在日常使用中，除了功能异常，开发者最常遇到的是配置未生效或额度受限的情况。以下列出高频场景及对应的排查思路。
模型切换提示"当前不可用"或"无权限"
若你在模型选择列表中看到目标模型置灰或切换后报错，通常有两类原因：一是该模型仅面向企业版或特定订阅档位开放，个人免费/基础版账号无法使用；二是企业管理员在后台锁定了可用模型白名单。此时请检查当前账号的订阅状态，或联系团队管理员确认权限范围。个人用户如需使用，可在官网升级至对应档位。
额度耗尽或请求频率受限
当侧边栏提示"今日额度已用完"或"请求过于频繁，请稍后再试"时，说明已触发当前账号的日/月调用上限。CodeBuddy 的额度通常按模型类型分别计算，极速模型与深度模型的消耗系数不同。处理方式：
- 降低调用频率，减少反复重试同一请求；
- 在 设置 > 账号与订阅（或官网个人中心）查看额度明细与重置时间；
- 企业用户请联系管理员确认团队共享池额度是否充足，或申请临时扩容。
配置多端不同步
桌面端与 VS Code 插件端共用账号体系，但部分本地级设置（如编辑器字体、快捷键绑定、本地缓存路径）默认保存在当前设备，不会自动同步。若换电脑后发现模型选择、生成语言等云端偏好未同步，尝试在设置面板手动点击 "立即同步" 或退出账号重新登录。若始终异常，检查客户端版本是否为最新，旧版本可能存在同步协议兼容问题。
团队规范（@规则）未生效
引入团队编码规范后，生成的代码仍未遵循既定格式，通常是因为：规范文件语法有误导致解析失败；或当前项目未正确绑定规范文件路径。请确认 @规则 引用的文件路径无误，且文件内容符合工具要求的格式（如 JSON/YAML 标准）。企业版用户还需确认管理员是否开启了"强制覆盖"选项，否则个人设置中的某些偏好可能会与团队规范产生冲突。
快捷键冲突
若 CodeBuddy 的默认快捷键（如 Tab 采纳补全、Alt+\ 手动触发）与系统中其他软件（如输入法、截图工具、IDE 自身插件）冲突，会导致功能间歇性失灵。进入 设置 > 快捷键配置，将冲突的按键修改为其他组合，或在操作系统层面排查占用该快捷键的全局应用。
自定义指令/快捷短语丢失
在 设置 > 常用指令快捷短语 中保存的自定义模板若突然消失，一般是由于本地配置目录权限变更或磁盘清理工具误删缓存。建议定期将高频指令导出为文本备份，或在企业版中利用团队共享指令库，避免依赖本地单一存储。