### [01｜第一次使用 Codex：从登录到完成一个小任务](https://www.escai.cn/docs/17)

**Published:** 2026-07-31T15:38:06

**Author:** 奕商创

**Excerpt:** 完成 Codex 登录、选择项目目录，并用一条结构清晰的需求完成你的第一个编码任务。

欢迎来到 Codex 快速上手。本篇不要求你会复杂的命令，只带你完成一件事：让 Codex 理解一个项目，并协助完成一个可验证的小任务。

![Codex 快速上手第一篇封面：开始使用 Codex](https://wp.escai.cn/wp-content/uploads/2026/07/codex-quickstart-01.jpg)

第一步：登录、打开项目、说明目标、确认结果。

## 你会完成什么

-   登录 Codex 并打开一个项目目录。
-   理解为什么项目说明和已有代码比一句模糊需求更重要。
-   用“目标、范围、约束、验证”描述一个小任务。
-   检查修改结果，而不是只看一段回答。

## 1\. 选择一个合适的项目

第一次练习请使用一个可以安全修改的测试项目，或创建一个小型示例目录。不要直接让 Codex 在生产仓库中批量重构、删除文件或发布内容。打开项目后，先让它阅读目录结构、依赖文件和项目说明。

```
请先查看这个项目的目录结构、依赖和已有说明。
暂时不要修改文件，告诉我建议的开发与验证命令。
```

这样可以让后续操作遵循项目已有的框架、测试和格式约定。

## 2\. 用清晰的方式描述任务

高质量的请求应该包含四部分：

1.  **目标：**要解决什么问题。
2.  **范围：**允许修改哪些模块或文件。
3.  **约束：**哪些内容不能改变，例如接口格式、数据库或依赖。
4.  **验证：**如何确认任务完成，例如运行测试和构建。

```
目标：为页面标题增加字数提示。
范围：只修改编辑页组件和相关测试。
约束：不改变现有提交接口，不新增依赖。
验证：运行相关测试，并说明结果。
```

## 3\. 先查看，再执行

当任务影响范围不明确时，先让 Codex 给出实施计划和预计改动文件。确认无误后再要求执行。对于删除数据、修改权限、发布内容或调用外部服务的操作，必须明确授权。

## 4\. 验证结果

完成后不要只看文字说明。检查修改的文件、运行测试或构建，并询问是否存在未覆盖的风险。一个最小验收清单如下：

-   目标功能是否按预期工作。
-   相关测试、构建或静态检查是否通过。
-   是否改动了任务范围以外的文件。
-   是否有需要人工复核的配置、权限或发布动作。

## 下一篇

下一篇将安装 Codex CLI，并处理 Windows 中常见的 Node.js、npm 和 PowerShell 问题。



---