← 返回系统教程
系统教程故障排查App / CLI / IDE / Cloud入门

排查 Codex 故障:先收集最小证据,再决定重装或报 Issue

用版本、平台、认证方式、复现步骤和脱敏日志定位问题,避免一遇到错误就清空配置或反复重装。

30 分钟阅读核验于 2026/07/21

先收集环境

记录 Codex 版本、操作系统、运行形态、认证方式、工作目录和错误发生时间。删除 API key、Cookie、私有代码和个人路径。

建立最小复现

在空仓库或最小示例中重复问题,区分账号、网络、配置、仓库和版本因素。一次只改变一个变量。

选择下一步

官方故障文档已有答案时按步骤处理;疑似回归时搜索现有 Issue,再提交完整证据。重装前先备份配置,不删除不可恢复数据。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Codex:Troubleshooting

    官方来源 · https://learn.chatgpt.com/docs/reference/troubleshooting

  2. openai/codex 官方仓库

    官方来源 · https://github.com/openai/codex

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。