先聊一个常见需求：在企业内网完全断开外网，或身处高安全等级的网络环境中时，想使用 CodeGeeX 这类 AI 辅助编程插件，直接从 Marketplace 下载是行不通的。唯一的办法就是提前将插件包下载到本地，再通过离线方式手动安装。听起来简单，但 VSCode 和 JetBrains 系列 IDE 的操作细节差异很大，容易踩坑。

核心流程两步走：先在联网机器上下载对应的离线安装包（.vsix 或 .zip），再把文件传输到离线环境中的目标机器上，按照相应 IDE 的安装指引完成部署。下面逐一拆解说明。

VSCode 离线安装 CodeGeeX 插件详解

先从 VSCode 说起。请确保获取的插件版本不低于 2.6，因为 2.6 以下的老版本缺少 localMode 开关，这在离线场景下是关键差异。具体操作步骤：

在已联网的电脑上打开 VS Code Marketplace 页面，搜索 【CodeGeeX: AI Code AutoComplete, Chat, Auto Comment】，确认发布者为 Zhipu AI。接着点击页面右上角的 “Download Extension”，将 .vsix 文件（例如 zhipuai.codegeex-2.6.0.vsix）保存到本地。如果该按钮无响应，也可以从 GitHub 或公司内部镜像站查找同名文件。

随后，将 .vsix 文件通过 U 盘或内网共享拷贝到离线机器上。启动 VSCode，按 Ctrl+Shift+X 进入扩展面板，点击右上角的 ⋯ 菜单，选择 Install from VSIX，定位到该文件并点击 Install 即可。安装完成后建议重启 VSCode。这里有一个容易被忽略的细节：如果 VSCode 提示“已禁用其他 AI 插件”，务必先卸载 Tabby、Continue 或旧版 CodeGeeX，否则 Ctrl+Enter 快捷键会冲突，导致代码补全功能彻底失效。这一步不执行，后续怎么折腾都无法正常使用。

JetBrains IDE（IntelliJ IDEA / PyCharm / GoLand）离线安装指南

JetBrains 系列 IDE 的操作相对灵活，提供两种安装方式。

方式一：直接拖入安装（推荐）
下载与 IDE 版本匹配的 .zip 插件包（注意：不是 .jar 文件，必须是 Marketplace 上最新发布的 zip 包）。解压后应包含 plugin.xml 和 resources 目录。然后打开 IDEA（或 PyCharm、GoLand），进入 File → Settings → Plugins，点击右下角的齿轮图标，选择 Install Plugin from Disk，选中该 zip 文件确认安装即可。这是最省心的办法。

方式二：手动解压部署（适用于插件未签名或权限受限的环境）
直接将 zip 包解压到插件目录：Linux/macOS 路径为 ~/.local/share/JetBrains/Toolbox/apps/IDE/bin/plugins/；Windows 路径为 %USERPROFILE%\AppData\Roaming\JetBrains\IntelliJIdea2024.3\plugins。解压后将文件夹重命名为 codegeex，然后重启 IDE，它会自动识别加载。

提醒一点：JetBrains 的插件版本必须与 IDE 主版本严格匹配。例如 IntelliJ IDEA 2024.3 需要选用 CodeGeeX v2.5.1 及以上版本，若安装 v2.4.0 在 2024.1+ 的 IDE 上，启动时会报 classloader 加载失败。下载前务必查看兼容性说明。

验证插件是否成功加载的方法

安装完成后如何确认插件已经跑起来了？三步即可验证：

第一步：启动 IDE 后观察右下角状态栏，若出现 CodeGeeX 图标，说明插件已激活。如果图标未显示，很可能是被安全策略拦截了。

第二步：按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 CodeGeeX: Toggle Panel，该命令若能触发面板弹出，表明插件的主界面已可正常使用。

第三步：打开一个 .java 或 .py 文件，将光标置于函数体内，按 Ctrl+Enter。如果看到代码补全的建议框弹出，恭喜你，插件底层的通信链路已经打通。注意，此阶段仅验证插件运行环境是否就绪，尚未配置模型，因此补全内容可能不够精准，但足以证明安装成功。