Skip to content

CCS配置Claude Code

这篇教程用 Windows 截图演示。不同版本的 CC Switch 界面可能略有变化,但主要按钮和流程基本一致。

Claude Code 是什么

Claude Code 是一个在命令行里使用的 AI 编程工具。 你可以在项目目录里打开它,让它帮你阅读代码、解释报错、修改文件、生成代码或分析项目结构。

CC Switch 的作用是帮 Claude Code 管理 API 地址、API Key 和模型配置。配置完成后,你在终端里运行 claude,就可以通过R-API 使用 Claude Code。

开始前准备

你需要先准备好:

  1. 已安装并能打开的 CC Switch
  2. 已安装并能运行的 Claude Code
  3. 一个可用的R-API API Key

如果还没有安装 CC Switch,先看:CC Switch 安装教程。 如果还没有 API Key,先看:API 密钥

需要填写什么

先记住这几项,后面按截图填写即可:

配置项填写内容
供应商类型统一供应商
预设类型NewAPI
名称R-API
API 地址以 R-API 地址 文档为准
API Key你的R-API Key
官网地址https://api.cccc.asia
Claude 模型gpt-5.5

注意

API Key 是你的私密凭证,不要发给别人,也不要把完整密钥截图公开。

1. 打开新增供应商

打开 CC Switch,先确认上方选中的是 Claude Code,然后点击右上角的 +

打开新增供应商入口

进入添加页面后,选择 统一供应商,再点击右下角 添加统一供应商

选择统一供应商

2. 填写供应商信息

预设类型选择 NewAPI,然后填写:

  • 名称:R-API
  • API 地址:打开 API 地址,复制当前推荐地址
  • API Key:粘贴你的R-API Key
  • 官网地址:https://api.cccc.asia

填写供应商信息

API Key 可以在后台的 API 密钥 页面复制。 点击密钥右侧的复制按钮即可,不建议手动输入。

回到 CC Switch,把复制好的 Key 粘贴到 API Key 输入框。

3. 填写 Claude 模型

往下找到 模型配置。 在 Claude 区域里,把 模型HaikuSonnetOpus 都填写为:

gpt-5.5

如果页面里还有 Codex、Gemini 等区域,不用时可以先保持默认;如果系统要求填写,也可以先同样填 gpt-5.5

填完后点击右下角 添加

填写模型配置

4. 同步配置

添加完成后,回到统一供应商列表。 能看到 R-API,说明供应商已经创建成功。

接着点击卡片上的 同步 图标。

供应商添加成功

弹出确认窗口后,点击 同步

确认同步统一供应商

看到绿色提示,例如 R-API 运行正常,说明 CC Switch 已经能正常连接。

连通性检查

5. 打开 Claude Code 测试

打开 PowerShell,进入你的项目目录,然后运行:

claude

进入 Claude Code 后,可以发送一句测试:

你好,你是什么模型?

如果能正常回复,就说明 Claude Code 已经通过 CC Switch 使用R-API配置。

常见问题

API 地址要不要加 /v1

按 API 地址 文档说明填写。 如果文档说明当前工具不需要 /v1,就不要额外添加。

提示鉴权失败怎么办?

优先检查 API Key:

  1. 是否复制完整
  2. 前后是否多了空格
  3. 密钥是否仍然启用
  4. 账户余额是否充足

Claude Code 没有走 CC Switch 怎么办?

先回到 CC Switch,确认:

  1. 顶部选中的是 Claude Code
  2. 供应商卡片显示为使用中
  3. 已点击同步,并出现运行正常提示

确认后重新打开 PowerShell,再运行 claude 测试。

相关文档

R-API 文档中心