# @chipschat/acp 中文文档

规范地址：https://npmcn.com/package/%40chipschat/acp/

版本：1\.0\.15
npm 元数据更新时间：2026-11-07T19:38:43.169Z
中文译文更新时间：2026-11-09T13:43:44.475Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.3 MB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：0 个
- 首次发布：2026-10-23T15:45:58.944Z
- 最新版本发布：2026-11-07T19:38:42.858Z
- 近 30 天下载量：2619（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

一个代理客户协议的代理商,作为芯片的同类工具:由芯片制造的代理商,每个代理商在一个自己的文件夹中,每个房间一个会话.

## 安装

```sh
npm install @chipschat/acp
```

也可以使用：`pnpm add @chipschat/acp`、`yarn add @chipschat/acp`、`bun add @chipschat/acp`

## README

# 芯片app

一个会说话的特工 [代理客户协议](https://agentclientprotocol.com/) (非加太)——克洛德 代码,代码,鹅,双子座——作为芯片吊带,每个吊带一种. 人们的代理人来自 芯片:出自+的一个房间,出自一房间的"添加"一页的新代理,与"叉"的复制. 每个特工都以 它的每个房间都是一个非加太会议。 没有主干员 桥 运行代理程序,所以桥是吊带(Chips ADR 0041),基于 `@chipschat/harness`。 。 。 . 芯片的第四阶段 `docs/proposals/open-source-harnesses-plan.md`和芯片的 `docs/proposals/acp-agents-made-from-chips-plan.md`。 。 。 .

这个 `@chipschat/*` SDK 包来自 npm, 在版本 `package.json` 针,和建筑 把它捆起来 `dist/main.js`。 。 。 .

## 从芯片的画廊

卡片的线是 `CHIPS_JOIN_LINK='<link>' chips connect claude-code` 或者说 `CHIPS_JOIN_LINK='<link>' chips connect codex` (芯片 ADR 0218). 它作为 npm 软件包下载此桥 `@chipschat/acp`最新的1.x 对照登记簿的验收和 运行在节点上 芯片携带,所以机器需要节点或npm本身。 大桥检查代理的ACP适配器 及其登录, 加入,并保持自己从登录运行. `chips disconnect claude-code` 或者说 `chips disconnect codex` 别闹了 Claude Code和Codex分享这个软件包:他们的卡片交给它 `~/Chips/.bridges/acp/claude-code.json` 或者说 `codex.json`,而文件的名称选择类型。 在另一台电脑上, `curl -fsSL https://chipschat.ai/install | CHIPS_JOIN_LINK='<link>' sh -s -- connect claude-code` 安装芯片 先说 下面的台阶是用这个检查结果来管理桥,以便进行这项工作.

## 运行它

```bash
npm install -g @agentclientprotocol/claude-agent-acp   # or @agentclientprotocol/codex-acp
npm install
CHIPS_JOIN_LINK='<a join link made in Chips>' npm run keep ~/Chips/.bridges/acp/claude-code.json
```

`npm run keep` 加入,然后使桥从登录中运行(“保持运行”,下方); `npm start` 只在终点站是相同的.

链接来自奇普斯的画廊(Agents → Connect a tape → Claude Code,或Codex),其卡片给出了这个 与其中的链接相符合(`codex.json` 为 Codex),并开始链接它所需要的内容: `agents`, (中文(简体) ), `new_spaces`, (中文(简体) ), `new_agents`, (中文(简体) ), `forks` 财务报告和审定财务报表 `restarts`。 。 。 . `claude-code.json` 财务报告和审定财务报表 `codex.json` 不需要在那里:没有它们,桥将运行 Claude Code 或 Codex, 以询问模式运行(参见 "调查一个人",每个代理文件夹下方 `~/Chips/Agents/claude-code` 或者说 `~/Chips/Agents/codex`。 。 。 .

在连接开始之前,它检查:

-   装潢是存在的,或者是其中之一;
-   其命令位于此机器的 PATH( 即如何安装它);
-   代理开始, 进行会话, 并签名于 : Codex 在签名时拒绝一个会话, claude Code说,这是作为无人签名的`_auth/status_update`) (中文(简体) ). 签名了,上面写着 以 : `codex login`,或 `claude` 然后/登录.

任何缺失的都阻止了它 做什么, 链接仍然是好的。 加入,在它的问候 房间一次,卡片等待;芯片的新链接取代它保存的密钥. 没有 链接, 设置 `CHIPS_URL` 并允许从芯片打印代码。 它的键被保存为 `join()` 保留 一种(键链,在类型名称下);其光标,未解事件,无限制运行,其代理 每个房间的哪个会话都保存在 配置旁边的文件夹里, 以它命名 (单位:千美元)`~/Chips/.bridges/acp/claude-code/`),所以重启会从原地取出. 每个开始记录是否 探员说签了名 转一圈就拒绝 说要签了.

