跳到主要内容
适用于 Codex 的菜单栏小工具

随时查看你的 Codex 用了多少 Token,限额还剩多少。

一个常驻菜单栏的 dashboard,查看本机 Codex token 用量、API 等效价值、模型分布、工具调用、账号概览和 rate limit 状态。只读,零侵入。

在 GitHub 上查看
CodexScope
Total tokens
0.00M14%
Est. API value
$46.10
Input 8.13M Output 4.27M56% cached
周一
周二
周三
周四
周五
周六
周日
Tokens by model
GPT-5 Codex
5.82M46.9%
GPT-5 high
3.07M24.8%
GPT-5
1.94M15.7%
Gemini 2.5 Pro
910K7.3%
Llama 3.3 70B
660K5.3%

按日、周、月查看 Codex 用量明细。

在一个面板里看模型分布、API 等效价值、Codex 工具调用、账号信号和保留历史活跃度。

模型价值占比

按所选周期估算每个模型对应的 OpenAI API 价值。
$46.10
GPT-5 high$19.10
GPT-5 Codex$18.40
GPT-5$6.20
Gemini 2.5 Pro$2.40
响应数
2,847
143 个线程
价值趋势
$46.10
本周

你实际用到的 Codex 活动

展示从本机 Codex 数据读取到的显式工具调用和账号信号。
工具调用10 · 5 个工具
shell
3
apply_patch
2
web_search
2
tool_search
2
browser
1
Codex 后台事件会和显式工具调用分开展示。
账号读取12 · 5 个信号
account/usage/read
4
account/rateLimits/read
3
reset-credit
2
reasoning-effort
2
thread-profile
1
来自本机 codex app-server --stdio 账号与 rate-limit 数据。

Codex 活跃热图

保留历史窗口内的每日 Codex 活跃度。
12月1月2月3月4月5月6月

Codex Token 类型一眼看清

56% 命中缓存
Codex 的 token_count 事件会暴露 input、cached input、output 和 reasoning output。CodexScope 会保留推理输出作为上下文信息,但总 Token 与 API 等效价值只按输入、缓存输入和输出加总。

只读、不上传日志,也不需要 API key。

CodexScope 读取本机 Codex rollout JSONL 和 Codex 账号元数据,不修改 Codex 配置或会话历史;你的日志仍然留在本机。

读取

扫描 ~/.codex/sessions/**/rollout-*.jsonl和归档会话,解析 token_count、模型上下文和工具调用。

归因

跟踪 session_meta / turn_context ,让追加 token 事件归属到正确的 session、model 和 reasoning effort。

计价

优先使用 models.dev 公开 OpenAI API 价格,其次使用 LiteLLM,最后使用内置快照作为离线兜底。

展示

菜单栏实时显示今日 Codex 用量,点开即可查看账号概览、rate-limit 窗口和完整 dashboard。

CodexScope 如何估算 API 等效价值。

CodexScope 读取 Codex token_count 事件,拆分输入、缓存输入、输出和推理输出,并用最接近的 OpenAI/Codex 价格条目估算可计价的输入、缓存与输出价值。

// gpt-5-codex · 一次 Codex 会话
tokens: {
  input_tokens               : 88,000
  cached_input_tokens       : 1,120,000
  reasoning_output_tokens  : 2,400,000
  output_tokens              : 320,000
}
类型Token × $/M价值
输入88,000 × $3.00$0.2640
缓存输入1,120,000 × $3.75$4.2000
推理输出2,400,000 × $0.30$0.7200
输出320,000 × $15.00$4.8000
总计 · 单个线程$9.98

注意 推理输出 只作为上下文信息展示,不在 API 等效价值里重复加总。 0.32M 的输出 Token 仍可能主导 API 等效价值。估算优先使用公开 OpenAI/Codex API 价格;ChatGPT/Codex 订阅和 quota 规则可能不同。

在 macOS 或 Windows 上构建。

目前还没有正式公开 release。先从源码本地构建,然后打开 Tauri 产出的 macOS app bundle 或 Windows NSIS 安装包。

macOS
$ pnpm install; pnpm tauri build
Windows
构建 NSIS 安装包

未签名 Windows 安装包会输出到 src-tauri/target/release/bundle/nsis/。

