桌面版

桌面版和 clauve-cli 连的是同一个后台进程，在主窗口里就能登录、申请、归还和更换坐席。下面这些是桌面版独有的。

状态气泡

在设置里打开「显示状态气泡」，桌面上会出现一个置顶的小气泡，显示三样东西：

• 出口 IP 国家：国旗和国家码。切换代理后 30 秒内更新。
• Claude 可用灯：能否连通 Claude 官方服务。不可用时悬停能看到原因。
• 会话灯：Claude Code 会话是在工作、已完成，还是在等你做决定。状态变化后 2 秒内变色。

把鼠标悬停在气泡上会展开浮层，从上到下依次是：

• 坐席用量：5 小时、7 天两行，带百分比、进度条和重置倒计时。
• 本机花费：今天和近 30 天的花费与 token，以及近 30 天每日花费柱状图，悬停某一天显示当天按模型的明细。
• 网络与会话：IP 和地区、不可用原因、每个会话的目录和状态。

气泡可以拖动并记住位置，双击打开主窗口。关闭「显示状态气泡」后，相关检测会全部暂停：不再探测出口 IP 和官方服务连通性，并从 Claude Code 配置里移除会话事件 hook。

本机花费统计

花费来自本机 Claude Code 的会话记录（~/.claude/projects 下的 jsonl），按模型单价折算成美元：

• 只统计这台电脑的用量，不上报服务端。
• 单价表内置一份快照，每天联网更新一次，拉不到时用内置的。
• 坐席的 5 小时 / 7 天百分比是整个账号的，几台设备共享一个坐席时，本机花费帮你看清自己用了多少。

macOS 菜单栏

在设置里打开「在菜单栏显示」（仅 macOS），右上角会出现 Clauve 图标，菜单里可以：

• 查看坐席状态和用量，以及本机今日花费
• 申请 / 归还坐席、手动换席
• 打开设置、退出

Windows 和 Linux 使用系统托盘。

偏好设置

「显示状态气泡」和「在菜单栏显示」默认关闭，重启后保持上次的选择，保存在 ~/.clauve/desktop.json。

升级

升级时用 clauve-cli restart --install <新版 Clauve.app>（macOS），会保留坐席并重启，正在用坐席的 Claude Code 不会断线。