文档中心

Codex CLI OpenAI 接入配置指南（国内可用）

发布时间：2026-02-19 · 更新于：2026-02-19

从 API Key 到最小请求验证，讲清 Codex CLI 的 OpenAI 接入配置步骤与常见报错处理。

这篇文档只解决一件事：让你在本机稳定跑通 Codex CLI 的 OpenAI 接入链路。

1. 前置条件

先确认以下三项：

  1. 已安装 CLI，且 codex --version 可执行
  2. 已获取可用 API Key
  3. 当前终端网络可访问接口

若未完成安装，先看：Codex CLI 安装教程（国内版）。

2. 配置 API Key

Linux / macOS：

export OPENAI_API_KEY="your_api_key"

Windows PowerShell：

$env:OPENAI_API_KEY="your_api_key"

建议在同一个终端窗口内完成配置与测试，避免环境变量未生效。

3. 最小可用验证

先跑帮助命令：

codex --help

再跑最小请求：

codex run "say hello in chinese"

两步都成功，说明基础接入链路正常。

4. 国内网络场景建议

如果直连链路不稳定，建议按以下顺序排查：

  1. 先做本机网络与 DNS 排查
  2. 降低并发，仅保留单请求验证
  3. 如需兼容网关，按提供方文档配置对应环境变量（例如 OPENAI_BASE_URL）

更完整的国内方案可看：Codex API 国内可用方案与稳定性排查。

5. 常见错误与处理

401 Unauthorized

  • Key 未生效或复制错误
  • 在新终端重新设置 OPENAI_API_KEY 后重试

429 Too Many Requests

  • 当前请求频率过高
  • 先降并发，再缩短单次任务长度

请求超时或连接中断

  • 优先检查网络链路稳定性
  • 用最小请求持续复测，确认是否偶发波动

6. 建议的接入流程（可复用）

  1. 安装完成后先做 codex --version
  2. 配置 Key 后先做 codex --help
  3. 再做最小请求
  4. 最后再执行复杂任务

相关阅读