Documentation 2026-09-30 23:00 UTC to 2026-10-01 03:02 UTC

2884 2884 

2885**ツール名：** `Bash`2885**ツール名：** `Bash`

2886 2886 

2887フォアグラウンドの上限については、[タイムアウトと出力制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands) を参照してください。2887フォアグラウンドの上限については、[タイムアウトと出力制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) を参照してください。

2888 2888 

2889**入力：**2889**入力：**

2890 2890 

3184};3184};

3185```3185```

3186 3186 

3187オプションのタイムアウトとバックグラウンド実行を備えた Bash コマンドを実行します。作業ディレクトリはコマンド間で永続化されます。マルチターンセッションの後のターンで実行されるコマンドも含まれます。エクスポートされた環境変数などのシェル状態は永続化されません。ディレクトリ変更がどの程度引き継がれるかの制限については、[コマンド間で永続化されるもの](/docs/ja/tools-reference#what-persists-between-commands) を参照してください。フォアグラウンドの上限を設定するものについては、[タイムアウトと出力の制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands) を参照してください。3187オプションのタイムアウトとバックグラウンド実行を備えた Bash コマンドを実行します。作業ディレクトリはコマンド間で永続化されます。マルチターンセッションの後のターンで実行されるコマンドも含まれます。エクスポートされた環境変数などのシェル状態は永続化されません。ディレクトリ変更がどの程度引き継がれるかの制限については、[コマンド間で永続化されるもの](/docs/ja/tools-reference#what-persists-between-commands) を参照してください。フォアグラウンドの上限を設定するものについては、[タイムアウトと出力の制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) を参照してください。

3188 3188 

3189<h3 id="monitor">3189<h3 id="monitor">

3190 Monitor3190 Monitor

4088 4088 

4089`timedOutAfterMs` はタイムアウト（ミリ秒単位）で、コマンドがタイムアウトに達し、明示的に開始するのではなくバックグラウンドに移動した場合に設定されます。`backgroundCwdHint` はバックグラウンド化されたコマンドに `cd`、`pushd`、`popd`、`chdir` などのディレクトリ変更組み込みが含まれていた場合に設定され、セッション作業ディレクトリが変更されなかったことを注記します。両方のフィールドは Claude Code v2.1.210 以降が必要です。4089`timedOutAfterMs` はタイムアウト（ミリ秒単位）で、コマンドがタイムアウトに達し、明示的に開始するのではなくバックグラウンドに移動した場合に設定されます。`backgroundCwdHint` はバックグラウンド化されたコマンドに `cd`、`pushd`、`popd`、`chdir` などのディレクトリ変更組み込みが含まれていた場合に設定され、セッション作業ディレクトリが変更されなかったことを注記します。両方のフィールドは Claude Code v2.1.210 以降が必要です。

4090 4090 

4091フォアグラウンドで実行されているサブエージェントがバックグラウンド化されたコマンドを所有している場合、コマンドは[そのサブエージェントの実行が終了するときに終了します](/docs/ja/tools-reference#background-commands)。Claude Code はそのようなコマンドで `backgroundEndsWithFinalResponse` を `true` に設定し、コマンドがターンを超えて存続する場合はフィールドを省略します。メインの会話またはバックグラウンドサブエージェントによって開始されたコマンドと同様です。このフィールドは Claude Code v2.1.227 以降が必要です。4091フォアグラウンドで実行されているサブエージェントがバックグラウンド化されたコマンドを所有している場合、コマンドは[そのサブエージェントの実行が終了するときに終了します](/docs/ja/tools-reference#when-a-background-command-stops)。Claude Code はそのようなコマンドで `backgroundEndsWithFinalResponse` を `true` に設定し、コマンドがターンを超えて存続する場合はフィールドを省略します。メインの会話またはバックグラウンドサブエージェントによって開始されたコマンドと同様です。このフィールドは Claude Code v2.1.227 以降が必要です。

4092 4092 

4093Claude Code は `gitOperation.commit.branch` を git のコミットサマリー行で名付けられたブランチに設定し、デタッチされた HEAD でコミットされたブランチの場合は省略します。このフィールドは Agent SDK v0.3.227 以降が必要です。Claude Code は `gh pr reopen` コマンドを `reopened` PR アクションとして報告します。これは Agent SDK v0.3.234 以降が必要です。4093Claude Code は `gitOperation.commit.branch` を git のコミットサマリー行で名付けられたブランチに設定し、デタッチされた HEAD でコミットされたブランチの場合は省略します。このフィールドは Agent SDK v0.3.227 以降が必要です。Claude Code は `gh pr reopen` コマンドを `reopened` PR アクションとして報告します。これは Agent SDK v0.3.234 以降が必要です。

4094 4094 

8 8 

9`claude agents` で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。9`claude agents` で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。

10 10 

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1872" height="680" data-path="images/agent-view-light.png" />

12 12 

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14 

15Claude が複数の独立したタスクに対して、あなたが毎ステップを監視することなく作業できる場合に、エージェントビューを使用します。バグ修正、プルリクエストレビュー、不安定なテストの調査を 3 つの行としてディスパッチし、別のウィンドウで作業を続け、行が入力が必要であることを示すか、結果が得られたときに確認します。15Claude が複数の独立したタスクに対して、あなたが毎ステップを監視することなく作業できる場合に、エージェントビューを使用します。バグ修正、プルリクエストレビュー、不安定なテストの調査を 3 つの行としてディスパッチし、別のウィンドウで作業を続け、行が入力が必要であることを示すか、結果が得られたときに確認します。

16 16 

84| `--dangerously-skip-permissions` | 権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)でこれが何をスキップし、何をスキップしないかを参照してください。`--bg` で開始されたセッションの場合、モードは[スーパーバイザーがセッションを再開するときに保持](/docs/ja/agent-view#permission-mode-model-and-effort)されます | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | 権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)でこれが何をスキップし、何をスキップしないかを参照してください。`--bg` で開始されたセッションの場合、モードは[スーパーバイザーがセッションを再開するときに保持](/docs/ja/agent-view#permission-mode-model-and-effort)されます | `claude --dangerously-skip-permissions` |

85| `--debug` | デバッグモードを有効にします。オプションのカテゴリフィルタリング（`--debug='mcp,startup'` または `--debug='!1p'` など）を使用します。フィルターは `=` 形式でのみバインドされます。スペース区切りフィルターはフィルタリングなしでデバッグモードを有効にします | `claude --debug='mcp,startup'` |85| `--debug` | デバッグモードを有効にします。オプションのカテゴリフィルタリング（`--debug='mcp,startup'` または `--debug='!1p'` など）を使用します。フィルターは `=` 形式でのみバインドされます。スペース区切りフィルターはフィルタリングなしでデバッグモードを有効にします | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` よりも優先されます | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` よりも優先されます | `claude --debug-file /tmp/claude-debug.log` |

87| `--desktop` | [Claude Desktop アプリ](/docs/ja/desktop)を現在のディレクトリで開き、ターミナルでセッションを開始せずに終了します。`--continue` を追加するか、セッション ID を使用して `--resume` を追加して、[代わりに Desktop でそのセッションを開く](/docs/ja/desktop#coming-from-the-cli)ことができます。ここで `--resume` はセッション ID のみを取り、名前またはトランスクリプトパスは取りません。プロンプトと `--verbose` および `--debug` フラグ以外の他のフラグは取りません。アプリがセッション自体を開始するため。macOS および x64 Windows で Claude サブスクリプションでサインインしている場合に利用可能です。Claude Code v2.1.285 以降が必要です | `claude --desktop` |

87| `--disable-slash-commands` | このセッションのすべてのスキルとコマンドを無効にします | `claude --disable-slash-commands` |88| `--disable-slash-commands` | このセッションのすべてのスキルとコマンドを無効にします | `claude --disable-slash-commands` |

88| `--disallowedTools`, `--disallowed-tools` | 拒否ルール。ベアツール名は一致するツールを Claude のコンテキストから削除します。`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、[書かれたとおりに](/docs/ja/permissions#bash-rule-limits)一致する呼び出しのみを拒否します。[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)という名前のルールは、他のツールが残っている間はそれを削除できません | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |89| `--disallowedTools`, `--disallowed-tools` | 拒否ルール。ベアツール名は一致するツールを Claude のコンテキストから削除します。`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、[書かれたとおりに](/docs/ja/permissions#bash-rule-limits)一致する呼び出しのみを拒否します。[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)という名前のルールは、他のツールが残っている間はそれを削除できません | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | 現在のセッションの[努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode`。利用可能なレベルはモデルによって異なります。`ultracode` は [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) をオンにして `xhigh` 努力をリクエストし、Claude Code v2.1.203 以降が必要です。このセッションの [`modelSettings`](/docs/ja/settings-reference#modelsettings) と [`effortLevel`](/docs/ja/settings-reference#effortlevel) 設定をオーバーライドし、保持されません | `claude --effort high` |90| `--effort` | 現在のセッションの[努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode`。利用可能なレベルはモデルによって異なります。`ultracode` は [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) をオンにして `xhigh` 努力をリクエストし、Claude Code v2.1.203 以降が必要です。このセッションの [`modelSettings`](/docs/ja/settings-reference#modelsettings) と [`effortLevel`](/docs/ja/settings-reference#effortlevel) 設定をオーバーライドし、保持されません | `claude --effort high` |

116| `--permission-prompts` | プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの `host` を使用すると、Claude Code はそれらをエージェント SDK ホストまたは `--permission-prompt-tool` ツールに送信します。誰も答えられない場合は `none` を渡し、Claude Code は代わりにそれらを拒否します。[無人実行で権限プロンプトをオフにする](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)を参照してください。Claude Code v2.1.259 以降が必要です | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの `host` を使用すると、Claude Code はそれらをエージェント SDK ホストまたは `--permission-prompt-tool` ツールに送信します。誰も答えられない場合は `none` を渡し、Claude Code は代わりにそれらを拒否します。[無人実行で権限プロンプトをオフにする](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)を参照してください。Claude Code v2.1.259 以降が必要です | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | ディレクトリまたは `.zip` アーカイブからプラグインを読み込むか、[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)から複数を読み込みます。このセッションのみ。各フラグは 1 つのパスを取ります。より多くのパスについてはフラグを繰り返します。`--plugin-dir A --plugin-dir B.zip`。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | ディレクトリまたは `.zip` アーカイブからプラグインを読み込むか、[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)から複数を読み込みます。このセッションのみ。各フラグは 1 つのパスを取ります。より多くのパスについてはフラグを繰り返します。`--plugin-dir A --plugin-dir B.zip`。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | URL からプラグイン `.zip` アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します | `claude --plugin-url https://example.com/plugin.zip` |119| `--plugin-url` | URL からプラグイン `.zip` アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | 対話モードなしで応答を出力します（プログラム的な使用の詳細については[エージェント SDK ドキュメント](/docs/ja/agent-sdk/overview)を参照してください） | `claude -p "query"` |120| `--print`, `-p` | 対話モードなしで応答を出力します（プログラム的な使用の詳細については[エージェント SDK ドキュメント](/docs/ja/agent-sdk/overview)を参照してください）。バックグラウンドセッションで `--resume` を実行している場合で、まだ実行中の場合は、[セッションを再開](/docs/ja/sessions#resume-a-running-background-session)を参照してください | `claude -p "query"` |

120| `--prompt-suggestions` | 各ターンの後に予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。非常に短い会話は何も生成しない可能性があります。`--print`、`--output-format stream-json`、`--verbose` が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を参照してください | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | 各ターンの後に予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。非常に短い会話は何も生成しない可能性があります。`--print`、`--output-format stream-json`、`--verbose` が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を参照してください | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | `--environment` を使用して、新しいセッションのチェックアウトをローカル `HEAD` の代わりに名前付きリファレンスに基づかせます | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | `--environment` を使用して、新しいセッションのチェックアウトをローカル `HEAD` の代わりに名前付きリファレンスに基づかせます | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

122| `--remote` | `--cloud` の非推奨エイリアス。既存セッション形式を含みます | `claude --remote "Fix the login bug"` |123| `--remote` | `--cloud` の非推奨エイリアス。既存セッション形式を含みます | `claude --remote "Fix the login bug"` |

124| `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合、自動生成された[リモートコントロール](/docs/ja/remote-control)セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定して同じ効果を得ます | `claude remote-control --remote-control-session-name-prefix dev-box` |125| `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合、自動生成された[リモートコントロール](/docs/ja/remote-control)セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定して同じ効果を得ます | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | stdin からのユーザーメッセージを stdout に再出力して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |126| `--replay-user-messages` | stdin からのユーザーメッセージを stdout に再出力して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | 制限モードで開始します。評価ハーネスが共有マシン上で `claude` を駆動し、Claude Code がそのマシンのコマンドを実行したり、ユーザーおよびプロジェクト設定を読み取ったりしてはいけない場合に使用します。Claude Code は、`--tools` で個別に名前を付けない限り、`default` プリセットを通じて、コマンドまたはコードを実行するビルトインツールと WebFetch を削除します。また、ビルトインファイルツールを[作業ディレクトリ](/docs/ja/permissions#working-directories)に限定し、[管理設定](/docs/ja/managed-settings)と `--settings` のみを読み込み、[`bypassPermissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を拒否し、[クラウドセッションの作成を拒否](/docs/ja/errors#cloud-sessions-cannot-be-created-from-a-restricted-session)します。Claude Code v2.1.248 以降が必要です | `claude --restricted -p "query"` |127| `--restricted` | 制限モードで開始します。評価ハーネスが共有マシン上で `claude` を駆動し、Claude Code がそのマシンのコマンドを実行したり、ユーザーおよびプロジェクト設定を読み取ったりしてはいけない場合に使用します。Claude Code は、`--tools` で個別に名前を付けない限り、`default` プリセットを通じて、コマンドまたはコードを実行するビルトインツールと WebFetch を削除します。また、ビルトインファイルツールを[作業ディレクトリ](/docs/ja/permissions#working-directories)に限定し、[管理設定](/docs/ja/managed-settings)と `--settings` のみを読み込み、[`bypassPermissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を拒否し、[クラウドセッションの作成を拒否](/docs/ja/errors#cloud-sessions-cannot-be-created-from-a-restricted-session)します。Claude Code v2.1.248 以降が必要です | `claude --restricted -p "query"` |

127| `--resume`, `-r` | ID または名前で特定のセッションを再開するか、セッションを選択するための対話型ピッカーを表示します。ID の代わりに、セッションの `.jsonl` [トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)への絶対パスを渡すことができます。ピッカーと名前検索には、このディレクトリを `/add-dir` で追加したセッションが含まれます。セッション ID を渡すと、Claude Code は現在のプロジェクトディレクトリとその git ワークツリーを検索してから、このマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索は現在のプロジェクトディレクトリとその git ワークツリーのみをカバーしていました。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます | `claude --resume auth-refactor` |128| `--resume`, `-r` | ID または名前で特定のセッションを再開するか、セッションを選択するための対話型ピッカーを表示します。ID の代わりに、セッションの `.jsonl` [トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)への絶対パスを渡すことができます。ピッカーと名前検索には、このディレクトリを `/add-dir` で追加したセッションが含まれます。セッション ID を渡すと、Claude Code は現在のプロジェクトディレクトリとその git ワークツリーを検索してから、このマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索は現在のプロジェクトディレクトリとその git ワークツリーのみをカバーしていました。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。まだ実行中のセッションを再開すると、[そのセッション](/docs/ja/sessions#resume-a-running-background-session)を `claude attach` を通じてこのターミナルで開き、コマンドラインで渡すプロンプトはそれに次のターンとして送信されます。v2.1.285 より前は、Claude Code は拒否し、代わりに実行する `claude attach` コマンドを出力しました | `claude --resume auth-refactor` |

128| `--safe-mode` | 壊れた設定をトラブルシューティングするためにすべてのカスタマイズを無効にして開始します。CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。認証、モデル選択、ビルトインツール、権限は通常どおり機能します。これは [`--bare`](/docs/ja/headless#start-faster-with-bare-mode) と異なります。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは含まれません。[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)をトリガーするカスタマイズかどうかを確認するのに役立ちます。[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars) を設定します | `claude --safe-mode` |129| `--safe-mode` | 壊れた設定をトラブルシューティングするためにすべてのカスタマイズを無効にして開始します。CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。認証、モデル選択、ビルトインツール、権限は通常どおり機能します。これは [`--bare`](/docs/ja/headless#start-faster-with-bare-mode) と異なります。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは含まれません。[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)をトリガーするカスタマイズかどうかを確認するのに役立ちます。[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars) を設定します | `claude --safe-mode` |

129| `--session-id` | 会話に特定のセッション ID を使用します（有効な UUID である必要があります） | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |130| `--session-id` | 会話に特定のセッション ID を使用します（有効な UUID である必要があります） | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | 読み込む設定ソースのコンマ区切りリスト（`user`、`project`、`local`）。[エージェントビュー](/docs/ja/agent-view#what-carries-over-when-you-background)と[エージェントチーム](/docs/ja/agent-teams#context-and-communication)を参照してください。このセッションから開始するセッションがリストを継承します | `claude --setting-sources user,project` |131| `--setting-sources` | 読み込む設定ソースのコンマ区切りリスト（`user`、`project`、`local`）。[エージェントビュー](/docs/ja/agent-view#what-carries-over-when-you-background)と[エージェントチーム](/docs/ja/agent-teams#context-and-communication)を参照してください。このセッションから開始するセッションがリストを継承します | `claude --setting-sources user,project` |

439 439 

440* **Claude が実行するコマンド**：クラウド環境は独自のコマンドタイムアウトを設定しないため、Bash ツールのデフォルトが適用されます。Claude はデフォルトでコマンドを 2 分間待機し、最大 10 分間要求できます。440* **Claude が実行するコマンド**：クラウド環境は独自のコマンドタイムアウトを設定しないため、Bash ツールのデフォルトが適用されます。Claude はデフォルトでコマンドを 2 分間待機し、最大 10 分間要求できます。

441 441 

442 コマンドが[タイムアウト](/docs/ja/tools-reference#timeout-and-output-limits)に達すると、Claude Code は `sleep` で始まるコマンドを除き、それを停止する代わりに[バックグラウンドに移動](/docs/ja/tools-reference#background-commands)します。この方法で移動されたコマンドは、Claude Code がそれを[バックグラウンド時間制限](/docs/ja/tools-reference#background-commands)で停止する前に、最大 30 分間実行し続けることができます。`BASH_DEFAULT_TIMEOUT_MS` を `1800000` ミリ秒より上に設定すると、その制限とフォアグラウンドデフォルトの両方が長くなります。442 コマンドが[タイムアウト](/docs/ja/tools-reference#timeout-and-output-limits)に達すると、Claude Code は `sleep` で始まるコマンドを除き、それを停止する代わりに[バックグラウンドに移動](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background)します。この方法で移動されたコマンドは、Claude Code がそれを[バックグラウンド時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)で停止する前に、最大 30 分間実行し続けることができます。`BASH_DEFAULT_TIMEOUT_MS` を `1800000` ミリ秒より上に設定すると、その制限とフォアグラウンドデフォルトの両方が長くなります。

443* **SessionStart hooks**：Claude Code は、hook エントリで[`timeout`](/docs/ja/hooks#common-fields)（秒単位）を設定しない限り、600 秒後に `command` hook をキャンセルします。Claude Code は[`async: true`](/docs/ja/hooks#run-hooks-in-the-background)で実行する hook に対してタイムアウトを適用しません。443* **SessionStart hooks**：Claude Code は、hook エントリで[`timeout`](/docs/ja/hooks#common-fields)（秒単位）を設定しない限り、600 秒後に `command` hook をキャンセルします。Claude Code は[`async: true`](/docs/ja/hooks#run-hooks-in-the-background)で実行する hook に対してタイムアウトを適用しません。

444* **セットアップスクリプト**：約 5 分以上かかるスクリプトはキャッシュされません。[スクリプト要件](#script-requirements)は、その制限内に留まる方法をカバーしています。444* **セットアップスクリプト**：約 5 分以上かかるスクリプトはキャッシュされません。[スクリプト要件](#script-requirements)は、その制限内に留まる方法をカバーしています。

445* **アイドルセッション**：数分間アクティビティがない場合、セッションの VM はファイルが保存された状態で一時停止され、一時停止された VM は後で回収される可能性があります。[環境変数の設定](#set-environment-variables)は、各ケースでセッションが何を取得するかについて説明し、[Environment expired](/docs/ja/claude-code-on-the-web#environment-expired)は VM が回収されたセッションを再度開く方法をカバーしています。445* **アイドルセッション**：数分間アクティビティがない場合、セッションの VM はファイルが保存された状態で一時停止され、一時停止された VM は後で回収される可能性があります。[環境変数の設定](#set-environment-variables)は、各ケースでセッションが何を取得するかについて説明し、[Environment expired](/docs/ja/claude-code-on-the-web#environment-expired)は VM が回収されたセッションを再度開く方法をカバーしています。

132| `/remote-control` | このセッションを claude.ai から [Remote Control](/docs/ja/remote-control) で利用可能にします。サインアウト状態で実行すると、Remote Control に claude.ai サブスクリプションが必要であることを出力し、サインイン方法を示します。v2.1.206 より前は `Unknown command: /remote-control` を報告しました。エイリアス：`/rc` |132| `/remote-control` | このセッションを claude.ai から [Remote Control](/docs/ja/remote-control) で利用可能にします。サインアウト状態で実行すると、Remote Control に claude.ai サブスクリプションが必要であることを出力し、サインイン方法を示します。v2.1.206 より前は `Unknown command: /remote-control` を報告しました。エイリアス：`/rc` |

133| `/remote-env` | CLI から開始するクラウドセッションのデフォルト[クラウド環境](/docs/ja/cloud-environments#select-an-environment-from-the-cli)を選択します |133| `/remote-env` | CLI から開始するクラウドセッションのデフォルト[クラウド環境](/docs/ja/cloud-environments#select-an-environment-from-the-cli)を選択します |

134| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非インタラクティブモード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字でキャップします。非表示文字が削除されると名前が空の場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さキャップには Claude Code v2.1.221 以降が必要です。このマシン上の別のライブセッションが既に渡した名前を使用している場合、Claude Code は[その変種](/docs/ja/sessions#name-your-sessions)を代わりに適用します |134| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非インタラクティブモード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字でキャップします。非表示文字が削除されると名前が空の場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さキャップには Claude Code v2.1.221 以降が必要です。このマシン上の別のライブセッションが既に渡した名前を使用している場合、Claude Code は[その変種](/docs/ja/sessions#name-your-sessions)を代わりに適用します |

135| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。実行中のセッションはここで再開できないため、`claude agents` からアタッチするか、最初にそこで停止します。エイリアス：`/continue` |135| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。実行中のセッションをピッカーから、または ID または名前で再開すると、[そのセッションが開きます](/docs/ja/sessions#resume-a-running-background-session)：現在の会話はバックグラウンドに移動し、このターミナルは実行中のセッションにアタッチされます。空のプロンプトで `←` を押してエージェントビューに戻ります。これは、残した会話も一覧表示します。v2.1.285 より前は、Claude Code は拒否し、`claude attach` を使用するか、最初にそこで停止するよう指示しました。エイリアス：`/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | [`/code-review`](/docs/ja/code-review#review-a-diff-locally) のエイリアス：現在の diff、または `/review 1234` などの渡す PR 番号、ブランチ、またはパスをレビューし、同じ努力レベルとフラグを取ります。レベルが指定されていない場合、レビューは最後に入力した `low` ～ `max` レベルを再利用します。正確なルールについては、[diff をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。ディープクラウドレビューの場合は、[`/code-review ultra`](/docs/ja/ultrareview) を使用してください。v2.1.223 より前は、`/review` は GitHub プルリクエストの単一パス、読み取り専用レビューを実行する別のコマンドで、引数なしで実行すると開いている PR を一覧表示して選択できました。v2.1.186 ～ v2.1.201 では、`/code-review medium` と同じマルチエージェントエンジンを実行しました |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | [`/code-review`](/docs/ja/code-review#review-a-diff-locally) のエイリアス：現在の diff、または `/review 1234` などの渡す PR 番号、ブランチ、またはパスをレビューし、同じ努力レベルとフラグを取ります。レベルが指定されていない場合、レビューは最後に入力した `low` ～ `max` レベルを再利用します。正確なルールについては、[diff をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。ディープクラウドレビューの場合は、[`/code-review ultra`](/docs/ja/ultrareview) を使用してください。v2.1.223 より前は、`/review` は GitHub プルリクエストの単一パス、読み取り専用レビューを実行する別のコマンドで、引数なしで実行すると開いている PR を一覧表示して選択できました。v2.1.186 ～ v2.1.201 では、`/code-review medium` と同じマルチエージェントエンジンを実行しました |

137| `/rewind` | 会話またはコードを前の時点に巻き戻すか、選択したメッセージから要約します。[checkpointing](/docs/ja/checkpointing) を参照してください。エイリアス：`/checkpoint`、`/undo` |137| `/rewind` | 会話またはコードを前の時点に巻き戻すか、選択したメッセージから要約します。[checkpointing](/docs/ja/checkpointing) を参照してください。エイリアス：`/checkpoint`、`/undo` |

138| `/run` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトのアプリを起動して駆動し、テストに合格するだけでなく、変更が機能しているのを確認します。[アプリを実行して検証する](/docs/ja/skills#run-and-verify-your-app)を参照してください |138| `/run` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトのアプリを起動して駆動し、テストに合格するだけでなく、変更が機能しているのを確認します。[アプリを実行して検証する](/docs/ja/skills#run-and-verify-your-app)を参照してください |

967 967 

968CLI セッションを Desktop に移動するには、ターミナルで `/desktop` を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは、Claude サブスクリプションでサインインしている場合、macOS と x64 Windows で利用可能です。API キー認証、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。968CLI セッションを Desktop に移動するには、ターミナルで `/desktop` を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは、Claude サブスクリプションでサインインしている場合、macOS と x64 Windows で利用可能です。API キー認証、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。

969 969 

970シェルから、[`claude --desktop`](/docs/ja/cli-reference#cli-flags) は Desktop を直接開き、ターミナルセッションを開始しません。Claude Code v2.1.285 以降が必要で、`/desktop` と同じプラットフォームおよびサインイン要件があります。他の引数がない場合、現在のディレクトリで Desktop を開きます。既存の CLI セッションを Desktop で開くには、このディレクトリの最新の会話に対して `--continue` を追加するか、`/status` が表示するセッション ID で `--resume` を追加します：

971 

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975 

976Claude Code は `Opening session <session-id> in Claude Desktop` を出力し、セッションはアプリで開き、コマンドは終了します。セッション名は ID の代わりに機能しません。Claude Code は別のターミナルで開いているセッションや、バックグラウンドで実行中のセッションを移動しません。Claude Desktop がインストールされていない場合、コマンドはダウンロードリンクを出力して終了します。

977 

970Desktop 内から CLI セッションを再開することもできます。`/resume` を使用します。このコマンドはローカルセッションで利用可能で、SSH、WSL、またはクラウドセッションでは利用できません。978Desktop 内から CLI セッションを再開することもできます。`/resume` を使用します。このコマンドはローカルセッションで利用可能で、SSH、WSL、またはクラウドセッションでは利用できません。

971 979 

972Desktop でターミナルセッションを続行するには：980Desktop でターミナルセッションを続行するには：

192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーに対してオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーに対してオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |

193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分；最大：2147483647）。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分；最大：2147483647）。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |

194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 認証用の API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 認証用の API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |

195| `BASH_DEFAULT_TIMEOUT_MS` | Bash または PowerShell ツールコマンドのデフォルトタイムアウト（ミリ秒単位）（デフォルト：120000、または 2 分）。30 分より長いデフォルトは、バックグラウンドコマンドの [デフォルト時間制限](/docs/ja/tools-reference#background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |195| `BASH_DEFAULT_TIMEOUT_MS` | Bash または PowerShell ツールコマンドのデフォルトタイムアウト（ミリ秒単位）（デフォルト：120000、または 2 分）。30 分より長いデフォルトは、バックグラウンドコマンドの [デフォルト時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト：30000；最大：150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト：30000；最大：150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |

197| `BASH_MAX_TIMEOUT_MS` | モデルが Bash または PowerShell ツールコマンドに設定できる最大タイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分）。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です。有効な上限が 2 時間より長い場合、バックグラウンドコマンドの [最大時間制限](/docs/ja/tools-reference#background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |197| `BASH_MAX_TIMEOUT_MS` | モデルが Bash または PowerShell ツールコマンドに設定できる最大タイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分）。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です。有効な上限が 2 時間より長い場合、バックグラウンドコマンドの [最大時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |

198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) の OTLP エンドポイント：`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) の OTLP エンドポイント：`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートから複製する代わりにローカルリポジトリをバンドルしてアップロードするように強制するには `1` に設定します |199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートから複製する代わりにローカルリポジトリをバンドルしてアップロードするように強制するには `1` に設定します |

200| `CLAUDECODE` | Claude Code が生成するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。Claude Code が生成したサブプロセス内でスクリプトが実行されているかどうかを検出するために使用します。Claude Code が開始した stdio MCP サーバー内ではなく、ツール呼び出しまたはフックによって直接生成されたプロセスであるかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |200| `CLAUDECODE` | Claude Code が生成するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。Claude Code が生成したサブプロセス内でスクリプトが実行されているかどうかを検出するために使用します。Claude Code が開始した stdio MCP サーバー内ではなく、ツール呼び出しまたはフックによって直接生成されたプロセスであるかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

3657 Claude Desktop を開くことができませんでした3657 Claude Desktop を開くことができませんでした

3658</h3>3658</h3>

3659 3659 

3660[`/desktop`](/docs/ja/desktop#coming-from-the-cli)またはそのエイリアス `/app` を実行しましたが、Claude Desktop を開くために Claude Code が使用するシステムコマンドが失敗しました。セッションはターミナルに留まります。3660[`/desktop`](/docs/ja/desktop#coming-from-the-cli)またはそのエイリアス `/app` をセッションで実行しました。または [`claude --desktop`](/docs/ja/cli-reference#cli-flags)をシェルで実行しました。Claude Desktop を開くために Claude Code が使用するシステムコマンドが失敗しました。`/desktop` の後、セッションはターミナルに留まります。`claude --desktop` はメッセージを `Error:` プレフィックスなしで出力し、ステータス 1 で終了します。

3661 

3662括弧内のテキストは失敗したコマンドを示し、その終了ステータスと最初の行のエラー出力（生成された場合）を示します。macOS ではそのコマンドは `open` です。この例のように。Windows では `rundll32` です。

3661 3663 

3662```text theme={null}3664```text theme={null}

3663Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3665Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3664```3666```

3665 3667 

3666**対処方法：**3668**対処方法：**

3667 3669 

3668* Claude Desktop を自分で開いてから、`/desktop` を再度実行してください。3670* Claude Desktop を自分で開いてから、`/desktop` または `claude --desktop` を再度実行してください。

3669* そのコマンドの完全なエラー出力を読むには、`/debug` でデバッグログをオンにし、`/desktop` を再度実行してから、デバッグログを確認してください。3671* 失敗したコマンドの完全なエラー出力を読むには、`/debug` でデバッグログをオンにし、`/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認してください。

3670 3672 

3671v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかを言いませんでした。3673v2.1.285 より前は、メッセージは `Open Claude Desktop and run /desktop again.` で終わりました。v2.1.275 より前は、`Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかを言いませんでした。

3672 3674 

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3675<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup は Zed キーマップを変更しませんでした3676 /terminal-setup は Zed キーマップを変更しませんでした

346* Claude Code にコマンドをバックグラウンドで実行するよう指示する346* Claude Code にコマンドをバックグラウンドで実行するよう指示する

347* `Ctrl+B` を押して、通常の Bash ツール呼び出しをバックグラウンドに移動する。Tmux ユーザーは tmux のプリフィックスキーのため、`Ctrl+B` を 2 回押す必要があります。347* `Ctrl+B` を押して、通常の Bash ツール呼び出しをバックグラウンドに移動する。Tmux ユーザーは tmux のプリフィックスキーのため、`Ctrl+B` を 2 回押す必要があります。

348 348 

349コマンドが完了する前にタイムアウトに達した場合、Claude Code は自動的に[それをバックグラウンドに移動](/docs/ja/tools-reference#background-commands)します。停止する代わりにバックグラウンドに移動します。ただし、コマンドが `sleep` で始まる場合は除きます。コマンドが実行される時間を変更するには、[Bash タイムアウト環境変数](/docs/ja/tools-reference#timeout-and-output-limits)を設定してください。349コマンドが完了する前にタイムアウトに達した場合、Claude Code は自動的に[それをバックグラウンドに移動](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background)します。停止する代わりにバックグラウンドに移動します。ただし、コマンドが `sleep` で始まる場合は除きます。コマンドが実行される時間を変更するには、[Bash タイムアウト環境変数](/docs/ja/tools-reference#timeout-and-output-limits)を設定してください。

350 350 

351**主な機能：**351**主な機能：**

352 352 

358* macOS と Linux では、オペレーティングシステムが重大なメモリプレッシャーを報告する場合、Claude Code はバックグラウンドタスクを停止します。ただし、セッションが少なくとも 30 分間アイドル状態にあり、ターンまたはサブエージェントが実行されていない場合に限ります。Claude Code v2.1.193 以降が必要です358* macOS と Linux では、オペレーティングシステムが重大なメモリプレッシャーを報告する場合、Claude Code はバックグラウンドタスクを停止します。ただし、セッションが少なくとも 30 分間アイドル状態にあり、ターンまたはサブエージェントが実行されていない場合に限ります。Claude Code v2.1.193 以降が必要です

359 * [デバッグログ](/docs/ja/debug-your-config)には、タスクが停止された理由、またはプレッシャーイベントがそれらを実行し続けた理由が記載されています359 * [デバッグログ](/docs/ja/debug-your-config)には、タスクが停止された理由、またはプレッシャーイベントがそれらを実行し続けた理由が記載されています

360 * [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ja/env-vars)を `1` に設定して、メモリプレッシャー停止をオフにします360 * [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ja/env-vars)を `1` に設定して、メモリプレッシャー停止をオフにします

361* バックグラウンド Bash および PowerShell コマンドには時間制限があり、コマンドがバックグラウンドに入った時点から数えられます。30 分、またはコマンドがバックグラウンドで開始されるときに Claude が要求する `timeout`（最大 2 時間まで）。例えば `Ctrl+B` で実行中にバックグラウンドに移動するコマンドは、移動から 30 分を取得します。コマンドが制限に達すると、Claude Code はそれを停止し、Claude に理由を伝えます。Claude は、作業がまだ必要な場合、より長い `timeout` で再度開始できます。2 つの環境変数は制限をミリ秒単位で引き上げ、どちらも短縮することはできません。361* バックグラウンド Bash および PowerShell コマンドには時間制限があり、コマンドがバックグラウンドに入った時点から数えられます。30 分、またはコマンドがバックグラウンドで開始されるときに Claude が要求する `timeout`（最大 2 時間まで）。例えば `Ctrl+B` で実行中にバックグラウンドに移動するコマンドは、移動から 30 分を取得します。コマンドが制限に達すると、Claude Code はそれを停止し、Claude に理由を伝えます。Claude は、作業がまだ必要な場合、より長い `timeout` で再度開始できます。制限を引き上げるには、[バックグラウンドコマンドの時間制限を引き上げる](/docs/ja/tools-reference#raise-the-time-limit-for-background-commands)を参照してください。ツール参照を参照してください

362 * [`BASH_DEFAULT_TIMEOUT_MS`](/docs/ja/env-vars)を `1800000` より上に設定して、30 分のデフォルトをその値に置き換えます。移動されたコマンドにも適用されます362* フォアグラウンド[サブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)が開始したバックグラウンドコマンドは、そのサブエージェントの実行が終了するときに終了します。完了、失敗、または中断されたかどうかに関わらず。ツール参照の[バックグラウンドコマンドが停止するとき](/docs/ja/tools-reference#when-a-background-command-stops)を参照してください

363 * [`BASH_MAX_TIMEOUT_MS`](/docs/ja/env-vars)を `7200000` より上に設定して、2 時間の最大値を引き上げます。`BASH_DEFAULT_TIMEOUT_MS` を `7200000` より上に設定すると、同じ方法で引き上げられます

364* フォアグラウンド[サブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)が開始したバックグラウンドコマンドは、そのサブエージェントの実行が終了するときに終了します。完了、失敗、または中断されたかどうかに関わらず。ツール参照の[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands)を参照してください

365 363 

366すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。詳細は[環境変数](/docs/ja/env-vars)を参照してください。364すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。詳細は[環境変数](/docs/ja/env-vars)を参照してください。

367 365 

29すべてのサブコマンドは、これらの終了コード、プラグイン引数、およびスコープ値を共有します：29すべてのサブコマンドは、これらの終了コード、プラグイン引数、およびスコープ値を共有します：

30 30 

31* **終了コード**: 成功時は `0`、失敗時は `1`。`validate` は予期しないエラーに対して終了 `2` を追加し、`eval` は[そのセクション](#plugin-eval)にリストされたコードを追加します。31* **終了コード**: 成功時は `0`、失敗時は `1`。`validate` は予期しないエラーに対して終了 `2` を追加し、`eval` は[そのセクション](#plugin-eval)にリストされたコードを追加します。

32* **プラグイン引数**: `<plugin>` 引数はプラグイン `name` または `name@marketplace` です。2 つのマーケットプレイスが同じ名前を提供する場合は、修飾形式を使用してください。32* **プラグイン引数**: `<plugin>` 引数はプラグイン `name` または `name@marketplace` です。2 つのマーケットプレイスが同じ名前を提供する場合は、修飾形式を使用してください。`configure` は修飾形式のみを取ります。

33* **スコープ**: `--scope` は `user`、`project`、または `local` を取り、コマンドが書き込む設定ファイルに名前を付けます。`update` は `managed` も取ります。33* **スコープ**: `--scope` は `user`、`project`、または `local` を取り、コマンドが書き込む設定ファイルに名前を付けます。`update` は `managed` も取ります。

34 34 

35<h3 id="plugin-init">35<h3 id="plugin-init">

87| フラグ | 説明 |87| フラグ | 説明 |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | インストールスコープ: `user`、`project`、または `local`。デフォルトは `user` |89| `-s, --scope <scope>` | インストールスコープ: `user`、`project`、または `local`。デフォルトは `user` |

90| `--config <key=value>` | プラグインのマニフェストが宣言する [`userConfig`](/docs/ja/plugins/manifest-reference) オプションを設定します。各オプションについてフラグを繰り返します。Claude Code v2.1.147 以降が必要です |90| `--config <key=value>` | プラグインのマニフェストが宣言する [`userConfig`](/docs/ja/plugins/manifest-reference) オプションを設定します。各オプションについてフラグを繰り返します。Claude Code v2.1.147 以降が必要です。`<server>.<key>` として書かれたキーは、プラグイン内に同梱されたバンドルファイルの[バンドル MCP サーバー](/docs/ja/plugins/components#include-a-packaged-mcpb-server)が独自の `user_config` で宣言する設定を設定します。`<server>.<key>` 形式には Claude Code v2.1.285 以降が必要です |

91| `-y, --yes` | `Run this command now?` プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です |91| `-y, --yes` | `Run this command now?` プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です |

92| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持つ表示されたインストールコマンドを受け入れます。`-y` の代わりに使用します。`-y` と組み合わせることはできません。[表示されたインストールコマンドを受け入れる](#accept-a-displayed-install-command)を参照してください。Claude Code v2.1.271 以降が必要です |92| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持つ表示されたインストールコマンドを受け入れます。`-y` の代わりに使用します。`-y` と組み合わせることはできません。[表示されたインストールコマンドを受け入れる](#accept-a-displayed-install-command)を参照してください。Claude Code v2.1.271 以降が必要です |

93| `--json` | スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。[JSON 結果形式](#plugin-json-result)を参照してください。Claude Code v2.1.268 以降が必要です |93| `--json` | スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。[JSON 結果形式](#plugin-json-result)を参照してください。Claude Code v2.1.268 以降が必要です |

293| :- | :- |293| :- | :- |

294| `--json` | リストを JSON として出力 |294| `--json` | リストを JSON として出力 |

295| `--available` | マーケットプレイスが提供するがインストールしていないプラグインもリストします。`--json` なしでは効果がありません |295| `--available` | マーケットプレイスが提供するがインストールしていないプラグインもリストします。`--json` なしでは効果がありません |

296| `--data-size [plugin]` | 各インストール済みプラグインの[保存されたデータディレクトリ](#what-an-uninstall-deletes-and-keeps)を測定するか、`name@marketplace` として指定された名前付きプラグインのみを測定します。`--json` なしでは効果がありません。名前にインストールレコードがない場合、コマンドは `--data-size names a plugin that is not installed` を出力し、リストの代わりに `1` で終了します。Claude Code v2.1.285 以降が必要です |

296 297 

297Claude Code は、各プラグインがどのようにロードされるかでグループ化された人間が読める出力を出力します：298Claude Code は、各プラグインがどのようにロードされるかでグループ化された人間が読める出力を出力します：

298 299 

324| `notes` | 文字列の配列 | ロードして機能するプラグインのオーサリング警告 |325| `notes` | 文字列の配列 | ロードして機能するプラグインのオーサリング警告 |

325| `errorDetails` | オブジェクトの配列 | 各 `errors` エントリごとに 1 つのオブジェクト。診断 `type` と、プラグイン、マーケットプレイス、サーバー、またはファイルなど、それが参照する名前を提供します。Claude Code v2.1.268 以降が必要です |326| `errorDetails` | オブジェクトの配列 | 各 `errors` エントリごとに 1 つのオブジェクト。診断 `type` と、プラグイン、マーケットプレイス、サーバー、またはファイルなど、それが参照する名前を提供します。Claude Code v2.1.268 以降が必要です |

326| `noteDetails` | オブジェクトの配列 | 各 `notes` エントリの同じ詳細オブジェクト。Claude Code v2.1.268 以降が必要です |327| `noteDetails` | オブジェクトの配列 | 各 `notes` エントリの同じ詳細オブジェクト。Claude Code v2.1.268 以降が必要です |

328| `hasUserConfig` | ブール値 | プラグインがロードされ、そのマニフェストが [`userConfig` オプション](/docs/ja/plugins/manifest-reference#user-configuration)を宣言する場合に存在し、`true`。ロードに失敗したプラグインの場合は存在しません。マニフェストが何を宣言しても。保存された値は含まれません。Claude Code v2.1.285 以降が必要です |

329| `projectEnabled` | ブール値 | プロジェクトの共有 `.claude/settings.json` がプラグインをオンにするかどうか。マーケットプレイスインストールのみ。Claude Code v2.1.285 以降が必要です |

330| `dataDirSize` | オブジェクト | `--data-size` を使用すると、プラグインの[保存されたデータディレクトリ](#what-an-uninstall-deletes-and-keeps)のサイズが `bytes` および `human` として表示されます。ディレクトリが見つからないか空の場合は存在しません。マーケットプレイスインストールのみ。Claude Code v2.1.285 以降が必要です |

331| `dataDirUnreadable` | ブール値 | `--data-size` を使用すると、保存されたデータディレクトリが存在するが測定できない場合は `true`。マーケットプレイスインストールのみ。Claude Code v2.1.285 以降が必要です |

327 332 

328`--json --available` を使用すると、Claude Code は配列の代わりに 1 つのオブジェクトを出力します。その `installed` フィールドはインストール済みプラグインオブジェクトの配列を保持し、その `available` フィールドはインストールされていない各マーケットプレイスプラグインを以下のフィールドを持つオブジェクトとして保持します。333`--json --available` を使用すると、Claude Code は配列の代わりに 1 つのオブジェクトを出力します。その `installed` フィールドはインストール済みプラグインオブジェクトの配列を保持し、その `available` フィールドはインストールされていない各マーケットプレイスプラグインを以下のフィールドを持つオブジェクトとして保持します。

329 334 

367 372 

368ロードされていないプラグインの場合、Claude Code は ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` を出力し、`1` で終了します。373ロードされていないプラグインの場合、Claude Code は ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` を出力し、`1` で終了します。

369 374 

375<h3 id="plugin-configure">

376 plugin configure

377</h3>

378 

379インストール済みプラグインの [`userConfig`](/docs/ja/plugins/manifest-reference#user-configuration) オプションを表示し、どれが設定されているか、または stdin でパイプされた値を保存します。Claude Code v2.1.285 以降が必要です。

380 

381```bash theme={null}

382claude plugin configure <plugin>

383```

384 

385| フラグ | 説明 |

386| :- | :- |

387| `--values-stdin` | stdin から JSON オブジェクトとしてオプション値を読み込み、保存します。省略したオプションは保存された値を保持します |

388| `--json` | stdout に 1 つの JSON オブジェクトとして結果を出力します。`--values-stdin` なしで、オブジェクトはオプションの `schema` と `choices`、開始 `inputs`、および `configured` と `unconfigured` オプション名を含みます。`--values-stdin` を使用すると、`saved` オプション名と、読み込める場合は `unconfigured` オプション名を含みます |

389 

390フラグなしで、コマンドは各オプションを最大 3 つのラベルでリストします：`required` または `optional`、その後マニフェストが機密として宣言するオプションの場合は `sensitive`、その後 `set` または `not set`。保存された値は出力されません。`--json` を使用すると、出力には機密でないオプションの保存された値が含まれ、機密オプションのテキストは含まれません。

391 

392値を保存するには、JSON オブジェクトとしてファイルに書き込み、オプションキーを文字列値にマップし、ファイルを stdin で渡します。`formatter@my-marketplace` を `claude plugin list` が表示するプラグインの id に置き換えます。この例は、`{"api_url": "https://example.com"}` を含むファイル `values.json` から `api_url` という名前の 1 つのオプションを設定します：

393 

394```bash theme={null}

395claude plugin configure formatter@my-marketplace --values-stdin < values.json

396```

397 

398Claude Code は各値をオプションの宣言された型に対して検証し、`Configuration saved. Restart Claude Code to apply it.` を出力します。マニフェストが宣言しないキーを渡すか、検証に失敗する値を渡す場合、コマンドは何も保存せず、`Failed to save configuration:` を理由と共に出力し、`1` で終了します。`--json` を使用すると、拒否された値は `message` を含む `refused` フィールドを持つ stdout のオブジェクトも出力し、1 つのオプションが原因の場合はその `option` キーを含みます。

399 

400`claude plugin list` が表示するプラグインの完全な `name@marketplace` id を渡します。`configure` はベア `name` を受け入れません。ロードされたプラグインにそのような id がない場合、コマンドは `No installed plugin has the id "<plugin>".` を出力し、`1` で終了します。

401 

402バンドル MCP サーバーの設定については、[`plugin install --config`](#plugin-install) または `/plugin` の **Configure** 項目を参照してください。

403 

370<h3 id="plugin-prune">404<h3 id="plugin-prune">

371 plugin prune405 plugin prune

372</h3>406</h3>

868 868 

869サーバーはバンドルのマニフェストの `name` からその名前を取ります。869サーバーはバンドルのマニフェストの `name` からその名前を取ります。

870 870 

871バンドルのマニフェスト自体は、サーバーがユーザーから必要とする設定を `user_config` ブロックで宣言できます。保存された値がない必須設定を持つバンドルされたサーバーは開始されません。`/plugin` **Errors** タブは `Bundled MCP server "<name>" was not started: it needs configuration` を表示します。

872 

873ユーザーは 2 つの方法のいずれかで値を提供します。

874 

875* **`/plugin` で**: **Installed** タブでプラグインを選択し、**Configure** を選択します。

876* **インストール時、シェルから**: `claude plugin install` に [`--config <server>.<key>=<value>`](/docs/ja/plugins/cli-reference#plugin-install) を渡します。Claude Code v2.1.285 以降が必要で、プラグイン内にパッケージ化されたバンドルに対してのみ機能します。

877 

871トランスポートと認証については、[MCP](/docs/ja/mcp#plugin-provided-mcp-servers) を参照してください。878トランスポートと認証については、[MCP](/docs/ja/mcp#plugin-provided-mcp-servers) を参照してください。

872 879 

873<h3 id="lsp-servers">880<h3 id="lsp-servers">

1071 設定ダイアログが表示されるとき1078 設定ダイアログが表示されるとき

1072</h3>1079</h3>

1073 1080 

1074ダイアログは対話型の `/plugin` インターフェースにのみ表示されます。ユーザーが以下のいずれかを実行したときに、まだ設定されていないオプションに対して開きます。1081ダイアログは対話型の `/plugin` インターフェースの一部です。ユーザーが以下のいずれかを実行したときに、まだ設定されていないオプションに対して開きます。

1075 1082 

1076* `/plugin` でプラグインをインストールする1083* `/plugin` でプラグインをインストールする

1077* セッション内で `/plugin install <plugin>@<marketplace>` を実行する1084* セッション内で `/plugin install <plugin>@<marketplace>` を実行する

1079 1086 

1080ユーザーがいつでも同じダイアログを開くには、`/plugin configure <plugin>@<marketplace>` を実行します。1087ユーザーがいつでも同じダイアログを開くには、`/plugin configure <plugin>@<marketplace>` を実行します。

1081 1088 

1082`claude plugin install` シェルコマンドは `userConfig` 値のプロンプトを表示しません。シェルから値を設定するには、各値を `--config KEY=VALUE` として渡します。オプションが設定されていない場合、コマンドは `userConfig options not yet set` という行を出力し、それらを設定する両方の方法を示します。[`userConfig` ダイアログが表示されない](/docs/ja/plugins/troubleshooting#the-userconfig-dialog-never-appears)場合、その行が引用されます。1089VS Code 拡張機能の [プラグイン管理ダイアログ](/docs/ja/vs-code#install-plugins)は、インストール後にフォームとして未設定のオプションを求め、プラグインの行のギアアイコンはすべてのオプションを含むフォームを再度開きます。

1090 

1091`claude plugin install` シェルコマンドは `userConfig` 値のプロンプトを表示しません。シェルから値を設定するには、インストール時に各値を `--config KEY=VALUE` として渡すか、その後 [`claude plugin configure --values-stdin`](/docs/ja/plugins/cli-reference#plugin-configure) にJSON オブジェクトをパイプします。

1092 

1093オプションが設定されていない場合、`claude plugin install` は `userConfig options not yet set` という行を出力します。その行の正確なテキストについては、[`userConfig` ダイアログが表示されない](/docs/ja/plugins/troubleshooting#the-userconfig-dialog-never-appears)を参照してください。

1083 1094 

1084オプションフィールド、各値が保存される場所、コンポーネントが保存された値を参照する方法、および `${user_config.*}` を拒否するフィールドについては、[ユーザー設定](/docs/ja/plugins/manifest-reference#user-configuration)を参照してください。1095オプションフィールド、各値が保存される場所、コンポーネントが保存された値を参照する方法、および `${user_config.*}` を拒否するフィールドについては、[ユーザー設定](/docs/ja/plugins/manifest-reference#user-configuration)を参照してください。

1085 1096 

72 概要の最後の文は、このセッションでプラグインが使用可能かどうかを示しています。72 概要の最後の文は、このセッションでプラグインが使用可能かどうかを示しています。

73 73 

74 * **Active now**: `Plugin is now active.` リロードは不要です。74 * **Active now**: `Plugin is now active.` リロードは不要です。

75 * **Active, but a server needs setup**: `Plugin is now active.` の後に `Its bundled MCP server needs configuration before it can start` が続きます。プラグインの[バンドルされた MCP サーバー](/docs/ja/plugins/components#include-a-packaged-mcpb-server)は、オプションを設定するまで開始できません。`/plugin` の **Installed** タブでプラグインを選択し、**Configure** を選択してサーバーのオプションを設定します。

75 * **Reload needed**: `Run /reload-plugins to activate.` パネルが閉じ、Claude Code がそのリロードを実行します。リロードが[プロンプトキャッシュを無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する場合、警告が表示され、代わりにプラグインは保留中のままになります。`/reload-plugins --force` を実行してアクティブ化すると、キャッシュされていない 1 つのリクエストがかかります。76 * **Reload needed**: `Run /reload-plugins to activate.` パネルが閉じ、Claude Code がそのリロードを実行します。リロードが[プロンプトキャッシュを無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する場合、警告が表示され、代わりにプラグインは保留中のままになります。`/reload-plugins --force` を実行してアクティブ化すると、キャッシュされていない 1 つのリクエストがかかります。

76 * **Load failed**: `The plugin couldn't be loaded`。`/plugin` の **Errors** タブを開いて理由を確認し、[インストール後: プラグインが機能しない](/docs/ja/plugins/troubleshooting#plugin-installed-but-not-working)を参照してください。77 * **Load failed**: `The plugin couldn't be loaded`。`/plugin` の **Errors** タブを開いて理由を確認し、[インストール後: プラグインが機能しない](/docs/ja/plugins/troubleshooting#plugin-installed-but-not-working)を参照してください。

77 </Step>78 </Step>

288 289 

289* 入力して名前または説明でフィルタリングします。290* 入力して名前または説明でフィルタリングします。

290* **Space** を押して選択したプラグインを有効化または無効化し、**f** でお気に入りにします。291* **Space** を押して選択したプラグインを有効化または無効化し、**f** でお気に入りにします。

291* **Enter** を押してプラグインの詳細を開きます。そこのメニューは **Disable plugin** または **Enable plugin**、**Update now**、および **Uninstall** を提供します。設定を取得するプラグインは **Configure options** も提供します。292* **Enter** を押してプラグインの詳細を開きます。

293 

294プラグインの詳細メニューは **Disable plugin** または **Enable plugin**、**Update now**、および **Uninstall** を提供します。設定を取得するプラグインには 2 つの追加項目が表示され、プラグインは両方を表示できます。

295 

296* **Configure options**: プラグインのマニフェストが [`userConfig` オプション](/docs/ja/plugins/manifest-reference#user-configuration)を宣言するときに表示されます。これらのオプションのダイアログを開きます

297* **Configure**: プラグインが[バンドルされた MCP サーバー](/docs/ja/plugins/components#include-a-packaged-mcpb-server)を含むときに表示されます。そのサーバー自体の `user_config` 設定を設定します

292 298 

293タブは **Managed** スコープのプラグインも表示できます。組織は [管理設定](/docs/ja/settings#settings-files)を通じてそれらをインストールし、ここでそれらを有効化、無効化、またはアンインストールすることはできません。299タブは **Managed** スコープのプラグインも表示できます。組織は [管理設定](/docs/ja/settings#settings-files)を通じてそれらをインストールし、ここでそれらを有効化、無効化、またはアンインストールすることはできません。

294 300 

201 201 

202成功した追加は `Successfully added marketplace: <name>` を出力します。202成功した追加は `Successfully added marketplace: <name>` を出力します。

203 203 

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207 

208マーケットプレイスを追加したか、プラグインをインストールしたか、git アドレスから更新を実行し、コマンドが `Invalid git URL` で失敗しました。

209 

210Claude Code は git アドレスを実行する前にすべてのチェックを行います。サポートしていないプロトコルを持つアドレスを拒否します。また、git がアドレスが示すものとは異なるサーバーまたはフォルダに名前を付けるとして読むことができるアドレスも拒否します。

211 

212アドレスの後のテキストは、変更する内容を名前付けします。メッセージが言うようにアドレスを書き直し、コマンドを再度実行してください。

213 

214代わりに `is blocked by enterprise policy` と言う拒否は、組織の設定から来ています。[マーケットプレイスソースはエンタープライズポリシーによってブロックされています](#marketplace-source-is-blocked-by-enterprise-policy)を参照してください。

215 

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>

410 422 

411シェルで `claude plugin install` は別のメッセージを出力します。ターゲットスコープで既にインストールされているプラグインの場合、`Plugin "<name>@<marketplace>" is already installed (scope: user)` を出力して終了 0 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。423シェルで `claude plugin install` は別のメッセージを出力します。ターゲットスコープで既にインストールされているプラグインの場合、`Plugin "<name>@<marketplace>" is already installed (scope: user)` を出力して終了 0 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。

412 424 

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428 

429`claude plugin install`、`/plugin`、またはセッション内のインストール提案を通じてプラグインをインストールし、Claude Code はこの行で拒否しました。または、`would share its saved data with` で拒否しました。

430 

431拒否されたプラグインの id と、インストールされたプラグインの id はディスク上の同じフォルダにマップされます。`.` と `@` が `-` として書き込まれると、それらは同じです。macOS と Windows では、大文字のみが異なる id も同じフォルダにマップされます。両方をインストールすると、1 つのプラグインのファイルが他のプラグインのフォルダに入るため、Claude Code は拒否し、インストールされたプラグインはそのファイルを保持します。

432 

433メッセージは方法を名前付けします：

434 

435* **他のプラグインがインストールされている**：メッセージは `Only one of the two can be installed.` と言い、`claude plugin uninstall` コマンド、または `/plugin` のアンインストール手順を名前付けします。それを実行し、再度インストールしてください。アンインストールが削除するものについては、[アンインストールが削除して保持するもの](/docs/ja/plugins/cli-reference#what-an-uninstall-deletes-and-keeps)を参照してください。

436* **両方の id が 1 つのインストールで到着する**。例えば、プラグインとそれが必要とする依存関係：インストール順序は役に立ちません。マーケットプレイスの 2 つのプラグインをリストしている保守者のみが、それらの 1 つの名前を変更することで修正できます。2 つが異なるマーケットプレイスから来る場合、どちらかの保守者が修正できます。

437 

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>

790* **`URL is unset or invalid`**: URL が使用する `${user_config.*}` オプションが設定されていません。`/plugin configure <plugin>` を実行して設定してください815* **`URL is unset or invalid`**: URL が使用する `${user_config.*}` オプションが設定されていません。`/plugin configure <plugin>` を実行して設定してください

791* **`has an invalid MCP url`** または **`headersHelper for MCP server '<server>' references ${user_config.*}`**: プラグイン自体の設定に問題があります。プラグインの MCP 設定で `url` または `headersHelper` を修正するか、プラグインがあなたのものでない場合はプラグインの作成者に報告してください。`headersHelper` の場合は、[プラグイン コマンドが user\_config を参照](/docs/ja/errors#plugin-command-references-user-config) の下に独自のエントリがあります816* **`has an invalid MCP url`** または **`headersHelper for MCP server '<server>' references ${user_config.*}`**: プラグイン自体の設定に問題があります。プラグインの MCP 設定で `url` または `headersHelper` を修正するか、プラグインがあなたのものでない場合はプラグインの作成者に報告してください。`headersHelper` の場合は、[プラグイン コマンドが user\_config を参照](/docs/ja/errors#plugin-command-references-user-config) の下に独自のエントリがあります

792 817 

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821 

822プラグインは、サーバーを [MCPB バンドル](/docs/ja/plugins/components#include-a-packaged-mcpb-server) として含めており、`user_config` を宣言し、必須の設定に保存された値がないか、保存された値がバンドル自体の検証に失敗しているため、Claude Code はサーバーの起動をスキップします。プラグインの残りは機能します。

823 

824`/plugin` の **Installed** タブでプラグインを選択し、**Configure** を選択して値を指定してください。保存した後、`/plugin` は `Configuration saved.` を表示して閉じ、Claude Code は [インストール済みプラグインの管理](/docs/ja/plugins/install#manage-installed-plugins) の下で説明されているようにプラグインをリロードします。そのリロードが適用されると、サーバーが起動します。v2.1.285 より前では、Claude Code はこの行を表示せずにサーバーをスキップしました。

825 

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 サーバーが設定されているが接続しない827 サーバーが設定されているが接続しない

795</h4>828</h4>

934 967 

935プラグインは `userConfig` オプションを宣言しますが、インストール時に設定ダイアログが表示されません。968プラグインは `userConfig` オプションを宣言しますが、インストール時に設定ダイアログが表示されません。

936 969 

937インタラクティブインストールはダイアログを表示し、シェルコマンドは代わりに値をフラグとして取得します：970インストール時に値を要求するかどうかは、それを実行する場所によって異なります：

938 971 

939* **セッションで `/plugin install`、または `/plugin` の Discover タブ**：ダイアログはこのインタラクティブインストールの一部です972* **セッションで `/plugin install`、または `/plugin` の Discover タブ**：ダイアログはこのインタラクティブインストールの一部です

973* **VS Code 拡張機能の Manage plugins ダイアログ**：インストール後に設定されていないオプションをフォームとして要求します。v2.1.285 より前では、そこでインストールしても設定オプションフォームが表示されなかったため、ターミナルセッションから `/plugin configure <plugin>@<marketplace>` で値を設定してください

940* **シェルで `claude plugin install`**：`userConfig` 値を要求しません。渡す `--config KEY=VALUE` 値を保存し、オプションが設定されたままの場合、`N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` を出力します。設定されていないオプションが必須の場合、`(M required)` は `not yet set` に従います。974* **シェルで `claude plugin install`**：`userConfig` 値を要求しません。渡す `--config KEY=VALUE` 値を保存し、オプションが設定されたままの場合、`N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` を出力します。設定されていないオプションが必須の場合、`(M required)` は `not yet set` に従います。

941 975 

942シェルからインストールした場合は、`--config` で値を渡してください。オプションごとに 1 つのフラグ：976シェルからインストールした場合は、`--config` で値を渡してください。オプションごとに 1 つのフラグ：

945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981 

948すべてのオプションが設定されている場合、インストール出力は `not yet set` 行を運びません。代わりに後でダイアログを開くには、セッションで `/plugin configure my-plugin@my-marketplace` を実行してください。982すべてのオプションが設定されている場合、インストール出力は `not yet set` 行を運びません。

983 

984代わりに後でダイアログを開くには、セッションで `/plugin configure my-plugin@my-marketplace` を実行してください。シェルから、[`claude plugin configure`](/docs/ja/plugins/cli-reference#plugin-configure)は設定されていないオプションを表示し、stdin でパイプされた値を保存します。Claude Code v2.1.285 以降が必要です。

949 985 

950マニフェストが宣言しない `--config` キーを渡す場合、プラグインはまだインストールされ、コマンドは `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` を出力し、その後にプラグインが宣言するキーが続きます。986マニフェストが宣言しない `--config` キーを渡す場合、プラグインはまだインストールされ、コマンドは `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` を出力し、その後にプラグインが宣言するキーが続きます。

951 987 

988[MCPB バンドルファイル](/docs/ja/plugins/components#include-a-packaged-mcpb-server)を配布するプラグインの場合、独自の `user_config` を宣言し、メッセージは `isn't declared in this plugin's userConfig or by its bundled MCP servers.` を代わりに読み込み、既知のキーはそのサーバーのキーを含み、`<server>.<key>` として書き込まれます。マニフェストが URL で参照するバンドルはインストール時に読み込まれないため、そのキーはリストされず、メッセージは `/plugin` で設定するように指示します。`<server>.<key>` キーを設定するには Claude Code v2.1.285 以降が必要です。

989 

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` がエラーを報告991 `claude plugin validate` がエラーを報告

954</h3>992</h3>

29 29 

30`claude --continue` は完了した [バックグラウンドセッション](/docs/ja/agent-view)を開きますが、実行中のセッションは開きません。完了したバックグラウンドセッションを開くには Claude Code v2.1.257 以降が必要です。最新の会話が [バックグラウンドに移動した](/docs/ja/agent-view#send-the-session-to-the-background)セッションで、そこで実行中の場合、Claude Code は `Your most recent conversation is running in the background` と終了し、そのセッションの ID を表示します。[`claude agents`](/docs/ja/agent-view#attach-to-a-session)からセッションにアタッチするか、`claude --resume` を実行して別のセッションを選択します。30`claude --continue` は完了した [バックグラウンドセッション](/docs/ja/agent-view)を開きますが、実行中のセッションは開きません。完了したバックグラウンドセッションを開くには Claude Code v2.1.257 以降が必要です。最新の会話が [バックグラウンドに移動した](/docs/ja/agent-view#send-the-session-to-the-background)セッションで、そこで実行中の場合、Claude Code は `Your most recent conversation is running in the background` と終了し、そのセッションの ID を表示します。[`claude agents`](/docs/ja/agent-view#attach-to-a-session)からセッションにアタッチするか、`claude --resume` を実行して別のセッションを選択します。

31 31 

32<span id="resume-a-running-background-session" />

33 

34`claude --resume` または `/resume` で再開する会話が、実行中の [バックグラウンドセッション](/docs/ja/agent-view)に属する場合、Claude Code は実行中のセッション自体を開きます。コマンドラインで `--bg` を使用すると、再開は [バックグラウンドディスパッチ](/docs/ja/agent-view#from-your-shell)になります。v2.1.285 より前は、Claude Code は拒否し、`claude attach <id>` でセッションを開くか、`claude stop <id>` で最初に停止するよう指示していました。

35 

36* **シェルから**：`claude --resume <session>` は、トランスクリプト自体を読み込む代わりに、同じターミナルでそのセッションに対して [`claude attach`](/docs/ja/agent-view#attach-to-a-session)を実行します。`claude --resume <session> "check the tests too"` のようにコマンドラインで渡すプロンプトは、最初にセッションの次のターンとして送信され、Claude Code は `Sent your prompt to the background session (<id>); opening it…` を出力してからアタッチします。ターミナルで入力した `claude -p --resume <session> "prompt"` も同じように動作するため、`-p` はその実行を非対話型に保ちません。

37 

38 Claude Code は、コマンドラインに以下のいずれかがある場合、セッションを開きません。

39 

40 * パイプまたはリダイレクトされた入力または出力

41 * `--permission-mode`、`--model`、`--settings` などのセッションを設定するフラグ

42 * `--output-format json` または `--json-schema` などの出力を読み込むフラグ

43 * `--max-turns` または `--max-budget-usd` などの実行を制限またはリワインドするフラグ

44 

45 これらのいずれかがある場合、または [エージェントビューがオフになっている](/docs/ja/agent-view#turn-off-agent-view)場合、Claude Code は何も送信せず、ステータス 1 で終了し、セッションがバックグラウンドで実行中であることを出力し、それを開く `claude attach <id>` コマンドを表示するか、ID を判定できない場合は `claude agents` で見つけるよう指示します。`--fork-session` を追加して、会話のコピーを再開します。セッション自体で会話を続行するには、フラグを適用して、`claude stop <id>` を実行してからコマンドを繰り返します。

46 

47 `/` または `!` で始まるプロンプトは送信されず、セッションが質問への回答を待っている間のプロンプトも送信されません。どちらの場合も Claude Code はセッションを開かず、メッセージには `Your prompt was not sent to it` と理由が含まれます。

48* **セッション内から**：`/resume` は現在の会話をバックグラウンドに移動し、このターミナルを実行中のセッションにアタッチし、`Opening "<title>", running in the background (<id>)` を出力します。空のプロンプトで `←` を押すとエージェントビューに戻ります。これは、残した会話もリストします。現在の会話がバックグラウンドに移動できない場合（例えば、バックグラウンドセッションにすでにアタッチしている場合、またはセッション永続性がオフの場合）、`/resume` は代わりに実行する `claude attach` コマンドを出力します。

49 

32任意のディレクトリから `claude --resume <session-id>` を実行できます。Claude Code は現在のプロジェクトディレクトリとその git worktrees でまず ID を検索し、次にこのマシン上の他のすべてのプロジェクトで検索するため、他の場所で開始されたセッションや [`/cd`](/docs/ja/commands)で移動したセッションを見つけます。クロスプロジェクト検索は、正確に 1 つの他のプロジェクトがそれのメッセージを含むトランスクリプトを保持している場合にのみ ID を解決するため、手動でコピーされた重複は Claude Code が見つからないと報告し、任意のコピーを再開するのではなく、見つかりません。保存されたセッションが ID と一致しない場合、Claude Code は `No conversation found with session ID: <session-id>` と報告します。v2.1.223 より前は、ルックアップは現在のプロジェクトディレクトリとその git worktrees で停止したため、セッションが最後に機能していたディレクトリから再開する必要がありました。50任意のディレクトリから `claude --resume <session-id>` を実行できます。Claude Code は現在のプロジェクトディレクトリとその git worktrees でまず ID を検索し、次にこのマシン上の他のすべてのプロジェクトで検索するため、他の場所で開始されたセッションや [`/cd`](/docs/ja/commands)で移動したセッションを見つけます。クロスプロジェクト検索は、正確に 1 つの他のプロジェクトがそれのメッセージを含むトランスクリプトを保持している場合にのみ ID を解決するため、手動でコピーされた重複は Claude Code が見つからないと報告し、任意のコピーを再開するのではなく、見つかりません。保存されたセッションが ID と一致しない場合、Claude Code は `No conversation found with session ID: <session-id>` と報告します。v2.1.223 より前は、ルックアップは現在のプロジェクトディレクトリとその git worktrees で停止したため、セッションが最後に機能していたディレクトリから再開する必要がありました。

33 51 

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 再開されたセッションが復元するもの53 再開されたセッションが復元するもの

36</h3>54</h3>

37 55 

38再開されたセッションは、会話とそれに保存された状態を復元します。56Claude Code がトランスクリプトから会話を読み込むと、再開されたセッションは会話とそれに保存された状態を復元します。

39 57 

40* 会話履歴：ツール呼び出しと結果を含む完全な履歴。前のプロセスが終了したときに実行中だったツール（例えばクラッシュ）は、再開時に完了または再実行されません。Claude はその呼び出しが結果が記録される前に切断されたとマークされているのを見て、再度実行する前に有効になったかどうかを確認するよう指示されます。ただし、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables)が設定されている場合は除きます。v2.1.281 より前は、Claude Code は切断された呼び出しを会話から削除するか、中断したものとして Claude に表示していました。58* 会話履歴：ツール呼び出しと結果を含む完全な履歴。前のプロセスが終了したときに実行中だったツール（例えばクラッシュ）は、再開時に完了または再実行されません。Claude はその呼び出しが結果が記録される前に切断されたとマークされているのを見て、再度実行する前に有効になったかどうかを確認するよう指示されます。ただし、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables)が設定されている場合は除きます。v2.1.281 より前は、Claude Code は切断された呼び出しを会話から削除するか、中断したものとして Claude に表示していました。

41* モデル：セッションは使用していたモデルで続行されます。モデルが廃止されたか `availableModels` で許可されていない場合、`--model` フラグまたは `ANTHROPIC_MODEL` ファミリー環境変数が起動時に 1 つを選択する場合、または [Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)などのプロバイダー固有のデプロイ ID を使用するプロバイダーの場合は復元されません。[モデル設定](/docs/ja/model-config#setting-your-model)の解決順序を参照してください。59* モデル：セッションは使用していたモデルで続行されます。モデルが廃止されたか `availableModels` で許可されていない場合、`--model` フラグまたは `ANTHROPIC_MODEL` ファミリー環境変数が起動時に 1 つを選択する場合、または [Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)などのプロバイダー固有のデプロイ ID を使用するプロバイダーの場合は復元されません。[モデル設定](/docs/ja/model-config#setting-your-model)の解決順序を参照してください。

51 再開時の権限モード69 再開時の権限モード

52</h4>70</h4>

53 71 

54再開されたセッションが開始される権限モードは、再開方法によって異なります。72再開されたセッションが開始される権限モードは、再開方法によって異なります。以下の場合は、Claude Code がトランスクリプトから会話を読み込むときに適用されます。[実行中のバックグラウンドセッションを開く](#resume-a-running-background-session)場合、そのセッションは存在する権限モードを保持します。

55 73 

56* ターミナル：`claude --continue`、`claude --resume <session-id>`、または `claude --resume <name>`（名前が 1 つのセッションと一致する場合）で `-p` なし。Claude Code はセッションが存在していた権限モードを復元します。ただし、表の場合は除きます。`--permission-mode` または `--dangerously-skip-permissions` を渡して復元されたモードをオーバーライドします。74* ターミナル：`claude --continue`、`claude --resume <session-id>`、または `claude --resume <name>`（名前が 1 つのセッションと一致する場合）で `-p` なし。Claude Code はセッションが存在していた権限モードを復元します。ただし、表の場合は除きます。`--permission-mode` または `--dangerously-skip-permissions` を渡して復元されたモードをオーバーライドします。

57* 非対話型：`claude -p --resume` または `claude -p --continue`。Claude Code は新しい `claude -p` 実行が開始される権限モードで実行を開始します。ただし、プランモードで終了したセッションは [以下の条件](#resume-in-plan-mode-with-p)下でプランモードで再開されます。75* 非対話型：`claude -p --resume` または `claude -p --continue`。Claude Code は新しい `claude -p` 実行が開始される権限モードで実行を開始します。ただし、プランモードで終了したセッションは [以下の条件](#resume-in-plan-mode-with-p)下でプランモードで再開されます。

740 740 

741* **作業ディレクトリ**：Claude Code は各コマンドをセッションシェルの現在の作業ディレクトリで実行します。Claude が `cd` を実行するとそのディレクトリが移動します。毎回同じ方法で解決する必要があるパスで [`${CLAUDE_SKILL_DIR}` または `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) を使用します。741* **作業ディレクトリ**：Claude Code は各コマンドをセッションシェルの現在の作業ディレクトリで実行します。Claude が `cd` を実行するとそのディレクトリが移動します。毎回同じ方法で解決する必要があるパスで [`${CLAUDE_SKILL_DIR}` または `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) を使用します。

742* **stderr**：デフォルトの `bash` シェルでは、Claude Code は stderr を stdout にマージします。コマンドが stderr に書き込むすべてのものが注入されたテキストに表示されます。742* **stderr**：デフォルトの `bash` シェルでは、Claude Code は stderr を stdout にマージします。コマンドが stderr に書き込むすべてのものが注入されたテキストに表示されます。

743* **タイムアウト**：各コマンドは Bash ツールのデフォルト 2 分 [timeout](/docs/ja/tools-reference#timeout-and-output-limits) の下で実行されます。Bash ツールが [タイムアウトしたコマンドをバックグラウンドに移動](/docs/ja/tools-reference#background-commands) する場合、スキルは引き続きレンダリングされます。注入されたテキストは移動を報告し、バックグラウンドタスクとコマンドの出力を収集するファイルに名前を付けます。コマンドが Bash ツールが自動的にバックグラウンドに移動しないコマンドの場合、Claude Code はタイムアウト時にそれを強制終了します。その失敗は [呼び出しを中止します](#when-an-injected-command-fails)。743* **タイムアウト**：各コマンドは Bash ツールのデフォルト 2 分 [timeout](/docs/ja/tools-reference#timeout-and-output-limits) の下で実行されます。Bash ツールが [タイムアウトしたコマンドをバックグラウンドに移動](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background) する場合、スキルは引き続きレンダリングされます。注入されたテキストは移動を報告し、バックグラウンドタスクとコマンドの出力を収集するファイルに名前を付けます。コマンドが Bash ツールが自動的にバックグラウンドに移動しないコマンドの場合、Claude Code はタイムアウト時にそれを強制終了します。その失敗は [呼び出しを中止します](#when-an-injected-command-fails)。

744* **出力サイズ**：Bash ツールのインライン上限を超える出力は、切り詰められたテキストではなく、ファイルパスと短いプレビューとして到着します。[出力制限](/docs/ja/tools-reference#output-limits) は上限とそれぞれの境界を調整する方法をカバーしています。744* **出力サイズ**：Bash ツールのインライン上限を超える出力は、切り詰められたテキストではなく、ファイルパスと短いプレビューとして到着します。[出力制限](/docs/ja/tools-reference#output-limits) は上限とそれぞれの境界を調整する方法をカバーしています。

745 745 

746PowerShell ツールは、実行するコマンドに同じタイムアウト、バックグラウンド処理、および出力上限の動作を適用します。その詳細については、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) セクションを参照してください。746PowerShell ツールは、実行するコマンドに同じタイムアウト、バックグラウンド処理、および出力上限の動作を適用します。その詳細については、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) セクションを参照してください。

20以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する [複数行ステータスライン](#display-multiple-lines) の例です。20以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する [複数行ステータスライン](#display-multiple-lines) の例です。

21 21 

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25 

26このページでは、[基本的なステータスラインの設定](#set-up-a-status-line) について説明し、Claude Code からスクリプトへの [データフロー](#how-status-lines-work) について説明し、[表示できるすべてのフィールド](#available-data) をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの [すぐに使える例](#examples) を提供します。26このページでは、[基本的なステータスラインの設定](#set-up-a-status-line) について説明し、Claude Code からスクリプトへの [データフロー](#how-status-lines-work) について説明し、[表示できるすべてのフィールド](#available-data) をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの [すぐに使える例](#examples) を提供します。

93これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、[Windows 設定](#windows-configuration) で PowerShell と Git Bash の例を参照してください。93これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、[Windows 設定](#windows-configuration) で PowerShell と Git Bash の例を参照してください。

94 94 

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="モデル名、ディレクトリ、コンテキスト割合を表示するステータスライン" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="モデル名、ディレクトリ、コンテキスト割合を表示するステータスライン" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98 

99<Steps>99<Steps>

444現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、`used_percentage` フィールドを抽出し、塗りつぶされたブロック（▓）が使用状況を表す 10 文字のバーを構築します：444現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、`used_percentage` フィールドを抽出し、塗りつぶされたブロック（▓）が使用状況を表す 10 文字のバーを構築します：

445 445 

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="モデル名とパーセンテージ付きプログレスバーを表示するステータスライン" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="モデル名とパーセンテージ付きプログレスバーを表示するステータスライン" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449 

450<CodeGroup>450<CodeGroup>

513ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に [ANSI エスケープコード](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) を使用します：`\033[32m` は緑、`\033[33m` は黄、`\033[0m` はデフォルトにリセットします。513ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に [ANSI エスケープコード](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) を使用します：`\033[32m` は緑、`\033[33m` は黄、`\033[0m` はデフォルトにリセットします。

514 514 

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="モデル、ディレクトリ、git ブランチ、ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを表示するステータスライン" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="モデル、ディレクトリ、git ブランチ、ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを表示するステータスライン" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518 

519各スクリプトは現在のディレクトリが git リポジトリであるかどうかを確認し、ステージングされたファイルと変更されたファイルをカウントし、カラーコード化されたインジケーターを表示します：519各スクリプトは現在のディレクトリが git リポジトリであるかどうかを確認し、ステージングされたファイルと変更されたファイルをカウントし、カラーコード化されたインジケーターを表示します：

611各スクリプトはコストを通貨としてフォーマットし、ミリ秒を分と秒に変換します：611各スクリプトはコストを通貨としてフォーマットし、ミリ秒を分と秒に変換します：

612 612 

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="モデル名、セッションコスト、期間を表示するステータスライン" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="モデル名、セッションコスト、期間を表示するステータスライン" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616 

617<CodeGroup>617<CodeGroup>

672スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。672スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。

673 673 

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677 

678この例は複数のテクニックを組み合わせています：閾値ベースの色（70% 未満は緑、70～89% は黄、90% 以上は赤）、プログレスバー、git ブランチ情報。各 `print` または `echo` ステートメントは別の行を作成します：678この例は複数のテクニックを組み合わせています：閾値ベースの色（70% 未満は緑、70～89% は黄、90% 以上は赤）、プログレスバー、git ブランチ情報。各 `print` または `echo` ステートメントは別の行を作成します：

781この例は GitHub リポジトリへのクリック可能なリンクを作成します。Cmd（macOS）または Ctrl（Windows/Linux）を押しながらクリックして、ブラウザでリンクを開きます。781この例は GitHub リポジトリへのクリック可能なリンクを作成します。Cmd（macOS）または Ctrl（Windows/Linux）を押しながらクリックして、ブラウザでリンクを開きます。

782 782 

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="GitHub リポジトリへのクリック可能なリンクを表示するステータスライン" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="GitHub リポジトリへのクリック可能なリンクを表示するステータスライン" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786 

787各スクリプトは git リモート URL を取得し、SSH 形式を HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Bash バージョンは `printf '%b'` を使用します。これはバックスラッシュエスケープを異なるシェル間でより確実に解釈します：787各スクリプトは git リモート URL を取得し、SSH 形式を HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Bash バージョンは `printf '%b'` を使用します。これはバックスラッシュエスケープを異なるシェル間でより確実に解釈します：

362 362 

363プラグインタブでは、以下のことができます。363プラグインタブでは、以下のことができます。

364 364 

365* **インストール済みプラグイン**がトップに表示され、トグルスイッチで有効または無効にできます365* **インストール済みプラグイン**がトップに表示され、トグルスイッチで有効または無効にできます。

366 * プロジェクトの共有 `.claude/settings.json` で有効になっているプラグインをオフにすると、拡張機能は最初に確認を求めます。**自分のみ無効にする**はあなただけのためにオフにし、**全員のために無効にする**は共有ファイルを変更します。

366* 設定されたマーケットプレイスからの**利用可能なプラグイン**が下に表示されます367* 設定されたマーケットプレイスからの**利用可能なプラグイン**が下に表示されます

367* 名前または説明でプラグインをフィルタリングするために検索します368* 名前または説明でプラグインをフィルタリングするために検索します

368* 利用可能なプラグインの**インストール**をクリックします369* 利用可能なプラグインの**インストール**をクリックします

373* **このプロジェクトのためにインストール**：プロジェクト協力者と共有（プロジェクトスコープ）374* **このプロジェクトのためにインストール**：プロジェクト協力者と共有（プロジェクトスコープ）

374* **ローカルにインストール**：このリポジトリのみ、あなただけ（ローカルスコープ）375* **ローカルにインストール**：このリポジトリのみ、あなただけ（ローカルスコープ）

375 376 

377インストールが完了すると、フォームはまだ設定されていないプラグインの[設定オプション](/docs/ja/plugins/components#user-configuration)を求めます。後でオプションを確認または変更するには、プラグインの行の歯車アイコンをクリックします。

378 

379機密テキストフィールドはマスクされ、以前保存したシークレットは\*\*（変更なし）\*\*と表示されます。保存された値を保持するには、フィールドを空白のままにします。

380 

381変更を保存した後、開いているセッションはプラグインをリロードし、ダイアログは**プラグイン変更を適用するために Claude を再起動してください**と表示します。

382 

383<h3 id="uninstall-plugins">

384 プラグインをアンインストールする

385</h3>

386 

387各インストール済み行は、それがインストールされている[スコープ](/docs/ja/plugins/install#choose-an-install-scope)を示します。そのインストールをアンインストールするには、行のゴミ箱アイコンをクリックします。薄いゴミ箱アイコンは、このワークスペースからアンインストールできない行（組織が管理するプラグインや別のプロジェクト用にインストールされたプラグインなど）を示します。

388 

389拡張機能は 2 つのケースで最初に確認を求めます：

390 

391* **プロジェクトの共有 `.claude/settings.json` で有効になっているプラグイン**：**自分のみ無効にする**を選択します。これはプラグインを協力者のためにインストール状態に保ちます。または**全員のためにアンインストール**を選択します。これはプロジェクトのインストールを [`--keep-data`](/docs/ja/plugins/cli-reference#what-an-uninstall-deletes-and-keeps) で削除するため、プラグインの保存されたデータディレクトリは残ります。既にプラグインを自分のためにオフにしている場合、ゴミ箱アイコンは質問なしにあなた自身のインストールを削除します。

392* **それ以外の場合、保存されたデータを持つプラグインの最後のインストール**：データを保持するか削除するかを選択します。**保持**がデフォルトです

393 

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 プラグインインストールリンクを共有する395 プラグインインストールリンクを共有する

378</h3>396</h3>

407 425 

408* GitHub リポジトリ、URL、またはローカルパスを入力して、新しいマーケットプレイスを追加します426* GitHub リポジトリ、URL、またはローカルパスを入力して、新しいマーケットプレイスを追加します

409* 更新アイコンをクリックして、マーケットプレイスのプラグインリストを更新します427* 更新アイコンをクリックして、マーケットプレイスのプラグインリストを更新します

410* ゴミ箱アイコンをクリックして、マーケットプレイスを削除します428* ゴミ箱アイコンをクリックして、マーケットプレイスを削除します。削除すると[それからインストールしたすべてのプラグインがアンインストールされます](/docs/ja/plugins/install#manage-marketplaces)。そのため、確認ではそれらのプラグインが最初に名前で示されます

429 

430ダイアログで加えたプラグイン変更は、その VS Code ウィンドウで開いている Claude Code セッションにすぐに適用されます。

411 431 

412ダイアログで加えたプラグイン変更は、その VS Code ウィンドウで開いている Claude Code セッションにすぐに適用されます。ダイアログを開いたセッションがプラグインをリロードできない場合、ダイアログは再度試すか、そのセッションで Claude を再起動するオプションを提供します。432ダイアログを開いたセッションがプラグインをリロードできない場合、ダイアログは再度試すか、そのセッションで Claude を再起動するオプションを提供します。

413 433 

414<Note>434<Note>

415 VS Code のプラグイン管理は、内部的に同じ CLI コマンドを使用しています。拡張機能で設定したプラグインとマーケットプレイスは CLI でも利用でき、その逆も同様です。435 VS Code のプラグイン管理は、内部的に同じ CLI コマンドを使用しています。拡張機能で設定したプラグインとマーケットプレイスは CLI でも利用でき、その逆も同様です。