文章信息

预计字数：2800 字 阅读时间：9 分钟 难度等级：⭐⭐（小白友好，跟着步骤操作即可）

核心价值：从零安装 CC Switch，5 分钟搞定多个 AI 工具的配置管理

---

你的 Claude Code、Codex、Gemini CLI、GLM 各种 API Key、Base URL、模型名也在到处散落吗？

今天改 .zshrc，明天改 config.toml，后天又忘了到底哪个配置正在生效。

CC Switch 就是用来解决这个问题的小工具。

它可以把 Claude、Codex、OpenClaw、Hermes Agent 等 CLI 工具的供应商配置集中管理起来，需要切换时点一下就行。

我以 macOS 为例，带你从零安装 CC Switch，并演示如何添加 OpenRouter 供应商。

---

一、安装前先确认 Node.js

CC Switch 自己是桌面应用，但它管理的 Claude Code、Codex、Gemini CLI 通常需要 Node.js 环境。

打开终端，输入：

node --version
npm --version

如果能看到版本号，说明 Node.js 已经装好了。

如果没有安装，可以选择其中一种方式。

如果你有 Homebrew，运行：

brew install node

或者用 nvm：

先运行：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

然后重新打开终端，再运行：

nvm install --lts

---

二、下载并安装 CC Switch

打开 CC Switch 的 GitHub Releases 页面：

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

macOS 用户优先下载：

• CC-Switch-v版本号-macOS.dmg
• 或者 CC-Switch-v版本号-macOS.zip

下载后按照普通 macOS 软件的方式安装：

1. undefined. 如果是 .dmg，打开后把 CC Switch 拖进"应用程序"
2. undefined. 如果是 .zip，解压后把 CC Switch 放进"应用程序"
3. undefined. 从"应用程序"里启动 CC Switch

如果你电脑上已经装了 Homebrew，也可以直接用官方推荐方式：

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

启动成功后，会看到类似这样的主界面：

---

三、第一次打开时，先看顶部黄色提示

如果你看到"检测到系统环境变量冲突"，不要慌。

这通常说明你之前在系统环境变量、.zshrc 或其他配置文件里写过类似这些内容：

ANTHROPIC_API_KEY=***
ANTHROPIC_BASE_URL=...
GEMINI_API_KEY=***

这些变量可能会覆盖 CC Switch 里的配置，导致你明明在软件里切换了供应商，命令行里却还是走旧配置。

新手建议先记住一个原则：

如果你想让 CC Switch 完整接管配置，就尽量不要再手动写全局的 ANTHROPIC_*、OPENAI_*、GEMINI_* 环境变量。

---

四、添加第一个供应商

在主界面右上角点击 +，第一次添加时可能会弹出"关于通用配置"的提示。

这个提示的大意是：CC Switch 可以把一些通用配置片段保留下来，比如插件、环境变量、Hook 等。

新手不用急着理解，点"我知道了"继续即可。

接下来会进入添加供应商界面

这里你会看到很多预设供应商

比如 Claude Official、OpenRouter、DeepSeek、Kimi、MiniMax、SiliconFlow 等。

新手优先用"预设供应商"，因为预设会自动填好请求地址和基础配置，你通常只需要填写 API Key。

CC Switch 工作原理

用一张图看清楚 CC Switch 在你的系统里扮演什么角色：

• 没有 CC Switch 时： 每个工具各自读 .zshrc 或自己的配置文件，改一个地方其他地方可能不生效，容易混乱。
• 有 CC Switch 后： 所有工具的供应商配置统一由 CC Switch 管理，切换一次，所有工具同步生效。

---

五、以 OpenRouter 为例配置供应商

在预设列表里点击 OpenRouter。

选中后，CC Switch 会自动填好这些信息：

配置项	值
供应商名称	OpenRouter
官网链接	https://openrouter.ai
请求地址	https://openrouter.ai/api

你需要自己做三件事：

