必须同时满足插件启用、潜行模式开启、vscode内联建议启用三条件,缺一不可;版本≥1.68.0、重启vscode、语言模式正确、文件已保存、光标不在字符串或注释中,才能触发灰色预览代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 VSCode 中让 CodeGeeX 真正“跟着你写、停就出建议”,必须同时满足插件启用、模式开启、上下文就绪三个条件,缺一不可——只装插件不配置,光标后永远不会出现灰色预览代码。
确认基础环境与插件状态
打开 VSCode,左下角查看版本号,【版本必须 ≥ 1.68.0】;低于此版本,CodeGeeX 的内联建议引擎根本无法加载。
按 Ctrl+Shift+X 打开扩展面板,搜索 “CodeGeeX”,确认已安装且右侧显示“已启用”;若为灰色“禁用”状态,点击启用按钮。
重启 VSCode —— 这一步不能跳过。插件首次启用或更新后,仅重载窗口不足以初始化内联建议通道,必须完整重启才能激活底层补全服务。
开启潜行模式(Stealth Mode)
按下 Ctrl+, 打开设置,左上角搜索框输入 CodeGeeX: Enable Code Generation,勾选该项。
再搜索 CodeGeeX: Stealth Mode,确保其开关为开启状态。这是潜行模式的总闸门,关闭它,无论你怎么停顿,图标都不会转圈,灰色建议也永远不会浮现。
注意:该模式默认依赖 800ms 停顿触发,无需额外设置延迟值;若你习惯秒级快速敲击,建议保持默认,避免误触发。
启用 VSCode 原生内联建议支持
潜行模式生成的灰色代码,本质是 VSCode 的 inlineSuggest 渲染结果,因此必须手动开启原生支持:
在设置中搜索 inline suggest,找到 【Editor > Inline Suggest: Enabled】 并勾选。
或者直接编辑 settings.json,添加这一行:"editor.inlineSuggest.enabled": true。不加这句,CodeGeeX 即使生成了内容,VSCode 也会直接丢弃,不渲染任何灰色文本。
验证是否生效并处理常见失效场景
第一步:新建一个 .py 文件,输入 print( 后停顿半秒,观察右括号后是否出现灰色 "hello" 或变量名建议;没有?说明语言服务器未就绪。
第二步:检查状态栏右下角语言模式是否为 Python;如果不是,点击它并手动选为 Python(需已安装 Python 插件且 Pylance 已加载)。
第三步:若仍无反应,尝试保存文件(.py 文件未保存时,Pylance 默认禁用内联建议);保存后再次输入 print( 并停顿。
关键提醒:【光标绝不能位于字符串内部或注释末尾】,例如写 name = "li|"(| 为光标),此时 CodeGeeX 会跳过,因上下文语义断裂,服务器拒绝提供建议。
触发与接受建议
编写任意合法代码(如 def greet():),光标停在冒号后换行处,等待右下角 CodeGeeX 图标开始旋转 → 灰色代码浮现 → 按 Tab 键插入。
若出现多个候选,按 Alt+[ 或 Alt+] 切换;想强制刷新新建议,按 Alt+N。
⚠️ 特别注意:不要按 Enter 接受——它只会换行,灰色建议依然挂着;Esc 可随时取消当前建议,不影响已输内容。











