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

必须升级至2026.1+版本，通过手动添加插件仓库源解决搜索失效，安装后登录并正确配置含config.json等三文件的本地模型路径方可启用CodeGeeX全部功能。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在最新版 JetBrains IDE（2026.x 系列）中快速启用 CodeGeeX 的代码生成、解释与重构能力，必须避开插件市场搜索失效、版本兼容校验失败、本地模型路径未识别这三类高频卡点。

确认 IDE 版本与插件兼容性

打开 JetBrains IDE → 点击左上角 Help → About → 查看版本号是否为 2026.1 或更高。低于 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 即可开始使用。