配置 Codex

Allen API 提供 OpenAI Responses 兼容接口，可作为 Codex 的自定义模型提供方。

1. 配置认证

编辑 ~/.codex/auth.json。Windows 对应路径通常为 C:\Users\<用户名>\.codex\auth.json：

{
  "OPENAI_API_KEY": "sk-your-key"
}

如果文件已经存在，请先备份。直接替换该文件可能会改变当前 Codex 的 OpenAI 或 ChatGPT 登录状态；需要频繁切换多个提供方时，建议使用 CCSwitch 之类的工具管理。

WARNING

auth.json 包含明文密钥，请勿提交、分享或上传该文件。

2. 添加模型提供方

编辑 ~/.codex/config.toml。Windows 对应路径通常为 C:\Users\<用户名>\.codex\config.toml：

model_provider = "allenapi"
model = "your-model-id"
disable_response_storage = true

[model_providers.allenapi]
name = "Allen API"
base_url = "https://api.allenyeahger.xyz/v1"
wire_api = "responses"
requires_openai_auth = true

model 必须使用当前 API Key 在 /v1/models 中可见的模型 ID。

requires_openai_auth = true 会让 Codex 从 auth.json 读取 OPENAI_API_KEY，并作为 Bearer Token 发送给 Allen API。该方式不依赖系统环境变量，也不需要设置 env_key 或 experimental_bearer_token。

用 Chat Completions 而不是 Responses

如果 wire_api = "responses" 在你的 Codex 版本上异常，改成：

wire_api = "chat"

两者 Allen API 都支持。

3. 启动验证

codex

发送一条简单消息，然后在 Allen API 控制台的 日志 页面检查是否出现 /v1/responses（或 /v1/chat/completions）请求。

常见问题

启动后报 401

• 确认 auth.json 里的密钥是控制台创建的完整密钥；
• 确认密钥没有被禁用或超出额度。

报 404

base_url 末尾的 /v1 与 Codex 自动拼接的路径重复，把 base_url 改成 https://api.allenyeahger.xyz 再试。

粘性会话异常

先创建新会话重试，并确认没有复用旧会话缓存。问题持续请携带发生时间到 QQ 群 1125021051 反馈。