Codex 桌面版第一次选择项目

Codex 桌面版第一次选择项目

装好桌面版以后，第一件事不是让 Codex 改代码，而是选择一个安全项目，让它先读项目。

前置教程：Codex 桌面版安装与登录
如果你还没有安装并登录桌面版，先完成前置教程。

依据来源：OpenAI Codex 官方手册中的 Codex app、Projects、App features、Approvals and sandboxing、提示词最佳实践等章节。

你会学到什么

完成本篇后，你会知道：

• 第一次为什么不要选重要项目。
• 如何在桌面版里选择项目文件夹。
• 如何让 Codex 只读分析项目。
• 如何确认 Codex 没有改文件。
• 如何保存第一次只读分析结果，方便后续排障。

第 1 步：选择安全练习项目

第一次使用桌面版，不要直接选择你的正式项目。

优先选择这类目录：

D:\codex-lab\hello-codex

或者你在 Windows 基础环境教程里准备过的练习项目。

这个项目最好满足：

• 是你自己创建的。
• 不包含真实客户数据。
• 不包含真实 API Key。
• 即使改坏了也能删除重来。
• 最好已经用 Git 初始化。

如果你现在只有正式项目，也可以先复制一份作为练习目录。

第 2 步：在 Codex 桌面版里添加项目

打开 Codex 桌面版。

找到类似下面含义的入口：

• Add project
• Open project
• Select folder
• 选择项目
• 添加项目

不同版本文案可能略有变化，你只要找“选择本地项目文件夹”的入口即可。

选择你的练习项目目录。

第 3 步：确认当前项目是练习项目

进入项目后，先看界面上显示的项目名称或路径。

你要确认：

• 当前项目不是正式项目。
• 当前项目路径是你准备的练习目录。
• 没有选到上一级大目录，比如 D:\ 或整个 Downloads。

如果选错了，立刻退出当前项目，重新选择正确目录。

不要让 Codex 在错误目录里开始任务。

第 4 步：发送第一次只读提示词

在 Codex 输入框里复制下面这段：

请先只读分析当前项目，不要修改任何文件，不要运行会改变文件的命令。

请用中文告诉我：
1. 这个项目看起来是什么类型。
2. 入口文件可能在哪里。
3. package.json 或类似配置文件里有哪些可用脚本。
4. 如果后续要让你做一个很小的安全改动，你建议从哪里开始。
5. 本次你没有修改任何文件。

这段提示词的重点不是“问它项目是什么”，而是先建立边界：

• 只读。
• 不改文件。
• 不运行会改变文件的命令。
• 输出中文。
• 说明它没有修改文件。

第 5 步：阅读 Codex 的回答

你不需要看懂每一个技术细节，但要检查 5 件事：

1. 它有没有说项目类型。
2. 它有没有提到入口文件。
3. 它有没有找到脚本或配置文件。
4. 它有没有给出适合新手的小任务建议。
5. 它有没有明确说没有修改文件。

如果 Codex 回答太笼统，继续追问：

请更具体一点。请列出你依据了哪些文件名或目录名得出判断。
仍然不要修改任何文件。

如果 Codex 提到它想运行命令，你可以让它先解释：

先不要运行命令。请先解释你想运行这个命令的目的、是否会修改文件、如果失败会发生什么。

第 6 步：确认没有改文件

如果项目已经用 Git 初始化，桌面版通常会展示变更、diff 或 Git 状态相关信息。

你要确认：

• 没有新增文件。
• 没有修改文件。
• 没有删除文件。

如果界面没有直接展示 Git 状态，可以问 Codex：

请检查当前项目是否有文件变化。只检查，不要修改。
如果有变化，请列出文件；如果没有变化，请明确回复“没有检测到文件变化”。

这里的重点仍然是：让 Codex 检查并解释，不是让用户手动执行一堆命令。

第 7 步：保存第一次成功结果

把这次只读分析的关键结论保存下来即可。

建议记录：

1. 当前选择的项目名称或路径。
2. Codex 判断的项目类型。
3. Codex 找到的入口文件和脚本。
4. Codex 明确说明没有修改文件的结论。

如果后续你配置模型、修改代码、验证结果时遇到问题，可以用这些记录判断：最基础的桌面版项目读取是否已经成功。

常见问题

Codex 说找不到项目文件怎么办

通常是选错目录。

你可以检查：

• 是否选到了空文件夹。
• 是否选到了项目上一级目录。
• 项目里是否真的有 package.json、README.md、源码目录等文件。

解决方式：

1. 退出当前项目。
2. 重新选择具体项目根目录。
3. 再发送只读分析提示词。

Codex 想运行命令怎么办

第一次只读分析时，不建议马上批准。

先让它解释：

请先说明这个命令是否会修改文件，以及你为什么需要运行它。

确认是只读命令后，再根据提示决定是否批准。

什么时候可以让 Codex 修改文件

至少满足这 3 个条件：

• 它已经能正确读懂项目。
• 你知道本次要改哪个小范围。
• 你写了明确的验收标准。

否则先不要进入改代码。

本篇验收

完成后，你应该得到这些结果：

• 桌面版已经添加一个练习项目。
• Codex 已经完成一次只读项目分析。
• 你确认没有文件变化。
• 你知道下一步可以配置模型，或者进入第一次小改动。

下一篇看：桌面版如何使用国内大模型配置。