--- description: "用 Codex 完成第一个任务的入门教程，带你选择工作目录、输入任务、查看结果并完成基础验证，形成操作习惯。" --- ::: tip 最后核对 官方资料最后核对日期：2026-06-29。本章以桌面 App 第一个任务为例，Codex App 的项目、工作区、权限和任务执行入口请以 [Codex App docs](https://developers.openai.com/codex/app)、[Settings](https://developers.openai.com/codex/app/settings) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security) 为准。 ::: # 用 Codex 完成第一个任务 本章以"用 Codex 桌面 App 开发一个关于 AI 发展历史的简单网页"为例，走完一次完整的任务闭环，帮助你快速上手 Codex 桌面 App 的基本用法。 ## 第一步：创建本地工作文件夹 在本地新建一个空文件夹，作为 Codex 的工作目录。Codex 生成的所有文件都会保存在这里。 ::: warning 文件夹路径中尽量不要包含中文，避免部分工具出现兼容性问题。 ::: ![新建本地文件夹](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-local-folder.png) ## 第二步：选择对话还是项目 打开 Codex 桌面 App 后，你需要选择用"对话"还是"项目"来开始任务。 - **对话**：适合一次性任务，操作简单，但多个对话之间不共享工作目录。 - **项目**：支持在同一工作目录下创建多个对话，每个对话处理不同的子任务，管理更方便。 如果你不确定选哪个，**优先选择项目**——后续扩展任务时更灵活，工作目录也只需要配置一次。 ## 第三步：添加工作目录 选择项目后，点击"使用现有文件夹"，选中刚才创建的文件夹。 ![选择工作目录](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-add-workspace-folder.png) 选择完成后，对话框左下角会显示当前工作目录的路径，确认路径正确即可。 ![确认工作目录](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-selected-workspace.png) ## 第四步：输入任务描述，开始执行 在对话框中输入你的需求，点击发送，Codex 就会开始执行任务。 ![输入任务并发送](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-prompt-input.png) 任务完成后，Codex 会在对话中展示结果，同时将生成的文件写入工作目录。 ![任务完成](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-completion.png) 如果生成的是网页文件，可以直接点击 Codex 弹出的"打开"按钮，在 App 内置浏览器中预览效果，无需手动打开文件夹。 ![内置浏览器预览](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-browser-preview.png) ## 第五步：逐步迭代 对结果不满意时，直接在当前对话框中继续描述修改需求，Codex 会在已有基础上进行调整。 随着对话轮次增加，上下文窗口会逐渐被填满。点击对话框右下角的小圆圈图标，可以查看当前上下文使用情况。 ![上下文使用情况](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-context-usage.png) ::: info 什么是上下文窗口？ 每次对话都有容量上限，每一轮问答都会占用一定空间。当上下文接近满载时，建议在项目中新建一个对话继续处理后续任务——新对话仍然共享同一工作目录，不需要重新配置。 ::: ![项目中新建对话](https://cdn.canghecode.com/codexguide/docs/images/codex-first-task-new-chat-in-project.png) 如果使用的是"对话"模式而非项目，新建对话时需要重新指定工作目录，两个对话之间也是相互隔离的，不方便统一管理。这也是推荐使用项目的主要原因之一。 ## 下一步 下一步：[任务设计](./07-task-design.md)。