26万上下文免费模型终于能用了，CC Switch一键配置，手慢无

文章信息

预计字数：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 会自动填好这些信息：

你需要自己做三件事：

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 的生效方式也不一样：

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

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

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

它的几个亮点：

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