AI精品店

Appearance

问题解决 ​

本页整理自 CodexZH 官方「常见问题解决方案」教程，并把关键步骤写成可操作的排查清单。

1. 401：认证失败 ​

现象：请求返回 401（Unauthorized），提示认证失败。

官方教程给出的排查方向：

  1. 检查 base_url 和密钥是否“正确对应”
  2. 排查环境变量是否有冲突
  3. 确认账户已激活且订阅有效
  4. 验证密钥是否复制完整（不要缺字符、不要带多余空格）

建议你优先对照：环境配置 中的最小配置示例，逐项核对。

2. 流式中断：stream disconnected before completion ​

错误示例（官方教程）：

stream error: stream disconnected before completion

官方教程列出的可能原因：

  • AI 思考时间过长（超过 150 秒会被系统截断）
  • 网络连接不稳定
  • VPN 或代理设置问题

解决思路（官方教程要点）：

  • 简化问题，减少一次对话需要的“长思考”
  • 更换更稳定的网络或 VPN 节点

3. 路径配置错误：系统找不到指定的路径 ​

错误示例（官方教程）：

Unable to persist auth file: 系统找不到指定的路径

官方教程给出的解决方案要点：

  • 搜索并删除/清理所有额外的 .codex 文件夹（避免写到错误目录）
  • 严格按照教程重新配置
  • Windows 用户确认在正确目录下创建文件
  • 检查文件夹权限

4. CLI / VSCode 切换模型问题 ​

官方教程提到：更新 Codex CLI 后，可能出现无法通过 /model 切换模型的问题，并给出了分别针对 VSCode 与 CLI 的处理方式。

4.1 VSCode 解决方案（官方教程） ​

只需要修改 config.toml，确保包含：

toml
[model_providers.codexzh]
requires_openai_auth = true

官方教程提供了一份可直接复制的完整示例（格式化后如下）：

toml
model_provider = "codexzh"
model = "gpt-5.4"
model_reasoning_effort = "high"

[model_providers.codexzh]
name = "codexzh"
base_url = "https://api.codexzh.com/v1"
wire_api = "responses"
requires_openai_auth = true

web_search = "live"

4.2 CLI 解决方案（官方教程） ​

官方教程的处理方式是：

  1. 把 auth.json 改成（注意这里是 null）：
json
{
  "OPENAI_API_KEY": null
}
  1. 在环境变量中新增 CODEXZH_API_KEY，值为你控制台里 sk- 开头的密钥。

macOS / Linux（当前终端会话临时生效）：

bash
export CODEXZH_API_KEY="sk-你的实际密钥"

配置完成后，如果出现 401，官方教程建议检查环境变量是否配置正确。

5. Codex 0.36.0 已知问题（官方教程） ​

官方教程提到的已知问题与现象：

5.1 历史会话丢失 ​

更新 VSCode 插件后，之前的对话记录可能消失。

官方教程给的处理方式：降级到之前的插件版本可能找回记录。

5.2 思考等级设置 ​

界面上无法直接调整思考等级。

官方教程说明：目前只能通过配置文件修改，等待官方修复。

5.3 文件编辑模式差异 ​

官方教程对比：

  • gpt-5：支持可视化编辑器，有完整的变更列表
  • gpt-5-codex：只能通过命令行编辑，无法追踪变更历史

5.4 插件配置简化 ​

新版本插件不再需要在 settings.json 中配置 chatgpt.* 选项，只读取 config.toml。

常见错误速查 ​

504 Gateway Timeout 错误 ​

网络问题，检查一下你的代理和网络连接是否正常。

Connection failed: error sending request 错误 ​

网络问题，打开或关闭代理、切换网络后重试。

413 错误 ​

当前会话记录已经超过 20MB，只能新建会话继续。

VSCode 插件一直在转圈，进不去 ​

这是官方插件自身的问题，第一次访问可能会访问外网，最快的解决办法是使用魔法（代理）。若还是不行则检查配置是否正确。

401 Unauthorized 错误 ​

401 只有 3 种情况：

  1. 账号配置不对 — 按照控制台中"查看配置文件"按钮显示的内容仔细检查两个配置文件是否正确
  2. 账号额度用完了 — 当天 50 刀额度已耗尽，等到晚上 0 点自动重置
  3. 账号已到期 — 套餐到期，需要续费

UTF-8 错误 ​

99% 是 Windows 系统中中文编码错误导致的，将配置中的中文内容删除即可。

503 Service Unavailable 错误 ​

依次检查：

  1. 网络是否正常
  2. 新建会话查看是否正常答复
  3. 套餐是否到期
  4. 配置是否正确

Your input exceeds the context window of this model 错误 ​

上下文超长了。建议：

  • 将项目相关规则编写到 AGENTS.md 文件中
  • 细分功能模块，完成一个功能就新建一个对话

上下文过长且功能不相关本身会导致后面的结果不够准确。

stream disconnected before completion: stream closed before response.completed 错误 ​

99% 是网络问题，请检查的代理，网关，网络等。