在AI开发与编程辅助场景中，Codex CLI凭借强大的代码生成、调试与工程化能力，成为开发者的高效工具。但Codex原生仅支持特定模型生态，无法直接对接DeepSeek等第三方大模型，核心障碍在于协议不兼容：Codex采用Responses API格式，而DeepSeek等主流第三方模型仅支持Chat Completions API格式。
CC Switch作为本地AI模型路由与协议转换工具，完美解决这一痛点：它在本地搭建中间代理，自动完成Responses→Chat Completions的协议转换，让Codex CLI无需修改任何代码，即可无缝调用DeepSeek、Kimi、MiniMax等第三方模型。本文将从零开始，详细讲解CC Switch本地路由的安装、配置、对接DeepSeek及常见问题排查，实现Codex CLI与第三方模型的完整打通。
阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。
Token Plan Token 最便宜/支持多模型切换：👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。
一、核心原理：CC Switch本地路由的协议转换逻辑
CC Switch的核心价值是本地协议转换与路由转发，整个流程对Codex完全透明，无需修改Codex配置文件或代码。其工作流程分为四步：
- 配置接管：CC Switch自动修改Codex的
config.toml配置，将其API端点指向本地路由地址http://127.0.0.1:15721/v1。 - 请求接收：Codex CLI发送Responses格式请求至本地路由服务。
- 协议转换：CC Switch将Responses格式请求解析、重构为DeepSeek兼容的Chat Completions格式，并注入真实的DeepSeek API Key。
- 响应回传：接收DeepSeek返回的结果，转换回Responses格式后返回给Codex CLI，完成整个调用链路。
这种架构的优势在于：API Key安全隔离（仅存储在CC Switch中，Codex配置文件无真实密钥）、多模型统一管理、零代码修改、本地断网可用（仅模型调用需联网）。
二、环境准备：安装前的必备条件
在开始部署前，需完成以下环境准备，确保所有组件正常运行：
2.1 系统与软件要求
- 操作系统：Windows 10/11、macOS 10.15+、Linux Ubuntu 20.04+（三大主流系统均支持）。
- Node.js环境：Codex CLI依赖Node.js，需安装v18.0+版本（推荐v20 LTS）。
- 终端工具：Windows用PowerShell/CMD，macOS/Linux用Terminal（后续命令均在终端执行）。
- 网络环境：稳定网络（用于下载安装包、获取DeepSeek API Key、模型调用）。
2.2 安装Node.js（Codex CLI依赖）
- 访问Node.js官网（nodejs.org），下载对应系统的LTS版本安装包。
- 安装完成后，打开终端验证：
若输出版本号（如v20.12.0），则安装成功。node -v # 验证Node.js版本 npm -v # 验证npm版本
2.3 安装Codex CLI
- 打开终端，执行npm命令全局安装Codex CLI：
npm install -g @openai/codex - 验证安装：
输出版本号（如v0.12.0）即安装成功。首次安装后，Codex会在用户目录生成配置文件：codex --version
- Windows：
C:\Users\你的用户名\.codex\ - macOS/Linux：
~/.codex/
包含auth.json（密钥存储）和config.toml（模型配置）两个核心文件。
2.4 获取DeepSeek API Key
- 访问DeepSeek开发者平台（platform.deepseek.com），注册并登录账号。
- 进入「API密钥」页面，点击「创建新密钥」，复制生成的
sk-xxxx密钥（妥善保管，切勿泄露）。 - 记录DeepSeek API基础地址：
https://api.deepseek.com（Chat Completions端点为/v1/chat/completions）。
三、第一步：安装与启动CC Switch
CC Switch是整个流程的核心，需安装最新版本以确保兼容性。
3.1 下载CC Switch安装包
- 访问CC Switch GitHub Releases页面（github.com/farion1231/cc-switch/releases），下载对应系统的最新版本安装包：
- Windows：
CC-Switch-vx.x.x-Windows.msi - macOS：
CC-Switch-vx.x.x-macOS.dmg - Linux：
CC-Switch-vx.x.x-Linux.AppImage
- Windows：
- 双击安装包，按照向导完成安装（建议勾选「创建桌面快捷方式」）。
3.2 启动CC Switch
安装完成后，启动CC Switch，初始界面包含多个工具标签（Codex、Claude、Gemini等），默认进入Codex配置页面。
四、第二步：CC Switch配置DeepSeek供应商
CC Switch内置DeepSeek预设配置，无需手动填写协议参数，仅需填入API Key即可完成配置。
4.1 进入Codex供应商配置页
- 在CC Switch顶部标签栏，点击「Codex / GPT」图标，进入Codex供应商管理页面。
- 点击右上角「+」按钮，新建供应商配置。
4.2 选择DeepSeek预设
在「添加新供应商」页面，找到「预设供应商」下拉菜单，选择「DeepSeek」。选择后，CC Switch会自动填充以下关键参数（无需修改）：
- API请求地址：
https://api.deepseek.com - 默认模型：
deepseek-v4-pro（可后续修改为deepseek-v4-flash等） - 协议类型：自动识别为Chat Completions，开启「需要本地路由映射」。
4.3 填入DeepSeek API Key
在「API Key」输入框中，粘贴之前获取的DeepSeek API Key（sk-xxxx）。
4.4 保存并启用供应商
- 点击「保存」按钮，完成DeepSeek供应商配置。
- 在供应商列表中，找到刚创建的「DeepSeek」配置，点击右侧「启用」按钮，状态变为「使用中」。
五、第三步：开启CC Switch本地路由（核心步骤）
本地路由是协议转换的核心，必须开启才能让Codex CLI通过CC Switch调用DeepSeek。
5.1 进入本地路由设置
- 点击CC Switch右上角「设置」图标（齿轮形状），进入设置页面。
- 在左侧菜单栏选择「路由」，展开「本地路由」区域。
5.2 开启路由服务
在本地路由设置中，完成两个关键开关：
- 路由总开关：点击开启，本地代理服务在
127.0.0.1:15721端口启动。 - Codex路由：勾选开启，仅让Codex的请求走本地路由（其他工具如Claude可保持关闭）。
5.3 验证路由状态
开启后，CC Switch会自动修改Codex的config.toml配置，将base_url指向http://127.0.0.1:15721/v1，并在auth.json中填入占位符密钥（真实密钥仍存储在CC Switch中）。可手动验证配置文件：
# macOS/Linux查看config.toml
cat ~/.codex/config.toml
# Windows查看config.toml
type C:\Users\你的用户名\.codex\config.toml
确认base_url为http://127.0.0.1:15721/v1，即配置生效。
六、第四步：Codex CLI调用DeepSeek模型实战
配置完成后，即可通过Codex CLI正常调用DeepSeek模型，所有命令与原生Codex完全一致。
6.1 基础对话调用
打开终端，执行codex命令进入交互模式，直接发送问题：
codex
进入交互模式后，输入问题：
请解释什么是大模型协议转换
Codex CLI会通过CC Switch本地路由转发请求至DeepSeek，返回结果后展示在终端中。
6.2 代码生成实战（核心场景）
Codex CLI最常用的场景是代码生成，以下示例调用DeepSeek生成Python代码：
# 直接在终端执行代码生成命令
codex "生成一个Python函数，实现冒泡排序算法，并添加详细注释"
DeepSeek会返回完整的冒泡排序代码及注释，Codex CLI自动格式化输出。
6.3 命令行参数调用（非交互模式）
通过命令行参数直接调用，适合脚本集成：
# 非交互模式调用DeepSeek生成代码
codex --model deepseek-v4-pro "生成一个Node.js Express接口，返回Hello World"
--model参数可指定DeepSeek的具体模型（如deepseek-v4-flash、deepseek-chat）。
6.4 模型切换与管理
CC Switch支持同时配置多个第三方模型（如DeepSeek、Kimi、MiniMax），在CC Switch供应商列表中切换「启用」状态，即可在Codex CLI中无缝切换模型，无需重启Codex。
七、进阶配置：自定义模型与参数优化
7.1 修改默认模型
在CC Switch的DeepSeek供应商配置中，可修改「默认模型」为其他DeepSeek模型：
deepseek-v4-pro：旗舰版，适合复杂代码、长文本处理deepseek-v4-flash：轻量版，速度更快，成本更低deepseek-chat：通用对话版（即将弃用，推荐使用v4系列）
7.2 调整生成参数
在CC Switch的供应商配置中，可调整以下生成参数（影响模型输出风格）：
- Temperature：温度值（0-1），值越低输出越严谨，值越高越有创意（默认0.7）。
- Max Tokens：最大生成长度（默认1024，可根据需求调整）。
- Reasoning Effort：推理力度（高/中/低），影响模型思考深度。
7.3 本地路由端口修改（可选）
若15721端口被占用，可在CC Switch「设置→路由→本地路由」中修改端口号，修改后CC Switch会自动更新Codex的config.toml配置。
八、常见问题与避坑指南
8.1 Codex CLI报错404 Not Found
- 原因：本地路由未开启，或
config.toml的base_url未指向本地路由。 - 解决：
- 确认CC Switch本地路由总开关与Codex路由已开启。
- 手动检查
~/.codex/config.toml，确保base_url = "http://127.0.0.1:15721/v1"。 - 重启Codex CLI与CC Switch。
8.2 提示「找不到/responses端点」
- 原因：未开启本地路由，DeepSeek原生不支持Responses API。
- 解决：必须开启CC Switch本地路由，由其完成协议转换。
8.3 模型调用失败，返回「API Key无效」
- 原因：DeepSeek API Key填写错误，或密钥已过期/被禁用。
- 解决：
- 重新复制DeepSeek API Key，在CC Switch中更新配置。
- 登录DeepSeek平台，检查密钥状态与额度。
8.4 Codex CLI无响应，或响应缓慢
- 原因：网络波动、DeepSeek服务器繁忙、本地路由端口冲突。
- 解决：
- 检查网络连接，尝试切换网络。
- 修改CC Switch本地路由端口，重启服务。
- 选择
deepseek-v4-flash轻量模型，提升响应速度。
8.5 CC Switch无法修改Codex配置文件
- 原因：权限不足，或配置文件被锁定。
- 解决：
- 以管理员身份启动CC Switch（Windows右键→以管理员身份运行；macOS/Linux用
sudo）。 - 手动删除
~/.codex/config.toml与auth.json，重启CC Switch自动重新生成。
- 以管理员身份启动CC Switch（Windows右键→以管理员身份运行；macOS/Linux用
九、总结与扩展
通过CC Switch本地路由，我们实现了Codex CLI与DeepSeek等第三方模型的无缝对接，核心价值在于：
- 协议兼容：解决Responses与Chat Completions的格式壁垒，让Codex支持更多模型生态。
- 安全隔离：API Key仅存储在CC Switch中，Codex配置无敏感信息，提升安全性。
- 统一管理：集中管理多个模型供应商，一键切换，无需重复配置。
- 零代码修改：Codex CLI使用方式完全不变，降低学习成本。
除DeepSeek外，该流程同样适用于Kimi、MiniMax、GLM等其他第三方模型，仅需在CC Switch中选择对应预设、填入API Key并开启本地路由即可。CC Switch作为本地AI路由工具，为开发者提供了更灵活、更安全的模型调用方案，是打通Codex与第三方模型生态的最佳实践。
