手动配置 - Claude Code

本文介绍如何手动修改 Claude Code 的配置文件，完成中转站接入。

适合场景：ccswitch 无法使用、遇到问题需要手动排查、想自己掌控配置的用户。

---

你需要准备的信息

在开始之前，请先从中转站后台获取以下两样东西：

信息	说明	示例格式
API Key	你的身份凭证	sk-xxxxxxxxxxxxxxxxxx
Base URL	中转站的接口地址	https://xxx.example.com

---

第一步：找到 settings.json 文件

需要修改的文件路径：

• Windows： C:\Users\你的用户名\.claude\settings.json
• Mac： ~/.claude/settings.json

---

Windows 打开方式

1. 按下键盘 Win + R，打开运行窗口
2. 输入以下内容并回车：

%USERPROFILE%\.claude

3. 文件夹打开后，找到 settings.json，右键用记事本打开

⚠️ 如果找不到 .claude 文件夹，可能是因为它被隐藏了。请在文件夹顶部菜单里勾选「显示隐藏的项目」。

---

Mac 打开方式

1. 打开 Finder，顶部菜单点击「前往」→「前往文件夹」（快捷键 Cmd + Shift + G）
2. 输入以下内容并回车：

~/.claude

3. 找到 settings.json，右键用「文本编辑」打开

⚠️ Mac 上以 . 开头的文件夹默认隐藏，用上面的「前往文件夹」方式可以直接访问，无需单独开启显示隐藏文件。

---

第二步：编辑 settings.json

打开文件后，将整个文件内容替换为下面这段（把 Key 和 URL 换成你自己的）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://xxx.example.com"
  }
}

⚠️ 注意事项：

• Key 和 URL 两侧的英文引号 " 不能删除
• URL 末尾不要加 /
• 文件保存后生效，无需重装软件

---

第三步：保存并验证

1. 按 Ctrl + S 保存文件（Mac 用 Cmd + S）
2. 完全关闭 Claude Code（任务栏也退出）
3. 重新打开 Claude Code，发送一条消息测试

能正常收到回复 → 配置成功 ✅

报错或无响应 → 请对照下方排错清单检查

---

排错清单

问题现象	可能原因	解决方法
提示认证失败 / Unauthorized	Key 填错或带了多余空格	重新复制 Key，确认没有空格
提示无法连接 / Connection Error	URL 填错，或末尾多了 /	检查 URL，去掉末尾斜杠
文件保存后没变化	可能保存了错误位置	确认修改的是 .claude\settings.json
设置没生效	软件没完全退出	右键任务栏图标选「退出」后重开