バックグラウンドタスクとは何か
Claude Code は、完了を待つことなくシェルコマンドを実行できます。リファレンスでは次のように説明されています。「Claude Code がバックグラウンドでコマンドを実行すると、コマンドは非同期で実行され、即座にバックグラウンドタスク ID を返します。コマンドがバックグラウンドで実行されている間も、Claude Code は新しいプロンプトに応答できます。」
主な対象は、時間がかかるものや、自動的には終了しないプロセスです。Anthropic は、ビルドツール、パッケージマネージャー、テストランナー、開発サーバー、および長時間実行されるプロセスを挙げています。
セッション内のバックグラウンド作業はシェルコマンドだけではありません。サブエージェントもバックグラウンドで実行でき、/tasks ビューではシェルと並んでリスト表示されます。Anthropic の並列作業の概要では、この2つを区別しています。バックグラウンドの bash コマンドは「会話をブロックせずに1つのシェルコマンドを実行します。エージェントは生成しません。」
コマンドがバックグラウンドに送られる仕組み
以下の3つの方法があります:
- 依頼する。 Claude Code にコマンドをバックグラウンドで実行するようプロンプトを出します。
- Ctrl+B を押す。 通常の Bash ツール呼び出しをバックグラウンドに移動させます。「tmux ユーザーは、tmux のプレフィックスキーの関係で
Ctrl+Bを2回押す必要があります。」 - タイムアウトさせる。 「コマンドが終了前にタイムアウトに達した場合、コマンドが
sleepで始まっていない限り、Claude Code は停止させる代わりに自動的にバックグラウンドへ移動させます。」
各バックグラウンドタスクには ID が割り振られ、その出力はファイルに保存されます。「出力はファイルに書き込まれ、Claude は Read ツールを使用してそれを取得できます」。これにより、Claude はセッションの早い段階で開始したテスト実行の状況を確認できるのです。
/tasks の表示内容
/tasks は、現在のセッションにおけるバックグラウンド作業を表示するビューです。コマンドリファレンスでは「終了したサブエージェントを含む、現在のセッションのバックグラウンド作業を表示および管理する」と説明されています。/bashes としても利用可能です。
並列作業の概要より:「現在のセッションのバックグラウンドで実行されているものについて、/tasks は各項目をリストし、確認、アタッチ、または停止を行えます。リストには終了したサブエージェントも含まれます。」
見落としがちな2つの詳細:
- 即座に実行される。 Claude Code は応答を中断することなく一部のコマンドを実行しますが、
/tasksもその一つです。 - 現在のセッションが対象。 これはマシン上のすべてのバックグラウンドプロセスをリストするものではなく、他のセッションのリストでもありません。
最近の変更により、終了したサブエージェントへのアクセスが容易になりました。11月6日にリリースされた Claude Code v2.1.319 では、終了したサブエージェントをリストする行が /tasks に追加されました。「これにより、リストから消えた後や再起動した後でも、サブエージェントを再度開いてメッセージを送ることができます」。
Ctrl+T で切り替えるタスクリストは別のものです。それは計画に対する Claude の To-Do チェックリストであり、バックグラウンドタスクのビューではありません。これについては、Claude Code のタスクリストが空である理由についてのガイドで解説しています。
終了時に何が起きるか
ルールは簡潔です:「Claude Code が終了すると、バックグラウンドタスクは自動的にクリーンアップされます。」
macOS と Linux では、クリーンアップはシェル以上に及びます。「/tasks からバックグラウンドタスクを停止した場合、または終了時に Claude Code が停止させた場合、setsid や timeout の下で開始されたものなど、タスクのシェルから切り離されたプロセスも停止します」。
したがって、macOS と Linux では、バックグラウンドタスクとして開始された開発サーバーは、通常であればシェルより長生きするような方法で開始されていても、セッション終了時に停止します。
サブエージェントやワークフローの実行中に終了する場合。 サブエージェントやワークフローなどのバックグラウンド作業が実行中に終了しようとすると、Claude Code は警告を表示します。エージェントビューのドキュメントによると、ダイアログが「作業が停止することを警告」し、代わりにセッションをバックグラウンドに移動して終了する選択肢を提示します。このオプションは、エージェントビューがオフの場合は表示されません。
バックグラウンドタスクが停止するその他の理由
終了だけが終わりではありません。リファレンスには他にもいくつか挙げられています。
出力が多すぎる。 「出力が 5GB を超えると、バックグラウンドタスクは自動的に終了し、stderr にその理由が記載されます」。
アイドル時のメモリ圧迫。 「macOS と Linux では、オペレーティングシステムが重大なメモリ圧迫を報告し、かつセッションが少なくとも30分間アイドル状態で、ターンやサブエージェントが実行されていない場合、Claude Code は実行中のバックグラウンドタスクを停止します」。
これらすべてが満たされる必要があります:システムが重大なメモリ圧迫下にあり、セッションが少なくとも30分間アイドルで、何も実行されていないこと。デバッグログには、タスクが停止された理由、または圧迫イベントがあっても実行し続けた理由が記録されます。この動作をオフにするには、CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP を 1 に設定します。環境変数リファレンスには、Windows にはメモリ圧迫のシグナルがないことが記されています。
無人セッションの制限時間。 「ターミナル、デスクトップアプリ、または VS Code 拡張機能から作業するローカルセッションのバックグラウンドコマンドには制限時間がありません。」 -p 実行やクラウドセッションなどの無人で実行されるセッションでは、Claude Code は制限時間に達したバックグラウンドコマンドを停止します。
開始したサブエージェントの終了。 「フォアグラウンドのサブエージェントが開始したバックグラウンドコマンドは、そのサブエージェントの実行が終了(完了、失敗、または中断)したときに終了します」。
この最後の点は、セットアップ作業を委任する場合に注意が必要です。サブエージェントがバックグラウンドで開発サーバーを起動した場合、サーバーの寿命はそのサブエージェントの実行に紐付けられます。
バックグラウンド作業を継続させる方法
離席後も作業を続けたい場合、推奨される方法は終了ではなく、セッションをバックグラウンド化することです。
リファレンスには次のようにあります:「終了する代わりにセッションをバックグラウンド化すると、バックグラウンドタスクはバックグラウンドセッションで実行され続けます。」
その方法はいくつかあります:
/backgroundまたは/bg。 「現在のセッションを切り離してバックグラウンドエージェントとして実行し、このターミナルを解放します。」追加の指示を1つ渡すことができ、claude agentsでセッションを監視できます。- 終了ダイアログ。 バックグラウンド作業が停止するという警告が表示されたら、セッションをバックグラウンドに移動して終了する方を選択します。
- バックグラウンドで開始。 Claude Code の起動時に
--bgを渡すと、最初からバックグラウンドでセッションが開始されます。
バックグラウンド化されたセッションは、その状態や入力待ちかどうかと共にエージェントビューに表示されます。これらのセッションが何を持って開始され、何を共有するかについては、Claude Code のエージェントビューとは何かについてのガイドで解説しています。
動的なワークフローに関する注意点が1つあります。ワークフローの実行中にセッションをバックグラウンド化すると、実行中のサブエージェントは、Claude がワークフローを再開したときに「最初からやり直し、トークンを再度消費」します。ダイアログにはその数が表示され、完了するまで待機することを選択できます。
バックグラウンドタスクをオフにする
バックグラウンドで何も実行したくない場合は、スイッチがあります。「バックグラウンドコマンドをオフにするには、環境変数 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 に設定します。」
これは名前から想像されるよりも広い影響を及ぼします。「これを設定すると、Ctrl+B ショートカットや、スキルをバックグラウンドで実行するなどの他のバックグラウンド機能も失われます。」環境変数リファレンスによると、Claude Code はサブエージェント、長時間の MCP ツール呼び出し、タイムアウトしたシェルコマンドを自動的にバックグラウンドへ移動させることも停止します。
bare モードで開始した場合も同様の効果があります。バックグラウンドコマンドがオフの状態では、タイムアウトに達したコマンドはバックグラウンドに移動せず、停止します。
バックグラウンドタスクが保持しないもの
バックグラウンドタスクは、ログ、テスト結果、実行中のサーバーなどの出力を生成します。Claude Code はその出力をファイルに書き込み、Claude はセッション中にそれを読み取ることができます。
タスクが生成しないのは、その結果が何を意味したかの「要約」です。テスト実行で不安定なテストが見つかったり、ビルドが失敗した理由を修正したりした場合、その結論は会話の中に存在します。タスクは終了時にクリーンアップされ、推論の耐久性はそれが行われたセッションの寿命と同じです。
開発サーバーであれば問題ありませんが、その結果によって次に何をすべきかが決まるような長時間実行の場合には、この点が重要になります。
よくある間違い
ターミナルを閉じればサーバーが走り続けると期待する。 Claude Code が終了すると、バックグラウンドタスクはクリーンアップされます。
/tasks で別のセッションのタスクを探す。 現在のセッションのバックグラウンド作業のみが表示されます。
セッションより長生きさせるために setsid でプロセスを開始する。 macOS と Linux では、Claude Code がタスクを停止すると、切り離されたプロセスも停止します。
高負荷なマシンをアイドル状態にする。 重大なメモリ圧迫下では、30分間のアイドル後にタスクが停止することがあります。
サーバーの起動をサブエージェントに委任する。 フォアグラウンドのサブエージェントによるバックグラウンドコマンドは、そのサブエージェントの実行終了とともに終了します。
解決策:必要なときにバックグラウンド作業を維持する
ステップ 1:作業をセッションより長生きさせるべきか判断する
クイックチェック用の開発サーバーはセッションと共に終了しても構いません。後で戻ってくる予定の長時間のテスト実行やビルドは、終了させるべきではありません。
ステップ 2:終了する代わりにセッションをバックグラウンド化する
/background を使用するか、終了ダイアログでバックグラウンドへの移動を選択し、後で claude agents で確認します。
ステップ 3:離れる前に /tasks を確認する
再開したい終了済みのサブエージェントを含め、何がまだ実行されているかを確認します。
ステップ 4:結果が何を意味したかを書き留める
どのテストが不安定か、なぜビルドが失敗したかなど、長時間実行から得られた結論をセッションの外に記録します。
MemoryLake でのセットアップ
バックグラウンドタスクは一時的なものとして設計されており、Claude Code は終了時にそれらをクリーンアップします。出力から得られた結論(どのテストが不安定か、どの依存関係がビルドを壊したかなど)こそが、次のセッションで必要になるものです。
MemoryLake は、決定事項、発見、制約などのプロジェクトコンテキストを1か所に維持し、ChatGPT、Claude Code、Codex などの接続されたアシスタントが利用できるようにするためのメモリレイヤーです。
エントリーはあなた自身の言葉で書き込みます。バックグラウンドタスク、その出力ファイル、セッション、セッショントランスクリプト、~/.claude フォルダ、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。バックグラウンドタスク、/tasks、およびクリーンアップは、Anthropic が説明している通りに動作します。
ステップ 1:API キーを作成する
サインインしてダッシュボードからキーを生成します。他の資格情報と同様に、リポジトリの外に保存してください。

