Codex CLI 怎么安装和使用？

介绍

Codex CLI 是可以在终端里运行的 Codex。它适合喜欢命令行工作流的开发者，也适合把 Codex 接入脚本、CI 或本地自动化流程。

在 Windows 上，你可以选择 Windows 原生 PowerShell 工作流，也可以选择 WSL2。官方文档明确说明：Windows 原生可使用 Windows sandbox；当你需要 Linux 原生工具链时，可以使用 WSL2。

步骤

步骤 1：确认 Windows 环境

建议先确认系统、包管理器和开发工具是否可用。

winget --version
git --version
node --version

配图标注：图 1 建议放一张 PowerShell 截图，标注 winget、git、node 三个命令的输出位置。

步骤 2：安装 Windows 开发依赖

如果你的机器缺少常见开发工具，可以使用 Windows 默认包管理器安装：

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id GitHub.cli

配图标注：图 2 建议放一张 winget 安装过程截图，标注安装包名称和完成状态。

步骤 3：安装 Codex CLI

Windows 原生 PowerShell 可以使用官方安装脚本：

$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

如果你选择 WSL2，可以先在管理员 PowerShell 中安装并进入 WSL：

wsl --install
wsl

然后在 WSL shell 中安装并启动 Codex：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

配图标注：图 3 建议放两张并排截图，左侧是 PowerShell 安装脚本，右侧是 WSL 中运行 codex。

步骤 4：登录 Codex

安装后运行：

codex login

你可以根据提示使用 ChatGPT 账号或 API key 登录。登录完成后，进入项目目录再启动 Codex：

cd path/to/your-project
codex

配图标注：图 4 建议放一张登录完成后的终端截图，隐去账号信息，只保留成功状态。

步骤 5：发送第一个任务

第一次建议先做只读任务：

请阅读当前项目，说明：
1. 这个项目使用什么技术栈。
2. 主要入口文件在哪里。
3. 本地开发、lint、build 命令是什么。
不要修改文件。

配图标注：图 5 建议放一张 Codex CLI 对项目结构总结的截图，用箭头标出命令输出和文件路径。

步骤 6：使用常用命令

常见命令：

codex
codex "解释这个项目"
codex exec "修复 CI 失败"
codex doctor
codex completion powershell

配图标注：图 6 建议放一张“常用命令速查表”，把交互模式、单次提示、非交互执行、诊断和补全分开。

红字避坑

总结

Codex CLI 适合命令行用户和自动化场景。Windows 用户可以走 PowerShell 原生路线，也可以在需要 Linux 工具链时使用 WSL2。第一次使用先跑只读分析和 codex doctor，确认环境稳定后再让 Codex 修改文件。