Codex教程,从新手小白到高级实操
从零开始掌握 OpenAI Codex——AI 编程工程 Agent。14 章覆盖认识 Codex、四种入口安装、核心功能(自动化/插件/Skill/MCP/Git/记忆)、标准工作流、实战案例和第三方模型接入。
Codex是OpenAI家的Agent,它的最大优势就是便宜量大,下载安装配置。本推来带从安装到实战的新手教程,附带基础概念讲解、使用步骤
1.新手入门基础概念
codex更像是人类梦想中的AI,人类下达指令——codex操作你的电脑完成任务,它可以回复Gmail里的邮件、生成文档/图片/网页/ppt、搜索网页并总结内容,填表。
普通AI只有嘴巴和大脑,会思考会说话,而codex加装了手脚(skills、插件),思考完不仅会说还会做事,能够真正帮助人类提高生产力
2.如何下载安装Codex
Windows:直接进入Openai的官网下载,如果微软应用商店无法打开,可以通过这个网址提取安装

Mac:App store中搜索并下载
CLI
[code]
npm install -g @openai/codex
[/code]
codex login # 浏览器自动登录 ChatGPT 账号
3.如何获取codex plus账号
邮箱注册和登录chatgpt,咸鱼购买苹果礼品卡,在手机上用苹果余额支付,升级Plus,电脑端用相同邮箱账号登陆即可。(土耳其区最便宜,操作相同,需要购买土耳其区的App账户和礼品卡)直接购买20刀一个月,土耳其账号80人民币一个月
4.Codex到底怎么使用,上面的按钮都是用来做什么的

