CodeGeex安装教程：JetBrains 2026版本快速适配指南
要启用 CodeGeeX 的全部功能，有个硬性前提：IDE 版本必须升级到 2026.1 或更高。安装时需要手动添加插件仓库源解决搜索失效问题，登录后正确配置一个包含 `config.json` 等三个关键文件的本地模型路径，才算大功告成。
在最新版 JetBrains IDE（2026.x 系列）里快速用上 CodeGeeX 的代码生成、解释和重构能力，得避开三个高频卡点：插件市场搜索不到、版本兼容校验失败、本地模型路径没识别。下面一步步拆解。
确认 IDE 版本与插件兼容性
打开 JetBrains IDE，点击左上角 Help → About，看看版本号是不是 2026.1 或更高。低于这个版本，新版 CodeGeeX 插件加载不了，会直接显示“不兼容”，连安装按钮都没有。
如果版本不对，得先升级：去 https://www.jetbrains.com/idea/download/ 下载 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 就可以开始用了。