想要充分发挥 CodeGeeX 的效能，仅安装本体插件远远不够——必须与 Python、Pylance、autopep8 这三款扩展协同部署，缺一不可。同时，VS Code 版本需不低于 1.68.0，否则右下角图标不会出现，Tab 补全功能也无法启用。
为何即便繁琐也要如此配置？因为 CodeGeeX 自身并不携带运行环境，代码补全与解释功能完全依赖语言服务协议（LSP）驱动。Python 扩展提供基础语言支持，Pylance 负责智能语义分析，autopep8 则处理代码格式化。四者协同工作，才能串联起完整的代码生成流程。任何一项缺失，都会导致图标显示为灰色，Tab 键按下毫无响应。
优先安装 CodeGeeX 插件本体
启动 VS Code，点击左侧活动栏的扩展图标（四个方块），搜索 CodeGeeX，确认发布者为 Zhipu AI 或 THUDM（两者均保持更新），安装完成后务必点击“重新加载”。
此步骤看似简单，拖拽安装即可。但有一个常见问题：若右下角图标未出现，不必急于重装，应首先检查 VS Code 版本是否低于 1.68.0——低于此版本时安装会静默失败，系统不会弹出任何错误提示。
接着安装推荐扩展包（一键式操作）
CodeGeeX 官方并未提供专属的 Extension Pack，但社区已验证出一套稳定组合：Python + Pylance + autopep8 + CodeGeeX。安装齐这四个扩展，即可覆盖 90% 的中文代码生成场景。
方法一：从扩展市场手动补充（适合首次配置）
① 按照顺序在扩展市场搜索以下四个插件：
ms-python.python（Python 扩展本体）→
ms-python.pylance（智能分析核心）→
ms-python.autopep8（自动格式化工具）→
zhipu.codegeex（CodeGeeX 本体，若已安装则跳过）。
方法二：命令行批量安装（适合多机部署）
第一步：新建一个文本文件，命名为 codegeex-stack.txt，每行写入一个插件 ID：
ms-python.python
ms-python.pylance
ms-python.autopep8
zhipu.codegeex
第二步：确保 code 命令已加入系统 PATH 环境变量（在终端输入 code --version 可返回版本号即表示成功）。
第三步：在文件所在目录打开终端，执行以下命令：
- PowerShell：
Get-Content codegeex-stack.txt | ForEach-Object { code --install-extension $_ --force } - macOS/Linux：
cat codegeex-stack.txt | xargs -I {} code --install-extension {} --force
【--force 参数不可或缺】 若省略该参数，遇到已安装的插件时安装过程会暂停等待确认，导致脚本直接卡死。
离线环境中安装 CodeGeeX 及其依赖项
当完全无法联网时，code --install-extension zhipu.codegeex 会报错“Failed to fetch”——因为 VS Code 默认从 Marketplace 拉取最新 .vsix 文件，网络不通则无法完成。
需要提前在有网络连接的机器上下载全部 .vsix 文件：
打开 https://marketplace.visualstudio.com/items?itemName=zhipu.codegeex → 滚动到页面底部，点击“Download Extension” → 将下载链接中的 /vspackage 替换为 .vsix → 保存文件。
同理，ms-python.python、ms-python.pylance、ms-python.autopep8 的 .vsix 文件也按照此方式下载（注意 URL 中携带版本号，例如 /2024.6.0/vspackage，更改后缀前需保留完整路径）。
将所有 .vsix 文件放入同一个文件夹，然后在终端中执行以下命令：
- bash：
for ext in *.vsix; do code --install-extension "$ext" --force; done - PowerShell：
Get-ChildItem *.vsix | ForEach-Object { code --install-extension $_.FullName --force }
如果遇到“Extension signature verification failed”提示，说明企业镜像已禁用签名校验——此时可添加参数 --disable-extension-corruption-check 临时绕过，但建议仅在测试环境中使用。