跳转到内容
AI 编程入门手册

零基础用 Codex / Claude Code 做项目，先从这 3 件事开始

聊天式问答不是这条路线的主线。新手学 Codex / Claude Code 的核心目标，是把 coding agent 投入到自己的项目里，完成一个具体工作。

第一周只做三件事：写清任务、让 agent 读项目、交付一个小改动。

这页不是知识地图。它的验收标准只有一个：你看完以后，能拿一个本地项目或开源练习项目，让 agent 交付一个小结果，而不是继续收藏教程。

新手最适合的 4 个真实任务

Section titled “新手最适合的 4 个真实任务”
任务为什么适合新手可以复制的目标
改一个页面文案风险低，改完能立刻看到变化把首页主按钮从“开始”改成“免费开始体验”
加一个空状态只涉及一个页面或组件，能练 UI 状态当列表为空时显示一句提示和一个操作按钮
修一个可复现小报错能练错误分类和最小修复点击提交空表单时报错，请先定位原因
补一个小测试能练“行为是什么”而不是乱改代码给 formatDate 这类小函数补 2 个边界用例

先不要选“做一个完整 SaaS”“接支付”“做用户系统”“重构项目”。这些不是不能做，而是不适合作为第一周训练任务。

1. 先写任务说明，不写聊天开场白

Section titled “1. 先写任务说明，不写聊天开场白”

不要问“你能帮我做什么”。直接把 agent 当开发同事派任务：

你是我的 coding agent。请先只读当前项目，不要修改文件。
我的目标是：{一个小任务}
请告诉我相关文件、最小交付版本、风险和验证方法。

先读：不会写任务说明怎么办。

2. 先选 Codex 或 Claude Code，而不是泛泛选模型

Section titled “2. 先选 Codex 或 Claude Code，而不是泛泛选模型”

如果你的目标是做项目、修 bug、改页面、写测试、上线功能，优先学能在仓库里工作的 coding agent。

  • Codex：适合在本地或工作区里读仓库、改文件、运行命令、遵守 AGENTS.md。
  • Claude Code：适合在终端、IDE、桌面或 Web 里理解代码库、编辑文件、运行测试、处理开发任务。

工具选择页仍会保留其他工具信息，但新手主线先围绕 Codex 和 Claude Code。

下一步读：新手该选哪个 AI 编程助手。

3. 第一小时交付一个小任务

Section titled “3. 第一小时交付一个小任务”

不要让 agent 第一小时做完整产品。先让它完成一个可见、可撤销、可验证的小交付：

  • 改一个文案。
  • 修一个小报错。
  • 加一个空状态。
  • 补一个小测试。

下一步做：Coding Agent 第一小时。

如果 agent 开始跑偏，立刻看：Coding Agent 跑偏了怎么办。

第一周路线

Section titled “第一周路线”
天数目标页面
第 1 天理解 coding agent 能做什么概念解释
第 2 天把模糊想法写成任务说明不会写任务说明
第 3 天安装并进入项目目录安装前准备
第 4 天只读摸底一个项目读项目提示词
第 5 天让 agent 做实现计划改小功能提示词
第 6 天完成一个小交付Coding Agent 第一小时
第 7 天看 diff、验收、纠偏Agent 控制指令

常见卡点

Section titled “常见卡点”
  • 不知道怎么开口：写任务目标，不写聊天寒暄。
  • agent 一上来就写代码：要求它先只读摸底。
  • agent 越改越多：要求它列出会改的文件，最多 1-3 个。
  • 不知道算不算完成：要求它给验证命令或人工验收清单。
  • 想做自己的产品：先拆成一个小交付，不要一次做完。

看教程时的自检问题

Section titled “看教程时的自检问题”

读完任意一页，都问自己 5 个问题：

  1. 我能不能把这一页的提示词直接复制到 Codex 或 Claude Code？
  2. 我有没有一个具体项目、仓库或文件可以给它读？
  3. 它输出以后，我知道什么算好输出、什么算空话吗？
  4. 它开始扩大范围时，我有没有一句叫停指令？
  5. 完成后，我能不能用 git diff、测试命令或浏览器页面确认结果？

如果 5 个问题里有 2 个答不上来，先不要继续学新概念，回到 Coding Agent 第一小时 做一次完整闭环。

来源与日期

Section titled “来源与日期”