CodeBuddy在VS Code中需依次完成安装、登录授权、工作区绑定三步才能启用AI功能：先通过扩展市场（或vsix/命令行）安装并重启；再微信或腾讯云账号登录，完成角色选择与系统权限授权；最后通过“文件→打开文件夹”绑定项目根目录，并验证目录树识别。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy VS Code 插件集成不难，但关键步骤缺一不可——安装只是起点，登录、工作区绑定和权限确认才是功能生效的核心。下面按实际使用顺序，把每一步说清楚。
安装插件（三种方式任选其一）
推荐优先用扩展市场安装，稳定且自动适配：
- 打开 VS Code，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）进入扩展面板
- 搜索 腾讯云代码助手 或 CodeBuddy，认准发布者是 Tencent Cloud，图标为螃蟹或虾形
- 点击“安装”，完成后点击弹出的 Reload 按钮，或手动重启 VS Code
如网络受限，可改用 .vsix 手动安装：
- 去腾讯云 CodeBuddy 官网下载最新
.vsix文件（如codebuddy-2.12.0.vsix） - VS Code 中按 Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中文件 → 点击“重新加载”
批量部署或 CI/CD 场景可用命令行：
- 终端执行
code --install-extension tencent-cloud.codebuddy - 成功提示后，运行
code --force-reload或重启编辑器
登录并完成授权
插件装完不会自动启用 AI 功能，必须登录并授予权限：
- 点击左侧活动栏的 CodeBuddy 图标（螃蟹/虾形），打开侧边栏
- 点击“登录”，选择微信扫码或腾讯云账号密码方式完成认证
- 首次登录会触发 Onboarding 流程：选择角色（如前端/Java工程师）、工作偏好，系统自动生成
IDENTITY.md和USER.md - 遇到系统弹窗（如 macOS “安全性与隐私” 或 Windows 文件访问提示），务必点“允许”——否则无法读取项目代码
绑定工作区并验证上下文感知
CodeBuddy 的智能补全、工程理解（@Codebase）、多文件重构等功能，全部依赖正确识别项目结构：
- 用菜单栏 文件 → 打开文件夹，选择完整项目根目录（含
package.json、src/、pom.xml等标志性文件） - 打开 CodeBuddy 面板，输入 “帮我看看当前项目结构”
- 若返回清晰的目录树，说明绑定成功；若提示“未检测到有效工作区”，点击对话框右上角 “? 选择文件夹” 手动指定路径
检查基础配置与常见问题
功能仍无响应？重点排查这几项：
- VS Code 版本需 ≥1.60.0（建议更新至最新稳定版，如 1.84+）
- Node.js ≥14.0.0（部分 CLI 和本地分析功能依赖）
- 网络需能访问腾讯云服务域名，企业内网用户需配置代理或白名单
- 若状态栏无“已登录”提示，或图标灰显，可按 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools 查看 Console 是否有拦截或报错
