CC-Switch Claude Code
这一页只讲一件事：在 CC Switch 里新增或选择一个 Provider，然后把它应用到 Claude Code。它不是 Claude Code 直连配置教程；如果你想直接改 Claude Code 配置文件，请看 Claude Code CLI 配置。
官方信息 下载和文档以官方站点为准
这一页讲什么
CC Switch 的作用是帮你集中管理 Provider，并把配置同步给目标工具。Claude Code 这一路要重点核对 Claude / Anthropic 协议、Key 和模型名，不要把 OpenAI 兼容地址直接当成 Claude 地址使用，除非服务商明确写了它支持 Claude Code。
开始前确认
| 要确认的事 | 怎么看 | 为什么 |
|---|---|---|
| Claude Code 已能启动 | 在终端或客户端里确认 Claude Code 能正常打开 | CC Switch 只负责切换配置，不负责安装 Claude Code |
| 服务商支持 Claude Code | 后台或文档里能看到 Claude / Anthropic / Claude Code 相关说明 | 只提供 OpenAI 兼容接口的服务商不一定能给 Claude Code 用 |
| Key 和模型名可用 | 后台能看到令牌、Key、模型列表或可用模型说明 | 模型名写错会直接导致 model not found |
| 先只改一个目标工具 | 第一次只选择 Claude Code | 排错时更容易判断是哪一项出问题 |
字段怎么填
| 字段 | 填写方式 | 新手注意 |
|---|---|---|
| Provider 名称 | 写成容易识别的名称 | 例如“主力中转 Claude”，不要只写数字 |
| 目标工具 / Preset | 选择 Claude Code 或 Claude 相关预设 | 不要选成 Codex、OpenAI 或 Gemini |
| Base URL | 复制服务商后台给 Claude / Anthropic 使用的 API 链接 | 不是所有服务商都和 OpenAI 共用同一个 Base URL |
| API Key | 复制后台生成的完整 Key | 它也常被叫作令牌、Key、密钥 |
| 模型名 | 照抄后台支持的 Claude 模型名 | 不要自己缩写，也不要把展示名改成模型名 |
如果服务商后台把不同协议分开写，Claude Code 就用 Claude / Anthropic 那一组。只有后台明确说明“Claude Code 使用 OpenAI 兼容地址”时，才按它的说明填写。
应用到 Claude Code
- 打开 CC Switch，进入 Provider 管理区域。
- 新增 Provider，或者选择你已经创建好的服务商配置。
- 目标工具选择 Claude Code 相关预设。
- 依次填写 Provider 名称、Base URL、API Key、模型名。
- 保存后执行 Apply / Switch，把当前 Provider 应用到 Claude Code。
- 如果页面提示需要重启终端或目标工具，就关闭当前 Claude Code 会话后重新打开。
测试是否生效
测试时先发一个极短问题，不要直接打开真实项目。只要能正常返回，就说明 Key、Base URL、模型名和目标工具同步基本可用。
Claude Code 最小测试
claude "请只回复：CC-Switch Claude Code 已生效"如果测试失败，优先按这个顺序查：目标工具是否选错、Base URL 是否对应 Claude / Anthropic、Key 是否复制完整、模型名是否照抄后台。