Claude Counter 应用图标

设置指南

快速上手

欢迎使用 Claude Counter！本指南将帮助你设置应用，并在几分钟内开始追踪你的 Claude Code 会话。

步骤 1：下载并安装

  1. 在你的 iPhone 或 iPad 上打开 App Store
  2. 搜索 “Claude Counter”
  3. 点按获取以下载并安装
  4. 安装完成后打开应用
前往 App Store 下载

步骤 2：选择你的语言

首次打开 Claude Counter 时，系统会要求你选择偏好的语言。

可用语言：

  • 英语（英国）
  • 英语（美国）
  • 南非语
  • 希腊语（Ελληνικά）
  • 法语（Français）
  • 西班牙语（Español）
  • 德语（Deutsch）
  • 荷兰语（Nederlands）
  • 中文，简体（中文 简体）
  • 中文，繁体（中文 繁體）
  • 日语（日本語）

点按你偏好的语言以继续。之后你也可以在“选项”中更改。

步骤 3：连接你的真实 Claude 用量（Mac）

这个一次性步骤将开启 Claude Counter 最有价值的功能。Claude Code 会在你的 Mac 上保留一份私密的真实用量日志 — 只需连接一次，应用即可显示你实时的 5 小时会话窗口、真实的 Token 数量、预估费用，还能将你的计时器同步到 Claude 实际重置的那一刻。

在你的 Mac 上（一次性操作）

开始之前：你需要一台运行 Claude Code 的 Apple 芯片 Mac — 使用记录就保存在那里 — 并且已开启 iCloud Drive（系统设置 > 你的姓名 > iCloud）。

  1. 打开 Mac App Store，搜索 Claude Counter，然后点按搜索结果顶部的 iPhone 与 iPad 版 App 标签页 — 它是一款可在 Mac 上运行的 iPad 应用，因此不会列在 Mac 应用中。安装它
  2. 打开应用，进入 标签 2（用量）
  3. 点按授权访问
  4. 在打开的文件夹窗口中，按下 Command+Shift+G，输入 ~/.claude，按下回车，然后点按打开
  5. 成功的标志是：“用量”标签会显示你的 Token 数量，如果你在过去 5 小时内向 Claude Code 发送过消息，还会显示实时的 5 小时倒计时。如果显示“该文件夹中没有 Claude Code 记录”，请点按标签底部的更改文件夹，重新选择 ~/.claude

在你的 iPhone 或 iPad 上

  • 登录与你的 Mac 相同的 iCloud 账户，并开启 iCloud Drive（设置 > 你的姓名 > iCloud）
  • 打开标签 2（用量），首次使用请最多等待五分钟 — 你的 Mac 会通过你自己的 iCloud 私密地分享用量数据，iPhone 会自动获取。你也可以在“用量”标签下拉以更早查看
  • 成功的标志是：“用量”标签底部会显示来自，后面跟着你 Mac 的名称及其最近一次更新的时间
  • 提示：工作时请让 Claude Counter 在 Mac 上保持运行 — 因为正是它在读取日志，所以你的 iPhone 只能显示 Mac 应用最近一次更新时的数据。如果你退出了 Mac 应用，iPhone 会保留最后一次更新的数据，直到你再次打开它

无需操作的后台运行（可选）

Mac 应用无需保持窗口打开 — 即使隐藏，它也会持续读取你的日志并更新你的其他设备。有两种简单的方法可以让它完全无需操作：

  • 登录项：系统设置 > 通用 > 登录项与扩展 > 添加 Claude Counter — 它会在登录时自动打开，你可以隐藏窗口后就不用再管它了
  • 让 Claude 帮你设置：如果你使用 Claude Code，把这段提示词粘贴到你 Mac 上的一个会话中，Claude 会协助你完成设置：
请帮我设置 Claude Counter 应用，使其能在这台 Mac 上无需操作地在后台运行，这样即使窗口隐藏，也能让我的用量数据保持最新。请在我的 ~/.claude/settings.json 中添加一个 SessionStart 钩子，运行以下命令：open -gja "Claude Counter"，这样每次我启动 Claude Code 会话时，应用都会以隐藏方式启动。请保留我现有的设置不变，在做出更改前先说明改动内容，并在之后验证 JSON 格式是否正确。

