Documentation 2026-05-17 01:01 UTC to 2026-05-18 23:59 UTC

111SDK には Claude Code を支えるのと同じツールが含まれています。111SDK には Claude Code を支えるのと同じツールが含まれています。

112 112 

113| カテゴリ | ツール | 機能 |113| カテゴリ | ツール | 機能 |

114| :------------- | :-------------------------------------------- | :------------------------------------ |114| :------------- | :---------------------------------------------------------- | :------------------------------------ |

115| **ファイル操作** | `Read`、`Edit`、`Write` | ファイルを読み取り、変更、作成 |115| **ファイル操作** | `Read`、`Edit`、`Write` | ファイルを読み取り、変更、作成 |

116| **検索** | `Glob`、`Grep` | パターンでファイルを検索、正規表現でコンテンツを検索 |116| **検索** | `Glob`、`Grep` | パターンでファイルを検索、正規表現でコンテンツを検索 |

117| **実行** | `Bash` | シェルコマンド、スクリプト、git 操作を実行 |117| **実行** | `Bash` | シェルコマンド、スクリプト、git 操作を実行 |

118| **Web** | `WebSearch`、`WebFetch` | Web を検索、ページを取得して解析 |118| **Web** | `WebSearch`、`WebFetch` | Web を検索、ページを取得して解析 |

119| **検出** | `ToolSearch` | すべてをプリロードする代わりに、オンデマンドでツールを動的に検索してロード |119| **検出** | `ToolSearch` | すべてをプリロードする代わりに、オンデマンドでツールを動的に検索してロード |

120| **オーケストレーション** | `Agent`、`Skill`、`AskUserQuestion`、`TodoWrite` | サブエージェントを生成、スキルを呼び出し、ユーザーに質問、タスクを追跡 |120| **オーケストレーション** | `Agent`、`Skill`、`AskUserQuestion`、`TaskCreate`、`TaskUpdate` | サブエージェントを生成、スキルを呼び出し、ユーザーに質問、タスクを追跡 |

121 121 

122組み込みツール以外に、以下を実行できます。122組み込みツール以外に、以下を実行できます。

123 123 

204SDK でのコンテキストへの各コンポーネントの影響は次のとおりです。204SDK でのコンテキストへの各コンポーネントの影響は次のとおりです。

205 205 

206| ソース | ロード時期 | 影響 |206| ソース | ロード時期 | 影響 |

207| :----------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |207| :----------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

208| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |208| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |

209| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ（ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う） |209| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ（ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う） |

