直接答案
Codex CLI 当前使用 Responses 协议连接模型提供方。配置老张API时，应在用户级 ~/.codex/config.toml 定义自定义 model_providers.<id>，并通过 env_key 读取 LAOZHANG_API_KEY。仅设置 OPENAI_BASE_URL 环境变量、只测试 /v1/models，或只确认普通 Chat Completions 成功，都不足以证明 Codex 可用。
本页依据 OpenAI 官方 Codex CLI、Authentication 和 Configuration Reference，最后核对日期为 2026 年 9 月 2 日。老张API模型、分组和价格以控制台为准。
安装 Codex CLI
选择一种方式，不需要同时安装。
macOS / Linux
Windows PowerShell
npm
Homebrew
只有 npm 安装方式需要 Node.js/npm。 配置老张API provider
1. 保存密钥
把环境变量写入安全的 shell 或密钥管理配置；不要提交到仓库，也不要用 echo 输出完整值。
2. 编辑用户级配置
编辑 ~/.codex/config.toml：
Provider、鉴权和 openai_base_url 等配置必须放在用户级配置中。Codex会忽略项目本地 .codex/config.toml 中的 model_provider、model_providers 和 openai_base_url，因此不要把密钥路由配置提交到项目仓库。
wire_api = "responses" 是当前 Codex 自定义 provider 支持的协议。若目标模型或 API Key 分组没有通过 /v1/responses、SSE 流式和工具调用验收，Codex 工作流可能失败。
openai_base_url 与自定义 provider 的区别
openai_base_url：覆盖内置 openai provider 的 Base URL；[model_providers.laozhang]：定义独立 provider，并通过 env_key 提供密钥；- 内置 provider ID 不能被自定义表覆盖；
- 项目级
.codex/config.toml 不应用 provider 和鉴权配置。
本页推荐独立 laozhang provider，使密钥来源和路由边界更清楚。不要同时混用多个未经验证的配置方式。
首次验收
验收不应只看是否出现文本。确认：
- 请求到达
https://api2.laozhang.ai/v1/responses；
- 模型 ID 属于当前 API Key 分组；
- SSE 流式可以正常结束；
- usage 和调用日志一致；
- 简单文件读取、工具调用和错误分支符合预期；
- 无效模型、401、403、429 和断流能被正确诊断。
OpenAI 官方登录与老张API密钥
OpenAI官方 Codex 支持 ChatGPT 登录和 OpenAI API Key 登录：
这些命令面向内置 OpenAI provider。使用上面的 laozhang 自定义 provider 时，密钥由 LAOZHANG_API_KEY 环境变量提供，不要把老张API Key误当成 ChatGPT 登录凭证。
查看当前 OpenAI 登录状态：
401 或找不到密钥
- 确认当前 shell 存在
LAOZHANG_API_KEY；
- 确认
env_key 拼写一致；
- 不要打印密钥值，只检查变量是否存在；
- 在控制台轮换可能泄露的密钥。
model_not_found 或 403
- 从模型目录复制准确模型 ID；
- 核对 API Key 分组和 Responses 端点；
- 使用相同密钥发送最小
/v1/responses 请求。
reconnecting、断流或超过重试限制
- 区分 TLS/代理/网络错误与上游 429/5xx；
- 查看 Codex 错误、老张API调用日志和发生时间；
- 不要无限重试；先用最小任务排除工具和大上下文；
- 记录
codex --version、模型、provider 和脱敏错误后联系支持。
相关文档
