手动配置 Claude Code

当 C+ 安装或 ccswitch 导入都不可用时，再使用手动配置。手动配置的核心是修改 Claude Code 的 settings.json，把 API Key 和 Base URL 写进去。

先备份，再修改

如果文件里已经有内容，不要直接清空。先复制一份备份，再把下面的 env 配置合并进去。

适合谁看

• ccswitch 保存了但 Claude Code 不生效。
• 想自己确认 Claude Code 到底读取了哪个 Key 和 Base URL。
• 需要手动调整压缩阈值等高级参数。

你需要准备

信息	从哪里拿	示例
API Key	中转站后台	sk-xxxxxxxxxxxxxxxx
Base URL	中转站后台或线路表	https://max.c-api.cc

找到 settings.json

Windows配置文件路径

%USERPROFILE%\.claude\settings.json

可以按 Win + R，输入 %USERPROFILE%\.claude 后回车。

macOS配置文件路径

~/.claude/settings.json

Finder 里按 Cmd + Shift + G，输入 ~/.claude 后回车。

如果没有 .claude 文件夹，可以先启动一次 Claude Code，或者手动创建文件夹和 settings.json。

写入配置

如果 settings.json 是空文件或不存在，可以写成下面这样：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://max.c-api.cc",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
  }
}

如果文件里已经有其他配置，只把 env 里的三项合并进去，不要删除其他字段。

{
  "env": {
    "已有配置": "保留",
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://max.c-api.cc",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
  }
}

保存并验证

1. 保存 settings.json。
2. 完全关闭 Claude Code 和当前终端。
3. 重新打开终端。
4. 执行 claude。
5. 发送一条测试消息。

请回复“配置已生效”。

能收到回复就完成

如果提示认证失败，优先检查 Key；如果提示连接失败，优先检查 Base URL。

排错清单

现象	可能原因	处理方式
Unauthorized / 认证失败	Key 错了或多了空格	重新复制 API Key
Connection Error / 连接失败	Base URL 错了或线路不可用	换线路，URL 末尾不要加 /
保存后没变化	改错文件	确认路径是 .claude/settings.json
设置不生效	旧进程还在	完全退出 Claude Code 和终端
JSON 报错	少逗号或多逗号	用 JSON 校验工具检查格式

仍然无法解决时，继续看 常见问题 FAQ。