Codex 常见问题
此页面汇总了使用 OpenAI Codex 配合 AiFirst 时常见的问题。通用问题请查看 FAQ 总览。
Q：Codex 的 Base URL 需要加 /v1 吗？
如果你按 Codex 配置 里的 config.toml 方式配置，base_url 填：
https://apiaifirst.com不要手动加 /v1。Codex 会根据 wire_api = "responses" 使用对应接口。
Q：修改了配置文件但 Codex 没生效？
- 确认
~/.codex/config.toml文件开头有：
model_provider = "OpenAI"
[model_providers.OpenAI]
base_url = "https://apiaifirst.com"
wire_api = "responses"
requires_openai_auth = true- 确认
~/.codex/auth.json已写入 API Key：
{
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}- 完全退出并重新打开 Codex。macOS 可以使用
Command + Q完全退出。
Q：报错 "Selected model is at capacity"
这是上游模型临时容量不足，不是 AiFirst 的问题。解决方案：
- 等待几分钟后重试
- 临时把
~/.codex/config.toml里的模型改成其他可用模型，例如：
model = "gpt-5.4-mini"
review_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" 或连接超时？
- 检查网络连接
- 确认
~/.codex/config.toml中的base_url是https://apiaifirst.com - 运行连通性测试：
curl https://apiaifirst.com/v1/models \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Q：如何手动配置而不是使用 CC Switch？
创建或编辑 ~/.codex/config.toml：
model_provider = "OpenAI"
model = "gpt-5.4"
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://apiaifirst.com"
wire_api = "responses"
requires_openai_auth = true再创建或编辑 ~/.codex/auth.json，写入你的 API Key。完整示例见 Codex 配置。