1. 从零搭建个人知识库Claude Code 搭配 graphify 与 Obsidian 的完整链路很多人收集资料的速度远超消化速度浏览器书签几百条、微信收藏上千条真正要用的时候却一条都找不到。我最近在折腾一套组合用 Claude Code 做调度中枢graphify 负责把散落的 Markdown 文档抽成知识图谱Obsidian 作为最终的阅读与双链管理界面。三者串起来之后你往raw/目录丢一篇文章几分钟后就能在 Obsidian 里看到它和其他笔记的关联关系。这套方案适合谁适合已经有一定 Markdown 笔记积累、想让大模型帮忙做知识关联、又不想把数据传到第三方 SaaS 的人。核心检索词就是 Claude Code、graphify、Obsidian 三件套本文会交付可复制的 settings 配置片段、graphify 索引命令、Obsidian 目录结构以及一次端到端验证动作。整个链路的关键在于Claude Code 需要调用模型来理解文档内容并生成图谱而模型请求的端点、Key、模型 ID 这三样东西统一走 TaoToken 的 API 通道来管理。这样你不需要在多个工具里反复填 Key改一处配置就能全局生效。下面从环境准备开始一步步把这条链路跑通。2. 前置准备TaoToken 统一 Key 与 Claude Code 环境搭建在动手改配置之前先把账号和基础工具准备好。TaoToken 的作用是提供一个统一的 API 入口你只需要维护一个 Key就能在 Claude Code、graphify 以及其他需要模型能力的工具里复用。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key 即可。拿到 Key 之后先确认本机的 Claude Code 能正常启动。如果你还没装用 npm 全局安装npm install -g anthropic-ai/claude-code装完之后不要急着跑先检查版本确认命令可用claude --version接下来是 Obsidian 侧的准备。Obsidian 本身是个本地 Markdown 编辑器它的价值在于双链和图谱视图。你需要做两件事一是安装 Obsidian 本体并开启 CLI 支持二是装一个 Web Clipper 浏览器扩展方便把网页内容快速剪藏成 Markdown。Web Clipper 在 Chrome 应用商店搜索 Obsidian Web Clipper 就能找到装好后在任意网页点一下内容就落到你指定的 vault 目录里。graphify 是这套方案里负责理解文档的组件它读取 Markdown 后调用模型抽取实体和关系输出 graph.json 和 graph.html。安装方式取决于你的 Python 环境管理习惯。如果你用 uv 管理虚拟环境先建环境再装包uv venv ~/.venv/Scripts/activate.ps1 uv pip install graphifyy注意包名是graphifyy多一个 y这是发布在 PyPI 上的实际名称。装完之后把 graphify 注册到 Claude Code 里让它能作为 skill 被调用graphify install默认注册到 Claude Code如果你用的是其他工具需要加参数指定。这一步做完Claude Code 里就能识别/graphify命令了。3. 可复制配置把 Claude Code 的 settings 改到 TaoToken这是全文最关键的一步。Claude Code 默认会去请求官方端点我们要把它改成走 TaoToken 的统一通道。配置的核心是三个值Base URL、API Key、Model ID。这三个值在 TaoToken 控制台都能找到Base URL 用https://taotoken.net/api注意这个地址不带任何查询参数。Claude Code 的配置文件在用户目录下的.claude/settings.json。如果你之前没建过直接新建一个。下面是可以直接复制的 JSON 片段{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(graphify:*), Bash(uv:*), Read, Write, Edit ] } }把sk-你的TaoToken密钥替换成你在控制台创建的真实 Key。Model ID 按你实际订阅的模型填上面给的是一个示例值。permissions.allow里放行 graphify 和 uv 相关命令避免每次执行都弹确认框。如果你更习惯用环境变量而不是 settings 文件也可以在 shell 里导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_MODELclaude-sonnet-4-20250514两种方式选一种即可settings.json 的好处是持久化重启终端不用重新导出。改完之后Claude Code 发出的所有模型请求都会经过 TaoToken 的通道Key 和端点统一管理。这里有个容易踩的坑Base URL 末尾不要加/v1或其他路径Claude Code 会自己拼接。如果你填成https://taotoken.net/api/v1请求路径就会变成/api/v1/v1/messages直接 404。另外 Key 不要带多余空格复制的时候容易带上换行符。配置改完先别急着跑 graphify用一条最简单的命令验证通道是否通。在终端里执行claude -p 回复 ok如果返回ok说明 Base URL、Key、Model 三件套都生效了。如果报 401回去检查 Key 是否复制完整如果报连接超时检查 Base URL 是否写错。4. 端到端验证写入笔记后触发图谱生成配置通了之后开始搭知识库目录。我建议的结构是这样你可以照着建F:/kb/personal/ ├── raw/ # 原始素材Web Clipper 剪藏的内容放这里 │ └── webclip/ ├── notes/ # 你自己的笔记 ├── graphify-out/ # graphify 输出目录自动生成 └── .claude/ # Claude Code 项目级配置raw/放原始文档notes/放你消化后的笔记graphify-out/是 graphify 跑完自动生成的不用手动建。进入项目目录启动 Claude Codecd F:/kb/personal claude --dangerously-skip-permissions--dangerously-skip-permissions会跳过权限确认适合在受控的本地目录里跑批处理。如果你不想跳过去掉这个参数手动确认也行。在 Claude Code 的交互界面里执行 graphify 索引命令/graphify .这个命令会扫描当前目录下的 Markdown 文件调用模型抽取实体和关系。跑完之后你会看到graphify-out/目录里多出几个文件graphify-out/ ├── GRAPH_REPORT.md # 人类可读的图谱报告 ├── cache/ # 缓存加速二次索引 ├── cost.json # 本次调用的 token 消耗 ├── graph.html # 可视化图谱浏览器打开 ├── graph.json # 结构化图谱数据 └── manifest.json # 索引清单打开graph.html就能看到知识图谱的可视化效果节点是实体边是关系。这一步验证了模型请求正常返回因为图谱的生成完全依赖模型对文档的理解。接下来把图谱信息输出成 Obsidian 能识别的格式/graphify . --obsidian这个命令会在笔记里插入双链和标签让 Obsidian 的图谱视图也能展示关联。跑完之后打开 Obsidian加载F:/kb/personal作为 vault你就能在 Obsidian 的图谱视图里看到节点和连线了。端到端验证的完整动作是往raw/webclip/丢一篇 Markdown 文章在 Claude Code 里执行/graphify .等它跑完打开graph.html确认新文章里的实体出现在图谱里。如果出现了说明从文档读取、模型调用、图谱生成、结果落盘整条链路都通了。5. 常见报错排查401、heredoc、找不到 graphify 命令跑这套链路大概率会遇到几个报错。我把自己踩过的坑列出来对照着排查。401 错误最常见的原因是 Key 不对。检查settings.json里的ANTHROPIC_API_KEY是否和 TaoToken 控制台里的一致注意有没有多余空格或换行。如果 Key 没问题检查 Base URL 是不是写成了https://taotoken.net/api末尾不要带斜杠。还有一种情况是 Key 被禁用或额度用完去控制台确认一下状态。local proxy failed这个报错通常出现在网络层说明 Claude Code 尝试连接 Base URL 时失败了。先确认ANTHROPIC_BASE_URL拼写正确然后用curl https://taotoken.net/api测试一下连通性。如果 curl 能通但 Claude Code 报错检查是不是有环境变量覆盖了 settings.json 里的配置比如 shell 里之前 export 过旧的ANTHROPIC_BASE_URL。heredoc 错误graphify 在处理某些 Markdown 时会尝试用 heredoc 语法执行 Python 脚本如果文档里有单引号或特殊字符heredoc 就会解析失败。控制台会提示类似heredoc 在处理单引号时遇到了问题。graphify 一般会自动降级到写临时 Python 文件的方式但如果你看到它卡住可以手动干预让它改用脚本文件执行而不是 heredoc。找不到 graphify 命令这个报错在 uv 管理的虚拟环境里特别常见。Claude Code 执行python或graphify时用的是系统 PATH而不是你激活的 venv。解决办法是给 Claude Code 配一个 skill明确指示必须用 uv 的 venv 环境执行 Python 脚本。你可以在 Claude Code 里用这样的 prompt 让它自己配我在本机用 uv 管理 Python 环境创建了 venv。 当你在 Claude Code 中调用 Python 时经常直接调用 python/pip 导致找不到命令。 请给我配置 skill明确指示必须使用 uv 的 venv 环境执行 Python 脚本并做测试。Claude Code 会生成对应的 skill 配置之后它就知道要先激活 venv 再执行。另一个更直接的办法是在settings.json的permissions.allow里放行Bash(uv:*)并且在项目根目录放一个.python-version文件指定版本让 uv 自动接管。reading choices 报错这个通常出现在模型返回格式不符合预期时。graphify 期望模型返回结构化的 JSON如果模型返回了自然语言解析就会失败。检查你用的 Model ID 是否支持结构化输出有些轻量模型在这块能力较弱。换成能力更强的模型再试。OAuth 相关报错如果你之前登录过 Claude Code 的官方账号本地可能残留了 OAuth token它会和 settings.json 里的 API Key 冲突。解决办法是执行claude logout清掉本地凭证然后重新用 API Key 模式启动。排查的顺序建议是先确认 401 和连接问题再确认命令找不到的问题最后看模型返回格式的问题。大部分报错集中在配置层真正跑到图谱生成阶段反而很少出错。6. 长期使用建议与接入文档这套链路跑通之后日常使用就是三步Web Clipper 剪藏到raw/Claude Code 里跑/graphify .Obsidian 里看图谱和双链。如果你想让模型请求的 Key 和端点长期稳定建议把配置固定在settings.json里而不是每次 export 环境变量。对于需要长期编码和 Agent 调用的场景可以了解一下 Coding Plan它适合高频调用模型能力的用户。如果你只是想先验证模型对话是否正常可以直接用模型对话页面测试。API Key 的管理在控制台的 API Keys 页面接入文档里有更详细的参数说明和示例。实际用下来graphify 的索引速度取决于文档数量和模型响应速度。第一次跑全量索引会比较慢之后有 cache 加速增量索引很快。Obsidian 的图谱视图在节点超过几百个之后会有点卡建议按主题分 vault不要把所有笔记堆在一个库里。另外graphify-out/cost.json会记录每次索引的 token 消耗定期看一下心里有数。