安装 Codex CLI 与 ChatGPT 账号授权登录

本节完成 Codex CLI 的安装、版本校验、账号登录与第一次会话启动。命令以 OpenAI 官方仓库与文档为准，你可以对照本机系统选择对应安装方式。

一、前置条件

• 一台可使用终端（macOS、Linux 或 Windows）的开发机器；
• Node.js 环境（npm 安装方式需要）；
• 可用于登录的 ChatGPT 账号，或对应 API 授权方式；
• 建议在 Git 管理的项目目录中练习，便于查看差异与回滚。

二、安装 Codex CLI

2.1 通过 npm 全局安装（通用）

在终端执行官方 npm 包：

npm install -g @openai/codex

2.2 Homebrew 安装（macOS）

使用 Homebrew 的用户也可以通过 cask 安装：

brew install --cask codex

三、校验安装版本

安装完成后，在终端执行版本命令确认 CLI 已就绪：

codex --version

终端输出版本号即安装成功。若提示命令不存在，先确认安装成功、终端路径已生效，必要时新开一个终端窗口重试。

查看帮助信息，熟悉可用命令入口：

codex --help

四、登录授权

执行登录命令，按引导在浏览器中完成 ChatGPT 账号授权：

codex login

命令会打开登录流程，使用你的 ChatGPT 账号登录并确认授权后，回到终端即可继续使用。登录凭证会保存在本地，后续启动会话一般不需要重复登录。

五、启动第一次会话

先切换到你的项目目录：

# 替换为你的项目路径
cd ~/projects/your-project

在项目目录中直接启动交互式会话：

codex

进入会话后，可以先让 Codex 做只读探索，例如：

请先浏览本项目的目录结构与配置文件，告诉我使用的技术栈、入口文件和测试命令，先不要修改任何代码。

在交互式会话中，你可以通过计划模式先让它给出方案，确认无误后再允许修改；这部分会在第 2 章结合界面与审批策略展开讲解。

六、认识基础命令形态

命令	作用	典型场景
codex	启动交互式会话	日常结对开发（主线用法）
codex --version	查看 CLI 版本	安装校验与版本排查
codex login	完成账号登录授权	首次使用或凭证失效后
codex exec	非交互执行任务，结束后退出	脚本、自动化与 CI 场景

七、首次使用的推荐顺序

1. 在干净、已纳入 Git 的项目目录中启动 codex；
2. 先下达只读探索类任务，观察它如何读取文件与组织回答；
3. 打开计划模式，让它先输出修改方案；
4. 方案确认后再放行代码改动；
5. 检查 diff，运行项目测试，再决定接受或回退。

八、常见安装问题排查

• 命令未找到：新开终端刷新 PATH；确认 npm 全局目录已加入环境变量；核对安装命令是否成功完成。
• 登录失败：检查网络与浏览器登录状态；确认账号具备相应使用权限。
• 安装后无法读取项目：确认当前终端工作目录就是项目目录，而不是在其他位置启动 CLI。
• 需要更新版本：重新执行全局安装命令拉取最新版本，再用 codex --version 核对。