注册
ChatGPTCodex

Codex 入门教程：在 ChatGPT 里用 Codex 写代码（网页版 / CLI / IDE）

OpenAI Codex 有网页版（云端）、命令行 CLI、IDE 插件和桌面 App 几种用法。本文讲清怎么选、怎么装、怎么用 ChatGPT 账号登录，并跑通第一个任务。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-10-07 · 依据官方文档与公开资料整理 Plus 账号
本文根据 OpenAI 官方文档（原 developers.openai.com/codex，现已迁到 learn.chatgpt.com/docs）和官方 GitHub 仓库整理，核对日期 2026-10-07；截图引用自官方页面和公开教程并注明出处。Codex 更新很快，入口名称和额度以官方说明为准。

适用于谁

  • 已有 ChatGPT 账号（尤其是 Plus / Pro），想让 AI 直接帮你写代码、修 bug、做代码审查的人。
  • 搜「chatgpt 怎么用 codex」「codex 教程」，分不清网页版、CLI、插件有什么区别的新手。
  • 会用 Git 最好；不会也能先从 IDE 插件或桌面 App 开始。

结论先说

  1. Codex 是 OpenAI 的编程智能体，用 ChatGPT 账号登录即可使用，不必单独申请 API Key。
  2. 怎么选：
  • 代码在 GitHub 上、想让它在云端慢慢干活并提 PR → 网页版（云端，Codex Cloud）；
  • 习惯终端、想让它在本机读写文件、跑命令 → CLI；
  • 主要在 VS Code / Cursor / Windsurf 里写代码 → IDE 插件。
  1. 套餐差别：官方定价页写 Free 和 Go 也包含 Codex，但只是「有限」使用，主要在 ChatGPT 桌面 App 里（官方注明逐步开放）；网页云端、CLI、IDE 插件这些完整入口从 Plus 起提供。各入口共用同一份套餐额度。
  2. 不管哪种方式，先让它解释项目，再给一个小任务，看完改动再合并。

步骤

方式一：网页版（云端运行，Codex Cloud）

按 2026-10 的官方文档，云端任务的入口在 ChatGPT 里：

  1. 在网页版或桌面 App 打开 ChatGPT 并登录（官方 GitHub README 里的 chatgpt.com/codex 入口链接仍然保留）。
  2. 新建任务时选择 Work in → Cloud，打开 Select environment。已有环境直接选；没有就点 Create environment。
  3. 选择要处理的 GitHub 仓库并点 Get started，首次会提示连接 GitHub。Codex 会自己检查仓库、安装依赖和工具、试跑流程，缺什么信息会在对话里问你。
  4. 看一遍它准备好的配置和测试结果，保存后点 Publish，等出现「Environment published」。之后每个任务都从这个环境的快照开始，各自有独立的工作区，可以同时开好几个，电脑关机也不影响。
  5. 点 Start a new task，用中文描述需求，例如「找出登录接口没有做参数校验的地方并补上，附带测试」。
  6. 任务完成后查看改动的文件和测试结果，不满意就继续追加要求；满意后提交或创建 Pull Request，在 GitHub 上审核合并。

Codex 网页版 2025 年发布时的官方配图：输入任务、选择仓库和分支，下方是任务列表

图片来源：OpenAI 官方公告《Introducing Codex》。这是早期界面，现在的入口是 ChatGPT 里的 Work in → Cloud，界面以实际为准。

官方配图：云端任务完成后的结果页，包含改动摘要、测试结果和改动文件列表

图片来源：OpenAI 官方公告《Introducing Codex》（早期界面）

据第三方教程（Flavio Copes，2026-10）介绍，旧版「手写环境配置脚本」的体验现在叫 Codex Cloud (Legacy)，网上较早的教程如果让你粘贴 setup 脚本，说的就是旧版。云端功能需要 ChatGPT 账号，只用 API Key 登录时没有云端功能（官方定价页）。

方式二：Codex CLI（命令行）

安装（来自官方 GitHub README 和 CLI 文档）：

Mac / Linux：

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

Windows（在新开的 PowerShell 窗口里运行）：

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以用包管理器：

bash
npm install -g @openai/codex
# 或（macOS）
brew install --cask codex

用安装脚本或 npm 装的，想更新时再运行一遍同一条安装命令即可；Homebrew 用 brew upgrade --cask codex。npm 包声明的 Node.js 版本要求是 16 及以上（npm 包信息里的 engines 字段），官方 README 没有单独写 Node 要求。

在 Windows PowerShell 里运行官方安装命令，提示 Codex CLI 安装成功

图片来源：Analytics Vidhya

登录与第一个任务：

bash
cd 你的项目文件夹
codex

首次启动会列出几种登录方式：Sign in with ChatGPT（浏览器登录，用套餐额度）、Sign in with Device Code（在另一台设备上用一次性代码登录）、Provide your own API key（按 API 用量计费）。新手选第一项，在浏览器里完成登录即可。

Codex CLI 首次启动时的登录方式选择

图片来源：Analytics Vidhya

然后直接输入：