这将解锁的功能

  • 实时会话窗口倒计时，显示在标签 1 和标签 2 上 — 精确掌握 Claude 何时重置
  • 记录并同步 — 当 Claude 窗口已在运行时，只需点按一下即可记录该会话，并让你的计时器与实际重置时间对齐
  • 最近的窗口与导入 — 忘记记录的会话，只需点按一下即可添加到你的历史记录
  • 预估费用与订阅价值 — 显示你的用量按 API 按 Token 计费的费用，并与你的方案费用对比
  • 模型追踪 — 为会话标记你实际使用的 Claude 模型

隐私与不使用 Mac 的情况

你的日志只会通过你自己私密的 iCloud 在你的设备之间传输 — 不会发送给我们或任何其他人。没有 Mac？没问题：手动会话追踪无需此步骤即可完整使用，你也可以之后随时连接 Mac。

步骤 4：了解你的会话限额

免费用户

  • 免费包含 5 次已追踪会话
  • 1 次宽限会话，作为升级前的缓冲
  • Claude Counter 的会话计数会在你每月 Claude 订阅续订当天重置（可由用户自行设置）

Pro 用户

  • 每月更多会话
  • 自定义计时器
  • 锁屏小组件
  • 所有方案均享两周免费试用

步骤 5：配置你的计时器

前往选项（标签 5）> 计时器设置进行自定义：

会话时长计时器

  • 默认：5 小时（300 分钟）
  • 用途：追踪你的 Claude Code 会话持续时间
  • 建议：将其设置为与 Claude Code 会话超时时间一致

保存进度计时器

  • 默认：4:45 小时（285 分钟）
  • 用途：提醒你保存与 Claude 的工作进度
  • 建议：根据你的进度更新习惯，将其设置为短于会话时长的时间

步骤 6：设置你的重置日

你的会话计数每月重置一次。重置发生在你在计时器设置中所设置的、与 Claude 订阅续订相对应的当月某一天。

更改你的重置日：

  1. 前往选项（标签 5）
  2. 点按计时器设置
  3. 找到会话重置日
  4. 选择 1 至 31 之间的任意一天

步骤 7：选择你的主题

Claude Counter 内置 15 种以上精美配色主题。

  1. 前往选项（标签 5）
  2. 点按主题与外观
  3. 选择你偏好的主题：
    • 系统（跟随 iOS）
    • 蓝色、紫色、绿色、粉色、金色
    • 钴蓝、靛蓝、道奇蓝
    • 橙色、红色、黄色
    • 灰色、黑色、棕色
  4. 选择浅色、深色或系统模式
  5. 组合方式非常多，花点时间找到让你满意的主题

步骤 8：设置锁屏小组件（Pro）

锁屏小组件让你无需打开应用即可查看会话信息。

添加小组件

  1. 长按你的锁定屏幕
  2. 点按自定义
  3. 点按锁定屏幕进行编辑
  4. 点按小组件区域（时间上方或下方）
  5. 搜索 Claude Counter
  6. 从可用的小组件中选择：
    • 会话计时器 - 剩余会话时间
    • 保存进度 - 距离保存提醒的时间
    • 剩余会话 - 可用会话数
    • 剩余天数 - 距离 Claude 订阅续订的可用天数

小组件刷新

计时器运行时，小组件会自动更新。

步骤 9：开始你的第一个会话

一切就绪！以下是开始追踪的方法：

开始一个会话

  1. 打开 Claude Counter，进入 标签 1（会话）
  2. （可选）添加会话描述。加入项目或客户标签，以便在导出数据时进行关键词筛选
  3. （可选）选择你将使用的 Claude 模型 — 会随会话一并保存
  4. 点按大号的开始会话按钮
  5. 确认你要开始一个新会话

连接了你的 Mac 之后（步骤 3）：如果你打开应用时 Claude 窗口已在运行，应用会改为提供记录并同步 — 接受、添加描述后，你的计时器就会对齐到 Claude 的实际重置时间。该窗口本身已计入你的一次会话，因此记录它只是为了让计数保持准确。

接下来会发生什么

  • 会话计时器开始倒计时
  • 保存进度计时器开始倒计时
  • 会话计数递增
  • 环形进度条显示已用会话数

