企业内网部署codegeex必须离线安装：vscode需下载≥2.6版.zhipuai.codegeex.vsix文件后通过“install from vsix”安装，jetbrains则用官方.zip包拖入或解压至plugins目录；安装后须重启、卸载冲突插件，并验证ctrl+enter补全及右下角图标显示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在企业内部局域网环境部署 CodeGeex 插件，必须绕过互联网 Marketplace，通过离线文件方式将插件安装包导入开发机，否则因网络隔离导致插件图标不显示、Ctrl+Enter 补全键失效、右下角状态栏无响应等问题会直接阻断使用流程。
VSCode 离线安装 CodeGeex 插件
第一步：在有外网权限的机器（如 IT 统一分发机）打开 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（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 图标出现；无图标说明插件未激活或被安全策略拦截。
步骤二：打开任意 .py 或 .java 文件，光标置于空行 → 按 Ctrl+Enter → 观察是否弹出补全建议框；若无反应，检查是否残留旧版插件或快捷键被占用。
步骤三：点击右下角 CodeGeeX 图标 → 选择 Settings → 切换至 Local Mode → 填写 Ollama 地址 http://192.168.x.x:11434（需提前在局域网服务器部署 Ollama 并拉取 codegeex4:all-9b 模型）→ 点击 Test Connection → 显示 “Connected” 即完成闭环验证。
