Claude Code 接入 Agent Island 指南

一步一步接进来

第 1 步 · 安装 Agent Island

macOS —— Homebrew，或者从 最新发布 下载 DMG：

第 2 步 · 确认 Claude Code 已登录

Claude Code 在你第一次登录时就会写下会话记录和钥匙串凭据。如果你已经在终端里跑 claude 或者在用 Claude Desktop，这一步已经完成了

第 3 步 · 看一眼服务商设置

打开 设置 → 服务商。检测不到本地登录的服务商没有位置也没有那一行；之前藏起来的也在这里重新启用。五个数据源可以都开着，岛在顶部条保留两个重点位置

第 4 步 · 在岛上读它

岛上 Claude 这一侧带两个额度窗口 —— 5 小时窗口和每周窗口，各有已用百分比与重置倒计时。展开面板还有本地 token 台账和 API 价值估算

第 5 步 · 用一次真实运行验证

在任意 Claude Code 会话里发一条真实提示。下一次同步时 Claude 的百分比会动，生成过程中会话显示工作中状态

如果没成功

1. 把额度当成重置窗口来读

在 macOS 上，Agent Island 可以显示当前登录账号对应的 Claude Code 5 小时与每周用量窗口。每块磁贴把已用百分比和它的重置时间放在一起，显示也可以翻成剩余百分比，底层数值不变

这个视图回答的是排产问题：当前这个窗口里还能不能接着干。它解释不了用量出自哪个模型、读了多少缓存 token，也说不出订阅账单上会是什么

2. 从本地事件建 token 台账

token 活动来自本来就存在机器上的编码会话。可靠的台账会读取各服务商特有的事件字段，把输入、输出、缓存创建与缓存读取分开记，并把事件归到它自己的时间戳上，而不是归到文件恰好被扫描的那一刻

它还需要重放保护。会话文件在重启或者监听器刷新之后可能被再扫一遍，同一个用量事件数两次，做得再漂亮的报告也不如没有报告可信。稳定的事件身份和有界的本地扫描是这套测量系统的一部分，不是实现细节

3. 把 API 价值标成估算

Agent Island 可以用内置的、带日期的模型价目快照去乘各类 token。对于已定价的模型，算式是：

API 价值估算 =
  输入 token × 输入单价
  + 输出 token × 输出单价
  + 缓存创建 token × 缓存写入单价
  + 缓存读取 token × 缓存读取单价

结果是一个 API 价值估算。它不代表 Claude Code 按 API 价目对这些 token 计了费，也不保证和服务商后台对得上。订阅条款、套餐内含用量、未知的模型标识、价目变动和服务商侧的记账，都可能造成差异

4. 采集边界要看得见

本地追踪器应该说清楚数据从哪来、到哪去。Agent Island 为它的台账读取本地会话记录，不把会话内容上传到 Agent Island 的服务，也不需要 Agent Island 账号。分享周报或月报卡是另一个明确由你发起的动作

一份可操作的 Claude Code 用量清单

1. 用 5 小时与每周磁贴做重置窗口的排产
2. 用本地台账看 token 与模型活动
3. 把 API 价值计算当成带日期的估算
4. 实际扣费以服务商的计费界面为准
5. 让数据新鲜度和重新认证的报错保持可见

当前已验证范围

这里描述的用量、成本与报告卡行为，在 Agent Island v1.7.1 的 macOS 上已验证。Agent Island 也提供 Windows 版本，但本文不声称这些用量界面在 Windows 上完全对齐。实时会话状态与轮到你了提醒是另一项跨平台能力