首页 / 文章

Skipper:一款可用于同时运行多个Claude Code会话的本地控制面板。

一个免费的开源控制面板,可追踪Claude Code会话、子代理和循环机制,在需要权限时向用户发送提醒,还能让用户通过浏览器或手机操控代理。

发布者:REACTAPP.TOP阅读约 6 分钟1433 词

来源: Claude Code Dashboard: How I Track Multiple Claude Code Sessions, Subagents and Permission Prompts in One Place

一旦 Claude Code 不再只是单次会话的使用方式,终端界面布局就会发生变化。此时会有四到五个会话同时运行:一个负责重构后端,一个在 git 工作树中编写测试,还有一个 /loop 状态处于休眠状态直到 CI 流水线完成,还有一个会话则启动了三个后台子代理并正在等待它们的反馈。在某种模式出现之前,这一切看起来都很高效。但二十分钟后回到终端时,却发现那个会话一直都在那里,不断询问是否允许执行某个命令。这意味着,因为注意力集中在另一个窗口上而需要一次按键操作,这个 AI 编码代理就有二十分钟处于空闲状态。

并行运行多个代理确实很强大,但终端从来就不是为管理它们而设计的。关键问题在于当前哪个会话需要人工干预。由于没有现有工具能解决这个问题,于是便有了 Skipper 的诞生。

Skipper 是什么

Skipper 是 Claude Code 的任务控制中心。它是一个免费的本地开源控制面板,能够实时显示机器上的所有会话、子智能体、/loop 功能以及待办事项列表,让你无需在多个终端之间切换即可对它们进行操作。只需一条命令即可启动它:

npx github:bilol-makhmudov/skipper

打开 http://localhost:4317,每个会话都会显示清晰的状态:

  • 需要权限: Claude 正在等待使用某工具的批准。
  • 需要您操作: 当前轮次已结束,下一个消息由您处理。
  • 正在运行: 会话正在执行中,工具正在使用中,并显示该轮次已过去的时间。
  • 处于休眠状态: 有 /loop 正在等待下次唤醒,会显示倒计时及暂停原因。

需要关注的会话会浮显在顶部。标签页标题会显示正在等待的会话数量,而图标颜色会变为琥珀色或红色,这样即使标签页被固定,也能及时发出提示。

监控子智能体、待办列表和循环

除了会话状态外,控制面板还会显示每个智能体当前正在执行的任务:

  • 实时的待办事项和任务列表,以及包含负责人和阻碍因素的代理团队任务列表。
  • 后台子代理的信息,包括其名称、模型、工作树分支以及上次操作的时间。
  • /loop计时器,可显示下一次唤醒时间以及暂停的原因。
  • 工作流、拉取请求和生成物,一键即可访问。
  • 记录您离开期间所有会话中发生的所有事件。
  • 按日、项目和模型显示令牌使用情况,包括子代理的数据,并可导出为CSV格式。

权限提示通知

这正是Skipper存在的意义。只需一条命令即可设置:

skipper hooks install

它在设置中新增了两个官方的 Claude Code 钩子:Notification 和 Stop。此后,每当会话请求权限时,就会响起提示音并显示桌面通知,该通知会一直存在直到被点击,同时显示需要批准的准确命令。当一轮对话处理完成后,则会发出较轻的提示音。

这个钩子几乎不起任何作用。它只是向本地的事件文件追加一行内容后就退出,因此不会拖慢会话速度或导致会话中断,而这比任何功能都更重要。那些不想保持浏览器标签页打开的人可以运行 skipper hooks native on 来直接发送系统通知。

