夜雨聆风
这篇是给第一次用 Codex 的人看的。
不讲复杂原理。
不讲太多概念。
你先照着做一遍：
先下载。
再登录。
再认界面。
最后让 Codex 跑一个最小任务。
能走到最后一步，就算真正入门。
这篇先讲第一部分：怎么把 Codex 装好，并且第一次跑起来。
Skill、插件、项目对话、内容生产系统，我建议放到下一篇讲。
因为第一次安装的时候，先别塞太多东西。
先跑起来。
一、安装入口
你先打开 Codex 官方入口：
https://developers.openai.com/codex/quickstart
或者打开官方文档里的 CLI 页面：
https://developers.openai.com/codex/cli
进去以后，你会看到 Codex 有几种使用方式。
常见的有这几类：
App：桌面应用，适合新手。 CLI：命令行工具，适合习惯终端的人。 IDE 扩展：适合程序员在编辑器里用。 Web：适合先在网页里体验。
第一次上手，建议先从 App 开始。
如果你是第一次用，我建议先选 App。
原因很简单：
App 有界面。
你能看到项目、对话、权限、输出和文件改动。
小白更容易理解。
CLI 不是不能用。
但如果你一上来就被终端、命令、路径卡住，可能还没开始用 Codex，就先被安装劝退了。
小白先用 App 跑通。想折腾命令行，再看 CLI。
下载前，先准备好这几样东西
正式安装前，先准备 3 样东西。
测试文件夹建议直接建在桌面。
名字就叫：
codex-test
里面随便放一点不重要的文件。
比如：
一篇笔记 一个 txt 文件 几张图片 一个 PDF
第一次不要打开正式项目。
不要打开客户资料。
不要打开你唯一一份重要文件。
先用测试文件夹。
Mac 用户看这里
如果你是 Mac，先打开 Codex 官方下载入口。
找到 Codex App 这一块。
一般会看到 macOS 下载选项。
Mac 通常会分成两种：
Apple Silicon Intel
如果你不知道自己的 Mac 是哪一种，可以这样看。
先点左上角苹果图标。
再点“关于本机”。
然后看芯片信息。
如果写的是 M1、M2、M3、M4，就是 Apple Silicon。
如果写的是 Intel，就是 Intel。
下载完成后，一般会得到一个安装包。
打开安装包。
把 Codex 拖进“应用程序”文件夹。
然后去“启动台”或者 Finder 的“应用程序”里，找到 Codex，双击打开。
如果系统提示“无法验证开发者”，不用慌。
这是 macOS 常见安全提示。
你可以去：
系统设置 → 隐私与安全性
看看有没有“仍要打开”的按钮。
点开以后，再重新打开 Codex。
Windows 用户看这里
如果你是 Windows，也先打开官方入口。
找到 Windows 下载入口。
下载完成后，双击安装包。
按照提示一步一步安装。
如果系统弹出：
是否允许此应用对设备进行更改？
点允许。
安装完成后，打开开始菜单。
搜索：
Codex
点开就行。
如果你看到有人说可以用 winget 命令安装，那是给稍微熟悉命令行的人用的。
纯小白先用安装包方式。
打开以后，先登录账号
安装好以后，打开 Codex。
第一次打开，它会让你登录。
通常有两种方式：
用 ChatGPT 账号登录 用 OpenAI API key 登录
小白优先选第一种：
用 ChatGPT 账号登录。
流程大概是这样：
在登录页选择用 ChatGPT 继续。 它会跳到浏览器。 登录你的 ChatGPT / OpenAI 账号。 授权。 回到 Codex App。
如果你能进入 Codex 主界面，或者左下角能看到账号信息，就说明登录成功。
API key 也可以登录。
但对小白来说，API key 更容易遇到额度、权限、粘贴错误这些问题。
所以第一次先用 ChatGPT 账号。
具体额度和功能，以你账号页面和官方说明为准。
不要在文章里死记某个额度数字。
因为这些东西会变。
别急着开工，先认界面
登录成功后，你会看到 Codex 主界面。
先别急着让它干活。
先认这 4 个区域。
先知道每个区域是干什么的，后面才不会乱。
左边栏
左边栏通常放这些东西：
新对话 搜索 项目 插件 / 技能 历史记录
你可以把左边栏理解成 Codex 的目录。
以后你要新建任务、找历史对话、切换项目，大多从这里开始。
左侧栏负责切换任务和项目。
中间区域
中间是对话和执行记录。
你给 Codex 发的需求，会出现在这里。
它读了什么文件、跑了什么命令、做了什么判断，也会在这里出现。
你可以把这里理解成“工作记录区”。
底部输入框
底部是你输入指令的地方。
你要让 Codex 做什么，就从这里发。
底部通常还会有一些按钮，比如：
添加材料 权限模式 模型 推理强度 语音输入 发送 / 停止
第一次不用每个按钮都研究，先会发任务就行。
你所有任务，都是从输入框开始的。
右侧输出面板
右侧通常会显示输出、来源、文件改动、预览等信息。
比如它生成了一篇文章、改了一个文件、做了一个页面，你可以在右侧看到结果。
右侧区域主要看结果和文件改动。
小白第一天，只要先认清这 4 块就够了。
左边切任务。
中间看过程。
底部发指令。
右边看结果。
如果界面是英文，先切成中文
如果你打开以后是英文界面，可以去设置里找语言。
常见路径是：
左下角账号 / 设置入口 → Settings → General → Language → 中文
如果改完没有立刻生效，就退出 Codex，再重新打开。
如果你找不到语言入口，可以直接在输入框里问 Codex：
请一步步告诉我，当前界面在哪里把语言切成中文。
它会根据当前界面给你提示。
第一次测试，只让它看文件夹
界面认完以后，先做一个最小测试。
不要第一次就让它写复杂项目。
不要第一次就让它改正式文件。
先让它只做一件事：
读取测试文件夹，并告诉你里面有什么。
你可以输入：
请先查看这个测试文件夹的结构，不要修改任何文件。 请告诉我： 1. 这个文件夹里有哪些文件； 2. 这些文件大概可以分成哪几类； 3. 如果要整理成一个资料导航页，你建议怎么做。 先只给计划，不要动手修改。
这条指令有两个重点：
第一，明确说：
不要修改任何文件。
第二，明确说：
先只给计划。
这能降低新手第一次使用的风险。
如果 Codex 能正常回复，并且能说清楚文件夹结构，说明第一步已经跑通。
第二个测试，再让它生成一个小页面
如果第一步没问题，可以让它做一个小交付物。
比如本地资料导航页。
你可以输入：
请帮我做一个本地资料导航页。 要求： 1. 生成一个可以本地打开的 HTML 文件； 2. 按文件类型或主题分类； 3. 页面简洁，不要复杂设计； 4. 生成文件前先告诉我你准备新建哪些文件。
如果它先给你计划，你看一下。
如果没问题，再回复：
可以，按这个计划执行。
这一步做完，你会更直观地理解 Codex。
它不是只回答你。
它可以在一个具体文件夹里，帮你生成一个真实文件。
这几句安全提示，建议直接收藏
第一次用 Codex，我建议你把下面几句话收藏起来。
以后只要涉及文件、项目、命令，都可以加上。
先不要修改文件，先告诉我你的计划。
只允许修改这个测试文件夹里的文件。
不要删除任何文件。
如果要新建文件，先告诉我文件名。
如果要运行命令，先告诉我命令的作用。
小白第一次用 Codex，最重要的不是大胆。
是可控。
你要知道它准备做什么，再让它动手。
想用命令行，再看 CLI
如果你已经习惯终端，也可以用 Codex CLI。
官方文档里提供了安装方式。
macOS / Linux 可以打开终端，输入：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
安装完成后，输入：
codex
第一次运行时，它会提示你登录。
你可以用 ChatGPT 账号登录，也可以用 API key。
Windows 可以用 PowerShell，也可以在需要 Linux 环境时使用 WSL2。
但是我还是建议：
如果你完全没用过终端，先别从 CLI 开始。
先用 App 跑通一次。
等你知道 Codex 是怎么工作的，再回来学命令行。
新手常见问题
我不会代码，可以用 Codex 吗？
可以。
但第一次不要让它写复杂项目。
先让它做简单任务。
比如整理文件、解释文件夹结构、生成一个本地 HTML 页面。
我不会命令行怎么办？
先用 App。
不用一开始就学 CLI。
登录时选 ChatGPT 账号还是 API key？
小白优先选 ChatGPT 账号。
API key 适合已经熟悉 OpenAI Platform 的用户。
第一次可以打开正式项目吗？
不建议。
先用测试文件夹。
Codex 会不会乱改文件？
你要给边界。
先只分析，不要修改。
只允许修改这个测试文件夹。
App 和 CLI 到底选哪个？
完全小白选 App。
习惯终端的人选 CLI。
程序员可以再看 IDE 扩展。
最短流程放这里
如果你只想要一个最短流程，就按这个做：
先下载 Codex App。
Mac 选对应芯片版本。
Windows 下载安装包。
再登录 ChatGPT / OpenAI 账号。
优先用 ChatGPT 账号登录。
然后新建测试文件夹。
名字叫：
codex-test
放几个不重要的文件进去。
笔记、图片、PDF 都可以。
最后打开 Codex，输入第一条任务。
复制这段：
请先查看这个测试文件夹的结构，不要修改任何文件。 请告诉我这个文件夹里有什么，以及你建议我第一次让 Codex 做什么。
能跑到这里，就已经不是“只看过教程”了。
你已经真正开始用 Codex 了。
写在最后
Codex 刚上手，按钮会显得有点多。
账号、项目、权限、模型、输入框、输出面板，看起来都很技术。
但你按顺序拆开，其实就几步：
下载 App → 登录账号 → 认界面 → 建测试文件夹 → 先只分析 → 再允许执行
第一次不要追求精通。
先跑通一个最小闭环：
让 Codex 读文件夹 → 总结内容 → 给计划 → 生成一个小文件 → 自己验收
这个闭环跑通以后，你就已经不是在“看 AI 教程”了。
你是真的把 Codex 用起来了。
下一篇再讲：
Codex 装好以后，怎么开项目、用计划模式、装 Skill 和插件，把它接进自己的内容生产系统。
如果你不想一边看教程一边到处找下载入口，我把 Codex 小白安装资料包整理好了。
里面包括：Mac / Windows 安装包领取入口、这篇安装教程、第一次测试提示词、常见问题排查。
在公众号后台回复：Codex资料包，就可以拿到。
