說明：AI 應用程式與寫程式時間

將 Hourcrumb 連接到 AI 應用程式，就能用平常的話詢問或記錄你的時間，在程式工具裡花的時間也會自動變成建議時段。兩者都需要 Hourcrumb Plus 和 Hourcrumb 帳號。

你的電腦

向 AI 應用程式詢問你的時間

將 Hourcrumb 加入應用程式一次即可。應用程式第一次使用 Hourcrumb 時，會在瀏覽器中開啟 Hourcrumb：登入並選擇「允許」。不需要複製任何金鑰。

在電腦上的 Claude 應用程式中，或在 claude.ai 上：設定 → 連接器 → 新增自訂連接器。命名為 Hourcrumb，貼上此位址，然後選擇「連接」。之後在手機上的 Claude 應用程式中也能使用。

https://api.hourcrumb.com/mcp

僅適用於終端機中的 Claude Code（需要 claude 指令）。執行這個，然後在 Claude Code 中輸入 /mcp 並選擇 hourcrumb 登入。

claude mcp add --transport http hourcrumb https://api.hourcrumb.com/mcp

在終端機中執行這些指令。第二個會開啟 Hourcrumb 讓你登入。

codex mcp add hourcrumb --url https://api.hourcrumb.com/mcp
codex mcp login hourcrumb

在裝有 Cursor 的電腦上，使用這個按鈕，或在 Cursor 設定 → MCP 中新增此位址。Cursor 要求時登入即可。

https://api.hourcrumb.com/mcp

在 Agent 面板中，開啟 … → MCP Servers → Manage MCP Servers → View raw config，加入這幾行並儲存。要求時登入即可。

{
  "mcpServers": {
    "hourcrumb": {
      "serverUrl": "https://api.hourcrumb.com/mcp"
    }
  }
}

然後試試：「我這週在每個專案上工作了多久？」或「把今天早上 2 小時記到寫作。」

當你使用 AI 程式工具時，Hourcrumb 會記下你所在的資料夾，最多每分鐘一次，並將它變成名為「Claude Code · my-app」這樣的建議時段。你可以像確認其他建議一樣確認它們。

從 https://nodejs.org 下載 LTS 安裝程式並開啟。如果你使用 Homebrew，也可以改為執行：

brew install node

要檢查，請在終端機中執行這個：應顯示 v18 或更新版本。

node -v

按 Cmd+Space，輸入「終端機」，然後按 Return。

npx hourcrumb login
npx hourcrumb setup claude
npx hourcrumb setup codex

第一個會在瀏覽器中開啟 Hourcrumb：登入並選擇「允許」。其他指令會將 Hourcrumb 加入 Claude Code 和 Codex，並為它們修改的每個檔案保留備份。不用的工具那一行可以略過。

結束 Claude Code 或 Codex 再重新開啟：從下一個工作階段開始記錄。在 Claude 桌面應用程式中，開啟新的 Code 工作階段。

開啟「延伸模組」，搜尋 Hourcrumb 並選擇「安裝」。然後開啟命令選擇區（Cmd+Shift+P），執行「Hourcrumb: Sign in」，並在瀏覽器中選擇「允許」。記錄時狀態列會顯示 Hourcrumb。

工作一分鐘，然後在 Hourcrumb 中開啟「今天」：下次同步後，會出現以工具和資料夾命名的建議時段。要查看終端機工具是否已登入並設定好，請執行：

npx hourcrumb status

如果你在設定 → AI 應用程式中斷開了該應用程式，或 90 天沒有使用，請重新登入：npx hourcrumb login（在編輯器中為「Hourcrumb: Sign in」）。掛鉤只在設定之後開啟的工作階段中執行。

如果 npx 因 ENOENT 或 EPERM 等 npm 錯誤而停止，表示 npm 的快取已損壞。執行下面的指令後再試一次：

npm cache verify

執行這個，並在設定 → AI 應用程式中中斷連接該應用程式。設定時在每個修改過的檔案旁留了一份副本（以 .hourcrumb-backup 結尾），需要還原舊檔案時可以使用。

npx hourcrumb logout

只有工具名稱和資料夾名稱（不含路徑），最多每分鐘一次。提示、程式碼、檔名和回覆都留在你的電腦上。詳見隱私權政策。