Codex 常见问题

问题 1：认证失败（401 Unauthorized）

问题描述

请求返回 401，提示令牌无效或认证失败。

原因分析

• 令牌粘贴时带了多余空格或换行。
• 本机残留旧 OPENAI_API_KEY、OPENAI_BASE_URL 环境变量。
• 当前令牌已过期或被删除。

解决步骤

1. 重新复制令牌，确认没有前后空格。
2. 检查并清理冲突环境变量。
3. 确认 Codex 配置文件中的 base URL 指向平台地址。
4. 如令牌疑似失效，重新创建并替换。

问题 2：模型名称错误

问题描述

请求报模型不存在，或返回 model not found。

原因分析

配置使用了不在当前分组中的模型名称，或别名写错。

解决步骤

1. 先查询可用模型列表：

curl -s https://www.yuzhixiaolongxia.com/v1/models \
  -H "Authorization: Bearer 你的Codex令牌"

2. 在返回列表里复制模型名，避免手输。
3. 确认该令牌绑定的是 Codex 相关分组。

问题 3：并发限制触发

问题描述

批量任务时出现限流、重试次数过多或请求被拒绝。

原因分析

同一令牌短时间并发过高，超过通道速率限制。

解决步骤

1. 降低并发数量，改为队列式提交。
2. 对失败请求启用指数退避重试。
3. 将测试任务和生产任务拆分到不同令牌。
4. 大批量任务分时段执行。

问题 4：响应超时

问题描述

请求长时间无返回，最终超时。

原因分析

• 提示词过大或单次输出目标过长。
• 网络链路不稳定。
• 参数设置过于激进（如输出长度过大）。

解决步骤

1. 拆分任务，减少单次输入规模。
2. 调整输出长度相关参数，避免一次请求过重。
3. 先用短请求验证连通性再运行长任务。
4. 必要时更换网络环境后重试。

更多配置说明见 Codex CLI 教程。