配置管理
CC Switch 接入
集中保存接入信息，在多个 CLI 工具与提供商之间切换。
安装与准备#
从 CC Switch 官方发布页 安装客户端，并确认目标 CLI 已安装。下面分别配置 Claude Code 和 Codex，两个工具的协议与地址不同。
Claude Code 配置#
- 在 CC Switch 中选择 Claude Code，添加供应商。
- 选择自定义配置，名称填 custom；使用 Anthropic Messages 格式。
- 按下表填写，保存。若需要默认模型，填账号可用的 Claude 兼容模型名。
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | custom |
| 上游格式 | Anthropic / Messages |
| API 请求地址 | https://api.onewonconnect.com |
| API Key | sk-你的Key |
如果界面提供「完整 URL」选项，使用上述基础地址时不要勾选。不要将 /v1/messages 当作基础地址。
Codex 配置#
- 切换到 Codex，另建一条 custom 供应商配置。
- 上游选择 Responses 格式，按下表填写。
- 获取或添加模型，选择默认模型后保存。
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | custom |
| 上游格式 | OpenAI Responses |
| Base URL | https://api.onewonconnect.com/v1 |
| API Key | sk-你的Key |
| 模型 | 控制台中可用的模型 ID |
直连模式需要上游原生支持目标工具的协议。若选择了需要转换的上游格式，应按 CC Switch 提示开启本地路由，并保持路由运行。
启用与验证#
回到供应商列表，启用刚添加的 custom 配置。若提示客户端配置已修改，重启目标工具或新建会话。
保存后，选择 custom 提供商和账号中可用的模型，在 目标工具 中发送一条短消息。然后到 控制台核对使用记录，确认请求使用了预期的 Key。
认证失败时检查 Key；模型错误时核对模型 ID；接口错误时检查协议和最终请求路径。能拉取模型列表不代表工具调用、图片或 Agent 的全部能力都可用。
避免同时用多个配置管理器修改同一个工具。