khanh020905/my-office
开发工具把每个 Claude Code 会话变成 3D 办公室里的角色,并集中处理审批、用量和 Mac 资源。
项目介绍
My Office 把每个正在运行的 Claude Code 会话画成 3D 办公室里的一个角色:读文件时走去图书室,编辑时在工位打字,运行命令时进服务器机房,部署时发射火箭。桌面屏幕显示会话当前在做什么,白板和群聊记录任务与 git 动态,权限请求会变成 Allow、Always allow、Deny 三选一的卡片;递归删除、force push、curl | sh、sudo 以及涉及 prod 的命令会被标红,需要点两次且不提供 Always allow。此外还能看套餐用量、提示缓存剩余时间、单会话成本,以及 Mac 的 RAM、CPU、磁盘、遗留的 dev server 和未提交的 worktree。
3D 画面主要是可视化层,真正实用的是向 Claude Code 注入 hook 的 CLI、审批流和手机端;只想在终端写代码的话,这套东西会增加不少装饰性内容。
快速使用
需要 Node.js 20.9 或更新版本,以及 Claude Code,支持 macOS、Linux、Windows。完整的机器面板和打开编辑器窗口等操作仅 macOS 可用。
git clone https://github.com/khanh020905/my-office.git && cd my-office
npm install
node bin/cli.mjs install --service # 向 ~/.claude/settings.json 添加 hook,并设置登录时启动
node bin/cli.mjs doctor # 检查 Node、服务器、每个 hook 和后台服务
然后打开 http://localhost:4310。install 会先备份 settings.json,只添加自己的 hook,重复执行不会重复添加;node bin/cli.mjs uninstall 会移除所有 hook、它添加的遥测配置和后台服务,保留文件其余内容。只想先看看界面,可以 npm run dev 后打开 http://localhost:4310/?demo,或直接访问托管在 GitHub Pages 的静态演示。
使用约束
- 套餐用量来自 Anthropic 一个未公开的地址,通过 Keychain 中的 Claude Code 登录信息读取,不存储也不记录;README 明确说该地址可能变化。
- 办公室页面上的审批只在页面打开且可见时生效,最长 45 秒,否则回到 Claude Code 自身的询问方式。
- 手机访问需要 6 到 10 位 PIN。服务器默认只监听
127.0.0.1,开启「Open on phones」或用--lan安装后才监听局域网地址;出门在外用 Cloudflare 快速隧道,只开放 https 和受限的 API 能力。HTTP 的局域网模式只应在可信网络使用。 - 「What eats your plan」用量拆分依赖 Claude Code 的 OpenTelemetry 计数器;
install会添加相应设置,如果你已经把遥测发往别处,它会改为提示如何把办公室加为第二个 exporter。 - 套餐用量、
ghCI 检查、越南语翻译和天气这几个网络调用可以分别用OFFICE_USAGE、OFFICE_CI、OFFICE_TRANSLATE和清空城市来关闭。 - 代码采用 MIT 许可,但其中出现的品牌名称和标志仍归各自所有者,项目与 Anthropic 及这些品牌没有关联。
HotRepo 点评
在 2026-11-01 的 JavaScript 新项目榜记录中,My Office 为 117 stars、63 forks,2 小时增长窗口内新增 10 star、6 fork;当天 10:45 到 12:45 UTC 的采样也从 107 star 升到 117。Fork 与 Star 的比例异常高,这与一个让人想克隆下来改成自己办公室的可视化项目相符。目前没有 GitHub 日榜名次,也没有讨论记录,所以现有信号只能说明早期关注度,不能说明质量。README 比多数新仓库详细得多,但大量篇幅花在越南办公室生活场景上;对 Claude Code 用户真正有价值的是审批流程、套餐与 Mac 面板和手机端,评估时应围绕这些功能进行。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。