Skip to content

手动配置 ​

自己在用户目录下的 .claude 文件夹里写 settings.json 和 config.json,效果和 一键脚本、CC Switch 一键导入 相同。适合想弄清每个字段的人。

1. 找到配置目录 ​

bash
# 配置目录:~/.claude
# 打开技巧:访达按 Command + Shift + G,输入 ~/.claude 回车
open ~/.claude
powershell
# 配置目录:%USERPROFILE%\.claude
# 打开技巧:按 Win + R,输入 %USERPROFILE%\.claude 回车
explorer $env:USERPROFILE\.claude

如果目录不存在,先运行一次:

bash
claude

2. 配置 settings.json(核心) ​

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

最小配置只需要两项,和控制台一键脚本写入的内容一致:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的 API Key"
  }
}
  • ANTHROPIC_BASE_URL:CcodeZH 的接口地址,不要加 /v1
  • ANTHROPIC_AUTH_TOKEN:控制台里 sk- 开头的 API Key

按需加入的可选字段(都写在同一个 env 里):

  • ANTHROPIC_MODEL 等模型字段:固定默认模型,见 模型设置
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:设为 "1" 减少非必要流量,不影响对话
  • CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS:设为 "1" 启用 Agent Teams(实验性)

apiKeyHelper:只在排障时加 ​

一般不需要。只有配置后运行 claude 仍去连 api.anthropic.com、报 ERR_BAD_REQUEST 时,才在 settings.json 最外层(与 env 同级)加入:

json
"apiKeyHelper": "echo 'sk-替换为你的 API Key'"

apiKeyHelper 在 Windows 上有已知问题。加了之后反而报 401 或无法使用,就删掉它再重启。

3. 配置 config.json(主配置) ​

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

json
{
  "primaryApiKey": "any"
}

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

4. 重启并验证 ​

改完配置后,重启终端(或重启 VSCode),然后运行:

bash
claude

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