Documentation 2026-09-30 23:00 UTC to 2026-10-01 16:59 UTC

106| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)を読み込むのを停止します。組織の claude.ai でスキルをオフにすると、Claude Code は両方の同期を停止します。v2.1.273 以降では、既に同期したものも削除します。スキルをオフにせずにどちらか一方を停止するには、マネージド設定でそのキーを `false` に設定します | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |106| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)を読み込むのを停止します。組織の claude.ai でスキルをオフにすると、Claude Code は両方の同期を停止します。v2.1.273 以降では、既に同期したものも削除します。スキルをオフにせずにどちらか一方を停止するには、マネージド設定でそのキーを `false` に設定します | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |

107| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限します。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完全な効果リストを参照してください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |107| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限します。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完全な効果リストを参照してください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

108| [ログイン強制](/docs/ja/settings-reference#forceloginmethod) | ログインを特定の方法または Anthropic 組織に制限します。メソッド制限は VS Code 拡張機能、Agent SDK、`claude setup-token`、`/install-github-app` 全体に適用され、ターミナルのインタラクティブログイン画面（`/login` または初回オンボーディングで到達）はメソッドを事前選択しますが強制しません。Claude Code は、ターミナル、VS Code 拡張機能、Agent SDK での claude.ai アカウントログインの組織を検証し、Claude Console ログインまたは[ゲートウェイ](/docs/ja/claude-apps-gateway)サインインではチェックしません。v2.1.212 より前は、ターミナルログインのみが両方のキーを適用していました。設定すると、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` によって認証されたセッションはスタートアップでブロックされます。クラウドプロバイダーセッションは影響を受けません | `forceLoginMethod`、`forceLoginOrgUUID` |108| [ログイン強制](/docs/ja/settings-reference#forceloginmethod) | ログインを特定の方法または Anthropic 組織に制限します。メソッド制限は VS Code 拡張機能、Agent SDK、`claude setup-token`、`/install-github-app` 全体に適用され、ターミナルのインタラクティブログイン画面（`/login` または初回オンボーディングで到達）はメソッドを事前選択しますが強制しません。Claude Code は、ターミナル、VS Code 拡張機能、Agent SDK での claude.ai アカウントログインの組織を検証し、Claude Console ログインまたは[ゲートウェイ](/docs/ja/claude-apps-gateway)サインインではチェックしません。v2.1.212 より前は、ターミナルログインのみが両方のキーを適用していました。設定すると、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` によって認証されたセッションはスタートアップでブロックされます。クラウドプロバイダーセッションは影響を受けません | `forceLoginMethod`、`forceLoginOrgUUID` |

109| [プロバイダー制限](/docs/ja/settings-reference#allowedproviders) | マシンが使用できる API プロバイダーを制限します。リストに記載されていないプロバイダー上のセッションはスタートアップ時、ログイン時、および次に API に接続するときに拒否されます。Claude Code v2.1.285 以降が必要です | `allowedProviders` |

109| [エージェントビューを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにします | `disableAgentView` |110| [エージェントビューを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにします | `disableAgentView` |

110| [企業ランチャーを構成する](/docs/ja/corporate-launcher) | [バックグラウンドエージェントスーパーバイザー](/docs/ja/agent-view#how-background-sessions-are-hosted)、そのワーカー、および[その他のカバーされたバックグラウンドプロセス](/docs/ja/corporate-launcher#what-the-launcher-covers)に、エージェントビューをオフにする代わりに、必須の企業ランチャーをプレフィックスします | `processWrapper` |111| [企業ランチャーを構成する](/docs/ja/corporate-launcher) | [バックグラウンドエージェントスーパーバイザー](/docs/ja/agent-view#how-background-sessions-are-hosted)、そのワーカー、および[その他のカバーされたバックグラウンドプロセス](/docs/ja/corporate-launcher#what-the-launcher-covers)に、エージェントビューをオフにする代わりに、必須の企業ランチャーをプレフィックスします | `processWrapper` |

111| [モデル制限](/docs/ja/model-config#restrict-model-selection) | `availableModels` はピッカーに表示されるモデルをフィルタリングします。`enforceAvailableModels` を追加すると、自動選択されたデフォルトモデルも制限されます。このセッティングが CLI、ウェブ、IDE にどのように到達するかについては、[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage)を参照してください | `availableModels`、`enforceAvailableModels` |112| [モデル制限](/docs/ja/model-config#restrict-model-selection) | `availableModels` はピッカーに表示されるモデルをフィルタリングします。`enforceAvailableModels` を追加すると、自動選択されたデフォルトモデルも制限されます。このセッティングが CLI、ウェブ、IDE にどのように到達するかについては、[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage)を参照してください | `availableModels`、`enforceAvailableModels` |

418 ```418 ```

419</CodeGroup>419</CodeGroup>

420 420 

421リダイレクトをブロックを確認するには、コールバックを `PreToolUse` に `Write|Edit` マッチャーで登録し、エージェントに `/etc` の下にファイルを作成するよう指示します。メッセージストリーム内の Write ツールの結果に `Writing to /etc is not allowed` が含まれ、ファイルは作成されません。

422 

421<h3 id="auto-approve-specific-tools">423<h3 id="auto-approve-specific-tools">

422 特定のツールを自動承認する424 特定のツールを自動承認する

423</h3>425</h3>

468 470 

469イベントが発火すると、すべての一致するフックが並列で実行されます。権限決定については、最も制限的な結果が適用されます。単一の `deny` は他のフックが何を返すかに関わらずツール呼び出しをブロックします。完了順序は非決定的であるため、別のフックが最初に実行されたことに依存するのではなく、各フックが独立して動作するように記述してください。471イベントが発火すると、すべての一致するフックが並列で実行されます。権限決定については、最も制限的な結果が適用されます。単一の `deny` は他のフックが何を返すかに関わらずツール呼び出しをブロックします。完了順序は非決定的であるため、別のフックが最初に実行されたことに依存するのではなく、各フックが独立して動作するように記述してください。

470 472 

471以下の例は、すべてのツール呼び出しに対して 3 つの独立したチェックを登録します。473以下の例は、すべてのツール呼び出しに対して 3 つの独立したチェックを登録します。例の中のフック名（Python の `audit_logger` や TypeScript の `auditLogger` など）は、定義するコールバックの代わりになります。

472 474 

473<CodeGroup>475<CodeGroup>

474 ```python Python theme={null}476 ```python Python theme={null}

500 マルチツールマッチャーでフィルタリングする502 マルチツールマッチャーでフィルタリングする

501</h3>503</h3>

502 504 

503マルチツールマッチャーを使用して、関連するツール間で 1 つのコールバックを共有します。この例は異なるスコープを持つ 3 つのマッチャーを登録します。505マルチツールマッチャーを使用して、関連するツール間で 1 つのコールバックを共有します。この例は異なるスコープを持つ 3 つのマッチャーを登録し、各フックが名前の代わりになります。

504 506 

505* パイプで区切られた正確なリスト（`Write|Edit|NotebookEdit`）は、ファイル変更ツールに対してのみ `file_security_hook` をトリガーします。507* パイプで区切られた正確なリスト（`Write|Edit|NotebookEdit`）は、ファイル変更ツールに対してのみ `file_security_hook` をトリガーします。

506* 正規表現（`^mcp__`）は、`mcp__` で始まる名前を持つ MCP ツールに対して `mcp_audit_hook` をトリガーします。508* 正規表現（`^mcp__`）は、`mcp__` で始まる名前を持つ MCP ツールに対して `mcp_audit_hook` をトリガーします。

585 ```587 ```

586</CodeGroup>588</CodeGroup>

587 589 

590フックが発火することを確認するには、コールバックを登録し、エージェントに小さなタスクをサブエージェントに委譲するよう指示します。例えば、現在のディレクトリ内のファイルをリストアップするなど。サブエージェントが完了すると、コールバックはサブエージェントの ID とトランスクリプトパスを含む `[SUBAGENT] Completed:` 行を出力します。

591 

588<h3 id="make-http-requests-from-hooks">592<h3 id="make-http-requests-from-hooks">

589 フックから HTTP リクエストを実行する593 フックから HTTP リクエストを実行する

590</h3>594</h3>

121 121 

122権限モードは、Claude がツールをどのように使用するかについてグローバルコントロールを提供します。`query()` を呼び出すときに権限モードを設定するか、ストリーミングセッション中に動的に変更できます。122権限モードは、Claude がツールをどのように使用するかについてグローバルコントロールを提供します。`query()` を呼び出すときに権限モードを設定するか、ストリーミングセッション中に動的に変更できます。

123 123 

124設定しない場合、Claude Code は [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) のルールに従って開始権限モードを選択します。

125 

126* セッションの [設定ファイル](/docs/ja/settings#where-settings-live) から `permissions.defaultMode` が適用される場合

127* それ以外の場合は、[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) である可能性がある組み込みデフォルト

128 

129自動モードで開始するセッションは、[自動モードがアクションを評価する方法](/docs/ja/permission-modes#how-auto-mode-evaluates-actions) で説明されているように、`Bash` エントリなどの広い許可ルールを削除します。アプリケーションが `default` モードまたはそのようなルールに依存している場合は、`default` を明示的に渡してください。

130 

131TypeScript Agent SDK v0.3.286 より前では、`permissionMode` を省略することは `default` を渡すことと同じでした。

132 

124<h3 id="available-modes">133<h3 id="available-modes">

125 利用可能なモード134 利用可能なモード

126</h3>135</h3>

536| `receive_messages()` | Claude からのすべてのメッセージを非同期イテレータとして受け取ります |536| `receive_messages()` | Claude からのすべてのメッセージを非同期イテレータとして受け取ります |

537| `receive_response()` | ResultMessage を含むまでのメッセージを受け取ります |537| `receive_response()` | ResultMessage を含むまでのメッセージを受け取ります |

538| `interrupt()` | 割り込み信号を送信します（ストリーミングモードでのみ機能） |538| `interrupt()` | 割り込み信号を送信します（ストリーミングモードでのみ機能） |

539| `set_permission_mode(mode)` | 現在のセッションのパーミッションモードを変更します |539| `set_permission_mode(mode)` | 現在のセッションの権限モードを変更します |

540| `set_model(model)` | 現在のセッションのモデルを変更します。[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットするには `None` を渡します |540| `set_model(model)` | 現在のセッションのモデルを変更します。[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットするには `None` を渡します |

541| `rewind_files(user_message_id)` | ファイルを指定されたユーザーメッセージの状態に復元します。`enable_file_checkpointing=True` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照 |541| `rewind_files(user_message_id)` | ファイルを指定されたユーザーメッセージの状態に復元します。`enable_file_checkpointing=True` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照 |

542| `get_mcp_status()` | すべての設定済み MCP サーバーのステータスを取得します。[`McpStatusResponse`](#mcpstatusresponse) を返します |542| `get_mcp_status()` | すべての設定済み MCP サーバーのステータスを取得します。[`McpStatusResponse`](#mcpstatusresponse) を返します |

543| `reconnect_mcp_server(server_name)` | 失敗したか切断された MCP サーバーへの再接続を試みます |543| `reconnect_mcp_server(server_name)` | 失敗したか切断された MCP サーバーへの再接続を試みます |

544| `toggle_mcp_server(server_name, enabled)` | セッション中に MCP サーバーを有効または無効にします。無効にするとそのツールが削除されます |544| `toggle_mcp_server(server_name, enabled)` | セッション中に MCP サーバーを有効または無効にします。stdio、SSE、または HTTP サーバーを無効にするとそのツールが削除されます |

545| `stop_task(task_id)` | 実行中のバックグラウンドタスクを停止します。ステータス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセージストリームに続きます |545| `stop_task(task_id)` | 実行中のバックグラウンドタスクを停止します。ステータス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセージストリームに続きます |

546| `get_server_info()` | サーバーの初期化情報（利用可能なコマンドと出力スタイルを含む）を取得します |546| `get_server_info()` | サーバーの初期化情報（利用可能なコマンドと出力スタイルを含む）を取得します |

547| `disconnect()` | Claude から切断します |547| `disconnect()` | Claude から切断します |

616 例 - ClaudeSDKClient でのストリーミング入力616 例 - ClaudeSDKClient でのストリーミング入力

617</h4>617</h4>

618 618 

619`query()` はユーザーメッセージ辞書の非同期イテレータも受け入れるため、送信時にプロンプトを組み立てたり、画像などのコンテンツブロックを含めたりできます。Claude Code は最初に生成されたメッセージが到着するとすぐに応答を開始し、イテレータが完了するのを待たず、`receive_response()` はそのレスポンスを終了する `ResultMessage` で停止します。Claude が回答する前に読むべきすべてのものを 1 つのメッセージに入れてください。このジェネレータが行うように、各 `query()` 呼び出しを独自の `receive_response()` ループとペアにしてください。

620 

619```python theme={null}621```python theme={null}

620import asyncio622import asyncio

621from claude_agent_sdk import ClaudeSDKClient623from claude_agent_sdk import ClaudeSDKClient

622 624 

623 625 

624async def message_stream():626async def message_stream():

625 """Generate messages dynamically."""627 """Assemble the prompt at send time and yield it as one user message."""

626 yield {628 readings = {"Temperature": "25°C", "Humidity": "60%"}

627 "type": "user",629 data = ", ".join(f"{name}: {value}" for name, value in readings.items())

628 "message": {"role": "user", "content": "Analyze the following data:"},

629 }

630 await asyncio.sleep(0.5)

631 yield {

632 "type": "user",

633 "message": {"role": "user", "content": "Temperature: 25°C, Humidity: 60%"},

634 }

635 await asyncio.sleep(0.5)

636 yield {630 yield {

637 "type": "user",631 "type": "user",

638 "message": {"role": "user", "content": "What patterns do you see?"},632 "message": {

633 "role": "user",

634 "content": f"Analyze the following sensor data and describe any patterns you see: {data}",

635 },

639 }636 }

640 637 

641 638 

705</Note>702</Note>

706 703 

707<h4 id="example-advanced-permission-control">704<h4 id="example-advanced-permission-control">

708 例 - 高度なパーミッション制御705 例 - 高度な権限制御

709</h4>706</h4>

710 707 

711```python theme={null}708```python theme={null}

2712 2709 

2713すべての組み込み Claude Code ツールの入出力スキーマのドキュメント。Python SDK はこれらを型としてエクスポートしませんが、メッセージ内のツール入出力の構造を表します。2710すべての組み込み Claude Code ツールの入出力スキーマのドキュメント。Python SDK はこれらを型としてエクスポートしませんが、メッセージ内のツール入出力の構造を表します。

2714 2711 

2712各出力は、そのツールの [`UserMessage.tool_use_result`](#usermessage) から読み込む値です。キー名は Claude Code が発行する通りに表示されます。「存在する場合」または「オプション」というコメント付きで `| None` と注釈が付けられたキーは、適用されない場合は省略されます。

2713 

2715<h3 id="agent">2714<h3 id="agent">

2716 Agent2715 Agent

2717</h3>2716</h3>

2729 "run_in_background": bool | None, # エージェントはデフォルトでバックグラウンドで実行されます。同期実行する場合は False に設定2728 "run_in_background": bool | None, # エージェントはデフォルトでバックグラウンドで実行されます。同期実行する場合は False に設定

2730 "name": str | None, # スポーンされたエージェントの名前2729 "name": str | None, # スポーンされたエージェントの名前

2731 "team_name": str | None, # 非推奨。無視されます2730 "team_name": str | None, # 非推奨。無視されます

2732 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # 非推奨。無視されます。サブエージェントは親セッションの権限モードを継承します。エージェント定義フロントマターがこれをオーバーライドする場合があります2731 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # 非推奨。無視されます。サブエージェント継承ルールがサブエージェントの権限モードを決定します

2733 "isolation": "worktree" | "remote" | None, # エージェントの変更の分離モード2732 "isolation": "worktree" | "remote" | None, # エージェントの変更の分離モード

2734}2733}

2735```2734```

2884 2883 

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

2886 2885 

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

2888 2887 

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

2890 2889 

2926 "command": str | None, # シェルスクリプト。各 stdout 行はイベント、終了はウォッチを終了2925 "command": str | None, # シェルスクリプト。各 stdout 行はイベント、終了はウォッチを終了

2927 "ws": dict | None, # WebSocket ソース：{"url": str, "protocols": list[str] | None}。各テキストフレームはイベント2926 "ws": dict | None, # WebSocket ソース：{"url": str, "protocols": list[str] | None}。各テキストフレームはイベント

2928 "description": str, # 通知に表示される短い説明2927 "description": str, # 通知に表示される短い説明

2929 "timeout_ms": int | None, # この期限後に強制終了（デフォルト 300000、最大 3600000。有効な期限は最大 1800000）2928 "timeout_ms": int | None, # 期限（ミリ秒）（デフォルト 300000、最大 3600000。有効な期限は最大 1800000）

2930}2929}

2931```2930```

2932 2931 

2961 2960 

2962```python theme={null}2961```python theme={null}

2963{2962{

2964 "message": str, # 確認メッセージ2963 "filePath": str, # 編集されたファイル

2965 "replacements": int, # 実行された置換の数2964 "oldString": str, # 置換されたテキスト

2966 "file_path": str, # 編集されたファイルパス2965 "newString": str, # それを置換したテキスト

2966 "originalFile": str | None, # 編集前のファイルコンテンツ

2967 "structuredPatch": [ # 変更の差分ハンク

2968 {

2969 "oldStart": int,

2970 "oldLines": int,

2971 "newStart": int,

2972 "newLines": int,

2973 "lines": list[str],

2974 }

2975 ],

2976 "userModified": bool, # ユーザーが提案された編集を受け入れる前に変更したかどうか

2977 "replaceAll": bool, # すべての出現が置換されたかどうか

2978 "gitDiff": { # ファイルのオプションの git 差分サマリー

2979 "filename": str,

2980 "status": "modified" | "added",

2981 "additions": int,

2982 "deletions": int,

2983 "changes": int,

2984 "patch": str,

2985 "repository": str | None, # 利用可能な場合は GitHub owner/repo

2986 } | None,

2967}2987}

2968```2988```

2969 2989 

2983}3003}

2984```3004```

2985 3005 

2986**出力（テキストファイル）：**3006出力は Claude が読み込んだ内容に応じて、以下の形状のいずれかを取ります。`type` キーをチェックして区別してください。

3007 

3008**出力（type：`"text"`）：**

2987 3009 

2988```python theme={null}3010```python theme={null}

2989{3011{

2990 "content": str, # 行番号付きのファイル内容3012 "type": "text",

2991 "total_lines": int, # ファイルの総行数3013 "file": {

2992 "lines_returned": int, # 実際に返された行数3014 "filePath": str, # 読み込まれたファイル

3015 "content": str, # 返されたコンテンツ

3016 "numLines": int, # 返されたコンテンツの行数

3017 "startLine": int, # コンテンツが開始する行番号

3018 "totalLines": int, # ファイルの総行数

3019 "truncatedByTokenCap": bool | None, # 全ファイル読み込みがトークン上限を超えた場合に存在し True。コンテンツは最初のページ

3020 },

2993}3021}

2994```3022```

2995 3023 

2996**出力（画像）：**3024**出力（type：`"image"`）：**

2997 3025 

2998```python theme={null}3026```python theme={null}

2999{3027{

3000 "image": str, # Base64 エンコードされた画像データ3028 "type": "image",

3001 "mime_type": str, # 画像の MIME タイプ3029 "file": {

3002 "file_size": int, # ファイルサイズ（バイト）3030 "base64": str, # Base64 エンコードされた画像データ

3031 "type": "image/jpeg" | "image/png" | "image/gif" | "image/webp", # 画像 MIME タイプ

3032 "originalSize": int, # 元のファイルサイズ（バイト）

3033 "dimensions": { # 座標マッピング用のオプションのサイジング情報

3034 "originalWidth": int | None, # オプション。元の幅（ピクセル）

3035 "originalHeight": int | None, # オプション。元の高さ（ピクセル）

3036 "displayWidth": int | None, # オプション。リサイズ後の幅

3037 "displayHeight": int | None, # オプション。リサイズ後の高さ

3038 } | None,

3039 },

3040}

3041```

3042 

3043**出力（type：`"notebook"`）：**

3044 

3045```python theme={null}

3046{

3047 "type": "notebook",

3048 "file": {

3049 "filePath": str, # 読み込まれたノートブック

3050 "cells": list, # ノートブックセル

3051 },

3052}

3053```

3054 

3055**出力（type：`"pdf"`）：**

3056 

3057```python theme={null}

3058{

3059 "type": "pdf",

3060 "file": {

3061 "filePath": str, # 読み込まれた PDF

3062 "base64": str, # Base64 エンコードされた PDF データ

3063 "originalSize": int, # ファイルサイズ（バイト）

3064 },

3065}

3066```

3067 

3068**出力（type：`"parts"`）：**

3069 

3070```python theme={null}

3071{

3072 "type": "parts",

3073 "file": {

3074 "filePath": str, # 読み込まれた PDF

3075 "originalSize": int, # ファイルサイズ（バイト）

3076 "count": int, # 画像として抽出されたページ数

3077 "outputDir": str, # 抽出されたページ画像を含むディレクトリ

3078 },

3079 "firstPage": int | None, # オプション。最初に抽出されたページのドキュメントページ番号

3080}

3081```

3082 

3083**出力（type：`"file_unchanged"`）：**

3084 

3085```python theme={null}

3086{

3087 "type": "file_unchanged", # ファイルはこのセッションで Claude が最後に読み込んだ以降変更されていないため、コンテンツは繰り返されません

3088 "file": {

3089 "filePath": str,

3090 },

3091 "source": "seeded" | None, # 以前のコピーが起動時に読み込まれた CLAUDE.md またはメモリファイルから来た場合に存在

3003}3092}

3004```3093```

3005 3094 

3022 3111 

3023```python theme={null}3112```python theme={null}

3024{3113{

3025 "message": str, # 成功メッセージ3114 "type": "create" | "update", # 書き込みが新しいファイルを作成したか、既存のファイルを上書きしたか

3026 "bytes_written": int, # 書き込まれたバイト数3115 "filePath": str, # 書き込まれたファイル

3027 "file_path": str, # 書き込まれたファイルパス3116 "content": str, # 書き込まれたコンテンツ

3117 "structuredPatch": [ # 差分ハンク。新しいファイル、何も変更されなかった場合、または Claude Code が差分をスキップした場合は空

3118 {

3119 "oldStart": int,

3120 "oldLines": int,

3121 "newStart": int,

3122 "newLines": int,

3123 "lines": list[str],

3124 }

3125 ],

3126 "originalFile": str | None, # 以前のコンテンツ。新しいファイルの場合または以前のコンテンツが大きすぎて含められない場合は None

3127 "gitDiff": { # ファイルのオプションの git 差分サマリー

3128 "filename": str,

3129 "status": "modified" | "added",

3130 "additions": int,

3131 "deletions": int,

3132 "changes": int,

3133 "patch": str,

3134 "repository": str | None, # 利用可能な場合は GitHub owner/repo

3135 } | None,

3136 "userModified": bool | None, # オプション。ユーザーが受け入れる前に提案されたコンテンツを編集したかどうか

3028}3137}

3029```3138```

3030 3139 

3047 3156 

3048```python theme={null}3157```python theme={null}

3049{3158{

3050 "matches": list[str], # マッチしたファイルパスの配列3159 "durationMs": int, # 検索の実行に要した時間（ミリ秒）

3051 "count": int, # 見つかったマッチの数3160 "numFiles": int, # 返されたパスの数。切り詰め後

3052 "search_path": str, # 使用された検索ディレクトリ3161 "filenames": list[str], # マッチしたファイルパス

3162 "truncated": bool, # 結果が 100 ファイルの上限で切り詰められたかどうか

3163 "totalMatches": int | None, # オプション。切り詰め前のマッチするファイルの総数。countIsComplete が False の場合は下限

3164 "countIsComplete": bool | None, # オプション。totalMatches が正確かどうか

3053}3165}

3054```3166```

3055 3167 

3168`totalMatches` と `countIsComplete` には Claude Code v2.1.191 以降が必要です。

3169 

3056<h3 id="grep">3170<h3 id="grep">

3057 Grep3171 Grep

3058</h3>3172</h3>

3073 "-B": int | None, # 各マッチの前に表示する行3187 "-B": int | None, # 各マッチの前に表示する行

3074 "-A": int | None, # 各マッチの後に表示する行3188 "-A": int | None, # 各マッチの後に表示する行

3075 "-C": int | None, # 前後に表示する行3189 "-C": int | None, # 前後に表示する行

3190 "context": int | None, # 前後に表示する行。-C はエイリアス

3191 "-o": bool | None, # 各行のマッチした部分のみを出力

3076 "head_limit": int | None, # 出力を最初の N 行/エントリに制限3192 "head_limit": int | None, # 出力を最初の N 行/エントリに制限

3193 "offset": int | None, # head_limit を適用する前に最初の N 行/エントリをスキップ

3077 "multiline": bool | None, # マルチラインモードを有効化3194 "multiline": bool | None, # マルチラインモードを有効化

3078}3195}

3079```3196```

3080 3197 

3081**出力（content モード）：**3198**出力：**

3082 3199 

3083```python theme={null}3200```python theme={null}

3084{3201{

3085 "matches": [3202 "mode": "content" | "files_with_matches" | "count" | None, # 使用された出力モード

3086 {3203 "numFiles": int, # 結果内のファイル数。content モードでは常に 0

3087 "file": str,3204 "filenames": list[str], # files_with_matches モードのマッチするファイル。他のモードでは空

3088 "line_number": int | None,3205 "content": str | None, # content モードのマッチする行、または count モードのファイルごとのカウント

3089 "line": str,3206 "numLines": int | None, # コンテンツ内の行数。content モードに存在

3090 "before_context": list[str] | None,3207 "numMatches": int | None, # 総マッチ数。count モードに存在

3091 "after_context": list[str] | None,3208 "totalFiles": int | None, # オプション。files_with_matches モードで head_limit と offset の前の総数

3092 }3209 "totalLines": int | None, # オプション。content モードで head_limit と offset の前の総数

3093 ],3210 "appliedLimit": int | None, # head_limit が結果を切り詰めた場合に存在

3094 "total_matches": int,3211 "appliedOffset": int | None, # オフセットが適用された場合に存在

3095}3212}

3096```3213```

3097 3214 

3098**出力（files\_with\_matches モード）：**3215Grep は各出力モードでこの dict 形状を返します。どのオプションキーが存在するかは `output_mode` に依存します。

3099 3216 

3100```python theme={null}3217`totalFiles` には Claude Code v2.1.208 以降が必要です。`totalLines` には Claude Code v2.1.210 以降が必要です。

3101{

3102 "files": list[str], # マッチを含むファイル

3103 "count": int, # マッチを含むファイルの数

3104}

3105```

3106 3218 

3107<h3 id="notebookedit">3219<h3 id="notebookedit">

3108 NotebookEdit3220 NotebookEdit

3126 3238 

3127```python theme={null}3239```python theme={null}

3128{3240{

3129 "message": str, # 成功メッセージ3241 "new_source": str, # セルに書き込まれたソース

3130 "edit_type": "replaced" | "inserted" | "deleted", # 実行された編集のタイプ3242 "old_source": str | None, # 以前のセルソース。replace と delete に存在

3131 "cell_id": str | None, # 影響を受けたセル ID3243 "cell_id": str | None, # 編集されたセルの ID。利用可能な場合

3132 "total_cells": int, # 編集後のノートブックの総セル数3244 "cell_type": "code" | "markdown", # セルタイプ

3245 "language": str, # ノートブックのプログラミング言語

3246 "edit_mode": str, # 使用された編集モード

3247 "error": str | None, # 操作が失敗した場合のエラーメッセージ

3248 "notebook_path": str, # ノートブックファイル

3249 "original_file": str, # 編集前のノートブックコンテンツ

3250 "updated_file": str, # 編集後のノートブックコンテンツ

3133}3251}

3134```3252```

3135 3253 

3227 3345 

3228```python theme={null}3346```python theme={null}

3229{3347{

3230 "message": str, # 成功メッセージ3348 "oldTodos": [ # 更新前の todo リスト

3231 "stats": {"total": int, "pending": int, "in_progress": int, "completed": int},3349 {

3350 "content": str,

3351 "status": "pending" | "in_progress" | "completed",

3352 "activeForm": str,

3353 }

3354 ],

3355 "newTodos": [ # 更新後の todo リスト

3356 {

3357 "content": str,

3358 "status": "pending" | "in_progress" | "completed",

3359 "activeForm": str,

3360 }

3361 ],

3232}3362}

3233```3363```

3234 3364 

3400 3530 

3401```python theme={null}3531```python theme={null}

3402{3532{

3403 "message": str, # 確認メッセージ3533 "plan": str | None, # ユーザーに提示されたプラン

3404 "approved": bool | None, # ユーザーがプランを承認したかどうか3534 "isAgent": bool, # サブエージェントがツールを呼び出した場合は True

3535 "filePath": str | None, # プランがファイルに保存された場合に存在

3536 "hasTaskTool": bool | None, # オプション。現在のコンテキストで Agent ツールが利用可能かどうか

3537 "planWasEdited": bool | None, # ユーザーが承認する前にプランを編集した場合に存在し True

3538 "awaitingLeaderApproval": bool | None, # チームメイトがプランをチームリーダーに承認を求めて送信した場合に存在し True

3539 "requestId": str | None, # その承認リクエストのオプション ID

3405}3540}

3406```3541```

3407 3542 

3419}3554}

