想立刻用上 CodeGeeX 免费版，又担心下载错版本导致 IDE 不兼容、模型跑不动或功能缺失？别以为官网只放了一个下载链接就万事大吉——不同操作系统、开发环境、硬件配置，对应的实际安装路径和版本选择其实天差地别。
CodeGeeX 免费版最新下载入口（官方唯一渠道）
所有版本统一从官方首页获取：【https://codegeex.cn/】。页面顶部的“桌面客户端下载”区域非常智能，它会根据你当前访问的设备自动显示对应格式：Windows 用户看到的是 .exe 安装包，macOS 用户看到 .dmg，Linux 用户看到 .tar.gz。这里必须提醒你一句：千万别信第三方镜像站——自 2026 年 4 月起，官方已关闭所有授权分发渠道，其他域名下载的安装包根本无法通过签名验证。
如果只想快速体验，网页端直接打开就能用，无需强制注册，也不用绑定手机号，粘贴代码即可生成。但要注意，网页版仅支持基础补全与翻译，无法进行本地模型切换、离线调试面板，以及右键“解释代码”这类深度功能。
Windows 用户该如何选择安装包？
方法一：普通笔记本（i5-8250U + 8GB 内存 + 集成显卡）→ 下载“Windows Installer（轻量版）”。它内置 4bit 量化 13B-v2 模型，启动后自动加载，不依赖 CUDA。首次运行必须要联网一次，完成模型缓存初始化，之后断网也能正常使用。
方法二：游戏本或工作站（i7-11800H + 16GB 内存 + RTX 3060 及以上独显）→ 下载“Windows Installer（GPU 加速版）”。安装时会自动检测 NVIDIA 驱动版本，启用 TensorRT 优化，响应延迟能压到 80 毫秒以内，还支持双卡并行推理。
方法三：老旧办公电脑（Win7 + i3-3220 + 4GB 内存）→ 必须选“绿色免安装精简包”。解压后直接运行 codegeex-lite.exe，只加载 3.2GB 模型权重，禁用了 UML 生成与 API 模拟模块，但核心的补全、注释、翻译三项能力完整保留。
VS Code 插件版与桌面客户端到底有什么区别？
第一步：打开 VS Code → Ctrl+Shift+X → 搜索“codegeex” → 点击安装最新插件（发布者必须是“CodeGeeX Team”，注意不要下载成“CodeGeex”或“Code-GeeX”这些容易混淆的拼写变体）。
第二步：重启 VS Code → 打开任意 .py 或 .js 文件 → 输入函数名后稍等 → 灰色的候选代码会自动浮现 → 按 Tab 插入。
桌面客户端是独立进程，自带 HTTP 调试服务（localhost:8080），可以查看 token 消耗热力图、上下文长度统计、建议采纳率曲线。而 VS Code 插件完全嵌入编辑器生命周期，共享 VS Code 主题与快捷键体系，但无法调出可视化分析面板。
插件默认启用“隐匿模式”，一旦停顿就自动补全；桌面客户端默认是“互动模式”，需要按 Ctrl+Enter 手动触发候选列表——这两项开关在各自设置页里的位置不同，千万别混淆。
JetBrains 全家桶用户专属通道
PyCharm / IntelliJ IDEA / WebStorm 2026.1 及更新版本 → Settings → Plugins → Marketplace → 搜索“CodeGeeX” → 安装 → 重启 → 自动识别项目 SDK 与 Maven/Gradle 依赖树 → 补全建议会带上 Spring Boot 3.x 或 Django 4.2 等框架的专属 API。
Android Studio 用户需要额外留意：插件会扫描 build.gradle 中声明的 Jetpack 组件版本，主动推荐对应 LifecycleScope 或 Room Database 的最新调用方式。不建议在 AS 2025.3 以下版本使用，因为依赖解析模块存在兼容性缺口。
HBuilderX 用户请走离线部署路径：下载插件压缩包 → 解压至 HBuilderX 安装目录下的 plugins 文件夹 → 重启编辑器 → 右键菜单出现“添加 AI 注释”“解析选中代码”选项。
MacBook M 系列芯片适配方案
方法一（推荐）：从官方下载 macOS DMG → 安装时勾选“启用 ARM64 原生推理引擎” → 启动后自动调用 Apple Neural Engine 加速，响应延迟稳定在 85 毫秒以内，模型权重全程驻留内存，不写磁盘。
方法二（备用）：如果遇到 Metal 驱动冲突，改用“Rosetta 2 兼容模式”安装包 → 性能下降约 40%，但能绕过部分 M1/M2 芯片的 GPU 调度异常，适合 macOS 13.6 以下系统。
VS Code 插件在 M 系列 Mac 上默认启用原生支持，无需额外配置；但 JetBrains 插件需要在 Settings → Languages & Frameworks → CodeGeeX → 勾选“Force Apple Silicon backend”才能激活原生加速。