从零开始：让 Codex 完成第一个本地任务

01 · 准备终端与练习目录

本篇以 macOS / Linux 终端为例，需要 Node.js、npm 和 Git。Windows 用户可使用自己已配置好的受支持终端；不要直接照搬不适用的系统命令。先检查工具是否可用，再创建一个全新的练习目录，避免第一次尝试就修改正式项目。

node --version
npm --version
git --version
mkdir codex-first-task
cd codex-first-task
git init

02 · 安装并登录

使用 OpenAI 的 npm 包安装 CLI。命令会下载软件，需要联网；如果出现权限错误，先检查 Node.js 安装方式，不要随意给系统目录放开写权限。运行 codex 后按客户端提示登录。可用能力与用量以你实际登录的账号为准，本站商品不代表官方授权或额外 API 额度。

npm install -g @openai/codex
codex --version
codex

03 · 给出一个可以验收的任务

把下面这段任务发送给 Codex。要求仅使用浏览器原生能力，让输出可以直接检查。先确认当前工作目录正确，再允许它创建练习文件。

在当前练习目录创建 index.html：
做一个中文待办清单，使用原生 HTML、CSS、JavaScript。
支持新增、完成和删除任务，适配手机。
不要引入框架、后端或外部服务。
结束后列出修改的文件、手动检查步骤和未验证项。

04 · 检查结果，再保留改动

用浏览器打开生成的 index.html，分别尝试新增、勾选、删除以及手机窄屏。回到终端检查文件，确认没有不需要的依赖或额外脚本。只有亲自检查后，才把需要的文件加入版本记录。git diff 对未跟踪的新文件不显示正文，需同时查看 git status 和文件内容。

git status --short
git diff
# 检查完成后，按实际文件名提交
git add index.html
git commit -m "Add todo practice page"

常见问题