CC Switch 配置
使用 CC Switch 配置 AiCore API,并管理 Claude Code 与 Codex
CC Switch 简介
CC Switch 是一个跨平台桌面配置管理工具,可以用图形界面管理 Claude Code、Claude Desktop、Codex 等 AI 工具的 API 供应商,并在多个供应商之间快速切换。
准备工作
下载并安装 CC Switch
打开 最新版本下载页,根据系统选择安装包:
添加 AiCore API 供应商
首次启动时,CC Switch 可能会检测并导入本机已有的 CLI 配置。随后按以下步骤添加新的供应商:
- 在左侧选择要配置的应用,例如 Claude 或 Codex。
- 点击右上角的 +,打开“添加供应商”面板。
- 选择“自定义”配置;如果列表中有匹配的预设,也可以先选择预设,再修改端点地址。
- 填写 API Key、接口地址和模型等字段。
- 点击“添加”或“保存”,再点击供应商卡片上的“启用”。
下面是两个应用的具体参数。
配置 Claude Code
在 Claude 应用中添加一个自定义供应商,填写:
| 配置项 | 值 |
|---|---|
| 供应商名称 | claude.xty.app |
| 备注 | 可留空 |
| 官网链接 | https://claude.xty.app |
| API Key | sk-你的令牌 |
| API 地址 | https://claude.xty.app |
| 上游格式 | Anthropic Messages(默认) |
如果使用 JSON 编辑器,可以参考以下配置:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
"ANTHROPIC_BASE_URL": "https://claude.xty.app/",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-opus-4-8",
"ANTHROPIC_MODEL": "claude-opus-4-8"
},
"theme": "light",
"model": "sonnet[1m]"
}启用供应商后,在项目目录中启动 Claude Code:
cd your-project-folder
claudeClaude Code 支持配置热切换,切换供应商后通常无需重启;如果当前版本没有立即更新,请退出后重新运行 claude。
配置 Codex
在 Codex 应用中添加一个自定义供应商,填写:
| 配置项 | 值 |
|---|---|
| 供应商名称 | api.xty.app |
| 备注 | 可留空 |
| 官网链接 | https://api.xty.app |
| API Key | sk-你的令牌 |
| API 地址 | https://codex-hk.xty.app/v1 |
| 默认模型 | gpt-5.6-sol |
| 上游格式 | Responses(原生) |
Codex 必须使用 Responses 协议。不要将协议改成 Chat Completions。
如果 CC Switch 显示高级 JSON/TOML 配置,可对应使用:
model_provider = "xty-api"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
[model_providers.xty-api]
name = "xty-api"
base_url = "https://codex-hk.xty.app/v1"
wire_api = "responses"
requires_openai_auth = true启用后,关闭当前 Codex 终端并重新打开,再运行:
cd your-project-folder
codex切换供应商
添加多个供应商后,可以通过两种方式切换:
- 主界面:在对应应用的供应商卡片上点击“启用”。
- 系统托盘:右键 CC Switch 托盘图标,在对应应用的子菜单中点击供应商名称。
不同工具的生效方式如下:
| 工具 | 生效方式 |
|---|---|
| Claude Code | 支持热切换;未生效时重新启动 CLI |
| Codex | 关闭并重新打开终端 |
如果您同时使用多个工具,请在对应的应用面板中分别点击“启用”。切换 Claude 的供应商不会自动切换 Codex 的供应商。
验证配置
分别启动对应 CLI,并发送一条简单消息:
你好,请简单介绍一下自己。如果无法回复,可以先检查配置文件中的 API 地址、协议和 API Key,再确认令牌具有对应模型的调用权限。