帮助：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

只有工具名称和文件夹名称（不含路径），最多每分钟一次。提示词、代码、文件名和回复都留在你的电脑上。详见隐私政策。