ステップ 2:最初のメモリをアップロードする
解決策のステップ 4 で書いた内容から始めましょう。長時間実行で何が示されたか、既知の失敗はどれか、それによって何を決定したか。1つの発見につき1つのエントリーを作成します。

ステップ 3:AI とエージェントを接続する
Claude Code やその他の使用しているアシスタントを接続します。古いセッションのタスクがクリーンアップされた後の新しいセッションでも、同じ発見を活用できます。

実践で何が変わるか
第一の違いは、セッションを閉じても調査が終了しないことです。昨日のバックグラウンド実行からの発見は、依然として記録されています。
第二に、再実行が減ります。テストが不安定だと分かっていれば、すべてのセッションでそれを再発見する必要はありません。
第三に、ツール間での継続性です。Codex や同じリポジトリで作業する他のアシスタントも、同じ発見を利用できます。
Claude Code バックグラウンドタスクのベストプラクティス
終了ルールを把握する。 Claude Code が終了すると、バックグラウンドタスクはクリーンアップされます。
作業を継続させるにはセッションをバックグラウンド化する。 終了する代わりに /background を使用します。
現在のセッションには /tasks を使用する。 終了したサブエージェントを含むバックグラウンド作業がリストされます。
長時間のアイドル時はメモリに注意する。 30分間のアイドル後、重大なメモリ圧迫下でタスクが停止することがあります。
サーバーをサブエージェント内に置かない。 フォアグラウンドのサブエージェントによるバックグラウンドコマンドは、その実行とともに終了します。
意図的にバックグラウンドタスクをオフにする。 この設定は Ctrl+B やその他のバックグラウンド機能も削除します。
結果の意味を書き留める。 タスクの出力は一時的なものであり、結論はそうあるべきではありません。
結論
Claude Code のバックグラウンドタスクを使用すると、作業を続けながらシェルコマンドやサブエージェントを実行でき、/tasks には終了したサブエージェントを含む現在のセッションのバックグラウンド作業が表示されます。Claude Code が終了するとバックグラウンドタスクはクリーンアップされ、macOS と Linux ではタスクのシェルから切り離されたプロセスも含まれます。
タスクは、出力が 5GB を超えた場合、30分間のアイドル後に重大なメモリ圧迫が報告された場合、無人セッションで制限時間に達した場合、または開始したフォアグラウンドのサブエージェントが終了した場合にも停止することがあります。作業を継続させるには、終了する代わりにセッションをバックグラウンド化し、長時間実行からの結論を次のセッションが読み取れる場所に保管してください。