CC Switch

CC Switch 是面向 Claude Code、Codex、Gemini CLI 的统一配置管理工具。原客户端支持一键创建 Key 并导入，这里迁成官网文档后保留导入结构、字段说明和模型推荐值。

准备信息

API Base URL：https://your-domain.com
API Key：你已有的 sk-...
目标应用：Claude Code、Codex、Gemini CLI

注意

Base URL 直接填写网关根地址，不要追加 /v1。

深链协议

CC Switch 通过 ccswitch:// 深度链接导入配置，配置内容为 Base64 编码 JSON。

ccswitch://v1/import?resource=provider&app=claude&name=My%20Provider&configFormat=json&config={Base64Json}

Claude Code 导入结构

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://your-domain.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_OPUS_MODEL": "claude-opus-4-6"
  }
}

Codex 导入结构

model_provider = "tag"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.tag]
name = "tag"
base_url = "https://your-domain.com"
wire_api = "responses"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"

Gemini CLI 导入结构

{
  "GEMINI_API_KEY": "sk-your-api-key",
  "GEMINI_BASE_URL": "https://your-domain.com",
  "GEMINI_MODEL": "gemini-2.5-flash"
}

Usage 配置脚本

如果你需要在 CC Switch 中同步展示额度或 usage，可参考原客户端使用的脚本结构：

({
  request: {
    url: "{{baseUrl}}/api/usage",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    },
  },
  extractor: function(response) {
    return {
      isValid: response.isValid || true,
      remaining: response.balance,
      unit: response.unit
    };
  },
})

使用建议

先确认目标工具本身能正常启动。
选择对应应用后，保持模型字段和客户端里的实际模型一致。
如果下拉模型为空，可手动填模型 ID。
需要额度显示时，再补 usage 脚本。

常见问题

导入后模型没切过去

通常是模型字段没和客户端要求保持一致。优先检查 Claude 的 Sonnet / Haiku / Opus，或 Codex 的默认模型名。

协议打不开

确认已安装 CC Switch，并且 ccswitch:// 协议已注册。

什么时候用 CC Switch

当你要给多个 CLI 工具统一切换网关配置、统一模型参数时，用它最省事。