CodeGeeX离线模式：VSCode基础补全配置指南

要让CodeGeeX插件在完全断网的环境下稳定运行，VSCode必须放弃云端依赖，强制指向本地Ollama托管的codegeex4模型。仅仅修改一项配置远远不够——必须同步完成三个关键步骤，否则补全框始终空白，快捷键也毫无反应。

下面按顺序拆解这三项配置的具体操作流程。

先准备离线可用的插件和模型文件。官网Marketplace在无网络机器上无法访问，只能先在联网机器上下载完整资源，再通过U盘或内网拷贝过去。

具体步骤：打开VS Code扩展商店，搜索“CodeGeeX: AI Code AutoComplete, Chat, Auto Comment”，确认发布者为智谱AI（Zhipu AI）。务必选择2.6及以上版本——旧版本缺少localMode开关。点击“Download Extension”获取.vsix文件（例如zhipuai.codegeex-2.6.0.vsix），将其复制到离线机。

模型同样需要离线预拉取。在联网机器上执行 ollama pull codegeex4，下载完成后将整个 ~/.ollama/models/ 目录完整拷贝到离线机的对应用户路径。Windows默认路径为 C:\Users\用户名\.ollama\models，Linux为 /home/用户名/.ollama/models/。注意：直接拷贝单个GGUF文件不可行，Ollama依赖完整的manifest.json与blobs子目录结构来识别模型。缺少这些文件，执行 ollama list 将始终返回空列表。

接下来启动本地模型服务。Ollama必须处于运行状态，且监听插件能够访问的地址。默认端口11434经常被Docker或旧版服务占用，插件会静默失败且不报错。

排查建议：Windows用户打开资源监视器，切换到“网络”标签页，查找占用11434端口的PID并结束对应进程。Linux/macOS用户运行 lsof -i :11434 或 netstat -tuln | grep 11434 定位PID，然后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，若返回的JSON包含 "name": "codegeex4"，则服务已就绪。

最后一步也是最关键的一步：配置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秒。若补全建议框弹出，说明全部配置已生效。