登录
Codex

Codex 配置

配置 Codex 的提供者路由、推理强度、凭证和项目覆盖。

了解配置范围

用户级设置位于 ~/.codex/config.toml 中。受信任的项目可以添加 .codex/config.toml 来实现项目范围的行为，但提供商和身份验证设置属于用户级配置。

定义 OmniGateway 提供商

  • 使用 API 密钥令牌组可用的确切模型 ID。
  • 对于此 Responses 兼容配置，请保留以 /v1 结尾的基本 URL。
  • 使用低、中、高或所选模型支持的其他推理强度值。
  • 编辑提供商或凭证文件后重新启动 Codex。
~/.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

存储和轮换凭证

本示例从 OMNIGATEWAY_API_KEY 环境变量读取密钥，不需要手工构造 auth.json 或 refresh_token。密钥不要写入截图、聊天或仓库；桌面端请确认实际进程读取到了对应配置。
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

配置排障

  • 401 先核对实际请求地址与密钥所属平台，再检查用户 Key 或上游凭证。
  • developer 角色报错需要检查 Responses 与线路兼容性。
  • refresh_token 为空需要区分账号登录与 API Key 认证；不要把 API Key 填成刷新令牌。
  • 配置不生效时检查 CODEX_HOME、项目配置、profile、启动参数和配置工具，并重启后用新会话验证。

连接失败时按报错排查

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

打开 Codex 连接报错排查