Codex 是 ChatGPT 体系中专用于软件开发的 AI 智能体工作模式，区别于普通 Chat 对话模式与 Work 办公模式，主打目标驱动、自主执行、工程落地。对于新手而言，Codex 不再是简单的“问答写代码”，而是可以自主读取项目、分析结构、修改文件、运行测试、输出可评审代码的协同开发工具。本文基于 OpenAI 官方文档，从零讲解 Codex 的入门前提、模式区分、环境选择、标准使用流程与新手最佳实践，帮助零基础用户快速建立完整的 Codex 使用认知。
一、入门前置条件
Codex 属于 ChatGPT 付费专属能力，免费账号无法解锁开发者智能体功能，正式入门前需满足两项基础条件：
- 账号权限：拥有 ChatGPT Plus、Pro、Business 或 Enterprise 有效订阅权限。优先使用账号密码登录，API Key 登录会缺失部分本地工程、可视化评审等核心能力。
- 设备与客户端：支持 ChatGPT 桌面端（Windows/macOS/Linux）、网页端、Codex CLI、IDE 插件多端入口，新手推荐优先使用功能最全、操作最直观的桌面客户端。
二、基础认知：三种工作模式区分
入门首要核心，是分清 ChatGPT 三类工作模式，根据场景正确选择 Codex，避免混用导致效果偏差：
- Chat 模式：通用轻量对话，适用于提问、 brainstorm、简单文本交流，不具备工程操作能力。
- Work 模式：面向办公场景，用于文档撰写、数据分析、方案整理，不支持代码仓库读写与终端命令执行。
- Codex 模式：专属开发者模式，唯一支持读取项目源码、修改文件、运行测试、查看代码 Diff、管理 PR、执行 Shell 命令的工作模式，是所有开发任务的唯一正确入口。
三、两大运行环境选择（入门必懂）
Codex 所有开发任务均运行在两类标准化环境中，新手需根据项目属性灵活选择，二者能力与适用场景差异明确：
1. 本地环境（Local）
仅桌面客户端支持，授权后可直接读写本机项目文件夹，全程依托本地设备权限运行。适合私密项目、本地调试、离线开发、小型功能迭代，数据留存本地、无云端泄露风险。缺点是任务依赖设备开机在线状态，关闭客户端或设备休眠后任务会中断。
2. 云端沙箱环境（Codex Cloud）
官方托管的隔离式云端环境，桌面端、网页端均可使用，网页端仅支持该环境、无法访问本地文件。云端环境可保存项目仓库、依赖配置，支持跨设备接续任务，可后台持续运行、不受设备状态影响。适合长期迭代、大型项目重构、团队协作、跨设备开发场景，全程操作可追溯、安全隔离。
四、新手标准入门操作流程
Codex 摒弃传统 AI “一问一答”模式，统一遵循提供上下文→描述目标→智能自主执行→人工审核迭代的标准化流程，新手严格按照该流程操作，即可稳定产出高质量代码成果。
1. 准备项目上下文
新建或关联已有项目文件夹，授权 Codex 访问目录权限。可将长期开发项目归入 Project 项目容器，统一留存文件、配置与会话上下文，避免每次任务重复说明项目信息。单次独立开发任务将自动生成 Thread 任务会话，全程隔离、互不干扰。
2. 编写规范任务目标
Codex 无需精细分步指令，只需用自然语言描述最终任务目标，新手遵循「目标+范围+约束+验收标准」四要素即可：明确要实现的功能、限定修改范围、说明代码规范与性能约束、定义任务完成标准。提示词无需一次完美，支持同一会话多轮迭代优化。
新手示例：读取当前项目，优化接口参数校验逻辑，修复空指针异常，保持原有业务功能不变，并为修改方法生成完整单元测试。
3. 等待智能体自动执行
提交任务后，Codex 启动 Agent 循环机制，自动完成项目架构分析、源码修改、命令执行、测试运行、问题自查迭代等全流程操作。复杂任务会自动通过 Subagents 子代理并行拆解执行，全程无需人工分步干预。
4. 人工审核与迭代优化
任务完成后，通过右侧开发视图查看代码 Diff、终端日志、测试结果。所有 AI 生成与修改的代码均为草稿，必须人工校验逻辑正确性、安全性与性能。若效果不达标，可在原 Thread 会话中直接下发优化指令，持续迭代直至满足需求。
五、新手推荐入门任务（零风险练手）
新手初次使用不建议直接修改正式项目，可从低风险练手任务熟悉完整流程，快速掌握核心能力：
- 新建空文件夹，让 Codex 生成项目说明文档、基础脚手架代码；
- 让 Codex 读取简单项目，梳理项目架构、模块依赖并生成注释；
- 为已有简单函数补充边界判断、优化代码冗余、生成单元测试；
- 修复简单语法 Bug、优化代码格式，统一项目编码规范。
六、基础协作与安全规范
1. 基础协作能力
Codex 支持新手快速完成团队协作复盘，可通过 /share 命令生成 Thread 只读快照，个人账户可公开分享，企业工作区可精细化管控访问权限，方便代码评审与任务交流，系统会自动脱敏密钥等敏感信息。
2. 新手安全准则
Codex 运行在隔离沙箱环境，高危操作会触发人工确认，但不代表绝对安全。新手必须牢记：AI 输出仅为辅助草稿，禁止直接合并至生产环境；大型任务尽量拆分细分步执行，降低出错风险；本地开发严格管控文件夹授权，避免泄露私密代码。
七、入门常见误区规避
- 误区一：混用 Chat/Work 模式写代码，导致无法识别项目、无法修改文件、无工程细节输出；
- 误区二：只提问题不设目标，任务模糊导致代码零散、不符合项目规范；
- 误区三：直接采信 AI 结果，省略人工审核，容易出现逻辑漏洞与安全隐患；
- 误区四：复杂任务一次性提交，不做拆分，导致任务执行失败、输出质量不佳。
八、总结
Codex 基础入门的核心，是建立「选对模式、分清环境、目标驱动、人工兜底」的正确使用思维。新手无需掌握复杂指令与专业配置，只需区分三类工作模式、灵活切换本地与云端环境，遵循标准化任务流程，即可快速完成代码生成、调试、优化、测试等基础开发工作。熟练掌握入门规范后，可进一步学习技能复用、权限规则、多智能体并行等进阶能力，充分发挥 Codex 的工程自动化价值。
0 条笔记