要在 rubymine 中让 codegeex 插件真正可用，必须先完成下载安装、授权登录和本地模式配置三步闭环，缺一不可——跳过任一环节都会导致补全建议不触发或提示“服务不可用”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
从 JetBrains Marketplace 安装插件
打开 RubyMine → 按 Ctrl + Alt + S 打开 Settings → 左侧选 Plugins → 切换到 Marketplace 标签页。
在搜索框输入 【CodeGeeX】（注意拼写是 X 不是 Ex，输错将找不到官方插件）→ 在结果中确认发布者为 Zhipu AI、版本号 ≥ 2.8.0 → 点击 Install。
安装完成后点击 Restart IDE，重启后插件才开始加载依赖。
完成首次登录与账号绑定
重启后，RubyMine 右下角会弹出 CodeGeeX 登录浮层；若未出现，手动进入 Settings → CodeGeeX → 点击 “Sign in” 按钮。
支持 GitHub / 邮箱 / 手机号三种方式，推荐用 GitHub 登录——它能自动同步你的订阅状态和历史偏好设置。
登录成功后，插件会自动拉取云端模型密钥并缓存至本地 ~/.codegeex/credentials.json。这一步失败会导致后续所有补全请求返回 401 错误。
启用本地推理服务（可选但强烈推荐）
方法一：使用已部署的本地服务
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
确保本地已运行 CodeGeeX 推理服务（如通过 test_inference.sh 启动，监听 http://localhost:5000）→ 进入 Settings → CodeGeeX → 勾选 “Use local model” → 在 Server URL 栏填入 【http://localhost:5000】（末尾不能带斜杠，否则连接失败）。
方法二：一键启动轻量本地服务（需 Python 3.9+ 和 CUDA 11.8+）
终端执行：pip install codegeex → 下载权重到 ~/.codegeex/models/ → 运行 codegeex-server --port 5000 --device cuda:0 → 回到 RubyMine 插件设置启用本地模式并填写地址。
注意：若显存不足 15GB，必须启用量化模式，否则服务启动即崩溃。
验证插件是否生效
新建一个 Ruby 文件 → 输入 def say_hello → 按 Ctrl + Space 触发补全 → 若出现灰色代码建议（如 puts "Hello"），说明插件已就绪。
若无响应，检查 RubyMine 底部状态栏右侧是否显示 “CodeGeeX: Ready”；若显示 “Offline” 或 “Auth Failed”，请返回第二步重新登录。
