先提醒一个最关键的前提——要启用这项功能，第一步永远是正确安装插件并重启编辑器。如果缺少这一步，右下角的火箭图标通常不会出现，常用快捷键也会失效，AI 模型加载时还可能直接报错。具体来看，VS Code 需要版本至少为 1.72.0，安装完成后必须点击 Reload 重新加载窗口；JetBrains 系列则需要先 Accept 信任提示，再执行 Restart IDE；如果是离线安装，必须使用 .vsix 或官方原版 ZIP 安装包，切记不要自行解压。

实际上，无论你使用的是 VS Code、JetBrains 系列 IDE（如 IntelliJ IDEA、PyCharm），还是 Visual Studio，想正常启用 CodeGeeX 的 AI 代码补全、智能对话、自动注释生成等核心功能，都需要先手动安装对应插件——它不会默认预装，也不会自动推送安装。同时，不同编辑器在安装路径、校验机制和重启要求上也存在差异，只要漏掉其中任意一步，都可能导致右下角没有火箭图标、快捷键无响应，或者模型加载失败。

VS Code 中安装 CodeGeeX 插件

打开 VS Code 后，先检查当前版本号——点击左下角的版本信息即可查看。如果版本低于 1.72.0，那么后续步骤基本无法正常进行，因为插件的核心组件无法运行，即使勉强安装成功，也通常无法触发 AI 代码补全。

接着按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS），打开扩展面板。

在搜索框中输入 CodeGeeX（注意拼写为 G-e-e-X，不是 Geex 或 GeeX）。在搜索结果里，确认发布者为 Zhipu AI、插件名称为 “CodeGeeX: AI Code AutoComplete, Chat, Auto Comment”，图标是蓝白火箭，这才是官方版本。

点击右侧的 Install 按钮，等待安装进度完成。安装结束后，右下角可能会短暂显示蓝白火箭图标，但这并不代表插件已经完全初始化。

【一定要点击 Reload 按钮重启窗口】——如果不重启，插件无法正确注入编辑器上下文，后续登录界面也不会自动弹出，settings.json 中的 codegeex.* 配置项也可能无法识别。

IntelliJ IDEA / PyCharm 中安装 CodeGeex 插件

打开 IDE，点击菜单栏 File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）。

在左侧导航栏中选择 Plugins，再将顶部标签切换到 Marketplace。

在右上角搜索框输入 CodeGeex（注意拼写为 e-x，不是 e-X 或 eex），等待 3-5 秒让列表刷新。如果没有搜索结果，通常说明当前网络策略拦截了 JetBrains 插件仓库的中国节点，此时需要手动切换插件仓库源。

切换仓库源的方法为：点击搜索框右侧齿轮图标 → Manage Plugin Repositories… → 点击 + 号 → 粘贴地址：https://plugins.jetbrains.com/marketplace/pluginsList?pluginId=codegeex → 点击 OK → 返回 Plugins 页面后重新搜索。

找到官方插件 “CodeGeex: AI Code Assistant” 后，点击右侧的 Install。安装过程中如果弹出 “Trust this plugin from third-party vendor?” 提示，务必点击 Accept——如果选择拒绝，插件通常会静默失效，即使重启后也不会正常显示。

安装完成后，点击右下角的 Restart IDE 立即重启。如果不执行重启，插件通常不会被加载，工具栏和右键菜单中也无法找到相关入口。

离线环境安装（VS Code / JetBrains 全家桶）

方法一：VS Code 离线安装
在可联网的电脑上访问 VS Code Marketplace，搜索 “CodeGeeX: AI Code AutoComplete…”，确认发布者为 Zhipu AI，且版本号 ≥ 2.6，然后点击右上角的 “Download Extension” 下载 .vsix 文件（例如 zhipuai.codegeex-2.6.0.vsix）。将文件复制到离线设备后，在 VS Code 扩展面板右上角点击 ⋯ → Install from VSIX，再选择该文件进行安装。

方法二：JetBrains 离线安装
下载对应 IDE 的官方 .zip 插件包（注意文件名中通常会带有 pycharm 或 intellij，而不是 .jar），然后打开 IDEA/PyCharm → Settings → Plugins → 右下角齿轮图标 → Install Plugin from Disk，直接选择未解压的 ZIP 文件并点击 OK。

【绝对不要解压 ZIP 文件】——JetBrains 插件加载器只识别官方原始压缩包结构，解压后再安装会直接报错 “Invalid plugin archive”。

无论采用哪种离线安装方式，安装完成后都必须重启编辑器。如果系统提示“已禁用其他 AI 插件”，建议先卸载 Tabby、Continue 或旧版本 CodeGeeX，避免与 Ctrl+Enter 等快捷键发生冲突——否则即使安装成功，AI 代码补全功能也可能无法正常使用。