Claude Codeの通知をiPhoneで受け取る

しくみ

• Claude Codeは自分のイベントでフックを実行します。ターンが終わるとStop、許可や入力を求めるとNotification。モデルが送信を覚えているかどうかに左右されません。
• AgentAlarmのフックは、それを「Claude Code: task finished in my-app」「Claude Code needs your decision in my-app」という静かな通知にしてiPhoneへ送ります。
• 通知しすぎません。パソコンから離れているとき（2分間操作がないとき）だけ通知し、「完了」は3分以上かかったターンだけ、同じセッションでは5分に1回までです。
• 通知に含まれるのはプロジェクトのフォルダ名と所要時間だけ。プロンプト、コード、Claudeの出力は送りません。

プラグインで設定する

1. iPhoneにAgentAlarmをインストールし、Appleでサインインします。
2. Claude Codeでプラグインを追加します：

   /plugin marketplace add achubnet/agentalarm-plugins
   /plugin install agentalarm@agentalarm

3. /agentalarm:setupを実行します。MCPツールの接続（/mcpでagentalarmを選び、Authenticate、iPhoneで許可）とフック用のキーをClaudeが案内します。
4. 最後にテストすると、iPhoneに通知が届きます。

フックを自分で追加する

プラグインを使わない場合は、CLIに一度サインインします（Node 18以降）。アプリで「設定」→「接続済みのエージェント」→「AIエージェントを接続」を開いてテキストをコピーし、次を実行します：

npx agentalarm login "<アプリからコピーしたテキスト>"

そして~/.claude/settings.jsonに次を追加します：

{
  "hooks": {
    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }],
    "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }],
    "Notification": [{ "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog|agent_needs_input",
      "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }]
  }
}

フックはバックグラウンドで動くので、Claudeは待たされません。UserPromptSubmitはターンの開始時刻を記録するだけで、所要時間の計算に使います。

終わったら鳴らしてもらう

MCPツールを接続したら、チャットで頼むだけです：

• 「テストが通ったら鳴らして」
• 「マイグレーションが失敗したらiPhoneを鳴らして」
• 「18時にこのPRのレビューをリマインドして」

緊急のアラートは、消音モードや集中モードでも、「完了」か「スヌーズ」をタップするまで目覚まし時計のように鳴ります。「判断待ち」の通知をすべて鳴らすにはnpx agentalarm config set ringOnDecision trueを実行します。

Apple Watchでも

iPhoneがロックされている間は、ほかのiPhoneの通知と同じようにAgentAlarmの通知もApple Watchに届きます。届かない場合はWatchアプリ →「通知」→ AgentAlarmを確認してください。

調整と一時停止

npx agentalarm setup              # 通知する条件
npx agentalarm config set minTaskMinutes 10
npx agentalarm pause 1h           # 再開: npx agentalarm resume
npx agentalarm test               # iPhoneを一度鳴らす

通知を控える時間帯を設定すると、フックからのアラームは普通の通知になります。例：npx agentalarm config set quietHours 23:00-08:00