用 Claude Code 重做个人主页

我原来的主页是 2025 年用 Hugo Blox 学术模板搭的，之后基本没再管。等我终于回头看它时，情况比想象中还糟。2026 年 10 月，我分几次对话用 Claude Code 把它从零重做了一遍。这篇文章记录了整个过程，以及下次我还会沿用的做法。

起点

我先让 Claude Code 检查项目环境和线上网站，看两者是否同步。这次检查比我预想的有用得多：

线上网站从 2025 年 8 月之后就没再部署过。
本地环境根本构建不了——主题需要更旧的 extended 版 Hugo，和本机装的版本不兼容。
模板自带的示例内容还挂在线上：示例博客、教学页、项目页，以及一份 resume.pdf——打开一看是 Lorem ipsum 占位文字。
一些小而尴尬的问题：GitHub 图标链接到主页自己，“Read Thesis” 按钮指向 example.com，NeurIPS 条目只是一个空占位。

我想要的不只是修补，而是一个真正的个人网站，而不只是学术主页：有博客，中英双语，读者不需要 GitHub 账号也能留言。

先定方案，再做设计，最后写代码

我要求在写任何代码之前先给出方案，并由我明确批准。回头看，这是整个项目里最重要的习惯。用什么框架、网址怎么组织、语言如何选择、评论放在哪里——每个决定都先用大白话讲清楚，再开始动手。

几个决定了网站形态的选择：

用 Astro，不再用主题。 每个页面都是自己的代码，以后框架升级不会再像旧主题那样悄悄把构建弄坏。
按设备语言选择中英文。 默认英文；浏览器首选中文的访客会进入 /zh/，手动点 EN/中切换后会记住选择。文章的两个语言版本由我自己写——我考虑过自动翻译，最后还是觉得措辞应该由自己把关。
评论放在自己的服务器上。 我不希望读者必须登录 GitHub，所以评论会跑在一个自建的小服务上，这是下一步要做的。

设计方面，我先让它做了三个首页设计稿再动手。我选了其中一个，改了配色，然后又彻底改主意，要求做得更接近 apple.com 的风格。

为什么是苹果？因为我觉得苹果的 taste 很不错——干净的排版、充足的留白、让文字本身说话——所以就模仿了它的风格。希望苹果的 taste 可以一直好下去，这样我就可以一直模仿它。其实 Claude 本身界面的 taste 也很不错，我也很喜欢。

给截图，而不是给形容词

“做成苹果官网的风格”能得到一个还不错的初稿；真正让它做对的，是我发过去的截图：灰底上放白色卡片的支持页面，上方白底大标题、下方灰底密集内容的产品页，用纯文字而不是方框排列的列表。每一张截图解决的问题，都是一段形容词描述解决不了的。现在的布局——简介在白底，信息密集的内容放在灰色区域的白色卡片里——就直接来自其中一张。

小细节也是一样。“这个标题太大了""删掉这行字，显得不专业”，这类具体的修改又快又准，来回迭代的成本很低。网站图标从姓名缩写换成波形，又换回缩写，前后也就几分钟。

让它自己验证，并且核实事实

有两件事让我对结果更放心。

第一，Claude Code 会测试自己的成果：构建网站、在浏览器里打开页面、检查手机宽度，发现问题就修。有一个 bug 很隐蔽——自动切换语言时，本地预览会跳转到线上网站，而不是留在当前地址。另一个是文章页在手机上比屏幕还宽，导致页面可以左右滑动。

第二，内容有据可查。论文信息是在 Crossref 上核对过的，而不是凭记忆填写。有一次它根据缩写补全了两位专利合作者的全名，随后去 Google Patents 核对，发现两个都猜错了，并改了过来。这件事是我能想到的最好的理由：让智能体去查资料，而不是相信听起来合理的内容；同时，发布之前一定要亲自读一遍它写的关于你的每一句话。

值得保留的”刹车”

有几个时刻，慢下来才是对的：

删除文件。 要删掉旧的 Hugo 文件时，自动模式的安全检查拦下了删除操作。Claude Code 停了下来，解释它想做什么，并给出了让我自己执行的命令。
个人隐私。 我的完整简历里有电话号码。网站上的 cv.pdf 是从去掉号码的副本编译的，上线前还检查了 PDF 的文字和元数据。
跨会话的记忆。 配色、双语规则、服务器信息存放的位置等决定都被记了下来，新的对话不用从头再问一遍。

下次我会告诉自己的

先让它做一次全面检查，再提修改要求。
先用文字把方案谈清楚并批准，再写代码。
先看设计稿，再做页面。
发截图，而不是堆形容词。
让它对照真实来源核实事实，并亲自读一遍关于自己的每一句话。
删除、发布、公开个人信息这类不可逆或对外的操作，由自己来决定。

现在这个网站用 Astro 构建，通过 GitHub Action 部署到 GitHub Pages，内容都是可以手动编辑的 Markdown 和 YAML。评论功能是下一步。如果你发现哪里有问题，欢迎给我发邮件。