01 它是干嘛的
Codex 是一款「编程代理」：它不只是补全一行代码，而是能读懂整个项目、自己动手改文件、运行命令、看结果、再继续，直到把任务做完。它代表 AI 从「帮你写一行」升级到了「帮你干一件活」，人从执行者变成验收者。
02 为什么会有它
在编程代理出现前，AI 写代码只是「你敲一半它猜一半」
早期 AI 写代码主要有两种形态：一是自动补全，你打几个字它猜下一行，快但只在光标附近起作用；二是聊天式问答，你把一段代码贴进去问「哪里错了」，它给你一段建议，但改还是得你自己复制、粘贴、保存、运行。
这就好比请了个顾问：他嘴上说得头头是道，活还是你自己干。而真正费时间的往往不是「想」，而是「在一堆文件里找到该改的地方、改完、跑一遍确认没弄坏别的功能」这一整套流程。
编程代理把这些步骤串起来交给 AI：你把任务说清楚，它自己去读项目文件、定位要改的代码、写补丁、运行测试、根据报错再修正，来回几轮直到通过。人只负责下达任务和检查结果。
03 它怎么工作
编程代理本质上是一个循环：读上下文 → 做计划 → 动手改 → 运行验证 → 看结果 → 再调整，直到任务完成，或卡住了向你求助。
一个编程代理接到任务后，自己是怎么干活的
- 1① 了解项目
它先扫描项目结构、读相关文件、看依赖和已有代码风格，建立对这块代码的整体认识。
- 2② 拆解任务
把你的自然语言需求拆成若干具体改动，比如「加一个登录接口」会拆成改路由、写逻辑、补测试。
- 3③ 动手修改
它直接编辑文件、生成代码、创建新文件，而不是只把代码贴给你让你自己复制。
- 4④ 运行验证
它主动运行测试、构建命令或脚本，观察有没有报错，把输出的真实结果当作下一步的依据。
- 5⑤ 循环修正并汇报
发现报错就回去改，改完再跑，直到任务达成；最后把「改了哪些文件、为什么这样改」讲清楚给你审。
04 谁在用它
把报错和大致背景丢给它，它自己定位、修改、跑测试验证，省去大量翻文件的时间。
「给这个表单加一个字段，并补上校验和测试」，它能一次把相关文件都改到位。
让它解释一段你看不懂的代码、梳理调用关系，比自己一点点啃快得多。
批量补单元测试、统一命名规范、清理重复代码这类琐碎又耗时的活。
临时要处理一批文件、转换数据格式，把需求描述清楚让它直接写出来跑。
05 怎么用
需要你懂一点开发流程，但它能省掉大量敲代码的时间；核心能力变成了「把要求讲清楚」。
- 01安装命令行工具，或在编辑器里安装对应插件，用账号登录授权。
- 02在一个 Git 仓库目录里启动它，让它能读到整个项目。
- 03用自然语言描述任务，说清目标、限制和验收标准。
- 04重要项目让它先给出计划，你确认后再让它动手改。
- 05改完后自己 review 它的改动，跑一遍完整测试再提交。
避坑提示
- !它会产生看起来对、实际有细微错误甚至引用了不存在函数的代码，务必自己审。
- !给它清晰的任务和验收标准，比让它自己瞎猜强得多，模糊需求容易越改越乱。
- !重要仓库提前用 Git 建好分支和提交，改动可回滚，心里不慌。
- !别让它接触生产环境的密钥和真实数据，在测试环境里练手更安全。
06 关键概念
- 编程代理（Coding Agent）
- 能自己读写文件、运行命令、根据结果迭代的 AI 程序，而不只是被动回答问题。
- 补全 vs 代理
- 补全只猜光标附近的下一个片段，代理能独立完成一整个任务。
- 上下文
- 代理能看到多少项目信息；看到的越多越准，但也越慢越贵。
- 测试驱动
- 先让它写测试、再让改动通过测试，是保证 AI 改代码不出大错的有效办法。