CC Switch 配置
使用 CC Switch 桌面应用一键把 QCode.cc 接入 Claude Code 和 Codex CLI
CC Switch 配置¶
CC Switch 是一款跨平台桌面应用（Windows / macOS / Linux），提供统一可视化界面管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款 CLI 工具的 API 服务商配置。本文介绍如何在 CC Switch 中新增 QCode.cc 作为自定义供应商。
为什么用 CC Switch¶
- 零配置文件手写：可视化表单替代 settings.json / config.toml
- 一键切换供应商：在 qcode.cc、官方 Anthropic、本地反代之间秒切
- Claude + Codex 双生态：同一个应用管理 Claude Code 和 Codex CLI 配置
- 系统托盘快捷切换：托盘菜单无需打开主界面
前置条件¶
- 已安装 Claude Code CLI 或 Codex CLI
- 拥有 QCode.cc API Key（
cr_开头），在 控制台 获取
安装 CC Switch¶
从 GitHub Releases 下载对应平台安装包：
| 平台 | 下载包 |
|---|---|
| Windows 10+ | CC-Switch-v{ver}-Windows.msi 或便携版 .zip |
| macOS 12+ | .dmg 包；或 brew tap farion1231/ccswitch && brew install --cask cc-switch |
| Linux | .deb / .rpm / .AppImage；Arch 用 paru -S cc-switch-bin |
配置 Claude 供应商（用于 Claude Code）¶
启动 CC Switch → 左侧切换到 Claude 标签 → 右上角 新增供应商（Add Provider） → 选择 自定义（Custom） → 按下图填写：
| 字段 | 值 |
|---|---|
| 供应商名称 | QCode.cc |
| ANTHROPIC_BASE_URL | http://103.236.53.153/api |
| ANTHROPIC_AUTH_TOKEN | 你的 QCode.cc API Key（cr_ 开头） |
为什么用
103.236.53.153？ 这是 QCode.cc 的深圳直连节点，对中国大陆用户平均 RTT 约 0.15 秒，比国际域名快一倍以上。
保存后点击 激活（Activate） 将其设为当前 Claude 供应商，CC Switch 会自动把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写入 ~/.claude/settings.json。在终端运行 claude 验证连接。
配置 Codex 供应商（用于 Codex CLI）¶
切换到 Codex 标签 → 新增供应商 → 自定义 → 按下图填写：
| 字段 | 值 |
|---|---|
| 供应商名称 | qcode（推荐小写，便于作为 TOML 键名） |
| Base URL | http://103.236.53.153/openai |
| API Key | 你的 QCode.cc API Key |
| 默认模型 | gpt-5.3-codex-spark（推荐）或 gpt-5.4 |
CC Switch 会生成等效的 ~/.codex/config.toml 和 ~/.codex/auth.json：
model_provider = "qcode"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
[model_providers.qcode]
name = "qcode"
base_url = "http://103.236.53.153/openai"
wire_api = "responses"
requires_openai_auth = true
保存并激活，运行 codex 验证连接。
备用节点¶
若深圳节点访问异常，可切换到其他节点：
| 节点 | Claude Base URL | Codex Base URL |
|---|---|---|
| 深圳直连（推荐） | http://103.236.53.153/api |
http://103.236.53.153/openai |
| 香港 | http://103.218.243.5/api |
http://103.218.243.5/openai |
| 国际 CDN | https://api.qcode.cc/api |
https://api.qcode.cc/openai |
共享配额¶
CC Switch 中的 Claude 和 Codex 供应商使用同一个 QCode.cc API Key，共享你的套餐配额（详见 计费说明），不会因为多开两个供应商而重复扣费。
常见问题¶
保存后"激活"按钮灰色¶
确认 ANTHROPIC_BASE_URL / Base URL 末尾没有多余的 /。CC Switch 对尾部斜杠敏感。
报错 401 Unauthorized¶
- 确认 API Key 以
cr_开头且无前后空格 - 到 qcode.cc/dashboard 检查密钥是否有效
- 若 Claude 端报 401 但 Codex 正常（或反之），说明某一份供应商的 Key 没填对——CC Switch 对每个供应商独立存储 Key
Codex 启动后一直转圈¶
确认 config.toml 中 base_url 是 /openai（不是 /openai/v1）；wire_api = "responses" 必须保留。
能同时用 Claude 和 Codex 吗¶
可以。CC Switch 把 Claude 写到 ~/.claude/，Codex 写到 ~/.codex/，两份配置互不干扰。终端分别运行 claude 和 codex 即可。
下一步¶
- Claude Code 完整教程 — 掌握 Claude Code 的核心用法
- Codex 完整教程 — 深入使用 Codex CLI
- VS Code 集成 — 在编辑器中直接使用 Claude Code
- 计费说明 — 了解套餐和配额规则