跳转至

Codex 常见问题

长时间使用后感觉"变笨"

原因分析：

这并不是 Codex 真的变笨了，关键问题在于任务拆分。永远不要提交过于宽泛的任务（比如「帮我做一个后台管理系统」），Codex 的设计初衷是精准、针对性的任务。

解决方案：

任务拆分建议

  1. 每次只给 Codex 一个明确、具体的任务
  2. 单次任务最多占用 Codex 上下文窗口的 60%，如果超过 60% 还没解决，说明你的任务拆分不够细
  3. 复杂功能拆成多个小步骤逐步完成，效果远好于一次性丢一个大需求

沙箱模式下网络连接问题

原因分析：

Codex 在 CLI 沙箱或容器模式（如 tun 模式）下运行时，可能因 MTU 设置不当导致网络连接异常。

解决方案：

解决步骤

  1. 检查网络代理工具是否干扰了 Codex 的网络连接
  2. 如果使用 tun 模式代理，尝试调整 MTU 值
  3. 确认 OPENAI_API_KEY 和 OPENAI_BASE_URL 环境变量设置正确
  4. 临时切换到非沙箱模式排查是否为网络问题

401 Unauthorized 错误

解决方案：

必查项

  • 检查是否有网络代理工具拦截/修改了请求
  • 确认 OPENAI_API_KEY 环境变量设置正确
  • 确认 OPENAI_BASE_URL 指向中转站 https://api.yunxicodes.com/v1 而不是 OpenAI 官方
  • 确认 config.toml 和 auth.json 两个文件内容正确
  • 重启终端或编辑器重新加载配置

模型找不到（Model Not Found）

原因分析：

通常是 config.toml 中配置的模型名称不正确。

解决方案：

解决步骤

  1. 检查 可用模型 页面确认模型名称是否正确
  2. 确认 config.toml 中 model 字段使用的是完整的模型名称（如 gpt-5.3-codex）
  3. 注意模型名称区分大小写