> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

Agent Client Protocol (ACP) 是 Zed 推出的智能体通用通信协议，用于将智能体的核心能力（服务端）与用户界面（客户端）解耦，让不同的智能体服务端和客户端能在统一协议下灵活组合与交互。
TRAE CLI 支持 ACP 协议，可作为智能体服务端，与所有支持 ACP 协议的编辑器实现无缝集成。
## 手动启动 ACP 服务器 {#5a66d41a}
执行以下命令启动 ACP 服务器，然后即可在 Zed 官方声明支持的 ACP Client 中使用 TRAE CLI。
```Plain Text
traecli acp serve
```

通常无需手动执行上述命令来启动 ACP 服务器。实际使用中，ACP Client 会通过 `subprocess` 方式自动启动该服务器，下文将以 Zed 编辑器为例，详细说明集成步骤。
## 示例：在 Zed 中集成 TRAE CLI {#14617b69}
:::tip 提示
不同 ACP Client 集成 TRAE CLI 的方式可能存在差异，参考各自的官方文档进行操作。
:::
在 Zed 中通过 ACP 协议集成 TRAE CLI 的步骤如下：

1. 新建 `~/.config/zed/settings.json` 文件。若已存在该文件，跳过此步骤。
2. 在 `~/.config/zed/settings.json` 文件中，新增以下配置：
   ```JSON
   {
     "agent_servers": {
       "TRAE CLI": {
         "type": "custom",
         "command": "traecli",
         "args": ["acp", "serve"],
         "env": {}
       }
     }
   }
   ```

   参数说明如下：
   <!-- @cols-width: 100,739 -->
   | | | \
   |**参数** |**描述** |
   |---|---|
   | | | \
   |type |指定服务端的类型。`"custom"` 表示用户自定义的服务端，需要指定启动命令。 |
   | | | \
   |command |指定启动服务端的可执行文件或命令，Zed 将调用这个命令来启动 ACP 服务器，此处为系统中的 `traecli` 可执行文件 。 |
   | | | \
   |args |指定传给 `command` 的命令行参数，等价于在终端执行：`traecli acp serve`；其中 `"acp"` 是子命令，`"serve"` 是动作参数，用于启动 ACP 服务器。 |
   | | | \
   |env |指定启动服务端时的环境变量。空对象 `{}` 表示使用默认系统环境变量。 |

3. 在 Zed 编辑器侧边的 **New Thread** 面板中，新建 TRAE CLI 线程。
   集成完毕，你可以在 Zed 编辑器中使用 TRAE CLI。