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 配置
• 多账号/多套餐管理：为同一供应商保存多份配置（如工作 Key 与个人 Key），随时切换
• 系统托盘快捷切换：托盘菜单无需打开主界面

CC Switch 的本质是一个"配置档案（profile）切换器"——它把每份供应商配置写入对应 CLI 的标准配置文件，激活时覆盖、切换时换回。理解这一点能帮你避免误以为多个供应商会同时生效。

前置条件¶

• 已安装 Claude Code CLI 或 Codex CLI
• 拥有 QCode.cc API Key（cr_ 开头），在 控制台 获取
• 同一把 Key 同时适用于 Anthropic、OpenAI、Gemini 等多种协议端点，详见 接入点与 API 格式

安装 CC Switch¶

从 GitHub Releases 下载对应平台安装包：

各版本的具体安装步骤与签名提示以 项目 README 为准。

配置 Claude 供应商（用于 Claude Code）¶

启动 CC Switch → 左侧切换到 Claude 标签 → 右上角 新增供应商（Add Provider） → 选择 自定义（Custom） → 按下图填写：

为什么推荐 asia.qcode.cc？ 这是 QCode.cc 的香港节点，对中国大陆用户延迟最低；不稳定时切回 api.qcode.cc（全球 Route 53）。同一把 Key 在 api / asia / us / eu 四个域名下通用。

保存后点击 激活（Activate） 将其设为当前 Claude 供应商，CC Switch 会自动把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写入 ~/.claude/settings.json。在终端运行 claude 验证连接。

选择默认模型¶

QCode.cc 提供完整的旗舰到轻量模型阵容，可在 Claude Code 中用 /model 切换，或直接在配置中指定：

旗舰位还有 claude-opus-4-7（1M）。完整阵容（含 GPT、Gemini）见 模型与定价。

配置 Codex 供应商（用于 Codex CLI）¶

切换到 Codex 标签 → 新增供应商 → 自定义 → 按下图填写：

CC Switch 会生成等效的 ~/.codex/config.toml 和 ~/.codex/auth.json：

model_provider = "qcode"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

保存并激活，运行 codex 验证连接。Codex CLI 当前版本为 0.142.0；GPT 模型可选 gpt-5.5（$5/$30，1M）、gpt-5.4（$2.5/$15，1M）、gpt-5.4-mini（$0.75/$4.5，400K）、gpt-5.3-codex（$1.75/$14，272K）。

在多个供应商/账号之间切换¶

CC Switch 的核心价值在于"切换"。常见做法：

1. 在 Claude 标签下保存多份供应商，例如 QCode.cc（主力）、QCode.cc (asia)（大陆节点）、Anthropic Official（备用）。
2. 需要切换时，点击目标供应商旁的 激活，CC Switch 会把对应的 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 重新写入 ~/.claude/settings.json。
3. 重启 Claude Code（或开新终端）使新配置生效——已在运行的 claude 会话不会热加载新的环境变量。
4. Codex 同理：在 Codex 标签切换激活项会重写 ~/.codex/config.toml。

托盘快捷切换：CC Switch 常驻系统托盘，右键托盘图标即可直接在已保存的供应商之间切换，无需打开主窗口。具体菜单项以应用实际版本为准。

多账号 / 多套餐示例¶

为同一个 QCode.cc 保存两份配置，分别填不同的 API Key：

切换激活即在两套配额之间无缝切换，互不串账。

使用场景¶

• 国内网络波动：主力用 asia.qcode.cc，抖动时一键切到 api.qcode.cc 全球节点。
• 多供应商对比：同一任务分别用 QCode.cc 与官方 Anthropic 跑一遍，对比响应与成本。
• 团队 / 个人分账：用不同 Key 区分工作与私人用量，便于核账。
• Claude + Codex 协同：一个应用里同时管理 Claude Code 与 Codex CLI，分别接 Anthropic 协议端点与 OpenAI 协议端点。

Claude Code 高级能力（接 QCode 后同样可用）¶

CC Switch 只负责切换供应商，Claude Code 自身的能力不受影响。接入 QCode 后，以下功能照常工作（运行在 Claude Code 当前配置指向的模型上）：

视觉输入：从截图 / 图表理解需求¶

Claude Code 支持把图片喂给具备视觉能力的模型：在提示中粘贴（Ctrl+V）、拖拽图片，或直接引用图片文件路径。常见用途：

• 从设计稿 / 截图还原 UI
• 从报错截图定位 Bug
• 阅读架构图、图表

经 QCode 可用的视觉模型包括 Claude Opus 4.8 / Sonnet 4.6 以及 GPT-5.x。

注意：这里说的是图像"输入"（理解），不是图像"生成"。 需要让模型生成图片，请用 gpt-image-2 模型，详见 gpt-image-2 图像生成。

