必须手动下载指定版本.vsix文件并安装，因Marketplace自2025年起已移除历史版本下载入口；需匹配VS Code版本选择CodeGeex v2.3.5–v2.6.0区间版本，从GitHub Release页获取文件，禁用冲突插件，确保路径无空格/中文，安装后必须重启VS Code。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 VS Code 中安装 CodeGeex 历史版本，必须绕过 Marketplace 仅提供最新版的限制，直接获取并安装指定版本的 .vsix 文件——官方市场自2025年起已移除历史版本下载入口，点击“Version History”不再显示任何下载链接。
确认当前 VS Code 版本并锁定兼容目标
按 Ctrl+Shift+P 打开命令面板 → 输入 Help: About → 回车，查看顶部显示的 VS Code 版本号（如 1.89.2）。【CodeGeex v2.4.0 及更早版本不支持 VS Code ≥1.90.0】，若你的版本为 1.90.0 或更新，请选择 v2.5.1～v2.6.0 区间版本；若为 1.79.2，则优先选 v2.4.0 或 v2.3.5。
这一步跳过会导致安装后插件被自动禁用，且控制台报错 “Extension 'aminer.codegeex' is not compatible with Code X.XX.X”。
从 GitHub Release 页面获取可靠 .vsix 文件
方法一：直链下载（推荐）
在浏览器中打开：https://github.com/aminer/codegeex/releases
向下滚动至 Releases 列表，找到发布时间早于你 VS Code 版本发布日期的 tag（例如 VS Code 1.79.2 发布于 2023 年 9 月，则避开 2023-10-01 后的版本）→ 点击该 tag → 在 Assets 区域找形如 aminer.codegeex-2.4.0.vsix 的文件 → 直接点击下载。
方法二：手动构造 URL（适用于 Release 页未列出 vsix 的情况）
将以下模板中的版本号替换为你需要的版本：https://github.com/aminer/codegeex/releases/download/v2.4.0/aminer.codegeex-2.4.0.vsix
注意路径中 /download/vX.Y.Z/ 和文件名中 -X.Y.Z.vsix 必须严格一致，否则返回 404。
⚠️ 不要使用 Marketplace 页面右上角“Download Extension”按钮生成的链接——它含临时鉴权 token，离开页面即失效。
安装前准备：清理冲突与校验环境
关闭所有 VS Code 实例。若此前装过 CodeGeex 或其他 AI 插件（如 Tabby、Continue），请先卸载：
按 Ctrl+Shift+X → 搜索 Tabby → 点击其右下角 ⋯ → Uninstall → 重复操作至无同类插件残留。
检查目标目录路径：
将下载好的 aminer.codegeex-2.4.0.vsix 复制到一个纯英文、无空格、无中文字符的路径下，例如：/home/user/vscode-ext/（Linux/macOS）或 C:\vsix\（Windows）。【路径含中文或空格会导致 code --install-extension 静默失败】
执行安装（两种方式任选其一）
方法一：命令行安装（稳定、可验证）
第一步：打开终端（Linux/macOS）或 PowerShell（Windows）
第二步：进入 vsix 所在目录 → 执行：code --install-extension aminer.codegeex-2.4.0.vsix
第三步：等待终端输出 Extension 'aminer.codegeex' was successfully installed.
方法二：图形界面安装（适合不熟悉终端者）
启动 VS Code → 按 Ctrl+Shift+X → 点击右上角 ⋯ → 选择 Install from VSIX... → 浏览并选中该文件 → 点击 Install。
安装完成后，必须重启 VS Code —— 不重启则插件不会加载，状态栏不会出现 CodeGeex 图标，Ctrl+Enter 补全功能也不生效。
