App 第 01 章 · 第一次打开

安装、登录和第一句话

这一章只做一件事:让你从“还没打开过 Codex App”走到“已经选好一个项目,并且让 Codex 帮你读了一遍”。不需要写代码,也不需要知道终端是什么。

Codex App 第一次使用时的界面区域示意图
先有画面感:打开项目后,你主要盯着中间的对话区和右侧的改动区。

第一步 · 下载和安装

去 OpenAI 官方入口下载 Codex App。macOS 和 Windows 都支持。Windows 用户也可以用 Microsoft Store / winget 安装,但如果你不熟悉命令,直接用图形界面下载就好。

别从陌生网盘下载
Codex 会读你的项目文件,也可能执行命令。安装包一定用官方来源,不要用别人转发的安装包。

第二步 · 登录

打开 App 后,按提示登录。一般有两条路:

如果你只是想跟着这套教程走,优先用 ChatGPT 账号登录。

登录后先检查三件事

登录成功不代表马上就能开工。你先看三件小事:

  1. 账号对不对。如果你有多个 ChatGPT/OpenAI 账号,确认不是登到了旧账号。
  2. 项目入口是否可见。你应该能看到打开文件夹、新建线程或项目列表之类的入口。
  3. Settings 能不能打开。能打开设置,后面权限、浏览器、Computer Use 出问题才有地方调。

如果登录卡住,先不要反复重装。优先检查网络、账号权限、浏览器是否能完成登录流程。企业或团队账号还要确认管理员是否开放 Codex Local。

第三步 · 选择一个项目文件夹

Codex App 不是对着整个电脑乱看。你要给它一个“工作范围”,也就是一个项目文件夹。

零基础读者可以这样做:

  1. 在桌面新建一个文件夹,叫 my-first-codex-project。
  2. 打开 Codex App,选择 Open folder 或 Add project。
  3. 选中刚才那个文件夹。
  4. 新建线程时,先选 Local。

Local 的意思是:Codex 就在这个文件夹里干活。你第一次用,这个最直观。

第四步 · 权限先保守一点

看到权限选项时,新手优先选“默认权限”或“工作区可写”这类保守选项。你可以把它理解成:

不要一上来就给全权限。不是因为 Codex 不可信,而是你还不熟,先让它在小范围里工作更安心。

看到审批弹窗怎么判断

Codex 想做某些动作时,App 可能会弹出审批。新手按这张表判断:

它想做什么通常怎么选理由
读取当前项目文件可以允许这是理解项目的基本动作。
修改当前项目文件先看它要改哪些文件确认范围和你的任务一致。
联网或下载依赖先让它解释为什么需要联网会带来更多不确定性。
访问项目外文件谨慎,优先拒绝或只允许一次新手先把工作限制在项目文件夹内。
操作浏览器或桌面 App人在旁边看着再允许它可能会看到或点击你的真实账号界面。

看到“允许一次”和“本次会话一直允许”时,不确定就选“一次”。等你熟了,再给更宽的权限。

第五步 · 发出第一句话

第一次发消息,不要说“帮我做一个网站”。先让它读项目、解释项目,这样你会知道它能看见什么。

第一次开口
我是零编程基础用户。请你先检查当前项目文件夹,用通俗的话告诉我: 1. 这里面现在有哪些文件 2. 每个文件大概是做什么的 3. 如果我要做一个简单产品官网,下一步应该做什么 这次先不要改任何文件。
最后一句“先不要改文件”很重要。它让你先建立信任,再进入真正动手。

你应该看到什么

Codex 通常会先读文件,然后给你一段解释。如果它想运行命令或改文件,你可能会看到审批提示。新手可以按这条规则判断:

第一次卡住时怎么说

第一次使用最容易卡在“我不知道它现在在干嘛”。这时不要连发十句催它,直接让它汇报状态:

卡住时问状态
请先暂停继续操作,用三句话告诉我: 1. 你现在正在做什么 2. 你是否已经修改了文件 3. 下一步你准备做什么,是否需要我批准
这句话能把局面拉回“可理解”。新手最重要的不是一次成功,而是知道发生了什么。
动手试试
让 Codex 给你的空文件夹做一份说明
  1. 新建一个空文件夹并用 Codex App 打开。
  2. 发送上面的“第一次开口”提示词。
  3. 确认它没有擅自改文件。
  4. 把它给你的下一步建议记下来。
完成标志:你能说清楚“Codex 现在正在看哪个文件夹”。