1. 为什么我要给 Claude Code 装一套“个人记忆库”先说结论Claude Code 本身已经是一个能读写文件、执行命令、理解项目结构的 Agent但它默认只活在“当前这个项目”里。你换一个目录、开一个新会话它就又变回那个需要你重新交代背景的陌生人。我真正想要的是——不管我在哪个项目里敲claude它都能自动知道我是谁、我偏好什么技术栈、我上次踩过哪个坑、我写文档时习惯先给结论还是先铺背景。这件事听起来玄其实拆开就是三个很朴素的需求第一把散落在笔记软件、聊天记录、任务清单里的“关于我的信息”沉淀成纯文本文件第二让 Claude Code 每次启动时按需加载这些文件第三让它在会话结束前把值得记住的新信息写回去。做完这三步“AI 比我还了解我”就从一种感受变成了可复现的配置流程。适合谁跟做已经在用 Claude Code 写代码或写内容、手上有至少几十篇笔记/文档、愿意花两三个小时整理目录结构的人。如果你只是偶尔问 AI 一个函数怎么写那通用助手就够了不必折腾。但如果你每天跟 Agent 协作好几个小时、同时推进多个项目这套东西的回报会非常明显。我用的模型是 Opus 系列里推理较深的版本。原因很直接让 AI 用你的思维方式分析一个业务场景浅一点的模型会流于表面深一点的模型能把你的决策逻辑链走完而且长对话里不容易跑偏。做记忆库这种事模型思考深度差一点整个系统的“像你程度”就差不少。下面我按“先接通道、再搭目录、再写配置、最后验证召回”的顺序讲每一步都给可复制的骨架。2. 前置用 TaoToken 统一 Key 与 API 通道在搭记忆库之前先把模型调用通道理顺。Claude Code 默认走官方通道但如果你同时用多个模型、多个工具Key 散在各处会很难管理。我的做法是用 TaoToken 作为统一的 API 通道一个 Key 覆盖 Claude Code 和其他调用场景。TaoToken 在这里的角色是“统一入口”你拿到一个 Key配置到 Claude Code 的环境变量里后续所有请求都走这个通道。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 这个不加 UTM直接填进配置即可。具体操作分三步。第一步登录后在控制台创建 API Key建议按用途命名比如claude-code-memory方便以后区分。第二步把 Key 写进环境变量不要硬编码在配置文件里。第三步在 Claude Code 的配置里把 base URL 指向 TaoToken 的 API 地址。环境变量这样设Linux/macOS 写进~/.zshrc或~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥Windows 用 PowerShell 的话$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_API_KEY sk-你的TaoToken密钥注意Key 只存在环境变量或系统的密钥管理里不要提交到 Git 仓库。我见过有人把 Key 写进settings.json然后推到公开仓库几分钟就被扫走了。如果你还想在网页端直接验证模型是否通可以打开模型对话页面手动发一条消息测试长期编码和 Agent 任务则更适合用 Coding Plan 来管理额度。这两个入口在控制台里都能找到。3. 记忆库目录结构把“我”拆成可读文件核心思路是记忆库本身就是一个普通项目目录Claude Code 把它当项目读。我把它放在~/alter下结构如下alter/ ├── CLAUDE.md # 入口文件告诉 Claude 先读什么 ├── identity/ │ ├── who-am-i.md # 身份、专业领域、决策优先级 │ └── style.md # 写作风格、表达习惯 ├── memory/ │ ├── long-term.md # 长期记忆面板 │ ├── weekly.md # 每周经验积累 │ └── blind-spots.md # 盲区记录本 ├── skills/ │ ├── write-article.md # 写文章的标准化流程 │ └── retro.md # 经验复盘流程 └── settings.json # Claude Code 项目级配置CLAUDE.md是整个系统的入口。Claude Code 启动时会自动读取项目根目录的CLAUDE.md所以我把“按需加载规则”写在这里# Alter 记忆库入口 ## 启动时必读 - identity/who-am-i.md - memory/long-term.md ## 按任务加载 - 写文章时identity/style.md skills/write-article.md - 做技术决策时identity/who-am-i.md 中的决策优先级章节 - 复盘时skills/retro.md memory/weekly.md ## 会话结束前 - 把本次值得记住的条目追加到 memory/weekly.md - 给条目打星1-54 星以上建议提升到 long-term.mdidentity/who-am-i.md不要写成“我是程序员”这种废话。要具体到可执行的偏好比如## 决策优先级 1. 可维护性 短期开发速度 2. 显式依赖 隐式魔法 3. 先跑通再优化但接口边界要提前定 ## 技术偏好 - 后端偏好 Go反对过度分层 - 前端偏好轻量方案不轻易上重型框架 - 写文档先给结论再展开论证memory/long-term.md是长期记忆面板只放经过验证、反复用到的信息。memory/weekly.md是缓冲区每次会话结束往里追加周末再筛选提升。memory/blind-spots.md记录我反复犯的错比如“又忘了给外部调用加超时”。4. 可复制配置settings.json 与 config.toml 骨架Claude Code 的项目级配置放在.claude/settings.json我把它放在alter/.claude/下。骨架如下{ permissions: { allow: [ Read(./identity/**), Read(./memory/**), Read(./skills/**), Write(./memory/weekly.md), Write(./memory/blind-spots.md) ], deny: [ Read(./.env), Read(./secrets/**) ] }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api } }这里的关键是权限控制允许 Claude 读身份和记忆文件、允许它往weekly.md和blind-spots.md追加内容但禁止它碰.env和密钥目录。这样它既能维护记忆又不会误读敏感信息。如果你用的是支持config.toml的客户端或工具链可以这样写[api] base_url https://taotoken.net/api api_key_env ANTHROPIC_API_KEY [memory] root ~/alter entry_file CLAUDE.md auto_load [identity/who-am-i.md, memory/long-term.md] write_back [memory/weekly.md, memory/blind-spots.md] [model] name claude-opus max_tokens 8192api_key_env指向环境变量名而不是 Key 本身这样配置文件可以安全地放进版本控制。auto_load定义每次启动必读的文件write_back定义允许回写的文件。提示不同版本的 Claude Code 配置字段可能略有差异以你本地claude --help和官方文档为准。上面这份骨架的重点是“读写分离 权限最小化”这个思路字段名可以按实际调整。5. 一次写入与召回验证确认它真的记住了配置写完不算完要验证“写入”和“召回”两个动作都通。我用的验证方法很土但有效。第一步启动 Claude Code 并进入记忆库目录cd ~/alter claude第二步发一条测试指令让它往记忆里写东西请把这条信息追加到 memory/weekly.md - 2025-06-10 测试记忆写入我偏好用表驱动测试而不是一堆 if。 打星 4 星。第三步退出会话重新进入然后问它根据你加载的记忆我偏好用什么方式写测试如果它回答“表驱动测试”说明写入和召回都通了。如果它答不上来检查三件事CLAUDE.md里有没有把weekly.md列进加载范围、settings.json的allow里有没有写权限、文件路径是不是相对项目根目录。第四步验证按需加载。发一条写文章的指令帮我写一段关于 API 网关的技术说明按我的风格来。观察它有没有去读identity/style.md。如果读到了输出会明显带上你的表达习惯比如先给结论、少用形容词。这一步通了说明“按任务加载”的机制生效了。实测下来整个验证流程十分钟内能跑完。跑通之后你每次开新会话都不用再交代背景Agent 会自己把该读的读了。6. 本篇常见错排查报错一ANTHROPIC_BASE_URL没生效请求还是打到默认地址。原因通常是环境变量写在 shell 配置里但没重新加载。执行source ~/.zshrc或重开终端。用echo $ANTHROPIC_BASE_URL确认输出是https://taotoken.net/api。报错二Claude 读不到记忆文件说“文件不存在”。检查CLAUDE.md里的路径是不是相对项目根目录。如果你在~/alter下启动路径写identity/who-am-i.md是对的写绝对路径~/alter/identity/...有时会因为~展开问题失败建议统一用相对路径。报错三写入被拒绝提示权限不足。settings.json的allow列表里要显式包含Write(./memory/weekly.md)。注意路径写法要和实际调用一致./memory/weekly.md和memory/weekly.md在某些版本里会被当成不同规则。报错四记忆越写越乱召回时答非所问。这是没做分层导致的。weekly.md是缓冲区不要什么都往里塞每周花十分钟把高星条目提升到long-term.md低星的删掉。长期记忆面板保持精简召回准确率才高。报错五Key 泄露风险。再强调一次Key 只放环境变量。settings.json里只写base_url不写 Key。如果怀疑泄露去控制台重新生成一个旧的立即失效。排障相关的入口我一般直接放两个接入和 Key 管理走 API Keys 页面配置文档走接入文档页面这两个在控制台导航里都能直接点到。7. 把“懂我”变成可复现的流程这套东西跑通之后最大的变化不是 AI 变聪明了而是我不用再重复交代自己。新开一个会话它自动加载身份和长期记忆写文章时自动切到风格档案做技术决策时自动带上我的优先级排序。整个过程没有魔法就是目录结构加配置文件加读写权限。如果你今天就想动手最小可行版本只需要三个文件一个CLAUDE.md写加载规则一个identity/who-am-i.md写你是谁一个memory/weekly.md当缓冲区。先把这三个跑通再逐步加技能包和盲区记录。通道这边用 TaoToken 统一 Key配置一次后面所有会话都省事。长期做编码和 Agent 任务的话建议把额度管理也纳入进来用 Coding Plan 统一规划避免多个工具各管各的。模型验证和日常对话则可以直接在模型对话页面完成。把通道、记忆、技能三件事分开管系统才稳。