CodeGeeX 的实时智能补全功能虽然听起来很理想,但默认设置下使用体验往往不尽如人意。要么等待三秒才弹出建议,要么光标稍停就胡乱补全——要让 AI 真正跟上你的编码节奏,核心在于精准调整触发时机、语言范围以及模型响应方式。以下四步配置缺一不可。

启用自动触发并设置合适的延迟
插件安装完成后默认处于静默状态——不会主动提示。因此第一步务必开启自动触发开关,并将响应速度调整到合适的档位。
首先按下 Ctrl + , 打开 VS Code 设置界面,搜索 codegeex.autoTrigger,勾选启用。特别提醒:如果不执行这一步,后续所有设置均不会生效。
然后搜索 codegeex.delay,将数值改为 300(单位毫秒)。这个值比默认的 500 毫秒响应更快,同时又不会像 200 毫秒那样容易误判光标停顿——例如你刚输入完括号打算加空格,它却抢先弹出补全。
最后搜索 codegeex.model,选择 codegeex-4(Lite 版)。该模型支持流式输出,适合边输入边查看建议逐渐浮现;而 codegeex-6b 虽然准确度更高,但返回的是整块内容,无法实现逐字补全的体验。
限定它只在特定编程语言中工作
让 AI 只在你真正编写的编程语言中发挥作用,避免在 Markdown 或配置文件中胡乱推荐。
方法一:在设置中搜索 codegeex.languageSupport,点击右侧的“编辑在 settings.json 中”,在数组里添加你常用的语言,例如:
"codegeex.languageSupport": ["python", "typescript", "html", "ja va"]
方法二:如果需要更严格的控制,搜索 codegeex.languageWhitelist,同样编辑 JSON,填入相同的语言列表。白名单的优先级高于 languageSupport,同时配置时以白名单为准。
注意:右下角状态栏必须显示对应的语言标识(例如 Python),否则即使配置了 html,在 .html 文件中也不会触发语义化标签补全。
让 Tab 键真正用于采纳 AI 建议
VS Code 默认将 Tab 键用于缩进,而非确认补全。如果不修改此设置,即使 CodeGeeX 弹出再好的建议,按下 Tab 键也不会有任何反应。
在设置中搜索 editor.tabCompletion,将值设为 "onlySnippets"。这样 Tab 键仅对代码片段和 AI 建议生效,缩进仍可通过 Shift+Tab 或空格处理,互不干扰。
验证方法:打开一个 .py 文件,输入 def test(): 回车,光标停在缩进处等待半秒,出现灰色预览后按 Tab 键,代码应该直接插入。
配置好 API 密钥并验证网络连通性
没有 API 密钥就像没有安装 SIM 卡的手机——界面显示正常,但无法发出任何请求。
首先,登录智谱 AI 官网,进入“API 密钥管理”页面,创建一个新密钥,完整复制(包含 sk- 前缀)。
然后在 VS Code 设置中搜索 codegeex.apiKey,粘贴密钥并保存。
最后验证连通性:打开命令面板(Ctrl + Shift + P),输入 Developer: Toggle Developer Tools,切换到 Console 标签,粘贴并执行:
fetch('https://api.bigmodel.cn/v1/ping').then(r => r.text()).then(console.log)
如果返回 "pong",说明密钥有效且网络通畅。密钥未配置或已过期会导致补全窗口空白、无响应,且系统不会报错,这一点需要特别留意。