动态工作流（后台子代理编排）¶

在提示中包含关键词 ultracode（或直接说"运行一个工作流"）即可触发 Claude Code 的动态工作流：它会编排数十到上百个后台子代理并行处理，适合全代码库级别的审查、迁移、调研。子代理在后台运行的同时你可以继续工作，用 /workflows 命令查看运行情况。该能力运行在 Claude Code 当前配置的模型上——所以当 Claude Code 指向 QCode 时同样可用。延伸阅读 子代理。

无头模式 / 自动化输出¶

在脚本与 CI 中用 -p 一次性运行并指定输出格式：

# 结构化 JSON（含 result / total_cost_usd / usage / session_id），用 jq 解析
claude -p "总结本仓库的测试覆盖" --output-format json | jq '.result'

# 行分隔的流式 JSON 事件，适合实时管道
claude -p "审查 src/ 的安全风险" --output-format stream-json

更多管道与 CI 用法见 自动化与 CI/CD。

关于 Gemini / Antigravity¶

CC Switch 的可视化列表里包含 Gemini CLI，但请注意：Google 已让 Gemini CLI 退役（Pro/免费层 EOL 为 2026-06-18，企业付费 Key 不受影响），后继为 Google Antigravity CLI（2026-05-19 起可用）。如需通过 QCode 使用 Gemini 系模型，推荐改用 Antigravity：

• 编辑 ~/.config/antigravity/config.toml
• 将 base_url 设为 https://api.qcode.cc/openai/v1，填入你的 QCode API Key，并选一个模型
• Antigravity 仍在快速演进，确切配置键名以 官方文档 为准

QCode 上的 Gemini 模型为 gemini-2.5-pro、gemini-3.5-flash（Gemini 系按 2 倍计费）。

备用节点¶

若主节点访问异常，可切换到其他节点（同一把 Key 通用）：

自检：直接访问 Base URL 对应路径返回 401 是正常的——说明路径正确，只是缺少鉴权。

共享配额¶

CC Switch 中的 Claude 和 Codex 供应商使用同一个 QCode.cc API Key，共享你的套餐配额（详见 计费说明），不会因为多开两个供应商而重复扣费。若你为不同 Key 建了多份供应商，则各 Key 各自计费、互不影响。

实用技巧¶

• 命名带后缀：供应商名加上 (asia) / (work) 等后缀，托盘切换时一眼可辨。
• 切换后重启 CLI：环境变量在进程启动时读取，切换供应商后请新开终端或重启 claude / codex。
• 末尾不要带斜杠：所有 Base URL 末尾不能有 /，否则可能拼出错误路径。
• Key 单独保管：CC Switch 对每个供应商独立存储 Key，更换 Key 时记得逐个更新。
• 备份配置：切换前若手改过 ~/.claude/settings.json，激活会覆盖你的手改内容，建议先备份。

常见问题¶

保存后"激活"按钮灰色¶

确认 ANTHROPIC_BASE_URL / Base URL 末尾没有多余的 /。CC Switch 对尾部斜杠敏感。

报错 401 Unauthorized¶

1. 确认 API Key 以 cr_ 开头且无前后空格
2. 到 qcode.cc/dashboard 检查密钥是否有效
3. 若 Claude 端报 401 但 Codex 正常（或反之），说明某一份供应商的 Key 没填对——CC Switch 对每个供应商独立存储 Key

切换供应商后没生效¶

切换只是重写了配置文件，已在运行的 claude / codex 进程不会热加载。请新开终端或重启 CLI 后再试。

Codex 启动后一直转圈¶

确认 config.toml 中 base_url 是 /openai（不是 /openai/v1）；wire_api = "responses" 必须保留。

能同时用 Claude 和 Codex 吗¶

可以。CC Switch 把 Claude 写到 ~/.claude/，Codex 写到 ~/.codex/，两份配置互不干扰。终端分别运行 claude 和 codex 即可。

我手改过 settings.json，激活会丢吗¶

会。激活时 CC Switch 会用该供应商的字段覆盖 ~/.claude/settings.json 中对应项。建议把自定义内容放在 CC Switch 的供应商配置里，或激活前先备份。

下一步¶

• Claude Code 完整教程 — 掌握 Claude Code 的核心用法
• Codex 完整教程 — 深入使用 Codex CLI
• VS Code 集成 — 在编辑器中直接使用 Claude Code
• 子代理 — 用动态工作流编排后台代理
• 自动化与 CI/CD — 无头模式与脚本集成
• 计费说明 — 了解套餐和配额规则

还没有 QCode.cc API Key？前往 qcode.cc/pricing 选套餐，一把 Key 在 CC Switch 里同时驱动 Claude Code 与 Codex CLI。