Documentation
🌀 Codex 相关

Codex 常见问题

此页面汇总了使用 OpenAI Codex 配合 AiFirst 时常见的问题。通用问题请查看 FAQ 总览

Q:Codex 的 Base URL 需要加 /v1 吗?

需要。 Codex 使用 OpenAI SDK,Base URL 填:

https://apiaifirst.com/v1

Q:设置了环境变量但 Codex 没生效?

  1. 确认你设置的是 OPENAI_BASE_URL 而不是 ANTHROPIC_BASE_URL
  2. 确认环境变量已经生效:
echo $OPENAI_BASE_URL
# 应该输出:https://apiaifirst.com/v1
 
echo $OPENAI_API_KEY
# 应该输出:sk-xxx
  1. 重新打开终端或运行 source ~/.zshrc

Q:报错 "Selected model is at capacity"

这是上游模型临时容量不足,不是 AiFirst 的问题。解决方案:

  1. 等待几分钟后重试
  2. 临时切换到 gpt-5.4-mini
codex --model gpt-5.4-mini

Q:Codex 支持哪些模型?

登录 控制台 (opens in a new tab),点击左侧 「可用渠道」 查看完整的模型列表和价格。

常用模型包括:

模型特点
gpt-5.5最新旗舰模型,能力最强
gpt-5.4上一代旗舰
gpt-5.4-mini快速且经济
gpt-5.3-codex编程专用

Q:报错 "Connection error" 或连接超时?

  1. 检查网络连接
  2. 确认 OPENAI_BASE_URL 设置正确(注意要加 /v1
  3. 运行连通性测试:
curl https://apiaifirst.com/v1/models \
  -H "Authorization: Bearer sk-xxx"

Q:如何在配置文件中使用而不是环境变量?

创建 ~/.codex/config.json

{
  "provider": "openai",
  "model": "gpt-5.5",
  "providers": {
    "openai": {
      "name": "AiFirst",
      "baseURL": "https://apiaifirst.com/v1",
      "envKey": "OPENAI_API_KEY"
    }
  }
}
⚠️

即使使用配置文件,OPENAI_API_KEY 仍需通过环境变量设置(出于安全考虑,不建议将 Key 明文写在配置文件中)。