AI Agent 开发实战（04）：CCSwitch 配置

发布时间：2026-07-14
标签：AI Agent｜实战｜Claude Code｜CCSwitch｜操作指南

---

目标

把第 02 篇（DeepSeek）和第 03 篇（OpenRouter）里手敲的 $env: 临时变量，变成永久配置——装好 CC-Switch 后，点一下就能在官方 / DeepSeek / OpenRouter 之间切换，重启终端也照样生效，再也不用每次重设环境变量。

💡 前 two 篇都标了"临时变量简单版"，本文就是预告过的正式方案。

---

环境准备

• 已完成 第 01 篇（Claude Code 已安装并能启动）
• 一个 DeepSeek API Key（platform.deepseek.com）和/或 OpenRouter API Key（openrouter.ai → Keys）
• Windows 10 / 11（本文按 Windows 截图步骤写，Mac / Linux 思路一致，只是安装包不同）
• 能访问 GitHub（去下载安装包）

---

步骤

1. 下载并安装 CC-Switch

打开 github.com/farion1231/cc-switch/releases，拉到下方 Assets，按系统下载：

• Windows：文件名带 Setup 的 .exe（如 CC-Switch-Setup-x.x.x.exe），双击安装
• Mac：.dmg；Linux：.AppImage 或 .deb

安装完首次启动，CC-Switch 会自动检测已安装的 Claude Code，左侧客户端列表里第一个就是 Claude Code。

---

2. 添加 DeepSeek（官网直连路径）

点击右上角 + 号 → 从预设列表选 DeepSeek（v3.15.0 内置 44 个预设，直接搜就能找到）→ 填入你的 DeepSeek API Key → 模型下拉选 deepseek-v4-pro（或 deepseek-v4-flash 省成本）。

其它字段 CC-Switch 已经帮你填好（它知道 DeepSeek 的 Anthropic 兼容端点），不用手改。点「添加」保存。

---

3. 添加 OpenRouter（中转站路径）

同样点 + → 选 OpenRouter 预设（若列表里没有，选「自定义配置」手动填）：

• API KEY：sk-or-你的openrouter key
• API 请求地址：https://openrouter.ai/api/anthropic（注意是 Anthropic 兼容端点，不是 OpenRouter 默认端点）
• 模型：deepseek/deepseek-v4-pro（厂商/模型 斜杠格式，和 03 篇一致）

点「添加」保存。现在你的 Provider 列表里同时有 DeepSeek 和 OpenRouter 两套配置。

---

4. 开启路由开关（关键，漏了会调用失败）

点顶部齿轮 设置 → 打开两处开关：

1. 路由总开关（必须开）
2. Claude 路由开关（必须开，否则请求不走 CC-Switch 的代理）

关掉设置面板。

---

5. 启用某个 Provider，配置自动写入

回到列表，点击你想用的那一条（比如 DeepSeek）右侧的 启用。CC-Switch 会立刻把配置写进 ~/.claude/settings.json 的 env 字段——你不用碰任何 JSON。

想换模型时，重复这一步：点另一条（OpenRouter）→ 启用，配置即刻覆盖。

---

6. 重启终端并验证

彻底关掉所有终端窗口和 VS Code，重新打开一个终端，让新配置生效：

claude status

输出里出现 api.deepseek.com / deepseek-v4-pro（或你启用的对应 Provider 和模型），说明 CC-Switch 的配置已经接管 Claude Code。

---

验证

三步全过 = 接入成功：

1. CC-Switch 列表里能看到 DeepSeek / OpenRouter，且某一条处于「启用」状态
2. claude status 显示当前 Provider 的地址和模型名
3. 进 claude 问一句"你现在的底层模型是什么"，回复确认走的是启用那家的模型

切换测试：在 CC-Switch 里换启用 OpenRouter → 重启终端 → claude status 应变成 openrouter.ai 相关地址，说明切换永久生效。

---

踩坑记录

1. 启用后模型没变
没关旧终端。CC-Switch 写的是全局 settings.json，必须彻底关闭所有终端 + VS Code 重开才生效。只关 Claude Code 交互界面没用。

2. 调 DeepSeek / OpenRouter 时报 401 或连不上
九成是路由开关没开（步骤 4）。两个开关都打开后，CC-Switch 才会在本地起路由把请求转给对应 Provider。

3. OpenRouter 填错地址
OpenRouter 有两套 API：默认 https://openrouter.ai/api/v1（OpenAI 格式）和 Anthropic 兼容 https://openrouter.ai/api/anthropic。Claude Code 走后者，地址填错会直接 404。

4. 想临时换模型不想改全局
不用动 CC-Switch——进 claude 后输入 /model 可直接选模型（如 /model claude-sonnet-4-6），但会重读整个对话历史，长对话费 Token。CC-Switch 负责"默认用哪家"，/model 负责"这次临时换"。

5. 预设里找不到小众模型
用「自定义配置」手填：供应商名随意、Key 必填、API 地址填那家的 Anthropic 兼容端点（参考 02/03 篇的 BASE_URL）。CC-Switch 本质就是帮你把这些写进 settings.json。

---

下一步

现在 DeepSeek（官网）、OpenRouter（中转站）都接好了，CC-Switch 一键切换、永久生效——开发环境彻底成型。

但 Claude Code 再强也只是工具，真正的 Agent 要能调用工具、记住上下文：

→ AI Agent 开发实战（05）：Hermes 安装

第 05 篇装 Hermes——把前面这套模型底座，变成你本地随叫随到的 AI 助手。