Codex：连接国内 API 并运行

用 CC Switch 的 DeepSeek 预设配置 Codex，检查模型目录并运行练习。

这篇用 CC Switch 给 Codex CLI 配置 DeepSeek API，再让它读取 README 并生成摘要。准备好 Codex、CC Switch 和自己的 DeepSeek API Key。

1. 安装

国内读者可以先用 npm 镜像。Windows 已有 Node.js/npm 时，使用OpenAI官方CLI文档的方法：

node --version
npm --version
npm install -g @openai/codex --registry=https://registry.npmmirror.com --include=optional
codex --version

--include=optional 明确保留系统对应的原生程序包；npm 默认安装可选依赖，但已有 omit=optional 配置可能把它们排除。若提示缺少平台包，检查平台、架构及镜像同步情况，不要省略这些依赖。PowerShell 拦截 npm.ps1 时改用 npm.cmd。

这条 --registry 只对本次命令生效，不修改 npm 全局配置。镜像可能有同步延迟；遇到 ETARGET，先核对包名和版本，官方源可达时把地址换成 https://registry.npmjs.org 重试。镜像不代理 GitHub、官方安装脚本或模型 API，也不代装 Node.js、Git；证书报错时保留 SSL 校验，检查网络和系统证书。

没有 npm 时，可使用官方 CLI 页的独立安装器，下载源仍需可达。macOS 已有 Homebrew 时：

brew install --cask codex
codex --version

Linux 可执行同一条 npm 镜像命令，或使用官方独立安装器。Homebrew 和独立安装器不经过这个 npm 镜像。安装完成应显示版本号；接入前与 DeepSeek 当前文档要求的客户端版本对照。

2. 准备 API Key 与客户端目录

还没有 API Key 时，先按API 与配置的完整申请流程准备；首次安装后运行一次 codex 并退出，让用户配置目录建立。需要备份时，按CC Switch 配置教程保存个人目录中的 .codex/config.toml、.codex/auth.json。若 config.toml 中设置了 model_catalog_json，也保存它指向的文件。备份可能有密钥，不上传。

3. 用 CC Switch 配置 DeepSeek

先按CC Switch 配置教程完成下载、备份、选择 Codex、添加供应商、填写 Key、启用和切回，再检查下面 Codex 特有的版本、协议和模型目录差异。

版本与协议

CC Switch v3.20.3 的 DeepSeek 原生 Responses 预设从 3.19.1 起提供，配套模型目录要求 Codex CLI 0.144.0 或以上。在终端用 codex --version 检查版本。本例走新预设的原生 Responses 直连，不开启本地路由转换；先使用预设默认的 Flash 模型跑通一遍，再研究其他模型。

不要同时运行旧的 DeepSeek 配置脚本，也不要手动粘贴整份 TOML。旧卡片和文件备份的保留方式按 CC Switch 教程处理。

已有旧卡片怎么办？

升级 CC Switch 不会自动改写过去保存的供应商。如果 DeepSeek 卡片仍有 Needs Routing／需要路由 标记，它保存的是转换路线；不要仅靠重启猜测能否直连。

先保留旧卡片作为回滚参照。官方也支持编辑已有卡片，在高级选项将上游格式改成 Responses (native)；旧模型行可能继续覆盖新版目录，初学者先采用新卡片。

4. 检查模型列表

在新开的 Codex 会话输入：

/model

列表应出现 DeepSeek 对应模型。CC Switch 会为直连路径生成 cc-switch-model-catalog.json，并把它的路径写入 model_catalog_json；只改 Base URL 而遗漏目录，可能影响模型列表和工具调用。

原生直连使用 DeepSeek 的 Responses 接口。配置中 wire_api 应为 responses，端点应属于 api.deepseek.com；具体 Provider 名称和目录路径由 CC Switch 生成，不用照抄别人的配置文件。已有自定义模型行或旧 model_catalog_json 冲突时，先检查备份与新卡片内容。

如果列表仍是旧模型，退出 Codex 后重开终端即可。

5. 简短验证

在不含隐私的练习目录运行 codex，新开会话后用 /model 确认预期模型，再只读检查 README，确认没有写入。完整的读取、创建、检查和定向修改流程见第一项任务；云模型会接收任务所需上下文，练习时使用无隐私内容。

常见问题

模型报错：检查名称、模型目录和客户端版本。
配置没生效：检查用户配置，然后重开终端和会话。
仍显示 Needs Routing：确认使用的是新版原生 Responses 预设，检查旧卡片和旧模型目录是否覆盖当前配置。

401、额度、限流和通用超时按API 与配置的排错表检查。

分享错误日志前先移除凭据，排查时保留原来的权限设置。

6. 恢复配置

备份、保留旧供应商卡片和切回的通用步骤见CC Switch 配置教程。Codex 切回后还需关闭并重开终端；需要恢复文件时先保留后来新增的 MCP 等设置。恢复连接不撤销任务文件或已发生费用。

如果换用百炼，请按百炼 Codex 教程选择对应套餐、协议和 Key。不同供应商有各自的版本要求，DeepSeek 的配置不能直接通用。使用 OpenAI 服务时，还需符合其地区、账号和套餐要求；下载或连接失败按具体网络问题排查。

继续第一项任务或Codex Skills与MCP实践。

参考资料

资料核对：2026-09-15；镜像包元数据已查询，安装、命令和 API 尚未实机测试。

Codex：连接国内 API 并运行

本页目录