文档目录

Codex CLI 与桌面端

更新于 2026-10-28

当前状态：暂不能通过本平台直接接入 Codex。 当前 AI526 网关提供 Chat Completions，但尚未提供 /v1/responses。Codex 现行配置只支持 wire_api = "responses"；更换 Base URL 不能补足协议差异。

配置参考

以下是后续完成 Responses 适配与模型验收后的配置参考，当前请勿按此模板开始实际调用。适配完成后，在模型目录中复制已确认兼容的公开模型 ID，替换示例值。

model = "REPLACE_WITH_PUBLIC_MODEL_ID"
model_provider = "ai526"
web_search = "disabled"

[model_providers.ai526]
name = "AI526"
base_url = "https://api.ai526.com/v1"
wire_api = "responses"
env_key = "AI526_API_KEY"
requires_openai_auth = false

把这些设置合并进用户级 ~/.codex/config.toml；Windows 路径为 %USERPROFILE%\.codex\config.toml。不要重复已有键或表；前三个顶层设置放在表头之前。项目内 .codex/config.toml 不能覆盖模型提供方配置。

密钥放进启动进程的环境变量，不写入 TOML。例如 PowerShell 当前会话：

$env:AI526_API_KEY = 'YOUR_AI526_API_KEY'
codex

macOS / Linux 终端示例：

export AI526_API_KEY='YOUR_AI526_API_KEY'
codex

桌面端边界

官方指南确认 macOS 和 Windows 桌面应用读取上述用户级配置。保存后需重启应用，并确保 应用进程 能读取环境变量；仅在终端设置变量，不保证从桌面图标启动的应用能读取到它。CLI 与桌面应用需要分别验证。

当前 AI526 普通 /v1/models 列表也不应当作 Codex 原生模型目录配置。自定义别名可能需要版本匹配的 Codex 模型元数据；未提供和验证该目录前，不要随意填写 model_catalog_url。

适配完成后的验收

先确认 Responses、流式输出、工具调用与多轮对话通过平台测试，再配置客户端。CLI 可用 /status 查看生效模型和提供方；桌面端检查当前模型与配置。最后在 AI526 调用记录中核对请求。

本教程只提供配置说明，不会修改你电脑中的 Codex 设置。

官方资料

核验日期：2026-10-28。尚未进行 AI526 与 Codex 的端到端调用测试。