AI精品店

Appearance

问题解决 ​

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

排查前先做一件事

先打开 服务运行状态 看一眼——如果服务端正在维护或故障，本地怎么改配置都没用，等恢复即可。

1. 401：认证失败 ​

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

401 只有 3 种原因：配置不对、额度用完、套餐到期。逐项排查：

  1. 检查 base_url 和密钥是否"正确对应"，密钥复制完整（不缺字符、不带多余空格）
  2. 排查环境变量是否有冲突
  3. 确认账户已激活、订阅未到期
  4. 确认额度未用完（包月套餐为周限额，每周刷新，具体以定价页为准）

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

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

错误示例：

stream error: stream disconnected before completion
stream disconnected before completion: stream closed before response.completed

可能原因：

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

解决思路：

  • 简化问题，减少单次对话需要的长思考
  • 更换更稳定的网络环境或线路节点

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 错误 ​

见上方 1. 401：认证失败。

UTF-8 错误 ​

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

503 Service Unavailable 错误 ​

如果报错信息包含 No available channel for model gpt-5.4：官方将下架 gpt-5.4 模型，平台目前已下架该模型。请更换使用 gpt-5.6-terra（消耗价格一样）：先新建任务或新建会话，再重新选择模型即可，原有会话基础上无法切换模型。

其他 503 情况依次检查：

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

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

上下文超长了。建议：

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

上下文过长且功能不相关会导致后续结果不准确。

stream 开头的流错误 ​

99% 是网络问题，见上方 2. 流式中断。