选择模型供应商
下方展示当前供应商的完整配置,切换后查看对应方案。
- MODEL
- deepseek-flash
- BASE URL
- https://api.deepseek.com/
- AUTH
- DeepSeek 平台 API Key
配置速查
| 配置项 | 填写内容 | 注意 |
|---|---|---|
| 协议 | Responses API | 不是 Chat Completions |
| 模型目录 | ~/.codex/models.json | 使用官方完整模型元数据 |
| 配置文件 | ~/.codex/config.toml | 备份并合并用户级配置 |
安装与备份
本篇面向本机 Codex CLI。先确认版本,并备份用户目录下 .codex/config.toml。Windows 路径同样位于用户目录,不是项目目录。使用 DeepSeek API Key,费用与 OpenAI 账号分别计算。
按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。
npm install -g @openai/codex
codex --versionmacOS / Linux:运行官方接入助手
官方脚本会备份配置、生成模型目录并配置供应商。先下载,用编辑器阅读,再执行最后一行。运行时在脚本的凭据输入位置填 Key,不要发到模型聊天框。脚本可能把 Key 保存进本机配置,不能提交或公开该文件。
curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh -o codex-deepseek-setup.sh
# 先阅读下载文件,确认后执行下一行
bash ./codex-deepseek-setup.shWindows:PowerShell 接入
下载并检查 PowerShell 脚本后再执行。若系统策略阻止运行,先查组织策略和官方要求,不直接关闭全局策略。按脚本菜单选择模型。
Invoke-WebRequest "https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1" -OutFile "./codex-deepseek-setup.ps1"
# 先阅读下载文件,确认后执行下一行
& "./codex-deepseek-setup.ps1"检查实际配置
确认 model_provider 指向 deepseek,base_url 为本页地址,wire_api 使用 responses,model_catalog_json 指向已生成的模型目录。当前官方示例默认 deepseek-flash;模型名称以当前官方集成为准。
需要手动配置时,从参考来源取得完整 models.json,不能只猜一个模型 ID。OpenAI 配置支持通过 env_key 读取指定环境变量中的 Key;选择这种认证时不要同时保留明文 token。
第一次任务与回退
在测试项目目录启动 codex,用 /status 和供应商控制台用量核对实际模型,再验证引用的文件。脚本配置可通过官方菜单恢复选项回退;手动配置则还原备份并重启,不能删除整个 .codex 目录。
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。卡在哪一步?按错误定位。
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