手动配置（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：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的 API Key",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

字段说明

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

关于 apiKeyHelper 的坑

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

如需手动添加，在 settings.json 的最外层加入（与 env 同级）：

“apiKeyHelper”: “echo 'sk-替换为你的 API Key'”

注意：apiKeyHelper 在 Windows 上存在已知 bug，一键脚本默认不含此字段。若配置后仍无法使用，尝试删除该字段并重启。

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

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

{
  "primaryApiKey": "any"
}

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

4. 重启并验证

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

claude

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