Codex 快速开始：完成第一个代码任务

中文实战指南 · 核验于 2026-11-14

第一次用 Codex，可以先从熟悉的项目开始：请它解释一个函数，修复一个输入校验问题，或者补一条测试。这份指南带你完成 CLI 安装、登录和第一次代码任务。

开始前保留项目中已有的修改，并找到原有的测试命令。选择自己能判断结果的小任务，更容易看清 Codex 做了什么。

安装与登录

已有可用的 Node.js 和 npm 环境时，可按官方 CLI 指南安装：

npm install -g @openai/codex
codex --version

进入目标项目目录后运行 codex，按照界面完成登录。官方也提供其他安装方式；账号登录和 API 凭据的计费、访问条件应分别核对，不能从一个端的订阅推断另一端的额度。

试一个小任务

开始前运行 git status --short，了解已有改动。然后给 Codex 一项具体任务，例如：

Find where email input is validated. Explain the current behavior first.
Add a regression test for empty input and fix the failing case.
Keep changes limited to validation and its tests.
Run the relevant test command and report any remaining failures.

这是一份任务说明示例。实际测试命令应来自项目文档或配置，不要照搬别的项目。

检查结果

查看 Agent 给出的文件清单、测试命令及结果，再运行 git diff 核对业务逻辑。测试通过还需要检查改动是否符合原目标，是否触及不相关文件。已有未提交差异不能全部归为本轮产物。

如果 Agent 无法执行命令，先看 审批与沙箱；如果没理解仓库约定，补充 AGENTS.md。下一次再扩大范围，不把首次任务同时变成大规模重构。