在 ubuntu 系统中离线安装 codegeex 扩展，需先从官网 marketplace 下载 ≥2.6 版本、发布者为 zhipu ai 的正版 .vsix 文件，再通过 code --install-extension 命令行安装，路径须无中文/空格，安装成功后终端显示“extension 'aminer.codegeex' was successfully installed.”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Ubuntu 系统中，当你无法联网访问 VS Code 扩展市场、或需批量部署 CodeGeex 到多台开发机时，必须跳过图形界面，直接用命令行安装已下载的 .vsix 文件——否则 VS Code 会提示“Unable to fetch extensions”并卡死在搜索页。
获取合法可用的 CodeGeex .vsix 文件
打开任意联网设备的浏览器，访问 https://www.php.cn/link/04a8ccbcb420e48b1165dffb899ebda8 → 点击页面右上角「VS Code 插件」按钮 → 跳转至官方 Marketplace 页面 → 在右侧「More Info」栏确认发布者为【Zhipu AI】、标识符为【aminer.codegeex】、版本号 ≥ 2.6 → 点击「Download Extension」保存文件（如 aminer.codegeex-2.6.0.vsix）。
⚠️ 注意：名字含 “CodeGeeX Pro” 或发布者为 “CodeGeeX Team” 的文件是第三方魔改版，会导致 codegeex.localMode 配置项缺失，后续无法启用离线模式。
将 .vsix 文件传入 Ubuntu 离线机
用 U 盘拷贝或内网 SCP 传输该 .vsix 文件到 Ubuntu 机器，例如存入 /home/yourname/vsix/ 目录。
确保路径中不包含中文、空格或括号，比如 /home/张三/下载/codegeex.vsix 会导致 code --install-extension 命令解析失败并静默退出——它不会报错，但扩展实际未安装。
执行命令行安装
第一步：打开终端，进入 .vsix 所在目录
第二步：运行安装命令
若 VS Code 已加入系统 PATH：
code --install-extension aminer.codegeex-2.6.0.vsix
若提示 command 'code' not found：
先查 VS Code 安装路径：ls /usr/share/code/ 或 which code → 找到 /usr/share/code/bin/code 后，用完整路径执行：
/usr/share/code/bin/code --install-extension /home/yourname/vsix/aminer.codegeex-2.6.0.vsix
安装成功后终端将输出：Extension 'aminer.codegeex' was successfully installed.
