必须先完成插件安装并重启编辑器，否则右下角无火箭图标、快捷键失效、模型加载失败；VS Code需≥1.72.0版本并点击Reload重启窗口，JetBrains系列需Accept信任提示并Restart IDE，离线安装须用.vsix或原ZIP包且不可解压。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 VS Code、JetBrains 系列（如 IntelliJ IDEA、PyCharm）或 Visual Studio 中启用 CodeGeeX 的 AI 代码补全、聊天、注释生成等核心能力，必须先完成插件安装——它不预装、不自动推送，且不同编辑器的安装路径、校验逻辑和重启要求各不相同，漏掉任一环节都会导致右下角无火箭图标、快捷键失效、模型加载失败。
VS Code 中安装 CodeGeeX 插件
打开 VS Code，确保版本 ≥ 1.72.0（左下角点击版本号可查看）；低于该版本将无法加载插件前端组件，即使安装成功也无法触发补全。
按 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 按钮，等待进度条走完；安装完成后，VS Code 右下角会短暂显示蓝白火箭图标，但此时插件尚未初始化。
【务必点击 Reload 按钮重启窗口】——不执行此步，插件不会注入编辑器上下文，后续登录界面不会弹出，settings.json 中的 codegeex.* 配置项也无法识别。
IntelliJ IDEA / PyCharm 中安装 CodeGeex 插件
打开 IDE → 点击菜单栏 File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）。
左侧导航栏选择 Plugins，顶部标签页切换至 Marketplace。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
在右上角搜索框输入 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 快捷键冲突——这一步不执行会导致代码补全失效。
