Appearance
Codex 使用教程：从安装到完成第一个代码任务
如果你第一次使用 Codex，最稳妥的路径是先准备一个可回滚的仓库，再让它完成一个边界清楚的小任务。本文按“准备项目 -> 安装入口 -> 授权 -> 执行任务 -> 检查改动”的顺序走一遍。
图示：从本地项目到可验证改动的最小流程，图片为本站原创示意图。
先理解 Codex 适合做什么
Codex 是面向软件开发的编码代理。它适合在项目目录中读取文件、修改代码、运行命令，并把改动留在 Git 工作区里。它仍然需要人的验收：依赖安装、测试结果、权限边界和业务判断都不能只看模型回复。
官方入口：OpenAI Codex 文档。CLI、编辑器集成和可用入口会随账号、地区与版本变化，安装前以官方页面为准。
1. 准备一个可回滚的项目
bash
cd your-project
git status
git switch -c codex/first-task如果项目还没有测试，至少先记录当前可以运行的命令，例如 npm test、pytest 或 go test ./...。不要把生产密钥、个人数据和未脱敏日志直接放进提示词或仓库。
2. 安装并登录
Codex 的安装命令可能因发行渠道更新而变化。请打开官方 Codex 文档，按当前页面提供的 CLI 或应用安装方式操作；不要复制来源不明的二进制下载命令。安装后先确认版本：
bash
codex --version首次运行通常需要完成账号授权。授权完成后，回到项目目录再启动 Codex，避免它在错误的目录中读取文件。
3. 写一个可验证的第一个任务
text
请在 src/utils/date.ts 中增加 formatDate(input, timezone) 函数。
要求：
1. 先阅读现有日期工具和测试，不要新增依赖；
2. 保持现有导出风格；
3. 为空值、非法日期和时区参数补充测试；
4. 修改完成后运行相关测试；
5. 最后列出修改文件、测试命令和仍未覆盖的边界。这段提示词把目标、约束、验证和输出格式一次说清楚，Codex 更容易形成闭环。
4. 检查结果，而不是只看总结
完成后按四步检查：看 git diff，确认没有无关文件和大范围格式化；阅读新增测试；运行项目的标准检查命令；必要时让 Codex 解释一处改动，但以代码和测试为准。若结果不对，先给出失败命令和完整错误，再要求它只修复当前问题。
AIMI 与 AICNBOX 可以放在哪一步
当你需要先整理需求、比较不同模型的回答风格，或处理与代码无关的文档、PPT 和图片任务时，可以把 AIMI（chat.aimirror123.com）作为多模型应用入口；AICNBOX（chat.aicnbox.com）适合快速打开常见大模型与绘图能力。它们不是 OpenAI 官方 Codex 服务，具体模型、额度和登录状态应以各自页面为准。
常见问题
Codex 使用教程适合不会命令行的用户吗？
适合，但建议先掌握进入目录、查看 Git 状态和运行测试三个基本动作。完全不熟悉终端时，可先在编辑器中完成同样流程。
Codex 第一个任务应该多大？
建议控制在一个模块或一个明确 Bug 内，最好能在几分钟内运行测试验证。跨目录重构和版本升级不适合作为第一次任务。
Codex 修改代码后如何确认没有引入问题？
同时检查 git diff、相关测试和项目原有检查命令。测试通过只能说明覆盖到的场景正常，仍要人工阅读关键逻辑。
AIMI、AICNBOX 和 Codex 使用教程中的角色有什么区别？
Codex 面向代码仓库中的开发任务；AIMI 与 AICNBOX 是多模型应用入口，更适合对话、内容整理、PPT 或绘图等任务。