Codex 快速入门：从安装、登录到第一个仓库任务

先选择与你工作方式匹配的入口

Codex 可以在不同入口中工作。不要先纠结“哪个最强”，先看任务发生在哪里：

• 经常在终端里操作仓库：使用命令行入口；
• 需要一边看代码一边沟通：使用编辑器集成；
• 想把多个任务交给智能体并查看进度：使用 Codex 应用或云端任务；
• 只需要理解一段代码：也可以先从较小、只读的任务开始。

具体安装方式和账号可用性会随产品更新，请从本文下方的官方来源进入最新说明。

第一次打开仓库前

先确认三件事：项目目录是否正确、当前 Git 状态是否干净、仓库里是否已有 AGENTS.md。后两项会直接影响改动能否安全审查。

建议第一次只给一个边界清楚的任务，例如：

阅读这个仓库的入口、测试命令和 AGENTS.md，不修改文件。告诉我新增一个静态页面应该改哪些位置，并引用具体文件。

这能验证 Codex 是否理解项目结构，也不会立即产生大量改动。

一个高质量任务应包含什么

好的任务通常有四部分：

1. 目标：最后要出现什么结果；
2. 范围：允许改哪些模块，哪些不要碰；
3. 约束：框架、风格、安全和兼容性要求；
4. 验证：需要运行哪些测试或检查。

例如：

在设置页增加导出按钮，只修改前端设置模块；沿用现有按钮组件，不新增依赖。完成后运行相关单测和 TypeScript 检查，并说明改动文件。

工作中要看什么

不要只看最终一句“完成了”。重点检查：

• Codex 是否先读了项目规则和相关文件；
• 实际 diff 是否只覆盖请求范围；
• 有没有删除用户原有的未提交修改；
• 测试是否真的运行，失败原因是否说明；
• 是否引入密钥、隐私数据或不必要依赖；
• 最终说明能否对应到具体文件与结果。

下一步

把通用约定写入AGENTS.md，可以减少每次重复解释。需要审查 pull request 时，再建立Codex 代码审查工作流。遇到环境或权限问题，查看常见故障排查。