配置名称 :

```json
{ "name": "Claude Code", "command": ["claude-agent-acp"], "mode": "default", "folders": "~/Chips/Agents/claude-code" }
```

-   `name` 和它自己的经纪人.
-   `command` 代理商如何说非加太语优于平: `["claude-agent-acp"]`, (中文(简体) ), `["codex-acp"]`, (中文(简体) ), `["goose", "acp"]`, (中文(简体) ), `["gemini", "--acp"]`, (中文(简体) ), `["opencode", "acp"]`。 。 。 .
-   `folders` 每个代理商都从那里得到一个以它命名的文件夹(`~/Chips/Agents/claude-code/nova`, (中文(简体) ), 变成空的。 一份来自Fork的复制件在它的原始文件夹中工作, 里面有它的对话文件 记得预期。 一个删除的代理文件夹会保留 .
-   `folder`在它的位置上,每个代理都放在一个文件夹里:一个他们一起工作的仓库.
-   `mode` 它的会话模式是代理报价(见下文). `env` 添加到 它的环境.

保存的一切都没了 `~/Chips` (芯片ADR 0283):各种相貌和所保存的 `~/Chips/.bridges/acp`,代理文件夹在 `~/Chips/Agents`在1.0.13之前 `~/.chips-acp` 财务报告和审定财务报表 `~/chips-acp`。这种移动是它第一次在1.0.13开始的地方: 配置和它所保存的,它的代理文件夹(其中它的配置将旧地命名为"或无"), 保存的文件夹路径,以及 Claude Code 移动的每个文件夹的自有商店 (单位:千美元)`~/.claude/projects/<the folder's path, dashed>`),它持有文件夹的对话和记忆. 它重命名,永远不再复制;在新地方的东西已经移动了,它不是 在那座乐园里,有记录, 旧地上一条布置道,从老芯片的 卡片或之前保存的登录项目,在新条目中读取,并将登录项目保留在新条目中 路径.

安装其他代理 并签入一个模型 是代理自己的方式,在此之前 这里的名字。 第二种是第二次配置,另一种是第一个旁边的第二个桥.

### 其代理人

-   **芯片中的 +**,用绳子的相貌: 房间是声称的, 从第一个字命名 一个新的代理(芯片名称)回答他们.
-   **在房间里加一个新代理**:一个特工称被要求的人加入房间.
-   **叉头**: 代理在房间里的会话被复制(`session/fork`),和副本 记得一直到那时的一切 一个从来没有发言的 复制新鲜.
-   **绳子是自己的房间** 奇普斯特工给每个带 以它命名: 一个普通的 特工,一个人可以移动任何地方.
-   闭会30分钟`session/close`并再次装入下一个字, 代理商同时提供:每次开放的克洛德代码会话都是自己的过程.

### 继续跑

`npm run keep <config>` 做点什么 `npm start <config>` 使用链接或没有链接,然后写 发射剂, `~/Library/LaunchAgents/chat.chips.acp.<config's name>.plist` (系统化用户单位) 在Linux上),它从登录开始运行桥梁,并在停止时再次运行并结束. 它的日志是 `~/Library/Logs/chips-acp-<config's name>.log`· ; `npm run keep -- <config> --stop` 停下来 删除文件。 用手书写的这个名字的发射代理 被留在原地,所以从不 运行两次 :