210| **ツール定義** | すべてのリクエスト | 各ツールはそのスキーマを追加します。[MCP ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)を使用して、すべてを一度にロードする代わりにオンデマンドでツールをロード |210| **ツール定義** | すべてのリクエスト。MCP スキーマはデフォルトで遅延 | 組み込みツールスキーマはすべてのリクエストをロードします。[ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)は、デフォルトで MCP ツールスキーマを遅延させ、Vertex AI または非ファーストパーティの `ANTHROPIC_BASE_URL` でのアップフロントロードにフォールバックします。完全なマトリックスについては、[ツール検索を構成](/ja/agent-sdk/tool-search#configure-tool-search)を参照してください |

211| **会話履歴** | ターン間で蓄積 | 各ターンで増加。プロンプト、応答、ツール入力、ツール出力 |211| **会話履歴** | ターン間で蓄積 | 各ターンで増加。プロンプト、応答、ツール入力、ツール出力 |

212| **スキル説明** | セッション開始時、設定ソース経由 | 短い要約。完全なコンテンツは呼び出し時のみロード |212| **スキル説明** | セッション開始時、設定ソース経由 | 短い要約。完全なコンテンツは呼び出し時のみロード |

213 213 

244長時間実行されるエージェントのいくつかの戦略。244長時間実行されるエージェントのいくつかの戦略。

245 245 

246* **サブタスク用にサブエージェントを使用します。** 各サブエージェントは新しい会話で開始されます（以前のメッセージ履歴はありませんが、独自のシステムプロンプトとプロジェクトレベルのコンテキスト（CLAUDE.md など）をロードします）。親のターンは表示されず、最終応答のみが親にツール結果として返されます。メインエージェントのコンテキストは完全なサブタスクトランスクリプトではなく、その要約で増加します。詳細については、[サブエージェントが継承するもの](/ja/agent-sdk/subagents#what-subagents-inherit)を参照してください。246* **サブタスク用にサブエージェントを使用します。** 各サブエージェントは新しい会話で開始されます（以前のメッセージ履歴はありませんが、独自のシステムプロンプトとプロジェクトレベルのコンテキスト（CLAUDE.md など）をロードします）。親のターンは表示されず、最終応答のみが親にツール結果として返されます。メインエージェントのコンテキストは完全なサブタスクトランスクリプトではなく、その要約で増加します。詳細については、[サブエージェントが継承するもの](/ja/agent-sdk/subagents#what-subagents-inherit)を参照してください。

247* **ツールを選別します。** すべてのツール定義はコンテキストスペースを取ります。[`AgentDefinition`](/ja/agent-sdk/subagents#agentdefinition-configuration)の `tools` フィールドを使用してサブエージェントを必要な最小セットにスコープし、[MCP ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)を使用してすべてをプリロードする代わりにオンデマンドでツールをロード。247* **ツールを選別します。** すべてのツール定義はコンテキストスペースを取ります。[`AgentDefinition`](/ja/agent-sdk/subagents#agentdefinition-configuration)の `tools` フィールドを使用してサブエージェントを必要な最小セットにスコープします。

248* **MCP サーバーコストを監視します。** 各 MCP サーバーはすべてのツールスキーマをすべてのリクエストに追加します。多くのツールを持つ少数のサーバーは、エージェントが何か作業を行う前に大量のコンテキストを消費できます。`ToolSearch` ツールはすべてをプリロードする代わりにオンデマンドでツールをロードすることで役立ちます。設定については、[MCP ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)を参照してください。248* **MCP サーバーコストを監視します。** [MCP ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、オンデマンドでロードします。ツール検索がオフの場合、Vertex AI 上の場合、または非ファーストパーティの `ANTHROPIC_BASE_URL` の背後にある場合、各 MCP サーバーはすべてのツールスキーマをすべてのリクエストに追加するため、多くのツールを持つ少数のサーバーは、エージェントが何か作業を行う前に大量のコンテキストを消費できます。

249* **ルーチンタスクに低い努力を使用します。** ルーチンタスク用に[努力](#effort-level)を `"low"` に設定します。これはファイルを読み取るか、ディレクトリをリストするだけで済むエージェント用です。これはトークン使用量とコストを削減します。249* **ルーチンタスクに低い努力を使用します。** ファイルを読み取るか、ディレクトリをリストするだけで済むエージェント用に[努力](#effort-level)を `"low"` に設定します。これはトークン使用量とコストを削減します。

250 250 

251機能ごとのコンテキストコストの詳細な内訳については、[コンテキストコストを理解する](/ja/features-overview#understand-context-costs)を参照してください。251機能ごとのコンテキストコストの詳細な内訳については、[コンテキストコストを理解する](/ja/features-overview#understand-context-costs)を参照してください。

252 252 

19### クイック比較19### クイック比較

20 20 

21| 機能 | `query()` | `ClaudeSDKClient` |21| 機能 | `query()` | `ClaudeSDKClient` |

22| :------------ | :------------ | :---------------- |22| :------------ | :----------------------------------------- | :---------------- |

23| **セッション** | 毎回新しいセッションを作成 | 同じセッションを再利用 |23| **セッション** | デフォルトで新しいセッションを作成 | 同じセッションを再利用 |

24| **会話** | 単一の交換 | 同じコンテキスト内の複数の交換 |24| **会話** | 単一の交換 | 同じコンテキスト内の複数の交換 |

25| **接続** | 自動的に管理 | 手動制御 |25| **接続** | 自動的に管理 | 手動制御 |

26| **ストリーミング入力** | ✅ サポート | ✅ サポート |26| **ストリーミング入力** | ✅ サポート | ✅ サポート |

27| **割り込み** | ❌ サポートなし | ✅ サポート |27| **割り込み** | ❌ サポートなし | ✅ サポート |

28| **Hooks** | ✅ サポート | ✅ サポート |28| **Hooks** | ✅ サポート | ✅ サポート |

29| **カスタムツール** | ✅ サポート | ✅ サポート |29| **カスタムツール** | ✅ サポート | ✅ サポート |

30| **会話を続ける** | ❌ 毎回新しいセッション | ✅ 会話を保持 |30| **会話を続ける** | `continue_conversation` または `resume` で手動実行 | ✅ 自動 |

31| **ユースケース** | 1 回限りのタスク | 継続的な会話 |31| **ユースケース** | 1 回限りのタスク | 継続的な会話 |

32 32 

33### `query()` を使用する場合（毎回新しいセッション）33### `query()` を使用する場合（1 回限りのタスク）

34 34 

35**最適な用途：**35**最適な用途：**

36 36 

53 53 

54### `query()`54### `query()`

55 55 

56Claude Code との各インタラクションのために新しいセッションを作成します。メッセージが到着するにつれて生成される非同期イテレータを返します。`query()` への各呼び出しは、前のインタラクションのメモリなしで新しく開始します。56Claude Code との各インタラクションのために新しいセッションを作成します。デフォルトでは、メッセージが到着するにつれて生成される非同期イテレータを返します。`query()` への各呼び出しは、`continue_conversation=True` または [`ClaudeAgentOptions`](#claudeagentoptions) の `resume` を渡さない限り、前のインタラクションのメモリなしで新しく開始します。[セッション](/ja/agent-sdk/sessions) を参照してください。

57 57 

58```python theme={null}58```python theme={null}

59async def query(59async def query(

790 plugins: list[SdkPluginConfig] = field(default_factory=list)790 plugins: list[SdkPluginConfig] = field(default_factory=list)

791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead

792 thinking: ThinkingConfig | None = None792 thinking: ThinkingConfig | None = None

793 effort: Literal["low", "medium", "high", "xhigh", "max"] | None = None793 effort: EffortLevel | None = None

794 enable_file_checkpointing: bool = False794 enable_file_checkpointing: bool = False

795 session_store: SessionStore | None = None795 session_store: SessionStore | None = None

796 session_store_flush: SessionStoreFlushMode = "batched"796 session_store_flush: SessionStoreFlushMode = "batched"

837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `"all"` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowed_tools` にリストしなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照 |837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `"all"` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowed_tools` にリストしなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照 |

838| `max_thinking_tokens` | `int \| None` | `None` | *非推奨* - 思考ブロックの最大トークン数。代わりに `thinking` を使用してください |838| `max_thinking_tokens` | `int \| None` | `None` | *非推奨* - 思考ブロックの最大トークン数。代わりに `thinking` を使用してください |

839| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 拡張思考動作を制御します。`max_thinking_tokens` より優先されます |839| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 拡張思考動作を制御します。`max_thinking_tokens` より優先されます |

840| `effort` | `Literal["low", "medium", "high", "xhigh", "max"] \| None` | `None` | 思考の深さの努力レベル |840| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | 思考の深さの努力レベル |

841| `session_store` | [`SessionStore`](/ja/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | セッショントランスクリプトを外部バックエンドにミラーリングして、任意のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/ja/agent-sdk/session-storage) を参照 |841| `session_store` | [`SessionStore`](/ja/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | セッショントランスクリプトを外部バックエンドにミラーリングして、任意のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/ja/agent-sdk/session-storage) を参照 |

842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | ミラーリングされたトランスクリプトエントリを `session_store` にフラッシュするタイミング。`"batched"` はターンごと、またはバッファが満杯になったときにフラッシュします。`"eager"` はすべてのフレームの後にバックグラウンドフラッシュをトリガーします。`session_store` が `None` の場合は無視されます |842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | ミラーリングされたトランスクリプトエントリを `session_store` にフラッシュするタイミング。`"batched"` はターンごと、またはバッファが満杯になったときにフラッシュします。`"eager"` はすべてのフレームの後にバックグラウンドフラッシュをトリガーします。`session_store` が `None` の場合は無視されます |

843 843 

890```890```

891 891 

892| フィールド | 必須 | 説明 |892| フィールド | 必須 | 説明 |

893| :------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |893| :------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

894| `type` | はい | プリセットシステムプロンプトを使用するには `"preset"` である必要があります |894| `type` | はい | プリセットシステムプロンプトを使用するには `"preset"` である必要があります |

895| `preset` | はい | Claude Code のシステムプロンプトを使用するには `"claude_code"` である必要があります |895| `preset` | はい | Claude Code のシステムプロンプトを使用するには `"claude_code"` である必要があります |

896| `append` | いいえ | プリセットシステムプロンプトに追加する追加の指示 |896| `append` | いいえ | プリセットシステムプロンプトに追加する追加の指示 |

897| `exclude_dynamic_sections` | いいえ | 作業ディレクトリ、git ステータス、メモリパスなどのセッションごとのコンテキストをシステムプロンプトから最初のユーザーメッセージに移動します。ユーザーとマシン全体でのプロンプトキャッシュの再利用を改善します。[システムプロンプトを変更](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) を参照 |897| `exclude_dynamic_sections` | いいえ | 作業ディレクトリ、git リポジトリフラグ、自動メモリパスなどのセッションごとのコンテキストをシステムプロンプトから最初のユーザーメッセージに移動します。ユーザーとマシン全体でのプロンプトキャッシュの再利用を改善します。[システムプロンプトを変更](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) を参照 |

898 898 

899### `SettingSource`899### `SettingSource`

900 900 

1039 initialPrompt: str | None = None1039 initialPrompt: str | None = None

1040 maxTurns: int | None = None1040 maxTurns: int | None = None

1041 background: bool | None = None1041 background: bool | None = None

1042 effort: Literal["low", "medium", "high", "xhigh", "max"] | int | None = None1042 effort: EffortLevel | int | None = None

1043 permissionMode: PermissionMode | None = None1043 permissionMode: PermissionMode | None = None

1044```1044```

1045 1045 

1056| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |1056| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |

1057| `maxTurns` | いいえ | エージェントが停止する前の最大 agentic ターン数 |1057| `maxTurns` | いいえ | エージェントが停止する前の最大 agentic ターン数 |

1058| `background` | いいえ | 呼び出されたときにこのエージェントをブロッキングされないバックグラウンドタスクとして実行します |1058| `background` | いいえ | 呼び出されたときにこのエージェントをブロッキングされないバックグラウンドタスクとして実行します |

1059| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます |1059| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます。[`EffortLevel`](#effortlevel) を参照 |

1060| `permissionMode` | いいえ | このエージェント内のツール実行のパーミッションモード。[`PermissionMode`](#permissionmode) を参照 |1060| `permissionMode` | いいえ | このエージェント内のツール実行のパーミッションモード。[`PermissionMode`](#permissionmode) を参照 |

1061 1061 

1062<Note>1062<Note>

1077]1077]

1078```1078```

1079 1079 

1080### `EffortLevel`

1081 

1082思考の深さを導くための努力レベル。

1083 

1084```python theme={null}

1085EffortLevel = Literal[

1086 "low", # Minimal thinking, fastest responses

1087 "medium", # Moderate thinking

1088 "high", # Deep reasoning

1089 "xhigh", # Extended reasoning (Opus 4.7 only; falls back to "high" on other models)

1090 "max", # Maximum effort

1091]

1092```

1093 

1080### `CanUseTool`1094### `CanUseTool`

1081 1095 

1082ツールパーミッションコールバック関数の型エイリアス。1096ツールパーミッションコールバック関数の型エイリアス。

1224拡張思考動作を制御します。3 つの設定の Union：1238拡張思考動作を制御します。3 つの設定の Union：

1225 1239 

1226```python theme={null}1240```python theme={null}

1241ThinkingDisplay = Literal["summarized", "omitted"]

1242 

1243 

1227class ThinkingConfigAdaptive(TypedDict):1244class ThinkingConfigAdaptive(TypedDict):

1228 type: Literal["adaptive"]1245 type: Literal["adaptive"]

1246 display: NotRequired[ThinkingDisplay]

1229 1247 

1230 1248 

1231class ThinkingConfigEnabled(TypedDict):1249class ThinkingConfigEnabled(TypedDict):

1232 type: Literal["enabled"]1250 type: Literal["enabled"]

1233 budget_tokens: int1251 budget_tokens: int

1252 display: NotRequired[ThinkingDisplay]

1234 1253 

1235 1254 

1236class ThinkingConfigDisabled(TypedDict):1255class ThinkingConfigDisabled(TypedDict):

1241```1260```

1242 1261 

1243| バリアント | フィールド | 説明 |1262| バリアント | フィールド | 説明 |

1244| :--------- | :--------------------- | :-------------------------- |1263| :--------- | :------------------------------- | :-------------------------- |

1245| `adaptive` | `type` | Claude は適応的に思考するタイミングを決定します |1264| `adaptive` | `type`、`display` | Claude は適応的に思考するタイミングを決定します |

1246| `enabled` | `type`、`budget_tokens` | 特定のトークン予算で思考を有効にします |1265| `enabled` | `type`、`budget_tokens`、`display` | 特定のトークン予算で思考を有効にします |

1247| `disabled` | `type` | 思考を無効にします |1266| `disabled` | `type` | 思考を無効にします |

1248 1267 

1268オプションの `display` フィールドは、思考テキストが `"summarized"` または `"omitted"` で返されるかどうかを制御します。Claude Opus 4.7 以降では、API デフォルトは `"omitted"` であるため、[`ThinkingBlock`](#thinkingblock) 出力で思考コンテンツを受け取るには `"summarized"` を設定します。

1269 

1249これらは `TypedDict` クラスであるため、実行時にはプレーンな dict です。dict リテラルとして構築するか、クラスをコンストラクタのように呼び出します。どちらも `dict` を生成します。`config["budget_tokens"]` でフィールドにアクセスし、`config.budget_tokens` ではなく：1270これらは `TypedDict` クラスであるため、実行時にはプレーンな dict です。dict リテラルとして構築するか、クラスをコンストラクタのように呼び出します。どちらも `dict` を生成します。`config["budget_tokens"]` でフィールドにアクセスし、`config.budget_tokens` ではなく：

1250 1271 

1251```python theme={null}1272```python theme={null}

2177 hookEventName: Literal["PostToolUse"]2198 hookEventName: Literal["PostToolUse"]

2178 additionalContext: NotRequired[str]2199 additionalContext: NotRequired[str]

2179 updatedToolOutput: NotRequired[Any]2200 updatedToolOutput: NotRequired[Any]

2180 updatedMCPToolOutput: NotRequired[Any]2201 updatedMCPToolOutput: NotRequired[Any] # Deprecated: use updatedToolOutput, which works for all tools

2181 2202 

2182 2203 

2183class PostToolUseFailureHookSpecificOutput(TypedDict):2204class PostToolUseFailureHookSpecificOutput(TypedDict):

2646**ツール名：** `TodoWrite`2667**ツール名：** `TodoWrite`

2647 2668 

2648<Note>2669<Note>

2649 `TodoWrite` は非推奨であり、将来のリリースで削除される予定です。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。`CLAUDE_CODE_ENABLE_TASKS=1` を設定してオプトインしてください。コード変更の監視方法については [Task ツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools) を参照してください。2670 Claude Code v2.1.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。[Task ツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools) を参照して監視コードを更新するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。

2650</Note>2671</Note>

2651 2672 

2652**入力：**2673**入力：**

100 100 

101### TypeScript：`continue: true`101### TypeScript：`continue: true`

102 102 

103安定した TypeScript SDK（これらのドキュメント全体で使用される `query()` 関数、V1 と呼ばれることもあります）には、Python の `ClaudeSDKClient` のようなセッション保持クライアントオブジェクトがありません。代わりに、後続の各 `query()` 呼び出しで `continue: true` を渡すと、SDK は現在のディレクトリ内の最新セッションを見つけて再開します。ID 追跡は不要です。103TypeScript SDK には、Python の `ClaudeSDKClient` のようなセッション保持クライアントオブジェクトがありません。代わりに、後続の各 `query()` 呼び出しで `continue: true` を渡すと、SDK は現在のディレクトリ内の最新セッションを見つけて再開します。ID 追跡は不要です。

104 104 

105この例は 2 つの別々の `query()` 呼び出しを行います。最初は新しいセッションを作成し、2 番目は `continue: true` を設定します。これは SDK にディスク上の最新セッションを見つけて再開するよう指示します。エージェントは最初の呼び出しから完全なコンテキストを持ちます：105この例は 2 つの別々の `query()` 呼び出しを行います。最初は新しいセッションを作成し、2 番目は `continue: true` を設定します。これは SDK にディスク上の最新セッションを見つけて再開するよう指示します。エージェントは最初の呼び出しから完全なコンテキストを持ちます：

106 106 

132```132```

133 133 

134<Note>134<Note>

135 実験的な [V2 セッション API](/ja/agent-sdk/typescript-v2-preview)（`createSession()` と `send` / `stream` パターンを提供していた）は非推奨です。このページで説明されている V1 `query()` 関数とセッションオプションを使用してください。135 実験的な [V2 セッション API](/ja/agent-sdk/typescript-v2-preview)（`createSession()` と `send` / `stream` パターンを提供していた）は TypeScript Agent SDK 0.3.142 で削除されました。このページで説明されている `query()` 関数とセッションオプションを使用してください。

136</Note>136</Note>

137 137 

138## `query()` でセッションオプションを使用する138## `query()` でセッションオプションを使用する

8 8 

9Todo 追跡は、タスクを管理し、ユーザーに進捗を表示するための構造化された方法を提供します。Claude Agent SDK には、複雑なワークフローを整理し、ユーザーにタスク進捗を知らせるのに役立つ組み込み todo 機能が含まれています。9Todo 追跡は、タスクを管理し、ユーザーに進捗を表示するための構造化された方法を提供します。Claude Agent SDK には、複雑なワークフローを整理し、ユーザーにタスク進捗を知らせるのに役立つ組み込み todo 機能が含まれています。

10 10 

11<Note>

12 TypeScript Agent SDK 0.3.142 および Claude Code v2.1.142 以降、セッションは `TodoWrite` の代わりに構造化された Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、および `TaskList` を使用します。監視コードの変更方法については、[Task ツールへの移行](#migrate-to-task-tools)を参照してください。このページの例では、まだ移行していないセッションの `TodoWrite` を引き続き表示するために `CLAUDE_CODE_ENABLE_TASKS=0` を設定しています。

13</Note>

14 

11### Todo ライフサイクル15### Todo ライフサイクル

12 16 

13Todo は予測可能なライフサイクルに従います：17Todo は予測可能なライフサイクルに従います：

36 40 

37 for await (const message of query({41 for await (const message of query({

38 prompt: "Optimize my React app performance and track progress with todos",42 prompt: "Optimize my React app performance and track progress with todos",

39 options: { maxTurns: 15 }43 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

44 // Task tools instead and these tool_use blocks never appear.

45 options: { maxTurns: 15, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

40 })) {46 })) {

41 // Todo updates are reflected in the message stream47 // Todo updates are reflected in the message stream

42 if (message.type === "assistant") {48 if (message.type === "assistant") {

61 67 

62 async for message in query(68 async for message in query(

63 prompt="Optimize my React app performance and track progress with todos",69 prompt="Optimize my React app performance and track progress with todos",

64 options=ClaudeAgentOptions(max_turns=15),70 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

71 # Task tools instead and these tool_use blocks never appear.

72 options=ClaudeAgentOptions(max_turns=15, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

65 ):73 ):

66 # Todo updates are reflected in the message stream74 # Todo updates are reflected in the message stream

67 if isinstance(message, AssistantMessage):75 if isinstance(message, AssistantMessage):

112 async trackQuery(prompt: string) {120 async trackQuery(prompt: string) {

113 for await (const message of query({121 for await (const message of query({

114 prompt,122 prompt,

115 options: { maxTurns: 20 }123 // Re-enable TodoWrite, which this tracker watches for.

124 options: { maxTurns: 20, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

116 })) {125 })) {

117 if (message.type === "assistant") {126 if (message.type === "assistant") {

118 for (const block of message.message.content) {127 for (const block of message.message.content) {

167 print(f"{i + 1}. {icon} {text}")176 print(f"{i + 1}. {icon} {text}")

168 177 

169 async def track_query(self, prompt: str):178 async def track_query(self, prompt: str):

170 async for message in query(prompt=prompt, options=ClaudeAgentOptions(max_turns=20)):179 async for message in query(

180 prompt=prompt,

181 # Re-enable TodoWrite, which this tracker watches for.

182 options=ClaudeAgentOptions(max_turns=20, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

183 ):

171 if isinstance(message, AssistantMessage):184 if isinstance(message, AssistantMessage):

172 for block in message.content:185 for block in message.content:

173 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":186 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":

181 ```194 ```

182</CodeGroup>195</CodeGroup>

183 196 

197## Task ツールへの移行

198 

199Task ツールは、単一の `TodoWrite` 呼び出しを、各新規アイテムの `TaskCreate` と各ステータス変更の `TaskUpdate` に分割し、`TaskList` と `TaskGet` はモデルが現在のリストを読み戻すために利用可能です。監視コードは引き続きアシスタントストリーム内の `tool_use` ブロックを検査しますが、すべての呼び出しでリスト全体を置き換える代わりに、タスク ID でキー付けされたマップを保持します。{/* min-version: 2.1.142 */}Task ツールは TypeScript Agent SDK 0.3.142 および Claude Code v2.1.142 以降のデフォルトであるため、`options.env` の変更は不要です。

200 

201| `TodoWrite` を使用 | Task ツールを使用 |

202| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| 1 つのツール呼び出しで完全な `todos` 配列を書き直す | `TaskCreate` は 1 つのアイテムを追加し、`TaskUpdate` は `taskId` で 1 つのアイテムをパッチする |

204| `block.name === "TodoWrite"` に一致 | `block.name === "TaskCreate"` または `"TaskUpdate"` に一致 |

205| アイテム形状：`{ content, status, activeForm }` | `TaskCreate` 入力：`{ subject, description, activeForm?, metadata? }`。`TaskUpdate` 入力：`{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`。`status` は `"pending"`、`"in_progress"`、または `"completed"`；削除するには `status: "deleted"` を設定 |

206| `block.input.todos` を直接レンダリング | 呼び出し全体でアイテムを蓄積するか、ストリームから `TaskList` ツール結果のスナップショットを読み取る |

207 

208割り当てられたタスク ID は `TaskCreate` 入力にはありません。マッチング `tool_result` で `{ task: { id, subject } }` として返されるため、マップをキー付けするために結果ブロックからそれをキャプチャします。次の例は、[Todo 変更の監視](#monitoring-todo-changes)ループへの最小限の変更を示しています。完全なリストをレンダリングするには、ストリーム内の `TaskList` ツール結果を監視するか、`TaskCreate` 結果と `TaskUpdate` 入力をマップに蓄積します：

209 

210<CodeGroup>

211 ```typescript TypeScript theme={null}

212 import { query } from "@anthropic-ai/claude-agent-sdk";

213 

214 for await (const message of query({

215 prompt: "Optimize my React app performance",

216 })) {

217 if (message.type !== "assistant") continue;

218 for (const block of message.message.content) {

219 if (block.type !== "tool_use") continue;

220 if (block.name === "TaskCreate") {

221 const input = block.input as { subject: string };

222 console.log(`+ ${input.subject}`);

223 } else if (block.name === "TaskUpdate") {

224 const input = block.input as { taskId: string; status?: string };

225 if (input.status) console.log(` ${input.taskId} -> ${input.status}`);

226 }

227 }

228 }

229 ```

230 

231 ```python Python theme={null}

232 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock

233 

234 async for message in query(

235 prompt="Optimize my React app performance",

236 ):

237 if not isinstance(message, AssistantMessage):

238 continue

239 for block in message.content:

240 if not isinstance(block, ToolUseBlock):

241 continue

242 if block.name == "TaskCreate":

243 print(f"+ {block.input['subject']}")

244 elif block.name == "TaskUpdate" and block.input.get("status"):

245 print(f" {block.input['taskId']} -> {block.input['status']}")

246 ```

247</CodeGroup>

248 

184## 関連ドキュメント249## 関連ドキュメント

185 250 

186* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript)251* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript)

414| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` にリストされていなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照してください |414| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` にリストされていなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照してください |

415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |

416| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |416| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |

417| `strictMcpConfig` | `boolean` | `false` | 厳密な MCP 検証を強制します |417| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバーを無視します |

418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined`（最小限のプロンプト） | システムプロンプト設定。カスタムプロンプト用の文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、[マシン全体でプロンプトキャッシュの再利用を改善](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) するためにセッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定します |418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined`（最小限のプロンプト） | システムプロンプト設定。カスタムプロンプト用の文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、[マシン全体でプロンプトキャッシュの再利用を改善](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) するためにセッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定します |

419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポートされているモデルの場合 `{ type: 'adaptive' }` | Claude の思考/推論動作を制御します。オプションについては [`ThinkingConfig`](#thinkingconfig) を参照してください |419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポートされているモデルの場合 `{ type: 'adaptive' }` | Claude の思考/推論動作を制御します。オプションについては [`ThinkingConfig`](#thinkingconfig) を参照してください |

420| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | 組み込みツール動作の設定。詳細は [`ToolConfig`](#toolconfig) を参照してください |420| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | 組み込みツール動作の設定。詳細は [`ToolConfig`](#toolconfig) を参照してください |

1847進捗を追跡するための構造化タスクリストを作成および管理します。1847進捗を追跡するための構造化タスクリストを作成および管理します。

1848 1848 

1849<Note>1849<Note>

1850 `TodoWrite` は非推奨であり、将来のリリースで削除されます。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。`CLAUDE_CODE_ENABLE_TASKS=1` を設定してオプトインします。コード変更の監視方法については、[Task ツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools) を参照してください。1850 TypeScript Agent SDK 0.3.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。監視コードを更新するには、[Task ツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools) を参照するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。

1851</Note>1851</Note>

1852 1852 

1853### TaskCreate1853### TaskCreate

2344前のタスクリストと更新されたタスクリストを返します。2344前のタスクリストと更新されたタスクリストを返します。

2345 2345 

2346<Note>2346<Note>

2347 `TodoWrite` は非推奨であり、将来のリリースで削除される予定です。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。`CLAUDE_CODE_ENABLE_TASKS=1` を設定してオプトインします。コード変更の監視方法については、[タスクツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools)を参照してください。2347 TypeScript Agent SDK 0.3.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。[タスクツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools)を参照して、監視コードを更新するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。

2348</Note>2348</Note>

2349 2349 

2350### TaskCreate2350### TaskCreate

2739Claude の思考/推論動作を制御します。非推奨の `maxThinkingTokens` より優先されます。2739Claude の思考/推論動作を制御します。非推奨の `maxThinkingTokens` より優先されます。

2740 2740 

2741```typescript theme={null}2741```typescript theme={null}

2742type ThinkingDisplay = "summarized" | "omitted";

2743 

2742type ThinkingConfig =2744type ThinkingConfig =

2743 | { type: "adaptive" } // モデルが推論のタイミングと量を決定します（Opus 4.6 以降）2745 | { type: "adaptive"; display?: ThinkingDisplay } // モデルが推論のタイミングと量を決定します（Opus 4.6 以降）

2744 | { type: "enabled"; budgetTokens?: number } // 固定思考トークン予算2746 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // 固定思考トークン予算

2745 | { type: "disabled" }; // 拡張思考なし2747 | { type: "disabled" }; // 拡張思考なし

2746```2748```

2747 2749 

2750オプションの `display` フィールドは、思考テキストが `"summarized"` または `"omitted"` で返されるかどうかを制御します。Claude Opus 4.7 以降では、API のデフォルトは `"omitted"` であるため、`"summarized"` を設定して `thinking` ブロックで思考コンテンツを受け取ります。

2751 

2748### `SpawnedProcess`2752### `SpawnedProcess`

2749 2753 

2750カスタムプロセススポーニング用のインターフェース（`spawnClaudeCodeProcess` オプションで使用）。`ChildProcess` は既にこのインターフェースを満たしています。2754カスタムプロセススポーニング用のインターフェース（`spawnClaudeCodeProcess` オプションで使用）。`ChildProcess` は既にこのインターフェースを満たしています。

3158```3162```

3159 3163 

3160| プロパティ | 型 | デフォルト | 説明 |3164| プロパティ | 型 | デフォルト | 説明 |

3161| :------------------------ | :--------- | :---------- | :------------------------------------------------------ |3165| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3162| `allowedDomains` | `string[]` | `[]` | サンドボックス化されたプロセスがアクセスできるドメイン名 |3166| `allowedDomains` | `string[]` | `[]` | サンドボックス化されたプロセスがアクセスできるドメイン名 |

3163| `deniedDomains` | `string[]` | `[]` | サンドボックス化されたプロセスがアクセスできないドメイン名。`allowedDomains` より優先されます |3167| `deniedDomains` | `string[]` | `[]` | サンドボックス化されたプロセスがアクセスできないドメイン名。`allowedDomains` より優先されます |

3164| `allowManagedDomainsOnly` | `boolean` | `false` | ネットワークアクセスを `allowedDomains` のドメインのみに制限します |3168| `allowManagedDomainsOnly` | `boolean` | `false` | 管理設定のみ。[管理設定](/ja/permissions#managed-settings) で設定された場合、管理設定からの `allowedDomains` エントリのみが尊重され、ユーザー、プロジェクト、またはローカル設定からのエントリは無視されます。SDK オプション経由で設定された場合は効果がありません |

3165| `allowLocalBinding` | `boolean` | `false` | プロセスがローカルポートにバインドすることを許可します（例：開発サーバー） |3169| `allowLocalBinding` | `boolean` | `false` | プロセスがローカルポートにバインドすることを許可します（例：開発サーバー） |

3166| `allowUnixSockets` | `string[]` | `[]` | プロセスがアクセスできる Unix ソケットパス（例：Docker ソケット） |3170| `allowUnixSockets` | `string[]` | `[]` | プロセスがアクセスできる Unix ソケットパス（例：Docker ソケット） |

3167| `allowAllUnixSockets` | `boolean` | `false` | すべての Unix ソケットへのアクセスを許可します |3171| `allowAllUnixSockets` | `boolean` | `false` | すべての Unix ソケットへのアクセスを許可します |

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# TypeScript SDK V2 セッション API（非推奨）5# TypeScript SDK V2 セッション API（削除済み）

6 6 

7> マルチターン会話向けのセッションベースの send/stream パターンを備えた、非推奨の V2 TypeScript Agent SDK セッション API のリファレンス。7> マルチターン会話向けのセッションベースの send/stream パターンを備えた、削除済みの V2 TypeScript Agent SDK セッション API のリファレンス。

8 8 

9<Warning>9<Warning>

10 V2 セッション API 関数の `unstable_v2_createSession`、`unstable_v2_resumeSession`、および `unstable_v2_prompt` は非推奨であり、将来のリリースで削除される予定です。代わりに [V1 の `query()` API](/ja/agent-sdk/typescript) を使用してください。10 V2 セッション API はサポートされなくなりました。TypeScript Agent SDK 0.3.142 では `unstable_v2_createSession`、`unstable_v2_resumeSession`、`unstable_v2_prompt`、および `SDKSession` と `SDKSessionOptions` 型が削除されます。

11 

12 移行するには、[`query()` API](/ja/agent-sdk/typescript) と、それが受け入れる [セッションオプション](/ja/agent-sdk/sessions) を使用してください。マルチターン会話の場合は `AsyncIterable<SDKUserMessage>` を渡すか、保存されたセッションを続行するには `options.resume` を使用してください。このページは、Agent SDK 0.2.x 以前のコードを保守している場合の参照用に保持されています。

11</Warning>13</Warning>

12 14 

13V2 は、非同期ジェネレータと yield 調整の必要性を排除した実験的なセッション API でした。ターン間でジェネレータの状態を管理する代わりに、各ターンは個別の `send()`/`stream()` サイクルになります。API サーフェスは 3 つの概念に縮小されました。15V2 は、非同期ジェネレータと yield 調整の必要性を排除した実験的なセッション API でした。ターン間でジェネレータの状態を管理する代わりに、各ターンは個別の `send()`/`stream()` サイクルになります。API サーフェスは 3 つの概念に縮小されました。

18 20 

19## インストール21## インストール

20 22 

21V2 インターフェースは既存の SDK パッケージに含まれています。23Agent SDK 0.2.x は V2 インターフェースを含む最後のバージョンです。パッケージバージョンは 0.2.x から直接 0.3.142 にジャンプしたため、上記の削除バージョンと下記のインストールピンは同じ境界を説明しています。最後の V2 互換リリースをインストールするには、メジャーバージョンとマイナーバージョンをピンしてください。

22 24 

23```bash theme={null}25```bash theme={null}

24npm install @anthropic-ai/claude-agent-sdk26npm install @anthropic-ai/claude-agent-sdk@0.2

25```27```

26 28 

27<Note>29<Note>

72 72 

73`claude agents` を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、最後に変更されてからの経過時間を表示します。73`claude agents` を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、最後に変更されてからの経過時間を表示します。

74 74 

75リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。他のターミナルで開いているインタラクティブセッションは、[バックグラウンドにする](#from-inside-a-session)までは表示されません。[Subagents](/ja/sub-agents) と [teammates](/ja/agent-teams) はセッションが生成しても個別の行としてリストされません。75デフォルトでは、リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。リストを 1 つのプロジェクトに絞り込むには、`--cwd` を渡します（Claude Code v2.1.141 以降が必要です）。

76 76 

77ビューを 1 つのプロジェクトにスコープするには、`claude agents --cwd <path>` で起動します。そのディレクトリの下で開始されたセッションのみが表示されます。これには、そこからディスパッチされた [ワークツリー](/ja/worktrees) で実行されているセッションも含まれます。77```bash theme={null}

78claude agents --cwd ~/projects/my-app

79```

80 

81これはそのディレクトリの下で開始されたセッションのみを表示します。`~/projects/my-app/.claude/worktrees/` の下の [ワークツリーに移動した](#how-file-edits-are-isolated) セッションは、`~/projects/my-app` に属するものとしてカウントされます。

82 

83他のターミナルで開いているインタラクティブセッションは、[バックグラウンドにする](#from-inside-a-session)までは表示されません。[Subagents](/ja/sub-agents) と [teammates](/ja/agent-teams) はセッションが生成しても個別の行としてリストされません。

78 84 

79```text theme={null}85```text theme={null}

80Pinned86Pinned

117| `∙` | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |123| `∙` | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |

118| `✢` | [`/loop`](/ja/scheduled-tasks) セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |124| `✢` | [`/loop`](/ja/scheduled-tasks) セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |

119 125 

126行の右端に表示される `●` は [プルリクエストステータス](#pull-request-status) インジケーターであり、状態アイコンの一部ではありません。その前の数字はセッションが開いたプルリクエストの数です。

127 

120バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の [スーパーバイザープロセス](#the-supervisor-process) がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。128バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の [スーパーバイザープロセス](#the-supervisor-process) がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。

121 129 

122セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。マシンがスリープまたはシャットダウンした場合、実行中のセッションは停止します。`claude respawn --all` で再開します。130セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。

123 131 

124### 行の概要132### 行の概要

125 133 

158 166 

159デタッチはバックグラウンドセッションを停止しません。`←`、`Ctrl+C`、`Ctrl+D`、`Ctrl+Z`、および `/exit` はすべてセッションを実行し続けます。セッション内からセッションを終了するには、`/stop` を実行します。167デタッチはバックグラウンドセッションを停止しません。`←`、`Ctrl+C`、`Ctrl+D`、`Ctrl+Z`、および `/exit` はすべてセッションを実行し続けます。セッション内からセッションを終了するには、`/stop` を実行します。

160 168 

161エージェントビューからディスパッチまたはバックグラウンドにしたセッションの後、空のプロンプトで `←` を押すと、アタッチしたセッションだけでなく、任意の Claude Code セッションから機能します。現在のセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開くため、ターミナルを離れずにセッションを切り替えることができます。このショートカットは `/config` でオフにできます。169ディスパッチまたはバックグラウンドにしたセッションの後、空のプロンプトで `←` を押すと、アタッチしたセッションだけでなく、任意の Claude Code セッションから機能します。現在のセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開くため、ターミナルを離れずにセッションを切り替えることができます。行は会話履歴がない新しいセッションからでも作成されるため、`→` はそれに戻ります。その行が唯一の行である場合、エージェントビューはその下にオンボーディングヒントを表示します。このショートカットは `/config` でオフにできます（`leftArrowOpensAgents` 設定）。

162 170 

163### リストを整理する171### リストを整理する

164 172 

173 181 

174セッションをリストから削除するには、`Ctrl+X` を押して停止し、2 秒以内に `Ctrl+X` を再度押して削除します。グループヘッダーで `Ctrl+X` を押すと、確認後、そのグループ内のすべてのセッションが削除されます。182セッションをリストから削除するには、`Ctrl+X` を押して停止し、2 秒以内に `Ctrl+X` を再度押して削除します。グループヘッダーで `Ctrl+X` を押すと、確認後、そのグループ内のすべてのセッションが削除されます。

175 183 

176削除するとセッションがエージェントビューから削除され、その [ワークツリー](#how-file-edits-are-isolated) がクリーンアップされます。コミットされていない変更を含みます。削除する前に、保持したい作業をプッシュまたはコミットします。会話トランスクリプトはディスク上に残り、`claude --resume` を通じて利用可能です。184削除するとセッションがエージェントビューから削除され、その会話トランスクリプトが削除されます。Claude が [ワークツリーを作成した](#how-file-edits-are-isolated) 場合、削除するとそのワークツリーも削除されます。コミットされていない変更を含みます。保持したい作業をプッシュまたはコミットしてから削除します。自分で作成したワークツリーとセッションを開始した場合は、そのままにしておきます。

177 185 

178古い完了したセッションは「… N more」行に折りたたまれ、リストを短く保ちます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。186古い完了したセッションは「… N more」行に折りたたまれ、リストを短く保ちます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。

179 187 

198| `Space` | 選択したセッションのピークパネルを開くまたは閉じる |206| `Space` | 選択したセッションのピークパネルを開くまたは閉じる |

199| `Shift+Enter` | ディスパッチして直ちにアタッチ |207| `Shift+Enter` | ディスパッチして直ちにアタッチ |

200| `→` | 選択したセッションにアタッチ |208| `→` | 選択したセッションにアタッチ |

201| `Alt+1`..`Alt+9` | 現在のグループのセッション 1～9 にアタッチ |209| `Alt+1`..`Alt+9` | フォーカスされたセッションのディレクトリ内のセッション 1～9 にアタッチ |

202| `Tab` | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |210| `Tab` | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |

203| `Ctrl+S` | グループ化を状態とディレクトリの間で切り替え |211| `Ctrl+S` | グループ化を状態とディレクトリの間で切り替え |

204| `Ctrl+T` | 選択したセッションをピン留めまたはピン留め解除 |212| `Ctrl+T` | 選択したセッションをピン留めまたはピン留め解除 |

205| `Ctrl+R` | 選択したセッションの名前を変更 |213| `Ctrl+R` | 選択したセッションの名前を変更 |

206| `Ctrl+G` | `$EDITOR` でディスパッチプロンプトを開く |214| `Ctrl+G` | `$VISUAL` または `$EDITOR` でディスパッチプロンプトを開く |

207| `Ctrl+X` | セッションを停止。2 秒以内に再度押して削除 |215| `Ctrl+X` | セッションを停止。2 秒以内に再度押して削除 |

208| `Shift+↑` / `Shift+↓` | 選択したセッションを並べ替え |216| `Shift+↑` / `Shift+↓` | 選択したセッションを並べ替え |

209| `Esc` | ピークパネルを閉じるか、入力をクリアするか、終了 |217| `Esc` | ピークパネルを閉じるか、入力をクリアするか、終了 |

251 259 

252インタラクティブセッションからバックグラウンド化すると、保存された会話から再開する新しいプロセスが開始されるため、subagent の実行、[monitors](/ja/tools-reference#monitor-tool)、およびバックグラウンドコマンドはそれに転送されません。実行中の場合、Claude はバックグラウンド化する前に確認を求めます。バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。260インタラクティブセッションからバックグラウンド化すると、保存された会話から再開する新しいプロセスが開始されるため、subagent の実行、[monitors](/ja/tools-reference#monitor-tool)、およびバックグラウンドコマンドはそれに転送されません。実行中の場合、Claude はバックグラウンド化する前に確認を求めます。バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。

253 261 

262元の起動時の設定フラグはバックグラウンド化されたセッションに引き継がれるため、その MCP サーバー、設定、およびフォールバックモデルは有効なままです：

263 

264* `--mcp-config` および `--strict-mcp-config`

265* `--settings`

266* `--add-dir`

267* `--plugin-dir`

268* `--fallback-model`

269* `--allow-dangerously-skip-permissions`

270 

271`--allow-dangerously-skip-permissions` を引き継ぐことで、バックグラウンド化されたセッションで `bypassPermissions` に到達可能になりますが、新しい権限は付与されません。このモードは、セッションが監視していない状態で承認なしに動作することを許可するため、[パーミッションモード、モデル、および努力](#permission-mode-model-and-effort) で説明されているのと同じ 1 回限りのインタラクティブな受け入れが必要です。

272 

254### シェルから273### シェルから

255 274 

256`--bg` を渡してセッションを直接バックグラウンドに送信します。275`--bg` を渡してセッションを直接バックグラウンドに送信します：

257 276 

258```bash theme={null}277```bash theme={null}

259claude --bg "investigate the flaky SettingsChangeDetector test"278claude --bg "investigate the flaky SettingsChangeDetector test"

260```279```

261 280 

262特定の subagent をセッションのメインエージェントとして実行するには、`--bg` を `--agent` と組み合わせます。281特定の subagent をセッションのメインエージェントとして実行するには、`--bg` を `--agent` と組み合わせます：

263 282 

264```bash theme={null}283```bash theme={null}

265claude --agent code-reviewer --bg "address review comments on PR 1234"284claude --agent code-reviewer --bg "address review comments on PR 1234"

266```285```

267 286 

268`--name` を渡して、自動生成されたセッションの代わりにエージェントビューでセッションの表示名を設定します。287`--name` を渡して、自動生成されたセッションの代わりにエージェントビューでセッションの表示名を設定します：

269 288 

270```bash theme={null}289```bash theme={null}

271claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"290claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

272```291```

273 292 

274バックグラウンド化の後、Claude はセッションの短い ID とセッションを管理するためのコマンドを出力します。293バックグラウンド化の後、Claude はセッションの短い ID とセッションを管理するためのコマンドを出力します：

275 294 

276```text theme={null}295```text theme={null}

277backgrounded · 7c5dcf5d296backgrounded · 7c5dcf5d

283 302 

284### ファイル編集の分離方法303### ファイル編集の分離方法

285 304 

286エージェントビュー、`/bg`、または `claude --bg` から開始されたすべてのバックグラウンドセッションは、作業ディレクトリで開始されます。ファイルを編集する前に、Claude はセッションを `.claude/worktrees/` の下の分離された [git worktree](/ja/worktrees) に移動するため、並列セッションは同じチェックアウトを読み取ることができますが、それぞれが独自のものに書き込みます。セッションが既に `.claude/worktrees/` の下にある場合、作業ディレクトリが git リポジトリでない場合、または作業ディレクトリの外への書き込みの場合、Claude はこれをスキップします。305エージェントビュー、`/bg`、または `claude --bg` から開始されたすべてのバックグラウンドセッションは、作業ディレクトリで開始されます。ファイルを編集する前に、Claude はセッションを `.claude/worktrees/` の下の分離された [git worktree](/ja/worktrees) に移動するため、並列セッションは同じチェックアウトを読み取ることができますが、それぞれが独自のものに書き込みます。

306 

307Claude はワークツリーをスキップします：

308 

309* セッションが既にリンクされた git worktree 内にある場合。Claude が `.claude/worktrees/` の下に作成したか、`git worktree add` で別の場所に作成したかに関係なく

310* 作業ディレクトリが git リポジトリでない場合

311* 作業ディレクトリの外への書き込みの場合

312 

313git worktree が実用的でないリポジトリのワークツリー分離をオフにするには、[`worktree.bgIsolation`](/ja/settings#worktree-settings) を `"none"` に設定します。バックグラウンドセッションは、ワークツリーに移動する前に作業コピーを直接編集します。プロジェクトの `.claude/settings.json` に設定を追加します：

314 

315```json theme={null}

316{

317 "worktree": {

318 "bgIsolation": "none"

319 }

320}

321```

322 

323<Note>

324 `worktree.bgIsolation` 設定には Claude Code v2.1.143 以降が必要です。

325</Note>

287 326 

288git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。327git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。

289 328 

290セッションを削除するとワークツリーが削除されるため、削除する前に保持したい変更をマージまたはプッシュします。セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。329エージェントビューでセッションを削除する（`Ctrl+X` を 2 回）と、Claude が作成したワークツリーが削除されます。コミットされていない変更を含めて削除されるため、保持したい変更をマージまたはプッシュしてから削除します。シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除すると、コミットされていない変更があるワークツリーが保持され、そのパスが出力されるため、自分でクリーンアップできます。自分で作成したワークツリーとセッションを開始した場合は、どちらの方法でも所定の位置に残されます。

330 

331セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。

291 332 

292subagent が開始方法に関係なく常に独自のワークツリーで実行されるようにするには、frontmatter で [`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields) を設定します。333subagent が開始方法に関係なく常に独自のワークツリーで実行されるようにするには、frontmatter で [`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields) を設定します。

293 334 

307 348 

308[permission mode](/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在のパーミッションモードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。349[permission mode](/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在のパーミッションモードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。

309 350 

310エージェントビューを開く際に `--permission-mode`、`--model`、または `--effort` のいずれかを渡して、エージェントビューからディスパッチするすべてのセッションのデフォルトを設定します。351バックグラウンドセッションを開始するときのパーミッションモードは、スーパーバイザーが後で [セッションのプロセスを停止して再開](#the-supervisor-process) するときに保持されます。`claude --bg --dangerously-skip-permissions` または `claude --bg --permission-mode bypassPermissions` で起動したセッションは、ディレクトリの `defaultMode` にフォールバックする代わりに、その再開後も `bypassPermissions` のままです。

352 

353エージェントビューを開く際に `--permission-mode`、`--model`、または `--effort` のいずれかを渡して、エージェントビューからディスパッチするすべてのセッションのデフォルトを設定します：

311 354 

312```bash theme={null}355```bash theme={null}

313claude agents --permission-mode plan --model opus --effort high356claude agents --permission-mode plan --model opus --effort high

314```357```

315 358 

359`claude agents` は、`--permission-mode bypassPermissions` の短縮形として `--dangerously-skip-permissions` も受け入れ、各ディスパッチされたセッションの `Shift+Tab` サイクルで `bypassPermissions` を利用可能にするために `--allow-dangerously-skip-permissions` も受け入れます。どちらも [トップレベル CLI フラグ](/ja/cli-reference) と一致します。

360 

316<Note>361<Note>

317 `--permission-mode`、`--model`、または `--effort` を `claude agents` に渡すには、Claude Code v2.1.142 以降が必要です。以前のバージョンはこれらのフラグを unknown-option エラーで拒否します。362 `--permission-mode`、`--model`、`--effort`、または `--dangerously-skip-permissions` を `claude agents` に渡すには、Claude Code v2.1.142 以降が必要です。{/* min-version: 2.1.143 */}`claude agents` の `--allow-dangerously-skip-permissions` には v2.1.143 以降が必要です。以前のバージョンはこれらのフラグを unknown-option エラーで拒否します。

318</Note>363</Note>

319 364 

320アクティブなデフォルトはディスパッチ入力の下のフッターに表示されます。365アクティブなデフォルトはディスパッチ入力の下のフッターに表示されます。

325 370 

326### 設定、プラグイン、および MCP サーバー371### 設定、プラグイン、および MCP サーバー

327 372 

328エージェントビューは、設定、プラグイン、MCP サーバー、および追加ディレクトリを読み込むための `claude` と同じ設定フラグを受け入れます。各フラグはエージェントビュー自体に適用され、そこからディスパッチするすべてのセッションに渡されるため、この方法で読み込むプラグインまたは MCP サーバーはそれらのセッションでも利用可能です。373エージェントビューは、設定、プラグイン、MCP サーバー、および追加ディレクトリを読み込むための `claude` と同じ設定フラグを受け入れます。これらのフラグには Claude Code v2.1.142 以降が必要です。各フラグはエージェントビュー自体に適用され、そこからディスパッチするすべてのセッションに渡されるため、この方法で読み込むプラグインまたは MCP サーバーはそれらのセッションでも利用可能です。

329 374 

330| フラグ | 効果 |375| フラグ | 効果 |

331| :----------------------------------------------------------------------------------------------- | :-------------------------------------------- |376| :----------------------------------------------------------------------------------------------- | :-------------------------------------------- |

337 382 

338`--add-dir`、`--plugin-dir`、または `--mcp-config` を値ごとに 1 回繰り返します。`--add-dir a b c` などのスペース区切り形式は `claude agents` ではサポートされていません。383`--add-dir`、`--plugin-dir`、または `--mcp-config` を値ごとに 1 回繰り返します。`--add-dir a b c` などのスペース区切り形式は `claude agents` ではサポートされていません。

339 384 

340次の例は、設定オーバーライドと 1 つの追加ディレクトリでエージェントビューを開きます。385次の例は、設定オーバーライドと 1 つの追加ディレクトリでエージェントビューを開きます：

341 386 

342```bash theme={null}387```bash theme={null}

343claude agents --settings ./ci-settings.json --add-dir ../shared-lib388claude agents --settings ./ci-settings.json --add-dir ../shared-lib

348すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID は `claude --bg` でセッションを開始するときに出力され、各セッションの ID は `~/.claude/jobs/` の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。393すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID は `claude --bg` でセッションを開始するときに出力され、各セッションの ID は `~/.claude/jobs/` の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。

349 394 

350| コマンド | 目的 |395| コマンド | 目的 |

351| :--------------------- | :-------------------------------------------------------------- |396| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |

352| `claude agents` | エージェントビューを開く。`--cwd <path>` を渡して、そのディレクトリの下で開始されたセッションのみをリストします |397| `claude agents` | エージェントビューを開く |

353| `claude attach <id>` | このターミナルでセッションにアタッチします |398| `claude agents --cwd <path>` | `<path>` の下で開始されたセッションにスコープされたエージェントビューを開く |

354| `claude logs <id>` | セッションの最新出力を出力します |399| `claude attach <id>` | このターミナルでセッションにアタッチする |

355| `claude stop <id>` | セッションを停止します。`claude kill` も受け入れます |400| `claude logs <id>` | セッションの最新出力を出力する |

356| `claude respawn <id>` | 会話を保持したまま停止したセッションを再開します |401| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |

357| `claude respawn --all` | すべての停止したセッションを再開します |402| `claude respawn <id>` | セッションを再開する。会話を保持したまま実行または停止状態から再開します。例えば、更新された Claude Code バイナリを取得するため |

358| `claude rm <id>` | リストからセッションを削除します。コミットされていない変更がない場合、その worktree をクリーンアップします |403| `claude respawn --all` | すべての実行中のセッションを再開する。例えば、すべてのセッションを一度に更新された Claude Code バイナリに移動するため |

404| `claude rm <id>` | セッションとそのトランスクリプトを削除する。コミットされていない変更がない場合、セッション用に Claude が作成した worktree を削除します。それ以外の場合は、クリーンアップできるように worktree パスを出力します。自分で作成した worktree はそのままにしておきます |

405| `claude daemon status` | [supervisor](#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、およびワーカー数を出力する |

359 406 

360## バックグラウンドセッションがどのようにホストされるか407## バックグラウンドセッションがどのようにホストされるか

361 408 

383| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションのリスト。再開後に再接続するために使用 |430| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションのリスト。再開後に再接続するために使用 |

384| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態 |431| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態 |

385 432 

433スーパーバイザーの状態を直接ファイルを読むことなく検査するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブのバックグラウンドセッション数を報告します。`/doctor` には同じチェックの概要が含まれます。Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。

434 

386### エージェントビューをオフにする435### エージェントビューをオフにする

387 436 

388バックグラウンドエージェントとエージェントビューを完全にオフにするには、`disableAgentView` [設定](/ja/settings) を `true` に設定するか、`CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境変数を設定します。管理者は [マネージド設定](/ja/permissions#managed-settings) を通じてこれを強制できます。437バックグラウンドエージェントとエージェントビューを完全にオフにするには、`disableAgentView` [設定](/ja/settings) を `true` に設定するか、`CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境変数を設定します。管理者は [マネージド設定](/ja/permissions#managed-settings) を通じてこれを強制できます。

397 446 

398### エージェントビューがセッションなしで開く447### エージェントビューがセッションなしで開く

399 448 

400エージェントビューは最初のセッションをディスパッチするまで空です。下部の入力にプロンプトを入力して `Enter` を押します。449最初のセッションをディスパッチする前に、エージェントビューはセッションリストの代わりに、例のプロンプトを含む短いオンボーディングヒントを表示します。下部の入力にプロンプトを入力して `Enter` を押して、最初のセッションをディスパッチします。

401 450 

402### バックグラウンドタスクが実行中のためエージェントを開くことができない451### バックグラウンドタスクが実行中のためエージェントを開くことができない

403 452 

407 456 

408ディスパッチ入力は会話の開始ではなく、タスクの説明を期待しています。4 文字未満のプロンプトは `Too short` ヒントで拒否されるため、誤ったキー入力がセッションを開始しません。セッションで何をしたいかを説明してください。例えば `investigate the flaky checkout test` のようにします。457ディスパッチ入力は会話の開始ではなく、タスクの説明を期待しています。4 文字未満のプロンプトは `Too short` ヒントで拒否されるため、誤ったキー入力がセッションを開始しません。セッションで何をしたいかを説明してください。例えば `investigate the flaky checkout test` のようにします。

409 458 

410### マシンをウェイクアップした後、セッションが停止として表示される459### シャットダウン後、セッションが失敗として表示される

460 

461マシンをシャットダウンまたは再起動すると、実行中のバックグラウンドセッションが停止するため、次にエージェントビューを開くときに失敗として表示されます。それらのいずれかにアタッチ、ピーク表示、または返信すると、セッションは中断したところから再開します。

411 462 

412バックグラウンドセッションはスリープまたはシャットダウンを生き残りません。実行中だったセッションは、ウェイク後に停止として表示されます。それらのいずれかにアタッチ、ピーク表示、または返信すると、セッションは中断したところから再開します。すべてを一度に再開するには、`claude respawn --all` を実行します。463スリープだけではこれは発生しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。

413 464 

414### セッションがアタッチ後に応答が遅い465### セッションがアタッチ後に応答が遅い

415 466 

417 468 

418### `.claude/worktrees/` が満杯になっている469### `.claude/worktrees/` が満杯になっている

419 470 

420ワークツリーはセッションを削除するときに削除されます。セッションがクリーンアップなしで終了した場合は、プロジェクトディレクトリで `git worktree list` で残りのエントリをリストし、各エントリを `git worktree remove <path>` で削除します。[ワークツリーをクリーンアップする](/ja/worktrees#clean-up-worktrees)を参照してください。471エージェントビューでセッションを削除すると、Claude が作成したワークツリーが削除されます。`claude rm` はコミットされていない変更があるワークツリーを保持し、そのパスを出力します。プロジェクトディレクトリで `git worktree list` を使用して残りのエントリをリストし、各エントリを `git worktree remove <path>` で削除します。[ワークツリーをクリーンアップする](/ja/worktrees#clean-up-worktrees)を参照してください。

421 472 

422## 制限事項473## 制限事項

423 474 

424Agent view はリサーチプレビューであり、以下の制限事項があります。475Agent view はリサーチプレビューであり、以下の制限事項があります。

425 476 

426* **レート制限が適用される**：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。477* **レート制限が適用される**：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。

427* **セッションはローカル**：バックグラウンドセッションはマシンで実行され、スリープまたはシャットダウンすると停止します。478* **セッションはローカル**：バックグラウンドセッションはマシンで実行され、スリープ中は保持されますが、マシンがシャットダウンすると停止します。

428* **Worktrees はセッションで削除される**：セッションが独自の Worktrees でファイルを編集した場合、削除する前に変更をマージまたはプッシュしてください。479* **Claude が作成した worktrees はエージェント view のセッションで削除される**：セッションが独自の worktree でファイルを編集した場合、セッションを削除する前に変更をマージまたはプッシュしてください。`claude rm` は未コミットの変更がある worktree を保持します。自分で作成した worktree はそのまま残されます。

429 480 

430## 関連リソース481## 関連リソース

431 482 

11これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。11これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。

12 12 

13| コマンド | 説明 | 例 |13| コマンド | 説明 | 例 |

14| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |14| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------- |

15| `claude` | インタラクティブセッションを開始 | `claude` |15| `claude` | インタラクティブセッションを開始 | `claude` |

16| `claude "query"` | 初期プロンプト付きでインタラクティブセッションを開始 | `claude "explain this project"` |16| `claude "query"` | 初期プロンプト付きでインタラクティブセッションを開始 | `claude "explain this project"` |

17| `claude -p "query"` | SDK 経由でクエリを実行してから終了 | `claude -p "explain this function"` |17| `claude -p "query"` | SDK 経由でクエリを実行してから終了 | `claude -p "explain this function"` |

24| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |24| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |

25| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |25| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |

26| `claude auth status` | 認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します | `claude auth status` |26| `claude auth status` | 認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します | `claude auth status` |

27| `claude agents` | [エージェントビュー](/ja/agent-view) を開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示します | `claude agents` |27| `claude agents` | [エージェントビュー](/ja/agent-view) を開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示します。`--permission-mode`、`--model`、または `--effort` を渡して、[ディスパッチされたセッションのデフォルト](/ja/agent-view#permission-mode-model-and-effort) を設定します。トップレベルの `claude` コマンドと同様に `--settings`、`--add-dir`、`--plugin-dir`、および `--mcp-config` を受け入れます。インタラクティブターミナルが必要です | `claude agents --cwd ~/projects/my-app` |

28| `claude attach <id>` | このターミナルで [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) に接続します | `claude attach 7c5dcf5d` |28| `claude attach <id>` | このターミナルで [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) に接続します | `claude attach 7c5dcf5d` |

29| `claude auto-mode defaults` | 組み込み [auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください | `claude auto-mode defaults > rules.json` |29| `claude auto-mode defaults` | 組み込み [auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください | `claude auto-mode defaults > rules.json` |

30| `claude daemon status` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します | `claude daemon status` |

30| `claude logs <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力します | `claude logs 7c5dcf5d` |31| `claude logs <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力します | `claude logs 7c5dcf5d` |

31| `claude mcp` | Model Context Protocol（MCP）サーバーを設定 | [Claude Code MCP ドキュメント](/ja/mcp) を参照してください。 |32| `claude mcp` | Model Context Protocol（MCP）サーバーを設定 | [Claude Code MCP ドキュメント](/ja/mcp) を参照してください。 |

32| `claude plugin` | Claude Code [plugins](/ja/plugins) を管理します。エイリアス：`claude plugins`。サブコマンドについては [plugin reference](/ja/plugins-reference#cli-commands-reference) を参照してください | `claude plugin install code-review@claude-plugins-official` |33| `claude plugin` | Claude Code [plugins](/ja/plugins) を管理します。エイリアス：`claude plugins`。サブコマンドについては [plugin reference](/ja/plugins-reference#cli-commands-reference) を参照してください | `claude plugin install code-review@claude-plugins-official` |

33| `claude project purge [path]` | プロジェクトのすべてのローカル Claude Code 状態を削除します：トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴行、および `~/.claude.json` 内のプロジェクトエントリ。`[path]` を省略して、インタラクティブリストから選択します。フラグ：`--dry-run` でプレビュー、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべてのプロジェクト。[ローカルデータをクリア](/ja/claude-directory#clear-local-data) を参照してください | `claude project purge ~/work/repo --dry-run` |34| `claude project purge [path]` | プロジェクトのすべてのローカル Claude Code 状態を削除します：トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴行、および `~/.claude.json` 内のプロジェクトエントリ。`[path]` を省略して、インタラクティブリストから選択します。フラグ：`--dry-run` でプレビュー、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべてのプロジェクト。[ローカルデータをクリア](/ja/claude-directory#clear-local-data) を参照してください | `claude project purge ~/work/repo --dry-run` |

34| `claude remote-control` | [Remote Control](/ja/remote-control) サーバーを開始して、Claude.ai または Claude アプリから Claude Code を制御します。サーバーモード（ローカルインタラクティブセッションなし）で実行されます。[サーバーモードフラグ](/ja/remote-control#start-a-remote-control-session) を参照してください | `claude remote-control --name "My Project"` |35| `claude remote-control` | [Remote Control](/ja/remote-control) サーバーを開始して、Claude.ai または Claude アプリから Claude Code を制御します。サーバーモード（ローカルインタラクティブセッションなし）で実行されます。[サーバーモードフラグ](/ja/remote-control#start-a-remote-control-session) を参照してください | `claude remote-control --name "My Project"` |

35| `claude respawn <id>` | 会話を保持したまま、停止した [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) を再開します。`--all` を使用してすべての停止したセッションを再開します | `claude respawn 7c5dcf5d` |36| `claude respawn <id>` | 会話を保持したまま、[バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) を再開します。実行中または停止中。`--all` を使用してすべての実行中セッションを再開します。たとえば、更新された Claude Code バイナリを取得するため | `claude respawn 7c5dcf5d` |

36| `claude rm <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) をリストから削除します | `claude rm 7c5dcf5d` |37| `claude rm <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) をリストから削除します | `claude rm 7c5dcf5d` |

37| `claude setup-token` | CI とスクリプト用の長期間有効な OAuth トークンを生成します。ターミナルにトークンを出力し、保存しません。Claude サブスクリプションが必要です。[長期間有効なトークンを生成](/ja/authentication#generate-a-long-lived-token) を参照してください | `claude setup-token` |38| `claude setup-token` | CI とスクリプト用の長期間有効な OAuth トークンを生成します。ターミナルにトークンを出力し、保存しません。Claude サブスクリプションが必要です。[長期間有効なトークンを生成](/ja/authentication#generate-a-long-lived-token) を参照してください | `claude setup-token` |

38| `claude stop <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) を停止します。`claude kill` も受け入れます | `claude stop 7c5dcf5d` |39| `claude stop <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) を停止します。`claude kill` も受け入れます | `claude stop 7c5dcf5d` |

68| `--effort` | 現在のセッションの [努力レベル](/ja/model-config#adjust-effort-level) を設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[`effortLevel`](/ja/settings#available-settings) 設定をこのセッションでオーバーライドし、永続化されません | `claude --effort high` |69| `--effort` | 現在のセッションの [努力レベル](/ja/model-config#adjust-effort-level) を設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[`effortLevel`](/ja/settings#available-settings) 設定をこのセッションでオーバーライドし、永続化されません | `claude --effort high` |

69| `--enable-auto-mode` | {/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください | `claude --permission-mode auto` |70| `--enable-auto-mode` | {/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください | `claude --permission-mode auto` |

70| `--exclude-dynamic-system-prompt-sections` | システムプロンプトからマシンごとのセクション（作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ）を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください | `claude -p --exclude-dynamic-system-prompt-sections "query"` |71| `--exclude-dynamic-system-prompt-sections` | システムプロンプトからマシンごとのセクション（作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ）を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

71| `--fallback-model` | デフォルトモデルが過負荷の場合、指定されたモデルへの自動フォールバックを有効にします（プリントモードのみ） | `claude -p --fallback-model sonnet "query"` |72| `--fallback-model` | デフォルトモデルが過負荷の場合、指定されたモデルへの自動フォールバックを有効にします。プリントモード（`-p`）と [バックグラウンドセッション](/ja/agent-view) で有効になります。バックグラウンドセッションは非インタラクティブで実行されます。インタラクティブセッションでは無視されます | `claude -p --fallback-model sonnet "query"` |

72| `--fork-session` | 再開時に、元のセッション ID を再利用する代わりに新しいセッション ID を作成します（`--resume` または `--continue` と一緒に使用） | `claude --resume abc123 --fork-session` |73| `--fork-session` | 再開時に、元のセッション ID を再利用する代わりに新しいセッション ID を作成します（`--resume` または `--continue` と一緒に使用） | `claude --resume abc123 --fork-session` |

73| `--from-pr` | 特定のプルリクエストにリンクされたセッションを再開します。PR 番号、GitHub または GitHub Enterprise PR URL、GitLab マージリクエスト URL、または Bitbucket プルリクエスト URL を受け入れます。Claude がプルリクエストを作成するときに、セッションは自動的にリンクされます | `claude --from-pr 123` |74| `--from-pr` | 特定のプルリクエストにリンクされたセッションを再開します。PR 番号、GitHub または GitHub Enterprise PR URL、GitLab マージリクエスト URL、または Bitbucket プルリクエスト URL を受け入れます。Claude がプルリクエストを作成するときに、セッションは自動的にリンクされます | `claude --from-pr 123` |

74| `--ide` | 起動時に、正確に 1 つの有効な IDE が利用可能な場合、自動的に IDE に接続します | `claude --ide` |75| `--ide` | 起動時に、正確に 1 つの有効な IDE が利用可能な場合、自動的に IDE に接続します | `claude --ide` |

29 29 

30管理者が組織の Code Review を[有効にする](#set-up-code-review)と、リポジトリの設定された動作に応じて、PR が開かれたとき、すべてのプッシュ時、または手動でリクエストされたときにレビューがトリガーされます。PR で `@claude review` と[コメントすると](#manually-trigger-reviews)、任意のモードでレビューが開始されます。30管理者が組織の Code Review を[有効にする](#set-up-code-review)と、リポジトリの設定された動作に応じて、PR が開かれたとき、すべてのプッシュ時、または手動でリクエストされたときにレビューがトリガーされます。PR で `@claude review` と[コメントすると](#manually-trigger-reviews)、任意のモードでレビューが開始されます。

31 31 

32レビューが実行されると、複数のエージェントが Anthropic インフラストラクチャ上で並行して diff と周囲のコードを分析します。各エージェントは異なるクラスの問題を探し、その後、検証ステップが候補を実際のコード動作に対してチェックして、偽陽性を除外します。結果は重複排除され、重大度でランク付けされ、問題が見つかった特定の行にインラインコメントとして投稿されます。問題が見つからない場合、Claude は PR に短い確認コメントを投稿します。32レビューが実行されると、複数のエージェントが Anthropic インフラストラクチャ上で並行して diff と周囲のコードを分析します。各エージェントは異なるクラスの問題を探し、その後、検証ステップが候補を実際のコード動作に対してチェックして、偽陽性を除外します。結果は重複排除され、重大度でランク付けされ、問題が見つかった特定の行にインラインコメントとして投稿され、レビュー本文に概要が記載されます。問題が見つからない場合、Code Review は GitHub チェック実行を更新して、問題が検出されなかったことを表示します。Claude は PR に短い確認コメントを投稿することもあります。

33 33 

34レビューはコストが PR のサイズと複雑さに応じてスケーリングされ、平均 20 分で完了します。管理者は[分析ダッシュボード](#view-usage)を通じてレビューアクティビティと支出を監視できます。34レビューはコストが PR のサイズと複雑さに応じてスケーリングされ、平均 20 分で完了します。管理者は[分析ダッシュボード](#view-usage)を通じてレビューアクティビティと支出を監視できます。

35 35 

225 225 

226## 料金226## 料金

227 227 

228Code Review はトークン使用量に基づいて請求されます。各レビューは平均 \$15～25 のコストで、PR サイズ、コードベースの複雑さ、検証が必要な問題の数に応じてスケーリングされます。Code Review の使用は[extra usage](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を通じて個別に請求され、プランの含まれた使用量にはカウントされません。228Code Review はトークン使用量に基づいて請求されます。各レビューは平均 \$15～25 のコストで、PR サイズ、コードベースの複雑さ、検証が必要な問題の数に応じてスケーリングされます。Code Review の使用は[usage credits](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)を通じて個別に請求され、プランの含まれた使用量にはカウントされません。

229 229 

230選択するレビュートリガーは総コストに影響します：230選択するレビュートリガーは総コストに影響します：

231 231 

60| `/diff` | コミットされていない変更と各ターンの diff を表示するインタラクティブ diff ビューアを開きます。左右矢印を使用して現在の git diff と個別の Claude ターンを切り替え、上下矢印でファイルをブラウズします |60| `/diff` | コミットされていない変更と各ターンの diff を表示するインタラクティブ diff ビューアを開きます。左右矢印を使用して現在の git diff と個別の Claude ターンを切り替え、上下矢印でファイルをブラウズします |

61| `/doctor` | Claude Code のインストールと設定を診断および検証します。結果はステータスアイコン付きで表示されます。`f` を押して Claude に報告された問題を修正させます |61| `/doctor` | Claude Code のインストールと設定を診断および検証します。結果はステータスアイコン付きで表示されます。`f` を押して Claude に報告された問題を修正させます |

62| `/effort [level\|auto]` | モデルの[努力レベル](/ja/model-config#adjust-effort-level)を設定します。`low`、`medium`、`high`、`xhigh`、または `max` を受け入れます。利用可能なレベルはモデルに依存し、`max` はセッションのみです。`auto` はモデルのデフォルトにリセットします。引数なしで、インタラクティブスライダーを開きます。左右矢印でレベルを選択し、`Enter` で適用します。現在の応答の完了を待たずに即座に有効になります |62| `/effort [level\|auto]` | モデルの[努力レベル](/ja/model-config#adjust-effort-level)を設定します。`low`、`medium`、`high`、`xhigh`、または `max` を受け入れます。利用可能なレベルはモデルに依存し、`max` はセッションのみです。`auto` はモデルのデフォルトにリセットします。引数なしで、インタラクティブスライダーを開きます。左右矢印でレベルを選択し、`Enter` で適用します。現在の応答の完了を待たずに即座に有効になります |

63| `/exit` | CLI を終了します。エイリアス: `/quit` |63| `/exit` | CLI を終了します。接続されている[バックグラウンドセッション](/ja/agent-view#attach-to-a-session)では、これはデタッチされ、セッションは実行を続けます。エイリアス: `/quit` |

64| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するダイアログを開きます |64| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するダイアログを開きます |

65| `/extra-usage` | レート制限に達したときに作業を続行するための追加使用量を構成します |

66| `/fast [on\|off]` | [高速モード](/ja/fast-mode)のオン/オフを切り替えます |65| `/fast [on\|off]` | [高速モード](/ja/fast-mode)のオン/オフを切り替えます |

67| `/feedback [report]` | Claude Code に関するフィードバックを送信します。エイリアス: `/bug` |66| `/feedback [report]` | Claude Code に関するフィードバックを送信します。エイリアス: `/bug` |

68| `/fewer-permission-prompts` | **[スキル](/ja/skills#bundled-skills)。** トランスクリプトで一般的な読み取り専用 Bash と MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先度付きの許可リストを追加して権限プロンプトを削減します |67| `/fewer-permission-prompts` | **[スキル](/ja/skills#bundled-skills)。** トランスクリプトで一般的な読み取り専用 Bash と MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先度付きの許可リストを追加して権限プロンプトを削減します |

121| `/theme` | カラーテーマを変更します。ターミナルのダークまたはライトモードに従う `auto` オプション、ライトおよびダークバリアント、色覚異常対応（ダルトン化）テーマ、ANSI テーマ（ターミナルのカラーパレットを使用）、および `~/.claude/themes/` またはプラグインからの[カスタムテーマ](/ja/terminal-config#create-a-custom-theme)を含みます。**新しいカスタムテーマ…** を選択して作成します |120| `/theme` | カラーテーマを変更します。ターミナルのダークまたはライトモードに従う `auto` オプション、ライトおよびダークバリアント、色覚異常対応（ダルトン化）テーマ、ANSI テーマ（ターミナルのカラーパレットを使用）、および `~/.claude/themes/` またはプラグインからの[カスタムテーマ](/ja/terminal-config#create-a-custom-theme)を含みます。**新しいカスタムテーマ…** を選択して作成します |

122| `/tui [default\|fullscreen]` | ターミナル UI レンダラーを設定し、会話を保持したまま再起動します。`fullscreen` は[ちらつきなしの alt-screen レンダラー](/ja/fullscreen)を有効にします。引数なしで、アクティブなレンダラーを出力します |121| `/tui [default\|fullscreen]` | ターミナル UI レンダラーを設定し、会話を保持したまま再起動します。`fullscreen` は[ちらつきなしの alt-screen レンダラー](/ja/fullscreen)を有効にします。引数なしで、アクティブなレンダラーを出力します |

123| `/ultraplan <prompt>` | [ultraplan](/ja/ultraplan) セッションで計画を作成し、ブラウザでレビューし、リモートで実行するか、ターミナルに送り返します |122| `/ultraplan <prompt>` | [ultraplan](/ja/ultraplan) セッションで計画を作成し、ブラウザでレビューし、リモートで実行するか、ターミナルに送り返します |

124| `/ultrareview [PR]` | [ultrareview](/ja/ultrareview) を使用してクラウドサンドボックスで深い複数エージェントコードレビューを実行します。Pro と Max に 3 つの無料実行が含まれ、その後は [extra usage](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) が必要です |123| `/ultrareview [PR]` | [ultrareview](/ja/ultrareview) を使用してクラウドサンドボックスで深い複数エージェントコードレビューを実行します。Pro と Max に 3 つの無料実行が含まれ、その後は [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) が必要です |

125| `/upgrade` | アップグレードページを開いて、より高いプランティアに切り替えます |124| `/upgrade` | アップグレードページを開いて、より高いプランティアに切り替えます |

126| `/usage` | セッションコスト、プラン使用制限、およびアクティビティ統計を表示します。サブスクリプション固有の詳細については、[コスト追跡ガイド](/ja/costs#using-the-%2Fusage-command)を参照してください。`/cost` と `/stats` はエイリアスです |125| `/usage` | セッションコスト、プラン使用制限、およびアクティビティ統計を表示します。サブスクリプション固有の詳細については、[コスト追跡ガイド](/ja/costs#using-the-%2Fusage-command)を参照してください。`/cost` と `/stats` はエイリアスです |

126| `/usage-credits` | 制限に達したときに作業を続行するための usage credits を構成します。以前は `/extra-usage` |

127| `/vim` | {/* max-version: 2.1.91 */}v2.1.92 で削除。Vim と通常編集モード間を切り替えるには、`/config` → エディタモードを使用してください |127| `/vim` | {/* max-version: 2.1.91 */}v2.1.92 で削除。Vim と通常編集モード間を切り替えるには、`/config` → エディタモードを使用してください |

128| `/voice [hold\|tap\|off]` | [音声ディクテーション](/ja/voice-dictation)を切り替えるか、特定のモードで有効にします。Claude.ai アカウントが必要です |128| `/voice [hold\|tap\|off]` | [音声ディクテーション](/ja/voice-dictation)を切り替えるか、特定のモードで有効にします。Claude.ai アカウントが必要です |

129| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを [Claude Code on the web](/ja/web-quickstart#connect-from-your-terminal) に接続します。GitHub が接続されていない場合、`/schedule` は自動的にこれを求めます |129| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを [Claude Code on the web](/ja/web-quickstart#connect-from-your-terminal) に接続します。GitHub が接続されていない場合、`/schedule` は自動的にこれを求めます |

87ほとんどの設定の問題は、小さな場所とシンタックスルールのセットに遡ります。バグを想定する前にこれらを確認してください：87ほとんどの設定の問題は、小さな場所とシンタックスルールのセットに遡ります。バグを想定する前にこれらを確認してください：

88 88 

89| 症状 | 原因 | 修正 |89| 症状 | 原因 | 修正 |

90| :--------------------------------------------------------- | :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |90| :--------------------------------------------------------- | :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

91| フックが発火しない | `matcher` が JSON 配列ではなく文字列である | 複数のツールをマッチするために `\|` を含む単一の文字列を使用します。例えば `"Edit\|Write"` です。[マッチャーパターン](/ja/hooks#matcher-patterns) を参照してください。 |91| フックが発火しない | `matcher` が JSON 配列ではなく文字列である | 複数のツールをマッチするために `\|` を含む単一の文字列を使用します。例えば `"Edit\|Write"` です。[マッチャーパターン](/ja/hooks#matcher-patterns) を参照してください。 |

92| フックが発火しない | `matcher` 値が小文字です。例えば `"bash"` | マッチングは大文字と小文字を区別します。ツール名は大文字です：`Bash`、`Edit`、`Write`、`Read`。 |92| フックが発火しない | `matcher` 値が小文字です。例えば `"bash"` | マッチングは大文字と小文字を区別します。ツール名は大文字です：`Bash`、`Edit`、`Write`、`Read`。 |

93| フックが発火しない | Hooks がスタンドアロンの `.claude/hooks.json` ファイルにあります | スタンドアロンの hooks ファイルはありません。`settings.json` の `"hooks"` キーの下に hooks を定義します。[フック設定](/ja/hooks) を参照してください。 |93| フックが発火しない | Hooks がスタンドアロンファイルではなく `settings.json` に定義されていません | プロジェクトまたはユーザー設定用のスタンドアロン hooks ファイルはありません。`settings.json` の `"hooks"` キーの下に hooks を定義します。[プラグイン](/ja/plugins-reference#hooks) のみが別の `hooks/hooks.json` を読み込みます。[フック設定](/ja/hooks) を参照してください。 |

94| グローバルに設定された権限、hooks、env が無視されます | 設定が `~/.claude.json` に追加されました | `~/.claude.json` はアプリ状態と UI トグルを保持します。`permissions`、`hooks`、`env` は `~/.claude/settings.json` に属します。これらは 2 つの異なるファイルです。 |94| グローバルに設定された権限、hooks、env が無視されます | 設定が `~/.claude.json` に追加されました | `~/.claude.json` はアプリ状態と UI トグルを保持します。`permissions`、`hooks`、`env` は `~/.claude/settings.json` に属します。これらは 2 つの異なるファイルです。 |

95| `settings.json` 値が無視されているように見えます | 同じキーが `settings.local.json` で設定されています | `settings.local.json` は `settings.json` をオーバーライドし、両方とも `~/.claude/settings.json` をオーバーライドします。[設定の優先順位](/ja/settings#how-scopes-interact) を参照してください。 |95| `settings.json` 値が無視されているように見えます | 同じキーが `settings.local.json` で設定されています | `settings.local.json` は `settings.json` をオーバーライドし、両方とも `~/.claude/settings.json` をオーバーライドします。[設定の優先順位](/ja/settings#how-scopes-interact) を参照してください。 |

96| スキルが `/skills` に表示されません | スキルファイルがフォルダ内ではなく `.claude/skills/name.md` にあります | `SKILL.md` を含むフォルダを使用します：`.claude/skills/name/SKILL.md`。 |96| スキルが `/skills` に表示されません | スキルファイルがフォルダ内ではなく `.claude/skills/name.md` にあります | `SKILL.md` を含むフォルダを使用します：`.claude/skills/name/SKILL.md`。 |

97| スキルが `/skills` に表示されますが Claude が呼び出しません | スキルのフロントマターに `disable-model-invocation: true` があるか、その説明がリクエストの言い方と一致しません | `/skills` のバッジを確認します：「user-only」ラベルは Claude が独自にトリガーしないことを意味します。[スキル呼び出し](/ja/skills) を参照してください。 |97| スキルが `/skills` に表示されますが Claude が呼び出しません | スキルのフロントマターに `disable-model-invocation: true` があるか、その説明がリクエストの言い方と一致しません | `/skills` のバッジを確認します：「user-only」ラベルは Claude が独自にトリガーしないことを意味します。[スキル呼び出し](/ja/skills) を参照してください。 |

98| サブディレクトリの `CLAUDE.md` 指示が無視されているように見えます | サブディレクトリファイルはセッション開始時ではなくオンデマンドで読み込まれます | Claude が Read ツールでそのディレクトリ内のファイルを読むときに読み込まれます。起動時ではなく、ファイルを書き込みまたは作成するときではありません。[CLAUDE.md ファイルの読み込み方法](/ja/memory#how-claude-md-files-load) を参照してください。 |98| サブディレクトリの `CLAUDE.md` 指示が無視されているように見えます | サブディレクトリファイルはセッション開始時ではなくオンデマンドで読み込まれます | Claude が Read ツールでそのディレクトリ内のファイルを読むときに読み込まれます。起動時ではなく、ファイルを書き込みまたは作成するときではありません。[CLAUDE.md ファイルの読み込み方法](/ja/memory#how-claude-md-files-load) を参照してください。 |

99| サブエージェントが `CLAUDE.md` 指示を無視します | サブエージェントは常にプロジェクトメモリを継承するわけではありません | 重要なルールをエージェントファイル本体に入れます。これはサブエージェントのシステムプロンプトになります。[サブエージェント設定](/ja/sub-agents) を参照してください。 |99| サブエージェントが `CLAUDE.md` 指示を無視します | 組み込みの Explore および Plan エージェントは `CLAUDE.md` をスキップします。カスタムサブエージェントはメイン会話と同じ方法で読み込みます | Explore または Plan の場合、委譲プロンプトで指示を再度述べてください。カスタムサブエージェントの場合、重要な指示をエージェントファイル本体に入れます。これはエージェントのシステムプロンプトになります。[起動時に読み込まれるもの](/ja/sub-agents#what-loads-at-startup) を参照してください。 |

100| クリーンアップロジックがセッション終了時に実行されません | `SessionEnd` フックが設定されていません | `settings.json` に `SessionEnd` フックを追加します。[フックイベントリスト](/ja/hooks#hook-events) を参照してください。 |100| クリーンアップロジックがセッション終了時に実行されません | `SessionEnd` フックが設定されていません | `settings.json` に `SessionEnd` フックを追加します。[フックイベントリスト](/ja/hooks#hook-events) を参照してください。 |

101| `.mcp.json` の MCP サーバーが読み込まれません | ファイルが `.claude/` の下にあるか、Claude Desktop の設定形式を使用しています | プロジェクト MCP 設定はリポジトリルートの `.mcp.json` に置かれます。`.claude/` 内ではありません。[MCP 設定](/ja/mcp) を参照してください。 |101| `.mcp.json` の MCP サーバーが読み込まれません | ファイルが `.claude/` の下にあるか、Claude Desktop の設定形式を使用しています | プロジェクト MCP 設定はリポジトリルートの `.mcp.json` に置かれます。`.claude/` 内ではありません。[MCP 設定](/ja/mcp) を参照してください。 |

102| `settings.json` の `mcpServers` の下に追加された MCP サーバーが表示されません | `settings.json` は `mcpServers` キーを読み込みません | プロジェクトサーバーをリポジトリルートの `.mcp.json` で定義するか、`claude mcp add --scope user` を実行してユーザースコープサーバーを追加します。[MCP 設定](/ja/mcp) を参照してください。 |102| `settings.json` の `mcpServers` の下に追加された MCP サーバーが表示されません | `settings.json` は `mcpServers` キーを読み込みません | プロジェクトサーバーをリポジトリルートの `.mcp.json` で定義するか、`claude mcp add --scope user` を実行してユーザースコープサーバーを追加します。[MCP 設定](/ja/mcp) を参照してください。 |

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Claude Code Desktop を使用する5# Desktop application

6 6 

7> Claude Code Desktop をさらに活用する：Git 分離による並列セッション、ドラッグアンドドロップペインレイアウト、統合ターミナルとファイルエディタ、サイドチャット、コンピュータ使用、電話から Dispatch セッションを送信、ビジュアル diff レビュー、アプリプレビュー、PR 監視、コネクタ、エンタープライズ設定。7> Claude Code Desktop をさらに活用する：Git 分離による並列セッション、ドラッグアンドドロップペインレイアウト、統合ターミナルとファイルエディタ、サイドチャット、コンピュータ使用、電話から Dispatch セッションを送信、ビジュアル diff レビュー、アプリプレビュー、PR 監視、コネクタ、エンタープライズ設定。

8 8 

707* **Linux**：デスクトップアプリは macOS と Windows でのみ利用可能です。Linux では、[CLI](/ja/quickstart)を使用します。707* **Linux**：デスクトップアプリは macOS と Windows でのみ利用可能です。Linux では、[CLI](/ja/quickstart)を使用します。

708* **インラインコード提案**：Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。708* **インラインコード提案**：Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。

709* **エージェントチーム**：マルチエージェントオーケストレーションは [CLI](/ja/agent-teams) および [Agent SDK](/ja/headless) を通じて利用可能であり、Desktop では利用できません。709* **エージェントチーム**：マルチエージェントオーケストレーションは [CLI](/ja/agent-teams) および [Agent SDK](/ja/headless) を通じて利用可能であり、Desktop では利用できません。

710* **ターミナルダイアログコマンド**：`/permissions`、`/config`、`/agents`、`/doctor` などのターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは利用できず、`isn't available in this environment` で応答します。[設定ファイル](/ja/settings)を直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。

710 711 

711## トラブルシューティング712## トラブルシューティング

712 713 

138 </Step>138 </Step>

139 139 

140 <Step title="プラグインをインストールする">140 <Step title="プラグインをインストールする">

141 プラグインを選択してその詳細を表示し、インストール スコープを選択します：141 プラグインを選択してその詳細を表示します。{/* min-version: 2.1.143 */}Claude Code v2.1.143 以降では、詳細ペインに **Context cost** の推定値が含まれており、インストール前に、プラグインが毎ターン [コンテキストウィンドウ](/ja/features-overview#understand-context-costs) に追加するトークン数を確認できます。

142 

143 インストール スコープを選択します：

142 144 

143 * **User scope**: すべてのプロジェクト全体で自分用にインストール145 * **User scope**: すべてのプロジェクト全体で自分用にインストール

144 * **Project scope**: このリポジトリのすべてのコラボレーター用にインストール146 * **Project scope**: このリポジトリのすべてのコラボレーター用にインストール

100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic バウンドの非必須トラフィックがブロックされている場合、「Claude の調子はどうですか？」セッション品質調査を独自の [OpenTelemetry コレクター](/ja/monitoring-usage) にルーティングするには `1` に設定します。調査の評価は OTEL イベントとしてのみ設定されたコレクターに出力されます。このモードでは調査データは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` と組織製品フィードバックポリシーが優先されます |100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic バウンドの非必須トラフィックがブロックされている場合、「Claude の調子はどうですか？」セッション品質調査を独自の [OpenTelemetry コレクター](/ja/monitoring-usage) にルーティングするには `1` に設定します。調査の評価は OTEL イベントとしてのみ設定されたコレクターに出力されます。このモードでは調査データは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` と組織製品フィードバックポリシーが優先されます |

101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | ツール呼び出し入力が Claude によって生成されるときに API からストリーミングされるかどうかを制御します。これがない場合、大きなツール入力（長いファイル書き込みなど）は Claude が生成を完了した後にのみ到着します。これは、ハングしているように見える可能性があります。Anthropic API 直接接続でデフォルトで有効です。Bedrock と Vertex では、デプロイされたコンテナがサポートしているモデルごとに有効です。`0` に設定してオプトアウトします。`1` に設定して、`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を通じてプロキシにルーティングする場合に強制的に有効にします。Foundry と [ゲートウェイ](/ja/llm-gateway) 接続ではデフォルトでオフです |101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | ツール呼び出し入力が Claude によって生成されるときに API からストリーミングされるかどうかを制御します。これがない場合、大きなツール入力（長いファイル書き込みなど）は Claude が生成を完了した後にのみ到着します。これは、ハングしているように見える可能性があります。Anthropic API 直接接続でデフォルトで有効です。Bedrock と Vertex では、デプロイされたコンテナがサポートしているモデルごとに有効です。`0` に設定してオプトアウトします。`1` に設定して、`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を通じてプロキシにルーティングする場合に強制的に有効にします。Foundry と [ゲートウェイ](/ja/llm-gateway) 接続ではデフォルトでオフです |

102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、または内部プロキシなどの Anthropic 互換ゲートウェイを指している場合、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを入力するには `1` に設定します。共有 API キーでバックアップされたゲートウェイはそれ以外の場合、すべてのユーザーにキーがアクセスできるすべてのモデルを表示するため、デフォルトではオフです。検出されたモデルは依然として [`availableModels`](/ja/settings#available-settings) 許可リストでフィルタリングされます |102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、または内部プロキシなどの Anthropic 互換ゲートウェイを指している場合、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを入力するには `1` に設定します。共有 API キーでバックアップされたゲートウェイはそれ以外の場合、すべてのユーザーにキーがアクセスできるすべてのモデルを表示するため、デフォルトではオフです。検出されたモデルは依然として [`availableModels`](/ja/settings#available-settings) 許可リストでフィルタリングされます |

103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | [高速モード](/ja/fast-mode) を Claude Opus 4.7 で実行するには `1` に設定します。Opus 4.6 の代わりに。変数が設定されている場合、`/fast` は Opus 4.7 に切り替わります。設定されていない場合、`/fast` は引き続き Opus 4.6 を使用します |103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}v2.1.142 で削除されました。[高速モード](/ja/fast-mode) は Opus 4.7 がデフォルトです。Opus 4.6 を保持するには `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` を設定します |

104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | プロンプト提案を無効にするには `false` に設定します（`/config` の「プロンプト提案」トグル）。これらは Claude が応答した後にプロンプト入力に表示される灰色の予測です。[プロンプト提案](/ja/interactive-mode#prompt-suggestions) を参照してください |104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | プロンプト提案を無効にするには `false` に設定します（`/config` の「プロンプト提案」トグル）。これらは Claude が応答した後にプロンプト入力に表示される灰色の予測です。[プロンプト提案](/ja/interactive-mode#prompt-suggestions) を参照してください |

105| `CLAUDE_CODE_ENABLE_TASKS` | 非対話モード（`-p` フラグ）でタスク追跡システムを有効にするには `1` に設定します。タスクは対話モードではデフォルトでオンです。[タスクリスト](/ja/interactive-mode#task-list) を参照してください |105| `CLAUDE_CODE_ENABLE_TASKS` | セッションが構造化 Task ツール（`TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList`）を使用するか、従来の `TodoWrite` ツールを使用するかを制御します。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、Task ツールはすべてのモードでデフォルトです。`TodoWrite` に戻すには `0` に設定します。[タスクリスト](/ja/interactive-mode#task-list) と [Task ツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools) を参照してください |

106| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry データ収集をメトリクスとログ用に有効にするには `1` に設定します。OTel エクスポーターを設定する前に必須です。[監視](/ja/monitoring-usage) を参照してください |106| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry データ収集をメトリクスとログ用に有効にするには `1` に設定します。OTel エクスポーターを設定する前に必須です。[監視](/ja/monitoring-usage) を参照してください |

107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になった後、自動的に終了するまで待機する時間（ミリ秒）。SDK モードを使用した自動化されたワークフローとスクリプトに役立ちます |107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になった後、自動的に終了するまで待機する時間（ミリ秒）。SDK モードを使用した自動化されたワークフローとスクリプトに役立ちます |

108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/ja/agent-teams) を有効にするには `1` に設定します。エージェントチームは実験的であり、デフォルトでは無効です |108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/ja/agent-teams) を有効にするには `1` に設定します。エージェントチームは実験的であり、デフォルトでは無効です |

130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定されている場合、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必須です。自動化された環境での認証のプロビジョニングに役立ちます |130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定されている場合、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必須です。自動化された環境での認証のプロビジョニングに役立ちます |

131| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンが発行されたスペース区切りの OAuth スコープ（例：`"user:profile user:inference user:sessions:claude_code"`）。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |131| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンが発行されたスペース区切りの OAuth スコープ（例：`"user:profile user:inference user:sessions:claude_code"`）。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |

132| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 認証用の OAuth アクセストークン。SDK および自動化された環境での `/login` の代替。キーチェーンに保存された認証情報よりも優先されます。[`claude setup-token`](/ja/authentication#generate-a-long-lived-token) で生成します |132| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 認証用の OAuth アクセストークン。SDK および自動化された環境での `/login` の代替。キーチェーンに保存された認証情報よりも優先されます。[`claude setup-token`](/ja/authentication#generate-a-long-lived-token) で生成します |

133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | [高速モード](/ja/fast-mode) を Claude Opus 4.6 で保持するには `1` に設定します。`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` より優先されるため、デフォルトの変更方法に関係なく Opus 4.6 をピンする必要がある場合に設定します |133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | [高速モード](/ja/fast-mode) を Claude Opus 4.6 で保持するには `1` に設定します。デフォルトの Opus 4.7 の代わりに。変数が設定されている場合、`/fast` は Opus 4.6 で実行されます。設定されていない場合、`/fast` は Opus 4.7 で実行されます |

134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュするためのタイムアウト（ミリ秒）（デフォルト：5000）。[監視](/ja/monitoring-usage) を参照してください |134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュするためのタイムアウト（ミリ秒）（デフォルト：5000）。[監視](/ja/monitoring-usage) を参照してください |

135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的 OpenTelemetry ヘッダーをリフレッシュする間隔（ミリ秒）（デフォルト：1740000 / 29 分）。[動的ヘッダー](/ja/monitoring-usage#dynamic-headers) を参照してください |135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的 OpenTelemetry ヘッダーをリフレッシュする間隔（ミリ秒）（デフォルト：1740000 / 29 分）。[動的ヘッダー](/ja/monitoring-usage#dynamic-headers) を参照してください |

136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するためのタイムアウト（ミリ秒）（デフォルト：2000）。終了時にメトリクスがドロップされる場合は増やしてください。[監視](/ja/monitoring-usage) を参照してください |136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するためのタイムアウト（ミリ秒）（デフォルト：2000）。終了時にメトリクスがドロップされる場合は増やしてください。[監視](/ja/monitoring-usage) を参照してください |

141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `git pull` が失敗した場合、既存のマーケットプレイスキャッシュを保持するには `1` に設定します。ワイプして再クローンする代わりに。オフラインまたはエアギャップ環境で役立ちます。再クローンは同じ方法で失敗します。[オフライン環境でのマーケットプレイス更新の失敗](/ja/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) を参照してください |141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `git pull` が失敗した場合、既存のマーケットプレイスキャッシュを保持するには `1` に設定します。ワイプして再クローンする代わりに。オフラインまたはエアギャップ環境で役立ちます。再クローンは同じ方法で失敗します。[オフライン環境でのマーケットプレイス更新の失敗](/ja/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) を参照してください |

142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` プラグインソースを SSH の代わりに HTTPS でクローンするには `1` に設定します。CI ランナー、コンテナ、または `github.com` 用に設定された SSH キーがない環境で役立ちます |142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` プラグインソースを SSH の代わりに HTTPS でクローンするには `1` に設定します。CI ランナー、コンテナ、または `github.com` 用に設定された SSH キーがない環境で役立ちます |

143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:` で、Windows では `;` で区切られます。事前入力されたプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code はこれらのディレクトリからマーケットプレイスを登録し、再クローンなしで事前キャッシュされたプラグインを使用します。[コンテナ用のプラグインを事前入力](/ja/plugin-marketplaces#pre-populate-plugins-for-containers) を参照してください |143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:` で、Windows では `;` で区切られます。事前入力されたプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code はこれらのディレクトリからマーケットプレイスを登録し、再クローンなしで事前キャッシュされたプラグインを使用します。[コンテナ用のプラグインを事前入力](/ja/plugin-marketplaces#pre-populate-plugins-for-containers) を参照してください |

144| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Claude Code が PowerShell をスポーンするときに `-ExecutionPolicy Bypass` を渡すことを停止するには `1` に設定します。ツール呼び出し、フック、ステータスラインコマンドの場合、マシンの有効な実行ポリシーを尊重します。デフォルトでは Claude Code はプロセススコープでバイパスを実行するため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関係なく、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |

144| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を埋め込み、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、`CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などのプロバイダー選択、エンドポイント、認証変数は設定ファイルで無視されるため、ユーザー設定はホストのルーティングをオーバーライドできません。Bedrock、Vertex、Foundry の自動テレメトリオプトアウトもスキップされるため、テレメトリは標準の `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/ja/data-usage#default-behaviors-by-api-provider) を参照してください |145| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を埋め込み、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、`CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などのプロバイダー選択、エンドポイント、認証変数は設定ファイルで無視されるため、ユーザー設定はホストのルーティングをオーバーライドできません。Bedrock、Vertex、Foundry の自動テレメトリオプトアウトもスキップされるため、テレメトリは標準の `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/ja/data-usage#default-behaviors-by-api-provider) を参照してください |

145| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | プロキシが呼び出し元の代わりに DNS 解決を実行できるようにするには `1` に設定します。プロキシがホスト名解決を処理する必要がある環境でオプトインします |146| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | プロキシが呼び出し元の代わりに DNS 解決を実行できるようにするには `1` に設定します。プロキシがホスト名解決を処理する必要がある環境でオプトインします |

146| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/ja/claude-code-on-the-web) として実行されている場合に自動的に `true` に設定されます。フックまたはセットアップスクリプトからこれを読み取って、クラウド環境にいるかどうかを検出します |147| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/ja/claude-code-on-the-web) として実行されている場合に自動的に `true` に設定されます。フックまたはセットアップスクリプトからこれを読み取って、クラウド環境にいるかどうかを検出します |

153| `CLAUDE_CODE_SESSION_ID` | Bash と PowerShell ツールサブプロセスで現在のセッション ID に自動的に設定されます。[フック](/ja/hooks) に渡される `session_id` フィールドと一致します。`/clear` で更新されます。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |154| `CLAUDE_CODE_SESSION_ID` | Bash と PowerShell ツールサブプロセスで現在のセッション ID に自動的に設定されます。[フック](/ja/hooks) に渡される `session_id` フィールドと一致します。`/clear` で更新されます。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |

154| `CLAUDE_CODE_SHELL` | 自動シェル検出をオーバーライドします。ログインシェルが優先作業シェルと異なる場合に役立ちます（例：`bash` vs `zsh`） |155| `CLAUDE_CODE_SHELL` | 自動シェル検出をオーバーライドします。ログインシェルが優先作業シェルと異なる場合に役立ちます（例：`bash` vs `zsh`） |

155| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code がスポーンするシェルコマンドをラップするコマンドプレフィックス：Bash ツール呼び出し、[フック](/ja/hooks) コマンド、stdio [MCP サーバー](/ja/mcp) スタートアップコマンド。ログまたは監査に役立ちます。例：`/path/to/logger.sh` を設定すると、各コマンドが `/path/to/logger.sh <command>` として実行されます |156| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code がスポーンするシェルコマンドをラップするコマンドプレフィックス：Bash ツール呼び出し、[フック](/ja/hooks) コマンド、stdio [MCP サーバー](/ja/mcp) スタートアップコマンド。ログまたは監査に役立ちます。例：`/path/to/logger.sh` を設定すると、各コマンドが `/path/to/logger.sh <command>` として実行されます |

156| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトと Bash、ファイル読み取り、ファイル編集ツールのみで実行するには `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。[`--bare`](/ja/headless#start-faster-with-bare-mode) CLI フラグがこれを設定します |157| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトと Bash、ファイル読み取り、ファイル編集ツールのみで実行するには `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。OAuth トークンとキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から取得する必要があります。[`--bare`](/ja/headless#start-faster-with-bare-mode) CLI フラグと同等です |

157| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトと省略されたツール説明を使用するには `1` に設定します。`0`、`false`、`no`、または `off` に設定して、実験またはサーバー設定がそれ以外の場合に有効にしてもオプトアウトします。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |158| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトと省略されたツール説明を使用するには `1` に設定します。`0`、`false`、`no`、または `off` に設定して、実験またはサーバー設定がそれ以外の場合に有効にしてもオプトアウトします。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |

158| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/ja/claude-platform-on-aws) のクライアント側認証をスキップします。リクエストに自分で署名するゲートウェイの場合 |159| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/ja/claude-platform-on-aws) のクライアント側認証をスキップします。リクエストに自分で署名するゲートウェイの場合 |

159| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Bedrock の AWS 認証をスキップします（例：LLM ゲートウェイを使用する場合） |160| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Bedrock の AWS 認証をスキップします（例：LLM ゲートウェイを使用する場合） |

161| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Bedrock Mantle の AWS 認証をスキップします（例：LLM ゲートウェイを使用する場合） |162| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Bedrock Mantle の AWS 認証をスキップします（例：LLM ゲートウェイを使用する場合） |

162| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴とセッショントランスクリプトをディスクに書き込むことをスキップするには `1` に設定します。この変数が設定されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプト化されたセッションに役立ちます |163| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴とセッショントランスクリプトをディスクに書き込むことをスキップするには `1` に設定します。この変数が設定されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプト化されたセッションに役立ちます |

163| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Vertex の Google 認証をスキップします（例：LLM ゲートウェイを使用する場合） |164| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Vertex の Google 認証をスキップします（例：LLM ゲートウェイを使用する場合） |

165| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/ja/hooks#stop) または [SubagentStop](/ja/hooks#subagentstop) フックがターンの終了をブロックできる最大連続回数（デフォルト：8）。フックが解決するのに正当に必要とする場合は、これを増やします。`0` に設定してキャップを無効にします |

164| `CLAUDE_CODE_SUBAGENT_MODEL` | [モデル設定](/ja/model-config) を参照してください |166| `CLAUDE_CODE_SUBAGENT_MODEL` | [モデル設定](/ja/model-config) を参照してください |

165| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Anthropic とクラウドプロバイダーの認証情報をサブプロセス環境（Bash ツール、フック、MCP stdio サーバー）から削除するには `1` に設定します。親 Claude プロセスはこれらの認証情報を API 呼び出し用に保持しますが、子プロセスはそれらを読み取ることができず、シェル展開を通じてシークレットを流出させようとするプロンプトインジェクション攻撃への露出を減らします。Linux では、これは Bash サブプロセスを分離された PID 名前空間で実行するため、ホストプロセス環境を `/proc` 経由で読み取ることができません。副作用として、`ps`、`pgrep`、`kill` はホストプロセスを見たり、シグナルを送ったりできません。`allowed_non_write_users` が設定されている場合、`claude-code-action` はこれを自動的に設定します |167| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Anthropic とクラウドプロバイダーの認証情報をサブプロセス環境（Bash ツール、フック、MCP stdio サーバー）から削除するには `1` に設定します。親 Claude プロセスはこれらの認証情報を API 呼び出し用に保持しますが、子プロセスはそれらを読み取ることができず、シェル展開を通じてシークレットを流出させようとするプロンプトインジェクション攻撃への露出を減らします。Linux では、これは Bash サブプロセスを分離された PID 名前空間で実行するため、ホストプロセス環境を `/proc` 経由で読み取ることができません。副作用として、`ps`、`pgrep`、`kill` はホストプロセスを見たり、シグナルを送ったりできません。`allowed_non_write_users` が設定されている場合、`claude-code-action` はこれを自動的に設定します |

166| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード（`-p` フラグ）でプラグインインストールが完了するまで待機するには `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機を制限します |168| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード（`-p` フラグ）でプラグインインストールが完了するまで待機するには `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機を制限します |

180| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします（デフォルト：`~/.claude`）。すべての設定、認証情報、セッション履歴、プラグインはこのパスの下に保存されます。複数のアカウントを並行して実行する場合に役立ちます：例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |182| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします（デフォルト：`~/.claude`）。すべての設定、認証情報、セッション履歴、プラグインはこのパスの下に保存されます。複数のアカウントを並行して実行する場合に役立ちます：例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

181| `CLAUDE_EFFORT` | Bash ツールサブプロセスとフックコマンドで、ターンのアクティブな [努力レベル](/ja/model-config#adjust-effort-level) に自動的に設定されます：`low`、`medium`、`high`、`xhigh`、または `max`。[フック](/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメータをサポートしている場合にのみ設定されます |183| `CLAUDE_EFFORT` | Bash ツールサブプロセスとフックコマンドで、ターンのアクティブな [努力レベル](/ja/model-config#adjust-effort-level) に自動的に設定されます：`low`、`medium`、`high`、`xhigh`、または `max`。[フック](/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメータをサポートしている場合にのみ設定されます |

182| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドルウォッチドッグを強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。未設定の場合、ウォッチドッグは Anthropic API 接続でデフォルトで有効になります。バイトウォッチドッグは、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定された期間、ワイヤ上にバイトが到着しない場合に接続を中止します。最小 5 分で、イベントレベルウォッチドッグとは独立しています |184| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドルウォッチドッグを強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。未設定の場合、ウォッチドッグは Anthropic API 接続でデフォルトで有効になります。バイトウォッチドッグは、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定された期間、ワイヤ上にバイトが到着しない場合に接続を中止します。最小 5 分で、イベントレベルウォッチドッグとは独立しています |

183| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドルウォッチドッグを有効にするには `1` に設定します。デフォルトではオフです。Bedrock、Vertex、Foundry では、これが唯一利用可能なアイドルウォッチドッグです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |185| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` レスポンスでバイトレベルストリーミングアイドルウォッチドッグを有効にするには `1` に設定します。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |

186| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドルウォッチドッグを有効にするには `1` に設定します。デフォルトではオフです。すべてのプロバイダーに適用されます。Bedrock では、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` で独立したバイトレベルウォッチドッグも有効にできます。両方が設定されている場合、一緒に実行されます。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |

184| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセスで実行するシェルスクリプトへのパス。ファイル内のエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。[SessionStart](/ja/hooks#persist-environment-variables)、[Setup](/ja/hooks#setup)、[CwdChanged](/ja/hooks#cwdchanged)、[FileChanged](/ja/hooks#filechanged) フックによって動的に入力されます |187| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセスで実行するシェルスクリプトへのパス。ファイル内のエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。[SessionStart](/ja/hooks#persist-environment-variables)、[Setup](/ja/hooks#setup)、[CwdChanged](/ja/hooks#cwdchanged)、[FileChanged](/ja/hooks#filechanged) フックによって動的に入力されます |

185| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合、自動生成される [Remote Control](/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一の呼び出しに対して同じ値を設定します |188| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合、自動生成される [Remote Control](/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一の呼び出しに対して同じ値を設定します |

186| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | ストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト（ミリ秒）。デフォルトと最小 `300000`（5 分）の両方のバイトレベルとイベントレベルウォッチドッグの場合。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために自動的にクランプされます。サードパーティプロバイダーの場合、`CLAUDE_ENABLE_STREAM_WATCHDOG=1` が必須です |189| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | ストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト（ミリ秒）。デフォルトと最小 `300000`（5 分）の両方のバイトレベルとイベントレベルウォッチドッグの場合。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために自動的にクランプされます。サードパーティプロバイダーの場合、`CLAUDE_ENABLE_STREAM_WATCHDOG=1` が必須です。Bedrock では、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` の場合にも適用されます |

187| `DEBUG` | デバッグモードを有効にするには `1` に設定します。[`--debug`](/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` に書き込まれるか、`CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` の真の値のみがデバッグモードを有効にするため、他のツール用に設定された `DEBUG=express:*` などの名前空間パターンはトリガーしません |190| `DEBUG` | デバッグモードを有効にするには `1` に設定します。[`--debug`](/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` に書き込まれるか、`CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` の真の値のみがデバッグモードを有効にするため、他のツール用に設定された `DEBUG=express:*` などの名前空間パターンはトリガーしません |

188| `DISABLE_AUTOUPDATER` | 自動更新を無効にするには `1` に設定します。手動の `claude update` は引き続き機能します。`DISABLE_UPDATES` を使用して両方をブロックします |191| `DISABLE_AUTOUPDATER` | 自動更新を無効にするには `1` に設定します。手動の `claude update` は引き続き機能します。`DISABLE_UPDATES` を使用して両方をブロックします |

189| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づいたときの自動コンパクションを無効にするには `1` に設定します。手動の `/compact` コマンドは引き続き利用可能です。コンパクションが発生するタイミングを明示的に制御したい場合に使用します |192| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づいたときの自動コンパクションを無効にするには `1` に設定します。手動の `/compact` コマンドは引き続き利用可能です。コンパクションが発生するタイミングを明示的に制御したい場合に使用します |

191| `DISABLE_COST_WARNINGS` | コスト警告メッセージを無効にするには `1` に設定します |194| `DISABLE_COST_WARNINGS` | コスト警告メッセージを無効にするには `1` に設定します |

192| `DISABLE_DOCTOR_COMMAND` | `/doctor` コマンドを非表示にするには `1` に設定します。ユーザーがインストール診断を実行すべきでない管理されたデプロイメントに役立ちます |195| `DISABLE_DOCTOR_COMMAND` | `/doctor` コマンドを非表示にするには `1` に設定します。ユーザーがインストール診断を実行すべきでない管理されたデプロイメントに役立ちます |

193| `DISABLE_ERROR_REPORTING` | Sentry エラーレポートをオプトアウトするには `1` に設定します |196| `DISABLE_ERROR_REPORTING` | Sentry エラーレポートをオプトアウトするには `1` に設定します |

194| `DISABLE_EXTRA_USAGE_COMMAND` | ユーザーがレート制限を超えて追加使用量を購入できる `/extra-usage` コマンドを非表示にするには `1` に設定します |197| `DISABLE_EXTRA_USAGE_COMMAND` | ユーザーがレート制限を超えて追加使用量を購入できる `/usage-credits` コマンドを非表示にするには `1` に設定します |

195| `DISABLE_FEEDBACK_COMMAND` | `/feedback` コマンドを無効にするには `1` に設定します。古い名前 `DISABLE_BUG_COMMAND` も受け入れられます |198| `DISABLE_FEEDBACK_COMMAND` | `/feedback` コマンドを無効にするには `1` に設定します。古い名前 `DISABLE_BUG_COMMAND` も受け入れられます |

196| `DISABLE_GROWTHBOOK` | GrowthBook フィーチャーフラグ取得を無効にするには `1` に設定します。すべてのフラグにコードデフォルトを使用します。テレメトリイベントログは `DISABLE_TELEMETRY` も設定されていない限りオンのままです |199| `DISABLE_GROWTHBOOK` | GrowthBook フィーチャーフラグ取得を無効にするには `1` に設定します。すべてのフラグにコードデフォルトを使用します。テレメトリイベントログは `DISABLE_TELEMETRY` も設定されていない限りオンのままです |

197| `DISABLE_INSTALLATION_CHECKS` | インストール警告を無効にするには `1` に設定します。インストール場所を手動で管理する場合にのみ使用してください。標準インストールの問題をマスクする可能性があります |200| `DISABLE_INSTALLATION_CHECKS` | インストール警告を無効にするには `1` に設定します。インストール場所を手動で管理する場合にのみ使用してください。標準インストールの問題をマスクする可能性があります |

221| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード（`-p` フラグ）で [`--json-schema`](/ja/cli-reference#cli-flags) に対するモデルの応答検証が失敗した場合の再試行回数。デフォルト：5 |224| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード（`-p` フラグ）で [`--json-schema`](/ja/cli-reference#cli-flags) に対するモデルの応答検証が失敗した場合の再試行回数。デフォルト：5 |

222| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) トークン予算をオーバーライドします。上限はモデルの [最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) から 1 を引いた値です。思考を完全に無効にするには `0` に設定します。[適応的推論](/ja/model-config#adjust-effort-level) を備えたモデルでは、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を通じて適応的推論が無効にされない限り、予算は無視されます |225| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) トークン予算をオーバーライドします。上限はモデルの [最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) から 1 を引いた値です。思考を完全に無効にするには `0` に設定します。[適応的推論](/ja/model-config#adjust-effort-level) を備えたモデルでは、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を通じて適応的推論が無効にされない限り、予算は無視されます |

223| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |226| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |

224| `MCP_CONNECTION_NONBLOCKING` | 非対話モード（`-p`）で MCP 接続待機全体をスキップするには `true` に設定します。MCP ツールが不要なスクリプト化されたパイプラインに役立ちます。この変数がない場合、最初のクエリは `--mcp-config` サーバー接続を最大 5 秒待機します。[`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、ツールが最初のプロンプトが構築されるときに存在する必要があるため、この変数に関係なく常にブロックします |227| `MCP_CONNECTION_NONBLOCKING` | スタートアップが最初のクエリの前に MCP サーバーの接続を待機するかどうかを制御します。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、MCP スタートアップはデフォルトで非ブロッキングです：サーバーはバックグラウンドで接続し、完了するとそのツールが利用可能になります。`0` に設定してブロッキング 5 秒接続待機を復元します。[`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、ツールが最初のプロンプトが構築されるときに存在する必要があるため、この設定に関係なく常にブロックします |

225| `MCP_CONNECT_TIMEOUT_MS` | 最初のクエリが MCP 接続バッチを待機する時間（ミリ秒）。ツールリストをスナップショットする前のデフォルト：5000。期限で保留中のサーバーはバックグラウンドで接続し続けますが、次のクエリまで表示されません。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行を制限します。最も関連性があるのは、単一のクエリを発行し、遅く接続するサーバーが表示される必要がある非対話セッションです |228| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップが接続バッチを待機する時間（ミリ秒）。ツールリストをスナップショットする前のデフォルト：5000。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。期限で保留中のサーバーはバックグラウンドで接続し続けますが、次のクエリまで表示されません。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行を制限します |

226| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポート。[事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) で MCP サーバーを追加する場合の `--callback-port` の代替 |229| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポート。[事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) で MCP サーバーを追加する場合の `--callback-port` の代替 |

227| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するリモート MCP サーバー（HTTP/SSE）の最大数（デフォルト：20） |230| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するリモート MCP サーバー（HTTP/SSE）の最大数（デフォルト：20） |

228| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するローカル MCP サーバー（stdio）の最大数（デフォルト：3） |231| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するローカル MCP サーバー（stdio）の最大数（デフォルト：3） |

162 162 

163これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。163これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。

164 164 

165### You've hit your session limit165### セッション制限に達しました

166 166 

167サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。167サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。

168 168 

178 178 

179* エラーに表示されているリセット時刻を待ってください179* エラーに表示されているリセット時刻を待ってください

180* `/usage` を実行して、プランの制限とリセット時刻を確認してください180* `/usage` を実行して、プランの制限とリセット時刻を確認してください

181* `/extra-usage` を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。[有料プランの追加使用量](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を参照して、これがどのように請求されるかを確認してください。181* `/usage-credits` を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。[有料プランの使用量クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)を参照して、これがどのように請求されるかを確認してください。

182* プランをアップグレードしてより高いベース制限を取得するには、[claude.com/pricing](https://claude.com/pricing)を参照してください182* プランをアップグレードしてより高いベース制限を取得するには、[claude.com/pricing](https://claude.com/pricing)を参照してください

183 183 

184制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。184制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。

185 185 

186### Server is temporarily limiting requests186### サーバーが一時的にリクエストを制限しています

187 187 

188API は、プランクォータとは無関係の短期的なスロットルを適用しました。188API は、プランクォータとは無関係の短期的なスロットルを適用しました。

189 189 

198* 少し待ってから再度試してください198* 少し待ってから再度試してください

199* 続く場合は [status.claude.com](https://status.claude.com)を確認してください199* 続く場合は [status.claude.com](https://status.claude.com)を確認してください

200 200 

201### Request rejected (429)201### リクエストが拒否されました（429）

202 202 

203API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。203API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。

204 204 

205```text theme={null}205```text theme={null}

206API Error: Request rejected (429) · this may be a temporary capacity issue206API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

207```207```

208 208 

209末尾の文は、サービスの健全性を確認する場所を示し、プロバイダーによって異なります。Bedrock および Vertex AI 設定では、Anthropic ステータスページの代わりにそのプロバイダーのサービスステータスを示します。

210 

209**対応方法：**211**対応方法：**

210 212 

211* `/status` を実行して、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した `ANTHROPIC_API_KEY` は、サブスクリプションではなく低層キーを通じてリクエストをルーティングできます。213* `/status` を実行して、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した `ANTHROPIC_API_KEY` は、サブスクリプションではなく低層キーを通じてリクエストをルーティングできます。

212* プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください214* プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください

213* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/en/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください215* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/ja/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください

214* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください216* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください

215 217 

216### Credit balance is too low218### クレジット残高が不足しています

217 219 

218Console 組織は、プリペイドクレジットを使い果たしました。220Console 組織は、プリペイドクレジットを使い果たしました。

219 221 

12 12 

13高速モードは Claude Opus の高速構成で、モデルを 2.5 倍高速化しますが、トークンあたりのコストは高くなります。迅速な反復やライブデバッグなどのインタラクティブな作業で速度が必要な場合は `/fast` でオンにし、コストがレイテンシーより重要な場合はオフにします。13高速モードは Claude Opus の高速構成で、モデルを 2.5 倍高速化しますが、トークンあたりのコストは高くなります。迅速な反復やライブデバッグなどのインタラクティブな作業で速度が必要な場合は `/fast` でオンにし、コストがレイテンシーより重要な場合はオフにします。

14 14 

15高速モードは異なるモデルではありません。Claude Opus を使用していますが、コスト効率よりも速度を優先する異なる API 構成です。同じ品質と機能が得られ、レスポンスが高速化されるだけです。高速モードは Opus 4.6 および Opus 4.7 でサポートされています。Sonnet、Haiku、または他のモデルでは利用できません。15高速モードは異なるモデルではありません。Claude Opus を使用していますが、コスト効率よりも速度を優先する異なる API 構成です。同じ品質と機能が得られ、レスポンスが高速化されるだけです。高速モードは Opus 4.7 および Opus 4.6 でサポートされています。Sonnet、Haiku、または他のモデルでは利用できません。

16 16 

17<Note>17<Note>

18 高速モードには Claude Code v2.1.36 以降が必要です。`claude --version` でバージョンを確認してください。18 高速モードには Claude Code v2.1.36 以降が必要です。`claude --version` でバージョンを確認してください。

21知っておくべきこと：21知っておくべきこと：

22 22 

23* Claude Code CLI で `/fast` を使用して高速モードをオンにします。Claude Code VS Code Extension でも `/fast` で利用可能です。23* Claude Code CLI で `/fast` を使用して高速モードをオンにします。Claude Code VS Code Extension でも `/fast` で利用可能です。

24* デフォルトでは、`/fast` は Opus 4.6 で実行されます。代わりに Opus 4.7 で高速モードを実行するには、[`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7) 環境変数を設定します。24* 高速モード価格は Opus 4.7 と Opus 4.6 の両方で $30/$150 MTok です。

25* 高速モード価格は Opus 4.6 と Opus 4.7 の両方で \$30/150 MTok です。

26* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーと Claude Console のすべてのユーザーが利用可能です。25* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーと Claude Console のすべてのユーザーが利用可能です。

27* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーの場合、高速モードは追加使用量のみで利用可能であり、サブスクリプションレート制限に含まれていません。26* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーの場合、高速モードは追加使用量のみで利用可能であり、サブスクリプションレート制限に含まれていません。

28 27 

29このページでは、[高速モードの切り替え](#toggle-fast-mode)、[Opus 4.7 で高速モードを使用](#use-fast-mode-on-opus-4-7)、[コストのトレードオフ](#understand-the-cost-tradeoff)、[使用時期の判断](#decide-when-to-use-fast-mode)、[要件](#requirements)、[セッションごとのオプトイン](#require-per-session-opt-in)、および[レート制限の処理](#handle-rate-limits)について説明します。28このページでは、[高速モードの切り替え](#toggle-fast-mode)、[コストのトレードオフ](#understand-the-cost-tradeoff)、[使用時期の判断](#decide-when-to-use-fast-mode)、[要件](#requirements)、[セッションごとのオプトイン](#require-per-session-opt-in)、および[レート制限の処理](#handle-rate-limits)について説明します。

30 29 

31## 高速モードの切り替え30## 高速モードの切り替え

32 31 

41 40 

42高速モードを有効にすると：41高速モードを有効にすると：

43 42 

44* 別のモデルを使用している場合、Claude Code は自動的に高速モードモデルに切り替わります：デフォルトでは Opus 4.6、または [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7) が設定されている場合は Opus 4.7。43* 別のモデルを使用している場合、Claude Code は自動的に Opus に切り替わります

45* 確認メッセージが表示されます：「Fast mode ON」44* 確認メッセージが表示されます：「Fast mode ON」

46* 高速モードがアクティブな間、プロンプトの横に小さい `↯` アイコンが表示されます45* 高速モードがアクティブな間、プロンプトの横に小さい `↯` アイコンが表示されます

47* いつでも `/fast` を再度実行して、高速モードがオンかオフかを確認できます46* いつでも `/fast` を再度実行して、高速モードがオンかオフかを確認できます

48 47 

49`/fast` を再度実行して高速モードを無効にすると、高速モードが実行されていた同じ Opus バージョンに留まります。モデルは以前のモデルに戻りません。別のモデルに切り替えるには、`/model` を使用します。48`/fast` を再度実行して高速モードを無効にすると、Opus に留まります。モデルは以前のモデルに戻りません。別のモデルに切り替えるには、`/model` を使用します。

50 49 

51## Opus 4.7 で高速モードを使用50Opus 4.7 は Claude Code v2.1.142 以降の高速モードのデフォルトです。代わりに高速モードを Opus 4.6 にピンするには、`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` を設定します。

52 

53<Note>

54 Opus 4.7 での高速モードには Claude Code v2.1.139 以降が必要です。

55</Note>

56 

57Claude Opus 4.7 の高速モードはリサーチプレビュー段階です。Opus 4.6 の高速モードと同じ 2.5 倍の速度と同じ価格で実行され、他の動作変更はありません。

58 

59<Note>

60 2026 年 5 月 14 日に、Opus 4.7 が高速モードのデフォルトモデルになります。それまでは、`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1` を設定してオプトインします。

61</Note>

62 

63オプトインするには、Claude Code を起動する前に `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1` を設定します。変数が設定されている場合、`/fast` は Opus 4.7 で実行されます。設定されていない場合、`/fast` は Opus 4.6 で実行され続けます。

64 

65変数をシェルエクスポートとして設定できます：

66 

67```bash theme={null}

68export CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1

69```

70 

71または、オプトインのスコープを設定するために、ユーザー、プロジェクト、管理設定を含む任意の Claude Code [設定ファイル](/ja/settings#settings-files)で設定します：

72 

73```json theme={null}

74{

75 "env": {

76 "CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE": "1"

77 }

78}

79```

80 

81Opus 4.6 の高速モードは Opus 4.7 と並行して利用可能なままです。2 つは同じ高速モードレート制限プールを共有します：どちらかのモデルでの使用は同じ制限から引き出されます。

82 

83高速モードを Opus 4.6 に明示的にピンするには、`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` を設定します。この変数は優先されるため、`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` が設定されているかどうかに関わらず、高速モードは Opus 4.6 で実行されます。

84 51 

85## コストのトレードオフを理解する52## コストのトレードオフを理解する

86 53 

87高速モードは標準 Opus よりもトークンあたりの価格が高くなります：54高速モードは標準 Opus よりもトークンあたりの価格が高くなります：

88 55 

89| モード | 入力（MTok） | 出力（MTok） |56| モード | 入力（MTok） | 出力（MTok） |

90| --------------- | -------- | -------- |57| ----- | -------- | -------- |

91| Opus 4.6 の高速モード | \$30 | \$150 |58| 高速モード | \$30 | \$150 |

92| Opus 4.7 の高速モード | \$30 | \$150 |

93 59 

94高速モード価格は完全な 1M トークンコンテキストウィンドウ全体で一定です。60高速モード価格は完全な 1M トークンコンテキストウィンドウ全体で一定です。

95 61 

160 126 

161## レート制限の処理127## レート制限の処理

162 128 

163高速モードは標準 Opus とは別のレート制限があります。Opus 4.6 および Opus 4.7 の高速モードは同じレート制限プールを共有します：どちらかのモデルでの使用は同じ制限から引き出されます。高速モードレート制限に達するか、追加使用量が不足した場合：129高速モードは標準 Opus とは別のレート制限があります。Opus 4.7 および Opus 4.6 の高速モードは同じレート制限プールを共有します：どちらかのモデルでの使用は同じ制限から引き出されます。高速モードレート制限に達するか、追加使用量が不足した場合：

164 130 

1651. 高速モードは自動的に同じ Opus バージョンの標準速度にフォールバックします1311. 高速モードは自動的に標準速度にフォールバックします

1662. `↯` アイコンがグレーに変わってクールダウンを示します1322. `↯` アイコンがグレーに変わってクールダウンを示します

1673. 標準速度と価格で作業を続けます1333. 標準速度と価格で作業を続けます

1684. クールダウンが終了すると、高速モードは自動的に再度有効になります1344. クールダウンが終了すると、高速モードは自動的に再度有効になります

271 271 

272 **ロード内容：** 以下を含む新しい独立したコンテキスト。272 **ロード内容：** 以下を含む新しい独立したコンテキスト。

273 273 

274 * システムプロンプト（キャッシュ効率のため親と共有）274 * エージェント独自のシステムプロンプト（完全な Claude Code システムプロンプトではない）

275 * エージェントの `skills:` フィールドにリストされているスキルの完全なコンテンツ275 * エージェントの `skills:` フィールドにリストされているスキルの完全なコンテンツ

276 * CLAUDE.md と git ステータス（親から継承）276 * CLAUDE.md と git ステータス（ただし、組み込みの Explore および Plan エージェントは[両方を省略](/ja/sub-agents#what-loads-at-startup)）

277 * リードエージェントがプロンプトで渡すコンテキスト277 * リードエージェントがプロンプトで渡すコンテキスト

278 278 

279 **コンテキストコスト：** メインセッションから分離。Subagents は会話履歴または呼び出されたスキルを継承しません。279 **コンテキストコスト：** メインセッションから分離。Subagents は会話履歴または呼び出されたスキルを継承しません。

732# Notification フック: Claude Code が注意を必要とするときにデスクトップに ping を送信します。732# Notification フック: Claude Code が注意を必要とするときにデスクトップに ping を送信します。

733input=$(cat)733input=$(cat)

734title="Claude Code'734title="Claude Code'

735body=$(jq -r '.message // 'Needs your attention"' <<<"$input")735body=$(jq -r '.message // 'Needs your attention'' <<<"$input")

736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

738```738```

2772 2772 

2773より詳細なフック マッチング詳細については、`CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose` を設定して、フック マッチャー数とクエリ マッチングなどの追加ログ行を確認します。2773より詳細なフック マッチング詳細については、`CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose` を設定して、フック マッチャー数とクエリ マッチングなどの追加ログ行を確認します。

2774 2774 

2775フックが発火しない、無限 Stop フック ループ、設定エラーなどの一般的な問題のトラブルシューティングについては、ガイドの[制限事項とトラブルシューティング](/ja/hooks-guide#limitations-and-troubleshooting)を参照してください。より広範な診断チュートリアルについては、`/context`、`/doctor`、および設定の優先順位をカバーする[設定をデバッグ](/ja/debug-your-config)を参照してください。2775フックが発火しない、Stop フックが実行をブロックし続ける、または設定エラーなどの一般的な問題のトラブルシューティングについては、ガイドの[制限事項とトラブルシューティング](/ja/hooks-guide#limitations-and-troubleshooting)を参照してください。`/context`、`/doctor`、および設定の優先順位をカバーするより広範な診断チュートリアルについては、[設定をデバッグ](/ja/debug-your-config)を参照してください。

910* JSON が有効であることを確認します（末尾のコンマとコメントは許可されていません）910* JSON が有効であることを確認します（末尾のコンマとコメントは許可されていません）

911* 設定ファイルが正しい場所にあることを確認します：プロジェクト hooks の場合は `.claude/settings.json`、グローバル hooks の場合は `~/.claude/settings.json`911* 設定ファイルが正しい場所にあることを確認します：プロジェクト hooks の場合は `.claude/settings.json`、グローバル hooks の場合は `~/.claude/settings.json`

912 912 

913### Stop hook が永遠に実行される913### Stop hook がブロック上限に達する

914 914 

915Claude は無限ループで作業を続け、停止する代わりに。915Claude は無限ループで作業を続け、停止する代わりに、Stop hook が連続して 8 回ブロックしたという警告でターンを終了します。

916 916 

917Stop hook スクリプトは、それが既にトリガーされたかどうかをチェックする必要があります。JSON 入力から `stop_hook_active` フィールドを解析し、`true` の場合は早期に終了します：917Claude Code は Stop hook が進捗なしで 8 回連続でブロックした後、それをオーバーライドします。Hook スクリプトは、それが既にトリガーされたかどうかをチェックする必要があります。JSON 入力から `stop_hook_active` フィールドを解析し、`true` の場合は早期に終了します：

918 918 

919```bash theme={null}919```bash theme={null}

920#!/bin/bash920#!/bin/bash

925# ... hook ロジックの残り925# ... hook ロジックの残り

926```926```

927 927 

928Hook が収束するために 8 回以上の反復が正当に必要な場合は、[`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/ja/env-vars) で上限を引き上げます。

929 

928### JSON 検証に失敗しました930### JSON 検証に失敗しました

929 931 

930Claude Code は hook スクリプトが有効な JSON を出力しているにもかかわらず、JSON 解析エラーを表示します。932Claude Code は hook スクリプトが有効な JSON を出力しているにもかかわらず、JSON 解析エラーを表示します。

143 143 

144`/mcp` パネルは、接続されている各サーバーの横にツール数を表示し、ツール機能をアドバタイズしているが、ツールを公開していないサーバーにフラグを立てます。144`/mcp` パネルは、接続されている各サーバーの横にツール数を表示し、ツール機能をアドバタイズしているが、ツールを公開していないサーバーにフラグを立てます。

145 145 

146リクエストがまだバックグラウンドで接続中のサーバーからのツールを必要とする場合、Claude はそのサーバーが接続されるまで待機してから続行します。デフォルトで有効になっている [ツール検索](#scale-with-mcp-tool-search) を使用すると、待機は `ToolSearch` 呼び出し内で発生します。Vertex AI、カスタム `ANTHROPIC_BASE_URL`、または `ENABLE_TOOL_SEARCH=false` などのツール検索がない設定では、Claude は代わりに `WaitForMcpServers` ツールを使用します。

147 

146サーバー名 `workspace` は内部使用のために予約されています。設定がその名前のサーバーを定義している場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。148サーバー名 `workspace` は内部使用のために予約されています。設定がその名前のサーバーを定義している場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。

147 149 

148### 動的ツール更新150### 動的ツール更新

1007 1009 

1008`alwaysLoad` フィールドはすべてのサーバータイプで利用可能で、Claude Code v2.1.121 以降が必要です。MCP サーバーは、ツールの `_meta` オブジェクトに `"anthropic/alwaysLoad": true` を含めることで、個別のツールを常にロードとしてマークすることもできます。これはそのツールのみに同じ効果があります。1010`alwaysLoad` フィールドはすべてのサーバータイプで利用可能で、Claude Code v2.1.121 以降が必要です。MCP サーバーは、ツールの `_meta` オブジェクトに `"anthropic/alwaysLoad": true` を含めることで、個別のツールを常にロードとしてマークすることもできます。これはそのツールのみに同じ効果があります。

1009 1011 

1010`alwaysLoad: true` を設定すると、サーバーが接続されるまでスタートアップもブロックされます。これは標準的な 5 秒の接続タイムアウトでキャップされます。これは [`MCP_CONNECTION_NONBLOCKING=1`](/ja/env-vars) が設定されている場合でも適用されます。ツールは最初のプロンプトが構築されるときに存在する必要があるためです。他のサーバーは、ノンブロッキングが有効な場合、バックグラウンドで接続し続けます。1012`alwaysLoad: true` を設定すると、サーバーが接続されるまでスタートアップもブロックされます。これは標準的な 5 秒の接続タイムアウトでキャップされます。これは MCP スタートアップが[デフォルトではノンブロッキング](/ja/env-vars)である場合でも適用されます。ツールは最初のプロンプトが構築されるときに存在する必要があるためです。他のサーバーはバックグラウンドで接続し続けます。

1011 1013 

1012## MCP プロンプトをコマンドとして使用する1014## MCP プロンプトをコマンドとして使用する

1013 1015 

141Claude Code は、Opus の使用量閾値に達した場合、自動的に Sonnet にフォールバックする可能性があります。141Claude Code は、Opus の使用量閾値に達した場合、自動的に Sonnet にフォールバックする可能性があります。

142 142 

143<Note>143<Note>

144 2026 年 4 月 23 日に、Enterprise 従量課金および Anthropic API ユーザーのデフォルトモデルが Opus 4.7 に変更されます。別のデフォルトを保つには、[サーバー管理設定](/ja/server-managed-settings) で `ANTHROPIC_MODEL` または `model` フィールドを設定します。144 2026 年 4 月 23 日に、Enterprise 従量課金および Anthropic API ユーザーのデフォルトモデルが Opus 4.7 に変更されます。別のデフォルトを保つには、[サーバー管理設定](/ja/server-managed-settings)で `ANTHROPIC_MODEL` または `model` フィールドを設定します。

145</Note>145</Note>

146 146 

147### `opusplan` モデル設定147### `opusplan` モデル設定

153 153 

154これにより、両方の長所が得られます。計画用の Opus の優れた推論と、実行用の Sonnet の効率性です。154これにより、両方の長所が得られます。計画用の Opus の優れた推論と、実行用の Sonnet の効率性です。

155 155 

156Plan Mode の Opus フェーズは標準的な 200K コンテキストウィンドウで実行されます。[拡張コンテキスト](#extended-context) で説明されている自動 1M アップグレードは `opus` モデル設定に適用され、`opusplan` には拡張されません。156Plan Mode の Opus フェーズは標準的な 200K コンテキストウィンドウで実行されます。[拡張コンテキスト](#extended-context)で説明されている自動 1M アップグレードは `opus` モデル設定に適用され、`opusplan` には拡張されません。

157 157 

158### 努力レベルの調整158### 努力レベルの調整

159 159 

160[努力レベル](https://platform.claude.com/docs/ja/build-with-claude/effort) は適応的推論を制御し、タスクの複雑さに基づいて各ステップで思考するかどうか、どの程度思考するかをモデルが決定できるようにします。低い努力はシンプルなタスクではより高速で安価ですが、高い努力は複雑な問題に対してより深い推論を提供します。160[努力レベル](https://platform.claude.com/docs/ja/build-with-claude/effort)は適応的推論を制御し、タスクの複雑さに基づいて各ステップで思考するかどうか、どの程度思考するかをモデルが決定できるようにします。低い努力はシンプルなタスクではより高速で安価ですが、高い努力は複雑な問題に対してより深い推論を提供します。

161 161 

162努力は Opus 4.7、Opus 4.6、Sonnet 4.6 でサポートされています。利用可能なレベルはモデルによって異なります。162努力は Opus 4.7、Opus 4.6、Sonnet 4.6 でサポートされています。利用可能なレベルはモデルによって異なります。

163 163 

200* **`/model` 内**：モデルを選択する際に左右矢印キーを使用して努力スライダーを調整200* **`/model` 内**：モデルを選択する際に左右矢印キーを使用して努力スライダーを調整

201* **`--effort` フラグ**：Claude Code を起動する際にレベル名を渡して、単一セッションのレベルを設定201* **`--effort` フラグ**：Claude Code を起動する際にレベル名を渡して、単一セッションのレベルを設定

202* **環境変数**：`CLAUDE_CODE_EFFORT_LEVEL` をレベル名または `auto` に設定202* **環境変数**：`CLAUDE_CODE_EFFORT_LEVEL` をレベル名または `auto` に設定

203* **設定**：設定ファイルで `effortLevel` を `low`、`medium`、`high`、`xhigh` に設定します。`max` は [セッションのみ](#adjust-effort-level) であり、ここでは受け入れられません203* **設定**：設定ファイルで `effortLevel` を `low`、`medium`、`high`、`xhigh` に設定します。`max` は[セッションのみ](#adjust-effort-level)であり、ここでは受け入れられません

204* **Skill と subagent frontmatter**：[skill](/ja/skills#frontmatter-reference) または [subagent](/ja/sub-agents#supported-frontmatter-fields) markdown ファイルで `effort` を設定して、その skill または subagent が実行される際の努力レベルをオーバーライド204* **Skill と subagent frontmatter**：[skill](/ja/skills#frontmatter-reference)または[subagent](/ja/sub-agents#supported-frontmatter-fields)markdown ファイルで `effort` を設定して、その skill または subagent が実行される際の努力レベルをオーバーライド

205 205 

206環境変数がすべての他の方法より優先され、次に設定されたレベル、次にモデルのデフォルトが優先されます。Frontmatter 努力は、その skill または subagent がアクティブな場合に適用され、セッションレベルをオーバーライドしますが、環境変数はオーバーライドしません。206環境変数がすべての他の方法より優先され、次に設定されたレベル、次にモデルのデフォルトが優先されます。Frontmatter 努力は、その skill または subagent がアクティブな場合に適用され、セッションレベルをオーバーライドしますが、環境変数はオーバーライドしません。

207 207 

213 213 

214Opus 4.7 は常に適応的推論を使用します。固定思考予算モードと `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` はそれに適用されません。214Opus 4.7 は常に適応的推論を使用します。固定思考予算モードと `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` はそれに適用されません。

215 215 

216Opus 4.6 と Sonnet 4.6 では、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定して、`MAX_THINKING_TOKENS` で制御される以前の固定思考予算に戻すことができます。[環境変数](/ja/env-vars) を参照してください。216Opus 4.6 と Sonnet 4.6 では、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定して、`MAX_THINKING_TOKENS` で制御される以前の固定思考予算に戻すことができます。[環境変数](/ja/env-vars)を参照してください。

217 217 

218### 拡張思考218### 拡張思考

219 219 

220拡張思考は、Claude が応答する前に発する推論です。[適応的推論](#adjust-effort-level) をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。220拡張思考は、Claude が応答する前に発する推論です。[適応的推論](#adjust-effort-level)をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。

221 221 

222| 制御 | 設定方法 |222| 制御 | 設定方法 |

223| :------------ | :--------------------------------------------------------------------------------------------------------------------- |223| :------------ | :------------------------------------------------------------------------------------------------------------------ |

224| 現在のセッションのトグル | macOS では `Option+T`、Windows と Linux では `Alt+T` を押します |224| 現在のセッションのトグル | macOS では `Option+T`、Windows と Linux では `Alt+T` を押します |

225| グローバルデフォルトを設定 | `/config` を実行して思考モードをトグルします。`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |225| グローバルデフォルトを設定 | `/config` を実行して思考モードをトグルします。`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |

226| 努力に関係なく無効化 | [`MAX_THINKING_TOKENS=0`](/ja/env-vars) を設定します。他の値は [固定思考予算](#adaptive-reasoning-and-fixed-thinking-budgets) でのみ適用されます |226| 努力に関係なく無効化 | [`MAX_THINKING_TOKENS=0`](/ja/env-vars)を設定します。他の値は[固定思考予算](#adaptive-reasoning-and-fixed-thinking-budgets)でのみ適用されます |

227 227 

228思考出力はデフォルトで折りたたまれています。`Ctrl+O` を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は [設定](/ja/settings) で `showThinkingSummaries: true` を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。228思考出力はデフォルトで折りたたまれています。`Ctrl+O` を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は[設定](/ja/settings)で `showThinkingSummaries: true` を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。

229 229 

230### 拡張コンテキスト230### 拡張コンテキスト

231 231 

232Opus 4.7、Opus 4.6、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に [100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) をサポートしています。232Opus 4.7、Opus 4.6、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に[100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。

233 233 

234利用可能性はモデルとプランによって異なります。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Sonnet with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要です。234利用可能性はモデルとプランによって異なります。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Sonnet with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで[追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要です。

235 235 

236| プラン | Opus with 1M context | Sonnet with 1M context |236| プラン | Opus with 1M context | Sonnet with 1M context |

237| ------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |237| ------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |

238| Max、Team、Enterprise | サブスクリプションに含まれる | [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要 |238| Max、Team、Enterprise | サブスクリプションに含まれる | [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要 |

239| Pro | [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要 | [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要 |239| Pro | [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要 | [追加使用](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要 |

240| API と従量課金 | フルアクセス | フルアクセス |240| API と従量課金 | フルアクセス | フルアクセス |

241 241 

2421M コンテキストを完全に無効にするには、`CLAUDE_CODE_DISABLE_1M_CONTEXT=1` を設定します。これにより、1M モデルバリアントがモデルピッカーから削除されます。[環境変数](/ja/env-vars) を参照してください。2421M コンテキストを完全に無効にするには、`CLAUDE_CODE_DISABLE_1M_CONTEXT=1` を設定します。これにより、1M モデルバリアントがモデルピッカーから削除されます。[環境変数](/ja/env-vars)を参照してください。

243 243 

2441M コンテキストウィンドウは標準モデル価格を使用し、200K を超えるトークンに対するプレミアムはありません。拡張コンテキストがサブスクリプションに含まれているプランでは、使用量はサブスクリプションでカバーされたままです。拡張コンテキストに追加使用でアクセスするプランでは、トークンは追加使用に請求されます。2441M コンテキストウィンドウは標準モデル価格を使用し、200K を超えるトークンに対するプレミアムはありません。拡張コンテキストがサブスクリプションに含まれているプランでは、使用量はサブスクリプションでカバーされたままです。拡張コンテキストに追加使用でアクセスするプランでは、トークンは追加使用に請求されます。

245 245 

284以下の環境変数を使用できます。これらは完全な **モデル名**（または API プロバイダーの同等のもの）である必要があり、エイリアスがマップするモデル名を制御します。284以下の環境変数を使用できます。これらは完全な **モデル名**（または API プロバイダーの同等のもの）である必要があり、エイリアスがマップするモデル名を制御します。

285 285 

286| 環境変数 | 説明 |286| 環境変数 | 説明 |

287| -------------------------------- | ---------------------------------------------------------------------------- |287| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |

288| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` に使用するモデル、または Plan Mode がアクティブな場合の `opusplan` に使用するモデル。 |288| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` に使用するモデル、または Plan Mode がアクティブな場合の `opusplan` に使用するモデル。 |

289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` に使用するモデル、または Plan Mode がアクティブでない場合の `opusplan` に使用するモデル。 |289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` に使用するモデル、または Plan Mode がアクティブでない場合の `opusplan` に使用するモデル。 |

290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` に使用するモデル、または [バックグラウンド機能](/ja/costs#background-token-usage) に使用するモデル |290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` に使用するモデル、または [バックグラウンド機能](/ja/costs#background-token-usage) に使用するモデル |

291| `CLAUDE_CODE_SUBAGENT_MODEL` | [subagents](/ja/sub-agents) に使用するモデル |291| `CLAUDE_CODE_SUBAGENT_MODEL` | すべての [subagents](/ja/sub-agents#choose-a-model) に使用するモデル。呼び出しごとの `model` パラメータと subagent 定義の `model` frontmatter の両方をオーバーライドします |

292 292 

293注：`ANTHROPIC_SMALL_FAST_MODEL` は `ANTHROPIC_DEFAULT_HAIKU_MODEL` の代わりに非推奨です。293注：`ANTHROPIC_SMALL_FAST_MODEL` は `ANTHROPIC_DEFAULT_HAIKU_MODEL` の代わりに非推奨です。

294 294 

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Claude Code の概要5# 概要

6 6 

7> Claude Code は agentic coding ツールで、コードベースを読み取り、ファイルを編集し、コマンドを実行し、開発ツールと統合します。ターミナル、IDE、デスクトップアプリ、ブラウザで利用できます。7> Claude Code は agentic coding ツールで、コードベースを読み取り、ファイルを編集し、コマンドを実行し、開発ツールと統合します。ターミナル、IDE、デスクトップアプリ、ブラウザで利用できます。

8 8 

73 | 自動モード | `auto` |73 | 自動モード | `auto` |

74 | パーミッションをバイパス | `bypassPermissions` |74 | パーミッションをバイパス | `bypassPermissions` |

75 75 

76 自動モードは拡張機能設定で **Allow dangerously skip permissions** を有効にした後、モード指示器に表示されますが、アカウントが [auto モードセクション](#eliminate-prompts-with-auto-mode)にリストされているすべての要件を満たすまで利用不可のままです。`claudeCode.initialPermissionMode` 設定は `auto` を受け入れません。デフォルトで自動モードで開始するには、代わりに Claude Code [`settings.json`](/ja/settings#settings-files) で `defaultMode` を設定します。76 自動モードは拡張機能設定で **Allow dangerously skip permissions** を有効にした後、モード指示器に表示されますが、アカウントが [auto モードセクション](#eliminate-prompts-with-auto-mode)にリストされているすべての要件を満たすまで利用不可のままです。`claudeCode.initialPermissionMode` 設定は `auto` を受け入れません。デフォルトで自動モードで開始するには、代わりに [ユーザー設定](/ja/settings#settings-files)で `defaultMode` を設定します。Claude Code はプロジェクトおよびローカル設定の `defaultMode: "auto"` を無視します。

77 77 

78 パーミッションのバイパスもモード指示器に表示される前に **Allow dangerously skip permissions** トグルが必要です。78 パーミッションのバイパスもモード指示器に表示される前に **Allow dangerously skip permissions** トグルが必要です。

79 79 

164 164 

165自動モードでは Claude はパーミッションプロンプトなしで実行できます。別の分類器モデルはアクション実行前にアクションをレビューし、リクエストを超えてエスカレートするもの、認識されないインフラストラクチャをターゲットにするもの、または Claude が読んだ敵対的なコンテンツによって駆動されているように見えるものをブロックします。165自動モードでは Claude はパーミッションプロンプトなしで実行できます。別の分類器モデルはアクション実行前にアクションをレビューし、リクエストを超えてエスカレートするもの、認識されないインフラストラクチャをターゲットにするもの、または Claude が読んだ敵対的なコンテンツによって駆動されているように見えるものをブロックします。

166 166 

167自動モードはまた Claude に即座に実行し、明確化の質問を最小化するよう指示します。パーミッションプロンプトを保持しながらその動作を取得するには、代わりに [プロアクティブ出力スタイル](/ja/output-styles)を設定してください。167自動モードはまた Claude に即座に実行し、明確化の質問を最小化するよう指示します。パーミッションプロンプトを保持しながらその動作を取得するには、代わりに [プロアクティブ出力スタイル](/ja/output-styles) を設定してください。

168 168 

169<Warning>169<Warning>

170 自動モードはリサーチプレビューです。プロンプトを削除しますが、安全性を保証しません。一般的な方向を信頼するタスクに使用し、機密操作のレビューの代わりとしては使用しないでください。170 自動モードはリサーチプレビューです。プロンプトを削除しますが、安全性を保証しません。一般的な方向を信頼するタスクに使用し、機密操作のレビューの代わりとしては使用しないでください。

177* **モデル**：Team、Enterprise、API プランで Claude Sonnet 4.6、Opus 4.6、または Opus 4.7。Max プランで Claude Opus 4.7 のみ。Haiku および claude-3 モデルを含む他のモデルはサポートされていません。177* **モデル**：Team、Enterprise、API プランで Claude Sonnet 4.6、Opus 4.6、または Opus 4.7。Max プランで Claude Opus 4.7 のみ。Haiku および claude-3 モデルを含む他のモデルはサポートされていません。

178* **プロバイダー**：Anthropic API のみ。Bedrock、Vertex、Foundry では利用できません。178* **プロバイダー**：Anthropic API のみ。Bedrock、Vertex、Foundry では利用できません。

179 179 

180Claude Code が自動モードを利用不可と報告する場合、これらの要件のいずれかが満たされていません。これは一時的な停止ではありません。モデルに名前を付けて自動モードが「アクションの安全性を判断できない」と言う別のメッセージは一時的な分類器停止です。[エラーリファレンス](/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)を参照してください。180Claude Code が自動モードを利用不可と報告する場合、これらの要件のいずれかが満たされていません。これは一時的な停止ではありません。モデルに名前を付けて自動モードが「アクションの安全性を判断できない」と言う別のメッセージは一時的な分類器停止です。[エラーリファレンス](/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action) を参照してください。

181 

182[設定](/ja/settings#available-settings) で `defaultMode: "auto"` を設定し、セッションがエラーなしで `default` モードで開始する場合、設定は `.claude/settings.json` または `.claude/settings.local.json` にある可能性があります。Claude Code はこれらのファイルから `auto` を無視するため、リポジトリは自動モードを自身に付与することはできません。`~/.claude/settings.json` に移動してください。

181 183 

182### 分類器がデフォルトでブロックするもの184### 分類器がデフォルトでブロックするもの

183 185 

184分類器は作業ディレクトリとリポジトリの設定されたリモートを信頼します。その他すべては [信頼できるインフラストラクチャを設定](/ja/auto-mode-config)するまで外部として扱われます。186分類器は作業ディレクトリとリポジトリの設定されたリモートを信頼します。その他すべては [信頼できるインフラストラクチャを設定](/ja/auto-mode-config) するまで外部として扱われます。

185 187 

186**デフォルトでブロック**：188**デフォルトでブロック**：

187 189 

202* 読み取り専用 HTTP リクエスト204* 読み取り専用 HTTP リクエスト

203* 開始したブランチまたは Claude が作成したブランチへのプッシュ205* 開始したブランチまたは Claude が作成したブランチへのプッシュ

204 206 

205サンドボックスネットワークアクセスリクエストはデフォルトで許可されるのではなく、分類器を通じてルーティングされます。`claude auto-mode defaults` を実行して完全なルールリストを確認してください。日常的なアクションがブロックされている場合、管理者は `autoMode.environment` 設定を通じて信頼できるリポジトリ、バケット、サービスを追加できます。[自動モードを設定](/ja/auto-mode-config)を参照してください。207サンドボックスネットワークアクセスリクエストはデフォルトで許可されるのではなく、分類器を通じてルーティングされます。`claude auto-mode defaults` を実行して完全なルールリストを確認してください。日常的なアクションがブロックされている場合、管理者は `autoMode.environment` 設定を通じて信頼できるリポジトリ、バケット、サービスを追加できます。[自動モードを設定](/ja/auto-mode-config) を参照してください。

206 208 

207### 会話で述べる境界209### 会話で述べる境界

208 210 

209分類器は会話で述べる境界をブロック信号として扱います。Claude に「プッシュしないで」または「デプロイ前にレビューを待って」と言う場合、分類器はデフォルトルールが許可する場合でも一致するアクションをブロックします。境界は後のメッセージで解除するまで有効です。Claude 独自の判断が条件が満たされたことは解除しません。211分類器は会話で述べる境界をブロック信号として扱います。Claude に「プッシュしないで」または「デプロイ前にレビューを待って」と言う場合、分類器はデフォルトルールが許可する場合でも一致するアクションをブロックします。境界は後のメッセージで解除するまで有効です。Claude 独自の判断が条件が満たされたことは解除しません。

210 212 

211境界はルールとして保存されません。分類器はチェックのたびにトランスクリプトから再読み込みするため、[コンテキストコンパクション](/ja/costs#reduce-token-usage)が述べたメッセージを削除する場合、境界は失われる可能性があります。ハード保証の場合、代わりに [deny ルール](/ja/permissions#permission-rule-syntax)を追加します。213境界はルールとして保存されません。分類器はチェックのたびにトランスクリプトから再読み込みするため、[コンテキストコンパクション](/ja/costs#reduce-token-usage) が述べたメッセージを削除する場合、境界は失われる可能性があります。ハード保証の場合、代わりに [deny ルール](/ja/permissions#permission-rule-syntax) を追加します。

212 214 

213### 自動モードがフォールバックする場合215### 自動モードがフォールバックする場合

214 216 

216 218 

217分類器がアクション 3 回連続でブロックするか、合計 20 回ブロックする場合、自動モードは一時停止し、Claude Code はプロンプトを再開します。プロンプトされたアクションを承認すると自動モードが再開されます。これらのしきい値は設定不可です。許可されたアクションは連続カウンターをリセットし、合計カウンターはセッション中に保持され、独自の制限がフォールバックをトリガーする場合にのみリセットされます。219分類器がアクション 3 回連続でブロックするか、合計 20 回ブロックする場合、自動モードは一時停止し、Claude Code はプロンプトを再開します。プロンプトされたアクションを承認すると自動モードが再開されます。これらのしきい値は設定不可です。許可されたアクションは連続カウンターをリセットし、合計カウンターはセッション中に保持され、独自の制限がフォールバックをトリガーする場合にのみリセットされます。

218 220 

219[非対話的モード](/ja/headless)で `-p` フラグを使用する場合、プロンプトするユーザーがいないため、繰り返されるブロックはセッションを中止します。221[非対話的モード](/ja/headless) で `-p` フラグを使用する場合、プロンプトするユーザーがいないため、繰り返されるブロックはセッションを中止します。

220 222 

221繰り返されるブロックは通常、分類器がインフラストラクチャについてのコンテキストが不足していることを意味します。`/feedback` を使用して誤検知を報告するか、管理者に [信頼できるインフラストラクチャを設定](/ja/auto-mode-config)するよう依頼してください。223繰り返されるブロックは通常、分類器がインフラストラクチャについてのコンテキストが不足していることを意味します。`/feedback` を使用して誤検知を報告するか、管理者に [信頼できるインフラストラクチャを設定](/ja/auto-mode-config) するよう依頼してください。

222 224 

223<AccordionGroup>225<AccordionGroup>

224 <Accordion title="分類器がアクションを評価する方法">226 <Accordion title="分類器がアクションを評価する方法">

225 各アクションは固定の決定順序を通過します。最初に一致するステップが勝ちます。227 各アクションは固定の決定順序を通過します。最初に一致するステップが勝ちます。

226 228 

227 1. [allow または deny ルール](/ja/permissions#manage-permissions)に一致するアクションは即座に解決されます229 1. [allow または deny ルール](/ja/permissions#manage-permissions) に一致するアクションは即座に解決されます

228 2. 読み取り専用アクションと作業ディレクトリ内のファイル編集は自動承認されます。[保護されたパス](#protected-paths)への書き込みを除く230 2. 読み取り専用アクションと作業ディレクトリ内のファイル編集は自動承認されます。[保護されたパス](#protected-paths) への書き込みを除く

229 3. その他すべては分類器に送られます231 3. その他すべては分類器に送られます

230 4. 分類器がブロックする場合、Claude は理由を受け取り、別のアプローチを試みます232 4. 分類器がブロックする場合、Claude は理由を受け取り、別のアプローチを試みます

231 233 

238 240 

239 `Bash(npm test)` のような狭いルールは引き継がれます。削除されたルールは自動モードを終了するときに復元されます。241 `Bash(npm test)` のような狭いルールは引き継がれます。削除されたルールは自動モードを終了するときに復元されます。

240 242 

241 分類器はユーザーメッセージ、ツール呼び出し、CLAUDE.md コンテンツを見ます。ツール結果は削除されるため、ファイルまたは Web ページの敵対的なコンテンツはそれを直接操作することはできません。サーバー側プローブは受信ツール結果をスキャンし、Claude がそれを読む前に疑わしいコンテンツにフラグを立てます。これらのレイヤーがどのように連携するかについての詳細については、[自動モードのお知らせ](https://claude.com/blog/auto-mode)および [エンジニアリング深掘り](https://www.anthropic.com/engineering/claude-code-auto-mode)を参照してください。243 分類器はユーザーメッセージ、ツール呼び出し、CLAUDE.md コンテンツを見ます。ツール結果は削除されるため、ファイルまたは Web ページの敵対的なコンテンツはそれを直接操作することはできません。サーバー側プローブは受信ツール結果をスキャンし、Claude がそれを読む前に疑わしいコンテンツにフラグを立てます。これらのレイヤーがどのように連携するかについての詳細については、[自動モードのお知らせ](https://claude.com/blog/auto-mode) および [エンジニアリング深掘り](https://www.anthropic.com/engineering/claude-code-auto-mode) を参照してください。

242 </Accordion>244 </Accordion>

243 245 

244 <Accordion title="自動モードがサブエージェントを処理する方法">246 <Accordion title="自動モードがサブエージェントを処理する方法">

245 分類器は [サブエージェント](/ja/sub-agents)の作業を 3 つのポイントでチェックします。247 分類器は [サブエージェント](/ja/sub-agents) の作業を 3 つのポイントでチェックします。

246 248 

247 1. サブエージェント開始前に、委譲されたタスク説明が評価されるため、危険に見えるタスクは生成時にブロックされます。249 1. サブエージェント開始前に、委譲されたタスク説明が評価されるため、危険に見えるタスクは生成時にブロックされます。

248 2. サブエージェント実行中、その各アクションは親セッションと同じルールで分類器を通過し、サブエージェントのフロントマターの任意の `permissionMode` は無視されます。250 2. サブエージェント実行中、その各アクションは親セッションと同じルールで分類器を通過し、サブエージェントのフロントマターの任意の `permissionMode` は無視されます。

114 114 

115依存関係を制約する最後のプラグインをアンインストールすると、依存関係は保持されなくなり、次の更新でマーケットプレイスエントリの追跡を再開します。115依存関係を制約する最後のプラグインをアンインストールすると、依存関係は保持されなくなり、次の更新でマーケットプレイスエントリの追跡を再開します。

116 116 

117## 依存関係を持つプラグインを有効または無効にする

118 

119プラグインを有効にすると、それが依存するプラグインも有効になり、別の有効なプラグインがまだそれを必要としている場合、プラグインを無効にすることはブロックされます。両方の動作には Claude Code v2.1.143 以降が必要です。以前のバージョンは、名前付きプラグインのみを有効または無効にし、次のロード時に `dependency-unsatisfied` エラーを表示します。

120 

121プラグインを有効にすると、Claude Code は同じスコープでその依存関係も有効にします。依存関係が独自の依存関係を持つ場合、Claude Code はそれらも有効にします。成功メッセージは、名前を付けたプラグインと一緒に有効になったものをリストします。依存関係を有効にできない場合、コマンドは拒否され、何がブロックしているか、およびそれを修正する方法が表示されます。

122 

123| 条件 | 結果 |

124| :-------------------------------------------- | :------------------------------------------------------------ |

125| 依存関係がインストールされていない | 有効化が失敗し、各欠落している依存関係の `claude plugin install` コマンドを出力します。 |

126| 依存関係が組織のプラグインポリシーによってブロックされている | 有効化が失敗し、ブロックされた依存関係に名前を付けます。 |

127| 依存関係が、ターゲットスコープより優先度の高いスコープで `false` に設定されている | 有効化が失敗します。そのスコープで依存関係を有効にするか、`--scope` を渡してそこに書き込みます。 |

128| すべての依存関係がインストールされ、許可されている | 有効化が成功し、プラグインと、ターゲットスコープでまだ有効になっていない各依存関係に対して `true` を書き込みます。 |

129 

130プラグインを無効にすると、別の有効なプラグインがまだそれに依存している場合、Claude Code は拒否します。エラーはそれに依存するプラグインに名前を付け、正しい順序でそれらを無効にする連鎖コマンドを提供します。

131 

132たとえば、`deploy-kit` が `secrets-vault` に依存している場合、`secrets-vault` だけを無効にすると、次のような出力で失敗します。

133 

134```text theme={null}

135secrets-vault is still required by deploy-kit. Disable that plugin first, or

136disable everything together: claude plugin disable deploy-kit@acme-tools && claude plugin disable secrets-vault@acme-tools

137```

138 

139エラーから連鎖コマンドをコピーして、1 つのステップで完全なセットを無効にします。

140 

117## 孤立した自動インストール依存関係を削除する141## 孤立した自動インストール依存関係を削除する

118 142 

119自動インストール依存関係は、それらをインストールしたプラグインがアンインストールされた後もディスク上に留まります。これは、依存プラグインを再インストールしたい場合や、依存関係を直接使用し続けたい場合に備えてです。それらをクリーンアップするには、`claude plugin prune` を実行して、インストール済みプラグインがもう必要としない自動インストール依存関係をリストし、確認プロンプトの後に削除します。これには Claude Code v2.1.121 以降が必要です。143自動インストール依存関係は、それらをインストールしたプラグインがアンインストールされた後もディスク上に留まります。これは、依存プラグインを再インストールしたい場合や、依存関係を直接使用し続けたい場合に備えてです。それらをクリーンアップするには、`claude plugin prune` を実行して、インストール済みプラグインがもう必要としない自動インストール依存関係をリストし、確認プロンプトの後に削除します。これには Claude Code v2.1.121 以降が必要です。

161| `plugins` | array | 利用可能なプラグインのリスト | 以下を参照 |161| `plugins` | array | 利用可能なプラグインのリスト | 以下を参照 |

162 162 

163<Note>163<Note>

164 **予約名**：以下のマーケットプレイス名は Anthropic の公式使用のために予約されており、サードパーティのマーケットプレイスでは使用できません。`claude-code-marketplace`、`claude-code-plugins`、`claude-plugins-official`、`anthropic-marketplace`、`anthropic-plugins`、`agent-skills`、`knowledge-work-plugins`、`life-sciences`。公式マーケットプレイスになりすましている名前（`official-claude-plugins` や `anthropic-tools-v2` など）もブロックされています。164 **予約名**：以下のマーケットプレイス名は Anthropic の公式使用のために予約されており、サードパーティのマーケットプレイスでは使用できません。`claude-code-marketplace`、`claude-code-plugins`、`claude-plugins-official`、`anthropic-marketplace`、`anthropic-plugins`、`agent-skills`、`anthropic-agent-skills`、`knowledge-work-plugins`、`life-sciences`。公式マーケットプレイスになりすましている名前（`official-claude-plugins` や `anthropic-tools-v2` など）もブロックされています。

165</Note>165</Note>

166 166 

167### 所有者フィールド167### 所有者フィールド

200 200 

201| フィールド | タイプ | 説明 |201| フィールド | タイプ | 説明 |

202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| `displayName` | string | {/* min-version: 2.1.143 */}UI サーフェスに表示される人間が読める名前。省略された場合は `name` にフォールバックします。スペースと任意の大文字小文字を含めることができます。名前空間指定またはルックアップには使用されません。Claude Code v2.1.143 以降が必要です。 |

203| `description` | string | プラグインの簡潔な説明 |204| `description` | string | プラグインの簡潔な説明 |

204| `version` | string | プラグインバージョン。設定されている場合（ここまたは `plugin.json` で）、プラグインはこの文字列にピン留めされ、ユーザーは変更時にのみ更新を受け取ります。省略すると、git コミット SHA にフォールバックします。[バージョン解決](#version-resolution-and-release-channels)を参照してください。 |205| `version` | string | プラグインバージョン。設定されている場合（ここまたは `plugin.json` で）、プラグインはこの文字列にピン留めされ、ユーザーは変更時にのみ更新を受け取ります。省略すると、git コミット SHA にフォールバックします。[バージョン解決](#version-resolution-and-release-channels)を参照してください。 |

205| `author` | object | プラグイン作成者情報（`name` は必須、`email` はオプション） |206| `author` | object | プラグイン作成者情報（`name` は必須、`email` はオプション） |

20 20 

21プラグインは Claude Code に skills を追加し、`/name` ショートカットを作成します。これらは、あなたまたは Claude が呼び出すことができます。21プラグインは Claude Code に skills を追加し、`/name` ショートカットを作成します。これらは、あなたまたは Claude が呼び出すことができます。

22 22 

23**場所**: プラグインルートの `skills/` または `commands/` ディレクトリ23**場所**: プラグインルートの `skills/` または `commands/` ディレクトリ、またはプラグインルートの単一の `SKILL.md` ファイル

24 24