Codex 接入 Agent Island 指南

用量界面常常比它当初对着做的那套服务商行为活得更久。2026 年 7 月起，Codex 不再给出旧的 5 小时额度窗口，只给出一个每周窗口。还在画那个已退役窗口的追踪器，提供的不是更多细节，而是把过时的产品历史当成当前数据端上来

一步一步接进来

第 1 步 · 安装 Agent Island

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

第 2 步 · 确认 Codex 已登录

Agent Island 只需要一个已登录的 codex CLI —— 它读的是 CLI 本来就会写的认证文件

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

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

第 4 步 · 在岛上读它

Codex 显示一个每周额度窗口 —— 服务商今天只报告这一个 —— 带重置倒计时。多个登录可以命名存放、从菜单切换；额度耗尽自动换号是可选项

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

从任意终端跑一次 Codex 任务。会话带着工作中状态出现，下一次同步时周百分比更新

如果没成功

当前覆盖：Agent Island 2.1.2 支持 Claude Code、Codex、Antigravity、Grok 和 Cursor —— 五家都有实时会话状态与轮到你了提醒，macOS 与 Windows 同步

1. 按服务商实际给出的窗口建模

当前的 Codex 用量界面应该只有一个主要的周窗口。Agent Island 用服务商返回的周期给磁贴打标签，而不是把「5h」写死。当服务商只返回一个窗口时，磁贴会展开，而不是在旁边留一个永远无数据的占位

百分比可以显示已用或剩余，重置时间给这个数字提供上下文。它回答的是「这周还剩多少产能」，回答不了「这个仓库消耗了多少 token」

2. Codex 的新鲜度要独立

就算是一块合并的多服务商面板，状态也必须按服务商各自持有。Claude 刷新成功，不能让过期的 Codex 数据看起来是新的。每家服务商都需要自己的数值、错误和刷新时间戳，这样局部失败才留得住痕迹

启动之后同样适用。保留旧值可以避免界面空白一闪，但 UI 不该悄悄把它们的新鲜度延长。一个可见的同步时长加上按服务商区分的错误，比整块面板一个绿色状态有用得多

3. 从 Codex 事件推导本地 token 活动

Codex 的会话记录里可能带有单个事件的 token 用量。本地台账应该解析这些事件，把输入、输出与缓存 token 分类保留，并对重放的记录做去重。归属到日和周时要用事件时间，而不是之后那次扫描的时间

这和周额度是两块不同的测量面。服务商的额度变化未必能一一对应到 token 上，本地日志也可能不完整，或者含有内置价目快照并不认识的模型标识

4. 估算价值，但别声称是账单

对已知的模型标识，Agent Island 可以把一份带日期的价目表套用到本地的各类 token 上，结果是 API 价值估算。未知模型保持不定价，而不是被悄悄映射到一个方便的费率上

不要把这个估算和订阅扣费一比，就把差额说成记账错误。套餐内含用量、服务商规则、价目变动、缺失的事件和不同的聚合边界，都让精确对账变成一次独立的实验

5. 守住本地边界

Agent Island 在 Mac 上读取会话记录并在本地计算台账。会话内容不会上传到 Agent Island 的服务，也不需要 Agent Island 账号。周报和月报卡在你明确复制或分享之前，一直留在本地

该向任何 Codex 用量追踪器提的问题

• 它显示的是当前这一个周窗口，还是一个虚构的 5 小时窗口
• Codex 的新鲜度和报错是否独立于 Claude
• token 台账有没有对重放事件做去重
• 未知模型是否明确显示为未定价
• API 价值估算有没有和实际花费分开标注
• 它有没有讲清楚哪些数据留在本地

当前已验证范围

这里描述的 Codex 周额度、本地成本台账与报告行为，在 Agent Island v1.7.1 的 macOS 上已验证。Windows 安装包已公开发布，但本文不声称这些用量界面在 Windows 上完全对齐，也不做任何 Codex 额度闹钟的声称