CC-Switch 如何配置 API

CC-Switch 安装（如果已经安装可以跳过这部分）

All-in-One AI CLI 管理器 - 桌面应用程序

CC-Switch 相关链接

• GitHub 发布页：https://github.com/farion1231/cc-switch/releases
• CC-Switch 文档站：https://ccswitch.lovable.app/

工具介绍

CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示和 Claude Skills 管理。

💡 核心功能：

• 一键切换不同 AI 工具的提供商配置
• API 端点速度测试与质量指示器
• 多预设系统提示管理
• MCP 服务器统一架构管理
• Claude Skills 发现与安装系统
• 配置备份/恢复（自动保留最近 10 个）
• 深度链接协议支持（ccswitch://）
• 环境变量冲突检测

安装方法

Windows 平台

方法一：MSI 安装器（推荐）

1. 访问项目发布页：https://github.com/farion1231/cc-switch/releases
2. 下载最新版本的 .msi 安装器
3. 运行安装器，按照向导完成安装
4. 安装完成后从开始菜单启动 CC-Switch

方法二：便携版（无需安装）

1. 下载 .zip 便携版压缩包
2. 解压到任意目录
3. 运行 cc-switch.exe 即可使用

macOS 平台

推荐方式：Homebrew 安装

• MacOS 安装推荐使用 HomeBrew
• 开启终端后，分别运行以下命令：

# 添加 tap 源
brew tap farion1231/ccswitch
# 安装 CC-Switch
brew install --cask cc-switch

• 安装完成后，在「启动台」或「应用程序」文件夹中找到 CC-Switch 并启动。

Linux 平台

Debian/Ubuntu 系列（推荐）

sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f  # 修复依赖

AppImage 通用版本

chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage

Arch Linux（AUR）

paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin

Claude Code 配置

1. 打开你下载的 CC Switch 软件
2. 在分组条中，将分组选择至「Claude」
3. 点右上角加号
4. 向下滚动页面
5. 分别填入：
   • 供应商名称：openclaw-api
   • 官网链接：https://cn.openclaw-api.com
   • 请求地址：https://cn.openclaw-api.com
   • API Key：在 openclaw-api 令牌管理中，创建或者创建令牌，点击复制按钮，复制 API Key 到剪切板，粘贴到 API Key 选项中
6. 点添加
7. 添加成功后，在主界面会看到我们配置的分组，在右侧点击「启用」按钮，显示「使用中」，则配置完成
8. 点击左上角「设置」按钮，在通用页面下拉找到「跳过 Claude Code 初次安装确认」，务必勾选
9. 在终端运行 claude，看到对话界面并能正常回复即表示配置完成

Codex 配置

1. 打开你下载的 CC Switch 软件，你会看到初始界面
2. 在分组条中，将分组选择至「Codex」
3. 点右上角加号
4. 向下滚动页面
5. 分别填入：
   • 供应商名称：openclaw-api
   • 官网链接：https://cn.openclaw-api.com
   • 请求地址（注意这里必须加 /v1）：https://cn.openclaw-api.com/v1
   • API Key：在 openclaw-api 令牌管理中，创建或者创建令牌，点击复制按钮，复制 API Key 到剪切板，粘贴到 API Key 选项中
6. 点获取模型列表
7. 选模型
8. 点添加
9. 添加成功后，在主界面会看到我们配置的分组，在右侧点击「启用」按钮，显示「使用中」，则配置完成
10. 运行 codex，看到对话界面并能正常回复即表示配置完成（codex 桌面端、codex cli、vscode 的 codex 插件均共享这套配置）