CodeGeex插件快速安装指南：JetBrains 2026最新版

先别急着折腾——要在最新版 JetBrains IDE（2026.x 系列）里顺利用上 CodeGeeX 的代码生成、解释与重构能力，有几个前置条件必须踩准。否则，你大概率会遇到插件市场搜不到、版本校验失败、本地模型路径死活认不出来这三类经典卡点。下面直接拆解每一步操作，按顺序来基本不出岔子。

确认 IDE 版本与插件兼容性

打开 JetBrains IDE，依次点击左上角 Help → About，确认版本号是 2026.1 或更高。低于这个版本的 IDE 无法加载新版 CodeGeeX 插件——安装按钮直接灰掉，明确提示“不兼容”。如果版本不足，需要先升级：前往 JetBrains 官方下载页 获取 2026.1+ 安装包，覆盖安装时记得勾选 【Keep previous version settings】，这样之前的配置和插件设置不会丢失。

在线安装 CodeGeeX 插件（推荐）

方法一：从插件市场直装（最快路径）
① 打开 IDE → File → Settings → Plugins（macOS 下路径为 IntelliJ IDEA → Preferences → Plugins）；
② 在右上角搜索框输入 CodeGeeX，等待列表刷新（通常 3–5 秒），认准发布者为 Zhipu AI 的官方插件；
③ 点击 Install → 安装完成后弹出提示框，点击 Restart IDE；
④ 重启后，侧边栏自动出现火箭图标，说明插件已激活。

注意：如果搜索后一片空白，说明你的网络策略拦截了 JetBrains 插件仓库的中国节点。这时候需要手动切换仓库源——别怕，只是多一步操作。

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

在 Settings → Plugins 页面右上角，点击齿轮图标 → Manage Plugin Repositories… → 点击 + 号 → 粘贴以下地址：
https://plugins.jetbrains.com/marketplace/pluginsList?pluginId=codegeex
点击 OK 后，回到插件搜索页重新输入 CodeGeeX，插件就会正常显示并允许安装。这一步相当于绕过了默认仓库的地域限流，是 2026 版本在国内网络环境下的必备操作。

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

启动后首次点击侧边栏火箭图标 → 弹出登录面板 → 支持手机号验证码 / 微信扫码 / Zhipu 账号三种方式；登录成功后，点击右上角齿轮图标 → 进入 Settings → 找到 Model Provider → 选择 CodeGeeX2-6B (Local)。如果已经提前克隆了模型仓库，点击 Browse 指向本地路径：~/codegeex2-6b-int4（macOS/Linux）或 C:codegeex2-6b-int4（Windows）。

关键前提： 该文件夹内必须包含 config.json、pytorch_model.bin、tokenizer.json 三个核心文件，缺一个都无法加载模型。模型路径设置完成后，点击右下角 Apply → 等待状态栏显示 ✅ Local model loaded，这时就可以愉快地使用本地大模型编码了。