必须安装腾讯云 codebuddy 插件到 vs code 才能使用 ai 补全、代码解释、错误诊断等功能；推荐通过扩展市场在线安装，或离线安装 .vsix 文件，安装后需登录腾讯云账号并完成实名认证方可启用全部功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把腾讯云 CodeBuddy 插件装进 VS Code 里，才能在编辑器内直接调用 AI 补全、代码解释、错误诊断等核心功能，而不是只能用网页版或独立 IDE。
通过扩展市场在线安装
这是最常用、最稳妥的方式，适合绝大多数开发者，无需下载文件，全程自动适配当前 VS Code 版本。
1、启动 VS Code，确保已联网且版本不低于 1.84（旧版本可能无法加载插件图标）。
2、按下 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS），打开扩展面板。
3、在搜索框中输入 腾讯云代码助手 或 CodeBuddy，确认发布者为 Tencent Cloud，图标是螃蟹或虾形标识——不是“Code Buddy”“CodeBuddy AI”等仿冒名称。
4、点击右侧的 Install 按钮，状态变为 “Installing…” 后自动切换为 “Reload Required”。
5、点击弹出的 Reload 按钮；若未弹窗，手动关闭并重新打开 VS Code。
手动安装 .vsix 文件（离线/内网适用）
当公司网络屏蔽扩展市场、代理策略严格，或需批量部署到无外网环境时，必须用此法。
方法一：从腾讯云官网下载签名包
访问腾讯云 CodeBuddy 官方发布页，下载最新版 .vsix 文件（文件名含版本号与平台标识，如 codebuddy-2.12.0.vsix）。
方法二：在 VS Code 中安装
按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板 → 输入并选择 Extensions: Install from VSIX… → 定位并选中已下载的 .vsix 文件 → 点击 Install。
安装完成后，VS Code 会提示 “Reload Window”，必须点击该按钮，否则插件不会激活。
配置登录与授权
插件装完只是第一步，不登录就无法调用云端模型服务，所有 AI 功能将显示“未授权”或直接灰显。
第一步：点击 VS Code 左侧活动栏中的 螃蟹或机器人图标（CodeBuddy 图标），打开插件侧边栏。
第二步：在侧边栏顶部点击 “登录”，选择微信扫码或腾讯云账号登录；必须完成实名认证，否则部分高级功能（如 MCP 调用、私有模型绑定）会被拦截。
第三步：手机端确认授权后，VS Code 状态栏右下角会显示 “已登录” 及你的昵称，图标旁出现绿色小点——此时插件进入就绪状态。
验证是否安装成功
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 CodeBuddy，能看到至少 5 条以 “CodeBuddy:” 开头的命令（如 “CodeBuddy: Ask AI”、“CodeBuddy: Explain Selection”）。
选中任意一条执行，若弹出对话框或底部状态栏出现加载动画，说明插件已正常注册并可响应指令。
