CodeBuddy 最大限度减少 Token 消耗（腾讯云 CodeBuddy）
核心原理：Token 最大开销来自上下文，每一轮请求都会带上全部历史对话+引用文件；减少无效上下文、精准引用、拆分任务是最有效的手段。
内置命令：
/cost查看当前token；/compact压缩历史；/clear新建会话；/rename会话命名；/resume恢复会话
一、会话上下文管理（收益最大）
- 不同任务，新开会话
/clear
无关任务不要放在同一个对话。比如：A模块开发完成，做B模块、写文档、查bug，直接/clear。
长会话每轮都会把所有历史全部计入输入token；跨任务残留旧上下文会持续扣费。
需要回溯前：先/rename命名，再/clear，后续/resume恢复。 - 长对话定期执行
/compact
连续对话20～30轮执行一次压缩；可自定义压缩保留重点：
/compact 只保留代码变更、关键决策，丢弃调试日志、失败试错记录compact会把冗长历史压缩成摘要，大幅降低后续每轮输入token，实测可降低50%+消耗。
- 及时止损，不要堆积失败试错
一旦AI方向跑偏，不要继续反复提问修正；直接/compact或新开会话。所有失败调试、错误输出都会永久留在上下文持续消耗token。
二、文件引用优化（最容易浪费token）
不要粘贴大段代码进对话框，优先使用@引用，但只引用最小必要范围
✅ 推荐：@src/xxx.ts:10-45 只引用指定文件的指定行/函数
❌ 禁止：@src 引用整个目录，一次性载入成千上万个token
注意：
@引用文件后，文件内容会保留在当前会话上下文，不需要每条消息重复@。
三、提示词精简 & 控制输出（减少输入+输出token）
- 去掉客套、冗余描述，一句话明确：目标 + 约束 + 输出格式
- 差：帮我优化这个代码，看看有没有问题
- 好：优化这个函数，修复空指针，只输出修改后的代码，不加解释
- 强制限制输出长度，减少昂贵的输出token（输出token成本更高）
示例结尾追加：只输出代码diff，不写多余说明，不复述需求 - 项目配置文件 CODEBUDDY.md 精简
CODEBUDDY.md 每次对话都会加载，删掉过时、非必要规则，只保留项目强制规范，不要写长篇大论。
四、模型与任务分层策略
- 简单任务（解释代码、生成简单注释、格式化、查询）：选用轻量模型，不要一直用最高规格模型
- 复杂任务（跨文件重构、疑难bug、架构设计）：才使用高阶模型
原则：贵模型只用来做推理，读文件、日志检索这类粗活交给轻量模型
五、工具调用与命令输出降噪
- 尽量减少自动执行大量shell命令，
git log、test、构建日志这类超长终端输出，一旦进入上下文，后续每轮都带着。 - 让AI执行命令时，增加约束：命令结果只保留错误摘要，不输出完整原始日志。
- 不需要的工具（文件搜索、终端），在MCP配置中按需关闭，减少工具描述带来的固定上下文开销。
六、工作流优化，减少来回迭代
- 先规划，再写代码：先让AI输出方案，确认方案没问题，再让它修改代码。避免写完再反复返工，每一轮返工都会新增token。
- 任务拆解：大需求拆成多个小独立任务，每个子任务单独会话，完成即关闭。
- 复用本地工具：格式化、lint、单元测试这类确定性操作，优先本地脚本执行，不要交给AI反复处理。
七、快速自检清单（执行前检查）
- 是否复用旧会话处理无关任务？→
/clear - 是否@整个文件夹/大文件？→ 修改为
文件:行号片段引用 - 对话轮次超过20轮？→
/compact - 提示词是否有大量客套、冗余描述？→ 精简，限制输出
- CODEBUDDY.md 是否臃肿？→ 删减无用规则
- 是否一直使用最高规格模型处理简单查询？→ 切换轻量模型
效果参考
- 同任务分散多会话：相比单会话一直聊，总token可降低约70%
- 定期compact：长对话后续每轮token可从数万降至数千
- 精准片段引用：相比全文件引用，文件相关token减少80%+
如果你需要，我可以给你一份可直接复制的CODEBUDDY.md精简模板，专门用于最小化上下文开销，同时约束AI输出简短。
CODEBUDDY.md（极简版，最小Token开销，直接复制）
放在项目根目录，全文尽量短，每轮对话都会加载本文件，只保留硬性约束，删除所有废话。
# CODEBUDDY.md｜极简规则（控制Token，简短输出）
## 核心输出约束（最高优先级）
1. 优先输出代码、diff，**文字解释尽量简短**；非必要不加前言、总结、客套话。
2. 代码修改：优先git diff片段；需要完整代码时只输出目标函数/文件片段，不输出全文件。
3. 回答结构：结论先行，控制文字长度；无特殊要求不做长篇原理讲解。
4. 日志/命令输出：只返回错误摘要，禁止打印完整原始长日志。
## 上下文&引用规则（降Token）
1. 文件引用：仅使用`file:start-end`片段引用，禁止引用整个目录/完整大文件。
2. 不要自动加载无关文件；仅读取用户明确指定的文件范围。
3. 对话膨胀时，主动建议 `/compact` 压缩历史；任务结束建议 `/clear` 新建会话。
## 代码规范（只保留项目硬性规则，按需删减）
- 缩进：2空格
- 行宽：≤100字符
- 优先const；命名小驼峰
> 👉 把上面3条替换成你项目真实规范，**不要额外扩展描述**
## 工具使用
- shell：长输出自动截断摘要；大批量文件检索前先确认必要性。
- 不主动扫描整个项目目录，除非用户明确要求。
## 内置命令备忘（极简）
- `/cost`：查看当前token
- `/compact`：压缩对话历史
- `/clear`：新建会话
- `/resume`：恢复历史会话配套使用建议（进一步压Token）
- 按需裁剪：代码规范部分，如果项目规范很少，直接删掉代码规范区块，越短越好。
- 不要追加长篇项目背景、架构介绍到这个文件里，架构背景放到单独文档，不要写进CODEBUDDY.md。
- 多包/monorepo：根目录放这份极简模板，子目录可以放单独更短的CODEBUDDY.md，子目录规则会局部覆盖。
- 测试：粘贴进项目后，新开对话，执行
/cost，看本文件带来的基础token占用，越短越好。
超精简压缩版（适合极小项目，token极致压缩）
# CODEBUDDY.md
## 输出规则
1. 优先diff/代码片段，文字简短；无要求不写多余解释。
2. 只输出修改部分，避免完整大文件。
3. 长命令日志仅摘要，禁止原始完整输出。
## 文件引用
仅@文件:行范围，禁止引用整个目录。不要自动读取无关文件。
## 代码规范
缩进2空格，行宽≤100，const优先。
## 命令
/cost 查看token；/compact 压缩会话；/clear 新建会话。如果想要再砍一半字符，用这个版本：
# CODEBUDDY.md
## 输出规则
1. 优先diff/代码片段，文字简短；无要求不写多余解释。
2. 只输出修改部分，避免完整大文件。
3. 长命令日志仅摘要，禁止原始完整输出。
## 文件引用
仅@文件:行范围，禁止引用整个目录。不要自动读取无关文件。
## 代码规范
缩进2空格，行宽≤100，const优先。
## 命令
/cost 查看token；/compact 压缩会话；/clear 新建会话。你想要我顺便给一个每次提问时追加的一行简短后缀提示词模板吗？加到每条消息末尾，强制AI继续压缩输出。
CodeBuddy 性能优化（不含上下文Token压缩）
核心思路：减少模型不必要的工具调用、降低文件扫描开销、模型分层调度、减少等待/确认弹窗、利用LSP代码智能，缩短首token响应、减少来回轮次、降低工具调用耗时。
1. MCP工具精简（性能收益非常明显）
MCP服务会把全部工具定义加载进模型，哪怕闲置，既拖慢首token，也增加开销。
- 执行
/mcp查看全部MCP服务，禁用所有当前项目不需要的MCP Server。不要一次性挂载一堆MCP（浏览器、爬虫、数据库等）。 - 优先直接调用CLI命令（git、jq、npm），尽量替代MCP工具，CLI没有持久化工具定义开销。
- 控制MCP输出上限：利用内置分段读取机制，MCP返回超大内容时，让模型使用offset/limit分段读取，避免一次性拉取巨量结果。
- 单任务只启用最少MCP；多项目分开MCP配置，不要全局挂载全部工具。
验证：关掉多余MCP后，首token延迟通常会明显下降。
2. 接入LSP代码智能插件，减少海量文件扫描（大仓库首选）
大项目最耗性能的动作：AI反复grep、遍历目录、批量读取文件来找符号定义/调用链。
- 安装对应语言LSP插件：
/plugin install typescript-lsp/ python / go / rust LSP插件 - LSP直接提供符号跳转、引用查找、类型检查，替代AI暴力扫描文件，大幅减少
read工具调用次数。 - 配合文件读取黑名单：在项目配置设置
deny规则，屏蔽node_modules、dist、build、日志、缓存目录，禁止AI读取这些文件夹。
适合monorepo、大型后端/前端仓库，减少大量无效文件IO。
3. 模型分层调度（按需选择模型，避免大模型做简单任务）
使用 /model 动态切换模型，不同任务绑定不同模型，减少推理耗时：
lite轻量模型：代码检索、grep查找、格式化、简单查询、读取文件摘要（速度快，延迟低）reasoning高阶推理模型：架构设计、疑难bug、复杂重构、多文件逻辑修改（仅复杂任务启用）- 子代理模型配置：
/agents单独配置Explore这类子代理默认使用lite模型做代码检索，不要全部子代理都跑重型模型。
4. 权限与确认弹窗优化（减少人工打断等待）
大量弹窗确认会打断流程，拉长端到端耗时：
- 设置安全白名单：把常用命令（
lint、test、git操作）加入allowlist，自动放行。 - 安全沙箱/
-y自动确认：可信本地开发环境，使用-y跳过低风险命令确认（高危命令依然会拦截），省去每一步人工点击确认等待。 - 不要开启L5全自动权限在陌生项目，容易触发大量失控工具调用，反而卡死会话。
5. 工作流优化：Plan模式 + 及时终止错误方向，减少无效轮次
- Plan模式（Shift+Tab）：大型重构/多文件修改，先进入plan模式让AI输出方案，确认方案正确再执行代码修改。避免AI直接动手改错，反复多轮返工，大量浪费工具调用和推理时间。
- 及时中断：一旦AI方向跑偏，立刻按
Esc终止当前生成，使用/rewind回退会话到上一个检查点，不要继续在错误路径继续对话。 - 任务边界：大任务拆成独立子任务，每个子任务完成后提交变更，不要一次性要求跨几十个文件一次性重构。
6. 本地环境与资源调优（CLI客户端）
针对CodeBuddy Code本地客户端：
- Node内存上限：处理超大项目时，调高Node堆内存
NODE_OPTIONS=--max-old-space-size=8192 codebuddy- 环境变量控制输出上限：
CODEBUDDY_CODE_MAX_OUTPUT_TOKENS # 全局最大输出token
CODEBUDDY_CODE_FILE_READ_MAX_OUTPUT_TOKENS # 文件读取上限- 网络：优先稳定低延迟网络；网络差会导致流式输出卡顿、超时重试。
- 磁盘：项目放在SSD；大量文件读取在机械硬盘会明显拖慢工具响应。
7. 文件系统访问规则：禁止自动全盘遍历
禁止自动递归扫描整个项目目录；查找文件前先询问用户，仅在用户明确授权后才检索指定目录。
忽略 node_modules, dist, build, .git, logs, vendor 目录。在CODEBUDDY.md增加这一条（加到之前的模板）：
禁止自动递归扫描整个项目目录；查找文件前先询问用户，仅在用户明确授权后才检索指定目录。
忽略 node_modules, dist, build, .git, logs, vendor 目录。防止AI自动执行find、ls -R这类全目录扫描，这是大仓库性能杀手。
8. 工具调用行为约束（减少不必要调用）
提示词/CODEBUDDY.md追加规则：
- 优先使用已有符号信息（LSP），优先使用精准符号查询，而不是全文搜索。
- 每次工具调用前评估必要性，禁止连续无意义的多次read/grep。
- shell命令输出默认做摘要，不要返回完整原始日志；长输出用jq做过滤，精简结果。
快速优化检查清单
/mcp：清理全部闲置MCP服务- 安装对应语言LSP插件（大仓库必做）
- 配置文件黑名单，屏蔽构建/依赖目录
- 子代理设置lite模型做代码检索
- 常用命令加入权限白名单，减少弹窗
- 复杂任务先用Plan模式评审方案
- 禁用自动全盘文件遍历
如果你需要，我可以把LSP、MCP白名单、目录黑名单规则直接合并进前面那份极简CODEBUDDY.md模板。