适合人群会一点 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 的同学Homebrewbrewinstall--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 和 /reviewCodex 改完后不要急着提交输入/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回到之前保存的对话继续做。九、常见问题 FAQQ1用中文提问效果如何可以直接用中文描述需求在 AGENTS.md 里写明“回复使用中文”更省事。Q2它会不会偷偷联网或改系统文件在 Auto 预设下写工作目录以外的文件或联网都需要你批准想只聊天、不改文件就切到 Read Only。Q3额度在哪里看在 CLI 里输入/usage可以查看账号的用量情况额度规则以官方定价页为准。十、小贴士一次只交给它一个小功能比一次提一大堆需求更容易检查。需求里写清“不要改什么”和写“要改什么”一样重要。不要把密钥、密码写进代码或对话里。遇到报错把完整的报错信息贴给它比只说“跑不起来”有效。参考资料OpenAI 官方文档Codex CLIhttps://learn.chatgpt.com/docs/codex/cliOpenAI 官方文档Agent approvals securityOpenAI 官方文档Custom instructions with AGENTS.mdOpenAI 官方文档Developer commandsBuilt-in slash commandsOpenAI 官方文档Pricing