终端 IDE Companion

连接编辑器上下文，接受或拒绝原生 diff，并排查工作区不匹配。

This page has not been translated into English yet. The original Chinese version is shown below.

Companion 为集成终端中的 Qwen CLI 提供编辑器上下文和原生 diff。当前用户指南针对 VS Code 及支持其扩展的编辑器；JetBrains/Zed 的 ACP 是另外的接入方式。

安装、启停和状态

在支持的编辑器中启动 Qwen 可能出现连接提示，接受后完成安装和连接。也可手动执行：

/ide install
/ide enable
/ide status

从市场手工安装后仍需 /ide enable。/ide disable 断开连接；/ide status 检查连接的编辑器和已知最近文件。

自动上下文范围

最多十个最近访问的工作区本地文件，并附活动文件光标与最多 16KB 选区。无磁盘路径的未保存虚拟文件不纳入。

最近文件列表表示模型知道这些路径，不应声称已自动读取每份文件全部正文。发送上下文前会排序并截断，长选区也不代表全部内容已送达。

Diff 接受与拒绝

提出修改时可打开 IDE 原生 diff，并允许在其中先编辑再接受。点击勾、保存文件、命令面板 Qwen Code: Accept Diff，或 CLI 回答 yes，都可接受；关闭 diff 标签、点击叉、Close Diff Editor 或 CLI 回答 no，则拒绝。

因此保存 diff 是接受操作，不是仅保存一份无影响的预览。CLI 的 Yes, allow always 会让后续修改自动接受，不再逐次打开 IDE diff。

命令面板 Qwen Code: Run 启动新的终端会话；View Third-Party Notices 查看第三方声明。

沙箱连接

macOS Seatbelt 需允许与 Companion 的网络通信。Docker/Podman 可通过 host.docker.internal 找宿主 IDE，但容器到宿主网络仍须实际可达，不保证所有自定义网络都免配置。

常见故障

缺少发现环境或扩展没初始化时，确认 Companion 已启用，再新开 IDE 终端，避免沿用旧环境。现代协议以 QWEN_CODE_IDE_SERVER_PORT 和对应 lock 文件发现服务；旧排障文本还提到 QWEN_CODE_IDE_WORKSPACE_PATH，不应手工伪造这些值代替真正连接。

目录不匹配时从 IDE 所开工作区内启动 CLI；未打开项目时先打开工作区。连接中断可 /ide enable 重连，持续失败再重启终端或 IDE。没有自动安装器的兼容编辑器从其市场手工安装。