Codex CLI 教程：安装、登录、常用命令与安全配置（2026）
Codex CLI 是 OpenAI Codex 的终端客户端。 它可以在当前代码仓库中读取文件、修改代码和运行命令，适合习惯命令行、需要自动化或希望精确控制工作目录的开发者。
IMPORTANT
本文于 2026 年 7 月 30 日校对。安装参数可能随版本变化；遇到差异时，以 Codex 官方文档和本机 codex --help 输出为准。
安装 Codex CLI
方法一：npm 安装（跨平台）
先安装 Node.js 的当前 LTS 版本，再执行：
npm install -g @openai/codex
codex --version升级到 npm 仓库的当前版本：
npm install -g @openai/codex@latest方法二：官方安装脚本（macOS / Linux）
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version在安全要求较高的环境中，应先查看脚本内容，再决定是否执行在线脚本。
Windows 怎么安装？
Windows 可在 PowerShell 中使用 npm 安装。若需要图形界面，优先阅读Codex Windows 下载教程。安装后如果提示找不到 codex，关闭并重新打开终端，再运行：
Get-Command codex
codex --version第一次启动与登录
进入一个 Git 仓库，再启动 Codex：
cd your-project
codex首次运行时，按当前客户端提示选择登录方式。常见方式是通过浏览器登录可使用 Codex 的 ChatGPT 账号，或使用 OpenAI API Key。ChatGPT 订阅与 API 平台计费是两套体系，使用 API Key 时应检查 API 平台的余额和用量限制。
不要把 API Key 写进 README、提交到 Git，或发送到公开聊天中。使用团队密钥时，应设置预算、权限和轮换规则。
Codex CLI 常用命令
不同版本的子命令可能变化，下面先用帮助命令确认当前版本支持的能力：
codex --help
codex --version
codex exec --help
codex review --help常见工作方式包括：
# 进入交互会话
codex
# 执行一个边界明确的非交互任务
codex exec "运行测试，定位第一个失败原因，只报告诊断结果"
# 查看当前版本的代码审查选项
codex review --help运行前先确认当前目录。Codex 获得的仓库上下文、可修改文件和测试命令都与工作目录有关。
推荐的第一个提示词
先不要修改文件。阅读 package.json、README 和相关源码，回答：
1. 项目如何启动和测试；
2. 这项需求涉及哪些文件；
3. 最可能出现的回归；
4. 建议的最小改动计划。确认调查结果后，再要求 Codex 小步修改并运行相关测试。比起一句“帮我优化项目”，明确目标、范围和验收标准通常能得到更稳定的结果。
权限与安全建议
- 在任务开始前运行
git status --short，避免覆盖尚未提交的工作； - 只在可信仓库中允许执行项目脚本；
- 安装依赖、访问网络、写入工作区外部或删除文件时，先审查命令；
- 用 Git diff 审查最终改动，不要只看 Codex 的文字总结；
- 对登录、支付、生产环境和密钥操作保留人工确认。
常见故障排查
codex: command not found
重新打开终端，运行 npm prefix -g 并确认全局可执行目录已进入 PATH。如果曾用多个包管理器安装，使用 command -v codex（Windows 用 Get-Command codex）确认实际执行文件。
浏览器登录后没有返回终端
检查系统时间、默认浏览器、旧 Cookie，以及公司网络是否拦截本地回调。不要反复安装 CLI，因为登录回调问题通常不是安装文件损坏。
CLI 能启动但无法访问模型
分别检查账号是否有 Codex 使用资格、API Key 是否属于正确项目、API 平台是否有可用额度，以及网络是否能访问所需服务。
Codex CLI 还是桌面版？
| 场景 | 推荐入口 |
|---|---|
| 终端开发、脚本和自动化 | Codex CLI |
| 图形化管理任务与审查改动 | Codex App / Desktop |
| 在编辑器中围绕当前文件工作 | IDE 扩展 |
| 第一次接触 Codex | 桌面版或 CLI 均可，选择更熟悉的界面 |
进一步阅读：Codex 官网入口、Codex GitHub 指南和官方 CLI 中文文档。