CodeBuddy用户规则配置详解：从入门到验证，让AI写代码更听话

CodeBuddy 这套 AI 编程工具，网上教程不少，但真正决定 AI 写出来的代码合不合你用、合不合团队规范的，不是模型本身，而是用户规则。这篇文章就把 CodeBuddy 的“创建用户规则”讲透：入口在哪、规则文件怎么写、用户级和项目级规则怎么选、优先级怎么排、怎么验证规则真的生效。与此同时，顺手把搜索里频率最高的几个问题一起解决：CodeBuddy 和 WorkBuddy 有什么区别、IDEA 里怎么配置 CodeBuddy、本地 vLLM 部署 Qwen3 时 tool-call-parser 填什么、CodeBuddy 消耗积分太快怎么减少。

CodeBuddy 是腾讯出品的一整套 AI 编程 IDE / 助手生态，社区版基于 VS Code 内核做了开源化改造，同时提供 JetBrains 系列插件。功能覆盖代码补全、对话、Agent 多智能体编排、技能（Skill）和自定义模型接入。而用户规则（Agent Rules / User Rules）是这套能力里最容易被忽略、但性价比最高的配置：它相当于给 AI 写一份“岗位说明书”，让 AI 在生成代码之前先知道你的风格、约束和禁止项。

先说清楚谁适合看：第一种是已经装了 CodeBuddy，但觉得 AI 写代码“不够听话”的个人开发者；第二种是想在团队里统一编码规范、把代码审查和批量任务做成固定流程的工程团队。下面内容按“是什么、怎么装、怎么建规则、怎么验证、怎么排查”的顺序展开，争取看完就能跑通。

1. CodeBuddy 核心能力速览

先给一份规格速览，后面所有内容都能对上号。以下信息来自社区文档和常规使用路径，具体展示方式以你安装的版本为准。

这张表的重点是：CodeBuddy 不是一个“只能聊天”的插件，规则的优先级和批量能力是可以工程化的。后面的内容基本围绕这些能力展开。

2. CodeBuddy 用户规则到底解决什么问题

2.1 规则解决的不是模型能力，而是行为约束

如果只看代码补全，现在的模型已经很强了。但放到真实项目里，同一个 AI 在不同仓库里的行为应该完全不一样。前端项目要守 Vue 风格，后端要守 FastAPI 风格，提交信息要守 Conventional Commits，这些偏好如果每次靠手敲提示词，既不稳定也浪费积分。

用户规则就是把这类要求固化成文件。CodeBuddy 会把规则内容注入到 AI 的上下文里，AI 每次生成前先读规则再干活。规则可以约束命名、文件结构、代码风格、禁止写法、API 封装方式、Git 提交格式，甚至约束 AI 面对不确定需求时先提问还是先动手。

2.2 用户规则、项目规则、Agent 规则的区别

CodeBuddy 的规则体系一般分为三层：

• 用户规则（User Rules）：作用域是当前机器上的所有项目，适合放个人通用偏好，比如“所有 Python 代码都要写类型注解”。
• 项目规则（Project Rules）：作用域是当前仓库，适合放业务约定，比如“本项目用 Vue 3 + TypeScript，禁止引入 jQuery”。
• Agent 规则（Agent Rules）：跟随特定 Agent 角色，适合做代码审查、重构、写单测这类专项任务。

很多人只在聊天框里输入一次提示词就以为配置完了。实际上，提示词是临时的，规则是持久的。规则建好之后，每次新建会话都会自动加载，不用重复说明。

2.3 WorkBuddy 和 CodeBuddy 的区别与项目迁移

搜索里很多人问 CodeBuddy 和 WorkBuddy 的区别，以及 WorkBuddy 项目怎么迁移到 CodeBuddy。两者的具体差异建议以官方文档为准，这里只给一个稳妥的迁移思路：代码仓库本身不需要改动，但 WorkBuddy 里的规则、提示词、Agent 配置不能假设直接兼容。

迁移时逐项复制到 CodeBuddy 对应入口，不要整目录复制。复制完立刻新建会话验证规则是否加载；如果规则没生效，就按新版本的规则格式重建。最容易被忽略的是规则文件编码和文件名，旧文件如果是特殊编码，可能在加载时静默失败。

3. 适用场景与使用边界

CodeBuddy 用户规则最适合下面这些场景：

• 团队想统一编码规范，但不想靠人肉 Code Review 重复提醒。
• 个人维护多个项目，每个项目技术栈差异大，希望 AI 自动切换风格。
• 需要让