```bash
launchctl kickstart -k gui/$(id -u)/chat.chips.acp.claude-code   # restart one
```

先停止任何手抄本: 两道桥一个吊带回答两次.

### 问一个人

Claude Code 和 Codex 的适配器以代理商决定的方式开始每次会话 克洛德密码 `auto`代码 `agent` ("自动审查",由Codex自己的审查员回答) 请求). 那么,没有什么到达芯片作为名片。 放在他们问的地方:

```json
{ "name": "Claude Code", "command": ["claude-agent-acp"], "mode": "default" }
{ "name": "Codex", "command": ["codex-acp"], "mode": "workspace-write" }
```

-   Claude Code仍然遵循自己的设置(`~/.claude/settings.json`) (中文(简体) ). 他们允许的 而只读命令从不问.
-   编码在 `workspace-write` 自由更改其文件夹并在网络或任何东西之前询问 在外边. `read-only` 在任何更改之前询问.

## 现场直播

2026年10月14日,在奇普斯的活服务器上:克洛德代码(英语:Claude Code (film))`@agentclientprotocol/claude-agent-acp` 0.90.0,在自己的登录)和Codex(`@agentclientprotocol/codex-acp` 2.2.2,关于ChatGPT 签入). 每个人轮流走步子、仪表和答复。 Claude Code的开销是 转弯; Codex没有,就像在ChatGPT的适配器上签名一样,没有报告. 一团糟了 每个人,要求,批准 在芯片,呼叫运行,并说。 芯片的吗 `testing/scenarios/harnesses/acp-agents-live.md` 运行.

当晚晚些时候, 一种牵引(`~/.chips-acp/claude-code.json`, (中文(简体) ), `codex.json`,发射 代理人 `chat.chips.acp.claude-code` 财务报告和审定财务报表 `chat.chips.acp.codex`),每间:从+到+的房间 由自己文件夹中的新代理、Add公司的新代理、复制本的叉子提出并答复 记得以前发生的事 以及他的原作没有听到复制品 搬出会议室;复制件被删除,其文件夹被保存;30后会议闭幕 几分钟后又装满了记忆 14跑,没有失败,0.35 所有克洛德代码.

## 什么地图是什么

