# @alas-ide/claude-agent-acp 中文文档

规范地址：https://npmcn.com/package/%40alas-ide/claude-agent-acp/

版本：0\.101\.0-alas\.2
npm 元数据更新时间：2026-11-07T00:21:29.723Z
中文译文更新时间：2026-11-06T06:44:52.818Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40alas-ide/claude-agent-acp
原文对照：https://npmcn.com/package/%40alas-ide/claude-agent-acp/?lang=original
项目主页：https://github.com/mrmans0n/claude-agent-acp#readme
源码仓库：https://github.com/mrmans0n/claude-agent-acp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.3 MB，312 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-10-05T01:32:43.972Z
- 最新版本发布：2026-11-07T00:21:29.302Z
- 近 30 天下载量：4375（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

由克洛德特工SDK(TypeScript)提供动力的ACP兼容编码代理

## 安装

```sh
npm install @alas-ide/claude-agent-acp
```

也可以使用：`pnpm add @alas-ide/claude-agent-acp`、`yarn add @alas-ide/claude-agent-acp`、`bun add @alas-ide/claude-agent-acp`

## README

# Claude Agent SDK的ACP适配器

[![npm](https://img.shields.io/npm/v/%40agentclientprotocol%2Fclaude-agent-acp)](https://www.npmjs.com/package/@agentclientprotocol/claude-agent-acp)

使用 [克劳德探员SDK](https://platform.claude.com/docs/en/agent-sdk/overview#branding-guidelines) 从 [兼容非加太公司](https://agentclientprotocol.com/) 客户!

该工具通过使用官员执行非加太代理 [克劳德探员SDK](https://platform.claude.com/docs/en/agent-sdk/overview),支持:

-   上下文@-mentions
-   图像
-   工具调用( 有许可请求)
-   通过谈判达成的压缩文件更改 [AIR diff 补丁扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#diff-patch)
-   跟踪
-   编辑审查
-   TODO 列表
-   嵌入子剂记录
-   交互式(和背景)终端
-   自定义 [斜线命令](https://docs.anthropic.com/en/docs/claude-code/slash-commands)
-   客户端 MCP 服务器
-   一个Ultracode会话配置选项,它开启了克洛德代码对每项任务的动态工作流程. 当动态工作流程被启用,且模型支持超码(任何模型都带有 `xhigh` (单位:千美元)
-   `/mcp` 在聊天中:作为列表的 MCP 服务器状态。 适配器运行 `/mcp reconnect`, (中文(简体) ), `/mcp enable`,以及 `/mcp disable` 通过SDK控制API,因为Claude Code在SDK模式中拒绝. 需要认证的 ACP 服务器通过 URL 引出启动 MCP OAuth 重联
-   AIR的会话范围长期目标 [目标扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#goal) 下级 `_meta.jetbrains.air.goal`
-   背景任务生命周期和每个任务停止控制通过选入 [代理任务扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#async-tasks),包括中性供应商 `clientCapabilities._meta["async-tasks"]: true` 谈判
-   通过选入结构化错误、恢复和警告 [会话失败扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#session-failure)
-   具体的模型和工作默认通过选入 [建议的配置值扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#recommended-config-values)
-   工具权限演示、可编辑的选择和通过 [权限扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#permission-presentation)
-   每个工具调用报告中每个字段一个事实 [非加太工具呼叫合同](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#tool-call-contract) 定义
-   所有航空延伸、能力以及 `_meta` 键 : [空中扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md)

学习更多关于 [代理客户协议](https://agentclientprotocol.com/)。 。 。 .

尝试已登陆的更改 `main` ,但尚未发布,从 `preview` 频道——每次推到 `main` 发布一个。 见 [`docs/RELEASES.md`](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/RELEASES.md#preview-releases)。 。 。 .

```sh
npm install @agentclientprotocol/claude-agent-acp@preview
```

### 独立的可执行文件

每次发行都附加了Linux(glibc和musl)、macOS和Windows的档案,在 x64和arm64,改为 [GitHub 发布](https://github.com/agentclientprotocol/claude-agent-acp/releases)。 。 。 . 他们不需要安装节点.js. 每个文件有两个: `claude-agent-acp`,则 克劳德·克里(Claude CLI)`claude`它运行。 将它们保存在同一目录中; 链接到 `claude-agent-acp` 别的地方也行 要用克洛德的CLI 你已经有了 相反,设置 `CLAUDE_CODE_EXECUTABLE`在高山上,安装 `libgcc` 财务报告和审定财务报表 `libstdc++` 先说.

为您的机器建造一个( 需要) [阿宝](https://bun.sh/))并检查它:

```sh
npm run build:binary
npm run smoke:binary            # add `-- --full` to drive a real session; needs a Claude login
```

### 副代理人会议

客户端声明 `clientCapabilities.subagents`除了JetBrains AIR, 得到每个特工或 任务子代理作为它自己的子会话,从 [rFD 亚剂](https://github.com/agentclientprotocol/agent-client-protocol/blob/main/docs/rfds/subagents.mdx)数字 :

-   `subagent_update` 父母在任何交通之前向子女申报,并通知 亲子关系 `title` 财务报告和审定财务报表 `description` 并报告其工作情况: `running`, (中文(简体) ), `requires_action` 其一项请求是开放的(和 `running` 当最后一个结束的时候, 除非被取消,否则,儿童将停止学业 `idle` 当其工作结束时 `end_turn` 或者说 `cancelled` 当SDK给出理由。 失败是 `idle` 与 `error` 停止理性和 SDK 错误文本作为其 `error`儿童为每一儿童保留其届会 代表团参加.
-   在父母工作目录之外运行的孩子,例如Agent呼叫 `isolation: "worktree"`,获取其 `cwd` 打开 `subagent_update` 在第一个工具呼叫之前 这个 适配器从 `cwd` 儿童自己的钩子:它的子代理起动钩子运行于其前 第一个型号请求。 它发出 `cwd: null` 当孩子回到父母的目录中时。 A 类 父目录中的孩子不会 `cwd`,没有孩子得到 `additionalDirectories`: 克劳德 代码给出了会话附加目录的子代理,因此它继承了它们. 重播 与 `cwd` 记录下来的笔录, 并在答复后澄清 当目录不复存在时.
-   会话信息取代启动孩子的代理或任务呼叫, 其父母是 未显示 :
    -   发射的快讯是 `session_message` 两种笔录中:父母的出处和 孩子们要来了 两者都使用发射工具使用id,彼此名称与d 报告草案 `recipientMessageId` 财务报告和审定财务报表 `senderMessageId`。 。 。 .
    -   从发射结果来看 预告孩子的答案是 `session_message` 改为 父母亲 在克洛德代码的手背模式中,孩子的 `SubagentHandback` 电话是它的 相反,在两种文字记录和链接中,向父母发出信息.
    -   其孩子从未暴露的发射装置毕竟被显示为一个工具召唤,其最终 状态.
-   送信信给孩子的电话信息 `session_message` 在孩子身边 记录 SendMessage 调用仍为生成它的会议的工具调用 .
-   `session/cancel` 父母打断克洛德代码,它阻止了前面的孩子 转动等待。 背景儿童继续运行, 如 RFD 所选择; 客户端停止一个 其本身 `cancel`每一份被拦截的儿童报告 `idle` 与 `cancelled` 从克洛德密码自己的 并撤回其公开请求。 适配器在取消时没有结束孩子,所以 持续运行的孩子会保持其打开的请求和打开的工具呼叫. 保留背景 孩子们,适配器宣布 SDK 选项 `perTaskStopAffordance`,客户端可以翻转 关入 `_meta.claudeCode.options`。该选项也省去了背景工作流程,客户端 不能停止,所以适配器在中断后停止它们,就像克洛德代码没有它. 背景命令在取消后继续运行 。 Claude Code报告没有的被拦截儿童的工具呼叫 结果, 如它运行的命令, 在取消前在子会话中结束 即时决断. 当克劳德代码 阻止一个背景孩子 之后,或者在没有快速运行, 工具呼叫在孩子报告后结束 `idle`。一个孩子仍然运行 当克劳德代码 出口为 `idle` 没有停止的理由.
-   父母尚未知道何时终止的儿童,因为《俄罗斯联邦家庭法》禁止 猜它的家长.
-   重播会恢复每个孩子的现场会话代号, 从自己的记录中, 和相同的 会话信息作为活的,结束 `idle` 在回复之前. 没有Claude Code的元数据文件的启动 儿童将保持一个普通的工具呼叫 和通知, 对于一个被通知的客户来说, 子代理历史缺失.
-   在装入或恢复后, 无论是否重放, 发送邮件从前恢复代理 它从以前开始负责代理 在代理交通之前 每一个祖先 在这方面未告知客户的,在孩子出生前即为父母 没有工作状态,正如RFD所要求的。 一个启动会场的特工 记录不被曝光.
-   每个正在运行的孩子都会与 `cancel` 能力. `session/cancel` 与孩子的 通过 SDK 停止该孩子当前的工作 `Query.stopTask`,而不是它的 claude Code也阻止了它所等待的前期孩子 父母的轮回 继续 每一份停止的儿童报告 `idle` 与 `cancelled` 克洛德·克洛德·克洛德的作品 以及他的作品 请求停止撤回编号 `running` 先说 一个重播的孩子,不再 运行,没有能力。 客户端不能催促或改变孩子.

一个 [非加太语 v2](https://npmcn.com/package/%40alas-ide/claude-agent-acp/#readme-experimental-acp-v2) 客户端在不申报任何信息的情况下得到同样的信息, 因为代理代理 是v2基线的一部分。 每个儿童还报告自己的工作状况 `state_update`对 父母抄后.

JetBrains AIR保留了RFD的更早的草稿(A`subagent_spawned`, (中文(简体) ), `subagent_state_update`, (中文(简体) ), 它能够使 `nativeSubagentSessions` 内 `_meta.jetbrains.air.capabilities`。见 [空中扩展](https://npmcn.com/package/%40alas-ide/claude-agent-acp/docs/air-extensions.md#native-subagent-sessions)。 。 。 .

没有信号 Agent and Task 保持普通工具呼叫 儿童互动保持 根会话。 使用历史的客户端 `_meta["subagent-transcript"]` 能力或 `forwardSubagentText` 课程选项保留平分的儿童记录.

### 非加太实验 v2

适配器还服务于 [非加太集团草案v2](https://agentclientprotocol.com/protocol/v2/overview)数字 : 客户端请求协议版本 2 或稍后在 `initialize` 获得 v2 和所有其他客户端 获得v1. 草案仍然可以改变,而这个表面随它而改变.

`CLAUDE_AGENT_ACP_PROTOCOL` 将适配器限制在一个版本。 与 `v1`,客户端询问 对于v2,谈判到v1。 与 `v2`,适配器拒绝 `initialize` 一个v1客户端. `auto`,默认,服务两者.

V2 适配器服务会话基线(`session/new`, (中文(简体) ), `session/list`, (中文(简体) ), `session/resume` 与重播, `session/close`, (中文(简体) ), `session/prompt`, (中文(简体) ), `session/cancel`, (中文(简体) ), `session/delete`, (中文(简体) ), `session/fork`,附加目录,配置选项(模式为一),计划,通知, 压缩、显示命令的终端、许可请求、诱导、提供者、认证和 [子剂](https://npmcn.com/package/%40alas-ide/claude-agent-acp/#readme-subagent-sessions)引导和AIR扩展只是现在.

## 捐助政策

这个项目不需要《捐助者许可证协定》。 相反,接受捐款的条件如下:

> 通过为这个项目捐款,你同意,你的捐款将获得以下许可: [Apache 许可证,2.0版本](https://www.apache.org/licenses/LICENSE-2.0)您确认您拥有提交作品的法定权利,您没有包含您无权使用的代码,您理解捐款是无需签署《贡献者许可协议》的.

## 常见问题

### @alas-ide/claude-agent-acp 是什么？

由克洛德特工SDK\(TypeScript\)提供动力的ACP兼容编码代理

### 如何安装 @alas-ide/claude-agent-acp？

在项目目录运行 npm install @alas-ide/claude-agent-acp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 claude-agent-acp，可以用 npx claude-agent-acp 直接运行。

### @alas-ide/claude-agent-acp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @alas-ide/claude-agent-acp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @alas-ide/claude-agent-acp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @alas-ide/claude-agent-acp 可以商用吗？

@alas-ide/claude-agent-acp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @alas-ide/claude-agent-acp 的下载量有多少？

根据 npm 官方下载统计，@alas-ide/claude-agent-acp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,375 次，日均约 146 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @alas-ide/claude-agent-acp 还在维护吗？

最新版本 0\.101\.0-alas\.2 发布于 2026/11/07（今天）；至今共发布 33 个版本，其中过去 12 个月发布了 33 个；首次发布于 2026/10/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。