Codex 打不开怎么办？启动、登录与请求失败分步排查
Codex 打不开，先看失败发生在哪一步：程序没有启动、登录没有完成，还是已经进入界面却发不出请求。 三者的处理方式不同。连 codex --version 都无法执行时，先查安装和命令路径；浏览器登录成功但客户端仍未登录时，查回调与账号；已有回复后中断，则进入流式诊断。
本文覆盖 CLI 与桌面端的启动、登录分诊，并说明网页入口应如何区分。步骤依据 2026-10-26 核对的官方资料整理，不代表已在你的设备上复现或修复。可以下载Codex 启动与登录排查清单，逐项记录；不需要提交密码或 Key。
先判断：你说的“打不开”是哪一种？
| 看见的现象 | 先检查什么 | 这一步通过的标志 |
|---|---|---|
终端提示找不到 codex，或启动即报文件缺失 |
安装来源、实际命令路径、系统与处理器架构 | 同一终端能输出 CLI 版本 |
| 桌面窗口没有出现、立即退出或持续空白 | 应用版本、是否刚升级、错误时间与系统提示 | 窗口可交互；仍不能据此确认模型请求成功 |
| 浏览器已登录，CLI 或应用还停在登录页 | 当前账号、工作区、浏览器回调；CLI 可核对认证状态 | 当前客户端确认了预期的认证方式 |
| 界面能开，发送后提示连接失败 | 实际请求目标、HTTP 状态或底层连接错误 | 同一路径下的短任务正常结束 |
| 界面能开，任务一直等 | 是否在等审批、工具或终端；是否只影响当前任务 | 等待原因明确，且下一步能在原权限内继续 |
已有输出，之后出现 stream disconnected |
流结束事件、工具执行状态、失败阶段 | 按流式中断验收检查 |
先写清楚是 Codex CLI、IDE 扩展、桌面应用，还是浏览器中的网页入口，再记录版本。它们可能使用不同版本、配置和登录状态；某一端成功，不能代替另一端的检查。官方也说明，桌面内置 Codex 与单独安装的 CLI 版本可能不同。官方排障说明
CLI 启动不了：先看命令路径，再看 API
在实际准备运行 Codex 的终端中检查。下面的命令只用于确认本地程序路径与版本，不发送模型任务。
macOS／Linux／WSL：
command -v codex
codex --version
Windows PowerShell：
Get-Command codex -All | Select-Object CommandType, Source
codex --version
按结果继续：
- 找不到命令：先确认是否安装在当前环境。Windows 原生、WSL、远程主机和容器分别检查；不要因为宿主机安装过，就认为容器里也已安装。刚安装后可重开终端，再看同一命令路径。
- 能找到命令，但报
ENOENT或缺少平台依赖：保留错误里指向的文件类型与安装来源。在codex --version阶段就缺少可执行文件，尚不能用来判断 API Key、余额或模型服务。若确认为安装包不完整，按原安装方式修复；不要同时叠加多个包管理器。 - 能显示版本，正常启动仍报配置错误：记录错误指向的配置键和文件类别。只修正该项；不要先删除整个
.codex目录，其中可能包含历史、设置和凭证。
官方提供独立安装器、npm 与 Homebrew 等安装方式，具体选项和更新命令见CLI 安装文档。npm 启动器还会选择对应操作系统和架构的平台包；包文件缺失与远程请求失败不是同一阶段。官方启动器源码
通过判据：原终端能执行版本命令，并进入 CLI；记录修复前后实际命令路径是否改变。这只能证明启动阶段通过，登录和一次完整任务仍需分别检查。
桌面打不开或一直转圈：先保留现场
先记录系统、应用版本、错误出现时间，以及它发生在启动时、登录后还是打开某个项目后。有正在运行的任务时，先检查其状态和已完成的文件改动，再退出应用；不要用批量结束进程或清空数据目录作为默认修复。
如果只是某个任务看起来不动，先查是否正在等待审批，再检查终端能否执行 pwd 或 git status 等本地命令。保留原任务摘要后，可以用一个更小的新任务做对照；新任务成功不代表原任务已恢复，也不会重置会员额度。持续异常再通过应用反馈入口交接脱敏记录。官方桌面排障、官方方案说明
如果需要更新，从原安装渠道核对更新并记录前后版本。CLI 能运行、桌面打不开时，不要仅修改 CLI 配置就宣称桌面已修好；反过来也一样。
浏览器页面空白或登录页打不开，应记录实际网址、浏览器和错误；可在私密窗口做一次对照，区分浏览器会话或扩展因素。私密窗口成功只缩小了排查范围，不证明桌面程序或 API 已恢复。网页分支可继续查阅OpenAI 网页错误排查。
登录成功却回不到 Codex，怎么查？
先区分 ChatGPT 登录、OpenAI API Key、自定义提供方 Key。浏览器登录了某个账号，不等于当前 CLI 或桌面已经使用它。检查当前客户端的账号与工作区；CLI 可运行：
codex login status
该命令用于查看认证状态，不验证每个模型、接口或第三方 provider。自定义 provider 还要核对当前配置；只记录认证类别，不复制完整输出中的账号信息或凭证。官方认证说明
ChatGPT 的浏览器登录流程需要将结果交回客户端。若 CLI 运行在无浏览器的远程机器上，或本地网络设置阻断 localhost 回调，官方提供 device code 登录（beta）。仅在账号安全设置或工作区权限已允许、且当前 CLI 支持时使用：
codex login --device-auth
随后由账号本人打开官方流程显示的地址并输入一次性代码。此方法针对 CLI 登录场景，不承诺修复桌面闪退、账号权限或 API 连接问题；没有可用权限时应联系工作区管理员，不通过修改网络策略绕过限制。官方无浏览器登录说明
通过判据：当前客户端确认了预期认证方式和工作区，并能完成允许范围内的短任务。仅浏览器显示“登录成功”还没有完成这一步。不要把 auth.json、Cookie、验证码或访问令牌发到工单与聊天中。
已经进入界面，为什么仍然连接失败？
connection failed: error sending request 说明请求发送过程中出现错误，但文字本身不能确定责任方。先看有没有实际 HTTP 状态，再选择下面的入口。
| 错误或状态 | 下一步 | 不应直接得出的结论 |
|---|---|---|
| 没有 HTTP 状态，只有连接、DNS、TLS 或超时文字 | 保留目标 host、时间和最内层错误，按连接失败分支做单变量对照 | 不能直接判定 Key 错误或余额用尽 |
| 401，或缺少认证头提示 | 核对目标服务、认证方式、当前进程的变量及 provider | 浏览器已登录不等于这次 API 已带对凭证 |
429，或 exceeded retry limit |
看错误体区分限流、预算、余额；会员限制另核对所属账号 | 达到重试上限不是根因，充值不是统一处理办法 |
stream disconnected 或压缩阶段失败 |
记录原任务状态，转流式与压缩排查 | 换会话成功不能证明原压缩问题已修复 |
HTTP 错误继续查认证与限流排查，会员用量见Codex 额度核对。OpenAI 的错误码说明只定义其服务的处理方式；第三方服务的具体含义需核对对应错误体与文档。官方错误码
服务异常还应检查发生时刻对应的OpenAI 状态公告；第三方请求同时核对该提供方。状态页是汇总信息，不能用“现在绿色”排除个人或单个模型的问题。
提交什么记录，才方便继续排查？
使用空白排查清单，保留五类信息：客户端与版本、失败阶段、脱敏错误与时间、改变的一个条件、改变后通过和未通过的项目。截图只截与错误有关的区域；完整项目、凭证目录和业务输入不属于必要信息。
云岚API 已有用户若确认请求目标是本站新业务站，可到控制台核对记录，再向本站客服提交脱敏信息。ChatGPT 登录或会员权限问题，应交给对应产品支持或工作区管理员。云岚API 余额不会恢复 ChatGPT 会员额度，排查启动与登录问题也不需要先充值或重新注册。
常见问题
Codex 打不开，重装一次就行吗？
先区分程序未启动与登录、请求失败。只有证据指向安装文件或版本问题时，才按原安装渠道修复并检查版本；重装不能替代认证、权限和接口诊断。
网页能打开，说明 Codex 网络正常吗？
只能说明这次网页访问成功。登录回调、模型请求和长连接可能走不同路径，仍需核对真正失败的客户端与请求目标。
CLI 能用，桌面端不能用，是同一个问题吗？
不能直接认定。两端可能有不同版本和配置；分别记录实际环境，用相同认证和任务做受控对照后再判断。
换成云岚API 就能修复 Codex 打不开吗？
不能保证。程序启动、ChatGPT 登录、工作区权限与第三方 API 接入是不同问题。只有明确选择自定义 provider 的用户，才需要按Codex API 配置教程验证当前模型、协议和用量。