三个月前的我：

你先别急着焦虑"48 小时够不够"。我花了两天时间，跟 Claude Code 聊着聊着就把一个知识图谱 demo

做出来了——没有详细需求文档，没有原型图，只有一个模糊的想法：“上传文件，AI 分析，前端画个图”。够了。

项目长什么样

一个网页工具。上传 txt、md、pdf、docx，DeepSeek V4

自动把里面的实体和关系抽出来，前端渲染成交互式知识图谱。节点可以拖拽，缩放，点了能看邻居，搜了能高亮。两种模式：命名实体（张三→任

职→字节跳动）和概念关系（Transformer→依赖→自注意力机制），并行分析，一键切换。部署在阿里云上，域名 Knowledge Graph Explorer。

技术栈：Next.js 14 + D3.js v7 + FastAPI + LangChain + LanceDB。

需求是聊出来的，不是写出来的

开始的时候我只跟 Claude Code 说了一句话：“做一个上传文件、AI 抽取、前端展示知识图谱的东西”。它没直接写代码，而是反问我：文件格式是

啥？中文还是英文？图谱类型是命名实体还是概念关系？要不要搜索？要不要持久化？

一问一答下来，需求自然就定了。最妙的是中间我一度想把检索功能和对话式 RAG 全做了，Claude Code 拦住了——"48

小时内做不完"——建议先用前端关键词过滤代替。后来证明这个判断是对的：光图谱渲染就调了一下午参数，再加 RAG 根本交不了。

最坑的几个地方

LanceDB 翻车。 Claude Code 一开始推荐 LanceDB 做本地存储，理由很充分：“嵌入式，不用装数据库”。然后它的 API 从 0.15 到 0.16

全变了，to_pandas() 没了，search() 必须配向量列否则报错。为这个折腾了快两个小时，最后还是加 dummy vector

绕过去的。下一次做小项目：直接 JSON file 存数据，等需要并发、索引、查询了再上数据库。Claude Code 事后也认了："当时推荐 LanceDB

是个错误决策"。

D3 力导向参数纯靠猜。 charge 排斥力、link distance、center force——没有一个现成的公式。最后是跟 Claude Code

来回试出来的：charge=-20、linkDist=50、centerStr=0.15 是 50-200 节点的甜点。它还建议用 forceRadial 把节点排成圆形，比 forceCenter

那种全部挤在中间的默认效果好得多。

cytoscape 换 D3 是一天内的关键决策。 项目前半天是用 cytoscape.js

写的，结果类型报错、布局算法缺失、交互崩溃——三个问题叠在一起，Claude Code 说"换个库吧"。切到 D3 以后代码少了 40%，bug 少了

80%。这个决策省了至少四小时的修修补补。

Claude Code 怎么帮的我

除了写代码，它帮我做了很多"辅助决策"：

• 分块策略——从 1500 字符/块提到 6000，省了 4 倍 API 调用。它说 DeepSeek V4 有 1M 上下文，“别太小气了”

• 前端的可视化细节——节点按度数大小、大节点黑字小节点灰字、省略双击用按钮"重构图"。这些不是我想到的，是它提的

• Dockerfile 里先装 CPU torch 再装 sentence-transformers，否则 CUDA 包 2.5GB 填满阿里云 40G 磁盘——这个坑它帮我省了

• HFS 镜像——BGE 模型下载国内直连超时，它判断出来是网络问题，加了 HF_ENDPOINT=https://hf-mirror.com 就通了

整个过程大概用了 15 小时有效时间——代码写了一部分，调参占了相当比例，还有两个小时在跟 LanceDB 的版本兼容性打架。Claude Code

写的代码大概占 70%，但它最值的部分不是写代码，是当我脑子不清的时候把我拉回来。

下次会怎么做

1. 需求先聊透再动工。 那 10 个来回的问答帮我锁定了功能边界，没做多余的东西。下次也是这样——别急着要代码，先让它把逻辑问清楚。

2. 不跟数据库过不去。 小项目的存储就用 JSON，别想"万一以后要扩展"——以后的事以后再说。

3. D3 力导图参数有规律。 下次先搜 d3 force layout parameter guide，比一个个试快得多。Claude Code

的建议是有上限的——它也不知道你的数据长什么样，参数还得自己感受。

4. 部署早做。 第一天晚上就可以 docker compose up 跑起来了，让更多时间留给联调，而不是最后一小时赶着传文件。

总的来说：Claude Code

不是写代码的机器，它是一个你有想法、它帮你追问、你去执行、它帮你纠正的对话伙伴。不用害怕需求不清晰——聊着聊着就清晰了。