VSCode离线安装CodeGeeX需先在有网机下载≥2.6版.vsix包（发布者Zhipu AI），再通过“Install from VSIX”安装；JetBrains则支持拖入.zip或手动解压至plugins目录，均须卸载冲突插件并验证Ctrl+Enter补全功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在无网络环境或企业内网隔离场景下，必须提前获取 CodeGeeX 插件离线安装包（.vsix 或 .zip），再通过本地文件方式完成安装，否则 VSCode 或 JetBrains IDE 将无法访问 Marketplace 下载插件。
VSCode 离线安装 CodeGeeX 插件
第一步：在有网机器上打开 VS Code Marketplace 页面，搜索 【CodeGeeX: AI Code AutoComplete, Chat, Auto Comment】，确认发布者为 Zhipu AI、版本号 ≥ 2.6（低于 2.6 的旧版不支持 localMode 开关）。
第二步：点击插件页面右上角 “Download Extension”，保存 .vsix 文件（如 zhipuai.codegeex-2.6.0.vsix）到本地磁盘；若下载失败，可改用 GitHub 镜像源或企业内部镜像站获取同名文件。
第三步：将该 .vsix 文件拷贝至离线机，打开 VSCode → 左侧扩展图标（Ctrl+Shift+X）→ 右上角 ⋯ → Install from VSIX → 选中该文件 → 点击 Install。
第四步：安装完成后重启 VSCode；若提示“已禁用其他 AI 插件”，请先卸载 Tabby、Continue 或旧版 CodeGeeX，避免 Ctrl+Enter 快捷键冲突——这一步不执行会导致代码补全失效。
JetBrains IDE（IntelliJ IDEA / PyCharm / GoLand）离线安装
方法一：直接拖入安装（推荐）
下载对应版本的 .zip 插件包（注意不是 .jar！必须是 Marketplace 官方发布的 zip 包），解压后得到 plugin.xml 和 resources 目录；打开 IDEA → File → Settings → Plugins → 右下角齿轮图标 → Install Plugin from Disk → 选中该 zip 文件 → 确认安装。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
方法二：手动解压部署（适用于插件未签名或权限受限环境）
将 zip 包解压至 【~/.local/share/JetBrains/Toolbox/apps/IDE/bin/plugins/】（Linux/macOS）或 【%USERPROFILE%\AppData\Roaming\JetBrains\IntelliJIdea2023.3\plugins\】（Windows），重命名文件夹为 codegeex，重启 IDE 即可识别。
注意：JetBrains 插件版本必须与 IDE 主版本兼容，例如 IntelliJ IDEA 2023.3 需匹配 CodeGeeX v2.5.1+，v2.4.0 在 2024.1+ 版本中会报 classloader 加载失败。
验证插件是否成功加载
步骤一：启动 IDE 后，在右下角状态栏查看是否有 CodeGeeX 图标出现；无图标说明插件未激活或被安全策略拦截。
步骤二：按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 “CodeGeeX: Toggle Panel”，若命令可触发面板弹出，则插件已就绪。
步骤三：打开任意 .java 或 .py 文件，光标置于函数体内，按 Ctrl+Enter —— 若出现代码补全建议框，即表示插件底层通信链路已通（此时尚未配置模型，仅验证插件运行时环境）。
