事情是这样的：要让 CodeGeeX 插件在 VSCode 中真正开始工作，光点击“安装”按钮远远不够。它有三个必须满足的先决条件——VSCode 版本需要达到要求、API 密钥必须正确配置、以及代码生成功能的手动开关也要打开。只要其中任何一项没有完成，编辑器右下角就不会出现那个熟悉的火箭图标，代码补全也毫无反应，甚至连错误提示都不会弹出。

首先检查 VSCode 版本是否满足要求

启动 VSCode，点击左下角的齿轮图标 → 选择“Help” → 再点击“About”，查看当前的版本号。CodeGeeX 插件现在要求 VSCode 版本不低于 1.75.0。如果你的编辑器版本还停留在 1.74.x 或更低，即便插件显示“已安装”，它也会悄悄罢工——既不会报错，也不给出提示，右下角同样找不到任何图标。

版本太低怎么办？直接去 VSCode 官方下载页面 获取最新的稳定版。Windows 用户在安装时记得勾选“Add to PATH”；macOS 或 Linux 用户安装完成后，建议在终端中执行 code --version 命令，确认命令行能正常调用 VSCode。

安装最新版 CodeGeeX 插件

方式一：在线安装（个人用户最常用）
按下 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）打开扩展面板 → 在搜索框输入 CodeGeeX → 确认发布者为 Zhipu AI（图标是一个蓝白火箭）→ 点击“Install”即可完成安装。

方式二：通过 VSIX 本地安装（企业或内网环境）
从 v4-enterprise.codegeex.cn 下载对应的 VSIX 文件 → 在扩展面板右上角点击「⋯」→ 选择“Install from VSIX” → 选中下载好的文件 → 安装完成后重启 VSCode。

特别提醒：插件安装后并不会自动生效，必须重启编辑器，否则侧边栏和右下角都看不到入口。

配置 API 密钥并强制启用代码生成

第一步：获取密钥
访问 智谱AI 开放平台，登录你的账号 → 进入“API 密钥管理” → 点击“创建新密钥” → 复制生成的以 sk-... 开头的字符串。

第二步：填入密钥
在 VSCode 中按 Ctrl+, 打开设置 → 搜索 codegeex.apiKey → 在输入框中粘贴刚才复制的密钥 → 保存设置（这一步不需要重启编辑器）。

第三步：强制打开代码生成开关
仍然在设置界面中，搜索 codegeex.enableCodeGeneration → 勾选这个选项。这一步特别容易被忽略：默认状态下这个开关是关闭的，如果不手动勾选，插件永远不会生成任何代码，补全功能就一直是空白。

第四步：验证是否配置成功
重启 VSCode → 新建一个 .py 或 .js 文件 → 输入几行代码后停顿 1–2 秒 → 观察右下角是否出现一个旋转的蓝白火箭图标。看到这个图标，就说明 CodeGeeX 已经准备就绪，可以正常工作了。