主动控制,而非仅旁观

  • 向会话发送消息。 对于在终端中打开的会话,消息会直接添加到该对话中。已结束的会话会在后台从其原始工作目录重新启动。
  • 编辑任务。可以添加、重命名、完成或删除任务,但那些仍在阻塞其他任务的无法被移除。
  • 私人笔记。每次会话都可以保存笔记,合适的时候可将笔记转发给 Claude。
  • 只读模式。使用 --read-only 参数即可关闭所有写入操作。
  • 借助语音助手在手机上使用 Claude Code

    当控制面板能够正常使用时,接下来的需求就是在远离办公桌的地方也能使用它,比如在泡茶时想确认迁移是否已完成。为此,Skipper 开发了一款基于 Flutter 的 iPhone 应用。通过扫描控制面板上的二维码即可配对,该应用会显示相同的会话、活动和对话内容。其中最常被使用的功能就是语音助手。

    只需轻触麦克风,问题“有什么需要我处理?”就会得到语音回复:哪些会话正在等待授权、哪些已经完成、哪些仍在运行。后续操作无需重复输入会话名称即可进行。说出“让结账会话在本次测试后停止”后,助手会重复该指令并等待确认,只有在得到肯定答复前不会发送任何内容。它支持英语和乌兹别克语。在免提模式下,它会持续监听,一旦用户开始说话就会立即停止发声。

    实际上,这个助手就是 Claude Code 本身,以无界面模式运行,通过 MCP 提供了一小套只读的 Skipper 工具,还有一项用于发送消息的工具。它能看到 Skipper 所能看到的一切内容,未经确认不会做任何更改。

    Claude Code 如何在磁盘上存储会话

    令人惊喜的是,Claude Code 已经在 ~/.claude 目录下生成了控制面板所需的所有内容:

    • ~/.claude/projects/*/<session>.jsonl 用于存储会话记录:提示词、回复、待办列表、子智能体、循环逻辑以及拉取请求。
    • ~/.claude/sessions/*.json 用于记录哪些会话正在运行,以及每个会话是处于忙碌状态还是空闲状态。
    • ~/.claude/tasks 和 ~/.claude/teams 用于存储任务列表和智能体团队信息。

    转录内容会从上次处理完毕的位置开始逐步读取,因此即便处理历史记录非常庞大也能保持响应迅速。当文件监控机制触发时,变化会通过 Server-Sent Events 传输到浏览器,因此无需轮询,也不存在刷新按钮。后端仅为纯 Node.js,没有运行时依赖;前端则是普通的 HTML、CSS 和 JavaScript,无需构建步骤或框架。

    以本地优先且私密为核心

    会话中包含代码和提示语,因此用于读取这些内容的工具在安全性方面必须十分严谨。

    • 无外部数据传输。该工具不包含任何遥测功能、CDN 服务或外部调用。只有电话上的可选语音回复会通过 Microsoft 的语音服务联网,而语音转文本的功能则由机器上的 Whisper 来处理。
  • 默认绑定到回环地址。主机头验证可防止DNS重新绑定。
  • 令牌控制电话访问权限。在局域网中,启动输出会包含一个带有随机令牌的链接,没有该令牌的请求将无法获得任何响应。
  • 写入路径经过强化保护。每个写入操作都需要自定义主机头、JSON数据载荷、同源请求以及经过验证的ID。claude CLI以参数列表的形式接收消息,绝不会通过shell传递。
  • 严格的内容安全策略。所有内容都以文本形式呈现,绝不会以原始HTML形式显示。
  • 安装方法

    npm install -g github:bilol-makhmudov/skipper
    skipper hooks install      # chime and notify on permission prompts
    skipper service install    # run in the background, start at login
    

    添加 --demo --open 可以打开包含示例会话的导览。需要 Node.js 20 或更高版本,支持 macOS、Linux 和 Windows 系统。

    常见问题

    • 每个会话都有对应的视图吗? Skipper 会自动在 ~/.claude 下查找会话,新会话一旦启动就会显示出来。
    • 子代理、代理团队和工作树也被涵盖吗? 是的。后台子代理、带有负责人的团队任务列表以及工作树分支都会被列出。
    • 需要权限时会发出提示音吗? 在执行 skipper hooks install 后,权限请求、问题以及对话结束都会触发提示音和桌面警报。
  • 消息能否发送到正在运行的终端?它会进入该终端自身的对话记录中。已关闭的会话会在后台悄悄恢复。
  • 成本和状态如何?该工具免费且采用MIT许可证。它是一个独立项目,与Anthropic无关。
  • 未来的规划包括加密电话连接、Android版本以及更多便捷的会话操作功能。