Codex 安装后不能运行：按命令、认证、接口和工具逐层排查

命令找不到，先查安装入口

在新的 PowerShell 窗口运行 Get-Command codex*，查看当前能找到哪些启动文件，再运行 codex.cmd --version。若找不到命令，核对安装是否完成、安装渠道的 PATH 设置，以及终端是否已重新打开。

如果报错明确指出 codex.ps1 受执行策略限制，且实际存在同一安装生成的 codex.cmd，可以尝试该入口。该方法只针对启动脚本问题；企业软件限制、组织策略或沙箱错误，应按对应要求处理。

Get-Command codex*
codex.cmd --version

认证报错，核对当前凭证和账户

401 通常需要检查认证信息，403 可能涉及权限或策略，但具体原因应结合返回内容与服务方日志判断。先确认使用的是 ChatGPT 登录、OpenAI API Key 还是自定义 provider，再检查相应账号或凭证。

自定义服务还需确认环境变量已经传入当前进程、Key 没有失效，以及账户可访问所选模型。分享排障材料时只保留凭证类型和脱敏标识；完整凭证无需发送给协助安装的人。

能登录却请求失败，检查接口与网络

404 可能来自路径或模型不匹配，也可能是服务端路由问题，应核对完整的目标路径、服务商规定的 Base URL 和模型 ID。出现协议、流式事件或工具参数错误时，查当前服务对 Codex Responses 工作流的实际支持范围。

代理、证书与超时问题按报错定位，不要同时改地址、模型和认证方式。请求超时后，先查该次请求的服务端状态与用量；429 或服务端繁忙也需要依据限额和服务状态处理，重复安装客户端通常无法解决。

模型能回复，工具仍可能缺少运行条件

文件读取失败时检查项目目录、文件是否存在和实际权限；命令执行失败时检查所需解释器、依赖及工作目录。模型描述了操作步骤，并不等于命令已经成功执行，最终应检查退出状态和生成的文件。

Windows 原生沙箱和 WSL 的路径、程序与权限环境不同。优先排查当前环境，不要为消除报错直接关闭全部限制。企业设备上的策略拒绝，应把脱敏日志、Windows 版本和操作步骤交给管理员核对。

保留能复现问题的最小记录

记录 CLI 版本、终端类型、发生时间、最小操作、预期结果和实际报错，必要时附脱敏请求标识。每次调整后只复验对应环节，并注明结果；故障解除后，再执行原样例任务确认流程完整。