在 IntelliJ IDEA 内部署 CodeGeex 的详细步骤指南

必须使用 IDEA 专业版 2024.1+、Java 11+，安装 CodeGeex 插件后重启，再本地部署 Ollama 并拉取 codegeex4:all-9b 模型，最后在插件中配置 Ollama 地址和模型名并启用功能。

要在 IntelliJ IDEA 中让 CodeGeex 真正跑起来并支持本地大模型推理，必须完成插件安装、离线服务启动、插件配置三步闭环，缺一不可——社区版无法安装，IDEA 专业版 2024.1 及以上才被最新支持。

确认环境与版本前提

打开 IDEA，点击 Help → About，查看当前版本号。若显示 “Community Edition”，【立即停止后续操作】——CodeGeex 插件不兼容社区版，强行尝试会卡在 Plugins 页面无响应。必须使用专业版（Ultimate），且版本 ≥ 2024.1。

检查系统是否已安装 Java 11 或更高版本：终端执行 java -version，输出中需含 “11.”、“17.” 或 “21.” 字样。低于 Java 11 将导致插件加载失败，界面弹出 “Plugin not compatible with current IDE version” 错误。

安装 CodeGeex 插件

第一步：点击菜单栏 File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）。

第二步：左侧导航栏选择 Plugins，确保顶部标签页为 Marketplace。

第三步：在搜索框输入 CodeGeex（注意拼写，不是 CodeGeeX 或 CodeGeex4），回车后等待结果刷新。

第四步：找到最新插件 “CodeGeex: AI Code Assistant”，点击右侧 Install 按钮。安装过程中若弹出 “Trust this plugin from third-party vendor?” 提示，必须点 Accept——拒绝会导致插件静默失效，重启后仍不可见。

第五步：安装完成后，点击右下角 Restart IDE 立即重启。不重启，插件不会加载，工具栏和右键菜单均无入口。

本地部署并启动 Ollama 服务

方法一：直接运行二进制（免 root 权限，适合开发机）
下载对应系统架构的 ollama-linux-amd64.tgz 或 ollama-darwin-arm64.zip，解压后进入 bin 目录，执行：
OLLAMA_HOST=0.0.0.0 OLLAMA_MODELS=/path/to/models ./ollama serve
其中 /path/to/models 必须是绝对路径，且该目录需提前创建并赋予读写权限，否则模型拉取失败时无报错提示，只在日志里沉默。

方法二：注册为系统服务（Linux 生产环境推荐）
用 root 权限创建 /etc/systemd/system/ollama.service，填入标准 unit 配置，然后执行 systemctl daemon-reload → systemctl enable ollama → systemctl start ollama。
启动后执行 curl http://localhost:11434/api/tags 确认返回 JSON 列表，说明服务已就绪。

拉取 CodeGeex4 模型：终端执行 ollama pull codegeex4:all-9b。该模型体积约 5.2 GB，首次拉取耗时较长，Wi-Fi 不稳时易中断，建议用有线网络或 screen 会话保活。

配置插件指向本地模型

重启 IDEA 后，点击右下角状态栏的 CodeGeex 图标 → Open Settings。

在 Model Provider 下拉菜单中选择 “Ollama”，自动填充地址为 http://localhost:11434 ——若此前修改过端口，此处必须手动同步为实际端口号，【端口不一致将导致所有代码生成请求超时】。

在 Model Name 输入框填写 codegeex4:all-9b（严格匹配 ollama list 输出的第一列名称，大小写与冒号不可错），点击 Test Connection，出现绿色 “Success” 提示即表示通路打通。

勾选 “Enable Code Completion” 和 “Enable Chat Panel”，最后点击 Apply → OK。此时任意 Java 文件中输入 // TODO 实现用户登录 → 按 Ctrl+Enter（Windows）或 ⌘+Enter（macOS），即可触发本地模型实时补全。