3420```3555```

3421 3556 

3557結果は dict ではなくリストであるため、`tool_use_result` はこのツールに対して `list` を保持します。

3558 

3422**出力：**3559**出力：**

3423 3560 

3424```python theme={null}3561```python theme={null}

3425{3562[ # リソースごとに 1 つのエントリ

3426 "resources": [

3427 {3563 {

3428 "uri": str,3564 "uri": str, # リソース URI

3429 "name": str,3565 "name": str, # リソース名

3430 "description": str | None,3566 "mimeType": str | None, # オプション。MIME タイプ

3431 "mimeType": str | None,3567 "description": str | None, # オプション。説明

3432 "server": str,3568 "server": str, # このリソースを提供するサーバー

3433 }3569 }

3434 ],3570]

3435 "total": int,

3436}

3437```3571```

3438 3572 

3439<h3 id="readmcpresource">3573<h3 id="readmcpresource">

3456```python theme={null}3590```python theme={null}

3457{3591{

3458 "contents": [3592 "contents": [

3459 {"uri": str, "mimeType": str | None, "text": str | None, "blob": str | None}3593 {

3594 "uri": str, # リソース URI

3595 "mimeType": str | None, # オプション。MIME タイプ

3596 "text": str | None, # テキストコンテンツ、またはバイナリコンテンツに関する注記

3597 "blobSavedTo": str | None, # Claude Code がバイナリコンテンツをディスクに保存した場合に存在。保存されたファイルのパス

3598 }

3460 ],3599 ],

3461 "server": str,3600 "error": str | None, # サーバーがリソースを読み込めなかった場合に存在

3462}3601}

3463```3602```

3464 3603 

575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/docs/ja/agent-sdk/structured-outputs) を参照してください |575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/docs/ja/agent-sdk/structured-outputs) を参照してください |

576| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効化](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style) を参照してください |576| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効化](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style) を参照してください |

577| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行可能ファイルへのパス。オプション依存関係がインストール中にスキップされた場合、またはプラットフォームがサポートされているセットにない場合にのみ必要です |577| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行可能ファイルへのパス。オプション依存関係がインストール中にスキップされた場合、またはプラットフォームがサポートされているセットにない場合にのみ必要です |

578| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | セッションの権限モード |578| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの権限モード。省略した場合、セッションは自動モードで開始できます。[権限モード](/docs/ja/agent-sdk/permissions#permission-modes) を参照して、Claude Code がどのように開始権限モードを選択するかを確認してください |

579| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプト用の MCP ツール名 |579| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプト用の MCP ツール名 |

580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答するのは誰か: `'host'` はそれらを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は [プロンプトが表示されるはずだった呼び出しを拒否](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) します。Claude Code v2.1.259 以降が必要です |580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答するのは誰か: `'host'` はそれらを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は [プロンプトが表示されるはずだった呼び出しを拒否](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) します。Claude Code v2.1.259 以降が必要です |

581| `persistSession` | `boolean` | `true` | `false` の場合、セッションのディスクへの永続化を無効にします。セッションは後で再開できません |581| `persistSession` | `boolean` | `true` | `false` の場合、セッションのディスクへの永続化を無効にします。セッションは後で再開できません |

716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles) を再読み込みして、ミッドセッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決します。Agent SDK v0.3.261 以降が必要です |716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles) を再読み込みして、ミッドセッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決します。Agent SDK v0.3.261 以降が必要です |

