如何安装和使用 Claude Code

Claude Code 是什么?

Claude Code是Anthropic推出的智能编程助手,通过CLI或Claude对话生成、补全、解释、重构多语言代码,支持长上下文推理和代理式开发,安全合规且高效,显著节省调试与交付时间,兼容云端与本地工作流,助力个人与团队快速交付高质量软件。

安装教程

选择你的操作系统

• Windows 安装
• macOS 安装

Windows 安装

1. 下载 Git

访问 Git下载页,安装时全程点击下一步,不要修改路径

2. 下载 Node.js

访问 Node.js下载页,安装时全程点击下一步,不要修改路径

3. 验证安装

Win+R 打开 Windows 命令提示符(CMD)

node -v
npm -v

若正常显示版本,则安装成功

4. 卸载已安装的 Claude Code(未安装跳过)

npm uninstall -g @anthropic-ai/claude-code

5. 重新安装 Claude Code

npm install -g @anthropic-ai/claude-code

6. 设置 Windows 系统环境变量

注意:CMD 本身不能直接修改"系统环境变量"(需管理员权限 + 图形界面),但可通过 setx 命令设置 用户级 或 系统级 变量(需管理员权限)。

方法一:使用 setx 命令(推荐用于用户级)

setx ANTHROPIC_BASE_URL "https://mg.aid.pub/claude-proxy"
setx ANTHROPIC_AUTH_TOKEN "填写你的Key"

注意

如果您使用 modelgate 网页端，ANTHROPIC_BASE_URL 为： https://mg.aid.pub/claude-proxy
如果您使用 modelgate 客户端，ANTHROPIC_BASE_URL 为： http://localhost:13148/claude-proxy

重要提示：请使用与您选择的端口对应的 Key：

• 使用客户端时，请填写客户端的 Key
• 使用网页版时，请填写网页版的 Key
• 两个端的 Key 不要混用，否则可能导致认证失败

TIP

此方法仅对当前用户生效,重启后仍有效

方法二:手动设置(推荐系统级)

1. Win10可在搜索框搜索 "系统属性" → "高级"→ "环境变量"
2. 点击"环境变量"
3. 在"系统变量"区域点击"新建"
4. 添加以下两项:

需要设置以下环境变量:

• 变量名:ANTHROPIC_BASE_URL,变量值:https://mg.aid.pub/claude-proxy
• 变量名:ANTHROPIC_AUTH_TOKEN,变量值:你的Key

注意

如果您使用 modelgate 网页端，ANTHROPIC_BASE_URL 为： https://mg.aid.pub/claude-proxy
如果您使用 modelgate 客户端，ANTHROPIC_BASE_URL 为： http://localhost:13148/claude-proxy

重要提示：请使用与您选择的端口对应的 Key：

• 使用客户端时，请填写客户端的 Key
• 使用网页版时，请填写网页版的 Key
• 两个端的 Key 不要混用，否则可能导致认证失败

7. 验证安装结果

重新启动 CMD,运行:

claude -v

macOS 安装

1. 打开终端

使用 Cmd+Space 搜索 "Terminal" 或在 应用程序 > 实用工具 中找到终端

2. 复制并执行环境检查脚本

curl -fsSL https://modelgate.oss-cn-beijing.aliyuncs.com/scripts/env-install.sh | bash

TIP

此脚本将自动检查并安装必要的依赖(Git、Node.js等)

3. 卸载已安装的 Claude Code(未安装跳过)

npm uninstall -g @anthropic-ai/claude-code

4. 重新安装 Claude Code

npm install -g @anthropic-ai/claude-code

5. 配置环境变量

打开 ~/.claude 目录下的 settings.json文件(如果没有则新建)，填入以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://mg.aid.pub/claude-proxy",
    "ANTHROPIC_AUTH_TOKEN": "填写你的 APIKey"
  }
}

注意

如果您使用 modelgate 网页端，ANTHROPIC_BASE_URL 为： https://mg.aid.pub/claude-proxy
如果您使用 modelgate 客户端，ANTHROPIC_BASE_URL 为： http://localhost:13148/claude-proxy

将 "填写你的 APIKey" 替换为你实际的 API Key

重要提示：请使用与您选择的端口对应的 Key：

• 使用客户端时，请填写客户端的 Key
• 使用网页版时，请填写网页版的 Key
• 两个端的 Key 不要混用，否则可能导致认证失败

6. 验证安装结果

重启终端后运行以下命令,确认安装成功:

claude -v

开始使用

安装完成后,可前往任意项目目录开始使用Claude Code

导航至目录

cd your-folder

启动 Claude Code

claude

计费说明

在使用 Claude Code 时,每一次具体的任务交互需要调用模型完成,不同的模型调用费率如下(下列计费单位为每百万 tokens):

模型名称	输入(魔币)	输出(魔币)	缓存写入(魔币)	缓存读取(魔币)
Opus	50 350	250 1750	63 438	5 35
Sonnet	30 210	150 1050	38 263	3 21
Haiku	8 56	40 280	11 70	1 6

说明

• 计费单位为 Mcoin(魔币)，1魔币=0.1人民币/ 0.0143美元
• 目前Claude Code内使用模型的费用约等于官方原价的 1.5折