CC Switch 接入

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

CC Switch · 当前稳定版 v3.19.1选择系统直接安装

Windows 普通电脑下载 .msi，macOS 下载 .dmg；Windows ARM 和 Linux 用户请进入官方 Releases。

国内加速 · Windows国内加速 · macOSGitHub Releases（最新版）

官方入口ccswitch.io ↗

官方仓库GitHub ↗

支持平台Windows、macOS、Linux

牛API 一键导入打开密钥页并导入 CCS ↗

CC Switch 能做什么

CC Switch 不只是一个 Provider 开关。它把多个 AI 编程工具分散在 JSON、TOML 和环境变量中的配置集中到图形界面中，适合同时使用多个 CLI、经常切换服务商或模型，以及希望统一维护开发扩展的用户。

• 集中管理 Provider：保存牛API和其他服务商的配置，通过预设、自定义配置和系统托盘快速切换，不必反复手动编辑配置文件；
• 按工具独立配置：分别管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Grok Build、Hermes 等工具，每个工具仍使用自己的协议、地址和模型设置；
• 统一维护开发扩展：集中管理并向受支持的工具同步 MCP、Prompts 和 Skills，减少多套配置重复维护；
• 代理与稳定性能力：其本地代理模式支持运行时切换、请求格式转换、故障转移和健康监控，具体支持范围以当前版本的官方说明为准；
• 统计与会话管理：可查看请求量、Token、成本等用量信息，并浏览、搜索或恢复部分工具的历史会话；
• 迁移与备份：支持 Deep Link 导入、配置导入导出和自动备份，也可按官方说明使用 Dropbox、OneDrive、iCloud 或 WebDAV 同步配置。

能力边界

以上是 CC Switch 自身提供的管理能力。牛API文档当前没有逐项验证其代理、故障转移、统计和云同步功能；接入时仍应按目标工具选择协议和 Base URL，不能把 Codex、Claude Code、OpenCode 等工具的配置直接混用。

开始前准备

1. 从页面顶部的国内加速入口安装当前版本；Windows ARM、Linux、需要后续版本或加速异常时，使用CC Switch 官方网站或官方 GitHub Releases；
2. 打开牛API 密钥页，确认模型 ID，并创建一个只给 CC Switch 使用的 Key；该页面提供“导入到 CCS”快捷操作；
3. 根据 CC Switch 当前正在配置的工具选择地址：Codex 和 Claude Code 使用根地址；其他工具按对应客户端教程填写。

添加牛API Provider

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

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

推荐直接在牛API 密钥页点击“导入到 CCS”，由控制台把配置交给 CC Switch；手动添加 Provider 仅作为备用方式。导入 Codex 时会写入根地址，不需要手动添加 /v1。CC Switch 管理的是不同工具的独立配置，OpenCode 等其他工具不要直接照抄 Codex 地址，请按对应客户端教程填写。

切换并验证

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

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

常见问题

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

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