必须一次性安装CodeGeeX本体(zhipu.codegeex)及配套工具链Python(ms-python.python)、Pylance(ms-python.pylance)、autopep8(ms-python.autopep8),缺一不可;VS Code版本须≥1.68.0,否则图标不亮或Tab无响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 VS Code 中一次性装好 CodeGeeX 本体及其配套工具链(比如 Python 支持、代码格式化、智能提示等),不能只点一个插件就完事——CodeGeeX 自身不带运行环境,必须搭配语言服务和 LSP 客户端才能触发补全与解释功能,漏掉任一关键扩展都会导致右下角图标不亮或 Tab 键无响应。
先装 CodeGeeX 插件本体
打开 VS Code → 点击左侧活动栏的扩展图标(四个方块)→ 在搜索框输入 CodeGeeX → 确认发布者为 Zhipu AI 或 THUDM(二者均为官方维护)→ 点击“安装” → 安装完成后点击“重新加载”。
这一步操作起来很简单,直接把文件拖进去就行。但注意:如果右下角没出现 CodeGeeX 图标,别急着重装,先检查 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 能返回版本号)→
第三步:在该文件所在目录打开终端,执行:Get-Content codegeex-stack.txt | ForEach-Object { code --install-extension $_ --force }(PowerShell)
或cat codegeex-stack.txt | xargs -I {} code --install-extension {} --force(macOS/Linux)。
【--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 放进同一文件夹 → 打开终端 → 执行:for ext in *.vsix; do code --install-extension "$ext" --force; done(bash)
或Get-ChildItem *.vsix | ForEach-Object { code --install-extension $_.FullName --force }(PowerShell)。
若提示 “Extension signature verification failed”,说明企业镜像禁用了签名校验——此时可加参数 --disable-extension-corruption-check 临时绕过,但仅限测试机使用。


















