codebuddy通过本地.codebuddy/memories.md实现跨会话项目记忆,需手动创建目录与文件、严格按yaml+markdown格式书写,并用--doctor验证;支持提问引用、/config查看、rules约束及rsync同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

CodeBuddy支持跨会话保存项目知识,让AI记住你的技术栈、命名习惯、常用配置和历史决策,避免每次对话都重复说明项目背景。这种记忆能力不依赖云端账户同步,而是通过本地Memories机制实现,重启终端或切换项目后仍生效。
启用项目级记忆功能
第一步:在项目根目录创建.codebuddy文件夹
这一步必须手动完成,不能跳过。CodeBuddy不会自动创建该目录,若缺失则所有记忆配置将被忽略。
第二步:进入该目录,新建memories.md文件
文件名必须严格为memories.md,大小写敏感,且必须位于.codebuddy/下一级,否则无法加载。
第三步:在文件中按YAML+Markdown混合格式写入关键信息
【必须用YAML开头的---分隔符】,否则CodeBuddy解析失败。例如:
第四步:保存文件后,在任意终端执行codebuddy --doctor
检查输出中是否出现✓ Memories loaded from ./ .codebuddy/memories.md。未显示即配置未生效。
让AI主动调用已存记忆
方法一:在提问时明确引用
直接说“根据项目记忆,PostgreSQL连接池应该用HikariCP还是Druid?”——AI会自动匹配memories.md中tech_stack字段并给出针对性回答。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手,支持自然语言驱动开发。 - 必备触发词:CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景:安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二:使用/config指令动态查看当前加载的记忆
进入交互模式后输入/config→选择Memories→可实时看到已加载的键值对。这个操作能验证记忆是否被正确读取,也能快速定位拼写错误。
方法三:结合Rules强制约束输出风格
在.codebuddy/rules.md中添加规则:“所有SQL语句必须使用snake_case字段名”,AI会在生成代码时自动应用该规则,无需每次提醒。
跨设备同步记忆文件
1. 将整个.codebuddy/目录打包压缩
不要只同步memories.md,因为Rules、Skills、Commands等其他配置也存于该目录,缺失会导致行为不一致。
2. 通过U盘或局域网传输到目标机器
推荐使用rsync -avz .codebuddy/ user@remote:/path/to/project/.codebuddy/,保留权限和时间戳。
3. 在目标机器上执行codebuddy -c恢复最近会话
这一步会重新加载新同步的memories.md,但不会覆盖已有聊天记录。若需清空旧记忆,先运行/clear再重启会话。










