Canopy 是一款原生 macOS 应用，定位为并行 Claude Code 会话的“驾驶舱”。它解决的核心问题是：Claude Code 擅长在单一目录中专注处理一件事，但真实工程工作往往需要同时推进多个任务（修 bug、重构、写测试、审查代码等），而 git 和 Claude 默认只支持单线操作。Canopy 通过 git worktree 让多个 Claude Code 会话并行运行，并在一个窗口中统一管理。
主要能力
并行会话与单窗口管理：每个标签页是一个独立 worktree，运行各自的 Claude Code 实例。可用 Cmd+1 至 Cmd+9 切换，拖拽排序，按名称、项目、创建日期或目录排序。活动圆点显示哪些会话正在工作，以及哪些会话被阻塞、正在等待用户输入（权限提示会让圆点变琥珀色，状态栏显示“1 needs input”）。状态栏还会显示当前会话的 Claude 运行信息，如模型、推理强度和上下文读取量。
会话自动恢复：关闭并重新打开 Canopy 后，所有会话都会恢复，并自动续接其 Claude 对话。Canopy 通过 --session-id <uuid> 为每个新会话分配 ID，后续启动都恢复该对话，因此标签页从一开始就绑定自己的对话，不会被同目录下手动运行的 claude 劫持。
活动仪表盘：解析 ~/.claude/projects/ 下的 JSONL 文件，展示历史 token 总量（输入与输出）、最近 12 周用量、会话数量、最繁忙的一天、按模型系列（Opus、Fable、Sonnet、Haiku）的占比，以及 12 周逐小时热力图。
命令面板：Cmd+K 打开模糊搜索面板，可搜索会话（按名称、项目、分支、终端输出）、项目和快捷操作（新建会话、新建 worktree 会话、设置）。
终端内查找：Cmd+F 在会话终端输出中进行增量搜索，匹配项高亮，回车跳转下一个，Shift+回车跳转上一个，Esc 关闭。
显示对话记录：右键会话选择 Show Transcript…，以干净、可滚动、只读的方式查看完整对话。运行时读取结构化 JSONL 日志，渲染用户/助手轮次并支持 markdown 格式，工具调用压缩为单行摘要，支持实时更新和自动跟随开关，可用 Cmd+Shift+C 复制格式化 markdown。
分屏终端：Cmd+Shift+D 在 Claude 终端下方切换一个辅助 shell 面板，作用域为同一 worktree，可运行 git status、查看测试输出或跟踪日志，无需打断 Claude。
沙箱隔离：可在设置中按全局、项目或会话选择沙箱后端，共四种：Off、Claude sandbox（仅 Bash，基于 macOS Seatbelt，无需安装，但只限制 Bash，读取由拒绝列表控制，~/.ssh 和 ~/.aws/credentials 仍可读）、Docker Sandbox（sbx，通过 sbx run 运行微 VM，旧版不支持会话恢复，需 Docker Desktop 和 sbx）、Apple container（通过 Apple 开源容器运行时运行轻量 VM，限制整个 Claude 进程，支持会话恢复，需 macOS 26+ 与 Apple 芯片，需安装 container 并每次启动运行 container system start）。两个 VM 后端会绑定挂载 worktree（worktree 会话还会挂载主仓库），未挂载内容不可访问。
合并与收尾：右键会话选择 Merge & Finish，通过两阶段确认完成合并与清理。第一阶段选择目标分支、确认提交数、预览冲突；第二阶段选择清理 worktree 目录、功能分支、两者或都不清理。跨 worktree 预检会显示当前分支与其他 worktree 分支的冲突（真实文本冲突，用 git merge-tree 计算）和共享表面（如包清单、锁文件、迁移、生成类型等高危文件），仅作提示不阻止合并。
项目视图：点击侧边栏项目可查看所有 worktree、分支、状态、冲突警告徽章，以及打开、合并、删除的一键按钮。“Open All”可一次性恢复所有非活动 worktree 及其之前的 Claude 会话。项目视图还通过 gh pr list 列出仓库的所有开放拉取请求。
Git 感知：每 10 秒轮询 git 和 gh，状态栏显示修改文件及增删行数、领先上游的提交数等。
使用方式
推荐通过 Homebrew 安装，也可从 Releases 下载最新 .dmg，打开后拖入 Applications 启动。应用已签名并公证，可正常打开。最快上手方式：按 Cmd+T，指向任意 git 仓库并开始提示。若需并行多个 worktree，可按以下步骤：用 Cmd+Shift+P 添加项目（配置要复制的文件如 .env、符号链接路径如 node_modules、安装命令如 npm install）；用 Cmd+Shift+T 创建 worktree 会话（选择基础分支、命名功能分支），Canopy 会创建 worktree、复制配置、运行安装并启动 Claude Code；再次 Cmd+Shift+T 可创建并行任务；完成后右键选择 Merge & Finish 合并并清理。
适用场景与限制
适用于需要同时推进多个分支或任务的开发者，尤其是重度使用 Claude Code 进行生产工作的用户。限制包括：仅支持 macOS 14+；部分沙箱后端有额外系统要求（如 Apple container 需 macOS 26+ 与 Apple 芯片）；Docker Sandbox 旧版不支持会话恢复；Claude sandbox 仅限制 Bash 且读取由拒绝列表控制；跨 worktree 预检仅为提示性，不阻止合并。商业使用需注意 AGPL-3.0 许可，可获取商业许可。
