跳转到主要内容
🎉 限时免费 — MiniMax: MiniMax M3 Free 现在体验 🔥

Claude Code

Claude Code 是运行在终端中的 AI 编程助手。通过配置 Anthropic 兼容接口，你可以让 Claude Code 使用 ModelGo 的模型和 API Key。

接入前准备

1. 安装 Claude Code

在终端执行：

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

安装完成后检查版本：

bash
claude --version

2. 配置 ModelGo

macOS / Linux

创建并编辑 Claude Code 配置文件：

bash
mkdir -p ~/.claude
$EDITOR ~/.claude/settings.json

Windows

在 PowerShell 中执行：

powershell
mkdir $env:USERPROFILE\.claude
notepad $env:USERPROFILE\.claude\settings.json

将下面内容写入 settings.json。把 YOUR_MODELGO_API_KEY 和 YOUR_MODELGO_MODEL 替换为真实的 ModelGo API Key 与逻辑模型名：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELGO_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.modelgo.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000",
    "ANTHROPIC_MODEL": "YOUR_MODELGO_MODEL",
    "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_MODELGO_MODEL",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODELGO_MODEL",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODELGO_MODEL",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODELGO_MODEL"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

ANTHROPIC_BASE_URL 填写 ModelGo 的根地址，不要追加 /v1/messages。Claude Code 会自动请求 ModelGo 的 POST /v1/messages 接口。

3. 可选：跳过官方账号初始化

如果首次输入 claude 时卡在官方账号登录引导，可以在用户目录创建 .claude.json，写入已完成初始化标识。

macOS / Linux：

bash
printf '%s\n' '{"hasCompletedOnboarding": true}' > ~/.claude.json

Windows PowerShell：

powershell
'{"hasCompletedOnboarding": true}' | Set-Content -Encoding utf8 $env:USERPROFILE\.claude.json

4. 启动 Claude Code

进入你的项目目录并启动：

bash
cd /path/to/your/project
claude

首次进入项目时，选择 Trust This Folder，允许 Claude Code 访问项目文件。然后输入一条简单的编码需求，能够正常返回结果即表示接入成功。

ModelGo 配置项

配置项ModelGo 填写内容
ANTHROPIC_AUTH_TOKEN在控制台创建的 ModelGo API Key
ANTHROPIC_BASE_URLhttps://api.modelgo.com
ANTHROPIC_MODELModelGo 平台逻辑模型名
ANTHROPIC_SMALL_FAST_MODEL同一个可调用的 ModelGo 逻辑模型名
ANTHROPIC_DEFAULT_HAIKU_MODEL同一个可调用的 ModelGo 逻辑模型名
ANTHROPIC_DEFAULT_SONNET_MODEL同一个可调用的 ModelGo 逻辑模型名
ANTHROPIC_DEFAULT_OPUS_MODEL同一个可调用的 ModelGo 逻辑模型名

模型名可以通过模型广场确认，也可以查询当前 API Key 可调用的模型：

bash
curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

常见问题

返回 401 或提示认证失败

检查 ANTHROPIC_AUTH_TOKEN 是否为有效的 ModelGo API Key，复制时不要带多余空格。

返回 403 或模型不可用

确认五个模型变量使用的都是当前 API Key 策略允许调用的 ModelGo 逻辑模型名。

返回 404 或找不到接口

ANTHROPIC_BASE_URL 应填写 https://api.modelgo.com，不要填写 https://api.modelgo.com/v1/messages；Claude Code 会自动补充 /v1/messages。

相关文档