国产模型接入教程
Codex · 模型接入

选择模型供应商

下方展示当前供应商的完整配置,切换后查看对应方案。

配置实操 / macOS · Linux · Windows

Codex 接入 DeepSeek

从官方配置脚本到模型目录,完成接入、项目验证和配置恢复。

5 个步骤约 9 分钟文档核对 2026-10-29
开始第一步
接入配置示意Responses API
CodexDeepSeek
MODEL
deepseek-flash
BASE URL
https://api.deepseek.com/
AUTH
DeepSeek 平台 API Key
已安装客户端 模型权限与额度 原配置已备份

配置速查

接口与凭据必须对应同一方案
配置项填写内容注意
协议Responses API不是 Chat Completions
模型目录~/.codex/models.json使用官方完整模型元数据
配置文件~/.codex/config.toml备份并合并用户级配置
01

安装与备份

本篇面向本机 Codex CLI。先确认版本,并备份用户目录下 .codex/config.toml。Windows 路径同样位于用户目录,不是项目目录。使用 DeepSeek API Key,费用与 OpenAI 账号分别计算。

按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。

终端
npm install -g @openai/codex
codex --version
02

macOS / Linux:运行官方接入助手

官方脚本会备份配置、生成模型目录并配置供应商。先下载,用编辑器阅读,再执行最后一行。运行时在脚本的凭据输入位置填 Key,不要发到模型聊天框。脚本可能把 Key 保存进本机配置,不能提交或公开该文件。

Bash / zsh
curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh -o codex-deepseek-setup.sh
# 先阅读下载文件,确认后执行下一行
bash ./codex-deepseek-setup.sh
03

Windows:PowerShell 接入

下载并检查 PowerShell 脚本后再执行。若系统策略阻止运行,先查组织策略和官方要求,不直接关闭全局策略。按脚本菜单选择模型。

PowerShell
Invoke-WebRequest "https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1" -OutFile "./codex-deepseek-setup.ps1"
# 先阅读下载文件,确认后执行下一行
& "./codex-deepseek-setup.ps1"
04

检查实际配置

确认 model_provider 指向 deepseek,base_url 为本页地址,wire_api 使用 responses,model_catalog_json 指向已生成的模型目录。当前官方示例默认 deepseek-flash;模型名称以当前官方集成为准。

需要手动配置时,从参考来源取得完整 models.json,不能只猜一个模型 ID。OpenAI 配置支持通过 env_key 读取指定环境变量中的 Key;选择这种认证时不要同时保留明文 token。

05

第一次任务与回退

在测试项目目录启动 codex,用 /status 和供应商控制台用量核对实际模型,再验证引用的文件。脚本配置可通过官方菜单恢复选项回退;手动配置则还原备份并重启,不能删除整个 .codex 目录。

复制到 Codex
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。
TROUBLESHOOTING

卡在哪一步?按错误定位。

401 / 403

凭据、套餐或模型权限不匹配

检查 Key 来源、地域和套餐;检查当前进程是否读取了旧认证。

404

地址或 API 协议不匹配

使用本文对应协议的 Base URL,不手工追加请求路径。

429

额度或调用频率限制

到供应商控制台核对余额、套餐与限流,降低并发后重试。

工具调用失败

文件权限、客户端版本或模型兼容性问题

先确认工作目录,验证一次只读文件任务,再增加其他能力。

完成前,确认这四项

  • 客户端版本可用,原配置已备份
  • 接口地址、Key 和模型属于同一产品方案
  • 只读任务引用了真实文件,并已核对调用用量
  • 没有提交真实 Key,能够还原原配置

官方参考来源

配置依据以下资料整理,验证任务与排查顺序为本站编辑建议。模型和客户端更新后,请重新核对接口与支持范围。

01https://api-docs.deepseek.com/quick_start/agent_integrations/codex/02https://learn.chatgpt.com/docs/enterprise/gateway-compatibility03https://learn.chatgpt.com/docs/config-file/config-reference
查看其他工具的接入方式