简历没项目？手把手教你用 Claude Code 一个周末撸出全栈应用（附完整 Prompt）

发表于 更新于 分类于 阅读次数： 本文字数： 4.4k 阅读时长 ≈ 4 分钟

cover

去年我帮一个朋友看简历，项目经历那栏写着：Todo App、天气查询、计算器。

他投了 40 多家公司，进了 3 个面试，全挂了。不是技术不行，是没有一个项目能让面试官多看一眼。

这不是个例。招聘市场上，初级开发者最大的困境不是技术能力不够，而是没有一个拿得出手的项目。学校的课程设计太玩具，公司的实习经历可能只是改了几个 bug。你需要一个完整的、有真实场景的、技术栈说得出口的全栈应用。

好消息是：2026 年，你可以用 Claude Code 在一个周末做到这件事。

不是做一个 Demo。是做一个有前端、有后端、有数据库、有认证、能部署、能写进简历的完整应用。

这篇文章会给你一套完整的流程和可以直接用的 Prompt，从周六早上到周日晚上，48 小时，从零到上线。

第一步：选对项目（周六上午 1 小时）

先说什么项目不要做：

  • Todo App（太烂大街）
  • 天气查询（没有后端逻辑）
  • 纯前端展示页（不算全栈）
  • 电商平台（太大，一个周末做不完）

好的简历项目有三个特征：有真实使用场景、有完整技术链路、有一两个技术亮点。

推荐几个方向：

项目类型 技术亮点 面试谈资
AI 代码片段管理器 AI 搜索 + 标签系统 RAG、向量检索
团队日报工具 实时协作 + Markdown WebSocket、富文本
API 监控面板 定时任务 + 数据可视化 Cron Job、图表组件
个人知识库 全文搜索 + AI 摘要 搜索引擎、LLM 集成
开发者招聘看板 筛选过滤 + 数据抓取 爬虫、复杂查询

技术栈建议选主流的：Next.js + TypeScript + PostgreSQL + Tailwind CSS。理由很简单——LLM 对这套栈的训练数据最多，生成的代码质量最高，面试官也最认。

第二步：写好 CLAUDE.md（周六上午 30 分钟）

这一步很多人跳过，但它决定了整个周末的效率。

CLAUDE.md 是 Claude Code 的「记忆文件」。每次对话开始，Claude 都会自动读取这个文件。把你的项目信息、技术栈、编码规范写在里面，Claude 就不会每次都问你「用什么框架」「数据库是什么」这种重复问题。

在你的项目根目录创建 CLAUDE.md，内容模板如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# 项目概述

DevPulse - 开发者 API 监控面板
一个帮助开发者监控 API 健康状态的全栈应用。

## 技术栈

- 前端：Next.js 15 (App Router) + TypeScript + Tailwind CSS
- 后端：Next.js API Routes + Prisma ORM
- 数据库：PostgreSQL
- 认证：NextAuth.js
- 部署：Vercel

## 项目结构

src/
├── app/          # Next.js App Router 页面
├── components/   # React 组件
├── lib/          # 工具函数和配置
├── server/       # 服务端逻辑
└── types/        # TypeScript 类型定义

## 编码规范

- 使用 TypeScript strict 模式
- 组件使用函数式组件
- 优先使用 Server Components
- API 路由统一返回 { data, error } 格式
- 变量命名使用 camelCase

## 常用命令

- npm run dev - 启动开发服务器
- npm run build - 构建生产版本
- npx prisma migrate dev - 执行数据库迁移
- npx prisma studio - 打开数据库管理界面

这个文件不需要一次写完美。随着项目推进，你可以随时用 # 命令追加规则，比如：

1
# 所有数据库查询都要在 server/ 目录下的 service 文件中完成

第三步：用 Plan Mode 做架构设计（周六上午 1 小时）

不要直接让 Claude 开始写代码。 这是新手最常犯的错误。

Claude Code 有一个 Plan Mode（按 Shift+Tab 两次切换），在这个模式下，Claude 只能思考和规划，不能修改任何文件。先规划，再执行。

进入 Plan Mode 后，用这段 Prompt：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
我要构建一个「开发者 API 监控面板」应用。

核心功能：
1. 用户注册/登录（NextAuth.js + GitHub OAuth）
2. 添加 API 端点进行监控（URL、检测频率、预期状态码）
3. 定时检测 API 状态（可用性、响应时间）
4. 仪表盘展示所有 API 的实时状态（在线/离线/延迟）
5. 历史数据图表（最近 24 小时的响应时间趋势）
6. 异常告警（API 宕机时发送通知）

请帮我：
1. 设计数据库模型（用户、API 端点、检测记录）
2. 规划 API 路由结构
3. 拆分前端页面和组件
4. 制定开发任务清单，按优先级排序
5. 将任务清单写入 tasks.md 文件

注意：这是一个周末项目，请控制范围，
优先保证核心链路跑通，UI 可以简洁但要专业。

Claude 会输出一份完整的架构方案和任务清单。仔细看这份计划，确认没有明显遗漏或过度设计的地方，然后再切回执行模式。

关键原则：让 Claude 把计划写到 tasks.md 文件里。这样后续开发时你可以随时引用，Claude 也能通过读这个文件知道当前进度。

第四步：逐步构建（周六下午 + 周日全天）

从这一步开始真正写代码。记住一个核心原则：一次只做一个功能，做完验证，再做下一个。

不要给 Claude 一个大而全的指令。拆成小任务，每个任务都能独立验证。

阶段 1：项目初始化 + 数据库（周六下午 2 小时）