1.在这里你可以选择模型,从gpt5.5到更低端的模型,也可以选择智能程度与响应速度,越智能响应速度越快,消耗的额度越多
2.在这里选择codex的操作权限,分为默认、自动审查、完全访问,开发程度依次提高
3.在这里寻找合适好用的插件以及skills,并且可以管理电脑上安装的其他插件
4.自动化,可以让codex按照某个频率,自动执行设置好的任务,定期汇报,例如把每天的美股行情总结并于八点
插件和skills是agent的技能包,算是手和脚,越多agent的能力越多,能做的事越多有了插件你可以让codex读Gmail的邮件,做ppt、操作浏览器,操作slack、notion如果需要完成其他的任务,可以咨询AI,找到相关的插件和skills5.以下是最常用和最实用的八个插件
如果你需要更多插件可以在官方或者GitHub上
- GitHub Plugin(官方,最常用 No.1)
- 功能:审查 PR、创建/管理 Issues、调试 CI 失败、自动生成 PR 描述、批量操作仓库。
- 最有用场景:代码审查、开源协作、自动化发布流程。
- 调用示例:@GitHub 帮我 review 这个 PR 并修复 failing checks
- Gmail Plugin(官方,生产力神器)
- 功能:读取、搜索、回复、撰写邮件,还能批量整理收件箱。
- 最有用场景:处理工作邮件、自动回复、提取邮件里的任务。
- 调用示例:@Gmail 帮我找过去两周的 brand sponsorship 邮件并做成表格
- Google Drive Plugin(官方)
- 功能:读取/编辑 Drive 里的 Docs、Sheets、Slides,支持跨文件操作。
- 最有用场景:文档生成、数据分析、PPT 自动制作。
- 调用示例:@Google Drive 把这份 Sheet 数据做成分析报告和 Slides
- Slack Plugin(官方)
- 功能:总结频道消息、起草回复、搜索历史记录、@ 团队成员。
- 最有用场景:远程团队沟通、会议纪要、快速响应。
- 调用示例:@Slack 总结 #engineering 频道本周讨论并起草回复
- Figma Plugin(官方,设计师/前端必备)
- 功能:读取设计稿、提取组件规格、自动转代码(React 等)、生成文档。
- 最有用场景:设计转代码、组件库维护。
- 调用示例:@Figma 把这个设计稿转成可用的 Tailwind React 组件
- Superpowers Plugin(社区最受欢迎)
- 功能:给 Codex 加上完整的 Agent 流程(Planning → Execution → Review → Verification)。
- 最有用场景:大型任务、复杂重构、避免幻觉。
- 为什么推荐:很多人说装了这个后 Codex “真正像个高级工程师”。
- Context7 Plugin(社区高频)
- 功能:实时拉取最新库文档、API 参考,避免 Codex 用过时知识。
- 最有用场景:用新框架/库、避免“幻觉 API”。
- 调用示例:@Context7 用最新 Next.js 15 帮我写这个功能
- Composio Plugin(社区,集成最多的)
- 功能:一键连接上千个第三方 App(Notion、Linear、Sentry、Playwright 等)。
- 最有用场景:想接更多工具时用它当“万能桥”。
- 为什么推荐:官方插件不够用的时候,它是扩展神器。
6.最常用最实用的skills
openai官方skills仓库安装命令
[code]
skill-installer create-plan # 最推荐 No.1
skill-installer gh-fix-ci
$skill-installer install https://github.com/obra/superpowers # Superpowers 完整版
npx skills@latest add mattpocock/skills # 一键全装 Matt 系列
[/code]
- create-plan(最推荐No.1,强烈建议第一个装)
- 功能:强制 Codex 先输出完整执行计划(改哪些文件、方案、边缘 case、需要哪些测试),用户确认后再动手改代码。
- 为什么最有用:防止 Codex 一上来就瞎改导致浪费 token 和时间,极大提升成功率。
- 典型用法:@create-plan 帮我加一个用户登录的 OAuth 流程
- 安装:Codex CLI 输入 $skill-installer create-plan
- gh-fix-ci(CI 调试神器,省时王者)
- 功能:自动读取 GitHub Actions 失败日志,分析根因、修复代码、commit 并 push。
- 为什么最有用:以前 CI 挂了要手动查半天,现在直接丢给它,几分钟搞定。
- 典型用法:直接说「CI 失败了,帮我修」或在 PR 里调用。
- 安装:$skill-installer gh-fix-ci
- WarpGrep(代码搜索性能升级)
- 功能:AI 驱动的并行代码搜索子代理,只返回真正需要的文件片段,速度飞快。
- 为什么最有用:普通搜索经常加载一堆无关代码,WarpGrep 把搜索时间从 75 秒压到 5 秒,还省 17% token。
- 典型用法:搜索大项目时自动触发,或 @WarpGrep 找所有 React 组件的 loading 逻辑
- 安装:配置 MCP server(Medium 文章有详细 toml 配置 + API key)。
- Superpowers(Agent 工作流神器,质变级)
- 功能:给 Codex 加上完整多代理流程(Planning → Execution → Review → Verification),自动迭代优化。
- 为什么最有用:单代理容易出错,装了它之后 Codex “像个真正的高级工程师团队”。
- 典型用法:大型重构或新功能时直接用。
- 安装:在 Codex App/CLI 的 Plugins 里搜索 “Superpowers” 一键安装(它是 plugin 但核心是 skills)。
5-7. Matt Pocock’s Skills 系列(社区最爱小而美套装,强烈推荐整个仓库)
- grill-me / grill-with-docs:严格审问需求、带文档一起 review,避免理解偏差。
- to-prd:把模糊想法快速转成正式产品需求文档(PRD)。
- tdd:强制测试驱动开发(写测试 → 写代码 → 跑测试)。
- diagnose:深度诊断 bug 和问题根因。
- zoom-out / caveman:高层次思考或用最简单语言解释复杂逻辑。
- 为什么最有用:这些是日常 coding 最频繁的操作,小巧不占 token,却能大幅提升代码质量。
- 安装:npx skills@latest add mattpocock/skills(一键全装)
- stop-slop(文档/文字净化器)
- 功能:去除 AI 常见的“机器味”(em-dash、被动语态、it’s worth noting that 等),让 README、commit message、注释更自然专业。
- 为什么最有用:Codex 代码写得好,但文档经常很“AI”,这个一键变人味。
- 安装:git clone 到 ~/.codex/skills/stop-slop
额外高频推荐(按需加):
- frontend-skill:大幅提升前端 UI 一致性和设计感。
- Context7:实时拉最新库文档,避免用过时 API。
- gh-address-comments:自动处理 PR review 评论并回复。
- meeting-notes-and-actions:会议纪要转 action items(生产力党必备)。
7.如何让codex更好用呢?
- 先建 AGENTS.md
在项目根目录创建 .codex/AGENTS.md
里面写清楚:项目技术栈、代码风格、测试命令、lint 规则、架构约束、Done-when 定义(例如“必须通过所有测试 + 无新warning”)。
Codex 每次启动都会自动读取它,相当于给它一份“入职手册”。
进阶:可以再建 code_styles.md、rules/ 文件夹,把每次犯过的错都记进去,Codex 就会越来越懂你。
2.让codex强制使用计划模式
每一次任务都先生成完整计划,你审批计划后再执行
- 大量使用 Skills(我们之前聊过的那些必装)
- 已经推荐过的:create-plan、gh-fix-ci、Superpowers、Matt Pocock 系列、stop-slop 等。
- 新推荐:changelog-generator、webapp-testing、sentry-triage、frontend-skill。
- 技巧:技能越专注越好(一个技能只干一件事),写完后用 A/B 测试验证效果,不行就删。
- 建立 Reviewer 心态 + 多 Agent 工作流
- 你当 Reviewer,Codex 当 Coder。
- 开两个 session:一个 Developer Agent,一个 Reviewer Agent(或用 Sub-agent)。
- 每阶段完成后让 Reviewer 用 QA checklist 检查(功能、完整性、一致性、测试覆盖等)。
- 最后自己再手动 review 3-5 分钟,能省后面 30 分钟 debug。
- 善用 Session 管理和 Automations
- Session 规则:一个任务一个 thread,用 /clear 切换任务,避免上下文污染;用 /fork、 /compact、 /resume 管理长任务。
- Automations:把重复工作设成定时任务( nightly test summary、weekly dependency audit、release changelog 等),结果丢到 review queue,你只看结果就行。
- 新功能 Hooks(2026 年 3 月上线):可以自定义验证脚本、secret scanning、repo 专属行为,生产级工作流必备。
- MCP + Plugins 打通外部工具(让 Codex 不再局限于代码)
- 用 MCP Server 连接 Slack、Notion、Linear、Sentry 等。
- 结合之前推荐的 Gmail、Drive、Figma、Composio 等插件,Codex 就能真正“干活”而不是只写代码。(codex官方内置插件即可满足绝大部分人的需求)
7.内置
codex可以操作他的内置浏览器完成搜索网页,总结资料,等浏览器上的功能,更加便捷 学习资源可在YouTube上搜索codex进行