如何快速将 CodeGeex 插件安装到最新的 JetBrains 2026 版本中

要启用 CodeGeeX 的全部功能，有个硬性前提：IDE 版本必须升级到 2026.1 或更高。安装时需要手动添加插件仓库源解决搜索失效问题，登录后正确配置一个包含 `config.json` 等三个关键文件的本地模型路径，才算大功告成。

在最新版 JetBrains IDE（2026.x 系列）里快速用上 CodeGeeX 的代码生成、解释和重构能力，得避开三个高频卡点：插件市场搜索不到、版本兼容校验失败、本地模型路径没识别。下面一步步拆解。

确认 IDE 版本与插件兼容性

打开 JetBrains IDE，点击左上角

，看看版本号是不是 2026.1 或更高。低于这个版本，新版 CodeGeeX 插件加载不了，会直接显示“不兼容”，连安装按钮都没有。

如果版本不对，得先升级：去

下载 2026.1+ 安装包，覆盖安装时勾选 ，这样原有的配置不会丢。

在线安装 CodeGeeX 插件（推荐）

方法一：走插件市场直装，这是最快路径。
① 打开 IDE →

（macOS 是 ）；
② 在右上角搜索框输入 ，等列表刷新（约 3–5 秒），认准发布者 的官方插件；
③ 点击 → 安装完成后弹出提示，点 ；
④ 重启后，侧边栏自动出现火箭图标，说明插件激活了。

需要注意：如果搜索没结果，说明网络策略拦了 JetBrains 插件仓库的中国节点——这时候需要手动切换仓库源。

手动切换插件仓库源（解决搜不到问题）

在

页面右上角，点击齿轮图标 → → 点 号 → 粘贴下面这个地址：

点 OK 后，回到插件搜索页重新输入 ，就能正常显示并安装了。

这一步跳过了默认仓库的地域限流，是 2026 版本在国内网络环境下的必备操作。

登录并启用本地模型（可选但推荐）

启动后第一次点侧边栏火箭图标 → 弹出登录面板 → 支持手机号验证码 / 微信扫码 / Zhipu 账号三种方式；
登录成功后，点右上角齿轮图标 → 进入

→ 找到 → 选择 ；
如果已经提前克隆了模型仓库，点 指向本地路径：（macOS/Linux）或 （Windows）；
：那个文件夹里必须包含 三个核心文件，缺一个模型就加载不了。

模型路径设置好之后，点右下角

→ 等状态栏显示 就可以开始用了。