本文只使用官方安装和登录方式。产品入口与命令可能更新，操作前可先打开文末的 OpenAI 官方文档核对。
一、先选择适合你的入口
Codex 不是只有一种使用方式。先根据工作习惯选择入口，能少走很多弯路：
- 桌面端：适合希望用图形界面打开文件夹、查看改动和管理任务的用户。
- IDE 扩展：适合已经长期使用 VS Code 等编辑器，希望在写代码时直接调用 Codex 的用户。
- Codex CLI：适合习惯终端，或需要在项目目录中快速分析、修改和验证代码的用户。
第一次接触终端时，可以先用桌面端；需要可复制的排错步骤和项目命令时，再补 CLI。
二、CLI 安装前检查
如果你选择 npm 安装 Codex CLI，先在终端检查 Node.js 和 npm 是否可用：
node --version
npm --version只要其中一个提示“命令不存在”，就先安装或修复 Node.js。不要同时从多个来路重复安装，否则容易出现旧版本和 PATH 冲突。
三、安装并验证 Codex CLI
使用官方 npm 包全局安装：
npm install --global @openai/codex
codex --version第二条命令能打印版本号，说明终端已经找到 Codex。如果安装成功但仍提示找不到命令，先完全关闭终端再打开，然后分别运行：
# macOS / Linux
command -v codex
npm prefix --global
# Windows PowerShell
Get-Command codex -ErrorAction SilentlyContinue
npm prefix --global重点检查 npm 的全局安装目录是否已经进入当前终端的 PATH，而不是反复重新安装。
四、登录自己的账号
运行登录命令并在浏览器完成官方流程：
codex login
codex login status本地个人使用优先走浏览器登录。不要把账号密码、浏览器 Cookie 或 API Key 发给安装人员；需要输入凭据时应由你自己操作。
五、完成第一个真实任务
不要只验证“能打开”。进入一个你有权修改的测试项目，再启动 Codex：
cd 你的项目目录
git status
codex第一次任务建议足够小，例如：
- 先让 Codex 总结项目结构，不修改文件。
- 让它修改首页的一句测试文案。
- 让它运行项目已有的检查或启动命令。
- 查看 Git diff，确认只改了预期文件。
验收标准：能读取正确目录、完成一处可控修改、运行验证命令，并且你知道如何查看和撤销改动。
六、仍然失败时记录这些信息
准备下面的信息，比只说“装不上”更容易定位问题：
- 操作系统和终端名称；
node --version、npm --version、codex --version的完整输出；- 安装命令和第一段完整报错；
npm prefix --global的输出；- 项目是否在本机磁盘、网络盘、WSL 或同步目录中。
官方资料
还是卡在安装或登录？
提交完整报错，先判断问题再决定是否需要远程服务。