替代 GitHub Copilot：国内用户如何顺利安装 CodeGeex

国内用户想找一款免费、中文优化、且无需订阅的AI编程助手来替代GitHub Copilot，CodeGeex无疑是目前最成熟的选择。它由清华团队与智谱AI联合研发，全面支持VS Code、JetBrains全家桶、Visual Studio等主流IDE，安装后直接调用130亿参数大模型，代码生成、补全、翻译、加注释一条龙，完全不用掏钱。

不过，在开始安装之前，有几个硬性门槛需要先确认。

确认本地开发环境是否达标

CodeGeex对IDE版本有明确要求，低于门槛会导致插件无法加载或功能异常。VS Code需要≥1.75.0（2024年1月后版本），IntelliJ IDEA/PyCharm需要≥2024.3。怎么查？VS Code看左下角版本号，IDEA里点Help → About就能看到。如果版本太低，

Windows用户安装VS Code时，务必勾选“Add to PATH”，不然命令行里调不了code命令。macOS/Linux用户装完后，建议执行chmod +x /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code并软链到/usr/local/bin，避免终端启动时找不到命令。

VS Code中安装CodeGeex插件

启动VS Code → 点击左侧活动栏Extensions图标（或按Ctrl+Shift+X）→ 搜索框输入CodeGeex（注意拼写，是e不是E）→ 找到最新插件（发布者为Zhipu AI，图标是蓝色火箭）→ 点击Install。

装完之后，右下角会出现蓝色CodeGeex图标，点击它会弹出登录面板。

前往CodeGeex官网下载对应IDE版本的VSIX包 → VS Code扩展面板右上角「⋯」→ Install from VSIX → 选择本地文件 → 安装 → 重启VS Code。

JetBrains系列IDE（IDEA/PyCharm/GoLand）安装

第一步：打开IDE → File → Settings（macOS为IntelliJ IDEA → Preferences）→ Plugins

第二步：在Marketplace搜索框输入CodeGeex → 点击搜索结果中的最新插件 → Install

第三步：安装完成后弹窗提示“Restart IDE” → 点击Restart → 启动后右侧边栏自动出现CodeGeex侧边栏图标

注意：部分旧版IDEA（如2020.x）即使满足最低版本要求，也可能因插件API变更导致侧边栏不显示。这时候需要手动启用——Settings → Appearance & Beha vior → System Settings → Plugins → 勾选“Show plugin updates in notification center”后重启。

首次使用前的关键配置

安装完成并重启后，在VS Code中点击右下角CodeGeex图标 → 点击齿轮图标进入Settings → 将Language设置为Chinese（简体中文）。这样生成的注释、文档、错误提示全部是中文，避免英文术语干扰理解。

JetBrains用户进入Settings → Other Settings → CodeGeex → Language → 中文。

在任意代码文件中，输入//后按回车，CodeGeex会自动识别上下文并生成中文注释；光标停在函数名后按Alt+Enter，可以触发“生成单元测试”或“解释当前函数”操作，非常顺手。