根本原因是VSCode版本低于1.84.0导致插件核心模块未初始化，需升级VSCode至1.84.0或更高版本，再卸载重装插件、清除缓存、重启编辑器，并完成账号登录与网络连通验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeeX 插件在 VSCode 中只显示 “ask” 按钮、不出现标识或功能面板，多数情况是插件加载失败而非界面隐藏——根本原因是当前 VSCode 版本低于 CodeGeeX 所需的最低运行版本，导致插件核心模块被跳过初始化。
确认 VSCode 当前版本是否达标
打开 VSCode，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Help: About 并回车。查看弹窗中显示的版本号，例如 1.85.3 或 1.90.2。
CodeGeeX 官方要求 VSCode 最低版本为 1.84.0（截至 2026 年 6 月）。若版本号小于此值，必须升级；若版本号 ≥1.84.0 但问题仍在，继续排查后续环节。
升级 VSCode 到兼容版本
方法一：通过内置更新通道（推荐）
点击菜单栏 Help → Check for Updates（帮助 → 检查更新），若有新版本提示，直接安装并重启。此方式确保获取的是官方 Stable Channel 正式版，API 行为稳定可靠。
方法二：手动下载指定版本安装包
访问 VSCode 官方归档页：Windows 64 位｜macOS Universal｜Linux x64。
选择发布日期在 2024 年 10 月之后 的稳定版（如 1.84.0 及以上），下载后直接运行安装程序——无需卸载旧版，新旧版本可共存。
方法三：命令行快速验证（Linux/macOS）
终端执行 code --version 确认当前 CLI 调用版本；若返回 Command 'code' not found，说明未配置 PATH，需先运行 VSCode → Shell Command: Install 'code' command in PATH。
重装 CodeGeeX 插件并清除残留缓存
第一步：彻底卸载旧插件
打开扩展面板（Ctrl+Shift+X），搜索 CodeGeeX，点击右上角 ⋯ → Uninstall。务必确认插件状态变为“已卸载”，而非仅禁用。
第二步：删除本地插件缓存目录
关闭 VSCode 后，手动进入插件数据目录：
• Windows：%USERPROFILE%\.vscode\extensions\aminer.codegeex-*
• macOS/Linux：~/.vscode/extensions/aminer.codegeex-*
找到以 aminer.codegeex- 开头的文件夹，整文件夹删除（不要只删 cache 子目录）。
第三步：重新安装并启用
重启 VSCode，在扩展面板中重新搜索 CodeGeeX，点击安装。安装完成后，必须重启一次编辑器——这是关键动作，否则插件 activate() 函数不会触发，面板仍不显示。
检查授权与网络连通性
安装完成且重启后，若侧边栏仍无 CodeGeeX 图标，按下 Ctrl+Shift+P，输入 CodeGeeX: Show Panel 并回车。若弹出空白面板或报错“Not logged in”，说明授权未完成。
点击面板右上角 Login 按钮，使用 AMiner 账号登录。若页面卡在加载状态，打开系统终端，执行：curl -I https://api.codegeex.cn
若返回 HTTP/2 200，网络正常；若超时或拒绝连接，需检查代理设置或防火墙规则。
注意：使用企业内网或教育网的用户，可能因 DNS 污染无法解析 api.codegeex.cn 域名，此时需手动配置 hosts 文件指向正确 IP。
