Tooling

CCS / CC-Switch 安装与使用

这是一类桌面端图形化配置工具。适合同时维护多 key、多环境、多客户端的人，不适合无界面的纯服务器环境。

GUI desktop first
多环境管理
不是主流程前置

什么时候该用 CCS

  • 你要在同一台机器上维护多套 key 或多家网关。
  • 你会在 Claude Code 和 Codex CLI 之间切换。
  • 你希望用图形界面快速开关不同配置，而不是一直手改文件。
不建议：如果你在纯 Linux 服务器、CI 或无桌面环境中运行，直接管理配置文件通常更稳，不需要额外装 CCS。

安装方式

当前社区常用的 CC-Switch 项目可从 GitHub Releases 获取安装包。桌面端常见分发形式包括 Windows 安装包、macOS 压缩包以及 Linux 的 AppImage / deb 包。

项目主页 github.com/farion1231/cc-switch
发行页 GitHub Releases
Arch Linux 可使用 AUR 包安装，但仍建议先看项目主页的当前说明。

给 Claude Code 添加配置

  1. 创建一个新的 Anthropic / Claude Code 配置项。
  2. 把 convertmodel 的 key 填到认证字段里。
  3. 把 Base URL 指向 https://convertmodel.net。
  4. 默认模型建议从 claude-sonnet-4-6 开始。
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://convertmodel.net",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

给 Codex CLI 添加配置

  1. 创建一个新的 OpenAI 兼容 provider。
  2. Key 使用 convertmodel 提供的 OpenAI 兼容链路 key。
  3. Base URL 仍然指向 https://convertmodel.net。
  4. 把 wire API 设为当前 CLI 所需协议，常见是 responses。
auth.json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

config.toml
model_provider = "convertmodel"
model = "gpt-5.4"

[model_providers.convertmodel]
name = "convertmodel"
base_url = "https://convertmodel.net"
wire_api = "responses"
requires_openai_auth = true