Chord

更快、更省、更轻的终端 Coding Agent。
单次任务实测:耗时和成本约为 Claude Code 的 1/3。
单个会话只占几十 MB 内存,配置不高的电脑也能同时跑多个 Agent。

快速开始 · 模型接入 · 文档站 · English README

CI Release Go Version License

Chord 终端界面:左侧是工具调用、补丁和诊断,右侧是模型、用量、待办和变更文件

## 实测数据 六款编程 Agent 用同一模型(`DeepSeek-V4.1-Flash-1017`)完成同一 [DeepSWE v1.1 任务](https://deepswe.datacurve.ai/data/v1.1/tasks/httpx-streaming-json-iteration),Chord 用时最短、成本最低: | 工具 | 耗时 | 估算成本 | |---------|------|------| | Chord 0.8.1 | **6m37s** | **¥0.348** | | deepseek-harness 0.1.5-rc.1 | 9m50s(1.49 倍) | ¥0.527(1.51 倍) | | pi 0.85.1 | 10m22s(1.57 倍) | ¥0.576(1.65 倍) | | Codex 0.154.0 | 17m01s(2.57 倍) | ¥0.929(2.67 倍) | | mini-swe-agent 2.4.6 | 18m29s(2.79 倍) | ¥0.835(2.40 倍) | | Claude Code 2.1.272 | 22m25s(3.39 倍) | ¥1.104(3.17 倍) | 加载 200 条消息后,Chord 占用 39 MB 内存(Claude Code:216 MB)。以上数据来自一次任务实测和一次内存测试,不代表普遍结果;token 明细与测量条件见[性能](./docs/performance_CN.md#实测数据)。 ## 三步上手 ### 1. 安装 macOS 或 Linux 已安装 [Homebrew](https://brew.sh) 时: ```bash brew install keakon/tap/chord chord --version ``` Linux 与 macOS 未安装 Homebrew 时: ```bash curl -fsSL https://github.com/keakon/chord/releases/latest/download/install.sh | bash chord --version ``` 如果该 URL 返回 404,说明最新发布版还没带上安装脚本,详见[快速开始](./docs/quickstart_CN.md#1-安装)。 Windows 从 [GitHub Releases](https://github.com/keakon/chord/releases) 下载压缩包,解压后把 `chord` 加入 `PATH`。
用 Go 安装 使用 Go 1.27.0 或更新版本: ```bash go install github.com/keakon/chord/cmd/chord@latest ``` `go install` 会把二进制放在 `$(go env GOPATH)/bin`,需确认该目录在 `PATH` 中。修法见[快速开始](./docs/quickstart_CN.md#用-go-安装)。
升级方法、macOS 下载版被系统阻止时的处理见[快速开始](./docs/quickstart_CN.md#1-安装)。 ### 2. 在项目里启动 在交互式终端进入项目目录: ```bash cd my-project chord ``` 首次运行会进入向导:填写模型 API 地址、模型名称和 API key,或通过 Codex OAuth 登录。已有账号或 API 是否支持,见[账号与 API 支持](./docs/model-choice_CN.md#账号与-api-支持)。 ### 3. 发送第一个任务 > [!IMPORTANT] > Chord 默认会直接修改文件和执行命令;使用 `delete` 删除文件,或通过 `apply_patch` 删除、移动文件时,需要确认。想让其他操作也先审批再执行,请在发送任务前配置[权限规则](./docs/permissions-and-safety_CN.md)。 说明任务并按 Enter 发送。先问一个项目相关的问题: ```text 请解释这个项目的主要模块和测试入口,先不要修改文件。 ``` 按 Esc 进入 Normal 模式,再在两秒内连按两次 q 退出。下次在同一项目目录运行 `chord --continue` 继续最近的会话。 ## 功能 - [多 Agent 并行](./docs/usage_CN.md#多-agent-与焦点切换):[定义子 Agent 角色并授予主 Agent 委派权限](./docs/configuration_CN.md#agent-配置)后,主 Agent 可把子任务交给子 Agent 并行处理,按 Shift+Tab 切换查看。 - [模型自动切换](./docs/configuration_CN.md#模型池):用模型池组合多个服务商和模型,请求失败时自动换下一个。 - [长会话不爆上下文](./docs/context-management_CN.md):每次请求前剪掉旧的大块工具输出,上下文接近上限时压缩成摘要。 - [执行前可审批](./docs/permissions-and-safety_CN.md):按工具和命令设置 `allow` / `ask` / `deny` 规则,决定哪些操作要先确认。 - [导入已有会话](./docs/usage_CN.md#导入外部会话):导入 Claude Code、Codex 或 OpenCode 的会话历史,在 Chord 中继续工作。 - [无界面控制](./docs/headless_CN.md)与 [ACP 接入](./docs/acp_CN.md):通过 `chord headless` 接入其他界面,或用 `chord acp` 在 Zed 等编辑器中使用。 ## 按主题查文档 - [快速开始](./docs/quickstart_CN.md):安装、接入模型,完成第一个任务 - [使用指南](./docs/usage_CN.md):日常操作、恢复会话、长任务和并行工作 - [模型配置](./docs/model-configs_CN.md) · [配置示例](./docs/examples/index_CN.md):接入模型或自定义网关 - [权限与安全](./docs/permissions-and-safety_CN.md):决定哪些操作需要确认 - [扩展与定制](./docs/customization_CN.md):配置多 Agent、技能、代码诊断和外部工具 - [Headless 集成](./docs/headless_CN.md):通过 `chord headless` 从其他入口操控 - [ACP Agent 模式](./docs/acp_CN.md):通过 `chord acp` 让 ACP 客户端(如 Zed)直接调用 Chord - [排障](./docs/troubleshooting_CN.md) · [完整文档目录](./docs/index_CN.md) ## 项目链接 - 配套项目:[keakon/chord-gateway](https://github.com/keakon/chord-gateway) - [贡献指南](./CONTRIBUTING.md) - [Changelog(中文)](./CHANGELOG_CN.md) - [问题反馈](https://github.com/keakon/chord/issues) ## 平台支持 Chord 主要在 macOS 上开发和测试,Linux 表现良好,Windows 大体可用但可能存在未发现的 bug。各功能的平台差异见[平台支持](./docs/platforms_CN.md)。 ## 致谢 Chord 基于 [Bubble Tea](https://github.com/charmbracelet/bubbletea) 构建,设计与功能借鉴了 Claude Code、Codex、OpenCode 和 Crush,主要使用 GPT-5.4/5.5 辅助开发。感谢 [linux.do](https://linux.do/) 上大量公益站提供 tokens。 ## License MIT License,详见 [LICENSE](./LICENSE)。