在 Ubuntu 系统中为 VS Code 离线安装 CodeGeex 扩展，需先从联网设备下载官方正版 aminer.codegeex ≥2.6 版本 .vsix 文件，再通过命令行 code --install-extension 或图形界面 “Install from VSIX” 安装，最后验证 codegeex.localMode 配置项是否存在以确认成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Ubuntu 系统中为 VS Code 离线安装 CodeGeex 扩展，必须先从有网环境获取正确版本的 .vsix 文件，再通过命令行或图形界面导入——直接在离线机上搜索安装会失败，因为 Marketplace 无法访问。
获取适配的 CodeGeex .vsix 文件
打开任意联网设备的浏览器，访问 CodeGeeX 官方扩展页 → 页面右侧“More Info”区域确认发布者为 【Zhipu AI】、标识符为 【aminer.codegeex】、版本号 ≥ 2.6（低于此版本不支持本地模式） → 点击“Download Extension”，保存文件如 aminer.codegeex-2.6.0.vsix。
注意：不要下载名字含 “CodeGeeX Pro” 或发布者为 “CodeGeeX Team” 的第三方变体，它们不兼容离线配置。
拷贝文件到 Ubuntu 离线机
将下载好的 .vsix 文件通过 U 盘、内网 SCP 或其他离线传输方式复制到 Ubuntu 机器的任意目录，例如 /home/username/downloads/。
确保目标路径不含中文、空格或特殊符号，否则命令行安装可能报错。
安装扩展（两种方法任选其一）
方法一：命令行安装（推荐）
打开终端 → 进入 .vsix 所在目录 → 执行：code --install-extension aminer.codegeex-2.6.0.vsix → 安装成功后终端会输出 “Extension 'aminer.codegeex' was successfully installed.”
若提示 “command 'code' not found”，说明 VS Code 未加入系统 PATH，需使用完整路径，例如：/usr/share/code/bin/code --install-extension /home/username/downloads/aminer.codegeex-2.6.0.vsix。
方法二：图形界面安装
启动 VS Code → 按 Ctrl+Shift+X 打开扩展面板 → 点击右上角 ⋯ → 选择 “Install from VSIX…” → 浏览并选中刚复制的 .vsix 文件 → 点击 “Install”。
安装完成后，VS Code 右下角会弹出绿色提示框，且扩展列表中显示 “CodeGeeX: AI Code AutoComplete, Chat, Auto Comment” 已启用。
验证安装是否生效
重启 VS Code → 按 Ctrl+, 打开设置 → 搜索 codegeex.localMode → 若能查到该配置项并可勾选，说明插件已正确加载。
若搜索不到该关键词，代表安装失败或版本过低——请返回第一步重新下载 ≥2.6 版本的 .vsix 文件。
