CC Switch 接入

CC Switch 是跨平台的 AI 工具配置管理器，可集中管理 Claude Code、Codex、OpenCode、OpenClaw、Grok Build 和 Hermes Agent 的 Provider。把牛API添加为一个自定义 Provider，再按目标工具切换使用。

官方入口ccswitch.io ↗

官方仓库GitHub ↗

支持平台Windows、macOS、Linux

牛API Key为 CC Switch 单独创建

开始前准备

1. 从CC Switch 官方网站或官方 GitHub Releases安装当前版本；
2. 在牛API 控制台确认模型 ID，并创建一个只给 CC Switch 使用的 Key；
3. 根据 CC Switch 当前正在配置的工具，选择对应的地址：Claude Code 使用根地址，OpenAI Compatible 工具通常使用 /v1 地址。

添加牛API Provider

在 CC Switch 中点击 Add Provider 或“添加 Provider”，选择自定义配置，填写：

字段	Claude Code	Codex、OpenCode 等 OpenAI Compatible 工具
Provider 名称	牛API	牛API
API Base URL	https://api.reniuniu.win	https://api.reniuniu.win/v1
API Key	牛API专用 Key	牛API专用 Key
模型 ID	控制台中的真实模型 ID	控制台中的真实模型 ID

CC Switch 管理的是不同工具的配置，地址不能跨工具照抄。客户端字段如果明确要求 API root，填写根地址；如果要求 OpenAI Base URL，填写 /v1 地址。

切换并验证

1. 保存 Provider 后，在 CC Switch 中选中目标工具；
2. 点击 Enable 或“启用”，让牛API配置成为当前 Provider；
3. Claude Code 通常可直接读取新配置，其他 CLI 工具按官方说明完全退出并重新打开终端或工具；
4. 发送一次短文本请求，并在控制台核对模型 ID、请求时间和用量记录。

首次测试建议并发 1，关闭自动重试和高风险工具。基础文本调用成功后，再逐项测试流式、工具调用和长上下文。

常见问题

现象	处理
切换后工具仍使用旧配置	完全退出对应终端或工具后重新打开；确认启用的是目标工具的 Provider
401	检查 Key 是否完整，且没有把 Bearer 一起粘贴进 API Key 字段
404	检查 Claude Code 是否使用根地址，OpenAI Compatible 工具是否使用 /v1，避免 /v1/v1
模型不存在	从牛API控制台重新复制真实模型 ID，注意大小写

CC Switch 的界面、字段名称和支持工具会随版本更新。遇到管理器本身的问题，优先查看CC Switch 官方文档；遇到请求、额度或模型问题，再按常见错误排查。