本页可直接阅读、选中文本复制或打印。文中的复制按钮、判断练习和成果保存,请使用互动版。

中文教程 · 独立阅读版

Codex CLI:从终端启动一次项目阅读

进入正确目录,用 codex 开始,核对运行说明与已有文件。

内容整理:2026-09-07 · 资料核对:2026年9月14日

进入互动版,练习并保存成果

开始前准备

能使用终端,按官方 CLI 文档完成系统对应的安装与认证。本篇不要求在桌面应用中新建项目,也不使用云端仓库环境。

1. 先核对位置和 CLI 是否可用

打开官方 CLI 文档的安装区,切换到自己的系统或 npm 标签,按该标签安装;不要把 macOS/Linux 命令直接照搬到 PowerShell。安装后在终端进入练习项目目录,运行 pwd 查看位置,再使用 codex --version 检查是否安装成功。若提示找不到命令,回到安装步骤检查路径,而不是粘贴到 ChatGPT 网页输入框。

终端逐行执行
pwd
codex --version
codex

2. 先请 Codex 阅读项目

首次运行 codex 时选择 Sign in with ChatGPT(使用 ChatGPT 登录)或文档支持的其他认证方式。登录后要求先阅读 AGENTS.md、README 和构建配置,不修改文件。把运行入口、测试命令和不确定项分别列出,核对路径是否存在。

任务提示词
请阅读当前目录的项目说明与约定,不修改文件。
说明运行入口、主要模块和测试命令。
每项附对应文件路径,未执行的命令标为未运行。

3. 结束任务,检查工作区状态

按照 CLI 当前提示退出会话,再在终端查看 Git 状态,确认这次只读任务没有引入意外修改。若项目本身有旧改动,不要为了练习清理它们。

下一次启动仍然先确认目录。CLI 的上下文与终端当前工作位置有关,不要因为桌面应用打开了某个项目就假定终端也在同一路径。

Git 项目中检查状态
git status --short

练习与核对

按实际操作自查,完成标记与成果草稿请在互动版保存。

打开练习与核对

带走这一点

终端里最先要确认的是工作目录,随后才是任务和模型。

资料与核对记录

关键步骤有官方依据

已确认按系统安装、项目目录启动与首次认证流程。

本次核对公开官方资料,未登录产品账号、运行练习或发起付费调用。

步骤对不上?在互动版生成问题记录