CodeGeeX
支持代码生成、代码翻译与注释编写的 AI 编程助手。
CodeGeeX 是智谱 AI 的编程助手插件，提供代码补全、注释、代码互译、问答和单测生成等能力。本指南围绕当前官方插件说明展开，并区分 IDE 插件与开源模型仓库。
CodeGeeX 能做什么
在编辑器中选定代码再调用解释、注释或测试功能，能让任务范围更清楚。官方插件说明给出右键菜单与 Ask CodeGeeX 侧栏入口。
官方仓库另有模型与研究代码，其许可证和运行方式不等于在线插件服务。本轮旧企业手册请求返回 410，未把该失效入口中的企业功能作为个人插件能力。
按上下文或注释生成代码
输入代码时可得到补全，也可先用自然语言注释描述小函数，再生成候选实现。官方说明用 Tab 采纳，其他按键可取消推荐。
生成中英文代码注释
选中代码后，通过 CodeGeeX 右键菜单添加注释；官方明确支持中文和英文。需核对参数、返回值和异常说明是否符合真实实现。
从选定函数生成测试
可通过右键菜单生成单测，或在问答侧栏使用预置命令。生成后还需要匹配项目测试框架、导入路径及依赖。
解释与审查具体代码
Ask CodeGeeX 提供解释、修复等预置指令；对已修改文件还可进行代码变更审查。选区能影响指令作用范围，未选择代码时可能处理更大范围。
- 核心用途
- 代码补全、注释、问答与单测草稿
- 可完成的工作
- 理解函数、补充测试和转换代码片段
- 如何开始
- 安装官方插件，选中代码后调用菜单
- 使用条件
- 插件页提供免费入口；IDE 兼容性需核对
如何使用 CodeGeeX
- 核对 IDE 与插件版本
从官网或官方发布的插件市场入口安装；JetBrains 版本兼容范围需以具体版本记录为准。
- 打开工程并完成接入
在当前 IDE 中打开项目，从 CodeGeeX 图标进入侧栏，按实际插件提示完成必要账户步骤。
- 选中一段目标代码
使用右键菜单选择解释、注释或生成单测，或在 Ask CodeGeeX 中使用相应预置命令。
- 检查输出后再采纳
补全可用 Tab 接受；测试与转换代码需检查依赖及行为，运行对应样例后再保留。
为函数补齐测试草稿
适合：已有测试框架的开发者
- 准备输入
- 目标函数、依赖和期望异常情况
- 操作方法
- 编辑建议：选中函数，从 CodeGeeX 菜单生成单测，补充空输入与异常边界，再放入现有测试目录执行。
- 预期交付物
- 可运行的函数测试候选
- 人工检查
- 确认断言验证真实需求，而不是简单复述当前实现。
为遗留代码补充中文说明
适合：接手旧模块的维护者
- 准备输入
- 目标代码片段和业务含义
- 操作方法
- 编辑建议：先用解释功能梳理逻辑，再生成中文注释，人工删去不确定推断并补充业务依据。
- 预期交付物
- 准确的函数与行内说明
- 人工检查
- 检查注释是否过时、重复或声称不存在的行为。
转换小段编程语言
适合：进行跨语言迁移的工程师
- 准备输入
- 短代码片段、目标语言与输入输出样例
- 操作方法
- 编辑建议：说明目标语言并生成转换候选，用相同样例比较结果，再检查类型、异常和标准库差异。
- 预期交付物
- 可验证的目标语言实现
- 人工检查
- 语言互译不代表整个项目的依赖、构建和性能都能自动迁移。
界面与参考图片
开始前需要了解
免费入口不等于所有企业功能
公开插件页写有免费使用入口，但不能据此推断企业部署、模型托管和所有增值服务均免费。
新 IDE 版本需检查兼容范围
本轮读取的 JetBrains 最新列出版本 2.27.4-223 适配 build 223.0—253.*；超出范围时不可仅凭产品名称判断兼容。
模型代码许可和服务条款不同
官方研究仓库分别列出代码 Apache-2.0 与模型许可证。使用插件、下载模型和自行部署的条件应分别核对。
公开插件提供免费入口；企业部署与模型许可需另核，IDE 兼容性按版本检查。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
能生成中文注释吗？
官方插件说明明确支持中英文注释；可选中代码后使用右键菜单的生成注释功能。
单测生成后可以直接当作通过吗？
不可以。它生成测试代码候选，仍需在项目环境运行并检查断言、依赖和边界条件。
插件与开源模型是同一个使用方式吗？
不是。插件在 IDE 中使用服务，模型仓库另有代码、权重和许可说明，需要分别阅读。
新的 JetBrains IDE 一定兼容吗？
应查看市场的具体插件版本范围。本轮版本记录给出 build 223.0—253.*，没有据此承诺更高版本兼容。
