Masko for Claude Code

Masko for Claude Code 是什么？

Masko for Claude Code 是一个免费、开源的 macOS 桌面伴侣，在 Claude Code 会话旁显示动画吉祥物叠加层。它实时跟踪会话活动，当 Claude 需要权限或注意时弹出，并让你无需切换编码工作流即可批准或拒绝操作。

该应用以轻量叠加窗口运行，为每个 Claude 会话提供可观测性仪表板——显示会话状态、活动 Feed 和权限提示——通过 Claude Code 的钩子系统保持一切本地化。

主要功能

• Claude Code 的 macOS 叠加吉祥物：吉祥物浮动在其他窗口上方，根据当前会话状态更新（例如，空闲、工作、需要注意）。
• 实时权限处理：当 Claude 请求运行命令时，叠加层提供键盘 allow/deny 流程，而非鼠标切换。
• 通知仪表板：仪表板显示会话快照（例如，运行中/等待输入/压缩中）、颜色编码事件 Feed 和会话摘要。
• 子代理跟踪：实时监控子代理，让你看到主会话之外发生的情况。
• 键盘优先会话控制：包含切换会话、跳转到运行 Claude Code 的终端标签页以及确认权限操作的快捷键。
• 本地优先行为：应用使用 Claude Code 的钩子系统接收事件元数据（工具名称和会话状态），但不读取你的代码；本地运行，不发送代码到服务器。

如何使用 Masko for Claude Code

1. 在 macOS 上下载安装：通过提供的 macOS DMG 安装应用；应用驻留菜单栏，而非 clutter Dock。
2. 首次授予无障碍权限：首次启动时，应用自动安装 Claude Code 钩子，并需无障碍权限以支持叠加层。
3. 启动 Claude Code：打开终端正常运行 Claude Code，让应用观察会话。
4. 从叠加层交互：当提示时（例如 Claude 要运行命令或提问），使用键盘快捷键批准/拒绝并聚焦正确终端标签页。
5. 选择吉祥物：默认使用六个内置吉祥物，或从 masko.ai 加载自定义吉祥物到桌面应用。

使用场景

• 无需上下文切换批准 Claude Code 命令：当 Claude 请求运行某物权限（例如构建命令）时，叠加层呈现 allow/deny 操作，让你快速用键盘确认。
• 跟踪多个会话中 Claude 的活动：借助会话切换器和终端跳转，你可管理多个 Claude 会话，并移至每个会话绑定的确切终端标签页。
• 审阅会话活动和工具调用：使用通知仪表板检查有序事件（工具调用和完成），了解会话随时间变化。
• 处理“等待输入”时刻：当会话显示等待输入状态时，仪表板和通知帮助你识别并及时响应。
• 跟踪依赖子代理的代理活动：如果工作流触发子代理，子代理跟踪实时显示这些活动，让你跟随完整执行路径。

常见问题

Masko for Claude Code 免费吗？
是的。桌面伴侣免费开源，采用 MIT 许可。

Masko 需要服务器或 API 密钥吗？
不需要。提供的信息表明无配置文件、无服务器、无 API 密钥，一切本地运行。

Masko 收集什么，它读取我的代码吗？
Masko 使用 Claude Code 的钩子系统，接收事件元数据如工具名称和会话状态。它不读取你的代码。

吉祥物如何工作？
应用默认包含六个吉祥物。你也可从 masko.ai 设计或引入自定义吉祥物并加载到桌面应用。

Masko 能帮我跳转到正确终端吗？
能。叠加层提供快捷键瞬间聚焦运行 Claude Code 的终端标签页，支持页面提及的终端和编辑器（例如 iTerm2、Terminal.app、VS Code、Ghostty）。

替代方案

• 终端/编辑器原生方式（无覆盖层）：依赖 Claude Code 在终端或 IDE 中的提示，就地响应。与此不同的是，需要切换注意力，而不是使用常驻覆盖层和仪表板。
• 通用 macOS 通知/自动化工具：使用通知路由或键盘自动化来突出提示和操作。这更通用，可能无法提供 Claude Code 专属会话可见性或基于吉祥物的状态显示。
• 其他开发者生产力覆盖层：寻找提供会话跟踪和开发者工作流快速导航的工具。这些通常聚焦代码导航或聊天历史，而非 Claude Code 权限提示和会话事件流。
• 纯 CLI 工作流，手动权限检查：从命令行运行 Claude Code，并在执行前手动审查命令。这提供最大简易性，但缺少实时仪表板可见性和覆盖层的单键/键盘批准。