Claude Subconscious记忆块定制全解如何设计自己的8格记忆架构【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude Subconscious 是一款为 Claude Code 打造潜意识记忆层的开源插件它让一个后台智能体持续观察你的编码会话、阅读代码库并把学到的经验沉淀成 8 个记忆块memory blocks在每次提示前悄悄低语回传给你。本文带你拆解这套8格记忆架构的完整设计并手把手教你定制属于自己的记忆块体系。一、为什么需要记忆块Claude Code 在会话之间会失忆——每次新对话都要重新解释项目背景、代码风格和注意事项。Claude Subconscious 的思路是不修改 CLAUDE.md而是让一个独立的 Letta 后台智能体在旁监听观察每次响应后完整会话记录transcript异步发送给后台智能体学习智能体用 Read/Grep/Glob 阅读代码库提取你的偏好与项目上下文回传下次提示前把记忆块或建议消息注入 Claude 的上下文这套机制由 4 个 Claude Code hooks 驱动注册配置在 hooks/hooks.json对应脚本位于 scripts/ 目录。二、默认 8 格记忆架构全解析开箱即用插件时会自动导入一个名为 Subconscious 的默认智能体完整定义见 Subconscious.af。它维护着 8 个记忆块构成8格记忆记忆块用途容量上限core_directives角色定义与行为准则观察什么、如何沟通5000 字符guidance给下一个会话的低语建议唯一直接面向 Claude 的块3000 字符user_preferences学到的编码风格、工具偏好、沟通风格3000 字符project_context代码库知识、架构决策、已知坑点3000 字符session_patterns重复行为、时间规律、常见卡点3000 字符pending_items未完成工作、显式 TODO、待跟进项3000 字符self_improvement记忆架构自我演进的规则何时拆分/合并块5000 字符tool_guidelines可用工具的使用手册memory、文件、搜索5000 字符 可以把它理解成三类格子大脑区core_directives/self_improvement/tool_guidelines——规定智能体怎么想经验区user_preferences/project_context/session_patterns/pending_items——沉淀学到了什么传声筒guidance——唯一会主动开口说话的格子三、记忆块如何同步给 Claude记忆块不会写入任何磁盘文件而是通过 stdout 注入提示上下文由 scripts/sync_letta_memory.ts 在每次提示前完成同步whisper 模式默认只回传智能体的消息轻量无侵入full 模式首次提示注入全部 8 个记忆块之后仅展示变更 diff见 detectChangedBlocks 的变更检测逻辑小贴士用LETTA_MODE环境变量切换模式设为off可一键暂停注入。四、如何设计自己的 8 格记忆架构想定制核心原则就藏在默认智能体的self_improvement块里Subconscious.af 中可完整看到这也是官方验证过的架构设计说明书。1. 两条硬性红线记忆文件总数≤ 12 个默认 8 格最多再新增 4 格所有记忆块总字符数≤ 30,0002. 四个设计心法小格子优于大格子改动过的块会被注入 Claude 提示词块太大就变成噪音一格一主题一个块只装一个关注点能一眼读完才算合格先更新、后新建新偏好先塞进现有块实在装不下才开新格定期瘦身连续 10 个会话没用到、或 30 天以上过期的内容果断删3. 何时开新格何时合并场景动作同时维护多个独立项目为每个项目开专属的project_context子块某主题反复出现测试、部署、特定框架拆出专属记忆块某块只剩不到 3 行内容并入相关块两个块内容大量重叠合并为一个4. 一键切换到你的定制 Agent把你自定义的智能体 ID 设为环境变量插件就会用它替代默认 8 格架构export LETTA_API_KEYyour-api-key export LETTA_AGENT_IDagent-你的智能体ID export LETTA_MODEfull # 可选注入完整记忆块智能体解析顺序为环境变量 → 本地已存配置~/.letta/claude-subconscious/config.json→ 自动导入默认 Subconscious。也就是说只配 API Key 即可零配置起步之后随时可以换成自己的架构。五、定制效果速查清单guidance 写具体情报而非空话如auth 模块 token 刷新有竞态而不是记得完成工作多个会话共享同一智能体时不要在会话开始就清空 guidance偏好信号分级显式声明 纠正行为 隐式习惯后者需观察确认让 Claude Code 直接点名后台智能体对话它会回应——这是双向沟通不是单向监控六、关键文件索引文件说明Subconscious.af默认 Subconscious 智能体完整定义8 格记忆 7 个工具scripts/sync_letta_memory.ts记忆块同步与 diff 注入核心逻辑scripts/session_start.ts会话开始时创建/复用对话线程scripts/send_messages_to_letta.ts响应结束后异步发送 transcripthooks/hooks.json四个 hooks 的注册配置提示本项目为演示性质生产环境建议使用官方 Letta Code。想从源码安装可执行git clone https://gitcode.com/GitHub_Trending/cl/claude-subconscious进入目录后运行/plugin enable .启用插件。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考