CodeBuddy在VS Code中未显示或无法登录，可按四步解决：一、通过扩展市场安装并扫码登录；二、手动安装.vsix包；三、启用CLI集成；四、配置自定义OpenAI兼容模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在 VS Code 中启用 CodeBuddy 的 AI 编程辅助功能，但插件未显示或无法登录，则可能是由于插件未正确安装、未启用，或授权流程中断。以下是完成安装与配置的多种可行路径：
一、通过 VS Code 扩展市场直接安装
该方法适用于所有操作系统，无需额外工具，依赖 VS Code 内置扩展管理器，安装过程全自动且可验证发布者身份。
1、启动 VS Code，确保已联网并处于最新稳定版（建议 1.84 及以上）。
2、按下 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS） 打开扩展面板。
3、在搜索框中输入 腾讯云代码助手 或 CodeBuddy，确认发布者为 Tencent Cloud。
4、点击“安装”按钮，等待状态变为“已安装”；安装完成后，重启 VS Code 以激活插件。
5、重启后，点击左侧活动栏中出现的 螃蟹或机器人图标（CodeBuddy 图标），打开插件面板。
6、在面板中点击“登录”，使用微信或腾讯云账号扫码授权，完成实名认证后即可进入主界面。
二、通过命令行手动安装插件包（.vsix）
该方式绕过扩展市场网络限制，适用于企业内网、代理拦截或市场访问异常场景，需提前获取官方签名插件包。
1、访问腾讯云 CodeBuddy 官方发布页，下载最新版 .vsix 文件（文件名含版本号与平台标识，如 codebuddy-2.12.0.vsix）。
2、在 VS Code 中，按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS） 打开命令面板。
3、输入并选择 Extensions: Install from VSIX... 命令。
4、定位并选中已下载的 .vsix 文件，点击“重新加载”提示按钮完成安装。
5、重新加载后，按步骤一第5–6条操作完成登录与授权。
三、启用 CLI 集成并绑定本地开发环境
该路径面向资深开发者，支持终端直启 CodeBuddy 功能、跨项目上下文感知及模型级细粒度控制，需预先配置命令行工具链。
1、在终端执行 buddycn --version 检查是否已安装 CodeBuddy CLI；若未安装，运行 npm install -g @tencentcloud/buddycn（Node.js ≥18）。
2、执行 buddycn login，系统将自动打开浏览器跳转至腾讯云授权页，扫码完成绑定。
3、返回 VS Code，在设置中搜索 codebuddy.enableCliIntegration，将其值设为 true。
4、重启 VS Code，再次点击左侧 CodeBuddy 图标，此时状态栏将显示 CLI 已连接 标识，并支持右键菜单调用 CLI 命令。
四、配置自定义模型（OpenAI 兼容接口）
该步骤用于替换默认云端模型，接入私有 API 或第三方大模型服务，要求用户已持有有效 API Key 与兼容端点。
1、在 VS Code 中打开命令面板（Ctrl+Shift+P），输入并选择 CodeBuddy: Open Model Configuration。
2、编辑打开的 models.json 文件，确保其位于路径：
国际版：C:\Users\[用户名]\.codebuddy\models.json
国内版：C:\Users\[用户名]\.codebuddycn\models.json
3、在文件中添加 JSON 对象，示例结构如下：
{"name": "my-grok", "provider": "openai-compatible", "baseUrl": "https://api.x.ai/v1", "apiKey": "sk-xai-xxxxxxxx", "model": "grok-beta"}
4、保存文件后，在 CodeBuddy 插件面板右上角点击齿轮图标，于下拉菜单中选择刚定义的模型名称 my-grok。
5、任意代码文件中高亮选中文本，右键选择 Ask CodeBuddy，验证模型响应是否生效。
