Claude Code 接入 ModelGate 教程

Claude Code 依赖 ANTHROPIC_* 环境变量读取供应商配置。通过 ModelGate 接入 Claude Code，只需设置两个变量：ANTHROPIC_AUTH_TOKEN（你的 ModelGate Key）和 ANTHROPIC_BASE_URL（ModelGate 接口端点）。

安装 Claude Code

安装官方 Claude Code：

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

Windows 也可以使用 PowerShell 安装脚本：irm https://claude.ai/install.ps1 | iex

安装完成后，先确认 claude 命令可被终端识别，再继续配置。

创建 API Key

进入 ModelGate 后台 令牌管理 页面。
创建密钥，名称填写 Claude，分组选择 Claude 分组。
创建成功后复制保存 Key。

密钥创建成功

配置环境变量

Windows

推荐使用配置文件 C:\Users\{用户名}\.claude\settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的ModelGate API Key",
    "ANTHROPIC_BASE_URL": "https://modelgate.app/",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

临时设置（PowerShell）：

$env:ANTHROPIC_BASE_URL="https://modelgate.app/"
$env:ANTHROPIC_AUTH_TOKEN="替换为您的ModelGate API Key"

macOS

创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的ModelGate API Key",
    "ANTHROPIC_BASE_URL": "https://modelgate.app/",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

临时设置（终端）：

export ANTHROPIC_BASE_URL="https://modelgate.app/"
export ANTHROPIC_AUTH_TOKEN="替换为您的ModelGate API Key"

Linux

推荐创建 ~/.claude/settings.json，内容与 macOS 相同。临时设置同样使用 export。

永久设置（macOS/Linux）

# bash
echo 'export ANTHROPIC_BASE_URL="https://modelgate.app/"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的ModelGate API Key"' >> ~/.bash_profile

# zsh
echo 'export ANTHROPIC_BASE_URL="https://modelgate.app/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的ModelGate API Key"' >> ~/.zshrc

# 立即生效
source ~/.bash_profile  # 或 source ~/.zshrc

验证配置

# macOS/Linux
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

确认变量已设置后，在终端运行 claude。能正常进入 Claude Code 并显示当前模型，说明 ModelGate 接入成功。

常见问题

claude 命令无法运行 — 确认安装完成，重新打开终端后再执行。
Claude Code 还是走默认配置 — 检查 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 是否生效。
认证失败 — 重新复制 ModelGate 后台的 Key，确认没有多余空格。
接口端点 — 统一填写 https://modelgate.app，API 格式保持 Anthropic Messages（原生），不要切换到 OpenAI 格式。