必须配置api key并重启vs code才能启用codegeex全部功能；安装≥2.6版本官方插件、填入智谱ai平台密钥、开启autotrigger与suggestontype选项，并支持离线.vsix安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 VS Code 里让 CodeGeex 真正跑起来写代码、补全、解释，光装上插件远远不够——没配 API Key 就像给汽车加了油却没点火，所有功能都处于休眠状态，右下角图标不会转圈，Tab 键按下去也毫无反应。
安装官方插件
打开 VS Code，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）直接唤出扩展面板。
在搜索框中输入 CodeGeex，注意拼写是 G-e-e-x，不是 G-e-e-X 或 C-o-d-e-G-e-e-X；结果中认准发布者为 Zhipu AI 的那一项，图标是蓝白火箭，版本号必须 ≥ 2.6（低于此版本不支持本地模式且无法调用最新模型）。
点击“安装”按钮，等待进度条走完。安装完成后，VS Code 右下角会自动出现一个蓝底白箭头图标——这是插件已加载的视觉信号。
【务必重启 VS Code】 否则部分配置项（如 settings.json 中的 codegeex.* 字段）可能无法被识别，后续设置 apiKey 时会提示“未找到该设置项”。
填入有效 API Key
访问 智谱AI开放平台，登录你的账号（没有就注册一个，邮箱验证秒过）。
进入「API 密钥管理」页面 → 点击「创建新密钥」→ 复制生成的密钥字符串（形如 bb1a2b3c-d4e5-6f7g-8h9i-j0k1l2m3n4o5），只复制一次，关闭页面前务必保存好，该密钥无法二次查看。
回到 VS Code，按 Ctrl+, 打开设置界面，在搜索框输入 codegeex.apiKey，找到该项后双击空白处，粘贴密钥并回车确认。
这一步漏掉或填错，插件所有远程功能全部失效——你敲再多次 Tab，它都不会弹出补全建议，也不会响应右键菜单里的“Ask CodeGeex about selection”。
启用自动补全（隐匿模式）
方法一：快捷设置路径
按下 Ctrl+Shift+P 打开命令面板 → 输入 Preferences: Open Settings (JSON) → 回车进入 settings.json 编辑页。
在大括号内添加以下两行（注意末尾逗号）："codegeex.autoTrigger": true,"codegeex.suggestOnType": true
方法二：图形化开关
在设置界面搜索 codegeex.autoTrigger → 将其值从 false 改为 true → 再搜索 codegeex.suggestOnType → 同样设为 true。
开启后，你在 .py/.js/.ts 等主流语言文件中停顿约 0.8 秒，光标后就会浮现灰色建议；按 Tab 插入，Esc 放弃，→ 循环切换多个候选——这是最接近原生体验的补全方式。
离线环境专用：安装 .vsix 文件
若你的开发机完全断网，必须跳过 Marketplace，改用离线安装包。
第一步：在有网机器上打开浏览器，访问 CodeGeex 官方扩展页 → 确认发布者为 Zhipu AI、标识符为 aminer.codegeex、版本 ≥ 2.6 → 点击「Download Extension」下载 .vsix 文件（例如 aminer.codegeex-2.6.0.vsix）。
第二步：把文件拷到离线机任意不含中文与空格的路径，比如 /home/user/vscode-ext/。
第三步：打开终端，执行：code --install-extension /home/user/vscode-ext/aminer.codegeex-2.6.0.vsix
如果提示 command 'code' not found，说明 VS Code 没加入 PATH，改用完整路径：/usr/share/code/bin/code --install-extension /home/user/vscode-ext/aminer.codegeex-2.6.0.vsix
安装成功后，VS Code 会弹出通知，右下角出现蓝箭头图标，此时再按前述步骤配置 apiKey（需提前将密钥通过 U 盘带入）即可正常使用。
