面对一个几万行的开源仓库，光看 README 是看不明白的。这次我们用 Codex 做一个「项目学习助手」：粘贴一个 GitHub 地址，它自动克隆、读源码、生成一份通俗的分析报告，还能针对代码交互问答。整套流程跑下来，你能学到 Codex 的扩展安装、提示词写法和自主测试，比看十篇概念文都实在。
第一步：想清楚要它干什么
别一上来就让 AI 瞎做。先定需求：
- 用户输入 GitHub 仓库地址，系统自动克隆并分析源码
- 生成报告：项目概述、技术栈、目录结构、核心模块、数据流、设计模式、阅读建议
- 分析过程实时推进度，分析过的项目自动缓存，不重复分析
- 支持针对源码的交互式问答，AI 自主搜文件、读代码来回答，流式输出
提示：需求越具体，AI 越不容易跑偏。把「要什么交付物」列清楚，比喊「帮我做个牛逼的项目」有用得多。
第二步：定方案与技术栈
这里直接给定方案，省 token：
- 后端：Python FastAPI + LangChain + SQLite
- 前端：Vue，前后端分离
- AI 能力：对接 DeepSeek V4 API（性价比高，适合做应用大脑）
AI 分析的核心技巧是 Tool Use：不要一股脑把几万行代码塞给模型，而是给 AI 三个工具——读取文件、搜索代码、获取仓库结构，让 AI 自己判断该看哪些文件、怎么组织答案。这正是 Agentic 场景的价值。
第三步：给 Codex 装三个扩展
打开 Codex，确认模型列表里有可用模型（示例用 GPT-5.5，智能程度选「高」），工作模式切到「用于编程」。然后装三个扩展，全部用一行命令，比手填 TOML 省事：
npx -y firecrawl-cli@latest init --all --browser # 联网搜索与网页抓取
npx ctx7@latest setup # 查最新技术文档，避免 AI 瞎编
uipro init # 前端美化技能，少一堆 Emoji
每条命令会在弹出的网页里授权一次，授权后 Codex 的技能/插件列表里就能看到它们。
第四步：写一段能用的提示词
新建项目文件夹，在 Codex 里打开，把这段提示词发过去（按需改项目名）：
## 角色
你是一个全栈工程师，擅长 Python + FastAPI + LangChain 开发。
## 任务
开发一个叫 project-helper 的 Web 应用：用户输入 GitHub 仓库地址，系统自动克隆并分析源码，
生成通俗分析报告（概述/技术栈/目录结构/核心模块/数据流/设计模式/阅读建议），
分析进度实时推送，已分析项目自动缓存；并支持针对源码的交互式问答（给 Agent 提供
read_file / grep_code / repo_map 工具，让 AI 自主查代码回答），流式输出。
## 技术栈
后端 Python FastAPI + LangChain + SQLite + DeepSeek V4；前端 Vue，前后端分离。
## 要求
1. 页面科技感、代码块语法高亮，用 UI UX Pro Max 技能美化
2. 开发前先通过 Firecrawl 联网搜索、通过 Context7 查最新文档
3. 必须生成完整可运行代码，每步完成后自主测试验证
提示：最后两条是防翻车关键——让 AI 先查文档再写、写完自己测。模型我选「高」智能程度、给完全访问权限省事；想让 AI 测得更完整，就先把 DeepSeek API Key 写进提示词或 .env。
第五步：配 Key 并让 AI 自主测试
去 DeepSeek 开放平台建 API Key，在 Codex 终端里设置：
export DEEPSEEK_API_KEY=你的_key
export DEEPSEEK_MODEL=deepseek-v4-pro
然后利用 Codex 内置的 Browser Use 插件，输入 @Browser Use，让它自主打开网页、输入仓库地址、看分析结果、测问答功能，全程自己点、自己修 Bug。等它跑完端到端测试并修好发现的问题，项目就齐活了。
提示：开源前务必在 .gitignore 忽略 .env，别把 Key 推到 GitHub。真实感受是，提示词到位后核心业务流程基本一把跑通，前端中规中矩但功能完整——这正是 Codex「先交付能用的东西」的风格。
可以接着扩展
报告里加 Mermaid 流程图、支持导出 PDF、给问答加引用高亮……发挥想象力。最重要的是：你已经跑通了「装扩展 → 写提示词 → 自主测试」这条 Codex 实战链路，下次换个需求照葫芦画瓢就行。
来源：本文根据微信公众号「程序员鱼皮」《Codex 保姆级项目实战教程》整理改写，原链接见文首 url 注释。
资料最后核对日期：2026-08-23 · 内容整理自 CodexGuide 社区公开教程