717| `accountInfo()` | アカウント情報を返します |717| `accountInfo()` | アカウント情報を返します |

718| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は [`mcpServers`](#options) または `setMcpServers()` を通じて設定したサーバーを再接続し、設定ファイルエントリではありません。その解決順序には Claude Code v2.1.257 以降が必要です |718| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は [`mcpServers`](#options) または `setMcpServers()` を通じて設定したサーバーを再接続し、設定ファイルエントリではありません。その解決順序には Claude Code v2.1.257 以降が必要です |

719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で MCP サーバーを名前で有効または無効にします。無効にするとサーバーが切断されます |719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で MCP サーバーを名前で有効または無効にします。無効にするとサーバーが切断されます。ミッドセッション中に `setMcpServers()` で追加したサーバーの場合、ツール削除には Claude Code v2.1.285 以降が必要です |

720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |

721| `readMcpResource(serverName, uri)` | *アルファ。* 接続された MCP サーバーから 1 つの MCP Apps `ui://` リソースを読み取り、アプリケーションがツールのウィジェットをレンダリングできるようにします。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決します。TypeScript Agent SDK v0.3.280 以降が必要です |721| `readMcpResource(serverName, uri)` | *アルファ。* 接続された MCP サーバーから 1 つの MCP Apps `ui://` リソースを読み取り、アプリケーションがツールのウィジェットをレンダリングできるようにします。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決します。TypeScript Agent SDK v0.3.280 以降が必要です |

722| `streamInput(stream)` | マルチターン会話のためにクエリにメッセージをストリーミングします |722| `streamInput(stream)` | マルチターン会話のためにクエリにメッセージをストリーミングします |

1768 1768 

1769* 最初の返信以外の返信フレーム1769* 最初の返信以外の返信フレーム

1770* サブエージェントフレーム1770* サブエージェントフレーム

1771* `uuid` を持つメッセージに答えないターン：ターンが `uuid` なしで送信したメッセージに答えたか、Claude Code がターンを開始し、`uuid` を持つ通常のメッセージを取得しなかった1771* `uuid` を持つメッセージに答えないターン：ターンが `uuid` を持つ通常のメッセージに答えないか、Claude Code がターンを開始し、`uuid` を持つ通常のメッセージを取得しなかった

1772* 送信したメッセージに答えない結果。クラッシュしたワーカープロセス後のゼロ化された結果など1772* 送信したメッセージに答えない結果。クラッシュしたワーカープロセス後のゼロ化された結果など

1773 1773 

1774<h4 id="user_message_uuids">1774<h4 id="user_message_uuids">

1821```typescript theme={null}1821```typescript theme={null}

1822type SDKStartupFailureReason =1822type SDKStartupFailureReason =

1823 | "org_pin_api_key_conflict"1823 | "org_pin_api_key_conflict"

1824 | "provider_not_allowed"

1824 | "org_verify_failed"1825 | "org_verify_failed"

1825 | "org_pin_mismatch"1826 | "org_pin_mismatch"

1826 | "managed_settings_invalid"1827 | "managed_settings_invalid"

1843| 値 | セッションを停止したもの |1844| 値 | セッションを停止したもの |

1844| :- | :- |1845| :- | :- |

1845| `org_pin_api_key_conflict` | 管理設定が [ファーストパーティまたはクラウドゲートウェイサインイン](/docs/ja/authentication#restrict-login-to-your-organization) を必要とし、Anthropic API キー、認証トークン、または `apiKeyHelper` が代わりに設定されている |1846| `org_pin_api_key_conflict` | 管理設定が [ファーストパーティまたはクラウドゲートウェイサインイン](/docs/ja/authentication#restrict-login-to-your-organization) を必要とし、Anthropic API キー、認証トークン、または `apiKeyHelper` が代わりに設定されている |

1847| `provider_not_allowed` | 管理設定が [このマシンが使用できる API プロバイダーをリストアップ](/docs/ja/settings-reference#allowedproviders) し、セッションがリストされていないプロバイダー、または設定がピンしないエンドポイント用に設定されている。Claude Code v2.1.285 以降が必要です |

1846| `org_verify_failed` | サインインの組織をピンに対して検証できなかった。例えば、ネットワーク障害または失効したトークンのため |1848| `org_verify_failed` | サインインの組織をピンに対して検証できなかった。例えば、ネットワーク障害または失効したトークンのため |

1847| `org_pin_mismatch` | サインインがピンが許可しない組織に属している |1849| `org_pin_mismatch` | サインインがピンが許可しない組織に属している |

1848| `managed_settings_invalid` | 管理ポリシー設定を読み取ることができず、ピンが組織に名前を付けず、または [管理モデル制限](/docs/ja/errors#managed-settings-block-the-default-model) がデフォルトオプションに許可されたモデルを残していない |1850| `managed_settings_invalid` | 管理ポリシー設定を読み取ることができず、ピンが組織に名前を付けず、または [管理モデル制限](/docs/ja/errors#managed-settings-block-the-default-model) がデフォルトオプションに許可されたモデルを残していない |

1908 1910 

1909ターミナルスラッシュコマンド：`terminal_slash_commands` は、`slash_commands` のエントリのうち、そのインターフェースがローカルターミナルにバインドされているもの（`exit` など）に名前を付けます。他の `slash_commands` エントリと同じように送信できます。フィールドは、リモートまたはモバイルクライアントがコマンドメニューから非表示にできるように存在します。フィールドは空でない場合にのみ存在し、Agent SDK v0.3.229 以降が必要です。1911ターミナルスラッシュコマンド：`terminal_slash_commands` は、`slash_commands` のエントリのうち、そのインターフェースがローカルターミナルにバインドされているもの（`exit` など）に名前を付けます。他の `slash_commands` エントリと同じように送信できます。フィールドは、リモートまたはモバイルクライアントがコマンドメニューから非表示にできるように存在します。フィールドは空でない場合にのみ存在し、Agent SDK v0.3.229 以降が必要です。

1910 1912 

1911* 努力レベル：`effort` は、[努力レベル](/docs/ja/model-config#adjust-effort-level)。Claude Code がセッションの次のリクエストで送信するか、何も送信しない場合は `null`。Claude Code は、[リモートコントロール](/docs/ja/remote-control) クライアントに送信する初期化メッセージでのみフィールドを設定し、アプリケーションが読み取る初期化メッセージから省略します。Agent SDK v0.3.234 以降が必要です。1913* 努力レベル：`effort` は、[努力レベル](/docs/ja/model-config#adjust-effort-level) Claude Code がセッションの次のリクエストで送信するか、何も送信しない場合は `null`。Claude Code は、[リモートコントロール](/docs/ja/remote-control) クライアントに送信する初期化メッセージでのみフィールドを設定し、アプリケーションが読み取る初期化メッセージから省略します。Agent SDK v0.3.234 以降が必要です。

1912 1914 

1913`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出できます。これはオープンセットです：認識しない値は無視し、依存する動作の特定の機能をチェックしてください。フィールドには Claude Code v2.1.205 以降が必要であり、以前の CLI では不在です。1915`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出できます。これはオープンセットです：認識しない値は無視し、依存する動作の特定の機能をチェックしてください。フィールドには Claude Code v2.1.205 以降が必要であり、以前の CLI では不在です。

1914 1916 

3184};3186};

3185```3187```

3186 3188 

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

3188 3190 

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

3190 Monitor3192 Monitor

4088 4090 

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

4090 4092 

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

4092 4094 

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

4094 4096 

8 8 

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

10 10 

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

12 12 

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

14 14 

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

16 16 

966 966 

967Claude Code は、`Enter` からまたは `claude attach` から実行される[シェルコマンド](#run-a-shell-command)を実行している行を再開しません。これはコマンドを再度実行するためです。行のメッセージと `claude attach` の両方は、コマンドが再度実行されないことを示しています。967Claude Code は、`Enter` からまたは `claude attach` から実行される[シェルコマンド](#run-a-shell-command)を実行している行を再開しません。これはコマンドを再度実行するためです。行のメッセージと `claude attach` の両方は、コマンドが再度実行されないことを示しています。

968 968 

969<h4 id="terminal-host-died">

970 ターミナルホストが停止した

971</h4>

972 

973Linux と WSL では、スーパーバイザーはセッションを開くかどうかに関わらず数秒ごとに各ホストプロセスをチェックし、プロセスが終了しているがスーパーバイザーへの接続が閉じられていない場合、セッションを失敗としてマークします。

974 

975* エージェントビューでは、行は `terminal host process died — press Enter to restart` を表示します。それで `Enter` を押すと、Claude Code はセッションを新しいホストプロセスで再開します。

976* シェルから、`claude attach <id>` は既に失敗としてマークされたセッションを再開します。それ以外の場合は原因を報告して終了し、`claude attach <id>` を再度実行するよう指示します。

977 

978<h4 id="session-isn’t-responding">

979 セッションが応答していない

980</h4>

981 

982スーパーバイザーが開いた状態を受け入れるが、約 10 秒間出力が到着しない場合、Claude Code は試みを終了し、再開を提供します。単にスタールしたセッション（例えば、マシンスリープ全体）はこの提供に到達しません。スーパーバイザーは[開く時に自動的にそれを再開します](#read-session-state)。

983 

984* エージェントビューでは、フッターは `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` を表示します。同じ行で再度 `Enter` を押すと、Claude Code は応答しないプロセスを停止し、セッションを再開します。その 2 番目の押下なしに何も停止しません。

985* シェルから、`claude attach <id>` は原因を報告して終了し、`claude stop <id>` を実行してから `claude attach <id>` を実行するよう指示します。

986 

987<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">969<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

988 セッションが `possibly low memory` ノートで開始前に失敗する970 セッションが `possibly low memory` ノートで開始前に失敗する

989</h3>971</h3>

384 384 

385`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID（アプリケーション推論プロファイル ARN など）も同様です。385`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID（アプリケーション推論プロファイル ARN など）も同様です。

386 386 

387これらのチェックがアカウントが呼び出せないモデルを見つけた場合、Claude Code はこのマシンで最大 1 日間その拒否を記憶し、その時間中は Amazon Bedrock に再度問い合わせることなく記憶されたモデルをスキップして起動します。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過すると起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ja/env-vars)を設定してください。

388 

389<h3 id="when-a-model-is-disabled-mid-session">

390 モデルがセッション中に無効化される場合

391</h3>

392 

393セッションが実行されているモデルへのアカウントアクセスが失われた場合（例えば、管理者が Amazon Bedrock アカウントでそれを無効化した場合）、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。スタートアップフォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合、デフォルト Sonnet モデルを試します。

394 

395切り替えは、ピン留めしていないティアにのみ適用されます。これはスタートアップフォールバックと同じ条件です。選択した特定のバージョン、または[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)でセッションを実行している場合、そのモデルを保持し、フォールバックモデルチェーンがないため、リクエストは失敗します。[自動モード](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Amazon Bedrock で自動モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは[AWS 認証失敗](/docs/ja/errors#aws-authentication-failed)で失敗し、モデルを有効にするためのヒントが表示されます。

396 

397設定した[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否では Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わるのではなく失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否で切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。

398 

387<h2 id="cross-region-inference-profile-prefixes">399<h2 id="cross-region-inference-profile-prefixes">

388 クロスリージョン推論プロファイルプレフィックス400 クロスリージョン推論プロファイルプレフィックス

389</h2>401</h2>

398| [環境変数](/docs/ja/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` を設定します |398| [環境変数](/docs/ja/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` を設定します |

399| [権限ルール](/docs/ja/permissions) | `permissions.deny` に `Artifact` を追加します |399| [権限ルール](/docs/ja/permissions) | `permissions.deny` に `Artifact` を追加します |

400 400 

401[`--settings`](/docs/ja/cli-reference#cli-flags) ファイルで、または `CLAUDE_CODE_DISABLE_ARTIFACT` でアーティファクトをオフにした場合、あるいは管理者が [管理設定](/docs/ja/server-managed-settings) でアーティファクトをオフにした場合、どの設定ファイルもアーティファクトを再度オンにすることはできません。v2.1.242 より前では、[優先度スタック](/docs/ja/settings#settings-precedence) の上位にあるファイルが、下位のファイルで `"enableArtifact": false` が設定されていても、アーティファクトを再度オンにすることができました。401[`--settings`](/docs/ja/cli-reference#cli-flags) ファイルで、または `CLAUDE_CODE_DISABLE_ARTIFACT` でアーティファクトをオフにした場合、あるいは管理者が [管理設定](/docs/ja/server-managed-settings) でアーティファクトをオフにした場合、どの設定ファイルもアーティファクトを再度オンにすることはできません。

402 402 

403プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で `"enableArtifact": false` を設定して、そのプロジェクト内のセッションのアーティファクトをオフにすることもできます。どちらのファイルでも `"enableArtifact": true` はアーティファクトを再度オンにしません。プロジェクトおよびローカル設定でこのキーを尊重するには、Claude Code v2.1.242 以降が必要です。403プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で `"enableArtifact": false` を設定して、そのプロジェクト内のセッションのアーティファクトをオフにすることもできます。どちらのファイルでも `"enableArtifact": true` はアーティファクトを再度オンにしません。プロジェクトおよびローカル設定でこのキーを尊重するには、Claude Code v2.1.242 以降が必要です。

404 404 

194* **Amazon Bedrock などのクラウドプロバイダーセッション**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーがマシン上にまだ存在する間のみブロックされます。それを削除するとセッションが開始します。これらのセッションはクラウドプロバイダーに対して認証され、クラウドプロバイダーのアクセスポリシーがそれらを管理します194* **Amazon Bedrock などのクラウドプロバイダーセッション**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーがマシン上にまだ存在する間のみブロックされます。それを削除するとセッションが開始します。これらのセッションはクラウドプロバイダーに対して認証され、クラウドプロバイダーのアクセスポリシーがそれらを管理します

195* **[Anthropic プロファイルまたはフェデレーション認証情報](#anthropic-profiles-and-federation-credentials)**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーもマシン上に存在する場合を除き、ブロックされません。キーはプロファイルが属する組織を確認しません195* **[Anthropic プロファイルまたはフェデレーション認証情報](#anthropic-profiles-and-federation-credentials)**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーもマシン上に存在する場合を除き、ブロックされません。キーはプロファイルが属する組織を確認しません

196 196 

197<h3 id="restrict-which-api-providers-a-machine-may-use">

198 マシンが使用できる API プロバイダーを制限する

199</h3>

200 

201[管理設定](/docs/ja/managed-settings)の [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) は、Anthropic API、Amazon Bedrock、LLM ゲートウェイなど、管理マシンが Claude に到達できるサービスをリストします。これは `forceLoginMethod` と `forceLoginOrgUUID` を補完します。これらは、セッションが Anthropic と通信するときに使用するアカウントを管理します。Claude Code v2.1.285 以降が必要です。

202 

203```json managed-settings.json theme={null}

204{

205 "forceLoginMethod": "claudeai",

206 "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],

207 "allowedProviders": ["anthropic", "bedrock"]

208}

209```

210 

211このファイルを使用すると、claude.ai 組織にサインインした開発者または Amazon Bedrock 用に設定された開発者は正常に起動します。他のプロバイダー用に設定されたセッションは起動時に拒否され、実行中のセッションがそのセッションに切り替わると、次のリクエストで拒否されます。[管理設定がこの API プロバイダーを許可していません](/docs/ja/errors#managed-settings-dont-allow-this-api-provider)は各メッセージを表示します。

212 

213* **LLM ゲートウェイまたはプロキシを許可する**: `"customEndpoint"` をリストし、同じソースの管理 `env` ブロックでゲートウェイの URL を設定します。[設定リファレンス](/docs/ja/settings-reference#allowedproviders)はすべての値をリストし、どのエンドポイント変数が管理 `env` ピンを必要とするかを示します。

214* **管理マシンにデプロイする**: リストをポリシーの残りを含む管理ソースに配置します。エントリの [スコープ注記](/docs/ja/settings-reference#allowedproviders)は、サーバー管理リストがそれとどのように組み合わされるかを示します。

215* **サーバー管理設定のみ**: [サーバー管理設定](/docs/ja/server-managed-settings)でのみ設定するリストは、組織の設定を取得するセッションにのみ到達するため、デバイス管理で到達できないマシンの利便性として扱い、強制として扱わないでください。[プラットフォーム可用性](/docs/ja/server-managed-settings#platform-availability)はどのセッションがそれらを取得するかをリストします。

216 

197<h2 id="credential-management">217<h2 id="credential-management">

198 認証情報管理218 認証情報管理

199</h2>219</h2>

285 `/permissions` から編集ルール285 `/permissions` から編集ルール

286</h2>286</h2>

287 287 

288設定ファイルを開かずに分類器ルールを表示および編集するには、[`/permissions`](/docs/ja/permissions#manage-permissions) を実行して **Auto mode** タブを選択します。このタブは Claude Code v2.1.246 以降が必要であり、[auto mode がセッションで利用可能](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)な場合にのみ表示されます。288設定ファイルを開かずに分類器ルールと `environment` エントリを表示および編集するには、[`/permissions`](/docs/ja/permissions#manage-permissions) を実行して **Auto mode** タブを選択します。このタブは Claude Code v2.1.246 以降が必要であり、[auto mode がセッションで利用可能](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)な場合にのみ表示されます。

289 289 

290このタブには、[分類器が設定を読み込むスコープ](#where-the-classifier-reads-configuration)のそれぞれから `allow`、`soft_deny`、`hard_deny`、および `environment` エントリが一覧表示され、各セクションに対して組み込みルールが有効かどうかが表示されます。Claude Code は [管理設定](/docs/ja/server-managed-settings)または `--settings` フラグからのエントリを読み取り専用として表示し、タブで行ったすべての変更を `~/.claude/settings.json` に保存します。タブから以下の操作ができます。290Claude Code は [管理設定](/docs/ja/server-managed-settings)または `--settings` フラグからのエントリを読み取り専用として表示し、タブで行ったすべての変更を `~/.claude/settings.json` に保存します。

291 

292* `allow`、`soft_deny`、および `hard_deny` セクションのルールを追加、編集、または削除します。セクションに最初のルールを追加すると、Claude Code は `"$defaults"` も挿入して、[組み込みルール](#override-the-block-and-allow-rules)が有効なままになるようにします。

293* `allow`、`soft_deny`、または `hard_deny` の組み込みルールをオフにするか、再度オンにします。Claude Code は、そのセクションのリストに `"$defaults"` を追加または削除することで選択を記録するため、セクションの組み込みルールをオフにする前に、少なくとも 1 つの独自ルールが必要です。

294* `environment` エントリをエディタで 1 つのドキュメントとして編集します。まだ `environment` エントリを設定していない場合、Claude Code は最初に組み込み環境を置き換えるかどうかを尋ね、その後、組み込みテキスト全体でエディタを開きます。保存すると、Claude Code はドキュメントで `autoMode.environment` 配列を置き換えます。`"$defaults"` 行を含めて、[組み込みエントリを保持](#define-trusted-infrastructure)します。

295 291 

296<h2 id="route-all-shell-commands-through-the-classifier">292<h2 id="route-all-shell-commands-through-the-classifier">

297 すべてのシェルコマンドを分類器を通してルーティングする293 すべてのシェルコマンドを分類器を通してルーティングする

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

439 439 

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

441 441 

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

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

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

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

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

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

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

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

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

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

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

1634 1634 

1635より小さな会話ではなく、より大きなウィンドウが必要な場合、Fable モデル、Sonnet 5 以降、Opus 4.6 以降、および Sonnet 4.6 は 100 万トークンのコンテキストウィンドウをサポートしています。プランごとの利用可能性と `[1m]` モデルバリアントの選択方法については、[拡張コンテキスト](/docs/ja/model-config#extended-context)を参照してください。コンパクションはより大きな制限でも同じ方法で機能します。1635より小さな会話ではなく、より大きなウィンドウが必要な場合、Fable モデル、Sonnet 5 以降、Opus 4.6 以降、および Sonnet 4.6 は 100 万トークンのコンテキストウィンドウをサポートしています。プランごとの利用可能性と `[1m]` モデルバリアントの選択方法については、[拡張コンテキスト](/docs/ja/model-config#extended-context)を参照してください。コンパクションはより大きな制限でも同じ方法で機能します。

1636 1636 

1637Sonnet 5.5 と Sonnet 5 は 1M コンテキストウィンドウで実行され、選択する `[1m]` バリアントはありません。その自動コンパクションのしきい値と LLM ゲートウェイの例外については、[Sonnet 5.5 と Sonnet 5 コンテキストウィンドウ](/docs/ja/model-config#sonnet-5-5-and-sonnet-5-context-window)を参照してください。1637Sonnet 5.5 と Sonnet 5 は 1M コンテキストウィンドウで実行され、選択する `[1m]` バリアントはありません。その自動コンパクションのしきい値については、[Sonnet 5.5 と Sonnet 5 コンテキストウィンドウ](/docs/ja/model-config#sonnet-5-5-and-sonnet-5-context-window)を参照してください。また、[ゲートウェイの背後にあるコンテキストウィンドウ](/docs/ja/model-config#context-window-behind-a-gateway)で、`ANTHROPIC_BASE_URL` を[LLM ゲートウェイ](/docs/ja/llm-gateway)に設定したときに Claude Code がウィンドウをどのようにサイズ設定するかについて参照してください。

1638 1638 

1639自動コンパクションが実行される時点は、あなたのモデルと設定によって異なります。モデルごとの境界については[デフォルト自動コンパクトしきい値](/docs/ja/model-config#default-auto-compact-thresholds)を参照してください。Claude Code があなたのモデル ID（[LLM ゲートウェイ](/docs/ja/llm-gateway)エイリアスなど）に対して間違ったウィンドウを想定している場合は、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください。1639自動コンパクションが実行される時点は、あなたのモデルと設定によって異なります。モデルごとの境界については[デフォルト自動コンパクトしきい値](/docs/ja/model-config#default-auto-compact-thresholds)を参照してください。Claude Code があなたのモデル ID（[LLM ゲートウェイ](/docs/ja/llm-gateway)エイリアスなど）に対して間違ったウィンドウを想定している場合は、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください。

1640 1640 

51 51 

52行のミス、予想される再構築、およびウォーム状態またはコールド状態の部分は以下を意味します。52行のミス、予想される再構築、およびウォーム状態またはコールド状態の部分は以下を意味します。

53 53 

54* **ミス**: キャッシュが既に保持していたコンテンツを再処理したリクエスト。最後のミスの時刻と、それらのリクエストがキャッシュに書き戻したトークン数が表示されます。Claude Code は、リクエストがキャッシュから読み取ることができた内容の 5% 以上かつ最低 2,000 トークン以上を再処理した場合、そのリクエストをミスとしてカウントします。[キャッシュを無効化するアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache) は通常の原因をリストしています。54* **ミス**: キャッシュが既に保持していたコンテンツを再処理したリクエスト。最後のミスの時刻と、それらのリクエストがキャッシュに書き戻したトークン数が表示されます。[キャッシュを無効化するアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache) は通常の原因をリストしています。Claude Code が最後のミスの可能性のある原因を特定できる場合、行はそれも名前を付けます。例えば `likely cause: tool definitions changed` のようにです。可能性のある原因テキストには Claude Code v2.1.260 以降が必要です。

55 Claude Code が最後のミスの可能性のある原因を特定できる場合、行はそれも名前を付けます。例えば `likely cause: tool definitions changed` のようにです。可能性のある原因テキストには Claude Code v2.1.260 以降が必要です。

56* **予想される再構築**: Claude Code が会話を再度書き直した場合。[圧縮](/docs/ja/prompt-caching#compacting-the-conversation) またはコンテキストから古いツール結果をクリアすることで、同じ種類のミスを予想される再構築としてカウントします。この部分は、少なくとも 1 つの予想される再構築が発生した後にのみ表示されます。55* **予想される再構築**: Claude Code が会話を再度書き直した場合。[圧縮](/docs/ja/prompt-caching#compacting-the-conversation) またはコンテキストから古いツール結果をクリアすることで、同じ種類のミスを予想される再構築としてカウントします。この部分は、少なくとも 1 つの予想される再構築が発生した後にのみ表示されます。

57* **ウォーム状態またはコールド状態**: キャッシュされたプレフィックスが [キャッシュ有効期間](/docs/ja/prompt-caching#cache-lifetime) 内にあるかどうか。有効な TTL が表示されます。キャッシュがコールド状態の場合、行はセッションがアイドル状態だった期間を表示します。API がキャッシュトークンを報告していない場合、行は代わりに `no prompt caching reported by the API` で終わります。56* **ウォーム状態またはコールド状態**: キャッシュされたプレフィックスが [キャッシュ有効期間](/docs/ja/prompt-caching#cache-lifetime) 内にあるかどうか。有効な TTL が表示されます。キャッシュがコールド状態の場合、行はセッションがアイドル状態だった期間を表示します。API がキャッシュトークンを報告していない場合、行は代わりに `no prompt caching reported by the API` で終わります。

58 57 

967 967 

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

969 969 

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

971 

972```bash theme={null}

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

974```

975 

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

977 

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

971 979 

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

56 </Tab>56 </Tab>

57</Tabs>57</Tabs>

58 58 

59代入行は成功時に何も出力しないため、`claude` を実行する前に同じシェルで変数を出力して確認します。59代入行は成功時に何も出力しないため、同じシェルで変数を出力して確認します。

60 60 

61<Tabs>61<Tabs>

62 <Tab title="macOS、Linux、WSL">62 <Tab title="macOS、Linux、WSL">

127タイムアウト、トークン予算、再試行回数などの数値変数は、変数の行に「プレーンな数字のみ」と記載されている場合を除き、プレーンな数字に加えて科学記法と数字区切り記法を受け入れます。例えば、Claude Code は `2e3` を 2000 として、`64_000` を 64000 として読み込みます。v2.1.211 より前は、これらの記法により、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が静かに設定される可能性がありました。127タイムアウト、トークン予算、再試行回数などの数値変数は、変数の行に「プレーンな数字のみ」と記載されている場合を除き、プレーンな数字に加えて科学記法と数字区切り記法を受け入れます。例えば、Claude Code は `2e3` を 2000 として、`64_000` を 64000 として読み込みます。v2.1.211 より前は、これらの記法により、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が静かに設定される可能性がありました。

128 128 

129<Note>129<Note>

130 動作をオン/オフにする変数の場合、`1` または `true` を設定してオンにし、`0` または `false` を設定してオフにします。大文字小文字は問いません。130 動作をオン/オフにする変数の場合、`1`、`true`、`yes`、または `on` を設定してオンにし、`0`、`false`、`no`、または `off` を設定してオフにします。大文字小文字は問いません。

131 131 

132 一部の変数は、設定されているかどうかのみを読み取るため、`0` を含む空でない値はすべて動作をオンにし、変数を設定解除するか空の値に設定することで動作をオフにします。これらの変数は次のように機能します：132 一部の変数は、設定されているかどうかのみを読み取るため、`0` を含む空でない値はすべて動作をオンにし、変数を設定解除するか空の値に設定することで動作をオフにします。これらの変数は次のように機能します：

133 133 

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

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

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

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

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

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

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

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

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

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [サブエージェント](/docs/ja/sub-agents) タイプ（Explore や Plan など）を無効にするには `1` に設定します。非対話モード（`-p` フラグ）にのみ適用されます。SDK ユーザーが白紙の状態を望む場合に便利です。これにより、エージェントツール呼び出しが `subagent_type` を省略した場合に Claude Code が実行する `general-purpose` も削除されます。そのような呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [サブエージェント](/docs/ja/sub-agents) タイプ（Explore や Plan など）を無効にするには `1` に設定します。非対話モード（`-p` フラグ）にのみ適用されます。SDK ユーザーが白紙の状態を望む場合に便利です。これにより、エージェントツール呼び出しが `subagent_type` を省略した場合に Claude Code が実行する `general-purpose` も削除されます。そのような呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのスタルタイムアウト（ミリ秒単位）。デフォルト `600000`（10 分）；`CLAUDE_STREAM_IDLE_TIMEOUT_MS` を上げながらストリーム監視犬がオンの場合、デフォルトは [遅いまたは停止した API 応答を処理](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されているように上昇します。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、Claude Code はサブエージェントを中止し、スタルを親に報告します |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのスタルタイムアウト（ミリ秒単位）。デフォルト `600000`（10 分）；`CLAUDE_STREAM_IDLE_TIMEOUT_MS` を上げながらストリーム監視犬がオンの場合、デフォルトは [遅いまたは停止した API 応答を処理](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されているように上昇します。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、Claude Code はサブエージェントを中止し、スタルを親に報告します |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動コンパクション がトリガーされる自動コンパクトウィンドウのパーセンテージ（1～100）を設定します。`50` などの低い値を使用して早期にコンパクトします。変数はしきい値を上げることはできないため、デフォルトパーセンテージを超える値は無視されます。[モデルのコンテキスト制限の前にコンパクト](/docs/ja/model-config#context-window-and-auto-compaction) するセッションにのみ適用されます。メイン会話とサブエージェントの両方に適用されます |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動コンパクションがトリガーされる自動コンパクトウィンドウのパーセンテージ（1～100）を設定します。`50` などの低い値を使用して早期にコンパクトします。変数はしきい値を上げることはできないため、デフォルトパーセンテージを超える値は無視されます。[モデルのコンテキスト制限の前にコンパクト](/docs/ja/model-config#context-window-and-auto-compaction) するセッションにのみ適用されます。メイン会話とサブエージェントの両方に適用されます |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには `1` に設定します。有効にすると、サブエージェントは約 2 分間実行した後、バックグラウンドに移動されます。また、Claude Code v2.1.212 以降の非対話モードで [長い MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) も有効にします |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには `1` に設定します。有効にすると、サブエージェントは約 2 分間実行した後、バックグラウンドに移動されます。また、Claude Code v2.1.212 以降の非対話モードで [長い MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) も有効にします |

208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility#what-your-screen-reader-hears) では、カーソルが行の開始位置にある状態で、Claude Code が新しい行または変更された行を書き込む前に待機するミリ秒数。デフォルト `50`。`0` に設定して直ちに書き込みます。Claude Code は待機を `5000` でキャップします。Claude Code v2.1.233 以降が必要です |208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility#what-your-screen-reader-hears) では、カーソルが行の開始位置にある状態で、Claude Code が新しい行または変更された行を書き込む前に待機するミリ秒数。デフォルト `50`。`0` に設定して直ちに書き込みます。Claude Code は待機を `5000` でキャップします。Claude Code v2.1.233 以降が必要です |

209| `CLAUDE_AX_SCREEN_READER` | スクリーンリーダーフレンドリーな出力をレンダリングするには `1` に設定します：装飾的なボーダーやアニメーションのないフラットテキスト。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でも、スクリーンリーダーモードを強制的にオフにするには `0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |209| `CLAUDE_AX_SCREEN_READER` | スクリーンリーダーフレンドリーな出力をレンダリングするには `1` に設定します：装飾的なボーダーやアニメーションのないフラットテキスト。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でも、スクリーンリーダーモードを強制的にオフにするには `0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |

263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |

264| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 組み込みコミットおよび PR ワークフロー指示と git ステータススナップショットを Claude のコンテキストから削除するには `1` に設定します。独自の git ワークフロースキルを使用する場合に便利です。設定されている場合、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |264| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 組み込みコミットおよび PR ワークフロー指示と git ステータススナップショットを Claude のコンテキストから削除するには `1` に設定します。独自の git ワークフロースキルを使用する場合に便利です。設定されている場合、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |

265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐには `1` に設定します。古いモデルを意図的にピン留めしたい場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐには `1` に設定します。古いモデルを意図的にピン留めしたい場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |

266| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | [Amazon Bedrock](/docs/ja/amazon-bedrock#when-a-model-is-disabled-mid-session) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai#when-a-model-is-disabled-mid-session) で Claude Code がセッション中にアカウントがモデルへのアクセスを失ったときに古いモデルに切り替わるのを停止するには `1` に設定します。拒否されたリクエストは直ちに失敗します。設定した [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) はその拒否で切り替わり、[スタートアップモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks) は引き続き起動時に切り替わります。Claude Code v2.1.285 以降が必要です |

266| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |267| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |

267| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには `1` に設定します。ホイールスクロールが Claude Code 内で機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにしたい場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |268| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには `1` に設定します。ホイールスクロールが Claude Code 内で機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにしたい場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |

268| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで API リクエストが失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには `1` に設定します。リロードが無効な場合、Claude Code は回転されたファイルを次に設定を適用するか、次のスタートアップ時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |269| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで API リクエストが失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには `1` に設定します。リロードが無効な場合、Claude Code は回転されたファイルを次に設定を適用するか、次のスタートアップ時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |

366| `CLAUDE_CODE_RETRY_WATCHDOG` | eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに、`429` および `529` 容量エラーを無期限に再試行します。Claude Code は、標準速度リクエストが支出制限またはクレジット使用済みを報告する `429` を取得すると直ちに失敗します。[ゲートウェイ支出キャップ](/docs/ja/errors#spend-limit-reached) からリセットされるもの。v2.1.239 より前は、監視犬はこれらを無期限に再試行していました。高速モードリクエストについては、[レート制限を処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。監視犬は試行間で最大 5 分バックオフするか、応答がレート制限リセット時間を報告する場合はリセットまで待機するため、使用制限に達したセッションは残りのウィンドウを待ちます。v2.1.199 以降では、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーのデフォルト再試行回数も上げられます。約 3 時間のバックオフに対して 300 に、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合、15 のキャップを削除します。Claude Code v2.1.186 以降が必要です |367| `CLAUDE_CODE_RETRY_WATCHDOG` | eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに、`429` および `529` 容量エラーを無期限に再試行します。Claude Code は、標準速度リクエストが支出制限またはクレジット使用済みを報告する `429` を取得すると直ちに失敗します。[ゲートウェイ支出キャップ](/docs/ja/errors#spend-limit-reached) からリセットされるもの。v2.1.239 より前は、監視犬はこれらを無期限に再試行していました。高速モードリクエストについては、[レート制限を処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。監視犬は試行間で最大 5 分バックオフするか、応答がレート制限リセット時間を報告する場合はリセットまで待機するため、使用制限に達したセッションは残りのウィンドウを待ちます。v2.1.199 以降では、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーのデフォルト再試行回数も上げられます。約 3 時間のバックオフに対して 300 に、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合、15 のキャップを削除します。Claude Code v2.1.186 以降が必要です |

367| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します：CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインおよびファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。設定の破損をトラブルシューティングするため。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含む。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは読み込まれません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すことと同等です。直接生成された子プロセスは変数を継承します |368| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します：CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインおよびファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。設定の破損をトラブルシューティングするため。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含む。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは読み込まれません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すことと同等です。直接生成された子プロセスは変数を継承します |

368| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースであるため、`./scripts/deploy.sh $(evil)` などのシェル展開トリックはキャップに対してカウントされます。`xargs` または `find -exec` を通じたランタイムファンアウトは検出されません。これは多層防御コントロールです |369| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースであるため、`./scripts/deploy.sh $(evil)` などのシェル展開トリックはキャップに対してカウントされます。`xargs` または `find -exec` を通じたランタイムファンアウトは検出されません。これは多層防御コントロールです |

369| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。最大 20 までの正の値を受け入れます。`0.5` などの 1 未満の小数値を含めて、加速トラックパッドおよびホイールスクロールを遅くします。ターミナルが既に増幅されたホイールイベントを送信します。ターミナルが増幅なしで 1 ホイールイベントを送信する場合は `3` に設定して `vim` と一致させます。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |370| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。最大 20 までの正の値を受け入れます。`0.5` などの 1 未満の小数値を含めて、加速トラックパッドおよびホイールスクロールを遅くします。ターミナルが増幅なしで 1 ホイールイベントを送信する場合は `3` に設定して `vim` と一致させます。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |

370| `CLAUDE_CODE_SEND_FEEDBACK` | セッションの [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにするには `0` に設定します。アカウントが既にアクセス権を持つ場所でオンにするには `1` に設定します。変数はアクセス権を付与できず、`DISABLE_FEEDBACK_COMMAND` および [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値などのフィードバックをオフにする他のスイッチは引き続き適用されます |371| `CLAUDE_CODE_SEND_FEEDBACK` | セッションの [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにするには `0` に設定します。アカウントが既にアクセス権を持つ場所でオンにするには `1` に設定します。変数はアクセス権を付与できず、`DISABLE_FEEDBACK_COMMAND` および [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値などのフィードバックをオフにする他のスイッチは引き続き適用されます |

371| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算をオーバーライドします（ミリ秒単位）。値は、独自の `timeout` を設定しないフックのタイムアウトでもあります。セッション終了、`/clear`、および対話的 `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定された最高のフックごとの `timeout` に自動的に上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を上げません |372| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算をオーバーライドします（ミリ秒単位）。値は、独自の `timeout` を設定しないフックのタイムアウトでもあります。セッション終了、`/clear`、および対話的 `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定された最高のフックごとの `timeout` に自動的に上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を上げません |

372| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールサブプロセス、[フックコマンド](/docs/ja/hooks) サブプロセス、および stdio [MCP サーバー](/docs/ja/mcp) サブプロセスで現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックの場合、これはフック JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーサブプロセスは、生成されたときに受け取った ID を保持します。`--resume <session-id>` では、再開された ID を受け取ります。`--continue` または明示的な ID なしで `--resume` では、初期スタートアップ ID を代わりに受け取る可能性があります。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |373| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールサブプロセス、[フックコマンド](/docs/ja/hooks) サブプロセス、および stdio [MCP サーバー](/docs/ja/mcp) サブプロセスで現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックの場合、これはフック JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーサブプロセスは、生成されたときに受け取った ID を保持します。`--resume <session-id>` では、再開された ID を受け取ります。`--continue` または明示的な ID なしで `--resume` では、初期スタートアップ ID を代わりに受け取る可能性があります。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |

381| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには `1` に設定します。プロキシがチェックのリクエストを拒否するのではなく傍受する場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |382| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには `1` に設定します。プロキシがチェックのリクエストを拒否するのではなく傍受する場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |

382| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを挿入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、例えば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |383| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを挿入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、例えば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |

383| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |384| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |

385| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [スタートアップモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks) が [Amazon Bedrock](/docs/ja/amazon-bedrock) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) でこのマシンで見つかったモデルをアカウントが呼び出せないことを記憶するのを停止するには `1` に設定します。最大 1 日間。Claude Code v2.1.285 以降が必要です |

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

385| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud の Agent Platform の Google 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |387| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud の Agent Platform の Google 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |

386| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前で示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには `1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |388| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前で示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには `1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |

322| `Transcript writes are failing (...)` | [セッション保存の警告](#transcript-writes-are-failing) |322| `Transcript writes are failing (...)` | [セッション保存の警告](#transcript-writes-are-failing) |

323| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [セッション保存の警告](#transcript-saving-is-off-skip-prompt-history) |323| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [セッション保存の警告](#transcript-saving-is-off-skip-prompt-history) |

324| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [セッション保存の警告](#transcript-saving-is-off-child-session-marker) |324| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [セッション保存の警告](#transcript-saving-is-off-child-session-marker) |

325| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [設定の警告](#fullscreen-failed-start-notice) |325| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [フルスクリーンレンダリング](/docs/ja/fullscreen#fullscreen-renderer-didnt-finish-starting) |

326| `Claude Code exited after an unrecoverable interface error (...)` | [設定の警告](#exited-after-an-unrecoverable-interface-error) |326| `Claude Code exited after an unrecoverable interface error (...)` | [設定の警告](#exited-after-an-unrecoverable-interface-error) |

327| `Agent descriptions are over the 15.0k-token limit` | [設定の警告](#agent-descriptions-are-over-the-15000-token-limit) |327| `Agent descriptions are over the 15.0k-token limit` | [設定の警告](#agent-descriptions-are-over-the-15000-token-limit) |

328| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [設定の警告](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |328| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [設定の警告](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

331| `Remote managed settings failed to load (<cause>)` | [設定の警告](#remote-managed-settings-failed-to-load) |331| `Remote managed settings failed to load (<cause>)` | [設定の警告](#remote-managed-settings-failed-to-load) |

332| `Managed settings were not approved; exiting without applying them.` | [設定の警告](#managed-settings-were-not-approved) |332| `Managed settings were not approved; exiting without applying them.` | [設定の警告](#managed-settings-were-not-approved) |

333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [設定の警告](#managed-settings-block-the-default-model) |333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [設定の警告](#managed-settings-block-the-default-model) |

334| `Your organization's managed settings allow Claude Code to use: <providers>` | [設定の警告](#managed-settings-dont-allow-this-api-provider) |

335| `Your organization's managed settings allow Claude Code to use no API provider at all` | [設定の警告](#managed-settings-dont-allow-this-api-provider) |

334| `MCP server <name> is blocked by enterprise managed policy` | [設定の警告](#mcp-server-is-blocked-by-enterprise-managed-policy) |336| `MCP server <name> is blocked by enterprise managed policy` | [設定の警告](#mcp-server-is-blocked-by-enterprise-managed-policy) |

335| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [設定の警告](#managed-settings-document-could-not-be-parsed) |337| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [設定の警告](#managed-settings-document-could-not-be-parsed) |

336| `Managed settings drop-in directory could not be read` | [設定の警告](#managed-settings-document-could-not-be-parsed) |338| `Managed settings drop-in directory could not be read` | [設定の警告](#managed-settings-document-could-not-be-parsed) |

339| `Unable to read managed policy settings` | [設定の警告](#unable-to-read-managed-policy-settings) |

337| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [設定の警告](#otelheadershelper-failed) |340| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [設定の警告](#otelheadershelper-failed) |

338| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [設定の警告](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |341| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [設定の警告](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

339| `headersHelper not run — this workspace has no persisted trust` | [設定の警告](#headershelper-not-run) |342| `headersHelper not run — this workspace has no persisted trust` | [設定の警告](#headershelper-not-run) |

2867 無効な --agents 設定2870 無効な --agents 設定

2868</h3>2871</h3>

2869 2872 

2870`--agents` に渡した値が無効なため、`claude` はセッションを開始する代わりに終了コード 1 で終了します。`--safe-mode` を渡すか、[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars#variables)を設定すると、Claude Code は `--agents` を完全に無視します。`--resume` または `--continue` を使用すると、インライン JSON 値はチェックされず、セッションが開始されます。ファイルから読み込まれた値は、起動するたびにチェックされます。v2.1.242 より前は、Claude Code はセッションを開始し、読み込めない定義を省略していました。2873`--agents` に渡した値が無効なため、`claude` はセッションを開始する代わりに終了コード 1 で終了します。`--safe-mode` を渡すか、[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars#variables)を設定すると、Claude Code は `--agents` を完全に無視します。`--resume` または `--continue` を使用すると、インライン JSON 値はチェックされず、セッションが開始されます。ファイルから読み込まれた値は、起動するたびにチェックされます。v2.1.242 より前は、Claude Code はセッションを開始していました。

2871 2874 

2872```text theme={null}2875```text theme={null}

2873Error: Invalid --agents configuration:2876Error: Invalid --agents configuration:

3117 Claude Desktop からサーバーをインポートできませんでした3120 Claude Desktop からサーバーをインポートできませんでした

3118</h3>3121</h3>

3119 3122 

3120Claude Code は `claude mcp add-from-claude-desktop` で選択したサーバーの 1 つを追加できませんでした。コマンドは他の選択されたサーバーをインポートし、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、失敗した最初のサーバーがインポートを停止し、選択されたサーバーは追加されませんでした。3123Claude Code は `claude mcp add-from-claude-desktop` で選択したサーバーの 1 つを追加できませんでした。コマンドは他の選択されたサーバーをインポートし、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、失敗した最初のサーバーがインポートを停止していました。

3121 3124 

3122```text theme={null}3125```text theme={null}

3123Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3126Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

3208"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3211"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.

3209```3212```

3210 3213 

3211Claude Code はこれらのホストを URL で照合するため、`claude mcp add` または `.mcp.json` で追加したサーバーがそれらの 1 つを指している場合、メッセージが表示されます。

3212 

3213**対処方法：**3214**対処方法：**

3214 3215 

3215* `claude mcp remove <name>` でエントリを削除して、同じ URL の claude.ai コネクタを非表示にすることができないようにしてください。3216* `claude mcp remove <name>` でエントリを削除して、同じ URL の claude.ai コネクタを非表示にすることができないようにしてください。

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

3658</h3>3659</h3>

3659 3660 

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

3662 

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

3661 3664 

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

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

3664```3667```

3665 3668 

3666**対処方法：**3669**対処方法：**

3667 3670 

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

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

3670 3673 

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

3672 3675 

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

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

3749これらのエラーは、[プラグイン](/docs/ja/plugins/overview)と[マーケットプレイス](/docs/ja/plugins/overview)の設定から発生します。このページのメッセージを生成しないプラグインの問題（マーケットプレイス URL が読み込まれない、またはプラグインがインストールされても表示されないなど）については、[プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting)を参照してください。3752これらのエラーは、[プラグイン](/docs/ja/plugins/overview)と[マーケットプレイス](/docs/ja/plugins/overview)の設定から発生します。このページのメッセージを生成しないプラグインの問題（マーケットプレイス URL が読み込まれない、またはプラグインがインストールされても表示されないなど）については、[プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting)を参照してください。

3750 3753 

3751<h3 id="plugin-eval-is-currently-in-early-access">3754<h3 id="plugin-eval-is-currently-in-early-access">

3752 plugin eval は現在早期アクセス段階です3755 plugin eval は現在早期アクセス中です

3753</h3>3756</h3>

3754 3757 

3755[`claude plugin eval`](/docs/ja/plugin-evals)または `claude plugin eval init` を実行し、何もする前に終了コード 1 で次のいずれかのメッセージが表示されました：3758[`claude plugin eval`](/docs/ja/plugin-evals)または `claude plugin eval init` を実行し、何もする前に終了コード 1 で以下のいずれかのメッセージで終了しました：

3756 3759 

3757```text theme={null}3760```text theme={null}

3758`plugin eval` is currently in early access3761`plugin eval` is currently in early access

3762`plugin eval` is currently unavailable3765`plugin eval` is currently unavailable

3763```3766```

3764 3767 

3765最初のメッセージは、ビルドがコマンドが一般的に利用可能になった最初のバージョンである v2.1.269 より古いことを意味します。2 番目のメッセージは、Anthropic がサーバー側でコマンドをオフにしたことを意味します。マシン上の何もそれをオンに戻しません。3768最初のメッセージは、ビルドが v2.1.269 より古いことを意味します。これはコマンドが一般的に利用可能になった最初のバージョンです。2 番目のメッセージは、Anthropic がサーバー側でコマンドをオフにしたことを意味します。マシン上の何もそれをオンに戻しません。

3766 3769 

3767**対処方法：**3770**対処方法：**

3768 3771 

3770* 現在のビルドで 2 番目のメッセージが表示される場合は、別の `claude update` の後で後で再度試してください3773* 現在のビルドで 2 番目のメッセージが表示される場合は、別の `claude update` の後で後で再度試してください

3771 3774 

3772<h3 id="marketplace-is-registered-from-an-untrusted-source">3775<h3 id="marketplace-is-registered-from-an-untrusted-source">

3773 マーケットプレイスが信頼されていないソースから登録されている3776 マーケットプレイスが信頼されていないソースから登録されています

3774</h3>3777</h3>

3775 3778 

3776マーケットプレイスは、[公式 Anthropic マーケットプレイス用に予約されている名前](/docs/ja/plugins/marketplace-reference#marketplace-file)で登録されていますが、登録されたソースが `anthropics` GitHub リポジトリではありません。Claude Code は、マーケットプレイスを読み込むか更新するたびに予約名を再確認するため、マーケットプレイスとそこからインストールされたプラグインの読み込みが停止します。v2.1.205 より前は、マーケットプレイスが追加されたときにのみ名前がチェックされたため、その名前が予約される前に登録されたエントリは読み込み続けていました。3779マーケットプレイスは、[公式 Anthropic マーケットプレイス用に予約されている](/docs/ja/plugins/marketplace-reference#marketplace-file)名前で登録されていますが、登録されたソースは `anthropics` GitHub リポジトリではありません。Claude Code は、マーケットプレイスを読み込むか更新するたびに予約名を再確認するため、マーケットプレイスとそこからインストールされたプラグインの読み込みが停止します。v2.1.205 より前では、名前が予約される前に登録されたエントリは読み込みを続けていました。

3777 3780 

3778```text theme={null}3781```text theme={null}

3779Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.3782Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

3780```3783```

3781 3784 

3782ソースが GitHub リポジトリまたは Git URL ではなく、ローカルディレクトリなどの場合、中央の文は `can only be used with GitHub sources from the 'anthropics' organization` の代わりに読み込まれます。`claude plugin marketplace add` は同じチェックを実行し、予約名を拒否して `Failed to add marketplace:` の後に同じ予約名の文が続きます。3785ソースが GitHub リポジトリまたは Git URL ではなく、ローカルディレクトリなどのマーケットプレイスの場合、中央の文は `can only be used with GitHub sources from the 'anthropics' organization` の代わりに読みます。`claude plugin marketplace add` は同じチェックを実行し、予約名を `Failed to add marketplace:` で拒否し、その後に同じ予約名の文が続きます。

3783 3786 

3784**対処方法：**3787**対処方法：**

3785 3788 

3786* マーケットプレイスが既に登録されている場合は、`claude plugin marketplace remove <name>` を実行してから、公式の `github.com/anthropics` リポジトリから再度追加してください3789* マーケットプレイスが既に登録されている場合は、`claude plugin marketplace remove <name>` を実行してから、公式の `github.com/anthropics` リポジトリから再度追加してください

3787* 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開する場合は、名前を変更し、ユーザーにあなたのソースから再度追加するよう依頼してください3790* 名前が予約される前に使用した第三者マーケットプレイスを公開する場合は、名前を変更し、ユーザーにソースから再度追加するよう依頼してください

3788* [マーケットプレイススキーマ](/docs/ja/plugins/marketplace-reference#marketplace-file)の予約名リストを参照してください3791* [マーケットプレイススキーマ](/docs/ja/plugins/marketplace-reference#marketplace-file)の下の予約名リストを参照してください

3789 3792 

3790<h3 id="marketplace-name-is-another-spelling-of-a-reserved-name">3793<h3 id="marketplace-name-is-another-spelling-of-a-reserved-name">

3791 マーケットプレイス名が予約名の別のスペルである3794 マーケットプレイス名は予約名の別のスペルです

3792</h3>3795</h3>

3793 3796 

3794マーケットプレイスの名前自体は予約名ではありませんが、Claude Code はそれを別のスペルとして扱います。[予約マーケットプレイス名](/docs/ja/plugins/marketplace-reference#reserved-name-spellings)は、どのスペルが予約名としてカウントされるかをリストしています。Claude Code はマーケットプレイスを追加するときにそのような名前を拒否します：3797マーケットプレイスの名前自体は予約名ではありませんが、Claude Code はそれを別のスペルとして扱います。[予約名](/docs/ja/plugins/marketplace-reference#reserved-name-spellings)は、どのスペルが予約名として数えられるかをリストします。Claude Code は、マーケットプレイスを追加するときにそのような名前を拒否します：

3795 3798 

3796```text theme={null}3799```text theme={null}

3797Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.3800Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.

3798```3801```

3799 3802 

3800マーケットプレイスが既にそのような名前で登録されている場合、そのエントリは読み込みが停止し、`/plugin`、`claude plugin install`、および `claude plugin update` は警告を表示します：3803マーケットプレイスが既にそのような名前で登録されている場合、そのエントリは読み込みを停止し、`/plugin`、`claude plugin install`、および `claude plugin update` は警告します：

3801 3804 

3802```text wrap theme={null}3805```text wrap theme={null}

3803known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins3806known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins

3804```3807```

3805 3808 

3806名前がシェルクォートを必要とする場合、追加時の拒否は `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.` と表示されます。3809名前がシェルクォートを必要とする場合、追加時の拒否は `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.` と読みます。

3807 3810 

3808**対処方法：**3811**対処方法：**

3809 3812 

3810* マーケットプレイスの名前を予約名のスペルにならない名前に変更し、再度追加してください3813* マーケットプレイスの名前を予約名のスペルではない名前に変更し、再度追加してください

3811* 無視されたエントリの警告については、`claude plugin marketplace remove` コマンドを実行するか、`~/.claude/plugins/known_marketplaces.json` からエントリを削除してください3814* 無視されたエントリの警告については、提供される `claude plugin marketplace remove` コマンドを実行するか、`~/.claude/plugins/known_marketplaces.json` からエントリを削除してください

3812 3815 

3813<h3 id="claude-code-refuses-the-marketplace-name">3816<h3 id="claude-code-refuses-the-marketplace-name">

3814 Claude Code がマーケットプレイス名を拒否している3817 Claude Code がマーケットプレイス名を拒否します

3815</h3>3818</h3>

3816 3819 

3817登録されたマーケットプレイスの名前は、[公式 Anthropic マーケットプレイスになりすまし](/docs/ja/plugins/marketplace-reference#reserved-names)ており、そのセクションがリストしているルールに従っています。3820登録されたマーケットプレイスの名前は、[公式 Anthropic マーケットプレイスを偽装します](/docs/ja/plugins/marketplace-reference#reserved-names)。そのセクションがリストするルールの下で。

3818 3821 

3819マーケットプレイスがそのような名前で登録されていて、チェックがそれをブロックする前に、マーケットプレイスとそこからインストールされたプラグインは読み込みが停止します。Claude Code はマーケットプレイスのカタログを読み込むたびに名前をチェックするためです。名前が公式のものを模倣している場合、`claude plugin list` と `/plugin` **Errors** タブは、影響を受けた各プラグインを次のように始まるメッセージで報告します：3822マーケットプレイスがチェックがそれをブロックする前にそのような名前で登録された場合、マーケットプレイスとそこからインストールされたプラグインは読み込みを停止します。Claude Code はマーケットプレイスのカタログを読むたびに名前をチェックするためです。名前が公式のものを模倣する場合、`claude plugin list` と `/plugin` **エラー**タブは、以下で始まるメッセージで影響を受けた各プラグインを報告します：

3820 3823 

3821```text theme={null}3824```text theme={null}

3822Claude Code refuses the marketplace name "anthropic-plugins-v2"3825Claude Code refuses the marketplace name "anthropic-plugins-v2"

3823```3826```

3824 3827 

3825模倣する名前の場合、マーケットプレイス自体のエラーは `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` と表示されます。`claude plugin marketplace add` は、なりすまし名を `Marketplace name impersonates an official Anthropic/Claude marketplace` で拒否します。3828模倣する名前の場合、マーケットプレイス自体のエラーは `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` と読みます。`claude plugin marketplace add` は、`Marketplace name impersonates an official Anthropic/Claude marketplace` で任意の偽装名を拒否します。

3826 3829 

3827v2.1.282 より前は、`claude plugin list` と `/plugin` は、模倣する名前のプラグインを読み込みに失敗したものとして報告し、マーケットプレイスの名前が原因であることを名前を付けずに報告していました。3830v2.1.282 より前では、`claude plugin list` と `/plugin` は、マーケットプレイスの名前が原因として名前を付けずに、模倣する名前のプラグインを読み込みに失敗したものとして報告していました。

3828 3831 

3829**対処方法：**3832**対処方法：**

3830 3833 

3831* `claude plugin marketplace remove <name>` を実行してください。これはマーケットプレイスからインストールされたプラグインもアンインストールし、保存されたデータを削除します3834* `claude plugin marketplace remove <name>` を実行してください。これはマーケットプレイスからインストールされたプラグインもアンインストールし、保存されたデータを削除します

3832* マーケットプレイスを保持する代わりに、その保守者が名前を変更するまで待ってから、`claude plugin marketplace update <name>` を実行してください3835* マーケットプレイスを代わりに保持するには、メンテナーが名前を変更するまで待ってから、`claude plugin marketplace update <name>` を実行してください

3833* マーケットプレイスを公開する場合は、`marketplace.json` で名前を変更してください。ユーザーはマーケットプレイスを削除する代わりに更新します3836* マーケットプレイスを公開する場合は、`marketplace.json` で名前を変更してください。ユーザーはマーケットプレイスを削除する代わりに更新します

3834 3837 

3835<h3 id="marketplace-is-already-added-from-a-different-source">3838<h3 id="marketplace-is-already-added-from-a-different-source">

3836 マーケットプレイスが別のソースから既に追加されている3839 マーケットプレイスは既に別のソースから追加されています

3837</h3>3840</h3>

3838 3841 

3839あなたは [`/plugin install <plugin> --marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を通じてマーケットプレイスの追加を確認し、そのソースから Claude Code が取得したカタログが、別のソースから既に追加したマーケットプレイスと同じ名前を付けています。Claude Code は既存のマーケットプレイスを保持し、それを置き換えず、プラグインはインストールされません。3842[`/plugin install <plugin> --marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を通じてマーケットプレイスの追加を確認し、そのソースから Claude Code が取得したカタログは、既に別のソースから追加したマーケットプレイスと同じ名前で自分自身に名前を付けます。Claude Code は既存のマーケットプレイスを保持し、それを置き換えず、プラグインはインストールされません。

3840 3843 

3841```text theme={null}3844```text theme={null}

3842Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.3845Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

3848* 新しいソースに切り替えるには、`/plugin marketplace remove <name>` を実行してから、インストールを再試行してください3851* 新しいソースに切り替えるには、`/plugin marketplace remove <name>` を実行してから、インストールを再試行してください

3849 3852 

3850<h3 id="plugin-command-references-user-config">3853<h3 id="plugin-command-references-user-config">

3851 プラグインコマンドがシェルコマンドで user\_config を参照している3854 プラグインコマンドがシェルコマンドで user\_config を参照しています

3852</h3>3855</h3>

3853 3856 

3854プラグインフック、[monitor](/docs/ja/plugins/components#monitors)、または MCP [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) コマンドが `${user_config.KEY}` [プラグインオプション](/docs/ja/plugins/manifest-reference#user-configuration)を参照し、置換された文字列がシェルに渡されます。`$(...)` 、バッククォート、または `;` を含む設定値はそこでコードとして実行されるため、Claude Code は値を置換する代わりにコンポーネントの起動を拒否します。チェックはコマンドテンプレートで実行されるため、値がまだ設定されていない場合でもエラーが表示されます。v2.1.207 より前は、値がシェルコマンドに置換されていました。3857プラグインフック、[monitor](/docs/ja/plugins/components#monitors)、または MCP [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication)コマンドは、`${user_config.KEY}` [プラグインオプション](/docs/ja/plugins/manifest-reference#user-configuration)を参照し、置換された文字列はシェルに渡されます。`$(...)` を含む設定値、バックティック、または `;` はそこでコードとして実行されるため、Claude Code は値を置換する代わりにコンポーネントの開始を拒否します。チェックはコマンドテンプレートで実行されるため、値がまだ設定されていない場合でもエラーが表示されます。v2.1.207 より前では、値はシェルコマンドに置換されていました。

3855 3858 

3856表現は、オプションを参照したサーフェスによって異なります。シェル形式フックは以下のように報告します：3859表現は、どの表面がオプションを参照したかによって異なります。シェル形式フックは以下を報告します：

3857 3860 

3858```text theme={null}3861```text theme={null}

3859Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}3862Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}

3860```3863```

3861 3864 

3862モニターは以下のように報告します：3865モニターは以下を報告します：

3863 3866 

3864```text theme={null}3867```text theme={null}

3865Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.3868Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.

3866```3869```

3867 3870 

3868MCP `headersHelper` は以下のように報告します：3871MCP `headersHelper` は以下を報告します：

3869 3872 

3870```text theme={null}3873```text theme={null}

3871headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).3874headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).

3873 3876 

3874**対処方法：**3877**対処方法：**

3875 3878 

3876* フックの場合は、`args` 配列を追加して [exec 形式](/docs/ja/hooks#exec-form-and-shell-form)で実行し、各 `${user_config.KEY}` が間にシェルなしで 1 つの引数になるようにします。または参照を削除し、スクリプト内から `$CLAUDE_PLUGIN_OPTION_<KEY>` 環境変数を読み込みます3879* フックの場合、`args` 配列を追加して、[exec 形式](/docs/ja/hooks#exec-form-and-shell-form)で実行されるようにします。ここで、各 `${user_config.KEY}` は、その間にシェルがない 1 つの引数になります。または参照をドロップし、スクリプト内から `$CLAUDE_PLUGIN_OPTION_<KEY>` 環境変数を読み取ります

3877* モニターの場合は、参照を削除し、モニタースクリプトが設定ファイルから値を読み込むようにします3880* モニターの場合、参照をドロップし、モニタースクリプトに設定ファイルから値を読み取らせます

3878* `headersHelper` の場合は、`${user_config.KEY}` をシェル解析されないサーバーの `headers` フィールドに移動するか、ヘルパースクリプト内から値を読み込みます3881* `headersHelper` の場合、`${user_config.KEY}` をサーバーの `headers` フィールドに移動します。これはシェル解析されません。または、ヘルパースクリプト内から値を読み取ります

3879 3882 

3880<h3 id="plugin-archive-integrity-check-failed">3883<h3 id="plugin-archive-integrity-check-failed">

3881 プラグインアーカイブの整合性チェックが失敗した3884 プラグインアーカイブの整合性チェックが失敗しました

3882</h3>3885</h3>

3883 3886 

3884プラグインのマーケットプレイスエントリは、`sha256` ピン付きの [`archive` ソース](/docs/ja/plugins/marketplace-reference#archive-plugin-source)を使用しており、ダウンロードされたファイルのダイジェストがピンと一致しません。Claude Code はインストールを拒否するため、プラグインキャッシュに何も変更されません。不一致には 3 つの考えられる原因があります：3887プラグインのマーケットプレイスエントリは、`sha256` ピン付きの [`archive` ソース](/docs/ja/plugins/marketplace-reference#archive-plugin-source)を使用し、ダウンロードされたファイルのダイジェストはピンと一致しません。Claude Code はインストールを拒否するため、プラグインキャッシュに何も変わりません。不一致には 3 つの考えられる原因があります：

3885 3888 

3886* 著者がピンを計算した後、URL のファイルが変更された3889* 著者がピンを計算した後、URL のファイルが変更されました

3887* 著者がマーケットプレイスエントリに間違ったダイジェストを入力した3890* 著者がマーケットプレイスエントリに間違ったダイジェストを入力しました

3888* URL が著者がピンしたファイルとは異なるファイルを提供している3891* URL は著者がピンしたファイルとは異なるファイルを提供します

3889 3892 

3890```text theme={null}3893```text theme={null}

3891Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.3894Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

3894**対処方法：**3897**対処方法：**

3895 3898 

3896* プラグインを公開する場合は、URL が提供する正確なファイルのダイジェストを再計算します。例えば `shasum -a 256 my-plugin.zip` または PowerShell で `Get-FileHash -Algorithm SHA256 my-plugin.zip` を使用し、マーケットプレイスエントリの `sha256` を更新してください3899* プラグインを公開する場合は、URL が提供する正確なファイルのダイジェストを再計算します。例えば `shasum -a 256 my-plugin.zip` または PowerShell で `Get-FileHash -Algorithm SHA256 my-plugin.zip` を使用し、マーケットプレイスエントリの `sha256` を更新してください

3897* プラグインをインストールする場合は、`/plugin marketplace update <name>` を実行してカタログをリフレッシュし、エントリが修正されている場合に備えて、インストールを再試行してください3900* プラグインをインストールする場合は、`/plugin marketplace update <name>` を実行してカタログをリフレッシュします。エントリが修正された場合、インストールを再試行してください

3898* リフレッシュ後もダイジェストが一致しない場合は、インストール前にマーケットプレイス所有者にどのファイルをピンしたかを確認してください3901* リフレッシュ後もダイジェストが一致しない場合は、インストール前にマーケットプレイス所有者にどのファイルをピンしたかを尋ねてください

3899 3902 

3900<h3 id="path-escapes-plugin-directory">3903<h3 id="path-escapes-plugin-directory">

3901 パスがプラグインディレクトリをエスケープしている3904 パスがプラグインディレクトリをエスケープします

3902</h3>3905</h3>

3903 3906 

3904プラグインコンポーネントパス（プラグインの `plugin.json` またはその[マーケットプレイスエントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)で宣言）が、プラグイン自体のディレクトリの外に解決されます。Claude Code はそのパスを削除し、プラグインの残りを読み込みます。メッセージ内のコンポーネント名（`commands` や `hooks` など）は、パスを宣言したフィールドに名前を付けます。3907プラグインコンポーネントパスは、プラグインの `plugin.json` またはその[マーケットプレイスエントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)で宣言され、プラグイン自体のディレクトリの外に解決されます。Claude Code はそのパスをドロップし、プラグインの残りを読み込みます。メッセージ内のコンポーネント名（`commands` や `hooks` など）は、パスを宣言したフィールドに名前を付けます。

3905 3908 

3906```text theme={null}3909```text theme={null}

3907commands path escapes plugin directory: ./../shared.md3910commands path escapes plugin directory: ./../shared.md

3908```3911```

3909 3912 

3910`claude plugin` コマンド出力では、同じエラーは `Path escapes plugin directory: ./../shared.md (commands)` と表示されます。3913`claude plugin` コマンド出力では、同じエラーは `Path escapes plugin directory: ./../shared.md (commands)` と読みます。

3911 3914 

3912Claude Code は、`../shared-utils` のようにプラグインの外を指すパスと、プラグインの外につながるシンボリックリンク（[マーケットプレイスシンボリックリンクルール](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)が許可するもの以外）の両方を拒否します。シンボリックリンクの場合、メッセージはパスが解決される場所も示します：3915Claude Code は、`../shared-utils` のように書かれたプラグイン外を指すパスと、プラグイン外に導くシンボリックリンク（[マーケットプレイスシンボリックリンクルール](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)が許可するものではない）の両方を拒否します。シンボリックリンクの場合、メッセージはパスが解決される場所も示します：

3913 3916 

3914```text theme={null}3917```text theme={null}

3915commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory3918commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory

3916```3919```

3917 3920 

3918macOS と Linux では、Claude Code はコンポーネントパスにバックスラッシュが含まれている場合も拒否します。パスがプラグイン内に留まっていても、Windows スタイルのセパレータを使用するコンポーネントパスを持つプラグインは Windows で読み込まれ、他のプラットフォームではこの拒否をトリガーします：3921macOS と Linux では、Claude Code はコンポーネントパスにバックスラッシュが含まれているパスも拒否します。パスがプラグイン内に留まる場合でも。Windows スタイルのセパレータを使用するコンポーネントパスを持つプラグインは Windows で読み込まれ、他のプラットフォームでこの拒否をトリガーします：

3919 3922 

3920```text theme={null}3923```text theme={null}

3921commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform3924commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform

3922```3925```

3923 3926 

3924v2.1.251 より前は、Claude Code はマーケットプレイスエントリで宣言された `commands` パスを、プラグインディレクトリの外を指している場合でも読み込みました。Claude Code は既に `plugin.json` で宣言されたパスとマーケットプレイスエントリの他のコンポーネントパスを拒否していました。3927v2.1.251 より前では、Claude Code はマーケットプレイスエントリで宣言された `commands` パスを、プラグインディレクトリの外を指していても読み込みました。

3925 3928 

3926v2.1.257 より前は、チェックはパスのスペルのみを確認し、シンボリックリンクがどこにつながるかは確認しませんでした。3929v2.1.257 より前では、チェックはパスのスペルのみを調べ、シンボリックリンクが導く場所を調べませんでした。

3927 3930 

3928**対処方法：**3931**対処方法：**

3929 3932 

3930* 参照されたファイルをプラグインディレクトリ内に移動し、`./` 相対パスでそれを指すようにしてください3933* 参照されたファイルをプラグインディレクトリ内に移動し、`./` 相対パスでそれを指してください

3931* パスがプラグイン外のファイルへのシンボリックリンクの場合は、シンボリックリンクをファイルのコピーに置き換えてください3934* パスがプラグイン外のファイルへのシンボリックリンクである場合は、シンボリックリンクをファイルのコピーに置き換えてください

3932* メッセージがパスにバックスラッシュが含まれていると言う場合は、例えば `./commands/deploy.md` のようにフォワードスラッシュでパスを記述してください3935* メッセージがパスにバックスラッシュが含まれていると言う場合は、パスを前方スラッシュで書いてください。例えば `./commands/deploy.md`

3933* 同じマーケットプレイス内の他のプラグインとファイルを共有するには、プラグインディレクトリ内のシンボリックリンクを使用してリンクし、[シンボリックリンクルール](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)に従ってください3936* 同じマーケットプレイス内の他のプラグインとファイルを共有するには、プラグインディレクトリ内のシンボリックリンクでそれらをリンクし、[シンボリックリンクルール](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)に従ってください

3934 3937 

3935<h3 id="path-could-not-be-checked">3938<h3 id="path-could-not-be-checked">

3936 パスをチェックできませんでした3939 パスをチェックできませんでした

3937</h3>3940</h3>

3938 3941 

3939Claude Code はプラグインパスが存在するかどうかをオペレーティングシステムに問い合わせ、「見つかりません」以外のエラーを受け取ったため、パスが名前を付けるものを読み込みません。プラグインのどの程度が読み込まれるかは、どのパスが失敗したかによって異なります：3942Claude Code はプラグインパスが存在するかどうかをオペレーティングシステムに尋ね、「見つかりません」以外のエラーを取得したため、パスが名前を付けるものを読み込みません。プラグインの読み込み量は、どのパスが失敗したかによって異なります：

3940 3943 

3941* プラグインの [デフォルトコンポーネント場所](/docs/ja/plugins/manifest-reference#standard-layout)の 1 つ（`skills/` フォルダ、`monitors/monitors.json` ファイル、またはプラグインルートの [`SKILL.md`](/docs/ja/plugins/components#skills)など）：プラグインの他のコンポーネントは引き続き読み込まれます3944* プラグインの[デフォルトコンポーネント位置](/docs/ja/plugins/manifest-reference#standard-layout)の 1 つ（`skills/` フォルダ、`monitors/monitors.json` ファイル、またはプラグインルートの [`SKILL.md`](/docs/ja/plugins/components#skills)）：プラグインの他のコンポーネントは引き続き読み込まれます

3942* プラグイン自体のディレクトリ：そのプラグインからは何も読み込まれません3945* プラグイン自体のディレクトリ：そのプラグインから何も読み込まれません

3943 3946 

3944存在しないパスについてはこのエラーは表示されません。`/plugin` では、エラーはプラグインの下に表示され、パスとオペレーティングシステムが返したコードに名前を付けます：3947このエラーは、まったく存在しないパスに対しては表示されません。`/plugin` では、エラーはプラグインの下に表示され、パスとオペレーティングシステムが返したコードに名前を付けます：

3945 3948 

3946```text theme={null}3949```text theme={null}

3947skills path could not be checked: /home/user/my-plugin/skills (ELOOP)3950skills path could not be checked: /home/user/my-plugin/skills (ELOOP)

3948```3951```

3949 3952 

3950`claude plugin list` では、同じエラーは `Path not found: /home/user/my-plugin/skills (skills, ELOOP)` と表示されます。3953`claude plugin list` では、同じエラーは `Path not found: /home/user/my-plugin/skills (skills, ELOOP)` と読みます。

3951 3954 

3952このエラーを生成する原因には以下が含まれます：3955このエラーを生成する原因には以下が含まれます：

3953 3956 

3954* `ELOOP`：パス内のシンボリックリンクが自分自身を指しているか、ループを形成している3957* `ELOOP`：パス内のシンボリックリンクが自分自身を指すか、ループを形成します

3955* `EIO` または `ESTALE`：パスが壊れているか古いネットワークマウント上にある3958* `EIO` または `ESTALE`：パスは壊れているか古いネットワークマウント上にあります

3956* `EACCES`：パスの上のディレクトリの 1 つがそれを通過する権限を拒否している3959* `EACCES`：パスの上のディレクトリの 1 つがそれを横断する権限を拒否します

3957 3960 

3958**対処方法：**3961**対処方法：**

3959 3962 

3962* コードが `EACCES` の場合は、パスの上のディレクトリに対する実行権限を復元してください3965* コードが `EACCES` の場合は、パスの上のディレクトリに対する実行権限を復元してください

3963* パスを修正した後、`/reload-plugins` を実行するか、Claude Code を再起動して、プラグインまたはコンポーネントを読み込んでください3966* パスを修正した後、`/reload-plugins` を実行するか、Claude Code を再起動して、プラグインまたはコンポーネントを読み込んでください

3964 3967 

3965v2.1.265 より前は、Claude Code はチェックできないデフォルトコンポーネントフォルダを存在しないものとして扱い、エラーなしでそのコンポーネントなしでプラグインを読み込みました。3968v2.1.265 より前では、Claude Code はチェックできないデフォルトコンポーネントフォルダを存在しないものとして扱い、エラーなしでそのコンポーネントなしでプラグインを読み込みました。

3966 3969 

3967<h3 id="marketplace-entry-path-does-not-stay-inside-the-marketplace-directory">3970<h3 id="marketplace-entry-path-does-not-stay-inside-the-marketplace-directory">

3968 マーケットプレイスエントリパスがマーケットプレイスディレクトリ内に留まらない3971 マーケットプレイスエントリパスはマーケットプレイスディレクトリ内に留まりません

3969</h3>3972</h3>

3970 3973 

3971プラグインの[マーケットプレイスエントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)は、Claude Code がマーケットプレイス自体のディレクトリ内の場所に解決できないソースパスを宣言しているため、プラグインはインストールまたは読み込まれません。拒否は以下をカバーしています：3974プラグインの[マーケットプレイスエントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)は、Claude Code がマーケットプレイス自体のディレクトリ内の位置に解決できないソースパスを宣言するため、プラグインはインストールまたは読み込まれません。拒否は以下をカバーします：

3972 3975 

3973* 絶対パス、`..` でマーケットプレイスから抜け出す、またはネットワークパスのようにスペルされたエントリパス3976* 絶対的なエントリパス、`..` でマーケットプレイスから登ります、またはネットワークパスのようにスペルされています

3974* macOS と Linux では、先頭の `./` の後のどこかにバックスラッシュが含まれているエントリパス3977* macOS と Linux では、先頭の `./` の後のどこかにバックスラッシュを含むエントリパス

3975* git または URL などのリモートソースから取得されたマーケットプレイス内のエントリで、マーケットプレイスディレクトリの外に解決するシンボリックリンクを通じてターゲットに到達する3978* git または URL などのリモートソースから取得されたマーケットプレイス内のエントリ。マーケットプレイスディレクトリの外に解決するシンボリックリンクを通じてターゲットに到達します

3976* マーケットプレイスの `marketplace.json` への直接 URL から追加された相対エントリ：Claude Code はそのファイルのみをダウンロードするため、パスが名前を付けるローカルプラグインファイルは存在しません。[相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗する](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください3979* マーケットプレイスの `marketplace.json` への直接 URL から追加された相対エントリ：Claude Code はそのファイルのみをダウンロードするため、パスが名前を付けるローカルプラグインファイルは存在しません。[相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗します](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください

3977 3980 

3978`claude plugin install` は拒否を次のように報告します：3981`claude plugin install` は拒否を次のように報告します：

3979 3982 

3981Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)3984Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)

3982```3985```

3983 3986 

3984既にインストールされているプラグインのエントリが同じチェックに失敗した場合、`claude plugin list` はプラグインを `failed to load` として表示します：3987既にインストールされているプラグインのエントリが同じチェックに失敗する場合、`claude plugin list` はプラグインを `failed to load` として表示します：

3985 3988 

3986```text theme={null}3989```text theme={null}

3987Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.3990Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.

3989 3992 

3990**対処方法：**3993**対処方法：**

3991 3994 

3992* マーケットプレイスを保守する場合は、エントリの `source` を `./plugins/my-plugin` のようなプレーンな相対パスとして記述し、それが通過するシンボリックリンクをマーケットプレイスディレクトリ内を指すようにしてください3995* マーケットプレイスを維持する場合は、エントリの `source` を `./plugins/my-plugin` などの単純な相対パスとして書き、それが横断するシンボリックリンクをマーケットプレイスディレクトリ内を指すようにしてください

3993* マーケットプレイスを直接 URL から追加した場合、相対エントリは解決できません。マーケットプレイス作成者に [別のプラグインソース](/docs/ja/plugins/marketplace-reference#plugin-sources)を使用するよう依頼するか、代わりに git リポジトリからマーケットプレイスを追加してください3996* マーケットプレイスを直接 URL から追加した場合、相対エントリは解決できません。マーケットプレイス作成者に[別のプラグインソース](/docs/ja/plugins/marketplace-reference#plugin-sources)を使用するよう依頼するか、代わりに git リポジトリからマーケットプレイスを追加してください

3994 3997 

3995<h3 id="failed-to-load-marketplace-configuration">3998<h3 id="failed-to-load-marketplace-configuration">

3996 マーケットプレイス設定の読み込みに失敗した3999 マーケットプレイス設定の読み込みに失敗しました

3997</h3>4000</h3>

3998 4001 

3999Claude Code は、`~/.claude/plugins/known_marketplaces.json` のレジストリファイルに追加したプラグインマーケットプレイスを保持しています。`claude plugin install` などのレジストリが必要なプラグインコマンドは、Claude Code がファイルを使用できない場合、次の 2 つのメッセージのいずれかで失敗します：4002Claude Code は、`~/.claude/plugins/known_marketplaces.json` のレジストリファイルに追加したプラグインマーケットプレイスを保持します。`claude plugin install` などのレジストリが必要なプラグインコマンドは、Claude Code がファイルを使用できない場合、2 つのメッセージのいずれかで失敗します：

4000 

4001* `Failed to load marketplace configuration`：ファイルが有効な JSON ではない、または読み込めません。空のファイルもこのように失敗します。

4002* `Marketplace configuration file is corrupted`：ファイルは有効な JSON ですが、その内容がレジストリスキーマと一致しません。

4003 4003 

4004ファイルが見つからない場合は失敗ではありません。Claude Code はそれをマーケットプレイスなしのレジストリとして扱います。4004* `Failed to load marketplace configuration`：ファイルは存在しますが、有効な JSON ではないか、読み取ることができません。空のファイルもこの方法で失敗します。

4005* `Marketplace configuration file is corrupted`：ファイルは有効な JSON ですが、その内容はレジストリスキーマと一致しません。

4005 4006 

4006空のファイルの場合、`claude plugin install` は以下のように報告します：4007空のファイルの場合、`claude plugin install` は以下を報告します：

4007 4008 

4008```text theme={null}4009```text theme={null}

4009✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF4010✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF

4010```4011```

4011 4012 

4012v2.1.246 より前は、`claude plugin install` はこの失敗を報告しませんでした。4013v2.1.246 より前では、`claude plugin install` はこの失敗を報告しませんでした。

4013 4014 

4014**対処方法：**4015**対処方法：**

4015 4016 

4016* `~/.claude/plugins/known_marketplaces.json` を開き、JSON を修復するか、メッセージが名前を付けるエントリがレジストリスキーマと一致しないように修正してください4017* `~/.claude/plugins/known_marketplaces.json` を開き、JSON を修復するか、メッセージが名前を付けるエントリをレジストリスキーマと一致するように修正してください

4017* 修復できない場合は、ファイルを削除するか、その内容を `{}` に置き換えてから、`claude plugin marketplace add <source>` で各マーケットプレイスを再度追加してください。Claude Code は、信頼したフォルダで次回起動するときに、ユーザーまたはマネージド設定で [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)で宣言したマーケットプレイスを再登録します。4018* 修復できない場合は、ファイルを削除するか、その内容を `{}` に置き換えてから、`claude plugin marketplace add <source>` で各マーケットプレイスを再度追加してください。Claude Code は、信頼したフォルダで次回起動するときに、ユーザーまたは管理設定が [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) で宣言するマーケットプレイスを再登録します。

4018 4019 

4019<h3 id="plugin-is-required-by-your-organization">4020<h3 id="plugin-is-required-by-your-organization">

4020 プラグインは組織で必須です4021 プラグインは組織で必須です

4021</h3>4022</h3>

4022 4023 

4023`claude plugin disable` を実行するか、`/plugin` **Installed** タブを使用して、組織が必須としてマークしている [claude.ai から同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)をオフにしました：4024`claude plugin disable` を実行するか、`/plugin` **インストール済み**タブを使用して、組織が必須としてマークする [claude.ai から同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)をオフにしました：

4024 4025 

4025```text theme={null}4026```text theme={null}

4026Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.4027Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

4028 4029 

4029Claude Code は何も保存せず、プラグインは有効なままです。4030Claude Code は何も保存せず、プラグインは有効なままです。

4030 4031 

4031必須プラグインが依存するプラグインを無効にしようとすると、Claude Code は同じ方法で拒否し、それが必要な必須プラグインに名前を付けるメッセージを表示します。4032必須プラグインが依存するプラグインを無効にしようとすると、Claude Code は同じ方法で拒否し、それを必要とする必須プラグインに名前を付けるメッセージを表示します。

4032 4033 

4033**対処方法：**4034**対処方法：**

4034 4035 

4038 プラグインはアンインストールされませんでした4039 プラグインはアンインストールされませんでした

4039</h3>4040</h3>

4040 4041 

4041[`claude plugin uninstall`](/docs/ja/plugins/cli-reference#plugin-uninstall)を実行するか、`/plugin` **Installed** タブで **Uninstall** を選択し、アンインストールが `"<plugin>" was not uninstalled:` で始まるメッセージで停止しました。そのコロンの後のテキストが `installed_plugins.json` の代わりに設定ファイルに名前を付けている場合、原因は `installed_plugins.json` 内のコンテンツで、このバージョンの Claude Code が読み込めません。その形式については、[`installed_plugins.json` がこのバージョンが読み込めないレコードを保持している](/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read)を参照してください。4042[`claude plugin uninstall`](/docs/ja/plugins/cli-reference#plugin-uninstall)を実行するか、`/plugin` **インストール済み**タブで **アンインストール**を選択し、アンインストールは `"<plugin>" was not uninstalled:` で始まるメッセージで停止しました。そのコロンの後のテキストが設定ファイルの名前ではなく `installed_plugins.json` で始まる場合、原因は `installed_plugins.json` 内のこのバージョンの Claude Code が読み取ることができないコンテンツです。その形式については、[`installed_plugins.json` はこのバージョンが読み取ることができないレコードを保持しています](/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read)を参照してください。

4042 4043 

4043Claude Code がプラグインのエントリを `enabledPlugins` から削除し、そのスコープの設定ファイルを読み込み直したとき、プラグインはまだそこでオンになっていたか、またはそれをオンにできるファイルを読み込むか確認できませんでした。設定エントリがそれをオンに戻す可能性があるときにプラグインの保存されたオプション、シークレット、およびデータを削除すると、それらが失われるため、アンインストールは代わりに停止します：プラグインはインストールされたままで、保存されたものは何も削除されません。4044Claude Code がプラグインのエントリを `enabledPlugins` から削除し、そのスコープの設定ファイルを読み直したとき、プラグインはそこでまだオンに切り替えられたか、それをオンに切り替えることができるファイルを読み取ったり確認したりできませんでした。プラグインの保存されたオプション、シークレット、およびデータを削除しながら、設定エントリがそれをオンに切り替えることができるのは、それらを失うことになるため、アンインストールは代わりに停止します：プラグインはインストールされたままで、保存されたものは削除されません。

4044 4045 

4045```text theme={null}4046```text theme={null}

4046✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.4047✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.

4048 4049 

4049メッセージの中央はファイルと原因に名前を付けます：4050メッセージの中央はファイルと原因に名前を付けます：

4050 4051 

4051* `it is still switched on in <file>, although the settings change reported no error`：設定の書き込みは成功を報告しましたが、ファイルが読み込み直されたときもエントリはそこにあります4052* `it is still switched on in <file>, although the settings change reported no error`：設定の書き込みは成功を報告しましたが、エントリはファイルを読み直すときにまだそこにあります

4052* `it is still switched on in <file>, and the settings change failed (<error>)`：ファイルを保存できず、括弧内の理由があります4053* `it is still switched on in <file>, and the settings change failed (<error>)`：ファイルを保存できませんでした。括弧内の理由のため

4053* `<file> is there and could not be read`：ファイルは存在しますが、設定として読み込めません。例えば有効な JSON ではないため、プラグインを有効にする可能性があります4054* `<file> is there and could not be read`：ファイルは存在しますが、設定として読み取ることができませんでした。例えば、有効な JSON ではないため、プラグインを有効にしたままの可能性があります

4054* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`：Claude Code はプロジェクトまたはローカル設定ファイルを読み込みませんでした。ファイル、またはそれを保持する `.claude` フォルダが、ネットワークの場所にリンクしているか、そのパスを確認できなかったためです4055* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`：Claude Code はプロジェクトまたはローカル設定ファイルを読み取りませんでした。ファイル、またはそれを保持する `.claude` フォルダは、ネットワークの場所にリンクしているか、そのパスを調べることができなかったためです

4055 4056 

4056`claude plugin uninstall` は終了コード 1 で終了し、`--json` を使用するとその結果は `failureCode: "settings_still_on"` を含みます。`/plugin` は同じメッセージを表示します。4057`claude plugin uninstall` は終了コード 1 で、`--json` を使用すると結果は `failureCode: "settings_still_on"` を含みます。`/plugin` は同じメッセージを表示します。

4057 4058 

4058**対処方法：**4059**対処方法：**

4059 4060 

4626terminal host process died — press Enter to restart4627terminal host process died — press Enter to restart

4627```4628```

4628 4629 

4629チェックが実行される前に行を開くと、フッターは `This session's terminal host process died (the conversation is saved) — press Enter to restart it` を表示し、行は失敗になります。

4630 

4631シェルから、`claude attach <id>` は既に死んだホストで失敗とマークされたセッションを再開し、そうでなければ原因を出力して終了します：4630シェルから、`claude attach <id>` は既に死んだホストで失敗とマークされたセッションを再開し、そうでなければ原因を出力して終了します：

4632 4631 

4633```text theme={null}4632```text theme={null}

5023 5022 

5024Claude Code はこれらのメッセージのほとんどを stderr に書き込み、会話には書き込みません。また、ほとんどのメッセージはスタートアップ時に書き込みます。エントリは、デバッグログや会話ビューのスタートアップ通知など、別の場所に表示される場合、または [認識されないモデル診断行](#unrecognized-model-id-on-a-request) のようにリクエスト時など別の時間に表示される場合に、そのことを記載します。5023Claude Code はこれらのメッセージのほとんどを stderr に書き込み、会話には書き込みません。また、ほとんどのメッセージはスタートアップ時に書き込みます。エントリは、デバッグログや会話ビューのスタートアップ通知など、別の場所に表示される場合、または [認識されないモデル診断行](#unrecognized-model-id-on-a-request) のようにリクエスト時など別の時間に表示される場合に、そのことを記載します。

5025 5024 

5026<h3 id="fullscreen-failed-start-notice">

5027 フルスクリーンレンダラーが起動を完了しませんでした

5028</h3>

5029 

5030このマシン上の以前の [フルスクリーン](/docs/ja/fullscreen) セッションが起動を完了する前に終了したため、Claude Code はこのセッションをクラシックレンダラーで起動し、次のいずれかの通知を出力します。

5031 

5032```text theme={null}

5033Claude Code's fullscreen renderer didn't finish starting last time on this machine, so this launch is using the classic renderer. It will try fullscreen again next launch; /tui default keeps the classic renderer.

5034 

5035Claude Code's fullscreen renderer has repeatedly failed to start on this machine, so it has been turned off here. Run /tui fullscreen to try it again (this also resets after an update).

5036```

5037 

5038**対応方法：**

5039 

5040* [フルスクリーンレンダリング](/docs/ja/fullscreen#fullscreen-renderer-didnt-finish-starting) に従ってください。どの通知が表示されるか、Claude Code が後続のセッションで何を行うか、およびフルスクリーンを再度試すか、クラシックレンダラーを保持する方法が説明されています。

5041* 終了したセッションが終了メッセージを出力した場合は、[Claude Code が回復不可能なインターフェイスエラーの後に終了しました](#exited-after-an-unrecoverable-interface-error) を参照して、その名前を確認してください。

5042 

5043v2.1.236 より前では、Claude Code は通知を出力せず、失敗した起動後もフルスクリーンレンダリングでセッションを起動し続けていました。

5044 

5045<h3 id="exited-after-an-unrecoverable-interface-error">5025<h3 id="exited-after-an-unrecoverable-interface-error">

5046 Claude Code が回復不可能なインターフェイスエラーの後に終了しました5026 回復不可能なインターフェイスエラーの後に Claude Code が終了しました

5047</h3>5027</h3>

5048 5028 

5049Claude Code は、ターミナルインターフェイスが回復できないエラーに遭遇して終了するときにこのメッセージを出力します。これはどちらのレンダラーでも発生する可能性があります。2 番目の文は、エラーが [フルスクリーン](/docs/ja/fullscreen) レンダラーの起動中に発生した場合にのみ表示されます。5029Claude Code は、ターミナルインターフェイスが回復できないエラーに遭遇して終了するときにこのメッセージを出力します。これはどちらのレンダラーでも発生する可能性があります。2 番目の文は、エラーが [フルスクリーン](/docs/ja/fullscreen) レンダラーの起動中に発生した場合にのみ表示されます。

5193* 設定を管理している場合は、ユーザーが実行できるモデルを `availableModels` に追加するか、すべてのフォールバックをブロックする `deniedModels` エントリを絞り込んでください。[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions) はデフォルトオプションがどのようにステップダウンするかを説明しています。5173* 設定を管理している場合は、ユーザーが実行できるモデルを `availableModels` に追加するか、すべてのフォールバックをブロックする `deniedModels` エントリを絞り込んでください。[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions) はデフォルトオプションがどのようにステップダウンするかを説明しています。

5194* 設定を管理していない場合は、メッセージを管理者に送信してください。独自の設定ファイルは、管理された `availableModels` または `deniedModels` リストを拡大することはできません。5174* 設定を管理していない場合は、メッセージを管理者に送信してください。独自の設定ファイルは、管理された `availableModels` または `deniedModels` リストを拡大することはできません。

5195 5175 

5176<h3 id="managed-settings-dont-allow-this-api-provider">

5177 管理設定がこの API プロバイダーを許可していません

5178</h3>

5179 

5180組織の [管理設定](/docs/ja/managed-settings) は [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) リストを設定し、セッションの API プロバイダーがそれにないか、セッションがそのエントリが要求する方法でピン留めされていないエンドポイントを使用しています。Claude Code はスタートアップ前、ログイン前、またはセッションが次に API に接続するときに拒否します。メッセージは許可されたプロバイダーで始まります。

5181 

5182```text theme={null}

5183Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.

5184```

5185 

5186リストが空の場合、メッセージは代わりに以下のように読みます。

5187 

5188```text theme={null}

5189Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.

5190```

5191 

5192すべてのエントリが認識されない場合、括弧内は `(allowedProviders lists only unrecognized entries)` と読みます。

5193 

5194**対応方法：**

5195 

5196* メッセージの `To continue:` ステップに従ってください。

5197* 設定を管理している場合、メッセージの `Admins:` で始まる行は、追加するエントリまたはピン留めする値に名前を付け、[`allowedProviders`](/docs/ja/settings-reference#allowedproviders) エントリは、どのソースの `env` ブロックがそれをピン留めできるかを示しています。

5198 

5196<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5199<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

5197 MCP サーバーはエンタープライズ管理ポリシーによってブロックされています5200 MCP サーバーはエンタープライズ管理ポリシーによってブロックされています

5198</h3>5201</h3>

5246* マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の `managed-settings.json` は `{}` としてカウントされ、起動をブロックしません。5249* マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の `managed-settings.json` は `{}` としてカウントされ、起動をブロックしません。

5247* そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。5250* そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。

5248 5251 

5252<h3 id="unable-to-read-managed-policy-settings">

5253 管理ポリシー設定を読み取ることができません

5254</h3>

5255 

5256組織は [管理設定](/docs/ja/managed-settings) をデプロイしており、デプロイされたソースの 1 つが存在しますが、オペレーティングシステムが読み取りを拒否するのではなく、I/O エラーなどの理由で読み取ることができませんでした。他の管理ソースがポリシーを供給していない場合、Claude Code はポリシーが実行される可能性があるソースなしで実行するのではなく、スタートアップで終了します。

5257 

5258```text theme={null}

5259Unable to read managed policy settings.

5260This machine may require organization login enforcement, but the policy file failed to load.

5261Contact your administrator.

5262 

5263Detail: <source>: <reason>

5264```

5265 

5266同じ状態で、サインインフロー、既に実行中のセッションからの API リクエスト、および [`claude gateway`](/docs/ja/claude-apps-gateway) サーバーは、[`allowedProviders`](/docs/ja/settings-reference#allowedproviders) に名前を付ける最初の行のバリアントで拒否されます。

5267 

5268オペレーティングシステムが拒否した読み取り（ルートのみのファイルなど）はこの終了を生成しません。[セッションはそのソースのポリシーなしで開始します](/docs/ja/managed-settings#find-entries-claude-code-dropped)。解析できないソースの場合、Claude Code は [ソースに名前を付ける別のメッセージで終了します](#managed-settings-document-could-not-be-parsed)。

5269 

5270**対応方法：**

5271 

5272* マシンを管理している場合は、`Detail:` 行が名前を付ける問題を修正して、デプロイされたソースを読み取ることができるようにするか、ソースを削除してください。

5273* そうでない場合は、メッセージを管理者に送信してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。

5274 

5275v2.1.285 より前では、claude.ai または Claude Console 認証情報でサインインしたセッションのみがこのメッセージで終了し、オペレーティングシステムが拒否した読み取りもそれを生成していました。

5276 

5249<h3 id="otelheadershelper-failed">5277<h3 id="otelheadershelper-failed">

5250 otelHeadersHelper が失敗しました5278 otelHeadersHelper が失敗しました

5251</h3>5279</h3>

5344* 警告が括弧内に名前を付けるソースでルールを修正してください。設定ファイルパス、または `--allowed-tools` フラグ自体。ディスク上に存在しない `claude-settings-<hash>.json` パスはインライン `--settings` 値を表します。そのフラグに渡す JSON を修正してください。5372* 警告が括弧内に名前を付けるソースでルールを修正してください。設定ファイルパス、または `--allowed-tools` フラグ自体。ディスク上に存在しない `claude-settings-<hash>.json` パスはインライン `--settings` 値を表します。そのフラグに渡す JSON を修正してください。

5345* ソースが `managed policy settings` と読む場合は、警告を管理設定を保守している人に転送してください。自分でそれをクリアすることはできません。5373* ソースが `managed policy settings` と読む場合は、警告を管理設定を保守している人に転送してください。自分でそれをクリアすることはできません。

5346 5374 

5347Claude Code は同じ形状の deny および ask ルールについて警告しません。それらが一致する追加コマンドを拒否またはプロンプトします。また、サブコマンドが最初の `*` の前に来るルール（`Bash(git commit *)` など）、または `*` の後にオプション以外の単語がないルール（`Bash(git *)` など）、または `:*` プレフィックスルール（`Bash(git:*)` など）についても警告しません。

5348 

5349[バックグラウンドセッション](/docs/ja/agent-view) または `--output-format json` または `stream-json` では、Claude Code は警告をデバッグログに stderr の代わりに書き込むため、マシン読み取り出力はクリーンなままです。`--debug` で `~/.claude/debug/<session-id>.txt` でキャプチャしてください。v2.1.246 より前では、Claude Code はこれらのルールを警告なしで受け入れていました。5375[バックグラウンドセッション](/docs/ja/agent-view) または `--output-format json` または `stream-json` では、Claude Code は警告をデバッグログに stderr の代わりに書き込むため、マシン読み取り出力はクリーンなままです。`--debug` で `~/.claude/debug/<session-id>.txt` でキャプチャしてください。v2.1.246 より前では、Claude Code はこれらのルールを警告なしで受け入れていました。

5350 5376 

5351<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">5377<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">

5458 応答の品質がいつもより低いように見える5484 応答の品質がいつもより低いように見える

5459</h2>5485</h2>