ClaudeBar
macOS menu bar app for Claude Code, Cursor, and Codex: provider switching, session monitor, token usage.
DOCS
界面
概览是一块仪表盘:CPU 芯片、GPU 柱、内存液面、硬盘、Wi-Fi / 蓝牙、左右风扇;下面是当前供应商、会话和 Token。菜单栏则是同一套事实的压缩版 — 三格切换 CC / Codex / VPN,再往下是活着的会话和当月热力。
主窗口 · 冰面 / 石墨宫格。颜色只出现在图表里。

菜单栏 · 点图标即出。切模型、巡会话、看用量,不用开窗口。

它解决什么
Claude Code、Codex、Cursor 同时在跑的时候,工作流会被拆成一堆独立工具:VPN 客户端、抓包代理、模型切换器、会话列表。每个都占一个托盘图标,切一次就要离开终端。
ClaudeBar 把这些收进一个菜单栏应用。顶栏常驻,主窗口按需打开。点一下就能做刚才那件事,然后回去写代码。
六件事
切换。 Claude Code 与 Codex 各有一份供应商。激活分别写回 ~/.claude/settings.json 和 ~/.codex/config.toml,互不覆盖。菜单栏三格:CC、Codex、VPN 节点。
转发。 本机代理听 127.0.0.1(默认 15721),Chat / Responses 互转。Claude Code 与 Codex 跟当前模型走;第三方客户端可另选上游,不改那两份配置文件。开了流量记录,对话、工具调用、图片和原始报文都在「流量」页。
隧道。 捆绑 mihomo。订阅、选节点、测延迟、系统代理 / TUN。菜单栏显示 ↓↑ 实时速率;出站路径是 日本 › 电信 这种面包屑,不是装饰线。
现场。 会话页把 Claude Code、Cursor、Codex 和其他 CLI 收成一张牌:上下文条、当前工具、心跳、CPU / 内存。双击卡片就能在终端或 Cursor 里接上。
用量。 只统计模型 Token。日 / 月 / 年热力图、CC / Codex / 第三方来源柱、输入·命中·写入·输出构成。VPN 剩余流量留在 VPN 页,不混进来。
本机。 概览 2×3:负载、温度写在 CPU / GPU 说明里、硬盘占用、Wi-Fi / 蓝牙 / 有线、两只可点的风扇(自动 / 最大)。浅色是冰 #EEF3F8,深色是石墨 #16181C,不跟系统外观走。
另外:⌘⇧A 区域截图(复制 / 保存 / 钉住),⌘K 跳页面 / 会话 / 模型,桌面 Widget 看当日 Token。
怎么用
| 你想… | 走这里 |
|---|---|
| 换模型 | 菜单栏 CC / Codex 格,或主窗口 模型 页。新开一个终端会话才生效。 |
| 换节点 | 菜单栏 VPN 格,或 VPN 页马赛克。 |
| 看对话有没有打到代理 | 设置 → 本地代理 → 模型卡打开流量记录 → 流量 |
| 让第三方走同一条上游 | Base URL http://127.0.0.1:<端口>/v1,设置里给第三方另选供应商 |
| 接上刚才那次会话 | 会话 页或 popup 里点卡片 |
| 截一块屏幕 | ⌘⇧A(设置可关) |
安装
macOS 15+,Apple Silicon。从 Releases 下载 DMG,拖进 Applications。
Gatekeeper 拦住时:
xattr -cr /Applications/ClaudeBar.app && open /Applications/ClaudeBar.app
它碰哪些文件
只读优先。除了你主动切换模型,不会改各工具自己的数据。
| 谁 | 路径 | 权限 |
|---|---|---|
| Claude Code | ~/.claude/ |
读;切换时写 settings.json |
| Codex | ~/.codex/ |
读;切换时写 config.toml |
| Cursor | ~/Library/.../state.vscdb |
只读 |
| 代理抓包 | ~/Library/Application Support/ClaudeBar/logs/ |
开了流量记录才写 |
| VPN | ~/Library/Application Support/ClaudeBar/vpn/ |
订阅与内核配置,只留本机 |
从源码构建
git clone https://github.com/wangxiajun68/ClaudeBar.git
cd ClaudeBar
make build