CodeGeeX 教程：清华智谱的免费 AI 编程助手上手（2026）

如果你想要一个免费、不用翻墙、还能装进 VS Code 和 JetBrains 的 AI 编程助手，CodeGeeX 是绕不开的一个选择。它由清华大学团队和智谱 AI 联合开发，模型权重开源，个人开发者可以免费用，功能从代码补全、编程问答一路覆盖到 @Repo 读整个仓库、Agent 一句话生成整个项目。这篇 CodeGeeX 教程从安装讲起，带你把它的核心能力用起来，并和通义灵码、文心快码做个对比，帮你选对趁手的国产助手。

CodeGeeX 是什么

CodeGeeX 是智谱 AI 发布、基于大模型的 AI 编程辅助工具，由清华大学 THUDM 团队参与研发，常被称作「国产版 GitHub Copilot」。它和 Cursor、Trae 那种独立 IDE 不同——CodeGeeX 是以插件形态存在，装进你已经在用的编辑器里工作，不用换环境。它还有一个别家少见的特点：模型权重开源（如 CodeGeeX4-ALL-9B，128K 上下文），支持本地私有化部署，对数据敏感的团队友好。

支持哪些 IDE，怎么安装

CodeGeeX 适配面很广，主流编辑器基本都能装：

• Visual Studio Code（在扩展市场搜 CodeGeeX 安装）
• JetBrains 全家桶：IntelliJ IDEA、PyCharm、WebStorm、GoLand 等（在 Plugins 里搜 CodeGeeX）
• Visual Studio、HBuilderX、DeepIn-IDE 等其它主流 IDE
• Open VSX 市场（适配 VSCodium 等开源编辑器）

以 VS Code 为例：打开左侧扩展面板（Ctrl/Cmd + Shift + X）→ 搜索「CodeGeeX」→ 点 Install 安装 → 侧边栏出现 CodeGeeX 图标，点开用手机号或智谱账号登录即可开始使用。装好后先写几行代码试试补全，再打开对话框问一句，确认插件正常工作。

核心功能盘点

Agent 模式：一句话生成整个项目

CodeGeeX 较新的版本加入了 Agent 模式，思路和当下流行的 agentic 工具一致：你在 Agent 输入框里把项目需求描述清楚，它会自动创建项目文件夹、生成一整套代码文件，而不只是补一个函数。适合快速起一个原型或脚手架。实测时建议先从小需求（比如「用 Flask 写一个待办清单 API，带增删改查」）开始，看它生成的结构是否合你意，再逐步把需求写细。

@Repo：让 AI 读懂你的整个仓库

单文件问答只能看到当前打开的代码，遇到「这个函数在项目里哪些地方被调用」「照现有风格再加一个接口」这类需要全局视野的问题就抓瞎。CodeGeeX 的 @Repo 功能基于 RAG，会检索你整个仓库的相关代码再回答。用法很简单：在对话框输入 @Repo 引用当前项目，然后正常提问，它会带着仓库上下文来答。对维护中大型项目、快速上手别人的代码库尤其有用。

CodeGeeX 免费吗？和 GLM Coding Plan 什么关系

对个人开发者来说，CodeGeeX 插件的核心功能是免费的，代码补全、问答、解释这些日常够用，这也是它相比按量付费方案最大的吸引力。需要注意的是免费额度可能有每日次数上限（不同时期政策不一），重度使用或团队/企业场景会有更高档位。

另外别把 CodeGeeX 和「GLM Coding Plan」搞混：CodeGeeX 是智谱面向所有开发者的免费编程助手插件；GLM Coding Plan 则是智谱的付费编程套餐（基于 GLM-4.7 等旗舰模型，月费 20 元起），主打把国产模型接进 Claude Code 等工具高频使用。想要开箱即用、零成本上手，选 CodeGeeX；想用旗舰模型跑重度 Agent 工作流，看 GLM Coding Plan——IMAI 站内对后者有单独的实测教程。

CodeGeeX vs 通义灵码 vs 文心快码：国产免费助手怎么选

三者都免费、都是插件、都能补全和问答，差异主要在生态和特色：看重「模型开源 + 可本地部署 + 隐私可控」选 CodeGeeX；已经在用阿里云或喜欢 Qwen 系列选通义灵码；深度绑百度生态选文心快码。它们不冲突，完全可以都装上、在不同项目里对比着用，谁顺手用谁。

CodeGeeX 把「免费、开源、能本地部署」几件事凑齐，是国内开发者上手 AI 编程门槛最低的入口之一。但工具只是起点——真正拉开差距的，是你会不会把需求拆清楚、让 AI 在补全、问答、Agent 之间各司其职，把它用成稳定的生产力。想系统掌握用国产 AI 编程工具做出可交付项目的方法，欢迎来 IMAI 看看我们的体系化实战课程。