图文教程：用国内大模型 API 跑通Codex

今天介绍一个开源工具，能让你在国内网络环境下，用 DeepSeek、Kimi、智谱等国产大模型的 API Key，直接跑通 Codex 的全部能力——读取本地项目、修改代码、执行命令。

这个工具叫CC-Switch。这篇文章从零开始，讲清楚它是什么、为什么需要它、怎么下载配置、怎么配合 Codex 使用，以及最容易踩的那些坑。!当工具链越来越长，真正的门槛往往不是技术本身，而是没人把中间那一步讲清楚。

01 先搞清楚：CC-Switch 到底是什么

很多教程一上来就让你下载 CC-Switch，但不说它到底干了什么。先把这个概念讲透，后面的配置你才能理解每一步为什么要做。

一句话定义：CC-Switch 是一个运行在你电脑本地的开源代理工具，它的核心作用是协议转换 + API 密钥管理。

具体来说，它做两件事：

第一，协议转换。Codex 底层使用的是 OpenAI 的 Responses API 接口格式，而 DeepSeek、Kimi、智谱等国内大模型使用的是 Chat Completions 接口格式。这两种格式的请求结构、参数命名、返回字段都不一样，直接把国内模型的 API 地址填进 Codex，一定会报错。CC-Switch 坐在中间，把 Codex 发出来的 Responses 格式请求，翻译成国内模型能听懂的 Chat Completions 格式，再把返回结果翻译回去交给 Codex。

第二，API 密钥可视化管理。如果不用 CC-Switch，你需要手动编辑 Codex 的 config.toml 配置文件，写错一个字符就跑不起来。CC-Switch 提供图形界面，点几下