Claude Code 实战：用 AI 编程 Agent 从零开发一个全栈应用

# 安装（需 Node 18+）
npm install -g @anthropic-ai/claude-code

# 进入（或新建）项目目录
mkdir my-blog && cd my-blog

# 启动 Agent（它会读取当前目录上下文）
claude

# 首次对话，先让它了解技术栈偏好
"本项目用 Node + Express 做后端，SQLite 做数据库，
 前端用原生 HTML/JS，部署到 Cloudflare Pages。
 请按这个栈帮我初始化工程结构。"

最高效的用法不是上来就"写个博客"，而是先让它产出一份需求文档，你确认后再生代码。

"请先帮我写一份需求文档（不写代码），包含：
 1. 数据模型：用户( id, username, password_hash )、
    文章( id, author_id, title, content, created_at )
 2. 后端接口：注册 / 登录 / 发文章 / 列表 / 详情
 3. 前端页面：注册页、登录页、发布页、列表页、详情页
 4. 技术要点：密码用 bcrypt 哈希，登录用 JWT

确认这份文档后我们再开始实现。"

"按需求文档实现后端：
 - 用 Express 写 5 个接口，参数校验要完整
 - 用更好的-sqlite3 操作数据库，启动时自动建表
 - 密码用 bcrypt，JWT 密钥从环境变量读取
 - 每个接口返回统一格式 { code, data, msg }
 写完后用 node 启动，确认没有语法错误。"

"实现前端 5 个页面（原生 HTML/JS，不引框架）：
 - 登录后把 JWT 存 localStorage，请求时带在 Header
 - 发布页调用 /api/post 提交，成功后跳列表页
 - 列表页调 /api/posts 渲染卡片，点击进详情
 保持页面简洁，移动端可正常浏览。"

联调几乎必出 bug。编程 Agent 最爽的一点：你不用自己读堆栈，直接把错误丢给它。

"启动后访问 /api/posts 报 500，后端日志如下：
 [ERROR] TypeError: Cannot read properties of undefined (reading 'map')
 at listPosts (routes/posts.js:23:18)
 请定位原因并修复，说明为什么会出现这个错误。"

"为后端接口写一套测试（用 node:test 即可）：
 - 覆盖注册、登录、发布、未登录发布应被拒
 - 在 package.json 加 test 脚本
 跑通 npm test，确保全部通过。"

"本项目是纯静态前端 + Node 后端，计划部署到 Cloudflare Pages。
 请帮我：
 1. 写适合的构建/部署配置
 2. 列出需要设置的环境变量（JWT_SECRET 等）
 3. 给出部署命令
 不要执行部署，只给方案和命令。"