Codex CLI 入门:在终端里让 AI 读懂项目并完成一次小修改

发布时间:2026/10/23 19:41:37

Codex CLI 入门:在终端里让 AI 读懂项目并完成一次小修改 适合人群会一点 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
延伸阅读

更多相关文章

2026/10/23 19:41:37

自动化越强,对 “原理懂不懂” 的要求越高。

手动时代,园区所有管线、水电、通道、住户登记全都靠人一点点操作。你是管理员,每天拧阀门、抄水表、疏通拥堵,每一步动作都看得见,出了问题,顺着自己刚才的操作就能找到毛病。 自动化时代,相当于雇了一个很…

2026/10/23 19:36:37

Java依赖注入中带Impl实现类的核心实践与避坑指南

1. 从“java imple_带imple的依赖注入”这个标题说起第一次看到“java imple_带imple的依赖注入”这个标题,我愣了几秒。imple这个前缀在 Java 里太常见了——implements、Implementation、Impl后缀,几乎每个写 Java 的人每天都在跟它打交道。但把imple单…

2026/10/23 19:36:37

蓝桥杯Java真题:用最大公约数破解等差数列最短长度问题

看到“蓝桥杯2019年Java C组第9题——等差数列”,很多人第一反应是:这不就是初中学过的等差数列吗?有什么难的。结果真上了考场,不少人在这一题上栽了跟头。问题恰恰就出在“太熟悉”上——越熟悉的定义,越容易让人忽视…

2026/10/23 20:41:44

麦语言函数实战避坑指南:REF、#IMPORT与L2盘口的正确用法

简介:本资源是文华财经官方麦语言函数手册的完整整理版,面向量化交易初学者、程序化策略开发者及期货/证券技术分析人员,解决麦语言函数调用不熟、参数理解不清、高频数据引用困难等核心问题。手册系统涵盖历史价格引用(CLOSE/HIG…

2026/10/23 20:41:44

WPF+Socket六轴机器人通讯调试器:粘包拆包与心跳保活

简介:围绕机器人通信调试场景整理的WPF与Socket实战代码包,面向自动化、物联网及机器人上位机开发的初中级人员,用于理解TCP服务器如何监听端口、接受机器人客户端连接、异步收发数据并在桌面界面中实时呈现交互结果。压缩包共38个文件、约70…

2026/10/23 20:41:44

GROMACS蛋白-小分子模拟NPT崩溃排查与全流程闭环方案

简介:本资源是一份面向计算生物学初学者与进阶研究者的GROMACS分子动力学模拟系统性学习笔记,聚焦蛋白质-小分子复合物在溶剂化环境下的NPT平衡模拟全流程,涵盖力场选择(AMBER/OPLS-AA/GROMOS等)、结构预处理&#xff…

2026/10/23 20:41:44

Aspose.Cells for Java 8.9.0 环境搭建与无水印导出实战

简介:本资源为 Aspose.Cells for Java 8.9.0 的破解版本,面向需要在 Java 项目中处理 Excel 文件的开发者,尤其适合使用 JDK 6.0 环境、希望免除水印与使用时间限制的技术人员。压缩包共 11 个文件,约 5.9MB,包含核心 …

2026/10/23 20:36:42

C#图表控件EeceChart源码解析:GDI+自绘与实时曲线优化

简介:EeceChart.zip 是一份面向 C# 开发者与数据分析初学者的实战项目源码,聚焦 Excel 数据读取、曲线绘制与交互式图形操作。项目以 C# 为基础,结合 Microsoft Office Interop 操作工作表与单元格,完成数据遍历、随机抽样、曲线平…

2026/10/22 11:29:28

金融AI落地指南:从调研报告到技术选型与工程实践

简介:这份PDF报告聚焦2025年金融服务业中国AI现状与趋势,面向金融科技从业者、AI战略规划人员及关注行业数字化转型的研究者,帮助读者把握生成式AI在银行、支付、交易等场景中的落地路径与投资方向。资源包内含1个PDF文件,大小约1…

2026/10/23 0:02:26

Verilog实现FPGA密码锁:矩阵键盘与状态机设计实战

说实话,这几年接触了不少想入门FPGA的朋友,如果你问哪个项目能一口气把Verilog的核心基本功串起来,我通常会推荐电子密码锁。这个项目看着不起眼,却把矩阵键盘扫描、按键消抖、状态机设计、动态显示刷新、外设控制这些数字逻辑里的…

2026/10/23 0:02:26

数据服务监控运维实战:从指标体系到告警治理与故障排查

周末凌晨两点,手机震了。第一反应是“数据服务挂了”。打开电脑看了下,果然,某张核心报表的数据产出时间已经超过SLA两小时,下游三个业务方连着发来问询。这种场景,做过大数据运维的人都不会陌生。数据服务的监控与运维…

2026/10/23 0:02:26

FreeRTOS任务通知实战详解:内核原理、API与避坑指南

裸机编程切到RTOS之后,任务之间的通信和同步永远是躲不开的坎。前面聊过队列、信号量、互斥锁、事件组,这次把FreeRTOS任务通知(Task Notification)单独拎出来讲透。原因很简单:任务通知是FreeRTOS里最容易用错、也最容…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