IntelliJ IDEA安装CodeBuddy插件详细配置指南

想在JetBrains家的IDE里用上CodeBuddy的智能编程能力，你得先把它装进去。简单来说，有两种主流安装方式：在线安装和本地安装。下面这张图可以帮你快速了解整个流程。

接下来，咱们就分步拆解，看看具体怎么操作。

一、通过 Marketplace 在线安装

如果你的网络环境不错，IDE版本在2023.3或以上，那么在线安装是最省心的办法。插件市场会自动帮你匹配版本、处理依赖，全程基本不用你操心。

第一步，打开你的IntelliJ IDEA、PyCharm或者其他任意一款JetBrains IDE。

第二步，点击顶部菜单栏的 File > Settings（Windows/Linux用户）或者 IntelliJ IDEA > Preferences（macOS用户）。

第三步，在左侧的设置面板里，找到并点击 Plugins 选项。

第四步，把目光移到窗口右上角，在搜索框里输入 腾讯云代码助手CodeBuddy 或者直接搜 CodeBuddy 也行。

第五步，在搜索结果里，认准发布者为“Tencent Cloud”的那个官方插件，然后点击旁边的 Install 按钮。

第六步，安装完成后，IDE会提示你重启。点击 Restart IDE，重启后插件功能就正式激活了。

二、从磁盘本地安装 ZIP 插件包

在线安装虽好，但有些情况它不适用。比如公司内网限制了访问，或者你需要离线部署、测试某个特定版本。这时候，手动下载ZIP包进行本地安装就成了更靠谱的选择。

第一步，先得把插件包弄到手。访问CodeBuddy的官方插件发布页：https://plugins.jetbrains.com/plugin/16252-codebuddy。

第二步，在页面上找到与你当前IDE版本兼容的最新ZIP文件（文件名类似 codebuddy-3.2.8.zip），点击下载。

第三步，回到你的IDE，再次进入 Settings > Plugins 页面。

第四步，点击插件列表右上角的 ⚙️ 设置图标，在下拉菜单中选择 Install from Disk…。

第五步，在弹出的文件选择窗口里，找到你刚才下载的那个ZIP文件，选中它，然后点击 OK。

第六步，等IDE解压并注册完插件，同样会提示你重启。点击 Restart IDE，重启后插件就生效了。

三、启用 Craft 对话界面并完成登录

插件装好、IDE也重启了，但这还没完。要让CodeBuddy开始干活，你得先把它“叫醒”，并完成账号绑定。这个交互入口就是Craft对话面板，它支持混元和DeepSeek-V3双模型引擎。

第一步，重启IDE后，在任意代码编辑器界面，按下快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），打开命令面板。

第二步，在命令面板里输入 CodeBuddy: Start Chat，然后按回车执行。

第三步，如果你是第一次使用，系统会弹出一个微信扫码登录的窗口。用手机微信扫一下二维码，完成身份认证。

第四步，登录成功后，IDE右侧会自动展开Craft面板。到这里，你就可以开始用自然语言给它下指令了，比如直接输入：“生成一个 Spring Boot Controller，响应 GET /api/users”。

四、切换至 CodeBuddy 自研 IDE 形态（备用方案）

上面说的都是在现有IDE里装插件。但如果你的IDE版本太老（低于2023.3）、公司安全策略拦截、插件签名不被信任，或者你没有管理员权限，导致插件死活装不上，怎么办？别急，还有个“终极方案”——直接用CodeBuddy自家的独立IDE。

这个独立版本不依赖任何第三方IDE，自带完整的项目管理和云端协同能力，算是个一体化的解决方案。

第一步，访问官网下载页面：https://copilot.tencent.com。

第二步，根据你的操作系统，选择对应的安装包：Windows选.exe，macOS Intel芯片选.dmg，macOS Apple Silicon芯片也选.dmg（注意区分版本）。

第三步，下载完成后，像安装普通软件一样完成安装，然后启动它。

第四步，在启动后的欢迎界面，点击 微信扫码登录 按钮，完成登录。

第五步，登录成功后，如果你的账号有历史配置，系统通常会帮你自动同步。之后，你就会进入它的主工作区，可以开始使用了。