必须完成插件安装、API密钥配置、本地模型适配（可选）及跨域权限打通四步闭环：安装≥2.6版Zhipu AI官方插件；联网模式填sk-开头API密钥，离线模式需启用localMode、apiBase设为http://localhost:11434/v1/chat/completions、model设codegeex4且apiKey为空，并执行export OLLAMA_ORIGINS="*"。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Linux 系统中让 VSCode 正常调用 CodeGeeX 的代码补全、生成与翻译能力，必须完成插件安装、API 密钥配置、本地模型适配（可选）及跨域权限打通四步闭环，漏掉任意一环都会导致图标灰显或请求超时。
安装 CodeGeeX 插件
打开 VSCode，按 Ctrl+Shift+X 进入扩展市场 → 在搜索框输入 CodeGeeX → 确认发布者为 Zhipu AI 且版本号 ≥ 2.6 → 点击“安装”。
安装完成后右下角会出现蓝色 CodeGeeX 图标，若未出现，请重启 VSCode；某些 Linux 发行版（如 Ubuntu Snap 版）会沙盒化 VSCode，导致插件无法加载，此时需改用 官网 .deb 包 重新安装。
配置智谱云 API 密钥（联网模式）
访问 https://www.php.cn/link/4002628957f70084918b0d02535b3bca 登录智谱账号 → 进入“API 密钥管理” → 点击“创建新密钥” → 复制密钥字符串（以 sk- 开头）。
在 VSCode 中按 Ctrl+, 打开设置 → 左上角搜索框输入 codegeex.apiKey → 在对应字段中粘贴密钥 → 保存设置。
【密钥必须为最新生成的，旧密钥可能已被撤销或限频】
验证：新建一个 .py 文件，输入 def hello(): 后停顿 1 秒，若右下角图标开始旋转，说明密钥已生效。
启用本地 Ollama 模型（离线模式）
方法一：使用 Ollama 运行 codegeex4
先确保已安装 Ollama（curl -fsSL https://ollama.com/install.sh | sh）→ 执行 ollama run codegeex4 启动模型。
方法二：指定监听端口并开放跨域
Linux/macOS 下必须执行：export OLLAMA_ORIGINS="*"，否则 VSCode 内置 Chromium 会拦截请求 → 再运行 OLLAMA_HOST=127.0.0.1:11434 ollama serve。
方法三：VSCode 插件三处关键配置
- 搜索 codegeex.localMode → 勾选启用
- 搜索 codegeex.apiBase → 设为 http://localhost:11434/v1/chat/completions（注意末尾路径不可省略）
- 搜索 codegeex.model → 手动输入 codegeex4（不能留空，也不能填 codegeex-4）
【apiKey 字段必须清空，否则插件仍会尝试连接智谱云，导致本地请求被忽略】
调整语言白名单与补全行为
搜索 codegeex.languageWhitelist → 点击“编辑设置(JSON)” → 替换为：["python", "javascript", "typescript", "java", "cpp"] → 保存。
搜索 codegeex.autoTrigger → 勾选启用自动补全（输入分号、回车后自动弹建议）；若常误触，可取消勾选，改用 Ctrl+Enter 手动唤起。
搜索 codegeex.candidateNum → 设为 3，兼顾响应速度与选项丰富度；设为 5 时首次补全延迟明显增加。
