CC Switch 图形化配置教程

CC Switch 是一款免费的桌面应用，通过图形界面管理 Claude Code、Codex 等 AI 编程工具的接入配置——不用手动改环境变量和配置文件。本教程演示如何安装 CC Switch 并接入 Router One。

开始之前，请先在 Dashboard API Keys 页面创建你的 API Key（格式： sk-xxx）。

如果你习惯使用终端，可以直接按手动配置指南操作。CC Switch 适合不想折腾环境变量和配置文件的用户。 CLI 配置指南

CC Switch 是开源软件，提供 macOS、Windows、Linux 安装包。

通过 Homebrew 安装（推荐）：

bash

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

或者到 GitHub Releases 页面下载 .dmg 安装包，把 CC Switch 拖进「应用程序」文件夹即可。应用已通过 Apple 签名和公证，可直接打开。

CC Switch 只负责管理已安装 CLI 工具的配置，不会代为安装。如果还没有安装，先装好 Claude Code（或 Codex）：

bash

npm install -g @anthropic-ai/claude-code

不熟悉 Node.js 或 CLI 安装？手动 CLI 配置指南里有各操作系统的逐步说明。 CLI 配置指南

打开 CC Switch，选择要配置的工具（例如 Claude Code），点击「添加供应商」，填写：

名称	Router One（任意备注名）
API Key	sk-your-api-key — 第 0 步创建的密钥

API 地址（Base URL）— 按工具区分：

text

Claude Code:
https://api.router.one

Codex / 其他 OpenAI 兼容工具:
https://api.router.one/v1

在 CC Switch 中点击 Router One 条目，将其设为当前供应商。CC Switch 会自动改写对应工具的配置文件。

Claude Code 支持热切换，无需重启即可生效；其他工具（如 Codex）切换后需要重启终端或 CLI 会话。

然后照常启动 CLI 验证，例如：

bash

claude

CC Switch 是第三方开源项目（github.com/farion1231/cc-switch），与 Router One 无隶属关系。如遇安装问题，可查看该项目的 issues 页面。