1. 为什么用 Claude Code 做第二大脑而不是再装一个笔记软件大多数人做知识管理卡在同一个地方录入的时候很爽检索的时候抓瞎。你存了几百篇 Markdown、几十份会议纪要、一堆技术方案真到要用的时候还是靠grep加记忆去翻。关键词搜索的前提是你得记得住那个词可人的记忆恰恰是靠语义而不是靠精确字符串工作的。Claude Code 能改变这件事是因为它本身就是一个跑在终端里的 Agent能读你本地的文件、能按目录结构去检索、能理解自然语言意图还能把结果直接写成新的文件。换句话说它不只是帮你写代码而是可以当成一个能访问你私有语料的调度中枢。你问它上个月那个扩容方案当时怎么定的它会去你的知识库目录里找相关文件读进来再给你一段带出处的回答。这套玩法的核心检索词就是Claude Code 个人知识库和第二大脑搭建。它适合三类人一是笔记存了一堆但从来搜不到的人二是想把会议纪要、踩坑记录、技术方案统一管理的人三是已经在用 Claude Code 写代码想让它顺带理解自己业务背景的人。你不需要换掉现有的 Obsidian 或 Notion只需要在本地留一个纯文本目录让 Claude Code 能读能写就行。我自己的做法是所有值得留下的东西最终都落成.md或.txt放在一个固定根目录下按主题分子目录。Claude Code 通过项目级和用户级两层配置知道这个根目录在哪、什么情况下该去查。下面从接入通道开始一步步把这套东西跑起来。2. TaoToken 统一 Key 接入 Claude Code 的前置准备Claude Code 默认走 Anthropic 官方通道但很多人在国内环境里配置起来会碰到网络和账号的问题。TaoToken 提供的是一个统一的 API 通道你拿一个 Key就能通过兼容的 Base URL 去调用模型省掉每个工具单独配一遍的麻烦。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。前置准备其实就三样东西第一一个可用的 API Key。登录后在控制台的 API Keys 页面创建形如sk-开头的一串字符。这个 Key 就是后面所有配置里要填的凭证别把它提交到 Git 仓库里。第二确认你要用的 Model ID。Claude Code 场景下通常用 Anthropic 系列的模型标识具体以你账号里可用的模型列表为准。配置时 Base URL、Key、Model ID 这三件套必须同时正确缺一个都会报错。第三本地已经装好 Claude Code CLI。如果你还没装用 npm 全局安装即可npm install -g anthropic-ai/claude-code claude --version装完之后先别急着配知识库先把通道打通。TaoToken 的接入文档在 https://taotoken.net/doc 里面有各客户端的配置示例遇到不确定的字段可以去对照。这里要强调一点TaoToken 是合规的 API 聚合通道配置时只填 Base URL 和 Key不要引入任何额外的网络层工具否则容易出问题。准备阶段还有个小细节给你的知识库根目录起一个绝对路径比如/Users/yourname/brain或D:\brain。后面所有配置都会引用这个路径路径写错是新手最常见的翻车点。3. 可复制的 settings 配置与知识库目录结构这一节是整篇的核心配置片段可以直接抄。Claude Code 的配置分两层用户级全局生效和项目级只在当前目录生效。做第二大脑两层都要用——用户级负责告诉它我的知识库在哪项目级负责具体项目的上下文。先看用户级配置文件路径是~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read(//Users/yourname/brain/**), Write(//Users/yourname/brain/**), Edit(//Users/yourname/brain/**) ] } }这里三个字段要对应上ANTHROPIC_BASE_URL填 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你的 KeyANTHROPIC_MODEL填 Model ID。permissions.allow里把知识库根目录的读写权限放开这样 Claude Code 才能扫描和写入你的笔记而不会每次都弹确认。再看项目级配置。在你的知识库根目录下建一个CLAUDE.md这是 Claude Code 每次启动会自动读取的记忆文件。它的作用是给 Agent 立规矩# 我的第二大脑 ## 知识库位置 根目录/Users/yourname/brain 子目录说明 - meetings/ 会议纪要与复盘 - pitfalls/ 踩坑记录与修复方法 - designs/ 技术方案与架构决策 - inbox/ 未整理的碎片想法 ## 工作规则 1. 任何任务开始前先检索相关目录看有没有过往经验。 2. 新增知识时按语义归档到对应子目录文件名用「日期-主题.md」。 3. 回答问题时必须标注信息来源的文件路径。 4. 发现过时信息时在文件顶部加 已过时 标记不要直接删除。目录结构建议这样组织简单但够用brain/ ├── CLAUDE.md ├── meetings/ ├── pitfalls/ ├── designs/ └── inbox/inbox/是缓冲区你随手丢进去的碎片想法先放这之后让 Claude Code 定期整理归档。这套结构的好处是语义清晰Agent 检索时能按目录缩小范围不用每次全量扫描几万个文件。配置写完后用claude启动它会自动加载用户级 settings 和当前目录的 CLAUDE.md。如果启动时报401或local proxy failed先回去检查 Key 和 Base URL 有没有写错具体排查见第 5 节。4. 三步验证发起问答、确认命中、检查返回配置写完不代表通了必须做验证。我习惯用三步动作确认整条链路是活的。第一步发起一次问答。在知识库根目录下启动 Claude Code先往inbox/里放一个测试文件比如inbox/2025-01-01-测试.md内容写一句我的知识库测试标记是 TAOTOKEN-BRAIN-001。然后在对话里问我的知识库测试标记是什么第二步确认请求命中。如果通道配置正确Claude Code 会去读inbox/下的文件然后回答出TAOTOKEN-BRAIN-001。这一步验证的是两件事一是 API 通道通了否则根本不会有回答二是文件读取权限开了否则它读不到文件。如果它回答我没有找到相关信息多半是permissions.allow里的路径写错了或者你不在知识库根目录下启动。第三步检查返回内容。看它的回答里有没有标注来源文件路径。按 CLAUDE.md 里的规则它应该告诉你信息来自inbox/2025-01-01-测试.md。如果只给了答案没给出处说明记忆文件没被正确加载检查CLAUDE.md是不是放在了启动目录下。三步都过了再做一个真实场景的验证让它把一段新内容归档。输入把这段记下来TaoToken 的 API 地址是 https://taotoken.net/api 归档到 designs/ 目录。正常的话它会在designs/下创建一个新文件并写入内容。你可以用ls designs/确认文件真的生成了。这一步验证的是写权限和归档逻辑。验证通过后你的第二大脑就算跑起来了。之后每次用都是在这个基础上叠加内容。想验证模型本身是否正常可以去 https://taotoken.net/api-keys 确认 Key 状态或者用模型对话页面单独测一次请求。5. 常见报错排查401、local proxy failed 与读取失败配置阶段最容易撞上的几个报错我按实际遇到的频率排一下。401 Unauthorized。这是 Key 的问题。要么 Key 填错了要么 Key 已失效要么ANTHROPIC_AUTH_TOKEN这个字段名写成了别的。检查方法把 Key 复制到模型对话页面单独发一次请求能通说明 Key 没问题问题在 Claude Code 的配置字段上。注意字段名必须是ANTHROPIC_AUTH_TOKEN不是ANTHROPIC_API_KEY这两个在 Claude Code 里不通用。local proxy failed 或连接超时。这个报错通常意味着 Base URL 写错了或者本地有残留的网络配置在干扰。先确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api结尾不要多加斜杠。然后检查你的 shell 环境里有没有遗留的HTTP_PROXY、HTTPS_PROXY变量有的话清掉再试unset HTTP_PROXY HTTPS_PROXYreading choices 相关报错。这类报错一般出现在返回体解析阶段常见原因是 Model ID 填了一个当前账号不可用的模型。回到配置里把ANTHROPIC_MODEL换成账号里确认可用的模型标识重启 Claude Code 再试。OAuth 相关报错。如果你之前登录过 Anthropic 官方账号本地可能残留了 OAuth 凭证和 TaoToken 的 Key 冲突。解决办法是清掉旧的凭证缓存让 Claude Code 只走 settings.json 里的 Key。凭证一般在~/.claude/目录下找到对应的缓存文件删掉即可。文件读取失败或权限被拒。报错里会提到路径。检查permissions.allow里的路径是不是绝对路径、有没有写错用户名、通配符**有没有漏。Windows 下路径要用双反斜杠或正斜杠别用单反斜杠。排查时记住一个原则Base URL、Key、Model ID 三件套必须同时正确。任何一个错了报错信息可能都长得差不多所以改配置时一次只改一个字段改完重启验证别一次改一堆否则你不知道是哪个起的作用。6. 把知识库用起来检索式问答与长期维护配置通了只是开始真正让第二大脑产生价值的是日常用法。我总结了几个高频场景。检索式问答。这是最直接的用法。你不需要记得文件名直接描述意图我记得之前讨论过一个接口限流的方案当时选的是什么策略把相关文件找出来。Claude Code 会去designs/和meetings/里检索读进相关文件然后给你结论并标注出处。这比关键词搜索强的地方在于你描述的是意图而不是精确词。自动归档。碎片想法先丢inbox/每周让它整理一次把 inbox/ 里的内容按主题归档到对应目录文件名用日期加主题。它会读每个文件、判断语义、移动到合适位置。你只需要最后扫一眼确认。定期除草。知识有时效性过时的 API 文档、废弃的方案留着会污染检索结果。每周让它对比新旧记录检查 designs/ 里有没有和最近会议纪要冲突的过时方案有的话在文件顶部加过时标记。跨项目复用。因为用户级配置是全局的你在任何目录下启动 Claude Code它都能访问知识库。这意味着你在写新项目时可以直接问我以前处理过类似的问题吗它会去知识库找你的历史经验。这是第二大脑和普通笔记软件最大的区别——它跟着你走而不是锁在某个 App 里。长期用下来知识库会越滚越大检索效率反而不会下降因为目录结构和 CLAUDE.md 的规则在约束它。你要做的维护动作很少定期整理 inbox、定期标记过时内容、偶尔调整目录结构。剩下的交给 Agent。如果你想把长期编码和 Agent 任务也统一到这套体系里可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 配置字段有疑问时对照着看最快。
