# @chorded/chord 中文文档

规范地址：https://npmcn.com/package/%40chorded/chord/

版本：0\.68\.0
npm 元数据更新时间：2026-11-07T00:17:28.680Z
中文译文更新时间：2026-11-09T14:40:42.425Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：13.9 kB，4 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-14T12:38:15.180Z
- 最新版本发布：2026-11-07T00:17:28.516Z
- 近 30 天下载量：2710（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

ACP编码代理的全屏终端客户端.

## 安装

```sh
npm install @chorded/chord
```

也可以使用：`pnpm add @chorded/chord`、`yarn add @chorded/chord`、`bun add @chorded/chord`

## README

# ![chord](https://npmcn.com/package/%40chorded/chord/docs/images/logo-light.png)

**每个编码代理都有一个终端.**  
Claude Code, Codex, 双子座 CLI, Cursor, OpenCode 和 31, 在一个中 键盘驱动窗口,并肩并肩,作为一个团队工作.

[![npm](https://img.shields.io/npm/v/@chorded/chord?color=47e7a5&label=npm)](https://www.npmjs.com/package/@chorded/chord) [![CI](https://github.com/IKatsuba/chord/actions/workflows/ci.yml/badge.svg)](https://github.com/IKatsuba/chord/actions/workflows/ci.yml) [![MIT licence](https://img.shields.io/badge/licence-MIT-blue)](https://npmcn.com/package/%40chorded/chord/LICENSE) ![macOS and Linux](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey)

![chord handing an issue to a team: a lead, tester and reviewer on Claude, a coder on Codex, each with its state under the prompt](https://npmcn.com/package/%40chorded/chord/docs/images/team.png)

和弦将克洛德代码, Codex,双子座CLI 和其他编码代理组成一个 终端接口: 相同的记录、 diffs、 许可提示、 斜线 命令, `@` 提及和计划。 它连接到特工通过 [代理客户协议](https://agentclientprotocol.com/)。 。 。 .

并肩运行特工或给一个团队一个任务. 例如,有代码x 写一个固定和克洛德审查, 每一个都有自己的模式和作用。 探员 交换信件,权限请求会来找你,被保存的团队可以 承担你的下一个任务.

```sh
npm install -g @chorded/chord
chord            # choose an agent, here
chord codex      # or any other agent
```

`chord` 打开标题页,上面有标志、版本和目录 特务拾取者. 更小的窗户缩小艺术, 然后留下一行, 然后选取者.

![The start page with the CHORD logo above the agent picker and Claude highlighted](https://npmcn.com/package/%40chorded/chord/docs/images/start.png)

## 为什么和弦

-   **任何代理,一个接口.** 36名特工从箱子里出来 [非加太国家登记处](https://agentclientprotocol.com/) 以及他们自己的CLI。 切换 特工没有再学习钥匙.
-   **合作的探员.** 在你说话的那个旁边开个代理 将一份工作交给一个被拯救的团队, 并看着他们每个人在列表下 快点 消息在他们之间传递;权限仍然降临到你身上.
-   **每个行动都有关键.** 屏幕上没有东西需要老鼠. `?` 列出他们 全部, 并有一个密钥绑定文件移动它们 .
-   **没什么好设置的.** 一个二进制,没有帐户,没有守护进程. 和弦开始 代理,保持会话,并把它还给 `chord --continue`。 。 。 .
-   **开源.** 麻省理工学院,建立在 [打开TUI](https://github.com/anomalyco/opentui) 编辑 [ACP SDK 软件](https://github.com/agentclientprotocol/typescript-sdk)。 。 。 .

## 参观

### 可以读到的回复和微分

编辑全部到达, 编号, 突出的 diff , 并用长行包裹 根据他们的代码。 复制回复加入被包裹的文本; 外部引用代码 拷贝没有它的盒子。 区块之间的空行停留.

![An Edit tool call drawn as a coloured diff](https://npmcn.com/package/%40chorded/chord/docs/images/edit.png)

### 你负责

代理商要求的每个许可都是笔录下的选择,回答 带有数字或箭头。 在转弯之间,你只能打字: ctrl+x 移动入框以回答. `shift+tab` 循环许可模式.

![The permission prompt: Allow, Always allow, Deny](https://npmcn.com/package/%40chorded/chord/docs/images/permission.png)

### 特工们在主线旁边

`/new [agent]` 打开主线旁的闲置代理,然后转到它。 名单 他们的状态和隐形新闻. `/fork [name]` 在单独的代理中继续当前对话 运行时间支持它. `/clear` 重新启动选中的代理 . `ctrl+x a` 带你去等什么.

![The agents list, with docs waiting on a permission](https://npmcn.com/package/%40chorded/chord/docs/images/agents.png)

### 子剂, 折叠

当代理粉丝退出时,它的子代理像一棵树一样运行;ctrl+o显示他们的 整个任务和工作。 克劳德的发射和信息 `→ to Agent(<title>)` 财务报告和审定财务报表 `← from Agent(<title>)` 作行相会. Claude、 Codex 和光标子剂 加入监视器并生成任务 `background` 下表摘要 探员名单 从空的提示中, QQ通过代理到达它; 输入打开 屏幕上方的边框。 输入显示项目 工作或显示器的命令和最新输出; `x` 停止提供.

![Two subagents running in parallel under one block](https://npmcn.com/package/%40chorded/chord/docs/images/subagents.png)

### 团队

描述一下你的工作方式 和经纪人提议一个团队: 领导及其成员, 在运行时间、模式和模式上。 存了一次,再拿来 任务 `/team run bugfix <job>` 使用它保存的成分。 在谈话中, 其指示可以要求发射装置读取提供者限制并选择 支持该运行的设置,保留保存的团队不变。 限制是 根据请求在 Apple 硅Macs 上读取,并安装了正式代码或原生代码 克劳德代码;见 [指南](https://npmcn.com/package/%40chorded/chord/docs/guide.md#resource-facts-and-team-selection) 他们的极限.

![A proposed team as a table of agents, with a box asking where to save it](https://npmcn.com/package/%40chorded/chord/docs/images/proposal.png)

### 捡起你离开的地方

`chord --resume` 打开一个标题页, 列出由代理服务器的早先会话 标题,或未标题的第一个提示。 在会场里, `/resume` 打开 名单 退出时,和弦会打印出命令将主力带回.

![The chord --resume title page with the logo above a framed list of earlier Claude sessions](https://npmcn.com/package/%40chorded/chord/docs/images/resume.png)

## 安装

```sh
npm install -g @chorded/chord   # or bun, pnpm, yarn
```

包是一个小的shim环绕一个预建的二进制,用于macOS和Linux, arm64和x64; macOS 二进制被签名和公证. `chord upgrade` 通过安装它的软件包管理器更新它.

和弦为您启动每个代理( 通过 `npx` 或者说 `uvx`,或经纪人自己的 在有CLI的地方),所以代理商自己的登录是它所需要的全部: 签入到 Claude Code, Codex 或双子座,你通常会这样.

从源头建造,与 [阿宝](https://bun.sh/) 1.4.4或更新:

```sh
git clone https://github.com/IKatsuba/chord && cd chord
bun install
bun dev compile --install   # into ~/.local/bin/chord
```

## 使用

```sh
chord                  # choose an agent in this directory
chord gemini -C ~/src/app
chord agents           # agents, startup commands and own CLI availability
chord acp codex         # serve ACP on stdin and stdout for another client
chord --continue       # the latest session here, again
chord --resume <id>     # a recorded session, on its own agent
chord --resume         # pick an earlier session
chord -p "Explain src/main.tsx"          # one reply on stdout, for scripts
git diff | chord -p "Review this" --output-format json
```

里面的窗口,完成列表,历史搜索, `?` 和命令拾取器 悬浮在提示上方的笔录上,保持高度并滚动. 迅速、状态和特工 留在他们的排:

| 密钥 | 对 |
| --- | --- |
| `?` | 每个键, 在空提示上 |
| `/` | 斜线命令,和弦和代理 |
| `@` | 提及文件 |
| `@@` | 完成代理名称 |
| `!` | 为代理运行 shell 命令, 其输出 |
| `alt+←` 编号 : `alt+→` | 在提示中逐字移动 |
| `cmd+←` 编号 : `cmd+→` | 线路的起站起站起站起站起站出站 |
| `tab` | 将最古老的队列发送到运行中的转折中 |
| `shift+tab` | 循环权限模式 |
| `ctrl+o` | 扩展输出和子代理 |
| `ctrl+x a` | 去你等着的地方 |
| `ctrl+x b` | 选择代码; `c` 副本, `r` 输入提示 |
| `esc` | 中断转弯 |

设置在 `~/.config/chord/settings.json` 和项目 `.chord/settings.json`: 默认代理( 在启动拾取器中突出显示) ),每个代理的模型,努力和模式,MCP服务器,主题 和通知书。 每个新未命名的交互式开始再次询问; 选择 适用于该运行,而不保存。 主代理可以读取设置和 请求更改允许的密钥通过 `settings`每一个变化都需要你的同意. 读取只返回已检查的设置, 与 `env`, (中文(简体) ), `headers`, (中文(简体) ), `command`, (中文(简体) ), `args` 财务报告和审定财务报表 `url` 价值被掩盖。 未知的服务器字段, 例如 `token` 为: 退出; 实际设置名称和代理、 服务器和 `env` 键 名字可以到达模型.

**[指南](https://npmcn.com/package/%40chorded/chord/docs/guide.md)** 有其他一切: 每面旗帜,设置,钥匙, 团队文件格式,和弦的 MCP 代理工具,以及会话如何 记录.

## 支助代理人

Claude Code, Codex, 双子座 CLI, 副驾驶, Cursor, OpenCode, Cline, Quen 代码, Kimi Code, Kiro, Goose, Junie, 工厂机器人, Auggie, Kilo, bob, Devin, fx 游戏机 以及更多内容: `chord agents` 打印完整列表,其他非加太公司代理运行 与 `chord --agent-command "my-agent --acp"`。 。 。 .

## 捐款

欢迎提出问题和拉动请求. [捐款额](https://npmcn.com/package/%40chorded/chord/CONTRIBUTING.md) 已经 如何从源头运行和弦与它的脚本测试代理, 选择检查 并遵循守则惯例。 找到安全问题了吗? 见 [警卫](https://npmcn.com/package/%40chorded/chord/SECURITY.md)。 。 。 .

上面的截图是和弦本身,被 `bun dev screenshots` 有固定设置和会话以及脚本测试代理.

## 许可证

和弦的代码是 [麻省理工学院](https://npmcn.com/package/%40chorded/chord/LICENSE)。其二进制中包括 FFmpeg LGPL-2.1-或后通过OpenTUI. npm 平台软件包包括 `LICENSE-FFMPEG`, (中文(简体) ), `LICENSE-ZLIB` 财务报告和审定财务报表 `FFMPEG-SOURCE.md` 和弦旁边 `LICENSE`· ; [指南](https://npmcn.com/package/%40chorded/chord/docs/guide.md#rebuilding-with-a-modified-libopentui) 解释如何用被修改的库重建. 和弦名称和 chevron mark是Igor Katsuba的商标,在许可证之外;叉子 应自画([贸易](https://npmcn.com/package/%40chorded/chord/TRADEMARKS.md)) (中文(简体) ).

和弦是开放的兄弟姐妹 [弦调](https://chorded.app/)一个本地的macOS 由密钥和弦驱动的代理会话工作空间.

## 常见问题

### @chorded/chord 是什么？

ACP编码代理的全屏终端客户端\.

### 如何安装 @chorded/chord？

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

### @chorded/chord 支持 TypeScript 吗？

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

### @chorded/chord 可以商用吗？

@chorded/chord 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chorded/chord 的下载量有多少？

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

### @chorded/chord 还在维护吗？

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

