Zed ACP 接入

Zed 通过 ACP 在原生 agent 界面运行 Qwen Code，支持文件 @ 引用及会话历史。需要已有 CLI；安装与模型连接先在终端验证。

从 Registry 添加

在 Zed 的 agent 设置入口选择 Add agent、Install from Registry，找到 Qwen Code 后安装。官方推荐当前版本 Zed，但没有在该页给出固定最低版本，不能据此编造兼容下限。

自定义 agent

选择 Add agent、Create a custom agent，按宿主要求添加以下条目：

{
  "Qwen Code": {
    "type": "custom",
    "command": "qwen",
    "args": ["--acp"],
    "env": {}
  }
}

这是 agent 条目映射示例，不是整份 Zed settings 的替代内容。官方展示的是对象成员片段；这里补了外层花括号以便查看合法 JSON，实际放置位置以编辑器生成的配置为准。

command 需在 Zed 启动环境中可解析；终端能找到 qwen 而 GUI 找不到时，核对 GUI PATH 或配置实际路径，不更改其他项目设置来绕过。

使用与验证

通过 @ 添加文件，把需要分析的目标交给会话，确认返回的工具结果而不仅是生成文字。与终端相同，改动是否自动执行仍取决于 agent 和宿主的权限流程。

找不到 agent 时执行 qwen --version、检查配置 JSON，再重启 Zed。存在 agent 但无法响应时，运行终端 qwen 区分 CLI/认证故障与 ACP 集成故障。不要把 JetBrains 的 # 引用习惯直接套到这里。