Appearance
Codex 安装与使用：App、CLI、Homebrew 和 IDE 全指南
Codex 可以通过桌面 App、命令行 CLI 或 IDE 工作流使用。选择安装方式前，先决定你要解决什么问题：需要可视化管理多个项目和 Worktree，优先考虑 App；需要脚本、终端和自动化，优先 CLI；需要在编辑器里边写边改，则使用 IDE 集成。
官方平台、版本和安装方式请以 OpenAI Codex 官方页面 和 Codex 开发者文档 为准。本文将安装后的验证、登录和排障补充完整。
安装前检查
先准备一个可以运行的 Git 项目，并确认：
- macOS、Linux 或受支持的 Windows 环境；
- 终端可以运行 Git；
- CLI 安装方式需要受支持的 Node.js 和 npm；
- 项目有明确的启动、测试和构建命令；
- 当前工作区没有你不想被覆盖的未提交修改。
CLI 用户可以先阅读 Codex CLI 安装与使用，Windows 用户可以阅读 Windows 配置排障。
方式一：安装 Codex App
从官方产品页面获取当前版本的桌面 App。下载后按系统安装器完成安装，再启动 App 并登录官方账号。不要从不明网盘或第三方安装包获取客户端，也不要把登录文件复制给别人。
App 适合管理多个项目、Review 面板、Automations 和 Worktrees。首次打开项目时，确认项目路径、分支和权限，再让 Codex执行只读任务。
安装界面参考
下面是安装、登录、更新和 IDE 集成过程中常见的界面截图。图片已保存到本站，具体按钮和版本以当前官方客户端为准。
方式二：使用 npm 安装 Codex CLI
如果当前官方文档仍提供 npm 方式，可以运行：
bash
npm install --global @openai/codex
codex --version进入仓库根目录启动：
bash
cd your-project
codexCLI 安装后如果提示找不到命令，重新打开终端，检查 npm prefix --global 和 PATH。不要为了绕过安装问题把 API Key 写进项目文件。
方式三：Homebrew 安装
macOS 用户可以查看官方是否提供 Homebrew cask 或其他推荐包。安装来源和包名可能变化，先以官方说明为准，再用 codex --version 验证。Homebrew 安装和 npm 安装不要混用多个版本，否则容易出现实际调用路径不一致。
方式四：GitHub Release 或二进制
如果官方提供二进制 Release，下载时只使用官方仓库的 Releases 页面，并核对版本、系统架构和校验信息。把可执行文件放在 PATH 中后，运行 codex --version，再执行一个只读任务。不要直接运行来源不明的二进制。
IDE 集成
IDE 扩展通常共享 CLI 或官方账号的部分配置，但不一定继承你在某个终端临时设置的环境变量。安装扩展后完全重启 IDE，确认当前项目目录、登录状态和模型 Provider。
如果终端可以调用 Clawsocket，IDE 却提示缺少 API Key，把变量持久保存到用户环境，或从已设置变量的终端启动 IDE。第三方 Provider 配置见 Codex 接入第三方模型。
登录和第一次验证
安装后先确认版本：codex --version。再按当前官方提示完成登录。首次启动不要直接让 Codex修改大型项目，先发送：
阅读当前项目的 package.json、README 和测试配置，只告诉我启动、测试和构建命令，不要修改文件。
确认它读到了正确目录后，再做一个小范围任务，并检查 git diff、测试和构建。完整流程见 Codex 安装与第一次运行。
更新和卸载
通过 npm、Homebrew、App 安装器或二进制 Release 安装的 Codex，应使用同一种渠道更新或卸载。先运行版本命令确认来源，再按官方说明操作。不要同时保留多个全局 CLI 版本，尤其要检查 PATH 中哪个路径优先。
FAQ
App、CLI 和 IDE 应该选哪个？
App 适合可视化项目管理和 Worktree；CLI 适合终端、脚本和自动化；IDE 适合编辑器内的快速修改。团队可以同时使用，但应统一版本和配置规则。
安装 Codex 一定需要 Node.js 吗？
取决于安装方式。npm CLI 需要 Node.js，App 和官方二进制可能不需要。以当前官方安装说明为准。
Codex 安装后怎么确认能用？
运行版本命令，在正确仓库目录启动，完成一个只读任务，再做一个小改动并运行已有测试。不要把“程序打开了”当成完整验证。
Windows 安装失败怎么办？
先检查 Node.js、PowerShell、PATH 和执行权限，参阅 Codex Windows 安装与配置排障。
配图来源
本文配图引用自 Runoob Codex 安装与使用，用于说明安装入口和使用方式。具体版本、下载地址和系统支持以 OpenAI 官方文档为准。