手动配置 Claude Code

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

先备份再修改

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

适合谁看

• ccswitch 导入失败。
• 想确认 Claude Code 实际读取了哪个 Base URL。
• 需要手动加入压缩阈值或其他环境变量。

你需要准备

项目	示例
API Key	sk-relay-xxxxxxxx
Base URL	https://hk.getelucid.com
配置文件	settings.json

Base URL 以控制台说明为准。当前默认写 https://hk.getelucid.com。

找到 settings.json

Windows：

%USERPROFILE%\.claude\settings.json

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

macOS / Linux：

~/.claude/settings.json

如果目录或文件不存在，可以先启动一次 Claude Code，或手动创建。

写入配置

最小配置示例：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-relay-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://hk.getelucid.com",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
  }
}

如果你已有其他配置，把 env 合并进去：

{
  "env": {
    "已有配置": "保留",
    "ANTHROPIC_API_KEY": "sk-relay-xxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://hk.getelucid.com",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
  }
}

保存并验证

完全关闭 Claude Code 和终端，再重新打开。进入任意目录后发送：

请回复“配置已生效”。

如果能正常回复，说明配置已生效。

排错清单

现象	可能原因	处理方式
认证失败	Key 错、过期或复制了空格	回控制台重新复制 API Key
连接失败	Base URL 写错或线路不可用	回控制台复制当前可用地址
改了没变化	Claude Code 没完全退出	关闭终端和后台进程后重开
JSON 报错	逗号、引号或括号错误	用 JSON 校验器检查 settings.json
仍走官方	改错配置文件	回到本页确认路径