Human in the loop：あなたにしかできない作業を見失わない Claude Code ヒューマンインザループ Mod

Human in the loop は Tzafrir Rehan（tzafrir）によるコミュニティ Mod で、Claude Code ヒューマンインザループを実現します。想定する場面は、Claude があなたにしかできないこと（.env へのキーの設定、ステージングでの承認、あなたのマシンでのコマンド実行、判断など）を必要とするときです。普通は返信の途中で一言触れるだけで、その依頼はすぐ流れてしまいます。この Mod があると、Claude は依頼をタスクとして割り当てます。

Mod は assign_task、list_tasks、withdraw_task の 3 つのツールを登録し、あなたにしかできないこと（作業のレビューを含む）には assign_task を使うよう、システムプロンプトに数行を加えます。タスクにはタイトル、1 文の理由、任意の「完了条件」、種類があります。種類は do（あなたがやって完了にする）、answer（Claude があなたの言葉を必要とする）、choose（2〜4 個の選択肢から選ぶ）です。未完了のタスクは My tasks ペインで待ち、プロンプト下のステータス行に ☐ 1 task for you · /my-tasks のように件数が出ます。完了、選択肢、回答、理由付きの却下で応答できます。

タスクは Claude を止めません。Claude は別の作業を続け、あなたの応答は返したときにメッセージとして届きます。コード上の制限は、未完了は最大 5 件、同じ依頼は 1 件にまとめられ、タスクを割り当てられるのはメインエージェントだけです。

録画では、小さなデモプロジェクトで Mod を読み込んだ Claude Code を起動し、assign_task で .env に STRIPE_KEY を設定するタスクを 1 つ割り当てるよう Claude に頼みます。Claude がツールを呼ぶと、トランスクリプトに黄色の ☐ Assigned you a task: Put your STRIPE_KEY in the .env file の行が表示され、続いてタスクが #1 で未完了は 5 件中 1 件であるというツール結果が出ます。プロンプト下のステータス行は ☐ 1 task for you · /my-tasks となり、フッター右側にはトースト human-in-the-loop: Claude assigned you a task: Put your STRIPE_KEY in the .env file. See /my-tasks が出ます。この幅の狭い録画ではペインは自動で開かず（トーストはそのためのものです）、ペインやタスクへの回答は映っていません。

インストール欄のどの方法でも、作者自身のマーケットプレイスから直接インストールされます。インストール後は新しいセッションを始めるか、/reload-plugins を実行してください。/my-tasks でペインが開きます。

フックのモジュールは hooks/register.tsx だけです。assign_task のハンドラーは引数を検査し、重複と 6 件目の未完了タスクを拒否し、タスクを保存してペインを開きます。hooks/register.tsx より:

on('tool.call', { tool: ASSIGN }, async ($, e) => {
  if (e.agentId !== undefined) {
    return { deny: 'Only the main agent assigns tasks to the user. Say what you need from the user in your result instead.' }
  }
  const ask = parseAsk(e as unknown as Record<string, unknown>)
  if ('error' in ask) {
    return { deny: ask.error }
  }
  // ...
  return { result: assignedOf(task, active.length + 1) }
})

タスクは $.state と、プロジェクトフォルダ配下のセッションごとの $.store キーに保存されます。書き込みは 60 秒間隔のハートビートで行われ、終了したセッションや応答のないセッションのタスクを次のセッションが引き継げるようにしています。応答は、Claude がアイドルなら $.prompt.submit で、作業中なら $.session.append で行として追加されます。prompt.compose フックが誘導の文章を加え、prompt.context フックが会話の開始時とコンパクション後に未完了タスクを一覧にします。

オプションはありません。ペインのボタンとキーで操作します。d で完了、1〜4 で選択肢、r で回答、x で却下、送信のタイミングは Save for later と Send now です。長い回答は自分のプロンプト欄から入力し、Long answer… が ↳ Answer to #3: で始まる状態にしてくれます。上限を変えるには、MAX_OPEN と MAX_TITLE が hooks/tasks.ts に、BATCH_MS が hooks/register.tsx にあります。

何かを実行する前に、プラグインが読み込むすべてのファイルを読みました。.claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx、pane.ts、project.ts、tasks.ts、text.ts、型宣言、テストです。package.json、インストールスクリプト、バンドル済みまたは minify 済みのコードはなく、PNG と GIF の画像以外のバイナリもありません。LICENSE ファイル（MIT）があります。

• ネットワーク、プロセス、ファイル、環境変数： いずれもなし。フック内で fetch、child_process、$.process、$.http、eval、動的 import() は見つかりませんでした。保存先は $.store と $.state だけで、データモデルは docs/privacy.md に書かれています。テレメトリーはなく、作者のプライバシーポリシーはデータがマシンの外に出ないと述べています。
• デーモン： なし。$.clock.every のハートビートはセッションが動いている間だけ動きます。
• モデルへの影響： ここが注目点です。Mod は 3 つのツール、システムプロンプト末尾の 3 行（STEERING）、未完了タスクを並べた humanInTheLoop コンテキストブロック、次のプロンプトに付くタスク更新のダイジェストを加えます。また 3 つのツールを遅延ではなく常に表示します。文章は平易で README と一致しており、コードとマニフェストに隠し文字やゼロ幅文字は見つかりませんでした（絵文字のテスト文字列にあるのみ）。
• ゲートするフック： tool.call フックは Mod 自身の 3 つのツールにだけ応答します。prompt.submit はプロンプトを読み、長い回答（↳ Answer to #N:）を認識し、未送信の応答を添付します。秘密情報に見える回答は送信されず通知が出ます。ほかのツール呼び出しはそのまま通ります。validate は、これらのフックに .catch がないと注記しています。
• 送信するプロンプト： あなたの言葉でのタスクへの応答と、固定の 1 行 I answered a task while you were finishing your reply; my answer is above. のみです。
• 要件： Claude Code で function hooks が有効であること（README は先行公開機能としています）。外部バイナリやアカウントは不要です。

claude plugin validate はエラー・警告なしで通り、作者のテストも Claude Code 2.1.310 で全件通りました（192 件成功、0 件失敗）。

macOS 上の Claude Code 2.1.310 で確認しました（validate、テスト、録画）。何も起きない場合:

• function hooks が有効で、/plugin でプラグインが読み込まれている。
• インストール後に新しいセッションを始めるか /reload-plugins を実行した。
• Claude がタスクを割り当てるのは、システムプロンプトに誘導の文章があるときだけです。-p（print）や bare モードでは追加されません。
• 幅の狭いターミナルでは、ペインは勝手に開きません。/my-tasks を実行し、クリックするか ctrl+x tab でキー操作に切り替えます。
• モバイルアプリには回答欄がないため、完了、選択肢、即時の却下だけが使えます。