Skip to Content

CC-Switch 接入

CC-Switch  是开源的多供应商切换工具,专门针对 Claude Code、Codex CLI、Gemini CLI 这类直接读环境变量的 Agent 客户端 —— 在 GUI 里一键切换上游,不用每次手动改 ~/.zshrc

1. 准备 API Key

登录 app.ttttt.ai API 密钥 → 创建密钥(命名 cc-switch)。

2. 添加 ttttt.ai Provider

打开 CC-Switch → + 添加供应商

字段
名称ttttt.ai
类型 / TypeOpenAI 兼容Custom
Base URLhttps://api.ttttt.ai/v1
API Keyowo-...
默认模型gpt-5.5

保存后这个 provider 会出现在主界面的下拉里。

3. 切换激活的 Provider

点击列表里的 ttttt.ai → 激活。CC-Switch 会自动写入对应的环境变量:

客户端CC-Switch 写入的变量
Codex CLIOPENAI_API_KEY + OPENAI_BASE_URL
Claude CodeANTHROPIC_API_KEY + ANTHROPIC_BASE_URL(开放后生效)
Gemini CLIGOOGLE_API_KEY + Gemini 兼容端点(开放后生效)

测试期 ttttt.ai 只对外开放 gpt-5.5 / gpt-5.4 —— 推荐和 Codex CLI 一起用。 Claude / Gemini 系列协议层已就绪,等模型放开后切换 provider 即可,不需重新配置 CC-Switch。

切换后开新终端,环境变量已生效,直接 codexclaudegemini 启动即可。

4. 多账号 / 多预算

CC-Switch 支持把多个 provider 配置并列保存:

  • ttttt.ai-personal 走个人 owo- 密钥
  • ttttt.ai-team-prod 走公司团队密钥
  • ttttt.ai-experiment 走小额度的实验密钥

平时跑业务用 team key,调试新工具切到 personal key —— 账单天然分开,离职 / 泄露 也可以单独吊销其中一把,不影响其他人。

5. 验证

cc-switch status codex "ping"

回到 app.ttttt.ai/dashboard/usage  按密钥筛选,能看到刚刚切换后的请求来自对应密钥。

6. 常见问题

Q: 切换后老终端没生效? A: CC-Switch 写入的是 shell 启动文件 / 系统环境变量,已开的 shell 不会自动更新。 关掉重开,或 source ~/.zshrc

Q: 我同时装了 Claude Code 和 Codex CLI,切换会不会互相打架? A: 不会。CC-Switch 按客户端类型分别写不同变量(ANTHROPIC_* vs OPENAI_*), 两者互不影响。

Q: ttttt.ai 自己有控制台密钥管理,为什么还要 CC-Switch? A: 控制台管的是「密钥本身的生命周期」(生成 / 吊销 / 限额)。 CC-Switch 管的是「本机要用哪把密钥」。两者互补: 要切换/审计 → 控制台;要快速换上游 → CC-Switch。

Last updated on