CodeGeeX 快速入门

一款由清华团队打造的国产开源 AI 编程助手,中文注释、VSCode 直装、学生党友好。

这是什么?适合谁?

CodeGeeX 是由清华大学知识工程实验室(KEG)推出的大规模多语言代码生成模型,基于自研架构训练,支持 Python、Java、C++、JavaScript、Go 等 20 多种主流编程语言。它对中文注释的理解尤其出色,你用中文写注释,它就能生成对应代码,这点对不擅长写英文 prompt 的同学非常友好。

它适合几类人:高校学生、刚入行的程序员、英文阅读困难但想用 AI 辅助的开发者、做国产化替代方案的企业。CodeGeeX 同时提供 VSCode、JetBrains IDE 插件和网页版 IDE,无需翻墙,网络稳定。如果你更在意”国产+开源+免费”这三件事,CodeGeeX 是个值得尝试的选择。

准备工作

• 网络:国内可直连,无需特殊网络环境。
• VSCode 或 JetBrains IDE:推荐 VSCode,生态最完整。
• 账号:可选,登录后可使用云端补全,免登录也能用本地模型。
• 硬盘:安装 VSCode 插件大约 50MB,首次下载模型需要 1~2GB 空间。

3 步快速上手

第 1 步:安装 VSCode 插件

打开 VSCode,点击左侧扩展图标(或按 Ctrl+Shift+X),搜索 CodeGeeX,找到清华大学出品的插件点 Install。也可以直接打开链接:https://marketplace.visualstudio.com/items?itemName=aminer.codegeex

第 2 步:登录并启用

安装完成后,VSCode 左侧会出现 CodeGeeX 图标。点击进入,选择”手机号登录”或”微信扫码登录”。登录后它会询问你使用的编程语言,勾选你常用的几种(比如 Python、JavaScript),插件会自动下载对应的小模型。

第 3 步:跑第一个补全

新建一个 .py 文件,输入:

# 计算一个列表的平均值
def average(nums):

按 Enter 后稍等 1~2 秒,CodeGeeX 会自动补全函数体。也可以选中一段代码,按 Ctrl+Shift+G 唤起对话面板,问它”这段代码有什么问题”。

常见踩坑

1. 网络波动导致模型下载失败:首次使用需要下载模型,几百兆到 2GB 不等,建议在网络好的时段一次性下完。
2. 插件与 VSCode 版本不兼容:VSCode 太旧(低于 1.75)可能装不上,升级到最新稳定版即可。
3. 补全反应慢:第一次请求要等几秒,后续会缓存提速;若一直慢,检查是否启用了过多语言。
4. 中文注释识别率低:尽量写”明确动作”的中文,比如”读取 csv 文件”比”搞个读 csv 的东西”效果好。
5. 企业内网限制:部分公司内网拦截外部 API,需要找 IT 配置白名单。
6. 误装到非官方插件:VSCode 商店里有多款同名插件,认准发布者为 aminer 的才是清华官方版。

初级用法

• 行内补全:在编辑器里写注释或函数名,等 CodeGeeX 出现灰色提示,按 Tab 采纳。
• 代码翻译:用 Python 实现一段逻辑,选中后让 CodeGeeX 翻译成 Java,适合跨语言学习。
• 解释代码:选中看不懂的代码块,在对话面板输入 “请解释这段代码”,它会用中文回答。

高级玩法

• 自定义 prompt 模板:在设置里编辑 codegeex.prompt,加入项目特有的代码规范要求。
• 本地推理加速:在配置中把模型切换为 INT4 量化版,适合显存较小的机器。
• CI 集成:用 CodeGeeX 的 CLI 模式接入流水线做自动审查。

小技巧

• 在 settings.json 里加 "codegeex.enable": true 确保插件始终启用。
• 想要更精准的中文补全,可以在 prompt 头部加一句”请用中文写注释”。
• 改完一个函数,按 Alt+Shift+G 让它直接生成对应单元测试。
• 在代码块上右键选择 “CodeGeeX: Add Comments”,一键补齐中文注释。
• 多行补全时,先按 Enter 让它建议整段,不合适再 Esc 撤回,比一行行试更高效。
• 写 Python 时把 # type hints 注释加在函数头,CodeGeeX 补全类型注解更准。
• 写 SQL 时表名用复数(users 而不是 user),AI 补全字段联想更合理。
• 在 JetBrains IDE 里把 CodeGeeX 设置为”按需触发”(Manual),减少误触发。
• 调试时选中 stack trace,问 CodeGeeX “这是什么问题”,AI 会给出修复方向。
• 团队统一 CodeGeeX 配置,把 codegeex.config 提交到 Git 仓库,新人上手更快。

与其他 AI 编程工具的对比

CodeGeeX 和 GitHub Copilot、Cursor、Codeium 的定位有重合,但差异也很明显。Copilot 英文最强、生态最完善,适合写英文项目;Cursor 走”AI 原生编辑器”路线,Composer 多文件改写惊艳,但收费;Codeium 免费且轻量,IDE 兼容性好;CodeGeeX 国产开源、对中文注释最友好,且模型权重可下载,适合对数据合规有要求的团队。如果你做国产化项目、企业内网部署、学校教学,CodeGeeX 是少数能”三连击”的方案:开源 + 免费 + 中文优化。

适合的项目场景

CodeGeeX 特别适合这几类场景:

• 高校计算机课程:清华、北大等高校在编程课里用 CodeGeeX 做教学演示,学生可以一边学语法一边看 AI 补全。
• 企业内部代码补全:金融、电信、政务行业的代码不外传,CodeGeeX 提供私有化部署版本,模型在公司机房跑。
• Python/Java 项目:对这两类语言的补全质量最高,尤其是数据科学、企业级应用。
• 中文教学项目:老师用 CodeGeeX 演示”中文注释 → 代码”的过程,学生更易理解。

进阶使用建议

如果你想从”能用”到”用好”,可以参考清华 KEG 实验室发布的几篇研究论文:CodeGeeX 的多语言能力来自多任务训练,它在 20+ 语言的 benchmark 上达到开源模型的领先水平。但即便如此,它仍不如 GPT-4、Claude 这类闭源大模型全面。建议把 CodeGeeX 当作”日常补全工具”,遇到难题再切换到更强的闭源模型,搭配使用效果最佳。

另外,CodeGeeX 团队持续在更新模型版本,关注他们的 GitHub 仓库(https://github.com/THUDM/CodeGeeX)可以第一时间拿到新版模型和功能。清华每年还在 KEG 招募实习生参与模型训练,有兴趣读研的同学可以关注实验室主页。

参考链接

• CodeGeeX 官网:https://codegeex.cn
• VSCode 插件市场:https://marketplace.visualstudio.com/items?itemName=aminer.codegeex
• GitHub 开源仓库:https://github.com/THUDM/CodeGeeX
• KEG 实验室:http://keg.cs.tsinghua.edu.cn
• 清华 THUDM 项目主页:https://github.com/THUDM

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。