codebuddy本地长期记忆需在项目根目录生成.codebuddy/文件夹,通过手动创建.memory/memory.md或执行/memory init初始化,支持硬规则、日期日志和斜杠命令三种记忆写入方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让CodeBuddy记住你的项目背景、协作习惯和历史决策,避免每次新开会话都要重复交代,直接在本地项目中启用它的长期记忆系统即可。
确认CodeBuddy已安装并进入项目目录
打开终端,cd进入你的项目根目录,确保该目录下已安装CodeBuddy CLI——运行codebuddy --version能正常输出版本号。若未安装,请先执行npm install -g @tencent-ai/codebuddy-code。
首次在该项目中运行codebuddy命令,完成微信或GitHub登录后,系统会自动在项目根目录生成.codebuddy/文件夹。这一步不可跳过,【没有该文件夹,后续所有记忆功能均无法生效】。
启用本地长期记忆的两种方式
方法一:手动创建记忆文件结构
在项目根目录下,依次执行以下命令:
mkdir -p .codebuddy/memory → touch .codebuddy/MEMORY.md → echo "# 项目通用记忆" > .codebuddy/MEMORY.md
此时.codebuddy/MEMORY.md将成为AI每次启动时必读的“项目画像”文件,用于存放技术栈偏好、代码风格要求、关键约束等永久性信息。
方法二:使用CLI内置命令快速初始化
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 问题
在CodeBuddy交互界面中输入/memory init,回车。系统将自动创建.codebuddy/rules/memory-system/RULE.mdc和.codebuddy/memory/MEMORY.md,并写入基础模板。
注意:/memory init仅在首次运行时生成空结构,不会覆盖已有内容;若已存在MEMORY.md,它会跳过写入。
日常使用记忆的三类操作路径
第一步:向MEMORY.md添加硬规则
用编辑器打开.codebuddy/MEMORY.md,直接写入你希望AI永远遵守的信息,例如:
“所有注释必须用中文”
“禁止生成console.log调试语句”
“接口请求统一走/src/utils/request.ts封装”。
第二步:按日期记录临时决策
每天工作结束后,在.codebuddy/memory/下新建一个YYYY-MM-DD.md文件(如2026-07-02.md),记录当天讨论过的架构选型、踩坑过程或待跟进事项。CodeBuddy会在次日启动时自动加载最新日期文件。
第三步:用斜杠命令即时写入
在对话中随时输入/memory write "今天确认放弃Webpack,改用Vite做构建",这条记录会立即追加到当日日期文件末尾,无需手动保存。










