Codex CLI Overview：终端里的 Codex 工作流

适用场景

Codex CLI 是在终端中运行的 Codex。它适合希望用命令行控制 Codex 的用户，尤其适合本地仓库、脚本化、非交互任务和自动化流程。

如果你熟悉 git、npm、pytest、cargo、go test 这类命令，CLI 会非常顺手。

安装和登录

官方页面提供 macOS/Linux 安装脚本、Windows 安装方式、npm 和 Homebrew 等路径。安装后进入项目目录，运行：

codex

第一次运行会要求登录。你可以使用 ChatGPT 账号或 API key。计划、额度和云端能力以官方 Pricing 和账号权限为准。

第一次终端任务

建议从只读任务开始：

codex "请阅读这个仓库，告诉我启动命令、测试命令、主要目录和潜在风险。先不要修改代码。"

进入交互式 TUI 后，可以继续让 Codex 修改：

请修复测试失败中最小的一个问题。完成后重新运行对应测试。

CLI 的优势是 Codex 可以直接运行项目命令，因此要明确告诉它哪些命令代表验收。

升级 CLI

官方文档说明 Codex CLI 会定期发布新版本。独立安装方式通常可以重新运行安装脚本升级。使用包管理器安装时，按对应包管理器升级。

升级前建议：

• 看官方 changelog。
• 确认团队是否锁定版本。
• 对 CI 或自动化环境先在分支里验证。
• 更新内部文档中的命令示例。

Windows 和 WSL2 选择

Windows 用户有两个常见路线：

• 原生 PowerShell：适合 Windows 项目、.NET、Windows sandbox、桌面路径。
• WSL2：适合 Linux CI、bash 脚本、Linux 包管理器、容器化项目。

不要在两个环境之间随意切换同一个工作区，尤其是依赖安装、路径和换行符敏感的项目。

CLI 适合的工作流

• 交互式修 bug。
• 让 Codex 跑测试并迭代。
• 用 codex exec 做非交互自动化。
• 在 SSH 或远程机器上分析项目。
• 配合 MCP、subagents、review 和 cloud task。
• 在 CI 或脚本中生成报告。

常见错误

不要在错误目录里运行 codex。CLI 默认以当前目录作为项目上下文。

不要不给验证命令。Codex 可以运行命令，但需要知道哪条命令代表完成。

不要把 API key 写进命令历史或仓库。使用环境变量或安全 secret 管理。

小结

Codex CLI 是终端优先的 Codex 入口。它的最佳使用方式是：进入正确目录，先只读理解项目，再让 Codex 做小而可验收的改动，最后用测试、lint 或构建确认结果。