必须绑定插件命令id(如codegeex.quickask)并配置快捷键,再在settings.json中启用codegeex.webview.floating等选项,v2.6.0+版本才支持真正悬浮式面板;或复用ctrl+k ctrl+i配合hover provider实现轻量交互。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 VSCode 中让 CodeGeeX 插件的快捷操作以悬浮窗形式快速唤出,必须绕过插件默认的侧边栏或命令面板入口,直接绑定快捷键并触发其核心交互界面——该界面本质是 Webview Panel,但可通过配置使其行为接近悬浮提示。
确认 CodeGeeX 已安装并激活
打开扩展面板(Ctrl+Shift+X),搜索 CodeGeeX,确保状态为“已启用”。若未安装,先安装后重启 VSCode。注意:【插件必须完成首次登录和模型授权,否则快捷键触发后仅显示空白或错误提示】。
右下角状态栏出现 CodeGeeX 图标且显示“Ready”才表示服务就绪。
查找并绑定插件提供的命令 ID
按下 Ctrl+Shift+P 打开命令面板,输入“Developer: Inspect Context Keys”,回车后将鼠标悬停在 CodeGeeX 的任意按钮(如侧边栏中的“Ask”按钮)上,观察开发者工具中 context key 变化,找到类似 codegeex.ask 或 codegeex.showPanel 的命令 ID。
更可靠的方式:打开插件源码目录(通常位于 ~/.vscode/extensions/zhijian.codegeex-*/package.json),搜索 "contributes.commands" 字段,提取 command 字段值,例如 "codegeex.quickAsk"。
手动配置快捷键触发悬浮式面板
按下 Ctrl+K Ctrl+S 打开键盘快捷方式设置,在搜索框输入你查到的命令 ID(如 codegeex.quickAsk),点击左下角“+”号新建快捷键绑定。
按你想用的组合键(例如 Ctrl+Alt+Q),回车确认。这一步会写入 keybindings.json,无需手动编辑。
关键验证:保存后,在任意代码文件中光标置于函数名或变量上,按下新设快捷键——此时应弹出一个轻量、无边框、可拖动的 Webview 面板,位置靠近光标,行为类似悬浮窗;若弹出全屏侧边栏,则说明绑定的是错误命令(如 codegeex.openSidebar),需重新排查。
强制悬浮窗样式与行为优化
在用户 settings.json 中添加以下配置:
"codegeex.webview.floating": true,
"codegeex.webview.width": 480,
"codegeex.webview.height": 320
注意:【此三项配置仅在 CodeGeeX v2.6.0 及以上版本生效;低于该版本会静默忽略,不报错也不起作用】。
重启 VSCode 后,再次触发快捷键,面板将自动以固定宽高、居中偏上位置弹出,且支持鼠标拖拽边缘调整大小,关闭时自动收起而非隐藏到侧边栏。
替代方案:用 Ctrl+K Ctrl+I 复用原生悬浮机制
方法一:在 settings.json 中追加:
"editor.hover.enabled": true,
"editor.hover.delay": 150,
"editor.hover.sticky": true
然后将光标精准停在被 CodeGeeX 支持的代码元素上(如函数调用名、类名),按 Ctrl+K Ctrl+I —— 若插件已注册 hover provider,此时悬浮框内会出现 CodeGeeX 的“解释”“续写”等快捷按钮,直接点击即可触发,无需额外窗口。
方法二:禁用所有其他 hover 干扰插件(尤其是 Copilot、TabNine),避免它们劫持 hover 事件导致 CodeGeeX 提示不显示。











