Updated 2026-04-29

Codex CLI 使用指南

如果你准备通过命令行使用 Codex,这页会把安装入口、登录方式、Windows 与 macOS 用法,以及它和 VS Code / Cursor / Windsurf 的配合方式整理在一起。

CLI Terminal PowerShell macOS Terminal Repo Workflow

CLI 用户开始前先看这三件事

先看官方安装文档、再确认账号状态、最后直接放进真实仓库。

Install

安装入口清晰

CLI 用户通常已经准备开始安装、登录并在本地工程里使用,因此最需要的是清楚的文档和入口。

Workflow

更贴近真实开发过程

CLI 用户通常直接把 Codex 放进仓库、终端、Git 和测试流程里,这比孤立的演示更接近实际价值。

Keyword

常见入口不止一个

除了 Codex CLI,本页也把 @openai/codex、Terminal、Windows 和 macOS 的使用方式放在一起,方便直接对照。

Codex CLI 的开始顺序

CLI 用户最适合按文档、账号、仓库这三个层次来开始。

先看官方安装说明

目前官方仓库和文档已经单独提供 CLI 入口。常见安装方式会使用 @openai/codex,然后再进入登录流程。

确认登录方式和可用计划

CLI 是否可直接用、是否走 ChatGPT 账号登录、是否有额度限制,都应以你当前账号和最新文档说明为准。

在真实仓库里启动首个任务

CLI 最适合直接对着真实项目做修复、重构、补测试、解释代码或完成小型迭代,而不是只跑演示命令。

CLI 页面适合解决哪些问题

如果你正在准备动手,通常会关心下面这些安装和工作流场景。

  • Codex CLI 安装:先看安装步骤和官方文档入口。
  • @openai/codex:查看包名、仓库和命令行入口。
  • Codex Terminal:查看终端场景下的常见用法。
  • Codex Windows CLICodex Mac CLI:按系统查看具体操作环境。
  • Codex VS Code CLI:查看终端和编辑器如何一起使用。

CLI 适合哪几类人

如果你属于下面任意一种,CLI 页面通常比桌面端页面更有价值。

Developers

已经习惯终端的人

这类用户会直接把 Codex 放进 PowerShell、Terminal、Git 和脚本流程里使用。

Teams

要处理真实仓库的人

CLI 更适合围绕已有代码库做补测试、修 bug、重构和文档整理,而不是只生成示例片段。

Editors

会同时用 IDE 的人

很多用户会把 CLI 和 VS Code、Cursor、Windsurf 配成一套连续工作流,而不是彼此替代。

Codex CLI 常见问题

FAQ 会继续围绕安装、登录、终端和编辑器协同来展开。

Codex CLI 怎么安装?

官方仓库和文档已经提供 CLI 的安装说明。常见安装方式会使用 npm 包 @openai/codex,安装前先看最新官方文档更稳妥。

Codex CLI 安装后怎么登录?

安装后通常会通过你的 ChatGPT 账号或相关凭证完成登录,具体流程以你当前可见的官方文档为准。

Codex CLI 可以在 Windows PowerShell 使用吗?

可以。Windows 开发者通常会在 PowerShell、Windows Terminal 或 VS Code 的集成终端里使用它。

Codex CLI 和桌面端有什么区别?

桌面端更适合从图形界面开始理解产品;CLI 更适合直接围绕真实仓库和终端工作流完成任务。

Codex CLI 适合哪些任务?

更适合在真实项目中做写代码、修 bug、重构、补测试和文档整理这类连续任务,而不是孤立地只生成几行示例代码。

Next Step

如果你已经决定走命令行,接下来通常会继续看 VS Code、Cursor 或 Windsurf

如果你已经决定走命令行,下一步通常就是把 CLI 接进自己常用的编辑器环境。