Agent Client Protocol (ACP)

Agent Client Protocol (ACP) 是 Zed 推出的智能体通用通信协议，用于将智能体的核心能力（服务端）与用户界面（客户端）解耦，让不同的智能体服务端和客户端能在统一协议下灵活组合与交互。

TraeCode CLI 支持 ACP 协议，可作为智能体服务端，与所有支持 ACP 协议的编辑器 / 客户端实现无缝集成。

手动启动 ACP 服务器

执行以下命令启动 ACP 服务器，即可在 ACP Client 中使用 TraeCode CLI。

## 方式一 
traecli acp serve

## 方式二
traecli --acp

命令结构：

traecli [全局参数] acp serve [ACP Server 参数]

全局参数

全局参数必须写在 acp serve 前。

示例：

## 指定配置档
traecli --profile work acp serve

## 设置初始权限模式
traecli --permission-mode auto acp serve

## 通过配置覆盖指定初始模型
traecli -c 'model="<model-id>"' acp serve

## 同时指定模型和初始 reasoning effort
traecli \
  -c 'model="<model-id>"' \
  -c 'model_reasoning_effort="high"' \
  acp serve

ACP Server 参数

以下参数写在 acp serve 后。

通常无需手动执行上述命令来启动 ACP 服务器。实际使用中，ACP Client 会通过 subprocess 方式自动启动该服务器。下文以 Zed 编辑器为例，说明集成步骤。

示例：在 Zed 中集成 TraeCode CLI

在 Zed 中通过 ACP 协议集成 TraeCode CLI 的步骤如下：

1. 新建 ~/.config/zed/settings.json 文件。若已存在该文件，跳过此步骤。
2. 在 ~/.config/zed/settings.json 文件中，新增以下配置：

   {
     "agent_servers": {
       "TraeCode CLI": {
         "type": "custom",
         "command": "traecli",
         "args": [
           "acp",
           "serve"
         ],
         "env": {}
       }
     }
   }
   

   参数说明如下：

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

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