适合人群：会一点 Python 或 JavaScript、平时在终端里跑脚本的学生和编程新手，想让 AI 读懂自己的小项目并帮忙改功能，又希望每一步都看得见、改得回。需要说明：OpenAI 已把 Codex 整合进 ChatGPT 桌面应用，本文只讲终端里的 Codex CLI。按官方定价页，CLI 包含在 Plus 及以上套餐中（也可以用 API 密钥登录，按 API 计费），Free 和 Go 套餐目前主要是在桌面应用里逐步开放，具体以官网为准；命令和选项名称以写作时官方文档为准。
本文用一个小例子贯穿：小陈有一个 Python 记账脚本，读取 bills.csv（日期、类别、金额三列）并输出总支出。他想加一个“按月份汇总”的功能，同时确保 Codex 不会乱改别的文件。
一、准备：先让项目有 Git 记录
官方建议在每次任务前后各做一次 Git 提交，方便随时回退。项目还没用 Git 的话，在项目目录执行：
gitinitgitadd.gitcommit-m"开始用 Codex 之前的版本"这一步还有一个好处：Codex 启动时会检测文件夹是否在版本控制下，并据此推荐默认权限（见第四步）。
二、安装 Codex CLI
官方提供了几种安装方式，任选一种：
- 官方独立安装脚本：macOS、Linux 在终端运行，Windows 在新开的 PowerShell 窗口中运行；
- npm 全局安装官方包（适合已装 Node.js 的同学）；
- Homebrew：
brewinstall--caskcodex脚本和 npm 的完整命令请从官方 Codex CLI 页面复制。以后需要更新时，再运行一次相同的安装命令即可（Homebrew 用brew upgrade --cask codex）。
三、启动并登录
cd~/projects/bill-tool codex第一次运行会出现登录界面，选择“Sign in with ChatGPT”，浏览器会打开登录页，登录后凭据会回传给 Codex 并缓存下来。CLI 和 IDE 插件共用同一份登录信息，在任意一处退出，两边都需要重新登录。
四、看懂权限：沙箱和审批
Codex 用两层设置来控制它能做什么：
- 沙箱：技术上允许它写哪里、能不能联网；
- 审批策略：哪些操作要先问你。
官方说明的默认推荐是：在 Git 管理的文件夹里使用 Auto 预设，可以读文件、改文件、在工作目录内运行命令，但改工作目录以外的文件或联网时会请求你批准；不在版本控制下的文件夹则推荐只读。输入/permissions可以随时在 Auto 和 Read Only 等预设之间切换，输入/status可以查看当前模型、审批策略和可写目录。官方表格里那个跳过沙箱和审批的“完全放开”选项明确标注为不推荐，新手不要用。
五、第一个任务：先读懂，再计划
先问一个只读问题，中文也可以：
用中文介绍一下这个项目：入口文件是哪个，数据怎么读入，现在能输出什么确认它理解正确后，输入/plan切换到计划模式，再描述需求：
/plan 增加按月份汇总支出的功能：读取 bills.csv，按“年-月”分组输出每月合计， 不修改现有的总支出逻辑，不新增第三方依赖，完成后告诉我怎么运行和测试Codex 会先给出执行计划。看清楚要改哪些文件、新增哪些函数，同意后再让它动手。
六、检查改动：/diff 和 /review
Codex 改完后，不要急着提交：
- 输入
/diff查看 Git 差异，包括还没被 Git 跟踪的新文件； - 输入
/review让 Codex 检查当前工作区的改动，它会重点指出行为变化和缺少的测试，而且不会修改你的文件； - 自己运行一遍脚本，用几条手算过的数据核对结果；
- 没问题再
git commit，有问题就用 Git 回到上一次提交。
七、用 AGENTS.md 记住项目规矩
Codex 在开始工作前会读取 AGENTS.md。在项目根目录输入/init，它会生成一份初稿，你再按自己的习惯修改，例如：
- 回复使用中文，代码注释使用中文 - 修改 Python 文件后运行 python -m pytest - 新增第三方依赖前先征求我的同意想对所有项目生效的偏好，可以写在用户目录的~/.codex/AGENTS.md里，项目里的文件会叠加在它后面。官方默认合并后的说明上限约 32 KiB，写精炼一些更好。
八、长对话怎么办
/compact：把当前对话压缩成摘要，释放上下文空间；/new：在同一个终端会话里开一个全新的对话；codex resume或/resume：回到之前保存的对话继续做。
九、常见问题 FAQ
Q1：用中文提问效果如何？
可以直接用中文描述需求，在 AGENTS.md 里写明“回复使用中文”更省事。
Q2：它会不会偷偷联网或改系统文件？
在 Auto 预设下，写工作目录以外的文件或联网都需要你批准；想只聊天、不改文件，就切到 Read Only。
Q3：额度在哪里看？
在 CLI 里输入/usage可以查看账号的用量情况，额度规则以官方定价页为准。
十、小贴士
- 一次只交给它一个小功能，比一次提一大堆需求更容易检查。
- 需求里写清“不要改什么”，和写“要改什么”一样重要。
- 不要把密钥、密码写进代码或对话里。
- 遇到报错，把完整的报错信息贴给它，比只说“跑不起来”有效。
参考资料
- OpenAI 官方文档：Codex CLI
https://learn.chatgpt.com/docs/codex/cli - OpenAI 官方文档：Agent approvals & security
- OpenAI 官方文档：Custom instructions with AGENTS.md
- OpenAI 官方文档：Developer commands（Built-in slash commands）
- OpenAI 官方文档：Pricing
