Claude Code穿过模型门

本指南使用永久 settings.json 配置。 ANTHROPIC_BASE_URL 必须指定 没有 /v1。

所需值

ANTHROPIC_BASE_URL=https://api.model-gate.com
ANTHROPIC_AUTH_TOKEN=mg_live_...

ANTHROPIC_AUTH_TOKEN 作为不记名令牌发送。模型门也接受 x-api-key，但身份验证令牌形式适用于 LLM 网关。

1.安装Claude Code

macOS 或 Linux 本机安装程序

curl -fsSL https://claude.ai/install.sh | bash

npm 替代方案

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

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

关闭并重新打开终端，然后验证：

claude --version

当安装程序发生更改时，请使用当前的官方安装说明： https://docs.anthropic.com/en/docs/claude-code/getting-started。

2.创建设置目录

Linux 或 macOS

mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"

3. 推荐设置.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
  },
  "model": "claude-sonnet-4.6"
}

将模型 ID 替换为以下方法返回的启用 ID：

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

4. 覆盖 Opus、Sonnet 和 Haiku 插槽

Claude Code 公开三个标准模型插槽。您可以将它们映射到 Model Gate 模型 ID：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

这些值覆盖三个标准插槽；他们不会创建无限的新 GUI 按钮。

5. 可选的隐私和超时设置

仅添加您理解的设置：

{
  "env": {
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "BASH_DEFAULT_TIMEOUT_MS": "120000",
    "BASH_MAX_TIMEOUT_MS": "600000"
  }
}

除非您了解安全影响，否则请勿全局启用权限绕过。模型门不需要 bypassPermissions。

6. 开始 Claude Code

claude

使用 /model 检查或更改所选模型。

7. 无需settings.json的一次性测试

Linux 或 macOS

export ANTHROPIC_BASE_URL="https://api.model-gate.com"
export ANTHROPIC_AUTH_TOKEN="mg_live_..."
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.model-gate.com"
$env:ANTHROPIC_AUTH_TOKEN = "mg_live_..."
claude

故障排除

问题	解决
claude 没有找到	关闭并重新打开终端，然后运行 claude --version。查看 where.exe claude 在 Windows 或 which claude 在 Unix 上。
需要验证	核实 ANTHROPIC_AUTH_TOKEN，关闭Claude Code，然后重新启动。
找不到型号	使用规范 ID 或启用的别名返回 /v1/models。
请求直接发送至 Anthropic	确认基本 URL 准确无误 https://api.model-gate.com 没有 /v1。
401 invalid_api_key	旋转 Model Gate 钥匙并更新 settings.json。

官方网关参考： https://docs.anthropic.com/en/docs/claude-code/llm-gateway。