替代 GitHub Copilot：国内用户怎样顺利安装 CodeGeex

CodeGeex是当前最成熟、免费、中文优化且无需订阅的GitHub Copilot替代方案，由清华团队与智谱AI联合研发，支持主流IDE并提供130亿参数模型的代码生成、补全、翻译与注释功能。

国内用户想用免费、中文优化、无需订阅的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查看；若版本过低，【必须先升级IDE再安装插件】，否则后续所有步骤都无效。

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（注意拼写，不是CodeGeeX）→ 找到最新插件（发布者为Zhipu AI，图标为蓝色火箭）→ 点击Install。

安装完成后，右下角会出现蓝色CodeGeex图标，点击它会弹出登录面板；【不登录也能使用基础功能，但登录后可同步历史记录、解锁多语言互译等高级能力】。

方法二：离线VSIX安装（适用于企业内网或网络受限环境）

前往https://codegeex.cn正式 → 下载对应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 & Behavior → System Settings → Plugins → 勾选“Show plugin updates in notification center”后重启。

首次使用前的关键配置

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

JetBrains用户进入Settings → Other Settings → CodeGeex → Language → 中文；【此步不可跳过，否则默认英文输出，中文注释生成质量大幅下降】。

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