要在 HBuilderX 中成功集成 CodeGeex，只需完成四个关键步骤：安装插件、配置 API 密钥、指定支持的语言、设置触发方式。虽然步骤不多，但每一步都不可或缺——否则远程模型将无法正常调用，代码补全与生成功能也会完全失效。

安装 CodeGeex 插件（务必重启编辑器）

启动 HBuilderX 后，从顶部菜单栏依次点击【工具】→【插件安装】。在弹出的窗口搜索框中输入 CodeGeex，确认发布者为“Zhipu AI”，随后点击安装按钮。安装完成后务必重启编辑器，否则插件不会加载，菜单栏也无法显示 CodeGeex 的相关入口。

获取并填入 API 密钥的两种方法

方法一：登录智谱 AI 开放平台（https://open.bigmodel.cn），进入【API 密钥管理】页面，点击【创建新密钥】并复制生成的密钥字符串。

方法二：若您已登录 codegeex.cn，可在个人中心的 API 设置中直接查看密钥。请注意，该密钥仅展示一次，刷新页面后便会消失，务必及时复制保存。

返回 HBuilderX，按 Ctrl+, 打开设置，左侧切换到【用户设置】，在搜索框中输入 codegeex.apiKey，找到对应的输入框粘贴密钥并保存。特别提醒：密钥错误或为空会导致所有 CodeGeex 功能变为灰色不可用，且控制台不会有任何报错提示——这是一个常见的隐蔽陷阱，不少用户都曾在此处遇到问题。

设置支持语言及自动补全功能

第一步：在设置中搜索 codegeex.languageWhitelist，点击右侧的“编辑设置(JSON)”，将默认值替换为数组格式，例如：["ja vascript", "vue", "html", "typescript"]，然后保存。

第二步：搜索 codegeex.autoTrigger，勾选以启用自动补全功能。设置完成后，在 .js 或 .vue 文件中输入函数名后紧跟空格或分号，系统将自动弹出代码补全建议。

第三步：若您不希望全局自动触发（例如编写注释或临时调试时，频繁弹出的补全可能干扰变量命名），可以取消勾选 autoTrigger，改为使用快捷键 Ctrl+Enter 手动调用补全面板——这种方式更精准，实现按需触发。