会话进行期间

  • 让 Claude Counter 保持打开，或使用小组件来监控时间
  • 达到保存计时器目标时间时，你会收到保存提醒
  • 达到会话计时器目标时间时，你会收到提醒
  • 请注意，Claude 会话到期后，向 Claude AI 发送的任何指令或响应都会自动开始一个新会话

结束你的会话

  • 如果你决定在会话结束前停止使用 Claude，再次点按按钮即可结束会话
  • 确认以停止所有计时器
  • 会话时长会保存到你的历史记录中

步骤 10：查看你的统计数据

积累几次会话后，去看看你的统计数据：

  1. 前往 标签 4（统计）
  2. 查看你的快速统计仪表盘
  3. 向下滚动查看图表：
    • 按 7 天周期显示的用量
    • 按日期显示的会话时长
    • 按星期几显示的用量
    • 按小时显示的会话数
  4. 使用周期筛选查看：
    • 仅当前周期
    • 全部历史数据
    • 特定周期范围

步骤 11：导出你的数据

需要汇报你的用量或为客户开票吗？

快速导出

  1. 前往 标签 3（历史记录）或标签 4（统计）
  2. 点按导出按钮
  3. 选择：
    • 复制到剪贴板 - 格式化文本
    • 以 CSV 分享 - 适用于电子表格

包含内容

  • 用户设置的开发者 ID
  • 会话日期与时间
  • 每个会话的时长
  • 会话描述
  • 所使用的 Claude 模型（如已设置）
  • 汇总统计数据
  • 周期信息

小贴士：防止误开会话

Claude Counter 的确认弹窗有助于防止浪费会话：

  1. 开始会话确认 - “确定要开始一个新会话吗？”
  2. 结束会话确认 - “这将停止所有计时器。是否继续？”
  3. 会话冷却 - 两次会话之间的短暂等待期

这些保护机制确保你只会在真正想开始会话时才开始。

升级到 Pro

当你准备好使用更多功能时：

  1. 前往选项（标签 5）
  2. 点按订阅
  3. 选择月付（$0.99）或年付（$9.99）
  4. 完成购买

解锁的 Pro 功能

  • 每月更多会话
  • 自定义计时器
  • 锁屏小组件
  • 未来所有 Pro 功能

疑难解答

会话没有被计数

请确认你点按了“开始会话”并进行了确认

小组件没有更新

  • 小组件会根据 iOS 的机制定期刷新
  • 尝试移除小组件后重新添加
  • 确认最近打开过应用

计时器提示音没有播放

  • 检查你的 iPhone 是否处于静音模式
  • 在 iOS 设置中确认通知权限

“用量”标签在等待你的 Mac

  • 在 Mac 上打开 Claude Counter 并授权文件夹访问（步骤 3） — Mac 自己的“用量”标签必须先显示数字，iPhone 才能显示
  • 确认两台设备登录了相同的 iCloud 账户，并且已开启 iCloud Drive
  • 首次同步最多需要五分钟，然后在“用量”标签下拉刷新。你的 iPhone 只有在 Mac 应用运行时才会收到更新

“文件夹访问权限已失效”或“该文件夹中没有 Claude Code 记录”

  • 重新安装或更新 Mac 应用后，访问权限可能会失效 — 请点按“用量”标签底部的更改文件夹，重新选择 ~/.claude
  • “没有 Claude Code 记录”表示选择了错误的文件夹 — 必须是主文件夹中隐藏的 ~/.claude 文件夹。在文件夹窗口中按下 Command+Shift+G 并输入它

显示“无活动窗口”

  • 只有在你向 Claude Code 发送过消息后才会出现窗口 — 你的下一条消息会开启一个全新的 5 小时窗口
  • 打开时，“会话”和“用量”标签每 30 秒会重新检查一次；“用量”标签的刷新按钮可立即检查
  • 在 iPhone 上，倒计时的新鲜程度取决于你的 Mac 最近一次更新 — 打开 Mac 应用即可让它保持最新

需要更多帮助？

访问：用户指南

后续步骤

完成设置之后：

  1. 开始追踪你的 Claude Code 会话
  2. 为你的工作流程创建自定义计时器（Pro）
  3. 每周查看统计数据，了解你的使用规律
  4. 按需导出报告，用于开票或管理汇报

编程愉快！

需要帮助？

如果你有任何问题或遇到困难，我们随时为你提供帮助。

完整用户指南 产品页面 联系支持