Claude Code / Codex 国内接入教程（cc-switch）

前言

在 AI 大模型的冲击下，我们软件行业现在可谓是发生了翻天覆地的变化，就在上周，零 C++ 基础的我，借助 AI 强大的能力，完成了很多以前想做，但由于技术能力和精力有限而做不到的事，效率、编码质量、甚至全栈能力都得到了极大提高！跟着教程一步一步来，开启你的 AI Agent 快乐编程体验~

什么是 Agent

说白了，Agent 就是一个大模型的壳子，我理解的 Agent 主要有以下两种核心特性：

内置了一套 AI 干活的方法论（专业点叫约束条件），可以让大语言模型输出更稳定、成功率更高的回答。
内置了一套脚本，也就是供 AI 调用的工具，借助这些工具，Agent 可以帮你把大语言模型生成的输出，直接转化为落地的成果。说白了就是直接帮你把活干了

只要满足以上两点的，我都认为它是 Agent，但是现代化的 Agent 还有更多好用的特性，比如记忆、MCP 支持、Skills 调用等。

什么是 cc-switch

cc-switch 是今年 AI 圈给我惊喜最大的，我最喜欢的开源工具。

简单地说，它只是一款配置切换工具而已，但它的价值在于实现了 Codex、Claude Code、Gemini、Hermes、OpenCode、OpenClaw 这几大 Agent 巨头的统一配置管理。

有了 cc-switch，你无需到每个 Agent 配置目录下去手动改配置，直接在 cc-switch 里操作就行。

实战步骤

1. 下载 Claude Code 或者 Codex

Claude Code 官网：https://claude.com/product/claude-code
Codex 官网：https://openai.com/zh-Hans-CN/codex/

选择你喜欢的使用方式下载即可，本教程以 VS Code 插件为例，直接在 VS Code 插件中下载官网插件也非常简单：

2. 下载 cc-switch 工具

cc-switch 官网安装包：https://github.com/farion1231/cc-switch/releases/tag/v3.15.0，进度条拉到最底部下载 Windows 版安装包

下载完成后双击安装即可，打开软件后界面如下：

其中第一排的是软件默认配置，默认连接到官方的大模型。点击右上角 + 号，可以设置你的第三方模型连接信息，设置好后点击启用即可切换 Agent 工具使用的配置。除了 Claude Code 和 Codex，还支持 Gemini、OpenCode、OpenClaw、Hermes 这些 Agent。

3. 第三方大模型 API 连接信息获取

对目前国内开发者来说，推荐的渠道有两种

国产大模型：GLM、Deepseek、Kimi、Qwen、Minimax、Mimo 等
AI 中转站：这个现在市场很混乱，我就不推荐了，谨慎充值，谨防野鸡小中转随时跑路

以 Deepseek 为例（Deepseek V4 Pro 现在很便宜，到 2026 年 5 月 31 号之前有 2.5 折优惠，强烈推荐），到官网：https://platform.deepseek.com/ 注册账号，创建一个 API Key

然后到 cc-switch 中，切到 Claude 配置，点击 + 号：

然后在预设供应商中选择 Deepseek，填入你申请的 API Key 即可（预设供应商会自动填入 API 端点的地址，如果你要用第三方中转站的 API，一般可以在中转站的文档或者教程中找到 API 端点的地址）

继续往下拉，配置模型映射，建议先点击获取模型列表，如果第三方 API 支持可以直接获取到它提供的模型列表，然后根据你的需要配置模型即可。对于 Claude Code 的模型映射，推荐 Opus 对应适合处理复杂任务的大参数模型、Sonnet 对应平衡型的中型参数模型、Haiku 对应快速响应的小参数模型。