在 openvscode server 中部署 codegeex 插件需手动安装 ≥2.6 版本 .vsix 文件，启用 localmode 并配置 apibase 为 http://localhost:11434/v1/chat/completions、model 为 codegeex4、apikey 留空，且须确保 ollama 已运行 codegeex4 模型并监听 11434 端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 OpenVSCode Server（即 code-server）中部署 CodeGeeX 插件，需绕过官方 Marketplace 限制、手动安装兼容版本，并配置本地 API 通道——因为默认网络策略会拦截远程模型请求，且插件无法自动识别 server 环境中的认证上下文。
确认 OpenVSCode Server 环境可用性
登录到你的 OpenVSCode Server 实例（如 https://your-server:8443），确保页面能正常加载，左下角显示“code-server v4.10+”或更高版本。低于 v4.9 的版本不支持 VSIX 扩展的完整签名验证机制，会导致插件安装后立即禁用。
打开命令面板（Ctrl+Shift+P），输入 “Developer: Show Logs”，检查输出中是否有 “Extension host terminated” 或 “Unsupported runtime” 报错——如有，必须先升级 code-server 容器镜像。
下载并手动安装 ≥2.6 版本的 CodeGeeX .vsix 文件
方法一：从联网机器获取官方插件包
在有外网的机器上打开 VS Code Marketplace 页面，搜索 “CodeGeeX: AI Code AutoComplete, Chat, Auto Comment”，认准发布者为 Zhipu AI，点击右侧“Download Extension”，保存为 zhipuai.codegeex-2.6.0.vsix（或更高 patch 版本）。
方法二：直接使用可信镜像源（推荐离线场景）
访问清华镜像站提供的预编译包：https://mirrors.tuna.tsinghua.edu.cn/vscode/extensions/zhipuai.codegeex-2.6.0.vsix，用 curl 或 wget 下载到本地，再上传至 OpenVSCode Server 所在服务器的任意目录（如 /home/coder/ext/）。
【注意】旧版（≤2.5.x）插件无 localMode 开关，无法启用离线模式，强行安装将导致侧边栏图标灰显且不可点击。
在 OpenVSCode Server 中安装 VSIX 插件
第一步：打开扩展视图 → 点击右上角三个点 → 选择 “Install from VSIX…”
第二步：在弹出的文件选择框中，定位并选中你上传的 zhipuai.codegeex-2.6.0.vsix 文件
第三步：点击 “Install” 后等待提示 “Extension installed successfully”，此时不要点击 “Reload Required” 弹窗中的 Reload 按钮——这会导致当前 session 断开且未保存配置丢失。
第四步：关闭弹窗，直接按 Ctrl+R 刷新浏览器标签页（保持 session cookie 不失效），刷新后左侧活动栏应出现蓝色 X 图标。
配置本地模式以绕过云服务依赖
OpenVSCode Server 默认禁用所有需要调用外部 API 的插件功能，因此必须强制启用本地推理通道：
① 打开设置（Ctrl+,）→ 在搜索框输入 codegeex.localMode → 勾选该项
② 继续搜索 codegeex.apiBase → 将值设为 http://localhost:11434/v1/chat/completions（注意路径末尾必须是 /v1/chat/completions，填 /api/completion 或漏掉 /v1 会导致 404）
③ 搜索 codegeex.model → 输入 codegeex4（与 Ollama 中运行的模型名严格一致）
④ 搜索 codegeex.apiKey → 清空其值（留空，否则插件会优先尝试连接智谱云）
【关键前提】Ollama 必须已在同一台服务器上运行 codegeex4 模型，并监听 11434 端口；若 Ollama 运行在另一台机器，请将 localhost 改为对应内网 IP（如 10.0.1.5），且确保防火墙放行该端口。
验证插件是否真正就绪
点击左侧 CodeGeeX 图标，观察右下角是否出现 “Ready” 提示（非 “Login required” 或 “Connecting…”）。
新建一个 Python 文件，输入 def hello(): 并换行，停顿 1.5 秒——若看到灰色的 return "Hello, World!" 自动浮现，说明隐匿模式已激活。
选中任意一行代码，按 Ctrl+Enter：若右侧弹出候选代码块而非报错弹窗，则本地 API 通信成功。
