零配置兼容！CC Switch让Codex CLI无缝调用DeepSeek模型教程

在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配置文件或代码。其工作流程分为四步：

1. 配置接管：CC Switch自动修改Codex的config.toml配置，将其API端点指向本地路由地址http://127.0.0.1:15721/v1。
2. 请求接收：Codex CLI发送Responses格式请求至本地路由服务。
3. 协议转换：CC Switch将Responses格式请求解析、重构为DeepSeek兼容的Chat Completions格式，并注入真实的DeepSeek API Key。
4. 响应回传：接收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依赖）

1. 访问Node.js官网（nodejs.org），下载对应系统的LTS版本安装包。
2. 安装完成后，打开终端验证：

   node -v  # 验证Node.js版本
   npm -v   # 验证npm版本
   

   若输出版本号（如v20.12.0），则安装成功。

2.3 安装Codex CLI

1. 打开终端，执行npm命令全局安装Codex CLI：

   npm install -g @openai/codex
   

2. 验证安装：

   codex --version
   

   输出版本号（如v0.12.0）即安装成功。首次安装后，Codex会在用户目录生成配置文件：

• Windows：C:\Users\你的用户名\.codex\
• macOS/Linux：~/.codex/
  包含auth.json（密钥存储）和config.toml（模型配置）两个核心文件。

2.4 获取DeepSeek API Key

1. 访问DeepSeek开发者平台（platform.deepseek.com），注册并登录账号。
2. 进入「API密钥」页面，点击「创建新密钥」，复制生成的sk-xxxx密钥（妥善保管，切勿泄露）。
3. 记录DeepSeek API基础地址：https://api.deepseek.com（Chat Completions端点为/v1/chat/completions）。

三、第一步：安装与启动CC Switch

CC Switch是整个流程的核心，需安装最新版本以确保兼容性。

3.1 下载CC Switch安装包

1. 访问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
2. 双击安装包，按照向导完成安装（建议勾选「创建桌面快捷方式」）。

3.2 启动CC Switch

安装完成后，启动CC Switch，初始界面包含多个工具标签（Codex、Claude、Gemini等），默认进入Codex配置页面。

四、第二步：CC Switch配置DeepSeek供应商

CC Switch内置DeepSeek预设配置，无需手动填写协议参数，仅需填入API Key即可完成配置。

4.1 进入Codex供应商配置页

1. 在CC Switch顶部标签栏，点击「Codex / GPT」图标，进入Codex供应商管理页面。
2. 点击右上角「+」按钮，新建供应商配置。

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 保存并启用供应商

1. 点击「保存」按钮，完成DeepSeek供应商配置。
2. 在供应商列表中，找到刚创建的「DeepSeek」配置，点击右侧「启用」按钮，状态变为「使用中」。

五、第三步：开启CC Switch本地路由（核心步骤）

本地路由是协议转换的核心，必须开启才能让Codex CLI通过CC Switch调用DeepSeek。

5.1 进入本地路由设置

1. 点击CC Switch右上角「设置」图标（齿轮形状），进入设置页面。
2. 在左侧菜单栏选择「路由」，展开「本地路由」区域。

5.2 开启路由服务

在本地路由设置中，完成两个关键开关：

1. 路由总开关：点击开启，本地代理服务在127.0.0.1:15721端口启动。
2. 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未指向本地路由。
• 解决：
  1. 确认CC Switch本地路由总开关与Codex路由已开启。
  2. 手动检查~/.codex/config.toml，确保base_url = "http://127.0.0.1:15721/v1"。
  3. 重启Codex CLI与CC Switch。

8.2 提示「找不到/responses端点」

• 原因：未开启本地路由，DeepSeek原生不支持Responses API。
• 解决：必须开启CC Switch本地路由，由其完成协议转换。

8.3 模型调用失败，返回「API Key无效」

• 原因：DeepSeek API Key填写错误，或密钥已过期/被禁用。
• 解决：
  1. 重新复制DeepSeek API Key，在CC Switch中更新配置。
  2. 登录DeepSeek平台，检查密钥状态与额度。

8.4 Codex CLI无响应，或响应缓慢

• 原因：网络波动、DeepSeek服务器繁忙、本地路由端口冲突。
• 解决：
  1. 检查网络连接，尝试切换网络。
  2. 修改CC Switch本地路由端口，重启服务。
  3. 选择deepseek-v4-flash轻量模型，提升响应速度。

8.5 CC Switch无法修改Codex配置文件

• 原因：权限不足，或配置文件被锁定。
• 解决：
  1. 以管理员身份启动CC Switch（Windows右键→以管理员身份运行；macOS/Linux用sudo）。
  2. 手动删除~/.codex/config.toml与auth.json，重启CC Switch自动重新生成。

九、总结与扩展

通过CC Switch本地路由，我们实现了Codex CLI与DeepSeek等第三方模型的无缝对接，核心价值在于：

1. 协议兼容：解决Responses与Chat Completions的格式壁垒，让Codex支持更多模型生态。
2. 安全隔离：API Key仅存储在CC Switch中，Codex配置无敏感信息，提升安全性。
3. 统一管理：集中管理多个模型供应商，一键切换，无需重复配置。
4. 零代码修改：Codex CLI使用方式完全不变，降低学习成本。

除DeepSeek外，该流程同样适用于Kimi、MiniMax、GLM等其他第三方模型，仅需在CC Switch中选择对应预设、填入API Key并开启本地路由即可。CC Switch作为本地AI路由工具，为开发者提供了更灵活、更安全的模型调用方案，是打通Codex与第三方模型生态的最佳实践。