命令能跑，
才算安装完成。

这套排错顺序适合 Windows、macOS 和 Linux 的终端环境。不同版本的命令名称可能变化，具体参数以官方文档为准。

一、先确认命令来自哪里

打开终端后，先看命令解析位置，再运行版本检查。Windows 可使用 PowerShell 的 Get-Command codex，macOS 或 Linux 可使用 command -v codex。如果没有路径，说明命令未进入 PATH。

# Windows PowerShell
Get-Command codex
codex --version

# macOS / Linux
command -v codex
codex --version

二、在正确的项目目录里运行

1. 用 cd 进入项目根目录，不要在下载文件夹里直接运行工作命令。
2. 确认目录里有项目文件，并检查当前 Git 分支或工作区状态。
3. 先用一个无敏感信息的小任务验证读写范围，避免一上来把生产目录交给自动化工具。

三、登录和权限检查

登录流程可能由官方页面或命令行引导完成。浏览器跳转后，要核对地址栏域名；终端出现权限错误时，先检查当前账号、项目目录权限和网络代理，不要直接使用管理员权限反复重试。

四、出现报错时保留哪些信息

保留命令、完整错误文本、系统版本、Node.js/npm 版本和当前目录。删掉 API key、Cookie、授权码和个人文件路径后，再发给协助人员。QQ 安装协助：1052279487。