codegeex插件显示“连接服务器失败”是因本地插件已加载但无法与后端通信，常见原因包括网络拦截、授权未完成、缓存异常、插件未启用、扩展图标未勾选可见、残留进程、代理未显式配置或配置损坏；需依次检查启用状态、可见性、重载重启、网络连通性、手动触发面板及清理缓存目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeeX 插件安装后显示“连接服务器失败”，说明本地已加载插件但无法与后端服务通信，常见于网络拦截、授权未完成或缓存异常——不是插件没装好，而是通路断了。
检查插件是否真正激活
打开 VS Code 扩展面板（Ctrl+Shift+X），搜索 CodeGeeX，确认状态显示为“已启用”而非“已禁用”或“已安装未启用”。【若显示“已禁用”，必须点击启用；仅安装不启用，插件不会初始化网络模块】
右键侧边栏底部的扩展图标 → 检查“CodeGeeX”是否勾选可见。未勾选会导致面板不加载，误判为连接失败。
强制重载插件并重启编辑器
在扩展面板中对 CodeGeeX 执行“禁用 → 重新启用”操作，这会清空运行时缓存并触发完整初始化流程。
关闭所有 VS Code 窗口，彻底退出进程（任务管理器中确认 code.exe 进程已结束），再重新启动。这一步不可跳过——残留进程会继续使用旧的 token 或代理配置，导致新设置不生效。
验证网络连通性与授权状态
点击右下角 CodeGeeX 图标 → 选择 “Login” → 观察是否跳转浏览器并完成授权。若卡在空白页或提示“授权失败”，说明本地无法访问 https://codegeex.aminer.org。
打开系统命令行，执行：curl -I https://codegeex.aminer.org。如果返回 HTTP/2 200，说明网络通畅；若超时或拒绝连接，则问题出在防火墙、代理或 DNS。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
注意：CodeGeeX 不走系统代理设置，必须显式配置。若你使用 Clash、Clash for Windows 或 Surge，请确认其 HTTP 代理端口（如 7890）已在 VS Code 启动前全局启用，并且该端口未被 Windows 防火墙拦截。
手动触发面板加载
按下 Ctrl+Shift+P 打开命令面板，输入并执行：CodeGeeX: Show Panel。这能绕过自动加载逻辑，直接唤起核心界面。
若面板弹出但顶部显示“正在连接…”持续超过 15 秒，说明请求发出但无响应——此时应立即检查终端是否有报错日志（帮助 → 切换开发人员工具 → Console 标签页），重点关注 Failed to fetch 或 net::ERR_CONNECTION_REFUSED 类错误。
清理缓存目录（终极手段）
关闭 VS Code，进入以下路径：
Windows：%USERPROFILE%\.vscode\extensions\aminer.codegeex-*
macOS/Linux：~/.vscode/extensions/aminer.codegeex-*
找到名称含 codegeex 的文件夹，将其整个删除。不要只删 cache 子目录——配置损坏常藏在 storage.json 或 state.vscdb 中。
重新打开 VS Code，从扩展市场重新安装 CodeGeeX，安装完成后**不重启编辑器**，直接点击右下角图标登录。这能避免旧状态干扰新实例初始化。
