Codex 第一次上手：安装、登录，再读懂一个练习项目

第一次使用 Codex，不必先交给它一个真实公司项目。本课从 Windows 终端开始，准备两个自己写的小文件，让它分清“工作规则”和“本周进展”。你将学会选对目录、发出读文件请求，并判断回答是否真的来自材料。

本课使用 Codex CLI。CLI 就是在终端里运行的界面；普通 ChatGPT 网页对话、桌面应用和编辑器扩展是不同入口，不能把本课的终端命令当成所有界面的按钮名称。

1. 先确认账号和安装条件

准备一台允许安装软件的 Windows 电脑、可正常访问服务的网络和自己的账号。用 ChatGPT 登录时，Codex 权益受账号计划、额度和工作区权限影响；使用 API Key 则另按 API 用量计费。免费阅读教程、下载资源，不等于免费使用模型。本课选择 ChatGPT 登录，不要求申请 API Key。

先从 OpenAI 官方产品页面找到 Codex，进入文档的 CLI—Getting started。本课使用其中的 npm 安装方式。如果还没有 Node.js，从 Node.js 官方下载页面选择适合 Windows 的 LTS 安装程序，安装时保留 npm。完成后重新打开 PowerShell。

运行以下检查，正常应分别出现版本号：

node --version
npm.cmd --version

随后安装客户端并确认结果：

npm.cmd install -g @openai/codex
codex.cmd --version
codex.cmd --help

安装会写入电脑的软件目录；公司设备先遵循安装管理要求。本课编辑时可读取的 npm 版为 codex-cli 0.144.6，并核对了帮助信息，不代表这是当前唯一或最新版本。

若你已经使用官方独立安装器装好了客户端，不要再装第二份；用 codex --version 检查，后文的 codex.cmd 相应改成 codex。npm.cmd 路线中的 .cmd 是 Windows 启动文件，不适用于 macOS 命令行。

2. 用文件管理器做一个最小项目

在文件资源管理器创建 C:\ai-practice\codex-first，不要复用装着私人资料的目录。开启“查看—显示—文件扩展名”，以免文件名多出 .txt 后缀。

用记事本创建 周报规则.txt，选择 UTF-8 保存，内容完整复制如下：

这是虚构练习，不涉及真实客户。
每周三整理周报，分为已完成、进行中、待确认三部分。
只有明确完成的事项可以进入已完成。
没有给出的负责人、日期或效果数据，不得补写。

再创建 本周记录.txt：

资料目录整理：已经完成。
下载说明校对：还差手机端说明，正在处理。
演示日期：尚未确定。
本记录未说明负责人，也没有统计节省时间。

现在目录只应有这两个文件。它不是软件代码仓库，也不需要先安装额外依赖。这里的“项目”只是你本次工作的文件集合。

分成两个文件是为了建立一个重要区别：规则告诉 Codex 怎么处理信息，记录才提供本次事实。“每周三整理”不能被当作“演示在周三”。

3. 在这个目录打开终端并登录

进入练习目录后，在资源管理器地址栏输入 powershell 并回车。终端出现后先执行：

Get-Location
Get-ChildItem -File | Select-Object Name
Get-FileHash -LiteralPath '.\周报规则.txt','.\本周记录.txt' -Algorithm SHA256

第一行路径必须是 C:\ai-practice\codex-first；第二行应列出两个文件。第三行给出每个文件的校验值，复制到自己临时的练习笔记中，稍后用来确认材料有没有改变。校验值能比较文件字节，不能证明内容本来就正确。

再启动：

codex.cmd --sandbox read-only --ask-for-approval on-request

首次启动按提示选择 Sign in with ChatGPT，在浏览器完成自己的账号认证，返回终端。不要将验证码、登录缓存或账号密码发给 AI。如果没有可用权益，先查看账号与工作区设置；反复重新安装无法增加额度。

看到会话输入区后，核对工作目录和权限显示。read-only 用于限制写入，on-request 保留请求批准的行为；本课不批准更广权限。也不要把“只读”理解为模型不联网或只能看见两个文件，文件范围仍需在任务中写清。

4. 发出第一条有明确结果的请求

接下来的文字输入 Codex 对话区，不是 PowerShell。整段提交：

只读取当前练习目录里的周报规则.txt和本周记录.txt。
先报告你实际读取的两个文件名。
根据规则，把记录分为已完成、进行中、待确认三部分。
最后说明哪些信息不足，不能写成事实。
只在对话里回答，不修改或新建文件，不运行安装命令，
不检索网络，不访问其他目录，不对外发送内容。

观察它实际读取文件的记录。能复述你在对话里写的文件名，不等于已经打开文件；如果工具记录显示路径不对，先中止这一轮并纠正工作目录。

人工编写的教学参考如下，不是本课已运行模型的记录：

读取文件：周报规则.txt、本周记录.txt。
已完成：资料目录整理。
进行中：下载说明校对，仍缺手机端说明。
待确认：演示日期。
信息不足：负责人、具体演示日期、节省时间数据未提供。

不用追求逐字一样，但每条状态必须一致。一个看起来很像周报的反例是：“周三演示，校对已全部完成，团队效率提升明显。”它混淆了规则和事实，又补出了没有证据的结果。

5. 用一次追问检查它如何处理未知

继续问：

根据刚才两个文件，演示具体是哪一天？
不要根据今天日期推算，指出材料能支持的结论。

正确方向是“无法确定，记录写的是尚未确定；周三是整理周报的时间”。如果它编出日期，明确指出混淆发生在哪里，再要求修正，不要把这次错误当成“语言风格不好”。

结束会话后回到 PowerShell，重复之前的 Get-FileHash 命令，两个值应与开始前一致；文件列表也不应多出周报成品。读文件练习没有要求生成文件，所以对话里给了答案、目录里没有新文件，恰恰是正确行为。

6. 常见卡点按出现位置处理

“不是内部或外部命令”发生在客户端启动前，先看命令安装和新终端的路径；npm 路线可用 Get-Command codex.cmd 查看命令实际位置，不必公开个人完整路径。

如果安装完成却登录失败，记录具体提示，检查账号权限、正常网络和组织政策；不关闭系统防护，也不粘贴登录缓存求助。若客户端可用但说找不到材料，回到 Get-Location 和文件扩展名检查，不要让它搜索整个磁盘。

如果读到了材料却把状态写错，问题位于理解和整理这一层。指出“正在处理”被误写为“已完成”，要求只修正错误状态，并再次对照原文。

完成本课后，你应能把“客户端能启动”“文件能读取”“结论有依据”分开验证。下一课 检查 Codex 的真实交付 会让你处理一个生成文件的任务；想使用本站下载的工作流，再进入 Codex Skill 实操。本文完成了官方文档与本地命令帮助核对，未替读者安装、登录或运行模型。