登录
Codex

Codex CLI 快速入门

安装 Codex CLI，连接 Responses 兼容的 OmniGateway 路由，然后运行第一个任务。

安装并验证 Codex CLI

安装当前的 Codex CLI 软件包，然后验证 codex 命令在新的终端会话中是否可用。

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

准备 provider 配置与 API Key

下面统一使用自定义 provider + 环境变量 API Key。合并到用户 config.toml，保留已有设置；将模型占位符换成控制台支持 Responses 的准确 ID。在同一终端设置密钥并启动 CLI。桌面应用不一定继承终端变量，需单独配置。

~/.codex/config.toml
# 将模型占位符替换为控制台中支持 Responses 的准确模型 IDmodel = "REPLACE_WITH_YOUR_MODEL_ID"model_provider = "omnigateway" [model_providers.omnigateway]name = "OmniGateway"base_url = "https://www.omnigateway.org/v1"wire_api = "responses"env_key = "OMNIGATEWAY_API_KEY"requires_openai_auth = false
Windows PowerShell · 当前终端
$secureKey = Read-Host "输入 OmniGateway API Key" -AsSecureString$env:OMNIGATEWAY_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password# 在同一终端启动 CLI；不要打印密钥codex
macOS / Linux · 当前终端
printf '输入 OmniGateway API Key: 'read -r -s OMNIGATEWAY_API_KEYprintf '\n'export OMNIGATEWAY_API_KEY# 在同一终端启动 CLIcodex

启动并验证

  1. 打开 模型广场 并确认所选模型支持分配给密钥的令牌组。
  2. Base URL 末尾保留 /v1，并将 wire_api 设置为 responses。
  3. 在测试仓库中打开一个新终端并运行 codex。
  4. 仅批准任务所需的权限并在 控制台 日志中确认请求。

连接失败时按报错排查

查看 401、developer 角色不兼容、refresh_token 为空的具体处理步骤，以及模型列表和最小 Responses 验证方法。

打开 Codex 连接报错排查