text
介绍一下这个项目的结构和入口文件

官方示意图：在 Codex CLI 里让它解释代码库，它会先列计划再去读文件

图片来源：openai/codex 官方 GitHub 仓库

官方建议在任务前后各做一次 Git 提交，方便出问题时回退。

常用命令：

命令作用
/init生成 AGENTS.md，写入给 Codex 的项目说明
/permissions设置它改文件、跑命令前要不要问你（例如在 Auto 和 Read Only 之间切换）
/model切换模型和推理强度
/review审查当前改动、找问题
/status查看当前会话配置和 token 用量
codex resume回到当前仓库之前的对话
codex exec "任务"非交互模式，适合脚本和自动化

也支持用 API Key 登录，但需要额外配置，而且没有云端相关功能，新手建议直接用 ChatGPT 账号。

方式三：IDE 插件（VS Code / Cursor / Windsurf）

  1. 在 VS Code 扩展市场搜索 Codex，认准发布者 OpenAI、扩展 ID openai.chatgpt；Cursor、Windsurf 用的是同一个扩展。
  2. 安装后点侧边栏的 Codex 图标；找不到就打开命令面板运行 Codex: Open Codex Sidebar，然后用 ChatGPT 账号登录。
  3. 打开文件或选中一段代码后提问，它可以直接引用当前文件和选中内容，改动在编辑器里以 diff 形式审阅，只保留你想要的部分。
  4. 大任务可以从插件里交给云端去跑，跑完回到编辑器里看结果。

官方配图：IDE 里的 Codex 面板（右侧）和它给出的多文件改动 diff（左侧）

图片来源：OpenAI Codex IDE 扩展官方文档

JetBrains IDE 和 Xcode 有各自的原生集成（JetBrains 在 AI Chat 里选 Codex，Xcode 在编码助手里选 Codex）。另外，现在的「Codex 桌面 App」已经并入 ChatGPT 桌面 App（macOS / Windows，Linux 另有安装说明），在 App 里选 Codex 即可；CLI 里运行 codex app 会打开已安装的桌面 App，没装则启动安装程序。

任务描述怎么写效果更好

  • 说清楚范围：指明文件或模块，例如「只改 src/auth 目录，不要动数据库结构」。
  • 说清楚验收标准：例如「改完后运行测试命令，全部通过再交付」。项目的测试命令最好写进 AGENTS.md，它就能自己去跑。
  • 一次一件事：一个任务只解决一个问题，结果更容易审核，也更省额度。
  • 先审再合并：不论哪种方式，都要自己看一遍改动；云端任务的 PR 也建议走正常的代码审查流程。

常见问题

Q：免费账号能用 Codex 吗？

能用一部分。官方定价页把 Free 和 Go 的 Codex 标为「有限」，说明里写的是在桌面 App 里使用（逐步开放）；网页云端、CLI、IDE 插件从 Plus 起提供，CLI 登录界面上也写着「Plus、Pro、Business、Enterprise 套餐包含用量」。想要完整入口和更高额度可以开通 Plus：/chongzhi/chatgpt-plus。

Q：Windows 上 PowerShell 提示禁止运行脚本？

官方命令里已经带了 -ExecutionPolicy ByPass，请完整复制那一整行，不要只复制引号里的部分。另外，官方仓库的安装说明文档里系统要求一栏仍写着「Windows 11 通过 WSL2」，和 README 提供的 PowerShell 原生安装命令不完全一致；原生安装遇到问题时可以改在 WSL2 里用 Mac / Linux 那条命令，以官方说明为准。

Q：额度怎么算？

官方定价页说明：Plus 和 Business 标准版按每 5 小时给出一个用量估算范围，可能另有每周上限；Pro 目前没有 5 小时限制。本地对话和云端任务共用同一份额度，云端任务通常消耗更多。同样的任务消耗也可能不同，模型选择、上下文长度、推理强度、工具调用都会影响用量，具体以 ChatGPT 里的用量面板为准。

Q：Codex 和 ChatGPT 聊天里直接让它写代码有什么不同？

聊天只是给你代码片段；Codex 能读整个仓库、直接改文件、运行测试，并以 diff / PR 的形式交付。

Q：AGENTS.md 有什么用？

相当于给 Codex 的「项目说明书」：怎么构建、怎么测试、代码规范。写一次，之后每次任务都会参考。

参考资料

  • Codex 官方仓库（安装命令）：https://github.com/openai/codex
  • Codex CLI 文档：https://learn.chatgpt.com/docs/codex/cli
  • Codex IDE 插件文档：https://learn.chatgpt.com/docs/codex/ide
  • Codex 云端文档：https://learn.chatgpt.com/docs/cloud
  • Codex 套餐与额度：https://learn.chatgpt.com/docs/pricing
  • 命令参考：https://learn.chatgpt.com/docs/developer-commands
  • ChatGPT 桌面 App：https://learn.chatgpt.com/docs/app
  • ChatGPT 套餐对比：https://chatgpt.com/pricing
  • 截图来源：OpenAI《Introducing Codex》、openai/codex README、Codex IDE 文档、Analytics Vidhya《How to Install Codex CLI》
