如果你有一份代码或待办清单，Codex CLI 可以在终端里读取项目、回答问题，再按你的要求协助修改。下面先在 Mac 上安装命令行工具，用一份虚构清单完成只读任务，约需 10 分钟。
Codex CLI 是 OpenAI 的编程助手。它通过网络连接在线服务，不需要下载本地模型；使用前需要能访问该服务，并登录 ChatGPT 或选择其他可用的登录方式。
开始前准备
| 项目 | 需要准备 |
|---|---|
| 设备 | Mac；本文实测 Apple Silicon、macOS 27.0.1 |
| 账号 | 可使用 Codex 的 ChatGPT 账号，或 OpenAI API Key |
| 网络 | 需要能访问 Codex 服务 |
| 费用 | ChatGPT 登录使用账号套餐包含的 Codex 用量，受套餐和用量限制；API Key 登录按 API 价格计费 |
1. 安装并确认命令可用
打开“终端”，复制官方提供的 macOS 安装命令：
curl -fsSL https://chatgpt.com/codex/install.sh | sh安装结束后，检查终端能否找到 Codex：
codex --version如果刚安装后提示找不到 codex，关掉终端窗口再打开一次，然后重试。仍然不行时，按安装程序提示检查命令路径。
2. 登录并确认登录方式
运行：
codex login按提示在浏览器里登录。第一次使用时，选择“Sign in with ChatGPT”即可；如果用 API Key，费用会记到 OpenAI Platform 账号，和 ChatGPT 套餐用量分开。不要把 API Key 粘贴到聊天内容或公开文件里。
登录后确认当前状态：
codex login status它会显示当前认证状态。想确认自己用的是哪种方式时，以此命令的结果为准。
3. 用虚构清单试做第一个任务
先建一个临时文件夹和练习清单：
mkdir -p ~/codex-first-task
cat > ~/codex-first-task/tasks.txt <<'EOF'
[x] 确认营业时间
[ ] 补充周末营业安排
[ ] 写一份菜单过敏原说明
EOF在终端运行下面的命令。它会要求 Codex 只读这份清单，不修改文件：
codex exec --cd ~/codex-first-task --skip-git-repo-check --sandbox read-only --ephemeral --ignore-user-config \
"只读取 tasks.txt，不要执行其他命令或修改文件。统计已完成和未完成的任务数量，并逐条列出未完成任务。"本机实测返回：已完成 1 项、未完成 2 项，并列出“补充周末营业安排”和“写一份菜单过敏原说明”。文件内容保持不变。--sandbox read-only 将这次任务限制为只读；--ephemeral 不会把本次会话记录写入磁盘；--ignore-user-config 避免本机自定义设置改变这次演示。练习目录不是 Git 仓库，所以示例加了 --skip-git-repo-check；在已有项目里运行时删掉这个选项。
4. 在自己的项目里开始使用
进入项目根目录，再启动交互界面：
cd /你的/项目/目录
codex --sandbox read-only第一次先让它做只读检查，例如：
请先阅读项目说明和相关代码，只解释这个项目如何启动；不要修改文件，也不要执行会改动数据的命令。等你确认它理解了项目，再提出一个范围很小的修改。改代码前先保存 Git 提交或备份；完成后检查变更内容并运行项目自己的验证步骤，不要只凭 Codex 的文字回复判断成功。
常见问题
codex login status 显示未登录怎么办？
重新运行 codex login，在打开的浏览器中完成登录。浏览器流程不能打开时，查看命令参考里的登录选项。
为什么要区分 ChatGPT 登录和 API Key？
两种登录方式的用量和数据设置不同。ChatGPT 登录使用套餐包含的 Codex 用量；API Key 使用 Platform API 计费。提交任务前确认终端登录状态和账号用量。
可以把客户项目直接交给它吗？
先确认你有权把相关代码和资料交给在线服务处理。不要发送密码、密钥、客户个人信息或未获授权的文件。
接下来可以做什么
不熟悉终端的话，先看《终端入门》。掌握只读提问后，再在版本控制保护下尝试一个小修改。