codex-token-usage-skill
分析本地 Codex 桌面端和 CLI 的 Token 使用情况
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：codex-token-usage-skill。 它的用途是：分析本地 Codex 桌面端和 CLI 的 Token 使用情况 完整的 Skill 内容见：https://321skill.com/skills/codex-token-usage-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘总结一下我过去30天的Codex Token使用情况，包括净用量和峰值日。’ 它会自动分析本地日志，并生成一份包含总用量、净用量、缓存命中率及单日最高用量等信息的文本报告。或者直接运行脚本：`python -B skills/codex-token-usage/scripts/codex_token_usage.py --days 30`，获取相同的数据。
介绍
Codex Token Usage Skill 是一款专注于分析本地 Codex 工具使用情况的技能。它通过读取本地的会话日志文件，帮助用户清晰掌握 Codex 的 Token 消耗细节。
该技能解决了用户难以量化本地 AI 助手使用成本的问题。它会自动解析 Codex Desktop 和 CLI 生成的 JSONL 格式日志，计算出总用量、净用量、缓存命中率、日均用量、峰值日和最繁忙周等关键指标，让用户对自己的使用模式一目了然。
使用方式非常灵活。用户既可以通过 Skills CLI 安装后，直接用自然语言向 Codex 询问使用报告，也可以直接运行技能包内提供的 Python 脚本，通过命令行参数指定日期范围、输出格式等，获取结构化的数据。
它非常适合频繁使用本地 Codex 进行开发的程序员、技术写作者或任何希望优化 AI 助手使用成本的个人用户。通过定期查看报告，用户可以识别使用习惯，调整提示词策略以提高缓存命中率，从而更经济高效地利用 Codex。
需要注意的是，该技能仅读取本地日志文件，所有计算均在本地完成，不会上传任何数据，确保了隐私安全。用户需确保 Codex 已生成会话日志，并正确指向日志文件路径。
核心特点
与仅提供简单统计的同类工具不同，本技能深入解析 Codex 特有的日志结构，精确区分缓存输入、推理输出等细分 Token 类型，并提供“净用量”（排除缓存后的实际消耗）和“缓存命中率”等对成本优化至关重要的专业指标。
注意事项
仅适用于分析本地 Codex（Desktop/CLI）生成的日志，无法用于分析云端 API 或其他 AI 工具的使用情况。
常见问题
这个技能会泄露我的使用数据吗？
不会。所有数据读取和计算均在本地完成，绝不联网上传。
支持分析多久之前的历史数据？
只要本地有保存对应的 JSONL 会话日志文件，就可以分析任意时间范围的数据。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/codex-token-usage-skill/raw/index.md 读取 codex-token-usage-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/codex-token-usage-skill/raw/index.md（查看排版版本）