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 等工具,改用镜像源方式安装。










