AI精品店

Appearance

CC-Switch 一键配置【推荐配置方式】 ​

使用 CC-Switch 一键配置 Claude Code，无需手动编辑配置文件。

CC-Switch 下载地址 ​

Mac 下载：https://v2li.lanzouq.com/i4PI63hm6vmh

Windows 下载：https://v2li.lanzouq.com/inq4Y3hm6w4f

为什么推荐 CC-Switch?

💡 图形化界面,无需手动编辑配置文件

🚀 一键切换不同 API 提供商

⚙️ 支持多个 API Key 管理

🔄 保存配置,随时切换

前置准备 ​

在开始前,请确保:

  1. ✅ 已安装 Claude Code CLI 工具
  2. ✅ 已在 ccodezh 控制台创建 API 令牌
  3. ✅ 已下载 CC-Switch 工具

还没完成?

注意

CC-Switch 会修改你本机的 Claude Code 配置文件（~/.claude/settings.json、~/.claude/config.json，Windows 对应 %USERPROFILE%\\.claude）。如果你之前已经手动配置过或同时管理多个中转，建议先备份现有文件。

配置 Claude Code ​

步骤 1：打开 CC-Switch ​

启动 CC-Switch 软件，你会看到初始界面：

CC-Switch 初始界面

步骤 2：选择 Claude 分组 ​

在顶部分组栏选择 "Claude"，点击右侧的 + 按钮：

步骤 3：选择供应商 ​

在供应商列表中，找到并选择 "ccodezh" 或 "api.ccodezh.com"：

选择供应商

提示：如果列表中没有 ccodezh，可以选择「自定义供应商」手动添加。

步骤 4：填写 API Key ​

  1. 回到 ccodezh 控制台，进入「令牌管理」页面
  2. 找到你创建的 Claude Code 分组 令牌，点击「复制」

创建 key

  1. 回到 CC-Switch，在 "API Key" 输入框中粘贴令牌

  2. 填写 "API 请求地址"：https://api.ccodezh.com

  3. 点击右下角 "添加" 按钮

步骤 5：启用配置 ​

添加成功后，在主界面会看到刚才配置的项目：

点击右侧的 "启用" 按钮，状态变为 "使用中"。

启用配置

步骤 6：验证配置 ​

打开终端，进入你的项目目录后运行：

bash
claude

发送 hi，看到对话界面并能正常回复，即表示配置成功！

配置详细说明 ​

CC-Switch 会自动写入以下配置到 ~/.claude/settings.json：

json
{
  "apiKeyHelper": "echo 'sk-你的API Key'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

常见问题 ​

❓ CC-Switch 无法启动 ​

可能原因：

  • 缺少运行库（Windows）
  • 权限不足（macOS）

解决方案：

❓ 配置后仍然连接 api.anthropic.com ​

检查步骤：

  1. 确认 Claude Code CLI 已正确安装（运行 claude --version）
  2. 确认 API Key 是 ccodezh 控制台创建的
  3. 确认已点击「启用」按钮
  4. 重启终端或 VSCode 后再试

手动检查配置文件：

打开 ~/.claude/settings.json（Windows：%USERPROFILE%\\.claude\\settings.json），确认包含以下内容：

  • apiKeyHelper 正确设置
  • ANTHROPIC_BASE_URL 为 https://api.ccodezh.com
  • ANTHROPIC_AUTH_TOKEN 为你的真实 API Key

❓ 提示「401 Unauthorized」 ​

原因：API Key 无效或已过期

解决：

  • 检查 API Key 是否正确复制（无多余空格）
  • 在 ccodezh 控制台确认令牌状态是否正常
  • 如有必要，重新创建令牌并更新配置

手动配置 ​

如果你不想使用 CC-Switch，也可以手动编辑配置文件：

最后更新：2025-02-02