Harp 是一款专为多 AI 代理打造的 macOS 终端：它是开源终端 Warp 的非官方 fork，用一条"冷静"的侧边栏取代了传统的标签栏，让你同时运行多个 Claude Code 和 Codex 会话，并一眼看出哪一个正在等待你的操作。无论你是同时开三个代理跑重构，还是让 Codex 写代码、Claude Code 做审查，Harp 都能把它们按状态（工作中 / 等待你 / 已完成）分组展示。本文用 3 步带你完成 Harp 终端的安装，并附上新手最关心的常见问题。

为什么选Harp：多开Claude Code与Codex的3个理由

在动手安装前，先花 30 秒了解 Harp 解决了什么痛点。

侧边栏中每个条目就是一个 Claude Code 或 Codex 会话：转圈表示正在工作，橙色标记表示需要你，勾号表示已完成。你可以把标签拖进具名分组（如iOS app、Backend），甚至开启 tmux 集成让分组在重启后保持不变。

说明：Harp 除了侧边栏与用量环，其余能力（内置 AI、Warp Drive 云端会话等）都来自上游 Warp 终端，Harp 自身不新增任何服务器。

第1步：从Releases下载Harp安装包（最快方式）

这是新手推荐路线，全程无需编译：

1. 打开项目的Releases页面，下载最新的Harp-<version>.dmg安装包
2. 双击 dmg 文件，把Harp图标拖进Applications文件夹
3. 完成。整个安装不到 1 分钟

安装细节可参考官方说明：README.md。

⚠️ 小提示：如果系统弹出"无法验证开发者"，到 系统设置 → 隐私与安全性 中点击"仍要打开"即可，因为 Harp 使用的是独立的 Developer ID 签名，而非 App Store 渠道。

第2步：验证安装，确认Harp与Warp互不干扰

很多人担心装了 Harp 会覆盖或冲突已有的 Warp 终端，其实完全不用担心。Harp 拥有自己的一套身份，与 Warp 井水不犯河水：

• Bundle ID：com.dominikmartn.Harp
• URL 协议：harp://
• 配置目录：~/.harp

也就是说，Harp 的设置、数据全部存放在~/.harp下，与 Warp 的~/.warp完全隔离，两者可以并存使用。Harp 的版本信息定义在 app/Cargo.toml 中。

启动后你会看到侧边栏底部有两组用量环：一组给 Claude，一组给 Codex。外环是周限额使用比例，内环是 5 小时窗口比例，悬停即可看到具体数值和重置时间。这些数据完全来自本地（Codex 的~/.codex/sessions日志和 Claude Code 的状态行），Harp 不抓取任何云端数据，也不读取你的凭据。用量环的完整文件格式说明见 docs/limit-rings.md。

第3步：打开Harp，让Claude Code与Codex并排跑起来

在 Harp 中打开新标签（快捷键Cmd+T），分别输入claude和codex启动两个代理会话，它们就会并排出现在侧边栏里：

• 工作中：会话行旁有旋转圆环，表示代理正在执行
• 等待你：橙色"needs you"标记 + 未读点，提醒你去看一眼
• 已完成：打勾标记，并触发一次完成提示
• 后台任务：小圆点表示会话里还有后台工作在进行

如果觉得 Claude Code 的"回合结束但子代理还在跑"时状态显示过早变成 done，可以安装官方的后台任务 hook，让状态一直保持在 working 直到真正跑完，安装方法在 integrations/claude-code/README.md（只需bash、jq、perl三个工具）。

Harp 还会自动检查更新：每 10 分钟对比一次 Releases 最新版本，发现新版后会后台下载 DMG、校验签名，然后提示你重启升级——和 Warp 的更新机制一致，无需手动操作。

进阶选项：从源码构建Harp终端

如果你习惯自己编译（或想改代码），Harp 基于 Rust 开发，Rust 工具链版本锁定在 rust-toolchain.toml（当前为 1.92.0）：

git clone https://gitcode.com/gh_mirrors/harp15/harp cd harp ./script/bootstrap # 一次性安装工具链与构建依赖 ./script/run # 构建 target/debug/bundle/osx/Harp.app 并启动

其中bootstrap会按平台自动执行系统依赖安装（见 script/bootstrap），run在 macOS 上会生成一个真正带签名的.app包。构建产物定义在 script/macos/run。

常见问题FAQ

Q1：Harp 是官方的吗？不是。Harp 是 Warp 的非官方开源 fork，与 Warp 官方团队无关，Warp 商标仍归原作者所有（见 README.md）。

Q2：装完Harp后还需要登录吗？Harp 沿用上游 Warp 的 AI 与云端功能，登录走 Warp 自己的服务器。README 中注明登录流程"未经完整测试"，建议普通用户以本地会话为主。

Q3：Harp 支持 Linux 或 Windows 吗？目前发布渠道是 macOS（dmg 安装包）。源码在其他平台可构建，但官方打包与更新机制仅面向 macOS。

Q4：和 tmux 能一起用吗？可以。在~/.harp/settings.toml中开启integrations.tmux.enabled = true，侧边栏的命名、分组、顺序就会存到 tmux 会话里，重启后布局不变，其他 tmux 客户端看到的布局也一致，还支持手机端 ssh 接入的会话"认领"到侧边栏。

写在最后

3 步走下来——下载 dmg、拖进 Applications、打开即用——Harp 就能把你散落在各个标签页里的 Claude Code 与 Codex 会话收进一条清晰的侧边栏：谁在干活、谁在等你、谁跑完了，一目了然。如果你也同时使用多个编码代理，这套"侧边栏 + 用量环"的组合值得花 1 分钟装上试试。