CodeBuddy 插件安装与配置实战

昨天定了型：主线工具 CodeBuddy，插件端打底。今天只干一件事——把它装好、配好、跑通第一次补全。全程不需要代理、不需要境外账号，国内网络直达，这是选它当主线的第一红利。

本篇是纯操作篇，按"前置 → 安装 → 登录 → 首次使用 → 设置 → 排查"的顺序走，每一步都有明确的完成标志。装完大约 15 分钟，建议现在就打开 IDE 跟着做。

一、前置条件：三件事先备齐

注意版本门槛：IDE 版本太旧是"插件装不上/装上不显示"的第一大原因。先在 IDE 的"关于"里确认版本号，不满足就先升级，再往下走。

二、安装插件：各 IDE 的入口

主流 IDE 都是"插件市场一键装"，几分钟的事：

1. VS Code
   ：扩展市场（Ctrl+Shift+X）搜索 CodeBuddy → 点安装 → 装完左侧活动栏出现 CodeBuddy 图标
2. JetBrains 系列
   （IDEA / WebStorm / PyCharm 等）：Settings → Plugins → Marketplace 搜索 CodeBuddy → 安装后重启 IDE
3. Visual Studio 2022
   ：扩展 → 管理扩展 → 搜索安装；微信开发者工具、Xcode 在各自扩展入口搜索

完成标志：侧边栏出现 CodeBuddy 面板图标。注意各家插件市场重名插件多，认准腾讯云官方出品（发布者与图标），别装到山寨货。

三、登录认证：个人版与企业版

点开 CodeBuddy 面板，会引导你登录：

• 个人版
  ：跳转浏览器用腾讯云账号授权登录，回 IDE 即显示已登录状态。免费可用。
• 企业版
  ：由企业管理员在企业控制台分配席位后，用企业统一的登录方式认证；员工无需自己购买。

两个确认点：① 账号串号——如果你有多个腾讯云账号，登录时确认用的是你想要的那一个；② 企业席位——企业用户若登录后提示无权限，多半是席位还没分配到你，找管理员开通。

四、三件武器 + Craft 初体验

1. 代码补全：快捷键表

第一次验证：新建一个文件，写一行带语义的注释（比如 // 校验手机号格式，不合法抛出参数异常），回车换行，等 1-2 秒出现灰色建议，按 Tab 采纳。这一刻起，AI 已经在为你写代码了。

2. 侧边栏对话（Ask）+ @ 引用

侧边栏面板里直接用自然语言提问。关键技巧是 @ 引用——把上下文精确地喂给它，而不是靠它猜：

@ 引用速查卡：
@workspace｜整个工程作为上下文（"@workspace 收货确认的入口在哪个文件？"）
@file｜指定文件（"@file OrderService.java 解释这个类"）
@git｜版本库信息（变更、提交记录相关的问题）
@docs｜文档检索
@terminal｜终端内容（把报错直接给它）
@problems｜当前 IDE 报错面板的问题

3. 六个必试斜杠命令

对话输入框里打 / 会弹出命令列表，这六个最常用：

4. Craft 智能体初体验

插件端同样内置了 Craft 智能体：把需求用自然语言说清楚，它会自主搜索代码库、规划改动、一次修改多个文件，改完列出变更清单让你确认。第一次体验建议选一个低风险任务，比如"给这个服务类补充日志埋点"，感受它从"补全器"到"执行者"的变化。

Craft 的每次文件修改都会列出 diff 等你确认——确认这一步永远不要省。它执行的是改动，你拍板的是合入。这个习惯从第一天就养成。

五、常用设置项

装完先做四项个性化设置（都在插件设置面板里）：

• 补全开关
  ：全局开关 + 按语言禁用（比如生成类代码、涉密文件所在语言建议关掉）
• 快捷键自定义
  ：与个人已有键位冲突时（尤其 Ctrl+→ 这类编辑键），在 IDE 键位设置里改绑
• 模型切换
  ：混元为主，可在 DeepSeek、GLM、Kimi、MiniMax 等模型间切换，不同任务各有手感
• 对话上下文控制
  ：对话默认带多大范围的上下文，可按需收窄，既提速又减敏感面

六、常见问题排查

七、企业合规提示

上线团队级使用前，三件事拿书面结论：

1. 确认上传范围
   ：与 IT / 安全部门确认公司政策——哪些代码允许提交给云端服务、哪些必须本地处理。个人开发随意，企业使用必须过这一关。
2. 敏感信息脱敏
   ：密钥、内网地址、客户数据，永远不进对话和代码上下文。这条红线与工具无关，与习惯有关。
3. 企业版能力
   ：如果合规要求高，CodeBuddy 企业版支持私有化离线部署、本地模型推理（源码不出机房），具体方案与报价找官方商务确认。

八、15 分钟上手清单

15 分钟上手清单：
□ 确认 IDE 版本 ≥ 最低要求（VS Code 1.82+ / IDEA 2022.2+ / VS 2022 17.0+）
□ 插件市场安装 CodeBuddy，侧边栏出现面板图标
□ 登录腾讯云账号（个人版免费），确认登录状态
□ 写注释 → Tab 采纳第一条补全建议
□ 用 @workspace 问一个"项目里 XX 功能在哪"的问题
□ 试 /explain /fix /tests /comments /name-var /cr 六个命令各一次
□ 用 Craft 跑一个低风险小任务，review 它的 diff

明天 Day 28：《CodeBuddy IDE 与 Craft 智能体实战》——从插件进阶到 AI 原生编辑器，NES、多模型、Figma 转代码都安排上。