偏向 macOS?本地构建后打开 CodexScope.app。如果 macOS 拦截未签名本地构建,可以右键打开,或者在命令行中运行一次 xattr -cr src-tauri/target/release/bundle/macos/CodexScope.app

常见问题。

本地运行 CodexScope 前经常会问到的问题。

不会。它读取本机 Codex rollout 日志: ~/.codex/sessions/ 以及 Codex 账号元数据,用公开 models.dev LiteLLM 价格和本地快照估算 API 等效价值,并在本地 dashboard 中展示。不修改配置或会话历史,也不需要 API key。
CodexScope 还没通过 Apple Developer 或 Windows 发布者计划的代码签名。请先用 pnpm install; pnpm tauri build 从源码本地构建。在 macOS 上,首次启动可能需要右键打开;如果本地 CodexScope.app无法打开,运行一次 xattr -cr src-tauri/target/release/bundle/macos/CodexScope.app 再打开。在 Windows 上生成的.exe 安装包也未签名,首次启动时可能需要「更多信息 → 仍要运行」。
输入、缓存输入和输出会匹配最接近的 OpenAI/Codex 价格条目。CodexScope 优先使用 models.dev 公开 OpenAI API 价格,其次使用 LiteLLM,以及内置快照兜底。推理输出只作为信息展示,不重复加总;没有公开价格的模型会标记为 “unpriced”。
codex app-server 提供账号用量和 rate-limit 窗口。CodexScope 会在可用时调用 codex app-server --stdio ,再把账号信号和本机 rollout 日志、 models.dev / LiteLLM 兜底价格整合成菜单栏 GUI:今日用量、API 等效价值、账号画像、rate limit、图表和热力图都能一键查看。
后台进程监听项目目录的文件变化,仅重新解析 mtime 有变动的文件。空闲时 CPU 基本为零,内存稳定在40MB。刷新面板也只是从上次读取位置往后扫一遍新增的 JSONL 字节。性能足够优秀。
目前 CodexScope 面向 Codex rollout JSONL 和 Codex app-server 账号数据。其他 agent 或终端需要单独适配;可以去 repo 上提个 issue,附上脱敏后的日志样例,我会考虑增加一种支持。
是的。MIT 协议,源码公开,项目本身没有内置付费版本。仓库地址: github.com/poer2023/CodexScope

CodexScope 的实现要点。

来自产品仓库、和日常使用直接相关的几个细节。

增量读取本机 ~/.codex/sessions rollout JSONL,CodexScope 面板刷新时不需要每次全量重扫。
CodexScopeCodexScope 仓库
通过 session_meta 和 turn_context, CodexScope 把 token 事件归因到正确的 session、model 和 reasoning effort。
CodexScopeCodexScope 仓库
CodexScope 会在可用时读取 codex app-server --stdio 的账号用量和 rate-limit 窗口。
CodexScopeCodexScope 仓库
API 等效价值优先使用 OpenAI/Codex 价格,再用公开价格表和内置快照兜底。
CodexScopeCodexScope 仓库
CodexScope 日、周、月视图会和上一对应周期比较,并保留历史热力图。
CodexScopeCodexScope 仓库
CodexScope 一键截图会把当前 dashboard 保存到桌面,方便分享和排查。
CodexScopeCodexScope 仓库
增量读取本机 ~/.codex/sessions rollout JSONL,CodexScope 面板刷新时不需要每次全量重扫。
CodexScopeCodexScope 仓库
通过 session_meta 和 turn_context, CodexScope 把 token 事件归因到正确的 session、model 和 reasoning effort。
CodexScopeCodexScope 仓库
CodexScope 会在可用时读取 codex app-server --stdio 的账号用量和 rate-limit 窗口。
CodexScopeCodexScope 仓库
API 等效价值优先使用 OpenAI/Codex 价格,再用公开价格表和内置快照兜底。
CodexScopeCodexScope 仓库
CodexScope 日、周、月视图会和上一对应周期比较,并保留历史热力图。
CodexScopeCodexScope 仓库
CodexScope 一键截图会把当前 dashboard 保存到桌面,方便分享和排查。
CodexScopeCodexScope 仓库

开始关注你的 Codex 用量。

免费,MIT 协议,为 Codex 菜单栏场景构建。

在 GitHub 上查看