CodeGeeX 明明已经安装完成,但在编写代码时却始终无法弹出自动补全建议?别急着怀疑插件没有正确安装,多数情况下,问题出在自动补全链路被配置、权限或环境层面的某个环节卡住了——只要这一步没走通,即便模型再强大也无法输出任何内容。下面按照顺序逐一排查,基本能够解决问题。

确认插件已安装并启用
点击左侧扩展图标(Ctrl+Shift+X)→ 搜索 CodeGeeX → 确认发布者为 Zhipu AI → 若未安装则点击“安装”,已安装则检查右侧是否显示“启用”状态;【若显示“禁用”或无反应,需先点击启用再重启 VS Code】。
启用自动触发开关
按下 Ctrl + , 打开设置界面;
在搜索框中输入 codegeex.autoTrigger;
勾选该选项,确保其状态为启用;
这一步如果不做,后续所有配置都无法生效。若使用 JetBrains IDE(如 IDEA、PhpStorm、Rider),进入 Settings → CodeGeeX → Auto Completion,将开关设为开启。
配置有效 API 密钥
方法一:获取并粘贴密钥
访问 https://open.bigmodel.cn/ 登录智谱AI账号 → 进入“API 密钥管理” → 点击“创建新密钥” → 完整复制生成的密钥字符串(含 sk- 前缀);
在 VS Code 设置中搜索 codegeex.apiKey → 粘贴密钥 → 保存设置。
方法二:验证密钥是否生效
打开命令面板(Ctrl+Shift+P)→ 输入 CodeGeeX: Test API Connection → 回车执行;若返回 Connection OK,说明密钥可用;若报错 Unauthorized 或超时,则密钥无效或网络不通。
限定语言范围并确认当前文件匹配
① 在 VS Code 设置中搜索 codegeex.languageWhitelist;
② 点击“编辑设置(JSON)” → 在数组中添加你常用的语言标识符,例如:["python", "ja vascript", "typescript", "ja va", "csharp"];
③ 保存 settings.json;
④ 关闭并重新打开一个对应语言的文件(如 index.ts),光标置于函数体内,输入 console. 或 async 观察是否触发补全。注意:仅修改配置不重启文件不会生效,必须新开同类文件。
调低延迟并选择支持流式响应的模型
第一步:在 VS Code 设置中搜索 codegeex.delay → 将数值改为 200(单位毫秒);
第二步:搜索 codegeex.model → 选择 codegeex-4;
延迟设为 200 毫秒后,只要输入暂停不到 1/5 秒,补全就会启动;选用 codegeex-4 是因它支持服务端流式响应,而 codegeex-6b 默认返回整块结果,无法实现“边生成边显示”的流式体验。
手动唤起验证各环节是否就绪
在已配置好的 .py 或 .ts 文件中,光标置于合法语法位(如函数体内部、if 块内)→ 按 Ctrl+Enter → 观察是否弹出灰色预览建议;
若出现建议,按 Tab 接受;若仍无反应,说明某环节配置未生效,需逐项回溯检查。
