一、需要的软件
1.1 Codex CLI（命令行工具）
Codex CLI 是 OpenAI 推出的 AI 编程助手命令行版本，支持插件扩展机制。通过它可以在终端环境中使用 AI 辅助编程功能。
- 下载地址：https://codex.chat/ 或应用商店搜索 Codex
1.2 cc-switch 插件
cc-switch 是连接 Codex 与国产大模型的桥梁插件，安装到 Codex CLI 后，即可在本地切换使用不同的国产大模型 API。
支持的国产模型：
- DeepSeek（深度求索）
- 通义千问（阿里云）
- 智谱 GLM（智谱 AI）
- Kimi（月之暗面）
- 百度文心一言
- 讯飞星火
- 下载地址：https://github.com/farion1231/cc-switch
安装成功后界面：
1.3 Codex 客户端（可选）
Codex 客户端提供图形界面，方便管理插件和配置。如仅使用命令行，可跳过此步骤。
1.4 API Key 准备
使用国产大模型前，需要在对应平台获取 API Key。获取方式如下：
- DeepSeek：https://platform.deepseek.com/ → 注册 → 控制台 → API Keys → 创建密钥
- 通义千问：阿里云百炼平台 → API-KEY 管理 → 创建 API Key
- 智谱 GLM：https://open.bigmodel.cn/ → 控制台 → API Keys → 创建密钥
- Kimi：https://platform.moonshot.cn/ → 控制台 → API Keys
- 文心一言：百度智能云千帆平台 → API Key
- 讯飞星火：讯飞开放平台 → API Key
注意：API Key 只会显示一次，请妥善保管。建议设置用量限制。
二、安装步骤
第一步：安装配置 Codex CLI
- 访问 https://codex.chat/ 下载 Codex CLI 安装包
- 打开终端，输入 codex --version 确认安装成功
- 完成安装，选择api登录，输入上面任何一个国产模型的api key即可。
第二步：安装配置 cc-switch 插件
下载插件，访问 https://github.com/farion1231/cc-switch，安装。
先说配置原理：codex--》cc-switch --》国产模型
新版 Codex CLI 面向的是 OpenAI Responses API，而 DeepSeek、Kimi、MiniMax、SiliconFlow 等很多供应商实际暴露的是 OpenAI Chat Completions 形态，也就是 /chat/completions。这两种协议的请求体、流式事件和返回结构不同，直接把 Chat 接口填进 Codex 配置里，常见结果就是模型列表不对、请求 404/400，或者流式响应无法被 Codex 正确解析。
cc-switch 的做法是让 Codex 始终连本机路由，仍以 Responses API 发送请求；路由在内部识别当前供应商是否是 Chat 格式，再把请求改写成 Chat Completions 发给上游，最后把 Chat 响应转换回 Responses 形态返回给 Codex。
本地路由工作原理（4步）
- Codex 接管时，本地配置会被写成 http://127.0.0.1:15721/v1，并强制保持 wire_api = "responses"
- Provider 的 meta.apiFormat = "openai_chat" 会告诉路由：真实上游是 Chat Completions
- 路由把 /responses 或 /v1/responses 改写到 /chat/completions，并把 Responses 请求体转换成 Chat 请求体
- 上游返回后，路由再把 Chat 的 JSON 或 SSE 转回 Codex 能理解的 Responses JSON/SSE
详细配置
第1步：配置供应商
查看配置完成后的效果：
选择预设的供应商，只需要填写API KEY即可
注意需要选择【需要本地路由映射】勾选：
第2步：配置cc-switch路由
选择设置--》路由，选择本地路由，开关都打开。
服务地址不需要修改，使用中模型可以不写。
保存后返回主界面，顶部路由开启。
第三步：Codex 连接国产大模型
打开Codex 客户端，就会自动连接cc-switch：
原理就是cc-switch配置后会更新config.toml文件的配置，其中就链接上了国产模型了。
可以开始使用啦：
四、 常见 问题
Q1：Codex报404或找不到 /responses？
通常是没有开启 Codex 接管，或者你手动把上游 Chat base URL 直接写给了 Codex。检查 ~/.codex/config.toml 是否指向 http://127.0.0.1:15721/v1。
Q2：DeepSeek上游报404？
如果用的是内置 DeepSeek 预设，先确认当前供应商确实来自预设，并且 Codex 路由已启用。只有在使用自定义供应商时，才需要额外检查 base URL：它应该是服务根地址，而不是带 /chat/completions 的完整接口路径。
Q3：/model 看不到DeepSeek模型？
保存供应商后重启 Codex。cc-switch 会生成 cc-switch-model-catalog.json 并把路径写入 model_catalog_json，但正在运行的 Codex 进程不一定会热加载模型目录。目前 Codex app 不支持多模型选择，默认使用配置的第一个模型。
Q4：开了路由但请求仍走错供应商？
确认三处状态一致：Codex 标签下当前供应商是 DeepSeek；本地路由服务正在运行；路由启用里 Codex 开关已打开。
Q5：可以用官方OpenAI Codex账号走本地路由吗？
不建议。cc-switch 会在本地路由接管模式下阻止切到官方供应商，因为用代理访问官方 API 可能带来账号风险。路由主要用于第三方、聚合或协议转换场景。
Q6：插件安装失败怎么解决？
请确认：Codex CLI 版本支持插件系统；插件文件完整且格式为 .codex-plugin；尝试以管理员权限运行；查看 Codex 日志获取具体错误信息。
Q7：提示 API Key 无效？
请检查：API Key 拼写是否正确；Key 是否已激活；账户是否有足够余额或配额；是否超过每日调用次数限制；API Key 格式是否符合平台要求。
Q8：请求超时怎么解决？
请尝试：检查网络连接是否稳定；在 API 服务非高峰期重试；减少上下文长度；在配置中增加超时时间。
Q9：是否支持代理设置？
是的，cc-switch 支持 HTTP/HTTPS 代理配置，适用于企业内网、网络受限地区或需要代理监控流量的场景。
Q10：多模型同时配置会冲突吗？
不会冲突。cc-switch 支持同时配置多个模型，各模型配置相互独立，切换时不影响其他模型。