在 VS Code 中配置 CodeGeeX，实现“输入冒号自动弹出建议、敲击点号及时列出方法”的智能代码补全功能，其实并不复杂。核心步骤可归纳为四步：安装插件、配置密钥、开启补全开关、设置语言支持。若遗漏任何一步，光标后很可能无法获得任何补全建议。

首先讲解安装流程。打开 VS Code，点击左侧活动栏的扩展图标（或按下快捷键 Ctrl+Shift+X），在搜索框输入 CodeGeeX，确认发布者为 Zhipu AI，然后点击“安装”。安装完成后务必点击“重新加载”——这一步不可忽略，否则插件虽显示已安装，却处于未激活状态，后续配置均无法生效。

配置有效 API 密钥

接下来进行密钥认证。登录智谱AI账号，进入“API 密钥管理”页面，创建一个新密钥，完整复制生成的那一串字符（包含 sk- 前缀）。返回 VS Code，按 Ctrl+, 打开设置，搜索 codegeex.apiKey，将密钥粘贴进去并保存。

这里有一个常见陷阱：密钥首尾不能包含空格，不能携带额外换行符，也不能使用已删除或禁用的旧密钥。否则补全请求会直接返回 401 错误——但 VS Code 控制台不会显示任何提示，你只会看到“一直转圈然后没反应”的情况。

开启自动补全触发模式

这一步是让补全真正“动起来”的关键开关。

方法一：自动触发（日常推荐）。在设置中搜索 codegeex.autoTrigger，勾选启用。之后在合法的语法位置（例如函数体内部、语句末尾、空行）停顿大约 800 毫秒，状态栏右下角的 CodeGeeX 图标会开始旋转，灰色预览代码便会自动出现。

方法二：手动唤起。按下 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS），右侧会展开一个多候选代码面板，选择所需代码后点击“Use Code”即可插入。该方法适合在调试环境或对干扰较敏感的场合使用。

注意：如果已勾选 autoTrigger 却始终不显示建议，请先检查光标是否位于字符串内部、注释末尾，或者语法错误的行上——这些位置 CodeGeeX 会主动拒绝补全，以避免污染上下文。

校准语言支持与模型选择

第一步：确认当前文件语言模式正确。查看右下角状态栏的语言标识（例如“JavaScript”“Python”），如果显示为“Plain Text”，则需要点击并选择对应的语言。否则 CodeGeeX 不会加载该语言模型。

第二步：指定补全模型。在设置中搜索 codegeex.model，下拉菜单中选择 codegeex-4（响应迅速，适合日常补全）或 codegeex-6b（逻辑能力更强，适合复杂函数生成）。

第三步：开放语言白名单。搜索 codegeex.languageWhitelist，点击编辑，在数组中添加你常用的语言 ID，例如：

["javascript", "typescript", "python", "java", "go"]

不在这个列表中的语言（例如 .vue 或 .astro 文件）默认会被拦截——即使编写了注释，也不会触发补全。

验证补全是否就绪

新建一个 .js 文件，输入以下代码：

function greet(name) {
return `Hello, ${name}`;
}
greet(

将光标放在括号内，稍作等待。如果看到灰色预览文字，例如 "World" 或 "prompt" 等建议，则说明整条链路已打通。按下 Tab 即可直接插入。