Codex 详细使用教程：从第一次登录到完成可验证的代码任务
这是一份面向新手和日常开发者的实用指南：了解 Codex 的入口、安装 CLI、连接 IDE、设计任务、配置项目规则、控制权限，并建立“提出任务—修改—验证—复盘”的工作闭环。
What is Codex
Codex 是帮助你写、审查和交付代码的 AI 代理
Codex 桌面端
桌面工作台在项目中组织多个任务，查看变更、评论结果，并继续推进开发工作。
Codex CLI
终端协作登录 ChatGPT 后在终端中使用，适合读代码、改文件、运行命令和验证结果。
IDE 扩展
编辑器内使用在 VS Code 及兼容编辑器中使用，让 Codex 结合当前项目上下文协助开发。
Codex 网页 / Cloud
网页与云端任务在 ChatGPT 网页中使用 Codex，也可以把适合的任务委托到云端环境运行。
选一个入口并登录
桌面端适合长期项目，网页适合快速沟通，CLI 适合终端工作流，IDE 扩展适合边看代码边修改。使用 ChatGPT 账号登录时，最终可用功能以你的账号页面为准。
打开正确的项目目录
先进入项目根目录，再启动 Codex。这样它能看到项目结构、依赖和测试脚本，避免在错误目录里修改文件。
先让它理解，再让它修改
第一条消息先要求说明项目结构、启动方式和验证命令；确认理解正确后，再提出一个范围明确的小改动。
检查变更并验证结果
查看修改了哪些文件，运行项目已有的 lint、test 或 build。结果通过后再继续下一步，不要一次性堆叠多个大任务。
第一个任务可以这样写
目标、范围、上下文和验收方式写在同一条消息里。让 Codex 先给计划，确认后再修改，能明显减少返工。
请先了解这个项目，不要修改文件。
1. 说明项目的启动方式、主要目录和测试命令
2. 找出与登录页相关的文件
3. 给出一个不超过 5 步的修改计划
4. 等我确认计划后再开始修改
如果你需要运行命令，请先说明命令和用途。Codex CLI
在终端里安装和使用 Codex
CLI 适合已经在终端中工作的开发者：进入项目目录后，Codex 可以读取文件、编辑代码、运行命令，并把验证结果带回同一个会话。
/status 看当前会话，再开始任务。Install
macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"安装方式可能随版本变化；遇到差异时，以官方 CLI 页面显示的命令为准。
Daily loop
codex在当前项目目录打开 Codex。
/status查看模型、权限和当前使用情况。
/init为当前项目生成 AGENTS.md 初始文件。
/model切换可用模型和推理强度。
/permissions调整命令执行和文件修改的授权范围。
/review让 Codex 检查当前变更并指出问题。
IDE workflow
在编辑器里保留代码上下文
在 VS Code、Cursor、Windsurf 等兼容编辑器里打开 Codex 侧栏，可以把当前文件、选中代码和项目上下文直接带进对话。适合小步修改、解释代码和查看差异。
查看官方 IDE 使用说明带上必要文件
只附加与任务有关的文件或选区，避免把整个无关目录塞进上下文。
看清差异再应用
先查看修改摘要和具体差异，再决定是否接受；重要项目先建立 Git 检查点。
大任务再委托
短任务本地完成，长任务或适合并行的工作可以委托云端，回来后继续审查结果。
Task design
把需求写成 Codex 能执行的任务
一句“帮我优化一下”通常太宽泛。把目标、范围、上下文和验收标准写清楚，Codex 才能更稳定地行动，也更容易检查是否真的完成。
目标
我要解决什么问题，最终要得到什么结果
范围
允许修改哪些文件或模块，明确不要碰什么
上下文
现象、报错、相关接口、已有约束和参考文件
验收
需要运行哪些命令，什么结果算完成
推荐的任务模板
目标：修复结算页在移动端按钮被遮挡的问题
范围：只修改 checkout 相关组件和样式，不改支付接口
现象：宽度小于 390px 时，提交按钮与底部浮层重叠
要求：保留桌面端布局，补充一个移动端测试
验收：运行 lint，并说明你实际验证了哪些视口和流程
流程：先分析并给计划，确认后再修改让结果更稳定的 5 个习惯
- 1. 一次只解决一个主要目标。
- 2. 指定“先计划、后修改”的顺序。
- 3. 说清楚不能碰的文件、接口和数据。
- 4. 把真实报错、日志和复现步骤完整提供。
- 5. 明确要求运行验证，并汇报未验证部分。
Project context
用项目规则让每次协作都更一致
AGENTS.md 可以写项目的目录说明、编码规范、验证命令和禁止事项。它像给团队成员看的项目协作约定，适合放在仓库根目录，也可以在子目录放更具体的规则。
AGENTS.md
项目级工作规则和验收方式
Skills
把重复的专业流程整理成可复用能力
配置
模型、权限、环境和工具的默认设置
AGENTS.md 示例
project root# 项目协作规则
## 工作方式
- 修改前先说明计划和涉及文件
- 保持现有功能和接口不变，除非明确要求
- 完成后运行项目已有的检查命令
## 验收方式
- 先运行 lint，再运行相关测试
- 汇报修改内容、验证结果和未解决风险
什么时候适合增加 Skill？
当某类工作会反复出现，并且有固定输入、步骤和验收方式时，再把它沉淀成 Skill。不要为了简单的一次性任务增加复杂配置。
Permissions & safety
先控制权限，再让它行动
Codex 能读文件、改文件和运行命令，所以权限设置不是“越开放越方便”，而是要和任务风险匹配。涉及支付、生产环境、密钥和数据库时，必须保留人工确认。
不要把 API Key、Cookie、Token、密码、验证码或生产环境密钥写进提示词、截图、仓库和 AGENTS.md。
Verify before ship
不要只看“改好了”，要验证它真的能用
一个完整的 Codex 任务，应该以可复现的检查结束。把这些要求写进提示词或项目规则里，结果会更容易交付。
看差异
确认修改文件、删除内容和意外变更。
跑检查
按项目已有命令运行 lint、test 或 build。
测边界
补充空值、错误输入、移动端和权限场景。
留记录
记录做了什么、测了什么、还有什么未确认。
推荐的收尾消息
请列出本次修改的文件、运行过的验证命令、验证结果和仍未覆盖的风险。不要只回复“已完成”。
Troubleshooting
常见问题处理
Codex 看不懂项目
确认启动目录是项目根目录，并先让它读取 README、package.json 和测试脚本。
改动范围太大
补充允许修改的文件、禁止修改的目录，以及“先给计划，确认后再改”的要求。
命令执行失败
把完整报错和运行命令交给 Codex，让它先判断是环境问题、依赖问题还是代码问题。
额度消耗过快
缩小上下文，减少无关文件和 MCP/插件，拆成小任务，并按需要选择更轻量的模型。
结果看起来正确但不能用
补充真实输入、边界情况和验收命令，要求它修改后再次运行验证。
Capabilities
它最适合处理可验证的开发任务
越具体、越能运行验证的任务，Codex 越容易发挥价值。它不是替代需求判断，而是帮你把明确的工程任务推进到结果。
写新功能
从需求或规格开始，生成代码并补上必要的验证。
修复问题
根据报错、日志或现象定位问题，修改后运行检查。
理解代码库
梳理陌生项目结构，解释模块关系和关键流程。
重构与维护
在保持现有行为的前提下整理代码，降低维护成本。
审查代码
检查潜在问题、边界情况和缺失验证，辅助上线前复核。
并行推进任务
在桌面端、云端或自动化流程中管理多个开发任务。
Plans
官方计划与 Codex 使用额度
Codex 是否可用、可用多少以及能否购买额外额度，都由 OpenAI 账号中的计划和 Usage 页面决定。任务复杂度、模型、上下文和运行位置都会影响实际消耗，不能用固定消息数承诺使用量。
Free / Go
当前开放范围以账号为准
OpenAI 当前帮助中心将 Codex 列入 Free 与 Go 的开放范围，但可用功能、地区和使用限额可能变化。
Plus
包含 Codex 使用额度
适合个人日常开发。实际可用量会受任务大小、模型和执行位置影响。
Pro
更高使用余量
官方 Pro 有 $100 和 $200 两档，核心能力相同，主要差别是使用余量。
Business / Enterprise / Edu
按工作区规则使用
适合团队和组织，管理员可以管理访问权限、模型设置和工作区策略。
小黑丸订阅服务入口
Plus、Pro 5X、Pro 20X 怎么选
Pro 5X / Pro 20X 是小黑丸商品页面使用的服务标识，对应 Pro 不同使用余量层级，不是 OpenAI 官方计划名称。实际官方计划、账单价格和可用额度请以 ChatGPT 账号页面为准。
不要提交密码或验证码
不要在聊天或陌生页面提交账号密码、邮箱验证码和支付凭证；具体信息要求以商品页为准。
先看官方 Usage 页面
计划、额度、可购买选项和价格会因账号而异，ChatGPT 账号页面是最终依据。
小黑丸不是官方站点
小黑丸提供独立的商品和人工服务，不代表 OpenAI 官方，也不声称获得官方授权。
常见问题
Codex 是什么？
Codex 是 OpenAI 的编程代理，可以帮助用户写代码、审查代码并推进交付。它可以在桌面端、网页、终端和 IDE 扩展中使用。
哪些 ChatGPT 计划可以使用 Codex？
OpenAI 当前帮助中心写明 Codex 已覆盖 ChatGPT 计划，包括 Free 和 Go；不同账号的开放功能、地区支持和使用限额可能不同，最终以账号实际显示为准。
Codex 的使用量怎么计算？
使用量会受到任务大小、上下文长度、模型和运行位置影响。简单脚本可能只消耗一小部分额度，复杂代码库、长时间任务和多步骤工作通常消耗更多。
Codex 额度在哪里查看或购买？
先在 ChatGPT 或 Codex 的 Settings / Usage 页面查看账号余额和可用选项。部分 Plus、Pro 账号在达到包含额度后可以购买额外额度，是否支持及价格以账号页面为准。
官方 Pro 和 Pro 5X、Pro 20X 是一回事吗？
OpenAI 官方使用 Pro $100 和 Pro $200 表示两档 Pro 计划，主要差别是使用余量。Pro 5X、Pro 20X 是小黑丸商品页面用于区分人工服务档位的名称，购买前请以 ChatGPT 官方计划页面和具体商品说明为准。
小黑丸这里是自动开通吗？
当前页面关联的 Plus / Pro 订阅服务是人工处理，不是 OpenAI 官方页面。支付后订单进入后台，由管理员按商品说明核验并跟进；具体提交内容、交付方式和售后范围以商品页为准。