# 新手小白如何安装并配置 CC Switch
**作者**: Cheery
**日期**: 2026-05-01T01:31:46.000Z
**来源**: [https://x.com/cheery9998/status/2050025352534122793](https://x.com/cheery9998/status/2050025352534122793)
---
如果你同时在用 Claude Code、Codex、Gemini CLI，最烦人的事情通常不是模型本身，而是各种 API Key、Base URL、模型名到处散落。
今天改 .zshrc，明天改 config.toml，后天又忘了到底哪个配置正在生效。
CC Switch 就是用来解决这个问题的小工具。
它可以把 Claude、Codex、Gemini、OpenCode、OpenClaw 等 CLI 工具的供应商配置集中管理起来，需要切换时点一下就行。
本文以 macOS 为例，带你从零安装 CC Switch，并演示如何添加 OpenRouter 供应商。
文章最后我也会推荐一个适合新手尝鲜的免费模型：
inclusionai/ling-2.6-1t:free
一、安装前先确认 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/releases/latest
macOS 用户优先下载：
CC-Switch-v版本号-macOS.dmg
或者：
CC-Switch-v版本号
下载后按照普通 macOS 软件的方式安装：
1. 如果是 .dmg，打开后把 CC Switch 拖进“应用程序”。
2. 如果是 .zip，解压后把 CC Switch 放进“应用程序”。
3. 从“应用程序”里启动 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。
五、以 OpenRouter 为例配置供应商
在预设列表里点击 OpenRouter。
选中后，CC Switch 会自动填好这些信息：
供应商名称：OpenRouter
官网链接：https://openrouter.ai
请求地址：https://openrouter.ai/api
你需要自己做三件事：
1. 去 OpenRouter 注册账号。
2. 创建 API Key。
3. 把 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
然后输入一句简单的问题：
你好，请用一句话介绍你自己。
如果模型正常回复，说明配置已经生效。
如果没有生效，优先检查三件事：
1. 顶部是否还有环境变量冲突提示。
2. OpenRouter API Key 是否填错。
3. 当前供应商卡片是否显示“使用中”。
不同 CLI 的生效方式也不一样：
Claude Code：通常即时生效
Codex：建议关闭并重新打开终端
Gemini：通常即时生效
OpenCode：建议关闭并重新打开终端
OpenClaw：建议关闭并重新打开终端
八、为什么推荐 OpenRouter 的 Ling-2.6-1T
OpenRouter 当前页面显示，inclusionai/ling-2.6-1t:free 是 Ling-2.6-1T 的免费版本。
模型 ID 是：
inclusionai/ling-2.6-1t:free
它的几个亮点：
1. 免费版本当前标注为 $0/M input tokens 和 $0/M output tokens。
2. 上下文窗口是 262,144 tokens，适合长文档和代码项目。
3. 官方介绍里提到它面向真实 Agent 工作流，适合编码、复杂推理和大规模任务执行。
OpenRouter 模型页：
https://openrouter.ai/inclusionai/ling-2.6-1t:free
注册/创建 API Key：
https://openrouter.ai/settings/keys
需要注意的是，OpenRouter 页面显示这个免费版本有结束时间，活动可能随时变化。
九、最后给新手的一句话建议
不要一上来就折腾十几个供应商。
先选一个你能跑通的，比如 OpenRouter，完成“添加供应商 → 启用 → 终端测试”这条最短路径。
只要这条路径跑通了，后面你再添加 DeepSeek、Kimi、Gemini、Codex，逻辑都是一样的：
选预设，填 Key，选模型，启用，测试。
CC Switch 最值钱的地方，不是功能多，而是让你少改配置文件。
对新手来说，这一点就已经很够用了。
💡 互动时间：你在开发中还想让哪些 AI 工具协作？有没有遇到什么奇葩的"AI 管理 AI"场景？欢迎在评论区分享 👉 想获取更多 AI 实操干货、工具资源和最新玩法，欢迎加入AI Spark「限时免费」社群 ！一起学习交流 + 资源共享，添加小助理v：rivanow，名额有限，先到先得~
## 相关链接
- [Cheery](https://x.com/cheery9998)
- [@cheery9998](https://x.com/cheery9998)
- [19K](https://x.com/cheery9998/status/2050025352534122793/analytics)
- [https://github.com/farion1231/cc-switch/releases/latest](https://github.com/farion1231/cc-switch/releases/latest)
- [https://openrouter.ai](https://openrouter.ai/)
- [https://openrouter.ai/api](https://openrouter.ai/api)
- [https://openrouter.ai/settings/keys](https://openrouter.ai/settings/keys)
- [https://openrouter.ai/inclusionai/ling-2.6-1t:free](https://openrouter.ai/inclusionai/ling-2.6-1t:free)
- [https://openrouter.ai/settings/keys](https://openrouter.ai/settings/keys)
- [Upgrade to Premium](https://x.com/i/premium_sign_up)
- [9:31 AM · May 1, 2026](https://x.com/cheery9998/status/2050025352534122793)
- [19.6K Views](https://x.com/cheery9998/status/2050025352534122793/analytics)
- [View quotes](https://x.com/cheery9998/status/2050025352534122793/quotes)
---
*导出时间: 2026/5/1 21:45:30*