只要前期框架搭得对，Claude Code 一个周末就能把一个双语内容站从空文件夹做到上线。这篇写的是我自己在用的流程，包括 Agent 会迷路的那些环节怎么救。
问题背景
大多数”AI 帮我建了一个站”的帖子都跳过了最难的中间段——Agent 一口气生成 40 个文件，一半互相冲突，你花两小时拆解。用 Claude Code 的关键是把它当一个读过所有 Astro 文档但没真发布过站的初级工程师：给清晰的目录结构、窄任务、每个 commit 都 review。这样它确实能做 80% 的活。
一份能避免大部分返工的初始 CLAUDE.md：
# 站点说明
技术栈：Astro 4 + MDX + Tailwind。中英双语，目录 src/content/articles/{en,zh}/。
路由：/en/articles/{slug}、/zh/articles/{slug}，sitemap 按语言拆分。
Frontmatter 字段：title、description、urlSlug、category、tags[]、publishedAt、lang、translationKey。
# 给 Agent 的硬约束
- 不要凭空发明 frontmatter 字段，加之前先读 src/content/config.ts。
- 翻译对共享 translationKey；slug 和 tags 在 en/zh 之间必须一致。
- 不要在没明确同意时改部署配置（firebase.json、vercel.json）。
- 一个 commit 一件事，diff 要能被人 review。文件落到仓库根，此后每次在此目录跑 Claude Code 都会带上这份上下文。
判断标准
- 你已经想清楚要做什么——主题、语言、变现方式——只是想快点上线。
- 你看得懂代码，敢于驳回 AI 的建议，而不是照单全收。
- 你能用一段话描述你的内容结构：分类、frontmatter 字段、路由怎么走。
- 部署目标已经选好（Vercel、Cloudflare Pages 或 Netlify），域名也准备好了。
快速结论
当你目标清晰、只想加速时用 Claude Code；当你还在选技术栈时别用，它会顺着你随口提到的第一个选项一路走到黑。
实操步骤
- 空仓库里先放一个
CLAUDE.md，用人话写清楚：技术栈是 Astro + MDX、语言 en/zh、路由结构、content collection 的字段。 - 让 Claude Code 搭起 Astro 项目骨架，包括 content collections、i18n 路由、最小布局——
astro.config.mjs和src/content/config.ts必须自己仔细看完再接受。 - 手写一篇真实文章作为 schema 样板，绝对不要让 Agent 自己发明 frontmatter 字段。
- 布局组件（
BaseLayout、ArticleLayout、Nav）一个个交给它做，每个都 review 完再做下一个，别让它一口气生成全套。 - 让它生成 sitemap、robots.txt、RSS feed——这些任务定义清楚，AI 做得很稳。
- SEO meta（canonical、hreflang、OpenGraph）要先列清楚你要的标签，让它做成一个单独的 helper 组件，而不是散在各页面。
- 第一次部署到 Vercel 或 Cloudflare Pages 必须自己手动来，看着构建输出。能跑通之后再让 Agent 加 GitHub Actions。
- 上线后把 Agent 切到”review 模式”——做增量任务远比白板开始稳。
容易踩的坑
- 让 Agent 选技术栈。它会默认拉 Tailwind、shadcn 和十几个你根本不需要的包。
- 接受它第一版提的内容 schema。Schema 一旦定下来很难改，写到 50 篇再改 frontmatter 就是噩梦。
- 说”做一个好看的首页”不给约束。结果只会是个通用 SaaS landing page。要明确指定区块、内容、语调。
- 不分阶段提交。每次接受改动就 commit 一次，下次 Agent 翻车你才回得来。
- 相信它的部署配置。第一次部署必须自己看着 build log 来，能跑通再自动化。
这篇适合谁
已经有 Astro 或 Next.js 基础、想把两周搭建压到一个周末的独立开发者。
这篇不适合谁
完全看不懂生成代码的纯新手——出问题时你自己救不回来，最后会留下一个没人能维护的站。
FAQ
- 一定要用 Claude Code CLI 吗，网页版不行吗: 做整个仓库还是要 CLI——能读写文件、跑命令。网页版只适合片段级别的提问，跨 session 容易丢上下文。
- 生成的代码可以直接信吗: 当作一个不太熟的同事提的 PR 来对待：读、跑、测。成功率很高但绝不是 100%。
- Claude Code 双语路由能搞对吗: 只要你一开始就把路由规则告诉它（比如
/en/articles/[slug]和/zh/articles/[slug]），没问题。让它自由发挥就会出各种不一致的路径。 - 可以让它也写文章吗: 做结构性草稿可以；要发布的内容必须人工 review 一遍——具体看”AI 生成内容如何避免低质”那篇。