#3. 安装

#Codex CLI 安装

npm 安装（推荐）：

npm install -g @openai/codex

Homebrew 安装（macOS）：

brew install --cask codex

安装完成后，在终端中运行 codex 即可启动。首次启动时，Codex 会引导你完成登录。

#登录

输入 codex 后，系统会提示你选择认证方式。选择"Sign in with ChatGPT"后，浏览器会自动打开 OpenAI 的登录页面。完成认证后回到终端，凭证会保存在本地，后续启动无需重复登录。

如果你想使用 API Key，可以将 OPENAI_API_KEY 环境变量设置好，或在 ~/.codex/config.toml 中配置。

#首次启动

建议在一个 Git 仓库中首次启动 Codex，这样它可以读取项目文件，你也可以随时通过 Git 管理改动。进入你的项目目录，然后运行：

cd your-project
codex

Codex 会启动一个全屏终端界面。你可以直接在输入框中用自然语言描述你的需求。

#常见安装问题

如果 codex 命令找不到，尝试重启终端让 PATH 生效。macOS 上如果遇到权限问题，考虑使用 nvm 管理 Node.js 而不是系统安装。Windows 用户建议在 WSL2 环境中使用 Codex CLI，原生 Windows 支持目前还处于实验阶段。如果浏览器反复打开但认证始终无法完成，尝试先运行 codex logout 再重新启动。