Claude Code 知识库
Claude Code 能记住一个项目。Busabase 则为整个团队提供一处经过审核的知识空间,用来保存不能只留在一台电脑或一个 Agent 里的决策、证据与运营知识。
三种记忆
Claude Code 已经会记忆,真正的问题是谁可以信任哪一种记忆。
Anthropic 把长期指令与 auto memory 分开。Busabase 再增加第三层,承接需要共同负责、结构化字段、信息来源,以及从提议走向正式记录的团队知识。
长期指令
Claude 每次会话都应该看到的编码规范、构建命令、架构规则和操作指引。
由代码仓库管理,通过 Git 审核。
自动学习
Claude 为同一仓库的后续会话记录的纠正、偏好与项目模式。
由 Claude Code 管理,可以作为本地 Markdown 查看和编辑。
团队记录
需要跨 Agent、仓库和应用复用的决策、证据、Runbook、发布状态与业务事实。
由团队通过审核与合并历史共同管理。
提拔知识,而不是复制聊天
不是每个有用发现都应该进入知识库。
大多数会话输出都应该保持临时状态。只有当其他人或 Agent 之后会依赖某项发现,而且审核者能够确认背后的证据时,才把它提拔为团队知识。
Claude 发现一条可复用的事实
某个约束、决策、依赖或事故教训,无法只从代码中可靠推导出来。
Claude 写下主张和来源
在记录被接受之前,拟写入的 Base 字段已经说明这条知识以后会怎样使用。
由人检查它会带来的后果
审核者可以修正适用范围、补充证据、拒绝主张,或批准它供后续复用。
下一次会话读取已接受的记录
Claude 不必重新推断同一事实,团队也能追溯它如何成为可信记录。
并行协作
给 subagent 一份交接账本,而不是一堆共享笔记。
Claude Code 可以把任务交给彼此隔离的上下文。结构化 Base 为这些执行者提供同一份交接契约:调查了什么、改了什么、还有哪些不确定项,以及谁接受了最终结果。
长期有用的 Base
先建立一张 Claude 能读取、也能提交提议的决策表。
一套精简的数据结构,比无限增长的长文档更适合作为记忆。每个字段都能告诉下一位 Agent:哪些可以依赖,哪些仍需核查。
| 字段 | 作用 |
|---|---|
| decision | 后续 Agent 可以使用的简明结论。 |
| evidence | 支持结论的来源链接、测试输出或原始记录。 |
| scope | 结论适用的仓库、服务、客户或环境。 |
| owner | 负责维护信息时效的人。 |
| verified_at | 证据最近一次完成核查的时间。 |
Claude Code 扩展栈
让每一种扩展只负责它真正能够治理的工作。
Claude Code 的多种扩展可以协同工作。Busabase 是外部正式记录系统,而不是另一份每次都加载的提示文件。
| 层 | 适合处理 | 治理方式 |
|---|---|---|
| CLAUDE.md | 每次会话都加载的项目指令 | 代码仓库审核 |
| Skill | 按需加载的知识与可复用工作流 | Skill 来源与调用方式 |
| Hook | 确定性的生命周期约束 | 可执行规则 |
| MCP | 外部工具与数据访问 | 服务器权限与认证 |
| Busabase | 跨仓库共享的已审核记录 | Change Request、审核者与合并历史 |
以上分工依据 Anthropic 对 CLAUDE.md、Skill、Hook、MCP 和 subagent 的官方定义。
连接正式记录层
连接步骤留在连接页,知识库只谈如何使用。
可以安装 Busabase Claude Code 插件来获得持续维护的工作流,也可以在连接指南中选择 user、project 或 local MCP 作用域。连接完成后,先从读取权限和一张可审核的 Base 开始。
第一个工作流
架构决策表
- 读取
- 这项服务已经接受的决策
- 提议
- 带有证据和适用范围的新决策
- 审核
- 负责人检查影响与时效
- 复用
- 下一次会话从已接受的记录开始
团队常见问题
Claude Code 知识库常见问题
Busabase 会取代 CLAUDE.md 或 auto memory 吗?
不会。指令继续放在 CLAUDE.md,机器本地的学习记录继续留在 auto memory。只有当知识需要结构化字段、共同负责人、来源与审核历史时,才使用 Busabase。
多个 Claude Code Agent 能使用同一个知识库吗?
可以。多个 Agent 可以读取同一批已接受记录,同时分别提交提议。审核机制可以防止并行工作悄悄覆盖共享知识。
Claude Code 可以直接写入 Busabase 吗?
可执行操作取决于 API Key 的权限级别。团队知识建议使用 Change Request 权限:Claude 可以提交提议,审核者决定哪些内容合并为正式记录。
架构决策还应该保存在 Git 里吗?
由代码负责的产物继续保存在 Git 中。当同一项决策还会影响其他仓库、客服、运营、产品工作或非代码应用时,再使用 Busabase 决策表。
这只是 Claude Code 的向量记忆吗?
不是。向量检索负责找到相关文本;Busabase 记录谁提出了结构化改动、哪些证据支持它、谁完成审核,以及哪个值最终成为正式记录。
把一次纠正变成团队知识
让下一次 Claude Code 会话从已接受的决策开始
创建一张精简的 Base,连接 Claude Code,只把团队愿意审核和复用的发现提拔为正式知识。