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.2"
model_reasoning_effort = "high"
disable_response_storage = true

[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。