需要开通或续费？ChatGPT Plus 充值 →

Nathaniel 的更多内容

  1. 01

    ChatGPT 图片识别怎么用：上传照片、截图提问与识别不准的处理

    ChatGPT 能看懂照片、截图、图表和手写笔记。本文按官方帮助中心讲清怎么上传图片（含粘贴和拖拽）、支持的格式和 20MB 限制、能不能传视频，以及官方列出的十条识别局限（中日韩文字、旋转、图表线型、计数等）和对应的提问技巧。

    ChatGPT0
  2. 02

    AI绘画提示词怎么写：主体、风格、构图、光线的通用公式与词汇表

    AI 绘画提示词到底怎么写？本文综合 OpenAI、Google、Midjourney 三家官方提示指南，总结一套通用公式（主体 + 动作 + 场景 + 构图 + 光线 + 风格 + 约束），附中英对照词汇表，并讲清 ChatGPT / Nano Banana 与 Midjourney 写法的差别。

    ChatGPT其他 AI 工具0
  3. 03

    Claude Code 权限模式详解：auto、手动、plan、bypass 与权限规则配置

    Claude Code 六种权限模式各自放行什么、怎么用 Shift+Tab 切换、auto 模式为什么提示不可用、allow / ask / deny 规则怎么写，以及 bypass 模式的风险。

    Claude0
  4. 04

    ChatGPT 套餐对比：Free、Go、Plus、Pro、Business 有什么区别（2026）

    ChatGPT 现在有 Free、Go、Plus、Pro（Pro 100 / 200 / 500）和面向团队的 Business。本文按官方价格页和帮助中心整理各套餐在模型、上下文、Work、Codex、生图、语音等方面的区别，并给出按用途选择的建议。

    ChatGPT0
  5. 05

    MCP 是什么：Model Context Protocol 入门，以及在 Claude 里怎么用

    MCP（模型上下文协议）是 Anthropic 发起的开放标准，让 AI 应用统一连接文件、数据库和各种工具。本文讲清它的结构、两种传输方式，以及在 claude.ai、桌面版、Claude Code、API 里怎么用。

    Claude0
  6. 06

    Midjourney 怎么用：网页版从登录到出图的完整流程

    第一次用 Midjourney 不知道从哪下手？本文按官方文档讲清网页版怎么登录、订阅、在 Imagine 栏写提示词出图，以及变体、放大、编辑、转视频和默认设置怎么调，附常见问题。

    其他 AI 工具0

同产品的其他教程

  1. 01

    ChatGPT 已达上限 / Too many requests 怎么办：额度用完、请求过多与模型容量不足的区别

    ChatGPT 提示「已达上限」、「Too many requests」或「model is at capacity」时，原因并不相同。本文按官方帮助中心讲清套餐额度怎么算、何时重置、用完后的回退模型和点数，以及临时限制、容量不足时该怎么处理。

    ChatGPT0
  2. 02

    ChatGPT 读 PDF、总结长文档：上传、提问与核对原文的方法

    怎么让 ChatGPT 读 PDF、总结论文、合同和长报告，而且总结得准？本文按官方帮助中心讲清它能读哪些文档、为什么扫描件读不出来、长文档怎么分步问，并附一套「先结构、再细节、最后核对」的提问模板。

    ChatGPT0
  3. 03

    ChatGPT 怎么设置中文：界面语言、回答语言与语音语言分别在哪改

    ChatGPT 界面是英文、回答老是夹英文、语音听不懂中文？其实这是三个不同的设置。本文按官方帮助中心讲清网页和手机怎么把界面改成中文、怎么让它固定用简体中文回答，以及语音对话的「口语语言」怎么设。

    ChatGPT0
  4. 04

    ChatGPT GPTs 是什么、还能用吗：2026 年 12 月退役与迁移到插件

    ChatGPT 的自定义 GPTs 计划于 2026 年 12 月 11 日退役，由插件（Plugins）接替。本文按官方帮助中心讲清 GPTs 是什么、现在还能不能用和新建、退役时间表、创作者怎么一键迁移到插件、哪些内容不会迁移，以及只是用别人 GPT 的人该怎么办。

    ChatGPT0
  5. 05

    CLAUDE.md 怎么写：最佳实践、模板与 AGENTS.md 的区别

    CLAUDE.md 是什么、放在哪、写什么不写什么？附可复制模板，并讲清 AGENTS.md 是什么、Claude Code 和 Codex 分别怎么读这两个文件，以及一个仓库里怎么让两者共存。

    ClaudeCodex0
  6. 06

    ChatGPT 语音对话怎么用：语音模式开启、不见了的原因与每日上限（2026）

    ChatGPT 语音对话（Voice）2026 年换成了 GPT-Live 驱动的「Live」模式。本文讲清手机和网页怎么开启、各套餐每天能用多久、语音按钮不见了怎么排查，以及语音对话和语音转文字（听写）的区别。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～