OpenAI Codex

Codex / OpenAI 兼容 CLI 一般通过 OPENAI_API_KEY 和 OPENAI_BASE_URL 接入 FreeDom API。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

一、适用场景

• 想把 OpenAI Codex 的模型请求接到 FreeDom API
• 已经有平台 API Key
• 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备

先确认你的 Codex 工具支持 OpenAI 兼容端点。不同发行版命令不同，核心是支持自定义 Base URL。

三、配置接入

macOS / Linux：

export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"

Windows PowerShell：

$env:OPENAI_API_KEY="你的_API_Key"
$env:OPENAI_BASE_URL="https://api.yonghu.shop"

如果工具使用配置文件，把 Base URL 与 Key 填到对应字段。

四、启动验证

运行一个最小补全/问答命令。若工具允许指定模型，先选择平台已开放的轻量模型测试。

五、推荐模型填写方式

优先使用控制台里真实展示的模型名。常见可尝试：

• Claude：claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
• Gemini：gemini-2.5-pro、gemini-2.5-flash
• OpenAI 兼容工具：按平台模型广场/控制台展示为准

六、常见问题

401 Unauthorized

API Key 错误、没保存成功，或请求头没有带上密钥。

403 Forbidden

通常是余额不足、Key 没有权限、模型未开放，或服务返回拒绝。

404 Model Not Found

模型名写错，或者当前 Key 没有这个模型权限。

429 Too Many Requests

请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。

七、实用建议

OpenAI 兼容工具有时要求 URL 带 /v1，有时不需要。若 {api} 不通，可在工具设置中尝试 {api}/v1。

Codex / OpenAI 兼容成熟资料归纳

参考资料中，Codex 类工具接自定义 API时最容易混淆的是 Base URL 是否带 /v1。

经验规则：

• 环境变量叫 OPENAI_BASE_URL 时，多数工具可填 https://api.yonghu.shop 或 https://api.yonghu.shop/v1。
• 如果工具内部自动拼 /v1/chat/completions，Base URL 填 https://api.yonghu.shop。
• 如果工具只拼 /chat/completions，Base URL 填 https://api.yonghu.shop/v1。

推荐测试顺序：

export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"

失败后再试：

export OPENAI_BASE_URL="https://api.yonghu.shop/v1"

更多依据见：参考资料。