1
2
3
4
5
6
参考 tasks.md 中的阶段 1 任务。
初始化 Next.js 15 项目（使用 App Router + TypeScript），
安装 Prisma，配置 PostgreSQL 连接，
创建 User、ApiEndpoint、CheckResult 三个数据模型，
执行数据库迁移。
完成后运行 npx prisma studio 确认表结构正确。

阶段 2：认证系统（周六下午 2 小时）

1
2
3
4
5
参考 tasks.md 中的阶段 2 任务。
配置 NextAuth.js，实现 GitHub OAuth 登录。
创建登录页面和用户信息展示组件。
确保未登录用户访问仪表盘时重定向到登录页。
完成后在浏览器中测试完整的登录流程。

阶段 3：核心 CRUD（周日上午 3 小时）

1
2
3
4
5
6
7
8
参考 tasks.md 中的阶段 3 任务。
实现 API 端点的增删改查：
- 添加 API 端点的表单（URL、名称、检测频率、预期状态码）
- API 端点列表页面
- 编辑和删除功能
- 后端 API 路由：POST /api/endpoints、GET /api/endpoints、
  PUT /api/endpoints/[id]、DELETE /api/endpoints/[id]
所有操作需要认证，只能管理自己的端点。

阶段 4：监控核心逻辑 + 仪表盘（周日下午 3 小时）

1
2
3
4
5
6
7
8
参考 tasks.md 中的阶段 4 任务。
1. 实现 API 健康检查服务：对每个端点发送 HTTP 请求，
   记录状态码、响应时间、是否可用
2. 创建 API 路由 POST /api/check 手动触发检测
3. 仪表盘页面：展示所有端点的当前状态（绿色=正常，
   红色=异常，黄色=延迟过高），
   显示最近一次检测时间和响应时间
4. 用 recharts 或类似库展示最近 24 小时的响应时间折线图

阶段 5：收尾 + 部署（周日晚上 2 小时）

1
2
3
4
5
参考 tasks.md 中的阶段 5 任务。
1. 添加 loading 状态和错误处理
2. 优化移动端适配
3. 添加 README.md（项目介绍、技术栈、本地运行步骤、截图）
4. 配置 Vercel 部署

关键技巧：让 Claude 输出面试级代码

如果你只是让 Claude 「把功能做出来」，它可能会走最短路径——代码能跑，但不够好看，不够规范。面试时被问到细节，你答不上来。

在 CLAUDE.md 里加上这段：

1
2
3
4
5
6
7
## 代码质量要求

- 所有 API 路由必须有输入验证（使用 Zod）
- 错误处理要完整，不能有未捕获的异常
- 数据库查询要在独立的 service 层，不要直接写在路由里
- 组件要有 TypeScript 类型定义
- 关键业务逻辑要有注释说明设计决策

这样生成的代码更接近生产标准，面试时也能讲出「为什么这么设计」。

面试官会问什么？你需要理解什么？

用 AI 做项目没问题，但面试时你得能讲清楚。以下是必须理解的内容：

数据库设计

  • 为什么选择这几个表？它们之间的关系是什么？
  • 索引加在哪里？为什么？

认证流程

  • OAuth 的工作原理是什么？
  • Session 和 JWT 的区别？你用了哪个？

API 设计

  • RESTful 路由是怎么设计的？
  • 输入验证是怎么做的？为什么要做？

前端架构

  • Server Component 和 Client Component 的区别？
  • 什么时候用哪个？

部署

  • Vercel 部署的流程？
  • 环境变量怎么管理的？

建议在项目做完后，专门花一个小时，让 Claude 帮你生成面试问题清单：

1
2
3
基于我们刚完成的项目，列出面试官可能问的 15 个技术问题，
并给出简洁的回答。重点覆盖：数据库设计、认证流程、
API 设计、前端架构、部署流程。

然后逐一理解这些答案。用 AI 做项目不丢人，用了 AI 却讲不出为什么这么做，才丢人。

容易踩的坑

1. 不要在一个 session 里做完所有事。 Claude 的上下文窗口有限。一个功能做完，提交 git commit，然后开新 session 继续下一个。新 session 开始时让 Claude 读一下最近的 commit 记录，它就能接上进度。我第一次做项目时没注意这个，在同一个 session 里撑了 6 个小时，后来 Claude 开始把已经写好的函数重复生成，还改错了之前的逻辑。

2. 用 Plan Mode 先想再做。 跳过规划直接写代码，到后面会反复返工。Plan Mode 逼你先想清楚，Claude 也不会在规划阶段乱改文件。

3. README 不能偷懒。 招聘者打开你的 GitHub，第一眼看的是 README。需要有：项目介绍、截图/GIF、技术栈、本地运行步骤、架构说明。让 Claude 帮你写，但自己要检查一遍。

4. 一定要部署上线。 一个有线上地址的项目，比只有源码的项目说服力强 10 倍。Vercel 部署免费，没有理由不做。

写在最后

Stanford 的研究显示，22-25 岁软件开发者的就业率在 2022-2025 年间下降了近 20%。Stack Overflow 调查显示，84% 的开发者在使用 AI 工具。

这两个数字放在一起，意思很明确：竞争更激烈了，但工具也更强了。

我帮那个朋友重新做了一个项目——API 监控面板，用了一个周末，部署上线了。他再投简历，进面试的比例从 7% 涨到了 30% 左右。面试官问他项目细节，他能讲清楚每一个技术决策，因为他全程参与了，不是只看了个结果。

用 Claude Code 做项目不是作弊。关键是你要理解你做的东西，能讲清楚每一个技术决策背后的原因。

我比较好奇的是：你在面试时有没有被直接问过「这个项目是 AI 帮你做的吗」？面试官的反应是什么？这个问题我还没遇到过，但感觉迟早会成为标配。