Codex CLI 安装与入门

返回 Codex 教学总目录

读完能做到什么

CLI 是在终端机操作 Codex 的入口。终端机负责启动程式，Codex 输入框负责接收任务；两者外观都像文字介面，但输入的意思不同。先看终端机与路径，能找到目前资料夹后再开始。图中 01 是启动前检查，02 是工作阶段，03 是档案验收。

开始之前：只选一种安装方式

先在自己的电脑建立一般使用者可写入的练习资料夹，不要直接用正式专案。帐号是否能使用 Codex、使用哪一种登入，以及额度资讯，先查帐号与用量。可以启动程式不代表帐号有可用额度；登入成功也不代表已取得目标资料夹权限。

逐步安装分别见Windows、macOS、Linux／WSL。三篇是替代路线，不必依序安装三套系统。若上述文章尚未公开，可直接依本篇末的官方 CLI 安装页，选自己的平台分页；完成下载、重新开启终端机，再做下面两项检查。不要为了比较方法把 npm、Homebrew 与独立版全部装一次。

codex --version
codex --help

这两行贴在系统终端机，预期显示版本及使用说明后回到提示符号，尚未开始模型任务。找不到 codex 就停在安装排错，先不要登入。实际查得的版本可能比文章新；以本机 help 和官方文件核对旗标，不要求安装本文验证时的预览版。

步骤一：建立能辨认的练习档

在文字编辑器建立 greeting.txt，内容如下；再另存一份 greeting.original.txt。两个档案放进新资料夹 codex-cli-lab。确认副档名没有变成 .txt.txt，内容不是 Word 档案。第二行是固定版本标记，用来分辨读到的是否真是你的练习档；备份则能核对修改前后。

Hello, traveler.
Lesson marker: CLI-START-01

Windows 在档案总管开启这个资料夹，使用「在终端机中开启」并选 PowerShell，执行 Get-Location 和 Get-ChildItem。macOS／Linux 在终端机输入 cd 加上这个资料夹的完整路径，再执行 pwd 和 ls；路径有空格就加引号。清单必须包含刚才的两个档案。若还显示家目录或下载目录，先定位，不能只因看见档案名称就猜已在对的地方。

步骤二：登入并启动唯读工作阶段

codex login
codex login status
codex --sandbox read-only

在系统终端机逐行执行，前一行完成才继续。login 依画面完成浏览器登入；选你预期的帐号及工作区。login status 用来确认已有凭证，不证明额度、网路或模型请求一定成功。第三行开启互动介面并指定唯读沙盒；若出现资料夹信任或沙盒设定，先核对路径和画面说明，再选符合本次练习的设定。

进入 Codex 输入框后才执行下面的 /status。检视目前目录、模型及权限资讯，栏位依版本而异。不要把它贴回 PowerShell，也不要把「read-only」理解成完全没有网路或所有外部工具都被禁用；它设定的是沙盒范围，外部工具仍受各自授权控制。本练习只使用本机文字档。

/status

Read greeting.txt in the current folder. Report the working directory and both lines exactly. Do not edit files, use external services, or infer missing content. If the file is missing, stop and report that.

这一段是自然语言任务，贴在 Codex 对话。合格回复必须对得上两行原文与目前目录；同时检视读档工具记录，确认有实际读取，不只照抄提示词。如果它说找不到档案，先停止后续修改；若档案存在但沙盒读不到，记录错误与范围，接著查权限教学。

步骤三：只修改指定的一行

在 Codex 输入 /exit，看到系统终端机提示符号后，于同一个练习资料夹重新启动下列写入工作阶段。这个练习刻意分开读取和写入，让你看到授权范围的差异；不必为了改一行开启全磁碟存取。若组织政策不允许这个模式，保留唯读练习结果并确认管理设定。

codex --sandbox workspace-write --ask-for-approval on-request

In greeting.txt, replace only the first line with: Hello, Codex learner.
Preserve the lesson marker and greeting.original.txt. Do not create other project files.
Read the file after editing and report the exact before/after change.

第一个区块是启动命令，第二个才是进入 Codex 后送出的要求。审核提出的命令与差异；如果改到备份或多出专案档，先指出偏离范围，要求修正后重新读档。合格结果是第一行变成 Hello, Codex learner.，第二行仍是原标记，备份完全不变。不要只以回复中的「完成」作为验收。

步骤四：退出、验证与接续

修改完成后，先在目前的 Codex 工作阶段做一次缺档测试：要求读取 greeting-missing.txt，并明说档案不存在就回报、不要建立。预期是清楚指出缺档，原档和备份不受影响。这能分辨有查档案与凭名称猜测内容的回复。接著输入 /exit 回到系统终端机，再使用文字编辑器独立开启两个档案比对。

退出后在系统终端机执行 codex resume，从清单依时间、内容和目录找回这次工作，不要假定最近一笔就是它。接续后要求摘要已做修改与剩余工作，再读 greeting.txt 核对实际状态。接续储存的对话不会把硬碟还原成当时版本；如果你在外部编辑过档案，应以目前档案为准。

codex resume

接续后先做一个状态判读：对话若记著「已把第一行改好」，但你刚从备份还原 greeting.txt，Codex 应重新读档后说明目前是 Hello, traveler.。请明确要求「只读取并比较，不要再次套用上次修改」。新任务、退出与接续是管理对话的动作；真正的恢复仍靠你核对与还原档案。需要分岔或跨目录查找时，再看工作阶段教学。

要重做练习，退出后将 greeting.original.txt 的两行内容复制回 greeting.txt，再核对两份一致。只还原这个练习档，不用删除整个 Codex 设定或所有工作阶段。更新 CLI 时也使用原本的安装管道，重新开启终端机核对版本；日后更换管道才另外检查重复安装。

常见问题与完成检查

命令找不到：确认是在系统 shell、重新开启视窗，依平台篇查 PATH。登入页完成但 CLI 等待：核对是否为同一笔登入、浏览器是否回到本机流程；不要在公开贴文贴登入网址或程式码。状态有登入却无法送出任务：分开记录额度、组织政策或网路错误，再查帐号篇。唯读不能修改：先核对本次是否仍在 read-only 工作阶段，不要反复重灌 CLI。

完成时应保有：安装版本、正确目录与两行读取证据、只改第一行的档案、未变的备份、缺档回报、可接续的工作阶段。接著阅读常用指令及AGENTS.md，把专案规则补进后续练习。本文 Windows 本机只验证版本与 help，以及练习档比较方法；安装、帐号与互动模型流程依官方查证，macOS／Linux 未宣称已亲自操作。

返回 Codex 教学总目录

阅读完整文字说明

Terminal to codex to Project

• AI 工具
• 教程
• Codex