把 Claude Code 的状态
钉在桌面旁边
多开 Claude Code 时，每个进程在干嘛、谁在等你、谁还在跑——iPhone 放电脑旁边，余光扫一眼就清楚。要切窗口时，点一下卡片，Mac 自动切到对应终端。
你是不是也遇到过这些
- 同时开了 4 个 Claude Code，要看哪个进度只能挨个切窗口
- 想把状态 dashboard 常开，又占用宝贵的主屏空间
- 单屏开发，Claude 跑着的时候连分屏看文档都嫌挤
- 用第三方 API（CC Switch / 各种代理），官方 Remote Control 用不了
- 想要个状态面板，但又不想为此装一堆云服务、注册账号、给数据上传权限
CC PEEK 就是为这个场景做的。
四种状态，一眼分辨紧急程度
颜色 + 节奏共同形成视觉梯度。最平静的运行中几乎不存在感，最紧急的等权限会主动呼吸打光，让你余光扫到就知道有没有急事、有多急。
运行中
Claude 正在工作，无需打扰。最平静的视觉，缓慢呼吸。
等待输入
需要你输入文本。有存在感但不紧迫，琥珀色温和提示。
等待权限
需要审批工具调用。最醒目，呼吸打光，立即吸引注意力。
状态未知
无法判断当前状态。中性灰色，不引导也不报警。
为多窗口工作流而生
CC Peek 不替代终端，也不替代 Claude Code。它做的只有一件事：把状态变成一种你不需要切窗口就能感知的环境信号。
第二块屏幕
iPhone 立在桌面支架上当 dashboard 用，全部 Claude Code 进程一目了然。Mac 端零侵入，不修改 Claude 任何行为。
一点直达
iPhone 上点一下卡片，Mac 上对应的终端窗口立刻浮到最前。配合触觉反馈，物理按键的手感。
本地直连
同一 Wi-Fi 局域网内，Apple MultipeerConnectivity + TLS 加密。不上云，不登录，不收集数据。
持续时长追踪
每个进程的当前状态已持续多久，精确到秒，每秒刷新。同时跑多个进程时，一眼看出谁等得最久。
自适应布局
1–6 张卡片自动填满屏幕。横竖屏自由切换。超过 6 个进程分页滑动。永远不会显得空也不会挤。
多终端支持
Terminal.app 和 iTerm2 精确切到具体 tab。Ghostty / Warp / VS Code 内置终端激活窗口。
三步搭起来，跑起来不用管
CC Peek 通过 Claude Code 的 hook 协议读状态，本地网络推送到 iPhone。第一次配对之后就一直在那。
装上 Mac 端
双击 .dmg 拖入 Applications。首次启动会引导你授予自动化、本地网络权限，并自动写入 Claude Code 的 hook 配置——不修改任何 Claude 行为。
装上 iPhone 端
在 App Store 下载 CC Peek。同一 Wi-Fi 下打开 app，两端自动发现彼此，Mac 弹窗确认即配对成功。
把手机立在桌面
放在显示器旁的支架上。屏幕常亮默认开启，Claude 一跑实时反映，不需要再做任何配置。
和其他方案怎么选
如果你已经在用其他类似工具，这里帮你看清差异。
| CC Peek | 官方 Claude Remote Control | 其他桌面端监控工具 | |
|---|---|---|---|
| 第三方 API 支持 | ✓ | ✗ 必须官方账号 | ✓ |
| 独立屏幕，不占主屏空间 | ✓ | — | ✗ |
| 同时监控多个进程 | ✓ | ✗ 单会话 | ✓ |
| 一键切回终端 tab | ✓ | ✗ | 部分支持 |
| 不需要互联网 | ✓ 局域网直连 | ✗ 走云端 | ✓ |
| 数据不离开本机 | ✓ | ✗ | ✓ |
| 价格 | 完全免费 | 订阅 | 各异 |
官方 Remote Control 的定位是「远程操控」——离开电脑后用手机继续操作。如果你的场景是这个，且能接受官方账号 + 云端，那它更合适。CC Peek 不做远程，专心做「坐在电脑前的副屏」——你必须人在 Mac 旁边。
不用 / 用 CC Peek 的差别
同时跑 4 个 Claude Code 进程时，绝大部分时间都浪费在轮询每个窗口看它们到底在干嘛。
没有 CC Peek
- ×Cmd-Tab 来回切换 4 个终端窗口看哪个在跑
- ×等权限弹窗有时漏看，过了 10 分钟才发现
- ×不记得哪个工作目录跑的是哪个任务
- ×状态只能从滚动的日志里推断
有 CC Peek
- ✓余光扫一眼 iPhone 就知道全局状态
- ✓等权限会呼吸打光，绝不会漏
- ✓每张卡片标有目录名，一一对应
- ✓点一下卡片直接跳到对应窗口
坦诚讲一下，谁适合 / 谁不适合
CC Peek 不是万能工具，下面这些场景请直接跳过。
适合你如果
- 经常同时跑多个 Claude Code 进程
- 单屏 / 屏幕空间紧张，不想让状态面板挤占主屏
- 用第三方 API，无法用官方 Remote Control
- 在意隐私，不愿意让 AI 工具碰云端
- 桌上有 iPhone（或愿意拿一台旧机当第二屏）
不适合你如果
- 平时只开 1 个 Claude，菜单栏徽章已经够用
- 没有 iPhone（暂无 Android 版）
- 想要远程操控（CC Peek 不做远程——你必须坐在 Mac 前）
- 期待复杂的进程历史、Token 用量统计、图表（当前版本不支持）
常见问题
需要 claude.ai 官方账号吗？
不需要。CC Peek 通过 Claude Code 自带的 hook 机制本地采集状态，不关心你怎么运行 Claude——官方账号、第三方 API、CC Switch 都可以。
会上传 Claude 的对话内容吗？
不会。CC Peek 只读 hook 提供的元数据（进程状态、工具调用名、时间戳），不读取也不传输任何对话、代码、文件、token 用量。
Mac 和 iPhone 必须在同一 Wi-Fi 吗？
是的。MultipeerConnectivity 在实际部署中需要同一局域网。如果办公室 Wi-Fi 开了客户端隔离（AP isolation），可能也连不上——可以试试连手机热点。
支持哪些终端？
完整支持（精确切 tab）：Terminal.app、iTerm2。部分支持（仅激活 app）：Ghostty、Warp、VS Code 内置终端。暂不支持：tmux、SSH 远程会话。
支持一台 Mac 连多台 iPhone 吗？
当前版本一对一。一台 Mac 同时只连一台 iPhone。后续版本会做多对多。
iPhone 一直开着 app 耗电吗？
只在前台时实时同步。后台 iOS 会断开 MPC 连接（系统限制）。建议把 iPhone 充电线插上、屏幕常亮——CC Peek 设置里有「屏幕常亮」开关。
没有 iPhone 能用吗？
Mac 端单独使用也可以——菜单栏图标会显示总状态、点开是 dashboard popover，能看到所有进程。但失去「副屏不分心」的核心价值。
和官方 Claude Remote Control 冲突吗？
不冲突，可以同时用。两者定位不同——官方 Remote Control 是「远程操控」，CC Peek 是「桌面副屏」。