个人免费版支持vscode在线一键安装和jetbrains专业版marketplace安装，企业版需vsix离线安装并校验license token，私有化部署要求nvidia显卡、ubuntu系统及签署协议获取离线包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在开发环境中快速启用清华出品的CodeGeeX AI编程助手，但不确定该选个人免费版还是企业版安装方式——两者在操作路径、依赖条件和部署权限上存在实质性区别，装错版本可能导致插件无法激活或功能受限。
个人免费版：VSCode在线一键安装
打开VSCode，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）进入扩展市场；
在搜索框中输入 CodeGeeX，认准官方插件全称“CodeGeeX: AI Code AutoComplete, Chat, Auto Comment”；
点击「Install」按钮完成下载与安装，无需重启即可触发基础补全功能；
安装后右下角自动出现CodeGeeX图标，点击→选择Login→在浏览器中完成账号授权（支持手机号验证码登录），登录后即解锁Ask模式、Agent模式等全部免费能力。
个人免费版：JetBrains全家桶安装限制
打开IntelliJ IDEA / PyCharm / GoLand等IDE，进入 File → Settings → Plugins（macOS为Preferences）；
在Marketplace搜索栏输入“CodeGeeX”，点击安装；
注意：必须使用专业版（Ultimate Edition），社区版（Community Edition）不支持安装；
若弹出第三方插件提示框，点击Accept；安装完成后需重启IDE，侧边栏将显示CodeGeeX图标。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
企业版：VSCode本地VSIX离线安装
方法一：从企业后台获取安装包
登录企业专属管理后台 v4-enterprise.codegeex.cn，下载对应组织域名签名的VSIX文件（含targetPlatform标识）；
方法二：VSCode内手动安装
打开扩展面板→点击右上角「⋯」→选择「Install from VSIX」→定位并选中已下载的VSIX文件→点击Install；
安装完成后必须重启VSCode，否则插件进程无法加载企业级证书校验模块；
首次启动时会强制校验企业License Token，无有效Token将直接禁用云端模型调用，仅保留本地轻量补全。
企业版：私有化部署前置准备
第一步：确认部署环境满足最低要求
服务器需具备NVIDIA T4或A10显卡（≥24GB显存），操作系统为Ubuntu 22.04 LTS，内核版本≥5.15；
第二步：联系智普公司获取部署套件
提供企业营业执照副本及内网IP段白名单，签署《CodeGeeX私有化服务协议》后，获得包含model weights、API gateway、web console的离线部署包；
第三步：执行离线初始化脚本
解压部署包→运行init-enterprise.sh→输入管理员邮箱→系统自动配置HTTPS反向代理与RBAC权限模型；
第四步：IDE端对接私有服务地址
在VSCode设置中修改CodeGeeX插件的Backend URL为https://your-company-ai.internal:8443，保存后重启插件进程。