1. undefined. 去 OpenRouter 注册账号

1. undefined. 创建 API Key
2. undefined. 把 API Key 填进 CC Switch 的 API Key 输入框

OpenRouter 的 API Key 页面：

https://openrouter.ai/settings/keys

如果你还没登录，它会自动跳转到登录/注册页面。

---

六、填写 Ling-2.6-1T 免费模型

目前 OpenRouter 上有一个很适合新手尝鲜的免费模型：

inclusionai/ling-2.6-1t:free

在 CC Switch 的 OpenRouter 预设里，展开"高级选项"。

把模型映射里的 主模型、Haiku、Sonnet、Opus 都填成：

inclusionai/ling-2.6-1t:free

填好后，确认 API Key 也已经填写，再点右下角"添加"。

添加成功后，回到供应商列表，找到 OpenRouter 卡片，点击"启用"。

启用后，Claude Code 就会使用这套 OpenRouter 配置。

模型映射说明

Claude Code 内部用 Haiku/Sonnet/Opus 来区分不同复杂度的任务。CC Switch 的"模型映射"功能让你把这些角色映射到任意模型上：

这样所有任务都走同一个免费模型，对新手来说最省事。

🥛 提示：如果你以后买了付费模型，可以只在 Opus 里填付费模型，Haiku 和 Sonnet 继续用免费的，省钱又够用。

---

七、切换后怎么验证

打开终端，运行：

claude

然后输入一句简单的问题：

你好，请用一句话介绍你自己。

如果模型正常回复，说明配置已经生效。

如果没有生效，优先检查三件事：

1. undefined. 顶部是否还有环境变量冲突提示
2. undefined. OpenRouter API Key 是否填错
3. undefined. 当前供应商卡片是否显示"使用中"

不同 CLI 的生效方式也不一样：

CLI 工具	生效方式
Claude Code	通常即时生效
Codex	建议关闭并重新打开终端
Gemini	通常即时生效
OpenCode	建议关闭并重新打开终端
OpenClaw	建议关闭并重新打开终端

📍 注意：如果切换后不生效，先关终端再开终端，90% 的问题都能解决。

---

八、为什么推荐 OpenRouter 的 Ling-2.6-1T

OpenRouter 当前页面显示，inclusionai/ling-2.6-1t:free 是 Ling-2.6-1T 的免费版本。

它的几个亮点：

特性	值
模型 ID	inclusionai/ling-2.6-1t:free
输入价格	$0/M input tokens
输出价格	$0/M output tokens
上下文窗口	262,144 tokens
适用场景	编码、复杂推理、大规模任务执行

262,144 tokens 的上下文窗口，意味着你可以直接把整个代码项目丢进去，不用反复复制粘贴。

❌ 注意：OpenRouter 页面显示这个免费版本有结束时间，活动可能随时变化。趁免费赶紧用。

• OpenRouter 模型页：https://openrouter.ai/inclusionai/ling-2.6-1t:free
• 注册/创建 API Key：https://openrouter.ai/settings/keys

---

九、最后给新手的一句话建议

不要一上来就折腾十几个供应商。

先选一个你能跑通的，比如 OpenRouter，完成"添加供应商 → 启用 → 终端测试"这条最短路径。

只要这条路径跑通了，后面你再添加 DeepSeek、Kimi、Gemini、Codex，逻辑都是一样的：

选预设 → 填 Key → 选模型 → 启用 → 测试

CC Switch 最值钱的地方，不是功能多，而是让你少改配置文件。

对新手来说，这一点就已经很够用了。

完整配置流程回顾

---

#CC Switch #AI工具 #配置管理 #Claude Code #Codex #OpenRouter

相关链接

• CC Switch GitHub: https://github.com/farion1231/cc-switch
• OpenRouter 官网: https://openrouter.ai
• Ling-2.6-1T 免费模型: https://openrouter.ai/inclusionai/ling-2.6-1t:free