CodeGeeX插件在国内需配置VSCode的http.proxy为http://127.0.0.1:7890并设http.proxyStrictSSL:false，或改extensions.gallery.serviceUrl为https://vscode.cdn.azure.cn/_apis/public/gallery镜像源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在国内网络环境下安装或更新 CodeGeeX 插件时，常因直连境外服务器导致下载卡在 0%、超时失败或反复重试，必须显式配置代理路径并确保 HTTPS 连接可穿透。
确认代理服务已就绪
CodeGeeX 插件本身不继承系统代理，也不读取 HTTP_PROXY 环境变量，它只认 VSCode 内部的 http.proxy 设置。如果你用的是 Clash、Surge 或其他支持 HTTP/HTTPS 双协议的代理工具，请先确认其「System Proxy」已开启，并且监听地址为 http://127.0.0.1:7890（Clash 默认端口）或你实际使用的端口。
这一步漏掉会导致后续所有配置失效——VSCode 根本不会把请求发出去。
打开终端执行 curl -x http://127.0.0.1:7890 https://marketplace.visualstudio.com，若返回 HTML 内容，说明代理能通；若报 Connection refused，请检查代理进程是否运行、端口是否被占用、是否开启了 HTTPS CONNECT 支持。
在 settings.json 中写入代理配置
VSCode 的代理设置必须带 http:// 前缀，否则会静默忽略。同时，自签名代理证书（如 Charles、Fiddler、企业中间人代理）会导致连接中断，必须关闭 SSL 严格校验。
方法一：快捷打开配置文件
按下 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（macOS），输入并选择 Preferences: Open Settings (JSON)。
方法二：手动定位文件
Windows 路径：%APPDATA%\Code\User\settings.json
macOS 路径：~/Library/Application Support/Code/User/settings.json
Linux 路径：~/.config/Code/User/settings.json
在已有 JSON 对象内添加以下两行（注意逗号分隔）：
"http.proxy": "http://127.0.0.1:7890","http.proxyStrictSSL": false
【务必用英文双引号包裹值，且末尾不能有多余逗号】。保存后彻底退出 VSCode 进程（任务管理器中杀掉所有 code.exe 或 code Helper 进程），再重新启动。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
绕过代理限制的备用方案：换镜像源
当代理被国产安全软件拦截、DNS 劫持或企业防火墙策略阻断时，改 extensions.gallery.serviceUrl 是更底层、更稳定的解法。
第一步：打开用户设置文件（同上）
第二步：添加以下两行配置（与 http.proxy 同级）：
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery","extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery/publishers"
vscode.cdn.azure.cn 是社区长期维护的镜像，兼容性优于清华、阿里等第三方源，且不依赖代理服务。改完必须重启 VSCode，否则不生效。
注意：该镜像不适用于 Remote-SSH 场景下的远程插件安装——远程端仍需单独配置代理或镜像源。
命令行安装时强制使用代理
当你用 code --install-extension 安装插件却失败，大概率是终端启动的 VSCode 进程未加载用户设置中的代理项。此时需显式传参：
执行：VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --proxy-server=http://127.0.0.1:7890 --install-extension codegeex.codegeex
如果仍报 ETIMEDOUT，说明当前 shell 继承了错误的代理环境变量，或者代理服务未监听所有接口（比如只监听 127.0.0.1 而非 0.0.0.0）。此时可临时关闭 Clash 等工具，改用镜像源方式安装。
