SpyBara
Go Premium

Documentation 2026-10-14 22:58 UTC to 2026-10-15 23:58 UTC

47 files changed +2,024 −799. View all changes and history on the product overview
2026
Fri 30 23:01 Thu 29 23:57 Wed 28 23:57 Tue 27 22:59 Mon 26 22:57 Sun 25 23:58 Sat 24 22:59 Fri 23 22:59 Thu 22 22:58 Wed 21 23:02 Tue 20 23:00 Mon 19 23:58 Sat 17 23:57 Fri 16 22:59 Thu 15 23:58 Wed 14 22:58 Tue 13 23:57 Sun 11 23:57 Sat 10 23:01 Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59
Details

633| 制限事項 | 説明 |633| 制限事項 | 説明 |

634| - | - |634| - | - |

635| Write/Edit/NotebookEdit ツールのみ | Bash コマンドを通じて行われた変更は追跡されません |635| Write/Edit/NotebookEdit ツールのみ | Bash コマンドを通じて行われた変更は追跡されません |

636| Subagent の編集 | [subagent](/docs/ja/agent-sdk/subagents) が適用する編集は追跡または復元されません。ただし、`context: fork` を使用して foreground で実行されるスキルは除きます。追跡されていない編集を戻すには git を使用してください |636| サブエージェントの編集 | [サブエージェント](/docs/ja/agent-sdk/subagents) が適用する編集は追跡されません。ただし、`context: fork` を使用してフォアグラウンドで実行されるスキルは除きます。巻き戻しでこれらの編集が元に戻るのは、メインの会話がすでに編集していたファイルのみです。それ以外は git を使用して元に戻してください |

637| 同じセッション | Checkpoint は、それを作成したセッションに関連付けられています |637| 同じセッション | Checkpoint は、それを作成したセッションに関連付けられています |

638| ファイルコンテンツのみ | ディレクトリの作成、移動、または削除は、巻き戻しによって元に戻されません |638| ファイルコンテンツのみ | ディレクトリの作成、移動、または削除は、巻き戻しによって元に戻されません |

639| ローカルファイル | リモートまたはネットワークファイルは追跡されません |639| ローカルファイル | リモートまたはネットワークファイルは追跡されません |

Details

17 17 

18このガイドでは、SDK がテレメトリをどのように発行するか、エクスポートを設定する方法、およびデータがバックエンドに到達した後にタグ付けしてフィルタリングする方法について説明します。バックエンドにエクスポートする代わりに SDK レスポンスストリームからトークン使用量とコストを直接読み取るには、[コストと使用量の追跡](/docs/ja/agent-sdk/cost-tracking)を参照してください。18このガイドでは、SDK がテレメトリをどのように発行するか、エクスポートを設定する方法、およびデータがバックエンドに到達した後にタグ付けしてフィルタリングする方法について説明します。バックエンドにエクスポートする代わりに SDK レスポンスストリームからトークン使用量とコストを直接読み取るには、[コストと使用量の追跡](/docs/ja/agent-sdk/cost-tracking)を参照してください。

19 19 

20<Note>

21 Claude API または Managed Agents については、[Claude API 用の OpenTelemetry](https://platform.claude.com/docs/en/manage-claude/opentelemetry) を参照してください。

22</Note>

23 

20<h2 id="how-telemetry-flows-from-the-sdk">24<h2 id="how-telemetry-flows-from-the-sdk">

21 SDK からのテレメトリフロー25 SDK からのテレメトリフロー

22</h2>26</h2>

Details

369| `session_id` | `string` | このメッセージが属するセッション |369| `session_id` | `string` | このメッセージが属するセッション |

370| `message` | `unknown` | トランスクリプトからの生のメッセージペイロード |370| `message` | `unknown` | トランスクリプトからの生のメッセージペイロード |

371| `parent_tool_use_id` | `string \| null` | サブエージェントメッセージの場合、サブエージェントを開始した `Agent` または `Skill` ツール呼び出しの `tool_use_id`。メインセッションメッセージと古いセッションの場合は `null` |371| `parent_tool_use_id` | `string \| null` | サブエージェントメッセージの場合、サブエージェントを開始した `Agent` または `Skill` ツール呼び出しの `tool_use_id`。メインセッションメッセージと古いセッションの場合は `null` |

372| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) からのメッセージの場合、それを生成したサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。Claude Code v2.1.202 以降が必要です |372| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) からのメッセージの場合、そのネストされたサブエージェントを生成したサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。Claude Code v2.1.202 以降が必要です |

373 373 

374<h4 id="example-4">374<h4 id="example-4">

375 例375 例


1829* `first_stream_post_ms`、`first_stream_post_ack_ms`、`first_stream_post_wall_ms`: ターンの最初のストリームイベントのアップロードに関するタイミング。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)など claude.ai にストリーミングするセッションでのみこれらを記録し、`query()` が返す結果にはこれらは含まれません。Agent SDK v0.3.260 以降が必要です。1829* `first_stream_post_ms`、`first_stream_post_ack_ms`、`first_stream_post_wall_ms`: ターンの最初のストリームイベントのアップロードに関するタイミング。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)など claude.ai にストリーミングするセッションでのみこれらを記録し、`query()` が返す結果にはこれらは含まれません。Agent SDK v0.3.260 以降が必要です。

1830* `usage`: メインのエージェントループのみが対象です。サブエージェントや補助的なモデル呼び出しは除外され、ストリーミング入力セッションではターンごとの値になります。トークンやコストの集計には `modelUsage` を優先してください。1830* `usage`: メインのエージェントループのみが対象です。サブエージェントや補助的なモデル呼び出しは除外され、ストリーミング入力セッションではターンごとの値になります。トークンやコストの集計には `modelUsage` を優先してください。

1831* `modelUsage`: この `query()` 呼び出しの間にクエリパイプラインを通じて行われたすべてのモデル呼び出しのモデルごとの合計で、メインループ、サブエージェント、コンテキスト圧縮や Workflow エージェントなどの内部呼び出しを含みます。権限分類器やトークンカウントのリクエストなど、そのパイプライン外のヘルパー呼び出しは除外されます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元されたモデルごとの合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)も数えられます。ストリーミング入力セッションでは合計がターンをまたいで累積されるため、結果を合算するのではなく最新の結果を読み取ってください。リセットについては [Track costs in streaming input mode](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) を、ゼロになった結果については [Recover totals after a session crash](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) を参照してください。1831* `modelUsage`: この `query()` 呼び出しの間にクエリパイプラインを通じて行われたすべてのモデル呼び出しのモデルごとの合計で、メインループ、サブエージェント、コンテキスト圧縮や Workflow エージェントなどの内部呼び出しを含みます。権限分類器やトークンカウントのリクエストなど、そのパイプライン外のヘルパー呼び出しは除外されます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元されたモデルごとの合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)も数えられます。ストリーミング入力セッションでは合計がターンをまたいで累積されるため、結果を合算するのではなく最新の結果を読み取ってください。リセットについては [Track costs in streaming input mode](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) を、ゼロになった結果については [Recover totals after a session crash](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) を参照してください。

1832* `total_cost_usd`: USD での累積推定コストで、`modelUsage` と同じ呼び出しを対象とし、同じタイミングでリセットされます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元された合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)も数えられます。これは推定値であり、請求明細ではありません。精度に関する注意事項については [Track cost and usage](/docs/ja/agent-sdk/cost-tracking) を参照してください。1832* `total_cost_usd`: USD での累積推定コストで、`modelUsage` と同じ呼び出しを対象とし、同じタイミングでリセットされます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元された合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)も数えられます。これは推定値であり、請求明細ではありません。精度に関する注意事項については [コストと使用状況を追跡する](/docs/ja/agent-sdk/cost-tracking) を参照してください。

1833* `queued_turn_count`: Claude Code が結果を生成した時点でまだ待機中の、`origin: { kind: "human" }` を付けて送信したメッセージの数。`0` やフィールドがない場合の意味については [`queued_turn_count`](#queued_turn_count) を参照してください。1833* `queued_turn_count`: Claude Code が結果を生成した時点でまだ待機中の、`origin: { kind: "human" }` を付けて送信したメッセージの数。`0` やフィールドがない場合の意味については [`queued_turn_count`](#queued_turn_count) を参照してください。

1834* `result_index`: 実行の配信順序におけるこの結果の位置で、プロセスが書き込むすべての結果を通して 0 から数えます。両方のアームに存在します。書き込みに失敗した結果もその番号を消費するため、連番に欠番がある場合は結果が失われたことを意味します。Agent SDK v0.3.268 以降が必要です。1834* `result_index`: 実行の配信順序におけるこの結果の位置で、プロセスが書き込むすべての結果を通して 0 から数えます。両方のアームに存在します。書き込みに失敗した結果もその番号を消費するため、連番に欠番がある場合は結果が失われたことを意味します。Agent SDK v0.3.268 以降が必要です。

1835* `startup_failure_reason`: 既知の起動失敗で終了する前に Claude Code が書き込む `error_during_execution` 結果における、Claude Code が起動を拒否した理由。値とどの失敗がこれを持つかについては [`startup_failure_reason`](#startup_failure_reason) を参照してください。Agent SDK v0.3.274 以降が必要です。1835* `startup_failure_reason`: 既知の起動失敗で終了する前に Claude Code が書き込む `error_during_execution` 結果における、Claude Code が起動を拒否した理由。値とどの失敗がこれを持つかについては [`startup_failure_reason`](#startup_failure_reason) を参照してください。Agent SDK v0.3.274 以降が必要です。

agent-view.md +5 −5

Details

500 バックグラウンドに移動するときに引き継がれるもの500 バックグラウンドに移動するときに引き継がれるもの

501</h4>501</h4>

502 502 

503バックグラウンドへの移動では、保存された会話から再開する新しいプロセスが開始され、進行中の作業はそのプロセスに移動します。実行中のバックグラウンドシェルコマンド、バックグラウンド化されたサブエージェント、動的ワークフロー、[`/loop`](/docs/ja/scheduled-tasks) で作成したスケジュールタスク、および Claude の [アーティファクトコメントへの自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) はすべて引き継がれ、そこで実行を続けます。サブエージェントは自身が開始したすべてのものと一緒に移動するため、その作業のすべてが移動できる場合にのみ引き継がれます。進行中の作業を引き継がずに停止するには、[`CLAUDE_DISABLE_ADOPT=1`](/docs/ja/env-vars#variables) 環境変数を設定します。その場合、Claude Code はバックグラウンドに移動する前に確認を求めます。503バックグラウンドへの移動では、保存された会話から再開する新しいプロセスが開始され、進行中のバックグラウンド作業はそのプロセスに移動します。実行中のバックグラウンドシェルコマンド、バックグラウンド化されたサブエージェント、動的ワークフロー、[`/loop`](/docs/ja/scheduled-tasks) で作成したスケジュールタスク、および Claude の [アーティファクトコメントへの自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) はすべて引き継がれ、そこで実行を続けます。サブエージェントは自身が開始したすべてのものと一緒に移動するため、その作業のすべてが移動できる場合にのみ引き継がれます。進行中のバックグラウンド作業を引き継がずに停止するには、[`CLAUDE_DISABLE_ADOPT=1`](/docs/ja/env-vars#variables) 環境変数を設定します。その場合、Claude Code はバックグラウンドに移動する前に確認を求めます。

504 504 

505[動的ワークフロー](/docs/ja/workflows) でまだサブエージェントが実行中の場合、Claude Code はバックグラウンドに移動する前に `Background this session?` ダイアログで確認を求め、再起動されるサブエージェントの数を示します。先に完了させるには `Stay` を選択します。確認すると、Claude Code はバックグラウンドセッションで実行を再生します。まだ実行中だったサブエージェントは最初からやり直されるため、それまでに使用したトークンは再度消費されます。完了したサブエージェントのうち、保存された結果を返すものと再実行されるものについては、[一時停止後の再開](/docs/ja/workflows#resume-after-a-pause) を参照してください。505[動的ワークフロー](/docs/ja/workflows) でまだサブエージェントが実行中の場合、Claude Code はバックグラウンドに移動する前に `Background this session?` ダイアログで確認を求め、再起動されるサブエージェントの数を示します。先に完了させるには `Stay` を選択します。確認すると、Claude Code はバックグラウンドセッションで実行を再生します。まだ実行中だったサブエージェントは最初からやり直されるため、それまでに使用したトークンは再度消費されます。完了したサブエージェントのうち、保存された結果を返すものと再実行されるものについては、[一時停止後の再開](/docs/ja/workflows#resume-after-a-pause) を参照してください。

506 506 

507Claude Code は、実行中の [モニター](/docs/ja/tools-reference#monitor-tool) など引き継げない作業を停止し、モニターを所有するバックグラウンド化されたサブエージェントも一緒に停止します。そのような作業が実行中の場合、Claude Code は `Background this session?` ダイアログを表示し、作業を停止する前に確認できるようにします。507Claude Code は、実行中の [モニター](/docs/ja/tools-reference#monitor-tool) など引き継げないバックグラウンド作業を停止し、モニターを所有するバックグラウンド化されたサブエージェントも一緒に停止します。そのような作業が実行中の場合、Claude Code は `Background this session?` ダイアログを表示し、作業を停止する前に確認できるようにします。

508 508 

509バックグラウンドに移動した後、セッションは新しいサブエージェント、モニター、バックグラウンドコマンドを開始でき、それらはその後のデタッチや再アタッチをまたいで実行を続けます。509バックグラウンドに移動した後、セッションは新しいサブエージェント、モニター、バックグラウンドコマンドを開始でき、それらはその後のデタッチや再アタッチをまたいで実行を続けます。

510 510 


949 バックグラウンド化が `Background this session?` ダイアログを表示する949 バックグラウンド化が `Background this session?` ダイアログを表示する

950</h3>950</h3>

951 951 

952`←` を押して現在のセッションをバックグラウンドに移すと、Claude Code が `Background this session?` ダイアログを表示する場合、セッションには実行中の作業があり、バックグラウンド化によって停止、再開、または無人で実行されたままになる可能性があり、Claude Code はそれを実行する前に確認します:952`←` を押して現在のセッションをバックグラウンドに移すと、Claude Code が `Background this session?` ダイアログを表示する場合、セッションには実行中のバックグラウンド作業があり、バックグラウンド化によって停止、再開、または無人で実行されたままになる可能性があり、Claude Code はそれを実行する前に確認します:

953 953 

954* **移動できない作業**:セッションには、実行中の [monitor](/docs/ja/tools-reference#monitor-tool) などのバックグラウンドセッションに移動できない作業があります。ダイアログは Claude Code が停止する作業を名前で表示し、別に転送されるタスクをカウントします。954* **移動できない作業**:セッションには、実行中の [モニター](/docs/ja/tools-reference#monitor-tool) など、バックグラウンドセッションに移動できない作業があります。ダイアログは Claude Code が停止するバックグラウンド作業を名前で表示し、転送されるタスクは別にカウントします。

955* **実行中のサブエージェントを持つワークフロー**:[動的ワークフロー](/docs/ja/workflows)にはまだ実行中のサブエージェントがあります。ワークフロー自体は転送されますが、実行中のサブエージェントは最初から再開され、ダイアログはその数を表示します。955* **実行中のサブエージェントを持つワークフロー**:[動的ワークフロー](/docs/ja/workflows)にはまだ実行中のサブエージェントがあります。ワークフロー自体は転送されますが、実行中のサブエージェントは最初から再開され、ダイアログはその数を表示します。

956* **自動アーティファクト返信**:Claude が[アーティファクトのコメントに自動で返信している](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)場合があります。これらの返信はバックグラウンドセッションで続行され、ダイアログはそのことを表示します。956* **自動アーティファクト返信**:Claude が[アーティファクトのコメントに自動で返信している](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)場合があります。これらの返信はバックグラウンドセッションで続行され、ダイアログはそのことを表示します。

957 957 


1175| v2.1.199 | プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |1175| v2.1.199 | プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |

1176| v2.1.198 | バックグラウンドセッションが入力を必要とするとき、完了したとき、または失敗したときに、agent view は `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内での `←` と `/exit` は、シェルに戻るのではなく agent view に戻ります。`Ctrl+Z` でシェルに戻ります。作業を worktree に分離したバックグラウンドセッションは、完了時に事前に確認することなくコミットし、独自の分離ブランチをプッシュして(`main` や `master` は決してプッシュしません)、ドラフトのプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。バックグラウンドセッションホストは、`connect: no route to host` で失敗する代わりに、最初の LAN アクセス時に macOS のローカルネットワーク権限を要求します。 |1176| v2.1.198 | バックグラウンドセッションが入力を必要とするとき、完了したとき、または失敗したときに、agent view は `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内での `←` と `/exit` は、シェルに戻るのではなく agent view に戻ります。`Ctrl+Z` でシェルに戻ります。作業を worktree に分離したバックグラウンドセッションは、完了時に事前に確認することなくコミットし、独自の分離ブランチをプッシュして(`main` や `master` は決してプッシュしません)、ドラフトのプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。バックグラウンドセッションホストは、`connect: no route to host` で失敗する代わりに、最初の LAN アクセス時に macOS のローカルネットワーク権限を要求します。 |

1177| v2.1.196 | 単一の `←` 押下でフォアグラウンドセッションがバックグラウンド化されます。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、黙って無視されるのではなく、バイパスの免責事項を表示します。名前を付けていない対話型セッションには、セッション一覧と `claude agents --json` で `my-app-3f` のようなデフォルト名が付きます。バックグラウンドのシェルコマンドと動的ワークフローは、Windows を含め、セッションのプロセスが停止、再起動、または更新されても存続します。このハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再起動時に空と誤って読み取られたトランスクリプトは、削除されるのではなく `.orphaned-` サフィックス付きの名前に変更されます。 |1177| v2.1.196 | 単一の `←` 押下でフォアグラウンドセッションがバックグラウンド化されます。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、黙って無視されるのではなく、バイパスの免責事項を表示します。名前を付けていない対話型セッションには、セッション一覧と `claude agents --json` で `my-app-3f` のようなデフォルト名が付きます。バックグラウンドのシェルコマンドと動的ワークフローは、Windows を含め、セッションのプロセスが停止、再起動、または更新されても存続します。このハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再起動時に空と誤って読み取られたトランスクリプトは、削除されるのではなく `.orphaned-` サフィックス付きの名前に変更されます。 |

1178| v2.1.195 | Windows でも、セッションをバックグラウンド化する際に実行中の作業が引き継がれます。代わりに停止させるには `CLAUDE_DISABLE_ADOPT=1` を設定します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンが、新しいセッションの `state.json` フィールドを破棄したり、それらのセッションを `claude agents` から隠したりしなくなりました。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入れることができないスーパーバイザーは自ら終了してロックを解放します。 |1178| v2.1.195 | Windows でも、セッションをバックグラウンド化する際に実行中のバックグラウンド作業が引き継がれます。代わりに停止させるには `CLAUDE_DISABLE_ADOPT=1` を設定します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンが、新しいセッションの `state.json` フィールドを破棄したり、それらのセッションを `claude agents` から隠したりしなくなりました。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入れることができないスーパーバイザーは自ら終了してロックを解放します。 |

1179| v2.1.191 | どのサブエージェントとも一致しない `--agent` 名を指定して `claude --bg` を実行すると、起動が失敗します。セッションはデフォルトのエージェントで実行されるのではなく、`--agent '<name>' not found` エラーで直ちに終了します。 |1179| v2.1.191 | どのサブエージェントとも一致しない `--agent` 名を指定して `claude --bg` を実行すると、起動が失敗します。セッションはデフォルトのエージェントで実行されるのではなく、`--agent '<name>' not found` エラーで直ちに終了します。 |

1180| v2.1.174 | バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数(`ANTHROPIC_BASE_URL` など)を継承しなくなります。スーパーバイザーは事前にウォームアップされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |1180| v2.1.174 | バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数(`ANTHROPIC_BASE_URL` など)を継承しなくなります。スーパーバイザーは事前にウォームアップされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |

1181| v2.1.172 | ディスパッチ入力の `/model` は、セッションスコープのディスパッチモデルの上書きを設定します。 |1181| v2.1.172 | ディスパッチ入力の `/model` は、セッションスコープのディスパッチモデルの上書きを設定します。 |

analytics.md +2 −0

Details

13| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | 使用メトリクス、GitHub 統合による貢献メトリクス、リーダーボード、データエクスポート | [詳細](#access-analytics-for-team-and-enterprise) |13| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | 使用メトリクス、GitHub 統合による貢献メトリクス、リーダーボード、データエクスポート | [詳細](#access-analytics-for-team-and-enterprise) |

14| API(Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | 使用メトリクス、支出追跡、チームインサイト | [詳細](#access-analytics-for-api-customers) |14| API(Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | 使用メトリクス、支出追跡、チームインサイト | [詳細](#access-analytics-for-api-customers) |

15 15 

16Code Review には専用のダッシュボードがあります。レビューのアクティビティと支出については、[使用状況を表示する](/docs/ja/code-review-costs#view-usage)を参照してください。

17 

16<h2 id="access-analytics-for-team-and-enterprise">18<h2 id="access-analytics-for-team-and-enterprise">

17 Team と Enterprise の分析にアクセスする19 Team と Enterprise の分析にアクセスする

18</h2>20</h2>

artifacts.md +5 −3

Details

75| セッションが [plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)になっている | 各アーティファクトの最初の公開前に確認する |75| セッションが [plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)になっている | 各アーティファクトの最初の公開前に確認する |

76| 公開が、[コネクタ呼び出し](#pull-live-data-with-mcp-connectors)や[ファイルダウンロード](#offer-a-file-download)など、ページのランタイム機能を宣言している | その公開の前に確認する |76| 公開が、[コネクタ呼び出し](#pull-live-data-with-mcp-connectors)や[ファイルダウンロード](#offer-a-file-download)など、ページのランタイム機能を宣言している | その公開の前に確認する |

77| アーティファクトを公開共有している | 変更前に会話ごとに 1 回確認する |77| アーティファクトを公開共有している | 変更前に会話ごとに 1 回確認する |

78| [機能フラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにしている | 各アーティファクトの最初の公開前に確認する |

79| 入力したプロンプトではなく、セッション内で実行された[スケジュールタスク](/docs/ja/scheduled-tasks)によって開始されたターンで Claude が公開する | 各アーティファクトの最初の公開前に確認する |78| 入力したプロンプトではなく、セッション内で実行された[スケジュールタスク](/docs/ja/scheduled-tasks)によって開始されたターンで Claude が公開する | 各アーティファクトの最初の公開前に確認する |

80| Claude がユーザーの承認なしではファイルを読み取れない | 公開前に確認する。`Artifact` ツールの許可ルールがあっても、このプロンプトはスキップされない |79| Claude がユーザーの承認なしではファイルを読み取れない | 公開前に確認する。`Artifact` ツールの許可ルールがあっても、このプロンプトはスキップされない |

80| [Manual](/docs/ja/permission-modes) モードまたは `acceptEdits` モードで、Claude がユーザーの承認なしでは編集できないアーティファクトのファイル(Manual モードでのプロジェクトファイルなど)に小さな変更を加える | 変更を公開する前に確認する。ファイルの編集にはユーザーの承認が必要なため、`Artifact` ツールが許可ルールの対象になっていても確認される |

81 81 

82Claude は、セッションの[作業ディレクトリ](/docs/ja/permissions#working-directories)内のファイルと、ページを書き込む一時ディレクトリ内のファイルを確認なしで読み取ります。別のフォルダからプロンプトなしで公開できるようにするには、起動時に [`--add-dir`](/docs/ja/cli-reference#cli-flags) を使用するか、セッション中に `/add-dir` を使用して、そのフォルダを作業ディレクトリとして追加します。82[作業ディレクトリ](/docs/ja/permissions#working-directories)外のファイルをユーザーの承認なしで Claude が読み取れるようにするには、起動時に [`--add-dir`](/docs/ja/cli-reference#cli-flags) を使用するか、セッション中に `/add-dir` を使用して、そのフォルダを作業ディレクトリとして追加します。Claude は、これらのディレクトリ内のファイルと、ページを書き込む一時ディレクトリ内のファイルを、確認なしですでに読み取ります。

83 

84公開のプロンプトに `Also makes 1 edit to that file on disk.` のような文が含まれている場合、Claude はアーティファクトのファイルの変更と公開を 1 つのステップで行います。プロンプトを承認すると、Claude Code はページを公開してから、変更をファイルに書き込みます。

83 85 

84<h2 id="update-an-artifact">86<h2 id="update-an-artifact">

85 アーティファクトを更新する87 アーティファクトを更新する


149* **ネットワークアクセスのないクラウドセッション**:[クラウド環境](/docs/ja/cloud-environments#access-levels) の場合、**None** レベルがこれに該当します。[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) では代わりに分類器が承認できますが、[Cowork](https://claude.com/product/cowork) セッションでは、承認できるのはユーザー本人だけです。151* **ネットワークアクセスのないクラウドセッション**:[クラウド環境](/docs/ja/cloud-environments#access-levels) の場合、**None** レベルがこれに該当します。[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) では代わりに分類器が承認できますが、[Cowork](https://claude.com/product/cowork) セッションでは、承認できるのはユーザー本人だけです。

150* **別の組織の公開アーティファクト**:Claude Code は auto モードであっても、まずユーザーに確認します。`bypassPermissions` モードなど、Claude Code がユーザーに確認できない場合、Claude はそのアーティファクトを読むことができません。Claude がこれらのアーティファクトを読めるのは、[機能フラグの取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching) がオンになっている間だけです。152* **別の組織の公開アーティファクト**:Claude Code は auto モードであっても、まずユーザーに確認します。`bypassPermissions` モードなど、Claude Code がユーザーに確認できない場合、Claude はそのアーティファクトを読むことができません。Claude がこれらのアーティファクトを読めるのは、[機能フラグの取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching) がオンになっている間だけです。

151* **所有者またはネットワーク設定が未確認**:Claude Code がアーティファクトの作成者を確認できない場合、またはクラウドセッションのネットワーク設定を確認できない場合は確認を求めます。ユーザーの承認はその 1 回のリクエストにのみ適用されます。153* **所有者またはネットワーク設定が未確認**:Claude Code がアーティファクトの作成者を確認できない場合、またはクラウドセッションのネットワーク設定を確認できない場合は確認を求めます。ユーザーの承認はその 1 回のリクエストにのみ適用されます。

152* **plan モード、または機能フラグの取得がオフ**:[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) の場合、または [機能フラグの取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching) をオフにしている場合、Claude Code は、組織内の他の人が作成したアーティファクトを Artifact ツールが読む前に確認を求めます。154* **plan モード**:[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) では、Claude Code は、組織内の他の人が作成したアーティファクトを Artifact ツールが読む前に確認を求めます。

153 155 

154Claude が WebFetch でアーティファクトを読む場合も、WebFetch 自体の [プロンプトのルール](/docs/ja/tools-reference#webfetch-tool-behavior) は引き続き適用されます。156Claude が WebFetch でアーティファクトを読む場合も、WebFetch 自体の [プロンプトのルール](/docs/ja/tools-reference#webfetch-tool-behavior) は引き続き適用されます。

155 157 

Details

102[サブエージェント](/docs/ja/sub-agents)は Claude のファイル編集ツールで編集を行いますが、Claude Code は通常、セッションのチェックポイントでこれらの編集をキャプチャしません。巻き戻しがそれらを復元するかどうかは、サブエージェントの実行方法によって異なります:102[サブエージェント](/docs/ja/sub-agents)は Claude のファイル編集ツールで編集を行いますが、Claude Code は通常、セッションのチェックポイントでこれらの編集をキャプチャしません。巻き戻しがそれらを復元するかどうかは、サブエージェントの実行方法によって異なります:

103 103 

104* **フォアグラウンドフォークスキル**:[`context: fork` を持つスキル](/docs/ja/skills#run-skills-in-a-subagent)がフォアグラウンドで実行され、自分のターン中にワーキングツリーを編集するため、巻き戻しは通常どおりその編集を復元します。`background: false` を設定してフォークをフォアグラウンドで実行します。いくつかの状況([スキルページに記載](/docs/ja/skills#run-skills-in-a-subagent))では、この設定に関係なくそこで実行されます。104* **フォアグラウンドフォークスキル**:[`context: fork` を持つスキル](/docs/ja/skills#run-skills-in-a-subagent)がフォアグラウンドで実行され、自分のターン中にワーキングツリーを編集するため、巻き戻しは通常どおりその編集を復元します。`background: false` を設定してフォークをフォアグラウンドで実行します。いくつかの状況([スキルページに記載](/docs/ja/skills#run-skills-in-a-subagent))では、この設定に関係なくそこで実行されます。

105* **その他のサブエージェント**:巻き戻しは編集を復元しません。git を使用してそれらを元に戻してください。これには、バックグラウンドで実行されるフォークスキル(デフォルト)と、バックグラウンド [`/code-review --fix`](/docs/ja/code-review) 実行が含まれます。105* **その他のサブエージェント**:巻き戻しで復元されるのは、会話の中で Claude がすでに編集していたファイルのみです。サブエージェントによるその他のファイルへの編集は残るため、git を使用して元に戻してください。これには、バックグラウンドで実行されるフォークスキル(デフォルト)と、バックグラウンド [`/code-review --fix`](/docs/ja/code-review-local) 実行が含まれます。

106 106 

107<h3 id="external-changes-not-tracked">107<h3 id="external-changes-not-tracked">

108 外部の変更は追跡されません108 外部の変更は追跡されません

Details

64`/web-setup` のウォークスルー(`/web-setup` が保存する内容と削除方法を含む)については、[ターミナルから接続](/docs/ja/web-quickstart#connect-from-your-terminal)を参照してください。64`/web-setup` のウォークスルー(`/web-setup` が保存する内容と削除方法を含む)については、[ターミナルから接続](/docs/ja/web-quickstart#connect-from-your-terminal)を参照してください。

65 65 

66<Note>66<Note>

67 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織、または [HIPAA 設定](/docs/ja/hipaa-setup)が適用されている組織は、`/web-setup` またはその他のクラウドセッション機能を使用できません。67 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織、または [HIPAA 設定](/docs/ja/hipaa-setup)が適用されている組織は、`/web-setup` またはその他のクラウドセッション機能を使用できません。[顧客管理の暗号化キー](https://platform.claude.com/docs/en/manage-claude/cmek)(CMEK)を使用している組織も、クラウドセッションを開始できません。

68</Note>68</Note>

69 69 

70<h3 id="quick-setup-for-team-and-enterprise">70<h3 id="quick-setup-for-team-and-enterprise">

Details

417* MCP サーバー:クラウドスレッドは、claude.ai アカウントのコネクタから MCP ツールを取得します。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サーバーです。すべてのクラウドスレッドは、プロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をクラウドスレッドのタスクとして送信してください。1 つのリポジトリを持つプロジェクトでは、クラウドスレッドはそのリポジトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サーバーも読み込みます。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラウドセッションのルールとコネクタをオフにする設定をリストしています。417* MCP サーバー:クラウドスレッドは、claude.ai アカウントのコネクタから MCP ツールを取得します。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サーバーです。すべてのクラウドスレッドは、プロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をクラウドスレッドのタスクとして送信してください。1 つのリポジトリを持つプロジェクトでは、クラウドスレッドはそのリポジトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サーバーも読み込みます。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラウドセッションのルールとコネクタをオフにする設定をリストしています。

418* コマンドラインツールとパッケージ:環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にインストールします。418* コマンドラインツールとパッケージ:環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にインストールします。

419 419 

420実行中のクラウドスレッドが claude.ai/code でどのコネクタを持っているかを確認するには、スレッドを開き、メッセージボックスの横の **+** メニューから **コネクタ** を選択します。コネクタをそこでオフにすると、そのスレッドから削除され、アカウントのデフォルトとして保存されます。そのため、新しいスレッドと claude.ai チャットは、再度オンにするまでそれなしで開始します。クラウドスレッドは、送信後のメッセージで追加または再接続したコネクタを取得します。420実行中のクラウドスレッドが claude.ai/code でどのコネクタを持っているかを確認するには、スレッドを開き、メッセージボックスの横の **+** メニューから **コネクタ** を選択します。コネクタをそこでオフにすると、そのスレッドから削除され、アカウントのデフォルトとして保存されます。そのため、新しいスレッドと claude.ai チャットは、再度オンにするまでそれなしで開始します。クラウドスレッドは、追加または再接続したコネクタを、次にそのスレッドへメッセージを送信した後に取得します。

421 421 

422<h2 id="project-settings-reference">422<h2 id="project-settings-reference">

423 プロジェクト設定リファレンス423 プロジェクト設定リファレンス

Details

122 122 

123<Steps>123<Steps>

124 <Step title="環境のネットワークシークレットを開く">124 <Step title="環境のネットワークシークレットを開く">

125 [claude.ai/code](https://claude.ai/code) で [環境を編集用に開きます](#configure-your-environment)。**環境を編集** ダイアログで、**ネットワークシークレット** セクションを見つけます。環境に既にあるシークレットが表示され、それぞれが適用されるホストが表示されます。125 [claude.ai/code](https://claude.ai/code) で [環境を編集用に開きます](#configure-your-environment)。**クラウド環境を編集** ダイアログで、**ネットワークシークレット** セクションを見つけます。環境に既にあるシークレットが表示され、それぞれが適用されるホストが表示されます。

126 </Step>126 </Step>

127 127 

128 <Step title="シークレットを追加する">128 <Step title="シークレットを追加する">


559 559 

560`matcher` はフックを `startup` および `resume` イベントに制限し、`$CLAUDE_PROJECT_DIR` はリポジトリルートに解決されるため、フックはセッションの作業ディレクトリに関係なくスクリプトを見つけます。560`matcher` はフックを `startup` および `resume` イベントに制限し、`$CLAUDE_PROJECT_DIR` はリポジトリルートに解決されるため、フックはセッションの作業ディレクトリに関係なくスクリプトを見つけます。

561 561 

562次に、`scripts/install_pkgs.sh` でスクリプトを作成します。クラウドの外では直ちに終了し、依存関係をインストールします。562次に、`scripts/install_pkgs.sh` でスクリプトを作成します。クラウドの外では直ちに終了し、依存関係をインストールします。`package.json`、`package-lock.json`、およびスクリプト自体が前回のインストール成功以降変更されていない間は、`npm install` をスキップします。

563 563 

564```bash theme={null}564```bash theme={null}

565#!/bin/bash565#!/bin/bash


568 exit 0568 exit 0

569fi569fi

570 570 

571npm install571cd "$CLAUDE_PROJECT_DIR" || exit 1

572hashes=node_modules/.install_pkgs.sha256

573 

574if ! sha256sum --check --status "$hashes" 2>/dev/null; then

575 # Delete the old hashes first, so a failed install runs again next time

576 rm -f "$hashes"

577 if npm install; then

578 sha256sum scripts/install_pkgs.sh package.json package-lock.json > "$hashes" || rm -f "$hashes"

579 fi

580fi

581 

582# pip skips requirements that are already satisfied

572pip install -r requirements.txt583pip install -r requirements.txt

573exit 0584exit 0

574```585```

575 586 

576`CLAUDE_CODE_REMOTE` チェックは、インストールをクラウドセッションにスコープするものです。セッション VM の環境は変数を `true` として持ち、ローカルでは決して `true` ではないため、ラップトップではスクリプトは何もインストールする前に終了します。587`CLAUDE_CODE_REMOTE` チェックは、インストールをクラウドセッションにスコープするものです。セッション VM の環境は変数を `true` として持ち、ローカルでは決して `true` ではないため、ラップトップではスクリプトは何もインストールする前に終了します。

577 588 

5782 つのファイルを合わせると、すべてのクラウドセッションは起動時に新しい `npm install` と `pip install` を取得し、ローカルセッションは影響を受けません。589`npm install` が成功したことを確認するには、クラウドセッションを開始し、Claude に `node_modules/.install_pkgs.sha256` を表示するよう依頼します。このファイルには、3 つのファイルそれぞれのハッシュが記載されています。ファイルが存在しない場合は、Claude に `npm install` を実行してエラーを報告するよう依頼してください。

590 

591<Note>

592 `npm install` がワークスペースの `package.json`、`.npmrc`、`postinstall` スクリプトの入力など、他のファイルを読み込む場合は、ハッシュを保存する `sha256sum` コマンドにそれらを追加してください。そうしないと、それらのファイルのいずれかが変更された後も古いパッケージが残ったままになります。

593</Note>

579 594 

580<h4 id="limitations-in-cloud-sessions">595<h4 id="limitations-in-cloud-sessions">

581 クラウドセッションの制限596 クラウドセッションの制限


587* **クラウドのみのスコープなし**:フックはローカルとクラウドセッションの両方で実行されます。ローカル実行をスキップするには、[依存関係インストールスクリプト](#install-dependencies-with-a-sessionstart-hook) のように `CLAUDE_CODE_REMOTE` 環境変数が `true` でない限り早期に終了します。602* **クラウドのみのスコープなし**:フックはローカルとクラウドセッションの両方で実行されます。ローカル実行をスキップするには、[依存関係インストールスクリプト](#install-dependencies-with-a-sessionstart-hook) のように `CLAUDE_CODE_REMOTE` 環境変数が `true` でない限り早期に終了します。

588* **ネットワークアクセスが必要**:インストールコマンドはパッケージレジストリに到達する必要があります。環境が **None** ネットワークアクセスを使用する場合、これらのフックは失敗します。**Trusted** の下の [デフォルト許可リスト](#default-allowed-domains) は npm、PyPI、RubyGems、crates.io をカバーします。603* **ネットワークアクセスが必要**:インストールコマンドはパッケージレジストリに到達する必要があります。環境が **None** ネットワークアクセスを使用する場合、これらのフックは失敗します。**Trusted** の下の [デフォルト許可リスト](#default-allowed-domains) は npm、PyPI、RubyGems、crates.io をカバーします。

589* **プロキシ互換性**:Anthropic ホスト環境では、すべての送信トラフィックは [セキュリティプロキシ](#security-proxy) を通じて渡されます。一部のパッケージマネージャーはこのプロキシで正しく機能しません。Bun は既知の例です。[セルフホスト環境](/docs/ja/self-hosted-environments-deploy#default-deny-egress) では、送信トラフィックは代わりに独自のネットワーク境界を通じて行きます。604* **プロキシ互換性**:Anthropic ホスト環境では、すべての送信トラフィックは [セキュリティプロキシ](#security-proxy) を通じて渡されます。一部のパッケージマネージャーはこのプロキシで正しく機能しません。Bun は既知の例です。[セルフホスト環境](/docs/ja/self-hosted-environments-deploy#default-deny-egress) では、送信トラフィックは代わりに独自のネットワーク境界を通じて行きます。

590* **スタートアップレイテンシを追加**:フックはセッションが開始または再開されるたびに実行されます。[環境キャッシング](#environment-caching) の恩恵を受けるセットアップスクリプトとは異なります。依存関係が既に存在するかどうかをチェックして再インストールを避けることで、インストールスクリプトを高速に保ちます。605* **スタートアップレイテンシを追加**:フックはセッションが開始または再開されるたびに実行されます。[環境キャッシング](#environment-caching) の恩恵を受けるセットアップスクリプトとは異なります。[依存関係インストールスクリプト](#install-dependencies-with-a-sessionstart-hook) のように、既に完了している作業をスキップすることで、インストールスクリプトを高速に保ちます。

591 606 

592ベースイメージをカスタマイズするには、セットアップスクリプトを使用して [提供されたイメージ](#installed-tools) の上にインストールするか、`docker compose` で Claude と一緒にコンテナとして独自のイメージを実行します。ベースイメージ全体を置き換えることはまだサポートされていません。607ベースイメージをカスタマイズするには、セットアップスクリプトを使用して [提供されたイメージ](#installed-tools) の上にインストールするか、`docker compose` で Claude と一緒にコンテナとして独自のイメージを実行します。ベースイメージ全体を置き換えることはまだサポートされていません。

593 608 

code-review.md +87 −384

Details

4 4 

5# Code Review5# Code Review

6 6 

7> マルチエージェント分析を使用してコードベース全体を検査し、ロジックエラー、セキュリティ脆弱性、リグレッションを検出する自動化された PR レビューを設定します7> Code Review で GitHub のプルリクエストのバグを検出します。Claude が各変更をレビューし、結果を検証して、インラインでコメントします。Team および Enterprise プラン向けです

8 8 

9<Note>9Code Review を使用すると、Claude が GitHub リポジトリのプルリクエストをレビューします。複数のエージェントが各変更を周囲のコードとあわせて読み込み、ロジックエラー、セキュリティ脆弱性、壊れたエッジケースなどの問題を探します。検証ステップでは、結果を報告する前にコードと照らし合わせて確認します。

10 Code Review はリサーチプレビュー段階であり、[Team および Enterprise](https://claude.ai/admin-settings/claude-code) サブスクリプションで利用可能です。[Zero Data Retention](/docs/ja/zero-data-retention) が有効になっている組織や [HIPAA 設定](/docs/ja/hipaa-setup)が適用されている組織では利用できず、Anthropic の BAA の対象外です。その他のプランでは、`/code-review` コマンドを使用して[ローカルで差分をレビュー](#review-a-diff-locally)することができます。

11</Note>

12 

13Code Review は GitHub プルリクエストを分析し、コードの問題が見つかった行にインラインコメントとして結果を投稿します。特化したエージェントのフリートがコード変更をコードベース全体のコンテキストで検査し、ロジックエラー、セキュリティ脆弱性、壊れたエッジケース、微妙なリグレッションを探します。

14 

15結果は重大度でタグ付けされ、PR を承認またはブロックしないため、既存のレビューワークフローはそのまま機能します。リポジトリに `CLAUDE.md` または `REVIEW.md` ファイルを追加することで、Claude がフラグを立てる内容をカスタマイズできます。

16 

17Claude を管理サービスではなく独自の CI インフラストラクチャで実行する場合は、[GitHub Actions](/docs/ja/github-actions) または [GitLab CI/CD](/docs/ja/gitlab-ci-cd) を参照してください。自己ホスト型 GitHub インスタンス上のリポジトリについては、[GitHub Enterprise Server](/docs/ja/github-enterprise-server) を参照してください。

18 10 

19このページでは以下をカバーしています:11結果は該当する行へのインラインコメントとして届き、[重大度](/docs/ja/code-review-pull-requests#severity-levels)でランク付けされ、プルリクエストには概要とチェック実行が追加されます。レビューがプルリクエストを承認またはブロックすることはないため、マージの判断はチームに委ねられたままです。

20 12 

21* [レビューの仕組み](#how-reviews-work)13<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=0351c96df9efa3105172eb00a672f130" className="dark:hidden" alt="4 段階のレビューの図。GitHub 上のプルリクエストが、Anthropic インフラストラクチャ上で並行して探索する複数のエージェントに渡されます。検証ステップで偽陽性が除外され、残った結果は重複排除されて重大度でランク付けされ、レビューはインラインコメント、概要、チェック実行を GitHub に投稿します。" width="760" height="300" data-path="images/code-review-pipeline.svg" />

22* [セットアップ](#set-up-code-review)

23* [`@claude review` と `@claude review always` を使用した](#manually-trigger-reviews)レビューの手動トリガー

24* [`CLAUDE.md` と `REVIEW.md` を使用した](#customize-reviews)レビューのカスタマイズ

25* [料金](#pricing)

26* [トラブルシューティング](#troubleshooting)失敗した実行と欠落したコメント

27* [ローカルで差分をレビューする](#review-a-diff-locally) `/code-review` コマンドを使用

28 

29<h2 id="how-reviews-work">

30 レビューの仕組み

31</h2>

32 14 

33管理者が組織の Code Review を[有効にする](#set-up-code-review)と、リポジトリの設定された動作に応じて、PR が開かれたとき、すべてのプッシュ時、または手動でリクエストされたときにレビューがトリガーされます。PR で `@claude review` と[コメントすると](#manually-trigger-reviews)、任意のモードでレビューが開始されます。15<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline-dark.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=9cf26bde98f4e999d0d9ff5bf5bdff40" className="hidden dark:block" alt="4 段階のレビューの図。GitHub 上のプルリクエストが、Anthropic インフラストラクチャ上で並行して探索する複数のエージェントに渡されます。検証ステップで偽陽性が除外され、残った結果は重複排除されて重大度でランク付けされ、レビューはインラインコメント、概要、チェック実行を GitHub に投稿します。" width="760" height="300" data-path="images/code-review-pipeline-dark.svg" />

34 

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

36 

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

38 

39<h3 id="severity-levels">

40 重大度レベル

41</h3>

42 

43各結果は重大度レベルでタグ付けされます:

44 

45| マーカー | 重大度 | 意味 |

46| :- | :- | :- |

47| 🔴 | Important | マージ前に修正すべきバグ |

48| 🟡 | Nit | 軽微な問題、修正する価値があるがブロッキングではない |

49| 🟣 | Pre-existing | コードベースに存在するが、この PR で導入されなかったバグ |

50 

51結果には、展開可能な **Why this was flagged** セクションが含まれており、Claude がなぜ問題をフラグ立てしたのか、どのように問題を検証したのかを理解するために展開できます。

52 

53<h3 id="rate-and-reply-to-findings">

54 結果に対する評価と返信

55</h3>

56 

57Claude からの各レビューコメントには、👍 と 👎 が既に添付されているため、GitHub UI で両方のボタンがワンクリック評価のために表示されます。結果が有用だった場合は 👍 をクリックし、間違っていたか騒々しかった場合は 👎 をクリックしてください。Anthropic は PR がマージされた後にリアクションカウントを収集し、それを使用してレビュアーをチューニングします。リアクションは再レビューをトリガーしたり、PR 上の何かを変更したりしません。

58 

59インラインコメントに返信しても、Claude が応答したり PR を更新したりするようにプロンプトされません。結果に対処するには、コードを修正してプッシュしてください。PR がプッシュトリガーレビューにサブスクライブされている場合、次の実行は問題が修正されるとスレッドを解決します。プッシュせずに新しいレビューをリクエストするには、[トップレベルの PR コメント](#manually-trigger-reviews)として `@claude review` とコメントしてください。

60 

61結果を却下するにはコード変更なしでスレッドを解決してください。返信しても却下されません。

62 

63<h3 id="check-run-output">

64 チェック実行出力

65</h3>

66 

67インラインレビューコメントに加えて、各レビューは CI チェックと並んで表示される **Claude Code Review** チェック実行を生成します。その **Details** リンクを展開して、すべての結果の概要を 1 か所で確認でき、重大度でソートされています:

68 

69| 重大度 | ファイル:行 | 問題 |

70| - | - | - |

71| 🔴 Important | `src/auth/session.ts:142` | トークン更新がログアウトと競合し、古いセッションがアクティブなままになる |

72| 🟡 Nit | `src/auth/session.ts:88` | `parseExpiry` は不正な形式の入力で黙って 0 を返す |

73 

74各結果は、**Files changed** タブの注釈としても表示され、関連する diff 行に直接マークされます。Important の結果は赤いマーカーで、nit は黄色の警告で、既存のバグは灰色の通知でレンダリングされます。注釈と重大度テーブルはインラインレビューコメントとは独立してチェック実行に書き込まれるため、移動した行のインラインコメントが GitHub に拒否された場合でも利用可能なままです。

75 

76チェック実行は常に中立的な結論で完了するため、ブランチ保護ルールを通じてマージをブロックすることはありません。Code Review の結果に基づいてマージをゲートしたい場合は、チェック実行出力から重大度の内訳を読み取り、独自の CI で使用してください。Details テキストの最後の行は、ワークフローが `gh` と jq で解析できるマシン可読コメントです。コミットのチェック実行を一覧表示するには、`gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'` を使用して、`Claude Code Review` 実行の `id` を取得します。`OWNER`、`REPO`、`CHECK_RUN_ID` をリポジトリ所有者、リポジトリ名、およびそのID に置き換えます:

77 

78```bash theme={null}

79gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \

80 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

81```

82 

83これは重大度ごとのカウントを含む JSON オブジェクトを返します。例えば `{"normal": 2, "nit": 1, "pre_existing": 0}` です。`normal` キーは Important の結果のカウントを保持します。ゼロ以外の値は、Claude がマージ前に修正する価値のあるバグを少なくとも 1 つ見つけたことを意味します。

84 

85<h3 id="what-code-review-checks">

86 Code Review がチェックする内容

87</h3>

88 

89デフォルトでは、Code Review は正確性に焦点を当てています:フォーマット設定の好みやテストカバレッジの欠落ではなく、本番環境を壊すバグです。リポジトリに[ガイダンスファイルを追加](#customize-reviews)することで、チェック内容を拡張できます。

90 

91<h2 id="set-up-code-review">

92 Code Review のセットアップ

93</h2>

94 

95管理者が組織に対して Code Review を 1 回有効にし、含めるリポジトリを選択します。

96 

97<Steps>

98 <Step title="Claude Code 管理設定を開く">

99 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) にアクセスして、Code Review セクションを見つけます。Claude 組織での Owner または Primary Owner ロールと GitHub 組織に GitHub Apps をインストールする権限が必要です。

100 </Step>

101 

102 <Step title="セットアップを開始する">

103 **Setup** をクリックします。これにより GitHub App インストールフローが開始されます。

104 </Step>

105 

106 <Step title="Claude GitHub App をインストールする">

107 プロンプトに従って Claude GitHub App をインストールします。レビュー対象のリポジトリを所有する GitHub 組織を選択し、アプリがアクセスできるリポジトリを選択して、リクエストされた権限を承認します。

108 

109 Claude が pull request をレビューするには、アプリの読み取りアクセスを通じてリポジトリコンテンツを読み取り、その書き込みアクセスを通じて pull requests とチェックに対してコメントと [check run](#check-run-output) を投稿します。インストール中に、[GitHub Actions](/docs/ja/github-actions) などの他の Claude 機能によって共有される、より広い権限セットを付与します。詳細なリストについては [GitHub App permissions](/docs/ja/github-actions#github-app-permissions) を参照してください。

110 </Step>

111 

112 <Step title="リポジトリを選択する">

113 Code Review を有効にするリポジトリを選択します。リポジトリが表示されない場合は、インストール中に Claude GitHub App にアクセス権を付与したことを確認してください。後でリポジトリを追加できます。

114 </Step>

115 

116 <Step title="リポジトリごとにレビュートリガーを設定する">

117 セットアップが完了すると、Code Review セクションはリポジトリをテーブルに表示します。各リポジトリについて、**Review Behavior** ドロップダウンを使用してレビューが実行されるタイミングを選択します:

118 

119 * **Once after PR creation**: PR が開かれるか ready for review としてマークされたときにレビューが 1 回実行されます

120 * **After every push**: PR ブランチへのすべてのプッシュでレビューが実行され、PR が進化するにつれて新しい問題をキャッチし、フラグが立てられた問題を修正するとスレッドを自動解決します

121 * **Manual**: PR を開くか PR ブランチにプッシュしてもレビューは開始されません。[`@claude review`](#manually-trigger-reviews) とコメントしてレビューをリクエストするか、`@claude review always` とコメントして、その後のプッシュでレビューに PR をサブスクライブします

122 

123 どのオプションを選択しても、Claude は [fork からの pull request](#review-pull-requests-from-forks) をレビューするのは、誰かが `@claude review` とコメントしたときだけです。

124 

125 すべてのプッシュでレビューすると、最も多くのレビューが実行され、最もコストがかかります。Manual モードは、特定の PR をレビューにオプトインしたい高トラフィックリポジトリ、または PR が ready になったら PR のレビューを開始したい場合に便利です。

126 </Step>

127</Steps>

128 

129リポジトリテーブルは、最近のアクティビティに基づいて各リポジトリの平均レビューコストも表示します。行アクションメニューを使用して、リポジトリごとに Code Review をオンまたはオフにするか、リポジトリを完全に削除します。

130 

131セットアップを確認するには、テスト PR を開きます。自動トリガーを選択した場合、**Claude Code Review** という名前のチェック実行が数分以内に表示されます。Manual を選択した場合は、PR で `@claude review` とコメントして最初のレビューを開始します。チェック実行が表示されない場合は、リポジトリが管理設定に一覧表示されていることと、Claude GitHub App がアクセス権を持っていることを確認してください。

132 

133<h2 id="manually-trigger-reviews">

134 レビューを手動でトリガーする

135</h2>

136 

137コメントコマンドはオンデマンドでレビューを開始します。リポジトリの設定されたトリガーに関係なく機能するため、Manual モードで特定の PR をレビューにオプトインするか、他のモードで即座に再レビューを取得するために使用できます。

138 

139| コマンド | 実行内容 |

140| :- | :- |

141| `@claude review` | サブスクライブせずに単一のレビューを開始します |

142| `@claude review always` | レビューを開始し、その後のプッシュでレビューがトリガーされるように PR をサブスクライブします |

143| `@claude review once` | `@claude review` と同じです。サブスクライブせずに単一のレビューを開始します |

144 

145Manual モードに設定されたリポジトリの高優先度 PR など、PR への後続のすべてのプッシュで新しいレビューを開始したい場合は、`@claude review always` を使用します。ベアコマンドは PR をサブスクライブしないため、後続のプッシュがレビューをトリガーするかどうかを変更せずに、1 回限りの 2 番目の意見をリクエストできます。

146 16 

147<Note>17<Note>

148 2026 年 7 月の更新前は、`@claude review` は PR を push トリガーレビューにサブスクライブしていました。その動作に依存していた場合は、代わりに `@claude review always` をコメントしてください。`@claude review once` は引き続き機能し、ベアコマンドと同じように動作します。18 Code Review は AI を使用してコードをレビューするため、バグ、セキュリティ脆弱性、その他の問題を見逃す可能性があります。結果のないレビューは、コードにエラーがないことや安全であることを意味するものではありません。

149</Note>19</Note>

150 20 

151これらのコマンドのいずれかでレビューをトリガーするには:21<span id="review-a-diff-locally" />

152 

153* トップレベルの PR コメントとして投稿し、diff 行のインラインコメントではない

154* コメントの開始にコマンドを配置し、`once` または `always` をコマンドの残りの部分と同じ行に配置します

155* リポジトリへの書き込み、メンテナンス、または管理者権限を持つ必要があります

156* PR は開いている必要があります

157 

158自動トリガーとは異なり、手動トリガーはドラフト PR で実行されます。明示的なリクエストはドラフトステータスに関係なく、今すぐレビューが必要であることを示すためです。

159 

160その PR でレビューが既に実行されている場合、リクエストは進行中のレビューが完了するまでキューに入ります。PR のチェック実行を通じて進捗を監視できます。

161 

162<h3 id="review-pull-requests-from-forks">

163 フォークからのプルリクエストをレビューする

164</h3>

165 

166Claude はリポジトリの **Review Behavior** 設定に関係なく、フォークからのプルリクエストを自動的にレビューしません。開始するには、プルリクエストに `@claude review` をコメントしてください。[コメントコマンドの要件](#manually-trigger-reviews)は引き続き適用され、必要な書き込みアクセスはフォークではなくベースリポジトリへのアクセスです。

167 22 

168フォークプルリクエストの別のレビューを取得するには、新しい `@claude review` コメントを投稿してください。`@claude review always` も機能しますが、後続のプッシュでプルリクエストをレビューにサブスクライブしません。フォークプルリクエストでレビューを開始するのはコメントコマンド以外の何もありません:23Code Review をオンにするには、Claude 組織の Owner が [Code Review のセットアップ](/docs/ja/code-review-setup)の手順に従います。Claude はこのサービスを使わずにコードをレビューすることもできます。任意のプランで Claude Code セッションから [`/code-review`](/docs/ja/code-review-local) を実行するか、[すべてのオプションを比較](#compare-ways-to-get-a-review)してください。

169 24 

170* チェック実行で **Re-run** をクリックしてもレビューは開始されません25<h2 id="availability">

171* 新しいコミットをプッシュしてもレビューは開始されません。**After every push** に設定されたリポジトリでも同様です26 利用可能性

172 

173<h2 id="customize-reviews">

174 レビューをカスタマイズする

175</h2>27</h2>

176 28 

177Code Review はリポジトリから 2 つのファイルを読み取り、フラグを立てる内容をガイドします。これらは、リビューにどの程度強く影響するかが異なります:29Code Review をセットアップする前に、組織が条件を満たしていることを確認してください:

178 

179* **`CLAUDE.md`**: Claude Code がすべてのタスク(レビューだけではなく)に使用する共有プロジェクト指示。Code Review はそれをプロジェクトコンテキストとして読み取り、新しく導入された違反を nit としてフラグ立てします。

180* **`REVIEW.md`**: レビューのみのガイダンス、レビューパイプラインの検出と検証を行うエージェントに与えられ、結果をランク付けして報告するエージェントによって参照されます。チームがフラグを立てたいもの、どの重大度で、結果がどのように報告されるかを指定するために使用します。

181 

182<h3 id="claude-md">

183 CLAUDE.md

184</h3>

185 

186Code Review はリポジトリの `CLAUDE.md` ファイルを読み取り、新しく導入された違反を[nit レベル](#severity-levels)の結果として扱います。これは双方向に機能します:PR が `CLAUDE.md` ステートメントを古くする方法でコードを変更する場合、Claude はドキュメントを更新する必要があることをフラグ立てします。

187 

188Claude はディレクトリ階層のすべてのレベルで `CLAUDE.md` ファイルを読み取るため、サブディレクトリの `CLAUDE.md` のルールはそのパスの下のファイルにのみ適用されます。`CLAUDE.md` の仕組みの詳細については、[memory ドキュメント](/docs/ja/memory)を参照してください。

189 30 

190一般的な Claude Code セッションに適用したくないレビュー固有のガイダンスについては、代わりに[`REVIEW.md`](#review-md)を使用します。31* **プラン**:[Team および Enterprise](/docs/ja/feature-availability)

191 32* **コードホスト**:GitHub でホストされているリポジトリ。[GitHub Enterprise Server](/docs/ja/github-enterprise-server) およびデータレジデンシー付きの GitHub Enterprise Cloud を含みます。データレジデンシーの場合は、Owner が [GitHub Enterprise Server の管理者セットアップ](/docs/ja/github-enterprise-server#admin-setup)の手順に従い、エンタープライズの `ghe.com` ホスト名を入力します。

192<h3 id="review-md">33* **データ保持**:Code Review は、[Zero Data Retention](/docs/ja/zero-data-retention) が有効になっている組織や [HIPAA 設定](/docs/ja/hipaa-setup)が適用されている組織では利用できず、Anthropic の Business Associate Agreement(BAA)の対象外です。

193 REVIEW\.md34* **暗号化キー**:Code Review は、顧客管理の暗号化キー(CMEK)を使用する組織ではまだ利用できません。

194</h3>35* **クラウドプロバイダー**:開発者が Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を通じて Claude Code を使用している場合でも、これらのいずれかのプランの Claude 組織が必要です

195 36 

196`REVIEW.md` はリポジトリルートのファイルで、Code Review をリポジトリに合わせて調整します。レビューパイプラインの結果を検出および検証するエージェントはその内容をリポジトリのレビュー指示として受け取り、Code Review のデフォルトレビューガイダンスと並行して、結果をランク付けして報告するエージェントはそれを参照してから重大度を決定し、レビューを作成します。37<h2 id="set-up-and-use-code-review">

197 38 Code Review のセットアップと使用

198フラグを立てたいルールを `REVIEW.md` に直接配置します。

199 

200<h4 id="what-you-can-tune">

201 チューニング可能な内容

202</h4>

203 

204`REVIEW.md` はフリーフォーム markdown であるため、レビュー指示として表現できるものはすべてスコープ内です。以下のパターンは実際に最も影響があります。

205 

206**重大度**: リポジトリの 🔴 Important の意味を再定義します。デフォルトのキャリブレーションは本番コードをターゲットにしています。ドキュメントリポジトリ、設定リポジトリ、またはプロトタイプは、はるかに狭い定義が必要な場合があります。Important である結果のクラスと、最大でも Nit である結果のクラスを明示的に述べます。別の方向にエスカレートすることもできます。例えば、デフォルトの nit ではなく、`CLAUDE.md` 違反を Important として扱う場合です。

207 

208**Nit ボリューム**: 単一のレビューが投稿する 🟡 Nit コメントの数をキャップします。散文と設定ファイルは永遠に磨くことができます。「最大 5 つの nit を報告し、残りを概要のカウントとして言及する」というようなキャップは、レビューを実行可能に保ちます。

209 

210**スキップルール**: Claude が結果を投稿しないべきパス、ブランチパターン、結果カテゴリを一覧表示します。一般的な候補は、生成されたコード、ロックファイル、ベンダーされた依存関係、マシン作成ブランチ、および linting やスペルチェックなど CI が既に実装しているものです。完全な精査を保証しないが何らかのレビューを保証するパスについては、完全にスキップするのではなく、より高いバーを設定します:「`scripts/` では、ほぼ確実で重大な場合のみ報告します」。

211 

212**リポジトリ固有のチェック**: すべての PR でフラグを立てたいルールを追加します。例えば「新しい API ルートには統合テストが必要」。`REVIEW.md` はレビューパイプラインのすべての検出および検証エージェントに直接到達するため、これらは長い `CLAUDE.md` の同じルールよりも確実に着地します。

213 

214**検証バー**: 結果クラスが投稿される前に証拠を要求します。例えば「動作クレームは命名からの推論ではなく、ソースの `file:line` 引用が必要」は、そうでなければ著者に往復を費やさせる偽陽性を削減します。

215 

216**再レビュー収束**: PR が既にレビューされている場合、Claude がどのように動作するかを伝えます。「最初のレビュー後、新しい nit を抑制し、Important の結果のみを投稿する」というようなルールは、1 行の修正がスタイルだけで 7 ラウンド目に到達するのを防ぎます。

217 

218**概要の形状**: レビュー本文が `2 factual, 4 style` のような 1 行のタリーで開くことを要求し、その場合は「ファクチュアルな問題なし」で始めることを要求します。著者は詳細の前に作業の形状を知りたいです。

219 

220<h4 id="example">

221 例

222</h4>

223 

224この `REVIEW.md` はバックエンドサービスの重大度を再キャリブレーションし、nit をキャップし、生成されたファイルをスキップし、リポジトリ固有のチェックを追加します。

225 

226```markdown theme={null}

227# レビュー指示

228 

229## ここで Important が意味するもの

230 

231Important は、動作を壊す、データをリークする、またはロールバックをブロックする結果のために予約します:不正なロジック、スコープされていないデータベースクエリ、ログまたはエラーメッセージの PII、および後方互換性のないマイグレーション。スタイル、命名、リファクタリング提案は最大でも Nit です。

232 

233## Nit をキャップする

234 

235レビューごとに最大 5 つの Nit を報告します。さらに見つけた場合は、インラインで投稿する代わりに、概要で「plus N similar items」と言います。見つけたすべてが Nit の場合、概要を「No blocking issues」で始めます。

236 

237## 報告しない

238 

239- CI が既に実装しているもの:lint、フォーマット、型エラー

240- `src/gen/` の下の生成されたファイルと任意の `*.lock` ファイル

241- 本番ルールを意図的に違反するテストのみのコード

242 

243## 常にチェック

244 

245- 新しい API ルートには統合テストがある

246- ログ行にメールアドレス、ユーザー ID、またはリクエスト本文が含まれていない

247- データベースクエリは呼び出し元のテナントにスコープされている

248```

249 

250<h4 id="keep-it-focused">

251 フォーカスを保つ

252</h4>

253 

254長さはコストがあります:長い `REVIEW.md` は最も重要なルールを薄めます。レビュー動作を変更する指示に保ち、一般的なプロジェクトコンテキストは `CLAUDE.md` に残します。

255 

256<h2 id="view-usage">

257 使用状況を表示する

258</h2>39</h2>

259 40 

260[claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) にアクセスして、組織全体の Code Review アクティビティを確認します。ダッシュボードは以下を表示します:41<span id="set-up-code-review" />

261 

262| セクション | 表示内容 |

263| :- | :- |

264| PRs reviewed | 選択した時間範囲でレビューされたプルリクエストの日次カウント |

265| Code Review cost | 今月これまでの Code Review の支出 |

266| Feedback | 開発者が問題に対処したため自動解決されたレビューコメントのカウント |

267| Repository breakdown | リポジトリごとのレビューされた PR、解決されたコメント、レビュー実行のカウント(推定コストと PR ごとのビューを含む) |

268 

269Code Review cost カードに金額が表示されるのは、当月が選択されている場合のみです。アナリティクスのコスト数値は請求書と異なる場合があります。Repository breakdown のコストは割引やクレジットを適用する前の定価で推定されており、Claude がプルリクエストに投稿したレビューのみが対象です。請求書に正確な支出については、Anthropic の請求書を参照してください。

270 

271<h2 id="pricing">

272 料金

273</h2>

274 

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

276 

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

278 

279* **PR 作成後に 1 回**: PR ごとに 1 回実行されます

280* **すべてのプッシュ後**: 各プッシュで実行され、プッシュ数によってコストが乗算されます

281* **手動**: オープンまたはプッシュ時にレビューは実行されないため、コストはユーザーがリクエストしたレビューからのみ発生します

282 

283PR 作成後に 1 回または手動モードでは、`@claude review always` とコメントすると [PR がプッシュトリガーレビューにオプトインされ](#manually-trigger-reviews)、そのコメント後のプッシュごとに追加コストが発生します。すべてのプッシュ後モードでは、プッシュは既にレビューをトリガーするため、サブスクリプションはプッシュごとのコストを変更しません。`@claude review` とコメントすると、将来のプッシュにサブスクライブせずに単一のレビューが実行されます。Claude は [フォークからのプルリクエスト](#review-pull-requests-from-forks) をレビューするのは、ユーザーが `@claude review` とコメントした場合のみであるため、フォークプルリクエストはどのモードでもプッシュごとのコストを発生させません。

284 42 

285組織が他の Claude Code 機能に Amazon Bedrock または Google Cloud の Agent Platform を使用しているかどうかに関わらず、コストは Anthropic の請求書に表示されます。Code Review の月間支出上限を設定するには、[claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) にアクセスして Claude Code Review サービスの制限を設定してください。43<span id="pricing" />

286 44 

287支出を監視するには、[分析ダッシュボード](#view-usage) を使用してください。45<span id="manually-trigger-reviews" />

288 46 

289<h2 id="troubleshooting">47<span id="customize-reviews" />

290 トラブルシューティング

291</h2>

292 

293レビュー実行はベストエフォートであり、失敗した実行が PR をブロックすることはありません。Code Review は中断されたレビューの一部を自動的に再試行します。このセクションでは、レビューを再度実行する方法と、チェック実行が報告する問題が見つからない場合に確認する場所について説明します。

294 

295<h3 id="retrigger-a-failed-or-timed-out-review">

296 失敗またはタイムアウトしたレビューを再トリガーする

297</h3>

298 48 

299レビューが失敗するか時間制限を超える場合、チェック実行は **Code review failed** または **Code review timed out** などのタイトルで完了します。結論は依然として中立的であるため、マージをブロックするものはありません。チェック実行の概要に新しいレビューがコミットに対して自動的にキューに入れられたと記載されていない限り、レビューを自分で再度実行してください。49<span id="troubleshooting" />

300 50 

301レビューを再度実行するには、PR で `@claude review` とコメントしてください。これは PR を今後のプッシュにサブスクライブせずに新しいレビューを開始します。PR が [フォークから](#review-pull-requests-from-forks) のものでない場合、GitHub の Checks タブの **Claude Code Review** チェックで **Re-run** をクリックすることもできます。再実行も PR をサブスクライブせずに新しいレビューを開始します。51目的に応じたページを選んでください:

302 52 

303<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">53<CardGroup cols={2}>

304 レビューが実行されず、PR に予算に関するメッセージが表示される54 <Card title="Code Review をセットアップする" icon="toggle-on" href="/docs/ja/code-review-setup">

305</h3>55 要件を確認し、Claude GitHub App をインストールして、リポジトリ、レビューレベル、レビューを実行するタイミングを選択します

306 56 </Card>

307組織の Code Review の月次支出上限に達した場合、または使用クレジットの残高を使い切った場合、Code Review はレビューをスキップし、PR に単一のコメントを投稿します。コメントとチェック実行カードの両方に原因が示され、管理者が問題を解決するための管理ページへのリンクが記載されます:

308 57 

309* **支出上限に達した場合**: レビューは次の請求期間の開始時に再開されるか、管理者が [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) で上限を引き上げるとすぐに再開されます58 <Card title="Code Review をカスタマイズする" icon="sliders" href="/docs/ja/code-review-customize">

310* **使用クレジットを使い切った場合**: 管理者が [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) で [使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を追加すると、レビューが再開されます59 リポジトリ内の `REVIEW.md` と `CLAUDE.md` ファイルで、指摘される内容を調整します

60 </Card>

311 61 

312<h3 id="find-issues-that-aren’t-showing-as-inline-comments">62 <Card title="プルリクエストでレビューを読み、リクエストする" icon="code-pull-request" href="/docs/ja/code-review-pull-requests">

313 インラインコメントとして表示されていない問題を見つける63 結果とその重大度を読み、コメントで再度レビューをリクエストします

314</h3>64 </Card>

315 65 

316チェック実行タイトルが問題が見つかったと言っているが、diff にインラインレビューコメントが表示されない場合は、結果が表示されるこれらの他の場所を確認してください:66 <Card title="Code Review のトラブルシューティング" icon="wrench" href="/docs/ja/code-review-troubleshooting">

67 開始されなかったレビュー、失敗したレビュー、予算のためにスキップされたレビューを修正します

68 </Card>

317 69 

318* **チェック実行 Details**: Checks タブの Claude Code Review チェックの横にある **Details** をクリックします。重大度テーブルは、インラインコメントが受け入れられたかどうかに関係なく、ファイル、行、概要を含むすべての結果を一覧表示します。70 <Card title="Code Review のコストと使用状況" icon="chart-line" href="/docs/ja/code-review-costs">

319* **Files changed 注釈**: PR の **Files changed** タブを開きます。結果はレビューコメントとは別に、diff 行に直接添付された注釈としてレンダリングされます。71 レビューの課金方法の確認、支出の見積もり、月間支出上限の設定、レビューアクティビティの追跡を行います

320* **レビュー本文**: レビューが実行されている間に PR にプッシュした場合、一部の結果は現在の diff に存在しなくなった行を参照する場合があります。これらは、インラインコメントではなく、レビュー本文テキストの **Additional findings** 見出しの下に表示されます。72 </Card>

73</CardGroup>

321 74 

322<h2 id="review-a-diff-locally">75<h2 id="how-reviews-work">

323 ローカルで差分をレビューする76 レビューの仕組み

324</h2>77</h2>

325 78 

326[`/code-review` コマンド](/docs/ja/commands)はターミナルで差分をレビューし、GitHub App をインストールせずに実行します。正確性バグを報告します。モデルと effort レベルによっては、レビューは再利用、簡素化、効率化のクリーンアップも対象にします。79<span id="what-code-review-checks" />

327 

328`/review` は `/code-review` のエイリアスです。v2.1.223 より前は、GitHub プルリクエストの単一パス読み取り専用レビューを実行する別のコマンドでした。

329 

330<Steps>

331 <Step title="/code-review を実行する">

332 作業しているセッションから、コマンドを実行します:

333 

334 ```text theme={null}

335 /code-review

336 ```

337 

338 ブランチのアップストリームより先のコミットと未コミット変更をレビューするため、レポートするものがあるようにブランチまたはワーキングツリーで作業する必要があります。別のものをレビューするには、ターゲットを渡します:ファイルパス、PR 番号、ブランチ名、または `main...my-feature` などの ref 範囲です。

339 

340 フラグを追加することもできます:

341 

342 * `--fix`:レビュー後に結果をワーキングツリーに適用します

343 * `--comment`:GitHub プルリクエストにインラインコメントとして結果を投稿するか、GitLab マージリクエストに単一のノートとして投稿します

344 * `--post`:`github.com` プルリクエストの `ultra` クラウドレビューで、起動ダイアログで PR に結果を投稿することを事前選択します。[プルリクエストに結果を投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)を参照してください。Claude Code v2.1.227 以降が必要です

345 * `--max-findings <n>`、`--max-findings all`、または `--max-findings default`:レビューの通常の上限の代わりに、最大 `n` 件の結果を報告します。`all` を指定するとすべての結果を報告します。以降のレビューでは、`--max-findings default` を渡すまで、入力した値が再利用されます。Claude Code v2.1.288 以降が必要です

346 

347 GitLab マージリクエストに `--comment` を渡すと、Claude Code は GitLab の `glab` CLI を通じて結果を投稿します。Claude Code v2.1.257 以降が必要です。`glab` がインストールされていない場合、Claude はターミナルに結果を出力します。

348 80 

349 マージリクエストを URL または `!123` 参照として渡します。Claude Code は、チェックアウトのオリジンが `gitlab.com` 上にある場合にのみ、ベアな番号またはブランチ名をマージリクエストとして扱います。自己管理 GitLab インスタンスでは、URL または `!123` 形式を渡します。81デフォルトでは、Code Review は正確性に焦点を当てています:フォーマット設定の好みやテストカバレッジの欠落ではなく、本番環境を壊すバグです。指摘する内容を変更するには、リポジトリに[ガイダンスファイルを追加](/docs/ja/code-review-customize)します。

350 </Step>

351 82 

352 <Step title="作業を続ける">83レビューは Anthropic インフラストラクチャ上で 4 つの段階で実行されます:

353 レビューは独自のコンテキストウィンドウを持つバックグラウンド[サブエージェント](/docs/ja/sub-agents)として実行されるため、会話を埋めません。結果はレビューが完了したときに会話に到着します。

354 </Step>

355 84 

356 <Step title="結果に対応する">851. **検出**:複数のエージェントが差分と周囲のコードを並行して検査します。

357 Claude にレビューが見つけたものを修正するよう依頼します。`--fix` または `--comment` を渡した場合、レビューはすでに結果を適用または投稿しています。862. **検証**:検証ステップが候補となる結果をコードと照らし合わせて確認し、偽陽性を除外します。

358 </Step>873. **ランク付け**:残った結果は重複排除され、重大度でランク付けされます。

359</Steps>884. **投稿**:レビューがプルリクエストに結果を投稿します。

360 89 

361Claude は以下の両方の実行で、ホストアプリケーションが結果リストをリクエストした場合でも、返信のテキストとして結果を報告します:90各レビューはプルリクエストに以下を残します:

362 91 

363* ターミナルセッション。ここで `/code-review` は[フォークされたサブエージェント](/docs/ja/skills#run-skills-in-a-subagent)としてレビューを実行します92* **結果**:該当する行へのインラインコメントと、レビュー本文の概要

364* テキストまたは JSON 出力を含む `-p` 実行93* **チェック実行**:**Claude Code Review** という名前で、結果はその[詳細](/docs/ja/code-review-pull-requests#check-run-output)に一覧表示されます。チェック実行が失敗として完了することはありません。

94* **何も見つからなかった場合**:チェック実行のタイトルは **Code review found no issues** となり、Claude は同じ短いメモをプルリクエストに投稿します

365 95 

366[デスクトップアプリ](/docs/ja/desktop#review-your-code)などの結果リストをリクエストするホストアプリケーションでは、Claude は[`ReportFindings` ツール](/docs/ja/tools-reference)を通じてレビューの結果を報告します。Claude Code は結果を結果リストとしてレンダリングし、各エントリはファイルの場所、1 文の要約、および結果が持つ場合は `correctness` などのカテゴリタグを表示します。ホストリクエストはすべての effort レベルで適用され、Claude Code v2.1.218 以降が必要です。96Code Review はレビューを実行する Claude モデルを選択し、その管理設定にモデルの選択肢はありません。レビューの徹底度を上げたり下げたりするには、[レビューレベル](#review-levels)を変更します。

367 97 

368Claude が後でセッションで報告された結果を修正すると、それらを再度報告し、Claude Code は更新された結果リストの各結果を修正済み、スキップ済み、または変更不要としてマークします。98Owner が Code Review をオンにすると、各リポジトリに[レビューを実行するタイミング](/docs/ja/code-review-setup#set-when-reviews-run)の設定が用意されます:プルリクエストが開かれたときに 1 回、プッシュのたび、またはリクエスト時のみです。どの設定であっても、リポジトリへの書き込みアクセス権を持つユーザーは、プルリクエストに `@claude review` とコメントして[レビューを開始](/docs/ja/code-review-pull-requests#comment-commands)できます。

369 99 

370<h3 id="what-the-review-reads-and-edits">100<h3 id="review-levels">

371 レビューが読み取り、編集するもの101 レビューレベル

372</h3>102</h3>

373 103 

374レビューは任意の Claude Code セッションのように `CLAUDE.md` に従いますが、[`REVIEW.md`](#review-md)は読み取りません。バックグラウンドレビューはその `--fix` 編集をセッションの[チェックポイント](/docs/ja/checkpointing#subagent-edits-not-restored)の外で適用するため、`/rewind` はそれらを元に戻しません。git を使用してそれらを戻します。レビューが[フォアグラウンドで実行](#run-in-the-foreground)される場合、独自のターン中にワーキングツリーを編集するため、`/rewind` は通常どおりその編集を復元します。104レビューレベルは各レビューの徹底度を設定し、徹底したレビューほどコストが高くなります:

375 105 

376<h3 id="tune-effort-and-arguments">106* **Quick**:軽めのチェックです。最も速く、コストも最も低いレベルです。

377 努力とアーギュメントを調整する107* **Standard**:深さ、速度、コストのバランスが取れています。デフォルトのレベルです。

378</h3>108* **Deep**:最も徹底したチェックです。最も時間がかかり、コストも最も高くなります。

379 

380[effort レベル](/docs/ja/model-config#adjust-effort-level)を渡して、カバレッジと信頼度をトレードオフします。`low` では、レビューは最も確信している結果を報告するため、偽陽性が少なくなります。`medium` から `max` では、レビューはカバレッジを広げます。

381 

382レベルを入力しない場合、レビューは以前のセッションでも、入力した `low` から `max` の最後のレベルを再利用し、Claude Code は `Reusing high effort, the level you typed last time` などの通知を表示します。`/code-review high` のようにレベルを入力して、後の実行が再利用するものを変更します。非対話型 `-p` 実行で渡すレベルはそれを更新しません。`ultra` は記憶されたレベルを更新も使用もしません。レベルを入力したことがない場合、レビューはセッションの現在の努力を使用します。v2.1.223 より前は、レベルのない `/code-review` は常にセッションの現在の努力を使用していました。

383 

384努力レベルとフラグの後、Claude Code は行の残りを 2 つの方法のいずれかで読み取ります:

385 

386* **`ultra` なし**:残りのすべてはレビューターゲットです。別のコマンド名で始まる場合でも同様です。`/code-review /fix-issue 123` は `/fix-issue 123` をターゲットテキストとしてレビューし、`/fix-issue` を 2 番目の[スタックされたスキル](/docs/ja/skills#pass-arguments-to-skills)として読み込みません。v2.1.218 より前は、`/code-review` の後にスタックされたコマンドは独自のスキルとして展開されました。

387* **`ultra` あり**:Claude Code は単一の単語をベースブランチまたは PR 番号として読み取り、ブランチまたは PR に名前を付けない長いテキストを[レビューに添付されたノート](/docs/ja/ultrareview#pass-a-request-in-plain-words)に変換します。`/code-review ultra check my auth changes` は現在のブランチをレビューし、Claude は結果をノートに関連付けます。

388 

389<h3 id="run-in-the-foreground">

390 フォアグラウンドで実行する

391</h3>

392 

393レビューはデフォルトでバックグラウンドで実行されます。v2.1.218 より前は、会話内で実行されました。以下のような場合はフォアグラウンドで実行されます:

394 109 

395* 前のレビューがまだ進行中に `/code-review` を再度実行する110Owner は[組織に 1 つのレベルを選択](/docs/ja/code-review-setup#set-the-default-review-level)し、個々のリポジトリに独自のレベルを設定できます。たとえば、日常的なコードベースには Quick、重要なコードベースには Deep を設定します。各レビューのコストに影響するその他の要因については、[Code Review のコストと使用状況](/docs/ja/code-review-costs)を参照してください。

396* 非対話モード(`-p` フラグまたは Agent SDK)で実行します。Claude Code はレビューを待機し、結果を応答に含めます。ただし `ultra` は除きます。これは[クラウドレビューを待ちません](/docs/ja/ultrareview#run-ultrareview-non-interactively)

397* [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ja/env-vars)を `1` に設定します。これはすべての他のバックグラウンドタスク機能もオフにします

398 111 

399<h3 id="let-claude-start-the-review">112<h3 id="what-a-review-can-access">

400 Claude にレビューを開始させる113 レビューがアクセスできるもの

401</h3>114</h3>

402 115 

403Claude は独自に `/code-review` を開始できます。変更をレビューするよう平文で依頼すると、コマンドを入力せずにスキルを実行でき、プロンプトとして `/code-review` を持つ[スケジュールされたタスク](/docs/ja/scheduled-tasks)はレビューを実行します。116レビューは、Owner が[セットアップ中にインストール](/docs/ja/code-review-setup#turn-on-code-review)した Claude GitHub App を通じてリポジトリにアクセスします:

404 117 

405スケジュールされたタスクは[クラウドレビュー](#escalate-to-ultrareview)を起動しないため、`ultra` 引数なしで `/code-review` をスケジュールします。118* **実行場所**:Anthropic インフラストラクチャ上のマネージド環境です。レビューは[セルフホスト環境](/docs/ja/self-hosted-environments)では実行されません。

119* **読み書きするもの**:レビュー内ではリポジトリへのアクセスは読み取り専用で、レビューがコミットをプッシュすることはありません。プルリクエスト上では、コメントと[チェック実行](/docs/ja/code-review-pull-requests#check-run-output)を投稿し、自身の以前のコメントスレッドを解決し、コメントコマンドに 👀 でリアクションできます。アプリ自体は、他の Claude 機能と共有する[より広い権限セット](/docs/ja/github-actions#github-app-permissions)を持っています。

120* **コードの検査方法**:レビューは差分と周囲のコードを読むことで行われ、コードをビルドしたり実行したりはしません。

406 121 

407Claude とスケジュールされたタスクがレビューを開始するのを停止しながら、入力するために `/code-review` を利用可能に保つには、`~/.claude/settings.json` などの[設定ファイル](/docs/ja/settings#where-settings-live)に[`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings)エントリを追加します:122<h3 id="who-controls-a-review">

408 123 レビューを制御する人

409```json theme={null}

410{

411 "skillOverrides": {

412 "code-review": "user-invocable-only"

413 }

414}

415```

416 

417v2.1.246 より前は、Claude は Anthropic から取得されたフィーチャーフラグがオンになった場所でのみ独自に `/code-review` を開始しました。[フィーチャーフラグを取得しないセッション](/docs/ja/env-vars#features-that-need-feature-flag-fetching)では、`/code-review` は入力したときのみ実行され、スケジュールされた `/code-review` は平文として Claude に到達しました。

418 

419<h3 id="escalate-to-ultrareview">

420 ultrareview にエスカレートする

421</h3>124</h3>

422 125 

423`/code-review ultra --fix` はクラウドでより深い[ultrareview](/docs/ja/ultrareview)を実行し、セッションに戻ってきたときに結果をワーキングツリーに適用します。126* **開始できる人**:レビューが自動で実行される設定では、プルリクエストを開くかプッシュするとレビューが開始されます。[ただしドラフトとフォークは除きます](/docs/ja/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)。[コメントコマンド](/docs/ja/code-review-pull-requests#comment-commands)は、リポジトリへの書き込みアクセス権を持つユーザーからのものである場合にのみレビューを開始します。

424 127* **従う指示**:ベースブランチまたはデフォルトブランチの `REVIEW.md` で、[プルリクエスト自体の変更からは決して読み取りません](/docs/ja/code-review-customize#which-branch-review-md-is-read-from)。

425Ultrareview は独自のスコープを使用します:現在のブランチとリポジトリのデフォルトブランチ、およびワーキングツリーの未コミットおよびステージされた変更です。`.env` および `*.tfvars` ファイルなどの認証情報またはキーのような名前のファイルの未コミット変更については、Claude Code は[ローカルリポジトリをクラウドセッションにアップロードするためのルール](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github)に従います。`/code-review ultra develop` などのブランチ名を渡して、別のベースと比較します。

426 128 

427ターゲットが `github.com` プルリクエストの場合、Claude に[完成した結果を PR に投稿](/docs/ja/ultrareview#post-findings-to-the-pull-request)させることができます。GitHub アカウントからのコメントとして。Claude Code v2.1.227 以降が必要です。129<h2 id="compare-ways-to-get-a-review">

428 130 レビューを受ける方法の比較

429<Note>131</h2>

430 Ultrareview は claude.ai アカウントでの認証が必要であり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または Zero Data Retention が有効な組織や [HIPAA 設定](/docs/ja/hipaa-setup)が適用された組織では利用できません。ultrareview が利用できない場合、`/code-review ultra` はセッション内でローカルレビューを実行します。

431</Note>

432 132 

433スクリプトまたは CI ジョブからクラウドレビューを実行するには、[`claude ultrareview` サブコマンド](/docs/ja/ultrareview#run-ultrareview-non-interactively)を使用します。このサブコマンドは結果を待機し、stdout に出力します。133利用できるオプションを見つけるには、**利用できるユーザー**列をプランとコードホストに照らし合わせて確認してください:

434 134 

435このコマンドは v2.1.147 より前は `/simplify` という名前で、デフォルトで修正を適用していました。`/simplify` はバグを探さずに修正を適用するクリーンアップのみのレビューを実行します。バグ検出のために `/simplify` をスクリプト化した場合は、`/code-review --fix` に切り替えます。135| オプション | レビューを開始するもの | 実行場所 | 利用できるユーザー |

136| :- | :- | :- | :- |

137| [Code Review](#how-reviews-work) | 各リポジトリの設定に応じたプルリクエストのアクティビティ、または `@claude review` コメント | Anthropic インフラストラクチャ | GitHub リポジトリを持つ Team または Enterprise プランの組織(Owner がオンにした後) |

138| [`/code-review`](/docs/ja/code-review-local) | ユーザーがブランチでコマンドを実行 | ユーザーの Claude Code セッション | すべてのプランの誰でも |

139| [Ultrareview](/docs/ja/ultrareview) | ユーザーが Claude Code から開始 | クラウドサンドボックス | claude.ai アカウントでのサインインが必要です。利用できない環境については [Ultrareview](/docs/ja/ultrareview) を参照してください |

140| [GitHub Actions](/docs/ja/github-actions) または [GitLab CI/CD](/docs/ja/gitlab-ci-cd) を使用した独自の CI での Claude | すべてのプルリクエストやマージリクエストなど、パイプラインのイベント | 独自の CI ランナー | GitHub または GitLab 上で、Claude API キーまたはクラウドプロバイダーの認証情報を持つ誰でも |

141| [サブエージェント](/docs/ja/sub-agents)または[スキル](/docs/ja/skills)としての独自のレビュアー | セッション中にユーザーまたは Claude が呼び出す | Claude Code を実行する場所 | それを作成した誰でも |

436 142 

437<h2 id="related-resources">143<h2 id="related-resources">

438 関連リソース144 関連リソース

439</h2>145</h2>

440 146 

441* [Commands](/docs/ja/commands): ローカルの Claude Code セッションで `/code-review` を実行して、プッシュ前に差分をチェック147* [GitHub Enterprise Server](/docs/ja/github-enterprise-server):セルフホストの GitHub インスタンスで Code Review を使用する

442* [GitHub Actions](/docs/ja/github-actions): コードレビューを超えたカスタム自動化のための独自の GitHub Actions ワークフローで Claude を実行148* [GitHub App permissions](/docs/ja/github-actions#github-app-permissions):Claude GitHub App が要求する権限の完全なセット

443* [GitLab CI/CD](/docs/ja/gitlab-ci-cd): GitLab パイプライン用の自己ホスト型 Claude 統合149* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle):自動レビューが Anthropic のセキュアな開発プロセスの 1 つのレイヤーとしてどのように適合するか

444* [Memory](/docs/ja/memory): Claude Code 全体で `CLAUDE.md` ファイルがどのように機能するか

445* [Analytics](/docs/ja/analytics): コードレビューを超えた Claude Code 使用状況を追跡

446* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle): 自動レビューが Anthropic のセキュアな開発プロセスの 1 つのレイヤーとしてどのように適合するか

code-review-costs.md +88 −0 created

Details

1> ## Documentation Index

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

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

4 

5# Code Review のコストと使用状況

6 

7> 組織が Claude Code Review に費やす金額を見積もり、上限を設定します。使用クレジットを通じたレビューの課金方法、コストを左右する要因、使用状況の確認場所について説明します。

8 

9[Code Review](/docs/ja/code-review) には、レビューごとの定額料金はありません。支出額は、各レビューのコストと実行されるレビューの数によって決まります。

10 

11* **各レビューのコスト**:[レビューレベル](/docs/ja/code-review-setup#set-the-default-review-level)、変更の規模、周辺コードの複雑さ、検証が必要な候補の問題の数に応じて増減します

12* **レビューの数**:各リポジトリで[レビューが実行される頻度](#how-often-reviews-run)によって決まります

13 

14<h2 id="pricing">

15 料金

16</h2>

17 

18Code Review は、プランに含まれる使用量とは別に、[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を通じてトークン使用量に基づいて課金されます。レビューは、PR を作成した開発者やレビューを依頼した開発者ではなく、組織に対して課金されます。組織が他の Claude Code 機能に Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のいずれを使用しているかにかかわらず、コストは Anthropic の請求書に記載されます。

19 

20<h3 id="how-often-reviews-run">

21 レビューが実行される頻度

22</h3>

23 

24管理ページから追加したリポジトリは、最も多くのレビューが実行される **After every push** から始まります。各リポジトリの [**Review runs** 設定](/docs/ja/code-review-setup#set-when-reviews-run)によって、プルリクエストが受けるレビューの数が決まります。

25 

26* **Once after PR creation**:プルリクエストが作成されたとき、再オープンされたとき、またはレビュー準備完了としてマークされたときにレビューが実行されます

27* **After every push**:プッシュのたびに実行されるため、コストはプッシュ回数に比例して増えます

28* **Manual (@claude review)**:作成時やプッシュ時にはレビューは実行されません

29 

30コメントコマンド、ドラフト、フォークからのプルリクエストによって、これらの回数は次のように変わります。

31 

32* **Once after PR creation または Manual モードでの `@claude review always`**:[PR をプッシュトリガーのレビューにオプトインする](/docs/ja/code-review-pull-requests#comment-commands)ため、そのコメント以降はプッシュごとに追加のコストが発生します

33* **After every push モードでの `@claude review always`**:プッシュですでにレビューがトリガーされるため、このサブスクリプションによってプッシュごとのコストは変わりません

34* **`@claude review`**:今後のプッシュをサブスクライブせずに、1 回だけレビューを実行します

35* **ドラフトとフォークからのプルリクエスト**:[自動レビューはどちらもスキップする](/docs/ja/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)ため、これらへのプッシュでレビューが増えることはありません

36 

37<h2 id="estimate-your-spend">

38 支出を見積もる

39</h2>

40 

41本格的に展開する前に、小規模なパイロットを実施して、自組織のプルリクエストから月間の支出を見積もります。

42 

431. パイロット用に[月間支出上限](#limit-your-spend)を設定します。

442. 代表的ないくつかのリポジトリで Code Review をオンにし、**Review runs** を **Once after PR creation** または **Manual (@claude review)** に設定します。

453. いくつかのレビューが実行された後、[**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) の **Code review** セクションにある **Repositories** テーブルの **Average cost** 列で、各リポジトリのレビューあたりの平均コストを確認します。

464. その平均値に、そのリポジトリで 1 か月間に作成されるプルリクエストの数を掛けます。**After every push** の場合は、さらにプルリクエストあたりの一般的なプッシュ回数を掛けます。

47 

48リポジトリの平均値は、そのプルリクエストの規模と選択したレビューレベルに応じて変動します。

49 

50<h2 id="limit-your-spend">

51 支出を制限する

52</h2>

53 

54Code Review の月間支出上限を設定するには、[claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) に移動し、Claude Code Review サービスの上限を構成します。この上限は組織全体に適用されます。

55 

56次のいずれかが尽きると、Code Review はレビューをスキップします。

57 

58* **Code Review の支出上限**:Claude Code Review サービスに設定した月間上限です。次の請求期間の開始時にリセットされ、上限を引き上げればそれより早くレビューが再開されます。

59* **組織の支出上限**:使用クレジットに対する組織全体の月間支出上限です。同じページで引き上げられます。

60* **使用クレジットの残高**:組織の使用クレジットの残高です。同じページでクレジットを追加できます。

61 

62また、残りの額が 1 回のレビューの想定コストを下回った時点でも、Code Review はレビューをスキップします。レビューがスキップされると、開発者には原因を示し使用状況の設定へのリンクを含む [PR へのコメント](/docs/ja/code-review-troubleshooting#review-didn’t-run-and-the-pr-shows-a-budget-message)が表示されます。

63 

64支出を監視するには、[分析ダッシュボード](#view-usage)を使用します。

65 

66<h2 id="view-usage">

67 使用状況を確認する

68</h2>

69 

70[claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) に移動すると、組織全体の Code Review のアクティビティを確認できます。

71 

72| セクション | 表示内容 |

73| :- | :- |

74| PRs reviewed | 選択した期間にレビューされたプルリクエストの日ごとの件数 |

75| Code Review cost | 今月これまでの Code Review の支出 |

76| Feedback | 開発者が問題に対処したために自動的に解決されたレビューコメントの件数 |

77| Repository breakdown | リポジトリごとのレビューされた PR、解決されたコメント、レビュー実行の件数と、推定コストおよび PR ごとのビュー |

78 

79Code Review cost カードには、当月が選択されている場合にのみ金額が表示されます。分析のコスト数値は請求書と異なる場合があります。Repository breakdown のコストは割引やクレジットを適用する前の定価で推定されており、Claude がプルリクエストに投稿したレビューのみが対象です。請求書と一致する正確な支出については、Anthropic の請求書を参照してください。

80 

81<h2 id="related-resources">

82 関連リソース

83</h2>

84 

85* [Code Review をセットアップする](/docs/ja/code-review-setup):各リポジトリでレビューレベルとレビューの実行タイミングを選択する場所

86* [プルリクエストでレビューを確認・依頼する](/docs/ja/code-review-pull-requests):コメントコマンド、フォークからのプルリクエスト、レビューがスキップされたときに開発者に表示される予算メッセージ

87* [Code Review](/docs/ja/code-review):レビューで確認される内容と投稿される内容

88* [コストを効果的に管理する](/docs/ja/costs):Claude Code のその他の機能における支出管理と使用状況の追跡

code-review-customize.md +149 −0 created

Details

1> ## Documentation Index

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

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

4 

5# Code Review をカスタマイズする

6 

7> REVIEW.md と CLAUDE.md を使って、Code Review がプルリクエストで指摘する内容を調整します。重大度の再調整、パスのスキップ、チェックの追加、そしてどのコピーが適用されるかを確認する方法を説明します。

8 

9リポジトリに指示をコミットすることで、[Code Review](/docs/ja/code-review) がそのリポジトリで指摘する内容を変更できます。これにより、nit の量を減らしたり、生成されたファイルへのコメントを止めたり、チームが重視するルールを追加したりできます。指示は次の 2 つのファイルのいずれかに記述します。

10 

11* **`CLAUDE.md`**:Claude Code がレビューを含むすべてのタスクで読み込む[プロジェクト指示](/docs/ja/memory)です。Code Review はこれをプロジェクトのコンテキストとして読み込み、これに違反する変更を指摘します。

12* **`REVIEW.md`**:レビュー専用の指示です。チームが何を指摘してほしいか、どの重大度で指摘するか、何をスキップするかを記述するために使用します。

13 

14リポジトリのルートに `REVIEW.md` を追加してマージします。その後、[デフォルトブランチを保護](#which-branch-review-md-is-read-from)します。

15 

16<Note>

17 レビューの徹底度や実行タイミングを変更するには、Owner に[レビューレベル](/docs/ja/code-review-setup#set-the-default-review-level)または [**Review runs** 設定](/docs/ja/code-review-setup#set-when-reviews-run)の変更を依頼してください。

18</Note>

19 

20<h2 id="use-claude-md-for-project-wide-rules">

21 プロジェクト全体のルールには CLAUDE.md を使用する

22</h2>

23 

24Code Review は、リポジトリの `CLAUDE.md` ファイルをプロジェクトのコンテキストとして読み込みます。そのルールのいずれかに違反する変更は、問題に応じた[重大度レベル](/docs/ja/code-review-pull-requests#severity-levels)の検出結果になります。

25 

26レビューでは、リポジトリのルートにある `CLAUDE.md` と、変更された各ファイルの親ディレクトリにある `CLAUDE.md` ファイルが読み込まれます。サブディレクトリの `CLAUDE.md` は、プルリクエストがそのパス配下のファイルを変更した場合に読み込まれます。

27 

28<h2 id="use-review-md-for-review-only-rules">

29 レビュー専用のルールには REVIEW\.md を使用する

30</h2>

31 

32`REVIEW.md` は、Code Review をリポジトリに合わせて調整するための、リポジトリのルートに置くファイルです。サブディレクトリに `REVIEW.md` を追加して、ルートのファイルに加えて、そのパス配下の変更に対するチェックを追加することもできます。

33 

34問題を検出するエージェントと、それを検証するエージェントは、Code Review のデフォルトのレビューガイダンスとともに、このファイルの内容をリポジトリのレビュー指示として受け取ります。最終的なレビューを書き出すステップでは、重大度を確定してサマリーを書く前にこのファイルを参照します。

35 

36次のレイアウト例には、ルートのファイルとサブディレクトリのファイルが 1 つずつあります。

37 

38```text theme={null}

39your-repo/

40├── REVIEW.md # Root file

41├── services/

42│ └── billing/

43│ └── REVIEW.md # Adds checks for changes under services/billing/

44└── src/

45```

46 

47サブディレクトリのファイルに頼る前に、デフォルトブランチを保護し、[ブランチ構成に応じてレビューが何を読み込むか](#what-a-review-reads-for-each-branch-setup)を確認してください。

48 

49<Note>

50 Code Review サービスとローカルの [`/code-review` コマンド](/docs/ja/code-review-local)は別々のツールであり、読み込むファイルが異なります。サービスは `CLAUDE.md` と `REVIEW.md` の両方を読み込みます。自分のマシン上の Claude Code セッション内で実行する `/code-review` コマンドは、`CLAUDE.md` ファイルを読み込みますが、`REVIEW.md` は読み込みません。両方で適用したいガイダンスは `CLAUDE.md` に記述し、`REVIEW.md` はプルリクエストのレビューに固有のルールのために使用してください。

51</Note>

52 

53<h3 id="example-review-md">

54 REVIEW\.md の例

55</h3>

56 

57この `REVIEW.md` は、バックエンドサービス向けに重大度を再調整し、nit の数に上限を設け、生成されたファイルをスキップし、リポジトリ固有のチェックを追加します。

58 

59```markdown theme={null}

60# Review instructions

61 

62## What Important means here

63 

64Reserve Important for findings that would break behavior, leak data,

65or block a rollback: incorrect logic, unscoped database queries, PII

66in logs or error messages, and migrations that aren't backward

67compatible. Style, naming, and refactoring suggestions are Nit at

68most.

69 

70## Cap the nits

71 

72Report at most five Nits per review.

73 

74## Do not report

75 

76- Anything CI already enforces: lint, formatting, type errors

77- Generated files under `src/gen/` and any `*.lock` file

78- Test-only code that intentionally violates production rules

79 

80## Always check

81 

82- New API routes have an integration test

83- Log lines don't include email addresses, user IDs, or request bodies

84- Database queries are scoped to the caller's tenant

85```

86 

87<h3 id="choose-what-to-write-in-review-md">

88 REVIEW\.md に何を書くかを決める

89</h3>

90 

91`REVIEW.md` は自由形式の Markdown で、レビューが何を検出して報告するかを変更します。レビューの形式は変更しません。発生している問題を見つけ、示されているような指示を追加してください。[例](#example-review-md)では最初の 4 つを使用しています。

92 

93* **間違ったものが Important としてマークされる**:リポジトリにおける 🔴 Important の意味を再定義します。デフォルトの調整は本番コードを対象としており、ドキュメントリポジトリ、設定リポジトリ、プロトタイプではもっと狭い定義が望ましい場合があります。どの種類の検出結果が Important で、どれがせいぜい Nit なのかを明記してください。重大度を引き上げることもでき、たとえば `CLAUDE.md` への違反をすべて Important として扱うこともできます。

94* **nit が多すぎる**:1 回のレビューで投稿される 🟡 Nit コメントの数に上限を設けます。「nit は最大 5 件まで報告する」のような上限により、レビューを対応可能な内容に保てます。

95* **生成されたファイルや CI がすでにチェックしている内容へのコメント**:Claude が検出結果をスキップすべきパスと検出結果のカテゴリを列挙します。よくある候補は、生成コード、ロックファイル、vendor された依存関係、そして lint やスペルチェックなど CI がすでに強制しているものです。ある程度のレビューを必要とするものの、徹底的な精査までは不要なパスについては、代わりに基準を引き上げます。たとえば「`scripts/` では、ほぼ確実かつ重大な場合にのみ報告する」とします。

96* **チームのルールがチェックされていない**:「新しい API ルートには統合テストが必要」のように、すべてのプルリクエストで指摘してほしいルールを追加します。

97* **誤っていることが判明する検出結果**:ある種類の検出結果を投稿する前に根拠を求めます。たとえば「動作に関する主張には、命名からの推測ではなく、ソース内の `file:line` の引用が必要」とすることで、作成者に余計なやり取りを強いる誤検出を減らせます。

98 

99これらの指示の一部は、[保護されたデフォルトブランチ上のルートファイルを必要とします](#which-branch-review-md-is-read-from)。

100 

101`REVIEW.md` にはレビューの動作を変える指示だけを記述し、一般的なプロジェクトのコンテキストは `CLAUDE.md` に残してください。

102 

103<h3 id="which-branch-review-md-is-read-from">

104 REVIEW\.md がどのブランチから読み込まれるか

105</h3>

106 

107Code Review は、`REVIEW.md` をプルリクエストのベースブランチまたはデフォルトブランチから読み込み、プルリクエスト自体の変更から読み込むことはありません。レビューの動作を変更するには、まず `REVIEW.md` の変更をマージしてください。

108 

109`REVIEW.md` はデフォルトブランチに置き、そのブランチを保護してください。レビューが保護されたデフォルトブランチ上のコピー(下の表の 1 行目)を読み込む場合、ルートファイルにある次の指示が適用されます。

110 

111* 検出結果の重大度を下げる

112* パス、ファイル、または問題の種類を除外する

113* nit コメントの数に上限を設ける

114 

115<h4 id="what-counts-as-branch-protection">

116 ブランチ保護とみなされるもの

117</h4>

118 

119Code Review は、次の設定を保護とみなします。

120 

121* **デフォルトブランチ**:クラシックなブランチ保護ルールまたはルールセット

122* **その他のブランチ**:ルールセットのみ

123 

124ルールセットは、更新を制限している場合、または少なくとも 1 件の承認を伴うプルリクエストを必須にしている場合に保護とみなされます。プルリクエストを必須にしている場合は、新しいプッシュ時にその承認を取り消すか、最後のプッシュ以降の承認を必須にする必要もあります。

125 

126<h4 id="what-a-review-reads-for-each-branch-setup">

127 ブランチ構成ごとにレビューが読み込むもの

128</h4>

129 

130下の表の 1 列目から、リポジトリの状況に該当するものを見つけてください。

131 

132| ブランチ保護 | 読み込まれるコピー | 読み込まれるファイル |

133| :- | :- | :- |

134| デフォルトブランチが保護されており、プルリクエストがそのブランチ、またはどのルールセットにも保護されていないブランチを対象としている | デフォルトブランチ | ルートとサブディレクトリのファイル |

135| プルリクエストが、ルールセットで保護された別のブランチを対象としている | そのベースブランチ | ルートとサブディレクトリのファイル |

136| デフォルトブランチが保護されておらず、ベースブランチにもどちらの種類の保護ルールもない | デフォルトブランチ | ルートファイル |

137| Code Review が保護設定を確認できない。保護されていないデフォルトブランチと、クラシックなルールのみを持つベースブランチの組み合わせもこれに含まれる | なし | なし |

138 

139チェック実行で `REVIEW.md` について言及されている場合は、[The check run mentions REVIEW.md](/docs/ja/code-review-troubleshooting#the-check-run-mentions-review-md) を参照してください。

140 

141<h2 id="related-resources">

142 関連リソース

143</h2>

144 

145* [Code Review](/docs/ja/code-review):サービスの概要とレビューの実行方法

146* [プルリクエストでレビューを確認・依頼する](/docs/ja/code-review-pull-requests#severity-levels):各重大度レベルの意味と検出結果の表示方法

147* [Code Review をセットアップする](/docs/ja/code-review-setup):Owner が設定するレビューレベルとレビューの実行タイミング

148* [`/code-review` でローカルにレビューする](/docs/ja/code-review-local):`/code-review` コマンド、その引数、effort レベル

149* [メモリ](/docs/ja/memory):Claude Code 全体で `CLAUDE.md` ファイルがどのように機能するか

code-review-local.md +197 −0 created

Details

1> ## Documentation Index

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

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

4 

5# /code-review でローカルにレビューする

6 

7> Claude Code セッションで `/code-review` を実行して、ブランチの変更に含まれるバグを見つけたり、レビュー対象をプルリクエストやパスに向けたり、Claude に修正を適用させたりします。

8 

9`/code-review` は、作業中のセッションで Claude Code のプロンプトに入力するコマンドです。Claude はブランチ上の変更をレビューし、正確性に関わるバグを探し、見つかった内容を会話内で報告します。モデルと effort レベルによっては、再利用、簡素化、効率化のためのクリーンアップもレビューの対象になります。

10 

11このコマンドはどのプランでも使用できます。レビューはユーザー自身のセッションで実行されるため、セッションの他の部分と同じように、プランの使用量または API の課金にカウントされます。

12 

13<Note>

14 GitHub 上でリポジトリ内のすべてのプルリクエストを自動的にレビューするには、Owner が組織に対して有効にするマネージドサービスである [Code Review](/docs/ja/code-review) を参照してください。

15</Note>

16 

17`/review` は `/code-review` のエイリアスです。v2.1.223 より前は、`/review` は GitHub プルリクエストに対してシングルパスの読み取り専用レビューを実行する別のコマンドでした。

18 

19<Steps>

20 <Step title="/code-review を実行する">

21 次のコマンドを実行します。

22 

23 ```text theme={null}

24 /code-review

25 ```

26 

27 対象を指定しない場合、レビューは現在のブランチ上の変更を対象とします。代わりにプルリクエスト、別のブランチ、パス、またはコミットの範囲をレビュー対象にするには、[レビュー対象を選択する](#choose-what-to-review)を参照してください。

28 

29 フラグを追加することもできます。

30 

31 * `--fix`: レビュー後に、指摘事項を作業ツリーに適用するよう Claude に求めます。その編集は[権限モード](/docs/ja/permission-modes)に従います。

32 * `--comment`: 指摘事項を GitHub プルリクエストにはインラインコメントとして、[GitLab マージリクエスト](#post-findings-to-a-gitlab-merge-request)には単一のノートとして投稿します

33 </Step>

34 

35 <Step title="作業を続ける">

36 レビューは独自のコンテキストウィンドウを持つバックグラウンドの[サブエージェント](/docs/ja/sub-agents)として実行されるため、会話を圧迫しません。指摘事項はレビューが完了すると会話に届きます。

37 </Step>

38 

39 <Step title="指摘事項に対応する">

40 レビューで見つかった問題を修正するよう Claude に依頼します。`--fix` または `--comment` を指定した場合、Claude はレビューの一環として指摘事項を適用または投稿し、その編集の承認を求められることがあります。

41 </Step>

42</Steps>

43 

44<h2 id="choose-what-to-review">

45 レビュー対象を選択する

46</h2>

47 

48現在のブランチ以外のものをレビューするには、effort レベルとフラグの後に対象を入力します。Claude はそのテキストをレビュー対象として受け取ります。対象には、プルリクエスト番号、ブランチ名、ファイルパス、または Git のリビジョン範囲を指定できます。レビューしたいものを 1 列目から探し、2 列目に示されている内容を入力してください。

49 

50| レビュー対象 | 入力内容 |

51| :- | :- |

52| 現在のブランチとコミットされていない変更 | `/code-review` |

53| 直近 15 件のコミット | `/code-review HEAD~15..HEAD` |

54| あるブランチと別のブランチの比較 | `/code-review main...my-feature` |

55| 単一のコミット(`abc1234` はコミットのハッシュ) | `/code-review abc1234^..abc1234` |

56| 番号で指定したプルリクエスト | `/code-review 1234` |

57| ファイルまたはディレクトリのパス | `/code-review src/auth` |

58 

59対象を指定しない場合、`/code-review` はブランチのアップストリームブランチより先行しているコミットと、コミットされていない変更をレビューします。ブランチにアップストリームがない場合、Claude は `main` または 1 つ前のコミットと比較します。

60 

61`ultra` を指定した場合、[effort レベルとフラグの後のテキスト](#text-after-the-effort-level-and-flags)で説明しているように、Claude Code は対象を異なる方法で解釈します。

62 

63<h2 id="what-the-review-reads-and-edits">

64 レビューが読み取るものと編集するもの

65</h2>

66 

67レビューを実行する前に、特に `--fix` を使用する場合は、次の点を確認してください。

68 

69* **編集**: `--fix` を指定しない場合、レビューの指示は Claude にレポートのみを求めます。`--fix` を指定すると、指摘事項を作業ツリーに適用することも求めます。いずれの場合も、すべての編集は権限モードに従います。

70* **巻き戻し**: バックグラウンドのレビューは、`--fix` による編集をセッションの[チェックポイント](/docs/ja/checkpointing#subagent-edits-not-restored)の外で適用します。その後に `/rewind` を実行しても、Claude がすでに会話内で編集していたファイルしか復元されません。レビューによる他のファイルへの編集は残るため、git を使用して元に戻してください。レビューが[フォアグラウンドで実行される](#run-in-the-foreground)場合は、ユーザー自身のターン中に作業ツリーを編集するため、`/rewind` で通常どおりその編集を復元できます。

71* **指示**: レビューは、非対話の `-p` 実行を含め、`CLAUDE.md` に従います。`REVIEW.md` は読み取りません。このファイルは、GitHub プルリクエストに対するマネージドの [Code Review サービス](/docs/ja/code-review-customize#use-review-md-for-review-only-rules)を設定するものです。

72 

73<h2 id="how-findings-are-reported">

74 指摘事項の報告方法

75</h2>

76 

77次のどちらの実行でも、Claude は指摘事項を応答内のテキストとして報告します。

78 

79* ターミナルセッション。この場合、`/code-review` はレビューを[フォークされたサブエージェント](/docs/ja/skills#run-skills-in-a-subagent)として実行します

80* テキストまたは JSON 出力を使用する `-p` 実行

81 

82[デスクトップアプリ](/docs/ja/desktop#review-your-code)など、指摘事項のリストを要求するホストアプリケーションでは、Claude は代わりに [`ReportFindings` ツール](/docs/ja/tools-reference)を通じてレビューの指摘事項を報告します。レポートは指摘事項のリストとして表示され、各エントリにはファイルの場所、1 文の要約、そして指摘事項にカテゴリがある場合は `correctness` などのカテゴリタグが表示されます。ホストからの要求はすべての effort レベルに適用され、Claude Code v2.1.218 以降が必要です。

83 

84セッションの後半で Claude が報告済みの指摘事項を修正すると、Claude は再度それらを報告します。その後、Claude Code は更新された指摘事項のリスト内の各指摘事項を、修正済み、スキップ、または変更不要としてマークします。

85 

86<h2 id="tune-effort-and-arguments">

87 effort と引数を調整する

88</h2>

89 

90`--fix` と `--comment` のほかに、このコマンドは次のフラグを受け付けます。

91 

92* `--post`: `github.com` のプルリクエストに対する `ultra` クラウドレビューで、起動ダイアログにおいて完了した指摘事項を PR に投稿するオプションをあらかじめ選択します。[指摘事項をプルリクエストに投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)を参照してください。Claude Code v2.1.227 以降が必要です。

93* `--max-findings <n>`、`--max-findings all`、または `--max-findings default`: レビューの通常の上限の代わりに、最大 `n` 件の指摘事項、または `all` の場合はすべての指摘事項を報告します。レビューが指摘事項ツールを通じて報告する場合、上限は 32 件です。以降のレビューでは、`--max-findings default` を渡すまで入力した値が再利用されますが、非対話の `-p` 実行で渡した値は記憶されません。Claude Code v2.1.288 以降が必要です。

94 

95[effort レベル](/docs/ja/model-config#adjust-effort-level)を渡すと、網羅性と確信度のバランスを調整できます。`low` では、レビューは最も確信度の高い指摘事項を報告するため、誤検知が少なくなります。`medium` から `max` にかけて、レビューの網羅性が広がります。

96 

97レベルを入力しない場合、レビューは、以前のセッションであっても、最後に入力した `low` から `max` までのレベルを再利用します。Claude Code は `Reusing high effort, the level you typed last time` のような通知を表示します。実行時にどのレベルが使用されるかは、次のルールで決まります。

98 

99* **レベルを入力した場合**: `/code-review high` のように入力したレベルは、以降の実行で再利用されるレベルを変更します

100* **非対話の実行**: 非対話の `-p` 実行で渡したレベルは、記憶されているレベルを更新しません

101* **`ultra`**: レビューは記憶されているレベルを使用も更新もしません

102* **一度もレベルを入力していない場合**: レビューはセッションの現在の effort を使用します

103 

104v2.1.223 より前は、レベルを指定しない `/code-review` は常にセッションの現在の effort を使用していました。

105 

106<h3 id="post-findings-to-a-gitlab-merge-request">

107 指摘事項を GitLab マージリクエストに投稿する

108</h3>

109 

110GitLab マージリクエストに対して `--comment` を渡すと、Claude Code は GitLab の `glab` CLI を通じて指摘事項を投稿します。Claude Code v2.1.257 以降が必要です。`glab` がインストールされていない場合、Claude は代わりにターミナルに指摘事項を出力します。

111 

112マージリクエストは URL または `!123` 形式の参照で渡してください。Claude Code が数字のみやブランチ名をマージリクエストとして扱うのは、チェックアウトの origin が `gitlab.com` にある場合のみです。セルフマネージドの GitLab インスタンスでは、URL または `!123` 形式を渡してください。

113 

114<h3 id="text-after-the-effort-level-and-flags">

115 effort レベルとフラグの後のテキスト

116</h3>

117 

118effort レベルとフラグの後、Claude Code は行の残りをレビュー対象として読み取ります。`ultra` 引数はこの解釈を変更します。

119 

120* **`ultra` を指定した場合**: Claude Code は単一の単語をベースブランチまたは PR 番号として読み取ります。ブランチや PR を指していない長いテキストは、[レビューに添付されるメモ](/docs/ja/ultrareview#pass-a-request-in-plain-words)になります。`/code-review ultra check my auth changes` は現在のブランチをレビューし、Claude は指摘事項をメモと関連付けます。

121* **`ultra` を指定しない場合**: 残りはすべてレビュー対象になります。これは別のコマンド名で始まる場合も同様です。`/code-review /fix-issue 123` は、`/fix-issue` を 2 つ目の[スタックされたスキル](/docs/ja/skills#pass-arguments-to-skills)として読み込むのではなく、`/fix-issue 123` を対象テキストとしてレビューします。v2.1.218 より前は、`/code-review` の後にスタックされたコマンドは独立したスキルとして展開されていました。

122 

123<h2 id="run-in-the-foreground">

124 フォアグラウンドで実行する

125</h2>

126 

127レビューをフォアグラウンドで実行するには、次のいずれかを行います。

128 

129* `-p` フラグまたは Agent SDK を使用して、非対話モードで実行します。Claude Code はレビューを待機し、指摘事項を応答に含めます。ただし `ultra` は例外で、[クラウドレビューを待機しません](/docs/ja/ultrareview#run-ultrareview-non-interactively)。

130* [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ja/env-vars) を `1` に設定します。これにより、他のすべてのバックグラウンドタスク機能もオフになります

131* 以前のレビューがまだ進行中の間に、`/code-review` を再度実行します

132 

133v2.1.218 より前は、レビューは会話内で実行されていました。

134 

135<h2 id="let-claude-start-the-review">

136 Claude にレビューを開始させる

137</h2>

138 

139Claude は、ユーザーがコマンドを入力しなくても、自ら `/code-review` を開始できます。

140 

141* **自然な言葉で依頼した場合**: 変更をレビューするよう Claude に依頼すると、Claude はスキルを実行できます

142* **スケジュールタスクから**: `/code-review` をプロンプトとする[スケジュールタスク](/docs/ja/scheduled-tasks)はレビューを実行します

143 

144スケジュールタスクが[クラウドレビュー](#escalate-to-ultrareview)を起動することはないため、`/code-review` は `ultra` 引数なしでスケジュールしてください。

145 

146`/code-review` をユーザーが入力できる状態に保ちつつ、Claude とスケジュールタスクの両方がレビューを開始しないようにするには、`~/.claude/settings.json` などの[設定ファイル](/docs/ja/settings#where-settings-live)に [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) エントリを追加します。

147 

148```json theme={null}

149{

150 "skillOverrides": {

151 "code-review": "user-invocable-only"

152 }

153}

154```

155 

156v2.1.246 より前は、Claude が自ら `/code-review` を開始するのは、Anthropic から取得した機能フラグによって有効化されている場合のみでした。[機能フラグを取得しないセッション](/docs/ja/env-vars#features-that-need-feature-flag-fetching)では、`/code-review` はユーザーが入力した場合にのみ実行され、スケジュールされた `/code-review` はプレーンテキストとして Claude に届いていました。

157 

158<h2 id="escalate-to-ultrareview">

159 ultrareview にエスカレーションする

160</h2>

161 

162`/code-review ultra --fix` は、より詳細な [ultrareview](/docs/ja/ultrareview) をクラウドで実行し、その指摘事項がセッションに戻ってきた時点で、作業ツリーに適用するよう Claude に求めます。

163 

164ultrareview は独自のスコープを使用します。

165 

166* **比較対象**: 現在のブランチとリポジトリのデフォルトブランチの比較に加え、作業ツリー内のコミットされていない変更とステージされた変更

167* **機密ファイル**: `.env` や `*.tfvars` ファイルなど、認証情報やキーのような名前のファイルに対するコミットされていない変更については、Claude Code は[ローカルリポジトリをクラウドセッションにアップロードする](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github)際のルールに従います

168* **別のベース**: 別のベースと比較するには、`/code-review ultra develop` のようにブランチ名を渡します

169 

170対象が `github.com` のプルリクエストである場合、完了した指摘事項を GitHub アカウントからのコメントとして [PR に投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)よう Claude に指示できます。Claude Code v2.1.227 以降が必要です。

171 

172<Note>

173 ultrareview には claude.ai アカウントでの認証が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では利用できず、Zero Data Retention が有効になっている組織や [HIPAA 構成](/docs/ja/hipaa-setup)が適用されている組織でも利用できません。これらの場合、`/code-review ultra` は代わりにセッション内でローカルレビューを実行します。[顧客管理の暗号化キー](https://platform.claude.com/docs/en/manage-claude/cmek)(CMEK)を使用する組織は ultrareview を実行できません。変更をローカルでレビューするには、`/code-review` を実行してください。

174</Note>

175 

176スクリプトや CI ジョブからクラウドレビューを実行するには、[`claude ultrareview` サブコマンド](/docs/ja/ultrareview#run-ultrareview-non-interactively)を使用します。このサブコマンドは指摘事項を待機し、stdout に出力します。

177 

178<h2 id="change-or-build-on-the-review">

179 レビューを変更する、またはレビューを基に構築する

180</h2>

181 

182`/code-review` は[バンドルスキル](/docs/ja/skills#bundled-skills)です。その指示は Claude Code に組み込まれているため、開いたり編集したりできる `SKILL.md` ファイルはディスク上にありません。すべてのレビューに従わせたいプロジェクトのルールがある場合は、`CLAUDE.md` に追加してください。さらに踏み込むには、次のいずれかのページから始めてください。

183 

184* **コマンドを置き換える**: `code-review` という名前のプロジェクトスキルまたは個人スキルは、バンドルされたスキルの代わりに実行され、`/review` エイリアスは引き続きバンドルされたレビューを実行します。[同じ名前を持つスキルを解決する](/docs/ja/skills#resolve-skills-that-share-a-name)を参照してください。

185* **独自のレビュアーを構築する**: レビュアーの[サブエージェント](/docs/ja/sub-agents)またはレビュー用の[スキル](/docs/ja/skills)を作成します

186* **関連するコマンドを使用する**: [`/simplify`](/docs/ja/commands) はクリーンアップのみを目的にレビューして修正を適用し、[`/verify`](/docs/ja/commands) はアプリを実行して変更が機能することを確認します

187 

188このコマンドは v2.1.147 より前は `/simplify` という名前で、デフォルトで修正を適用していました。バグを見つけるために `/simplify` をスクリプト化していた場合は、`/code-review --fix` に切り替えてください。

189 

190<h2 id="related-resources">

191 関連リソース

192</h2>

193 

194* [Code Review](/docs/ja/code-review): 組織の GitHub 上のすべてのプルリクエストをレビューするマネージドサービス

195* [Ultrareview](/docs/ja/ultrareview): より詳細なクラウドレビューのセットアップ、制限、コスト

196* [コマンド](/docs/ja/commands): `/code-review`、`/review`、`/simplify`、`/verify` の 1 行リファレンス

197* [スキル](/docs/ja/skills): バンドルスキルの仕組みと独自のスキルの作成方法

code-review-pull-requests.md +169 −0 created

Details

1> ## Documentation Index

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

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

4 

5# プルリクエストのレビューを読む・リクエストする

6 

7> GitHub のプルリクエストで Code Review の指摘を読み、返信または却下し、`@claude review` でレビューをリクエストします。

8 

9Code Review は、Claude 組織の Owner が一連の GitHub リポジトリに対してオンにするマネージドサービスです。オンにすると、Claude はそれらのリポジトリのプルリクエストをレビューし、指摘をインラインコメント、レビュー本文のサマリー、そして **Claude Code Review** という名前のチェックランとして投稿します。レビューがプルリクエストを承認したりブロックしたりすることはなく、チェックランが失敗として終了することもありません。

10 

11Owner は、リポジトリごとに[レビューを実行するタイミング](/docs/ja/code-review-setup#set-when-reviews-run)と[レビューの詳細度](/docs/ja/code-review-setup#set-the-default-review-level)を制御します。

12 

13<Note>

14 プランに Code Review が含まれていない場合でも、Claude Code セッションから Claude にブランチをレビューさせることができます。[`/code-review` でローカルにレビューする](/docs/ja/code-review-local)を参照してください。

15</Note>

16 

17<h2 id="severity-levels">

18 重大度レベル

19</h2>

20 

21Claude は各指摘を該当する行へのインラインコメントとして投稿し、3 つの重大度レベルのいずれかでマークします。

22 

23| マーカー | 重大度 | 意味 |

24| :- | :- | :- |

25| 🔴 | Important | マージ前に修正すべきバグ |

26| 🟡 | Nit | 軽微な問題。修正する価値はあるがブロックするほどではない |

27| 🟣 | Pre-existing | コードベースに存在するが、この PR で導入されたものではないバグ |

28 

29レビューが推論を記録した場合、指摘には折りたたまれた **Why this was flagged** セクションがあります。これを展開すると、Claude がその問題を指摘した理由と、問題をどのように検証したかを読むことができます。

30 

31リポジトリで Claude が指摘する内容や重大度の判定方法を変更するには、[Code Review をカスタマイズする](/docs/ja/code-review-customize)を参照してください。

32 

33<h2 id="respond-to-findings">

34 指摘に対応する

35</h2>

36 

37リポジトリ独自のルールで求められていない限り、指摘に対応しなくてもマージできます。ブランチ保護で[会話の解決が必須](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-conversation-resolution-before-merging)になっている場合は、マージする前に各指摘のスレッドを解決してください。

38 

39指摘を解消するには、そのスレッドを解決するか、修正をプッシュします。

40 

41* **コードを変更せずに却下する**: GitHub 上で自分でスレッドを解決します。返信するだけでは指摘は却下されません。

42* **問題を修正する**: コードを変更してプッシュします。プルリクエストの次のレビューは、問題が修正されたと判断した場合に以前のスレッドを解決します。これは、そのレビューがプッシュで自動的に実行された場合でも、リクエストによって実行された場合でも同じです。

43* **説明する、または反論する**: コメントに返信します。Claude はすぐには応答せず、返信によってレビューが開始されることもありません。プルリクエストの次のレビューが以前の指摘への返信を読み、スレッドを解決するか、フォローアップの返信を 1 件投稿することがあります。同じ種類の指摘が繰り返し出る場合は、メンテナーに [`REVIEW.md`](/docs/ja/code-review-customize#choose-what-to-write-in-review-md) へのルール追加を依頼してください。

44 

45プッシュせずに次のレビューを実行するには、`@claude review` を[プルリクエストのトップレベルコメント](#comment-commands)として投稿します。

46 

47<h2 id="check-run-output">

48 チェックランの出力

49</h2>

50 

51**Claude Code Review** チェックランの **Details** リンクを開くと、GitHub がインラインコメントを受け付けなかった指摘も含め、すべての指摘が重大度順に並んだ 1 つの表で表示されます。

52 

53| 重大度 | ファイル:行 | 問題 |

54| - | - | - |

55| 🔴 Important | `src/auth/session.ts:142` | トークンのリフレッシュがログアウトと競合し、古いセッションがアクティブなまま残る |

56| 🟡 Nit | `src/auth/session.ts:88` | `parseExpiry` が不正な入力に対して暗黙的に 0 を返す |

57 

58行情報があるもののインラインコメントとして投稿されなかった指摘は、**Files changed** タブの該当行にアノテーションとして表示されます。Important の指摘は赤、Nit は黄、既存のバグはグレーで表示されます。

59 

60チェックランは neutral として終了します。プッシュでファイルが変更されなかったために自動レビューが実行されなかった場合は skipped として終了します。失敗として終了することはないため、完了したレビューが必須チェックを失敗させることはありません。指摘が表示されない場合やレビューが実行されなかった場合は、[Code Review のトラブルシューティング](/docs/ja/code-review-troubleshooting)を参照してください。

61 

62<h3 id="read-the-result-from-a-script">

63 スクリプトから結果を読む

64</h3>

65 

66独自の CI でマージをゲートしたりサマリーを投稿したりするには、`gh` と jq を使って Details テキストの最終行を解析します。この行は機械可読なコメントになっています。

67 

68<Steps>

69 <Step title="チェックラン ID を見つける">

70 シェルからコミットのチェックランを一覧表示し、`Claude Code Review` ランの `id` を取得します。`OWNER` と `REPO` をリポジトリのオーナーと名前に、`<commit-sha>` をプルリクエストの head コミットに置き換えてください。

71 

72 ```bash theme={null}

73 gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'

74 ```

75 </Step>

76 

77 <Step title="重大度ごとの件数を読む">

78 `CHECK_RUN_ID` を ID に置き換えて、そのチェックランから件数を読み取ります。

79 

80 ```bash theme={null}

81 gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \

82 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

83 ```

84 

85 これにより、重大度ごとの件数を持ち、キーがアルファベット順に並んだ JSON オブジェクトが出力されます。例: `{"nit": 1, "normal": 2, "pre_existing": 0}`。件数には、スレッドがまだ未解決のままになっているプルリクエストの以前のレビューによる指摘も含まれます。

86 </Step>

87 

88 <Step title="結果に基づいて処理する">

89 スクリプトで次のケースを処理するようにします。

90 

91 * **`normal` が 0 より大きい**: マージをゲートしたい場合はジョブを失敗させます。`normal` キーには Important の指摘の件数が入っているため、Claude がマージ前に修正すべきバグを少なくとも 1 件見つけたことを意味します。

92 * **行が存在しない**: 指摘 0 件ではなく、判定なしとして扱います。失敗した、タイムアウトした、キャンセルされた、または新しいレビューに置き換えられたレビューのチェックランにはこの行がなく、完了したレビューの中にもこの行がないものがあります。

93 </Step>

94</Steps>

95 

96<h2 id="request-a-review">

97 レビューをリクエストする

98</h2>

99 

100プルリクエストがドラフトである場合やフォークからのものである場合、自動レビューはスキップされるため、[コメントコマンドでレビューをリクエスト](#review-drafts-and-pull-requests-from-forks)してください。プルリクエストのレビューを受けるには、次のいずれかを行います。

101 

102* **オープンする、または ready にする**: **Once after PR creation** または **After every push** に設定されたリポジトリでは、プルリクエストをオープンまたは再オープンしたとき、あるいはドラフトを ready for review にしたときにレビューが開始されます。

103* **コマンドをコメントする**: プルリクエストに [`@claude review`](#comment-commands) を投稿します。

104* **コミットをプッシュする**: **After every push** に設定されたリポジトリ、または `@claude review always` でサブスクライブしたプルリクエストでは、プッシュによってレビューが開始されます。

105* **Re-run をクリックする**: フォークからではないプルリクエストでレビューが失敗またはタイムアウトした場合は、チェックランから[再実行](/docs/ja/code-review-troubleshooting#retrigger-a-failed-or-timed-out-review)します。

106* **自動再試行を待つ**: セッションが中断されたレビューは、自動的に 1 回再試行されます。再試行が行われている場合は、[チェックランのサマリー](/docs/ja/code-review-troubleshooting#retrigger-a-failed-or-timed-out-review)にその旨が表示されます。

107 

108<h3 id="comment-commands">

109 コメントコマンド

110</h3>

111 

112次のいずれかのコマンドをプルリクエストへのコメントとして投稿します。

113 

114| コマンド | 動作 | 使用するタイミング |

115| :- | :- | :- |

116| `@claude review` | 今後のプッシュに PR をサブスクライブせずに、1 回だけレビューを開始する | 今すぐ 1 回レビューしたい場合。たとえば Manual に設定されたリポジトリのプルリクエストや、他のモードですぐにもう一度レビューしたい場合 |

117| `@claude review always` | レビューを開始し、以降はプッシュでトリガーされるレビューに PR をサブスクライブする | 以降のプッシュごとに新しいレビューを開始したい場合。たとえば Manual に設定されたリポジトリの優先度の高い PR |

118| `@claude review once` | `@claude review` と同じ: サブスクライブせずに 1 回だけレビューを開始する | `@claude review` と同じケース |

119 

120これらのコマンドでレビューを開始するには、次の条件をすべて満たす必要があります。

121 

122* 新しいプルリクエストのトップレベルコメントとして投稿すること。差分の行へのインラインコメントやレビュー本文では機能しません。以前のコメントを編集しても対象になりません。

123* コマンドをコメントの先頭に置き、`always` をコマンドの他の部分と同じ行に書くこと。大文字と小文字は区別されません。

124* リポジトリに対する write、maintain、または admin 権限を持っていること。Claude はコメントした各ユーザーについて GitHub でこれを確認し、ボットからのコメントではレビューは開始されません。

125* プルリクエストがオープンであること。

126 

127コマンドが受け付けられると、**Code review queued...** というタイトルの **Claude Code Review** チェックランがプルリクエストに表示されます。レビューが開始されると、タイトルは **Code review in progress...** に変わります。Claude がコメントに 👀 でリアクションすることもありますが、このリアクションはレビューが開始されない場合にも表示されることがあるため、代わりにチェックランを確認してください。

128 

129プルリクエストの最新コミットですでにレビューが実行中の場合、新しいリクエストによって 2 つ目のレビューが開始されることはありません。

130 

131<Note>

132 2026 年 7 月のアップデート以前は、`@claude review` によって PR がプッシュでトリガーされるレビューにサブスクライブされていました。その動作に依存していた場合は、代わりに `@claude review always` をコメントしてください。

133</Note>

134 

135<h3 id="what-a-later-review-covers">

136 以降のレビューの対象範囲

137</h3>

138 

139プッシュ後など、自動的に開始される以降のレビューは、前回のレビュー以降に変更された部分に焦点を当て、Nit や既存の問題の指摘を少なく投稿します。そのサマリーには、除外した件数が "found and not posted" または "outside the scope of this re-review and not posted." で終わる行に記載されます。

140 

141これらを何も除外しないレビューを受けるには、[`@claude review`](#comment-commands) をコメントしてください。プルリクエスト全体が改めてレビューされます。

142 

143<h3 id="review-drafts-and-pull-requests-from-forks">

144 ドラフトとフォークからのプルリクエストをレビューする

145</h3>

146 

147自動レビューはこれらの両方をスキップするため、コメントコマンドでレビューをリクエストしてください。

148 

149* **ドラフトのプルリクエスト**: コメントコマンドはドラフトでも実行されるため、プルリクエストを ready にする前にレビューをリクエストできます。ドラフトへのプッシュでは、`@claude review always` の後でもレビューは開始されません。サブスクリプションは、プルリクエストを ready にした時点で有効になります。

150* **フォークからのプルリクエスト**: リポジトリの **Review runs** 設定にかかわらず、Claude はフォークからのプルリクエストを自動的にはレビューしません。レビューを開始するには、プルリクエストに `@claude review` をコメントします。[コメントコマンドの条件](#comment-commands)は引き続き適用され、必要な書き込み権限はフォークではなくベースリポジトリに対するものです。

151 

152フォークからのプルリクエストでも `@claude review always` は機能しますが、以降のプッシュでのレビューにプルリクエストがサブスクライブされることはありません。また、そこではチェックランの **Re-run** をクリックしてもレビューは開始されません。

153 

154<h3 id="use-code-review-alongside-the-claude-code-github-action">

155 Claude Code GitHub Action と併用する

156</h3>

157 

158リポジトリで [Claude Code GitHub Action](/docs/ja/github-actions) もデフォルトの `@claude` トリガーフレーズを使ったインタラクティブモードで実行している場合、`@claude review` コメントによって Action も開始されます。2 つを区別するには、Action の `trigger_phrase` 入力を別のフレーズに設定してください。

159 

160<h2 id="related-resources">

161 関連リソース

162</h2>

163 

164* [Code Review のトラブルシューティング](/docs/ja/code-review-troubleshooting): 開始されなかった、失敗した、または予算のためにスキップされたレビュー

165* [Code Review](/docs/ja/code-review): サービスの概要とレビューの実行方法

166* [Code Review をセットアップする](/docs/ja/code-review-setup): Owner 向け。Code Review をオンにし、レビューを実行するタイミングとレベルを選択する

167* [Code Review をカスタマイズする](/docs/ja/code-review-customize): `REVIEW.md` と `CLAUDE.md` で Claude が指摘する内容を変更する

168* [Code Review のコストと使用量](/docs/ja/code-review-costs): レビューの課金方法と支出上限の設定場所

169* [`/code-review` でローカルにレビューする](/docs/ja/code-review-local): Claude Code セッションからブランチのレビューを実行する

code-review-setup.md +189 −0 created

Details

1> ## Documentation Index

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

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

4 

5# Code Review を設定する

6 

7> Claude 組織で Code Review をオンにします。GitHub を接続し、Claude GitHub App をインストールし、リポジトリを選択して、レビューを実行するタイミングを設定します

8 

9Claude 組織の Owner は、claude.ai の [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) で Code Review をオンにします。レビューは Anthropic のインフラストラクチャ上で実行されるため、リポジトリにワークフローファイルを追加する必要はありません。

10 

11設定後は、各リポジトリでレビューの綿密さと実行タイミングを選択します。レビューレベルが高いほど、またレビューの実行頻度が高いほど費用は増えます。[Code Review のコスト](/docs/ja/code-review-costs#pricing)を参照してください。

12 

13<h2 id="what-you-need-to-turn-on-code-review">

14 Code Review をオンにするために必要なもの

15</h2>

16 

17まず、組織が [Code Review の対象](/docs/ja/code-review#availability)であることを確認します。次に、以下のアクセス権を自分が持っているか、持っている人がいることを確認します。

18 

19| アクセス権 | 必要となる作業 |

20| :- | :- |

21| Claude 組織での [Owner ロール](/docs/ja/server-managed-settings#access-control) | 管理ページでのすべての手順 |

22| GitHub 組織のオーナー | Claude GitHub App のインストールと、[Claude 組織へのリンク](/docs/ja/admin-setup#connected-github-accounts)。オーナーでない場合は、開始前にオーナーにアプリのインストールとリンクを依頼してください |

23| Claude に接続する GitHub アカウントでの、追加する各リポジトリへの書き込みアクセス権 | リポジトリの追加 |

24 

25<h2 id="turn-on-code-review">

26 Code Review をオンにする

27</h2>

28 

29<Steps>

30 <Step title="Allow code review スイッチをクリックする">

31 [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) の **Code review** セクションに移動し、**Allow code review** スイッチをクリックします。

32 

33 ダイアログが表示されずに Code Review がすぐにオンになった場合、組織ではすでに Claude GitHub App がリンクされているか、リポジトリが追加されています。[リポジトリをさらに追加する](#add-more-repositories)に進み、その後最後の手順に戻ってください。

34 </Step>

35 

36 <Step title="GitHub アカウントを接続する">

37 **Connect GitHub** ダイアログが開いた場合は、**Connect** をクリックします。組織で GitHub Enterprise Server を使用している場合は、先にダイアログでインスタンスを選択します。GitHub で Claude の認可を求められ、その後 **Add a repository** ダイアログが開いた状態で管理ページに戻ります。

38 

39 すぐに **Add a repository** が開いた場合は、アカウントがすでに接続されているため、次の手順に進んでください。

40 </Step>

41 

42 <Step title="Claude GitHub App をインストールする">

43 目的のリポジトリが **Add a repository** ダイアログに一覧表示されているか、そこで検索して見つかる場合は、次の手順に進みます。ダイアログには Claude GitHub App がアクセスできるリポジトリのみが表示されるため、表示されない場合はアプリをインストールします。

44 

45 * **Install GitHub App** をクリックします。リポジトリが 1 つも表示されていない場合はダイアログ内のボタンとして表示されます。それ以外の場合は、ダイアログの GitHub 組織フィルターメニューの下部にあります。GitHub のインストールページが新しいタブで開きます。

46 * リポジトリを所有する GitHub 組織を選択します。

47 * アプリがアクセスできるリポジトリを選択します。

48 * 要求された権限を承認します。この権限セットはレビューで使用する範囲より広く、[GitHub Actions](/docs/ja/github-actions) など他の Claude 機能と共有されます。[レビューがアクセスできる範囲](/docs/ja/code-review#what-a-review-can-access)と[権限の完全な一覧](/docs/ja/github-actions#github-app-permissions)を参照してください。

49 * インストールが完了すると、タブは Claude に戻ります。**Finish connecting GitHub** ボタンが表示された場合は、それをクリックしてインストールを Claude 組織にリンクします。

50 * 管理ページのタブに戻ると、ダイアログ内の一覧が更新されます。

51 </Step>

52 

53 <Step title="リポジトリを選択する">

54 レビュー対象にするリポジトリを選択し、**Continue** をクリックします。リポジトリを追加するには、接続した GitHub アカウントでそのリポジトリへの書き込みアクセス権が必要です。[リポジトリは後から追加](#add-more-repositories)することもできます。

55 </Step>

56 

57 <Step title="Finish をクリックする">

58 続いて **Code review is set up** ダイアログが表示されます。**Finish** をクリックすると Code Review がオンになります。それ以外の方法でダイアログを閉じた場合、リポジトリは追加されたままですが **Allow code review** はオフのままになるため、スイッチからオンにします。

59 

60 各リポジトリは最初、プッシュのたびにレビューする設定になっており、レビューの実行回数が最も多くなります。実行回数を減らすには、[レビューを実行するタイミングを設定](#set-when-reviews-run)してください。

61 </Step>

62 

63 <Step title="テスト用プルリクエストで確認する">

64 追加したリポジトリのいずれかでテスト用のプルリクエストを作成します。ドラフトにはしないでください。数分以内に **Claude Code Review** という名前のチェック実行が表示されます。リポジトリをすでに **Manual (@claude review)** に設定している場合は、プルリクエストに `@claude review` とコメントして最初のレビューを開始します。

65 

66 チェック実行が表示されない場合は、[No check run appears on the test pull request](/docs/ja/code-review-troubleshooting#no-check-run-appears-on-the-test-pull-request) を参照してください。

67 

68 レビューが届いたら、開発者に[プルリクエストでレビューを確認・リクエストする](/docs/ja/code-review-pull-requests)を共有してください。重大度レベル、コメントコマンド、指摘事項への対応方法が説明されています。

69 </Step>

70</Steps>

71 

72<h2 id="set-defaults-for-your-organization">

73 組織のデフォルトを設定する

74</h2>

75 

76Owner は、レビューの綿密さと実行頻度を決定します。どちらも [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) の **Code review** セクションにあります。

77 

78<h3 id="set-the-default-review-level">

79 デフォルトのレビューレベルを設定する

80</h3>

81 

82レビューレベルは各レビューの綿密さを決めるもので、綿密なレビューほど費用がかかります。組織に 1 つのデフォルトを設定し、個々のリポジトリで上書きできます。

83 

84| レベル | トレードオフ |

85| :- | :- |

86| Quick | 軽めのチェック。最も速く、費用も最も低いレベル |

87| Standard | 深さ、速度、費用のバランスを取ったレベル。デフォルトのレベル |

88| Deep | 最も綿密なチェック。最も時間がかかり、費用も最も高い |

89 

90* **組織のデフォルト**:**Review level** でレベルを選択し、**Change level** で確定します。リポジトリ個別のレベルを設定しない限り、すべてのリポジトリでこのレベルが使用されます。

91* **1 つのリポジトリ**:リポジトリの行の **Edit** をクリックし、そこで **Review level** を選択します。最初の選択肢である **Default** は組織の設定に従います。レベルは選択した時点で保存されます。

92 

93新しいレベルは、変更後に開始されるレビューに適用されます。各レビューの費用を左右するその他の要因については、[Code Review のコストと使用量](/docs/ja/code-review-costs)を参照してください。

94 

95<h3 id="set-when-reviews-run">

96 レビューを実行するタイミングを設定する

97</h3>

98 

99各リポジトリには個別の **Review runs** 設定があり、プルリクエストがレビューされるタイミングを決定します。

100 

101* **Once after PR creation**:プルリクエストが作成されたとき、再オープンされたとき、またはレビュー準備完了としてマークされたときにレビューが実行されます

102* **After every push**:プルリクエストのブランチへのプッシュごとにレビューが実行されます。プルリクエストの変化に合わせて新たな問題を検出し、指摘された問題を修正するとスレッドが自動的に解決されます

103* **Manual (@claude review)**:プルリクエストの作成やプッシュではレビューは開始されません。[`@claude review`](/docs/ja/code-review-pull-requests#comment-commands) とコメントしてレビューをリクエストするか、`@claude review always` とコメントして、以降のプッシュでもレビューを受けるようにプルリクエストを登録します。

104 

105Manual は、特定のプルリクエストだけをレビュー対象にしたいトラフィックの多いリポジトリや、準備が整ったプルリクエストだけをレビューしたい場合に便利です。各選択肢が費用に与える影響の比較については、[レビューの実行頻度](/docs/ja/code-review-costs#how-often-reviews-run)を参照してください。

106 

107設定を変更するには、**Repositories** テーブルでリポジトリの行の **Edit** をクリックし、**Review runs** の選択肢を選びます。選択は選んだ時点で保存され、テーブルの **Review runs** 列には Once per PR、Every push、Manual のいずれかの短縮表記で表示されます。

108 

109* **ドラフトとフォークからのプルリクエスト**:どの選択肢を選んでも、[自動レビューではどちらもスキップされます](/docs/ja/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)

110* **新しいリポジトリ**:**Add a repository** ダイアログから追加したリポジトリは **After every push** から始まります。その GitHub 組織が[組織全体として対象](#cover-a-whole-github-organization)になっている場合は、代わりにその組織の行の設定が適用されます。

111 

112<h3 id="turn-tip-comments-on-or-off">

113 ヒントコメントのオン/オフを切り替える

114</h3>

115 

116ヒントコメントとは、レビューが開始されなかったときに、その理由と次に行うことを Claude がプルリクエストに投稿する短いコメントです。**Show tips on pull requests** はデフォルトでオンです。オンの場合、Claude は次の各ケースでヒントを投稿し、以下を説明します。

117 

118* **リポジトリが Manual に設定されている**:コメントでレビューをリクエストする方法

119* **プルリクエストがフォークからのものである**:メンテナーがレビューをリクエストできること

120* **ボット、または書き込みアクセス権のないユーザーが `@claude review` とコメントした**:レビューが開始されなかったことと、誰がリクエストできるか

121* **GitHub 組織が Claude 組織にリンクされていない**:レビューが一時停止していることと、リンクする方法

122 

123これらのコメントを止めるには、設定をオフにします。

124 

125<h3 id="what-developers-can-change">

126 開発者が変更できること

127</h3>

128 

129レビューレベル、**Review runs** 設定、レビュー対象のリポジトリを変更したい場合、開発者は Owner に依頼します。Owner ロールを持たない開発者でも、GitHub から次の操作を行えます。

130 

131* **レビューをリクエストする**:プルリクエストに [`@claude review`](/docs/ja/code-review-pull-requests#comment-commands) とコメントします。リポジトリへの書き込みアクセス権が必要で、自動レビューではスキップされる[ドラフトとフォークからのプルリクエスト](/docs/ja/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)でも機能します。

132* **1 つのプルリクエストをプッシュごとのレビューに登録する**:Manual に設定されたリポジトリなどで、[ドラフトでもフォークからのものでもない](/docs/ja/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)プルリクエストに `@claude review always` とコメントします

133* **レビューで指摘される内容を変更する**:[`REVIEW.md` と `CLAUDE.md` ファイル](/docs/ja/code-review-customize)をリポジトリにコミットします。たとえばチェックを追加できます

134 

135開発者がリクエストしたレビューは[組織に課金されます](/docs/ja/code-review-costs#pricing)。Code Review の月間の支出を制限するには、[支出を制限する](/docs/ja/code-review-costs#limit-your-spend)を参照してください。

136 

137<h2 id="manage-repositories">

138 リポジトリを管理する

139</h2>

140 

141リポジトリは 1 つずつ追加することも、GitHub 組織全体をまとめて対象にすることもでき、不要な場所ではレビューを停止できます。

142 

143<h3 id="add-more-repositories">

144 リポジトリをさらに追加する

145</h3>

146 

147設定後にリポジトリを追加するには、**Code review** セクションの **Repositories** テーブルの上にある **Add** をクリックします。**Add a repository** ダイアログが開きます。リポジトリを選択し、**Continue** をクリックします。

148 

149* **リポジトリが一覧に表示されない**:[A repository isn't listed in Add a repository](/docs/ja/code-review-troubleshooting#a-repository-isn’t-listed-in-add-a-repository) を参照してください。

150* **GitHub 組織内のすべてのリポジトリを対象にしたい**:リポジトリを 1 つずつ選択する代わりに、[組織全体を対象にします](#cover-a-whole-github-organization)

151 

152<h3 id="cover-a-whole-github-organization">

153 GitHub 組織全体を対象にする

154</h3>

155 

156GitHub 組織内のすべてのリポジトリで Code Review をオンにするには、**Repositories** テーブルの組織の行で **Review runs** を設定します。これにより、Claude GitHub App がアクセスできるその組織内のすべてのリポジトリが対象になり、後から追加されるリポジトリも含まれます。支出が大幅に増える可能性があります。次のすべての条件を満たす必要があります。

157 

158* Claude に接続した GitHub アカウントが、その GitHub 組織のオーナーであること。

159* 組織が github.com 上にあること。GitHub Enterprise Server インスタンスと個人の GitHub アカウントは対象外です。

160* Claude 組織または Code Review に対して[月間の支出上限](/docs/ja/code-review-costs#limit-your-spend)が設定されていること。

161 

162組織を対象にするには、その行の **Edit** をクリックし、**Review runs** の選択肢を選んで確定します。選択肢は、[レビューを実行するタイミングを設定する](#set-when-reviews-run)の 3 つに **Off** を加えたものです。

163 

164確定すると、次の変更が適用されます。

165 

166* **対象範囲**:各リポジトリは次のプルリクエストから対象になります。Claude GitHub App がすべてのリポジトリではなく選択したリポジトリにインストールされていた場合、Claude はそれらのリポジトリをレビューします。残りも対象にするには、GitHub でアプリのリポジトリアクセスを変更してください。

167* **既存の設定**:その GitHub 組織内のすべてのリポジトリに選択した設定が適用され、個別に設定していたリポジトリも含まれます。行を再度設定した場合も同様です。各リポジトリの行でオフにしたリポジトリはオフのままです。

168* **その後の個別変更**:後から組織と異なる設定にしたリポジトリは、テーブルで **Custom** と表示されます。

169* **レビューレベル**:組織の行には独自のレビューレベルはありません。

170 

171<h3 id="turn-off-code-review-or-remove-a-repository">

172 Code Review をオフにする、またはリポジトリを削除する

173</h3>

174 

175[**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) の **Code review** セクションで、停止したい対象に応じたコントロールを選択します。

176 

177* **1 つのリポジトリ(一覧には残す)**:その行の **Edit** をクリックし、**Code review** をオフにします。テーブルではリポジトリが Off と表示されます。

178* **1 つのリポジトリ(削除する)**:その行の **Edit** をクリックし、ダイアログ下部の **Remove repository** をクリックします。そのリポジトリでのレビューは停止し、別の Claude 組織がそのリポジトリを設定できるようになります。リポジトリの GitHub 組織が組織全体として対象になっている間は削除できないため、代わりに **Code review** スイッチをオフにしてください。

179* **GitHub 組織全体**:組織の行の **Edit** をクリックし、**Off** を選択します。これにより、その組織内で 1 つずつ追加したリポジトリもオフになります。

180* **すべて**:**Allow code review** をオフにします。どのリポジトリでも新しいレビューは開始されず、リポジトリの一覧は保持されるため、後で再びオンにできます。

181 

182<h2 id="related-resources">

183 関連リソース

184</h2>

185 

186* [Code Review のコストと使用量](/docs/ja/code-review-costs):レビューレベルとレビューの実行タイミングが支出に与える影響、支出上限の設定方法、使用量の確認場所

187* [プルリクエストでレビューを確認・リクエストする](/docs/ja/code-review-pull-requests):開発者がプルリクエスト上で目にする内容とコメントコマンド

188* [Code Review をカスタマイズする](/docs/ja/code-review-customize):`REVIEW.md` と `CLAUDE.md` で Claude が指摘する内容を調整する

189* [GitHub Enterprise Server](/docs/ja/github-enterprise-server):設定前にセルフホストの GitHub インスタンスを接続する

code-review-troubleshooting.md +113 −0 created

Details

1> ## Documentation Index

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

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

4 

5# Code Review のトラブルシューティング

6 

7> 開始されなかった、失敗した、または予算のためにスキップされた Code Review の修正、表示されない指摘事項の確認、セットアップと `REVIEW.md` の問題の解決を行います。

8 

9プルリクエストで [Code Review](/docs/ja/code-review) が期待どおりに動作しない場合は、まず **Claude Code Review** チェック実行を確認してください。そのタイトルから、レビューがどこまで進んだかがわかります。

10 

11<h2 id="check-how-far-the-review-got">

12 レビューがどこまで進んだかを確認する

13</h2>

14 

15プルリクエストで **Claude Code Review** チェック実行を見つけ、そのタイトルを次のよくあるタイトルと照らし合わせてください。

16 

17| チェック実行のタイトル | 意味 | 対処方法 |

18| :- | :- | :- |

19| **Code review queued...** または **Code review in progress...** | レビューがまだ完了していません | タイトルが変わるまで待ちます |

20| **Code review found no issues** | レビューが完了し、指摘すべき点は見つかりませんでした | 対処は不要です |

21| 問題が見つかったことを示すタイトル | レビューが完了し、指摘事項があります | 差分上に表示されない場合は、[インラインコメントとして表示されない問題を見つける](#find-issues-that-aren’t-showing-as-inline-comments)を参照してください |

22| **Code review skipped — no new changes** | 最新のプッシュに対して自動レビューが実行されませんでした | それでもレビューを受けたい場合は、`@claude review` とコメントします |

23| **Code review failed** または **Code review timed out** | レビューが完了しませんでした | 再実行するには、[失敗またはタイムアウトしたレビューを再トリガーする](#retrigger-a-failed-or-timed-out-review)を参照してください |

24| **Code review declined** | レビューは実行されませんでした | チェック実行の概要を読んでください。予算または支出上限について記載されている場合は、[レビューが実行されず、PR に予算に関するメッセージが表示される](#review-didn’t-run-and-the-pr-shows-a-budget-message)を参照してください |

25| チェック実行なし | レビューが開始されていません | `@claude review` とコメントします。その後もチェック実行が表示されない場合は、[コメントコマンドでレビューが開始されなかった](#a-comment-command-didn’t-start-a-review)を参照してください |

26 

27<h2 id="a-review-didn’t-start">

28 レビューが開始されなかった

29</h2>

30 

31**Claude Code Review** チェック実行が表示されない場合、または Claude がレビューをスキップしたというコメントを投稿した場合は、次のケースを確認してください。

32 

33<h3 id="a-comment-command-didn’t-start-a-review">

34 コメントコマンドでレビューが開始されなかった

35</h3>

36 

37`@claude review` とコメントした後、プルリクエスト上に **Code review queued...** または **Code review in progress...** というタイトルの **Claude Code Review** チェック実行があるかを確認してください。コメントに 👀 リアクションが付いても、レビューが開始されることの確認にはなりません。チェック実行が表示されない場合は、次の各原因を確認してください。

38 

39* **このリポジトリで Code Review がオンになっていない**:Claude はコマンドに対してコメントもチェック実行も投稿しません。Owner に[リポジトリを追加する](/docs/ja/code-review-setup#add-more-repositories)よう依頼してください。

40* **コメントが条件を満たしていない**:新しいトップレベルのコメントではなく、インラインコメントやレビュー本文だった場合、またはコマンドがコメントの先頭になかった場合です。新しいコメントを投稿せずに以前のコメントを編集した場合も対象外で、プルリクエストはオープンである必要があります。[コメントコマンドの条件](/docs/ja/code-review-pull-requests#comment-commands)を確認し、条件を満たす新しいコメントを投稿してください。

41* **書き込みアクセス権がない**:リポジトリに対する write、maintain、または admin の権限が必要です。フォークからのプルリクエストの場合は、ベースリポジトリに対する権限が対象になります。組織でヒントがオンになっている場合、Claude は「No review was started: manual reviews can only be requested by someone with write access to this repository.」と返信します。書き込みアクセス権を持つ人に代わりにコメントしてもらってください。

42* **予算が尽きた**:Claude は「⚠️ Code review skipped」で始まるコメントを投稿します。[レビューが実行されず、PR に予算に関するメッセージが表示される](#review-didn’t-run-and-the-pr-shows-a-budget-message)を参照してください。

43 

44<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">

45 レビューが実行されず、PR に予算に関するメッセージが表示される

46</h3>

47 

48組織の予算でレビューをまかなえない場合、Code Review はレビューをスキップし、Claude はプルリクエストに「⚠️ Code review skipped」で始まるコメントを投稿します。場合によっては、**Code review declined** というタイトルのチェック実行も表示されます。

49 

50コメントには [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) へのリンクが含まれており、管理者はそこで予算を回復できます。コメントの文言から、どの上限に達したかがわかります。

51 

52* **「has reached its monthly code review spending cap」**:[Code Review の月間支出上限](/docs/ja/code-review-costs#limit-your-spend)に達しました。レビューは次の請求期間の開始時に再開されます。それより早く再開するには、管理者に上限の引き上げを依頼してください。

53* **「has no extra usage available to pay for this review」**:組織の[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)残高がなくなったか、組織全体の月間支出上限に達しました。管理者に使用クレジットの追加またはその上限の引き上げを依頼してください。

54* **「is too low to start another review」**:予算または残高の残りが、1 回のレビューにかかる想定コストを下回っています。管理者に上限の引き上げまたは使用クレジットの追加を依頼してください。

55 

56予算が回復したら、プルリクエストに `@claude review` とコメントして、スキップされたレビューを実行してください。[コメントコマンドの条件](/docs/ja/code-review-pull-requests#comment-commands)が適用されるため、コメントする人には書き込みアクセス権が必要です。

57 

58<h2 id="retrigger-a-failed-or-timed-out-review">

59 失敗またはタイムアウトしたレビューを再トリガーする

60</h2>

61 

62チェック実行の概要に「The review session was interrupted before it could finish. A new review of this commit has been queued automatically.」と表示されている場合は、何もする必要はありません。そのレビューは自動的に 1 回再試行されます。

63 

64それ以外で、チェック実行のタイトルが **Code review failed** または **Code review timed out** の場合は、コメントまたは再実行でレビューをもう一度実行してください。

65 

66* **`@claude review` とコメントする**:プルリクエストにトップレベルのコメントとして投稿します。これにより、プルリクエストを今後のプッシュの対象として登録することなく、新しいレビューが開始されます。

67* **Re-run をクリックする**:プルリクエストが[フォークからのもの](/docs/ja/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)でない場合は、GitHub の **Checks** タブで **Claude Code Review** チェックの **Re-run** をクリックします。再実行はプルリクエストの現在の head コミットを対象とし、こちらもプルリクエストを今後のプッシュの対象として登録しません。

68 

69<h2 id="find-issues-that-aren’t-showing-as-inline-comments">

70 インラインコメントとして表示されない問題を見つける

71</h2>

72 

73チェック実行のタイトルが問題が見つかったことを示しているのに、差分上にインラインのレビューコメントが表示されない場合は、指摘事項が表示される次の別の場所を確認してください。

74 

75* **チェック実行の Details**:**Checks** タブで **Claude Code Review** チェックの横にある **Details** をクリックします。重大度の表には、インラインコメントが受け付けられたかどうかにかかわらず、指摘事項がファイル、行、概要とともに一覧表示されます。

76* **Files changed のアノテーション**:PR の **Files changed** タブを開きます。行が特定されているもののインラインコメントとして投稿されなかった指摘事項は、該当する行のアノテーションとしてそこに表示されます。

77* **レビュー本文**:インラインの位置がない指摘事項や、現在の差分の範囲外にある指摘事項は、レビュー本文の **Additional findings** 見出しの下に表示されます。

78 

79<h2 id="the-check-run-mentions-review-md">

80 チェック実行に REVIEW\.md が記載されている

81</h2>

82 

83チェック実行に表示される `REVIEW.md` に関するメッセージのうち、次の 2 つはブランチ保護に関するものです。

84 

85* **「This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes.」**:レビューはルートのファイルのみを読み込みました。ブランチを保護すると何が変わるかについては、[REVIEW.md の読み込み元ブランチ](/docs/ja/code-review-customize#which-branch-review-md-is-read-from)を参照してください。

86* **「were not applied to this review: branch protection could not be confirmed」**:レビューは `REVIEW.md` を読み込みませんでした。

87 

88<h2 id="setup-problems">

89 セットアップの問題

90</h2>

91 

92これらのケースは、Owner が [Code Review をセットアップする](/docs/ja/code-review-setup)際に発生します。

93 

94<h3 id="a-repository-isn’t-listed-in-add-a-repository">

95 Add a repository にリポジトリが表示されない

96</h3>

97 

98ダイアログは長いリストをすべて読み込まないため、まずリポジトリを名前で検索してください。ダイアログには、Claude GitHub App がアクセスできるリポジトリのみが表示されます。**Install GitHub App** をクリックし、アプリにそのリポジトリへのアクセス権を付与してください。リポジトリが 1 つも表示されない場合、**Install GitHub App** はダイアログ内のボタンとして表示されます。それ以外の場合は、ダイアログの GitHub 組織フィルターメニューの下部にあります。

99 

100<h3 id="no-check-run-appears-on-the-test-pull-request">

101 テスト用のプルリクエストにチェック実行が表示されない

102</h3>

103 

104**Allow code review** がオンになっていること、**Code review** セクションの **Repositories** にリポジトリが表示されていること、Claude GitHub App がそのリポジトリにアクセスできることを確認してください。自動レビューはドラフトのプルリクエストをスキップします。また、**Manual (@claude review)** に設定されたリポジトリでは、最初のレビューを開始するために `@claude review` コメントが必要です。

105 

106<h2 id="related-resources">

107 関連リソース

108</h2>

109 

110* [プルリクエストでレビューを読む・依頼する](/docs/ja/code-review-pull-requests):指摘事項とチェック実行の意味、およびコメントコマンド

111* [Code Review をセットアップする](/docs/ja/code-review-setup):Owner 向けに、Code Review をオンにしてリポジトリを管理する方法

112* [Code Review のコストと使用量](/docs/ja/code-review-costs):予算に関するメッセージの原因となる支出上限

113* [Code Review をカスタマイズする](/docs/ja/code-review-customize):レビューがどの `REVIEW.md` を読み込むか

commands.md +2 −2

Details

72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。各サブコマンドが何をするか、および必要なバージョンについては、[Claude API プロジェクトで作業する](/docs/ja/skills#work-on-claude-api-projects)を参照してください |72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。各サブコマンドが何をするか、および必要なバージョンについては、[Claude API プロジェクトで作業する](/docs/ja/skills#work-on-claude-api-projects)を参照してください |

73| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラウザでタスクを実行させます。ページのテスト、フォームの入力、コンソールログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じて。Chrome 統合がセッションで有効な場合(たとえば `claude --chrome` など)、または Claude Code が[拡張機能をインストール](/docs/ja/chrome#install-the-extension-when-claude-asks)することを提案できる場合に利用可能です |73| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラウザでタスクを実行させます。ページのテスト、フォームの入力、コンソールログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じて。Chrome 統合がセッションで有効な場合(たとえば `claude --chrome` など)、または Claude Code が[拡張機能をインストール](/docs/ja/chrome#install-the-extension-when-claude-asks)することを提案できる場合に利用可能です |

74| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話に `/resume` ピッカーでラベルを付けるために名前を渡します。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用します。`/resume` で前の会話を再開するか、同じ Claude Code プロセスで、[rewind メニューの previous-session エントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から復元します。エイリアス:`/reset`、`/new` |74| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話に `/resume` ピッカーでラベルを付けるために名前を渡します。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用します。`/resume` で前の会話を再開するか、同じ Claude Code プロセスで、[rewind メニューの previous-session エントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から復元します。エイリアス:`/reset`、`/new` |

75| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在の差分、または渡す PR 番号、ブランチ、またはパスを正確性バグについてレビューします。モデルと effort レベルに応じて、レビューはクリーンアップの機会もカバーします。`--fix` を渡して検出結果を適用し、`--comment` を渡して GitHub PR または GitLab マージリクエストに投稿するか、`ultra` を渡してディープ[クラウドレビュー](/docs/ja/ultrareview)を実行します。GitLab マージリクエストに投稿するには Claude Code v2.1.257 以降が必要です。`github.com` PR ターゲットで `ultra` を使用する場合、`--post` を渡して [PR に完成した検出結果を投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)ことを起動ダイアログで事前選択します。`--post` には Claude Code v2.1.227 以降が必要です。effort レベル、ターゲット、および `/simplify` との関係については、[差分をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。エイリアス:`/review` |75| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在の差分、または渡す PR 番号、ブランチ、またはパスを正確性バグについてレビューします。モデルと effort レベルに応じて、レビューはクリーンアップの機会もカバーします。`--fix` を渡して検出結果を適用し、`--comment` を渡して GitHub PR または GitLab マージリクエストに投稿するか、`ultra` を渡してディープ[クラウドレビュー](/docs/ja/ultrareview)を実行します。GitLab マージリクエストに投稿するには Claude Code v2.1.257 以降が必要です。`github.com` PR ターゲットで `ultra` を使用する場合、`--post` を渡して [PR に完成した検出結果を投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)ことを起動ダイアログで事前選択します。`--post` には Claude Code v2.1.227 以降が必要です。effort レベル、ターゲット、および `/simplify` との関係については、[`/code-review` でローカルにレビューする](/docs/ja/code-review-local)を参照してください。エイリアス:`/review` |

76| `/color [color\|default]` | 現在のセッションのプロンプトバーのカラーを設定します。利用可能なカラー:`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を使用してリセットするか、引数なしで実行してランダムなカラーを選択します。[Remote Control](/docs/ja/remote-control) が接続されている場合、カラーは claude.ai/code に同期されます。非対話モード(`-p`)でも利用可能です |76| `/color [color\|default]` | 現在のセッションのプロンプトバーのカラーを設定します。利用可能なカラー:`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を使用してリセットするか、引数なしで実行してランダムなカラーを選択します。[Remote Control](/docs/ja/remote-control) が接続されている場合、カラーは claude.ai/code に同期されます。非対話モード(`-p`)でも利用可能です |

77| `/compact [instructions]` | ここまでの会話を要約してコンテキストを解放します。オプションで要約のフォーカス指示を渡します。[コンテキスト圧縮がルール、スキル、メモリファイルをどのように処理するか](/docs/ja/context-window#what-survives-compaction)を参照してください |77| `/compact [instructions]` | ここまでの会話を要約してコンテキストを解放します。オプションで要約のフォーカス指示を渡します。[コンテキスト圧縮がルール、スキル、メモリファイルをどのように処理するか](/docs/ja/context-window#what-survives-compaction)を参照してください |

78| `/config [key=value ...]` | [設定](/docs/ja/settings)インターフェイスを開いて、テーマ、モデル、[出力スタイル](/docs/ja/output-styles)、その他の設定を調整します。1 つ以上の `key=value` ペアを渡して、インターフェイスを開かずに設定を直接設定します。たとえば `/config thinking=false`、`/config theme=dark`、または `/config model=sonnet`。`key=value` 形式は非対話モード(`-p`)および Claude モバイルアプリから [Remote Control](/docs/ja/remote-control) 経由でも機能します。`key=value` 形式は、[`autoContinueAtUsageLimit`](/docs/ja/interactive-mode#turn-automatic-continue-off) などのパネルで確認が必要な設定をオンにすることはできませんが、オフにすることはできます。`/config --help` を実行して、受け入れるキーを一覧表示します。エイリアス:`/settings` |78| `/config [key=value ...]` | [設定](/docs/ja/settings)インターフェイスを開いて、テーマ、モデル、[出力スタイル](/docs/ja/output-styles)、その他の設定を調整します。1 つ以上の `key=value` ペアを渡して、インターフェイスを開かずに設定を直接設定します。たとえば `/config thinking=false`、`/config theme=dark`、または `/config model=sonnet`。`key=value` 形式は非対話モード(`-p`)および Claude モバイルアプリから [Remote Control](/docs/ja/remote-control) 経由でも機能します。`key=value` 形式は、[`autoContinueAtUsageLimit`](/docs/ja/interactive-mode#turn-automatic-continue-off) などのパネルで確認が必要な設定をオンにすることはできませんが、オフにすることはできます。`/config --help` を実行して、受け入れるキーを一覧表示します。エイリアス:`/settings` |


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

135| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非対話モード(`-p`)でも利用可能です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字に制限します。非表示文字を削除すると名前が空になる場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さ制限には Claude Code v2.1.221 以降が必要です |135| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非対話モード(`-p`)でも利用可能です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字に制限します。非表示文字を削除すると名前が空になる場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さ制限には Claude Code v2.1.221 以降が必要です |

136| `/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| `/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` |

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

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

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

140| `/run-skill-generator` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトごとの[スキル](/docs/ja/skills#run-and-verify-your-app)を書くことで、クリーンな環境からプロジェクトのアプリをビルド、起動、操作する方法を `/run` と `/verify` に教えます |140| `/run-skill-generator` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトごとの[スキル](/docs/ja/skills#run-and-verify-your-app)を書くことで、クリーンな環境からプロジェクトのアプリをビルド、起動、操作する方法を `/run` と `/verify` に教えます |

desktop.md +257 −3

Details

207* **Walk through in diff** をクリックすると、差分ビューが開き、結果を 1 つずつ確認できます。現在の差分内の結果は該当する行に表示され、そこで **Fix this one** をクリックするか、結果を却下できます。207* **Walk through in diff** をクリックすると、差分ビューが開き、結果を 1 つずつ確認できます。現在の差分内の結果は該当する行に表示され、そこで **Fix this one** をクリックするか、結果を却下できます。

208* **Apply fixes** をクリックすると、まだ未対応の結果を修正するよう Claude に依頼します。208* **Apply fixes** をクリックすると、まだ未対応の結果を修正するよう Claude に依頼します。

209 209 

210どのセッションでも、プロンプトボックスで Claude にレビュー結果の修正を依頼することもできます。`/code-review` が確認する内容と受け付ける引数については、[差分をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。210どのセッションでも、プロンプトボックスで Claude にレビュー結果の修正を依頼することもできます。`/code-review` が確認する内容と受け付ける引数については、[`/code-review` でローカルにレビューする](/docs/ja/code-review-local)を参照してください。

211 211 

212<h3 id="monitor-pull-request-status">212<h3 id="monitor-pull-request-status">

213 プルリクエストステータスを監視する213 プルリクエストステータスを監視する


859* **接続あたりのセッション数**:macOS と Linux の Desktop は、1 つの SSH 接続で複数のセッションを開きます。サーバーの `sshd_config` で `MaxSessions 1` が設定されている場合は、OpenSSH のデフォルトである 10 などに引き上げてください。859* **接続あたりのセッション数**:macOS と Linux の Desktop は、1 つの SSH 接続で複数のセッションを開きます。サーバーの `sshd_config` で `MaxSessions 1` が設定されている場合は、OpenSSH のデフォルトである 10 などに引き上げてください。

860* **インストールフォルダ**:Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。860* **インストールフォルダ**:Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。

861* **シェル**:リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります861* **シェル**:リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります

862* **ネットワーク**:Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](/docs/ja/network-config#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。862* **ネットワーク**:Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](/docs/ja/network-config#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンで、それらのリクエストにプロキシが必要な場合は、[SSH セッション用に設定してください](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)。

863 

864<h4 id="set-a-proxy-or-a-ca-certificate-for-ssh-sessions">

865 SSH セッションのプロキシまたは CA 証明書を設定する

866</h4>

867 

868Linux のリモートマシンがプロキシ経由でインターネットに接続する場合、または CA 証明書が必要な場合は、そのマシン上の `~/.claude/settings.json` の `env` に[プロキシと CA の変数](/docs/ja/network-config)を追加してください。そのマシンの `~/.profile`、`~/.bash_profile`、`~/.zprofile`、または `~/.zshrc` ですでにエクスポートしている場合でも追加してください。

869 

870そのマシンのターミナルで実行した `claude` がそれらのファイルから変数を取得する場合でも、SSH セッションはそれらのファイルから変数を取得しません。その結果、セッションが応答しなくなったり、**The connection from … to the API failed** や **Authentication failed** が表示されたりすることがあり、再度サインインしても解決しません。

871 

872<Steps>

873 <Step title="変数を追加する">

874 CA ファイルには [`NODE_EXTRA_CA_CERTS`](/docs/ja/network-config#custom-ca-certificates) を使用してください。Claude Code は `~/.claude/settings.json` の `SSL_CERT_FILE` に指定された CA を信頼しないためです。次の例では、プロキシと CA ファイルを設定します:

875 

876 ```json ~/.claude/settings.json theme={null}

877 {

878 "env": {

879 "HTTPS_PROXY": "http://proxy.example.com:8080",

880 "NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"

881 }

882 }

883 ```

884 </Step>

885 

886 <Step title="メッセージを再送信する">

887 そのファイルで追加または変更した変数は数秒以内に有効になるため、メッセージを再送信してください。それでも失敗する場合は、新しいセッションを開始してください。

888 </Step>

889</Steps>

890 

891<h5 id="find-a-proxy-or-ca-variable-set-elsewhere-on-the-remote-machine">

892 リモートマシンの別の場所で設定されたプロキシまたは CA の変数を見つける

893</h5>

894 

895Linux のリモートマシンがプロキシまたは CA の変数を別の場所で設定していないか確認してください。セッションはその値を使用し、[どの設定ファイルの値も無視する](/docs/ja/settings-reference#how-env-values-interact-with-your-shell)ためです:

896 

897<Steps>

898 <Step title="リモートマシンが設定する変数を一覧表示する">

899 コンピューターのターミナルで、自分のホストを指定して `ssh devbox env` を実行します。

900 </Step>

901 

902 <Step title="変数が設定されている場所で変更する">

903 一覧にその変数がある場合は、リモートマシン上の `~/.zshenv`、`/etc/environment`、`~/.bashrc` など、その変数を設定しているファイルで変更します。

904 </Step>

905 

906 <Step title="セッションに新しい値を渡す">

907 リモートマシンを再起動するか、[ヘルパーを削除する](#files-and-processes-on-the-remote-machine)手順の最初の 2 つのステップと同様に、Desktop を終了してヘルパーのプロセスを終了します。どちらの方法でも Claude の作業が中断されるため、タスクが実行されていないときに行ってください。

908 </Step>

909</Steps>

863 910 

864<h4 id="use-your-ssh-configuration-on-macos-and-linux">911<h4 id="use-your-ssh-configuration-on-macos-and-linux">

865 macOS と Linux で SSH 設定を使用する912 macOS と Linux で SSH 設定を使用する


892 939 

893**SSH host** フィールドに `devbox` と入力します。940**SSH host** フィールドに `devbox` と入力します。

894 941 

942<h5 id="reach-a-container-on-a-remote-machine">

943 リモートマシン上のコンテナに接続する

944</h5>

945 

946SSH ポートを公開していないコンテナ内でセッションを実行するには、`ProxyCommand` を使用してコンテナに接続してください。Desktop は接続先エントリの `RemoteCommand` を実行しないためです。エントリで `RemoteCommand` を使用してコンテナに入っている場合、セッションはコンテナ内ではなく、エントリがログインするマシン上で実行されます。

947 

948<Steps>

949 <Step title="エントリを追加する">

950 次のエントリを `~/.ssh/config` の末尾に追加するか、`Host *` エントリがある場合は最初の `Host *` エントリの直前に追加します。Docker コンテナ `devbox`、そのユーザー `dev`、マシン `build.example.com` は自分のものに置き換えてください。このエントリのコマンドは、接続ごとにコンテナ内で SSH サーバーを起動します:

951 

952 ```text ~/.ssh/config theme={null}

953 Host devbox-container

954 User dev

955 ProxyCommand ssh build.example.com docker exec -i devbox /usr/sbin/sshd -i

956 ```

957 </Step>

958 

959 <Step title="コンテナを準備する">

960 * OpenSSH サーバーをインストールし、イメージを再ビルドしたりコンテナを再作成したりしても変わらないホスト鍵を用意します

961 * `User` で指定したアカウントに、`authorized_keys` ファイルなどのログイン手段を用意します

962 * コンテナが[リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)を満たしていることを確認します

963 </Step>

964 

965 <Step title="許可リストを確認する">

966 管理者が [SSH ホストを制限している](#restrict-which-ssh-hosts-users-can-connect-to)場合は、コンピューターのターミナルで `ssh -G devbox-container` を実行します。出力される `hostname`(ここでは `devbox-container`)を `sshHostAllowlist` で許可するよう管理者に依頼してください。管理者がその名前を許可すると、エントリの `ProxyCommand` が接続する先はどこであっても許可されることになります。

967 </Step>

968 

969 <Step title="エントリをテストしてから接続する">

970 コンピューターのターミナルで `ssh devbox-container` を実行します。報告された問題を修正し、何も尋ねられずにコンテナ内でシェルが開くまで繰り返し実行します:

971 

972 * **`ssh` がパスワード、パスフレーズ、またはコードを求める場合**:SSH エージェントが保持する鍵など、プロンプトなしで機能するログインに切り替えます

973 * **`ssh` が `Cannot execute command-line and remote command.` または `Bad packet length` を報告する場合**:`build.example.com` のエントリから `RemoteCommand` と `RequestTTY` を削除します。その後は、コンピューターのターミナルで `ssh build.example.com` を実行すると、コンテナ内ではなくそのマシン上でシェルが開きます。

974 * **`ssh` が `Connection closed by UNKNOWN port 65535` を報告する場合**:同じターミナルで `ssh build.example.com docker exec devbox /usr/sbin/sshd -t` を実行します。

975 * `Missing privilege separation directory: /run/sshd` と出力された場合は、コンテナ内にそのフォルダを作成します。

976 * `no hostkeys available` と出力され、コンテナにホスト鍵がある場合は、このコマンドとエントリの両方で `exec` の後に `-u root` を追加します。

977 

978 その後、**SSH host** フィールドに `devbox-container` と入力します。

979 </Step>

980</Steps>

981 

895<h5 id="use-variables-from-your-shell-in-a-proxycommand">982<h5 id="use-variables-from-your-shell-in-a-proxycommand">

896 `ProxyCommand` でシェルの変数を使用する983 `ProxyCommand` でシェルの変数を使用する

897</h5>984</h5>


900 987 

901これには Claude Desktop v2.37337.0 以降と、`-0` を受け付ける `env` コマンドが必要です。これはコンピューターのターミナルで `env -0` を実行して確認できます。988これには Claude Desktop v2.37337.0 以降と、`-0` を受け付ける `env` コマンドが必要です。これはコンピューターのターミナルで `env -0` を実行して確認できます。

902 989 

990<Note>

991 シェルが一時的な AWS 認証情報を設定する場合は、`AWS_*` 変数をエクスポートする代わりに、[AWS CLI にプロファイルを指定してください](#use-aws-credentials-in-a-proxycommand)。

992</Note>

993 

994<a id="use-aws-credentials-in-a-proxycommand" />

995 

996<h5 id="use-aws-credentials-in-a-proxycommand">

997 `ProxyCommand` で AWS 認証情報を使用する

998</h5>

999 

1000シェル起動ファイルで一時的な AWS 認証情報を設定している場合、AWS CLI を実行する `ProxyCommand` は、ターミナルでは接続できても Desktop では失敗することがあります。シェルが `AWS_SESSION_TOKEN`、`AWS_SECURITY_TOKEN`、または `AWS_CREDENTIAL_EXPIRATION` をエクスポートしていると、Desktop の `ssh` と `ProxyCommand` は、シェルの AWS 認証情報、`AWS_REGION`、`AWS_PROFILE` を取得しません。

1001 

1002AWS CLI にリージョンや認証情報の他の取得元がない場合、`You must specify a region` または `Unable to locate credentials` で失敗します。Desktop から接続するには、AWS CLI が `~/.aws/config` から読み取るプロファイルを指定します:

1003 

1004<Steps>

1005 <Step title="リージョンと認証情報の取得元を持つプロファイルを追加する">

1006 次の例では、ヘルパープログラムから認証情報を取得する `corp` という名前のプロファイルを追加します:

1007 

1008 ```ini ~/.aws/config theme={null}

1009 [profile corp]

1010 region = us-east-1

1011 credential_process = /full/path/to/your-credential-helper

1012 ```

1013 

1014 * **`region`**:接続先マシンの AWS リージョンを指定します

1015 * **`credential_process`**:[AWS がドキュメントで定めている JSON 形式](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sourcing-external.html)で認証情報を出力するプログラムのフルパスを指定します。AWS CLI は、不在中の再接続を含め、接続のたびにこのプログラムを実行するため、ユーザーの入力を必要としないプログラムを選んでください。

1016 * **IAM Identity Center**:`credential_process` の代わりに、プロファイルの [IAM Identity Center 設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html)を追加します。接続する前と、そのサインインの期限が切れたときに、ターミナルで `aws sso login --profile corp` を実行します。

1017 </Step>

1018 

1019 <Step title="ProxyCommand でプロファイルを指定する">

1020 次の例では、[AWS が Session Manager 用にドキュメントで示しているコマンド](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-getting-started-enable-ssh-connections.html)に `--profile` を追加します:

1021 

1022 ```text ~/.ssh/config theme={null}

1023 Host i-*

1024 ProxyCommand sh -c "aws ssm start-session --profile corp --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"

1025 ```

1026 </Step>

1027 

1028 <Step title="再度接続する">

1029 ターミナルでホストを指定して `ssh` を実行し、エントリがそこで引き続き接続できることを確認してから、Desktop から接続します。

1030 </Step>

1031</Steps>

1032 

903<h5 id="raise-the-ssh-connection-timeout">1033<h5 id="raise-the-ssh-connection-timeout">

904 SSH 接続のタイムアウトを延長する1034 SSH 接続のタイムアウトを延長する

905</h5>1035</h5>


916 1046 

917`ssh` はホストに対して最初に見つかった値を使用するため、このエントリは `ConnectTimeout` を設定する `Host *` エントリよりも上に配置してください。確認するには、コンピューターのターミナルで `ssh -G devbox` を実行します。その出力には `connecttimeout 120` が含まれます。値を変更した後は、Desktop を終了して再度開いてください。1047`ssh` はホストに対して最初に見つかった値を使用するため、このエントリは `ConnectTimeout` を設定する `Host *` エントリよりも上に配置してください。確認するには、コンピューターのターミナルで `ssh -G devbox` を実行します。その出力には `connecttimeout 120` が含まれます。値を変更した後は、Desktop を終了して再度開いてください。

918 1048 

1049リモートマシン自体がスマートフォンでの承認を待つ場合は、`ConnectTimeout` の設定にかかわらず、45 秒以内に承認してください。Desktop が `ServerAliveInterval` と `ServerAliveCountMax` を独自に設定し、リモートマシンがその間何も送信しないログインを `ssh` が閉じるため、この制限は延長できません。代わりにジャンプホストまたは `ProxyCommand` がユーザーを待つ場合は、リモートマシンのエントリの `ConnectTimeout` を延長して、その時間をカバーしてください。

1050 

1051<h5 id="fix-a-match-host-block-that-only-desktop-applies">

1052 Desktop だけが適用する `Match host` ブロックを修正する

1053</h5>

1054 

1055ターミナルの `ssh devbox` では使用されない設定を Desktop が使用する場合は、エントリの `HostName` 行より上にある `Match host` ブロックを探してください。ターミナルでは、`ssh` はその位置のブロックを `HostName` 行より前に読み取るため、ブロックを `devbox` と比較します。Desktop はコマンドラインで `ssh` に `HostName` の値を渡すため、`ssh` はブロックをその値と比較します。

1056 

1057確認するには、Desktop と同様に、エントリの `HostName` と `User` の値をコマンドラインで指定して、コンピューターのターミナルで `ssh -G` を実行します:

1058 

1059```bash theme={null}

1060ssh -G -o HostName=devbox.internal.example.com -l alice devbox

1061```

1062 

1063その出力を `ssh -G devbox` の出力と比較します。`proxycommand` などのブロックの設定が最初の出力にのみ表示される場合、そのブロックは Desktop でのみ有効になります。Desktop でもスキップされるようにするには、その `Match` 行に `!originalhost devbox` を追加します:

1064 

1065```text ~/.ssh/config theme={null}

1066Match host *.internal.example.com !originalhost devbox

1067```

1068 

1069確認するには、最初のコマンドを再度実行します。ブロックの設定は出力に表示されなくなります。

1070 

919<h5 id="forwarding-settings-that-desktop-leaves-off">1071<h5 id="forwarding-settings-that-desktop-leaves-off">

920 Desktop がオフにする転送設定1072 Desktop がオフにする転送設定

921</h5>1073</h5>


1154 </Step>1306 </Step>

1155 1307 

1156 <Step title="プロセスを終了する">1308 <Step title="プロセスを終了する">

1157 リモートマシンにそのユーザーとしてログインし、[`pgrep`](#files-and-processes-on-the-remote-machine) が一覧表示する各プロセス ID を指定して `kill` を実行します。1309 リモートマシンにそのユーザーとしてログインし、[`pgrep`](#files-and-processes-on-the-remote-machine) が一覧表示する各 Claude Code プロセスの ID を指定して `kill` を実行します。それらが一覧から消えたら、各 `server` プロセスの ID を指定して `kill` を実行します。先に `server` プロセスを終了すると、Claude Code が実行中のコマンドが実行を続けることがあります。

1310 

1311 次に、`ps -u "$(id -un)" -f` などでユーザーの残りのプロセスを一覧表示し、Claude Code が起動したと分かるものを終了します。Claude Code がバックグラウンドに残したプログラムは、`pgrep` の一覧に含まれないまま、Claude Code の終了後も実行を続けることがあります。

1158 </Step>1312 </Step>

1159 1313 

1160 <Step title="フォルダを削除する">1314 <Step title="フォルダを削除する">


1170 1324 

1171worktree を持つセッションをアーカイブする前に、[セッションで並行作業する](#work-in-parallel-with-sessions)を参照してください。1325worktree を持つセッションをアーカイブする前に、[セッションで並行作業する](#work-in-parallel-with-sessions)を参照してください。

1172 1326 

1327<h5 id="see-which-user-the-processes-run-as">

1328 プロセスを実行するユーザーを確認する

1329</h5>

1330 

1331ヘルパーと Claude Code は、Desktop が SSH でログインするユーザーとして実行されます。これらのインストールと起動に `sudo` は必要ありません。ユーザーを確認するには、[`pgrep`](#files-and-processes-on-the-remote-machine) が一覧表示するプロセス ID を指定して、リモートマシンで `ps -o user= -p` を実行します。

1332 

1333シェルコマンドや MCP サーバーなど、Claude Code が起動するプログラムも、そのユーザーとして起動します。そこでコマンドを実行する人に対して行うのと同様に、`sudo` ルールを含め、リモートマシン上のそのユーザーの権限を確認してください。

1334 

1173<h5 id="see-who-connected-to-the-remote-machine">1335<h5 id="see-who-connected-to-the-remote-machine">

1174 リモートマシンに接続したユーザーを確認する1336 リモートマシンに接続したユーザーを確認する

1175</h5>1337</h5>

1176 1338 

1177リモートマシンに誰が接続したかを確認するには、そのマシン上の SSH サーバーのログを読みます。ログでは、Desktop からのログインはターミナルからのログインと同じように表示されます。macOS または Linux の Desktop では、エントリはセッションごとではなく、Desktop が接続するたびに記録されます。1339リモートマシンに誰が接続したかを確認するには、そのマシン上の SSH サーバーのログを読みます。ログでは、Desktop からのログインはターミナルからのログインと同じように表示されます。macOS または Linux の Desktop では、エントリはセッションごとではなく、Desktop が接続するたびに記録されます。

1178 1340 

1341Desktop の SSH 接続は、Claude Code の[メトリクスとイベント](/docs/ja/monitoring-usage#available-metrics-and-events)には含まれません。そこから SSH セッションがどのリモートマシンで実行されたかを確認するには、[Desktop SSH セッションにテレメトリを関連付ける](/docs/ja/monitoring-usage#attribute-telemetry-to-desktop-ssh-sessions)を参照してください。Desktop 自体の接続記録については、[SSH の問題について Desktop のログを取得する](#get-desktops-logs-for-an-ssh-problem)を参照してください。

1342 

1343<h4 id="connections-that-close-before-login">

1344 ログイン前に閉じる接続

1345</h4>

1346 

1347SSH サーバーのログに、ログイン前に閉じる接続が記録されている場合、それは Desktop による SSH ポートのテストである可能性があります。Desktop は、たとえばマシンへの接続が失敗した後などに、マシンが応答するかどうかをテストします。ポートへの接続を開き、何も送信せずにすぐに閉じます。テストは 1 回の場合もあれば、たとえば約 2 分間に 8 回など、連続して複数回行われる場合もあります。

1348 

1349そのような接続に対してアドレスを禁止または拒否する仕組みがない場合は、Desktop のテストについて何もする必要はありません。Desktop の接続元アドレスが拒否または禁止される場合は、[SSH サーバー自体がそのアドレスを拒否しているかどうか](#check-whether-the-ssh-server-itself-refuses-the-address)と、[fail2ban が Desktop のテストをカウントしているかどうか](#check-whether-fail2ban-counts-desktops-tests)を確認してください。

1350 

1351<h5 id="recognize-a-test-in-the-ssh-server’s-log">

1352 SSH サーバーのログでテストを識別する

1353</h5>

1354 

1355ログの行を、Linux 上の OpenSSH サーバーがデフォルトの `LogLevel` でテストについて書き込む行と、サーバーのバージョンに対応する行で比較してください。Desktop が接続を閉じる前にサーバーのグリーティングが届いた場合は、代わりに最後の列の行が表示されることがあります。

1356 

1357| OpenSSH のバージョン | テストの行 | グリーティングが先に届いた場合の行 |

1358| - | - | - |

1359| 6.6 から 7.9 | `Did not receive identification string from 203.0.113.7` を含む行 | 同じ行 |

1360| 8.0 から 8.2 | `error: kex_exchange_identification: Connection closed by remote host` | `error: kex_exchange_identification: read: Connection reset by peer` |

1361| 8.3 から 9.4 | `error: kex_exchange_identification: Connection closed by remote host`、続いて `Connection closed by 203.0.113.7 port 51234` | `error: kex_exchange_identification: read: Connection reset by peer`、続いて `Connection reset by 203.0.113.7 port 51234` |

1362| 9.5 から 10.2 | `Connection closed by 203.0.113.7 port 51234` | `error: kex_exchange_identification: read: Connection reset by peer`、続いて `Connection reset by 203.0.113.7 port 51234` |

1363| 10.3 から 10.5 | `Connection closed by 203.0.113.7 port 51234 [preauth]` | `error: kex_exchange_identification: read: Connection reset by peer [preauth]`、続いて `Connection reset by 203.0.113.7 port 51234 [preauth]` |

1364 

1365ポートを開いて閉じる他のプログラムも、同じ行を残すことがあります。行にアドレスがある場合は、それが Desktop を使用するコンピューターの接続元アドレスであることを確認してください。

1366 

13678.0 から 8.2 の行にはアドレスがありません。アドレスを取得するには、`sshd_config` で `LogLevel VERBOSE` を設定し、root として `sshd -T | grep -i loglevel` を実行します。`loglevel VERBOSE` と出力された場合は、SSH サーバーをリロードします。その後、テストの行の前にある `Connection from 203.0.113.7 port 51234` を含む行を探してください。

1368 

1369<a id="check-whether-the-ssh-server-itself-refuses-the-address" />

1370 

1371<h5 id="check-whether-the-ssh-server-itself-refuses-the-address">

1372 SSH サーバー自体がアドレスを拒否しているかどうかを確認する

1373</h5>

1374 

1375Desktop を使用する多数のコンピューターが共有するアドレスからの接続が拒否される場合は、SSH サーバーのログで次のように終わる行を探してください。

1376 

1377```text theme={null}

1378drop connection #0 from [203.0.113.7]:51234 on [192.0.2.10]:22 penalty: connections without attempting authentication

1379```

1380 

1381デフォルトの `LogLevel` では、OpenSSH 9.8 以降は、Desktop のテストのようにログインを試みずに閉じた接続を理由にアドレスを拒否する際に、このような行を書き込むことがあります。デフォルト設定では、数回のテストだけでこのような行が表示されることはありません。

1382 

1383拒否を防ぐには、`sshd_config` で `PerSourcePenaltyExemptList` を接続元のアドレスに設定します(例: `PerSourcePenaltyExemptList 203.0.113.7`)。サーバーはそれらのアドレスに対して、ログイン失敗に対するものを含め、どのペナルティも適用しなくなります。ファイルを確認するには、root として `sshd -T | grep -i persourcepenalt` を実行します。リストが出力された場合は、SSH サーバーをリロードしてください。

1384 

1385<a id="check-whether-fail2ban-counts-desktops-tests" />

1386 

1387<h5 id="check-whether-fail2ban-counts-desktop’s-tests">

1388 fail2ban が Desktop のテストをカウントしているかどうかを確認する

1389</h5>

1390 

1391fail2ban 0.10.5 以降が Desktop の接続元アドレスを禁止した場合は、`jail.conf`、`jail.local`、または `jail.d/` の下で jail のモードを確認します。

1392 

1393* **角かっこ内でモードを指定する `filter` 行**(`filter = sshd[mode=aggressive]` など)がある場合: そのモードを使用します。

1394* **標準の `filter` 行**(`[mode=%(mode)s]`)のみの場合: `mode` 行を使用し、ない場合は `normal` を使用します。

1395 

1396モードが `normal` の場合、fail2ban は Desktop のテストの行をカウントしないため、禁止の別の原因を探してください。

1397 

1398それ以外のモードの場合は、自分のログの行をリモートマシン上のファイルにコピーします。各行を日付から末尾まで丸ごとコピーし、テストが 2 行を残す場合は両方の行をコピーします。そこで、ファイルと jail のモード(たとえば `aggressive`)を指定して `fail2ban-regex` を実行します。

1399 

1400```bash theme={null}

1401fail2ban-regex -o ip lines.log "sshd[mode=aggressive]"

1402```

1403 

1404fail2ban がカウントする失敗ごとに、コマンドは `203.0.113.7` のようにアドレスを 1 行ずつ出力します。その場合は、[禁止を防いで](#prevent-a-ban-by-fail2ban)ください。何も出力されない場合、fail2ban はそのモードではそれらの行を 1 つもカウントしていないため、禁止の別の原因を探してください。

1405 

1406<a id="prevent-a-ban-by-fail2ban" />

1407 

1408<h5 id="prevent-a-ban-by-fail2ban">

1409 fail2ban による禁止を防ぐ

1410</h5>

1411 

1412fail2ban が Desktop のテストを理由にアドレスを禁止しないようにするには、jail の 2 つの設定のいずれかを変更します。どちらにも代償があります。

1413 

1414* **`mode`**: jail で設定されている箇所(`mode` 行、または `filter = sshd[mode=aggressive]` のような行の角かっこ内)で `normal` に設定します。ログインを試みずに接続して切断するクライアントのカウントなど、他のモードでのみ行われるカウントはすべて行われなくなります。

1415* **`ignoreip`**: 接続元のアドレスに設定します(例: `ignoreip = 203.0.113.7`)。fail2ban は、ログイン失敗を含め、それらのアドレスからのものを一切カウントしなくなります。

1416 

1179<h4 id="use-mcp-servers-set-up-on-the-remote-machine">1417<h4 id="use-mcp-servers-set-up-on-the-remote-machine">

1180 リモートマシンで設定した MCP サーバーを使用する1418 リモートマシンで設定した MCP サーバーを使用する

1181</h4>1419</h4>


1682 1920 

1683その他のメッセージについては、[リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)を確認してください。1921その他のメッセージについては、[リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)を確認してください。

1684 1922 

1923<a id="get-desktops-logs-for-an-ssh-problem" />

1924 

1925<h3 id="get-desktop’s-logs-for-an-ssh-problem">

1926 SSH の問題について Desktop のログを取得する

1927</h3>

1928 

1929Desktop の SSH 接続の記録である `ssh.log` は、**Help** メニューから保存する Desktop のログの zip ファイルに含まれています。保存するには、**Help > Troubleshooting** を開き、使用しているシステムに対応する項目を選択します:

1930 

1931* **macOS**:**Show Logs in Finder**

1932* **Windows**:**Show Logs in File Explorer**

1933* **Linux**:**Show Logs in File Manager**

1934 

1935ファイルには環境内の名前やその他の詳細が含まれる可能性があるため、送信する前に内容を確認してください。`<host>` と `<user>` は、Desktop が置き換えた名前を表します。Desktop はすべての名前を置き換えるわけではなく、SSH のホスト名やユーザー名が記述されたまま表示される場合もあります。zip ファイルを誰かに送信する場合は、ログにホスト名が記載されていない可能性があるため、どのホストでいつ失敗したかを伝えてください。

1936 

1937zip ファイルには、Desktop がリモートマシンにインストールするヘルパープログラムのログは含まれていません。そのログも取得するには、接続したユーザーのホームディレクトリにある [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine) 配下のヘルパーのフォルダから `remote-server.log` をコピーします。このファイルも送信する前に内容を確認してください。

1938 

1685<h3 id="app-won’t-quit">1939<h3 id="app-won’t-quit">

1686 アプリが終了しない1940 アプリが終了しない

1687</h3>1941</h3>

env-vars.md +3 −1

Details

225| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0` に設定すると、新しい[アーティファクト](/docs/ja/artifacts#create-an-artifact)が公開されたときに Claude Code がブラウザを自動的に開かないようにします |225| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0` に設定すると、新しい[アーティファクト](/docs/ja/artifacts#create-an-artifact)が公開されたときに Claude Code がブラウザを自動的に開かないようにします |

226| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0` に設定すると、Claude が[アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読んで返信しないようにします。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` によって[アーティファクトがオフになっている](/docs/ja/artifacts#availability)場合は効果がありません。Claude Code v2.1.221 以降が必要です |226| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0` に設定すると、Claude が[アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読んで返信しないようにします。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` によって[アーティファクトがオフになっている](/docs/ja/artifacts#availability)場合は効果がありません。Claude Code v2.1.221 以降が必要です |

227| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0` に設定すると、Claude が[自身に送信されたコメントに自動で返信する](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)のを停止します。Claude Code v2.1.228 以降が必要です |227| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0` に設定すると、Claude が[自身に送信されたコメントに自動で返信する](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)のを停止します。Claude Code v2.1.228 以降が必要です |

228| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | `0` に設定すると、Claude が[アーティファクト](/docs/ja/artifacts#update-an-artifact)の公開処理の一環としてファイルに小さな変更を適用しないようにします。その場合、Claude はファイル編集ツールでファイルを編集し、別のステップとして公開します。Claude Code v2.1.300 以降が必要です |

228| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0` に設定すると、クライアントのバージョンとプロンプトのフィンガープリントを含む[帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)を、システムプロンプトの先頭から省略します。Anthropic API への直接接続でのキャッシュは、どちらの場合も影響を受けません。一部の直接接続構成では、`0` を設定した場合でも、Claude Code は [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)の分類器リクエストでブロックを保持します。どの接続と認証情報が対象になるかは、[システムプロンプトの帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)で確認してください。v2.1.181 より前は、カスタムベース URL と Microsoft Foundry の接続ではブロックにリクエストごとのトークンが含まれていました。そのため、それらのバージョンでは、LLM ゲートウェイがリクエストボディに基づいてキャッシュする場合、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合に `0` に設定してください |229| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0` に設定すると、クライアントのバージョンとプロンプトのフィンガープリントを含む[帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)を、システムプロンプトの先頭から省略します。Anthropic API への直接接続でのキャッシュは、どちらの場合も影響を受けません。一部の直接接続構成では、`0` を設定した場合でも、Claude Code は [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)の分類器リクエストでブロックを保持します。どの接続と認証情報が対象になるかは、[システムプロンプトの帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)で確認してください。v2.1.181 より前は、カスタムベース URL と Microsoft Foundry の接続ではブロックにリクエストごとのトークンが含まれていました。そのため、それらのバージョンでは、LLM ゲートウェイがリクエストボディに基づいてキャッシュする場合、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合に `0` に設定してください |

229| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用してください |230| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用してください |

230| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)をトークン単位で `100000` から `1000000` の範囲で設定します。`500000` のようなプレーンな整数のみを受け付けます。`500k` のような値は `500` として読み取られ、最小値の 100K に制限されます。実際のウィンドウは、モデルのコンテキストウィンドウが上限になります。`/autocompact` コマンド、`--autocompact` フラグ、`autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルのコンテキストウィンドウ全体を基準に測定されるため、この変数を設定すると、そのパーセンテージはコンテキスト圧縮が実行されるタイミングを示さなくなります |231| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)をトークン単位で `100000` から `1000000` の範囲で設定します。`500000` のようなプレーンな整数のみを受け付けます。`500k` のような値は `500` として読み取られ、最小値の 100K に制限されます。実際のウィンドウは、モデルのコンテキストウィンドウが上限になります。`/autocompact` コマンド、`--autocompact` フラグ、`autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルのコンテキストウィンドウ全体を基準に測定されるため、この変数を設定すると、そのパーセンテージはコンテキスト圧縮が実行されるタイミングを示さなくなります |


332| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | [アイドル時のコンテキスト圧縮](/docs/ja/settings-reference#idlecompaction)が会話に適用されるコンテキストサイズ(トークン数)(デフォルト: `200000`)。正の整数を受け付け、それ以外は無視されます。`100000` 未満の値は、最小しきい値である `100000` に引き上げられます。アイドル時の圧縮は、条件を満たす会話ではデフォルトでオンです。オフにするには、`idleCompaction` を `false` に設定してください。Claude Code v2.1.290 以降が必要です |333| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | [アイドル時のコンテキスト圧縮](/docs/ja/settings-reference#idlecompaction)が会話に適用されるコンテキストサイズ(トークン数)(デフォルト: `200000`)。正の整数を受け付け、それ以外は無視されます。`100000` 未満の値は、最小しきい値である `100000` に引き上げられます。アイドル時の圧縮は、条件を満たす会話ではデフォルトでオンです。オフにするには、`idleCompaction` を `false` に設定してください。Claude Code v2.1.290 以降が必要です |

333| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数(デフォルト: 20)。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |334| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数(デフォルト: 20)。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |

334| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルについて想定するコンテキストウィンドウのサイズを上書きします。v2.1.193 以降、適用方法は Claude Code がモデル ID をどのように解決するかによって異なります。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を介してルーティングするモデルのコンテキストウィンドウが、その名前に対応する組み込みのサイズと一致しない場合に使用します |335| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルについて想定するコンテキストウィンドウのサイズを上書きします。v2.1.193 以降、適用方法は Claude Code がモデル ID をどのように解決するかによって異なります。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を介してルーティングするモデルのコンテキストウィンドウが、その名前に対応する組み込みのサイズと一致しない場合に使用します |

335| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する、各 MCP ツールの説明と各 MCP サーバーの指示の最大長(文字数)。設定した値は、両方の [デフォルトの制限](/docs/ja/mcp#for-mcp-server-authors)(4096、および Claude がツール検索を通じて読み込むツールの説明については 16384)を置き換えます。Claude Code はそれより長いテキストを切り詰めます。数字のみの正の整数を受け付けます。それ以外は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |336| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する MCP ツールの説明と MCP サーバーの指示の最大長(文字数)。設定した値は、両方の[デフォルトの制限](/docs/ja/mcp#for-mcp-server-authors)、つまり 4096 と、Claude がツール検索で読み込むツールの説明に対する 16384 を置き換えます。正の整数を数字のみで受け付けます。それ以外は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |

336| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。モデルの上限を超える値は、Claude Code によって上限まで引き下げられます。Claude Code が既知のモデルに解決できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動圧縮](/docs/ja/costs#reduce-token-usage) が発生するまでに利用できる実質的なコンテキストウィンドウが小さくなります |337| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。モデルの上限を超える値は、Claude Code によって上限まで引き下げられます。Claude Code が既知のモデルに解決できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動圧縮](/docs/ja/costs#reduce-token-usage) が発生するまでに利用できる実質的なコンテキストウィンドウが小さくなります |

337| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします(デフォルト: 10)。v2.1.186 以降は上限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害を待ち続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |338| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします(デフォルト: 10)。v2.1.186 以降は上限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害を待ち続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |

338| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は何も行いません。以前は、1 つのセッションで Claude が Agent ツールで生成できる [サブエージェント](/docs/ja/sub-agents) の総数を制限していました(デフォルト: 200)。上限を超えて生成しようとすると `Subagent spawn limit reached` で失敗していました。[同時実行サブエージェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) と [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |339| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は何も行いません。以前は、1 つのセッションで Claude が Agent ツールで生成できる [サブエージェント](/docs/ja/sub-agents) の総数を制限していました(デフォルト: 200)。上限を超えて生成しようとすると `Subagent spawn limit reached` で失敗していました。[同時実行サブエージェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) と [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |


598* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く599* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く

599* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する600* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する

600* [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) をオンにする601* [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) をオンにする

602* VS Code 拡張機能のチャットパネルで [mod](/docs/ja/plugins/mods/overview#where-mods-run) が描画する内容を表示する。mod のフックは引き続き実行されます

601* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する603* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する

602* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する604* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する

603* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる605* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる

errors.md +495 −303

Details

72| `Claude.ai login was rejected — run /login, then /remote-control` | [認証](#remote-control-couldnt-refresh-your-login) |72| `Claude.ai login was rejected — run /login, then /remote-control` | [認証](#remote-control-couldnt-refresh-your-login) |

73| `OAuth token unavailable — run /login to restore Remote Control` | [認証](#remote-control-couldnt-refresh-your-login) |73| `OAuth token unavailable — run /login to restore Remote Control` | [認証](#remote-control-couldnt-refresh-your-login) |

74| `Signed out of Claude — run /login, then /remote-control` | [認証](#remote-control-couldnt-refresh-your-login) |74| `Signed out of Claude — run /login, then /remote-control` | [認証](#remote-control-couldnt-refresh-your-login) |

75| `Remote Control could not renew this computer's connection` | [認証](#remote-control-could-not-renew-this-computers-connection) |

75| `signed-in claude.ai account or organization changed on this machine` | [認証](#remote-control-stopped-because-the-signed-in-account-changed) |76| `signed-in claude.ai account or organization changed on this machine` | [認証](#remote-control-stopped-because-the-signed-in-account-changed) |

76| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [認証](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |77| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [認証](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

77| `Remote Control stopped — the app running this session is signed out of Claude` | [認証](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |78| `Remote Control stopped — the app running this session is signed out of Claude` | [認証](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |


153| `Request too large` | [リクエストエラー](#request-too-large) |154| `Request too large` | [リクエストエラー](#request-too-large) |

154| `Request too large for the API's 32MB request limit` | [リクエストエラー](#request-too-large) |155| `Request too large for the API's 32MB request limit` | [リクエストエラー](#request-too-large) |

155| `Image was too large` | [リクエストエラー](#image-was-too-large) |156| `Image was too large` | [リクエストエラー](#image-was-too-large) |

157| `API Error: an image in the conversation could not be processed and was removed` | [リクエストエラー](#image-was-too-large) |

156| `Unable to resize image` | [リクエストエラー](#unable-to-resize-image) |158| `Unable to resize image` | [リクエストエラー](#unable-to-resize-image) |

157| `Request rejected as unprocessable by the model` | [リクエストエラー](#request-rejected-as-unprocessable-by-the-model) |159| `Request rejected as unprocessable by the model` | [リクエストエラー](#request-rejected-as-unprocessable-by-the-model) |

158| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [リクエストエラー](#pdf-errors) |160| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [リクエストエラー](#pdf-errors) |


179| `Effort '<level>' isn't available with thinking turned off on this model` | [リクエストエラー](#effort-isnt-available-with-thinking-turned-off) |181| `Effort '<level>' isn't available with thinking turned off on this model` | [リクエストエラー](#effort-isnt-available-with-thinking-turned-off) |

180| `effort '<level>' is not supported when thinking is disabled` | [リクエストエラー](#effort-isnt-available-with-thinking-turned-off) |182| `effort '<level>' is not supported when thinking is disabled` | [リクエストエラー](#effort-isnt-available-with-thinking-turned-off) |

181| `max_tokens must be greater than thinking.budget_tokens` | [リクエストエラー](#thinking-budget-exceeds-output-limit) |183| `max_tokens must be greater than thinking.budget_tokens` | [リクエストエラー](#thinking-budget-exceeds-output-limit) |

184| `Claude's response exceeded the ... output token maximum` | [リクエストエラー](#response-exceeded-the-output-token-maximum) |

182| `API Error: 400 due to tool use concurrency issues` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |185| `API Error: 400 due to tool use concurrency issues` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |

183| `API Error: 400 orphaned tool_result in conversation history` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |186| `API Error: 400 orphaned tool_result in conversation history` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |

184| `API Error: 400 duplicate tool_use ID in conversation history` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |187| `API Error: 400 duplicate tool_use ID in conversation history` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |


199| `The connection dropped while downloading the update` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |202| `The connection dropped while downloading the update` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

200| `Download timed out: exceeded the total deadline` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |203| `Download timed out: exceeded the total deadline` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

201| `--bg and --print conflict` | [コマンドラインエラー](#conflict-between-bg-and-print) |204| `--bg and --print conflict` | [コマンドラインエラー](#conflict-between-bg-and-print) |

205| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [コマンドラインエラー](#couldnt-tell-whether-bg-is-a-flag-or-text) |

202| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラインエラー](#conflict-between-a-system-prompt-flag-and-its-file-form) |206| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラインエラー](#conflict-between-a-system-prompt-flag-and-its-file-form) |

203| `Cloud sessions cannot be created from a --restricted session` | [コマンドラインエラー](#cloud-sessions-cannot-be-created-from-a-restricted-session) |207| `Cloud sessions cannot be created from a --restricted session` | [コマンドラインエラー](#cloud-sessions-cannot-be-created-from-a-restricted-session) |

204| `Cloud sessions are disabled by your organization's policy` | [コマンドラインエラー](#cloud-sessions-are-disabled-by-your-organizations-policy) |208| `Cloud sessions are disabled by your organization's policy` | [コマンドラインエラー](#cloud-sessions-are-disabled-by-your-organizations-policy) |


217| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [コマンドラインエラー](#directory-couldnt-be-resolved-to-a-real-location) |221| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [コマンドラインエラー](#directory-couldnt-be-resolved-to-a-real-location) |

218| `Error: Workspace not trusted` when starting Remote Control | [コマンドラインエラー](#workspace-not-trusted-when-starting-remote-control) |222| `Error: Workspace not trusted` when starting Remote Control | [コマンドラインエラー](#workspace-not-trusted-when-starting-remote-control) |

219| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラインエラー](#not-carried-over-to-the-sessions-remote-control-starts) |223| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラインエラー](#not-carried-over-to-the-sessions-remote-control-starts) |

224| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [コマンドラインエラー](#sandbox-is-not-supported-by-claude-remote-control) |

220| `` `claude import` is not yet available in this build `` | [コマンドラインエラー](#claude-import-is-not-yet-available-in-this-build) |225| `` `claude import` is not yet available in this build `` | [コマンドラインエラー](#claude-import-is-not-yet-available-in-this-build) |

221| `Could not read Claude Code config` | [コマンドラインエラー](#could-not-read-claude-code-config) |226| `Could not read Claude Code config` | [コマンドラインエラー](#could-not-read-claude-code-config) |

222| `Could not import <server>: <reason>` | [コマンドラインエラー](#could-not-import-a-server-from-claude-desktop) |227| `Could not import <server>: <reason>` | [コマンドラインエラー](#could-not-import-a-server-from-claude-desktop) |


233| `Shell command failed for pattern "..."`, from `/security-review` or any skill that injects dynamic context | [コマンドラインエラー](#security-review-fails-without-origin-head) |238| `Shell command failed for pattern "..."`, from `/security-review` or any skill that injects dynamic context | [コマンドラインエラー](#security-review-fails-without-origin-head) |

234| `Shell command permission check failed for pattern "..."`, from a skill that injects dynamic context | [コマンドラインエラー](#security-review-fails-without-origin-head) |239| `Shell command permission check failed for pattern "..."`, from a skill that injects dynamic context | [コマンドラインエラー](#security-review-fails-without-origin-head) |

235| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [コマンドラインエラー](#security-review-fails-without-origin-head) |240| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [コマンドラインエラー](#security-review-fails-without-origin-head) |

241| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [コマンドラインエラー](#no-shell-command-was-run) |

236| `Input must be provided either through stdin or as a prompt argument when using --print` | [コマンドラインエラー](#input-must-be-provided-when-using-print) |242| `Input must be provided either through stdin or as a prompt argument when using --print` | [コマンドラインエラー](#input-must-be-provided-when-using-print) |

237| `Claude Code can't read the keyboard here: stdin is not a terminal` | [コマンドラインエラー](#claude-code-cant-read-the-keyboard-here) |243| `Claude Code can't read the keyboard here: stdin is not a terminal` | [コマンドラインエラー](#claude-code-cant-read-the-keyboard-here) |

238| `Error: Input contained only whitespace` | [コマンドラインエラー](#input-contained-only-whitespace) |244| `Error: Input contained only whitespace` | [コマンドラインエラー](#input-contained-only-whitespace) |


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

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

369| `hook needs quotes around a path with a space` | [設定の警告](#hook-needs-quotes-around-a-path-with-a-space) |375| `hook needs quotes around a path with a space` | [設定の警告](#hook-needs-quotes-around-a-path-with-a-space) |

376| `Instruction file not loaded` | [設定の警告](#instruction-file-not-loaded) |

370| `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) |377| `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) |

371| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [設定の警告](#skill-or-command-name-refused) |378| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [設定の警告](#skill-or-command-name-refused) |

372| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定の警告](#workspace-has-not-been-trusted) |379| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定の警告](#workspace-has-not-been-trusted) |


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

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

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

387| `"<name>" is a reserved MCP server name and was not loaded` | [設定の警告](#mcp-server-name-is-reserved) |

380| `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) |388| `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) |

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

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

391| `Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded; fix or remove each entry:` | [設定の警告](#managed-settings-hooks-not-loaded) |

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

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

385| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [設定の警告](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |394| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [設定の警告](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |


389| `... has a wildcard before the rest of the command` | [設定の警告](#has-a-wildcard-before-the-rest-of-the-command) |398| `... has a wildcard before the rest of the command` | [設定の警告](#has-a-wildcard-before-the-rest-of-the-command) |

390| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [設定の警告](#denying-bash-also-turns-off-the-powershell-tool) |399| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [設定の警告](#denying-bash-also-turns-off-the-powershell-tool) |

391| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [設定の警告](#the-200k-limit-isnt-enforced) |400| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [設定の警告](#the-200k-limit-isnt-enforced) |

401| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

402| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

392| `[claude-code:unrecognized_model]` | [設定の警告](#unrecognized-model-id-on-a-request) |403| `[claude-code:unrecognized_model]` | [設定の警告](#unrecognized-model-id-on-a-request) |

404| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [設定の警告](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |

393| `Stale sandbox mask files left by a killed session` | [設定の警告](#stale-sandbox-mask-files-left-by-a-killed-session) |405| `Stale sandbox mask files left by a killed session` | [設定の警告](#stale-sandbox-mask-files-left-by-a-killed-session) |

394| Responses seem lower quality than usual | [応答品質](#responses-seem-lower-quality-than-usual) |406| Responses seem lower quality than usual | [応答品質](#responses-seem-lower-quality-than-usual) |

395 407 


1209 1221 

1210v2.1.238 より前では、Claude Code は現在 `Signed out of Claude` と表示されるケースを `JWT refresh failed: no OAuth token — run /login` として報告し、ログインの更新で 1 回でも応答が得られないとすぐに `Claude.ai login expired — run /login to restore Remote Control` で Remote Control を停止していました。1222v2.1.238 より前では、Claude Code は現在 `Signed out of Claude` と表示されるケースを `JWT refresh failed: no OAuth token — run /login` として報告し、ログインの更新で 1 回でも応答が得られないとすぐに `Claude.ai login expired — run /login to restore Remote Control` で Remote Control を停止していました。

1211 1223 

1224<h3 id="remote-control-could-not-renew-this-computers-connection">

1225 Remote Control could not renew this computer's connection

1226</h3>

1227 

1228この警告は、[`claude remote-control`](/docs/ja/remote-control#start-a-remote-control-session) を実行しているターミナルで、サーバーが claude.ai ログインを使って接続の認証情報を有効期限前に更新できない場合に表示されます。警告の最後の文には、現在の認証情報があとどれくらい有効か、またはすでに期限切れであることが示されます。

1229 

1230```text theme={null}

1231Remote Control could not renew this computer's connection: claude.ai did not accept the sign-in it uses. Run `claude /login` to sign in again. The connection keeps working for about 26 hours; if it still cannot sign in then, it stops.

1232```

1233 

1234**対処方法:**

1235 

1236* 警告で `claude /login` を実行するよう指示されている場合は、サーバーを実行しているマシンで別のターミナルを開き、そこで `claude /login` を実行して claude.ai アカウントでサインインします

1237* 接続の認証情報の期限が切れた後もサーバーがサインインできない場合、サーバーは `Poll: Authentication failed (401)` を含むエラーを出力して停止します。警告の 2 つ目の文に従って再度サインインし、サーバーが停止したターミナルで `claude remote-control` を再度実行してください。

1238 

1212<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1239<h3 id="remote-control-stopped-because-the-signed-in-account-changed">

1213 サインイン中のアカウントが変更されたため Remote Control が停止しました1240 サインイン中のアカウントが変更されたため Remote Control が停止しました

1214</h3>1241</h3>


2279* `/mcp disable <name>` で使用していない MCP サーバーを無効にして、コンテキストからツール定義を削除してください2306* `/mcp disable <name>` で使用していない MCP サーバーを無効にして、コンテキストからツール定義を削除してください

2280* 大きな `CLAUDE.md` メモリファイルをトリミングするか、[パススコープルール](/docs/ja/memory#path-specific-rules)に指示を移動して、関連する場合にのみ読み込むようにしてください2307* 大きな `CLAUDE.md` メモリファイルをトリミングするか、[パススコープルール](/docs/ja/memory#path-specific-rules)に指示を移動して、関連する場合にのみ読み込むようにしてください

2281* 自動圧縮はデフォルトでオンであり、通常このエラーを防ぎます。`/config` または [`DISABLE_AUTO_COMPACT`](/docs/ja/env-vars) でオフにした場合は、オンに戻してください。オフのままにする場合は、ウィンドウが満杯になる前に `/compact` を自分で実行してください。2308* 自動圧縮はデフォルトでオンであり、通常このエラーを防ぎます。`/config` または [`DISABLE_AUTO_COMPACT`](/docs/ja/env-vars) でオフにした場合は、オンに戻してください。オフのままにする場合は、ウィンドウが満杯になる前に `/compact` を自分で実行してください。

2309* より多くのトークンを受け付けるモデルで 200K トークン付近でエラーが発生する場合、原因の 1 つとして、Claude Code が認識しないモデル ID が考えられます。Claude Code はそのような ID に対して 200K のウィンドウを想定するため、その上限を超えて作業を続けるには、[モデルの実際のコンテキストウィンドウを指定してください](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)。

2282 2310 

2283[コンテキストウィンドウを探索](/docs/ja/context-window)して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。2311[コンテキストウィンドウを探索](/docs/ja/context-window)して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。

2284 2312 


2340```text theme={null}2368```text theme={null}

2341Image was too large. Double press esc to go back and try again with a smaller image.2369Image was too large. Double press esc to go back and try again with a smaller image.

2342API Error: 400 ... image dimensions exceed max allowed size2370API Error: 400 ... image dimensions exceed max allowed size

2371API Error: an image in the conversation could not be processed and was removed.

2343```2372```

2344 2373 

2345Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。v2.1.142 より前のバージョンでは、貼り付けられた画像は会話に残り、後続のすべてのメッセージで同じエラーを繰り返す可能性がありました。これらのバージョンで復旧するには、Esc キーを 2 回押して、画像が追加されたターンより前に戻ってください。2374`could not be processed and was removed` の行は、サイズや寸法の上限を超えた画像など、会話内の画像を API が拒否したことを意味します。

2375 

2376これらのエラーのいずれかが繰り返し発生する場合は、Claude Code を更新してください。古いバージョンでは、次のような理由で画像エラーが繰り返されることがありました。

2377 

2378* v2.1.299 より前は、多数の画像を含む長い会話で、Claude Code が上限を超えた画像ではなく、最後に添付した画像を削除することがありました。その結果、`was removed` の行が毎ターン繰り返され、Claude には新しい画像が見えませんでした。

2379* v2.1.299 より前は、VS Code、Desktop アプリ、Agent SDK で、Claude の作業中に添付した画像には、他の添付画像に適用されるリサイズが適用されませんでした。それらの画像は元のサイズのまま API に送信されたため、長い会話で画像エラーが繰り返し発生していました。

2380* v2.1.166 より前は、貼り付けた画像が会話内に残り、その後のすべてのメッセージで同じエラーが繰り返されることがありました

2346 2381 

2347**対応方法:**2382**対応方法:**

2348 2383 


2800* [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/env-vars) を思考予算より大きくしてください2835* [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/env-vars) を思考予算より大きくしてください

2801* 予算が出力長とどのように相互作用するかについては、[拡張思考](/docs/ja/model-config#extended-thinking)を参照してください2836* 予算が出力長とどのように相互作用するかについては、[拡張思考](/docs/ja/model-config#extended-thinking)を参照してください

2802 2837 

2838<h3 id="response-exceeded-the-output-token-maximum">

2839 Response exceeded the output token maximum

2840</h3>

2841 

2842Claude の応答が、リクエストで許可された出力トークンの最大数に達し、そこで切り捨てられました。

2843 

2844```text theme={null}

2845API Error: Claude's response exceeded the ... output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable.

2846API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit.

2847```

2848 

2849`a request sent without streaming` を示す形式は、ストリーミングリクエストが失敗し、Claude Code がストリーミングなしで再送信したことを意味します。この場合、応答は 64,000 出力トークンに制限されます。v2.1.299 より前は、このように再送信されたリクエストで応答が切り捨てられると、このメッセージが表示されずにターンが終了し、応答が完了したかのように扱われていました。

2850 

2851**対処方法:**

2852 

2853* 応答が切り捨てられる前に Claude がテキストを書いていた場合は、対話セッションで `continue` と返信して残りを求めます。そのテキストは会話内に残ります。

2854* メッセージで `CLAUDE_CODE_MAX_OUTPUT_TOKENS` の設定を求められている場合は、値の上限については [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/env-vars) を、設定場所については[環境変数を設定する](/docs/ja/env-vars#set-environment-variables)を参照してください

2855* 各応答を上限内に収めるには、1 回の応答につき 1 つのファイルや 1 つのセクションなど、出力を小さな単位に分けるよう Claude に求めます

2856 

2803<h3 id="tool-use-or-thinking-block-mismatch">2857<h3 id="tool-use-or-thinking-block-mismatch">

2804 ツール使用または思考ブロックの不一致2858 ツール使用または思考ブロックの不一致

2805</h3>2859</h3>


2936モデルの安全対策が、会話内のコンテンツをサイバーセキュリティのトピックとして警告しました。メッセージはリクエストを警告したモデルを示します:2990モデルの安全対策が、会話内のコンテンツをサイバーセキュリティのトピックとして警告しました。メッセージはリクエストを警告したモデルを示します:

2937 2991 

2938```text theme={null}2992```text theme={null}

2939API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2993API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2940```2994```

2941 2995 

2942メッセージに `` Details: `[reasoning_extraction]` `` という行が含まれている場合は、[セーフガードが Claude の推論を求めるリクエストを警告しました](#safeguards-flagged-a-request-for-claudes-reasoning)を参照してください。2996メッセージに `` Details: `[reasoning_extraction]` `` という行が含まれている場合は、[セーフガードが Claude の推論を求めるリクエストを警告しました](#safeguards-flagged-a-request-for-claudes-reasoning)を参照してください。


2945 2999 

2946[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry) では、サイバーセキュリティの警告は代わりに [使用ポリシーによる拒否](#usage-policy-refusal)のメッセージになります。3000[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry) では、サイバーセキュリティの警告は代わりに [使用ポリシーによる拒否](#usage-policy-refusal)のメッセージになります。

2947 3001 

2948セーフガード自体はサーバー側にあり、v2.1.203 より前から存在しています。それ以降のクライアントリリースで変更されたのはメッセージの表現のみです。

2949v2.1.203 から v2.1.218 までは、メッセージは `<model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` と表示され、その後に同じヘルプセンターのリンクが続き、対話セッションでは `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.` が追加されていました。

2950v2.1.203 より前では、`<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` と表示され、その後に免除申請フォームのリンクが続いていました。

2951 

2952**対応方法:**3002**対応方法:**

2953 3003 

2954* 作業にこのコンテンツが必要な場合は、[Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude) を通じてアクセスを申請してください3004* 作業にこのコンテンツが必要な場合は、[Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude) を通じてアクセスを申請してください

2955* リクエストがサイバーセキュリティのトピックに関するものではなかった場合は、`/feedback` を実行して誤検知を報告してください3005* リクエストがサイバーセキュリティのトピックに関するものではなかった場合は、`/feedback` を実行して誤検知を報告してください

2956* 同じセッションで作業を続けるには、Esc キーを 2 回押すか、`/rewind` を実行して、警告をトリガーしたターンの前のチェックポイントに戻り、別のアプローチを試してください。[チェックポイント機能](/docs/ja/checkpointing)を参照してください。3006* 同じセッションで作業を続けるには、Esc キーを 2 回押すか、`/rewind` を実行して、警告をトリガーしたターンの前のチェックポイントに戻り、別のアプローチを試してください。[チェックポイント機能](/docs/ja/checkpointing)を参照してください。

2957 3007 

3008表示されたメッセージが代わりに以下のいずれかの文言である場合は、以前のバージョンの Claude Code における同じ警告です。

3009 

3010* v2.1.219 から v2.1.296 までは、メッセージの最後の文の前に `Apply to the Cyber Verification Program to reduce these interruptions.` が含まれることもありました

3011* v2.1.203 から v2.1.218 までは、メッセージは `<model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` で、その後に同じヘルプセンターのリンクが続いていました。インタラクティブセッションでは、さらに `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.` が続いていました

3012* v2.1.203 より前は、メッセージは `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` で、その後に適用除外フォームへのリンクが続いていました

3013 

2958<h3 id="safeguards-flagged-a-request-for-claudes-reasoning">3014<h3 id="safeguards-flagged-a-request-for-claudes-reasoning">

2959 セーフガードが Claude の推論を求めるリクエストを警告しました3015 セーフガードが Claude の推論を求めるリクエストを警告しました

2960</h3>3016</h3>


3001 `--bg` と `--print` の競合3057 `--bg` と `--print` の競合

3002</h3>3058</h3>

3003 3059 

3004このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` と `-p` または `--print` を組み合わせました。`--bg` は後から `claude agents` でアタッチする[バックグラウンドセッション](/docs/ja/agent-view#from-your-shell)を開始しますが、`--print` は[非対話](/docs/ja/headless)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが何も通知されずに作成されていました。3060このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` を `-p` または `--print` と組み合わせています。`--bg` は後で `claude agents` でアタッチする[バックグラウンドセッション](/docs/ja/agent-view#from-your-shell)を開始しますが、`--print` は[非対話](/docs/ja/headless)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが何の警告もなく作成されていました。

3005 3061 

3006```text theme={null}3062```text theme={null}

3007--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.3063--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

3008```3064```

3009 3065 

3066**対処方法:**

3067 

3068* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` だけで完全なコマンドになります。[シェルから新しいエージェントを Dispatch する](/docs/ja/agent-view#from-your-shell)を参照してください。

3069* バックグラウンドセッションを作成する代わりにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します

3070 

3071<h3 id="couldnt-tell-whether-bg-is-a-flag-or-text">

3072 Couldn't tell whether `--bg` is a flag or text

3073</h3>

3074 

3075Claude Code がバックグラウンドフラグとして意図されたものかテキストとして意図されたものかを判別できない位置に `--bg` または `--background` を指定して `claude` を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:

3076 

3077```text theme={null}

3078Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>

3079```

3080 

3081`--background` と入力した場合は、この行には代わりに `--background` と表示されます。

3082 

3010**対処方法:**3083**対処方法:**

3011 3084 

3012* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` だけで完全なコマンドになります。[シェルから新しいエージェントをディスパッチする](/docs/ja/agent-view#from-your-shell)を参照してください。3085* [バックグラウンドセッション](/docs/ja/agent-view#from-your-shell)を開始するには、フラグを先頭に置いてシェルでコマンドを再度実行します: `claude --bg --name nightly-audit "<task>"`

3013* バックグラウンドセッションを作成せずにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します

3014 3086 

3015<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">3087<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">

3016 システムプロンプトフラグとそのファイル形式の競合3088 システムプロンプトのフラグとそのファイル形式の競合

3017</h3>3089</h3>

3018 3090 

30191 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を同時に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:30911 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:

3020 3092 

3021```text theme={null}3093```text theme={null}

3022Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.3094Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.

3023```3095```

3024 3096 

3025v2.1.283 より前は、`--system-prompt` と `--system-prompt-file`、または `--append-system-prompt` と `--append-system-prompt-file` を渡した場合にも、`claude` は同じように終了していました。これらの組み合わせは[結合](/docs/ja/cli-reference#system-prompt-flags)されずに競合していたためです。これらのバージョンでは、メッセージに組み合わせたフラグのペアが表示されます。3097v2.1.283 より前は、`--system-prompt` と `--system-prompt-file`、または `--append-system-prompt` と `--append-system-prompt-file` を一緒に渡した場合も、`claude` は同様に終了していました。これらの組み合わせは[併用](/docs/ja/cli-reference#system-prompt-flags)されずに競合していたためです。これらのバージョンでは、メッセージに組み合わせたフラグのペアが示されます。

3026 3098 

3027**対処方法:**3099**対処方法:**

3028 3100 

3029* フラグの一方の形式だけを残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします3101* フラグのどちらか一方の形式を残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡す代わりに、起動前にテキストをファイルにマージします

3030 3102 

3031<h3 id="invalid-agents-configuration">3103<h3 id="invalid-agents-configuration">

3032 Invalid `--agents` configuration3104 Invalid `--agents` configuration

3033</h3>3105</h3>

3034 3106 

3035`--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 はそれでもセッションを開始していました。3107`--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 はそれでもセッションを開始していました。

3036 3108 

3037```text theme={null}3109```text theme={null}

3038Error: Invalid --agents configuration:3110Error: Invalid --agents configuration:

3039<what failed>3111<what failed>

3040```3112```

3041 3113 

30421 行目以降の内容は、値がどのように無効だったかによって異なります。Claude Code は以下のチェックを順番に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にはじめて表示されます:31141 行目以降の内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順番に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:

3043 3115 

30441. 値が `{` で始まるのに JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します31161. 値が `{` で始まるのに JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します

30452. 解析はできるものの、エージェント定義が [CLI で定義されたサブエージェント](/docs/ja/sub-agents#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します31172. 解析はできるものの、エージェント定義が [CLI で定義されたサブエージェント](/docs/ja/sub-agents#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します


3047 3119 

3048問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。3120問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。

3049 3121 

3050`--print` を使用する場合、`--agents` はインラインのオブジェクトの代わりに [JSON ファイルへのパス](/docs/ja/sub-agents#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。たとえば次のようなものがあります:3122`--print` を使用する場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](/docs/ja/sub-agents#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。次のようなものがあります:

3051 3123 

3052* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み込ませてください。3124* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**:Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み込みます。

3053* **`Error: --agents file not found: <path>`**: そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって崩れたインライン JSON でもこのように失敗することがあります。パスまたはクォートを確認して、コマンドを再実行してください。3125* **`Error: --agents file not found: <path>`**:そのパスにファイルが存在しません。`{` で始まらず、有効な JSON でもない値はパスとして読み取られるため、シェルによって壊されたインライン JSON もこの形で失敗することがあります。パスまたはクォートを確認して、コマンドを再度実行します。

3054 3126 

3055**対処方法:**3127**対処方法:**

3056 3128 

3057* メッセージに列挙された各問題を修正してから、コマンドを再実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](/docs/ja/sub-agents#choose-the-subagent-scope)を参照してください。3129* メッセージに列挙された各問題を修正してから、コマンドを再度実行します。[CLI で定義されたサブエージェントが受け取るフィールド](/docs/ja/sub-agents#choose-the-subagent-scope)を参照してください。

3058 3130 

3059<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">3131<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">

3060 Cloud sessions cannot be created from a `--restricted` session3132 Cloud sessions cannot be created from a `--restricted` session

3061</h3>3133</h3>

3062 3134 

3063[`--restricted`](/docs/ja/cli-reference#cli-flags) でセッションを開始した場合、Claude Code はそのセッションから[クラウドセッション](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)を作成することを拒否します。新しいセッションは制限されたプロセスの外部で実行され、制限モードを適用しないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:3135[`--restricted`](/docs/ja/cli-reference#cli-flags) でセッションを開始すると、Claude Code はそのセッションから[クラウドセッション](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)を作成することを拒否します。新しいセッションは制限されたプロセスの外部で実行され、制限モードを適用しないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:

3064 3136 

3065```text theme={null}3137```text theme={null}

3066Cloud sessions cannot be created from a --restricted session: they would not enforce it.3138Cloud sessions cannot be created from a --restricted session: they would not enforce it.

3067```3139```

3068 3140 

3069**対処方法:**3141**対処方法:**

3070 3142 

3071* 制限されたセッション内でタスクをローカルに実行します3143* 制限されたセッションでタスクをローカルで実行します

3072* セッションの起動方法を制御できる場合は、`--restricted` を付けずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します3144* セッションの起動方法を制御できる場合は、`--restricted` なしで新しい `claude` セッションを開始し、そこからクラウドセッションを作成します

3073 3145 

3074v2.1.248 より前の Claude Code には `--restricted` フラグがありません。それ以前のバージョンでは、フラグ自体が不明なオプションのエラーとして拒否されます。3146v2.1.248 より前の Claude Code には `--restricted` フラグがありませんでした。それ以前のバージョンでは、フラグ自体が不明なオプションのエラーで拒否されます。

3075 3147 

3076<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">3148<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">

3077 Cloud sessions are disabled by your organization's policy3149 Cloud sessions are disabled by your organization's policy

3078</h3>3150</h3>

3079 3151 

3080組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](/docs/ja/claude-code-on-the-web)とそれを使用するコマンドは利用できません:3152組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](/docs/ja/claude-code-on-the-web)とそれを使用するコマンドは利用できません:

3081 3153 

3082```text theme={null}3154```text theme={null}

3083Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.3155Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

3084```3156```

3085 3157 

3086このメッセージは、[ターミナルからクラウドセッションを作成する](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)とき、および`/teleport`、`/remote-env`、`/web-setup` など、クラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドを送信すると代わりに [`Unknown command`](#unknown-command) が返されていました。3158このメッセージは、[ターミナルからクラウドセッションを作成する](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)ときと、`/teleport`、`/remote-env`、`/web-setup` など、クラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドのいずれかを送信すると、代わりに [`Unknown command`](#unknown-command) が返されていました。

3087 3159 

3088メッセージが、このセッションで使用している認証情報を挙げ、`Cloud sessions use your claude.ai login.` で終わっている場合は、[Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login) を参照してください。Claude Code が組織のポリシーをまったく読み込めなかった場合は、代わりに[別のメッセージ](#couldnt-verify-your-organizations-policy-for-cloud-sessions)が表示されます。3160メッセージがこのセッションで使用中の認証情報を示し、`Cloud sessions use your claude.ai login.` で終わる場合は、[Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login) を参照してください。Claude Code が組織のポリシーをまったく読み込めなかった場合は、代わりに[別のメッセージ](#couldnt-verify-your-organizations-policy-for-cloud-sessions)が表示されます。

3089 3161 

3090**対処方法:**3162**対処方法:**

3091 3163 

3092* 組織の [Owner](/docs/ja/server-managed-settings#access-control) に、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理設定でクラウドセッションを有効にするよう依頼します3164* 組織の [Owner](/docs/ja/server-managed-settings#access-control) に、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理設定でクラウドセッションを有効にするよう依頼します

3093 3165 


3095 Cloud sessions use your claude.ai login3167 Cloud sessions use your claude.ai login

3096</h3>3168</h3>

3097 3169 

3098[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージが、このセッションで使用している認証情報を挙げ、この文で終わっている場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります:3170[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージがこのセッションで使用中の認証情報を示し、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります:

3099 3171 

3100```text theme={null}3172```text theme={null}

3101Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.3173Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.

3102```3174```

3103 3175 

3104最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合にも、組織の管理者に連絡するよう求める形式が出力されていました。3176最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合も、組織の管理者に連絡するよう指示する形式が出力されていました。

3105 3177 

3106<h3 id="couldnt-verify-your-organizations-policy-for-cloud-sessions">3178<h3 id="couldnt-verify-your-organizations-policy-for-cloud-sessions">

3107 Couldn't verify your organization's policy for cloud sessions3179 Couldn't verify your organization's policy for cloud sessions

3108</h3>3180</h3>

3109 3181 

3110これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、次のメッセージが表示されます:3182これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、メッセージは次のとおりです:

3111 3183 

3112```text theme={null}3184```text theme={null}

3113Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.3185Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.

3114```3186```

3115 3187 

3116セッション内では、`/teleport` や `/web-setup` など、クラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルであれば `Cloud sessions aren't available:` の形式が出力される場合でもこのメッセージが表示され、2 文目は `Check your network connection, then restart Claude Code and try again.` となります。3188セッション内では、`/teleport` や `/web-setup` など、クラウドセッションを必要とするコマンドもこのメッセージを返します。シェルであれば `Cloud sessions aren't available:` 形式が出力される場合でもこのメッセージが返され、その 2 文目は `Check your network connection, then restart Claude Code and try again.` となります。

3117 3189 

3118ポリシーのリクエストが失敗した後は、メッセージに何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に該当します。API への経路がない場合は、次のように表示されます:3190ポリシーのリクエストが失敗した後は、メッセージに何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に該当します。API への経路がない場合、メッセージは次のようになります:

3119 3191 

3120```text theme={null}3192```text theme={null}

3121Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.3193Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.

3122```3194```

3123 3195 

3124その他の失敗も同じ書き出しで始まり、その後にそれぞれの原因が続きます。たとえば、プロキシが HTTP 403 でリクエストを拒否した場合、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその認証情報の名前と、その設定を解除するよう求める内容も含まれることがあります:3196その他の失敗も同じ書き出しに続けてそれぞれの原因が示されます。たとえば、プロキシが HTTP 403 でリクエストを拒否した場合、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその認証情報の名前と、設定を解除するよう示す内容が含まれることもあります:

3125 3197 

3126```text theme={null}3198```text theme={null}

3127Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.3199Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.


3129 3201 

3130v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。3202v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。

3131 3203 

3132**対処方法:**3204**対処方法:**

3133 3205 

3134* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内の場合は、まず Claude Code を再起動します3206* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内の場合は、先に Claude Code を再起動します

3135* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や、メッセージに示された認証情報の設定解除など、原因に応じた対処を行ってから、コマンドを再実行します3207* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や示された認証情報の設定解除など、原因に応じた対処を行ってから、コマンドを再度実行します

3136 3208 

3137<h3 id="nothing-was-stashed-because-a-folder-replaced-a-tracked-file">3209<h3 id="nothing-was-stashed-because-a-folder-replaced-a-tracked-file">

3138 追跡対象のファイルがフォルダーに置き換わったため何もスタッシュされなかった3210 フォルダーが追跡対象のファイルを置き換えたため何もスタッシュされなかった

3139</h3>3211</h3>

3140 3212 

3141このメッセージは、チェックアウト内で、git が追跡しているファイルまたはリンクがあった場所にフォルダーが存在するようになったことを意味します。これは、`claude --teleport` や `/teleport` などで[クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をターミナルに取り込む際にスタッシュのオプションを選択した後に表示されます。その状態をスタッシュするとフォルダー内のファイルが削除される可能性があるため、Claude Code はスタッシュを拒否し、チェックアウトとインデックスを変更せずにそのままにします:3213このメッセージは、チェックアウト内で、以前は git で追跡されていたファイルまたはリンクがあった場所に、現在はフォルダーがあることを意味します。たとえば `claude --teleport` や `/teleport` を使用して[クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をターミナルに取り込む際に、スタッシュのオプションを選択した後に表示されます。その状態をスタッシュするとフォルダー内のファイルが削除される可能性があるため、Claude Code はスタッシュを拒否し、チェックアウトとインデックスを変更しないままにします:

3142 3214 

3143```text wrap theme={null}3215```text wrap theme={null}

3144Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.3216Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.

3145```3217```

3146 3218 

3147**対処方法:**3219**対処方法:**

3148 3220 

3149* メッセージのとおり、変更をコミットするかフォルダーを別の場所に移動してから、teleport を再実行します3221* メッセージに示されているとおり、変更をコミットするかフォルダーを別の場所に移動してから、再度 teleport を実行します

3150 3222 

3151<h3 id="the-json-schema-value-is-not-a-valid-json-schema">3223<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

3152 The `--json-schema` value is not a valid JSON Schema3224 The `--json-schema` value is not a valid JSON Schema

3153</h3>3225</h3>

3154 3226 

3155[非対話モード](/docs/ja/headless#get-structured-output)で [`--json-schema`](/docs/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema のコンパイルに失敗したため、`claude` はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマはエラーなしに構造化されていない出力を生成し、`format` キーワードを使用するスキーマはすべて無効として扱われていました。3227[非対話モード](/docs/ja/headless#get-structured-output)で [`--json-schema`](/docs/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema のコンパイルに失敗したため、`claude` はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマはエラーなしで構造化されていない出力を生成し、`format` キーワードを使用するスキーマはすべて無効として扱われていました。

3156 3228 

3157```text theme={null}3229```text theme={null}

3158Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values3230Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

3159```3231```

3160 3232 

31612 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` を注釈として受け付け、その内容を強制しません。32332 つ目のコロン以降のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` をアノテーションとして受け付けますが、適用はしません。

3162 3234 

3163Claude Code はスキーマのコンパイルの前に 2 つのチェックを行います。解析可能な JSON でない値は `Error: --json-schema is not valid JSON` で、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。3235Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON でない値は `Error: --json-schema is not valid JSON` で拒否し、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否します。

3164 3236 

3165**対処方法:**3237**対処方法:**

3166 3238 

3167* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します3239* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します

3168* 動作するスキーマとコマンドの例については、[構造化された出力を取得する](/docs/ja/headless#get-structured-output)を参照してください3240* 動作するスキーマとコマンドについては、[構造化出力を取得する](/docs/ja/headless#get-structured-output)を参照してください

3169 3241 

3170<h3 id="settings-file-exceeds-the-2mib-limit">3242<h3 id="settings-file-exceeds-the-2mib-limit">

3171 Settings file exceeds the 2MiB limit3243 Settings file exceeds the 2MiB limit

3172</h3>3244</h3>

3173 3245 

3174[`--settings`](/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` はファイルを読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズをチェックせずにファイルを読み込んでいたため、数ギガバイトのファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。3246[`--settings`](/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` は起動時にそれを読み込まずに終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み込んでいたため、数ギガバイトのファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。

3175 3247 

3176```text theme={null}3248```text theme={null}

3177Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3249Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

3178```3250```

3179 3251 

3180Claude Code は、通常のファイルではない `--settings` のパスも同じように拒否します。デバイス、FIFO、ソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` の後にパスが表示され、ディレクトリの場合は `EISDIR` という理由が表示されます。3252Claude Code は、通常のファイルではない `--settings` パスも同様に拒否します。デバイス、FIFO、ソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` に続けてパスが報告され、ディレクトリの場合は `EISDIR` の理由が報告されます。

3181 3253 

3182**対処方法:**3254**対処方法:**

3183 3255 

3184* `--settings` には 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](/docs/ja/settings)を参照してください。3256* `--settings` には 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](/docs/ja/settings)を参照してください。

3185 3257 


3187 The current directory no longer exists3259 The current directory no longer exists

3188</h3>3260</h3>

3189 3261 

3190シェルがディレクトリに入った後に削除または移動されたディレクトリ(たとえば、別のシェルが削除した worktree や一時ディレクトリ)から `claude` を開始しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](/docs/ja/headless)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code はミニファイされたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。3262シェルがディレクトリに入った後に削除または移動されたディレクトリから `claude` を起動しました。たとえば、別のシェルが削除した worktree や一時ディレクトリなどです。Claude Code は作業ディレクトリを読み取れないため、対話モードと[非対話](/docs/ja/headless)モードのどちらでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、Claude Code はこのメッセージの代わりに、圧縮されたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。

3191 3263 

3192```text theme={null}3264```text theme={null}

3193The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3265The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.

3194error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3266error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

3195```3267```

3196 3268 

3197どちらの形式でも、原因と修正方法は同じです。3269どちらの形式も、原因と修正方法は同じです。

3198 3270 

3199権限の変更など、別の理由で Claude Code が作業ディレクトリを読み取れない場合は、代わりにメッセージにエラーコードが示されます: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3271権限の変更など、別の理由で Claude Code が作業ディレクトリを読み取れない場合は、代わりにメッセージにエラーコードが示されます:`Can't read the current directory (EACCES). Start Claude Code from a different directory.`

3200 3272 

3201macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が表示される場合、通常は macOS がターミナルアプリによるそのフォルダーへのアクセスをブロックしています。そのフォルダーを読み取る他のコマンドも同じように失敗します。そこで `ls` を実行すると、`sudo` を付けても `Operation not permitted` が表示されます。3273macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が発生する場合、通常は macOS がターミナルアプリによるそのフォルダーへのアクセスをブロックしていることを意味します。そのフォルダーを読み取る他のコマンドも同様に失敗します。そこで `ls` を実行すると、`sudo` を使用しても `Operation not permitted` が報告されます。

3202 3274 

3203**対処方法:**3275**対処方法:**

3204 3276 

3205* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再実行します3277* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、再度 `claude` を実行します

3206* ディレクトリが同じパスに再作成された場合、シェルはまだ削除されたディレクトリを保持しています。`cd "$PWD"` を実行するか、ディレクトリから出て再び入ってから、`claude` を再実行します3278* ディレクトリが同じパスに再作成された場合でも、シェルは削除されたディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て再度入ってから、再度 `claude` を実行します

3207* macOS で `EPERM` が表示される場合は、Cmd+Q でターミナルアプリを終了し、再度開いてそのフォルダーに戻ってから `claude` を実行します。それでもそのフォルダーで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ** を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを開き直します3279* macOS の `EPERM` の場合は、Cmd+Q でターミナルアプリを終了し、再度開いてそのフォルダーに戻り、`claude` を実行します。それでもそのフォルダーで `ls` が失敗する場合は、**System Settings > Privacy & Security > Files and Folders** を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを開き直します

3208 3280 

3209<h3 id="temp-directory-refused-or-cannot-be-created">3281<h3 id="temp-directory-refused-or-cannot-be-created">

3210 一時ディレクトリが拒否される、または作成できない3282 一時ディレクトリが拒否された、または作成できない

3211</h3>3283</h3>

3212 3284 

3213macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) による上書き先の下に、専用の一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスにすでに存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに、失敗内容を stderr に出力して終了コード 1 で終了します:3285macOS と Linux では、Claude Code は起動時にプライベートな一時ディレクトリを作成します。これは、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) による上書き先の下にある `claude-<uid>` です。ディレクトリを作成できない場合、またはそのパスに既に存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに、失敗を stderr に出力して終了コード 1 で終了します:

3214 3286 

3215```text wrap theme={null}3287```text wrap theme={null}

3216ENOSPC: no space left on device, mkdir '/tmp/claude-501'3288ENOSPC: no space left on device, mkdir '/tmp/claude-501'


3222Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.3294Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

3223```3295```

3224 3296 

3225**対処方法:**3297**対処方法:**

3226 3298 

3227* `ENOSPC` の場合は、一時ディレクトリがあるボリュームのディスク容量を空けます3299* `ENOSPC` の場合は、一時ディレクトリがあるボリュームのディスク容量を空けます

3228* `Refusing to use it` を含む形式の場合は、リンクの参照先ではなく、示されたエントリ自体を削除してから、Claude Code を再起動します。`owned by uid` の形式の場合、削除できるのは管理者またはそのユーザーのみです3300* `Refusing to use it` 形式の場合は、リンク先ではなく示されたエントリ自体を削除し、Claude Code を再度起動します。`owned by uid` 形式の場合、削除できるのは管理者またはそのユーザーのみです

3229* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再起動します3301* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再度起動します

3230* いずれの場合も、拒否されたパスには手を触れずに、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) を自分が管理するディレクトリに設定して Claude Code を再起動することもできます3302* いずれの場合も、拒否されたパスはそのままにして、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) を自分が管理するディレクトリに設定し、Claude Code を再度起動できます

3231 3303 

3232<h3 id="directory-couldnt-be-resolved-to-a-real-location">3304<h3 id="directory-couldnt-be-resolved-to-a-real-location">

3233 Directory couldn't be resolved to a real location3305 Directory couldn't be resolved to a real location


3235 3307 

3236作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code がそのディレクトリを実際の場所に解決できませんでした。3308作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code がそのディレクトリを実際の場所に解決できませんでした。

3237 3309 

3238作業ディレクトリのサブディレクトリにはすでにファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントを読み込むだけです。読み込む前に、Claude Code はシンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることをチェックします。その場所を解決できない場合、Claude Code は何も読み込まずに次のメッセージを表示します:3310作業ディレクトリのサブディレクトリには既にファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントを読み込むだけです。これらを読み込む前に、Claude Code は、シンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることを確認します。その場所を解決できない場合、Claude Code は何も読み込まず、次のメッセージを表示します:

3239 3311 

3240```text theme={null}3312```text theme={null}

3241packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3313packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.

3242```3314```

3243 3315 

3244**対処方法:**3316**対処方法:**

3245 3317 

3246* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再実行します3318* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、再度 `/add-dir` を実行します

3247* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告しているだけです3319* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです

3248 3320 

3249v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。Claude Code は設計上そのようなパスを解決しないためで、ディレクトリには問題がなく、再試行しても解決しませんでした。3321v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。この場所では Claude Code は設計上パスの解決を行いません。ディレクトリには問題がなく、再試行しても解決しませんでした。

3250 3322 

3251<h3 id="workspace-not-trusted-when-starting-remote-control">3323<h3 id="workspace-not-trusted-when-starting-remote-control">

3252 Workspace not trusted when starting Remote Control3324 Workspace not trusted when starting Remote Control

3253</h3>3325</h3>

3254 3326 

3255信頼していないディレクトリで `claude remote-control` またはそのエイリアス `claude rc` を使用して [Remote Control](/docs/ja/remote-control) のサーバーモードを開始しましたが、コマンドがそのディレクトリを信頼するかどうかを確認できませんでした。たとえば、標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、ターミナルではない場合です。コマンドは終了コード 1 で終了します:3327信頼していないディレクトリで `claude remote-control` またはそのエイリアス `claude rc` を使用して [Remote Control](/docs/ja/remote-control) のサーバーモードを開始しましたが、コマンドはそのディレクトリを信頼するかどうかを確認できませんでした。たとえば、コマンドの標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、ターミナルではない場合です。コマンドは終了コード 1 で終了します:

3256 3328 

3257```text theme={null}3329```text theme={null}

3258Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3330Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

3259```3331```

3260 3332 

3261同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションが、ディレクトリを信頼すると何が有効になるかを表示するには小さすぎるターミナル、またはサイズを報告しなかったターミナルで表示されます。ウィンドウを大きくするか通常のターミナルウィンドウに切り替えてから、`claude rc` を再実行してください。3333同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションは、ディレクトリを信頼することで有効になる内容を表示するにはターミナルが小さすぎる場合、またはターミナルがサイズを報告しなかった場合に表示されます。ウィンドウを拡大するか通常のターミナルウィンドウに切り替えてから、再度 `claude rc` を実行します。

3262 3334 

3263ホームディレクトリでは、メッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリの信頼を保存しないため、そこでダイアログを承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はホームディレクトリでは成功しません。3335ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はホームディレクトリでは成功しません。

3264 3336 

3265```text theme={null}3337```text theme={null}

3266Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3338Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

3267```3339```

3268 3340 

3269[`Trust <directory>?` の質問](/docs/ja/remote-control#requirements)に `n` と答えるか Enter を押した場合、コマンドはディレクトリ名を含む `Remote Control did not start` メッセージを出力して終了コード 1 で終了します。`y` と答えるには `claude rc` を再実行してください。3341[`Trust <directory>?` の質問](/docs/ja/remote-control#requirements)に `n` と答えるか Enter キーを押すと、コマンドはディレクトリ名を示す `Remote Control did not start` メッセージを出力し、終了コード 1 で終了します。`y` と答えるには、再度 `claude rc` を実行します。

3270 3342 

3271**対処方法:**3343**対処方法:**

3272 3344 

3273* まずターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します3345* まずターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再度実行します

3274* ホームディレクトリにいる場合は、プロジェクトディレクトリに移動してそこで Remote Control を開始します3346* ホームディレクトリにいる場合は、プロジェクトディレクトリに移動して、そこで Remote Control を開始します

3275 3347 

3276v2.1.284 より前は、ターミナル内であってもコマンドは確認を求めませんでした。3348v2.1.284 より前は、ターミナル内であってもコマンドが確認を求めることはありませんでした。

3277 3349 

3278<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3350<h3 id="not-carried-over-to-the-sessions-remote-control-starts">

3279 Not carried over to the sessions Remote Control starts3351 Not carried over to the sessions Remote Control starts

3280</h3>3352</h3>

3281 3353 

3282`remote-control` 動詞の前に、Remote Control が開始するセッションを制限または設定するグローバルな `claude` フラグ(`--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools`、`--mcp-config` など)を付けて [Remote Control](/docs/ja/remote-control) を開始しました。動詞の前に置いたフラグは、それらのセッションに届きません。Claude Code は代わりに、フラグ名を示して起動を拒否します:3354`remote-control` サブコマンドの前にグローバルな `claude` フラグを付けて [Remote Control](/docs/ja/remote-control) を開始しました。これは、`--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools`、`--mcp-config` など、Remote Control が開始するセッションを制限または設定するフラグです。サブコマンドの前に置いたフラグは、これらのセッションには渡されません。代わりに、Claude Code はフラグ名を示して起動を拒否します:

3283 3355 

3284```text theme={null}3356```text theme={null}

3285Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3357Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).

3286```3358```

3287 3359 

3288`--verbose`、`--model`、ラッパーによって挿入される `--session-id` や `--plugin-dir` など、破棄しても問題のないグローバルフラグについては、Claude Code は拒否しません。それらを無視して Remote Control を開始します。3360`--verbose`、`--model`、ラッパーによって挿入された `--session-id` や `--plugin-dir` など、無視しても問題のないグローバルフラグは拒否されません。Claude Code はこれらを無視し、Remote Control は起動します。

3289 3361 

3290Claude Code は、まだ無害と認識していないグローバルフラグについても起動を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。3362Claude Code は、まだ無害と認識していないグローバルフラグに対しても起動を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。

3291 3363 

3292**対処方法:**3364**対処方法:**

3293 3365 

3294* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](/docs/ja/remote-control#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でそれらの一覧を確認できます3366* サブコマンドの前からフラグを削除し、[Remote Control 独自のオプション](/docs/ja/remote-control#start-a-remote-control-session)をサブコマンドの後に渡します。`claude remote-control --help` でオプションの一覧を確認できます

3295* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します3367* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します

3296 3368 

3297v2.1.248 より前は、グローバルフラグが先にあると `claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。3369v2.1.248 より前は、グローバルフラグが先にあると `claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。

3298 3370 

3371<h3 id="sandbox-is-not-supported-by-claude-remote-control">

3372 `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3373</h3>

3374 

3375このエラーは、[Remote Control](/docs/ja/remote-control) サーバーを起動するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しており、`claude remote-control` はどちらのフラグも受け付けないことを意味します。サーバーは起動せずに終了コード 1 で終了します:

3376 

3377```text theme={null}

3378Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings.

3379Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.

3380```

3381 

3382**対処方法:**

3383 

3384* サーバーを自動で起動するスクリプトやサービス定義も含め、コマンドからフラグを削除してから、再度実行します

3385* サーバーが開始するセッションをサンドボックス化するには、[設定ファイル](/docs/ja/settings#where-settings-live)で [`sandbox.enabled`](/docs/ja/settings-reference#sandbox-enabled) を `true` に設定して[サンドボックス化](/docs/ja/sandboxing)をオンにします

3386 

3387両方のフラグは v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだどちらかが含まれている可能性があります。

3388 

3299<h3 id="claude-import-is-not-yet-available-in-this-build">3389<h3 id="claude-import-is-not-yet-available-in-this-build">

3300 claude import is not yet available in this build3390 claude import is not yet available in this build

3301</h3>3391</h3>

3302 3392 

3303[`claude import`](/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code がインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。3393[`claude import`](/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。

3304 3394 

3305```text theme={null}3395```text theme={null}

3306`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3396`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

3307```3397```

3308 3398 

3309Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです:3399Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです:

3310 3400 

3311* インストール後にまだセッションを開始していないため、Claude Code がフラグをまだ取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。3401* インストール後にまだセッションを開始していないため、Claude Code がまだフラグを取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。

3312* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) を通じて Claude Code を使用しています。これらのセッションでは Claude Code が機能フラグを取得しないため、`claude import` は利用できないままです。3402* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由で Claude Code を使用しています。これらのセッションでは Claude Code は機能フラグを取得しないため、`claude import` は利用できないままです。

3313* 機能フラグの取得をオフにする `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) を設定しているため、`claude import` は利用できないままです。3403* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) を設定しています。これらは機能フラグの取得をオフにするため、`claude import` は利用できないままです。

3314 3404 

3315**対処方法:**3405**対処方法:**

3316 3406 

3317* 新規インストールの場合は、`claude` を起動し、セッションが読み込まれるのを待ってから終了し、`claude import` を再実行します3407* 新規インストールの場合は、`claude` を起動してセッションが読み込まれるのを待ち、終了してから再度 `claude import` を実行します

3318* 機能フラグの取得がオフのままの環境では、設定を自分でセットアップします。[`claude mcp add`](/docs/ja/mcp#installing-mcp-servers) で MCP サーバーを追加し、引き継ぎたい [`CLAUDE.md` ファイル](/docs/ja/memory#how-claude-md-files-load)、[スキルとコマンド](/docs/ja/skills#where-skills-live)、[サブエージェント](/docs/ja/sub-agents#choose-the-subagent-scope)を作成します。メッセージでは `~/.claude/settings.json` も挙げられていますが、`claude import` が引き継ぐ設定のうち、このファイルに保存されるのは[権限モード](/docs/ja/settings-reference#permission-settings)だけです。Claude Code はこのファイルから MCP サーバーを読み込みません。3408* 機能フラグの取得がオフのままの環境では、設定を自分で行います。[`claude mcp add`](/docs/ja/mcp#installing-mcp-servers) で MCP サーバーを追加し、引き継ぎたい [`CLAUDE.md` ファイル](/docs/ja/memory#how-claude-md-files-load)、[スキルとコマンド](/docs/ja/skills#where-skills-live)、[サブエージェント](/docs/ja/sub-agents#choose-the-subagent-scope)を作成します。メッセージには `~/.claude/settings.json` も示されています。`claude import` が引き継ぐ設定のうち、このファイルに含まれるのは[権限モード](/docs/ja/settings-reference#permission-settings)のみで、Claude Code はこのファイルから MCP サーバーを読み込みません。

3319 3409 

3320<h3 id="could-not-read-claude-code-config">3410<h3 id="could-not-read-claude-code-config">

3321 Could not read Claude Code config3411 Could not read Claude Code config

3322</h3>3412</h3>

3323 3413 

3324Claude Code が `~/.claude.json`(ログインとプロジェクトごとの状態を保存するファイル)を解析できない状態で [`claude import`](/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否をチェックするためにそのファイルを読み込みますが、対話セッションが表示する復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルが読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログでファイルが処理されていました。3414Claude Code が `~/.claude.json`(ログイン情報とプロジェクトごとの状態を保存するファイル)を解析できない状態で [`claude import`](/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否を確認するためにこのファイルを読み込みますが、対話セッションで表示される復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、読み取れない設定ファイルがある状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログでファイルが処理されていました。

3325 3415 

3326```text theme={null}3416```text theme={null}

3327Could not read Claude Code config — run `claude` with no arguments to recover it.3417Could not read Claude Code config — run `claude` with no arguments to recover it.

3328```3418```

3329 3419 

3330**対処方法:**3420**対処方法:**

3331 3421 

3332* 引数なしで `claude` を実行します。Claude Code が無効なファイルを検出し、リセットを提案します。その後、`claude import` を再実行します。3422* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出し、リセットを提案します。その後、再度 `claude import` を実行します。

3333* 手動で加えた編集を残したい場合は、代わりにエディターで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します3423* 手動で行った編集を残したい場合は、代わりにエディターで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します

3334 3424 

3335<h3 id="could-not-import-a-server-from-claude-desktop">3425<h3 id="could-not-import-a-server-from-claude-desktop">

3336 Could not import a server from Claude Desktop3426 Could not import a server from Claude Desktop

3337</h3>3427</h3>

3338 3428 

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

3340 3430 

3341```text theme={null}3431```text theme={null}

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

3343```3433```

3344 3434 

3345サーバー名の後のテキストが理由です。最も一般的な理由は名前のチェックです。Claude Desktop ではサーバー名にスペースやピリオドなどの文字を使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由としては、サーバー設定の検証の失敗や、組織の [MCP ポリシー](/docs/ja/managed-mcp)によってブロックされたサーバーなどがあります。3435サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではサーバー名にスペースやピリオドなどの文字を使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由には、検証に失敗したサーバー設定や、組織の [MCP ポリシー](/docs/ja/managed-mcp)によってブロックされたサーバーなどがあります。

3346 3436 

3347**対処方法:**3437**対処方法:**

3348 3438 

3349* `claude_desktop_config.json` 内のサーバー名を英字、数字、ハイフン、アンダースコアのみを使用する名前に変更してから、`claude mcp add-from-claude-desktop` を再実行します3439* `claude_desktop_config.json` 内のサーバー名を英字、数字、ハイフン、アンダースコアのみを使用する名前に変更してから、再度 `claude mcp add-from-claude-desktop` を実行します

3350* 有効な名前で、`claude mcp add` または `claude mcp add-json` を使用してそのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](/docs/ja/mcp#import-mcp-servers-from-claude-desktop)を参照してください。3440* `claude mcp add` または `claude mcp add-json` を使用して、有効な名前でそのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](/docs/ja/mcp#import-mcp-servers-from-claude-desktop)を参照してください。

3351 3441 

3352<h3 id="cannot-add-mcp-server-to-the-managed-scope">3442<h3 id="cannot-add-mcp-server-to-the-managed-scope">

3353 Cannot add MCP server to the managed scope3443 Cannot add MCP server to the managed scope

3354</h3>3444</h3>

3355 3445 

3356`--scope managed` を付けて `claude mcp add` または `claude mcp add-json` を実行しました。このスコープには、組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーが含まれます。Claude Code はこれらを管理設定からのみ読み込むため、コマンドはそのスコープにサーバーを書き込めません。3446`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープには、組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーが含まれます。Claude Code はこれらを管理設定からのみ読み込むため、コマンドはそのスコープにサーバーを書き込めません。

3357 3447 

3358```text theme={null}3448```text theme={null}

3359Cannot add MCP server to scope: managed3449Cannot add MCP server to scope: managed

3360```3450```

3361 3451 

3362**対処方法:**3452**対処方法:**

3363 3453 

3364* 書き込み可能なスコープ(`local`、`user`、または `project`)にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](/docs/ja/mcp#mcp-installation-scopes)を参照してください3454* 書き込み可能なスコープ(`local`、`user`、`project`)にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](/docs/ja/mcp#mcp-installation-scopes)を参照してください

3365* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) にサーバーを追加します3455* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) に追加します

3366 3456 

3367<h3 id="cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers">3457<h3 id="cannot-add-mcp-server-when-managed-settings-allow-only-plugin-servers">

3368 管理設定でプラグインのサーバーのみが許可されている場合に MCP サーバーを追加できない3458 Cannot add MCP server when managed settings allow only plugin servers

3369</h3>3459</h3>

3370 3460 

3371組織の管理設定で [`strictPluginOnlyCustomization`](/docs/ja/settings-reference#strictpluginonlycustomization) が `true`、または `mcp` を含むリストに設定されている状態で、`claude mcp add` または `claude mcp add-json` を実行しました。この設定では、Claude Code は `~/.claude.json` や `.mcp.json` から MCP サーバーを読み込まないため、コマンドは決して読み込まれないサーバーを保存する代わりに、終了コード 1 で終了します:3461組織の管理設定で [`strictPluginOnlyCustomization`](/docs/ja/settings-reference#strictpluginonlycustomization) が `true` または `mcp` を含むリストに設定されている状態で、`claude mcp add` または `claude mcp add-json` を実行しました。この設定では、Claude Code は `~/.claude.json` や `.mcp.json` から MCP サーバーを読み込まないため、コマンドは決して読み込まれないサーバーを保存せずに終了コード 1 で終了します:

3372 3462 

3373```text theme={null}3463```text theme={null}

3374Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.3464Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.

3375```3465```

3376 3466 

3377`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、その理由としてこのメッセージを表示します。[`/import`](/docs/ja/commands#all-commands) は、追加しようとした各 MCP サーバーについてこのメッセージを報告し、見つかった他の項目のインポートは続行します。3467`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、その理由としてこのメッセージを示します。[`/import`](/docs/ja/commands#all-commands) は、追加しようとした各 MCP サーバーについてこのメッセージを報告し、見つかった他の項目はそのままインポートします。

3378 3468 

3379v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーが読み込まれることはありませんでした。3469v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーは読み込まれませんでした。

3380 3470 

3381**対処方法:**3471**対処方法:**

3382 3472 

3383* サーバーを提供する[プラグイン](/docs/ja/plugins/install)をインストールします3473* サーバーを提供する[プラグイン](/docs/ja/plugins/install)をインストールします

3384* 管理者に、サーバーを[プラグイン](/docs/ja/plugins/org)で配布するか、リモート HTTP または SSE サーバーであれば [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じて提供するよう依頼します3474* 管理者に、サーバーを[プラグイン](/docs/ja/plugins/org)で配布するか、リモートの HTTP または SSE サーバーであれば [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じて提供するよう依頼します

3385 3475 

3386<h3 id="cant-read-mcp-json">3476<h3 id="cant-read-mcp-json">

3387 Can't read .mcp.json3477 Can't read .mcp.json

3388</h3>3478</h3>

3389 3479 

3390プロジェクトの [`.mcp.json`](/docs/ja/mcp#project-scope) を読み込むコマンド(`--scope project` を付けた `claude mcp add` や `claude mcp add-json`、または `claude mcp remove` など)が、現在のディレクトリにあるそのファイルが通常のファイルではないか、2 MiB を超えていることを検出したため、ファイルを読み込まずにこのエラーで終了します。3480`--scope project` を指定した `claude mcp add` や `claude mcp add-json`、または `claude mcp remove` など、プロジェクトの [`.mcp.json`](/docs/ja/mcp#project-scope) を読み込むコマンドが、現在のディレクトリにあるファイルが通常のファイルではないか 2 MiB を超えていることを検出したため、ファイルを読み込まずにこのエラーで終了します。

3391 3481 

3392```text theme={null}3482```text theme={null}

3393Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3483Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.

3394```3484```

3395 3485 

3396v2.1.257 より前は、`.mcp.json` が FIFO の場合はコマンドが出力なしで永久に待機し、`/dev/zero` などのデバイスファイルへのシンボリックリンクの場合はプロセスが強制終了されるまでメモリが増加していました。3486v2.1.257 より前は、`.mcp.json` に FIFO があるとコマンドは出力なしで無期限に待機し、`/dev/zero` などのデバイスファイルへのシンボリックリンクがあるとプロセスが強制終了されるまでメモリが増加し続けていました。

3397 3487 

3398**対処方法:**3488**対処方法:**

3399 3489 

3400* 現在のディレクトリの `.mcp.json` にあるものを確認します。[プロジェクトスコープの形式](/docs/ja/mcp#project-scope)の通常の JSON ファイルに置き換えるか削除してから、コマンドを再実行します。3490* 現在のディレクトリの `.mcp.json` に何があるかを確認します。[プロジェクトスコープの形式](/docs/ja/mcp#project-scope)の通常の JSON ファイルに置き換えるか削除してから、コマンドを再度実行します。

3401 3491 

3402<h3 id="mcp-server-was-not-saved-or-removed">3492<h3 id="mcp-server-was-not-saved-or-removed">

3403 MCP server was not saved or removed3493 MCP server was not saved or removed

3404</h3>3494</h3>

3405 3495 

3406`user` または `local` [スコープ](/docs/ja/mcp#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しました。どちらのスコープも `~/.claude.json` に保存されますが、書き込み後に Claude Code がそのファイルを読み直したときに、変更が反映されていませんでした。コマンドは成功を示す行の代わりにこのエラーで終了します。3496`user` または `local` [スコープ](/docs/ja/mcp#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しました。どちらのスコープも `~/.claude.json` に保存されますが、書き込み後に Claude Code がファイルを読み戻したときに、変更がファイルに反映されていませんでした。コマンドは成功の行の代わりにこのエラーで終了します。

3407 3497 

3408```text theme={null}3498```text theme={null}

3409MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3499MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.

3410```3500```

3411 3501 

3412削除の後は、メッセージが `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合、パスの後にエントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` の形式で続きます。3502削除の場合、メッセージは `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合、パスの後にエントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` として示されます。

3413 3503 

3414v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。3504v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。

3415 3505 

3416**対処方法:**3506**対処方法:**

3417 3507 

3418* メッセージに示されたファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除のコマンドを再実行します。3508* メッセージに示されたファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除コマンドを再度実行します。

3419 3509 

3420<h3 id="mcp-server-may-not-have-been-saved-or-removed">3510<h3 id="mcp-server-may-not-have-been-saved-or-removed">

3421 MCP server may not have been saved or removed3511 MCP server may not have been saved or removed

3422</h3>3512</h3>

3423 3513 

3424`user` または `local` [スコープ](/docs/ja/mcp#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しましたが、Claude Code が変更を確認するために `~/.claude.json` を読み直せませんでした。変更はディスクに反映されている場合もあれば、されていない場合もあります。括弧内のテキストは、その読み込み時のエラーです。3514`user` または `local` [スコープ](/docs/ja/mcp#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しましたが、Claude Code は変更を確認するために `~/.claude.json` を読み戻せませんでした。変更がディスクに反映されているかどうかは不明です。括弧内のテキストは、その読み取りのエラーです。

3425 3515 

3426```text theme={null}3516```text theme={null}

3427MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3517MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.

3428```3518```

3429 3519 

3430削除の後は、メッセージが `may not have been removed` となり、`then remove the server again if it is still listed` で終わります。3520削除の場合、メッセージは `may not have been removed` となり、`then remove the server again if it is still listed` で終わります。

3431 3521 

3432v2.1.283 より前は、変更を確認できなかった場合でも、これらのコマンドは成功を報告していました。3522v2.1.283 より前は、変更を確認できなかった場合でも、コマンドは成功を報告していました。

3433 3523 

3434**対処方法:**3524**対処方法:**

3435 3525 

3436* `claude mcp get <name>` を実行して、変更がディスクに反映されているかを確認します。`local` スコープのサーバーの場合は、ローカルスコープがプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。3526* `claude mcp get <name>` を実行して、変更がディスクに反映されているかを確認します。`local` スコープのサーバーの場合、ローカルスコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。

3437* 追加の後にサーバーが存在しない場合、または削除の後にまだ一覧に表示される場合は、同じ追加または削除のコマンドを再実行します。3527* 追加後にサーバーが見つからない場合、または削除後もまだ一覧に表示される場合は、同じ追加または削除コマンドを再度実行します。

3438 3528 

3439<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3529<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">

3440 Server is Anthropic-hosted and doesn't support local OAuth3530 Server is Anthropic-hosted and doesn't support local OAuth

3441</h3>3531</h3>

3442 3532 

3443URL が、サードパーティの ID プロバイダーを通じて認証する Anthropic ホストのコネクタホストを指している MCP サーバーに対してサインインを開始しました。これらのホストには `microsoft365.mcp.claude.com`、`gmail.mcp.claude.com`、`gcal.mcp.claude.com` が含まれます。[これらのサインインは claude.ai を通じてのみ機能する](/docs/ja/mcp#use-mcp-servers-from-claude-ai)ため、Claude Code は `/mcp` パネルからも `claude mcp login` からも、これらのホストに対するローカルの OAuth フローの開始を拒否します。3533サードパーティの ID プロバイダーを通じて認証する、Anthropic がホストするコネクタのホストを URL が指している MCP サーバーに対して、サインインを開始しました。これらのホストには `microsoft365.mcp.claude.com`、`gmail.mcp.claude.com`、`gcal.mcp.claude.com` が含まれます。[これらのサインインは claude.ai を通じてのみ機能する](/docs/ja/mcp#use-mcp-servers-from-claude-ai)ため、Claude Code は `/mcp` パネルと `claude mcp login` のどちらからも、これらのホストに対するローカル OAuth フローの開始を拒否します。

3444 3534 

3445```text theme={null}3535```text theme={null}

3446"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.3536"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.

3447```3537```

3448 3538 

3449**対処方法:**3539**対処方法:**

3450 3540 

3451* 同じ URL の claude.ai コネクタが隠れないように、`claude mcp remove <name>` でエントリを削除します3541* `claude mcp remove <name>` でエントリを削除し、同じ URL の claude.ai コネクタが隠されないようにします

3452* 削除した後、Claude Code で使用しているアカウントにサインインした状態で、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) でサービスを接続します。接続後、アクティブな認証方法が claude.ai のサブスクリプションログインであれば、[コネクタは Claude Code に自動的に表示されます](/docs/ja/mcp#use-mcp-servers-from-claude-ai)3542* 削除後、Claude Code で使用しているアカウントにサインインした状態で、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) でサービスを接続します。接続すると、アクティブな認証方法が claude.ai サブスクリプションのログインであれば、[コネクタが Claude Code に自動的に表示されます](/docs/ja/mcp#use-mcp-servers-from-claude-ai)

3453 3543 

3454<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3544<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">

3455 Server rejected the Authorization header minted by the configured headersHelper3545 Server rejected the Authorization header minted by the configured headersHelper

3456</h3>3546</h3>

3457 3547 

3458[`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) が `Authorization` ヘッダーを提供する MCP サーバーが HTTP 401 または 403 で接続に応答したため、Claude Code は接続を失敗として報告します。ヘルパーが `Authorization` ヘッダーを提供するため、Claude Code はそのサーバーについて [OAuth にフォールバックしません](/docs/ja/mcp#authenticate-with-remote-mcp-servers):3548[`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) が `Authorization` ヘッダーを提供する MCP サーバーが接続に対して HTTP 401 または 403 を返したため、Claude Code は接続を失敗として報告します。ヘルパーが `Authorization` ヘッダーを提供しているため、Claude Code はそのサーバーに対して [OAuth にフォールバックしません](/docs/ja/mcp#authenticate-with-remote-mcp-servers):

3459 3549 

3460```text theme={null}3550```text theme={null}

3461Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3551Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.

3462```3552```

3463 3553 

3464Claude Code は接続を試みるたびにヘルパーを再実行するため、トークンのローテーションの競合など一時的な拒否の後であれば、再試行によって新しい認証情報で成功することがあります。3554Claude Code は接続を試みるたびにヘルパーを再実行するため、トークンのローテーションの競合など、一時的な拒否の後の再試行では、新しい認証情報で成功する場合があります。

3465 3555 

3466**対処方法:**3556**対処方法:**

3467 3557 

3468* Claude Code が実行するのと同じ方法で、`headersHelper` コマンドを自分で実行します。つまり、[Claude Code がヘルパーを実行するディレクトリ](/docs/ja/mcp#where-the-helper-runs)から、[Claude Code がヘルパー用に設定する環境変数](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication)を付け、プロジェクトの `.mcp.json`、プラグイン、またはプロジェクトのエージェントファイルのサーバーの場合は[Claude Code が削除する認証情報の変数](/docs/ja/mcp#which-variables-a-helper-can-read)を除いて実行します。サーバーのエンドポイントが受け付ける `Authorization` の値が出力されることを確認してください3558* Claude Code と同じ方法で `headersHelper` コマンドを自分で実行します。つまり、[Claude Code がヘルパーを実行するディレクトリ](/docs/ja/mcp#where-the-helper-runs)から、[Claude Code がヘルパー用に設定する環境変数](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication)を使用し、プロジェクトの `.mcp.json`、プラグイン、またはプロジェクトのエージェントファイルに由来するサーバーの場合は [Claude Code が削除する認証情報の変数](/docs/ja/mcp#which-variables-a-helper-can-read)を除いた状態で実行します。サーバーのエンドポイントが受け付ける `Authorization` の値が出力されることを確認します

3469* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択し、**Reconnect** を選択します3559* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択して **Reconnect** を選択します

3470 3560 

3471v2.1.248 より前は、ヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても Claude Code は OAuth の検出を実行していました。その検出は、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。3561v2.1.248 より前は、ヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても、Claude Code は OAuth ディスカバリーを実行していました。このディスカバリーは、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。

3472 3562 

3473<h3 id="mcp-permission-prompt-tool-not-found">3563<h3 id="mcp-permission-prompt-tool-not-found">

3474 MCP permission prompt tool not found3564 MCP permission prompt tool not found

3475</h3>3565</h3>

3476 3566 

3477[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) に渡したツールが、実行で初めて権限の判断が必要になった時点で、接続済みの MCP ツールの中にありませんでした。そのサーバーが接続しなかったか、接続済みのどのサーバーもその名前のツールを公開していないためです。Claude Code はそれでもプロンプトを送信します。[非対話](/docs/ja/headless)の実行は最初のツール呼び出しでこのエラーと終了コード 1 で終了するため、リクエストは行われたものの回答は生成されません。最初のプロンプトの前に、Claude Code はそのサーバーが接続するまで、[`MCP_TIMEOUT`](/docs/ja/env-vars) で設定されるサーバーごとの接続タイムアウト(30 秒)まで待機します。v2.1.206 より前は、起動時にサーバーの接続完了を待たなかったため、起動が遅いものの正常なサーバーでもこのエラーが発生していました。3567[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) に渡したツールが、実行で最初に権限の判断が必要になった時点で、接続済みの MCP ツールの中にありませんでした。原因は、そのサーバーが接続されなかったか、接続済みのサーバーがその名前のツールを公開していないかのいずれかです。Claude Code はプロンプトを送信しますが、[非対話](/docs/ja/headless)の実行は最初のツール呼び出しの時点でこのエラーと終了コード 1 で終了するため、リクエストは送信されたものの回答は生成されません。最初のプロンプトの前に、Claude Code はそのサーバーが接続されるまで、[`MCP_TIMEOUT`](/docs/ja/env-vars) で設定されたサーバーごとの接続タイムアウト(30 秒)まで待機します。v2.1.206 より前は、起動時にサーバーの接続完了を待たなかったため、起動に時間がかかるものの正常なサーバーでもこのエラーが発生していました。

3478 3568 

3479```text theme={null}3569```text theme={null}

3480Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3570Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

3481```3571```

3482 3572 

3483`Available MCP tools:` の後の一覧は、接続されていた MCP ツールを示します。3573`Available MCP tools:` の後のリストには、接続されていた MCP ツールが示されます。

3484 3574 

3485**対処方法:**3575**対処方法:**

3486 3576 

3487* サーバーが起動し、接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして一覧に表示されることを確認してください3577* サーバーが起動して接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして表示されることを確認します

3488* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致することを確認します3578* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致することを確認します

3489* サーバーの起動に 30 秒より長くかかる場合は、[`MCP_TIMEOUT`](/docs/ja/env-vars) の値を引き上げます3579* サーバーの起動に 30 秒以上かかる場合は、[`MCP_TIMEOUT`](/docs/ja/env-vars) を増やします

3490 3580 

3491<h3 id="oauth-callback-port-is-already-in-use">3581<h3 id="oauth-callback-port-is-already-in-use">

3492 OAuth callback port is already in use3582 OAuth callback port is already in use

3493</h3>3583</h3>

3494 3584 

3495OAuth でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを起動します。そのリスナーが必要とするポートを別のプロセスが保持している場合、サインインはこのメッセージで失敗します。これは主に、[`MCP_OAUTH_CALLBACK_PORT`](/docs/ja/env-vars) 変数または `--callback-port` で[固定のコールバックポート](/docs/ja/mcp#use-a-fixed-oauth-callback-port)を設定している場合に発生します。固定ポートを設定しない場合、Claude Code は利用可能なポートを選ぶためです。3585OAuth でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを起動します。リスナーが必要とするポートを別のプロセスが使用している場合、サインインはこのメッセージで失敗します。これは主に、[`MCP_OAUTH_CALLBACK_PORT`](/docs/ja/env-vars) 変数または `--callback-port` で[固定のコールバックポート](/docs/ja/mcp#use-a-fixed-oauth-callback-port)を設定している場合に発生します。固定ポートがない場合、Claude Code は利用可能なポートを選択するためです。

3496 3586 

3497```text theme={null}3587```text theme={null}

3498OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3588OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.


3500 3590 

3501Windows では、代わりに `netstat -ano | findstr :<port>` が提案されます。3591Windows では、代わりに `netstat -ano | findstr :<port>` が提案されます。

3502 3592 

3503**対処方法:**3593**対処方法:**

3504 3594 

3505* メッセージのコマンドを実行してポートを保持しているプロセスを特定し、そのプロセスを停止するか、終了するまで待ちます3595* メッセージのコマンドを実行してポートを使用しているプロセスを特定し、停止するか終了を待ちます

3506* 別のプログラムがそのポートを常に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方法に応じて `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します3596* 別のプログラムがそのポートを常に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方法に応じて `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します

3507* その後、たとえば `/mcp` でサーバーを選択して、サインインを再度開始します3597* その後、`/mcp` でサーバーを選択するなどして、再度サインインを開始します

3508 3598 

3509<h3 id="no-available-ports-for-oauth-redirect">3599<h3 id="no-available-ports-for-oauth-redirect">

3510 No available ports for OAuth redirect3600 No available ports for OAuth redirect

3511</h3>3601</h3>

3512 3602 

3513[OAuth](/docs/ja/mcp#authenticate-with-remote-mcp-servers) でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを起動します。そのためのローカルポートを Claude Code がバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアや、ローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` での待ち受けを妨げています。3603[OAuth](/docs/ja/mcp#authenticate-with-remote-mcp-servers) でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを起動します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアやローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。

3514 3604 

3515```text theme={null}3605```text theme={null}

3516No available ports for OAuth redirect3606No available ports for OAuth redirect

3517```3607```

3518 3608 

3519v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身で選んだポートだけをバインドできない場合にもこのメッセージが表示されていました。これは、Hyper-V が Claude Code の選択対象となるポートを含む範囲を予約している Windows ホストで発生することがあります。3609v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身で選択したポートをバインドできない場合にもこのメッセージが表示されていました。これは、Hyper-V が Claude Code の選択対象のポートを含むポート範囲を予約している Windows ホストで発生することがあります。

3520 3610 

3521**対処方法:**3611**対処方法:**

3522 3612 

3523* セキュリティソフトウェアまたはサンドボックスポリシーが、プロセスによる `127.0.0.1` での待ち受けをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるように許可します3613* セキュリティソフトウェアやサンドボックスポリシーがプロセスによる `127.0.0.1` でのリッスンをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるようにします

3524* その後、たとえば `/mcp` でサーバーを選択して、サインインを再度開始します3614* その後、`/mcp` でサーバーを選択するなどして、再度サインインを開始します

3525 3615 

3526<h3 id="security-review-fails-without-origin-head">3616<h3 id="security-review-fails-without-origin-head">

3527 origin/HEAD がない場合に /security-review が失敗する3617 origin/HEAD がないと /security-review が失敗する

3528</h3>3618</h3>

3529 3619 

3530[`/security-review`](/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD`(`origin` リモートでどのブランチがデフォルトかを記録するローカル参照)との差分を取ることで、レビューのコンテキストを構築します。その参照が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。3620[`/security-review`](/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD` の差分を取ってレビューのコンテキストを構築します。`origin/HEAD` は、`origin` リモートでどのブランチがデフォルトかを記録するローカル参照です。この参照が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。

3531 3621 

3532```text theme={null}3622```text theme={null}

3533Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3623Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]


3536'git <command> [<revision>...] -- [<file>...]'3626'git <command> [<revision>...] -- [<file>...]'

3537```3627```

3538 3628 

3539メッセージには、代わりに `git log` や別の `git diff` が引用されている場合もあります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、フェッチの refspec がそれを含む場合だけです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次のような構成では、参照が存在しません:3629メッセージには、代わりに `git log` や別の `git diff` が引用されている場合があります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、かつフェッチの refspec がそれをカバーしている場合のみです。コミットがあるリモートの完全な `git clone` はこれに該当します。次の構成ではこの参照が存在しません:

3540 3630 

3541* 単一ブランチのチェックアウトや CI のチェックアウト。フェッチする refspec が狭すぎます3631* 狭すぎる refspec をフェッチする、単一ブランチまたは CI のチェックアウト

3542* サーバー側の HEAD が、誰もプッシュしていないブランチを指しているリモート3632* サーバー側の HEAD が誰もプッシュしていないブランチを指しているリモート

3543* `origin` リモートがないリポジトリ、または一度もフェッチしていないリポジトリ3633* `origin` リモートがない、または一度もフェッチしていないリポジトリ

3544 3634 

3545Claude Code は、[動的コンテキストを挿入する](/docs/ja/skills#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。コマンドが実行される前に発生する、関連する 2 つの文字列があります:3635Claude Code は、[動的コンテキストを挿入する](/docs/ja/skills#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。

3546 3636 

3547* `Shell command permission check failed for pattern "..."`: コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](/docs/ja/skills#permission-checks-on-injected-commands)では、各権限モードでどの結果によって中止されるか、および `allowed-tools` でコマンドを事前承認する方法を説明しています3637関連するメッセージは、コマンドが実行される前に発生します:

3548* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: スキルのフロントマターが、bash のないマシンで bash を要求しています。Git for Windows をインストールするか、フロントマターを `shell: powershell` に変更してください。[挿入されたコマンドの実行方法](/docs/ja/skills#how-injected-commands-run)を参照してください

3549 3638 

3550**対処方法:**3639* `Shell command permission check failed for pattern "..."`: コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](/docs/ja/skills#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止につながるか、および `allowed-tools` でコマンドを事前承認する方法を説明しています

3640* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: スキルのフロントマターが、bash のないマシンで bash を要求しています。Git for Windows をインストールするか、フロントマターを `shell: powershell` に変更します。[挿入されたコマンドの実行方法](/docs/ja/skills#how-injected-commands-run)を参照してください

3641* `No shell command in <name> was run`: ファイルの `!` コマンドのいずれかに、タブと改行以外の生の制御文字が含まれているため、いずれも実行されません。[文字を見つけて削除する方法](#no-shell-command-was-run)を参照してください

3642 

3643**対処方法:**

3644 

3645* リモートのデフォルトブランチを指定して参照を作成します:`git remote set-head origin <default-branch>`。これは、ローカルの追跡参照 `origin/<default-branch>` が存在すれば機能します。単一ブランチのクローンのように存在しない場合は、まずブランチをフェッチします。`git remote set-branches --add origin <branch>` を実行し、次に `git fetch origin` を実行してから、set-head コマンドを再実行します。その後、`/security-review` を再実行します。

3646* ブランチを指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これにより、どのブランチがデフォルトかをリモートに問い合わせます。リモートが空である、またはその HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合は代わりにブランチを明示的に指定します。クローンがそのブランチをフェッチしない場合は `error: Not a valid ref` で失敗します。その場合は、まず上記のように refspec を広げます。

3647* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、参照を作成する前にフェッチします。リモートが空の場合は、まず `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。これにより `origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで `/security-review` には空の差分が表示されます。

3648 

3649<h3 id="no-shell-command-was-run">

3650 No shell command in a skill or command was run

3651</h3>

3652 

3653スキルまたはカスタムコマンドファイル内の `` !`<command>` `` [動的コンテキストコマンド](/docs/ja/skills#inject-dynamic-context)のいずれかに、タブや改行以外の生の制御文字が含まれています。Claude Code は、ファイル内のどのコマンドも実行する前に、呼び出し全体を拒否します。

3551 3654 

3552* リモートのデフォルトブランチを指定して参照を作成します: `git remote set-head origin <default-branch>`。これは、ローカルの追跡参照 `origin/<default-branch>` が存在する場合に機能します。単一ブランチのクローンのように存在しない場合は、まずブランチをフェッチします。`git remote set-branches --add origin <branch>` を実行し、次に `git fetch origin` を実行してから、set-head コマンドを再実行します。その後、`/security-review` を再実行します。3655メッセージには、コマンドを実行するはずだったシェルツール(Bash または PowerShell)が示され、拒否されたコマンドで終わります。該当する各文字は `�` に置き換えられるため、場所を確認できます:

3553* ブランチを指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これはリモートにデフォルトブランチを問い合わせます。リモートが空であるか、HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合は代わりにブランチを明示的に指定してください。クローンがそのブランチをフェッチしない場合は `error: Not a valid ref` で失敗します。まず上記のとおり refspec を広げてください。3656 

3554* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、フェッチしてから参照を作成します。リモートが空の場合は、まず `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。すると `origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで `/security-review` には空の差分が表示されます。3657```text theme={null}

3658No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.

3659build.sh --target�dist

3660```

3661 

3662**対処方法:**

3663 

3664* メッセージの末尾に引用されたコマンド内の各 `�` を探します。それが表す文字を、スキルまたはコマンドファイル、あるいはファイルに代入される引数やオプションから削除します。

3555 3665 

3556<h3 id="input-must-be-provided-when-using-print">3666<h3 id="input-must-be-provided-when-using-print">

3557 Input must be provided when using `--print`3667 Input must be provided when using `--print`

3558</h3>3668</h3>

3559 3669 

3560引数なしの `claude` で対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合や、PowerShell ISE や一部の IDE の出力ペインのようにコンソールが本物のターミナルではない場合、`claude` は代わりに[非対話](/docs/ja/headless)で実行されます。これは `claude -p` と同じモードで、プロンプトが必要です。そのため、フラグを渡していなくてもメッセージには `--print` が示されます。プロンプトなしで、stdin にも何もパイプせずに `-p`/`--print` を渡した場合も、どこであっても同じエラーが発生します。3670引数なしの `claude` では、対話 UI を開始するために stdout がターミナルである必要があります。stdout がリダイレクトされている場合や、PowerShell ISE や一部の IDE の出力ペインのようにコンソールが実際のターミナルではない場合、`claude` は代わりに[非対話](/docs/ja/headless)で実行されます。これは `claude -p` と同じモードであり、プロンプトが必要なため、フラグを渡していなくてもメッセージには `--print` が示されます。プロンプトなしで、stdin にも何もパイプせずに `-p`/`--print` を渡した場合も、どこでも同じエラーが発生します。

3561 3671 

3562```text theme={null}3672```text theme={null}

3563Error: Input must be provided either through stdin or as a prompt argument when using --print3673Error: Input must be provided either through stdin or as a prompt argument when using --print

3564```3674```

3565 3675 

3566**対処方法:**3676**対処方法:**

3567 3677 

3568* 対話的に使用する場合は、本物のターミナルで `claude` を実行します。ISE ではなく Windows Terminal または PowerShell コンソールを、出力ペインではなく IDE の統合ターミナルを使用してください3678* 対話的に使用する場合は、実際のターミナルで `claude` を実行します。ISE ではなく Windows Terminal または PowerShell コンソール、出力ペインではなく IDE の統合ターミナルを使用します

3569* 単発で使用する場合は、プロンプトを渡します: `claude -p "your question"`、または `echo "your question" | claude -p` でパイプします3679* 単発で使用する場合は、プロンプトを渡します:`claude -p "your question"`、またはパイプで `echo "your question" | claude -p`

3570 3680 

3571<h3 id="claude-code-cant-read-the-keyboard-here">3681<h3 id="claude-code-cant-read-the-keyboard-here">

3572 Claude Code can't read the keyboard here3682 Claude Code can't read the keyboard here

3573</h3>3683</h3>

3574 3684 

3575[`-p`](/docs/ja/headless) を付けずに `claude` を実行したため[対話セッション](/docs/ja/interactive-mode)が開始されますが、その標準入力がターミナルではありません。何かがパイプまたはリダイレクトしているか、`claude` を起動したプログラムが独自の入力ストリームを提供しています。3685[`-p`](/docs/ja/headless) を付けずに `claude` を実行して[対話セッション](/docs/ja/interactive-mode)を開始しましたが、その標準入力がターミナルではありません。何かがパイプまたはリダイレクトしているか、`claude` を起動したプログラムが独自の入力ストリームを提供しています。

3576 3686 

3577対話セッションではキー入力を読み取るためのターミナルが必要であり、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります:3687対話セッションにはキー入力を読み取るためのターミナルが必要で、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります:

3578 3688 

3579* **Windows**: Claude Code はインターフェースを開始せず、メッセージを stderr に出力して終了コード 1 で終了します3689* **Windows**:Claude Code はインターフェースを開始せずに、メッセージを stderr に出力して終了コード 1 で終了します

3580* **macOS と Linux**: Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その 1 行目では Windows の文言の代わりに `/dev/tty` が示されます。3690* **macOS と Linux**:Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。このメッセージは `/dev/tty` を開けない場合に表示され、その 1 行目には Windows の文言の代わりに `/dev/tty` が示されます。

3581 3691 

3582Windows では、メッセージは次のようになります:3692Windows では、メッセージは次のとおりです:

3583 3693 

3584```text theme={null}3694```text theme={null}

3585Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.3695Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.


3587To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).3697To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).

3588```3698```

3589 3699 

3590**対処方法:**3700**対処方法:**

3591 3701 

3592* 対話的に作業するには、入力をパイプまたはリダイレクトせずに、ターミナルで直接 `claude` を実行します3702* 対話的に作業するには、入力をパイプまたはリダイレクトせずに、ターミナルで直接 `claude` を実行します

3593* スクリプトからなど、対話インターフェースなしで応答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` や `--resume <session-id>` でも同じように機能します。3703* スクリプトからなど、対話インターフェースなしで返答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` や `--resume <session-id>` でも同様に機能します。

3594 3704 

3595v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。3705v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。

3596 3706 

3597代わりに `claude install` の実行中に `Raw mode is not supported` が表示される場合は、[インストール中の `Raw mode is not supported`](/docs/ja/troubleshoot-install#raw-mode-is-not-supported-during-install) を参照してください。3707代わりに `claude install` 中に `Raw mode is not supported` が表示される場合は、[インストール中の `Raw mode is not supported`](/docs/ja/troubleshoot-install#raw-mode-is-not-supported-during-install) を参照してください。

3598 3708 

3599<h3 id="input-contained-only-whitespace">3709<h3 id="input-contained-only-whitespace">

3600 Input contained only whitespace3710 Input contained only whitespace

3601</h3>3711</h3>

3602 3712 

3603[非対話モード](/docs/ja/headless)では、Claude Code はスペース、タブ、改行だけで構成されたプロンプトを送信せずに拒否します。API は表示可能なテキストのないメッセージを拒否するためです。表示されるメッセージは、空白のプロンプトがどこから来たかによって異なります:3713[非対話モード](/docs/ja/headless)では、Claude Code はスペース、タブ、改行のみで構成されたプロンプトを送信せずに拒否します。API は表示可能なテキストのないメッセージを拒否するためです。表示されるメッセージは、空白のプロンプトがどこから来たかによって異なります:

3604 3714 

3605* **`claude -p` のプロンプト引数またはパイプされた stdin**: `claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します3715* **`claude -p` のプロンプト引数またはパイプされた stdin**:`claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します

3606* **実行中の `--input-format stream-json` または [Agent SDK](/docs/ja/agent-sdk/overview) セッションに送信されたメッセージ**: Claude Code はモデルを呼び出さずにターンを終了し、セッションは引き続き使用できます。拒否は、情報メッセージとして、またターンの結果テキストとして届きます: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`3716* **実行中の `--input-format stream-json` または [Agent SDK](/docs/ja/agent-sdk/overview) セッションに送信されたメッセージ**:Claude Code はモデルを呼び出さずにターンを終了し、セッションは引き続き使用できます。拒否は情報メッセージとして、またターンの結果テキストとして返されます:`Blank prompt — the message was only whitespace, so nothing was sent to the model.`

3607 3717 

3608v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API はリクエストを 400 エラーで拒否していました。3718v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API は 400 エラーでリクエストを拒否していました。

3609 3719 

3610**対処方法:**3720**対処方法:**

3611 3721 

3612* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを作成する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。3722* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを組み立てる場合は、Claude Code を呼び出す前にソースが空でないことを確認します。

3613 3723 

3614<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3724<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">

3615 stream-json input carried over 256M characters with no newline3725 stream-json input carried over 256M characters with no newline

3616</h3>3726</h3>

3617 3727 

3618プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超える内容を stdin に送信したため、Claude Code は入力をそれ以上バッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限を `256M` と表記しています。v2.1.257 より前は、Claude Code はそのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。3728プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超える文字を stdin に送信したため、Claude Code はそれ以上入力をバッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限が `256M` と表記されています。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加し続けていました。

3619 3729 

3620```text theme={null}3730```text theme={null}

3621Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3731Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.

3622```3732```

3623 3733 

3624改行なしでこれほど長い入力がある場合、通常は、誤ってパイプされたバイナリファイルやプレーンなログ出力など、入力元がそもそも stream-json の生成元ではないことを意味します。単一のメッセージが上限を超えた場合も、同じチェックで失敗します。3734改行なしでこれほど長い入力は、通常、プロデューサーがそもそも stream-json のプロデューサーではないことを意味します。たとえば、バイナリファイルや通常のログ出力が誤ってパイプされた場合です。上限を超える単一のメッセージも同じチェックで失敗します。

3625 3735 

3626**対処方法:**3736**対処方法:**

3627 3737 

3628* stdin に何がパイプされているかを確認します。[`--input-format stream-json`](/docs/ja/cli-reference#cli-flags) では、すべてのメッセージが改行で終わる 1 行の JSON である必要があります3738* stdin に何がパイプされているかを確認します。[`--input-format stream-json`](/docs/ja/cli-reference#cli-flags) では、各メッセージは改行で終わる 1 行の JSON である必要があります

3629* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を削除します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります3739* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を削除します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります

3630 3740 

3631<h3 id="unknown-command">3741<h3 id="unknown-command">

3632 Unknown command3742 Unknown command

3633</h3>3743</h3>

3634 3744 

3635対話型のターミナルセッションで、このセッションのどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告します:3745対話型のターミナルセッションで、このセッションのどのコマンドにも一致しない `/` の名前を送信したため、Claude Code は何も実行せずにその名前を報告します:

3636 3746 

3637```text theme={null}3747```text theme={null}

3638Unknown command: /hepl. Did you mean /help?3748Unknown command: /hepl. Did you mean /help?

3639```3749```

3640 3750 

3641Claude Code は、このセッションのメニューに表示されるコマンド名またはエイリアスのうち、最も近いものを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです:3751Claude Code は、このセッションでメニューに表示される中で最も近いコマンド名またはエイリアスを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです:

3642 3752 

3643* `/help` を `/hepl` と入力するようなタイプミス。[コマンドメニューが入力内容とどのように一致するか](/docs/ja/commands#how-the-command-menu-matches-what-you-type)では、送信前に近い候補を選ぶ方法を説明しています3753* `/help` を `/hepl` と入力するなどのタイプミス。送信前に近い候補を選ぶ方法については、[コマンドメニューが入力内容と照合される仕組み](/docs/ja/commands#how-the-command-menu-matches-what-you-type)を参照してください

3644* コマンドは存在するものの、プラットフォーム、プラン、認証方法などの要件が満たされていないため、このセッションでは利用できない。[`/web-setup`](/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) と [`/schedule`](/docs/ja/routines#schedule-returns-unknown-command) のトラブルシューティング項目で、よくある 2 つのケースを説明しています。一部のコマンドは、組織のポリシーで無効になっている場合に、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) のような独自のメッセージで応答します3754* 存在するものの、プラットフォーム、プラン、認証方法などの要件を満たしていないために、このセッションでは利用できないコマンド。[`/web-setup`](/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) と [`/schedule`](/docs/ja/routines#schedule-returns-unknown-command) のトラブルシューティング項目では、よくある 2 つのケースを説明しています。組織のポリシーによって無効化されている場合に、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) のような独自のメッセージを返すコマンドもあります

3645* このセッションでインストールまたは接続されていない[プラグイン](/docs/ja/plugins/overview)や [MCP サーバー](/docs/ja/mcp#use-mcp-prompts-as-commands)のコマンド3755* このセッションでインストールまたは接続されていない[プラグイン](/docs/ja/plugins/overview)や [MCP サーバー](/docs/ja/mcp#use-mcp-prompts-as-commands)のコマンド

3646 3756 

3647Claude Code が一致しない `/` 名にこのように応答するのは、対話型のターミナルセッションの場合だけです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示すメモと、セッションで Claude が実行できるコマンドの一覧を添えます。そのようなセッションには次のものがあります:3757Claude Code が一致しない `/` の名前にこのように応答するのは、対話型のターミナルセッションのみです。その他のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示すメモと、そのセッションで Claude が実行できるコマンドの一覧を添えます。これらのセッションには次のものが含まれます:

3648 3758 

3649* `-p` での実行3759* `-p` の実行

3650* [Agent SDK](/docs/ja/agent-sdk/overview) アプリケーション3760* [Agent SDK](/docs/ja/agent-sdk/overview) アプリケーション

3651* [デスクトップアプリ](/docs/ja/desktop)の Code タブ3761* [デスクトップアプリ](/docs/ja/desktop)の Code タブ

3652* [VS Code 拡張機能](/docs/ja/vs-code)のチャットパネル3762* [VS Code 拡張機能](/docs/ja/vs-code)のチャットパネル

3653* [クラウドセッション](/docs/ja/claude-code-on-the-web)と[ルーティン](/docs/ja/routines)3763* [クラウドセッション](/docs/ja/claude-code-on-the-web)と[ルーティン](/docs/ja/routines)

3654 3764 

3655これらのセッションのいずれかで実行できない組み込みコマンドについては、Claude Code は Claude に送信する代わりに、そのコマンドは利用できないと応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとルーティンだけでした。v2.1.273 より前は、それらも `Unknown command` と応答していました。3765これらのセッションのいずれかで実行できない組み込みコマンドの場合、Claude Code は Claude に送信する代わりに、そのコマンドは利用できないと応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとルーティンのみでした。v2.1.273 より前は、これらも `Unknown command` と応答していました。

3656 3766 

3657Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合、または `/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。3767Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合や、`/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。

3658 3768 

3659v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている状態で `Enter` を押すと、Claude Code はその候補を実行していました。そのため、`/hepl` のようなタイプミスでは、このメッセージを表示する代わりに `/help` が実行されていました。3769v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている状態で `Enter` を押すと、Claude Code はその候補を実行していたため、`/hepl` のようなタイプミスではこのメッセージの代わりに `/help` が実行されていました。

3660 3770 

3661**対処方法:**3771**対処方法:**

3662 3772 

3663* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで利用できるものを確認します3773* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで利用可能なコマンドを確認します

3664* ドキュメントに記載されたコマンドが不明として報告される場合は、[コマンドリファレンス](/docs/ja/commands)のその行で、示されている要件を確認します3774* ドキュメントに記載されているコマンドが不明と報告される場合は、[コマンドリファレンス](/docs/ja/commands)でそのコマンドの行を確認し、示されている要件を確認します

3665 3775 

3666<h3 id="diff-is-too-large-for-ultrareview">3776<h3 id="diff-is-too-large-for-ultrareview">

3667 Diff is too large for ultrareview3777 Diff is too large for ultrareview

3668</h3>3778</h3>

3669 3779 

3670コミットされていない変更やステージされた変更を含む、ブランチとベースブランチとの差分が [ultrareview](/docs/ja/ultrareview) のサイズ制限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドは、クラウドセッションの開始前にレビューを拒否します。拒否されたレビューは無料実行回数を消費せず、使用クレジットも請求されません。メッセージには、適用されている制限、差分のサイズ、そして変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには生の差分統計のみが表示されていました。3780未コミットの変更とステージされた変更を含む、ブランチとベースブランチの間の差分が [ultrareview](/docs/ja/ultrareview) のサイズ上限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。拒否されたレビューでは、無料の実行回数は消費されず、使用クレジットも請求されません。メッセージには、適用されている上限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには生の差分統計のみが表示されていました。

3671 3781 

3672```text theme={null}3782```text theme={null}

3673Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3783Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.

3674```3784```

3675 3785 

3676プルリクエストのレビューにも同じ制限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。3786プルリクエストをレビューする場合も同じ上限が適用されます。その場合、メッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。

3677 3787 

3678**対処方法:**3788**対処方法:**

3679 3789 

3680* `/code-review ultra develop` のように、作業に近いベースブランチを渡して、レビューがそのブランチとの差分だけを対象とするようにします3790* `/code-review ultra develop` のように、作業により近いベースブランチを渡して、そのブランチとの差分のみがレビュー対象になるようにします

3681* 変更をより小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数が最も多いため、まずそれらを専用のブランチに移動することから始めてください。3791* 変更をより小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数が最も多いため、まずそれらを別のブランチに移動します。

3682 3792 

3683<h3 id="could-not-find-merge-base-with-the-base-branch">3793<h3 id="could-not-find-merge-base-with-the-base-branch">

3684 Could not find merge-base with the base branch3794 Could not find merge-base with the base branch

3685</h3>3795</h3>

3686 3796 

3687`/code-review ultra` と `claude ultrareview` サブコマンドは、ブランチとベースブランチとの差分をレビューします。そのためには、両者が共有するコミットが必要です。`git merge-base` が共有コミットを見つけられない場合、Claude Code はクラウドセッションの開始前にレビューを拒否します。Claude Code が完全であると確認できるクローンで、ブランチが 1 つ以上ある場合は、拒否する代わりに[追跡されているすべてのファイルのレビュー](/docs/ja/ultrareview#diff-limits-and-fallbacks)にフォールバックします。この拒否が表示されるのは、ベースブランチがまったく見つからない場合、Claude Code がクローンの完全性を確認できない場合、または SHA-256 オブジェクト形式のように、ツリー全体の差分が不可能なまれなリポジトリの場合です。3797`/code-review ultra` と `claude ultrareview` サブコマンドは、ブランチとベースブランチの間の差分をレビューするため、両者が共有するコミットが必要です。`git merge-base` がそれを見つけられない場合、Claude Code はクラウドセッションの開始前にレビューを拒否します。Claude Code が完全であることを確認できる、少なくとも 1 つのブランチを持つクローンでは、拒否する代わりに[すべての追跡対象ファイルのレビュー](/docs/ja/ultrareview#diff-limits-and-fallbacks)にフォールバックします。この拒否が表示されるのは、ベースブランチがまったく見つからない場合、Claude Code がクローンの完全性を確認できない場合、または SHA-256 オブジェクト形式のようにツリー全体の差分が不可能なまれなリポジトリの場合です。

3688 3798 

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

3690Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3800Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.

3691```3801```

3692 3802 

3693最初の文の後のヒントは、Claude Code が確認した内容によって異なります:38031 文目の後のヒントは、Claude Code が確認した内容によって異なります:

3694 3804 

3695* **ベースブランチを渡さなかった場合**: Claude Code はリポジトリのデフォルトブランチと比較し、上の例のように、ベースを明示的に渡すよう提案します3805* **ベースブランチを渡さなかった場合**:Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースを明示的に渡すよう提案します

3696* **すでにクローン内にあるベースブランチを渡した場合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります3806* **クローンに既に存在するベースブランチを渡した場合**:ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります

3697* **クローン内にないベースブランチを渡した場合**: Claude Code は比較の前に origin からそのブランチをフェッチしました。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` となります。クローンがシャロークローンかどうかを Claude Code が判断できない場合は、代わりに `git fetch --unshallow origin` を提案します。v2.1.221 より前は、フェッチしたすべてのベースブランチについて `git fetch --unshallow origin` が提案されていましたが、完全なクローンでは、このコマンドは `fatal: --unshallow on a complete repository does not make sense` で失敗します。3807* **クローンに存在しないベースブランチを渡した場合**: Claude Code は比較する前に origin からそのブランチをフェッチしました。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` となります。Claude Code がクローンがシャロークローンかどうかを判別できない場合は、代わりに `git fetch --unshallow origin` を提案します。v2.1.221 より前は、フェッチしたすべてのベースブランチに対してヒントが `git fetch --unshallow origin` を提案していましたが、完全なクローンではそのコマンドは `fatal: --unshallow on a complete repository does not make sense` で失敗します。

3698 3808 

3699**対処方法:**3809**対処方法:**

3700 3810 

3701* 別のブランチが本当のベースである場合は、それを明示的に渡します: `/code-review ultra <branch>`3811* 別のブランチが実際のベースである場合は、明示的に渡します:`/code-review ultra <branch>`

3702* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します3812* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してレビューを再実行します

3703 3813 

3704<h3 id="your-checkout-has-no-branches">3814<h3 id="your-checkout-has-no-branches">

3705 Your checkout has no branches3815 Your checkout has no branches

3706</h3>3816</h3>

3707 3817 

3708チェックアウトには、コミットはあってもブランチがない場合があります。`git init` の後に `git fetch <url>` と `git checkout FETCH_HEAD` を実行すると、参照のない detached HEAD の状態になります。Claude Code は [ultrareview](/docs/ja/ultrareview) のためにリポジトリを git バンドルとしてパッケージ化してアップロードしますが、ブランチやその他の参照のないリポジトリはバンドルできないため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。3818チェックアウトには、コミットはあってもブランチがない場合があります。`git init` に続けて `git fetch <url>` と `git checkout FETCH_HEAD` を実行すると、参照のない detached HEAD の状態になります。Claude Code は [ultrareview](/docs/ja/ultrareview) のためにリポジトリを git バンドルとしてパッケージ化してアップロードしますが、ブランチやその他の参照がないリポジトリはバンドルできないため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。

3709 3819 

3710```text theme={null}3820```text theme={null}

3711Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3821Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.

3712```3822```

3713 3823 

3714v2.1.221 より前は、Claude Code はこのチェックアウト内の追跡されているすべてのファイルのレビューを試み、アップロードが失敗していました。3824v2.1.221 より前は、Claude Code はこのチェックアウト内のすべての追跡対象ファイルのレビューを試み、アップロードが失敗していました。

3715 3825 

3716**対処方法:**3826**対処方法:**

3717 3827 

3718* `git checkout -b <name>` で現在のコミットにブランチを作成してから、レビューを再実行します3828* `git checkout -b <name>` で現在のコミットにブランチを作成してから、レビューを再実行します

3719 3829 


3721 No GitHub account is connected to your Claude account3831 No GitHub account is connected to your Claude account

3722</h3>3832</h3>

3723 3833 

3724`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行しました。Claude Code はクラウドセッションを作成する前に、[Claude アカウントに接続された GitHub アカウント](/docs/ja/ultrareview#review-a-pull-request)が PR のリポジトリにアクセスできるかをサーバーに問い合わせます。アカウントが接続されていないか、接続の有効期限が切れているため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、無料実行回数は消費されず、使用クレジットも請求されません。3834`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行しました。Claude Code はクラウドセッションを作成する前に、[Claude アカウントに接続された GitHub アカウント](/docs/ja/ultrareview#review-a-pull-request)が PR のリポジトリにアクセスできるかどうかをサーバーに問い合わせます。アカウントが接続されていないか接続の有効期限が切れているため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、無料の実行回数は消費されず、使用クレジットも請求されません。

3725 3835 

3726```text theme={null}3836```text theme={null}

3727Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3837Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).


3729 3839 

3730セッションで [`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージには claude.ai のリンクのみが示されます。3840セッションで [`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージには claude.ai のリンクのみが示されます。

3731 3841 

3732**対処方法:**3842**対処方法:**

3733 3843 

3734* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します3844* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します

3735* 接続してから 1 分ほど待って、レビューを再実行します3845* 接続してから 1 分後にレビューを再実行します

3736 3846 

3737v2.1.248 より前は、Claude Code は起動前にこのチェックを行っていませんでした。3847v2.1.248 より前は、Claude Code は起動前にこのチェックを行っていませんでした。

3738 3848 


3740 Your connected GitHub account can't see the repository3850 Your connected GitHub account can't see the repository

3741</h3>3851</h3>

3742 3852 

3743`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行しましたが、[Claude アカウントに接続された GitHub アカウント](/docs/ja/ultrareview#review-a-pull-request)が PR のリポジトリを読み取れないため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、無料実行回数は消費されず、使用クレジットも請求されません。3853`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行しましたが、[Claude アカウントに接続された GitHub アカウント](/docs/ja/ultrareview#review-a-pull-request)がその PR のリポジトリを読み取れないため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否しました。起動が拒否された場合、Claude Code は無料実行回数を消費せず、使用クレジットも請求しません。

3744 3854 

3745```text theme={null}3855```text theme={null}

3746Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3856Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.


3748 3858 

3749セッションで [`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージにはアプリのインストールのみが示されます。3859セッションで [`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージにはアプリのインストールのみが示されます。

3750 3860 

3751**対処方法:**3861**対処方法:**

3752 3862 

3753* ローカルの `gh` CLI がリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します3863* ローカルの `gh` CLI がリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します

3754* 変更後にレビューを再実行します3864* 変更後にレビューを再実行します

3755 3865 

3756v2.1.248 より前は、Claude Code は起動前にこのチェックを行っていませんでした。3866v2.1.248 より前では、Claude Code は起動前にこの確認を行っていませんでした。

3757 3867 

3758<h3 id="the-github-app-preflight-failed-transiently">3868<h3 id="the-github-app-preflight-failed-transiently">

3759 The GitHub App preflight failed transiently3869 The GitHub App preflight failed transiently

3760</h3>3870</h3>

3761 3871 

3762ローカルリポジトリから[クラウドセッション](/docs/ja/claude-code-on-the-web)を開始しましたが、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、Claude Code はクラウドサービスが GitHub からリポジトリをクローンできるかをチェックしましたが、そのチェックは明確な答えではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消される可能性のあるエラーで終了しました。完全なメッセージは、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因で始まり、事前チェックに関する文で終わります:3872ローカルリポジトリから[クラウドセッション](/docs/ja/claude-code-on-the-web)を開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、Claude Code はクラウドサービスが GitHub からリポジトリをクローンできるかどうかを確認しますが、この確認は明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消できる可能性のあるエラーで終わりました。完全なメッセージは、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因から始まり、事前確認に関する文で終わります:

3763 3873 

3764```text theme={null}3874```text theme={null}

3765Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3875Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead

3766```3876```

3767 3877 

3768**対処方法:**3878**対処方法:**

3769 3879 

3770* 少し待ってからコマンドを再実行します。GitHub のチェックに合格すると、Claude Code は GitHub のクローンからセッションを開始できるため、失敗したアップロードによって起動が妨げられることはなくなります3880* 少し待ってからコマンドを再実行します。GitHub の確認が通れば、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗によって起動が妨げられることはなくなります

3771* 再試行しても失敗が続く場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば修正して、代わりにローカルリポジトリからセッションを開始できるようにします3881* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば、修正してローカルリポジトリからセッションを開始できるようにします

3772 3882 

3773v2.1.251 より前は、GitHub のチェックが一時的に失敗しただけの場合でも、Claude Code はメッセージの最後に `Please set up GitHub on https://claude.ai/code` を表示していましたが、セットアップの助言では一時的な失敗は解消できません。3883v2.1.251 より前では、GitHub の確認が一時的に失敗しただけの場合でも、Claude Code はメッセージを `Please set up GitHub on https://claude.ai/code` で終えていましたが、セットアップの案内では一時的な失敗は解消できません。

3774 3884 

3775<h3 id="the-repository-upload-cant-follow-a-git-setting">3885<h3 id="the-repository-upload-cant-follow-a-git-setting">

3776 リポジトリのアップロードが git 設定に従えない3886 リポジトリのアップロードが git 設定に従えない

3777</h3>3887</h3>

3778 3888 

3779[ローカルリポジトリをアップロードするクラウドセッション](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github)、またはブランチの [ultrareview](/docs/ja/ultrareview) を開始しましたが、ファイルにどの属性ルールを適用するかを決める git 設定のいずれかに、アップロードが従えません。アップロードをそのまま進めてルールを見落とすと、git が保存前に変換するファイル(clean フィルターで暗号化されるファイルなど)が、ディスク上の状態のままクラウドに届く可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードされません:3889[ローカルリポジトリをアップロードするクラウドセッション](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github)またはブランチの [ultrareview](/docs/ja/ultrareview) を開始しましたが、ファイルに適用される属性ルールを決定する git 設定の 1 つにアップロードが従えません。アップロードを続行してルールを見落とすと、clean フィルターで暗号化されるファイルなど、git が保存前に変換するファイルがディスク上の状態のままクラウドに送られる可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードしません:

3780 3890 

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

3782Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.3892Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.

3783```3893```

3784 3894 

3785メッセージには設定項目の名前とその設定場所が示され、最後に該当するケースの修正方法が記載されます。`core.attributesFile` と `attr.tree` についても同じ拒否が表示され、それぞれ固有の修正方法が示されます。3895メッセージには設定名とその設定場所が示され、該当するケースの修正方法で終わります。`core.attributesFile` と `attr.tree` についても同じ拒否が表示され、それぞれに固有の修正方法が示されます。

3786 3896 

3787メッセージには、git の設定が `include` または `includeIf` ディレクティブを通じて読み込む設定ファイルが示されることがあります。これは、そのディレクティブの条件がこのリポジトリに該当しない場合でも同様です。3897メッセージには、git 設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが示されることがあります。これは、そのディレクティブの条件がこのリポジトリに当てはまらない場合でも同様です。

3788 3898 

3789**対処方法:**3899**対処方法:**

3790 3900 

3791* メッセージの最後の文に記載された修正を適用します3901* メッセージの最後の文に示された修正を適用します

3792 3902 

3793<h3 id="github-isnt-connected-to-your-claude-account">3903<h3 id="github-isnt-connected-to-your-claude-account">

3794 GitHub isn't connected to your Claude account3904 GitHub isn't connected to your Claude account

3795</h3>3905</h3>

3796 3906 

3797ローカルリポジトリから、たとえば `/autofix-pr` を使って[クラウドセッション](/docs/ja/claude-code-on-the-web)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否します:3907`/autofix-pr` などでローカルリポジトリから[クラウドセッション](/docs/ja/claude-code-on-the-web)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否します:

3798 3908 

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

3800GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3910GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github

3801```3911```

3802 3912 

3803[`/schedule`](/docs/ja/routines) でルーティンを作成する場合は、同じメッセージがリポジトリ名を示すセットアップの注記として表示されます。この注記はルーティンの作成をブロックしません。3913[`/schedule`](/docs/ja/routines) でルーティンを作成すると、同じメッセージがリポジトリ名を含むセットアップの注記として表示されます。この注記はルーティンの作成を妨げません。

3804 3914 

3805**対処方法:**3915**対処方法:**

3806 3916 

3807* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します。両者の違いについては [GitHub 認証オプション](/docs/ja/claude-code-on-the-web#github-authentication-options)を参照してください。3917* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します。両者の違いについては [GitHub 認証オプション](/docs/ja/claude-code-on-the-web#github-authentication-options)を参照してください。

3808* 接続してから 1 分後にコマンドを再実行します3918* 接続してから 1 分後にコマンドを再実行します

3809 3919 

3810v2.1.268 より前では、Claude Code はこれを Claude GitHub App チェックの一時的な失敗として報告し、再試行またはアプリのインストールを提案していました。どちらも GitHub アカウントを接続するものではありません。3920v2.1.268 より前では、Claude Code はこれを Claude GitHub App の確認の一時的な失敗として報告し、再試行またはアプリのインストールを提案していました。いずれも GitHub アカウントを接続するものではありません。

3811 3921 

3812<h3 id="a-github-organization-policy-is-blocking-claude">3922<h3 id="a-github-organization-policy-is-blocking-claude">

3813 GitHub 組織のポリシーが Claude をブロックしている3923 GitHub 組織のポリシーが Claude をブロックしている

3814</h3>3924</h3>

3815 3925 

3816Claude Code のプロンプトで、[`/autofix-pr`](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests) などクラウドセッションを開始するコマンドを実行しました。Claude Code はセッションを作成する前に GitHub 上のリポジトリへの Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub が拒否しました。Claude Code はそこで停止し、そのポリシーを示すメッセージを表示します。3926Claude Code のプロンプトで、[`/autofix-pr`](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests) などのクラウドセッションを開始するコマンドを実行しました。セッションを作成する前に、Claude Code は GitHub 上のリポジトリに対する Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub がこれを拒否しました。Claude Code はそこで停止し、ポリシー名を示すメッセージを表示します。

3817 3927 

3818IP 許可リストがアクセスをブロックしている場合、メッセージは次のようになります:3928IP 許可リストがアクセスをブロックしている場合、メッセージは次のとおりです:

3819 3929 

3820```text theme={null}3930```text theme={null}

3821Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.3931Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.

3822```3932```

3823 3933 

3824シングルサインオンがブロックしている場合、メッセージは次のようになります:3934シングルサインオンがブロックしている場合、メッセージは次のとおりです:

3825 3935 

3826```text theme={null}3936```text theme={null}

3827Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.3937Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.

3828```3938```

3829 3939 

3830Microsoft Entra ID の条件付きアクセスポリシーがブロックしている場合、メッセージは次のようになります:3940Microsoft Entra ID の条件付きアクセスポリシーがブロックしている場合、メッセージは次のとおりです:

3831 3941 

3832```text theme={null}3942```text theme={null}

3833Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.3943Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.

3834```3944```

3835 3945 

3836**対処方法:**3946**対処方法:**

3837 3947 

3838* **IP 許可リスト**: GitHub 組織または Enterprise のオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更すべき GitHub の設定については、[GitHub の許可リストとファイアウォール](/docs/ja/network-config#github-allow-lists-and-firewalls)を参照してください。3948* **IP 許可リスト**:GitHub 組織またはエンタープライズのオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更すべき GitHub の設定については、[GitHub の許可リストとファイアウォール](/docs/ja/network-config#github-allow-lists-and-firewalls)を参照してください。

3839* **シングルサインオン**: [claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub の接続を解除してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックして、新しい接続がその組織のシングルサインオンに対して認可されるようにします。3949* **シングルサインオン**:[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub を切断し、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックして、新しい接続をその組織のシングルサインオンに対して認可します。

3840* **条件付きアクセスポリシー**: GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します3950* **条件付きアクセスポリシー**:GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します

3841* 変更後、コマンドを再度実行します3951* 変更後、コマンドを再度実行します

3842 3952 

3843<h3 id="single-sign-on-authorization-needed">3953<h3 id="single-sign-on-authorization-needed">

3844 Single sign-on authorization needed3954 Single sign-on authorization needed

3845</h3>3955</h3>

3846 3956 

3847[`/install-github-app`](/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサインオンを強制している組織のリポジトリを選択しました。セットアップの前に Claude Code は GitHub CLI でリポジトリへのアクセスを確認しますが、`gh` トークンがまだその組織に対して認可されていないため、GitHub がその確認を拒否しました。ウィザードには、認可の手順とともに警告が表示されます:3957[`/install-github-app`](/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサインオンを強制する組織のリポジトリを選択しました。セットアップの前に、Claude Code は GitHub CLI でリポジトリへのアクセスを確認しますが、`gh` トークンがまだその組織に対して認可されていないため、GitHub がこの確認を拒否しました。ウィザードには、認可の手順とともに警告が表示されます:

3848 3958 

3849```text theme={null}3959```text theme={null}

3850Single sign-on authorization needed3960Single sign-on authorization needed

3851<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.3961<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.

3852```3962```

3853 3963 

3854**対処方法:**3964**対処方法:**

3855 3965 

3856* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` スコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します3966* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` スコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します

3857* `GH_TOKEN` の個人アクセストークンで認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します3967* `GH_TOKEN` の個人アクセストークンで認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します

3858* `/install-github-app` を再度実行します3968* `/install-github-app` を再度実行します

3859 3969 

3860v2.1.273 より前では、この状況で Claude Code は代わりに `Admin permissions required` という警告を表示していました。3970v2.1.273 より前では、Claude Code はこの状況で代わりに `Admin permissions required` の警告を表示していました。

3861 3971 

3862<h3 id="failed-to-resume-the-conversation">3972<h3 id="failed-to-resume-the-conversation">

3863 Failed to resume the conversation3973 Failed to resume the conversation

3864</h3>3974</h3>

3865 3975 

3866[`claude --resume` ピッカー](/docs/ja/sessions#use-the-session-picker)で選択したセッションの保存済みトランスクリプトを Claude Code が読み取りまたは処理できなかったため、部分的に読み込まれた状態で続行するのではなくプロセスを終了します。メッセージには再試行のためのコマンドが含まれます:3976[`claude --resume` ピッカー](/docs/ja/sessions#use-the-session-picker)で選択したセッションの保存済みトランスクリプトを Claude Code が読み取りまたは処理できなかったため、部分的に読み込まれた状態で続行するのではなく、プロセスを終了します。メッセージには再試行用のコマンドが含まれます:

3867 3977 

3868```text theme={null}3978```text theme={null}

3869Failed to resume the conversation.3979Failed to resume the conversation.

3870Run claude --resume <session-id> to retry, or claude to start a new session.3980Run claude --resume <session-id> to retry, or claude to start a new session.

3871```3981```

3872 3982 

3873Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは実行を続けます。v2.1.216 より前では、`claude --resume` ピッカーからの再開に失敗すると、このメッセージを表示する代わりに `Resuming conversation…` スピナーが表示されたままになっていました。3983Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは実行を続けます。v2.1.216 より前では、`claude --resume` ピッカーからの再開が失敗すると、このメッセージを表示する代わりに `Resuming conversation…` スピナーのまま止まっていました。

3874 3984 

3875**対処方法:**3985**対処方法:**

3876 3986 

3877* メッセージに示されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します3987* メッセージに示されたセッション ID で `claude --resume <session-id>` を実行して再試行します

3878* v2.1.285 より前のバージョンで、再試行が同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。3988* v2.1.285 より前のバージョンで、再試行も同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。

3879* 再試行が再び失敗する場合は、`claude` を実行して新しいセッションを開始します3989* 再試行が再び失敗する場合は、`claude` を実行して新しいセッションを開始します

3880 3990 

3881<h3 id="no-conversation-found-with-the-session-id">3991<h3 id="no-conversation-found-with-the-session-id">

3882 No conversation found with the session ID3992 No conversation found with the session ID

3883</h3>3993</h3>

3884 3994 

3885`claude --resume <session-id>` にセッション ID を渡しましたが、一致する保存済みトランスクリプトがありませんでした:3995`claude --resume <session-id>` にセッション ID を渡しましたが、一致する保存済みトランスクリプトがありませんでした:

3886 3996 

3887```text theme={null}3997```text theme={null}

3888No conversation found with session ID: <session-id>3998No conversation found with session ID: <session-id>

3889```3999```

3890 4000 

3891Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は、[まず現在のプロジェクトを検索し、次にこのマシン上の他のすべてのプロジェクト](/docs/ja/sessions#where-the-session-picker-looks)からその ID を検索します。v2.1.223 より前では、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開してください。4001Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は、[まず現在のプロジェクトを検索し、次にこのマシン上の他のすべてのプロジェクト](/docs/ja/sessions#where-the-session-picker-looks)からその ID を探します。v2.1.223 より前では、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開してください。

3892 4002 

3893主な原因:4003主な原因:

3894 4004 

3895* **ID の入力ミス**: 非対話型の実行では、ID は [`--output-format json` の出力](/docs/ja/headless#get-structured-output)の `session_id` フィールドです4005* **ID の入力ミス**:非対話型の実行では、ID は [`--output-format json` の出力](/docs/ja/headless#get-structured-output)の `session_id` フィールドです

3896* **トランスクリプトの削除**: Claude Code は[保持期間](/docs/ja/sessions#where-transcripts-are-stored)(デフォルトは 30 日)が過ぎると、[保持スイープのルール](/docs/ja/claude-directory#cleaned-up-automatically)に従ってトランスクリプトを削除します4006* **トランスクリプトの削除**:Claude Code は、[保持期間](/docs/ja/sessions#where-transcripts-are-stored)(デフォルトは 30 日)が過ぎると、[保持期間による削除ルール](/docs/ja/claude-directory#cleaned-up-automatically)に従ってトランスクリプトを削除します

3897* **別のマシン**: Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開してください4007* **別のマシン**:Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開してください

3898* **重複したコピー**: `~/.claude/projects` 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらかのコピーを任意に再開するのではなく、このメッセージを表示します4008* **重複コピー**:`~/.claude/projects` 内のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code は一方を任意に再開するのではなく、このメッセージを報告します

3899 4009 

3900**対処方法:**4010**対処方法:**

3901 4011 

3902* 対話型セッションの場合は、`claude --resume` で[セッションピッカー](/docs/ja/sessions#use-the-session-picker)を開き、`Ctrl+A` を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します4012* 対話型セッションの場合は、`claude --resume` で[セッションピッカー](/docs/ja/sessions#use-the-session-picker)を開き、`Ctrl+A` を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します

3903* `claude -p` または [Agent SDK](/docs/ja/agent-sdk/overview) で作成したセッションはピッカーに表示されないため、元の実行で出力された `session_id` と ID を照合し直してください4013* `claude -p` または [Agent SDK](/docs/ja/agent-sdk/overview) で作成したセッションはピッカーに表示されないため、元の実行で出力された `session_id` と ID を照合し直してください


3906 Windows reported an error (EBADF) when Claude Code read this session's transcript file4016 Windows reported an error (EBADF) when Claude Code read this session's transcript file

3907</h3>4017</h3>

3908 4018 

3909Windows でセッションを再開し、保存済みの[トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)は正常に開かれましたが、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーからは読み取りが失敗した理由がわからないため、メッセージでは考えられる原因と試すべきことが提案されます:4019Windows でセッションを再開したところ、保存済みの[トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)は正常に開かれたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーは読み取りが失敗した理由を示さないため、メッセージでは考えられる原因と試すべきことが提案されます:

3910 4020 

3911```text theme={null}4021```text theme={null}

3912Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.4022Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

3913```4023```

3914 4024 

3915このメッセージは、`Failed to resume session <session-id>` などのコマンド自体の失敗行に続いて表示されます。`claude --resume` または [`claude -p`](/docs/ja/headless) コマンドは、これを表示した後に終了コード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションが実行を続けます。4025このメッセージは、`Failed to resume session <session-id>` のようなコマンド自体の失敗を示す行に続いて表示されます。`claude --resume` または [`claude -p`](/docs/ja/headless) コマンドは、これを表示した後、終了コード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションは実行を続けます。

3916 4026 

3917**対処方法:**4027**対処方法:**

3918 4028 

3919* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアの対象から、セッションのトランスクリプトを保持するフォルダーを除外します。トランスクリプトはデフォルトで `%USERPROFILE%\.claude\projects` 配下、または [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) が指定するディレクトリ配下に保存されます4029* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアから、セッションのトランスクリプトを保存するフォルダーを除外します。トランスクリプトはデフォルトでは `%USERPROFILE%\.claude\projects` に、または [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) が指定するディレクトリに保存されます

3920* 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します4030* 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します

3921* セッションを再度再開します4031* セッションを再度再開します

3922 4032 

3923v2.1.282 より前では、失敗時に説明は表示されませんでした。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようなシステムエラーのテキストのみが出力されていました。4033v2.1.282 より前では、この失敗は説明なしで発生していました。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` での実行では `Failed to resume session: EBADF: bad file descriptor, read` のようなシステムエラーのテキストのみが出力されていました。

3924 4034 

3925<h3 id="cannot-switch-renderers-in-this-session">4035<h3 id="cannot-switch-renderers-in-this-session">

3926 Cannot switch renderers in this session4036 Cannot switch renderers in this session

3927</h3>4037</h3>

3928 4038 

3929レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を拒否するセッションで [`/tui`](/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります:4039レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を拒否するセッションで [`/tui`](/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります:

3930 4040 

3931* `Cannot switch renderers while work is running in the background`: バックグラウンドシェルやサブエージェントなど、再起動すると放棄されてしまうバックグラウンドの作業が実行中です。作業が終わるのを待つか、[`/tasks`](/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します4041* `Cannot switch renderers while work is running in the background`:バックグラウンドシェルやサブエージェントなど、再起動によって破棄されてしまうバックグラウンドの作業が実行中です。作業が完了するまで待つか、[`/tasks`](/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します

3932* `Cannot switch renderers in this session`: セッションに、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前では、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました4042* `Cannot switch renderers in this session`:セッションに、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前では、Claude Code はそれでも再起動し、再起動後のセッションはそれらの制限なしで実行されていました

3933 4043 

3934制限に関するメッセージでは、括弧内の部分に Claude Code が検出した制限が示されます:4044制限に関するメッセージでは、括弧内に Claude Code が検出した制限が示されます:

3935 4045 

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

3937Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.4047Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.

3938```4048```

3939 4049 

3940メッセージの括弧内に表示される可能性のある各理由:4050メッセージの括弧内に表示される可能性のある各理由:

3941 4051 

3942* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Claude Code が再起動後のプロセスに引き継がないフラグを付けてセッションを開始しました。これらのフラグには、[`--system-prompt`](/docs/ja/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](/docs/ja/cli-reference#cli-flags) の許可リスト、[`--setting-sources`](/docs/ja/cli-reference#cli-flags)、[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) が含まれます4052* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`:Claude Code が再起動後のプロセスに引き継がないフラグを指定してセッションを開始しました。これらのフラグには、[`--system-prompt`](/docs/ja/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](/docs/ja/cli-reference#cli-flags) の許可リスト、[`--setting-sources`](/docs/ja/cli-reference#cli-flags)、[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) が含まれます

3943* `permission rules set for this session only`: フックまたは SDK の呼び出し元からの[権限の更新](/docs/ja/hooks#permission-update-entries)により、`session` を保存先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。再起動するとそれらは破棄され、Claude Code は代わりに再度確認を求めます4053* `permission rules set for this session only`:フックまたは SDK の呼び出し元からの[権限の更新](/docs/ja/hooks#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールは拒否の原因になりません。再起動するとそれらは破棄され、Claude Code は代わりに再度確認を求めます

3944* `ask-before-running rules with no command-line form`: フックまたは SDK の呼び出し元からの権限の更新により、Claude Code が `--allowed-tools` と `--disallowed-tools` として引き継ぐルールに加えて、確認ルールが追加されました。確認ルール用のフラグは存在しません4054* `ask-before-running rules with no command-line form`:フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` および `--disallowed-tools` として引き継ぐルールとともに確認ルールが追加されました。確認ルール用のフラグは存在しません

3945* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`: 権限の更新により、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継げません4055* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`:権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継げません

3946 4056 

3947**対処方法:**4057**対処方法:**

3948 4058 

3949* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻す場合は `/tui default` を実行します。Claude Code はそのセッションで [`tui` 設定](/docs/ja/settings-reference#tui)を保存します4059* それらの制限なしで開始したセッションで、`/tui fullscreen` を実行するか、元に戻すには `/tui default` を実行します。Claude Code はそこで [`tui` 設定](/docs/ja/settings-reference#tui)を保存します

3950 4060 

3951<h3 id="claude-code-couldnt-restart">4061<h3 id="claude-code-couldnt-restart">

3952 Claude Code couldn't restart4062 Claude Code couldn't restart

3953</h3>4063</h3>

3954 4064 

3955このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングへの切り替えまたはその解除のために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました:4065このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](/docs/ja/fullscreen#enable-fullscreen-rendering) を実行した後にフルスクリーンレンダリングへの切り替えまたは解除を行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました:

3956 4066 

3957```text theme={null}4067```text theme={null}

3958Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.4068Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.

3959```4069```

3960 4070 

3961たとえば新しいセッションで `/tui` が最初の入力だったために、再起動時に再度開く会話がなかった場合、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。4071`/tui` が新しいセッションでの最初の入力だった場合など、再起動時に再度開く会話がなかった場合、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。

3962 4072 

3963**対処方法:**4073**対処方法:**

3964 4074 

3965* シェルで `claude` を再度実行します。メッセージで会話が保存されていると示されていた場合は、新しいセッションで [`/resume`](/docs/ja/sessions#resume-a-session) を実行し、その会話を選択します。一覧にない場合は、[セッションピッカーの範囲を広げます](/docs/ja/sessions#where-the-session-picker-looks)4075* シェルで `claude` を再度実行します。メッセージで会話が保存されていると示されていた場合は、新しいセッションで [`/resume`](/docs/ja/sessions#resume-a-session) を実行し、その会話を選択します。一覧にない場合は、[セッションピッカーの範囲を広げます](/docs/ja/sessions#where-the-session-picker-looks)

3966* 再起動が失敗し続ける場合は、シェルから [`claude --debug-file claude-debug.log`](/docs/ja/cli-reference#cli-flags) で Claude Code を起動します。そのセッションからの再起動が失敗すると、起動したディレクトリの `claude-debug.log` に、オペレーティングシステムのエラーを含む `Failed to relaunch:` 行が記録されます。[問題を報告する](#report-an-error)際は、その行を含めてください4076* 再起動が失敗し続ける場合は、シェルから [`claude --debug-file claude-debug.log`](/docs/ja/cli-reference#cli-flags) で Claude Code を起動します。そのセッションからの再起動が失敗すると、起動したディレクトリの `claude-debug.log` に、オペレーティングシステムのエラーを含む `Failed to relaunch:` 行が記録されます。[問題を報告する](#report-an-error)際にはその行を含めてください

3967 4077 

3968<h3 id="couldnt-open-claude-desktop">4078<h3 id="couldnt-open-claude-desktop">

3969 Couldn't open Claude Desktop4079 Couldn't open Claude Desktop

3970</h3>4080</h3>

3971 4081 

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

3973 4083 

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

3975 4085 

3976```text theme={null}4086```text theme={null}

3977Error: 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.4087Error: 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.

3978```4088```

3979 4089 

3980**対処方法:**4090**対処方法:**

3981 4091 

3982* Claude Desktop を自分で開いてから、`/desktop` または `claude --desktop` を再度実行します4092* Claude Desktop を自分で開いてから、`/desktop` または `claude --desktop` を再度実行します

3983* 失敗したコマンドの完全なエラー出力を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します4093* 失敗したコマンドの完全なエラー出力を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します

3984 4094 

3985v2.1.285 より前では、メッセージの末尾は `Open Claude Desktop and run /desktop again.` でした。v2.1.275 より前では、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されませんでした。4095v2.1.285 より前では、メッセージは `Open Claude Desktop and run /desktop again.` で終わっていました。v2.1.275 より前では、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されていませんでした。

3986 4096 

3987<h3 id="terminal-setup-left-your-zed-keymap-unchanged">4097<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3988 /terminal-setup で Zed のキーマップが変更されなかった4098 /terminal-setup で Zed のキーマップが変更されなかった

3989</h3>4099</h3>

3990 4100 

3991Zed で [`/terminal-setup`](/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code は Zed の `keymap.json` の更新を完了できなかったため、ファイルを元のままにしました。4101Zed で [`/terminal-setup`](/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code は Zed の `keymap.json` の更新を完了できなかったため、ファイルをそのままにしました。

3992 4102 

3993各メッセージにはキーマップのパスが示され、最後に自分で追加するためのキーボードショートカットのブロックが記載されます:4103各メッセージにはキーマップのパスが示され、最後に自分で追加するためのキーボードショートカットのブロックが示されます:

3994 4104 

3995```text theme={null}4105```text theme={null}

3996Couldn't update your Zed keymap, so it was left unchanged.4106Couldn't update your Zed keymap, so it was left unchanged.


3998{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }4108{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }

3999```4109```

4000 4110 

4001メッセージの最初の行に原因が示されます:4111メッセージの最初の行に原因が示されます:

4002 4112 

4003* `Couldn't read your Zed keymap, so it was left unchanged.`: ファイルの権限などが原因で、Claude Code がファイルを読み取れませんでした4113* `Couldn't read your Zed keymap, so it was left unchanged.`:ファイルの権限などの理由で、Claude Code がファイルを読み取れませんでした

4004* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: ファイルは読み取れましたが、`//` コメントや末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません4114* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`:ファイルは読み取れましたが、`//` コメントと末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません

4005* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code がファイルをその隣の `.bak` バックアップにコピーできなかったため、何も変更しませんでした4115* `Couldn't back up your Zed keymap; not modifying it.`:Claude Code がファイルを隣の `.bak` バックアップにコピーできなかったため、何も変更しませんでした

4006* `Couldn't update your Zed keymap, so it was left unchanged.`: マージした結果が、そのキーボードショートカットを含む有効なキーマップとして検証できなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックがあると、これが発生することがあります4116* `Couldn't update your Zed keymap, so it was left unchanged.`:マージ結果が、そのキーボードショートカットを含む有効なキーマップであると検証できなかったため、Claude Code は書き込まずに破棄しました。キーが重複しているキーボードショートカットのブロックがあると、これが発生することがあります

4007 4117 

4008**対処方法:**4118**対処方法:**

4009 4119 

4010* メッセージに記載されたブロックを、メッセージが示すパスにある `keymap.json` のトップレベルの配列にコピーします4120* メッセージのブロックを、メッセージに示されたパスにある `keymap.json` のトップレベルの配列にコピーします

4011* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します4121* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します

4012 4122 

4013v2.1.247 より前では、`/terminal-setup` は `//` コメントや末尾のカンマを使った Zed のキーマップを解析できず、ファイル全体を自身のキーボードショートカットのみに置き換えたうえで、そのキーボードショートカットがインストールされたと報告していました。以前のバージョンによって置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](/docs/ja/terminal-config#enter-multiline-prompts)で説明されている `.bak` バックアップファイルを使用します。4123v2.1.247 より前では、`/terminal-setup` は `//` コメントや末尾のカンマを使用した Zed のキーマップを解析できず、ファイル全体を自身のキーボードショートカットだけに置き換えたうえで、インストール済みと報告していました。以前のバージョンによって置き換えられたキーマップを復元するには、[複数行プロンプトを入力する](/docs/ja/terminal-config#enter-multiline-prompts)で説明されている `.bak` バックアップファイルを使用します。

4014 4124 

4015<h3 id="skill-usage-reports-are-not-available-on-this-connection">4125<h3 id="skill-usage-reports-are-not-available-on-this-connection">

4016 Skill usage reports are not available on this connection4126 Skill usage reports are not available on this connection

4017</h3>4127</h3>

4018 4128 

4019スマートフォンまたはブラウザから [Remote Control](/docs/ja/remote-control) 経由で [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行しました。Claude Code はスキルの使用状況レポートを Remote Control 経由で送信せず、代わりに次のメッセージで応答します:4129スマートフォンまたはブラウザから [Remote Control](/docs/ja/remote-control) 経由で [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行しました。Claude Code はスキルの使用状況レポートを Remote Control 経由では送信せず、代わりに次のメッセージで応答します:

4020 4130 

4021```text theme={null}4131```text theme={null}

4022Skill usage reports are not available on this connection.4132Skill usage reports are not available on this connection.

4023```4133```

4024 4134 

4025**対処方法:**4135**対処方法:**

4026 4136 

4027* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そこで `claude -p "/skill-doctor"` を実行します4137* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そのマシンで `claude -p "/skill-doctor"` を実行します

4028 4138 

4029<h3 id="custom-output-styles-cant-be-selected-over-remote-control">4139<h3 id="custom-output-styles-cant-be-selected-over-remote-control">

4030 Custom output styles can't be selected over Remote Control4140 Custom output styles can't be selected over Remote Control

4031</h3>4141</h3>

4032 4142 

4033[Remote Control](/docs/ja/remote-control) 経由でモバイルアプリまたは Web から [`/output-style`](/docs/ja/output-styles#change-your-output-style) を実行したか、セッションに中継されたメッセージでそのコマンドが届きました。このようなターンはアカウント所有者からのものではない可能性があるため、Claude Code はそのターンでは[組み込みスタイル](/docs/ja/output-styles#built-in-output-styles)のみを一覧表示および選択し、コマンドがスタイルを一覧表示したとき、または指定した名前を認識できなかったときには、常にこの通知を追加します。[カスタムスタイル](/docs/ja/output-styles#create-a-custom-output-style)の名前には、存在しない名前と同じ応答が返されます:4143[Remote Control](/docs/ja/remote-control) 経由でモバイルアプリまたは Web から [`/output-style`](/docs/ja/output-styles#change-your-output-style) を実行したか、セッションに中継されたメッセージでコマンドが届きました。このようなターンはアカウント所有者からのものではない可能性があるため、Claude Code はそのターンでは[組み込みスタイル](/docs/ja/output-styles#built-in-output-styles)のみを一覧表示・選択し、コマンドがスタイルを一覧表示したとき、または指定した名前を認識しなかったときには必ずこの通知を追加します。[カスタムスタイル](/docs/ja/output-styles#create-a-custom-output-style)の名前には、存在しない名前と同じ応答が返されます:

4034 4144 

4035```text theme={null}4145```text theme={null}

4036Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.4146Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.

4037```4147```

4038 4148 

4039**対処方法:**4149**対処方法:**

4040 4150 

4041* `/output-style concise` などの組み込みスタイルを選択します4151* `/output-style concise` などの組み込みスタイルを選択します

4042* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体にターミナルがある場合はそこで `/output-style <style>` を実行します4152* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体のターミナルがある場合はそこで `/output-style <style>` を実行します

4043 4153 

4044<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">4154<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">

4045 Output styles are saved to local settings which this session doesn't load4155 Output styles are saved to local settings which this session doesn't load

4046</h3>4156</h3>

4047 4157 

4048設定ソースから `local` が除外されているセッションで、`/output-style <style>` または `/config outputStyle=<style>` を使って[出力スタイル](/docs/ja/output-styles)を切り替えようとしました。たとえば、[`settingSources`](/docs/ja/agent-sdk/typescript#options) に `"local"` が含まれていない [Agent SDK](/docs/ja/agent-sdk/typescript) セッションや、`local` を含まない [`--setting-sources`](/docs/ja/cli-reference#cli-flags) の値で開始した CLI セッションが該当します。どちらのコマンドもスタイルを `.claude/settings.local.json` に保存しますが、このようなセッションはこのファイルを読み込まないため、Claude Code は効果のない設定を書き込む代わりに拒否します:4158設定ソースから `local` が除外されているセッションで、`/output-style <style>` または `/config outputStyle=<style>` を使って[出力スタイル](/docs/ja/output-styles)を切り替えようとしました。たとえば、[`settingSources`](/docs/ja/agent-sdk/typescript#options) から `"local"` が除外されている [Agent SDK](/docs/ja/agent-sdk/typescript) のセッションや、`local` を除外した [`--setting-sources`](/docs/ja/cli-reference#cli-flags) の値で開始した CLI セッションがこれに該当します。どちらのコマンドもスタイルを `.claude/settings.local.json` に保存しますが、このようなセッションはそのファイルを読み込まないため、Claude Code は効果のない設定を書き込む代わりに拒否します:

4049 4159 

4050```text theme={null}4160```text theme={null}

4051Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.4161Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

4052```4162```

4053 4163 

4054**対処方法:**4164**対処方法:**

4055 4165 

4056* セッションの設定ソースに `local` を追加してから、再度切り替えます4166* セッションの設定ソースに `local` を追加してから、再度切り替えます

4057* プロジェクトの `.claude/settings.json` や `~/.claude/settings.json` など、セッションが読み込む設定ファイルで [`outputStyle`](/docs/ja/settings-reference#outputstyle) キーを設定します。TypeScript SDK では、代わりにインラインの `settings` オブジェクト内で `outputStyle` を設定します。[出力スタイルを有効にする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください4167* プロジェクトの `.claude/settings.json` や `~/.claude/settings.json` など、セッションが読み込む設定ファイルで [`outputStyle`](/docs/ja/settings-reference#outputstyle) キーを設定します。TypeScript SDK では、代わりにインラインの `settings` オブジェクト内で `outputStyle` を設定します。[出力スタイルを有効にする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください


4060 /recap only runs when you ask for it yourself4170 /recap only runs when you ask for it yourself

4061</h3>4171</h3>

4062 4172 

4063[`/recap`](/docs/ja/interactive-mode#session-recap) のリクエストがユーザー自身の入力からのものではありませんでした。Slack、Teams、または[プロジェクト](/docs/ja/claude-projects)のスレッドからセッションに中継されたメッセージ、あるいは[ルーティン](/docs/ja/routines)や別のプログラムが送信したプロンプトで届きました。4173[`/recap`](/docs/ja/interactive-mode#session-recap) のリクエストが自分自身の入力から来たものではありませんでした。Slack、Teams、または[プロジェクト](/docs/ja/claude-projects)のスレッドからセッションに中継されたメッセージで届いたか、[ルーティン](/docs/ja/routines)や別のプログラムが送信したプロンプトで届きました。

4064 4174 

4065中継されたメッセージは、ユーザー自身が書いたものであっても通知の対象になります。Claude Code は、中継されたメッセージや自動化されたメッセージが、セッションを実行しているアカウントの持ち主からのものかどうかを判断できないため、要約の代わりに次の通知で応答します:4175中継されたメッセージは、自分で書いたものであっても通知の対象になります。Claude Code は、中継されたメッセージや自動化されたメッセージが、セッションを実行しているアカウントの所有者からのものかどうかを判別できないため、要約の代わりにこの通知で応答します:

4066 4176 

4067```text theme={null}4177```text theme={null}

4068/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.4178/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.

4069```4179```

4070 4180 

4071`claude -p` に渡した `/recap` や、独自の [Agent SDK](/docs/ja/agent-sdk/overview) アプリケーションが起動したセッションに送信した `/recap` は、ユーザー自身の入力として扱われます。4181`claude -p` に渡した `/recap` や、自分の [Agent SDK](/docs/ja/agent-sdk/overview) アプリケーションが起動したセッションに送信した `/recap` は、自分自身の入力として扱われます。

4072 4182 

4073**対処方法:**4183**対処方法:**

4074 4184 

4075* 自分でセッションを開き、そこで `/recap` を実行します。セッションのターミナル、[デスクトップアプリ](/docs/ja/desktop)や[モバイルアプリ](/docs/ja/mobile)、[claude.ai/code](https://claude.ai/code)、または [Remote Control](/docs/ja/remote-control) 経由で実行できます4185* セッションを自分で開き、そこで `/recap` を実行します。ターミナル、[デスクトップアプリ](/docs/ja/desktop)または[モバイルアプリ](/docs/ja/mobile)、[claude.ai/code](https://claude.ai/code)、または [Remote Control](/docs/ja/remote-control) 経由で実行できます

4076* ルーティンや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します4186* ルーティンや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します

4077 4187 

4078<h2 id="plugin-errors">4188<h2 id="plugin-errors">


4124 マーケットプレイス名は予約名の別のスペルです4234 マーケットプレイス名は予約名の別のスペルです

4125</h3>4235</h3>

4126 4236 

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

4128 4238 

4129```text theme={null}4239```text theme={null}

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


5499 5609 

5500* 通知に示されたスクリプトを実行するフックの `command` で、パスを二重引用符で囲みます。JSON ファイルでは、`"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\""` のように記述します。5610* 通知に示されたスクリプトを実行するフックの `command` で、パスを二重引用符で囲みます。JSON ファイルでは、`"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\""` のように記述します。

5501 5611 

5612<h3 id="instruction-file-not-loaded">

5613 Instruction file not loaded

5614</h3>

5615 

5616対話セッションの会話ビューに表示されるこの通知は、存在する[メモリファイル](/docs/ja/memory#how-claude-md-files-load)が読み込まれなかったことを意味します。読み取り制限が適用されています。

5617 

5618```text theme={null}

5619Instruction file not loaded (a Read deny rule covers it):

5620path: .claude/rules/shared.md

5621```

5622 

5623括弧内には理由が示されます。例:

5624 

5625* **`a Read deny rule covers it`**: `Read` の[拒否ルール](/docs/ja/permissions#read-and-edit)が、記述されたとおりのファイルのパス、またはそのファイル上のリンクの参照先に一致している

5626* **`it's read from outside your working directories, where reads are blocked`**: [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) がオンの状態で、ファイルが[作業ディレクトリ](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)の外に解決される

5627* **`where it leads couldn't be worked out`**: たとえば、ファイルが直接または他のリンクを介して自分自身に戻るリンクになっている

5628 

5629Claude がサブディレクトリ内のファイルを操作する際にそのサブディレクトリ独自のメモリファイルを読み込めない場合、同じ行がそのターン中に会話に表示されます。行に示されているよりも多くのファイルが保留された場合は、最後の行に `and 3 more instruction files not loaded` のように残りの件数が示されます。

5630 

5631**対処方法:**

5632 

5633* 制限が意図したものであれば、何もする必要はありません。セッションはそのファイルの指示なしで実行されます。

5634* `a Read deny rule covers it` のために保留されたファイルを読み込むには、[そのルールを削除するか範囲を狭めます](/docs/ja/permissions#manage-permissions)。その後、新しいセッションを開始します。

5635* `it's read from outside your working directories, where reads are blocked` のために保留されたファイルを読み込むには、そのファイルまたはリンク先を作業ディレクトリ内に移動します。その後、新しいセッションを開始します。

5636* `where it leads couldn't be worked out` のために保留されたファイルを読み込むには、そのファイルが自分自身に戻るリンクになっていないか確認します。そうなっている場合は、リンクを存在するファイルに向けるか、その場所に通常のファイルを置きます。その後、新しいセッションを開始します。

5637 

5638v2.1.292 より前では、通知は同じ行の理由の後の末尾にファイル名を示していました。

5639 

5502<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">5640<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">

5503 名前が予約されているため、スキル、コマンド、またはワークフローが読み込まれなかった5641 名前が予約されているため、スキル、コマンド、またはワークフローが読み込まれなかった

5504</h3>5642</h3>


5683 5821 

5684v2.1.257 より前では、`/mcp` の **Reconnect** や再有効化によって、セッション中のポリシー更新でブロックされたサーバーに接続できてしまう場合がありました。5822v2.1.257 より前では、`/mcp` の **Reconnect** や再有効化によって、セッション中のポリシー更新でブロックされたサーバーに接続できてしまう場合がありました。

5685 5823 

5824<h3 id="mcp-server-name-is-reserved">

5825 MCP サーバー名が予約されている

5826</h3>

5827 

5828このメッセージは、組み込みサーバーの名前など、Claude Code が予約している名前を持つ MCP サーバーの 1 つを示しています。

5829 

5830```text theme={null}

5831"workspace" is a reserved MCP server name and was not loaded

5832```

5833 

5834**対処方法:**

5835 

5836* サーバーを定義している場所でサーバーの名前を変更します。たとえば、`workspace` を `my-workspace` に変更します

5837* 避けるべき他の予約名については、[MCP の設定の警告](/docs/ja/mcp#configuration-warnings)を参照してください

5838 

5686<h3 id="managed-settings-document-could-not-be-parsed">5839<h3 id="managed-settings-document-could-not-be-parsed">

5687 Managed settings document could not be parsed5840 Managed settings document could not be parsed

5688</h3>5841</h3>


5737 5890 

5738v2.1.285 より前では、claude.ai または Claude Console の認証情報でサインインしたセッションのみがこのメッセージで終了し、オペレーティングシステムによって読み取りが拒否された場合にもこのメッセージが表示されていました。5891v2.1.285 より前では、claude.ai または Claude Console の認証情報でサインインしたセッションのみがこのメッセージで終了し、オペレーティングシステムによって読み取りが拒否された場合にもこのメッセージが表示されていました。

5739 5892 

5893<h3 id="managed-settings-hooks-not-loaded">

5894 Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded

5895</h3>

5896 

5897`-p` の実行で表示されるこの stderr のブロックは、[管理設定](/docs/ja/managed-settings)のソースに Claude Code が読み込めないフックエントリが含まれていることを意味します。そのフックは実行されず、ある行でソースの `hooks` フィールドが無視されたと示されている場合は、そのソースのフックはいずれも実行されません。

5898 

5899各行には、ソース、該当する場合はフィールド、および問題(不明なフックの `type` や、`hooks` キーの外で宣言されたフックなど)が示されます。

5900 

5901```text theme={null}

5902Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded; fix or remove each entry:

5903 <source> (<field>): <message>

5904```

5905 

5906**対処方法:**

5907 

5908* ソースを管理している場合は、ブロックに一覧表示された各エントリを修正または削除します。`hooks` の下で Claude Code が想定する形式については、[フックの設定](/docs/ja/hooks#configuration)を参照してください。

5909* 行のソースが `parent managed settings` となっている場合は、Claude Code を起動したアプリケーションがそのエントリを[親設定](/docs/ja/managed-settings#parent-settings-from-embedding-hosts)として渡しているため、そのアプリケーションの開発者に報告してください

5910* それ以外の場合は、ブロックを管理者に送ってください

5911 

5912v2.1.300 より前では、`-p` の実行ではこのケースが `Managed settings failed to load; policies from the failed source are NOT in effect:` ヘッダーの下に一覧表示されていました。

5913 

5740<h3 id="otelheadershelper-failed">5914<h3 id="otelheadershelper-failed">

5741 otelHeadersHelper failed5915 otelHeadersHelper failed

5742</h3>5916</h3>


5955 6129 

5956v2.1.233 より前では、Claude Code は認識しないモデル ID でリクエストを送信しても、行を書き込んでいませんでした。6130v2.1.233 より前では、Claude Code は認識しないモデル ID でリクエストを送信しても、行を書き込んでいませんでした。

5957 6131 

6132<h3 id="sandbox-allow-entries-are-ignored-under-a-managed-lock">

6133 管理ロック下ではサンドボックスの許可エントリが無視される

6134</h3>

6135 

6136`/status` と `claude doctor` に表示されるこの警告は、管理設定で [`allowManagedReadPathsOnly`](/docs/ja/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) または [`allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) が設定されているため、警告に示されたファイル内の [`allowRead`](/docs/ja/settings-reference#sandbox-filesystem-allowread) または [`allowedDomains`](/docs/ja/settings-reference#sandbox-network-alloweddomains) エントリが適用されないことを意味します。

6137 

6138```text wrap theme={null}

6139sandbox.filesystem.allowRead is ignored — managed settings set allowManagedReadPathsOnly, so only allowRead paths from managed settings are honored. The 3 entries in /home/you/.claude/settings.json will NOT apply (see https://code.claude.com/docs/en/settings#sandbox-settings).

6140```

6141 

6142ネットワークのロックの場合、警告には `sandbox.network.allowedDomains` と `allowManagedDomainsOnly` が示され、`only allowed domains (and WebFetch domain rules) from managed settings are honored` と表示されます。

6143 

6144**対処方法:**

6145 

6146* この警告に対処する必要はありません

6147* それらのパスやドメインが必要で、組織の管理設定でロックが設定されている場合は、それらを管理設定に追加するよう管理者に依頼してください。示されたファイルからもエントリを削除するまで、警告は表示されたままになります。

6148* 警告を解消するには、示されたファイルからエントリを削除します。プロジェクトの `.claude/settings.json` など共有しているファイルの場合は、ロックのないチームメイトのためにエントリを残し、警告を表示させたままにしておくこともできます。

6149 

5958<h3 id="stale-sandbox-mask-files-left-by-a-killed-session">6150<h3 id="stale-sandbox-mask-files-left-by-a-killed-session">

5959 Stale sandbox mask files left by a killed session6151 Stale sandbox mask files left by a killed session

5960</h3>6152</h3>

Details

314 314 

315 * エージェント独自のシステムプロンプト(Claude Code システムプロンプトではない)315 * エージェント独自のシステムプロンプト(Claude Code システムプロンプトではない)

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

317 * CLAUDE.md と git ステータス(ただし、組み込みの Explore および Plan エージェントは[両方を省略](/docs/ja/sub-agents#what-loads-at-startup) し、エージェント定義が [`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定する場合はユーザー、プロジェクト、ローカル CLAUDE.md ファイルをスキップします)317 * CLAUDE.md と git ステータス。組み込みの Explore および Plan エージェントは[どちらもなしで開始](/docs/ja/sub-agents#what-loads-at-startup) し、定義で [`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定したエージェントは、ユーザー、プロジェクト、ローカル CLAUDE.md ファイルなしで開始します。

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

319 319 

320 [fork](/docs/ja/sub-agents#fork-the-current-conversation) の場合、Claude Code は親の会話(これまでのところ)、システムプロンプト、ツールをロードします。320 [fork](/docs/ja/sub-agents#fork-the-current-conversation) の場合、Claude Code は親の会話(これまでのところ)、システムプロンプト、ツールをロードします。

Details

57 </Step>57 </Step>

58 58 

59 <Step title="Code Review を有効にする">59 <Step title="Code Review を有効にする">

60 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) にアクセスし、GHES リポジトリの [Code Review](/docs/ja/code-review#set-up-code-review) を github.com と同じ設定を使用して有効にします。60 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) にアクセスし、GHES リポジトリの [Code Review](/docs/ja/code-review-setup) を github.com と同じ設定を使用して有効にします。

61 </Step>61 </Step>

62</Steps>62</Steps>

63 63 

Details

217* `VERTEX_REGION_CLAUDE_*`:Claude Code は `CLOUD_ML_REGION` にフォールバックします。217* `VERTEX_REGION_CLAUDE_*`:Claude Code は `CLOUD_ML_REGION` にフォールバックします。

218* `CLOUD_ML_REGION`:Claude Code は `us-east5` にフォールバックします。218* `CLOUD_ML_REGION`:Claude Code は `us-east5` にフォールバックします。

219 219 

220[prompt caching](/docs/ja/prompt-caching)は自動的に有効になります。これを無効にするには、`DISABLE_PROMPT_CACHING=1` を設定します。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、`ENABLE_PROMPT_CACHING_1H=1` を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます。メインの会話と Claude Code が外部で行うリクエストに異なる TTL を設定するには、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)してください。220[プロンプトキャッシュ](/docs/ja/prompt-caching)は自動的に有効になります。これを無効にするには、`DISABLE_PROMPT_CACHING=1` を設定します。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、`ENABLE_PROMPT_CACHING_1H=1` を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます。メインの会話と Claude Code が外部で行うリクエストに異なる TTL を設定するには、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)してください。

221 221 

222レート制限を高くするには、Google Cloud サポートに連絡してください。Google Cloud の Agent Platform を使用する場合、認証が Google Cloud 認証情報を通じて処理されるため、`/logout` コマンドは利用できません。222レート制限を高くするには、Google Cloud サポートに連絡してください。Google Cloud の Agent Platform を使用する場合、認証が Google Cloud 認証情報を通じて処理されるため、`/logout` コマンドは利用できません。

223 223 

Details

222| `T{char}` | 現在の行で前の文字の出現位置の直後にジャンプ |222| `T{char}` | 現在の行で前の文字の出現位置の直後にジャンプ |

223| `;` | 最後の f/F/t/T モーションを繰り返す |223| `;` | 最後の f/F/t/T モーションを繰り返す |

224| `,` | 最後の f/F/t/T モーションを逆方向で繰り返す |224| `,` | 最後の f/F/t/T モーションを逆方向で繰り返す |

225| `%` | 対応する `()`、`[]`、`{}` の括弧にジャンプします。カーソルが括弧の上にない場合は、現在の行の次の括弧を起点にします。Claude Code v2.1.301 以降が必要です |

225| `/` | 逆履歴検索を開く、`Ctrl+R` と同じです。空の検索プロンプトはヒントを表示します:`Esc` を押してから `i` を押してから `/` を押してコマンドメニューを開く代わりに |226| `/` | 逆履歴検索を開く、`Ctrl+R` と同じです。空の検索プロンプトはヒントを表示します:`Esc` を押してから `i` を押してから `/` を押してコマンドメニューを開く代わりに |

226 227 

227<Note>228<Note>


243| `dj`/`dk` | 現在の行と下または上の行を削除 |244| `dj`/`dk` | 現在の行と下または上の行を削除 |

244| `dgg`/`dG` | 現在の行から最初または最後の行まで削除 |245| `dgg`/`dG` | 現在の行から最初または最後の行まで削除 |

245| `d0`/`c0`/`y0` | カーソルから行の開始まで削除、変更、またはヤンク。Claude Code v2.1.281 以降が必要です |246| `d0`/`c0`/`y0` | カーソルから行の開始まで削除、変更、またはヤンク。Claude Code v2.1.281 以降が必要です |

247| `d%`/`c%`/`y%` | カーソルから `%` のジャンプ先の括弧までを削除、変更、またはヤンク。Claude Code v2.1.301 以降が必要です |

246| `cc` | 行を変更 |248| `cc` | 行を変更 |

247| `C` | 行の終わりまで変更 |249| `C` | 行の終わりまで変更 |

248| `cw`/`ce`/`cb` | 単語を変更/終わりまで/戻す |250| `cw`/`ce`/`cb` | 単語を変更/終わりまで/戻す |

mcp.md +1 −1

Details

1632 1632 

1633v2.1.296 より前は、短い方の上限は 2,048 文字でした。また v2.1.295 より前は、ツール検索を通じて読み込まれるものを含むすべてのツール説明にこの上限が適用されていました。1633v2.1.296 より前は、短い方の上限は 2,048 文字でした。また v2.1.295 より前は、ツール検索を通じて読み込まれるものを含むすべてのツール説明にこの上限が適用されていました。

1634 1634 

1635セッション内のすべての MCP サーバーの上限を変更するには、[`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](/docs/ja/env-vars#variables)を文字数に設定します。設定した数値は両方の上限を置き換えます。たとえば `8192` を設定すると、短い方の上限は引き上げられ、長い方の上限は引き下げられます。この変数には Claude Code v2.1.280 以降が必要です。1635Anthropic が `api.anthropic.com` でホストしている一部の MCP サーバーからの説明と指示は、切り詰められずに Claude に届きます。セッション内のその他の MCP サーバーの上限を変更するには、[`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](/docs/ja/env-vars#variables)を文字数に設定します。設定した数値は両方の上限を置き換えます。たとえば `8192` を設定すると、短い方の上限は引き上げられ、長い方の上限は引き下げられます。この変数には Claude Code v2.1.280 以降が必要です。

1636 1636 

1637<h4 id="per-tool-alwaysload">1637<h4 id="per-tool-alwaysload">

1638 ツールを事前に読み込むか遅延させたままにするかをマークする1638 ツールを事前に読み込むか遅延させたままにするかをマークする

Details

378 ```powershell theme={null}378 ```powershell theme={null}

379 $env:MCP_TIMEOUT = "60000"; claude379 $env:MCP_TIMEOUT = "60000"; claude

380 ```380 ```

381 

382 v2.1.299 より前は、稼働中の HTTP サーバーへの一部の接続が、`MCP_TIMEOUT` に関係なくスタートアップ時にタイムアウトしていました。これらのバージョンを使用していて、制限を引き上げた後も稼働中の HTTP サーバーがタイムアウトする場合は、[Claude Code を更新](/docs/ja/setup#update-claude-code)してください。

381 </Accordion>383 </Accordion>

382 384 

383 <Accordion title="サーバーは既に存在します">385 <Accordion title="サーバーは既に存在します">

memory.md +1 −0

Details

648デバッグするには:648デバッグするには:

649 649 

650* `/context` を実行し、**Memory files** の下のリストを確認して、起動時に読み込まれるはずの CLAUDE.md と CLAUDE.local.md ファイルを確認します。そこにないファイルがある場合、Claude はそれを見ることができません。`/memory` を使用してファイルを開いて編集します。650* `/context` を実行し、**Memory files** の下のリストを確認して、起動時に読み込まれるはずの CLAUDE.md と CLAUDE.local.md ファイルを確認します。そこにないファイルがある場合、Claude はそれを見ることができません。`/memory` を使用してファイルを開いて編集します。

651* `Instruction file not loaded` という通知が表示された場合は、[その意味と対処方法](/docs/ja/errors#instruction-file-not-loaded) を参照してください。

651* 作業ディレクトリのサブディレクトリにある `CLAUDE.md` は、起動時ではなくオンデマンドで読み込まれるため、**Memory files** の下には表示されません。読み込まれると、そのパスを含む `Loaded` 行がターミナルに表示されます。新しいファイルをテストするには、Claude に書き込みを依頼するのではなくシェルから作成し、そのサブディレクトリ内のファイルを読むよう Claude に依頼します。652* 作業ディレクトリのサブディレクトリにある `CLAUDE.md` は、起動時ではなくオンデマンドで読み込まれるため、**Memory files** の下には表示されません。読み込まれると、そのパスを含む `Loaded` 行がターミナルに表示されます。新しいファイルをテストするには、Claude に書き込みを依頼するのではなくシェルから作成し、そのサブディレクトリ内のファイルを読むよう Claude に依頼します。

652* 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します([CLAUDE.md ファイルをどこに配置するかを選択する](#choose-where-to-put-claude-md-files) を参照)。653* 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します([CLAUDE.md ファイルをどこに配置するかを選択する](#choose-where-to-put-claude-md-files) を参照)。

653* 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。654* 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。

model-config.md +20 −0

Details

895 ゲートウェイまたはカスタムモデル ID のウィンドウを修正する895 ゲートウェイまたはカスタムモデル ID のウィンドウを修正する

896</h3>896</h3>

897 897 

898次の起動時の警告のいずれかが表示された場合、Claude Code はセッションのモデル ID を認識していないため、そのモデルのコンテキストウィンドウを判別できず、200K トークンを想定しています。

899 

900```text theme={null}

901⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

902Claude Code doesn't recognize the model "my-gateway-opus", so it assumes a context window of 200k tokens. Update Claude Code, or see https://code.claude.com/docs/en/model-config#correct-the-window-for-a-gateway-or-custom-model-id to set the window.

903```

904 

905Claude Code は想定した 200K で会話を[自動圧縮](#default-auto-compact-thresholds)するため、モデルの実際のコンテキストウィンドウが 200K であれば、修正の必要はありません。そうでない場合は、ID に合わせて次のいずれかの方法で実際のウィンドウを Claude Code に指定してください。

906 

907* **Claude Code のバージョンより新しいモデル**:シェルで `claude update` を実行します。更新後に Claude Code がその ID を認識すれば、他に設定する必要はありません。

908* **Claude Code が認識しているモデルに対する、ゲートウェイまたはプロバイダー側の名前**:Anthropic のモデル ID を自分の ID に対応付ける [`modelOverrides`](#override-model-ids-per-version) エントリを追加します(例:`"claude-opus-4-8": "my-gateway-opus"`)。代わりに、[`modelPicker`](/docs/ja/settings-reference#fields-for-modelpicker) の行に自分の ID を記載し、`behavesAs` にそのモデルを設定することもできます。いずれの場合も、Claude Code はその ID をそのモデルとして扱います。

909* **1M のウィンドウを持つモデル**:モデルを設定する箇所で、ID の末尾に `[1m]` を付けます(例:シェルで `claude --model 'my-gateway-opus[1m]'`)。[1M コンテキストをオフにした](#turn-off-1m-context)場合は、接尾辞の有無にかかわらず同じウィンドウになります。

910* **その他のウィンドウ**:Claude Code を起動する環境で、[`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ja/env-vars) にウィンドウサイズをトークン数で設定します(例:`CLAUDE_CODE_MAX_CONTEXT_TOKENS=400000`)。`claude-` で始まらず `[1m]` 接尾辞もない認識できない ID の場合、この変数は単独で有効になります。それ以外の ID の場合は、まず[この変数がどの ID に適用されるか](#which-ids-claude_code_max_context_tokens-applies-to)を確認してください。

911 

912Claude Code が ID を認識するか、指定したウィンドウを使用するようになると、その ID でセッションを開始しても警告は表示されなくなります。

913 

914<h4 id="which-ids-claude_code_max_context_tokens-applies-to">

915 `CLAUDE_CODE_MAX_CONTEXT_TOKENS` が適用される ID

916</h4>

917 

898[LLM ゲートウェイ](/docs/ja/llm-gateway)やその他のカスタムデプロイでは、Claude Code がその ID を Claude モデルに解決するかどうかにかかわらず、モデル ID に対してモデルの実際のウィンドウとは異なるコンテキストウィンドウを想定することがあります。Claude Code が代わりに想定すべきウィンドウを [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ja/env-vars) に設定してください。918[LLM ゲートウェイ](/docs/ja/llm-gateway)やその他のカスタムデプロイでは、Claude Code がその ID を Claude モデルに解決するかどうかにかかわらず、モデル ID に対してモデルの実際のウィンドウとは異なるコンテキストウィンドウを想定することがあります。Claude Code が代わりに想定すべきウィンドウを [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ja/env-vars) に設定してください。

899 919 

900この変数の適用方法は ID によって異なります。Claude Code は、ID が(大文字小文字を問わず)`claude-` で始まらない場合、または Google Cloud の Agent Platform で使用される `@YYYYMMDD` の日付のように、ID の読み取り時に Claude Code が取り除く接尾辞が付いている場合に、その ID をプロバイダー固有またはカスタムの表記として扱います。v2.1.259 より前の Claude Code は取り除かれた接尾辞を考慮しなかったため、日付の接尾辞が付いた認識できない `claude-` ID は、接尾辞のない `claude-` 名として扱われていました。920この変数の適用方法は ID によって異なります。Claude Code は、ID が(大文字小文字を問わず)`claude-` で始まらない場合、または Google Cloud の Agent Platform で使用される `@YYYYMMDD` の日付のように、ID の読み取り時に Claude Code が取り除く接尾辞が付いている場合に、その ID をプロバイダー固有またはカスタムの表記として扱います。v2.1.259 より前の Claude Code は取り除かれた接尾辞を考慮しなかったため、日付の接尾辞が付いた認識できない `claude-` ID は、接尾辞のない `claude-` 名として扱われていました。

Details

6 6 

7> Claude Code の OpenTelemetry を有効にして設定する方法を学びます。7> Claude Code の OpenTelemetry を有効にして設定する方法を学びます。

8 8 

9OpenTelemetry (OTel) を通じてテレメトリデータをエクスポートすることで、組織全体で Claude Code の使用状況、コスト、ツールアクティビティを追跡します。Claude Code はメトリクスを標準メトリクスプロトコル経由で時系列データとしてエクスポートし、イベントをログ/イベントプロトコル経由でエクスポートし、オプションで [トレースプロトコル](#traces-beta)経由で分散トレースをエクスポートします。9OpenTelemetry (OTel) を通じてテレメトリデータをエクスポートすることで、組織全体で Claude Code の使用状況、コスト、ツールアクティビティを追跡します。Claude Code はメトリクスを標準メトリクスプロトコル経由で時系列データとしてエクスポートし、イベントをログ/イベントプロトコル経由でエクスポートし、オプションで [OpenTelemetry 経由の分散トレース](#traces-beta)をエクスポートします。

10 

11<Note>

12 Claude API または Managed Agents については、[Claude API 向けの OpenTelemetry](https://platform.claude.com/docs/en/manage-claude/opentelemetry) を参照してください。

13</Note>

10 14 

11<h2 id="quick-start">15<h2 id="quick-start">

12 クイックスタート16 クイックスタート

Details

84* **ネットワークポリシーは `$.http.fetch` をカバーします。**84* **ネットワークポリシーは `$.http.fetch` をカバーします。**

85 85 

86 * **組織のポリシーで WebFetch が許可されていない場合**: Claude Code はすべての mod の `$.http.fetch` リクエストも拒否します。[WebFetch の利用可否](/docs/ja/tools-reference#webfetch-availability) を参照してください。86 * **組織のポリシーで WebFetch が許可されていない場合**: Claude Code はすべての mod の `$.http.fetch` リクエストも拒否します。[WebFetch の利用可否](/docs/ja/tools-reference#webfetch-availability) を参照してください。

87 * **管理設定またはその他の設定ファイルで、[`CLAUDE_CODE_DISABLE_WEB_FETCH`](/docs/ja/env-vars#variables) または `WebFetch` の[拒否ルール](/docs/ja/permissions#tool-specific-permission-rules)を使用して WebFetch ツールをオフにした場合**: mod は引き続き `$.http.fetch` リクエストを実行できます。

88 

89 ユーザーがインストールするすべての mod についてこれを停止するには、[ユーザーがインストールした mod が読み込まれないようにする](#stop-user-installed-mods-from-loading)か、[ポリシー mod](#enforce-a-policy-with-a-mod-of-your-own) で `http.fetch` をフックし、ユーザーの mod からのリクエストを拒否してください。Claude Code は失敗したフックをスキップし、その場合リクエストはそのまま実行されるため、そのフックには同様に拒否する [`.catch` ハンドラー](/docs/ja/plugins/mods/events#handle-a-hook-that-fails)を指定してください。[ユーザーがインストールできるプラグインを制限する](/docs/ja/plugins/org#restrict-what-users-can-install)だけの場合、読み込まれる mod は減りますが、許可した mod は引き続きこれらのリクエストを実行できます。

87 * **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) を設定した場合**: 管理者自身またはユーザーがインストールした mod は、引き続きこれらのリクエストを実行できます。この変数が停止するのは、[Claude Code に組み込まれた mod](/docs/ja/plugins/mods/overview#mods-built-into-claude-code) と、セッションの Anthropic 認証情報を含む `$.http.fetch` リクエストのみです。v2.1.288 より前は、この変数はすべての mod の `$.http.fetch` リクエストを停止していました。90 * **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) を設定した場合**: 管理者自身またはユーザーがインストールした mod は、引き続きこれらのリクエストを実行できます。この変数が停止するのは、[Claude Code に組み込まれた mod](/docs/ja/plugins/mods/overview#mods-built-into-claude-code) と、セッションの Anthropic 認証情報を含む `$.http.fetch` リクエストのみです。v2.1.288 より前は、この変数はすべての mod の `$.http.fetch` リクエストを停止していました。

88 91 

89 どちらも、mod が `$.process.run` で開始するプログラムはカバーしません。そのプログラムはユーザー独自のアクセスでネットワークに到達します。92 いずれも、mod が `$.process.run` で開始するプログラムはカバーしません。そのプログラムはユーザー独自のアクセスでネットワークに到達します。

90* **プラグインコントロールは mod をカバーします。** Mod はプラグインであるため、[ユーザーがインストールできるものを制限する設定](/docs/ja/plugins/org#restrict-what-users-can-install)(`strictKnownMarketplaces` など)は、それをインストールできるかどうかを決定します。93* **プラグインコントロールは mod をカバーします。** Mod はプラグインであるため、[ユーザーがインストールできるものを制限する設定](/docs/ja/plugins/org#restrict-what-users-can-install)(`strictKnownMarketplaces` など)は、それをインストールできるかどうかを決定します。

91* **Mod は権限プロンプトを変更できません。** Mod は Claude Code のインターフェイスの大部分を再スタイル化できますが、権限プロンプトはできないため、プロンプトが表示するものを変更できません。Mod は、[デフォルトで何が起こるかを理解する](#know-what-happens-by-default) で説明されているように、プロンプトが表示される前にツール呼び出しを承認または拒否できます。94* **Mod は権限プロンプトを変更できません。** Mod は Claude Code のインターフェイスの大部分を再スタイル化できますが、権限プロンプトはできないため、プロンプトが表示するものを変更できません。Mod は、[デフォルトで何が起こるかを理解する](#know-what-happens-by-default) で説明されているように、プロンプトが表示される前にツール呼び出しを承認または拒否できます。

92* **信頼プロンプトが最初に表示されます。** ユーザーがまだ信頼していないディレクトリでのインタラクティブセッションでは、信頼プロンプトに答えるまで mod は読み込まれません。95* **信頼プロンプトが最初に表示されます。** ユーザーがまだ信頼していないディレクトリでのインタラクティブセッションでは、信頼プロンプトに答えるまで mod は読み込まれません。

Details

234| `$.ui.toast(text)` | mod の名前を含むトースト通知で、数秒後に消えます。[フルスクリーンレンダリング](/docs/ja/fullscreen)では右上のボックスとして、クラシックレンダラーではプロンプトの下の右側に 1 行で表示されます。 |234| `$.ui.toast(text)` | mod の名前を含むトースト通知で、数秒後に消えます。[フルスクリーンレンダリング](/docs/ja/fullscreen)では右上のボックスとして、クラシックレンダラーではプロンプトの下の右側に 1 行で表示されます。 |

235| `$.ui.log(text)` | Claude が読まない、トランスクリプト内の薄い行。`●` と mod の名前で始まります。`● my-mod: build finished` など。 |235| `$.ui.log(text)` | Claude が読まない、トランスクリプト内の薄い行。`●` と mod の名前で始まります。`● my-mod: build finished` など。 |

236 236 

237[VS Code 拡張機能](/docs/ja/plugins/mods/interface#draw-in-the-vs-code-extension)では、ステータスラインとトーストは代わりにプロンプトボックスの上に表示され、ログ行は会話内に表示されます。

238 

237<h3 id="start-a-turn-from-a-background-job">239<h3 id="start-a-turn-from-a-background-job">

238 バックグラウンドジョブからターンを開始する240 バックグラウンドジョブからターンを開始する

239</h3>241</h3>

Details

226| `Spinner`、`ToolProgress`、`TurnDuration` | ターンのステータスライン:Claude の作業中にアニメーションする行、実行中のツールのリアルタイムの進捗行、ターンの終わりを示す行 |226| `Spinner`、`ToolProgress`、`TurnDuration` | ターンのステータスライン:Claude の作業中にアニメーションする行、実行中のツールのリアルタイムの進捗行、ターンの終わりを示す行 |

227| `InfoNotice`、`SessionMode`、`PromptHint` | ロゴの下のステータスライン、フッターのモードラベル、プロンプトの下のヒント行 |227| `InfoNotice`、`SessionMode`、`PromptHint` | ロゴの下のステータスライン、フッターのモードラベル、プロンプトの下のヒント行 |

228 228 

229`Pane`、`AskUserQuestion`、`Spinner`、`UserMessage`、`AssistantMessage`、およびツール呼び出しの描画箇所は、ターミナル、Desktop アプリ、VS Code 拡張機能で機能します。その他の描画箇所がそれぞれどこで発生するかは、[描画箇所の表](/docs/ja/plugins/mods/reference#render-sites)に記載されています。

230 

229Claude Code がすでに描画している描画箇所では、フックで細部を変更したり、描画を置き換えたり、そのままにしたりできます。タブを選択すると、それぞれをスピナーに適用した例を確認できます。これらの例では、[チュートリアルの mod](/docs/ja/plugins/mods/create#write-a-mod-yourself) と同様に、別のフックがカウントする `calls` 変数を読み取っています。231Claude Code がすでに描画している描画箇所では、フックで細部を変更したり、描画を置き換えたり、そのままにしたりできます。タブを選択すると、それぞれをスピナーに適用した例を確認できます。これらの例では、[チュートリアルの mod](/docs/ja/plugins/mods/create#write-a-mod-yourself) と同様に、別のフックがカウントする `calls` 変数を読み取っています。

230 232 

231<Tabs>233<Tabs>


297 299 

298権限プロンプトは描画箇所ではないため、mod でその表示内容を変更することはできません。質問ダイアログ `AskUserQuestion` は描画箇所であるため、mod で変更できます。ダイアログ用のツリーには参照をちょうど 1 回だけ含め、独自の要素はその上に配置する必要があります。そうでない場合、Claude Code は独自のダイアログを描画します。300権限プロンプトは描画箇所ではないため、mod でその表示内容を変更することはできません。質問ダイアログ `AskUserQuestion` は描画箇所であるため、mod で変更できます。ダイアログ用のツリーには参照をちょうど 1 回だけ含め、独自の要素はその上に配置する必要があります。そうでない場合、Claude Code は独自のダイアログを描画します。

299 301 

300ターミナルと Desktop アプリでは、発生する描画箇所がすべて同じではありません。`Pane`、`AbovePrompt`、`Spinner`、およびトランスクリプトの描画箇所は両方で機能します。その他のいくつかのステータスラインはターミナルでのみ発生します。それぞれがどこで発生するかは、[描画箇所の表](/docs/ja/plugins/mods/reference#render-sites)に記載されています。

301 

302<h3 id="open-a-pane-at-the-right-time">302<h3 id="open-a-pane-at-the-right-time">

303 適切なタイミングでペインを開く303 適切なタイミングでペインを開く

304</h3>304</h3>


328| `rows` | ペインがプロンプトの上に配置されるときに求める高さ。デフォルトは領域の 3 分の 1 です。 |328| `rows` | ペインがプロンプトの上に配置されるときに求める高さ。デフォルトは領域の 3 分の 1 です。 |

329| `columns` | ペインがトランスクリプトの横に配置されるときに求める幅 |329| `columns` | ペインがトランスクリプトの横に配置されるときに求める幅 |

330 330 

331[VS Code 拡張機能](#draw-in-the-vs-code-extension)は `rows` と `columns` を無視し、ペインのサイズを自ら決定します。

332 

331`focus`、`closeOnEscape`、`holdToasts` は省略可能で、`true` のみを受け付けます。指定しない場合は省略してください。`false` を渡すと、`ui.open: focus is true or left out` のようなエラーがスローされます。これらのいずれかを条件付きで設定するには、条件が成り立つ場合にのみフィールドを追加します。次の呼び出しは、`items` が空でない場合にのみキーボードフォーカスを要求します。333`focus`、`closeOnEscape`、`holdToasts` は省略可能で、`true` のみを受け付けます。指定しない場合は省略してください。`false` を渡すと、`ui.open: focus is true or left out` のようなエラーがスローされます。これらのいずれかを条件付きで設定するには、条件が成り立つ場合にのみフィールドを追加します。次の呼び出しは、`items` が空でない場合にのみキーボードフォーカスを要求します。

332 334 

333```javascript theme={null}335```javascript theme={null}


356 358 

357ペインが表示されると、`$.ui.open` は `{ isPlaced: true }` に解決されます。ペインが待機している場合、`isPlaced` は `false` になり、`reason` にはその理由を示す文字列が入ります。待機中のペインは、ユーザーがペインを開くかターミナルの幅を広げると表示されます。ペインを開かずに何かが利用可能であることを伝えるには、`$.ui.toast('Your message')` を呼び出してトースト通知を表示します。359ペインが表示されると、`$.ui.open` は `{ isPlaced: true }` に解決されます。ペインが待機している場合、`isPlaced` は `false` になり、`reason` にはその理由を示す文字列が入ります。待機中のペインは、ユーザーがペインを開くかターミナルの幅を広げると表示されます。ペインを開かずに何かが利用可能であることを伝えるには、`$.ui.toast('Your message')` を呼び出してトースト通知を表示します。

358 360 

361<h3 id="draw-in-the-vs-code-extension">

362 VS Code 拡張機能で描画する

363</h3>

364 

365VS Code 拡張機能では、拡張機能のバージョン 2.1.299 以降で、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションにおいて、mod が描画する内容がチャットパネルに表示されます。パネル向けの `ui.render` フックでは、`e.surface` は `vscode` です。パネルがどの描画箇所と要素を描画し、どの props を無視するかについては、[描画箇所](/docs/ja/plugins/mods/reference#render-sites)と[要素](/docs/ja/plugins/mods/reference#elements)の表を参照してください。

366 

367mod をターミナルだけでなくパネルでも機能させるには、次の違いを考慮してください。

368 

369* **ペイン**:幅が 800 ピクセル以上のパネルでは、ペインは会話の横にドッキングされ、`e.props.placement` は `'dock'`、`e.viewport.isFullscreen` は `true` になります。それより狭いパネルでは、ペインはプロンプトボックスの上に描画され、`placement` は `'inline'` になり、ペインは 12 行を表示した後にスクロールします。

370* **トーストとステータスライン**:これらはプロンプトボックスのすぐ上にある 1 つのスタックにまとめて配置され、パネルが狭い場合はペインも一緒に配置されます。ステータスラインは mod ごとに 1 つです。権限リクエストやダイアログが表示されている間、スタックは非表示になります。

371* **ラベル**:パネルは mod が描画または書き換えた内容を枠で囲み、**From the token-chart plugin** や **Edited by the token-chart plugin** のようにプラグイン名のラベルを付けます。

372* **キーボード**:ボタンにはホットキーがないため、ユーザーはボタンをクリックするか、ボタンにフォーカスがあるときに Enter キーを押します。

373* **キーボードフォーカス**:パネルがペインの `focus: true` 要求を受け入れるのは、パネルにフォーカスがあり、Claude がアイドル状態で待機中の質問がなく、プロンプトボックスが空の場合のみです。

374* **質問ダイアログ**:`AskUserQuestion` では、パネルは独自の質問カードを維持し、その上に指定した要素を描画します。`next` に渡した props はカードを変更しません。

375* **プロンプトの候補**:パネルはプロンプトボックスの薄い候補テキストを Claude 自身の候補用に確保しているため、`$.prompt.suggest` は `isShown: false` で解決され、何も表示しません。

376* **テキストの上限**:パネルはステータスラインを 200 文字または 2 行で、トーストを 500 文字で切り詰めます。

377 

359<h2 id="build-a-tree-from-elements">378<h2 id="build-a-tree-from-elements">

360 要素からツリーを構築する379 要素からツリーを構築する

361</h2>380</h2>

362 381 

363`ui.render` フックが返すのは要素ツリーです。これは描画する内容の記述で、ボックス、テキスト、コントロールを互いに入れ子にして構成します。ユーザーが描画内容を記述すると、Claude Code がそれをターミナルまたは Desktop アプリでレンダリングします。382`ui.render` フックが返すのは要素ツリーです。これは描画する内容の記述で、ボックス、テキスト、コントロールを互いに入れ子にして構成します。描画内容を記述すると、Claude Code はユーザーが開いているアプリ(ターミナル、Desktop アプリ、VS Code 拡張機能のいずれか)でそれをレンダリングします。

364 383 

365要素を取得するには、フック内で `const { Box, Text, Button } = $.ui.resolve(e)` のように `$.ui.resolve(e)` を呼び出します。各要素は関数です。関数に props を渡し、その中に入れる要素や文字列を `children` に入れます。384要素を取得するには、フック内で `const { Box, Text, Button } = $.ui.resolve(e)` のように `$.ui.resolve(e)` を呼び出します。各要素は関数です。関数に props を渡し、その中に入れる要素や文字列を `children` に入れます。

366 385 


440| `Text` | スタイル付きテキスト。`color`、`bold`、`dimColor`、`italic`、`wrap` を受け取ります。`color` はテーマキー、または `'red'` などのカラーです。`wrap` は `'wrap'`、`'truncate'`、`'truncate-start'`、`'truncate-middle'`、`'truncate-end'` のいずれかです。 | すべて |459| `Text` | スタイル付きテキスト。`color`、`bold`、`dimColor`、`italic`、`wrap` を受け取ります。`color` はテーマキー、または `'red'` などのカラーです。`wrap` は `'wrap'`、`'truncate'`、`'truncate-start'`、`'truncate-middle'`、`'truncate-end'` のいずれかです。 | すべて |

441| `Button` | `onPress` を呼び出すコントロール | すべて |460| `Button` | `onPress` を呼び出すコントロール | すべて |

442| `Link`、`Code`、`Markdown` | `href` と任意の `label` を持つリンク、コードブロック、Claude の返信と同じ形式で整形されたテキスト。`Markdown` はコンテンツを `children` ではなく `text` props で受け取り、`onLinkPress` を渡す場合は `key` が必要です。 | すべて |461| `Link`、`Code`、`Markdown` | `href` と任意の `label` を持つリンク、コードブロック、Claude の返信と同じ形式で整形されたテキスト。`Markdown` はコンテンツを `children` ではなく `text` props で受け取り、`onLinkPress` を渡す場合は `key` が必要です。 | すべて |

443| `Input`、`Select` | テキストフィールドとドロップダウン | ターミナル、Desktop |462| `Input`、`Select` | テキストフィールドとドロップダウン | ターミナル、Desktop、VS Code |

444| `Svg` | SVG ドキュメント | Desktop |463| `Svg` | SVG ドキュメント | Desktop、VS Code |

445| `Client` | アニメーションやポインター入力のために、ユーザーが用意した 2 つ目のファイルが描画する領域。そのファイルは mods API を利用できません。そのファイルはデータをポストすることでフックに到達し、そのデータは `ui.message` イベントとして届きます。読み込み、描画、実行のいずれかに失敗すると、フックは [`ui.fault`](/docs/ja/plugins/mods/reference#interface) イベントを受け取ります。 | ターミナル、Desktop |464| `Client` | アニメーションやポインター入力のために、ユーザーが用意した 2 つ目のファイルが描画する領域。そのファイルは mods API を利用できません。そのファイルはデータをポストすることでフックに到達し、そのデータは `ui.message` イベントとして届きます。読み込み、描画、実行のいずれかに失敗すると、フックは [`ui.fault`](/docs/ja/plugins/mods/reference#interface) イベントを受け取ります。 | ターミナル、Desktop |

446| `Raster`、`Image` | [色付きセルのグリッド](#draw-a-grid-of-colored-cells)と画像 | ターミナル |465| `Raster`、`Image` | [色付きセルのグリッド](#draw-a-grid-of-colored-cells)と画像 | ターミナル |

447 466 


452`--plugin-dir` で開始したセッションでは、`ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own` のように、トランスクリプトの行でそのことが示されます。[デバッグログ](/docs/ja/plugins/mods/troubleshoot#read-the-debug-log)には、同じ理由とともに `ui.render (Pane): a hook returned a tree that does not validate` として記録されます。セッションにはそれ以外に何も表示されないため、描画が表示されない場合は、その行またはログを確認してください。471`--plugin-dir` で開始したセッションでは、`ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own` のように、トランスクリプトの行でそのことが示されます。[デバッグログ](/docs/ja/plugins/mods/troubleshoot#read-the-debug-log)には、同じ理由とともに `ui.render (Pane): a hook returned a tree that does not validate` として記録されます。セッションにはそれ以外に何も表示されないため、描画が表示されない場合は、その行またはログを確認してください。

453 472 

454<h3 id="link-in-the-desktop-app">473<h3 id="link-in-the-desktop-app">

455 Desktop アプリでの `Link`474 Desktop アプリと VS Code での `Link`

456</h3>475</h3>

457 476 

458Desktop アプリでは、`Link` の `href` が次の要件を満たさない限り、プレーンテキストとして描画されます。477Desktop アプリと VS Code 拡張機能では、`Link` の `href` が次の要件を満たさない限り、プレーンテキストとして描画されます。

459 478 

460* **スキームとホスト**: `https:` URL、または `http://localhost:3000` のような `http://localhost` URL479* **スキームとホスト**: `https:` URL、または `http://localhost:3000` のような `http://localhost` URL

461* **`@` を含まない**: パスやクエリ内の `@` は `%40` と記述します480* **`@` を含まない**: パスやクエリ内の `@` は `%40` と記述します


477 496 

478ターミナルでヒートマップ、スパークライン、ゲームボードを描画する場合は、セルごとに `Box` を使うのではなく、`Raster` を 1 つ描画します。`Raster` は `key`、`columns` と `rows` によるサイズ、そしてすべてのセルをパックした base64 文字列である `cells` を受け取ります。各セルは 3 つの数値、つまり文字のコードポイント、文字色、背景色で構成されます。色は 16 進数の 24 ビット RGB 値で、たとえば赤なら `0xc62828` です。その範囲より 1 大きい値 `0x01000000` は、ターミナルのデフォルトを意味します。497ターミナルでヒートマップ、スパークライン、ゲームボードを描画する場合は、セルごとに `Box` を使うのではなく、`Raster` を 1 つ描画します。`Raster` は `key`、`columns` と `rows` によるサイズ、そしてすべてのセルをパックした base64 文字列である `cells` を受け取ります。各セルは 3 つの数値、つまり文字のコードポイント、文字色、背景色で構成されます。色は 16 進数の 24 ビット RGB 値で、たとえば赤なら `0xc62828` です。その範囲より 1 大きい値 `0x01000000` は、ターミナルのデフォルトを意味します。

479 498 

480Desktop アプリには `Raster` がないため、`e.surface` を確認して、そこではテキストを描画します。次のペイン本体は 3×2 のヒートマップを描画します。499ターミナル以外のアプリには `Raster` がないため、`e.surface` を確認して、そこではテキストを描画します。次のペイン本体は 3×2 のヒートマップを描画します。

481 500 

482```javascript theme={null}501```javascript theme={null}

483// The value that means "use the terminal's default color"502// The value that means "use the terminal's default color"


535 554 

536mod 自身がキーボードを読み取ることはありません。ユーザーがキーを押すと、Claude Code がそのキーをどのコントロール宛てかを判断し、そのコントロールのコールバックが実行されます。[バンド上の数字ホットキー](/docs/ja/plugins/mods/reference#elements)を除き、これはペインまたはバンドがキーボードフォーカスを持っている間にのみ発生します。それ以外のときは、キーはプロンプトに送られます。555mod 自身がキーボードを読み取ることはありません。ユーザーがキーを押すと、Claude Code がそのキーをどのコントロール宛てかを判断し、そのコントロールのコールバックが実行されます。[バンド上の数字ホットキー](/docs/ja/plugins/mods/reference#elements)を除き、これはペインまたはバンドがキーボードフォーカスを持っている間にのみ発生します。それ以外のときは、キーはプロンプトに送られます。

537 556 

557[VS Code 拡張機能](#draw-in-the-vs-code-extension)では、ボタンにホットキーはありません。ユーザーはボタンをクリックするか、ボタン上で Enter を押し、フィールドには直接入力します。

558 

538<h4 id="how-a-pane-gets-keyboard-focus">559<h4 id="how-a-pane-gets-keyboard-focus">

539 ペインがキーボードフォーカスを得る方法560 ペインがキーボードフォーカスを得る方法

540</h4>561</h4>


570 ホットキーと最初のフォーカスを設定する591 ホットキーと最初のフォーカスを設定する

571</h4>592</h4>

572 593 

573コントロールの次の props によって、キーボードがそのコントロールにどのように届くかが決まります。

574 

575* **`hotkey`**: ユーザーが 1 つのキーで `Button` を押せるようにするには、`hotkey: 'a'` のように、1 桁の数字または 1 文字の小文字を `hotkey` に指定します594* **`hotkey`**: ユーザーが 1 つのキーで `Button` を押せるようにするには、`hotkey: 'a'` のように、1 桁の数字または 1 文字の小文字を `hotkey` に指定します

576* **`autoFocus`**: ペインを開いたときにどのコントロールがフォーカスを持つかを選ぶには、そのコントロールに `autoFocus: true` を追加します。この props は `true` のみを受け付けるため、ほかのコントロールでは省略してください。595* **`autoFocus`**: ペインを開いたときにどのコントロールがフォーカスを持つかを選ぶには、そのコントロールに `autoFocus: true` を追加します。[VS Code 拡張機能](#draw-in-the-vs-code-extension)では `autoFocus` は何もしません。コントロールはこの props を省略した場合と同じように描画されるため、何も変更する必要はありません。この props は `true` のみを受け付けるため、ほかのコントロールでは省略してください。

577 596 

578ホットキーの表示方法は、ボタンとアプリによって異なります。597ホットキーの表示方法は、ボタンとアプリによって異なります。

579 598 

580| ボタン | ターミナル | Desktop アプリ |599| ボタン | ターミナル | Desktop アプリ | VS Code 拡張機能 |

581| :- | :- | :- |600| :- | :- | :- | :- |

582| 角括弧付き(デフォルト) | `[ Add one ]`、ホットキーは表示されない | ラベルの横に小さなキーが表示される |601| 角括弧付き(デフォルト) | `[ Add one ]`、ホットキーは表示されない | ラベルの横に小さなキーが表示される | ラベルが表示され、ホットキーは機能しない |

583| `plain: true` の場合 | `1: One` | ラベルの横に小さなキーが表示される |602| `plain: true` の場合 | `1: One` | ラベルの横に小さなキーが表示される | ラベルが表示され、ホットキーは機能しない |

584 603 

585ターミナルでは、ユーザーが押すべきキーがわかるように、角括弧付きボタンのラベルでキーを示すか、`plain: true` を使用してください。`Button` のその他のルール(`action`、バンド上の数字ホットキー、1 つのホットキーに 2 つのボタンを割り当てる場合)については、[要素リファレンス](/docs/ja/plugins/mods/reference#elements)を参照してください。604ターミナルでは、ユーザーが押すべきキーがわかるように、角括弧付きボタンのラベルでキーを示すか、`plain: true` を使用してください。`Button` のその他のルール(`action`、バンド上の数字ホットキー、1 つのホットキーに 2 つのボタンを割り当てる場合)については、[要素リファレンス](/docs/ja/plugins/mods/reference#elements)を参照してください。

586 605 

Details

24* **コマンドで独自のコードを実行する**: Claude ターンなしで、Claude が作業中でも、すぐに関数を実行する `/command`。[コマンドまたはツールを追加する](/docs/ja/plugins/mods/api#add-a-command-or-a-tool) を参照してください。24* **コマンドで独自のコードを実行する**: Claude ターンなしで、Claude が作業中でも、すぐに関数を実行する `/command`。[コマンドまたはツールを追加する](/docs/ja/plugins/mods/api#add-a-command-or-a-tool) を参照してください。

25* **hooks 間でデータを共有する**: mod の hooks はそのファイル内の変数を共有するため、1 つの hook が記録したものを別の hook が表示できます。たとえば、1 つの hook がツール呼び出しをカウントしながら別の hook がスピナーの横にカウントを表示したり、1 つが各リクエストのトークン使用量を読み取りながら別がペインでチャートしたりできます。[イベントに反応する](/docs/ja/plugins/mods/events) を参照してください。25* **hooks 間でデータを共有する**: mod の hooks はそのファイル内の変数を共有するため、1 つの hook が記録したものを別の hook が表示できます。たとえば、1 つの hook がツール呼び出しをカウントしながら別の hook がスピナーの横にカウントを表示したり、1 つが各リクエストのトークン使用量を読み取りながら別がペインでチャートしたりできます。[イベントに反応する](/docs/ja/plugins/mods/events) を参照してください。

26 26 

27Mod は Claude Code CLI と Claude Desktop アプリの Code タブで動作します。VS Code 拡張機能、`claude -p`、クラウドセッションなど、他の場所での動作を理解するには、[mod が実行される場所](#where-mods-run) を参照してください。settings hook、skill、または MCP サーバーが既に必要なことを実行している場合は、mod を作成する前に [それらを比較してください](#compare-mods-settings-hooks-skills-and-mcp-servers)。組織の mod を管理するには、[組織の mod を管理する](/docs/ja/plugins/mods/admin) を参照してください。27mod は Claude Code CLI、Claude Desktop アプリの Code タブ、VS Code 拡張機能で動作します。`claude -p` やクラウドセッションなど、他の場所での動作については、[mod が実行される場所](#where-mods-run) を参照してください。設定フック、スキル、または MCP サーバーが既に必要なことを実行している場合は、mod を作成する前に [それらを比較してください](#compare-mods-settings-hooks-skills-and-mcp-servers)。組織の mod を管理するには、[組織の mod を管理する](/docs/ja/plugins/mods/admin) を参照してください。

28 28 

29<h2 id="get-a-mod">29<h2 id="get-a-mod">

30 mod を取得する30 mod を取得する


212 mod が実行される場所212 mod が実行される場所

213</h3>213</h3>

214 214 

215Mod のフックは、モデルを提供するプロバイダーが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のいずれであっても、プラグインをロードするあらゆる種類のセッションで実行されます。描画の範囲はより狭く、mod のペイン、バンド、置き換えられた行を表示するのはターミナルと Desktop アプリのみです。この表は、Claude Code を実行する可能性のある各場所を示しています。215Mod のフックは、モデルを提供するプロバイダーが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のいずれであっても、プラグインをロードするあらゆる種類のセッションで実行されます。描画の範囲はより狭く、mod が描画したものが表示されるのはターミナル、Desktop アプリ、VS Code 拡張機能です。この表は、Claude Code を実行する可能性のある各場所を示しています。

216 216 

217| Claude Code を実行する場所 | フックが実行される | mod の描画が表示される |217| Claude Code を実行する場所 | フックが実行される | mod の描画が表示される |

218| :- | :- | :- |218| :- | :- | :- |

219| ターミナルの `claude`。エディタの統合ターミナルと JetBrains プラグインを含む | はい | はい |219| ターミナルの `claude`。エディタの統合ターミナルと JetBrains プラグインを含む | はい | はい |

220| Desktop アプリの Code タブ。WSL セッションを除く | はい | はい。[elements テーブル](/docs/ja/plugins/mods/reference#elements) がターミナルのみとしてマークしている要素を除く |220| Desktop アプリの Code タブ。WSL セッションを除く | はい | はい。[elements テーブル](/docs/ja/plugins/mods/reference#elements) がターミナルのみとしてマークしている要素を除く |

221| Desktop アプリの [WSL セッション](/docs/ja/desktop-wsl) | いいえ。WSL セッションではプラグインが利用できないため | いいえ |221| Desktop アプリの [WSL セッション](/docs/ja/desktop-wsl) | いいえ。WSL セッションではプラグインが利用できないため | いいえ |

222| VS Code 拡張機能のチャットパネル | はい | いいえ |222| VS Code 拡張機能のチャットパネル | はい | はい。拡張機能のバージョン 2.1.299 以降で、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching) セッションの場合。パネルが描画するものは [描画箇所](/docs/ja/plugins/mods/reference#render-sites) テーブルと [elements](/docs/ja/plugins/mods/reference#elements) テーブルに示されています。 |

223| `claude -p` と [Agent SDK](/docs/ja/agent-sdk/overview) | はい | いいえ |223| `claude -p` と [Agent SDK](/docs/ja/agent-sdk/overview) | はい | いいえ |

224| claude.ai またはモバイルアプリからの [Remote Control](/docs/ja/remote-control) | はい。マシン上のセッションで | マシン上のターミナルに表示 |224| claude.ai またはモバイルアプリからの [Remote Control](/docs/ja/remote-control) | はい。マシン上のセッションで | マシン上のターミナルに表示 |

225| [クラウドセッション](/docs/ja/claude-code-on-the-web) | はい。[クラウドセッションに引き継がれる](/docs/ja/cloud-environments#what-carries-over-from-your-setup) プラグインの場合 | いいえ |225| [クラウドセッション](/docs/ja/claude-code-on-the-web) | はい。[クラウドセッションに引き継がれる](/docs/ja/cloud-environments#what-carries-over-from-your-setup) プラグインの場合 | いいえ |

Details

6 6 

7> Claude Code の mod の完全なリファレンス:フックモジュールの構成、イベント、mods API メソッド、描画箇所、サーフェス別の要素、制限、設定。7> Claude Code の mod の完全なリファレンス:フックモジュールの構成、イベント、mods API メソッド、描画箇所、サーフェス別の要素、制限、設定。

8 8 

9v2.1.290 時点の Claude Code CLI と Desktop アプリについて、[mod](/docs/ja/plugins/mods/overview) が処理できるイベント、呼び出せる mods API メソッド、描画できる描画箇所を調べられます。各項目には名前と 1 行の説明があり、解説しているガイドのセクションがある場合はそこへのリンクも記載しています。9[mod](/docs/ja/plugins/mods/overview) が処理できるイベント、呼び出せる mods API メソッド、描画できる描画箇所を調べられます。各項目は v2.1.290 時点の Claude Code CLI と Desktop アプリ、および v2.1.299 時点の VS Code 拡張機能を対象としています。各項目には名前と 1 行の説明があり、解説しているガイドのセクションがある場合はそこへのリンクも記載しています。

10 10 

11<Note>11<Note>

12 完全なリファレンスは Claude Code の [mod 用 TypeScript 宣言](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts)で、すべてのイベント、メソッド、要素が例とともに記述されています。GitHub 上のコピーは、インストールしている Claude Code のバージョンより古い場合があります。両者が食い違う場合は、[Claude Code がお使いのバージョン用に書き出すコピー](/docs/ja/plugins/mods/create#get-the-types-for-your-build)を信頼してください。12 完全なリファレンスは Claude Code の [mod 用 TypeScript 宣言](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts)で、すべてのイベント、メソッド、要素が例とともに記述されています。GitHub 上のコピーは、インストールしている Claude Code のバージョンより古い場合があります。両者が食い違う場合は、[Claude Code がお使いのバージョン用に書き出すコピー](/docs/ja/plugins/mods/create#get-the-types-for-your-build)を信頼してください。


255 描画箇所255 描画箇所

256</h2>256</h2>

257 257 

258描画箇所は、Claude Code のインターフェースにおける拡張ポイントです。各行は `ui.render` フックにおける `e.component` の値で、`e.props` のフィールドと、それを描画するアプリを示しています。`e.surface` は `terminal` または `desktop` です。各描画箇所でフックができることは、[Claude Code がすでに描画しているものを変更する](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws)で、選択肢ごとの例とともに説明しています。258描画箇所は、Claude Code のインターフェースにおける拡張ポイントです。各行は `ui.render` フックにおける `e.component` の値で、`e.props` のフィールドと、それを描画するアプリを示しています。`e.surface` は描画しているアプリの名前で、`terminal`、`desktop`、`vscode` などです。各描画箇所でフックができることは、[Claude Code がすでに描画しているものを変更する](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws)で、選択肢ごとの例とともに説明しています。

259 

260VS Code 拡張機能での描画には、拡張機能のバージョン 2.1.299 以降と、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションが必要です。拡張機能で描画が異なる点については、[VS Code 拡張機能で描画する](/docs/ja/plugins/mods/interface#draw-in-the-vs-code-extension)に一覧があります。

259 261 

260| 描画箇所 | `e.props` | `e.requestId` | 描画されるアプリ |262| 描画箇所 | `e.props` | `e.requestId` | 描画されるアプリ |

261| :- | :- | :- | :- |263| :- | :- | :- | :- |

262| [`Pane`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `title`、`isFocused`、`bodyColumns`、`placement`、`scroll`、`view` | ペインの `id` | Terminal、Desktop |264| [`Pane`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `title`、`isFocused`、`bodyColumns`、`placement`、`scroll`、`view` | ペインの `id` | Terminal、Desktop、VS Code |

263| [`AbovePrompt`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`、`isWorking`、`maxRows`、`bodyColumns`、`scroll`、`view` | 1 つのインスタンス | Terminal、Desktop |265| [`AbovePrompt`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`、`isWorking`、`maxRows`、`bodyColumns`、`scroll`、`view` | 1 つのインスタンス | Terminal、Desktop |

264| `UserMessage` | `text`、`origin`、`isExpanded`、および origin に応じて `task` または `from` | メッセージ ID | Terminal、Desktop |266| `UserMessage` | `text`、`origin`、`isExpanded`、および origin に応じて `task` または `from` | メッセージ ID | Terminal、Desktop、VS Code |

265| `AssistantMessage` | 返信のテキスト | メッセージ ID | Terminal、Desktop |267| `AssistantMessage` | 返信のテキスト | メッセージ ID | Terminal、Desktop、VS Code |

266| `ToolUse`、`ToolResult`、`ToolGroup` | ツールの名前、入力、結果 | ツール呼び出し ID | Terminal、Desktop |268| `ToolUse`、`ToolResult`、`ToolGroup` | ツールの名前、入力、結果 | ツール呼び出し ID | Terminal、Desktop、VS Code |

267| `CommandOutput` | `command`、`text` | メッセージ ID | Terminal、Desktop |269| `CommandOutput` | `command`、`text` | メッセージ ID | Terminal、Desktop |

268| [`AskUserQuestion`](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) | 質問と選択肢 | ツール呼び出し ID | Terminal、Desktop |270| [`AskUserQuestion`](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) | 質問と選択肢 | ツール呼び出し ID | Terminal、Desktop、VS Code |

269| `ToolProgress` | `kind` | ツール呼び出し ID | Terminal |271| `ToolProgress` | `kind` | ツール呼び出し ID | Terminal |

270| [`Spinner`](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) | `word`、`message`、`suffix`、`mode` | エージェント ID | Terminal、Desktop |272| [`Spinner`](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) | `word`、`message`、`suffix`、`mode` | エージェント ID | Terminal、Desktop、VS Code |

271| `TurnDuration` | `word`、`durationMs` | メッセージ ID | Terminal |273| `TurnDuration` | `word`、`durationMs` | メッセージ ID | Terminal |

272| `InfoNotice` | `text`、`command` | メッセージ ID | Terminal |274| `InfoNotice` | `text`、`command` | メッセージ ID | Terminal |

273| `SessionMode` | `modes` | 1 つのインスタンス | Terminal、Desktop |275| `SessionMode` | `modes` | 1 つのインスタンス | Terminal、Desktop |

274| `PromptHint` | `isDraft`、`isWorking`、`hint` | 1 つのインスタンス | Terminal、Desktop |276| `PromptHint` | `isDraft`、`isWorking`、`hint` | 1 つのインスタンス | Terminal、Desktop |

275 277 

276`e.viewport` には `columns`、`rows`、`isFullscreen` が入っています。アプリがウィンドウを計測するまでは存在しません。その `rows` はウィンドウ全体の高さであり、ペインの高さではありません。278`e.viewport` には `columns`、`rows`、`isFullscreen` が入っています。ターミナルと Desktop アプリでは、アプリがウィンドウを計測するまでは存在しません。また、これらのアプリでは、その `rows` はウィンドウ全体の高さであり、ペインの高さではありません。VS Code 拡張機能では常に存在します。

277 279 

278ツリーを描画箇所に合わせるには、フック内で次の props を読み取ります。280ツリーを描画箇所に合わせるには、フック内で次の props を読み取ります。

279 281 


289 291 

290要素は `ui.render` フックが返すツリーの構成要素で、`$.ui.resolve(e)` から取得します。[要素からツリーを構築する](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)ではよく使う要素をターミナルでの描画例とともに紹介しており、[インターフェースギャラリー](/docs/ja/plugins/mods/gallery)にはほとんどの要素のスクリーンショットがあります。チェックマークは、そのアプリが要素を描画できることを示します。292要素は `ui.render` フックが返すツリーの構成要素で、`$.ui.resolve(e)` から取得します。[要素からツリーを構築する](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)ではよく使う要素をターミナルでの描画例とともに紹介しており、[インターフェースギャラリー](/docs/ja/plugins/mods/gallery)にはほとんどの要素のスクリーンショットがあります。チェックマークは、そのアプリが要素を描画できることを示します。

291 293 

292| 要素 | 主な props | Terminal | Desktop |294| 要素 | 主な props | Terminal | Desktop | VS Code |

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

294| [`Box`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `key`、flex レイアウト、`gap`、`padding`、`margin`、`width`、`height`、[`borderStyle`](#box-border-styles)、`backgroundColor`、`position`、`hover` | ✓ | ✓ |296| [`Box`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `key`、flex レイアウト、`gap`、`padding`、`margin`、`width`、`height`、[`borderStyle`](#box-border-styles)、`backgroundColor`、`position`、`hover` | ✓ | ✓ | ✓ |

295| [`Text`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `color`、`backgroundColor`、`bold`、`italic`、`underline`、`dimColor`、`inverse`、`wrap` | ✓ | ✓ |297| [`Text`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `color`、`backgroundColor`、`bold`、`italic`、`underline`、`dimColor`、`inverse`、`wrap` | ✓ | ✓ | ✓ |

296| [`Button`](/docs/ja/plugins/mods/interface#respond-to-presses-and-typing) | `key`、`label`、`onPress`、`hotkey`、`plain`、`dimColor`、`autoFocus`、`action` | ✓ | ✓ |298| [`Button`](/docs/ja/plugins/mods/interface#respond-to-presses-and-typing) | `key`、`label`、`onPress`、`hotkey`、`plain`、`dimColor`、`autoFocus`、`action` | ✓ | ✓ | ✓ |

297| [`Link`](/docs/ja/plugins/mods/interface#link-in-the-desktop-app) | `href`、`label`。[制限](#limits)を参照してください。 | ✓ | ✓ |299| [`Link`](/docs/ja/plugins/mods/interface#link-in-the-desktop-app) | `href`、`label`。[制限](#limits)を参照してください。 | ✓ | ✓ | ✓ |

298| [`Code`](/docs/ja/plugins/mods/gallery#show-code-and-changes) | `source`、`language`、`path`、`startLine`、`format`、`wrap` | ✓ | ✓ |300| [`Code`](/docs/ja/plugins/mods/gallery#show-code-and-changes) | `source`、`language`、`path`、`startLine`、`format`、`wrap` | ✓ | ✓ | ✓ |

299| `Markdown` | `text`、`key`、`dimColor`、`onLinkPress`、`pressableLinks` | ✓ | ✓ |301| `Markdown` | `text`、`key`、`dimColor`、`onLinkPress`、`pressableLinks` | ✓ | ✓ | ✓ |

300| [`Input`](/docs/ja/plugins/mods/interface#take-typed-input-and-draw-a-row-for-each-item) | `key`、`label`、`placeholder`、`value`、`submitLabel`、`onSubmit`、`onInput`、`autoFocus` | ✓ | ✓ |302| [`Input`](/docs/ja/plugins/mods/interface#take-typed-input-and-draw-a-row-for-each-item) | `key`、`label`、`placeholder`、`value`、`submitLabel`、`onSubmit`、`onInput`、`autoFocus` | ✓ | ✓ | ✓ |

301| `Select` | `key`、`label`、`options`、`value`、`onSelect`、`autoFocus` | ✓ | ✓ |303| `Select` | `key`、`label`、`options`、`value`、`onSelect`、`autoFocus` | ✓ | ✓ | ✓ |

302| `Svg` | SVG ドキュメント(最大 131,072 文字) | | ✓ |304| `Svg` | SVG ドキュメント(最大 131,072 文字) | | ✓ | ✓ |

303| [`Client`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `module`、`key` | ✓ | ✓ |305| [`Client`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `module`、`key` | ✓ | ✓ | |

304| [`Raster`](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`、`columns`(最大 512)、`rows`(最大 256)、`cells`。[色付きセルのグリッドを描画する](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells)を参照してください。 | ✓ | |306| [`Raster`](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`、`columns`(最大 512)、`rows`(最大 256)、`cells`。[色付きセルのグリッドを描画する](/docs/ja/plugins/mods/interface#draw-a-grid-of-colored-cells)を参照してください。 | ✓ | | |

305| `Image` | 最大 2 MiB の PNG または RGBA バイト、またはファイルパス、`columns` と `rows`(いずれも最大 255)、`alt` テキスト。 | ✓ | |307| `Image` | 最大 2 MiB の PNG または RGBA バイト、またはファイルパス、`columns` と `rows`(いずれも最大 255)、`alt` テキスト。 | ✓ | | |

306 308 

307`Button` のその他のルール:`action` は Claude Code 独自の[キーボードショートカットのアクション](/docs/ja/keybindings)の 1 つを指定し、そのアクションに対するユーザーの割り当てがコードまたは修飾キー付きのキーである場合、その割り当てでボタンが押されます。バンド内のボタンに数字の `hotkey` を指定すると、ユーザーが空のプロンプトにその数字だけを入力して手を止めたときにも発火します。1 つの描画内で 2 つのボタンが同じ `hotkey` を指定した場合は、後のボタンが優先されます。`autoFocus` はどのコントロールでも `true` しか受け付けないため、オフにするには props を省略してください。309`Button` のその他のルール:`action` は Claude Code 独自の[キーボードショートカットのアクション](/docs/ja/keybindings)の 1 つを指定し、そのアクションに対するユーザーの割り当てがコードまたは修飾キー付きのキーである場合、その割り当てでボタンが押されます。バンド内のボタンに数字の `hotkey` を指定すると、ユーザーが空のプロンプトにその数字だけを入力して手を止めたときにも発火します。1 つの描画内で 2 つのボタンが同じ `hotkey` を指定した場合は、後のボタンが優先されます。`autoFocus` はどのコントロールでも `true` しか受け付けないため、オフにするには props を省略してください。

308 310 

311VS Code 拡張機能は一部の要素の props を無視し、それらを省略した場合と同じように要素を描画します。

312 

313* **`Box`**:`position` と `hover`

314* **`Button`**:`hotkey`、`plain`、`autoFocus`、`action`。そのため VS Code では、ユーザーはクリックするか、ボタンにフォーカスがある状態で Enter キーを押してボタンを押します

315* **`Code`**:`language`、`path`、`startLine`、`format`、`wrap`。そのため、コードは色や行番号なしで描画され、`format: 'diff'` のブロックは差分の生のテキストを表示します

316* **`Input` と `Select`**:`autoFocus`

317 

309<h3 id="box-border-styles">318<h3 id="box-border-styles">

310 `Box` の枠線スタイル319 `Box` の枠線スタイル

311</h3>320</h3>

Details

289 ホットキーが何もしない289 ホットキーが何もしない

290</h3>290</h3>

291 291 

292ペインにキーボードフォーカスがありません。292ペインにキーボードフォーカスがないか、描画が VS Code 拡張機能内にあり、そこではボタンにホットキーがありません。該当するほうを実行してください。

293 293 

294Ctrl+X を押してから Tab を押すか、ペインをクリックします。`focus: true` を使用してコマンドから開きます。294* **キーボードフォーカスがない**: Ctrl+X を押してから Tab を押すか、ペインをクリックします。ペインが開いたときにフォーカスを取得するようにするには、コマンドから `focus: true` を指定して開きます。

295* **VS Code 拡張機能内の場合**: ボタンをクリックするか、ボタンにフォーカスがある状態で Enter を押します

295 296 

296<h3 id="a-drawing-works-in-the-terminal-and-not-in-the-desktop-app">297<h3 id="a-drawing-works-in-the-terminal-and-not-in-the-desktop-app-or-vs-code">

297 描画がターミナルで機能し、Desktop アプリでは機能しない298 描画がターミナルで機能し、Desktop アプリや VS Code では機能しない

298</h3>299</h3>

299 300 

300描画箇所または要素はそこで利用できません。301そのアプリが描画箇所または要素を描画しないか、VS Code 拡張機能が mod に対して何も描画しないセッションです。mod の他のフックは引き続き実行されます。以下の原因を確認してください。

301 302 

302[描画箇所](/docs/ja/plugins/mods/reference#render-sites) と [要素](/docs/ja/plugins/mods/reference#elements) の表を確認してください。303* **描画箇所または要素がそのアプリで描画されない**: [描画箇所](/docs/ja/plugins/mods/reference#render-sites) の表で描画箇所を、[要素](/docs/ja/plugins/mods/reference#elements) の表で要素を調べます。アプリにない要素については、フック内で `e.surface` を確認し、アプリが描画できるツリーを返します。

304* **VS Code 拡張機能が 2.1.299 より古い**: チャットパネルは [拡張機能のバージョン](/docs/ja/vs-code#install-the-extension) 2.1.299 から mod の描画を行います。VS Code の拡張機能ビューでバージョンを確認し、そこで拡張機能を更新してください。

305* **VS Code セッションがフィーチャーフラグを取得しない**: チャットパネルでの描画にはフィーチャーフラグの取得が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry 上のセッション、または [Claude apps gateway](/docs/ja/claude-apps-gateway) を経由するセッションは、[フィーチャーフラグの取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching) に記載されているその他のセッションと同様に、これをスキップします。そのようなセッションで描画を確認するには、代わりに VS Code の統合ターミナルなどのターミナルで `claude` を実行してください。

303 306 

304<h2 id="an-edit-or-a-value-is-lost">307<h2 id="an-edit-or-a-value-is-lost">

305 編集または値が失われる308 編集または値が失われる

Details

72 | `-d`, `--debug[=<filter>]` | サーバーのデバッグログをオンにします。オプションでカテゴリでフィルタリングできます。フィルタは `=` 形式でのみ渡します(例:`--debug=api,hooks`)。Claude Code v2.1.282 以降が必要です。 |72 | `-d`, `--debug[=<filter>]` | サーバーのデバッグログをオンにします。オプションでカテゴリでフィルタリングできます。フィルタは `=` 形式でのみ渡します(例:`--debug=api,hooks`)。Claude Code v2.1.282 以降が必要です。 |

73 | `--debug-file <path>` | デバッグログを指定されたファイルに書き込みます。 |73 | `--debug-file <path>` | デバッグログを指定されたファイルに書き込みます。 |

74 | `--verbose` | 詳細な接続とセッションログを表示します。 |74 | `--verbose` | 詳細な接続とセッションログを表示します。 |

75 | `--sandbox`, `--no-sandbox` | v2.1.300 で削除されました。どちらかのフラグを渡すと、サーバーは起動せずに[エラーで終了](/docs/ja/errors#sandbox-is-not-supported-by-claude-remote-control)します。 |

75 76 

76 `remote-control` の前にグローバル `claude` フラグを渡すか、ラッパースクリプトが 1 つを追加する場合、Claude Code はそのフラグをサーバーが作成するセッションに引き継ぎません。Claude Code は `--verbose` や `--model` など、そのフラグを削除しても何が起こるかが変わらないことが既知の場合にのみフラグを通します。他のフラグ(`--settings` など)の場合、Claude Code は [起動を拒否](/docs/ja/errors#not-carried-over-to-the-sessions-remote-control-starts)し、削除するフラグを名前で指定します。77 `remote-control` の前にグローバル `claude` フラグを渡すか、ラッパースクリプトが 1 つを追加する場合、Claude Code はそのフラグをサーバーが作成するセッションに引き継ぎません。Claude Code は `--verbose` や `--model` など、そのフラグを削除しても何が起こるかが変わらないことが既知の場合にのみフラグを通します。他のフラグ(`--settings` など)の場合、Claude Code は [起動を拒否](/docs/ja/errors#not-carried-over-to-the-sessions-remote-control-starts)し、削除するフラグを名前で指定します。

77 78 

routines.md +2 −2

Details

398 398 

399各ルーチンは、ネットワークアクセス、環境変数、およびセットアップスクリプトを制御する [クラウド環境](/docs/ja/cloud-environments)を使用します。ルーチンはすべての実行でその環境のネットワークポリシーを継承します。399各ルーチンは、ネットワークアクセス、環境変数、およびセットアップスクリプトを制御する [クラウド環境](/docs/ja/cloud-environments)を使用します。ルーチンはすべての実行でその環境のネットワークポリシーを継承します。

400 400 

401**Default** 環境は **Trusted** ネットワークアクセスを使用します。これにより、セッションのネットワークを通じて [デフォルト許可リスト](/docs/ja/cloud-environments#default-allowed-domains)のみが許可されます。そのパスの外のホストへのリクエストは `403` と `x-deny-reason: host_not_allowed` で失敗します。MCP コネクタトラフィックは Anthropic のサーバーを通じてルーティングされるため、ルーチンに追加するコネクタは **Allowed domains** にホストを追加しなくても機能します。[コネクタ](#connectors)の下で不要なコネクタを削除します。401**Default** 環境は **Trusted** ネットワークアクセスを使用します。これにより、セッションのネットワークを通じて [デフォルト許可リスト](/docs/ja/cloud-environments#default-allowed-domains)のみが許可されます。そのパス上で許可リスト外のホストへのリクエストは `403` と `x-deny-reason: host_not_allowed` で失敗します。MCP コネクタトラフィックはそのパスではなく Anthropic のサーバーを通じてルーティングされるため、ルーチンに追加するコネクタは **Allowed domains** にホストを追加しなくても機能します。[コネクタ](#connectors)の下で不要なコネクタを削除します。

402 402 

4031 つ以上の独自の環境で追加のドメインを許可するには、以下の手順に従います。[組織共有環境](/docs/ja/cloud-environments#organization-shared-environments)はここで読み取り専用で開くため、所有者は [管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページからそのネットワークアクセスを変更します。403独自の環境のいずれかで追加のドメインを許可するには、以下の手順に従います。[組織共有環境](/docs/ja/cloud-environments#organization-shared-environments)はここで読み取り専用で開くため、オーナーは [管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページからそのネットワークアクセスを変更します。

404 404 

405<Steps>405<Steps>

406 <Step title="ルーチンを編集用に開く">406 <Step title="ルーチンを編集用に開く">

skills.md +8 −2

Details

720 720 

7211 つのメッセージの先頭に複数のスキルをスタックすることもできます。`/write-tests /fix-issue 123` と入力すると、両方のスキルが読み込まれ、末尾のテキスト `123` が `$ARGUMENTS` として各スキルに渡されます。7211 つのメッセージの先頭に複数のスキルをスタックすることもできます。`/write-tests /fix-issue 123` と入力すると、両方のスキルが読み込まれ、末尾のテキスト `123` が `$ARGUMENTS` として各スキルに渡されます。

722 722 

723Claude Code は最初のスキルと、その後にスタックされた最大 5 つのスキルを展開します。展開は、インラインユーザー呼び出し可能スキルではない最初のトークンで停止するため、[フォークされたサブエージェント](#run-skills-in-a-subagent) として実行されるスキル([`/code-review`](/docs/ja/code-review#review-a-diff-locally) など)、またはその引数自体がスラッシュコマンドで始まる可能性があるスキル(`/loop` など)も、そこで実行を終了します。そのトークンとその後のすべてが、展開されたすべてのスキルの引数テキストになります。v2.1.218 から `/code-review` はフォークされたサブエージェントとして実行されます。以前のバージョンではインラインで実行され、スタックされました。723Claude Code は最初のスキルと、その後にスタックされた最大 5 つのスキルを展開します。展開は、インラインのユーザー呼び出し可能スキルではない最初のトークンで停止するため、[フォークされたサブエージェント](#run-skills-in-a-subagent) として実行されるスキル([`/code-review`](/docs/ja/code-review-local) など)、またはその引数自体がスラッシュコマンドで始まる可能性があるスキル(`/loop` など)も、そこで展開を終了します。そのトークンとその後のすべてが、展開されたすべてのスキルの引数テキストになります。v2.1.218 から `/code-review` はフォークされたサブエージェントとして実行されます。以前のバージョンではインラインで実行され、スタックされました。

724 724 

725位置で個別の引数にアクセスするには、`$ARGUMENTS[N]` または短い `$N` を使用します。725位置で個別の引数にアクセスするには、`$ARGUMENTS[N]` または短い `$N` を使用します。

726 726 


832 832 

833デフォルトの `bash` シェルでは、0 以外で終了することが想定されるその他のコマンドには `|| true` を追加してください。問題を検出したときに 1 で終了するチェックスクリプトがその一例です。833デフォルトの `bash` シェルでは、0 以外で終了することが想定されるその他のコマンドには `|| true` を追加してください。問題を検出したときに 1 で終了するチェックスクリプトがその一例です。

834 834 

835<h4 id="control-characters-in-injected-commands">

836 注入されたコマンド内の制御文字

837</h4>

838 

839`No shell command in <name> was run` は、ファイル内の `!` コマンドのいずれかにタブや改行以外の生の制御文字が含まれているため、どのコマンドも実行されないことを意味します。[その文字を見つけて削除する方法](/docs/ja/errors#no-shell-command-was-run)を参照してください。

840 

835<h4 id="permission-checks-on-injected-commands">841<h4 id="permission-checks-on-injected-commands">

836 注入されたコマンドの権限チェック842 注入されたコマンドの権限チェック

837</h4>843</h4>


865 871 

866バックグラウンドで実行されるフォークは、[バックグラウンドのサブエージェントに適用される、より限定されたツールセット](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)でも実行されます。スキルのサブエージェントは通常のエージェントタイプであるため、会話をフォークするサブエージェント向けの例外は適用されません。スキルの手順がそのセット外のツールに依存する場合は、`background: false` を設定して完全なツールセットを維持してください。872バックグラウンドで実行されるフォークは、[バックグラウンドのサブエージェントに適用される、より限定されたツールセット](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)でも実行されます。スキルのサブエージェントは通常のエージェントタイプであるため、会話をフォークするサブエージェント向けの例外は適用されません。スキルの手順がそのセット外のツールに依存する場合は、`background: false` を設定して完全なツールセットを維持してください。

867 873 

868バックグラウンドで実行されるフォークされたスキルは、セッションの[チェックポイント](/docs/ja/checkpointing)の外で編集を適用するため、`/rewind` ではそれらを元に戻せません。元に戻すには git を使用してください。874バックグラウンドで実行されるフォークされたスキルは、セッションの[チェックポイント](/docs/ja/checkpointing#subagent-edits-not-restored)の外で編集を適用します。その後、`/rewind` で復元されるのは、Claude が会話内ですでに編集していたファイルのみです。スキルによるその他のファイルへの編集は残るため、git を使用して元に戻してください。

869 875 

870<Warning>876<Warning>

871 `context: fork` は、明示的な指示を持つスキルでのみ意味があります。スキルにタスクがなく「これらの API 規約を使用する」のようなガイドラインしか含まれていない場合、サブエージェントはガイドラインを受け取るものの実行可能なプロンプトがないため、意味のある出力を返さずに終了します。877 `context: fork` は、明示的な指示を持つスキルでのみ意味があります。スキルにタスクがなく「これらの API 規約を使用する」のようなガイドラインしか含まれていない場合、サブエージェントはガイドラインを受け取るものの実行可能なプロンプトがないため、意味のある出力を返さずに終了します。

ultrareview.md +1 −1

Details

18* **より広いカバレッジ**: より大規模なレビュアーエージェントのフリートが並行して変更を探索するため、ローカルレビューでは見落とされる可能性のある問題が浮かび上がります18* **より広いカバレッジ**: より大規模なレビュアーエージェントのフリートが並行して変更を探索するため、ローカルレビューでは見落とされる可能性のある問題が浮かび上がります

19* **ローカルリソースの使用なし**: レビューはクラウドサンドボックスで完全に実行されるため、実行中はターミナルが他の作業に使用可能なままです19* **ローカルリソースの使用なし**: レビューはクラウドサンドボックスで完全に実行されるため、実行中はターミナルが他の作業に使用可能なままです

20 20 

21Ultrareview は Anthropic のインフラストラクチャ上でクラウドセッションとして実行されるため、claude.ai アカウントでの認証が必要です。API キーのみでサインインしている場合は、`/login` を実行して claude.ai で認証してください。Ultrareview は Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry で Claude Code を使用する場合は利用できず、Zero Data Retention を有効にしている組織や [HIPAA 設定](/docs/ja/hipaa-setup) が適用されている組織でも利用できません。ultrareview が利用できない場合、`/code-review ultra` はセッション内でローカルレビューを実行します。21Ultrareview は Anthropic のインフラストラクチャ上でクラウドセッションとして実行されるため、claude.ai アカウントでの認証が必要です。API キーのみでサインインしている場合は、`/login` を実行して claude.ai で認証してください。Ultrareview は Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry で Claude Code を使用する場合は利用できず、Zero Data Retention を有効にしている組織や [HIPAA 設定](/docs/ja/hipaa-setup) が適用されている組織でも利用できません。これらの場合、`/code-review ultra` は代わりにセッション内でローカルレビューを実行します。[顧客管理の暗号化キー](https://platform.claude.com/docs/en/manage-claude/cmek)(CMEK)を使用している組織は ultrareview を実行できません。変更をローカルでレビューするには、`/code-review` を実行してください。

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 CLI から ultrareview を実行する24 CLI から ultrareview を実行する

vs-code.md +76 −2

Details

220* `Removed 3 invisible characters from the pasted text` などの通知が貼り付け時に表示される場合、テキストはそれらの文字なしで入力されました。220* `Removed 3 invisible characters from the pasted text` などの通知が貼り付け時に表示される場合、テキストはそれらの文字なしで入力されました。

221* 送信時に削除された文字に関する通知が表示される場合、何も送信されていません。クリーンなテキストはプロンプトボックスに戻ります。表示されたテキストを送信するために再度送信します。221* 送信時に削除された文字に関する通知が表示される場合、何も送信されていません。クリーンなテキストはプロンプトボックスに戻ります。表示されたテキストを送信するために再度送信します。

222 222 

223<h3 id="latex-math-in-responses">

224 応答内の LaTeX 数式

225</h3>

226 

227チャットパネルは、Claude の応答内の LaTeX 数式を組版された数式として表示します。数式のレンダリングには Claude Code v2.1.301 以降が必要です。[ターミナルモード](#switch-to-terminal-mode)では、数式は組版されません。パネルはディスプレイ数式とインライン数式の両方を組版します。

228 

229* **ディスプレイ数式**: 独立した 1 行または複数行に置かれた `$$ … $$` または `\[ … \]` ブロック、および言語に `math` を指定したフェンス付きコードブロック

230* **インライン数式**: 同じ行で開いて閉じる `$…$` または `\(…\)`(例:`$E = mc^2$` や `\(a^2 + b^2 = c^2\)`)

231 

232パネルは数式と同じ文字の他の用途を区別しようとするため、`$HOME`、`$5` のような価格、`sed 's/\(foo\)/\1/'` などのテキストは組版されません。コードスパン内のテキストや、フェンス付き `math` ブロック以外のコードブロック内のテキストも組版されません。組版されるはずの数式が書かれたままで表示される場合は、[A formula shows as raw LaTeX](#a-formula-shows-as-raw-latex) を参照してください。

233 

234組版された数式を含むテキストを選択してコピーすると、描画された記号ではなく、`$…$` または `$$…$$` の区切り文字で囲まれた数式の TeX ソースが得られます。[**Copy response**](#use-the-prompt-box) と `/copy` では、TeX ソースを含め、Claude が書いたとおりの応答が得られます。

235 

223<h3 id="resume-past-conversations">236<h3 id="resume-past-conversations">

224 過去の会話を再開する237 過去の会話を再開する

225</h3>238</h3>

226 239 

227Claude Code パネルの上部にある **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間で参照できます。240Claude Code パネルの上部にある **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間で参照できます。

228 241 

229任意の会話をクリックして、完全なメッセージ履歴で再開します。会話が現在のウィンドウの別のタブで既に開いている場合、クリックするとそのタブに切り替わります。セッションの再開の詳細については、[セッションを管理](/docs/ja/sessions)を参照してください。242任意の会話をクリックして、完全なメッセージ履歴で再開します。会話が現在のウィンドウの別のタブで既に開いている場合、クリックするとそのタブに切り替わります。最初にメッセージが空白のままになる場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。セッションの再開の詳細については、[セッションを管理](/docs/ja/sessions)を参照してください。

230 243 

231* **セッションタイトル**: 新しいセッションは最初のメッセージに基づいて AI が生成したタイトルを受け取ります。244* **セッションタイトル**: 新しいセッションは最初のメッセージに基づいて AI が生成したタイトルを受け取ります。

232* **名前変更とアーカイブ**: セッションにマウスを置いて、これらのアクションを表示します。説明的なタイトルを付けるために名前を変更するか、リストの下部にある **Archived sessions** グループに移動するためにアーカイブします。245* **名前変更とアーカイブ**: セッションにマウスを置いて、これらのアクションを表示します。説明的なタイトルを付けるために名前を変更するか、リストの下部にある **Archived sessions** グループに移動するためにアーカイブします。


321* **エディタタブ**: 会話はそのタブとともに戻ります。334* **エディタタブ**: 会話はそのタブとともに戻ります。

322* **サイドバー**: 過去 10 分以内にメッセージを送信したか Claude が応答した場合、会話は戻ります。戻らない場合は、[セッション履歴](#resume-past-conversations)から会話を再開してください。335* **サイドバー**: 過去 10 分以内にメッセージを送信したか Claude が応答した場合、会話は戻ります。戻らない場合は、[セッション履歴](#resume-past-conversations)から会話を再開してください。

323 336 

324別の Claude Code プロセスがまだその会話を開いている場合は、ここで開く前に確認を求められます。その際には、[セッション履歴から再開する](#resume-past-conversations)ときと同じ **Open here anyway** の通知が表示されます。337別の Claude Code プロセスがまだその会話を開いている場合は、ここで開く前に確認を求められます。その際には、[セッション履歴から再開する](#resume-past-conversations)ときと同じ **Open here anyway** の通知が表示されます。メッセージが最初は空白のままの場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。

325 338 

326リロードが Claude の途中のステップを中断した場合、会話が戻ると Claude はそのステップを続行し、チャット内の通知が継続をマークします。Claude Code v2.1.274 以降が必要です。ステップが 1 時間以上前に中断されたか、セッションが別の場所で開かれている場合、会話はアイドル状態で戻ります。339リロードが Claude の途中のステップを中断した場合、会話が戻ると Claude はそのステップを続行し、チャット内の通知が継続をマークします。Claude Code v2.1.274 以降が必要です。ステップが 1 時間以上前に中断されたか、セッションが別の場所で開かれている場合、会話はアイドル状態で戻ります。

327 340 

328継続をオフにするには、[Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)を開いてチェックを外します。VS Code の環境または [`environmentVariables` 設定](#extension-settings)で [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables) やその他の `CLAUDE_CODE_RESUME_` 変数を設定しても、パネルでは効果がありません。拡張機能がパネルのセッションを開始する前にこれらの変数を削除するためです。341継続をオフにするには、[Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)を開いてチェックを外します。VS Code の環境または [`environmentVariables` 設定](#extension-settings)で [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables) やその他の `CLAUDE_CODE_RESUME_` 変数を設定しても、パネルでは効果がありません。拡張機能がパネルのセッションを開始する前にこれらの変数を削除するためです。

329 342 

343<h4 id="a-conversation-was-not-reopened">

344 会話が再度開かれなかった場合

345</h4>

346 

347リロード後、プロンプトボックスの上に次のような通知がある新しいチャットが表示された場合、その会話を開く処理が直近 2 回とも完了しなかったため、パネルが会話を閉じたままにしたことを意味します。

348 

349```text theme={null}

350“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

351```

352 

353会話の読み込み中にパネルがクラッシュしたり応答しなくなったりした場合、または会話が開いてから約 3 秒以内にウィンドウをリロードしたり閉じたりした場合、開く処理は完了しません。失われるものはありません。会話は変更されず、[セッション履歴](#resume-past-conversations)に残ります。

354 

355* **それでも開くには**: **Open it anyway** をクリックするか、セッション履歴から会話を選択します。会話が開いてパネルが正常に動作し続ける場合、以降のリロード後は通常どおり戻ります。パネルが再び応答しなくなった場合は、ウィンドウをリロードすると通知付きの新しいチャットに戻ります。

356* **閉じたままにするには**: 新しいチャットで作業を続けます。プロンプトを送信すると通知は消えます。

357 

330<h3 id="run-multiple-conversations">358<h3 id="run-multiple-conversations">

331 複数の会話を実行する359 複数の会話を実行する

332</h3>360</h3>


464 492 

465プラグインシステムの詳細については、[プラグイン](/docs/ja/plugins/overview)および[プラグインマーケットプレイス](/docs/ja/plugins/overview)を参照してください。493プラグインシステムの詳細については、[プラグイン](/docs/ja/plugins/overview)および[プラグインマーケットプレイス](/docs/ja/plugins/overview)を参照してください。

466 494 

495<h3 id="plugins-that-draw-in-the-panel">

496 パネルに描画するプラグイン

497</h3>

498 

499[mod](/docs/ja/plugins/mods/overview) を含むプラグインは、チャットパネルに描画できます。描画には、拡張機能バージョン 2.1.299 以降と、[機能フラグを取得する](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションが必要です。このようなプラグインからは、次のものが表示されることがあります。

500 

501* 会話の横またはプロンプトボックスの上に表示されるペイン

502* プロンプトボックスの上に表示されるトーストまたはステータスライン

503* プラグイン独自の方法で描画されたメッセージまたはツール呼び出し

504 

505インストールしたプラグインがパネルに何かを追加または変更すると、次のような表現のラベルでそのプラグインが示されます。

506 

507* **token-chart プラグインから**:プラグインがこれを描画または出力したか、このカードがプラグインからの質問であることを示します

508* **token-chart プラグインによって編集済み**:プラグインが、ツール呼び出しなど Claude Code が描画するものを変更したことを示します

509* **token-chart プラグインからのプロンプト**:プラグインがユーザーに代わってこのメッセージを送信したことを示します

510 

511プラグインによる描画を停止するには、[プラグインダイアログ](#install-plugins)でプラグインをオフにします。

512 

467<h2 id="automate-browser-tasks-with-chrome">513<h2 id="automate-browser-tasks-with-chrome">

468 Chrome でブラウザタスクを自動化する514 Chrome でブラウザタスクを自動化する

469</h2>515</h2>


896 942 

897または、拡張機能を別のキーにリバインドしてください。VS Code の [Keyboard Shortcuts editor](https://code.visualstudio.com/docs/configure/keybindings)(`Cmd+K Cmd+S`)を開き、`Claude Code: Focus input` を検索して、新しいバインディングを割り当ててください。943または、拡張機能を別のキーにリバインドしてください。VS Code の [Keyboard Shortcuts editor](https://code.visualstudio.com/docs/configure/keybindings)(`Cmd+K Cmd+S`)を開き、`Claude Code: Focus input` を検索して、新しいバインディングを割り当ててください。

898 944 

945<h3 id="a-resumed-conversation-is-blank-at-first">

946 再開した会話が最初は空白になる

947</h3>

948 

949[過去の会話を再開](#resume-past-conversations)したとき、または会話が[再読み込み後に復元](#continue-conversations-after-a-reload)されたとき、その会話の Claude Code プロセスが起動するまでメッセージが空白のままになることがあります。約 1 秒後、空白部分に `Waiting for your plugins…` が表示されます。

950 

951操作は不要です。プロセスが起動し、事前にメッセージを確認する必要のあるプラグインがないことが確認されると、メッセージが表示されます。起動に時間がかかる場合は、20 秒後に表示されます。

952 

953<h3 id="the-panel-stops-responding-each-time-a-reload-reopens-a-conversation">

954 再読み込みで会話が再び開かれるたびにパネルが応答しなくなる

955</h3>

956 

957再読み込みして会話が復元されるたびに、パネル全体がクラッシュする、フリーズする、または `Something went wrong` のみが表示される場合は、拡張機能を v2.1.301 以降に更新してください。その後、もう一度ウィンドウを再読み込みするか、VS Code を再起動してください。会話が 2 回連続で開き終わらなかった場合は、その代わりに新しいチャットが表示され、[会話が再び開かれなかった](#a-conversation-was-not-reopened)ことを示す通知が表示されます。

958 

959<h3 id="a-formula-shows-as-raw-latex">

960 数式が LaTeX のまま表示される

961</h3>

962 

963Claude の応答に含まれる数式がまったく組版されない場合は、[数式のレンダリング](#latex-math-in-responses)にはバージョン 2.1.301 以降が必要なため、拡張機能ビューで拡張機能のバージョンを確認してください。バージョンにかかわらず数式を組版しない[ターミナルモード](#switch-to-terminal-mode)を使用している場合は、[Use Terminal 設定](vscode://settings/claudeCode.useTerminal)のチェックを外して、Claude Code がチャットパネルで開くようにしてください。

964 

9651 つの数式だけが記述されたままで、その近くの他の数式は組版されている場合は、次の原因を確認してください。

966 

967* **数式以外のものとして解釈される**:単語として解釈される `$…$` テキストは、`$O(n log n)$` のように記述されたままになります。`$30$` や `$1/N$` のように数字で始まる `$…$` テキストも、`=`、`+`、`^` などの文字で数式であることが示されていない限り、記述されたままになります。代わりに、独立した行に `$$` ブロックを書くよう Claude に依頼してください。パネルはこのチェックを行わずに `$$` ブロックを組版します。

968* **余白がある、長い、または複数行にまたがっている**:ドル記号の内側にスペースがある `$ x^2 $`、60 文字を超える `$…$` の内容、2 行にまたがる `$…$` や `\(…\)` は組版されません。代わりに、独立した行に `$$` ブロックを書くよう Claude に依頼してください。`$$` ブロックにはこれらの制限はありません。

969* **TeX を組版できない**:構文エラーのある数式、`\newcommand` や `\def` などのマクロ定義、エスケープされていない `%` を含む数式は、記述されたまま表示されます。エラーを修正する、マクロを使わない、またはパーセント記号に `\%` を使うように書き直すよう Claude に依頼してください。

970* **大きすぎる**:8,192 文字を超える数式や、ソースよりもはるかに大きく描画される数式は、記述されたまま表示されます。より小さな数式に分割するか、よりコンパクトに書くよう Claude に依頼してください。

971* **大量の数式の後にある**:応答内の 1 つのテキストブロックでは、パネルは上限に達するまで数式を順番に組版します。上限を超える後続の数式は、記述されたまま表示されます。必要な数式を単独でもう一度送るよう Claude に依頼してください。

972 

899<h3 id="claude-code-never-responds">973<h3 id="claude-code-never-responds">

900 Claude Code が応答しない974 Claude Code が応答しない

901</h3>975</h3>

Details

103既にブラウザで GitHub を接続している場合、`/web-setup` は続行すると cloud セッションの接続が置き換わることを警告します。103既にブラウザで GitHub を接続している場合、`/web-setup` は続行すると cloud セッションの接続が置き換わることを警告します。

104 104 

105<Note>105<Note>

106 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な Organization、または [HIPAA 構成](/docs/ja/hipaa-setup) が適用されている Organization は、`/web-setup` または他のクラウドセッション機能を使用できません。GitHub CLI がインストールされていない、または認証されていない場合、Claude Code はブラウザオンボーディングフローを開きます。106 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織、または [HIPAA 構成](/docs/ja/hipaa-setup) が適用されている組織は、`/web-setup` または他のクラウドセッション機能を使用できません。[顧客管理の暗号化キー](https://platform.claude.com/docs/en/manage-claude/cmek)(CMEK)を使用している組織も、クラウドセッションを開始できません。GitHub CLI がインストールされていない、または認証されていない場合、Claude Code はブラウザオンボーディングフローを開きます。

107</Note>107</Note>

108 108 

109<Steps>109<Steps>

Details

74 <p className="digest-wins-title">その他の改善</p>74 <p className="digest-wins-title">その他の改善</p>

75 75 

76 <div className="digest-wins-grid">76 <div className="digest-wins-grid">

77 <div><a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> は独自のコンテキストウィンドウを持つバックグラウンドサブエージェントとして実行されるようになったため、レビュー作業は会話から外れ、完了時に検出結果が到着します</div>77 <div><a href="/docs/ja/code-review-local"><code>/code-review</code></a> は独自のコンテキストウィンドウを持つバックグラウンドサブエージェントとして実行されるようになったため、レビュー作業は会話から外れ、完了時に検出結果が到着します</div>

78 <div><code>/verify</code>、<code>/code-review</code>、<code>/deep-research</code> は呼び出すときのみ実行されます。Claude は自動的に起動しなくなりました</div>78 <div><code>/verify</code>、<code>/code-review</code>、<code>/deep-research</code> は呼び出すときのみ実行されます。Claude は自動的に起動しなくなりました</div>

79 <div><a href="/docs/ja/interactive-mode#emoji-shortcodes">Emoji shortcodes</a> はプロンプト入力で自動補完されます。<code>:heart:</code> を入力して絵文字を挿入するか、<code>:</code> の後に 2 文字以上入力して候補を表示します。<code>emojiCompletionEnabled</code> でオフにできます</div>79 <div><a href="/docs/ja/interactive-mode#emoji-shortcodes">Emoji shortcodes</a> はプロンプト入力で自動補完されます。<code>:heart:</code> を入力して絵文字を挿入するか、<code>:</code> の後に 2 文字以上入力して候補を表示します。<code>emojiCompletionEnabled</code> でオフにできます</div>

80 <div><code>context: fork</code> を持つスキルは <a href="/docs/ja/skills#run-skills-in-a-subagent">バックグラウンドで実行</a>されるようになり、スキルのフロントマターで <code>background: false</code> を設定すると同じターンで結果を待ちます</div>80 <div><code>context: fork</code> を持つスキルは <a href="/docs/ja/skills#run-skills-in-a-subagent">バックグラウンドで実行</a>されるようになり、スキルのフロントマターで <code>background: false</code> を設定すると同じターンで結果を待ちます</div>

81 <div>セッションはデフォルトで最大 20 個のサブエージェントを同時に実行できます。<code>CLAUDE\_CODE\_MAX\_CONCURRENT\_SUBAGENTS</code> で <a href="/docs/ja/sub-agents#concurrent-subagent-limit">制限</a>を変更してください</div>81 <div>セッションはデフォルトで最大 20 個のサブエージェントを同時に実行できます。<code>CLAUDE\_CODE\_MAX\_CONCURRENT\_SUBAGENTS</code> で <a href="/docs/ja/sub-agents#concurrent-subagent-limit">制限</a>を変更してください</div>

82 <div>`--max-budget-usd` はサブエージェントの上限を強制するようになりました。支出がそれに達すると、Claude はこれ以上起動できず、実行中のバックグラウンドサブエージェントは停止します</div>82 <div>`--max-budget-usd` はサブエージェントの上限を強制するようになりました。支出がそれに達すると、Claude はこれ以上起動できず、実行中のバックグラウンドサブエージェントは停止します</div>

83 <div>新しい <a href="/docs/ja/sandboxing#disable-filesystem-isolation"><code>sandbox.filesystem.disabled</code></a> 設定はファイルシステム分離をスキップしながらネットワーク出力制御を維持します</div>83 <div>新しい <a href="/docs/ja/sandboxing#disable-filesystem-isolation"><code>sandbox.filesystem.disabled</code></a> 設定はファイルシステム分離をスキップしながらネットワーク出力制御を維持します</div>

84 <div>自動モードでは、危険な <code>rm</code> コマンド、バックグラウンドジョブ、疑わしい Windows パスのチェックは権限ダイアログを開かなくなります。自動モード分類器が判定します</div>84 <div>auto モードでは、危険な <code>rm</code> コマンド、バックグラウンドジョブ、疑わしい Windows パスのチェックは権限ダイアログを開かなくなります。代わりに auto モード分類器が判定します</div>

85 <div>Bash 権限チェックはより多くのシェル形式で失敗するようになりました。ファイルディスクリプタリダイレクト、Zsh 変数サブスクリプト(<code>\[\[ ]]</code> 比較内)、安全でないオプションを実行できる <code>help</code> と <code>man</code> 呼び出し、10,000 文字を超えるコマンドが含まれます</div>85 <div>Bash 権限チェックはより多くのシェル形式でフェイルクローズ(安全側に拒否)するようになりました。ファイルディスクリプタリダイレクト、Zsh 変数サブスクリプト(<code>\[\[ ]]</code> 比較内)、安全でないオプションを実行できる <code>help</code> と <code>man</code> 呼び出し、10,000 文字を超えるコマンドが含まれます</div>

86 <div><a href="/docs/ja/fast-mode">Fast mode</a> は Opus 4.7 をサポートしなくなりました。<code>/fast</code> は Opus 5 と Opus 4.8 に適用されるようになりました</div>86 <div><a href="/docs/ja/fast-mode">Fast mode</a> は Opus 4.7 をサポートしなくなりました。<code>/fast</code> は Opus 5 と Opus 4.8 に適用されるようになりました</div>

87 <div>長時間実行されるツール呼び出しは沈黙する代わりに定期的な進捗ハートビートを発行します</div>87 <div>長時間実行されるツール呼び出しは沈黙する代わりに定期的な進捗ハートビートを発行します</div>

88 </div>88 </div>

Details

84 <p className="digest-wins-title">その他の改善</p>84 <p className="digest-wins-title">その他の改善</p>

85 85 

86 <div className="digest-wins-grid">86 <div className="digest-wins-grid">

87 <div>VS Code 拡張機能は <a href="/docs/ja/vs-code#extension-settings">Focus ビュー</a> を取得します。これはツールアクティビティを 1 ターンあたり 1 つの展開可能な行の背後に隠します。コマンドメニューから、または <code>Ctrl+Alt+F</code>(Mac では <code>Ctrl+Option+F</code>)で切り替えてください</div>87 <div>VS Code 拡張機能に <a href="/docs/ja/vs-code#extension-settings">Focus ビュー</a> が追加されました。これはツールアクティビティを 1 ターンあたり 1 つの展開可能な行の背後に隠します。コマンドメニューから、または <code>Ctrl+Alt+F</code>(Mac では <code>Ctrl+Option+F</code>)で切り替えてください</div>

88 <div>Sandbox 認証情報ファイルは Linux と WSL2 で <a href="/docs/ja/sandboxing#mask-credential-files"><code>mode: "mask"</code></a> を受け入れるため、サンドボックス化されたコマンドはセンチネルコピーを読み取り、サンドボックスプロキシは出力時に実際の値を置き換えます。認証情報マスキングは <code>extract</code>、JWT 対応 <code>decode</code>、および AWS SigV4 再署名オプションも取得します</div>88 <div>サンドボックスの認証情報ファイルは Linux と WSL2 で <a href="/docs/ja/sandboxing#mask-credential-files"><code>mode: "mask"</code></a> を受け入れるため、サンドボックス化されたコマンドはセンチネルコピーを読み取り、サンドボックスプロキシは送信時に実際の値に置き換えます。認証情報マスキングには <code>extract</code>、JWT 対応の <code>decode</code>、および AWS SigV4 再署名オプションも追加されました</div>

89 <div>マーケットプレイスは新しい <code>archive</code> ソースを使用してプラグインを <a href="/docs/ja/plugins/marketplace-reference#archive-plugin-source">zip アーカイブ</a> として配布でき、HTTPS 経由でダウンロードされ、オプションの SHA-256 ピンが付いているため、インストールは git または npm なしで機能します</div>89 <div>マーケットプレイスは新しい <code>archive</code> ソースを使用してプラグインを <a href="/docs/ja/plugins/marketplace-reference#archive-plugin-source">zip アーカイブ</a> として配布でき、HTTPS 経由でダウンロードされ、オプションの SHA-256 ピンが付いているため、インストールは git または npm なしで機能します</div>

90 <div><code>/review</code> は <a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> のエイリアスになり、努力レベルなしの <code>/code-review</code> は最後に入力したレベルを再利用します</div>90 <div><code>/review</code> は <a href="/docs/ja/code-review-local"><code>/code-review</code></a> のエイリアスになり、effort レベルを指定しない <code>/code-review</code> は最後に入力したレベルを再利用します</div>

91 <div><a href="/docs/ja/agent-view#copy-the-session-with-%2Ffork"><code>/fork</code></a> でコピーするセッションは、元のセッションのチェックアウトの代わりに、独自の worktree でコード変更を行うようになりました</div>91 <div><a href="/docs/ja/agent-view#copy-the-session-with-%2Ffork"><code>/fork</code></a> でコピーするセッションは、元のセッションのチェックアウトの代わりに、独自の worktree でコード変更を行うようになりました</div>

92 <div><code>/plugin</code> から <a href="/docs/ja/plugins/install#install-a-plugin">インストール</a> するプラグインは、安全な場合に現在のセッションで有効になります。インストール概要は <code>Plugin is now active.</code> を報告するか、<code>/reload-plugins</code> を実行するよう指示します</div>92 <div><a href="/docs/ja/plugins/install#install-a-plugin"><code>/plugin</code></a> からインストールするプラグインは、安全な場合に現在のセッションで有効になります。インストール概要は <code>Plugin is now active.</code> を報告するか、<code>/reload-plugins</code> を実行するよう指示します</div>

93 <div><a href="/docs/ja/agent-view#how-file-edits-are-isolated">バックグラウンドセッション</a> が worktree でコードを変更した場合、完了前にコミットしてプッシュし、タスクが要求する場合にのみドラフトプルリクエストを開き、お客様の <code>CLAUDE.md</code> の git 指示に従います</div>93 <div>worktree でコードを変更した <a href="/docs/ja/agent-view#how-file-edits-are-isolated">バックグラウンドセッション</a> は、完了前にコミットしてプッシュし、タスクが必要とする場合にのみドラフトプルリクエストを開き、<code>CLAUDE.md</code> の git 指示に従うようになりました</div>

94 <div>セッションあたり 200 サブエージェントの上限が削除されたため、長時間実行されるセッションは新しいサブエージェントを拒否しなくなります。<a href="/docs/ja/sub-agents#concurrent-subagent-limit">同時実行</a> と深さの制限は引き続き適用されます</div>94 <div>セッションあたり 200 サブエージェントの上限が削除されたため、長時間実行されるセッションは新しいサブエージェントを拒否しなくなります。<a href="/docs/ja/sub-agents#concurrent-subagent-limit">同時実行</a> と深さの制限は引き続き適用されます</div>

95 <div>リポジトリのチェックイン設定は <a href="/docs/ja/remote-control#enable-remote-control-for-all-sessions">Remote Control 自動接続</a> をオンにできなくなりました。代わりにお客様のユーザーまたは管理設定で <code>remoteControlAtStartup</code> を設定し、プロジェクトとローカル設定はそれをオフにすることのみできます</div>95 <div>リポジトリにチェックインされた設定では <a href="/docs/ja/remote-control#enable-remote-control-for-all-sessions">Remote Control 自動接続</a> をオンにできなくなりました。代わりにユーザー設定または管理設定で <code>remoteControlAtStartup</code> を設定してください。プロジェクト設定とローカル設定ではオフにすることのみできます</div>

96 <div><a href="/docs/ja/worktrees#how-claude-code-enforces-isolation">Worktree 分離</a> はファイル編集だけでなく、メインチェックアウトに到達する Bash コマンドと git リダイレクトもブロックするようになり、すべてのセッションタイプとセッションのサブエージェントで行われます</div>96 <div><a href="/docs/ja/worktrees#how-claude-code-enforces-isolation">worktree 分離</a> はファイル編集だけでなく、メインチェックアウトに到達する Bash コマンドと git リダイレクトもブロックするようになり、すべてのセッションタイプとセッションのサブエージェントで行われます</div>

97 <div>Bash コマンドは権限チェックから自身の一部を隠すことができなくなり、タブまたは非表示の Unicode パディングはコマンドの一部を承認ダイアログから隠さなくなります</div>97 <div>Bash コマンドは権限チェックから自身の一部を隠すことができなくなり、タブまたは非表示の Unicode パディングはコマンドの一部を承認ダイアログから隠さなくなります</div>

98 <div>PreToolUse 自動許可フックは、概要やコンパクションなどの Claude Code の内部サイドタスクでツール制限をバイパスしなくなります</div>98 <div>PreToolUse 自動許可フックは、概要やコンテキスト圧縮などの Claude Code の内部サイドタスクでツール制限をバイパスしなくなります</div>

99 <div><a href="/docs/ja/ultraplan">Ultraplan</a> リサーチプレビューは削除されました。<code>/ultraplan</code> コマンドと <code>ultraplan</code> キーワードを含めて。代わりにプランモードまたは Web 上の Claude Code を使用してください</div>99 <div><a href="/docs/ja/ultraplan">Ultraplan</a> リサーチプレビューは、<code>/ultraplan</code> コマンドと <code>ultraplan</code> キーワードを含めて削除されました。代わりに plan モードまたは Web 上の Claude Code を使用してください</div>

100 </div>100 </div>

101</div>101</div>

102 102 

Details

34 <span className="digest-feature-pill">v2.1.232</span>34 <span className="digest-feature-pill">v2.1.232</span>

35 </div>35 </div>

36 36 

37 <p className="digest-feature-lede">フォークモードはインタラクティブセッションでデフォルトで有効になりました。Claude は <code>fork</code> サブエージェントタイプをリクエストできます。これは完全な会話とプロンプトキャッシュを継承するため、最初からやり直す必要がなく、サイドタスクのコンテキストを再度説明する必要がありません。インタラクティブセッションで Claude が生成するサブエージェント(エージェントチームのチームメイトが生成するもの以外)もデフォルトでバックグラウンドで実行されます。</p>37 <p className="digest-feature-lede">フォークモードはインタラクティブセッションでデフォルトで有効になりました。Claude は <code>fork</code> サブエージェントタイプを要求できます。これは完全な会話とプロンプトキャッシュを継承するため、最初からやり直す必要がなく、サイドタスクのコンテキストを再度説明する必要がありません。インタラクティブセッションで Claude が生成するサブエージェント(エージェントチームのチームメイトが生成するもの以外)もデフォルトでバックグラウンドで実行されます。</p>

38 38 

39 <p className="digest-feature-try">これまでに説明したすべてのコンテキストが必要なタスクでフォークを自分で開始してください:</p>39 <p className="digest-feature-try">これまでに説明したすべてのコンテキストが必要なタスクでフォークを自分で開始してください:</p>

40 40 


53 <span className="digest-feature-pill">v2.1.232</span>53 <span className="digest-feature-pill">v2.1.232</span>

54 </div>54 </div>

55 55 

56 <p className="digest-feature-lede">プラグインマーケットプレイスはベア <code>gitlab.com</code> URL(ネストされたサブグループを含む)をクローンします。v2.1.233 以降では、GitLab マージリクエスト URL を <code>--worktree</code> に渡してそこからブランチを作成でき、<code>claude agents</code> ビューはマージリクエストにリンクされたセッションを <code>!N</code> としてラベル付けします。Claude Code は <code>glpat-</code> や <code>glrt-</code> などの GitLab トークンファミリーも編集し、<code>glab</code> CLI の設定ストアを <code>gh</code> と同じ方法で保護します。</p>56 <p className="digest-feature-lede">プラグインマーケットプレイスはベア <code>gitlab.com</code> URL(ネストされたサブグループを含む)をクローンします。v2.1.233 以降では、GitLab マージリクエスト URL を `--worktree` に渡してそこからブランチを作成でき、<code>claude agents</code> ビューはマージリクエストにリンクされたセッションを <code>!N</code> としてラベル付けします。Claude Code は <code>glpat-</code> や <code>glrt-</code> などの GitLab トークンファミリーもマスクし、<code>glab</code> CLI の設定ストアを <code>gh</code> と同じ方法で保護します。</p>

57 57 

58 <p className="digest-feature-try">マージリクエストからブランチされたワークツリーでセッションを開始してください:</p>58 <p className="digest-feature-try">マージリクエストからブランチされた worktree でセッションを開始してください:</p>

59 59 

60 ```bash terminal theme={null}60 ```bash terminal theme={null}

61 claude --worktree https://gitlab.com/group/project/-/merge_requests/4261 claude --worktree https://gitlab.com/group/project/-/merge_requests/42

62 ```62 ```

63 63 

64 <p className="digest-feature-try"><code>origin</code> が gitlab.com 上にある場合、Claude Code は <code>merge-requests/42/head</code> をフェッチし、そのブランチ上のセッションを独自のワークツリーで開きます。</p>64 <p className="digest-feature-try"><code>origin</code> が gitlab.com 上にある場合、Claude Code は <code>merge-requests/42/head</code> をフェッチし、そのブランチ上のセッションを独自の worktree で開きます。</p>

65 65 

66 <a className="digest-feature-link" href="/docs/ja/worktrees#branch-from-a-pull-request">プルまたはマージリクエストからワークツリーをブランチする</a>66 <a className="digest-feature-link" href="/docs/ja/worktrees#branch-from-a-pull-request">プルまたはマージリクエストから worktree をブランチする</a>

67</div>67</div>

68 68 

69<div className="digest-wins">69<div className="digest-wins">


71 71 

72 <div className="digest-wins-grid">72 <div className="digest-wins-grid">

73 <div>プロンプトで <code>@</code> を入力して、別の Claude セッションを名前で <a href="/docs/ja/cross-session-messaging#message-another-session">メンションする</a> と、Claude は <code>SendMessage</code> でそれに直接メッセージを送信します。正確に 1 つのライブセッションと一致するベア名は確認ステップなしで配信されるようになりました</div>73 <div>プロンプトで <code>@</code> を入力して、別の Claude セッションを名前で <a href="/docs/ja/cross-session-messaging#message-another-session">メンションする</a> と、Claude は <code>SendMessage</code> でそれに直接メッセージを送信します。正確に 1 つのライブセッションと一致するベア名は確認ステップなしで配信されるようになりました</div>

74 <div>1 台のマシン上のインタラクティブセッションは <a href="/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach">一意の名前</a> を保持します。別のライブセッションが既に使用している名前でセッションを開始または名前変更した場合、Claude Code はあなたのセッションに <code>name-word-word</code> バリアントを付与し、その旨を通知します</div>74 <div>1 台のマシン上のインタラクティブセッションは <a href="/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach">一意の名前</a> を保持します。別のライブセッションが既に使用している名前でセッションを開始または名前変更した場合、Claude Code はそのセッションに <code>name-word-word</code> バリアントを付与し、その旨を通知します</div>

75 <div>プラグインマーケットプレイスは <a href="/docs/ja/plugins/marketplace-reference#command-plugin-source"><code>command</code> ソース</a> を受け入れます。ローカルコマンドはプラグインディレクトリを出力し、Claude Code は各セッションで再解決して再起動なしで適用します</div>75 <div>プラグインマーケットプレイスは <a href="/docs/ja/plugins/marketplace-reference#command-plugin-source"><code>command</code> ソース</a> を受け入れます。ローカルコマンドはプラグインディレクトリを出力し、Claude Code は各セッションで再解決して再起動なしで適用します</div>

76 <div>Linux と WSL では、<a href="/docs/ja/tools-reference#memory-limit-on-linux-and-wsl"><code>CLAUDE\_CODE\_TOOL\_MEMORY\_LIMIT</code></a> を <code>4G</code> などのサイズに設定して、Bash および PowerShell ツールコマンドが使用できるメモリをキャップできます</div>76 <div>Linux と WSL では、<a href="/docs/ja/tools-reference#memory-limit-on-linux-and-wsl"><code>CLAUDE\_CODE\_TOOL\_MEMORY\_LIMIT</code></a> を <code>4G</code> などのサイズに設定して、Bash および PowerShell ツールコマンドが使用できるメモリをキャップできます</div>

77 <div><code>TaskCreate</code>、<code>TaskUpdate</code>、<code>TodoWrite</code> などのタスク追跡ツールは、<a href="/docs/ja/tools-reference#task-tool-availability">Opus 4.8、Sonnet 5、Fable 5、Mythos 5、およびそれ以降のモデルでは利用できなくなりました</a>。<code>CLAUDE\_CODE\_ENABLE\_TODO\_TOOLS=1</code> を設定して再度有効にしてください</div>77 <div><code>TaskCreate</code>、<code>TaskUpdate</code>、<code>TodoWrite</code> などのタスク追跡ツールは、<a href="/docs/ja/tools-reference#task-tool-availability">Opus 4.8、Sonnet 5、Fable 5、Mythos 5、およびそれ以降のモデルでは利用できなくなりました</a>。<code>CLAUDE\_CODE\_ENABLE\_TODO\_TOOLS=1</code> を設定して再度有効にしてください</div>

78 <div><a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> は高、xhigh、および max 努力レベルで、他のレベルと同様にバックグラウンドエージェントで実行されるようになりました</div>78 <div><a href="/docs/ja/code-review-local"><code>/code-review</code></a> は高、xhigh、および max 努力レベルで、他のレベルと同様にバックグラウンドエージェントで実行されるようになりました</div>

79 <div><a href="/docs/ja/plugins/install#install-a-plugin"><code>/plugin install plugin\@marketplace</code></a> はまずマーケットプレイスをリフレッシュするため、新しく公開されたプラグインは手動マーケットプレイス更新なしでインストールできます</div>79 <div><a href="/docs/ja/plugins/install#install-a-plugin"><code>/plugin install plugin\@marketplace</code></a> はまずマーケットプレイスをリフレッシュするため、新しく公開されたプラグインは手動マーケットプレイス更新なしでインストールできます</div>

80 <div>設定は <a href="/docs/ja/settings-reference#marketplace-key-aliases"><code>additionalMarketplaces</code> および <code>allowedMarketplaces</code></a> を <code>extraKnownMarketplaces</code> および <code>strictKnownMarketplaces</code> のエイリアスとして受け入れます</div>80 <div>設定は <a href="/docs/ja/settings-reference#marketplace-key-aliases"><code>additionalMarketplaces</code> および <code>allowedMarketplaces</code></a> を <code>extraKnownMarketplaces</code> および <code>strictKnownMarketplaces</code> のエイリアスとして受け入れます</div>

81 <div>新しいモデルでは、Claude は <a href="/docs/ja/tools-reference#write-tool-behavior">Write ツールで既存ファイルを上書き</a> できるようになり、このセッションで最初に読み込む必要がなくなり、Edit ツールのルールと一致します。古いモデルは読み込みが必要です</div>81 <div>新しいモデルでは、Claude は <a href="/docs/ja/tools-reference#write-tool-behavior">Write ツールで既存ファイルを上書き</a> できるようになり、このセッションで最初に読み込む必要がなくなり、Edit ツールのルールと一致します。古いモデルは読み込みが必要です</div>

workflows.md +4 −4

Details

205 205 

206`claude -p` と Agent SDK では、Claude Code はこのプロンプトを表示しません。セッションの残りの部分と同じ[権限評価](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を通じてワークフロー ツール呼び出しを実行するため、拒否ルール、質問ルール、および `dontAsk` モードはすべてのツール呼び出しに適用されるのと同じように適用されます。これらの実行でワークフローを開始させるには、次のいずれかを使用します。206`claude -p` と Agent SDK では、Claude Code はこのプロンプトを表示しません。セッションの残りの部分と同じ[権限評価](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を通じてワークフロー ツール呼び出しを実行するため、拒否ルール、質問ルール、および `dontAsk` モードはすべてのツール呼び出しに適用されるのと同じように適用されます。これらの実行でワークフローを開始させるには、次のいずれかを使用します。

207 207 

208* **権限ルール**: 許可ルール内の `Workflow` はすべてのワークフローを承認し、`Workflow(<name>)` は名前で 1 つの保存されたワークフローを承認します。208* **権限ルール**: すべてのワークフローを承認するには許可ルールに `Workflow` を追加し、名前で 1 つの保存されたワークフローを承認するには `Workflow(<name>)` を追加します。

209* **自動権限モード**: [分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)は呼び出しをレビューし、それを承認できます。209* **auto 権限モード**: [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で実行します。auto モードでは分類器が呼び出しをレビューし、それを承認できます。

210* **バイパス権限モード**: Claude Code は呼び出しを承認します。210* **バイパス権限モード**: バイパス権限モードで実行します。

211* **フック**: 呼び出しを許可する [`PreToolUse`](/docs/ja/hooks#pretooluse) フックがそれを承認します。211* **フック**: [`PreToolUse`](/docs/ja/hooks#pretooluse) フックから呼び出しに対して `"allow"` を返します。[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)では、フックの承認だけではワークフローは開始されないため、代わりに権限ルールまたはホストの承認を使用します。

212* **ホスト**: [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)、または Agent SDK では [`canUseTool`](/docs/ja/agent-sdk/permissions) コールバックがそれを承認します。212* **ホスト**: [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)、または Agent SDK では [`canUseTool`](/docs/ja/agent-sdk/permissions) コールバックがそれを承認します。

213 213 

214デスクトップアプリでは、承認カードはワークフロー名、フェーズリスト、トークン使用量の注意を表示し、**Once**、**Always**、**Deny** アクションを表示します。進行状況ビューは、バックグラウンドタスクサイドペインに表示されます。214デスクトップアプリでは、承認カードはワークフロー名、フェーズリスト、トークン使用量の注意を表示し、**Once**、**Always**、**Deny** アクションを表示します。進行状況ビューは、バックグラウンドタスクサイドペインに表示されます。