手动配置（settings.json）

本页按照 ccodezh 官方教程，将 Claude Code 的中转参数写入本机配置文件。

【推荐配置方式】

如果你更喜欢一键配置，建议优先使用：CC-Switch 一键配置。

1. 找到配置目录

• Windows：%USERPROFILE%\.claude
• macOS / Linux：~/.claude

打开目录的小技巧：

• Windows：按 Win + R，输入 %USERPROFILE%\.claude 回车
• macOS：访达按 Command + Shift + G，输入 ~/.claude 回车

如果目录不存在，先运行一次：

claude

2. 配置 settings.json（核心）

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

{
  "apiKeyHelper": "echo 'sk-替换为你的 API Key'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的 API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

字段说明

• ANTHROPIC_BASE_URL：中转站 API 地址（ccodezh 为 https://api.ccodezh.com）
• ANTHROPIC_AUTH_TOKEN：你在控制台创建的 API Key
• apiKeyHelper：Claude Code 读取密钥的辅助命令（ccodezh 教程特别强调该项）
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：可选，减少非必要流量（不影响核心对话）

关于 apiKeyHelper 的坑

ccodezh 的教程提示：某些“一键脚本”配置后运行 claude 仍会尝试连接 api.anthropic.com，并报 ERR_BAD_REQUEST，通常就是缺少 apiKeyHelper。

3. 配置 config.json（主配置）

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

{
  "primaryApiKey": "any"
}

如果你已经有 config.json 且内容不止一行，请先备份再修改，避免影响你其他配置。

4.（可选）多账号 / 多中转：使用 auth.json

如果你需要在多家中转之间切换（而不是只用一个），可以用 auth.json + primaryApiKey 的方式管理。

示例：~/.claude/auth.json

{
  "api.ccodezh.com": {
    "apiKey": "sk-替换为你的 API Key"
  }
}

示例：~/.claude/config.json

{
  "primaryApiKey": "api.ccodezh.com"
}

选择建议

如果你只是接入 ccodezh 一个站点，直接用前面的 settings.json 方式更直观； auth.json 更适合“一个 Claude Code 管多个站点/多个 Key”的场景。

5. 重启并验证

改完配置后，重启终端（或重启 VSCode），然后运行：

claude

能正常回复就说明配置生效。

（可选）不用改文件：改环境变量

如果你不想编辑 settings.json，也可以直接设置环境变量（更适合临时测试）。

注意

环境变量方式与 settings.json 方式二选一即可；两者同时存在时，可能会让你排障更困难。

Windows（PowerShell 临时）

$env:ANTHROPIC_BASE_URL = "https://api.ccodezh.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-替换为你的 API Key"

Windows（PowerShell 永久，用户级）

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.ccodezh.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-替换为你的 API Key", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开终端窗口才会生效。

macOS / Linux（当前终端会话）

export ANTHROPIC_BASE_URL="https://api.ccodezh.com"
export ANTHROPIC_AUTH_TOKEN="sk-替换为你的 API Key"