必须配置Codex CLI直连第三方模型API,否则会报“stream disconnected”或401错误;需升级Node.js≥22、安装CLI、创建配置目录与文件、在config.toml中设置model_provider及wire_api="responses"、通过.env设置对应API密钥,并用--dry-run验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地命令行中调用GPT-5.6、DeepSeek V4 Pro或GLM 5.2等第三方大模型,必须让Codex CLI绕过OpenAI官方接口,直连兼容Responses API的中转服务。这一步不完成,执行codex命令时会卡在“stream disconnected before completion”或直接报401错误。
确认环境与安装CLI
先检查Node.js版本是否≥22:运行node -v,输出不是v22.x或更高则需升级。Ubuntu用户可执行curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs;Windows用户请从nodesource.com下载LTS安装包手动安装。
安装Codex CLI:运行sudo npm install -g @openai/codex(Linux/macOS)或npm install -g @openai/codex(Windows PowerShell以管理员身份运行)。
验证安装:输入codex --version,看到类似0.134.2的输出即成功。
创建配置目录与基础文件
Linux/macOS执行:mkdir -p ~/.codex && touch ~/.codex/config.toml && touch ~/.codex/auth.json。
Windows执行:mkdir %USERPROFILE%\.codex & type nul > %USERPROFILE%\.codex\config.toml & type nul > %USERPROFILE%\.codex\auth.json。
【注意:Windows路径是隐藏目录,需在文件资源管理器地址栏手动输入%USERPROFILE%\.codex并回车才能看到】。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
配置第三方API(推荐自定义provider方式)
编辑config.toml,填入以下内容(以DeepSeek V4 Pro为例):
model = "deepseek-v4-pro"<br>model_provider = "deepseek"<br><br>[model_providers.deepseek]<br>name = "DeepSeek V4 Pro"<br>base_url = "https://api.deepseek.com/v1"<br>wire_api = "responses"<br>requires_openai_auth = false<br>env_key = "DEEPSEEK_API_KEY"
关键点:【wire_api必须为"responses",这是Codex唯一接受的协议类型】;base_url末尾必须带/v1;env_key值将用于读取环境变量,不能拼错。
接着,在同一目录下新建.env文件(Linux/macOS)或.env(Windows),写入:DEEPSEEK_API_KEY=sk-xxxxxx(替换为你从DeepSeek官网获取的真实密钥)。
校验连通性
第一步:在配置目录所在终端中运行source ~/.codex/.env(Linux/macOS)或set DEEPSEEK_API_KEY=sk-xxxxxx(Windows CMD)。
第二步:执行codex "print 'hello'" --dry-run。
第三步:观察输出——若出现→ Using model_provider: deepseek且无401/404错误,说明配置生效;若提示Unauthorized,立即检查.env文件是否被正确加载、密钥是否复制完整、env_key是否与变量名完全一致。

















