主题
Linux安装
安装前说明
这篇文档教你在 Linux 系统上安装 Codex CLI。
Linux 用户一般通过终端安装和使用 Codex。
不同 Linux 发行版的安装命令可能不一样，例如 Ubuntu、Debian、CentOS、Fedora、Arch Linux 都可能不同。
小白用户不要随便复制网上看不懂的命令，也不要无脑使用 sudo 修改系统目录。
安装 Codex CLI 前，需要先安装 Node.js LTS。
Node.js 会提供 node 命令，npm 会提供 npm 命令。
Node.js 官方地址：
text
https://nodejs.org/建议优先安装 LTS 长期支持版。
第一步：安装 Node.js
如果你的系统还没有 Node.js，请先安装 Node.js。
你可以优先查看 Node.js 官网给出的 Linux 安装方式：
text
https://nodejs.org/如果你使用 Ubuntu 或 Debian，也可以参考下面的基础命令。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
sudo apt update这行命令用来更新软件列表。
更新完成后，再复制下面这行命令，粘贴到终端里，然后按回车：
bash
sudo apt install nodejs npm这行命令用来安装 Node.js 和 npm。
如果你使用的不是 Ubuntu 或 Debian，不要直接照抄这两行命令，请按照自己系统的方式安装。
如果你会使用 nvm，也可以用 nvm 管理 Node.js，这样更适合长期使用。
第二步：检查 Node.js 是否安装成功
打开终端。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
node -v这个命令用来查看 Node.js 版本。
如果看到类似 v20.x.x、v22.x.x 这样的版本号，说明 Node.js 可以使用。
如果提示 node 命令不存在，说明 Node.js 还没有安装成功，或者当前终端找不到 Node.js。
第三步：检查 npm 是否可用
复制下面这行命令，粘贴到终端里，然后按回车：
bash
npm -v这个命令用来查看 npm 版本。
如果看到版本号，说明 npm 可以正常使用。
如果 node -v 正常，但 npm -v 不正常，说明 npm 可能没有安装，需要根据你的 Linux 发行版补装 npm。
第四步：使用 npm 安装 Codex CLI
确认 node -v 和 npm -v 都能正常显示版本号后，再安装 Codex CLI。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
npm i -g @openai/codex这行命令的意思是：使用 npm 在系统里全局安装 Codex CLI。
安装过程可能需要等待一会儿，请不要中途关闭终端。
如果出现权限不足，不要乱改系统目录，也不要随便复制看不懂的危险命令。
建议先确认 npm 全局安装目录权限是否正确，或者使用 nvm 重新管理 Node.js 和 npm。
第五步：检查 Codex 是否安装成功
安装完成后，复制下面这行命令，粘贴到终端里，然后按回车：
bash
codex --version这个命令用来查看 Codex CLI 版本。
如果能看到版本号，说明 Codex CLI 已经安装成功。
如果提示 codex 命令不存在，可能是 npm 全局安装目录没有加入 PATH。
第六步：第一次启动 Codex
安装完成后，建议先进入你的项目目录。
项目目录就是你希望 Codex 帮你查看或修改的文件夹。
进入项目目录后，复制下面这行命令，粘贴到终端里，然后按回车：
bash
codex这个命令会启动 Codex。
第一次启动时，终端可能会提示你登录。
按照终端里的提示一步一步操作即可。
常见问题
node 命令不存在怎么办？
说明 Node.js 还没有安装成功，或者当前终端找不到 Node.js。
可以重新按照 Node.js 官网的 LTS 长期支持版说明安装。
安装完成后，重新打开终端再试。
npm 命令不存在怎么办？
有些 Linux 系统会把 Node.js 和 npm 分开安装。
如果你使用 Ubuntu 或 Debian，可以参考：
bash
sudo apt install npm执行前请确认你正在使用的系统确实是 Ubuntu 或 Debian。
权限不足怎么办？
如果 npm 全局安装时提示权限不足，不要乱改系统目录。
可以先查看自己当前 npm 全局目录配置，或者让熟悉 Linux 的人帮你处理。
如果你会使用 nvm，可以用 nvm 安装 Node.js，再重新安装 Codex CLI。
安装很慢怎么办？
安装慢通常和网络有关。
可以先等待几分钟。
如果一直没有进度，可以换网络后再试。
不知道项目目录在哪里怎么办？
项目目录就是你要让 Codex 处理的文件夹。
比如你的网站项目、代码项目、文档项目所在的文件夹。
如果不确定，可以先不要选择系统根目录，也不要选择整个用户目录。
只进入当前真正要处理的项目文件夹，再执行：
bash
codex安装完成后下一步做什么？
进入你的项目目录，然后执行：
bash
codex启动后按照 Codex 的提示登录并开始使用。