| 芯片 | 非加太集团 |
| --- | --- |
| 给代理人的信息 | `session/prompt` 和谁说的`promptFor`),文件保存于 `<folder>/chips-files/` |
| 房间 | 代理文件夹中的会话 : `session/new` 第一次的时候, `session/load` 在重启或代理商提供时闲置关闭之后 |
| +的一间房间 | `claimSpace` 在新密钥下; 芯片制作它的代理; 第一个单词是它的首个提示 |
| 新代理人(Add) | 记录和文件夹,登记在 `madeFor` 和房间 |
| 叉头 | `session/fork` 原件的会话在会议室、文件夹中; 副本登记在 `forkedFrom` |
| 代理删除 | 届会闭幕`session/close`),其记录被遗忘;其文件夹保留 |
| 运行 | 时间到了; `stopReason` 结束它( e)`refusal` 失败, `max_tokens` 增加后续行动) |
| 状态 | `agent_thought_chunk`,最多每 1.5 s 有线 |
| 步骤 | `tool_call` 编号 : `tool_call_update` 以 `toolCallId`,标题为工具名称或类型 |
| 计划 | `plan` |
| 背景测量,成本 | `usage_update` (单位:千美元)`used`编号 :`size`· ; `cost` (美元,转出份额) |
| 答复 | `agent_message_chunk`收集到一条信息; `NO_REPLY` 孤军奋战 |
| 回复中的文件 | 每个 `MEDIA:<path>` 仅从代理文件夹中上传(`sendAnswer`这篇文章说为什么一个人不能去 |
| 核准卡 | `session/request_permission`,用经纪人自己的话问 哪里的电话有 `description` (克洛德代码的命令:"语法检查游戏.js? `node --check game.js`"),又作"随叫随到"和"呼号";允许总是选取 `allow_always`除了一个命令,它选择 `allow_once` 因为芯片会记住每个部分的起始方式(芯片 ADR 0239);没有选择 `reject_once`; 停止回答 `cancelled`;卡片听到 如何打电话 |
| 问卡 | `elicitation/create` 最多4个选择或是/否字段的形式; 任何其他字段都被拒绝 |
| 停下来 | `session/cancel` |
| 引导 | 同一运行的下一个提示, 之后 `session/cancel` 当它中断时 |
| 不对吗? (芯片 AR 0200) | (单位:千美元) `correction`,或者一个更古老的装置的qq:在那个房间的会话中,又一个说回话的代理(用房间的行号),引用它的回话和什么是错的;运行是 _回头看:....._; qq或其他任何反应都不算什么, 每一个都回答一次 |
| 重新开始 | 代理程序又停止运行 |
| 麻烦 | 代理未运行; 在 2 s 之后再次运行, 每次启动失败会更长 |

代理商没有文件系统也没有终端:它使用自己的工具,在自己的工具下工作 许可,它要求的每个许可都是批准卡.

### 芯片在代理页面上显示的内容

桥上说 `context` 财务报告和审定财务报表 `models` (编)和 `context_windows` (每一种) 在它的问候,并发送每个代理的副本 当它开始和随着变化。 芯片画出它们 带子被授予的地方 `context_files`, (中文(简体) ), `models` 财务报告和审定财务报表 `context_windows`。 。 。 .

| 芯片 | 克劳德代码 | 代码 | 另一种 |
| --- | --- | --- | --- |
| 上下文:它自己的文件 | 它的文件夹 `CLAUDE.md`,以及 `CLAUDE.local.md`, (中文(简体) ), `.claude/CLAUDE.md` 财务报告和审定财务报表 `.claude/rules/*.md` 他们在哪里;那记忆, `~/.claude/projects/<its folder>/memory/MEMORY.md`克劳德代码也写着 一个人可以改变每个, 一个还没有显示空 | 它的文件夹 `AGENTS.override.md`,否则 `AGENTS.md`一个人可以改变 | 无 |
| 背景:共享 | `~/Chips/Agents/claude-code/CLAUDE.md`,每个代理都读取,在管理器的页面上更改;代理文件夹上方的文件和 `~/.claude/CLAUDE.md`,显示和没有改变, 因为他们不只是这些特工' | `~/.codex/AGENTS.override.md`,则 `~/.codex/AGENTS.md`显示和未更改 | 无 |
| 当它读到 | 当会话开始时; 编辑会在其下个回合前关闭代理会话并再次加载, 因此它从下个消息中应用 | 同样的 |  |
| 上下文窗口 | `usage_update` 表示最后一次表示的代理会话; 结束一个转弯的更新窗口(它带有成本), 如以前一样, 可能是默认 | `usage_update` | `usage_update` |
| 现在收紧了 | `/compact` 他说,在经过任何转折之后,这届大会是其本身的转折;它的话是无从谈起的;它的工具呼唤是: `rawOutput` | 相同;从 `usage_update` 当它完成的时候发出 | 在清单中 `compact` 在其命令中 |
| 限制 | 自己从 `autoCompactWindow` 在其设置中 (`modelSettings` 每个型号),相差约33,000个令牌;从芯片上取出一个从每个会场的取出 `_meta.claudeCode.options.settings`,从未在文件中; `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 都比不上 限制是不能改变的 | 桥的:在转弯结束或过弯之后,桥的会话会紧凑;除非选取 | 作为 Codex, 它有的地方 `compact` |
| 型号 | 其适配器为某届会议提供的模型 `model` 选项),每个选项都有其水平(`effort`,没有它的 `default`),用适配器的自用名称(其名称) `xhigh` 是额外高;与"Claude Code's default"相同的是新会话的起始内容: `model` 环境,或自身环境 `default` | 同样的,与 `reasoning_effort`; Codex 配置的默认值, 可能是其列表所忽略的模型, 没有级别 | 无 |
| 在它学会的地方 | 每次桥开始代理,一个会话打开 在吊带的文件夹, 并把每个模型 依次,然后关闭, 没有说什么 | 同样的 |  |
| 一个挑 | 设定代理商每次会话的时间 `session/set_config_option`,现在和每一个打开之后, 永远不要在文件中; 保存在代理, 一份从Fork开始的拷贝 与它的原件。 和Claude代码的级别一样 `default`,并遵循其设置 | ; 代码解码器不会重新放入模型中, 它的列表被遗漏了, 在下个转弯前再次被卸载 |  |

只有在文件仍然是当事人所读的时,才会保存编辑;否则会因更改而被拒绝. 该桥的自有代码适配器与 `project_doc_max_bytes` 在64KiB时 `CODEX_CONFIG`,铺设 在 Codex 的配置上, 它开始的每次会话, 因此 Codex 读取所有的文件 Chips 让一个人 写入( 32 KiB 除非设置) .

## 尚未建立

从计划的第四阶段: 特工们越过了WebSocket(`goose serve`(三); `follows_rooms`; 任意的模型 其它类型; 桥自有的MCP服务器(Reminders, ask a people)和心跳; 以子代理为车道; 自由文本形成字段; 仅限于批准范围 代理选项(电线改变,第6阶段).

## 测试

```bash
npm test
```

ACP剧本代理商(`test/fake-agent.ts`,作为儿童的过程,反对 装配箱的假芯片, 检查每个事件 与协议的图谋; 装配箱的 带有 +、 添加和分叉的金色情景 `chips conformance custom --capabilities agents,new_spaces,new_agents,forks,restarts` 运行 live : 住在6分之5的芯片里 以 Claude 代码运行 `context_files`, (中文(简体) ), `context_windows` 财务报告和审定财务报表 `models` 此外,工具包的设置检查通过:由5个芯片3管理. `test/settings.test.ts` 播放游戏 文档、窗口和各种模型,来自自己的家园;其模型是 Claude Code的适配器0.90.0和Codex的2.2.2于2026年10月28日提供.

```bash
npm run e2e
```

画廊的ACP卡,一个人运行它, 与刮痕芯片 从芯片检查出 (单位:千美元)`CHIPS_REPO`, (中文(简体) ), `~/Work/Chips/chips-main` 除非设定; 跳过而未设置), 并安装在 以自己的名称命名的 PATH( 从不) `claude-agent-acp`,这个机器可能是真实的。 每个 连线还是不错的,然后它加入到卡片上 有一次在房间里,说 没有什么更多的开始 保存下来了 抓痕芯片 链路和跑道来自芯片 `tools/connect-kit`,它包了结账 并服务它 从站立npm注册, 所以卡的 `chips connect` 下载、检查和运行将公布的内容.

## 释放

`npm run release` 正在建设 `dist/main.js`一个SDK的文件 和所有其它文件 `dist/THIRD-PARTY-NOTICES.md` 旁边,进行测试,打包 `chipschat-acp-<version>.tgz`改为: ,将新版本放入 `package.json` (单位:千美元)`npm version <version> --no-git-tag-version`),执行 推着它 `main`: GitHub 的出版工作流程(`.github/workflows/publish.yml`测试它和 发布到npm, 相信该工作流程, 所以没有人签名。 别跑 `npm publish`数字 : 两场比赛 一个版本的主要内容是它所说的芯片协议 和芯片的卡片名称 (Chips ADR 0218):固定是次要的或补丁,在其主要日期到达每张卡片 发表.

## 常见问题

### @chipschat/acp 是什么？

一个代理客户协议的代理商,作为芯片的同类工具:由芯片制造的代理商,每个代理商在一个自己的文件夹中,每个房间一个会话\.

### 如何安装 @chipschat/acp？

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

### @chipschat/acp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chipschat\_\_acp 是否存在。

### @chipschat/acp 支持 ESM 还是 CommonJS？

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

### @chipschat/acp 需要什么版本的 Node\.js？

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

### @chipschat/acp 可以商用吗？

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

### @chipschat/acp 的下载量有多少？

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

### @chipschat/acp 还在维护吗？

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