Claude Counter 應用程式圖示

設定指南

開始使用

歡迎使用 Claude Counter！本指南將協助你設定應用程式，並在幾分鐘內開始追蹤你的 Claude Code 工作階段。

步驟一：下載並安裝

  1. 在你的 iPhone 或 iPad 上開啟 App Store
  2. 搜尋 「Claude Counter」
  3. 點按 取得 進行下載與安裝
  4. 安裝完成後開啟應用程式
在 App Store 下載

步驟二：選擇你的語言

第一次開啟 Claude Counter 時，系統會要求你選擇偏好的語言。

可用語言：

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

點按你偏好的語言以繼續。之後你可以在「選項」中變更。

步驟三：連接你的實際 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，按下 Return，然後點按 打開
  5. 你可以透過以下方式確認是否成功：「用量」分頁會顯示你的權杖數量，如果你在過去 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 掛勾（hook），執行以下指令：open -gja "Claude Counter"，這樣每次我開始一個 Claude Code 工作階段時，應用程式都會以隱藏方式啟動。請保留我現有的設定不變，在進行變更前先說明改動內容，並在之後驗證 JSON 是否正確。

這能解鎖什麼

  • 即時工作階段視窗倒數，於標籤 1 與標籤 2 顯示 — 準確掌握 Claude 何時重設
  • 記錄並同步 — 當 Claude 視窗已在執行時，輕點一下即可記錄工作階段，並讓你的計時器對齊實際的重設時間
  • 最近的視窗與匯入 — 忘記記錄的工作階段，只需輕點一下即可加入你的歷史記錄
  • 預估費用與訂閱價值 — 你的用量若以 API 按權杖計費計算會是多少費用，並與你方案的費用相比較
  • 模型追蹤 — 為工作階段標記你實際使用的 Claude 模型

隱私與不使用 Mac 的情況

你的記錄除了透過你自己的私人 iCloud 之外，絕不會離開你的裝置 — 不會傳送給我們或其他任何人。沒有 Mac？沒問題：手動工作階段追蹤在不進行此步驟的情況下也能完整運作，你隨時都可以之後再連接 Mac。

步驟四：了解你的工作階段額度

免費使用者

  • 免費包含 5 次 追蹤工作階段
  • 1 次寬限工作階段，作為升級前的緩衝
  • Claude Counter 的工作階段次數，會在你 Claude 訂閱每月續訂當天重設（使用者可自行設定）

Pro 使用者

  • 每月更多工作階段
  • 自訂計時器
  • 鎖定畫面小工具
  • 所有方案皆享 2 週免費試用

步驟五：設定你的計時器

前往 選項（標籤 5） > 計時器設定 進行自訂：

工作階段時長計時器

  • 預設值：5 小時（300 分鐘）
  • 用途：追蹤你 Claude Code 工作階段的執行時間
  • 建議：將此設定為與 Claude Code 的工作階段逾時時間一致

儲存進度計時器

  • 預設值：4 小時 45 分鐘（285 分鐘）
  • 用途：提醒你儲存與 Claude 的進度
  • 建議：根據你更新進度的工作流程，將此設定為短於工作階段時長的時間

步驟六：設定你的重設日

你的工作階段次數每月都會重設。重設會發生在你於計時器設定中所設定、與 Claude 訂閱續訂日相同的那一天。

若要變更你的重設日：

  1. 前往 選項（標籤 5）
  2. 點按 計時器設定
  3. 找到 工作階段重設日
  4. 選擇 1 到 31 之間的任一天

步驟七：選擇你的主題

Claude Counter 提供 15 種以上美觀的配色主題。

  1. 前往 選項（標籤 5）
  2. 點按 主題與外觀
  3. 選擇你偏好的主題：
    • 系統（跟隨 iOS）
    • 藍色、紫色、綠色、粉紅色、金色
    • 鈷藍色、靛藍色、道奇藍
    • 橘色、紅色、黃色
    • 灰色、黑色、棕色
  4. 選擇 淺色、深色或系統模式
  5. 組合方式很多，花點時間找出你最喜歡的主題吧

步驟八：設定鎖定畫面小工具（Pro）

鎖定畫面小工具讓你不用開啟應用程式就能查看工作階段資訊。

新增小工具

  1. 長按你的鎖定畫面
  2. 點按 自訂
  3. 點按鎖定畫面以進行編輯
  4. 點按小工具區域（時間上方或下方）
  5. 搜尋 Claude Counter
  6. 從可用的小工具中選擇：
    • 工作階段計時器 - 剩餘的工作階段時間
    • 儲存進度 - 距離儲存提醒的時間
    • 剩餘工作階段 - 可用的工作階段次數
    • 剩餘天數 - 距離你 Claude 訂閱續訂還有幾天

小工具重新整理

當計時器正在執行時，小工具會自動更新。

步驟九：開始你的第一個工作階段

準備就緒！以下是開始追蹤的方法：

開始工作階段

  1. 開啟 Claude Counter 進入 標籤 1（工作階段）
  2. （選用）新增工作階段描述。加入任何專案或客戶標籤，即可在匯出資料時啟用關鍵字篩選
  3. （選用）選擇你將使用的 Claude 模型 — 會隨工作階段一併儲存
  4. 點按大大的 開始工作階段 按鈕
  5. 確認你要開始一個新的工作階段

若已連接你的 Mac（步驟三）：當你開啟應用程式時，如果 Claude 視窗已在執行，它會改為提供 記錄並同步 — 接受、新增描述，你的計時器就會對齊 Claude 實際的重設時間。該視窗已算作你其中一次工作階段，因此記錄它只是為了讓你的次數保持準確。

接下來會發生什麼

  • 工作階段計時器開始倒數
  • 儲存進度計時器開始倒數
  • 工作階段次數增加
  • 環狀進度顯示已使用的工作階段

工作階段進行期間

  • 讓 Claude Counter 保持開啟，或使用小工具來監控時間
  • 當儲存計時器的目標時間到達時，你會收到儲存提醒
  • 當工作階段計時器的目標時間到達時，你會收到提醒
  • 請注意，在 Claude 工作階段到期後，任何傳送給 Claude AI 的指令或回覆都會自動開始一個新的工作階段

結束你的工作階段

  • 如果你決定在工作階段結束前停止使用 Claude，再次點按按鈕以結束工作階段
  • 確認以停止所有計時器
  • 工作階段時間會儲存到你的歷史記錄中

步驟十：檢視你的統計資料

累積幾次工作階段後，探索你的統計資料：

  1. 前往 標籤 4（統計）
  2. 查看你的 快速統計 儀表板
  3. 捲動以查看圖表：
    • 以 7 天為週期的用量
    • 依日期顯示的工作階段時長
    • 依星期幾顯示的用量
    • 依小時顯示的工作階段
  4. 使用 週期篩選 來檢視：
    • 僅目前週期
    • 所有時間的資料
    • 特定的週期範圍

步驟十一：匯出你的資料

需要回報你的用量，或向客戶請款嗎？

快速匯出

  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 並授權資料夾存取（步驟三） — 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. 依需要匯出報表，用於請款或管理報告

祝你開發愉快！

需要協助嗎？

如果你有任何問題或遇到任何狀況，我們都在這裡協助你。

完整使用指南 產品頁面 聯絡支援