乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > 用 CC Switch 管理你的 AI 编程工具

用 CC Switch 管理你的 AI 编程工具

当前时间： 2026-04-22 00:12:47 更新时间： 2026-04-22 分类：软件教程 评论(0)

用 CC Switch 管理你的 AI 编程工具

  • 用过 Claude Code 、Codex 、Gemini CLI 的朋友，切换 API 供应商时是不是经常要手动改配置文件、重启终端？
  • CC Switch 就是来终结这种混乱的——一个开源桌面工具，统一管理所有 AI 编程 CLI 的供应商配置，一键切换。
  • 今天带你从零安装 CC Switch，搭配 LetAiCode 中转 API，同时搞定 Claude Code、Codex 和 Gemini 三个工具。

CC Switch 是什么？能干什么？

一句话概括：它是 AI 编程工具的”万能遥控器”。

你只需要在 CC Switch 里添加一次供应商配置，它就能自动帮你写入 Claude Code、Codex、Gemini CLI 等工具的配置文件。想切换供应商？右键托盘图标，点一下就行。

核心功能：

  • 供应商管理 — 添加多个 API 供应商，一键切换，不用再手动改配置文件
  • 系统托盘常驻 — 右键菜单秒切模型，不用打开主窗口
  • MCP 统一管理 — 一次配置，Claude Code、Codex、Gemini CLI 等多个工具共用
  • Skills 一键安装 — 从 GitHub 直接安装 Claude Skills 扩展能力
  • 分组独立管理 — Claude、Codex、Gemini 的供应商配置互不干扰

第一步：安装 CC Switch

macOS 用户（推荐 Homebrew）

打开终端，依次执行：

brew tap farion1231/ccswitchbrew install --cask cc-switch

首次打开如果提示”无法验证开发者”，前往「系统设置 → 隐私与安全性」，点击「仍要打开」即可。

Windows 用户

前往 CC Switch GitHub Releases 页面 

https://github.com/farion1231/cc-switch/releases

下载 .msi 安装包，双击安装（也可直接下载便携版（绿色免安装，解压后直接运行））。如果遇到 SmartScreen 蓝屏提示，点击「更多信息 → 仍要运行」。

Linux 用户

# Ubuntu / Debian — 从 [Releases 页面](https://github.com/farion1231/cc-switch/releases) 下载 .deb 包sudo dpkg -i cc-switch_*.deb# Arch Linuxparu -S cc-switch-bin

安装完成后启动 CC Switch，我们进入下一步。

第二步：获取 LetAiCode 的 API Key

在配置 CC Switch 之前，我们需要先拿到 API 密钥。这里选用 LetAiCode 作为中转 API 平台，它支持 Claude Code、Gemini Pro、OpenAI Codex 等模型，官方直连、按量计费、扣费透明，还支持开票。

操作步骤：

  1. 访问 LetAiCode 官网：https://letaicode.cn/，邮箱登录
  2. 点击 接口密钥 页面
  3. 点击 创建新密钥
  4. 关键配置项：
    • 密钥类型/分组：根据你要使用的工具选择对应分组（claude / codex / gemini）
    • 额度：选择 无限额度，不要限制模型
    • 令牌名称：随意填写
  5. 创建成功后，复制 API Key（格式为 sk-xxx），妥善保存

⚠️ API Key 只在创建时显示一次，务必立即复制保存！

第三步：在 CC Switch 中添加供应商

打开 CC Switch，开始配置。下面分别介绍三个工具的配置方法。

配置 Claude Code 的供应商

  1. 在 CC Switch 主界面顶部，确认当前分组为 Claude

  2. 点击右上角的 「+」 按钮

  3. 选择 Custom（自定义配置）

  4. 填写以下信息：

    • 供应商配置：LetAiCode-Claude（名称随意，方便识别即可）

    • API请求地址：https://letaicode.cn/claude（末尾不要加斜杠，选中完整URL）

    • API Key：填入你在 LetAiCode 创建的 API Key

    • API 格式：选择 Anthropic（Claude Code 使用 Anthropic 原生协议）

    • 配置 JSON

      {"env": {"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌","ANTHROPIC_BASE_URL": "https://letaicode.cn/claude","ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929","ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001"  }}

  5. 点击 保存

配置 Codex 的供应商

  1. 在主界面顶部切换分组为 Codex

  2. 同样点击右上角 「+」 按钮

  3. 选择 Custom

  4. 填写以下信息：

    • 供应商配置：LetAiCode-Codex
    • API请求地址：https://letaicode.cn/codex（末尾不要加斜杠，选中完整URL）
    • API Key：填入你的 LetAiCode API Key
    • 选择写入通用配置

  5. 点击保存

💡 使用 CC Switch 的好处是这些配置会自动写入，不需要你手动编辑 JSON 文件。

