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-6.1-sol

保存后这个 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 兼容端点(开放后生效)

当前在线模型以 模型清单 或 GET /v1/models 为准,例如 gpt-6.1-sol / gpt-6-luna,可搭配 Codex CLI 使用。 切换其他客户端前,请确认目标模型在线且协议匹配;Provider 配置不代表 Claude / Gemini 系列模型已开放。

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

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