Guide · Claude Code

我如何用 Claude Code 从零做出这个网站

你现在看到的这个网站——有谱实验室——从一个空文件夹到现在这个样子,全程是我和 Claude Code 对话做出来的。没有写过一行手动的框架代码,但也绝不是”一句话生成”。这篇把整个过程如实复盘一遍,包括几个关键的岔路口和踩过的坑,给同样想用 AI 建站的人做参考。

一、最重要的一步,是在动手前想清楚”做什么”

我最初的想法很朴素:做一个个人作品集,把自己做的几个项目摆上去。但聊着聊着,AI 提醒了我一个我没想到的问题:

纯作品集有个致命伤——更新慢、没人看。你的项目不会天天上新,网站就会一直是”死”的。

这句话点醒了我。于是定位从”作品集”升级成了内容站:作品只是其中一块,再加上「AI Agent 指南」(写使用心得)、「有谱雷达」(每月推荐亲测好物)、「有谱锦囊」(AI 用法案例)。这三块能持续更新,网站才活得下去。

这一步没写任何代码,却是最关键的。 如果一上来就说”帮我做个作品集”,我今天大概只有一个精美但冷清的空壳。

二、定几条原则,后面的技术选择自然就顺了

想清楚要什么之后,我给这个项目定了两条硬原则,剩下的技术决策 AI 基本能自己推导:

  • 服务器上不放数据库、不做后台。 我不想维护一套登录、鉴权、存储,也不想给备案过的服务器留安全隐患。于是所有内容都是仓库里的 Markdown / JSON 文件——“内容即文件”。
  • 能静态就不动态。 最终选了 Astro,写 Markdown 就能生成纯静态页面,服务器只用跑一个 Nginx,负担几乎为零。

原则先行的好处是:当 AI 给方案时,我能一眼判断”这个符不符合我的原则”,而不是被各种炫技的方案带偏。

三、我的三条协作心法

1. 先聊清楚,再动手

不要一上来就要成品。先把定位、结构、风格聊透,让 AI 出规划、给选项,你来做选择题。我甚至是先让它帮我查域名、比选名字,再一步步聊页面结构和配色,最后才让它写第一行代码。

2. 小步快跑,每步验收

每做完一个板块,就让它在浏览器里跑起来给我看。发现不对立刻说——AI 改起来很快,最怕的是攒一堆问题到最后一起爆。这个网站是一个板块一个板块长出来的,不是一次性砸出来的。

3. 站在巨人肩膀上,让 AI 抄结构、你抄不了的品味自己补

看到喜欢的网站,直接把链接丢给 AI,让它分析人家的结构和交互,再用到自己的站上。但要注意——抄结构,不抄内容。我参考了一个做得很好的同类站的卡片布局和”数据条”设计,但每一条文案、每一个提示词都是重新写的、带自己的观点的。

四、我踩过、也帮你标出来的坑

  • 需求描述太模糊:说”好看一点”没用,说”参考某某站的卡片布局、深色科技风”才有用。给 AI 具体的参照物。
  • 舍不得让 AI 返工:改方案是常态,中途从”三板块”加到”四板块”、把列表页重做成卡片页,都很正常。沉没成本不是成本。
  • 一次塞太多需求:一句话里塞五件事,不如拆成五句话,一件一件来,每件都能验收。
  • 忘了外部约束:我的服务器在大陆、要 ICP 备案,域名备案通过前不能解析上线。这类”代码之外”的现实约束,一定要早点告诉 AI,让它帮你把节奏排好——我就是趁备案审核的那段时间,并行把网站内容填起来的,备案一通过,当天就上线了。

五、做完之后,怎么维护

这也是我最满意的一点:维护这个网站,不需要我再写代码

想加一篇文章,就在 src/content/guide/ 新建一个 Markdown 文件;想发一期雷达,就复制上一期改一改。写完 git push,GitHub Actions 自动构建、自动部署,一分钟后网站就更新了。

# 发布一期新内容,就这么简单
git add .
git commit -m "radar: 新增 2026-08 期"
git push

我甚至可以直接对着 Claude Code 或 Codex 说”加一期雷达,推荐这三个项目”,让它帮我把文件写好——这套工作流本身,就成了这座实验室的第一篇指南。

小结

Vibe Coding 的门槛,从来不是”会不会写代码”,而是会不会把需求讲清楚、会不会验收结果、有没有自己的判断。这三件事,恰好是每个人都能练、也值得练的能力。

你现在看到的这个网站,就是这么做出来的。它证明了一件事:一个非科班的人,靠对话,真的能把想法一件件做成能用的东西。

← 返回指南列表