用途：CodexIsland 是 macOS 原生悬浮层，把 MacBook 刘海变成类似灵动岛的实时活动显示，用于监控 Claude Code 与 Codex 的用量限额。可显示两家提供商的 5 小时与 7 天（每周）窗口，并从本地会话日志估算美元花费与 token 吞吐，提供可滑动的 Cost 屏幕。无刘海 Mac 回退为菜单栏胶囊。
主要能力：双提供商监控（Claude 5h+7d、Codex 5h+7d）；悬停查看 5 小时百分比与重置摘要；点击展开完整 Usage/Cost 面板（提供商分列与图表控制）；左右滑动切换 Usage 与 Cost 屏幕；五种图表样式（Ring、Bar、Stepped、Numeric、Sparkline）；Cost 屏幕支持 USD、VALUE、TOKENS、TREND 视图；Token 计数可选 All Tokens（默认，含缓存读写）或 Billable Only（仅输入+输出）；设置项含刷新间隔、低电量模式、提供商显示、开机启动，均持久化到 UserDefaults。
使用方式：安装可用 brew install --cask ericjypark/tap/codexisland，或下载 dmg 并移除隔离属性 xattr -dr com.apple.quarantine /Applications/CodexIsland.app。首次运行读取现有凭据：Claude 依次尝试 CLAUDE_CODE_OAUTH_TOKEN、Keychain 的 Claude Code-credentials、Anthropic OAuth 刷新令牌，需先运行 claude；Codex 读取 ~/.codex/auth.json，需先执行 codex auth login。交互：悬停刘海窥视，点击展开，横向滑动切换屏幕，Cmd 点击循环图表样式，点击“synced Xs ago”强制刷新。
适用场景：需要在不离开工作流的情况下查看 Claude Code 与 Codex 用量与估算花费的 macOS 用户。
限制：仅 macOS 13+；应用未签名，首次打开可能需绕过 Gatekeeper；刷新间隔最短 5 分钟，不支持更短轮询（受 Anthropic 用量接口速率限制）；多显示器仅部分支持。本地优先：无遥测、无代理服务器、不存储凭据，Cost 屏幕日志聚合完全在设备上进行。