Codex Manual

选择使用入口

Codex 不是只有一个入口。选对入口,使用体验会差很多。

入口适合场景推荐人群
CLI在终端中读写本地项目、运行命令熟悉命令行的开发者
App桌面图形界面、多线程、项目管理普通用户和希望少碰命令行的人
IDE Extension在 VS Code、Cursor、Windsurf 等编辑器中使用编辑器优先的开发者
Web / Cloud云端执行任务、生成 PR、并行处理;也可在 ChatGPT 网页和移动端查看与继续团队协作和远程任务

新手怎么选

如果你只是想体验 Codex,先用 Codex App。它更直观,也更容易看到项目、线程和任务。

如果你是开发者,建议同时使用 Codex CLI。CLI 能让你更清楚地理解当前目录、权限、配置和命令执行结果。

什么时候用 CLI

适合:

  • 你已经熟悉终端。
  • 你想让 Codex 直接在当前项目里工作。
  • 你需要明确控制 sandbox、approval、model、profile。
  • 你想把 Codex 接入脚本或自动化流程。

启动方式:

cd your-project
codex

常用子命令:codex exec(非交互运行,适合脚本和 CI)、codex resume(继续之前的对话)、codex cloud(浏览和提交云端任务)、codex mcp(管理 MCP 服务器)。会话内常用 /init(生成 AGENTS.md)、/status、/permissions、/model、/review。

什么时候用 App

适合:

  • 你想用桌面界面选择项目。
  • 你想并行开多个 Codex 线程。
  • 你想更直观看到修改、预览和 Git 状态。
  • 你是非纯开发角色,但需要让 Codex 帮你处理项目。

启动方式:

codex app

什么时候用 IDE 扩展

适合你正在编辑器里写代码,希望 Codex 在旁边辅助解释、修改和 review。

如果你使用 VS Code、Cursor 或 Windsurf,这通常是日常开发中最自然的入口(VS Code 扩展 ID 为 openai.chatgpt)。Xcode 和 JetBrains IDE 则通过各自的 AI 聊天入口选择 Codex 作为代理,不使用这个扩展。

什么时候用 Web / Cloud

适合把任务交给云端处理,例如:

  • 为一个 GitHub 仓库生成 PR。
  • 同时尝试多个修复方向。
  • 让 Codex 在你离开电脑时继续处理任务。

云端工作更适合边界清晰、仓库已连接、任务描述明确的场景。在桌面 App 或网页中新建对话并选择 Work in > Cloud 即可开始,也可以在终端用 codex cloud 提交和查看。云端任务需要 ChatGPT 账号登录,仓库通过已连接的 GitHub 或 GitLab 账号访问。