做一个真实项目

跟着完成一个 AI 新闻聚合 CLI 工具，掌握 Claude Code 的基本工作循环

五步工作循环

用 Claude Code 做项目，核心是这五步循环：

描述需求：用自然语言告诉 Claude 你要做什么
审查方案：Claude 给出计划，你看看方向对不对
确认执行：同意后让它动手
验证结果：检查产出是否符合预期
迭代改进：不满意就继续提要求

这五步会反复循环，直到项目完成。接下来我们用一个真实例子走一遍。

实操：AI 新闻聚合器

我们要做一个命令行工具，能从多个来源抓取 AI 领域的新闻，展示在终端里。

第一步：描述需求

在项目目录下启动 Claude Code，输入：

帮我创建一个 AI 新闻聚合 CLI 工具，用 Node.js 写。
功能要求：
1. 从 Hacker News、TechCrunch RSS 抓取 AI 相关新闻
2. 按时间倒序排列
3. 在终端用表格形式展示标题、来源、时间
4. 支持 --limit 参数控制显示条数
5. 支持 --source 参数筛选来源

第二步：审查方案

Claude 会先给你一个方案概览，大概长这样：

我来帮你创建这个 AI 新闻聚合 CLI 工具。这是我的计划：

1. 初始化 Node.js 项目，安装依赖（rss-parser, commander, cli-table3, chalk）
2. 创建以下文件结构：
   ├── package.json
   ├── src/
   │   ├── index.js        # CLI 入口
   │   ├── fetchers/
   │   │   ├── hackernews.js  # HN API 抓取
   │   │   └── rss.js         # RSS 通用抓取
   │   └── utils/
   │       └── display.js     # 终端展示
   └── README.md

3. 实现各个新闻源的抓取逻辑
4. 实现 CLI 参数解析和表格展示

需要我继续执行吗？

这时候你要看：技术选型合不合理？文件结构清不清晰？有没有遗漏的需求？

如果觉得 OK，回复"继续"或者按回车确认。如果想调整，直接说，比如："用 TypeScript 写，不要 JavaScript。"

第三步：确认执行

Claude 开始执行时，会依次：

> 创建 package.json
> npm install rss-parser commander cli-table3 chalk
> 创建 src/index.js
> 创建 src/fetchers/hackernews.js
> ...

执行过程中，遇到需要权限的操作（安装依赖、创建文件、运行命令），Claude 会弹出确认提示：

Claude wants to run: npm install rss-parser commander cli-table3 chalk
Allow? (y/n)

刚开始建议每次都仔细看一下它要执行什么命令，确认没问题再按 y。

第四步：验证结果

执行完成后，运行看看效果：

node src/index.js

node src/index.js --limit 5 --source hackernews

如果能正常抓到新闻并展示，说明基本功能 OK。

第五步：遇到报错怎么办

假设运行时报错了：

Error: connect ETIMEDOUT 104.18.32.68:443

不用慌，直接把报错贴给 Claude：

运行报错了，你看看：
Error: connect ETIMEDOUT 104.18.32.68:443

Claude 会分析原因（比如网络超时）并给出修复方案（加代理配置、加重试逻辑、换备用数据源等）。

迭代加功能

基础版本跑通后，继续加功能：

现在帮我加三个功能：
1. AI 摘要——调用 Claude API 对每条新闻生成一句话摘要
2. 定时运行——支持 --watch 参数，每 30 分钟自动刷新
3. 去重——已经展示过的新闻不要重复显示

Claude 会在现有代码基础上修改，你不需要关心具体改了哪几行。它改完后你再跑一遍验证即可。

这就是典型的迭代循环：基础版本 → 验证 → 加功能 → 验证 → 再加功能。

心态转变

从传统编程切换到 Claude Code，最大的变化是你的角色：

维度	传统编程	Claude Code 编程
你的角色	施工者	项目经理
关注点	语法、API、实现细节	需求、方向、验收标准
遇到 Bug	自己查文档、搜 Stack Overflow	把报错贴给 Claude，让它修
学新技术	先花几天学基础再动手	直接说需求，Claude 帮你选技术
代码质量	逐行 Code Review	关注整体架构和运行结果
工作节奏	写 → 调试 → 写	描述 → 审查 → 验证 → 迭代

[!NOTE] 心态转变不意味着你不需要懂技术。相反，你越懂技术，越能给 Claude 提出精准的需求，也越能判断它的方案是否合理。技术能力是你的"审查能力"。

新手常见 FAQ

Q: Claude 写的代码我看不懂怎么办？

完全正常。你不需要逐行看懂，但要能看懂整体结构。可以问 Claude："解释一下这个项目的代码结构和每个文件的作用"。随着你用得越多，代码阅读能力自然会提升。

Q: Claude 写错了怎么办？

直接告诉它哪里不对。比如："这个功能不对，我要的是 XXX 效果，不是 YYY。" 如果一个方向改了两三次还不对，建议用 Esc 回退到之前的状态重新开始，换个描述方式。

Q: 我应该管多少细节？

这取决于你的经验：

新手：描述你想要的最终效果，让 Claude 决定技术细节
有经验：可以指定技术栈、文件结构、编码规范
高手：精确到架构模式、性能要求、边界情况处理

一个好的经验法则：先让 Claude 自由发挥，不满意再加约束。

Q: Claude 跑偏了怎么办？

按一次 Esc 可以立即停止当前操作。按两次 Esc 会打开 Rewind 菜单，你可以选择回滚到之前的某个节点。

更好的预防方式是：把大任务拆成小任务。不要一次给太大的需求，而是分步来：

# 不推荐
帮我做一个完整的电商网站，包含商品展示、购物车、支付、订单管理...

# 推荐
先帮我搭一个商品列表页面，用 Next.js + Tailwind CSS。
数据先用 mock 数据，后面再接数据库。

小步快跑，每一步都验证，比一次给一个大需求靠谱得多。

下一步

恭喜你完成了第一个项目！现在你已经掌握了 Claude Code 最核心的工作方式。接下来我们会深入核心工作流——Plan 模式、Auto 模式、Git 集成、CLAUDE.md 记忆系统。这些是让你从"会用"到"用得好"的关键。

做一个真实项目

On this page