配置 Gemini的供应商

  1. 在主界面顶部切换分组为 Gemini

  2. 点击右上角 「+」 按钮

  3. 选择 Custom

  4. 填写以下信息：

    • 供应商配置：LetAiCode-Gemini
    • API请求地址：https://quiz.playoffer.cn/gemini（末尾不要加斜杠）
    • API Key：填入你的 LetAiCode API Key

  5. 点击保存

💡 为什么三个工具的 API请求地址 不一样？ 因为 LetAiCode 为不同工具提供了专用的中转端点，各自走最优的协议链路，确保稳定性和响应速度，API请求地址可参考https://letaicode.cn/网站的接口密钥栏。

第四步：启用并验证

启用供应商

在供应商列表中找到刚添加的配置，点击 Enable 按钮，状态变为 Active 即表示生效。CC Switch 会自动将配置写入对应工具的配置文件。

以下验证需事先已安装claude code/codex/gemini，具体安装教程可参考之前的文章

验证 Claude Code

Claude Code 支持热切换，启用后无需重启终端，直接在终端输入：

claude

随便问一个问题，比如 你好，请介绍一下你自己，能正常回复就说明配置成功。

验证 Codex

Codex 需要关闭并重新打开终端后才能生效：

# 先退出当前终端，重新打开codex

同样输入测试内容，能正常回复即配置成功。

验证 Gemini

Gemini CLI 每次请求都会重新读取配置，启用后直接在终端输入：

gemini

输入测试内容，能正常回复即配置成功。

💡 快速切换技巧：以后想换供应商，直接右键点击系统托盘的 CC Switch 图标，选择目标供应商即可，不用打开主窗口。

第五步：进阶用法（可选）

一键安装 Skills 扩展

CC Switch 内置了 Skills 管理功能，可以从 GitHub 一键安装 Claude Code 的扩展能力：

  1. 点击右上角 Skills 标签页
  2. 浏览可用的 Skills（如 code-review、commit-commands、playwright 等）
  3. 勾选需要的 Skill，一键安装

统一管理 MCP 服务器

如果你同时使用 Claude Code、Codex 和 Gemini CLI，MCP 配置只需要在 CC Switch 里设置一次：

  1. 点击右上角 MCP 标签页
  2. 点击 添加，选择协议类型（stdio / HTTP / SSE）
  3. 填写 MCP 服务器信息
  4. 保存后，所有 CLI 工具自动共享该配置

跳过 Claude Code 首次登录引导

如果 Claude Code 首次启动时弹出登录引导页面，可以在 CC Switch 中关闭：

  1. 打开 CC Switch → Settings → General
  2. 开启 Skip Claude Code first-run confirmation
  3. 重启 Claude Code

常见问题

Q：切换供应商后不生效？

Claude Code 支持热切换，即时生效。Codex 需要重启终端，Gemini CLI 每次请求自动读取配置。如果仍不生效，检查 Base URL 末尾是否误加了斜杠。

Q：API请求的Base URL 填错了会怎样？

末尾多加一个 / 会导致 API 路径拼接出现双斜杠，请求直接失败。这是最常见的坑，务必注意。

Q：之前手动配置过环境变量，会冲突吗？

可能会。建议在使用 CC Switch 前，清除旧的官方环境变量：

unset ANTHROPIC_AUTH_TOKENunset ANTHROPIC_BASE_URLunset GEMINI_API_KEYunset GOOGLE_GEMINI_BASE_URL

Q：Windows 用户名含中文导致启动报错？

CC Switch 的数据库文件默认存放在 %USERPROFILE%\.cc-switch\，中文路径可能引发问题。可以到 Releases 页面 下载便携版（.zip）解压到纯英文路径下使用。

Q：想恢复官方 API 登录怎么办？

在 CC Switch 中选择 “Official Login” 预设（Claude/Codex）或 “Google Official” 预设（Gemini），重启对应工具后按官方流程登录即可。

Q：配置数据在哪里？重装会丢失吗？

所有供应商配置保存在 ~/.cc-switch/cc-switch.db（macOS/Linux）或 %USERPROFILE%\.cc-switch\cc-switch.db（Windows），重装前备份此文件即可。

写在最后

CC Switch 解决的痛点很明确：让 AI 编程工具的配置管理从”手动改文件”变成”点一下按钮”。如果你同时使用多个 AI 编程工具，或者经常需要在不同供应商之间切换，它几乎是必备工具。

搭配 LetAiCode 的中转 API，整个流程就是：安装 CC Switch → 拿到 API Key → 添加供应商 → 启用，四步搞定。Claude Code、Codex、Gemini 三个工具全部覆盖，一份 API Key 通用。

相关链接

CC Switch 下载页面

https://github.com/farion1231/cc-switch/releases

LetAiCode 官网

https://letaicode.cn/