必须切断云端依赖、强制调用本地Ollama托管的codegeex4模型，并完成三项核心配置：一、启用codegeex.localMode；二、设置codegeex.apiBase为http://localhost:11434/v1/chat/completions；三、指定codegeex.model为codegeex4且apiKey为空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在无网络连接的电脑上让 VSCode 中的 CodeGeeX 插件稳定输出代码补全建议，必须切断所有云端依赖路径，强制其调用本地 Ollama 托管的 codegeex4 模型，并确保三项核心配置全部生效——缺一不可，否则补全框始终空白或快捷键无响应。
提前准备离线可用的插件与模型文件
官网 Marketplace 在离线机上完全不可访问，必须在有网机器上完成全部资源获取并拷贝至目标设备。
打开 VS Code Marketplace 页面，搜索“CodeGeeX: AI Code AutoComplete, Chat, Auto Comment”，确认发布者为 Zhipu AI、版本号 ≥ 2.6（旧版无 localMode 开关），点击“Download Extension”下载 .vsix 文件（如 zhipuai.codegeex-2.6.0.vsix）。
在有网机器执行 ollama pull codegeex4，下载完成后将整个 ~/.ollama/models/ 目录完整复制到离线机对应用户路径下：Windows 为 C:\Users\<username>\.ollama\models\</username>，Linux 为 /home/<user>/.ollama/models/</user>。
【注意】不要只拷贝单个 GGUF 文件，Ollama 需要完整的 manifest.json + blobs 子目录结构才能识别模型，否则 ollama list 始终为空。
启动并验证本地模型服务
Ollama 必须运行且监听插件可访问的地址，默认端口 11434 常被 Docker 或旧版服务占用，冲突会导致插件静默失败。
Windows 用户打开资源监视器 → “网络”选项卡 → 查找 PID 对应进程，结束所有占用 11434 端口的程序；Linux/macOS 用户执行 lsof -i :11434 或 netstat -tuln | grep 11434 定位并 kill 进程。
启动 Ollama 服务：Windows 下双击开始菜单中“Ollama”快捷方式，或命令行执行 ollama serve；Linux 用户执行 systemctl start ollama 并确认 systemctl is-active ollama 返回 active。
保持终端运行 ollama run codegeex4，看到 Send a message 提示即表示模型加载成功；此时另开终端执行 curl http://localhost:11434/api/tags，若返回包含 "name": "codegeex4" 的 JSON，则服务就绪。
配置 CodeGeeX 插件启用本地模式
VSCode 设置界面里“登录”按钮在离线状态下点不动是正常现象，所有验证逻辑已被跳过——真正起作用的是以下三项手动配置，顺序不能错。
第一步：按下 Ctrl + , 打开设置 → 搜索 codegeex.localMode → 勾选启用。这是总开关，不勾选则后续所有配置无效。
第二步：搜索 codegeex.apiBase → 将值设为 http://localhost:11434/v1/chat/completions。【末尾路径必须严格为 /v1/chat/completions，填成 /chat/completions 或 /v1/completions 将导致 404 错误且无任何提示】
第三步：搜索 codegeex.model → 手动输入 codegeex4（注意不是 codegeex-4 或 codegeex-6b）；同时搜索 codegeex.apiKey → 清空该字段内容，留空。
重启 VSCode，打开一个 .py 或 .js 文件，在函数体内输入 for i in range( 后停顿 1 秒，若出现补全建议框则配置成功。
