CodeGeeX插件卡在“模型加载中”超时，主因是远程模型服务初始化失败，需逐层验证代理生效性（仅认系统级HTTPS_PROXY/HTTP_PROXY）、代理连通性（curl测试）、切换本地轻量模型（如Qwen1.5-0.5B-Chat）及清除缓存重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeeX 插件安装后卡在“模型加载中”并最终超时，说明远程模型服务初始化失败，不是插件没装好，而是网络链路、本地配置或服务端连接未就绪——此时界面静止、右键无响应、设置页模型下拉为空，必须逐层验证通信通路。
确认代理是否真正生效
CodeGeeX 不读取 IDE 内置的 HTTP Proxy 设置，只认系统级环境变量 HTTPS_PROXY 和 HTTP_PROXY。打开终端，执行：
echo $HTTPS_PROXY
若输出为空，说明代理未继承到 CodeGeeX 进程。
方法一：终端启动 IDE（推荐）
在已配置好代理的终端中运行：
idea.sh --new-instance（Linux/macOS）或
idea64.exe --new-instance（Windows）
这样 IDE 完全继承 shell 的环境变量。
方法二：设为系统级变量（Windows 图标双击也生效）
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→「系统变量」中新建：
变量名：HTTPS_PROXY，变量值：http://127.0.0.1:7890
变量名：NO_PROXY，变量值：localhost,127.0.0.1,.local
⚠️ 若你用的是 SOCKS5 代理（如 127.0.0.1:1080），必须用 Privoxy 转成 HTTP 代理再填，否则直接填 socks5:// 地址会导致握手卡死。
方法三：终端内临时验证
在启动 IDEA 前，先执行：
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
再运行 IDEA 启动命令——该方式仅对当前终端会话有效。
验证代理能否连通 CodeGeeX 服务端
别跳过这步。很多用户以为代理开着就通了，实际请求根本发不出去。
在终端中执行：
curl -x http://127.0.0.1:7890 -I https://api.codegeex.cn/v1/status
若返回 HTTP/2 200，说明代理链路通畅；
若返回 Connection refused，检查 Clash/Stash 是否正在运行、端口是否被占用；
若返回 403 或 401，说明代理能通但被企业网关拦截，需换代理节点或联系 IT 部门。
强制切换为本地轻量模型
第一步：打开 Settings → Tools → CodeGeeX
第二步：勾选 Use local model (if available)
第三步：在 Model 下拉菜单中选择 Qwen1.5-0.5B-Chat
这个模型约 380MB，纯 CPU 可跑，无需联网，首次加载稍慢（30秒内），但后续响应稳定。不选它，插件会一直尝试加载远程的 CodeGeeX-2 大模型，而国内直连 api.codegeex.cn 几乎必超时。
注意：该选项默认关闭，且只有在插件成功初始化 UI 后才可见——如果连设置页都打不开，先按前两步解决代理问题。
清除缓存并重启
Help → Find Action → 输入 “Clear Caches and Restart” → 点击执行。
这一步会清空插件的模型元数据缓存、token 缓存和连接状态记录。
旧缓存损坏是导致“模型加载中”假死的高频原因，尤其在升级插件后未重启的情况下。
重启后，观察右下角状态栏是否出现 CodeGeeX 图标；若仍显示“模型加载中”，立即打开 Help → Show Log in Explorer，搜索关键词 “timeout” 或 “failed to load model”，定位具体失败环节。
