エラーリファレンス

Claude Code のランタイムエラーメッセージを検索し、各エラーの意味と修正方法を確認できます。

このページでは、Claude Code が表示するランタイムエラーと各エラーからの復旧方法、および応答がエラーなしで問題があるように見える場合に確認すべき内容を一覧表示しています。セットアップ中の command not found や TLS エラーなどのインストールエラーについては、インストールとログインのトラブルシューティングを参照してください。

ラッパーと IDE エラーを除き、これらのエラーと復旧コマンドは CLI、Desktop アプリ、および Claude Code on the web全体に適用されます。これら 3 つはすべて同じ Claude Code CLI をラップしているためです。その他の表面固有の問題については、その表面のページのトラブルシューティングセクションを参照してください。

エラーを見つける

以下のセクションに表示されるメッセージを照合してください。

自動リトライ

Claude Code は、エラーを表示する前に、指数バックオフを使用して一時的な障害を最大 10 回リトライします。Claude の応答の途中で到着した障害は常にリトライされるわけではありません。このページのエラーのいずれかが表示される場合、Claude Code はその障害に適用されるリトライを既に実行しています。以下のリストは、どの障害が完全な予算を取得するか、どの障害がより小さい予算を取得するか、どの障害が予算を取得しないかを示しています。

Claude Code がリトライする障害：

• Claude の応答がストリーミングされる前に到着するサーバーエラー、過負荷応答、およびリクエストタイムアウト。
• 接続の切断。Claude が応答の任意の部分（思考を含む）を完了する前にリクエストの途中で接続が切断された場合、Claude Code は同じバックオフでリクエストを再発行し、テキストがすでにストリーミングを開始していても、ターンは続行されます。Claude が思考を完了した後、テキストまたはツール呼び出しを開始する前に接続が切断された場合、Claude Code は代わりにリクエストを最大 2 回迅速に連続して再発行し、接続がその時点で切断され続ける場合は Connection lost before a response was produced でターンを終了します。
• リクエストの途中でコンピューターがスリープ状態になったことが原因で Claude Code が検出した接続の破損。Claude Code はこれを上記のルールに基づいて切断された接続としてカウントします。リトライラベルが特定の理由を名前付けすると、Connection lost while your computer was asleep と読み、Claude が思考を完了した後、テキストまたはツール呼び出しの前にターンが終了する場合、メッセージは Your computer went to sleep before a response was produced と読みます。
• 応答ヘッダーが到着したが Claude の応答が到着していない場合、または Claude が思考を完了したがテキストまたはツール呼び出しを開始していない場合の、停止した応答ストリーム。Claude Code は停止した接続を中止し、上記の 10 回の試行予算外で最大 1 回リクエストを再発行します。Claude が思考を完了した後、テキストまたはツール呼び出しの前に応答が 2 回目に停止した場合、Claude Code は The response stalled before a response was produced でターンを終了します。
• API が応答ヘッダーで応答しないストリーミングリクエスト。最初のバイトデッドラインが実行される接続上：Claude Code はデッドラインで中止し、リトライ予算内でモデルリクエストごとに最大 1 回再送信し、その試行も応答がない場合は No response from API でターンを終了します。他の接続では、リクエストは API_TIMEOUT_MS を待ちます。CLAUDE_CODE_RETRY_WATCHDOG を設定する場合、1 回のリトライ上限は適用されません。
• 一時的な 429 スロットル。ただし、ゲートウェイの支出制限 429 は除きます。これはスロットルではありません。Spend limit reached を参照してください。
  • claude.ai サブスクリプションでサインインしている場合、これには計画の割り当てヘッダーを含まない 429 スロットルが含まれます。v2.1.199 より前は、Claude Code は API キーおよび Enterprise サインインに対してのみこれらのスロットルをリトライしました。
• 入力と max_tokens がコンテキスト制限を超えるため拒否されたリクエスト。変更されていない状態で再送信すると同じ方法で失敗するため、Claude Code は削減された max_tokens でリトライし、2 つのケースで リトライを停止してコンパクト化する代わりに：
  • 削減がフィットできない場合。例えば、会話自体がコンテキストウィンドウをほぼ満たしている場合。
  • リトライが max_tokens をこれ以上縮小できない場合。v2.1.218 より前は、Claude Code は、拡張思考予算が残りのコンテキストを超えた場合など、フィットしない削減されたリクエストを再送信でき、リトライ予算が尽きるまで続きました。
• Google Cloud の Agent Platform 上の期限切れまたは欠落している Google Cloud 認証情報、またはマシンで読み込みに失敗した AWS 認証情報。Claude Code はキャッシュされた認証情報を破棄し、最大 2 回リトライしてから、Could not load AWS or Google Cloud credentials で説明されているように、すぐに再認証できるようにエラーを報告します。v2.1.228 より前は、Claude Code は失敗した Google Cloud 認証情報を完全なリトライ予算を通じてリトライしてからエラーを表示していました。
• apiKeyHelper スクリプトが認証情報を提供している間に、Anthropic API から直接、または LLM gateway を通じて 401 または 403。Claude Code はスクリプトを再実行し、完全なリトライ予算内でその新しい出力でリトライします。スクリプト自体が再実行時に失敗する場合、Claude Code は Your apiKeyHelper script is failing を代わりに表示します。

v2.1.227 より前は、Connection lost before a response was produced は Connection closed while thinking, before producing a response と読み、The response stalled before a response was produced は Response stalled while thinking, before producing a response と読みました。

Claude Code がリトライしない障害：

• TLS 証明書検証エラー。TLS 検査プロキシ、欠落している NODE_EXTRA_CA_CERTS バンドル、または期限切れの証明書など。Claude Code は最初の試行でエラーを報告するため、証明書セットアップをすぐに修正できます。SSL certificate errors を参照してください。Claude Code は依然としてハンドシェイクタイムアウトなどの一時的な TLS 条件をリトライします。v2.1.199 より前は、Claude Code は証明書エラーを完全なリトライ予算を通じてリトライしてからエラーを表示していました。
• Claude がテキストのブロックまたはツール呼び出しを完了した後、または思考を完了した後にそれを開始した後、応答を完了する前に到着するサーバーエラー、切断された接続、または停止したストリーム。Claude Code はリクエストを再実行しません。これは同じツール呼び出しを 2 回実行する可能性があるためです。Claude が完了したものを保持し、Claude が完了したツール呼び出しを実行し、その結果からターンを続行します。対話型セッションと非対話型セッションで表示される内容については、The response above may be incomplete を読んでください。v2.1.199 より前は、サーバーエラーがストリーム中に到着した場合、Claude Code は部分的な出力を破棄し、ターン全体をエラーとして報告していました。
• Claude が応答を完了した後に到着する障害：リトライする必要がないため、Claude Code は完全な応答を保持し、ターンを正常に終了します。
• Amazon Bedrock ストリーミング応答に予期しないコンテンツタイプがある。ゲートウェイまたはプロキシが応答を書き直すため、リトライも同じ方法で書き直されます。Claude Code v2.1.208 以降が必要です。
• 失敗したストリーミングリクエストの非ストリーミングリトライが成功ステータスを取得しますが、本文に Claude API メッセージがない。Claude Code はそのエラーでターンを終了します。
• 組織のポリシーチェックが拒否したリクエスト。これは API Error: 行として表示され、拒否メッセージが含まれます。組織の管理者は Inference hooks を使用してチェックを設定します。これは Claude Enterprise 機能であり、メッセージは彼らが設定した指示で終わるか、デフォルトでは彼らに連絡するよう指示します。Claude Code は、拒否がリクエストのコンテンツに関するものであり、モデルに関するものではないため、拒否されたリクエストを同じモデルまたは fallback model に再送信しません。v2.1.239 より前は、Claude Code は拒否されたリクエストを、ストリーミングなしで、または設定されたフォールバックモデルで再送信してから、拒否を表示する可能性がありました。

Claude Code がリトライまたは待機している間に表示される内容

リトライ中、スピナーはエラーラベルの後に Retrying in Ns · attempt x/y カウントダウンを表示します。ラベルは、すぐに対応できる障害の最初の試行からの特定の理由を名前付けします。ネットワークがダウンしている、TLS ハンドシェイクが失敗した、またはレート制限に達した場合です。他のエラーの場合は、最初は API error と読みます。v2.1.198 以降、3 回目の試行からの特定の理由に切り替わるか、CLAUDE_CODE_MAX_RETRIES が 3 未満の試行を許可する場合は最終試行時に切り替わります。以前のバージョンは最終試行時にのみ切り替わります。

v2.1.198 以降、通常のスピナーのヒントはリトライ中に抑制されます。エラーの理由が明らかになると、障害が 529 オーバーロードの場合、カウントダウンの下の行はサービスステータスを確認する場所も名前付けします。Anthropic API の場合は status.claude.com、または他の設定の場合はメッセージで名前付けされたプロバイダーまたはゲートウェイホスト。

リクエストがまだ保留中の間に応答ストリームで 20 秒間データが到着しない場合、スピナーは任意のリトライが開始される前に Waiting for API response · will retry in … · check your network を表示します。リクエストはまだ失敗していません。カウントダウンは Claude Code が停止した接続を中止する時点まで実行されます。中止後、表示される内容は応答がどこまで進んだかによって異なります。

• Claude がテキストのブロックまたはツール呼び出しを完了する前、または思考を完了した後にそれを開始する前に、Claude Code はリクエストをリトライするか、エラーでターンを終了します。Automatic retries は、どのストールをリトライするか、何回リトライするかを示しています。
• Claude がテキストのブロックまたはツール呼び出しを完了した後、または思考を完了した後にそれを開始した後、応答を完了する前に、Claude Code は Claude が完了したものを保持し、Claude が完了したツール呼び出しからターンを続行し、The response above may be incomplete を表示します。非対話型セッション、およびいずれかのセッションでサブエージェントの応答の場合、Claude Code は最初に Claude に応答を続行するよう促す可能性があります。そのエントリは、いつそれを行うか、いつそこでも通知が表示されるかを示しています。
• Claude が応答を完了した後、Claude Code はターンを正常に終了します。

バナーは、データが再開されるか、リトライが成功すると自動的にクリアされます。すべての試行で再表示される場合は、network issue として扱ってください。v2.1.185 より前は、バナーは 10 秒後に異なる文言で表示されました。

Claude が advisor を参照している間、バナーは 20 秒ではなく 90 秒後にデータなしで表示されます。長いアドバイザーレビューは 20 秒以上何も送信しないことがあるためです。v2.1.214 より前は、20 秒のしきい値がアドバイザー呼び出し中にも適用されたため、バナーは何も問題がなくてもアドバイザーレビュー中に表示されました。

リトライ動作を調整する

これらの環境変数を使用してリトライ動作を調整できます。

サーバーエラー

これらのエラーのほとんどは推論プロバイダーから発生します。Anthropic API 上の Anthropic のサービス、および Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、またはカスタムゲートウェイの背後にあるプロバイダーのエンドポイントのサービスです。Auto mode cannot determine the safety of an action と Agent terminated early due to an API error は、Amazon Bedrock アカウントがクラシファイアーモデルを呼び出せない、またはサブエージェントが使用制限に達したなど、お客様側の原因もカバーしています。

API Error: 500 Internal server error

Claude Code は、5xx レスポンスに対して、ステータスコードと API のエラーメッセージを表示します。以下の例は、Anthropic API での 500 レスポンスを示しています。

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

末尾の文は、サービスの健全性を確認する場所を示し、プロバイダーによって異なります。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry の設定は、そのプロバイダーのサービスステータスを示します。カスタム ANTHROPIC_BASE_URL はゲートウェイホストを示します。

これは API 内の予期しない障害を示しています。これはお客様のプロンプト、設定、またはアカウントが原因ではありません。

対応方法：

• status.claude.com またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください
• 1 分待ってから、メッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は、全体を貼り付ける代わりに try again と入力できます。
• エラーが投稿されたインシデントなしで続く場合は、/feedback を実行して、Anthropic がリクエストの詳細で調査できるようにしてください。環境で /feedback が利用できない場合は、Report an error を参照してください。

API Error: Repeated 529 Overloaded errors

API は全ユーザー間で一時的に容量に達しています。Claude Code はこのメッセージを表示する前に既に数回再試行しています。

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

末尾の文は、500 エラーと同じ方法でプロバイダーによって異なります。

529 はお客様の使用制限ではなく、クォータに対してカウントされません。

対応方法：

• status.claude.com またはメッセージに示されているプロバイダーのステータスページで、容量に関する通知を確認してください
• 数分後に再度試してください
• /model を実行して別のモデルに切り替えて、作業を続けてください。容量はモデルごとに追跡されるためです。Claude Code は、1 つのモデルが特に高い負荷を受けている場合、これを行うようにお客様に促します。例えば Opus is experiencing high load, please use /model to switch to Sonnet のようなメッセージが表示されます。

Request timed out

API は接続期限前に応答しませんでした。

Request timed out

これは高負荷期間中、またはモデルが非常に大きなレスポンスを生成しているときに発生する可能性があります。デフォルトのリクエストタイムアウトは 10 分です。

対応方法：

• リクエストを再試行してください
• 長時間実行されるタスクの場合は、作業をより小さなプロンプトに分割してください
• 遅いネットワークまたはプロキシが原因の場合は、Automatic retries で説明されているように API_TIMEOUT_MS を上げてください
• タイムアウトが頻繁で、ネットワークが正常な場合は、以下の Network and connection errors を参照してください

No response from API

Claude Code はストリーミングリクエストを送信し、API は最初のバイトの期限内に応答ヘッダーを返さなかったため、Claude Code は完全な API_TIMEOUT_MS リクエストタイムアウト（デフォルトは 10 分）を待つ代わりにリクエストを中止しました。Claude Code は retry budget が許可する場合、最大 1 回リクエストを再度送信します。再試行も応答がない場合、ターンはこのメッセージで終了し、各試行が待機した時間を示します。CLAUDE_CODE_RETRY_WATCHDOG を設定すると、1 回の再試行の上限は適用されず、Claude Code は Tune retry behavior で説明されているバジェット下で再試行します。

API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

Claude Code は最初の試行の応答ヘッダーの待機と再試行の待機を個別に設定します。

• 最初の試行: CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS を 1 以上に設定した場合、10 秒から 30 分の間にクランプされます。それ以外の場合、Claude Code は Streaming idle watchdogs に記載されているバイトレベルのウォッチドッグタイムアウトを使用するため、そのタイムアウトを変更する変数はこの待機も変更します。どちらの場合でも、Claude Code はリクエストボディの 32KB ごとに 1 秒を追加します。
• 再試行: API_TIMEOUT_MS より 1 秒少ない、デフォルトではほぼ 10 分。これにより、再試行は応答を生成完了まで保持するプロキシまたはゲートウェイを上回ることができます。Amazon Bedrock では、再試行は最初の試行と同じ期限を使用し、メッセージは 2 つの期間ではなく 1 つの期間を示します。

どちらの待機も、正の API_TIMEOUT_MS より 1 秒少ないを超えず、11 秒未満の正の API_TIMEOUT_MS は期限をオフにします。バイトレベルのウォッチドッグは応答ヘッダーが到着した後にのみ開始されるため、その後バイト送信を停止するレスポンスは、この期限ではなく stalled-stream rules に従います。

対応方法：

• メッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は、全体を貼り付ける代わりに try again と入力できます。
• 繰り返される場合は、network or proxy problem として扱ってください。接続を受け入れてリクエストを転送しないプロキシは、すべての試行でこのエラーを生成します。
• ネットワーク上のプロキシまたはゲートウェイが応答を生成完了まで保持する場合は、API_TIMEOUT_MS を上げて再試行がより長く待機するようにしてください。Amazon Bedrock では、CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS も上げてください。
• 最初の試行がタイムアウトし続け、再試行が成功する場合は、CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS を上げて最初の試行も十分に長く待機するようにしてください。

v2.1.242 より前では、Claude Code は応答のない ストリーミングリクエストが失敗する前に、完全な API_TIMEOUT_MS リクエストタイムアウト（デフォルトは 10 分）を待機していました。v2.1.261 より前では、再試行は最初の試行と同じ期限を待機し、メッセージは期間を示していませんでした。

The response above may be incomplete

ストリーミングリクエストがレスポンスの進行中に失敗しました。Claude がテキストのブロックまたはツール呼び出しを完了した後、または思考を終了した後に 1 つを開始した後です。リクエストを再送信すると、同じツール呼び出しが 2 回実行される可能性があるため、Claude Code は Claude が完了した出力を保持し、ターンを破棄する代わりにこの通知を追加します。表示されるバリアントは原因を示します。

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.

• Server error mid-response: ストリーム中のオーバーロードまたは 5xx サーバーエラー。このバリアントには Claude Code v2.1.199 以降が必要です。それ以前は、その場合は部分的な出力を破棄し、ターン全体をエラーとして報告していました。
• Connection lost mid-response: 接続が切断されました。
• Your computer went to sleep mid-response: Claude Code は、レスポンスがストリーミング中にコンピューターがスリープ状態になったことを検出しました。コンピューターが起動すると、Claude Code は接続を破損として扱い、読み取りを停止します。
• The response stopped arriving: 接続は開いたままでしたが、データの配信を停止したため、ストリーミングアイドルウォッチドッグがそれを中止しました。v2.1.222 より前では、Claude Code は gateway 接続で ANTHROPIC_BASE_URL または ANTHROPIC_AWS_BASE_URL を通じて到達したこのエラーを報告することもできました。サーバーのキープアライブピングがまだ到着している間、解析された応答イベントのみをカウントしたため、アップグレードするとこれらのルートでの偽のタイムアウトが停止します。ANTHROPIC_BEDROCK_BASE_URL などのプロバイダーベース URL を通じて到達するゲートウェイは、バイトウォッチドッグでラップされていません。Streaming idle watchdogs を参照してください。

v2.1.227 より前では、Connection lost mid-response は Connection closed mid-response と読まれ、The response stopped arriving は Response stalled mid-stream と読まれていました。

4 つのケースでは、Claude Code はこの通知をすぐに表示せずに障害を処理します。

• レスポンスの前半で、Claude Code は障害を再試行するか、別のエラーでターンを終了します。Automatic retries を参照してください。
• これらの障害の 1 つが Claude がレスポンスを完了した後に到着した場合、Claude Code は完全なレスポンスを保持し、この通知なしでターンを正常に終了します。v2.1.222 より前では、Claude Code はレスポンスが完了した後に接続が切断またはスタールした場合、この通知を表示し、レスポンスが完全であったにもかかわらずターンをエラーとして報告していました。
• non-interactive session（-p 実行、Agent SDK 実行、または cloud session など）では、カットオフレスポンスがメイン会話にあり、テキストを含むがツール呼び出しを含まない場合、continue を自分で送信する必要はありません。Claude Code は部分的な出力を保持し、Claude に停止した場所から続行するよう促します。最大 3 回連続で。この通知は、Claude Code がこれらの継続を使い果たした後にのみ、そのようなレスポンスに対して表示されます。v2.1.246 より前では、Claude Code は最初のカットオフでこの通知を使用してターンを終了していました。
• subagent（セッションがインタラクティブかどうかに関わらず）：カットオフレスポンスがテキストを含むがツール呼び出しを含まない場合、Claude Code はサブエージェントに続行するよう促します。通知は、これらの継続が使い果たされた後にのみ、サブエージェントの最後のメッセージになります。v2.1.257 より前では、サブエージェントは最初のカットオフでこの通知を表示していました。

対応方法：

• インタラクティブセッションでは、画面に残っているレスポンスを読んでください。Claude Code はエラーの前に Claude が完了したすべてのブロックを保持しますが、ターンが終了するときに中断された最終ブロックを破棄するため、最終文またはツール呼び出しが欠落している可能性があります。continue で返信して、Claude が最後に完了したブロックから再開するようにしてください。
• non-interactive mode（-p）：
  • デフォルトのテキスト出力では、Claude Code は、ターンの前半から保持している最後に完了したテキストのブロックを出力し、その後このメッセージを出力します。何も保持していない場合、Claude Code はこのメッセージのみを出力します。例えば、Claude Code がターン中に会話をコンパクト化し、そのテキストをクリアしたためです。v2.1.219 より前では、Claude Code は -p テキスト出力でこのメッセージのみを出力し、既に生成されたレスポンスを削除していました。
  • --output-format json または stream-json では、Claude Code はこのメッセージを result フィールドで報告します。
  • 接続が安定したら、ターンを続行するために、セッションを再開し、Continue conversations で説明されているように continue を送信してください。

Auto mode cannot determine the safety of an action

auto mode がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、クラシファイアーが失敗した方法によって異なります。

作業ディレクトリ内の読み取り、検索、編集はクラシファイアーをスキップするため、これらすべてのケースで動作し続けます。

クラシファイアーモデルが利用できない場合：

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

Claude Code が障害カテゴリを判定できる場合、temporarily unavailable の後の括弧内にカテゴリを示します。例えば <model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now。カテゴリは (rate-limited)、(overloaded)、(server error)、(timed out)、(connection failed) です。レート制限、オーバーロード、サーバーエラーは一時的で、再試行が機能します。(timed out) または (connection failed) が繰り返される場合は、接続を確認してください。Unable to connect to API を参照してください。v2.1.229 より前では、メッセージはカテゴリを示さず、Wait briefly and then try this action again と読まれていました。

カテゴリが適合しない場合、メッセージは括弧内にカテゴリなしで表示されます。複数の障害がその形式を生成します。Amazon Bedrock（Mantle endpoint を含む）では、AWS アカウントがメッセージに示されているモデルを呼び出せない場合にも表示され、その障害はアカウントにモデルへのアクセスが付与されるまで、すべての再試行で繰り返されます。

対応方法：

• 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します。一時的な障害は auto mode eligibility とは無関係です。設定を変更する必要はありません
• 再試行が失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください
• Amazon Bedrock では、メッセージがすべての再試行で返される場合は、アカウントがそれが示すモデルを呼び出せることを確認してください。標準の Amazon Bedrock モデルの場合、IAM policy がそれを呼び出すことを許可していることを確認してください。Mantle モデル ID の場合は、AWS アカウントチームに連絡してください

OAuth トークンの有効期限が切れたか、別のセッションによってローテーションされたためにクラシファイアーリクエストが失敗した場合、Claude Code はトークンをリフレッシュし、リクエストを 1 回再試行するため、ルーチンのトークン有効期限はこのメッセージとして表示されません。v2.1.216 より前では、有効期限が切れたまたはローテーションされたトークンはすべてのクラシファイアーリクエストに失敗し、トークンがリフレッシュされるまで auto mode はこのメッセージで確認されたすべてのアクションを拒否していました。

クラシファイアーが解析不可能なレスポンスを返した場合：

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

対応方法：

• アクションを再試行してください。これは通常、次の試行で成功します
• claude --debug を実行し、アクションを繰り返して、デバッグログで基になるクラシファイアーレスポンスを確認してください

別の API セーフティチェックが、以前の会話コンテンツのためにクラシファイアーリクエストをブロックした場合：

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

Claude Code はアクションを拒否しますが、Claude にこれはアクションが安全でないという判断ではなく、再試行するのではなく他のタスクを続行するよう伝えます。これらの拒否は auto mode's pause thresholds に対してカウントされません。non-interactive -p 実行では、Claude Code は実行を停止しません。Claude が受け取るものは、アクションをリクエストした場所によって異なります。

• background subagent への -p 実行（--input-format stream-json なし）では、Claude Code は Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode を含むエラー結果を返します
• インタラクティブセッションと -p 実行のメイン会話を含む、その他すべての場所では、Claude Code はその拒否を Claude に返します

v2.1.225 より前では、Claude Code はこれらの拒否を一時停止しきい値に対してカウントし、本物のクラシファイアーブロックと同じ拒否メッセージを返していました。

対応方法：

• これはお客様のアクションに関する決定ではありません。会話に既にあるコンテンツが、auto mode がクラシファイアーに会話を送信したときに API のセーフティフィルターをトリガーしました
• 再試行は役に立ちません。同じ会話コンテンツがフィルターを再度トリガーします
• インタラクティブセッションでは、別の permission mode に切り替えて、プロンプトが表示されたときにアクションを承認できるようにしてください
• トリガーするコンテンツなしで新しい会話を開始してください

会話がクラシファイアーのコンテキストウィンドウより大きくなった場合：

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

アクションに何が起こるかは、Claude がそれをリクエストした場所によって異なります。

• インタラクティブセッションでは、auto mode はそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます
• background subagent への non-interactive -p 実行（--input-format stream-json なし）では、Claude Code は Agent aborted: auto mode classifier transcript exceeded context window in headless mode を含むエラー結果を返し、実行は続行されます
• --permission-prompt-tool なしの -p 実行の他の場所では、フォールバックするプロンプトがないため、アクションは実行されず、実行は続行されます

対応方法：

• インタラクティブセッションでは、表示されるプロンプトでアクションを承認または拒否してください
• インタラクティブセッションでは、/compact を実行して会話サイズを削減し、後続のアクションがクラシファイアーウィンドウ内に収まるようにしてください

Agent terminated early due to an API error

subagent の API リクエストが終了的に失敗しました。例えば、使用制限に達したか、サーバーエラーの再試行が終了したため、サブエージェントはタスクを完了する前に停止しました。このメッセージには Claude Code v2.1.199 以降が必要です。それ以前は、API エラーテキストはサブエージェントの結果であるかのように Claude に返されていました。

Agent terminated early due to an API error: <error detail>

対応方法：

• コロンの後のエラー詳細をこのページの独自のセクション（Usage limits または Server errors など）と照合し、そのセクションの手順に従ってください
• 基になるエラーがクリアされたら、Claude にタスクを再試行するか、resume the subagent するよう依頼してください

レート制限、オーバーロード、またはサーバーエラーがテキスト出力を既に生成したフォアグラウンドサブエージェントを中断する場合、Claude はその部分的な出力を不完全としてマークされた状態で受け取り、このエラーは受け取りません。唯一の出力がツール呼び出しであるサブエージェントもこのエラーを取得します。v2.1.199 では、その形状は代わりに空の部分的な結果を返していました。API errors in subagents を参照してください。

使用制限

このセクションのほとんどのエラーは、アカウントまたはプランに関連付けられたクォータに達したことを意味します。3 つのエラーは異なる動作をします。Server is temporarily limiting requests はプランクォータとは無関係なサーバー側のスロットル、Usage credits required for 1M context は使い果たされたクォータではなく権利確認、The prompt to confirm went unanswered は使用クレジット同意プロンプトが未回答で閉じられたことを意味し、クォータに達したかどうかは関係ありません。

セッション制限に達しました

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

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

Claude Code はメッセージに表示されたリセット時刻まで、それ以上のリクエストをブロックします。セッション制限と週間制限はすべてのモデル間で共有されるため、モデルを切り替えてもアクセスは復元されません。Opus 制限と Sonnet 制限はそれぞれそのモデルファミリーへのリクエストにのみ適用されるため、/model で別のファミリーのモデルに切り替えると、作業を続行できます。

claude.ai サブスクリプションでサインインしたインタラクティブセッションでは、Claude Code はオープンセッションで待機し、リセット直後に中断されたタスクを続行することもできます。待機中、セッションの下部の行は Usage limit reached · continuing automatically at 3:45pm · esc to cancel と表示されます。空のプロンプトで Esc を押すと、待機をキャンセルできます。使用制限がリセットされるのを待つ を参照して、表示内容、待機の開始またはキャンセル方法、自動続行をオフにする方法を確認してください。v2.1.234 より前では、Claude Code はこの待機機能を提供していませんでした。

使用量はセッション許容量と週間許容量に同時にカウントされます。大規模なワークフロー展開など、単一の大量アクティビティのバースト、セッションウィンドウがリセットされる前に週間許容量を使い果たす可能性があります。

対応方法：

• エラーに表示されたリセット時刻まで待機します
• Desktop アプリ の Code タブでは、セッション制限カードに Auto-continue when limits reset チェックボックスが表示されます。週間制限カードには表示されません。チェックされている場合、Desktop アプリはリセット後に中断されたターンを再試行し、カードに再試行時刻を表示します。Desktop チェックボックスと CLI の /config の Continue automatically at usage limit 設定は別個なので、それぞれ個別にオフにしてください。
• Opus または Sonnet 制限の場合、/model を実行してそのファミリー外のモデルに切り替えて、作業を続行します。各モデルは独自のプロンプトキャッシュを持つため、次のリクエストは会話全体を再度読み込み、キャッシュヒットはありません。モデルの切り替え を参照してください
• /usage を実行して、プラン制限とリセット時刻を確認します
• /usage-credits を実行して、Pro と Max で追加使用量を購入するか、Team と Enterprise で管理者にリクエストします。有料プランの使用クレジット を参照して、これがどのように請求されるかを確認してください。
• プランをアップグレードしてベース制限を高くするには、claude.com/pricing を参照してください

ウィンドウが終了する前に、Claude Code はほとんどを使用したことを警告できます。例えば You've used 85% of your session limit · resets 3:45pm というメッセージが表示されます。残りの許容量を継続的に監視するには、rate_limits フィールドを カスタムステータス行 に追加するか、Desktop アプリでモデルピッカーの横にある 使用量リング をクリックします。

1M コンテキストに使用クレジットが必要です

選択されたモデルは 1M トークン拡張コンテキストウィンドウを使用しており、プランはそれを使用クレジットを通じてのみ含みます。

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

これはクォータ枯渇ではなく、権利確認です。セッション許容量と週間許容量に容量が残っている場合でも発火します。拡張コンテキスト を参照して、どのプランが 1M コンテキストを直接含み、どのプランが使用クレジットを必要とするかを確認してください。Claude Code は /model でモデルを選択するときにこのチェックを実行し、Anthropic API への直接接続でのみ実行します。ANTHROPIC_BASE_URL を LLM ゲートウェイ に指定する場合、/model は [1m] 選択を許可し、ゲートウェイがリクエストが成功するかどうかを決定します。

このエラーが会話の途中でコンテキストが 200K トークンを超えて成長したために表示される場合、Claude Code は自動的に会話を標準コンテキスト制限の下に圧縮し、その後セッションをその制限に保つため、アクションは不要です。v2.1.172 より前のバージョンでは、エラーは /compact を含むその後のすべてのリクエストで繰り返されました。これらのバージョンで復旧するには /clear を実行してください。以下の手順は、明示的に [1m] モデルを選択した場合に適用されます。

対応方法：

• /model を実行し、[1m] サフィックスなしのバリアントを選択して、標準コンテキストウィンドウにフォールバックします
• メッセージが /usage-credits を指定する場合、それを実行して Pro と Max で 1M バリアントのメータリング課金をオンにするか、Team と Enterprise で管理者に使用クレジットをリクエストします。使用クレジットがオンになったら Claude Code を再起動します。再起動するまで、セッションは標準コンテキスト制限に留まります。
• /model の後もエラーが続く場合、1M モデル ID が他の場所に設定されている可能性があります。モデルの設定 を参照して、優先順位順に確認する設定場所を確認してください。
• モデルピッカーから 1M バリアントを完全に削除するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定します

v2.1.268 より前では、メッセージは run /usage-credits to turn them on, or /model to switch to standard context で終わり、再起動について言及していませんでした。

確認プロンプトが未回答のまま終了しました

アカウントが Fable 使用クレジット同意 を必要とする場合、Claude Code は Fable リクエストが使用クレジットを請求する前に確認するよう求めます。ターミナルがないセッションで誰もその同意プロンプトに答えない場合、Claude Code はプロンプトを閉じ、次のいずれかのメッセージでターンを終了します。

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

メッセージはセッションの Fable モデルを指定するため、Fable 5 では continuing on Fable 5 と Fable 5 now uses usage credits と表示されます。v2.1.257 より前では、最初のメッセージは Fable 5 limit reached で始まりました。

これは Remote Control セッション、バックグラウンドセッション、および エージェントチーム チームメイトセッションで発生します。Claude Code は同意プロンプトをセッション独自のインタラクティブビューにのみ表示します。実行されるターミナル、またはバックグラウンドセッションの場合は、アタッチしたら エージェントビュー です。Remote Control クライアントはそれを表示できません。Claude Code は dialogExpiry デッドラインでプロンプトを閉じます。デフォルトは 5 分、またはそのターミナルで誰も入力していない間に新しいプロンプトが到着するとすぐに、例えば Remote Control クライアントから送信されたプロンプトなどです。セッションが実行されるターミナルで入力するとデッドラインがキャンセルされ、Claude Code は回答を待ちます。バックグラウンドセッションのアタッチされたビューでは、入力はデッドラインをキャンセルせず、新しいプロンプトは同意プロンプトを閉じるため、どちらかが発生する前に回答してください。Claude Code は何も送信せず、モデルを保持するため、次のプロンプトを送信すると、Claude Code は同意プロンプトを再度表示します。

対応方法：

• セッションが実行されるターミナルで別のプロンプトを送信し、再度表示されたら同意プロンプトに答えます。バックグラウンドセッションの場合、最初に エージェントビュー からアタッチします。Remote Control クライアントから再送信すると、クライアントがプロンプトを表示できないため、このメッセージが再度表示されます。
• /model を実行して、使用クレジットを請求しないモデルに切り替えます
• そのターミナルに到達するまでの時間を増やすには、dialogExpiry をより長い値または "never" に設定します

v2.1.236 より前では、このメッセージは表示されませんでした。Remote Control クライアントが接続されている間、Claude Code は回答を 60 秒待ってからデフォルトモデルでターンを続行しました。

サーバーが一時的にリクエストを制限しています

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

API Error: Server is temporarily limiting requests (not your usage limit)

Claude Code は、実際の制限応答が持つ統一クォータヘッダーの不在によって、これらをプラン制限と区別します。v2.1.199 以降、これは認証方法に関係なく、自動的に再試行 されてからバックオフで表示されます。以前のバージョンでは、claude.ai サブスクリプションでサインインしたセッションは最初の発生時にターンに失敗しました。API キーと Enterprise サインインのみが再試行しました。

対応方法：

• 少し待ってから再度試してください
• 続く場合は status.claude.com を確認してください

リクエストが拒否されました (429)

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

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

末尾の文はサービスヘルスを確認する場所を指定し、プロバイダーによって異なります。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry 設定は、Anthropic ステータスページの代わりにそのプロバイダーのサービスステータスを指定します。カスタム ANTHROPIC_BASE_URL はゲートウェイホストを指定します。

対応方法：

• /status を実行して、アクティブな認証情報が予想されるものであることを確認します。環境内の迷走した ANTHROPIC_API_KEY は、サブスクリプションの代わりに低層キーを通じてリクエストをルーティングできます。
• プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストします
• Anthropic API キーについては、レート制限リファレンス を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください
• 同時実行性を削減します。CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に /model で小さいモデルに切り替えます

月間支出制限に達しました

プランに含まれる使用量ではこのリクエストをカバーできず、それ以外の場合はそれを支払う 使用クレジット が支出制限に達しました。これは、プランの使用ウィンドウの 1 つが尽きたとき、またはリクエストが使用クレジットのみが支払うもの（例えば 使用クレジットに請求 するモデルへのリクエスト）の場合に発生します。メッセージはどの制限があなたをブロックしたかを指定します。· の後のテキストはその制限を増やす方法を説明し、プランと請求を管理しているかどうかによって異なります。

You've hit your monthly spend limit · raise it at claude.ai/settings/usage
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

team's shared budget はグループに割り当てられたプール予算で、メッセージはグループを指定しません。channel's monthly spend limit はセッションが実行される Slack チャネルの予算なので、組織は外部に予算を持つ可能性があります。

プランのウィンドウの 1 つが尽きたとき、メッセージはそのウィンドウがいつリセットされるかも言及します。例えば · your session limit resets 3:45pm、アクセスは誰も制限を上げることなく、その後に戻ります。使用量ベースの課金を持つ組織では、メッセージは spend limit の代わりに usage limit を言及します。例えば You've hit your individual usage limit。

v2.1.239 より前では、メッセージはプランウィンドウのリセット時刻を指定しませんでした。v2.1.268 より前では、グループのプール予算は team's shared budget の代わりに individual spend limit メッセージを生成しました。

Claude アプリゲートウェイを通じて接続し、小文字の spend limit reached を見る場合、それはゲートウェイオペレーターのキャップです。支出制限に達しました を参照してください。

対応方法：

• Pro と Max では、claude.ai の Settings > Usage で月間支出制限を増やすか、/usage-credits を実行します
• Team と Enterprise では、請求を管理する場合は Admin settings > Usage で制限を増やすか、管理者に依頼します。/usage-credits は管理者にそのリクエストを送信します
• チャネルの制限については、組織の所有者またはチャネルのマネージャーに claude.ai で上げるよう依頼してください。Claude Tag ドキュメントの Per-channel limits を参照してください
• メッセージがプランのウィンドウのリセット時刻を指定する場合、代わりにそれを待つことができます
• /usage を実行して、プランのウィンドウと各リセット時刻を確認します

支出制限に達しました

Claude アプリゲートウェイ を通じて接続し、ゲートウェイオペレーターが設定した 支出キャップ を超えました。ゲートウェイは、指定された期間がリセットされるか、オペレーターがキャップを上げるまで、リクエストをブロックします。ブロックされた各 429 レスポンスに x-should-retry: false をマークするため、Claude Code は再試行せずにこのメッセージを表示します。

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

メッセージはキャップの期間とリセット時刻を指定し、オペレーターが blocked_message を設定した場合、その指示がそれに続きます。v2.1.225 より前では、メッセージは spend limit reached のみを読みました。古いバージョンのゲートウェイはまだその短い形式を送信します。

対応方法：

• メッセージが指定するリセット時刻まで待つか、メッセージがそれを含む場合はオペレーターの指示に従います
• ルーチンでそれに達する場合は、ゲートウェイオペレーターにキャップを上げるよう依頼します

関連するメッセージ spend limit unavailable は、ゲートウェイが支出レコードを読み取ることができず、キャップを超えるのではなく予防措置としてリクエストをブロックしたことを意味します。通常は自動的にクリアされます。続く場合は、ゲートウェイオペレーターに通知してください。

クレジット残高が低すぎます

Console 組織がプリペイドクレジットを使い果たしたか、Claude Code が Console API キーでリクエストを送信しており、サブスクリプションを使用することを意図していました。

Credit balance is too low

対応方法：

• Pro、Max、Team、または Enterprise プランを持っており、これを見る場合は、/status を実行して API key 行を確認します。環境内の承認された ANTHROPIC_API_KEY は、サブスクリプションの代わりにそのキーを通じてリクエストをルーティングします。現在のシェルでそれを設定解除し、シェルプロファイルから削除してから、claude を再起動します。サブスクリプションでまだサインインしていない場合は /login を実行します。
• platform.claude.com/settings/billing でクレジットを追加し、そこで自動リロードを有効にして、残高がゼロに達する前に補充されるようにすることを検討してください
• Console でワークスペースごとの支出キャップを設定して、単一のプロジェクトが組織残高を消耗するのを防ぎます。コストを効果的に管理 を参照してください。

支出制限を更新できませんでした

サーバーは、支出制限に達したときに表示されるプロンプトから行った支出制限の変更を拒否しました。

Could not update your spend limit: <reason from the server>

サーバーが拒否を説明する場合、メッセージはその理由で終わり、同じ値を再試行すると再度失敗します。失敗に接続の切断など、サーバーが提供した理由がない場合、メッセージは Could not update your spend limit. Press Enter to retry. と表示され、再試行は成功する可能性があります。v2.1.216 より前では、Claude Code はすべての失敗に対して汎用形式を表示していました。

対応方法：

• メッセージに理由が含まれている場合は、より低い金額など、それを満たす制限を選択します
• メッセージが汎用形式のみを表示する場合は、再試行します。失敗は一時的である可能性があります
• 変更が失敗し続ける場合は、ブラウザの claude.ai 請求設定 から代わりに行います

認証エラー

これらのエラーは、Claude Code が API に対してあなたの身元を証明できないことを意味します。任意の時点で /status を実行して、現在アクティブな認証情報を確認できます。

ログインしていない

このセッションで有効な認証情報が利用できません。

Not logged in · Please run /login

対応方法：

• /login を実行して、Claude サブスクリプションまたは Console アカウントで認証します
• 環境変数で認証されることを想定していた場合は、ANTHROPIC_API_KEY が claude を起動したシェルで設定およびエクスポートされていることを確認します
• CI または自動化で対話的ログインが不可能な場合は、起動時にキーを取得する apiKeyHelper スクリプトを設定します
• 認証の優先順位 を参照して、複数の認証情報が存在する場合に Claude Code が使用する認証情報を理解します

ログインを繰り返し求められる場合は、ログインしていないか、トークンの有効期限が切れている を参照して、システムクロックの確認と macOS 認証情報ストレージの復旧手順を確認してください。

認証方法を解決できませんでした

セッションが認証情報なしで API クライアントに到達しました。バックグラウンドセッション とクラウドセッションは、ワーカーが認証情報なしで起動したときにこのメッセージを表示します。対話的、-p、および Agent SDK の実行は、同じ条件を ログインしていない として報告し、この文字列をデバッグログにのみ書き込みます。そこで見つけた場合は、代わりにそのエントリに従ってください。

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

現在のバージョンでは、エラーはワーカープロセスで認証情報が利用できなかったことを意味します。v2.1.174 より前では、有効な認証情報が設定されていても、アイドル状態の事前初期化されたワーカーに割り当てられたバックグラウンドセッションがこの方法で失敗する可能性がありました。v2.1.176 より前では、クラウドセッションがアイドル状態で要求される前に失敗する可能性もありました。アップグレードして復旧してください。

対応方法：

• バックグラウンドまたはクラウドセッションでこれが表示され、認証情報が既に設定されている場合は、v2.1.176 以降にアップグレードします
• ANTHROPIC_API_KEY、CLAUDE_CODE_OAUTH_TOKEN、またはクラウドプロバイダーの認証情報が、対話的シェルだけでなく、ワーカーを起動する環境で設定されていることを確認します
• Agent SDK については、クイックスタートの認証設定 を参照してください
• 同じ環境の対話的セッションで /status を実行して、どの認証情報ソースが解決されるかを確認します

無効な API キー

ANTHROPIC_API_KEY 環境変数または apiKeyHelper スクリプトが API に拒否されたキーを返しました。または Claude Code が ANTHROPIC_API_KEY からのキーをブロックしてから送信しました。

Invalid API key · Fix external API key

メッセージが Fix external API key を超えて Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines). などの説明で続く場合、API はキーを見ていません。Claude Code は HTTP ヘッダーが運べない文字を見つけ、送信前にリクエストを停止しました。無効なリクエストヘッダー値 を参照して、説明を読み、値を修正する方法を確認してください。

対応方法：

• タイプミスがないか確認し、Console でキーが取り消されていないことを確認します
• 同じシェルで env | grep ANTHROPIC を実行するか、PowerShell で Get-ChildItem Env:ANTHROPIC* を実行します。direnv、dotenv シェルプラグイン、IDE ターミナルなどのツールは、プロジェクト内の .env ファイルから古いキーを明示的に設定せずに読み込むことができます
• ANTHROPIC_API_KEY をアンセットして /login を実行し、代わりにサブスクリプション認証を使用します
• キーが apiKeyHelper スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーを出力することを確認します
• /status を実行して、Claude Code が実際に使用している認証情報ソースを確認します

apiKeyHelper スクリプトが失敗しています

Claude Code が apiKeyHelper 設定でコマンドを実行しましたが、キーを取得できませんでした。キーがないと、リクエストはプレースホルダー認証情報で API に到達し、API は 401 で拒否します。ターミナルの Authentication パネルには、以下のいずれが発生したかが表示されます：

• コマンドがエラーで終了したか、タイムアウトしました
• コマンドが stdout に何も出力しませんでした
• コマンドがキー以外の何かを出力しました。ログイン バナーやログ行など。パネルは returned output that cannot be used as an API key を表示し、何が間違っているかを示します。v2.1.227 より前では、Claude Code は周囲の空白をトリミングした後、コマンドが出力したものを送信していました。

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

非対話モード では、stderr も apiKeyHelper failed: というプレフィックス付きの具体的な理由を含みます。

Claude Code はスクリプトを再実行し、このメッセージを表示する前にリクエストを最大 2 回まで再試行するため、失敗は 3 回の試行以内に表面化します。v2.1.208 より前では、Claude Code は完全な 再試行予算 を使用してプレースホルダー認証情報でリクエストを再送信し、その後、スクリプト失敗ではなく一般的な 401 認証エラーを報告していました。

/login を実行しても役に立ちません。ここでは、ヘルパーの出力が 優先順位 で保存されたログインより優先されます。設定が存在する限り。

対応方法：

• apiKeyHelper で設定されたコマンドをシェルで直接実行して、失敗を再現します
• コマンドが期限切れのセッションを報告する場合は、認証情報プロバイダーで再認証します。たとえば、SSO またはシークレットボールトに再度サインインします
• コマンドを修正して、stdout にのみキーを出力するようにします。単一のトークンとして、最大 16,384 文字の印字可能 ASCII で、終了コード 0 で終了します。apiKeyHelper で認証情報をローテーションする を参照して、動作するセットアップを確認してください。
• /status を実行して、apiKeyHelper がアクティブな認証情報ソースであることを確認します。コマンドが失敗するたびに、その終了コードとエラー出力がターミナルの Authentication パネルに表示されます。v2.1.212 より前では、パネルは Cloud authentication というタイトルでした。

無効なリクエストヘッダー値

Claude Code がリクエストヘッダーとして送信しようとしていた値に、HTTP ヘッダーが運べない文字が含まれています。改行、NUL バイト、または U+00FF より上の文字（カーリークォートやゼロ幅スペースなど）。Claude Code は何も送信される前にリクエストを停止し、修正する変数または設定に名前を付けます。通常の原因は、ドキュメントまたはチャットから貼り付けられた認証情報で、目に見えない文字または迷走改行が含まれていることです。

Claude Code は Claude API に直接リクエストを送信するとき、または LLM ゲートウェイ を通じてリクエストを送信するときにこのチェックを実行します。Amazon Bedrock などのサードパーティクラウドプロバイダーでは、Claude Code は送信前にこれを実行しません。

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

メッセージの最初の部分は、不正な値がどこから来たかによって異なります：

• Invalid auth token：ANTHROPIC_AUTH_TOKEN または CLAUDE_CODE_OAUTH_TOKEN からのベアラートークン
• Invalid ANTHROPIC_CUSTOM_HEADERS：ANTHROPIC_CUSTOM_HEADERS で設定したヘッダー名または値。説明は、distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS など、どの Name: Value ペアが問題かをカウントします。名前または値を繰り返さずに、両方を選択したため。
• Invalid request header from the environment：Claude Code が別の環境変数（CLAUDE_AGENT_SDK_CLIENT_APP など）からリクエストヘッダーにコピーする値。説明は修正する変数に名前を付けます。

Claude Code は、このチェックで検出された不正な ANTHROPIC_API_KEY を 無効な API キー として報告します。同じ末尾の説明付き。不正な保存された /login 認証情報を ログインしていない として報告します。代わりに /login を実行して新しいものを保存してください。apiKeyHelper スクリプトの出力はこのチェックに到達しません。Claude Code はスクリプトが実行されるときに検証し、HTTP ヘッダーが運べない出力は apiKeyHelper スクリプトが失敗しています で失敗します。

2 番目の · の後、メッセージは問題を説明します。この完全な例のように：

Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

位置は 1 から始まる文字をカウントします。説明は固定フレーズと文字数から構築されるため、値自体は含まれません。バイト順マーク、ゼロ幅スペース、カーリークォートなど、よく知られている目に見えない文字または活字文字である場合にのみ、問題のある文字に名前を付けます。その他はすべて a non-ASCII character として報告されます。

対応方法：

• メッセージが名前を付ける変数または設定を再設定し、同じソースから貼り付けるのではなく、報告された位置の周囲の文字を再入力します
• ANTHROPIC_CUSTOM_HEADERS の場合は、1 行に 1 つの Name: Value ペアを保持し、メッセージがカウントするペアを書き直します
• /status を実行して、どの認証情報ソースがアクティブであるかを確認します

このオーガニゼーションは無効になっています

Claude Code は、無効な Console オーガニゼーションから古い ANTHROPIC_API_KEY を使用しています。保存されたサブスクリプションログインがある場合、キーはそれをオーバーライドします。

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

· の後のヒントは、保存された認証情報によって異なります。最初の形式は、保存された /login がキーをアンセットした後に引き継ぐことができるときに表示され、2 番目はキーが唯一の認証情報である場合に表示されます。

環境変数は /login より優先されるため、シェルプロファイルでエクスポートされたキーまたは .env ファイルから読み込まれたキーは、動作する Pro または Max サブスクリプションがある場合でも使用されます。非対話モード（-p）では、キーが存在する場合は常に使用されます。

対応方法：

• 現在のシェルで ANTHROPIC_API_KEY をアンセットし、シェルプロファイルから削除してから、claude を再起動します
• メッセージが Update or unset と言う場合、フォールバックする保存されたログインがありません。キーをアンセットして /login を実行するか、アクティブな Console オーガニゼーションからのキーに置き換えます
• その後 /status を実行して、アクティブな認証情報がサブスクリプションであることを確認します
• 環境変数が設定されておらず、エラーが続く場合、無効なオーガニゼーションは /login に関連付けられたものです。サポートに連絡するか、別のアカウントでサインインしてください。

オーガニゼーションが API キー認証を無効にしました

このメッセージには Claude Code v2.1.169 以降が必要です。Console オーガニゼーションの管理者が API キー認証をオフにしたため、API は Claude Code が送信しているキーを拒否します。· の後の復旧ヒントは、キーがどこから来たかによって異なります：

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

環境変数と apiKeyHelper は /login より優先されるため、どちらかがまだキーを供給している間は /login を実行するだけでは役に立ちません。認証の優先順位 を参照してください。

対応方法：

• メッセージが ANTHROPIC_API_KEY に名前を付ける場合は、現在のシェルでアンセットし、シェルプロファイルまたは .env ファイルから削除してから、claude を再起動します
• メッセージが apiKeyHelper に名前を付ける場合は、settings.json から apiKeyHelper 設定を削除します
• /login を実行して claude.ai アカウントでサインインします
• その後 /status を実行して、アクティブな認証情報が API キーではなくサブスクリプションであることを確認します
• 自動化に API キー認証が必要な場合は、オーガニゼーション管理者に Console で再度有効にするよう依頼してください

オーガニゼーションが Claude サブスクリプションアクセスを無効にしました

Claude オーガニゼーションは、サブスクリプションログインで Claude Code にサインインすることを許可していません。同じアカウントで /login を再度実行すると、同じエラーが返されます。

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

これはサーバー側のオーガニゼーション設定であるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。

Agent SDK と -p 非対話モードは、これを oauth_org_not_allowed エラーコードとして表示します。

対応方法：

• 管理者にオーガニゼーションの Claude Code アクセスを有効にするよう依頼してください
• サブスクリプションの代わりに Console API キーで認証します。セットアップについては、Claude Console 認証 を参照してください
• あなたが管理者で、アクセスを有効にするオプションが表示されない場合は、Anthropic サポート に連絡してください

ルーチンはオーガニゼーションのポリシーで無効になっています

Team または Enterprise オーガニゼーションの Owner がオーガニゼーションレベルでルーチンをオフにしました。エラーは、Routines UI on claude.ai/code などからルーチンを作成または実行しようとするときに表示されます。Claude Code v2.1.227 以降では、同じ設定が CLI で /schedule も非表示にします。

Routines are disabled by your organization's policy.

これはサーバー側の設定であるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。

対応方法：

• オーガニゼーションの Owner に claude.ai/admin-settings/claude-code で Routines トグルを有効にするよう依頼してください
• オーガニゼーションレベルのルーチンを必要としない 1 回限りのスケジュール作業については、スケジュール済みタスク を参照してください

Remote Control には Anthropic API が必要です

セッションが Anthropic API に直接通信していないため、Remote Control がペアリングする claude.ai バックエンドがありません。

Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

2 番目の文は、セッションを Anthropic API から遠ざけた原因を説明します。v2.1.219 より前では、メッセージは最初の文だけでした。原因によって、メッセージは以下に名前を付けます：

• CLAUDE_CODE_USE_* プロバイダー変数。Amazon Bedrock の CLAUDE_CODE_USE_BEDROCK または Google Cloud の Agent Platform の CLAUDE_CODE_USE_VERTEX など
• ANTHROPIC_BASE_URL が api.anthropic.com 以外のホストを指しています。LLM ゲートウェイ またはプロキシなど。claude.ai でサインインしている場合でも。v2.1.196 より前では、カスタムベース URL は Remote Control をブロックしませんでした
• ANTHROPIC_UNIX_SOCKET が設定されているため、セッションは api.anthropic.com ではなくローカルソケットを通じてリクエストを送信します
• /login を通じた enterprise クラウドゲートウェイ サインイン。Remote Control をサポートしておらず、アンセットする変数がありません

対応方法：

• メッセージが名前を付ける変数（CLAUDE_CODE_USE_BEDROCK または ANTHROPIC_BASE_URL など）をアンセットし、セッションを再起動するか、Anthropic API に直接通信するセッションから Remote Control を起動します
• 変数がシェルで設定されていない場合は、設定ファイル の env キーを確認してください。これはすべてのセッションに環境変数を適用します
• この他の Remote Control スタートアップメッセージについては、Remote Control のトラブルシューティング を参照してください

Remote Control がログインを更新できませんでした

Claude Code は、保存された claude.ai ログインを使用して取得および更新する短命の認証情報で、ライブ Remote Control 接続を実行します。claude.ai がそのログインの受け入れを停止するか、Claude Code に保存されたログインが残っていない場合、Claude Code は Remote Control を停止し、再度サインインするよう求めます。どちらの失敗も、Claude Code がまだ接続しているときまたは後で認証情報を更新するときに発生する可能性があります。

Claude Code がログインサービスに保存されたログインの更新を要求し、応答がない場合、Remote Control を実行し続け、接続の現在の認証情報がまだ有効な間に更新を再試行します。Claude Code がログインサービスに到達できない、リクエストがタイムアウトする、またはサービスがログインを拒否せずに失敗する場合、更新は応答を取得しません。ログインサービスがその認証情報の有効期限が切れるときにまだ応答していない場合、Claude Code は Remote Control を停止し、OAuth token refresh failed を報告します。

Claude Code が Remote Control を停止すると、警告と Remote Control disconnected で始まるトランスクリプト行に理由が表示されます。ローカルセッションは Remote Control なしで実行し続けます。このセクションでは、これらの行をカバーしています：

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

Claude Code はメッセージの中央に原因に名前を付けます：

• Claude.ai login expired および Claude.ai login was rejected：claude.ai はもはや保存されたログイントークンを受け入れません。有効期限が切れたか取り消されたため
• OAuth token unavailable：接続の認証情報が更新期限に達したときに、Claude Code に保存されたログイントークンがありませんでした
• OAuth token refresh failed：claude.ai が Claude Code が再接続しているときに保存されたログイントークンを拒否し、トークンの更新は新しいものを生成しませんでした
• JWT refresh failed: no OAuth token：Claude Code は更新するための保存されたログイントークンを見つけませんでした
• Signed out of Claude：このマシンで、たとえば別のターミナルで /logout を実行してサインアウトしたため、Claude Code は接続を更新するための保存されたログインが残っていません

対応方法：

• /login を実行して再度サインインします
• /remote-control を実行してセッションを再接続します。 run /login to restore Remote Control で終わるメッセージはこのステップを必要としません。Claude Code はサインイン後に自動的に再接続します。

v2.1.224 より前では、OAuth token refresh failed — run /login to re-authenticate は OAuth token refresh failed — re-authenticate, then re-enable Remote Control と読み、JWT refresh failed: no OAuth token — run /login は no OAuth token available for recovery (code <N>) と読みました。 Claude.ai login expired、Claude.ai login was rejected、および OAuth token unavailable メッセージは v2.1.225 で追加されました。

v2.1.238 より前では、Claude Code は現在 Signed out of Claude と言うケースを JWT refresh failed: no OAuth token — run /login として報告し、1 つのログイン更新が応答を取得しないとすぐに Remote Control を停止しました。Claude.ai login expired — run /login to restore Remote Control で。

サインイン済みアカウントが変更されたため Remote Control が停止しました

Claude Code は、このマシンで別の claude.ai アカウントまたはオーガニゼーションにサインインしたときに、Remote Control セッション中にこの行を表示します。別のターミナルで /login を実行するなど、Claude Code セッションの外でスイッチを作成しました。

/login でサインインしている間に開始した Remote Control セッションは、その時点でサインインしていた claude.ai アカウントとオーガニゼーションに属しています。

Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

Claude Code は claude.ai がアカウントまたはオーガニゼーションが変更されたことを確認するとすぐに Remote Control セッションを停止します。ローカルセッションは Remote Control なしで実行し続けます。

対応方法：

• /remote-control を実行して、現在のアカウントまたはオーガニゼーションの下で新しい Remote Control セッションを開始します
• 戻すには、/login を実行して前のアカウントまたはオーガニゼーションに再度サインインします。その後、/remote-control を実行します。

v2.1.234 より前では、Claude Code は Claude Code セッションの外でアカウントまたはオーガニゼーションを切り替えたときに気付きませんでした。Claude Code は Remote Control セッションを接続したままにしておきました。Remote Control サーバーへの後のリクエストが Remote Control server rejected the request (HTTP 404) で失敗するまで。その失敗はスイッチの数時間後に来る可能性があります。

セッションを実行しているアプリがサインアウトしたか、アカウントを切り替えたため Remote Control が停止しました

Claude デスクトップアプリまたは IDE がセッションをホストしている場合、Claude Code は /login ではなくそのアプリからログイントークンを取得します。claude.ai がそのトークンを拒否すると、Claude Code はアプリに新しいものを要求します。アプリが、サインアウトしたか、別の Claude アカウントにサインインしたと答える場合、Claude Code は Remote Control セッションを終了し、アプリに次のいずれかの行を送信します：

Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

ローカルセッションは Remote Control なしで実行し続けます。

対応方法：

• アプリがサインアウトしている場合は、再度サインインしてから、アプリで Remote Control をオンに戻します
• アプリがアカウントを切り替えた場合、Claude Code は終了したセッションを新しいアカウントの下で続行できません。そのアカウントの下で新しい Remote Control セッションを開始します。

v2.1.238 より前では、Claude Code は両方のケースで Remote Control がログインを更新できませんでした の下にリストされている run /login メッセージをアプリに送信していました。

OAuth トークンが取り消されたか、有効期限が切れています

保存されたログインは有効ではなくなりました。取り消されたトークンは、どこからでもサインアウトしたか、管理者がアクセスを削除したことを意味します。有効期限が切れたトークンは、自動更新がセッション中に失敗したことを意味します。

どちらのメッセージも、Claude Code が送信したリクエストに対して API が返した拒否を報告します。保存されたログインが失敗した更新後に既にクリアされている場合、代わりに ログインの有効期限が切れています が表示されます。CLAUDE_CODE_OAUTH_TOKEN で長命トークンで認証する場合、そのトークンが有効期限切れまたは取り消されたときに同じメッセージが表示されます。

OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...

対応方法：

• /login を実行して再度サインインします
• 再認証後、同じセッション内でエラーが返される場合は、最初に /logout を実行して保存されたトークンを完全にクリアしてから、/login を実行します
• CLAUDE_CODE_OAUTH_TOKEN 環境変数で認証する場合、Claude Code はリクエストが 401 で失敗した後、保存されたログインのトークンに切り替えるのではなく、設定した値を送信し続けます。/status はこの認証情報を Auth token 行として表示します。CLAUDE_CODE_OAUTH_TOKEN を読みます。claude setup-token で新しいトークンを生成して再起動するか、変数をアンセットして /login を実行します。v2.1.225 より前では、Claude Code はセッション中に変数の値を保存されたログインからの短命アクセストークンに置き換える可能性があり、そのトークンの有効期限が切れるとセッションは再び 401 エラーで失敗しました。
• 起動全体でログインを繰り返し求められる場合は、トラブルシューティング のシステムクロック確認と macOS 認証情報ストレージ復旧手順を参照してください
• 403 Forbidden や OAuth ブラウザの問題を含む他の失敗については、ログインと認証 を参照してください

API エラー：401 無効な認証認証情報

API は認証情報の形式を認識しましたが、その背後にあるアカウントまたはオーガニゼーションを拒否しました。Anthropic は、認証情報が最近取り消されたとき、オーガニゼーションが無効になったか、アクセスが削除されたとき、またはアカウント自体が非アクティブ化されたときにこのメッセージを返します。有効期限切れトークンが原因ではありません。認証情報は保存されたログインまたは承認された ANTHROPIC_API_KEY である可能性があり、修正は異なるため、まず /status を実行してどちらがアクティブであるかを確認してください。

Please run /login · API Error: 401 Invalid authentication credentials

対応方法：

• /status が API key 行を表示し、使用中でないとマークされていない場合、承認された ANTHROPIC_API_KEY がアクティブな認証情報であり、ログインより優先されるため、/login はそれを置き換えません。Claude Console でキーをローテーションするか、unset ANTHROPIC_API_KEY を実行するか、PowerShell で Remove-Item Env:ANTHROPIC_API_KEY を実行してサブスクリプションにフォールバックします。
• /status がログインのみを表示する場合は、/login を 1 回実行します。認証情報が取り消された場合、新しいログインがそれを置き換えます。
• 同じログインアカウントで同じメッセージが返される場合、アカウントまたはオーガニゼーションはアクティブではなくなりました。/status が報告するアカウントとオーガニゼーションを確認し、オーガニゼーション管理者にアクセスを復元するよう依頼してください。
• ANTHROPIC_BASE_URL が LLM ゲートウェイ を指している場合、401 の後のテキストは Anthropic のメッセージではなくゲートウェイのメッセージであり、/login はそれを変更しません。代わりにゲートウェイが期待する認証情報を修正してください。

ログインの有効期限が切れています

Claude Code は保存された claude.ai または Claude Console ログインを更新しようとしましたが、OAuth サービスは保存された更新トークンを拒否したため、Claude Code は保存された認証情報をクリアしました。その後、各モデルリクエストは、/login のみが新しい認証情報を作成できるため、API に到達する前にローカルで停止します。

v2.1.206 より前では、Claude Code はモデルリクエストを環境に残っている認証情報で送信し、すべてのモデルは 選択されたモデルに問題があります または 401 で失敗しました。サインインを求めるプロンプトの代わりに。

Login expired · Please run /login

非対話モード（-p）および Agent SDK では、メッセージは次のように読み、構造化エラーコードは authentication_failed です：

Failed to authenticate: OAuth session expired and could not be refreshed

これは OAuth トークンが取り消されたか、有効期限が切れています と同じ状態ではありません。これらのメッセージは API が返した拒否を報告します。Claude Code 自体は、既に更新に失敗したログインに対して Login expired を生成するため、リクエストを送信しません。更新が失敗する理由がログインが古いのではなくアカウント自体が中断されている場合、Claude Code は代わりに アカウントが保留中です を表示します。

API キー、CLAUDE_CODE_OAUTH_TOKEN、またはサードパーティプロバイダーで認証されたセッションは、保存されたログインを使用せず、このメッセージを表示しません。

リクエストが失敗する前にこの状態を確認できます。/status は Login 行を表示します。Expired — log in again を読み、保存されている有効期限切れログインのオーガニゼーションとメールを読みます。行は、保存されたログインがアクティブな認証情報であり、もはや更新できない場合にのみ表示されます。別の方法で認証されたセッションは、有効期限切れログインが保存されたままであっても、行を表示しません。v2.1.210 より前では、/status はこの状態で、クリアされた認証情報がそれを報告するものが何もないため、ログインが存在したことを示していません。

対応方法：

• /login を実行して再度サインインします。サインインせずに再試行すると、すべてのリクエストで同じメッセージが表示されます。
• 非対話モードでは、同じ環境で claude を実行し、/login を完了してから、コマンドを再実行します。対話的にサインインできない自動化の場合は、ANTHROPIC_API_KEY で認証するか、claude setup-token で長命トークンを生成します。
• サインインが失敗し続ける場合は、ログインと認証 を参照してください

Claude ログインが受け入れられません

クラウドセッション を開始しようとしましたが、サーバーは 401 で作成を拒否しました。このマシンが送信した Claude ログインを受け入れませんでした。通常、ログインが有効期限切れまたは取り消されたためです。

行の最初の部分は、サーバーが 1 つを与える場合はサーバー自身の理由です。それ以外の場合、行は次のように読みます：

Claude login not accepted · Run /login, then try again

対応方法：

• /login を実行し、サインインを完了してから、セッションを再度開始します

管理者ポリシーがクラウドゲートウェイサインインを必要とします

このマシンの管理者の 管理設定 が forceLoginMethod を "gateway" に設定したか、forceLoginGatewayUrl を設定しました。CLAUDE_CODE_USE_BEDROCK などの変数を通じてクラウドプロバイダーを選択しない限り、Claude Code は Claude apps gateway サインインのみを受け入れます。2 つのメッセージのいずれかが表示されます：

Not signed in to the Cloud gateway — run /login.

セッションにゲートウェイサインインがない場合、モデルリクエストはこのメッセージで失敗します。たとえば、ポリシーがマシンに到達してから /login を実行していないため。

ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、または apiKeyHelper 認証情報も設定されており、管理設定が forceLoginMethod を設定している場合、Claude Code は代わりに起動時に次のメッセージで終了します：

Administrator policy requires a Cloud gateway sign-in on this machine; the
Anthropic-issued credential configured here (ANTHROPIC_API_KEY,
ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.

対応方法：

• /login を実行し、Cloud gateway 画面でサインインを完了します
• スタートアップメッセージについては、設定した ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、または apiKeyHelper 設定を削除し、claude を起動して /login を実行します
• マシンがゲートウェイを必要としないと思われる場合は、それを管理する管理者に、管理設定から forceLoginMethod と forceLoginGatewayUrl を削除するよう依頼してください

v2.1.265 では、回帰により、API キー、apiKeyHelper、またはカスタムヘッダーで認証し、マシンに管理者要件がない一部の LLM ゲートウェイおよびプロキシ設定でも最初のメッセージが表示されました。v2.1.266 以降に更新してください。設定を変更する必要はありません。

v2.1.261 より前では、forceLoginMethod を "gateway" に設定したマシンでは、Claude Code は古い保存されたログインを使用し、モデルリクエストを失敗させず、設定された環境認証情報を This machine's managed settings require a first-party login で報告しました。スタートアップメッセージの代わりに。v2.1.265 より前では、管理設定が forceLoginGatewayUrl のみを設定したマシンはゲートウェイサインインを必要とせず、Claude Code はそこで古い認証情報を使用していました。

アカウントが保留中です

Claude アカウントがサスペンドされています。Claude Code は、保存されたログインを更新しようとして保留について学ぶときに最初のメッセージを表示し、2 番目はブラウザで完了したサインインが報告するときに表示されます：

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

同じアカウントで再度サインインしても、保留がアカウントにあるため、メッセージはクリアされません。ログインではなく。非対話モード（-p）および Agent SDK では、構造化エラーコードは account_on_hold です。v2.1.235 より前では、Claude Code は保留中のアカウントを ログインの有効期限が切れています · /login を実行してください として報告しました。その復旧手順は保留をクリアできません。

対応方法：

• メッセージのリンクを開いて、保留の詳細を表示するか、それに異議を唱えます
• 保留の影響を受けない別の Claude アカウントまたは API キーがある場合は、保留が解決されている間、作業を続けることができます。そのアカウントで /login を実行するか、ANTHROPIC_API_KEY でキーを設定します

Anthropic プロファイルログインの有効期限が切れています

Claude Code は、保存されたログイン認証情報が有効期限切れの Anthropic 認証情報プロファイルを通じて認証しており、プロファイルは Claude Code が更新するために使用できる更新認証情報を保持していません。Claude Code は、同じ有効期限切れ認証情報を読み取るため、各リクエストをローカルで停止します。

Anthropic profile login expired · Re-authenticate your Anthropic profile
Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile

これは、アクティブな認証情報が Anthropic 認証情報プロファイルから来ている場合にのみ表示されます。ANTHROPIC_PROFILE 環境変数で選択するもの。Claude Code が Anthropic 設定ディレクトリでアクティブなプロファイルとして発見するもの。または Claude Code が API キーなしでサインイン したときに書き込んだもの。/login の claude.ai オプション、API キー、ANTHROPIC_AUTH_TOKEN などのベアラートークン、またはサードパーティプロバイダーで認証されたセッションは、このメッセージを表示しません。

キーレスサインインを提供する マシンでは、/login を実行し、Anthropic Console アカウントを選択して、再度サインインして、キーレス Console サインインまたは Claude Platform CLI の ant auth login が書き込んだプロファイルを更新します。Claude Code はそのプロファイルの有効期限切れ認証情報を置き換えます。フェデレーションプロファイルまたは別のツールが作成したプロファイルの場合、/login は認証情報を更新しません。表示されるフォームは、プロファイルを明示的に選択したか、Claude Code がそれを発見したかによって異なります：

• ANTHROPIC_PROFILE を明示的に設定すると、メッセージは Re-authenticate your Anthropic profile で終わります。
• Claude Code が設定ディレクトリからプロファイルを発見した場合、メッセージは /login を提供します。Claude Code は動作する /login を発見されたプロファイルより優先し、claude.ai または Console アカウントで認証します。v2.1.234 より前では、Claude Code はこのケースでも Re-authenticate your Anthropic profile フォームを表示していました。

対応方法：

• プロファイルに再度サインインしてから、再試行します。キーレスサインインを提供する マシンでは、/login を実行し、キーレス Console サインインまたは Claude Platform CLI の ant auth login が書き込んだプロファイルの Anthropic Console アカウントを選択します。他のプロファイルの場合は、それらを作成したツールを使用します
• 管理者がプロファイルの認証情報をプロビジョニングした場合は、新しいものを発行するよう依頼してください
• /status を実行してアクティブな認証情報ソースとプロファイル名を確認します
• プロファイルの使用を停止するには、設定した場合は ANTHROPIC_PROFILE をアンセットし、/login または ANTHROPIC_API_KEY などの別の方法で認証します

OAuth スコープ要件

保存されたトークンは、新しい機能が必要とする権限スコープより前のものです。これは /usage とステータス行の使用状況インジケーターから最も頻繁に表示されます：

OAuth token does not meet scope requirement: user:profile

対応方法：

• /login を実行して、現在のスコープで新しいトークンを取得します。最初にログアウトする必要はありません。

claude.ai がセッショントークンを拒否しました

claude.ai コネクタ リクエストが失敗しました。claude.ai が Claude Code ログインからのトークンを拒否したため。通常、有効期限切れのログイン。更新できませんでした。拒否されたトークンはコネクタ自身の claude.ai での認可ではなく、ログインであるため、コネクタを再度認可しても解決しません。/mcp では、コネクタは connected · session token rejected として表示され、その詳細ビューは次のように読みます：

claude.ai rejected the session token. Run /login, then reconnect.

対応方法：

• /login を実行して再度サインインします
• /mcp からコネクタを再接続するか、/mcp reconnect <server> を実行します。再度サインインする前に再接続すると、コネクタは同じ状態のままになります。/mcp パネルの Reconnect オプションは your claude.ai session token was rejected を報告します。入力された /mcp reconnect <server> フォームは、トークンがまだ拒否されていても、成功した再接続を報告します。

v2.1.222 より前では、Claude Code はコネクタを認証が必要として標記しました。これはコネクタの認可フローを指しましたが、完了してもこの状態は解決しませんでした。

MCP サーバーがもう一度サインインするよう求めています

リモート MCP サーバー がセッション中のツール呼び出しで認証情報を拒否しました。通常、サインインまたはトークンが有効期限切れになったため。ツール呼び出しは失敗し、/mcp はサーバーを 認証が必要 として標記します。

Claude Code からサインインするサーバー（claude.ai コネクタを含む）の場合、サインインが有効期限切れまたは取り消されました：

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

/mcp を実行し、サーバーを選択し、そのメニューから再度サインインします。

headersHelper スクリプトで設定されたサーバーの場合、Claude Code はこれを表示する前にヘルパーを再実行し、呼び出しを 1 回再試行しました：

MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

ヘルパーがサーバーが受け入れる認証情報を返すことを確認してから、/mcp から再接続します。これはヘルパーを再実行します。

設定に静的な Authorization ヘッダーを持つサーバーの場合：

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

サーバーが設定されている場所でヘッダー値を更新してから、/mcp から再接続します。

v2.1.273 より前では、3 つのケースすべてが MCP server "<name>" requires re-authorization (token expired) を表示していました。

サーバーは、HTTP 403 insufficient_scope でツール呼び出しを拒否して、スコープを認可するよう求めることもできます。時々、トークンが既にリストしているもの。メッセージはそのスコープに名前を付けます：

MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

/mcp を実行し、サーバーを選択し、そのメニューから再度認証します。

サーバーの設定が oauth.scopes も authServerMetadataUrl も設定しない場合、Claude Code はサーバーが名前を付けたスコープをリクエストします。どちらかの設定を使用すると、Claude Code はその設定のスコープをリクエストします。oauth.scopes をピン留めした場合は、再度認証する前にそのリストに欠落しているスコープを追加します。

v2.1.274 より前では、このケースは needs you to sign in again メッセージを表示し、v2.1.273 より前は他のケースのように requires re-authorization (token expired) を表示していました。

認可応答での発行者の不一致

MCP OAuth サインイン 中に、認可サーバーは Claude Code に iss パラメーターでリダイレクトバックしました。これは Claude Code がサーバーの OAuth メタデータから期待していた発行者に名前を付けていません。このステップでの間違った発行者は、認可サーバーの混合攻撃がどのように見えるかです。Claude Code は認可コードを交換する代わりにサインインを失敗させます。Claude Code はブラウザサインイン後の /mcp サーバーメニューにエラーを表示します：

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

expected はサーバーの OAuth メタデータからの発行者であり、received はリダイレクトが運んだ iss 値です。リダイレクトが iss パラメーターを運ばないサインインはチェックに合格します。サーバーのメタデータが authorization_response_iss_parameter_supported を設定しない限り。その場合、Claude Code はサインインを失敗させます。

対応方法：

• /mcp からサインインを再度試してください
• エラーが繰り返される場合は、サーバーオペレーターに報告してください。修正はサーバー側です。認可サーバーは、メタデータで宣伝する同じ発行者を iss パラメーターで返す必要があります
• サーバーが修正されている間に接続するには、MCP_SDK_GENERATION=v1 で Claude Code を起動します。その ランタイム はこのチェックを実行しません。これは混合攻撃に対する保護を削除するため、サーバー側の修正を優先してください

v2.1.232 より前では、Claude Code は段階的なロールアウトでのみ v2 ランタイムを使用するか、MCP_SDK_GENERATION=v2 を設定したときに使用していました。

AWS 認証情報が有効期限切れまたは無効です

AWS セッショントークンが有効期限切れまたは拒否されました。このメッセージは Claude Platform on AWS または Mantle エンドポイント からの 401 に表示されます。これらのプロバイダーが有効期限切れのセキュリティトークンを報告する方法です。

中央のアクション ヒントはセットアップによって異なります。安定した部分は先頭の AWS credentials expired or invalid です：

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

v2.1.273 より前では、このメッセージは awsAuthRefresh が設定されている場合にのみ表示されました。

対応方法：

• ヒントが認証情報がこの環境で管理されていると言う場合、Claude Code を起動したアプリが認証情報を所有し、ここの他のステップは適用されません。再試行するか、管理者に連絡してください
• awsAuthRefresh が設定されている場合は、メッセージで名前が付けられたコマンド（aws sso login --profile myprofile など）を別のターミナルで実行し、ブラウザサインインを完了してから、再試行します。それ以外の場合は、自分で使用する AWS 認証情報を更新します。SSO サインイン、アクセスキー、API キー、またはプロキシトークン
• 対話的セッションで awsAuthRefresh が設定されている場合は、代わりに /login を実行し、3rd-party platform を選択してから、Using 3rd-party platforms の下で Claude Platform on AWS · refresh credentials を選択して、Claude Code を再起動せずに同じコマンドを実行できます。AWS 認証情報を設定する を参照してください
• 更新コマンドが成功した後もエラーが繰り返される場合は、同じシェルとプロファイルで aws sts get-caller-identity を使用して Claude Code の外で ID が有効であることを確認します

AWS 認証が失敗しました

AWS プロバイダーが 403 を返したか、Amazon Bedrock が 401 を返しました。

Amazon Bedrock は有効期限切れのセキュリティトークンを 403 として報告しますが、403 は認可拒否（IAM 権限の欠落など AccessDeniedException）を報告する方法でもあります。Claude Code はこれら 2 つの原因を区別できません。

Amazon Bedrock からの 401 は、リクエストパスの他の何か（企業プロキシなど）から来ているため、AWS 認証情報が有効期限切れまたは無効です の下ではなくここに着地します。そのエンドポイントからの 401 は通常、他の何かから来ています。

認証情報の更新は有効期限切れトークンを修正でき、他の原因を修正できないため、メッセージは両方を提供します：

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

中央のアクション ヒントはセットアップによって異なります。安定した部分は先頭の AWS authentication failed です。

403 が、指定されたモデル ID でモデルへのアクセス権がないという Amazon Bedrock の答えである場合、ヒントは代わりに Amazon Bedrock コンソールでアカウントとリージョンのモデルを有効にするよう指示します。

v2.1.273 より前では、このメッセージは awsAuthRefresh が設定されている場合にのみ表示されました。

対応方法：

• ヒントが認証情報がこの環境で管理されていると言う場合、Claude Code を起動したアプリが認証情報を所有し、ここの他のステップは適用されません。再試行するか、管理者に連絡してください
• 有効期限切れ認証情報が原因である可能性があるため、AWS 認証情報を更新します。設定されている場合は awsAuthRefresh コマンドで名前が付けられたコマンドを実行するか、SSO サインイン、アクセスキー、API キー、またはプロキシトークンを自分で更新します
• 認証情報が最新の場合は、IAM 設定 の IAM 権限が使用している ID に接続されていることを確認し、選択されたモデルがアカウントとリージョンで有効になっていることを確認します
• aws sts get-caller-identity を実行してリクエストが使用する ID を確認します。古い AWS_PROFILE またはデフォルトプロファイルは権限の不一致の一般的な原因です

Google Cloud 認証情報が有効期限切れまたは無効です

Google Cloud の Agent Platform の Google Cloud 認証情報が有効期限切れまたは拒否されました。リクエストが 401 を返しました。これは Agent Platform が認証情報の有効期限切れを報告する方法です。

中央のアクション ヒントはセットアップによって異なります。安定した部分は先頭の Google Cloud credentials expired or invalid です：

Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

対応方法：

• ヒントが認証情報がこの環境で管理されていると言う場合、Claude Code を起動したアプリが認証情報を所有し、ここの他のステップは適用されません。再試行するか、管理者に連絡してください
• アプリケーションデフォルト認証情報で認証する場合は、メッセージで名前が付けられた gcpAuthRefresh コマンドまたは gcloud auth application-default login を実行し、サインインを完了してから、再試行します
• LLM ゲートウェイ を通じてルーティングし、CLAUDE_CODE_SKIP_VERTEX_AUTH が設定されている場合は、ANTHROPIC_AUTH_TOKEN または ANTHROPIC_CUSTOM_HEADERS のゲートウェイトークンを更新してから、再試行します
• サービスアカウントキーファイルで認証する場合は、GOOGLE_APPLICATION_CREDENTIALS が有効なキーを指していることを確認します。GCP 認証情報を設定する を参照してください
• 更新後もエラーが繰り返される場合は、同じシェルで gcloud auth application-default print-access-token を使用して Claude Code の外で ID が機能することを確認します

v2.1.273 より前では、Agent Platform からの 401 は、Google Cloud 認証情報を更新できない一般的な Please run /login または Failed to authenticate メッセージを表示していました。

Google Cloud 認証が失敗しました

Google Cloud の Agent Platform が 403 を返しました。これは有効期限切れ認証情報ではなく認可拒否に使用します。通常、認証する ID に IAM 権限がないか、モデルがプロジェクトで有効になっていません。

中央のアクション ヒントはセットアップによって異なります。安定した部分は先頭の Google Cloud authentication failed です：

Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

対応方法：

• ヒントが認証情報がこの環境で管理されていると言う場合、Claude Code を起動したアプリが認証情報を所有し、ここの他のステップは適用されません。再試行するか、管理者に連絡してください
• 認証する ID に IAM 設定 のロールが付与されていることを確認します
• モデルがプロジェクトで有効になっていることを確認します。モデルアクセスをリクエストする を参照してください

v2.1.273 より前では、Agent Platform からの 403 は、Google Cloud 認証情報を更新できない一般的な Please run /login または Failed to authenticate メッセージを表示していました。

Microsoft Foundry 認証が失敗しました

Microsoft Foundry が 401 または 403 を返しました。リクエストの Azure 認証情報が拒否されたか、その背後にある ID が Foundry リソースへのアクセス権を持っていません。/login は Azure 認証情報をミントできません。中央のアクション ヒントはセットアップによって異なります。安定した部分は先頭の Microsoft Foundry authentication failed です：

Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

対応方法：

• ヒントが認証情報がこの環境で管理されていると言う場合、Claude Code を起動したアプリが認証情報を所有し、ここの他のステップは適用されません。再試行するか、管理者に連絡してください
• Azure 認証情報を設定する で設定した認証情報を更新します。ANTHROPIC_FOUNDRY_API_KEY をローテーションするか、新しい ANTHROPIC_FOUNDRY_AUTH_TOKEN をミントするか、az login を実行してデフォルト Microsoft Entra 認証情報チェーンが再度サインインできるようにします
• 認証情報が最新の場合は、ID が Foundry リソースへのアクセス権を持っていることを確認します。Azure RBAC 設定 を参照してください

v2.1.273 より前では、Microsoft Foundry からの 401 または 403 は、Azure 認証情報を更新できない一般的な Please run /login または Failed to authenticate メッセージを表示していました。

AWS またはGoogle Cloud 認証情報を読み込めませんでした

Claude Code は、実行されているマシンの AWS 認証情報プロバイダーチェーンまたは Google アプリケーションデフォルト認証情報から使用可能な認証情報を取得できなかったため、クラウドプロバイダーにリクエストが到達しませんでした。Claude Code はキャッシュされた認証情報をクリアし、表示する前に 2 回再試行します。· の後の詳細は、有効期限切れの SSO セッション、Could not load the default credentials として報告される欠落アプリケーションデフォルト認証情報、または invalid_grant として報告される取り消されたサインインなど、特定の原因に名前を付けます：

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

非対話モード で -p を使用し、Agent SDK では、構造化エラーコードは cloud_credential_error です。v2.1.267 より前では、メッセージは API Error: の後の詳細テキストのみを表示し、構造化コードは server_error または unknown でした。

対応方法：

• aws sso login --profile myprofile または gcloud auth application-default login などのプロバイダーのサインインコマンドを実行してから、再試行します。Bedrock、Agent Platform、または Foundry 認証情報が読み込まれていない は、Claude Code の外で認証情報を確認する方法を示しています
• 詳細が AWS default-chain credential resolve timed out と読む場合は、チェーンが失敗するのではなくハングしたため、代わりに AWS default-chain credential resolve timed out に従ってください

AWS default-chain credential resolve がタイムアウトしました

AWS デフォルト認証情報プロバイダーチェーンが 60 秒以内に認証情報を生成しなかったため、Claude Code は解決を停止し、リクエストを失敗させました。このタイムアウトは AWS またはGoogle Cloud 認証情報を読み込めませんでした の 1 つの原因です。失敗はローカル認証情報解決です。リクエストは Amazon Bedrock、Claude Platform on AWS、または Mantle エンドポイント に到達しませんでした。Claude Code は 認証情報キャッシュ をクリアし、このエラーが表示される前に再試行するため、このエラーが表示されるまでにチェーンは繰り返された試行でスタールしています。

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

一般的な原因は、AWS プロファイルの credential_process コマンドが受け取ることができない入力を待機し、インスタンスメタデータサービス（IMDS）がチェーンのプローブに応答しないコンテナまたは VM です。

v2.1.267 より前では、メッセージは API Error: AWS default-chain credential resolve timed out と読みました。 v2.1.207 より前では、スタールしたチェーンはリクエストを無期限に待機したままにしておきました。

対応方法：

• 同じシェルで同じ AWS_PROFILE を使用して aws sts get-caller-identity を実行します。それもハングする場合は、プロファイルを修正します。対話的にプロンプトを表示する credential_process コマンドが一般的な原因です。
• Claude Code を起動する前にサインインステップを完了します。たとえば aws sso login --profile myprofile。これにより、チェーンはブラウザフローを待機する代わりにローカル SSO キャッシュから解決されます
• チェーンが aws-vault などのラッパーを使用した MFA を使用した SSO など、60 秒以上の正当なインタラクティブサインインを実行する場合は、ミリ秒単位で制限を上げます。CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

Bedrock セットアップ検証が AWS を待機中にタイムアウトしました

Bedrock セットアップウィザード の認証情報検証中の AWS への呼び出し（認証情報ルックアップまたは ID チェックなど）が 60 秒の制限内に完了しませんでした。ウィザードは待機を停止し、検証ステップを失敗させます：

Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

数値は制限を反映しています。デフォルトでは 60 秒、または CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS で設定した値。

一般的な原因は、SSO トークン更新を含む AWS へのリクエストをスタールさせるネットワークまたはプロキシ、および見えない入力を待機しているまだ認証情報ヘルパーです。ヘルパーが正当にもっと時間が必要な場合にのみ制限を上げます。

AWS への単一のスタールしたリクエストは、独自のリクエストごとのタイムアウトで失敗することもあります。これは同じステップでより短いメッセージを表示します：

A request to AWS timed out. Check your network and proxy settings, then try again.

同じタイムアウトがモデルピンステップで発生する場合、ウィザードはモデルを unreachable としてマークします。どちらのメッセージも表示する代わりに。

対応方法：

• 同じシェルで aws sts get-caller-identity を実行します。それもハングする場合、スタールは Claude Code の外にあります。ネットワーク、プロキシ、または AWS プロファイルの認証情報ヘルパーで。最初にそれを修正します。
• ウィザードを開く前にインタラクティブサインインを完了します。たとえば aws sso login --profile myprofile
• AWS プロファイルの認証情報ヘルパーが正当に 60 秒以上の時間が必要な場合は、ミリ秒単位で制限を上げます。CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

クラウドゲートウェイセッションが有効期限切れです

Claude apps gateway を通じてサインインし、このマシンに保存されたゲートウェイセッションが有効期限切れになり、更新できなかったか、ゲートウェイはそれを受け入れなくなりました。たとえば、ゲートウェイの JWT シークレットが置き換えられた 後。対話的に claude を起動するときにこの行が表示される場合、セッションはゲートウェイからサインアウトして開いています：

Cloud gateway session expired — run /login to reconnect.

同じ行はセッション中に表示される場合があります。ゲートウェイ認証情報が有効期限切れになり、Claude Code が更新できないとき。

非対話的 実行、バックグラウンドまたは他の無人セッション、または claude サブコマンド（claude auth 以外）では、ゲートウェイがセッションを受け入れなくなったときに Claude Code は代わりにこのメッセージで終了します：

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

対応方法：

• セッションで /login を実行し、ブラウザサインインを完了します
• 非対話的な起動の場合は、同じ環境で claude を起動し、/login を実行してから、コマンドを再実行します

ゲートウェイがリクエストを拒否しました

Claude apps gateway を通じてサインインしており、リクエストが 403 を返しました。ゲートウェイ、またはその背後にあるアップストリームがそれを拒否しました。再度サインインしても拒否は変わらないため、メッセージはゲートウェイ管理者を指しています：

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

対応方法：

• ゲートウェイ管理者にリクエストを検索するよう依頼してください。API Error: テールはゲートウェイが返した拒否を運びます
• 管理者の場合：ゲートウェイの アクセス制御ルール は、監査ログ が理由を記録する 403 を返し、アップストリームの認可拒否は アップストリームエラーメッセージ ごとに渡されます

v2.1.273 より前では、ゲートウェイセッションの 403 は一般的な Please run /login または Failed to authenticate メッセージを表示し、再度サインインしても拒否はクリアされませんでした。

ネットワークと接続エラー

これらのエラーのほとんどは、Claude Code からのネットワークリクエストが宛先に到達できなかったか、Claude Code と API の間で何かが戻りの応答を変更したことを意味します。ローカルアーカイブ書き込みの失敗など、ローカルの原因がある場合、その本文に記載されています。通常、ローカルネットワーク、プロキシ、ファイアウォール、またはクラウド環境のネットワークポリシーで発生します。

API に接続できません

API への TCP 接続が失敗したか、完了しませんでした。一般的な接続エラーコードについては、メッセージは失敗の種類を示し、括弧内にコードを保持します。

Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
fetch failed
Request timed out. Check your internet connection and proxy settings

Claude Code が認識しないコードは、Unable to connect to API の後に括弧内にコードが表示されます。これらのメッセージの一部は複数のコードを表示できます。例えば、Connection refused は ConnectionRefused または ECONNREFUSED を表示でき、Can't reach the API server は ENOTFOUND または FailedToOpenSocket を表示できます。

v2.1.227 より前では、これらの各コード付きメッセージは Unable to connect to API の後にコードが続きました。例えば Unable to connect to API (ECONNREFUSED) のようにです。

一般的な原因には、インターネットアクセスがない、api.anthropic.com をブロックする VPN、または設定されていない必須の企業プロキシが含まれます。

対応方法：

• 同じシェルから curl -I https://api.anthropic.com を実行して、API ホストに到達できることを確認してください。Windows PowerShell では、組み込みの Invoke-WebRequest エイリアスが使用されないように curl.exe -I https://api.anthropic.com を使用してください。
• 企業プロキシの背後にいる場合は、Claude Code を起動する前に HTTPS_PROXY を設定し、ネットワーク設定 を参照してください。
• LLM ゲートウェイまたはリレーを経由してルーティングする場合は、ANTHROPIC_BASE_URL をそのアドレスに設定してください。セットアップについては Claude Code を LLM ゲートウェイに接続する を参照してください。
• ファイアウォールが ネットワークアクセス要件 に記載されているホストを許可していることを確認してください。
• 断続的な障害は 自動的に再試行 されます。永続的な障害はローカルネットワークの問題を示しています。

curl が成功しても Claude Code が失敗する場合、原因は通常、ネットワーク自体ではなく、ランタイムとネットワークの間にあります。

• Linux と WSL では、/etc/resolv.conf で到達不可能なネームサーバーを確認してください。特に WSL はホストから壊れたリゾルバーを継承できます。
• macOS では、切断またはアンインストールされた VPN クライアントがトンネルインターフェイスまたはルーティングルールを残す可能性があります。ifconfig で古い utun インターフェイスを確認し、システム設定で VPN のネットワーク拡張機能を削除してください。
• Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。これを除外するために、それらを終了して再試行してください。

Anthropic サービスに接続できません

初回実行セットアップ中に、Claude Code はサインインステップを表示する前に api.anthropic.com と platform.claude.com に到達できることを確認します。いずれかのチェックが失敗すると、Claude Code は理由を出力して終了します。

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

Claude Code は、API リクエストと同じ プロキシ設定 を通じてチェックを送信し、各プローブに 10 秒を与えます。失敗したプローブがプロキシを通過した場合、メッセージは HTTPS_PROXY などの環境変数を名前で指定します。v2.1.222 より前では、チェックはタイムアウトなしの異なるプロキシトランスポートを使用していました。https:// スキーム付きのプロキシ URL の背後では、Checking connectivity... で無期限に停止してから失敗する可能性があり、同じプロキシを通じた API リクエストが成功しても失敗します。

Claude Code は、管理設定ファイル、MDM ポリシー、またはポリシーヘルパー が forceLoginMethod を "gateway" に設定するか、forceLoginMethod なしで forceLoginGatewayUrl を設定する場合、このチェックをスキップします。どちらかの設定では、Claude Code は Cloud gateway 画面ではなく Anthropic サインイン方法でサインインステップを開きます。マシン上の管理設定ソースが存在するが読み取れない場合、Claude Code はチェックをスキップします。そのソースはゲートウェイ設定を保持する可能性があるためです。v2.1.247 より前では、Claude Code はこの設定下でもチェックを実行し、Anthropic のエンドポイントに到達できない場合、このエラーで終了しました。

対応方法：

• メッセージがプロキシ変数を名前で指定する場合、その値が正しいプロキシを指しており、ネットワークチームにメッセージ内のホストへの HTTPS 接続を許可するよう依頼してください。ネットワーク設定 を参照してください。
• API に接続できません のチェックを実行してください。そこの curl テストとファイアウォールガイダンスはこのチェックにも適用されます。
• 組織が クラウドゲートウェイ を通じてサインインし、このエラーが初回実行時に表示される場合は、Claude Code v2.1.247 以降に更新してください。
• ネットワークが開いており、障害が続く場合、Claude Code は お客様の国で利用できない 可能性があります。

ソケットが閉じられています

Socket is closed は、ストリーミング応答を運ぶ接続が応答がまだ到着している間に閉じられたことを意味します。最も一般的な原因は、Windows 上の企業プロキシが確立されたトンネルを応答の途中でドロップすることです。

応答がどこまで進んだかに応じて、Claude Code は要求を再試行し、Claude が生成したものを保持するか、ターンを終了します。自動再試行 を参照してください。

v2.1.214 より前では、Claude Code はこの障害を再試行せず、ターンは Socket is closed を含むエラーで停止しました。

対応方法：

• このエラーが表示される場合は、claude update で v2.1.214 以降に更新してから、メッセージを再度送信してください。
• 更新後も同じプロキシの背後でターンが失敗し続ける場合は、API に接続できません を実行し、ネットワーク設定 でプロキシセットアップを確認してください。

API が空または不正な形式の応答を返しました

Claude Code は、失敗したストリーミング要求の非ストリーミング再試行が HTTP 成功ステータスを取得しても、本文が Claude API メッセージではない場合、このエラーを表示します。一般的には HTML エラーまたはサインインページ、空の本文、または別の形式の JSON です。プロキシ、ゲートウェイ、またはネットワークサインインページが API の代わりに応答することが通常の原因です。Claude Code は要求を再試行せず、ターンはこのエラーで終了します。

API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.

その冒頭の後、メッセージは戻ってきたものと失敗した要求を報告します。

• Response: 句は、コンテンツタイプ、本文の種類（body is an HTML page または empty body など）、バイト単位のサイズ、および応答が Anthropic リクエスト ID を運んだかどうかを示します。応答が nginx または cloudflare などの認識可能なサーバーを名前で指定するか、cf-ray または via などの中間ヘッダーを運ぶ場合、句はそれらもリストします。
• 失敗したストリーミング要求の ID と失敗をトリガーした障害を名前で指定する文。ストリームが障害の前に開いていた場合、到着したストリームイベント数と、いずれかが到着した場合、試行が失敗したときにストリームが沈黙していた時間も報告します。

v2.1.234 より前では、メッセージは intercepting the request の後で終了しました。

v2.1.271 より前では、text/plain などの JSON 以外のコンテンツタイプの下で有効な API メッセージを運ぶ返信もこのエラーでターンを終了しました。一部の LLM ゲートウェイは非ストリーミング返信にそのコンテンツタイプを使用します。

対応方法：

• Response: 句を読んで、どのシステムが応答したかを確認してください。HTML 本文、Anthropic リクエスト ID がない、または nginx または cloudflare などの名前付きサーバーは、Claude Code と API の間に何かが代わりに応答したことを意味します。
• LLM ゲートウェイ を通じてルーティングする場合は、直接要求でルートをテストし、非 API 応答を返すホップを修正してください。
• ゲスト Wi-Fi などのサインインページを持つネットワーク上では、ブラウザーでサインインを完了してから再試行してください。
• ゲートウェイを通じた非ストリーミングルートのみが壊れている場合は、CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 を設定して、ストリーミング中に失敗した要求がこのフォールバックではなく通常の再試行パスに進むようにしてください。ただし、ストリーミングエンドポイント自体が 404 を返す場合は除きます。その場合、Claude Code は引き続きフォールバックします。

ストリーミング応答が完全なデータを受け取る前に終了しました

モデルプロバイダーからのストリーミング応答が完了しましたが、使用可能なデータを配信しなかったため、Claude Code は要求をストリーミングなしで再送信してターンを完了しました。Claude Code は警告を 1 回のセッションごとに、対話型セッションのみで表示します。v2.1.239 より前では、Claude Code はストリーミングなしで黙って再試行しました。

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

Claude Code は影響を受けた各要求を 2 回送信します。空のストリーミング試行と再試行です。通常の原因は、戻りの途中でストリーミング応答本文を消費または変換するプロキシまたはゲートウェイです。

対応方法：

• Claude Code とモデルプロバイダーの間のプロキシまたはゲートウェイを設定して、ストリーミング応答本文とそのヘッダーを変更されずに通すようにしてください。
• Amazon Bedrock では、ゲートウェイまたはプロキシの背後でのストリーミングエラー を参照して、ヘッダーと本文の要件を確認してください。

Bedrock ストリーミング応答に予期しないコンテンツタイプがあります

Claude Code と Amazon Bedrock の間のゲートウェイまたはプロキシがストリーミング応答本文またはその Content-Type ヘッダーを変換しています。Amazon Bedrock はストリーミング応答を application/vnd.amazon.eventstream として配信します。読み取れない本文をデコードするのではなく、Claude Code は異なるコンテンツタイプを報告する成功したストリーミング応答を拒否します。Claude Code は要求を再試行しません。

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

v2.1.208 より前では、同じ設定ミスは、応答全体がバッファリングされた後、API Error: Truncated event message received として表示されました。

対応方法：

• ゲートウェイを設定して、InvokeModelWithResponseStream 応答本文とその Content-Type ヘッダーを変更されずに通すようにしてください。ストリームをサーバー送信イベントとして再発行する中間者は一般的な原因です。
• CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 を設定するとこのエラーが非表示になりますが、Claude Code は書き直されたヘッダーの下でバイナリ本文をデコードしないため、これらの要求はより遅い非ストリーミングパスにフォールバックします。ゲートウェイまたはプロキシの背後でのストリーミングエラー を参照してください。

SSL 証明書エラー

ネットワーク上のプロキシまたはセキュリティアプライアンスが TLS トラフィックを独自の証明書でインターセプトしており、Claude Code はそれを信頼しません。

Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

v2.1.273 より前では、両方のメッセージは Check your proxy or corporate SSL certificates で終了し、OpenSSL コードまたは NODE_EXTRA_CA_CERTS ヒントはありませんでした。

v2.1.199 以降、証明書検証の失敗は再試行されないため、このエラーは完全な 再試行予算 の後ではなく、最初の試行時に表示されます。以前のバージョンは、表示する前に数分間再試行しました。ハンドシェイクタイムアウトなどの一時的な TLS 条件は、引き続き再試行されます。

/login とスタートアップ接続チェック中に、同じ障害は異なるメッセージを生成します。

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

Amazon Bedrock では、Claude Code 自体が AWS に送信するリクエスト（STS および SSO ロール認証情報呼び出し、モデル検出、セットアップウィザードのチェックなど）は、同じ証明書設定に依存しています。TLS 検査プロキシの背後での証明書エラー を参照してください。

対応方法：

• 組織の CA バンドルをエクスポートし、NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem で Claude Code を指してください。
• 完全なセットアップ手順については、ネットワーク設定 を参照してください。
• NODE_TLS_REJECT_UNAUTHORIZED=0 を設定しないでください。これは証明書検証を完全に無効にします。

クラウドセッションでホストが許可されていません

クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが環境のネットワークポリシーによってブロックされました。

HTTP 403
x-deny-reason: host_not_allowed

宛先の実際の証明書と一致しない TLS 証明書も表示される場合があります。クラウドセッションはアウトバウンドトラフィックをプロキシを通じてルーティングしてネットワークポリシーを適用するため、一致しない証明書はプロキシが接続を終了したことを意味し、宛先ではありません。

これはクライアント側のネットワーク問題ではありません。クラウドセッションと ルーチン は、セッションのネットワークを通じたアウトバウンドトラフィックが クラウド環境の 許可リストにフィルタリングされるサンドボックス化された VM 内で実行されます。GitHub 操作 と MCP コネクタトラフィックは別のチャネルを使用するため、他のホストがブロックされている間も機能し続けることができます。Default 環境は Trusted アクセスを使用し、パッケージレジストリ、クラウドプロバイダー API、コンテナレジストリ、および一般的な開発ドメインの デフォルト許可リスト を許可し、そのパス上の他のドメインをブロックします。

対応方法：

これらのステップは、お客様自身の環境の 1 つを変更します。組織共有環境 はセレクターで読み取り専用で開くため、管理設定 の Cloud environments ページからオーナーにネットワークアクセスを変更するよう依頼してください。

• ルーチンを編集用に開くか、クラウドセッションを開始してください。Default などの環境の名前を示すクラウドアイコンを選択して、セレクターを開きます。環境の上にマウスを置き、設定アイコンをクリックしてください。
• Update cloud environment ダイアログで、Network access を Trusted から Custom に変更し、ブロックされたドメインを Allowed domains に追加してください。1 行に 1 つのドメインを入力してください。Also include default list of common package managers をチェックして、カスタムドメインと共に デフォルト許可リスト を保持してください。無制限のアクセスが必要な場合は、代わりに Full を選択してください。
• Save changes をクリックしてください。次の実行は更新された許可リストを使用します。

アクセスレベルとデフォルト許可リストについては、ネットワークアクセス を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。

プロキシが接続を拒否しました

Claude が HTTPS_PROXY または関連する プロキシ変数 に設定したプロキシを通じて アーティファクト を読み取るときに、このメッセージが表示されます。アーティファクトコンテンツは *.frame.claudeusercontent.com から来るため、Claude Code は最初にプロキシに CONNECT リクエストを送信して、そのホストへのトンネルを開くよう要求します。プロキシが拒否すると、何もホストに到達せず、メッセージはプロキシの HTTP ステータスを運びます。

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

ステータスは CONNECT に対するプロキシの応答です。ホストは応答しなかったため、各ステータスは異なる修正を指しています。

• HTTP 407：プロキシは受け取らなかった認証情報を必要とします。基本認証 が示すように、プロキシ URL に認証情報を入力してください。
• HTTP 403：プロキシは *.frame.claudeusercontent.com へのトンネリングを拒否します。プロキシを実行している人に、ネットワークアクセス要件 にリストされているそのホストを許可するよう依頼してください。
• HTTP 502 などの他のステータス：プロキシはホストに到達できないなど、独自の理由でトンネルを開きませんでした。プロキシのログでステータスを検索してください。
• ステータスの代わりに unreadable reply：プロキシアドレスにあるものが HTTP ステータス行で応答しませんでした。アドレスが HTTP プロキシであることを確認してください。

対応方法：

• プロキシ設定 で説明されているように、プロキシ変数のアドレスと認証情報を確認してから、Claude Code を開始するシェルから curl -x http://proxy.example.com:8080 -I https://api.anthropic.com を実行してください。独自のプロキシ URL を使用してください。Windows PowerShell では、curl.exe を実行してください。このプローブが同じ方法で失敗する場合は、最初にプロキシセットアップを修正してください。成功する場合、拒否はアーティファクトホストに固有です。
• ネットワークが Claude Code をアーティファクトホストに直接到達させる場合は、.frame.claudeusercontent.com を NO_PROXY に追加してください。エントリを狭く保ってください。より広い .claudeusercontent.com エントリは、IP 許可リスト を持つ組織がプロキシ上に保つ必要がある bridge.claudeusercontent.com のプロキシもバイパスします。

v2.1.238 より前では、Claude Code は拒否されたトンネルを一般的なネットワークエラーとして報告しました。

クラウド環境サービスが空または予期しない応答を返しました

Claude Code は、CLI からクラウドセッションを作成するときや /remote-env を実行するときなど、複数のポイントで クラウド環境 リストをリクエストします。サーバーの応答を読み取れない場合、次のいずれかのメッセージが表示されます。

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.

サーバーはリクエストを受け入れましたが、環境リストではない本文で応答しました。空、JSON ではない、または環境リストのない JSON です。これは通常、サービス側の中断を伴い、独自にクリアされます。リストをリクエストした表面に応じて、Claude Code は /remote-env ダイアログの couldn't list environments: などのプレフィックスを追加する場合があります。

対応方法：

• アクションを再試行してください。Claude Code はアクションのたびにリストをリクエストします。
• メッセージが表示され続ける場合は、status.claude.com でアクティブなインシデントを確認してください。

v2.1.236 より前では、Claude Code はこれらのメッセージの代わりに生の JavaScript TypeError を表示しました。

Remote Control セッションに再接続できませんでした

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

claude --resume または claude --continue で再開すると、その会話に記録された Remote Control セッションに再接続します。このメッセージは、ネットワーク中断またはサーバーエラーなど、一時的な理由で再接続が失敗したことを意味するため、Claude Code はリモートセッションがまだ存在するかどうかを確認できません。ローカルセッションは Remote Control なしで実行し続けます。

対応方法：

• /remote-control を実行して接続を再試行してください。
• claude --remote-control で新しいセッションを開始して、新しい Remote Control セッションを作成してください。
• 他の Remote Control スタートアップメッセージについては、Remote Control のトラブルシューティング を参照してください。

サーバーが代わりに前のセッションが消えたことを報告する場合、このメッセージは表示されません。Claude Code は、その代わりに新しいセッションを開始するか、Previous session is unavailable — run /remote-control to start a new one を表示します。これは 会話の再接続レコード に依存します。v2.1.227 から v2.1.231 では、Claude Code は代わりに Remote Control could not resume the previous session under the current login で始まるメッセージを表示し、以前のバージョンは異なる動作をしました。

このマシンがオフラインの間にセッションが終了しました

Claude Code は、マシンがオフラインになった時間が長すぎて、サーバーがマシンが提供していた Remote Control 環境をクリーンアップした後、claude remote-control を実行しているターミナルにこのメッセージを表示します。その環境のセッションが終了し、それらを再開することはできません。カウントは終了したセッション数です。

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

対応方法：

• Claude Code がこのメッセージの下で保持されたワークツリーをリストする場合、それらから未コミットの作業を取得してください。
• claude remote-control を実行して新しい環境を開始してください。

トランスクリプトを共有できませんでした

セッション品質調査 などの調査プロンプトからセッショントランスクリプトを共有することに同意した後、Claude Code はそれを Anthropic にアップロードするか、サードパーティプロバイダー上、Claude apps ゲートウェイ セッション上、および Anthropic 認証情報が利用できない場合にローカルアーカイブを保存します。このメッセージは共有が完了しなかったことを意味します。

Couldn't share the transcript.

アップロードは 8 MiB の制限に適合する必要があります。長いセッションでは、Claude Code は段階的に共有の一部をドロップし、最後のリクエストのモデル設定を最初に、次に構造化された会話とサブエージェントトランスクリプトをドロップし、削減されたバージョンを送信できない場合、またはネットワークまたはサーバーエラーがアップロードを停止する場合にのみ、このメッセージを表示します。Claude Code がローカルアーカイブを保存する場合、メッセージはアーカイブを書き込めなかったことを意味します。

対応方法：

• /feedback を実行して、何が起こったかの説明と共にトランスクリプトを送信してください。環境で /feedback が利用できない場合は、エラーを報告する を参照してください。
• 他のリクエストも失敗している場合は、ネットワーク接続を確認し、API に接続できません を参照してください。

リクエストエラー

これらのエラーはリクエストの内容に関連しています。ほとんどはリクエストを拒否した後に API から返されます。いくつかはリクエストが送信される前に Claude Code によってローカルで生成されます。

プロンプトが長すぎます

会話と添付ファイルがモデルのコンテキストウィンドウを超えています。

Prompt is too long

インタラクティブセッションでは、Claude Code はこのエラーを次のように表示します。

Context limit reached · /compact or /clear to continue

DISABLE_COMPACT が設定されている場合、この行は /clear のみを表示します。圧縮失敗形式など、エラーのより長い形式は Prompt is too long · という表現を保持します。-p 出力とトランスクリプトでは、テキストは Prompt is too long のままです。

ユーザー設定で自動圧縮をオフにした場合、この行は次のように表示されます。

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

/config の Auto-compact トグルは、ユーザー設定に autoCompactEnabled を書き込みます。ヒントは /config の変更が有効になる場合にのみ表示されます。たとえば、DISABLE_AUTO_COMPACT または DISABLE_COMPACT が自動圧縮をオフにした場合は表示されません。また、プロジェクトまたはマネージド設定などのより高い優先度のスコープが autoCompactEnabled を false に設定した場合も表示されません。v2.1.235 より前では、この行に自動圧縮ヒントは含まれていませんでした。

Amazon Bedrock はこの状態を Input is too long for requested model. として報告し、Claude Code は同じ方法で処理します。v2.1.217 より前では、Claude Code は Bedrock の表現を認識しなかったため、自動圧縮はトリガーされず、/compact は同じエラーで失敗しました。

Claude apps gateway は、クラウドアップストリームがプロバイダー独自のエラー形式でリクエストを拒否した場合、この状態を capability_rejected: prompt_too_long として報告します。Claude Code はトークンを Prompt is too long と同じように扱います。v2.1.228 より前では、Claude Code はトークンを認識しなかったため、自動圧縮はトリガーされませんでした。

このターンで自動圧縮が実行され、利用不可のモデルや認証失敗などの基礎となるエラーで失敗した場合、メッセージはセパレータの後にそのエラーを名前付けします。

Prompt is too long · automatic compaction failed: <the underlying error>

名前付けされたエラーを最初に解決してください。/compact は解決するまで同じエラーで失敗します。v2.1.229 より前では、失敗した自動圧縮は原因なしで Prompt is too long を表示していました。

自動圧縮がこのエラーで実行される場合、通常は最も古い交換を要約し、最新のものを保持します。最後の手段として、Claude Code は異なる方法で要約します。

• 全体の交換を要約できない場合、Claude Code は最新のプロンプトをそのまま保持し、その前のすべてを要約します。
• その場合、会話が最新のプロンプトで終わらない場合、Claude Code は代わりに会話全体を要約します。

Claude Code は、転送するコンテンツがモデル応答を保持せず、短い再試行など約 1,000 トークン未満の独自のテキストを保持する場合、この回復をスキップします。/clear を実行して新しく開始してください。v2.1.269 より前では、全体の交換を要約できない場合は圧縮が失敗したため、その状態のセッションはすべてのターンでこのエラーに遭遇しました。

単一交換の会話には要約する以前のターンがありません。自動圧縮が実行されるはずの場合、Claude Code は試行をスキップし、代わりにリクエストを何が満たしているかを説明します。API がエラーでトークン数を報告しない場合、メッセージは次のように読みます。

Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

API がエラーでトークン数を報告する場合、Claude Code はそれを会話のサイズの独自の推定値と比較して、リクエストの大部分が何であるかを判断します。会話独自のコンテンツ、またはシステムプロンプト、ツール定義、および Claude Code が送信する添付ファイルコンテンツです。会話独自のコンテンツがリクエストの大部分である場合、メッセージは次のように読みます。

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

リクエストの大部分が会話外にある場合、メッセージは次のように読みます。

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

v2.1.162 より前では、Claude Code は圧縮を試行し、失敗時に裸の Prompt is too long を表示していました。

対応方法：

• マルチターン会話では、/compact を実行して以前のターンを要約し、スペースを解放するか、/clear を実行して新しく開始します。/compact が Not enough messages to compact. と答える場合、会話は圧縮できる以前のものがない単一交換であるため、スペースはそのプロンプトと Claude Code がすべてのリクエストで送信するもので占められています。/clear を実行して、ペーストされたテキストが少ないか、より小さな添付ファイルで再度送信するか、以下の手順を使用してツール定義とメモリファイルを削減してください
• /context を実行して、ウィンドウを消費しているものの内訳を確認します。システムプロンプト、ツール、メモリファイル、およびメッセージです
• /mcp disable <name> で使用していない MCP サーバーを無効にして、コンテキストからツール定義を削除します
• 大きな CLAUDE.md メモリファイルをトリミングするか、指示を パススコープ規則に移動して、関連する場合にのみ読み込みます
• サブエージェントは親セッションからすべての MCP ツール定義を継承します。これは最初のターンの前にコンテキストウィンドウを満たす可能性があります。サブエージェントを生成する前に、使用していない MCP サーバーを無効にします
• 自動圧縮はデフォルトでオンになっており、通常このエラーを防ぎます。/config または DISABLE_AUTO_COMPACT でオフにした場合は、オンに戻してください。オフのままにする場合は、ウィンドウが満杯になる前に /compact を自分で実行してください。

コンテキストウィンドウを探索を参照して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。

コンテキストがトークン制限を超えています

/context は、会話がモデルのコンテキストウィンドウを超えて成長した場合、その出力の上部にこの警告を表示します。Prompt is too long でリクエストが失敗するまで、スペースを解放してください。インタラクティブセッションは、そのエラーを Context limit reached 行として表示します。

Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

超過した制限がモデルのコンテキストウィンドウより小さい圧縮ウィンドウ（1M コンテキストモデルの 200K 境界など）である場合、警告は異なります。圧縮ウィンドウはモデルのコンテキストウィンドウより下に位置する可能性があるため、それを超えたリクエストは依然として成功する可能性があります。

Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

両方の形式は、DISABLE_COMPACT を設定した場合、/compact の代わりに /clear を名前付けします。

対応方法：

• マルチターン会話では、/compact を実行して以前のターンを要約し、スペースを解放します。代わりに新しく開始するには、/clear を実行してください
• 使用量を削減するその他の方法については、プロンプトが長すぎますを参照してください

v2.1.216 より前では、/context は 100% を超える使用量を表示し、それが何を意味するか、または回復方法を説明する警告行がありませんでした。

圧縮中のエラー：会話が長すぎます

/compact 自体が失敗しました。これは、生成される要約を保持するのに十分な空きコンテキストがないためです。

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

これは、自動圧縮がトリガーされた時点でウィンドウが既に満杯である場合、または Prompt is too long を見た後に /compact を実行した場合に発生する可能性があります。インタラクティブセッションでは、そのエラーは Context limit reached 行です。

対応方法：

• Esc キーを 2 回押してメッセージリストを開き、数ターン戻ります。これにより、最新のメッセージがコンテキストから削除されます。その後、/compact を再度実行してください。
• 戻ることで十分なスペースが解放されない場合は、/clear を実行して新しいセッションを開始してください。以前の会話は保存され、/resume で再度開くことができます。

このメッセージと他の /compact 失敗はエラースタイルで表示されます。v2.1.216 より前では、成功したコマンド出力と同じ薄いスタイルでレンダリングされたため、失敗した圧縮を成功として読むことができました。

リクエストが大きすぎます

トークン化前の生のリクエストボディが API の 32MB 制限を超えました。通常、大きなペーストコンテンツ、ツール結果、または添付ファイルが原因です。この制限は コンテキストウィンドウとは別です。

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

リクエストが Claude API に直接送信され、API 自体がそれを拒否した場合、Claude Code は会話を測定し、回復が機能するかどうかによってメッセージを表現します。プロキシ、ゲートウェイ、またはクラウドプロバイダーを通じて、一般的なメッセージが表示されます。測定された形式：

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).：画像またはドキュメントがリクエストを制限を超えました。Claude Code はそれらを削除して再試行します。
• Request too large for the API's 32MB request limit：メッセージだけが制限を超えているため、メッセージは compacting cannot make it fit と言い、Claude Code は再試行しません。非インタラクティブモードでは、メッセージは入力を削減するか、代わりに新しいセッションを開始するよう指示します。

v2.1.212 より前では、十分に蓄積された画像を持つ会話は、すべてのターンで Request too large (max 32MB). Double press esc to go back and try with a smaller file. で失敗しました。v2.1.229 より前では、Claude Code は圧縮が役に立たない場合でも、すべての拒否に対して添付ファイルのアドバイスを表示していました。

対応方法：

• メッセージが compacting cannot make it fit と言う場合、Esc キーを 2 回押して大きなコンテンツを追加したターンを超えて戻るか、/clear を実行して新しく開始してください
• それ以外の場合は、/compact を実行します。これにより、蓄積された画像と添付ファイルが削除されます
• ファイルの内容をペーストする代わりに、パスで大きなファイルを参照して、Claude がそれらをチャンクで読むことができるようにします
• 画像については、以下の 画像が大きすぎましたを参照してください

画像が大きすぎました

ペーストまたは添付された画像が API のサイズまたは寸法制限を超えています。

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size

Claude Code は処理不可能な画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。v2.1.142 より前では、ペーストされた画像は会話に残り、後続のすべてのメッセージで同じエラーを繰り返す可能性がありました。これらのバージョンで回復するには、Esc キーを 2 回押して、画像が追加されたターンを超えて戻ってください。

対応方法：

• ペーストする前に画像をリサイズしてください。API は単一の画像で最大 8000 ピクセル、または多くの画像がコンテキストにある場合は 2000 ピクセルまでの画像を受け入れます。
• 全画面ではなく、関連する領域のより厳密なスクリーンショットを撮ってください

画像をリサイズできません

Claude Code は、API に送信する前に添付された画像をダウンスケールできませんでした。

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、画像をデコードまたはリサイズして API 制限内に収まるようにできなかったことを意味します。

対応方法：

• メッセージが画像を変換するよう求めている場合は、PNG、JPEG、GIF、または WebP に変換して、再度添付してください。Claude Code はこれらの形式の寸法をファイルヘッダーから検証でき、画像をデコードする必要はありません。
• メッセージが寸法またはサイズ制限を報告している場合は、その制限以下に画像をリサイズまたは再圧縮してから添付してください。
• メッセージが CMYK JPEG、アニメーション WebP、または破損している可能性のあるファイルなどの原因を名前付けしている場合は、メッセージが提案する形式で画像を再度保存して添付してください。

PDF エラー

添付した PDF を処理できませんでした。メッセージはここに非インタラクティブ形式で表示されます。インタラクティブセッションでは、代わりに Esc キーを 2 回押して再試行するよう促します。

PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).

対応方法：

• サイズの大きい PDF の場合は、ファイル全体を添付する代わりに、Read ツールでページ範囲を読むよう Claude に依頼するか、pdftotext などのツールでテキストを抽出し、パスでファイルを参照してください
• 保護されているか無効な PDF の場合は、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから、再度試してください

追加入力は許可されていません

Claude Code と API の間のプロキシまたは LLM ゲートウェイが anthropic-beta リクエストヘッダーを削除したため、API はそれに依存するフィールドを拒否しました。

API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

Claude Code は、context_management や effort などのベータのみのフィールドを、それらを有効にする anthropic-beta ヘッダーと一緒に送信します。ゲートウェイがボディを転送しますがヘッダーを削除すると、API は認識しないフィールドを見ます。

対応方法：

• anthropic-beta ヘッダーを転送するようにゲートウェイを設定してください。ゲートウェイが転送する必要があるものについては、機能パススルーを参照してください。
• フォールバックとして、起動前に CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を設定してください。プリリリース機能を無効にするは正確なスコープをカバーしています。

ツール入力スキーマが無効です

リクエスト内のツールが、API の JSON Schema 検証に失敗する input_schema を宣言したため、API はリクエスト全体を拒否しました。tools. の後の番号は、検索できる名前ではなく、リクエストのツールリスト内の失敗したツールの位置です。

API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'

最初の形式は、スキーマが有効な JSON Schema ドラフト 2020-12 ではないことを意味します。2 番目は、トップレベルのプロパティ名がメッセージが引用するパターンと一致しないことを意味します。

Claude Code は、この検証に失敗するであろう入力スキーマを持つ MCP ツールを除外します。サーバーのツールを読み込むときは、リクエストは通常、このツールを含みません。

フラグ取得がオフの展開、またはフラグが到着したことのないマシンでは、Claude Code はサーバーのログに拒否されるであろうツールを記録しますが、とにかく送信するため、このエラーは依然として発生する可能性があります。

エラーは、$schema で JSON Schema ドラフト 2020-12 以外の JSON Schema 方言を宣言するツールのスキーマに対しても発生する可能性があります。Claude Code はこれらのスキーマを JSON Schema メタスキーマに対してチェックしませんが、トップレベルのプロパティ名チェックは依然として適用されます。

v2.1.216 より前では、展開は除外チェックを実行していませんでした。

対応方法：

• Claude Code バージョンが v2.1.216 より前の場合は、claude update を実行してください。
• 無効なスキーマを宣言する MCP サーバーを削除するか、無効にしてください。エラーは位置によってのみツールを名前付けします。v2.1.216 以降では、各サーバーのログで、入力スキーマが拒否されるであろうツールを名前付けする行を確認してください。ログが名前付けしない場合は、サーバーを 1 つずつ無効にしてください。
• サーバーを保守している場合は、ツールの input_schema を修正してください。スキーマは有効な JSON Schema である必要があり、トップレベルのプロパティ名は 1 ～ 64 文字で、ASCII 文字と数字、_、.、および - のみを使用する必要があります。無効な入力スキーマを持つツールを参照してください。

選択されたモデルに問題があります

設定されたモデル名が認識されなかったか、アカウントがそれへのアクセス権を持っていません。v2.1.160 の時点で、ここにインタラクティブ形式で表示される末尾のヒントは、サーフェスによって異なります。

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

対応方法：

• インタラクティブ CLI：/model を実行して、アカウントで利用可能なモデルから選択してください。
• 非インタラクティブモード（-p）：有効なエイリアスまたは ID で --model を渡すか、ANTHROPIC_MODELを設定してください。エラーテキストはこのサーフェスで Run --model を表示します。
• Agent SDK：モデルはプログラムで設定されるため、エラーテキストはヒントを省略します。TypeScript で Options の modelを設定するか、Python で ClaudeAgentOptions(model=...)を設定し、構造化された model_not_found エラーを処理して、独自の再試行またはモデルピッカーを表示してください。
• claude-sonnet-5 などの完全なバージョン ID の代わりに、sonnet や opus などのエイリアスを使用してください。エイリアスは保守されたデフォルトに解決されるため、古くなりません。モデル設定を参照してください。
• 間違ったモデルが CLI で戻り続ける場合は、古い ID がどこかに設定されています。優先順位順でモデルを設定できる場所を確認し、古い値を削除してください。
• 新しく起動されたモデルは、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry が提供する前に Anthropic API で利用可能になる可能性があります。これらのプロバイダーの 1 つで新しいモデル ID をピンしており、このエラーが表示される場合は、プロバイダーのモデルカタログで地域での利用可能性を確認し、新しいモデルがそこに表示されるまで以前のバージョンをピンしたままにしてください。
• Claude Code は期限切れの claude.ai ログインを ログイン期限切れとして報告し、このエラーとしてではありません。v2.1.206 より前では、更新できなくなった期限切れのログインはすべてのモデルで失敗しました。古いバージョンでこれが表示される場合は、/login を実行してください。
• Google Cloud の Agent Platform デプロイメントについては、Google Cloud の Agent Platform トラブルシューティングを参照してください。

モデルは認識されたモデル ID ではありません

モデルスイッチに渡したモデル文字列は、モデルエイリアス、この Claude Code バージョンが知っているモデル ID、または claude- で始まる ID ではありません。通常の原因は、ID のタイプミス、Sonnet 5 などの表示名（ID claude-sonnet-5 が予想される）、または新しい Claude Code バージョンのみが認識するエイリアスです。Claude Code はスイッチを直ちに拒否します。v2.1.200 より前では、Claude Code は文字列を保存し、次のリクエストで 選択されたモデルに問題がありますで失敗しました。

Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

末尾のヒントは、最も近いマッチングエイリアスまたはモデル ID を名前付けします。十分に近いものがない場合は、代わりに Run /model to see available models. と読みます。

Claude Code はこのエラーをローカルで生成します。スイッチが要求された時点で、API リクエストが行われる前です。これは、Agent SDK setModel() メソッドを通じてモデルが設定されるか、Claude Code CLI を実行する Desktop appなどのアプリによって適用されます。または、Remote Controlを通じて接続されたデバイスからモデルを選択するときに適用されます。v2.1.260 より前では、チェックは Remote Control ピックをカバーしなかったため、Claude Code はピックを適用し、次のリクエストは 選択されたモデルに問題がありますで失敗しました。

対応方法：

• 引数なしで /model を実行してピッカーを開き、アカウントで利用可能なモデルから選択してから、そこに表示されるエイリアスまたは ID を渡してください
• 新しい Claude Code バージョンがサポートするエイリアスを使用した場合は、claude update を実行してください。claude- で始まる完全な ID はこのローカルチェックを通過します。サーバーはそのモデルに最小バージョンを要求する可能性があります。Claude Code はこのモデルをサポートしていませんを参照してください。
• v2.1.200 より前に保存されたモデルはこのチェックで修復されません。古い値が戻り続ける場合は、モデルの設定の下にリストされている場所から削除してください。
• チェックは Anthropic API でのみ実行されます。カスタム ANTHROPIC_BASE_URL を含む他のプロバイダーまたはゲートウェイでは、プロバイダーがモデル名を定義するため、Claude Code は任意の文字列を受け入れて渡します。Claude Code は依然として、すべてのプロバイダーで、リクエスト時に 認識されないモデル診断行を書き込むことができます。

モデルが見つかりません

/model <name> でモデルを選択し、Claude Code がそのモデルが存在することを確認できませんでした。名前が モデルエイリアスまたは Claude Code がローカルで受け入れる別のスペルではない場合、/model は最小限の API リクエストで検証し、このエラーは通常、API エンドポイントの応答です。スペースを含むものなど、モデル ID になることができない名前は同じメッセージを取得します。

Model 'claude-opus-9' not found

プロバイダー固有のモデル ID を持つプロバイダーでは、メッセージはフォールバックモデルのプロバイダーの ID を名前付けする Try '...' instead 提案を追加する場合があります。

対応方法：

• 引数なしで /model を実行して、アカウントで利用可能なモデルから選択するか、sonnet などの モデルエイリアスを使用してください。これは保守されたデフォルトに解決されます
• 完全な ID を入力した場合は、プロバイダーのモデルカタログに対して確認してください。新しく起動されたモデルは、プロバイダーまたは地域が提供する前に Anthropic API で利用可能になる可能性があります。
• v2.1.265 より前では、/model は opusplan[1m] エイリアススペルもこのエラーで拒否しました。これらのバージョンでは、Claude Code を更新するか、設定または --model でモデルを設定してください。

Claude Opus は Claude Pro プランでは利用できません

アクティブなサブスクリプションプランに、選択したモデルが含まれていません。

Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

対応方法：

• /model を実行して、プランに含まれるモデルを選択してください
• 最近プランをアップグレードしてもこれが表示される場合は、/logout を実行してから /login を実行してください。保存されたトークンはサインイン時のプランを反映するため、Web でアップグレードしても、再認証するまで既存のセッションで有効になりません。
• 各プランに含まれるモデルについては、claude.com/pricingを参照してください

Claude Code はこのモデルをサポートしていません

API は、選択したモデルに必要な最小値より下の Claude Code バージョンであるため、400 でリクエストを拒否しました。サーバーはモデルごとにこれをチェックするか、組織のポリシーが 1 つを要求します。400 はエラーコード claude_code_version_too_old を含み、メッセージは適用される最小値を示します。

API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.

組織ポリシーの表現は次のように読みます。

API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

対応方法：

• claude update を実行するか、Claude デスクトップアプリを更新してから、新しいセッションを開始してください
• モデルごとの表現については、/model で別のモデルに切り替えて、現在のセッションで作業を続けることができます
• 組織ポリシーの表現については、続行する前に更新してください

モデルは組織の設定によって制限されています

組織の管理者が claude.ai 管理コンソールでこのモデルを無効にしたか、マネージド設定の availableModels許可リストで除外されています。制限されたモデルが --model、ANTHROPIC_MODEL、または model 設定で設定された場合、Claude Code は許可されたモデルを代用して続行します。制限されたモデルに対して /model <name> を入力すると、Run /model to choose a different model. で拒否され、セッションは現在のモデルを保持します。代用通知は、セッションが実行されているモデルを管理者が claude.ai 管理コンソールで無効にした後、セッション中に表示される場合もあります。

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

エージェント、スキル、またはコマンド名で始まるお知らせは、制限が サブエージェントの要求されたモデルに適用されたことを意味します。サブエージェントは代用モデルで実行され、セッションのモデルは変わりません。v2.1.223 より前では、Claude Code はお知らせを Agent ツールで起動されたサブエージェントに対してのみ表示していました。

Claude Code は、opus、sonnet、haiku、または fable の 1 つであるモデルファミリーエイリアスを、その最新バージョンではなく、そのファミリーへのリクエストとして扱います。Anthropic API および Claude Platform on AWSでは、制限されたファミリーエイリアスは、組織と availableModels 許可リストが許可する最新バージョンのファミリーに解決され、代用お知らせはそのバージョンを名前付けします。Claude Code は /model <alias> を拒否するのは、ファミリーのすべてのバージョンが制限されている場合のみです。v2.1.205 より前では、ファミリーエイリアスは、同じファミリーの古いバージョンが許可されている場合でも、最新バージョンのみに基づいて代用または拒否されました。

対応方法：

• /model を実行して、組織が許可するモデルから選択してください。制限されたモデルはピッカーから非表示になります。
• 制限されたモデルが --model、ANTHROPIC_MODEL、設定ファイルの model フィールド、または サブエージェント、スキル、またはコマンドの model frontmatter で設定された場合は、その値を削除または更新して、お知らせが再度表示されないようにしてください
• 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼してください。組織モデル制限を参照してください。

モデルスイッチは PreModelSwitch フックによってブロックされました

PreModelSwitch フックが、ユーザーまたはクライアントが要求したモデルスイッチを承認しなかったため、セッションは現在のモデルを保持します。スイッチが Agent SDKホストまたは Remote Controlから来た場合、メッセージは、ターゲットモデルを名前付けせずに Model switch blocked by a PreModelSwitch hook と読みます。

Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.

コロンの後の理由は、スイッチを拒否したものを示しています。

• フックが書いた理由：PreModelSwitch フックは、スイッチを拒否したか確認を求めたときにその理由を提供しました。それが求めることに対応するか、フックが許可するモデルを選択してください。
• PreModelSwitch hook <name> did not respond before its timeout：タイムアウトの前に応答しないフックがスイッチをブロックします。ハングしているコマンドを修正するか、そのフックの timeout を上げてから、再度スイッチしてください。
• confirmation required, and this session cannot ask：フックは理由なしで ask で応答し、制御リクエストは確認プロンプトを表示する方法がありません。-p 実行の /model コマンドは、理由の後に (run /model interactively to confirm) で同じ状態を報告します。インタラクティブセッションからスイッチを行うか、このモデルのフックの決定を変更してください。
• so organization-managed PreModelSwitch hooks could not be checked：Claude Code は、組織の マネージドプラグインが提供する PreModelSwitch フックを判断できませんでした。たとえば、マネージドプラグインの読み込みに失敗したためです。これらのフックの 1 つがスイッチをブロックする可能性があるため、Claude Code はチェックされていないスイッチを適用するのではなく拒否します。理由の開始は、失敗したものを名前付けします。Claude Code はすべてのスイッチ試行で再チェックするため、それ以降にクリアされた失敗はブロックを停止します。ブロックが続く場合は、claude --debug を実行してスイッチし、詳細をキャプチャしてから、プラグインを修正するか、管理者に修正を依頼してください。
• a PreModelSwitch hook failed before answering または PreModelSwitch hooks were cancelled (the control stream closed) before answering：フック実行は判定なしで終了し、Claude Code はそれを承認として扱いません。claude --debug を実行して失敗したものを確認してから、再度スイッチしてください。

v2.1.260 より前では、マネージドプラグイン拒否は plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log と読みました。Claude Code はプラグイン読み込みを 1 回再試行してから、セッション内の後のスイッチを拒否しました。組織がプラグインを管理していない場合でも同様です。これらのバージョンでセッションを再開して、プラグイン読み込みを再度実行してください。

デフォルトとして保存できませんでした

モデルをデフォルトとして保存するために選択しました。たとえば、/model <name> または /model ピッカーで Enter を使用して、Claude Code はユーザー設定ファイル ~/.claude/settings.json に選択を書き込むことができませんでした。スイッチ自体が適用されたため、現在のセッションは選択したモデルで実行されますが、デフォルトは変わらず、次のセッションは古い値で開始されます。

Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)

ファイルパスの後の理由は、失敗したものを示しています。

• can't be written (<code>)：書き込みは、EROFS などのオペレーティングシステムエラーコードで失敗しました。ファイルまたはそれがリンクするファイルが、書き込みを拒否するファイルシステムに存在する場合です。ファイルを書き込み可能にしてスイッチしてください。別のツールがファイルを生成する場合は、代わりにそのツールで model キーを設定してください。Claude Code で行った変更は新しいセッションで失われますを参照してください。
• isn't valid JSON：ディスク上のファイルが解析されず、Claude Code は読み戻すことができないコンテンツを上書きするのではなく、それを手つかずのままにします。構文エラーを修正してからスイッチしてください。破損した設定ファイルを修正を参照してください。

couldn't confirm it was saved as your default (~/.claude/settings.json is still being written) で終わるお知らせは、書き込みが 3 秒後に完了していなかったことを意味します。バックグラウンドで続行されるため、デフォルトは依然として保存される可能性があります。次のセッションが開始するモデルを確認するか、/model <name> を再度実行してください。

v2.1.265 より前では、お知らせは、書き込みが失敗した場合でも、モデルが saved as your default for new sessions であると述べていました。

thinking.type.enabled はこのモデルではサポートされていません

Claude Code バージョンが選択されたモデルの最小値より古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

対応方法：

• claude update を実行して Claude Code を再開してください。Opus 4.7 には v2.1.111 以降が必要です。Opus 4.8 には v2.1.154 以降が必要です。Sonnet 5 には v2.1.197 以降が必要です。Opus 5 には v2.1.219 以降が必要です
• アップグレードできない場合は、/model を実行して Opus 4.6 または Sonnet 4.6 を選択してください
• Agent SDKでこれに遭遇した場合は、SDK パッケージをアップグレードしてください。Opus 4.8 には TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 には TypeScript SDK v0.3.197 以降が必要です。Opus 5 には TypeScript SDK v0.3.219 以降が必要です

思考がオフの場合、努力は利用できません

拡張思考をオフにして、high より上の 努力レベルで実行しました。モデルはその組み合わせを受け入れないため、API はリクエストを拒否しました。

API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

対応方法：

• 努力レベルを低下させて、high 以下にしてください。
• 思考をオンに戻してください。たとえば、MAX_THINKING_TOKENSをアンセットするか、設定から "alwaysThinkingEnabled": falseを削除してください。

v2.1.242 より前では、Claude Code は API 独自のメッセージを表示していました。API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. v2.1.251 より前では、Claude Code は設定した努力レベルでリクエストを送信したため、Opus 5 は思考がオフの場合、high より上のすべてのリクエストを拒否しました。Claude Code は現在、Opus 5 などの組み合わせを拒否することが分かっているモデルに努力 high を送信するため、v2.1.251 以降では、このエラーは Claude Code が知らないモデルからのみ到達します。

思考予算が出力制限を超えています

設定された拡張思考予算が最大応答長を超えているため、実際の答えのためのスペースが残っていません。

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code は Anthropic API でこれらの値を自動的に調整します。通常、Amazon Bedrock または Google Cloud の Agent Platform でこのエラーが表示されるのは、MAX_THINKING_TOKENSがプロバイダーの出力制限より高く設定されている場合、またはプランモードが思考予算を上げる場合です。

対応方法：

• MAX_THINKING_TOKENS を低下させるか、CLAUDE_CODE_MAX_OUTPUT_TOKENSを思考予算より上に上げてください
• 拡張思考を参照して、予算が出力長とどのように相互作用するかを確認してください

ツール使用または思考ブロックの不一致

会話履歴が不整合な状態で API に到達しました。通常、ツール呼び出しが中断されたか、ターンがストリーム中に編集された後です。

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

3 つのバリアントはすべて同じことを意味します。履歴内の tool_use、tool_result、および thinking ブロックのシーケンスが、API が期待するものと一致しなくなりました。

対応方法：

• Opus 4.7 または Opus 4.8 を使用している場合は、最初に claude update を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、/rewind はそれをクリアしません。
• /rewind を実行するか、Esc キーを 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。チェックポイントを参照して、チェックポイントがどのように作成および復元されるかを確認してください。

サポートされていないツールコンテンツが削除されました

Claude Code が Anthropic API に直接接続し、保存されたセッションを読み込むまたはプレビューする場合、Anthropic API が受け入れないツールコンテンツを削除し、2 つの思考ブロック間の削除されたコンテンツが座っていた場所にこの行を残します。

[Unsupported tool content removed]

このようなコンテンツは、通常、ANTHROPIC_BASE_URLを通じて設定されたサードパーティプロキシなど、API の形式で応答する Anthropic API 以外のものがセッションファイルに到達します。これは別のプロバイダーのツール呼び出しを変換します。Claude Code は、セッションが Anthropic API に直接接続する場合にのみそれを削除し、セッションがプロキシを通じて実行されるか別のプロバイダーで実行される場合、保存された履歴をそのまま読み込みます。v2.1.246 より前では、Claude Code はツール使用とその結果を API に送信し、再開されたセッションのすべてのターンは messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ... などの 400 エラーで失敗しました。

対応方法：

• プレースホルダー行が表示される場合は、対応は不要です。セッションは削除されたコンテンツなしで続行します。
• 再開されたセッションのすべてのターンが 400 エラーで失敗する場合は、claude update を実行してセッションを再度再開してください。v2.1.246 より前のバージョンはコンテンツを削除しません。

使用ポリシー拒否

API は、会話内のコンテンツが 使用ポリシーチェックをトリガーしたため、応答を拒否しました。メッセージには、拒否が正しくないと思われる場合にサポートに引用できるリクエスト ID が含まれています。

API Error: Opus 4.6 can't help with this. Start a new session to continue.

Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup

メッセージは、拒否したモデルを名前付けするか、モデルが記録されていない場合は Claude を名前付けします。

チェックは最新のプロンプトだけでなく、完全な会話を評価するため、同じセッションで新しいメッセージを送信すると、通常、同じ拒否が再度トリガーされます。同じことが --continue または --resume でセッションを終了して再度開いた後にも適用されます。ディスク上のトランスクリプトには依然としてトリガーコンテンツが含まれているためです。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundryでは、このメッセージはモデルのセーフティ対策がサイバーセキュリティトピックとしてフラグを立てたリクエストもカバーしています。セーフティ対策がサイバーセキュリティトピックをフラグ立てしましたを参照してください。

v2.1.219 より前では、メッセージは Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task. と読みました。

対応方法：

• Esc キーを 2 回押すか /rewind を実行して、拒否をトリガーしたターンの前のチェックポイントに戻り、別のアプローチを試してください。チェックポイントを参照してください。
• どのターンが原因かを特定できない場合は、/clear を実行して同じプロジェクトで新しい会話を開始してください。以前の会話はディスクに保存され、/resume で利用可能なままです。
• 非インタラクティブモード（-p）では、巻き戻しが利用できないため、--continue なしで新しいセッションで言い換えられたプロンプトで再試行してください。ポリシーチェックはモデルによって異なるため、--model で別のモデルに切り替えると、場合によっては拒否が解決される可能性があります。

セーフティ対策がサイバーセキュリティトピックをフラグ立てしました

モデルのセーフティ対策が、会話内のコンテンツをサイバーセキュリティトピックとしてフラグ立てしました。メッセージは、リクエストをフラグ立てしたモデルを名前付けします。

API 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-claude

メッセージは Cyber Verification Programにリンクしており、正当なサイバーセキュリティ作業へのアクセスを許可します。

Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundryでは、サイバーセキュリティフラグは代わりに 使用ポリシー拒否メッセージを生成します。

セーフガード自体はサーバー側であり、v2.1.203 より前のものです。それ以降のクライアントリリースはメッセージの表現のみを変更しました。 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. を追加しました。 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: と読み、その後に免除フォームリンクが続きました。

対応方法：

• 作業にこのコンテンツが必要な場合は、Cyber Verification Programを通じてアクセスを申請してください
• リクエストがサイバーセキュリティトピックについてではなかった場合は、/feedback を実行して誤検知を報告してください
• 同じセッションで作業を続けるには、Esc キーを 2 回押すか /rewind を実行して、フラグをトリガーしたターンの前のチェックポイントに戻り、別のアプローチを試してください。チェックポイントを参照してください。

インストールエラー

これらのエラーは、インストールスクリプト、claude install、または claude update から Claude Code をインストールまたは更新する際に表示されます。セットアップ中の command not found、PATH、権限、および TLS の問題については、インストールとログインのトラブルシューティングを参照してください。

インストールが完了する前に終了されました

インストールスクリプトは、claude install ステップがシグナルによって終了されたときに報告します。Linux では、終了コード 137 はプロセスが SIGKILL を受け取ったことを意味し、メモリが少ないホストでは通常、カーネルのメモリ不足（OOM）キラーです。スクリプトはこの説明を出力し、コード 137 で終了します。

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

その他の致命的なシグナルの場合、および macOS でのコード 137 の場合、スクリプトは Installation was killed before it could finish (exit code <N>) を出力し、実際の終了コードを表示し、メモリ不足の説明は省略します。メッセージは macOS と Linux が使用するインストールスクリプトから来ており、WSL 内のインストールもカバーしています。ネイティブ Windows インストールスクリプトはこれを出力しません。v2.1.200 より前では、スクリプトはシェルの単なる Killed 行でのみ終了していました。

対処方法：

• 他のプロセスを停止してメモリを解放し、インストーラーを再実行します
• スワップスペースを追加するか、より大きなインスタンスに移動します。低メモリ Linux サーバーでのインストール終了を参照して、スワップファイルコマンドを確認してください。

更新のダウンロード中に接続が切断されました

claude install、claude update、または自動アップデーターが Claude Code バイナリをフェッチしている間にダウンロードサーバーへの接続が閉じられ、リトライが回復しませんでした。Claude Code は、接続がドロップされた場合、転送が停止した場合、またはダウンロードされたファイルがチェックサムに失敗した場合、最大 3 回の試行でダウンロードを再試行します。404 などの完了した HTTP エラーは、サーバーが既に応答しているため再試行されません。v2.1.202 より前では、単一の接続ドロップはダウンロードを即座に失敗させ、リトライの代わりに単なるエラー aborted を表示していました。

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

括弧内のテキストは、失敗した試行と基になるネットワークエラーを示します。claude update は stderr でメッセージの前に Error: Failed to install native update を付けます。

接続は保持されているがダウンロードが 10 分以内に完了しない場合、代わりに Download timed out: exceeded the total deadline で失敗します。Claude Code はタイムアウトしたダウンロードを再試行しません。期限内に完了するのに十分な速度がない接続は、即座に再試行しても完了しないためです。以下の手順は両方のメッセージに適用されます。

通常の原因は、長い転送を完了する前に閉じるプロキシまたはゲートウェイです。Claude Code バイナリは大きなダウンロードであるため、通常の API トラフィックに影響を与えないプロキシ接続制限でも、それを中断する可能性があります。

対処方法：

• claude update を再度実行します。それ以外の場合は健全なネットワークで、ダウンロードは通常、次の実行で成功します。タイムアウトメッセージの場合は、より高速またはスロットルされていないネットワークから再度実行します。
• ネットワークがプロキシを必要とする場合は、インストーラーまたは claude update を実行する前に HTTPS_PROXY を設定します。ネットワーク接続の確認を参照してください。
• 企業プロキシが転送を閉じ続ける場合は、ネットワークチームに downloads.claude.ai からの完全なダウンロードを許可するよう依頼します。ネットワークアクセス要件を参照してください。
• シェルから claude doctor を実行して、インストール診断を実行します

コマンドラインエラー

これらのエラーは、claude コマンドラインとそのサブコマンド、プロンプトで送信するコマンド名、および /security-review などのコンテキストを収集するためにシェルコマンドを実行してからプロンプトを実行するコマンドから発生します。また、CLI を再起動する /tui からも発生します。

\--bg と --print の競合

このメッセージには Claude Code v2.1.198 以降が必要です。同じ claude 呼び出しで --bg を -p または --print と組み合わせました。--bg は、後で claude agents で接続するバックグラウンドセッションを開始し、--print は非対話的に実行され、claude agents が接続するインタラクティブセッションを開始しません。v2.1.198 より前は、この組み合わせは暗黙的に接続できないバックグラウンドジョブを作成していました。

--bg と --print は競合します。--print は `claude agents` が接続するインタラクティブセッションを開始しないため、ジョブは接続不可能になります。位置引数はプロンプトです。--print を削除してください。`claude --bg '<task>'`。

対処方法：

• -p または --print を削除してください。--bg はプロンプトを位置引数として受け取るため、claude --bg "<task>" が完全なコマンドです。シェルから新しいエージェントをディスパッチするを参照してください。
• プロンプトを非対話的に実行し、バックグラウンドセッションを作成する代わりに結果を出力するには、--bg を削除して claude -p "<task>" を実行してください。

無効な --agents 設定

--agents に渡した値が無効なため、claude はセッションを開始する代わりに終了コード 1 で終了します。--safe-mode、--resume、または --continue を渡すか、CLAUDE_CODE_SAFE_MODE を設定すると、Claude Code は値をチェックせずにセッションを開始します。v2.1.242 より前は、Claude Code はセッションを開始し、読み込めない定義を省略していました。

Error: Invalid --agents configuration:
<what failed>

最初の行の後に続く内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順番に実行し、最初に失敗したもので停止します。値に 2 種類の問題がある場合、最初の問題を修正した後にのみ 2 番目の問題が表示されます。

1. 値が JSON として解析されない場合、Claude Code は JSON パーサー自体のメッセージを含む 1 つの invalid JSON: 行を出力します。
2. 解析されるが、エージェント定義が CLI 定義サブエージェントのスキーマと一致しない場合、Claude Code は問題ごとに 1 行を出力します。
3. エージェント名が - で始まる場合、Claude Code は <name>: agent names must not start with '-' を出力します。

問題行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを …and N more に置き換えます。

対処方法：

• メッセージが列挙する各問題を修正してから、コマンドを再度実行してください。CLI 定義サブエージェントが受け取るフィールドを参照してください。

クラウドセッションは --restricted セッションから作成できません

--restricted でセッションを開始すると、Claude Code はクラウドセッションの作成を拒否します。新しいセッションは制限されたプロセスの外で実行され、制限モードを強制しないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません。

Cloud sessions cannot be created from a --restricted session: they would not enforce it.

対処方法：

• 制限されたセッションでタスクをローカルで実行してください。
• セッションの起動方法を制御できる場合は、--restricted なしで新しい claude セッションを開始し、そこからクラウドセッションを作成してください。

v2.1.248 より前は、Claude Code に --restricted フラグがなく、以前のバージョンはフラグ自体を不明なオプションエラーで拒否します。

クラウドセッションは組織のポリシーで無効になっています

組織の allow_remote_sessions ポリシーがオフになっているため、クラウドセッションとそれを使用するコマンドは利用できません。

Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

このメッセージは、ターミナルからクラウドセッションを作成するときに表示され、/teleport、/remote-env、/web-setup などのクラウドセッションが必要なコマンドを送信するときにも表示されます。v2.1.268 より前は、これらのコマンドの 1 つを送信すると、代わりにUnknown command が返されていました。

これはサーバー側の組織ポリシーであるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。

Claude Code が組織のポリシーをまだ読み込んでいない場合、またはそれを取得できない場合、これらのコマンドは代わりに Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again. と答えます。

対処方法：

• 組織のオーナーに、claude.ai/admin-settings/claude-code の Claude Code 管理設定でクラウドセッションを有効にするよう依頼してください。
• メッセージがポリシーを検証できなかったと言っている場合は、ネットワーク接続を確認してから Claude Code を再起動して、もう一度試してください。

\--json-schema 値は有効な JSON Schema ではありません

非対話的モードで --json-schema に渡したスキーマが JSON Schema コンパイルに失敗したため、claude はプロンプトを実行する代わりに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマは構造化されていない出力を生成し、format キーワードを使用したスキーマは無効として扱われていました。

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

2 番目のコロンの後のテキストはバリデータの診断であり、失敗したキーワードまたは場所を示します。"format": "email" などの format キーワードを使用するスキーマは有効です。Claude Code は format を注釈として受け入れ、それを強制しません。

Claude Code はスキーマコンパイルの前に 2 つのチェックを実行します。解析可能でない JSON 値は Error: --json-schema is not valid JSON で拒否され、有効な JSON がオブジェクトでない場合は Error: --json-schema must be a JSON object で拒否されます。

対処方法：

• 診断が示すスキーマの部分を修正してから、コマンドを再実行してください。
• 診断が schema too large の場合は、スキーマのネストと $ref の再利用を減らしてください。
• 構造化された出力を取得するで、動作するスキーマとコマンドを参照してください。

設定ファイルが 2MiB の制限を超えています

--settings に渡したファイルが 2 MiB より大きいため、claude は起動時に終了コード 1 で終了し、それを読み込みません。設定ファイルは小さい JSON ドキュメントであるため、このサイズのファイルは通常、パスが間違ったファイルを指していることを意味します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み込み、数ギガバイトのファイルまたは /dev/zero などのデバイスファイルはメモリを無制限に増やしていました。

Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

Claude Code は、通常のファイルではない --settings パスも同じ方法で拒否します。デバイス、FIFO、またはソケットは Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) の後にパスを報告し、ディレクトリは EISDIR 理由を報告します。

対処方法：

• --settings を 2 MiB 未満の通常の JSON 設定ファイルを指すようにしてください。形式については設定を参照してください。

現在のディレクトリが存在しなくなりました

シェルがディレクトリに入った後、別のシェルが削除または移動したワークツリーまたは一時ディレクトリなど、削除または移動されたディレクトリから claude を開始しました。Claude Code は作業ディレクトリを読み取ることができないため、インタラクティブモードと非対話的モードの両方で、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、Claude Code は縮小されたバンドルソースと生の ENOENT ... uv_cwd スタックを stderr に出力してクラッシュしていました。

The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

原因と修正は両方の形式で同じです。

Claude Code が権限の変更など別の理由で作業ディレクトリを読み取ることができない場合、メッセージはエラーコードを示します。Can't read the current directory (EACCES). Start Claude Code from a different directory.

macOS では、~/Desktop、~/Documents、~/Downloads、または iCloud Drive のディレクトリの EPERM は通常、macOS がターミナルアプリをそのフォルダからブロックしていることを意味します。そのフォルダを読み取る他のコマンドも同じ方法で失敗します。ls はそこで Operation not permitted を報告します。sudo を使用しても同じです。

対処方法：

• ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに変更してから、claude を再度実行してください。
• ディレクトリが同じパスで再作成された場合、シェルはまだ削除されたものを保持しています。cd "$PWD" を実行するか、ディレクトリを出て再度入ってから、claude を実行してください。
• macOS の EPERM の場合は、Cmd+Q でターミナルアプリを終了し、再度開いて、そのフォルダに戻り、claude を実行してください。そのフォルダの ls がまだ失敗する場合は、システム設定 > プライバシーとセキュリティ > ファイルとフォルダを開き、ターミナルアプリのフォルダをオンにしてから、ターミナルを再度開いてください。

ディレクトリを実際の場所に解決できませんでした

作業ディレクトリのサブディレクトリに対して /add-dir を実行しましたが、Claude Code はディレクトリを実際の場所に解決できませんでした。

作業ディレクトリのサブディレクトリへのファイルアクセスは既にあるため、/add-dir はそのスキル、コマンド、エージェントのみを読み込みます。それらを読み込む前に、Claude Code はディレクトリの実際の場所（シンボリックリンクが解決されている）が作業ディレクトリ内にあることを確認します。Claude Code がその場所を解決できない場合、何も読み込まず、このメッセージを表示します。

packages/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.

対処方法：

• パスが作業ディレクトリ内の実際のディレクトリを示していることを確認してから、/add-dir を再度実行してください。
• メッセージはファイルアクセスを変更しません。ディレクトリの .claude/ コンテンツが読み込まれなかったことのみを報告します。

v2.1.261 より前は、作業ディレクトリが /net/<host> オートマウント上にある場合、すべての /add-dir <subdirectory> に対してこのメッセージが表示されていました。Claude Code は設計上パスを解決することを拒否します。ディレクトリは問題なく、再試行は役に立ちません。

Remote Control 開始時にワークスペースが信頼されていません

claude remote-control またはそのエイリアス claude rc を使用してRemote Controlサーバーモードを開始しましたが、信頼していないディレクトリで開始しました。コマンドはワークスペース信頼ダイアログ自体を表示しないため、終了コード 1 で終了し、修正を示します。

Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

ホームディレクトリではメッセージが異なります。ワークスペース信頼ダイアログはホームディレクトリの信頼を保存しないため、そこで受け入れることはこのチェックを満たすことができません。v2.1.214 より前は、ホームディレクトリは上記のメッセージを表示していました。そのアドバイスはそこで成功することはできません。

Error: 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).

対処方法：

• ディレクトリで claude を実行し、ワークスペース信頼ダイアログを受け入れてから、claude remote-control を再度実行してください。
• ホームディレクトリでは、プロジェクトディレクトリに変更して、そこで Remote Control を開始してください。

Remote Control が開始するセッションに引き継がれません

remote-control 動詞の前にグローバル claude フラグを使用してRemote Controlを開始しました。Remote Control が開始するセッションを制限または設定するフラグ（--settings、--setting-sources、--permission-mode、--disallowed-tools、--mcp-config など）です。動詞の前に配置されたフラグはこれらのセッションに到達しません。Claude Code は代わりに開始を拒否し、フラグを示します。

Error: `--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`).

Claude Code は、--verbose、--model、またはラッパーが注入した --session-id や --plugin-dir など、削除しても害のないグローバルフラグを拒否しません。それらを無視し、Remote Control は開始します。

Claude Code はまた、まだ害のないものとして認識していないグローバルフラグを拒否するため、新しいリリースで追加されたフラグは、後のリリースでそれを害のないものとしてマークするまで、このメッセージに表示される可能性があります。

対処方法：

• 動詞の前からフラグを削除し、Remote Control 独自のオプションをその後に渡してください。claude remote-control --help がそれらをリストします。
• 拒否されたフラグが --permission-mode の場合は、claude remote-control --permission-mode <mode> を実行して、Remote Control が開始するセッションの権限モードを設定してください。

v2.1.248 より前は、claude remote-control はグローバルフラグが最初に来たときに独自のフラグを受け入れず、コマンドは不明なオプションエラーで失敗していました。

claude import はこのビルドではまだ利用できません

claude import を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドは終了コード 1 で終了し、インポートを開始する代わりにこのメッセージを出力します。v2.1.222 より前は、インポートフローがオフのビルドは import をプロンプトとして扱い、このメッセージを出力する代わりにインタラクティブセッションを開始していました。

`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

Claude Code は、Anthropic から取得してディスクにキャッシュするフィーチャーフラグを通じて claude import をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、以下のいずれかです。

• インストール後にセッションを開始していないため、Claude Code はまだフラグを取得していません。最初の claude import は、フィーチャーが利用可能な場合でもこれを出力できます。
• Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、またはClaude apps gateway を通じて Claude Code を使用しています。Claude Code はこれらのセッションでフィーチャーフラグを取得しないため、claude import は利用できません。
• DISABLE_TELEMETRY、DO_NOT_TRACK、DISABLE_GROWTHBOOK、または CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を設定しました。これらはフィーチャーフラグ取得をオフにするため、claude import は利用できません。

対処方法：

• 新規インストールでは、claude を開始し、セッションが読み込まれるのを待ってから終了し、claude import を再度実行してください。
• フィーチャーフラグ取得がオフのままの場合は、設定を自分で設定してください。claude mcp add で MCP サーバーを追加し、CLAUDE.md ファイル、スキルとコマンド、サブエージェントを作成してください。メッセージは ~/.claude/settings.json も示します。claude import が引き継ぐ設定のうち、そのファイルは権限モードのみを保持します。Claude Code はそこから MCP サーバーを読み込みません。

Claude Code 設定を読み込めませんでした

ログインとプロジェクトごとの状態を保存するファイル ~/.claude.json を解析できない間に claude import を実行しました。サブコマンドはそのファイルを読み込んで可用性を確認しますが、インタラクティブセッションが表示する復旧ダイアログを表示しないため、終了コード 1 で終了します。v2.1.222 より前は、claude import は読み込み不可能な設定ファイルでインタラクティブセッションを開始し、その復旧ダイアログがファイルを処理していました。

Could not read Claude Code config — run `claude` with no arguments to recover it.

対処方法：

• 引数なしで claude を実行してください。Claude Code は無効なファイルを検出し、リセットを提供します。その後、claude import を再度実行してください。
• 手動で編集した内容を保持するには、エディタで ~/.claude.json の JSON 構文を修正してから、claude import を再度実行してください。

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

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

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

サーバー名の後のテキストは理由です。最も一般的なのは名前チェックです。Claude Desktop はサーバー名に空白やピリオドなどの文字を許可しますが、claude mcp はそれらを文字、数字、ハイフン、アンダースコアに制限しています。その他の理由には、検証に失敗するサーバー設定と、組織の MCP ポリシーによってブロックされるサーバーが含まれます。

対処方法：

• claude_desktop_config.json でサーバーの名前を変更して、文字、数字、ハイフン、アンダースコアのみを使用してから、claude mcp add-from-claude-desktop を再度実行してください。
• claude mcp add または claude mcp add-json を使用して、有効な名前でそのサーバーを直接追加してください。Claude Desktop から MCP サーバーをインポートするを参照してください。

MCP サーバーを管理スコープに追加できません

--scope managed を使用して claude mcp add または claude mcp add-json を実行しました。そのスコープは、managedMcpServers管理設定を通じて組織が提供するサーバーを保持しています。Claude Code はそれらを管理設定からのみ読み込むため、コマンドはそのスコープにサーバーを書き込むことができません。

Cannot add MCP server to scope: managed

対処方法：

• 書き込み可能なスコープにサーバーを追加してください。local、user、または project。--scope なしで、コマンドは local を使用します。MCP インストールスコープを参照してください。
• 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の managedMcpServers に追加してください。

.mcp.json を読み込めません

プロジェクトの .mcp.json を読み込むコマンド（--scope project を使用した claude mcp add または claude mcp add-json、または claude mcp remove）は、現在のディレクトリのファイルが通常のファイルではないか、2 MiB より大きいことを検出したため、ファイルを読み込む代わりにこのエラーで終了します。

Can'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.

v2.1.257 より前は、.mcp.json の FIFO はコマンドを出力なしで永遠に待機させ、/dev/zero などのデバイスファイルへのシンボリックリンクはプロセスが強制終了されるまでメモリを増やしていました。

対処方法：

• 現在のディレクトリの .mcp.json に何があるかを確認してください。プロジェクトスコープ形式の通常の JSON ファイルに置き換えるか、削除してから、コマンドを再度実行してください。

サーバーは Anthropic ホストで、ローカル OAuth をサポートしていません

URL が Anthropic ホストのコネクタホストを指す MCP サーバーのサインインを開始しました。これらのホストには microsoft365.mcp.claude.com、gmail.mcp.claude.com、gcal.mcp.claude.com が含まれます。Claude Code は、サインインが claude.ai を通じてのみ機能するため、/mcp パネルと claude mcp login の両方からこれらのホストのローカル OAuth フローを開始することを拒否します。

"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.

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

対処方法：

• claude mcp remove <name> でエントリを削除して、同じ URL の claude.ai コネクタを非表示にすることができないようにしてください。
• 削除した後、claude.ai/customize/connectors で Claude Code で使用するアカウントにサインインしながらサービスを接続してください。接続すると、アクティブな認証方法が claude.ai サブスクリプションログインの場合、コネクタは Claude Code に自動的に表示されます。

サーバーは設定された headersHelper によって作成された Authorization ヘッダーを拒否しました

headersHelper が Authorization ヘッダーを提供する MCP サーバーが HTTP 401 または 403 で接続に応答したため、Claude Code は接続を失敗として報告します。ヘルパーが Authorization ヘッダーを提供するため、Claude Code はリモート MCP サーバーで OAuth に認証しません。

Server 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.

Claude Code は接続試行のたびにヘルパーを再実行するため、一時的な拒否（トークンローテーションレースなど）の後の再試行は、新しい認証情報で成功する可能性があります。

対処方法：

• headersHelper コマンドを、Claude Code が実行する方法で自分で実行してください。Claude Code が実行するディレクトリから、Claude Code が設定する環境変数を使用して、Claude Code が削除する認証情報変数なしで、プロジェクト .mcp.json、プラグイン、またはプロジェクトエージェントファイルのサーバーの場合。サーバーのエンドポイントが受け入れる Authorization 値を出力することを確認してください。
• ヘルパーまたはその認証情報ソースを修正した後、/mcp でサーバーを選択し、再接続を選択してください。

v2.1.248 より前は、Claude Code はヘルパーが Authorization ヘッダーを提供するサーバーの OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに Incompatible auth server: does not support dynamic client registration で失敗する可能性があります。

MCP 権限プロンプトツールが見つかりません

--permission-prompt-tool に渡したツールは、実行が最初に権限決定を必要とするときに接続された MCP ツールの中にありませんでした。サーバーが接続されなかったか、接続されたサーバーがその名前のツールを公開していないためです。Claude Code はまだプロンプトを送信します。非対話的実行は、承認が必要な最初のツール呼び出しでこのエラーで終了し、終了コード 1 で終了するため、リクエストが行われたにもかかわらず答えを生成しません。最初のプロンプトの前に、Claude Code は MCP_TIMEOUT で設定されたサーバーごとの接続タイムアウト 30 秒までそのサーバーの接続を待ちます。v2.1.206 より前は、起動は接続の完了を待たなかったため、遅く開始しても健全なサーバーはこのエラーを生成していました。

Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

Available MCP tools: の後のリストは、待機が終了したときに接続されていた MCP ツールを示します。

対処方法：

• サーバーが開始して接続されたままであることを確認してください。同じディレクトリで claude mcp list を実行し、サーバーが接続済みとしてリストされていることを確認してください。
• ツール名がサーバーが公開する mcp__<server>__<tool> 名と一致することを確認してください。
• サーバーが開始するのに 30 秒以上必要な場合は、MCP_TIMEOUT を上げてください。

OAuth コールバックポートは既に使用中です

OAuth を使用してリモート MCP サーバーにサインインするとき、Claude Code はサインインコールバックを受け取るためのローカルリスナーを開始します。そのリスナーが必要とするポートが別のプロセスによって保持されている場合、サインインはこのメッセージで失敗します。これは主に、MCP_OAUTH_CALLBACK_PORT変数または --callback-port を通じて設定された固定コールバックポートで発生します。1 つがない場合、Claude Code は利用可能なポートを選択するためです。

OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.

Windows では、提案されたコマンドは代わりに netstat -ano | findstr :<port> です。

対処方法：

• メッセージからコマンドを実行して、ポートを保持しているプロセスを見つけ、それを停止するか、完了するのを待ってください。
• 別のプログラムがそのポートを永続的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、MCP_OAUTH_CALLBACK_PORT または --callback-port を使用してそのポートを設定してください。どちらを使用するかに関わらず。
• その後、サインインを再度開始してください。例えば、/mcp でサーバーを選択することで。

OAuth リダイレクト用の利用可能なポートがありません

OAuth を使用してリモート MCP サーバーにサインインするとき、Claude Code はサインインコールバックを受け取るためのローカルリスナーを開始します。Claude Code がそれのためにローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。マシン上の何かが 127.0.0.1 でのリッスンを防止しています。例えば、セキュリティソフトウェアまたはローカルリスナーを拒否するサンドボックスポリシーです。

No available ports for OAuth redirect

v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てたポートにフォールバックしなかったため、メッセージは Claude Code が選択したポートのみがバインドできない場合にも表示されていました。これは Hyper-V が Claude Code が選択するポート範囲を予約する Windows ホストで発生する可能性があります。

対処方法：

• セキュリティソフトウェアまたはサンドボックスポリシーが 127.0.0.1 でのリッスンをプロセスからブロックしているかどうかを確認し、Claude Code がローカルポートをバインドできるようにしてください。
• その後、サインインを再度開始してください。例えば、/mcp でサーバーを選択することで。

/security-review は origin/HEAD なしで失敗します

/security-review は、ブランチを origin/HEAD に対して差分することで、レビューコンテキストを構築します。origin/HEAD は、origin リモートのデフォルトブランチがどれであるかを記録するローカル ref です。その ref が存在しない場合、差分を収集する git コマンドは失敗し、レビューは開始する前に停止します。

Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

メッセージは git log または別の git diff を引用する可能性があります。Git は、リモートがデフォルトブランチをアドバタイズし、フェッチ refspec がそれをカバーする場合にのみ origin/HEAD を作成します。これは、リモートへのコミット付きの完全な git clone です。ref は次のセットアップで欠落しています。

• シングルブランチまたは CI チェックアウト。これは refspec を狭くフェッチします。
• サーバー側の HEAD がだれも押していないブランチを指すリモート。
• origin リモートがないか、フェッチしたことがないリポジトリ。

Claude Code は、動的コンテキストを注入するスキルに対して同じエラーを表示し、失敗した注入コマンドはそのスキルの呼び出しを中止します。コマンドが実行される前に 2 つの兄弟文字列が発火します。

• Shell command permission check failed for pattern "...": コマンドの権限チェックはそれを許可しませんでした。注入コマンドの権限チェックは、各権限モードでどの結果が中止されるか、および allowed-tools でコマンドを事前承認する方法をカバーしています。
• Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found: スキルの frontmatter は bash を要求していますが、マシンにはそれがありません。Git for Windows をインストールするか、frontmatter を shell: powershell に変更してください。注入コマンドの実行方法を参照してください。

対処方法：

• リモートのデフォルトブランチを示して ref を作成してください。git remote set-head origin <default-branch>。これは、ローカル追跡 ref origin/<default-branch> が存在するときはいつでも機能します。シングルブランチクローンのように存在しない場合は、最初にブランチをフェッチしてください。git remote set-branches --add origin <branch> を実行してから、git fetch origin を実行してから、set-head コマンドを再実行してください。/security-review を再実行してください。
• ブランチに名前を付けたくない場合は、git fetch origin を実行してから git remote set-head origin --auto を実行してください。これはリモートにどのブランチがデフォルトであるかを尋ねます。リモートがデフォルトブランチをアドバタイズしないため、error: Cannot determine remote HEAD で失敗します。空であるか、その HEAD がだれも押していないブランチを指しているため、代わりにブランチを明示的に示してください。クローンがそのブランチをフェッチしないため、error: Not a valid ref で失敗します。上記のように refspec を広げてください。
• リポジトリにリモートがない場合は、git remote add origin <url> で追加してからフェッチしてください。リモートが空の場合は、git push -u origin HEAD でブランチをプッシュしてから、set-head コマンドでそのブランチに名前を付けてください。origin/HEAD はプッシュしたばかりのブランチを指すため、/security-review はブランチがそれから分岐するまで空の差分を見ます。

\--print を使用する場合は入力を提供する必要があります

ベアの claude は、インタラクティブ UI を開始するために stdout がターミナルである必要があります。stdout がリダイレクトされるか、コンソールが実際のターミナルではない場合（PowerShell ISE や一部の IDE 出力ペインなど）、claude は代わりに非対話的に実行されます。これは claude -p と同じモードであり、プロンプトが必要なため、メッセージはフラグを渡さなかった場合でも --print を示します。プロンプトなしで -p/--print を渡し、stdin に何もパイプされていない場合、どこでも同じエラーが発生します。

Error: Input must be provided either through stdin or as a prompt argument when using --print

対処方法：

• インタラクティブ使用の場合は、実際のターミナルで claude を実行してください。Windows Terminal または PowerShell コンソール（ISE ではなく）、IDE の統合ターミナル（出力ペインではなく）。
• ワンショット使用の場合は、プロンプトを渡してください。claude -p "your question"、またはパイプで echo "your question" | claude -p。

入力に空白のみが含まれていました

非対話的モードでは、Claude Code は、API がテキストのないメッセージを拒否するため、空白、タブ、または改行のみで構成されるプロンプトを送信する代わりに拒否します。表示されるメッセージは、空白のプロンプトがどこから来たかによって異なります。

• claude -p のプロンプト引数またはパイプされた stdin: claude は Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print で終了します。
• 実行中の --input-format stream-json または Agent SDK セッションに送信されたメッセージ: Claude Code はモデルを呼び出さずにターンを終了し、セッションは使用可能なままです。拒否は情報メッセージとしてターンの結果テキストとして到着します。Blank prompt — the message was only whitespace, so nothing was sent to the model.

v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API は 400 エラーで要求を拒否していました。

対処方法：

• プロンプトに表示されるテキストを含めてください。スクリプトが変数またはファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認してください。

stream-json 入力は改行なしで 256M 文字を超えました

プログラムは claude -p --input-format stream-json 実行に stdin で改行なしで 268,435,456 文字以上を送信したため、Claude Code はこのエラーを stderr に出力し、終了コード 1 で終了し、より多くの入力をバッファリングする代わりに終了します。メッセージはその予算を 256M として示します。v2.1.257 より前は、Claude Code はそのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリを増やしていました。

Error: 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.

改行なしのこのような長い入力は通常、プロデューサーが stream-json プロデューサーではないことを意味します。例えば、バイナリファイルまたは誤ってパイプされたプレーンログ出力。予算を超える単一のメッセージは同じチェックに失敗します。

対処方法：

• stdin にパイプされているものを確認してください。--input-format stream-json を使用すると、すべてのメッセージは 1 つの改行で終了する JSON 行である必要があります。
• プレーンテキストを代わりに送信するには、--input-format stream-json を削除してください。claude -p はデフォルトで stdin からプレーンテキストプロンプトを読み込みます。

不明なコマンド

このセッションのコマンドと一致しない / 名を送信したため、Claude Code は何も実行する代わりに名前を報告します。

Unknown command: /hepl. Did you mean /help?

Claude Code は、このセッションのメニューにリストされている最も近いコマンド名またはエイリアスを提案します。何も近い場合、メッセージは名前の後で終了します。原因は通常、以下のいずれかです。

• /hepl から /help への入力ミスなどのタイプミス。コマンドメニューが入力と一致する方法は、送信する前に近い一致を選択することをカバーしています。
• コマンドが存在しますが、プラットフォーム、プラン、認証方法などの要件が満たされていないため、このセッションでは利用できません。/web-setup と /schedule のトラブルシューティングエントリは 2 つの一般的なケースを説明しています。一部のコマンドは、組織のポリシーが無効にしている場合、Cloud sessions are disabled by your organization's policy などの独自のメッセージで答えます。
• このセッションにインストールまたは接続されていないプラグインまたは MCP サーバーからのコマンド。

Claude Code は、一致しない / 名をインタラクティブターミナルセッションでのみこのように答えます。他のすべてのセッションでは、プロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったこと、および Claude がセッションで実行できるコマンドのリストを示します。これらのセッションには以下が含まれます。

• -p 実行
• Agent SDK アプリケーション
• Desktop app の Code タブ
• VS Code extension のチャットパネル
• クラウドセッションとルーチン

これらのセッションの 1 つで実行できない組み込みコマンドの場合、Claude Code はコマンドが利用できないことを答えます。v2.1.274 より前は、クラウドセッションとルーチンのみが一致しない名前を Claude に送信していました。v2.1.273 より前は、それらも Unknown command で答えていました。

Claude Code は、/ で始まるすべてのプロンプトをコマンドとして扱うわけではありません。最初の単語の後の / が句読点で始まる場合（Lean ドキュメントコメントを開く /-- など）、またはパス（/var/log/syslog など）である場合、プロンプトを通常のメッセージとして Claude に送信します。

v2.1.236 より前は、コマンドメニューが入力した名前の近い一致をリストしている間に Enter を押すと、Claude Code はその一致を実行したため、/hepl などのタイプミスはこのメッセージを生成する代わりに /help を実行していました。

対処方法：

• 提案された名前を実行するか、/ の後に名前の一部を入力して、このセッションで利用可能なものを確認してください。
• Claude Code が文書化されたコマンドを不明として報告する場合は、コマンドリファレンスでその行を確認して、それが示す要件を確認してください。

Diff は ultrareview には大きすぎます

ブランチとベースブランチ間の差分（コミットされていない変更とステージングされた変更を含む）は、ultrareview のサイズ制限を超えているため、/code-review ultra と claude ultrareview サブコマンドはクラウドセッションが開始する前にレビューを拒否します。拒否されたレビューは無料実行を使用せず、使用クレジットを請求しません。メッセージは有効な制限、差分のサイズ、最も変更された行に貢献するファイルを示します。v2.1.216 より前は、メッセージは生の差分統計のみを表示していました。

Diff 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.

プルリクエストをレビューすると、同じ制限が適用されます。そのメッセージの形式は PR #<N> is too large for ultrareview で始まり、PR のファイルと行数を示します。

対処方法：

• より近いベースブランチ（/code-review ultra develop など）を渡して、レビューがそのブランチに対する差分のみをカバーするようにしてください。
• 変更を小さなブランチに分割し、それぞれをレビューしてください。メッセージが示すファイルは最も変更された行に貢献するため、それらを独自のブランチに移動することから始めてください。

ベースブランチとのマージベースが見つかりませんでした

/code-review ultra と claude ultrareview サブコマンドは、ブランチとベースブランチ間の差分をレビューします。これには 2 つが共有するコミットが必要です。git merge-base が見つからない場合、Claude Code はクラウドセッションが開始する前にレビューを拒否します。Claude Code が完全であることを確認できるクローン上で、少なくとも 1 つのブランチがある場合、代わりにすべての追跡ファイルをレビューすることにフォールバックします。ベースブランチが見つからない場合、Claude Code がクローンが完全であることを確認できない場合、または全体ツリー差分が不可能な稀なリポジトリ（SHA-256 オブジェクト形式など）の場合、この拒否が表示されます。

Could 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.

最初の文の後のヒントは、Claude Code が観察したものに依存します。

• ベースブランチを渡さなかった: Claude Code はリポジトリのデフォルトブランチと比較し、上記の例のように明示的にベースを渡すことを提案します。
• クローンに既にあったベースブランチを渡した: ヒントは Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`) を読みます。
• クローンにはなかったベースブランチを渡した: 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 で失敗します。

対処方法：

• 別のブランチが実際のベースである場合は、明示的に渡してください。/code-review ultra <branch>
• クローンに完全な履歴がない可能性がある場合は、git fetch --unshallow origin を実行してレビューを再実行してください。

チェックアウトにブランチがありません

チェックアウトはコミットを持つことができますが、ブランチはありません。git init の後に git fetch <url> と git checkout FETCH_HEAD を実行すると、ref のない分離 HEAD が得られます。Claude Code はリポジトリを git バンドルとしてパッケージ化して ultrareview にアップロードし、ブランチまたは他の ref がないリポジトリをバンドルすることはできないため、/code-review ultra と claude ultrareview サブコマンドはクラウドセッションが開始する前にレビューを拒否します。

Your 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.

v2.1.221 より前は、Claude Code はこのチェックアウトのすべての追跡ファイルをレビューしようとし、アップロードは失敗していました。

対処方法：

• 現在のコミットで git checkout -b <name> を使用してブランチを作成してから、レビューを再実行してください。

GitHub アカウントが Claude アカウントに接続されていません

/code-review ultra <PR#> または claude ultrareview <PR#> を実行しました。クラウドセッションを作成する前に、Claude Code はサーバーに、Claude アカウントに接続された GitHub アカウントが PR のリポジトリに到達できるかどうかを尋ねます。アカウントが接続されていないか、接続が期限切れになっているため、クラウドクローンは失敗し、Claude Code は起動を拒否します。Claude Code は拒否された起動に無料実行を費やしたり、使用クレジットを請求したりしません。

Ultrareview 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).

/web-setup がセッションで利用できない場合、メッセージは claude.ai リンクのみを示します。

対処方法：

• /web-setup を実行して GitHub CLI ログインを Claude アカウントに接続するか、claude.ai/connect-github でアカウントを接続してください。
• 接続してから 1 分後にレビューを再実行してください。

v2.1.248 より前は、Claude Code は起動前にこれをチェックしませんでした。

接続された GitHub アカウントはリポジトリを見ることができません

/code-review ultra <PR#> または claude ultrareview <PR#> を実行しました。Claude アカウントに接続された GitHub アカウントは PR のリポジトリを読み取ることができないため、クラウドクローンは失敗し、Claude Code は起動を拒否します。Claude Code は拒否された起動に無料実行を費やしたり、使用クレジットを請求したりしません。

Your 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.

/web-setup がセッションで利用できない場合、メッセージはアプリのインストールのみを示します。

対処方法：

• ローカル gh CLI がリポジトリを読み取ることができる場合は、/web-setup を実行してそのログインを Claude アカウントに接続してください。
• 変更後にレビューを再実行してください。

v2.1.248 より前は、Claude Code は起動前にこれをチェックしませんでした。

GitHub App プリフライトが一時的に失敗しました

ローカルリポジトリからクラウドセッションを開始しました。2 つのステップが一緒に失敗しました。Claude Code はリポジトリのバンドルを構築またはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかどうかを確認し、確定的な答えではなく、再試行が解決できるエラーで終了しました。例えば、ネットワークエラー、タイムアウト、または一時的なサーバーエラーです。完全なメッセージは、バンドルを停止したもので始まります。例えば Could not upload repo bundle (<error>)、プリフライト文で終わります。

Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead

対処方法：

• しばらく後にコマンドを再実行してください。GitHub チェックが成功すると、Claude Code はクラウドクローンから開始できるため、失敗したアップロードはもはや起動をブロックしません。
• 再試行が失敗し続ける場合、メッセージの開始はアップロードを停止したものを示します。それが修正できるものである場合は、セッションがローカルリポジトリから代わりに開始できるように修正してください。

v2.1.251 より前は、Claude Code は GitHub チェックが一時的にのみ失敗した場合でも Please set up GitHub on https://claude.ai/code でメッセージを終了し、セットアップアドバイスは一時的な失敗を解決することはできません。

GitHub が Claude アカウントに接続されていません

ローカルリポジトリからクラウドセッションを開始しました。例えば、/autofix-pr を使用しています。GitHub アカウントが Claude アカウントに接続されていないか、接続が期限切れになっているため、Claude Code は起動を拒否します。

GitHub 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

/schedule でルーチンを作成するとき、同じメッセージはセットアップノートとして表示され、リポジトリに名前を付けます。ノートはルーチンの作成をブロックしません。

対処方法：

• /web-setup を実行して GitHub CLI ログインを Claude アカウントに接続するか、claude.ai/connect-github でアカウントを接続してください。GitHub 認証オプションを参照して、2 つの違いを確認してください。
• 接続してから 1 分後にコマンドを再実行してください。

v2.1.268 より前は、Claude Code はこれを Claude GitHub App チェックの一時的な失敗として報告し、再試行またはアプリのインストールを提案していました。どちらも GitHub アカウントを接続しません。

単一サインオン認可が必要です

/install-github-app を実行し、SAML シングルサインオンを強制する組織のリポジトリを選択しました。セットアップの前に、Claude Code は GitHub CLI を使用してリポジトリへのアクセスを確認し、GitHub はあなたの gh トークンがまだ組織に対して認可されていないため、そのチェックを拒否しました。ウィザードは警告を表示し、認可するステップを示します。

Single sign-on authorization needed
<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.

対処方法：

• gh auth refresh -h github.com -s repo,workflow を実行して GitHub CLI ログインを再認可し、GitHub がシングルサインオンを求めるときに組織を認可してください。
• GH_TOKEN で個人アクセストークンを認証する場合は、github.com/settings/tokens を開き、トークンで Configure SSO を選択し、組織を認可してください。
• /install-github-app を再度実行してください。

v2.1.273 より前は、Claude Code はこの条件に対して Admin permissions required 警告を表示していました。

会話の再開に失敗しました

Claude Code は、claude --resume ピッカーから選択したセッションの保存されたトランスクリプトを読み込むか処理できなかったため、部分的に読み込まれた状態で続行する代わりにプロセスを終了します。メッセージには再試行するコマンドが含まれています。

Failed to resume the conversation.
Run claude --resume <session-id> to retry, or claude to start a new session.

Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の /resume ピッカーは、会話で Failed to resume conversation を報告し、現在のセッションは実行を続けます。v2.1.216 より前は、claude --resume ピッカーからの失敗した再開は Resuming conversation… スピナーで無期限に留まっていました。

対処方法：

• メッセージからセッション ID を使用して claude --resume <session-id> を実行して再試行してください。
• 再試行が再度失敗する場合は、claude を実行して新しいセッションを開始してください。

セッション ID で会話が見つかりません

セッション ID を claude --resume <session-id> に渡しましたが、保存されたトランスクリプトと一致しませんでした。

No conversation found with session ID: <session-id>

Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は現在のプロジェクトを最初に検索し、このマシン上のすべての他のプロジェクトを検索して ID を検索します。v2.1.223 より前は、ルックアップは現在のプロジェクトディレクトリとその git ワークツリーで停止したため、セッションが最後に機能したディレクトリから再開してください。

一般的な原因：

• 入力ミスされた ID: 非対話的実行の場合、ID は --output-format json 出力の session_id フィールドです。
• 削除されたトランスクリプト: Claude Code は保持期間（デフォルトでは 30 日）の後にトランスクリプトを削除し、保持スイープルールに従います。
• 別のマシン: Claude Code はトランスクリプトをローカルに保存するため、セッションが実行されたマシンでセッションを再開してください。
• 重複コピー: ~/.claude/projects の下にプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はこのメッセージを報告し、1 つのコピーを任意に再開します。

対処方法：

• インタラクティブセッションの場合は、claude --resume でセッションピッカーを開き、Ctrl+A を押してこのマシン上のすべてのプロジェクトに拡張してから、セッションを選択してください。
• claude -p または Agent SDK で作成されたセッションはピッカーに表示されないため、元の実行が出力した session_id に対して ID を再確認してください。

このセッションではレンダラーを切り替えることができません

レンダラーを切り替えると、Claude Code はプロセスを再起動します。/tui をセッションで実行しましたが、Claude Code は再起動を拒否するため、切り替わらず、何も保存しません。表示されるメッセージは原因を示します。

• Cannot switch renderers while work is running in the background: バックグラウンドで実行中のバックグラウンドシェルやサブエージェントなど、再起動が放棄するバックグラウンド作業があります。/tasks で作業が完了するか停止するのを待ってから、/tui fullscreen または /tui default を再度実行してください。
• Cannot switch renderers in this session: セッションには、再起動されたプロセスに渡すことができない制限があります。v2.1.234 より前は、Claude Code は再起動し、再起動されたセッションはそれらなしで実行されていました。

制限メッセージでは、括弧内の部分は Claude Code が見つけた制限に名前を付けます。

Cannot 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.

メッセージが括弧内に表示できる各理由：

• launch flags: a custom system prompt, a tool allowlist, or restricted settings: Claude Code がプロセスを再起動するときに渡さないフラグを使用してセッションを開始しました。これらのフラグには --system-prompt、--system-prompt-file、--append-system-prompt-file、--tools 許可リスト、--setting-sources、--permission-prompt-tool が含まれます。
• permission rules set for this session only: フックまたは SDK 呼び出し元からの権限更新は、session 宛先を持つ拒否またはルールを追加しました。セッションスコープの許可ルールは拒否をトリガーしません。再起動はそれらを削除し、Claude Code は代わりにプロンプトを表示します。
• ask-before-running rules with no command-line form: フックまたは SDK 呼び出し元からの権限更新は、Claude Code が --allowed-tools と --disallowed-tools として渡すルールと一緒に質問ルールを追加しました。質問ルールのフラグは存在しません。
• permission rules a command line cannot carry intact と added directories a command line cannot carry intact: 権限更新はセッション中にルールまたはディレクトリパスを追加しました。再起動されたプロセスのコマンドラインはそのテキストを同じ値として持つことができません。

対処方法：

• これらの制限なしで開始されたセッションで、/tui fullscreen または /tui default を実行して戻してください。Claude Code はそこで tui 設定を保存します。

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

Zed で /terminal-setup を実行しましたが、Claude Code は Zed keymap.json への更新を完了できなかったため、ファイルはそのままにしました。

各メッセージはキーマップへのパスを示し、自分で追加するキーバインディングブロックで終わります。

Couldn't update your Zed keymap, so it was left unchanged.
To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }

メッセージの最初の行は原因を示します。

• Couldn't read your Zed keymap, so it was left unchanged.: Claude Code はファイルを読み込むことができませんでした。例えば、ファイル権限のため。
• Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.: ファイルは正常に読み込まれましたが、// コメントと末尾のコンマが許可されている場合でも、キーバインディングブロックの配列として解析されません。
• Couldn't back up your Zed keymap; not modifying it.: Claude Code はファイルを .bak バックアップにコピーできなかったため、何も変更しませんでした。
• Couldn't update your Zed keymap, so it was left unchanged.: マージされた結果は、バインディングを持つ有効なキーマップとして検証されなかったため、Claude Code は書き込む代わりに破棄しました。重複したキーを持つキーバインディングブロックはこれを引き起こす可能性があります。

対処方法：

• メッセージのブロックを、メッセージが示すパスの keymap.json のトップレベル配列にコピーしてください。
• isn't a readable list of keybindings の場合は、構文エラーを修正するか、ファイルのトップレベル値を配列にしてから、/terminal-setup を再度実行してください。

v2.1.247 より前は、/terminal-setup は // コメントまたは末尾のコンマを使用する Zed キーマップを解析できず、ファイル全体をバインディングのみで置き換えながら、バインディングがインストールされたと報告していました。以前のバージョンが置き換えたキーマップを復元するには、マルチラインプロンプトを入力するの下で説明されている .bak バックアップファイルを使用してください。

スキル使用レポートはこの接続では利用できません

Remote Control 経由で、電話またはブラウザから /skill-doctor を実行しました。Claude Code は Remote Control 経由でスキル使用レポートを送信せず、代わりにこのメッセージで返信します。

Skill usage reports are not available on this connection.

対処方法：

• セッションが実行されているマシンのターミナルで /skill-doctor を実行するか、そこで claude -p "/skill-doctor" を実行してください。

カスタム出力スタイルは Remote Control 経由で選択できません

モバイルアプリまたは Remote Control 経由の Web から /output-style を実行しました。またはコマンドはセッションにリレーされたメッセージで到着しました。そのようなターンはアカウント所有者から来ない可能性があるため、Claude Code は組み込みスタイルのみをリストして選択し、コマンドがスタイルをリストするか、指定した名前を認識しないときはいつでもこの通知を追加します。カスタムスタイル名は、存在しない名前と同じ返信を取得します。

Custom 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.

対処方法：

• 組み込みスタイルを選択してください。例えば /output-style concise。
• カスタムスタイルを使用するには、プロジェクトの .claude/settings.local.json で outputStyle を設定するか、セッション自体のターミナルがある場合はそこで /output-style <style> を実行してください。

出力スタイルはこのセッションが読み込まないローカル設定に保存されます

このセッションの設定ソースが local を除外する /output-style <style> または /config outputStyle=<style> で出力スタイルを切り替えようとしました。例は、settingSources が "local" を除外する Agent SDK セッション、および --setting-sources 値が local を除外する CLI セッションです。両方のコマンドはスタイルを .claude/settings.local.json に保存します。そのようなセッションは読み込まないため、Claude Code は効果がない設定を書き込む代わりに拒否します。

Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

対処方法：

• セッションの設定ソースに local を追加して、もう一度切り替えてください。
• outputStyle キーをセッションが読み込む設定ファイル（プロジェクトの .claude/settings.json または ~/.claude/settings.json）に設定してください。TypeScript SDK では、代わりにインライン settings オブジェクト内に outputStyle を設定してください。出力スタイルをアクティブにするを参照してください。

プラグインエラー

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

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

claude plugin evalまたは claude plugin eval init を実行し、何もする前に終了コード 1 で次のいずれかのメッセージが表示されました：

`plugin eval` is currently in early access

`plugin eval` is currently unavailable

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

対処方法：

• claude --version を実行してから claude update を実行し、新しいセッションでコマンドを再度実行してください。プラグイン eval の要件を参照してください
• 現在のビルドで 2 番目のメッセージが表示される場合は、別の claude update の後で後で再度試してください

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

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

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

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

対処方法：

• マーケットプレイスが既に登録されている場合は、claude plugin marketplace remove <name> を実行してから、公式の github.com/anthropics リポジトリから再度追加してください
• 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開する場合は、名前を変更し、ユーザーにあなたのソースから再度追加するよう依頼してください
• マーケットプレイススキーマの予約名リストを参照してください

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

プラグインフック、monitor、または MCP headersHelper コマンドが ${user_config.KEY} プラグインオプションを参照し、置換された文字列がシェルに渡されます。$(...) 、バッククォート、または ; を含む設定値はそこでコードとして実行されるため、Claude Code は値を置換する代わりにコンポーネントの起動を拒否します。チェックはコマンドテンプレートで実行されるため、値がまだ設定されていない場合でもエラーが表示されます。v2.1.207 より前は、値がシェルコマンドに置換されていました。

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

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

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

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

MCP headersHelper は以下のように報告します：

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

対処方法：

• フックの場合は、args 配列を追加して exec 形式で実行し、各 ${user_config.KEY} が間にシェルなしで 1 つの引数になるようにします。または参照を削除し、スクリプト内から $CLAUDE_PLUGIN_OPTION_<KEY> 環境変数を読み込みます
• モニターの場合は、参照を削除し、モニタースクリプトが設定ファイルから値を読み込むようにします
• headersHelper の場合は、${user_config.KEY} をシェル解析されないサーバーの headers フィールドに移動するか、ヘルパースクリプト内から値を読み込みます

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

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

• 著者がピンを計算した後、URL のファイルが変更された
• 著者がマーケットプレイスエントリに間違ったダイジェストを入力した
• URL が著者がピンしたファイルとは異なるファイルを提供している

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

対処方法：

• プラグインを公開する場合は、URL が提供する正確なファイルのダイジェストを再計算します。例えば shasum -a 256 my-plugin.zip または PowerShell で Get-FileHash -Algorithm SHA256 my-plugin.zip を使用し、マーケットプレイスエントリの sha256 を更新してください
• プラグインをインストールする場合は、/plugin marketplace update <name> を実行してカタログをリフレッシュし、エントリが修正されている場合に備えて、インストールを再試行してください
• リフレッシュ後もダイジェストが一致しない場合は、インストール前にマーケットプレイス所有者にどのファイルをピンしたかを確認してください

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

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

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

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

Claude Code は、../shared-utils のようにプラグインの外を指すパスと、プラグインの外につながるシンボリックリンク（マーケットプレイスシンボリックリンクルールが許可するもの以外）の両方を拒否します。シンボリックリンクの場合、メッセージはパスが解決される場所も示します：

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

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

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

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

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

対処方法：

• 参照されたファイルをプラグインディレクトリ内に移動し、./ 相対パスでそれを指すようにしてください
• パスがプラグイン外のファイルへのシンボリックリンクの場合は、シンボリックリンクをファイルのコピーに置き換えてください
• メッセージがパスにバックスラッシュが含まれていると言う場合は、例えば ./commands/deploy.md のようにフォワードスラッシュでパスを記述してください
• 同じマーケットプレイス内の他のプラグインとファイルを共有するには、プラグインディレクトリ内のシンボリックリンクを使用してリンクし、シンボリックリンクルールに従ってください

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

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

• プラグインの デフォルトコンポーネント場所の 1 つ（skills/ フォルダ、monitors/monitors.json ファイル、またはプラグインルートの SKILL.mdなど）：プラグインの他のコンポーネントは引き続き読み込まれます
• プラグイン自体のディレクトリ：そのプラグインからは何も読み込まれません

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

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

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

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

• ELOOP：パス内のシンボリックリンクが自分自身を指しているか、ループを形成している
• EIO または ESTALE：パスが壊れているか古いネットワークマウント上にある
• EACCES：パスの上のディレクトリの 1 つがそれを通過する権限を拒否している

対処方法：

• 自分自身を指すシンボリックリンクを実フォルダに置き換えるか、削除してください
• パスがネットワークマウント上にある場合は、共有を再マウントしてください
• コードが EACCES の場合は、パスの上のディレクトリに対する実行権限を復元してください
• パスを修正した後、/reload-plugins を実行するか、Claude Code を再起動して、プラグインまたはコンポーネントを読み込んでください

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

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

プラグインのマーケットプレイスエントリは、Claude Code がマーケットプレイス自体のディレクトリ内の場所に解決できないソースパスを宣言しているため、プラグインはインストールまたは読み込まれません。拒否は以下をカバーしています：

• 絶対パス、.. でマーケットプレイスから抜け出す、またはネットワークパスのようにスペルされたエントリパス
• git または URL などのリモートソースから取得されたマーケットプレイス内のエントリで、マーケットプレイスディレクトリの外に解決するシンボリックリンクを通じてターゲットに到達する
• マーケットプレイスの marketplace.json への直接 URL から追加された相対エントリ：Claude Code はそのファイルのみをダウンロードするため、パスが名前を付けるローカルプラグインファイルは存在しません。相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗するを参照してください

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

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

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

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

対処方法：

• マーケットプレイスを保守する場合は、エントリの source を ./plugins/my-plugin のようなプレーンな相対パスとして記述し、それが通過するシンボリックリンクをマーケットプレイスディレクトリ内を指すようにしてください
• マーケットプレイスを直接 URL から追加した場合、相対エントリは解決できません。マーケットプレイス作成者に 別のプラグインソースを使用するよう依頼するか、代わりに git リポジトリからマーケットプレイスを追加してください

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

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

• Failed to load marketplace configuration：ファイルが有効な JSON ではない、または読み込めません。空のファイルもこのように失敗します。
• Marketplace configuration file is corrupted：ファイルは有効な JSON ですが、その内容がレジストリスキーマと一致しません。

ファイルが見つからない場合は失敗ではありません。Claude Code はそれをマーケットプレイスなしのレジストリとして扱います。

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

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

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

対処方法：

• ~/.claude/plugins/known_marketplaces.json を開き、JSON を修復するか、メッセージが名前を付けるエントリがレジストリスキーマと一致しないように修正してください
• 修復できない場合は、ファイルを削除するか、その内容を {} に置き換えてから、claude plugin marketplace add <source> で各マーケットプレイスを再度追加してください。Claude Code は、信頼したフォルダで次回起動するときに、ユーザーまたはマネージド設定で extraKnownMarketplaces で宣言したマーケットプレイスを再登録します。

ツールエラー

これらのエラーは Claude の組み込みツールから発生します。Claude はほとんどのツールエラーを自動的に修正します。変更が必要な場合、そのエラーの What to do リストに何を変更するかが記載されています。

Agent would be spawned with zero tools

subagent の tools リスト内のすべてのエントリが使用可能なツールと一致しなかったため、Claude Code は subagent の起動を拒否しました。ツールがないと、subagent は動作できません。メッセージは、エントリを何が問題かでグループ化します。

• Unrecognized: エントリがツール名と一致しません。通常は Grpe を Grep と誤入力するようなタイプミスです。
• Not available to subagents: エントリが subagent が使用できない実際のツールを指定しています。バックグラウンド subagent は、より小さい組み込みツールセットを保持しているため、フォアグラウンド subagent のみが使用できるエントリは、subagent がバックグラウンドで実行される場合（デフォルト）ここに表示されます。Agent をリストする場合、メッセージは代わりに次のグループの下に報告します。
• Matched no tools in this session: エントリは有効ですが、現在のセッション内のツールが現在それと一致しません。例えば、GitHub MCP サーバーが接続されていない mcp__github__* や、深さ制限にある subagent の Agent などです。

tools フィールドを省略しても、この拒否はトリガーされません。tools リストを空のままにするか、disallowedTools がそれ内のすべてのエントリを削除する場合、Claude Code も拒否をスキップし、ツールなしで subagent を起動します。

v2.1.208 より前は、subagent はツールなしで起動され、空または混乱した結果を返す可能性がありました。

Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.

What to do:

• エラーが指定する各エントリを subagent が利用可能なツールに対して修正します
• セッションが持たないツール（接続されていないサーバーからの MCP ツールなど）のエントリを削除します
• バックグラウンド subagent が削除するツール（LSP など）の場合、エントリを削除します。ツールを保持するには、fork モードをオフにして、Claude に subagent をフォアグラウンドで実行するよう依頼します
• tools フィールドを削除して、subagent に subagent が利用可能なすべてのツールを与えます
• Agent のみを含む tools リストの場合、深さ制限を上げるか、エージェントに少なくとも 1 つの他のツールを与えます。Claude Code はその制限でこの深さで Agent を保留するため、それ以外に何もないリストは、ツールなしに解決されます

File is covered by a Read deny rule

Edit または Write ツールが Read deny ルールと一致するパスで呼び出されました。これには、そのパスで新しいファイルを作成することも含まれます。両方のツールは Claude が読み戻す必要があるコンテンツを変更するため、Claude Code はファイルアクセスの前に呼び出しを拒否します。NotebookEdit は Read deny ルールの対象ではありません。v2.1.228 より前は、ルールは Edit ツールのみをブロックし、v2.1.208 より前は、Edit deny ルールのみが編集をブロックしました。

File is covered by a Read deny rule in your permission settings and cannot be edited.

Claude Code が Write ツールを拒否する場合、メッセージは代わりに and cannot be written で終わります。

What to do:

• Claude がファイルを変更できる場合、/permissions または settingsの Read deny ルールを削除または縮小します
• ファイルが変更されないままである必要がある場合、ルールを保持し、NotebookEdit ツールもブロックするために同じパスに対して Edit deny ルールを追加します

subagent\_type is required

subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...

Claude は subagent_type なしで Agent ツールを呼び出し、このセッションには general-purpose subagentにフォールバックするものがありません。これは 2 つのセットアップの場合です。

• CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1は非対話モードで設定されており、すべての組み込み subagent を削除します
• セッションのメインスレッドエージェントには tools: Agent(...) allowlistがあり、general-purpose を除外しています

What to do:

• 通常は何もしません。メッセージはセッションが持つ subagent をリストするため、Claude はそのうちの 1 つで再試行できます
• Claude が失敗し続ける場合、tools: Agent(...) allowlist に general-purpose を追加するか、CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS を設定解除します

v2.1.235 より前は、同じ呼び出しが Agent type 'general-purpose' not found で失敗しました。

Memory index is over its read limit

Claude は auto memoryインデックス MEMORY.md に書き込み、その読み取り制限の 1 つを超えたままにしました。200 行または 25KB です。書き込みは成功しましたが、最初の 200 行または 25KB のみ（どちらか先に来た方）がセッションの開始時に読み込まれるため、制限を超えるすべてのものはインデックスが読み込まれるたびにドロップされます。v2.1.210 より前は、制限を超えるインデックスは次の読み込み時に警告なく静かに切り詰められました。

Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.

読み込まれるコンテンツのみが制限にカウントされます。YAML frontmatter とブロックレベルの HTML コメントはインデックスが読み込まれる前に削除されるため、測定から除外されます。v2.1.211 より前は、Claude Code は生ファイルを測定し、frontmatter またはコメントは読み込まれたコンテンツが適合しても、このエラーをトリガーする可能性がありました。

Claude Code はこのエラーをターミナルのバナーとして出力するのではなく、書き込み後に Claude に配信するため、トランスクリプトでのみ気付く可能性があります。

Claude の書き込みがファイルを制限に近づけても越えない場合、Claude Code はこのエラーの代わりに、インデックスをコンパクトにするための穏やかなリマインダーを返します。

What to do:

• Claude に MEMORY.md を書き直させるか、依頼します。エントリごとに 1 行を保持し、詳細をトピックファイルに移動し、古いエントリをマージまたは削除します
• インデックスを自分で削除するには、Audit and edit your memoryを参照してください

pkill pattern matches the Claude Code process

Bash ツール呼び出しの pkill コマンドは、通常 -f を使用するパターンを使用し、Claude Code プロセス自体と一致するため、Claude Code はコマンドを実行してセッションを終了させるのではなく、コマンドを拒否します。Claude Code は pgrep でパターンをテストし、独自のプロセス ID が結果に含まれている場合は拒否します。チェックは Linux でのみ実行されます。macOS では、pkill は変更されずに実行されます。v2.1.214 より前は、コマンドが実行され、一致するパターンが Claude Code セッションをターン中に終了させました。

pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.

拒否はターミナルのバナーではなく、Bash ツール結果に表示され、Claude は通常、コマンドを自動的に調整します。

What to do:

• パターンを絞り込んで、短い部分文字列ではなく、ターゲットバイナリの完全なパスなど、意図したプロセスのみと一致するようにします
• 現在のシェルで開始されたプロセスを停止するには、パターンで pkill -P $$ を使用します。これにより、マッチをシェルの独自の子プロセスに制限します

Failed to write to a teammate's inbox

Claude Code は ~/.claude/teams/{team-name}/inboxes/ の下のチームメイトのメールボックスファイルにメッセージを書き込むことができなかったため、受信者は何も受け取りませんでした。書き込みは、Claude Code がファイルを作成または更新できない場合に失敗します。例えば、ディスクがいっぱい、ディレクトリが書き込み可能でない、または別のエージェントがインボックスロックを長時間保持している場合などです。v2.1.224 より前は、Claude Code は書き込みが失敗した場合でも、メッセージが送信されたと報告しました。

エラーはターミナルのバナーではなく、送信エージェントのツール結果に表示され、テキストは Claude に再試行するよう指示します。

Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.

構造化された agent teamプロトコルメッセージは同じ方法で失敗し、エラーは未配信メッセージに名前を付けます。Claude Code が計画承認、計画却下、シャットダウン要求、またはシャットダウン却下を書き込むことができない場合、エラーは Failed to write the <message> to <name>'s inbox — nothing was sent と読みます。そのリストの plan approval はチームメイトの計画を承認するリーダーの決定です。チームメイトの計画提出は、別の plan approval request メッセージです。そのメッセージと他の 2 つのプロトコルメッセージは、独自のメッセージテキストと結果を持ちます。

• Failed to write the plan approval request to the lead's inbox — plan not submitted; try again: チームメイトの計画がリーダーに到達せず、チームメイトは再提出が成功するまで計画モードのままです
• The permission request could not be delivered to the team lead (mailbox write failed): チームメイトの権限要求がリーダーに到達しなかったため、誰もツール呼び出しを承認しませんでした
• The confirmation could not be written to team-lead's inbox.: シャットダウン承認自体が有効になり、チームメイトが終了します。リーダーへの確認のみが不足しています

リード セッションでチームメイト自身にメッセージを送信する場合、@name に続いてメッセージを入力すると、同じ失敗は通知として表示されます。Couldn't write to @name's inbox — message not sent. Try again. であり、Claude Code はテキストをプロンプトボックスに保持して、再度送信できるようにします。

What to do:

• 送信者にメッセージを再送信するよう依頼します。インボックスロックの競合は一時的であり、再試行時にクリアされます
• 空きディスク容量を確認し、~/.claude/teams とその下のファイルがユーザーによって書き込み可能であることを確認します

Teammate's agent definition was not restored

Claude は停止した agent teamチームメイトにメッセージを送信し、Claude Code はそれを subagent 定義を再適用せずに復帰させました。その定義ファイルは、保存された信頼のないフォルダから来たためです。通知は、送信エージェントのツール結果の再開レポートに続きます。

Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.

チェックは、プロジェクトの .claude/agents/ ディレクトリまたは --add-dir ディレクトリの定義に適用され、親フォルダの信頼ダイアログを受け入れることはそれを満たしません。

What to do:

• debug logが指定するフォルダで claude を実行し、信頼ダイアログを受け入れます。定義は Claude Code がチームメイトを次に復帰させるときに再適用されます。リード セッションを再起動する必要はありません
• または、~/.claude.json の hasTrustDialogAccepted エントリを true に設定します。debug log が出力する正確な projects["<path>"] キーを使用します

Message too large for cross-session delivery

Claude の cross-session messageは、このマシン上の別のセッションに対して長すぎて送信できませんでした。Claude Code はそれを拒否し、受信セッションは何も受け取りませんでした。拒否は、ターミナルのバナーではなく、送信セッションのツール結果に表示されます。両方のサイズとメッセージを適合させる方法に名前を付けます。

Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.

同じテキストを再送信すると、同じ方法で失敗します。

What to do:

• Claude にメッセージを要約するか、バルクコンテンツをファイルに入れて、受信者が読むことができるようにするよう依頼します
• Claude にコンテンツを複数の短いメッセージに分割するよう依頼します

v2.1.235 より前は、Claude Code は超過サイズのメッセージを送信されたと報告しました。受信セッションはそれを未読でドロップしました。

Too many messages to this session just now

Claude は、このマシン上の 1 つのセッションに対して cross-session messagesの急速なバーストを送信し、バーストはそのセッションのインボックスが受け入れるものに達しました。Claude Code は次の送信を拒否し、受信セッションはそれから何も受け取りませんでした。拒否は、ターミナルのバナーではなく、送信セッションのツール結果に表示されます。

Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.

What to do:

• 通常は何もしません。Claude は残りのコンテンツを 1 つのメッセージにバッチするか、さらに送信する前に少し待ちます
• バースト自体をプロンプトした場合、Claude に残りのものを 1 つのメッセージに結合するよう依頼します

v2.1.236 より前は、Claude Code はこれらの送信を送信されたと報告しました。受信セッションはそれらを未読でドロップしました。

Refusing to send a cross-session message

Claude Code が cross-session messageをこのマシン上の別のセッションに書き込む前に、ターゲットセッションのインボックスソケットがメッセージが宛てられたエンドポイントであることを確認します。チェックが失敗すると、Claude Code は送信セッションで送信を拒否し、ターゲットセッションは何も受け取りません。Claude が送信するメッセージの場合、拒否は送信セッションのツール結果に表示されます。

Failed to send to api-worker: Refusing to send: reply target is a symlink

Refusing to send: の後のテキストは、失敗したチェックに名前を付けます。

• reply target is a symlink: シンボリックリンクがターゲットセッションのソケットパスにあります。Claude Code はそれを通じて配信しません。リンクがそこにあると、メッセージをターゲットセッションが作成しなかったエンドポイントにリダイレクトする可能性があるためです。
• cannot vet reply target: Claude Code はターゲットパスをまったく検査できませんでした。例えば、権限エラーで読み取りが失敗した場合などです。
• connected endpoint is not the expected process: ソケットを保持しているプロセスは、メッセージが宛てられたセッションではないため、アドレスは古いか、別のプロセスがソケットを置き換えました。
• connected endpoint identity could not be read: Claude Code は接続しましたが、どのプロセスが反対側を保持しているかを読み取ることができなかったため、ターゲットを確認できませんでした。これは一時的である可能性があります。
• connected endpoint is not owned by this user: ソケットを保持しているプロセスは別のユーザーアカウントで実行されるため、セッションの 1 つではありません。
• connected endpoint owner could not be read: Claude Code は接続しましたが、どのユーザーアカウントが反対側を所有しているかを読み取ることができなかったため、エンドポイントがあなたのものであることを確認できませんでした。
• connected endpoint is a different process with the expected pid: プロセス ID はメッセージが宛てられたものと一致しますが、Claude Code はそれが同じプロセスであることを確認できませんでした。通常、そのセッションが終了し、オペレーティングシステムがプロセス ID を再利用したため、アドレスは古いです。

What to do:

• 通常は何もしません。チェックはメッセージが宛てられたセッション以外のエンドポイントに到達するのを防ぎ、何も送信されませんでした
• Claude にセッションを再度リストするよう依頼して再送信します。古いアドレスが原因の拒否は、Claude が現在のセッションに送信すると消えます
• reply target is a symlink が 1 つのセッションで繰り返される場合、そのセッションのソケットパスにリンクを作成したものを確認します。これは /status の Peer address に表示されます
• connected endpoint identity could not be read の場合、再送信します。条件は一時的である可能性があります
• connected endpoint is not owned by this user が共有マシンに表示される場合、そのアドレスのセッションは別のユーザーのアカウントで実行されるため、Claude はあなたのアカウントからそれにメッセージを送信できません

v2.1.248 より前は、Claude Code はエンドポイントの所有ユーザーまたはプロセス開始時刻をチェックしなかったため、これらのチェックに名前を付ける拒否は以前のバージョンに表示されません。

Refusing to read, write, or search a path

Claude Code はファイルパスの permission rulesをチェックし、ツールがファイルを開くか検索を開始するときに解決を再度確認します。パスがチェックが承認した場所にまだ導いていることを確認できない場合、Claude Code はそれに従う代わりに操作を拒否します。拒否はツール結果に表示されます。

Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.

各拒否は理由に名前を付けます。

• its symlink resolution changed after permission was checked: パスに沿ったシンボリックリンク、または Grep または Glob 検索ルートが、権限チェックと操作の間に置き換えられました。読み取り拒否では、括弧内のフレーズはどの比較が失敗したかを指定します。
• its parent-directory symlink resolution changed after permission was checked: 書き込みパスが通過するディレクトリは、承認された場所にもはや解決されません
• it is a symbolic link. Write to the link's target path instead: シンボリックリンクが承認された書き込み場所自体にあります。例えば、CLAUDE.md が AGENTS.md へのシンボリックリンクです。メッセージは Claude をリンクのターゲットに指示します
• Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.: 別のライターがファイルを開くときに捕捉された同じ条件。例えば、シンボリックリンクされた .mcp.json への書き込み
• Refusing to write into symlinked directory: <path>: ファイルを保持するディレクトリ自体がシンボリックリンクです。例えば、プロジェクトの .claude/ ディレクトリが別の場所にリンクされています
• a path one of its Read deny rules is written through changed while the search was being prepared. Retry.: Read deny ルールの検索がシンボリックリンクを通過するパスに名前を付け、そのリンクが Claude Code が検索を準備している間に変更されました
• it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.: 検索ルートは存在しますが、開くことができませんでした。括弧内のコードはオペレーティングシステムエラーです
• its permission check expired before it ran (too many concurrent file operations). Retry.: Claude Code は多くの同時ファイル操作の下で、ツールが使用する前に承認レコードを削除しました。再試行は新しい権限チェックを実行します
• ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration: Claude Code は rg バイナリを絶対パスに解決できなかったため、deny ルールをカバーしない検索を実行するのではなく、作業ディレクトリの外の検索を拒否します

What to do:

• 通常は何もしません。拒否は Claude にツール結果として到達し、拒否された操作は実行されません
• シンボリックリンク拒否が 1 つのパスで繰り返される場合、ビルドツールやファイルウォッチャーなど、リンクをそこで書き直し続けるものを見つけるか、Claude にリンクされたものの代わりにファイルの解決されたパスを使用するよう依頼します
• Claude Code が Windows 内の AppContainer または制限トークンサンドボックスで実行されている場合、この拒否がすべてのファイルに対して表示される場合は、v2.1.265 以降にアップグレードします
• macOS でこの拒否がスクリーンショットをプロンプトにドラッグしたファイルなど、何も書き直していないファイルに対して表示される場合は、v2.1.273 以降にアップグレードします
• ripgrep 拒否の場合、パッケージマネージャーで ripgrep をインストールして、rg が PATH 上の絶対パスに解決されるようにするか、作業ディレクトリの下で検索を保持します

v2.1.251 より前は、Claude Code はファイル書き込みに対してのみパスの解決を再チェックしたため、権限チェック後に置き換えられたリンクは、メッセージなしで読み取りまたは検索を別の場所にリダイレクトする可能性がありました。これらの拒否のうち、親ディレクトリ、スルーシンボリンク、およびシンボリンクディレクトリ書き込み拒否のみが以前のバージョンに表示されます。

Task output swap refused

Claude Code は各 Bash コマンドの出力をその一時ディレクトリの下のファイルに保存します。このファイルを開くたびに、パスがまだ Claude Code が作成したファイルにつながっていることを確認します。シンボリックリンク、追加のハードリンク、または移動されたディレクトリがそれをリダイレクトしていません。このメッセージは、そのチェックが失敗したことを意味するため、Claude Code はそのパスを通じて出力を書き込むのではなく、操作を拒否しました。メッセージは Bash ツール結果に表示されます。

task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.

括弧内のテキストは、失敗したチェックに名前を付けます。output symlink was re-pointed、output file identity changed、not a regular file などの理由はすべて同じ条件を報告します。出力パスのどこかまたはその沿いに何かがもはや Claude Code が作成したファイルではありません。一部の理由のみが To recover: 文を持ちます。

コマンドがまだ実行中にチェックが失敗した場合、Claude Code はコマンドを停止し、その結果は以下を報告します。

Command killed: its output file was replaced or could no longer be verified

What to do:

• v2.1.260 以降にアップグレードします。以前のバージョンは、リンクまたは移動されたディレクトリが存在しない場合でも、このメッセージを表示することがあります
• CLAUDE_CODE_TMPDIRを新しいディレクトリに設定して Claude Code を再起動します
• または、プロジェクトのディレクトリを Claude Code 一時ディレクトリの下で確認します。例のメッセージでは /private/tmp/claude-501/-Users-you-my-project です。そのパスがシンボリックリンクであるか、そこにあるべきではないディレクトリである場合、リンクのターゲットではなく、リンクまたはディレクトリ自体を削除して、Claude Code を再起動します
• 拒否が繰り返される場合、セッションが実行されている間に、プロセスが Claude Code の一時ディレクトリの下のエントリを置き換え、リンク、または削除しています。CLAUDE_CODE_TMPDIRを他に何も管理しないディレクトリに設定して再起動します

The source file is not valid UTF-8 text

Claude は、バイトがテキストとしてデコードされないファイルから artifactを公開しようとしました。または、テキストにはすでに置換文字 U+FFFD が含まれているため、Claude Code は何もアップロードする前に公開を拒否しました。メッセージは Artifact ツール結果に表示され、修正する最初の位置に名前を付けます。

file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.

file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.

Claude Code はファイルを UTF-8 としてデコードするか、リトルエンディアン UTF-16 バイト順マークで始まる場合は UTF-16 としてデコードします。そのような UTF-16 ファイルがデコードされない場合、最初のメッセージは UTF-16 に名前を付け、ファイルを UTF-8 として書き直すよう指示します。名前の後に複数の位置が続く場合、メッセージは位置の後に (+2 more) などのカウントを追加します。

What to do:

• 通常は何もしません。Claude はファイルを書き直して公開します
• ファイルが自分で書いたか、エクスポートしたものである場合は、UTF-8 として再度保存し、各 U+FFFD を以前の編集、貼り付け、または変換で失われた文字に置き換えます
• ページに意図的な U+FFFD を表示するには、リテラル文字の代わりに HTML で � として書き込みます

v2.1.267 より前は、Claude Code はそのようなファイルをチェックなしでアップロードし、サーバーは代わりに公開を拒否しました。

Reading a local file from outside the connected folders in a Cowork session

Coworkセッションで Claude Desktop アプリでマシン上で実行されている場合、Claude はローカルファイルを artifactに指定しました。Claude Code はファイルがセッションの接続フォルダ内のプレーンファイルであることを確認できませんでした。パスはそれらのフォルダの外にあり、シンボリックリンクを通過するか、それが見えるのとは異なるファイルに名前を付けることができる方法で綴られています。そのようなファイルを読み取るにはあなたの承認が必要であり、すべての承認をスキップするように設定されたセッションなど、承認カードを表示できないセッションでは、Claude Code は読み取りを拒否します。

拒否は Artifact ツール結果に表示されます。ファイルをまったく検査できない場合、代わりにその失敗に名前を付けます。

Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.

cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.

What to do:

• 通常は何もしません。メッセージは Claude に接続フォルダ内のプレーンファイルを代わりに使用するよう指示します
• その正確なファイルをアーティファクトに入れるには、セッションの接続フォルダの 1 つにそれをコピーして、シンボリックリンクではなく通常のファイルとして、再度依頼します

WebFetch cannot fetch localhost

Claude は WebFetchを、http://localhost:3000 や http://wiki/ のようなドットのないホスト名を持つ URL で呼び出しました。WebFetch はリクエストを行う前にこれらの URL を拒否します。

WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.

What to do:

• 通常は何もしません。メッセージは Claude を Bash ツールを通じて curl に指し示し、ローカルおよびイントラネットサーバーに到達できます

v2.1.268 より前は、WebFetch はこれらの URL を汎用 Invalid URL エラーで報告しました。

バックグラウンドセッションエラー

バックグラウンドセッションは独自のインタラクティブターミナルなしで実行されるため、ターミナルが必要なコマンドはそこで異なる動作をします。これらのメッセージはバックグラウンドセッションのトランスクリプト、それに接続するターミナル、ディスパッチ元のセッションまたはシェル、または以下のworktree-guard エントリの場合は worktree に分離されたセッションまたは worktree 分離サブエージェントを実行しているセッションに表示されます。メッセージが特定の表面に固有の場合、そのエントリに記載されています。

バックグラウンドセッションで拒否されたコマンド

インタラクティブダイアログを開くコマンドは、バックグラウンドセッションにターミナルが接続されていない間は実行できません。/install-github-app、/mcp 設定リスト、および MCP サーバーメニューの認証アクションは、メッセージで応答し、セッションはエージェントビューの入力が必要に表示されるため、セッションを見つけて接続し、コマンドを再度実行できます。ターミナルが接続されている間、これらのコマンドは正常に機能します。

v2.1.216 より前では、これらの拒否の後、セッションは入力が必要に表示されませんでした。v2.1.213 から v2.1.215 では、ターミナルが接続されている間、コマンドは引き続き機能し、拒否メッセージは接続して再度コマンドを実行するよう指示していました。v2.1.208 から v2.1.212 では、Claude Code はターミナルが接続されている間でもこれらを拒否し、Can't open MCP settings in a background session などのメッセージが表示されていました。これらのバージョンでは、通常の claude セッションからコマンドを実行するか、アップグレードしてください。v2.1.208 より前では、バックグラウンドセッション内でダイアログが開きました。v2.1.208 のみで、Claude Code はバックグラウンドセッションの /model ピッカーも拒否し、/upgrade はブラウザを開く代わりにアップグレード URL を出力しました。

表現はコマンドに名前を付けます。/mcp 設定リストは以下を報告します：

Can't open MCP settings while no terminal is attached to this background session. This session now shows "needs input" in agent view — open it and run /mcp to manage servers, or use `/mcp enable|disable|reconnect <server>` to steer without the panel.

対処方法：

• エージェントビューからセッションに接続します。セッションは入力が必要に表示されており、コマンドを再度実行します
• または、メッセージが名前を付けた形式を使用します。例えば /mcp reconnect <server>、/mcp enable、または /mcp disable は、接続せずに機能します

パスを安全に解決できないため、書き込みまたはコマンドがブロックされました

Claude は、worktree 分離ガードが 1 つの検証可能な場所に解決できないスペルを通じてファイルまたは作業ディレクトリにアクセスしました。ガードは、worktree に分離されたセッション（インタラクティブまたはバックグラウンド）およびworktree 分離サブエージェントでの書き込みとコマンド作業ディレクトリをチェックします。解決前にシンボリックリンクを解決し、操作が共有チェックアウトに到達しないことを確認します。解決に失敗すると、操作をブロックして、そこに到達させません。メッセージは、拒否するパス形式と再試行方法に名前を付けます：

This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.

ブロックされたコマンドは、作業ディレクトリについて同じ原因を報告し、re-run the command from its direct symlink-free path で終わります。v2.1.217 より前では、ガードはシンボリックリンクを解決せずにパススペルを比較していたため、これらのスペルはブロックされず、シンボリックリンクを通じた書き込みは共有チェックアウトに到達する可能性がありました。

対処方法：

• 通常は何もしません：完全なメッセージは Claude にツールエラーとして送信され、Claude は名前を付けた直接パスで再試行します。ブロックされたファイル編集の場合、会話ビューには短い Error editing file 行のみが表示されます。完全なメッセージはトランスクリプトビューに表示されます。これは Ctrl+O で開きます。ブロックされたコマンドはコマンド出力に出力します。
• 同じファイルでブロックが繰り返される場合、パスは docs/current -> ../README.md など .. を含むコミット済みシンボリックリンクを通じて実行される可能性があります。Claude にリンクを通じてではなく、実際のパスでターゲットファイルを編集するよう依頼してください

パスがネットワークロケーションに名前を付けているため、書き込みまたはコマンドがブロックされました

Claude は、マシン上にないドライブ、\\server\share\file などの UNC 共有、または /net オートマウントパスに名前を付けるパスを通じてファイルまたは作業ディレクトリにアクセスしました。セッションのチェックアウトはローカルディスク上にあります。同じworktree 分離ガードは、そのようなパスが共有チェックアウトから外れていることを確認できないため、操作をブロックします。セッションを worktree に分離してもブロックは解除されません。メッセージは、代わりに使用するパスの形式に名前を付けます：

This write was blocked because the path is network-shaped (a UNC share or /net automount spelling) while this session's checkout is local. Isolating cannot unblock it. If the file is genuinely inside the worktree /path/to/worktree, address it by its local, plainly-spelled path instead.

ブロックされたコマンドは、作業ディレクトリについて同じ原因を報告し、re-run the command from its local, plainly-spelled path で終わります。v2.1.217 より前では、ガードはパステキストのみを比較していたため、UNC または /net パスを通じてチェックアウト内のファイルにアクセスすることはブロックされませんでした。

対処方法：

• 通常は何もしません：Claude はメッセージが要求するローカルスペルで再試行します
• ファイルがローカルファイルのスペルが付いたネットワークパスではなく、ネットワーク共有上にある場合、セッションのローカルワークスペースの外にあります。通常のインタラクティブセッションから編集してください

このセッションに保存されたトランスクリプトがありません

停止したバックグラウンドセッションに接続しました。このセッションは ← または /background で別の会話からバックグラウンドに移動され、最初の応答が完了する前に停止しました。その最初の応答が完了するまで、会話はバックグラウンドに移動した元のセッションにのみ存在するため、claude attach は停止したセッションの開始を拒否し、同じセッション ID で空白の会話を開始しません。メッセージは、このセッションの claude respawn コマンドで終わります：

This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.

エージェントビューで同じセッションの行を開くと、リストの下に Press enter again to restart this session fresh が表示され、行の 2 番目の Enter はセッションを空の会話で再開します。v2.1.212 より前では、行を開くと拒否メッセージが表示され、エージェントビューから再開する方法がありませんでした。v2.1.211 より前では、停止したセッションを開くと、その空白の会話が静かに開始され、セッションの元のプロンプトを再実行できました。

対処方法：

• バックグラウンドに移動した会話は無傷です：claude --resume で再開するか、そこで作業を続けます
• 停止したセッションを新しく開始するには、メッセージの ID で claude respawn <id> を実行するか、エージェントビューの行で Enter を 2 回押します
• セッションが応答を完了し、v2.1.214 より前のバージョンでこの拒否が表示される場合、~/.claude/projects の読み取り不可フォルダがトランスクリプトスキャンが保存された会話を見つけるのを妨げる可能性があります。v2.1.214 以降にアップグレードしてください。これはスキャン中に読み取り不可フォルダを許容します

このセッションは別のターミナルで実行されています

エージェントビューで停止したセッションの行を開きました。その保存された会話は、このマシン上の別のライブ Claude Code プロセスで既に開かれているため、Claude Code は同じトランスクリプトに書き込む 2 番目のプロセスの開始を拒否します。表示されるメッセージは、会話を保持しているものによって異なります：

Can't open — this session is running in another terminal
This conversation is already open in another running Claude session — use that one, or close it and try again

• running in another terminal：ターミナルが会話を保持しています。例えば、claude --resume または /resume で再開したターミナル。行には Open in a terminal も表示されます。
• already open in another running Claude session：別の非インタラクティブ Claude Code プロセスがそれを保持しています。例えば、同じ会話のバックグラウンドセッションプロセスがまだ終了していません。

Claude Code は、行を開くときに入力した返信を保存し、セッションが次に開始するときにセッションの次のプロンプトとして送信します。

対処方法：

• 会話を開いているプロセスで会話を続けるか、そのプロセスを終了して行を再度開きます

v2.1.248 より前では、already open in another running Claude session 拒否のみが存在していました：ターミナルで再開された会話は開いているとはカウントされず、行を開くと同じ会話に書き込む 2 番目の Claude Code プロセスが開始されました。

このセッションの保存された会話はディスク上にもうありません

バックグラウンドセッションを開きました。このセッションはバックグラウンドサービスがオフの間に終了し、トランスクリプトクリーンアップがその保存された会話を削除しました。例えば、マシンが数週間オフになった後です。通常、そのような行を開くと、保存された会話を再開します。再開するものがないため、Claude Code は、セッションの元のプロンプトを再実行するよう求めずに拒否します：

This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.

claude attach <id> はこのテキストを出力します。エージェントビューでは、フッターはより短く、ctrl+x deletes the row で終わります。

対処方法：

• claude rm <id> を実行して行を削除します。保持されたケースの 1 つが適用される場合、claude rm は行と worktree を保持し、理由に名前を付けます
• セッションの元のプロンプトを新しい会話として再度実行するには、claude respawn <id> を実行します

v2.1.248 より前では、そのような行を開くと、セッションの元のプロンプトを再実行し、数週間前のタスクをフォアグラウンドに引き戻しました。

Worktree にはどこにもプッシュされていないコミットがあります

バックグラウンドセッションを削除しようとしました。その worktree は、Claude Code が他の場所に保存されていることを確認できないコミットを保持しています。Claude Code は、コミットを見ずに破棄するのではなく、worktree とセッション行を保持します。claude rm はブランチとプッシュされていないコミットに名前を付け、進め方を説明します：

kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"
  2 unpushed commits on "claude/fix-login": a1b2c3d "Fix login flow" and 1 more. They exist on no remote, so deleting the worktree would lose them.
  push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef

Claude Code がコミットを要約できない場合、詳細行は The worktree has unpushed commits を読みます。エージェントビューでは、セッションの行は同じ理由で not deleted を表示します。

リモート上のコミットは削除をブロックしません。ローカルコピーの origin リモートのデフォルトブランチ上のコミットもブロックしません。そのブランチがメインチェックアウト（リポジトリディレクトリ自体、worktree ではなく）でチェックアウトされている限り。

対処方法：

• コミットを保持するには、worktree のブランチをプッシュするか、メインチェックアウトでチェックアウトされたデフォルトブランチにマージしてから、セッションを再度削除します
• コミットを破棄するには、メッセージが出力した claude rm <id> --discard-unpushed コマンドを実行するか、エージェントビューのセッション行で Ctrl+X を 2 回押します。これにより、セッション、worktree、そのブランチ、プッシュされていないコミット、およびコミットされていない変更が削除されます。worktree が拒否以降にコミットを獲得した場合、Claude Code はそれを再度保持し、更新された状態を表示します
• メッセージが worktree が別の完了したセッションによっても記録されていることを示す場合、再度削除してもそれは破棄されません：コミットをプッシュしてから、セッションを再度削除します

v2.1.268 より前では、claude rm はコミット要約を kept 行自体に置いていました。Claude Code がコミットを要約できない場合、kept 行は要約の代わりに worktree has commits that are not pushed anywhere を読みました。

v2.1.260 より前では、メッセージはブランチまたはコミットに名前を付けず、再度削除することは同じ方法で拒否されました：セッションを削除してプッシュしないことは、git worktree remove --force <path> で worktree を自分で削除してから、claude rm <id> を再度実行することを意味していました。

v2.1.248 より前では、メインチェックアウトでチェックアウトされたデフォルトブランチはカウントされませんでした：既にそこにマージしたブランチは、そのコミットがリモートに到達するまで、この拒否をトリガーしました。

ターミナルホストプロセスが終了しました

各バックグラウンドセッションのターミナルはバックグラウンドサービスの下のホストプロセスで実行され、そのプロセスはサービスがその接続を保持している間に終了したため、セッションに到達できませんでした。

Linux と WSL では、バックグラウンドサービスは数秒ごとに各ホストプロセスをチェックし、プロセスが終了しているがサービスへの接続が閉じられていない場合、セッションを失敗とマークし、エージェントビューの行に理由を表示します：

terminal host process died — press Enter to restart

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

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

Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.

会話はどちらの場合でも保存されます。

シェルコマンドを実行している行は代わりに terminal host process died — its output is gone; the command was not run again を表示し、claude attach は This command's terminal host process died — its output is gone and the command was not run again を出力します。Claude Code はコマンドを再実行することはありません。

対処方法：

• エージェントビューで、失敗した行で Enter を押します。セッションは新しいホストプロセスで再開され、会話が再開されます
• シェルから、claude attach <id> を再度実行します。Claude Code は Session <id>'s terminal host died — restarting it on a fresh one… を出力し、セッションを再度開きます
• シェルコマンド行をこの方法で再開することはできません。コマンドを再度ディスパッチして再実行します

v2.1.247 より前では、死んだホストプロセスはバックグラウンドサービスが実行したすべての生存性チェックに合格する可能性があったため、セッションを開くと opening… · esc to cancel が無期限に表示され、claude attach <id> はエラーを報告せずに待機していました。

セッションが応答していません

バックグラウンドセッションを開きました。バックグラウンドサービスは開くことを受け入れましたが、約 10 秒間出力が到着しなかったため、Claude Code は、セッションのターミナルをリレーするプロセスが出力を配信できないと結論付け、待機する代わりに試行を終了します。

エージェントビューでは、Claude Code はフッターで再開を提供します：

Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).

シェルから、claude attach <id> は原因を出力して終了します：

Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).

Claude Code は、シェルコマンドを実行している行を再開することはありません。再開するとコマンドが再度実行されるためです。

対処方法：

• エージェントビューで、同じ行で Enter を再度押します。Claude Code は応答しないプロセスを停止し、セッションを再開し、会話が再開されます。2 番目のプレスなしに何も停止されません
• シェルから、claude stop <id> を実行してから、claude attach <id> を実行します
• シェルコマンド行の場合、エージェントビューで Ctrl+X を押すか、claude stop <id> を実行してそれを停止します。コマンドを再度ディスパッチして再実行します

セッションは respawn が進行中に停止されました

バックグラウンドセッションを開きました。そのプロセスは実行されていなかったため、Claude Code はそれを再開していました。その間に、別の Claude Code プロセスがそれを停止しました。例えば、別のターミナルで claude stop を実行しました。Claude Code はセッションを停止したままにします：

Session <id> was stopped while the respawn was in flight

ディスパッチしたばかりのセッションを開く場合、そのプロセスがまだ開始中の間、プロセスの開始を待ちます。v2.1.246 より前では、その時点でそれを開くと、それを停止してこのメッセージを表示する可能性がありました。

対処方法：

• セッションを停止しなかった場合、エージェントビューで行を再度開くか、claude respawn <id> を実行して再開します
• セッションを自分で停止した場合、残っているものはありません：セッションは停止したままです

セッションエージェントはもう利用できません

カスタムエージェントを実行していたセッションを再開しました。--agent またはエージェント設定で開始され、Claude Code はその名前のエージェントを見つけませんでした。セッションの元のディレクトリを最初に検索します。そのワークスペースを信頼している場合、再開するディレクトリを検索します。セッションは引き続き再開されますが、デフォルトツールとシステムプロンプトを使用するため、エージェントのツール制限は適用されなくなります：

This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.

警告は、Claude Code が検索したディレクトリのみに名前を付け、バックグラウンドセッションを起動するか、/resume または claude --resume を実行するか、非インタラクティブモードで再開するかどうかに関わらず、再開された会話に表示されます。そこでは stderr にも送信されます。--input-format stream-json を使用するセッションは、Agent SDK がスタートアップ後にエージェントを提供するため、表示されません。

Claude Code はセッションへのフォールバックを保存しないため、警告は、対処するまで各再開で繰り返されます。組み込みの claude エージェントは、デフォルトツールセットへのフォールバックがそれに対して何も変わらないため、警告をトリガーしません。v2.1.216 より前では、Claude Code は静かにデフォルトエージェントとして続行し、ルックアップは再開するディレクトリのみをカバーしていたため、プロジェクトスコープのエージェントは別のディレクトリから再開すると失われました。

対処方法：

• セッションのプロジェクトの .claude/agents/<name>.md または個人エージェントの ~/.claude/agents/<name>.md にエージェントファイルを再作成してから、再度再開します
• または、--agent <name> で再開して、存在するエージェントに名前を付けて、セッションをそのエージェントとして実行します
• エージェントがプロジェクトスコープで、セッションの元のディレクトリを信頼していない場合、そこで Claude Code を 1 回実行し、信頼ダイアログを受け入れてから、再度再開します

CLAUDE\_CODE\_PROCESS\_WRAPPER ランチャーエラー

CLAUDE_CODE_PROCESS_WRAPPERが設定されており、その値は使用できないため、Claude Code はランチャーなしで実行するのではなく、影響を受けるプロセスの開始を拒否します。構成の問題は、変数名で始まり、理由を述べるメッセージで報告されます。例えば：

CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

開始するが Claude Code で自分自身を置き換えずに終了するランチャーは、それが開始していたセッションを失敗させ、エージェントビューのセッション行は、ランチャーが must exec, not daemonize に続いて、ランチャーが出力したものを報告します。バックグラウンドサービスに到達できないセッションは、ランチャーの問題を理由として Couldn't reach the background service (...) 内で報告します。

対処方法：

• 変数を、exec "$@" を呼び出して終了する実行可能ファイルの絶対パスに設定します。完全な契約については、ランチャー契約を参照してください
• /status をチェックします。これは Self-exec エントリで解決されたランチャーコマンドを表示し、実行中のバックグラウンドサービスが一致しない場合に警告するか、シェルから claude daemon status を実行します
• 設定の env ブロックで値を修正した後、claude daemon stop --any でバックグラウンドサービスを再開して、次のディスパッチがラップされたものを開始するようにします

バックグラウンドセッションを開始するときの EUNKNOWN

Windows は標準名を持たないエラーコードでプログラムの開始を拒否したため、失敗は EUNKNOWN として表示されます。通常のトリガーはソフトウェア制限ポリシー（グループポリシーや AppLocker など）で、開始されるプログラムをブロックしています。エラーは、/background または claude --bg でバックグラウンドセッションを開始するときに表示されます：

Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'

一部のアカウントでは、メッセージは background service の代わりに daemon を示しています。

npm インストールでは、npm install -g @anthropic-ai/claude-code がバイナリを置き換えている間に表示される EUNKNOWN は、再インストール中の EACCESと同じ原因を持ち、インストール完了後に再試行するとクリアされます。

Claude Code は PowerShell を通じてバックグラウンドサービスを開始するため、ターミナルを閉じてもサービスが存続します。PowerShell 7 がインストールされている場合はそれを使用し、そうでない場合は Windows PowerShell 5.1 を使用します。どちらの PowerShell も実行できない場合、Claude Code は代わりにサービスを直接開始するため、PowerShell のみをブロックするポリシーはこのエラーを引き起こしません。npm インストールが実行されていない間にそれを見る場合、ポリシーは Claude Code 実行可能ファイル自体をブロックしています。

v2.1.212 より前では、Claude Code は Windows PowerShell 5.1 のみを使用してサービスを開始していたため、グループポリシーが PowerShell 5.1 をブロックしたマシンは、PowerShell 7 がインストールされていても Couldn't start the session — EUNKNOWN: unknown error, uv_spawn で失敗しました。

対処方法：

• メッセージが Couldn't start the session を読む場合、v2.1.212 以降にアップグレードします。以前のバージョンでは、別のターミナルで最初に claude daemon run を実行してから、バックグラウンドセッションを再度開始することもできます。そのコマンドはバックグラウンドサービスをターミナルのフォアグラウンドで実行するため、サービスはそのターミナルが開いている限り続きます。
• npm インストールがバイナリを置き換えていた場合、完了するまで待ってから、バックグラウンドセッションを再度開始します
• エラーが npm インストールが実行されていない間に v2.1.212 以降で表示される場合、Windows 管理者に Claude Code 実行可能ファイルを制限ポリシーで許可するよう依頼します
• ターミナルを閉じるとバックグラウンドサービスが停止する場合、Claude Code は PowerShell なしでそれを開始しました。PowerShell 7 をインストールするか、管理者に PowerShell をブロック解除するよう依頼して、サービスがターミナルより長く続くようにします。

バックグラウンドセッションを開始するときの EACCES

Claude Code は、バックグラウンドセッションをホストするバックグラウンドサービスを開始するために、独自のバイナリを実行できませんでした。npm インストールでは、これは通常、npm install -g @anthropic-ai/claude-code がその時点でバイナリを置き換えていることを意味します。実行したか、自動アップデーターが実行したかどうか。エラーは、エージェントビューからセッションを開くときに表示されます：

Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'

/background または claude --bg でセッションを開始する場合、同じ理由は Couldn't reach the background service (...) 内に表示されます。同じ再インストールウィンドウ中に、エラーは ENOENT または ENOEXEC などの別のコードに名前を付けることができます。または Windows では EUNKNOWN または EPERM。再試行全体で持続する EUNKNOWN は異なる原因を持っています。

npm インストールでは、Claude Code は再インストールが完了するのを待ち、独自に再試行します：最大 10 秒、および Claude Code の npm インストールがマシン上で明らかにまだ実行されている間、最大 2 分。これは別の Claude Code プロセスがアップデートをダウンロードしている場合をカバーします。インストールがその待機を超える場合、失敗は裸のエラーコードではなくアップデートに名前を付けます：

Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes

v2.1.257 より前では、待機は 10 秒で停止していたため、別の Claude Code プロセスがまだアップデートをダウンロードしている間にこのエラーが表示されました。v2.1.246 より前では、Claude Code は待機なしで直ちに失敗しました。

対処方法：

• 数秒待ってから、セッションを開くか再度ディスパッチします。メッセージが Claude Code が更新されていることを示す場合、アップデートが完了した後に再試行します。
• npm インストールが実行されていない間にエラーが持続する場合、ユーザーはインストールされたバイナリを実行できません。そのパーミッションとそのディレクトリのパーミッションをチェックするか、Claude Code を再インストールします。

バックグラウンドサービスが到達可能になる前に終了しました

Claude Code がバックグラウンドサービスとして開始したプロセスは、接続を受け入れる前に終了したため、Claude Code はセッションを開くことができませんでした。サービスが終了する前にエラーを出力した場合、括弧内の理由は終了コードまたはシグナルと、サービスが出力した最初の行を示します。これはそれを停止したものに名前を付けます：

Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'

エージェントビューからセッションを開く場合、同じ理由は Couldn't start the background service — に従います。サービスが終了する前に何も出力しなかった場合、メッセージは代わりに nothing on stderr を示しています。

Claude Code はサービスのエラー行で失敗を報告します。v2.1.246 より前では、失敗は 45 秒の待機後にのみ表示され、background service did not become reachable within 45s として、サービスのエラー行なしで表示されました。

2 つの引用された理由は既知の原因を持っています：

• Error: claude native binary not installed.：npm インストールがその時点で Claude Code バイナリを置き換えていたため、サービスは npm のプレースホルダーを実行しました。インストール完了後に再試行します。インストールが実行されていない間に行が持続する場合、npm インストールを完了します。v2.1.257 より前では、macOS npm 自己更新はインストールウィンドウ中のすべての開始でこの失敗を生成しました。
• Windows で、すべての開始で終了コード 1 で nothing on stderr：daemon.lock は、Claude Code がシグナルを送信することも、消えたことを証明することもできないプロセスに名前を付けます。そのため、各新しいサービスは別のサービスがロックを保持していると結論付け、終了します。Claude Code が消えたことを証明できるロックは、独自に置き換えられ、この失敗を生成しません。失敗がすべての開始で繰り返される場合、~/.claude/daemon.lock を削除してから、セッションを開くか再度ディスパッチします。v2.1.257 より前では、そのようなロックはファイルを削除するまですべての開始をブロックしました。

対処方法：

• メッセージが行を引用する場合、それが名前を付けるものを修正してから、セッションを開くか再度ディスパッチします。次の試行はサービスを再度開始します
• claude daemon status を実行して、サービスが現在実行されているかどうかをチェックします

バックグラウンドセッションを開始するときに作業ディレクトリが存在しなくなりました

バックグラウンドセッションを開始しようとしました。そのセッションは、もう存在しないディレクトリで実行されます。これは、エージェントビューからディスパッチするか、作業中のディレクトリが削除または移動された後に /background を実行するときに発生します。また、プロセスが終了し、そのディレクトリが消えたセッションに接続または再開するときにも発生します。新しいプロセスは同じディレクトリで開始するためです。Claude Code はセッションを開始せず、メッセージは見つからないディレクトリに名前を付けます：

Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

v2.1.257 より前では、セッションは開始されたように見え、その後エージェントビューで同じ理由で失敗した行として表示されました。

対処方法：

• メッセージが名前を付けるディレクトリを再作成するか、存在するディレクトリからディスパッチしてから、再度試してください

ラッパーと IDE エラー

これらのエラーは、IDE 拡張機能や Agent SDK アプリケーションなど、Claude Code を起動したプログラムから発生します。Claude Code 自体からではなく、ラッパーから発生するものです。

Claude Code プロセスがコード N で終了しました

基盤となる claude プロセスがゼロ以外のコードで終了しました。終了コードだけでは何が失敗したかは分かりません。実際のエラーはプロセス自体の出力にあり、ラッパーはキャプチャした場合はそれを追加し、そうでない場合はログに保持します。

Error: Claude Code process exited with code 1

Windows では、ネイティブビルドはターンが完了した直後にコード 4294967295 で終了することがあります。その終了がターン境界に着地し、待機中のメッセージがなく、バックグラウンドタスクが実行されていない場合、VS Code 拡張機能 はこのエラーを表示する代わりに、セッションを静かに閉じます。次のメッセージで会話が再開されます。

v2.1.273 より前では、拡張機能は何も失われていないにもかかわらず、すべてのターン境界でそのエラーを表示していました。

対応方法：

• VS Code では、エラーと共に表示される View output logs リンクをクリックして、基盤となるエラーを確認してください
• Agent SDK アプリケーションでは、メッセージループの周りでエラーをキャッチしてください。CLI プロセス終了 の下のエントリは、各 SDK 言語でコードが受け取るものをカバーしています。
• 同じプロジェクトのターミナルで claude を実行してください。通常、失敗はそこで実際のエラーメッセージと共に再現され、このページで検索できます。
• ターミナルで claude doctor を実行して、インストールと設定を確認してください

Claude CLI が PATH に見つかりません

VS Code 拡張機能 は、Windows で統合ターミナルで Claude Code を開き、ターミナルのシェルが PowerShell で、拡張機能がインストールされた claude 実行ファイルを PATH で見つけられない場合、このエラーを表示します。拡張機能は、インストールされた claude を PATH で見つけるまで Claude Code の起動を拒否します。

Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH. Launching by name in a PowerShell terminal would run a 'claude' from the open folder instead of the installed CLI, so the launch was blocked. Make sure the Claude CLI's install directory is on your system PATH (not only your PowerShell profile), then restart VS Code and try again. VS Code reads PATH when it starts, so PATH changes take effect only after a restart.

対応方法：

• VS Code の外で新しい PowerShell ウィンドウを開き、where.exe claude を実行してください。パスが出力されない場合、CLI は PATH にありません。PATH を確認する に従ってインストールディレクトリを追加してください。パスが出力される場合、エントリは PowerShell プロファイルから、または VS Code がまだ取得していない PATH 変更から来ています。次の 2 つのステップがこれらのケースをカバーしています。
• PATH エントリを PowerShell プロファイルではなく、ユーザーまたはシステム環境変数として設定してください。拡張機能はプロファイルを実行しないため、そこにのみ存在する PATH 編集は拡張機能に到達しません。
• PATH を変更した後、VS Code を再起動してください。拡張機能は VS Code が起動時にキャプチャした PATH をチェックするため、PATH 変更は再起動後にのみ有効になります。

Claude Code への接続がこのメッセージの完了前に終了しました

VS Code 拡張機能 はメッセージを claude プロセスに送信し、プロセスが確認または完了する前に接続がエラーなしで終了しました。拡張機能はメッセージが処理されたかどうかを判断できないため、再度送信するよう求めます。

The connection to Claude Code ended before this message completed — it may not have been processed, so please send it again.

対応方法：

• メッセージを再度送信してください。次のメッセージは会話を再開する新しい claude プロセスを開始します。
• 繰り返される場合は、同じプロジェクトのターミナルで claude を実行してください。プロセスを終了し続ける失敗は通常、そこで実際のエラーメッセージと共に再現されます。

Rewind の警告とエラー

これらのメッセージは、/rewind コード復元から発生します。Restored the code, but skipped N files は Claude Code が一部のパスをスキップしたことを示す警告です。No files were restored は何も復元されなかったことを意味するエラーです。

Restored the code, but skipped files

/rewind コード復元は、1 つ以上の追跡パスをスキップしました。これらのパスに対して書き込みまたは削除を行いませんでした。Claude Code は以下の場合にパスをスキップします。

• シンボリックリンク、ハードリンク、またはその他の通常ファイル以外のファイルである、またはそうなった場合
• チェックポイント以降にそのディレクトリが変更された場合
• バックアップを安全に読み取ることができない場合

スキップされたパスは現在の内容を保持します。v2.1.216 より前では、/rewind は追跡パスのリンクを通じて書き込みと削除を行い、部分的な復元を報告しませんでした。

Restored the code, but skipped 2 files: the tracked path is (or became) a link or other non-regular file, its directory changed since the checkpoint, or its backup could not be safely read. Skipped files were left untouched — run with --debug for the paths.

対応方法：

• スキップされたファイルを特定して、以下の手順で各ファイルを処理してください。メッセージはカウントのみを示します。~/.claude/debug/<session-id>.txt のデバッグログには、復元の実行時に各スキップされたパスが記載されます。次の復元の前に /debug でデバッグログを有効にしてください。macOS または Linux では、代わりにリンクを直接見つけることができます。シンボリックリンクの場合は find . -type l、ハードリンクされたファイルの場合は find . -type f -links +1 を実行してください。
• スキップされたファイルが、dotfile マネージャーで管理されている設定ファイルや pnpm などのツールでハードリンクされたファイルなど、意図的に作成したリンクである場合、rewind はその内容をそのままにしました。セッションの変更を元に戻すには、Claude にその編集を逆にするよう依頼するか、ファイルを自分で編集してください。
• リンクを作成していない場合は、その内容を信頼する前にパスを検査してください。チェックポイント後にファイルが置き換わった可能性があります。

No files were restored

Claude Code は、/rewind でコードを復元しようとしたときにそのチェックポイント内のファイルを復元できない場合、このメッセージを表示します。各ファイルについて、Claude Code が編集前に保存したバックアップが見つからないか、Claude Code がファイルに書き込みまたは削除できませんでした。

Failed to restore the code:
No files were restored: 1 file failed (backup missing, or the file could not be updated)

Claude Code は、retention sweep でセッションのバックアップを削除します。デフォルトではセッションが最後にバックアップを保存してから約 30 日後です。その後にセッションを再開した場合、/rewind はそのチェックポイントをリストしますが、そのいずれかに rewind すると、このエラーで失敗する可能性があります。メッセージに N paths were skipped for link safety も表示されている場合は、これらのパスについて Restored the code, but skipped files を参照してください。

対応方法：

• 別の方法で変更を元に戻してください。Claude に編集を逆にするよう依頼するか、バージョン管理からファイルを復元してください。バックアップがなくなると、/rewind を再度実行しても同じ方法で失敗します。
• Claude Code がファイルに書き込みまたは削除できない場合は、ファイル権限など書き込みをブロックしているものを修正してから、/rewind を再度実行してください。
• 今後のセッションでバックアップをより長く保持するには、cleanupPeriodDays を増やしてください。

v2.1.260 より前では、Claude Code はバックアップが見つからないファイルをサイレントにスキップし、rewind が成功したように見えました。

セッション保存の警告

Claude Code は、セッショントランスクリプトを保存していない場合、入力ボックスの下の永続的な行に以下の警告を表示します。セッションはどちらの場合でも機能し続けます。警告は、後で --resume でセッションが見つからない可能性があることを示しています。

トランスクリプト書き込みが失敗しています

Claude Code は作業中にトランスクリプトをディスクに保存し、トランスクリプトファイル への書き込みが失敗しています。メッセージは原因を基になるエラーコードで示します。例えば、ディスクがいっぱいの場合：

Transcript writes are failing (disk full — ENOSPC) · recent messages may not be saved for resume

警告は、エラーに応じて異なるポイントで表示されます：

• 自動的にクリアされない条件での最初の失敗：ディスクがいっぱい、ディスククォータを超過、ファイルシステムが読み取り専用、パスがファイルシステムの長さ制限を超過、または macOS と Linux では権限エラー
• 少なくとも 1 分間にわたる繰り返しの失敗（Windows での権限エラーを含む、ウイルス対策スキャンが単一の書き込みに失敗してから再試行で成功する場合など）

v2.1.217 より前では、Claude Code は失敗した書き込みを警告なしにドロップし、後で --resume で最近のメッセージが見つからないことが最初の兆候でした。

対応方法：

• エラーコードが示す条件を修正します：ENOSPC の場合はディスク容量を解放、EDQUOT の場合はクォータを引き上げるかクリア、EACCES、EPERM、または EROFS の場合はトランスクリプト位置への書き込みアクセスを復元
• 警告は次の書き込み成功時に自動的にクリアされます。再起動は不要です
• 警告が表示されている間に送信されたメッセージは、後でセッションを再開するときに見つからない可能性があります

CLAUDE\_CODE\_SKIP\_PROMPT\_HISTORY が設定されているため、トランスクリプト保存がオフになっています

このセッションは CLAUDE_CODE_SKIP_PROMPT_HISTORY が設定された状態で開始されたため、Claude Code はこのセッションのトランスクリプトまたはプロンプト履歴を書き込みません：

Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set · --resume will not find this session; if unintended, unset it and restart

この変数は、一時的なスクリプト化されたセッションの意図的なオプトアウトですが、シェルプロファイル、ラッパースクリプト、またはそれをエクスポートした親プロセスを通じてセッションに到達することもあります。

対応方法：

• 変数を意図的に設定した場合、アクションは不要です。通知は、セッションが --resume、--continue、または上矢印履歴に表示されないことを確認します
• 設定していない場合は、claude を起動するシェルまたはスクリプトから変数を削除し、新しいセッションを開始します。現在のセッションからのメッセージは遡及的に保存されません。

CLAUDE\_CODE\_CHILD\_SESSION マーカーを継承しているため、トランスクリプト保存がオフになっています

Claude Code は、生成するサブプロセスで CLAUDE_CODE_CHILD_SESSION を設定し、それを継承するインタラクティブセッションをネストされたものとして扱います：Claude Code はそのトランスクリプトを保存しないため、Claude 自体が開始するセッションは --resume リストを埋めません。この通知は、現在のセッションがマーカーを継承したことを意味します：

Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker · restart with CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 to keep future transcripts

この通知は、別の Claude Code セッション内から claude を実行した場合に予想されます。マーカーが長寿命の仲介者（例えば、Claude Code セッションが元々開始したターミナル、screen セッション、またはランチャー）を通じてリークした場合、誤分類を示します。

tmux 内では、Claude Code は tmux サーバーのグローバル環境を通じて到達したマーカーを検出し、保存を続けるため、このケースではこの通知は表示されません。

対応方法：

• このセッションを別の Claude Code セッション内から意図的に開始した場合、アクションは不要です
• これがトップレベルセッションの場合、終了して CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 を設定して再起動します。保存は再起動から適用されるため、その前に送信されたメッセージは保存されません。
• 同じターミナルまたはランチャーからの将来の起動を修正するには、その環境から CLAUDE_CODE_CHILD_SESSION を削除します

設定警告

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

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

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

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

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

対応方法：

• フルスクリーンレンダリング に従ってください。どの通知が表示されるか、Claude Code が後続のセッションで何を行うか、およびフルスクリーンを再度試すか、クラシックレンダラーを保持する方法が説明されています。
• 終了したセッションが終了メッセージを出力した場合は、Claude Code が回復不可能なインターフェイスエラーの後に終了しました を参照して、その名前を確認してください。

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

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

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

Claude Code exited after an unrecoverable interface error (<error>). It happened while the fullscreen renderer was starting, so the next launch will use the classic renderer (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 forces that any time).

対応方法：

• Claude Code を再度起動してください。会話を再開するには、同じディレクトリで claude --resume を実行してください。
• メッセージがフルスクリーンレンダラーに言及している場合、フルスクリーンレンダリング は次の起動が何を行うかを説明しており、これはフルスクリーンをどのように有効にしたかによって異なり、フルスクリーンを再度試すか、クラシックレンダラーを保持する方法が説明されています。

v2.1.236 より前では、Claude Code はこの種のエラーの後、メッセージを出力せずに終了していました。

エージェント説明が 15.0k トークン制限を超えています

Claude Code はこの警告を stderr ではなく、会話ビューのスタートアップ通知として表示します。サブエージェント の組み合わせた説明（組み込みのものを除く）が、Claude Code が推定する 15,000 トークンを超えています。各エージェントはその名前とその description フロントマターをカウントします。Claude Code は合計が制限を超えているかどうかに関わらず、すべてのエージェントを読み込むため、警告は何が読み込まれるかを変更しません。

Agent descriptions are over the 15.0k-token limit (~16.2k tokens) · ask Claude to trim agent descriptions in .claude/agents/

対応方法：

• エージェントファイルの description フロントマターを短縮するか、Claude に短縮するよう依頼してください。
• 使用しなくなったエージェントファイルを削除してください。

ワークスペースが信頼されていません

Claude Code はプロジェクトの .claude/settings.json または .claude/settings.local.json で permissions.allow ルールまたは permissions.additionalDirectories エントリを見つけましたが、プロジェクト設定からの許可ルールはワークスペース信頼が必要 なため、それらを適用しませんでした。カウント、設定名、およびメッセージで名前が付けられたファイルは、設定によって異なります。deny および ask ルールは影響を受けません。

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

対応方法：

• ディレクトリで claude を実行し、信頼ダイアログを受け入れてください。プロジェクト許可ルールとワークスペース信頼 は、その受け入れがどのフォルダをカバーするかを説明しています。
• 非対話型モード で -p を使用する場合、ダイアログは表示されません。メッセージが出力する正確な projects キーを使用して、~/.claude.json の hasTrustDialogAccepted エントリを設定してください。
• メッセージが .claude/settings.local.json に名前を付けており、git リポジトリの外またはホームディレクトリで Claude Code を起動した場合は、v2.1.200 以降に更新してください。バージョン 2.1.196 から 2.1.199 は、これらのワークスペースでは独自の .claude/settings.local.json をリポジトリ提供として扱いました。v2.1.207 以降では、git リポジトリの外で信頼ダイアログを受け入れていない場合、更新だけでは不十分です。フォルダがリポジトリ内にないことを判断するには git を実行する必要があり、Claude Code はその確認を信頼ダイアログを受け入れた後にのみ実行するため、最初のステップを使用してください。ホームディレクトリおよび他の 設定ホーム は除外され、ダイアログを待ちません。プロジェクト許可ルールとワークスペース信頼 を参照してください。

作業ディレクトリはネットワークパスです

Claude Code はネットワークパスを作業ディレクトリとして追加しません。ネットワークパスを検索すると、それが名前を付けるホストに接続でき、Windows ではその接続がホストに認証情報を送信する可能性があるため、Claude Code はそのパスを検索せずに拒否します。このメッセージは、そのようなパスで /add-dir を実行するとき、またはスタートアップ時の警告として表示されます。スタートアップ時に表示される場合、Claude Code はそのディレクトリなしで起動します。

\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).

Claude Code がこの方法で拒否するパスには、以下が含まれます。

• \\server\share などの UNC 共有
• /net/<host> などのオートマウントパス（そのホストのオートマウント下のディレクトリから Claude Code を起動した場合を除く）
• シンボリックリンクまたはジャンクションを通じてネットワークロケーションに到達するローカルパス

マップされたドライブ文字と \\wsl$ パスはネットワークパスとしてカウントされません。

対応方法：

• Windows では、共有をドライブ文字にマップします。例えば net use Z: \\server\share を使用し、起動時に claude --add-dir Z:\ でドライブを渡してください。
• macOS または Linux では、共有をローカルパスにマウントし、代わりにそのパスを追加してください。
• パスが permissions.additionalDirectories にある場合は、それをリストする設定ファイルから削除してください。

v2.1.257 より前では、Claude Code は到達可能なネットワークパスを作業ディレクトリとして受け入れていました。

リモート管理設定の読み込みに失敗しました

セッションは サーバー管理設定 の対象ですが、Claude Code はそれらを取得できなかったため、対話型セッションでこの警告を表示します。括弧内の原因は、network error、request timed out、または authentication rejected (401) などの失敗した内容に名前を付け、行の残りはセッションが実行するポリシーを示します。

• 以前の成功した取得からキャッシュされた設定：Claude Code は 保留されている環境変数 を除いて、そのキャッシュされたポリシーでセッションを実行し、行は using cached policy と読みます。
• キャッシュなし：Claude Code はサーバー管理設定なしでセッションを実行し、行は no remote policy applied と読みます。

対応方法：

• メッセージが名前を付ける原因に対応してください。ネットワーク原因の場合は、このマシンが api.anthropic.com に到達できることを確認してください。認証原因の場合は、/status でサインインを確認してください。
• /status または claude doctor を実行して、完全な診断を取得してください。

v2.1.248 より前では、Claude Code は失敗した設定取得をデバッグログにのみ報告していました。

管理設定が承認されませんでした

組織の サーバー管理設定 には承認が必要な設定が含まれており、セキュリティ承認ダイアログ を拒否したため、Claude Code はそれらを適用せずに終了します。

Managed settings were not approved; exiting without applying them.

対応方法：

• Claude Code を再度起動し、ダイアログを承認して、組織の設定の下で続行してください。拒否されたダイアログは記憶されないため、次の起動時に再度表示されます。
• ダイアログがリストする設定について不確かな場合は、承認する前に組織の管理設定を保守している人に確認してください。

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

/mcp でサーバーの 再接続 を選択したか、無効なサーバーをそこで再度有効にしたところ、MCP サーバーを制限する 設定がそのサーバーをブロックしています。Claude Code はそれへの接続を拒否し、以下を表示します。

MCP server <name> is blocked by enterprise managed policy

これらの設定のいずれかがメッセージを生成できます。

• サーバーに一致する deniedMcpServers エントリ（~/.claude/settings.json またはプロジェクトの .claude/settings.json のものを含む）
• サーバーが一致しない allowedMcpServers リスト
• strictPluginOnlyCustomization と mcp ロック（~/.claude.json および .mcp.json で設定されたサーバーをブロック）
• disableClaudeAiConnectors（サーバーが claude.ai コネクタの場合）

対応方法：

• 独自のユーザーおよびプロジェクト設定ファイルでこれらの設定のいずれかを確認し、変更または削除してください。
• 独自の設定がブロックを説明しない場合は、管理者に、どの管理設定がサーバーをブロックするかを確認してください。

v2.1.257 より前では、/mcp での 再接続 と再度有効化は、セッション中のポリシー更新がブロックしたサーバーに接続できました。

管理設定ドキュメントを解析できませんでした

組織は 管理設定 をデプロイしており、デプロイされたドキュメントの 1 つが存在しますが、JSON オブジェクトとして解析できないため、Claude Code はポリシーを実行せずにスタートアップ時に終了コード 1 で終了します。行は失敗したソースをメッセージの前に名前を付けます。

/Library/Application Support/ClaudeCode/managed-settings.json: Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.

ソースは以下のいずれかです。

• managed-settings.json ファイルのパスまたは managed-settings.d 下のドロップインファイル
• macOS 管理設定プロファイル、ユーザーごとの管理設定 または デバイスレベルの管理設定
• Windows レジストリ値、Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings

Claude Code がドロップしたエントリを検索 は、各ソースを解析不可能にするものをリストしています。

Claude Code は、別の管理ソースが有効なポリシーを配信する場合でも、起動を拒否します。このエラーは対話型セッション、claude -p、Agent SDK セッション、バックグラウンドセッション、およびほとんどのサブコマンド（claude doctor を含む）で表示されます。拒否は意図的に閉じられます。Claude Code が解析できないドキュメント内の設定は強制できず、とにかく起動すると、組織の制御なしでセッションが実行されます。

解析可能なドキュメント内のスキーマ問題はこのエラーを生成しません。Claude Code がドロップしたエントリを検索 は、Claude Code が 1 つで何を行うかをカバーしています。

managed-settings.d/ ディレクトリが存在しますが、リストできない場合、Claude Code は Managed settings drop-in directory could not be read: の後に基になるエラーを報告します。Claude Code がドロップしたエントリを検索 は、読み取り失敗がスタートアップで終了する場合をカバーしています。

対応方法：

• マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の managed-settings.json は {} としてカウントされ、起動をブロックしません。
• そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。

headersHelper が実行されていません

Claude Code は MCP サーバーを静的 headers だけで接続し、サーバーの headersHelper をスキップしました。これは、ヘルパーがシェルコマンドであり、フォルダに保存された信頼がないためです。フォルダは、~/.claude.json でそのエントリを手動で設定するか、ホームディレクトリの外で、対話型セッションでそれを受け入れるときに、保存された信頼を取得します。headersHelper を実行する前にフォルダを信頼する を参照して、このチェックが適用されるサーバーを確認してください。

Claude Code は 非対話型モード でのみこの行を書き込み、サーバーごとに 1 回です。対話型セッションでは、同じ拒否をデバッグログに書き込みます。

MCP server 'internal-api': headersHelper not run — this workspace has no persisted trust; accept the trust dialog here once interactively, or set projects["/Users/you/project"].hasTrustDialogAccepted in /Users/you/.claude.json.

メッセージが出力する projects キーは、プロジェクト許可ルールとワークスペース信頼 が Claude Code がその信頼をキーにするフォルダです。親フォルダの信頼ダイアログを受け入れることはこのチェックを満たさず、-p または SDK セッションもそれを満たしません。

対応方法：

• メッセージが名前を付けるフォルダで claude を実行し、信頼ダイアログを受け入れ、その後、-p または SDK コマンドを再度実行してください。
• ~/.claude.json で hasTrustDialogAccepted エントリを自分で設定し、メッセージが出力する正確な projects キーを使用してください。
• ホームディレクトリでセッションを開始した場合は、信頼したプロジェクトディレクトリから作業してください。ホームディレクトリで信頼ダイアログを受け入れると、Claude Code はその信頼を現在のセッションのみ保持します。

不正な形式の Tool(content) ルール

権限ルール の 1 つが設定ファイルに Tool または Tool(content) の形状を持たない場合（例えば、テキストが閉じ括弧の後に続く、または括弧の 1 つが欠落している）。Claude Code はルールをスキップし、対話型セッションが開始されるときに無効な設定ダイアログにリストし、claude doctor 出力に表示します。

Invalid permission rule "Bash(ls) x" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal

対応方法：

• メッセージでリストされた設定ファイルで、ルールを閉じ括弧で終わるように書き直してください。例えば、Bash(ls) x の代わりに Bash(ls *) を使用してください。
• コンテンツ内の括弧はそのままにしてください。それらはリテラルなので、Edit(./Finance (2024)/**) などのルールはエスケープなしで有効です。

v2.1.260 より前では、Claude Code は一致しない括弧を持つルールを Mismatched parentheses として報告していました。

ファイル権限チェックと一致しません

Claude Code は、設定ファイル、管理設定、または --allowedTools、--disallowedTools、または --settings フラグ値で、Write、NotebookEdit、MultiEdit、または Glob 権限ルール を持つパスを見つけました。ファイル権限を Edit および Read ルールに対してのみチェックするため、他のファイルツールのいずれかに名前を付けるパスルールを参照することはありません。ルールを保持し、他に何も変更しません。警告はルール、括弧内のソース、および書き込む置換に名前を付けます。

Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).

対応方法：

• Write(path)、NotebookEdit(path)、および従来の MultiEdit(path) ルールを Edit(path) に置き換えてください。Edit ルールはすべてのファイル編集ツールをカバーしています。
• --allowedTools を除き、Claude Code は警告なしで Glob ルールを受け入れます。Glob(path) ルールを Read(path) に置き換えてください。
• 警告が括弧内に名前を付けるソースでルールを修正してください。設定ファイルパス、または --allowed-tools および --disallowed-tools フラグ自体。ディスク上に存在しない claude-settings-<hash>.json パスはインライン --settings 値を表します。そのフラグに渡す JSON を修正してください。
• Write または Glob などのベアツール名ルールはそのままにしてください。Claude Code は ツールレベル でそれらと一致し、それらについて警告しません。
• ソースが managed policy settings と読む場合は、警告を管理設定を保守している人に転送してください。自分でそれをクリアすることはできません。

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

コマンドの残りの部分の前にワイルドカードがあります

Claude Code は、* が後の単語の前に来る Bash 許可ルールを見つけました。その単語はどのコマンドであるかを決定します。例えば Bash(git * main) または Bash(git -C * status *)。これは 設定ファイル、管理設定、または --allowedTools または --settings フラグ値のいずれかにあります。* はテキストを一致させます。その位置に挿入されたオプションを含みます。Bash(git * main) は git -c core.fsmonitor=<script> diff main も承認します。ここで -c は git にコマンドが名前を付けるプログラムを実行させます。ワイルドカードパターン は一致ルールを示しています。

警告は、意図したより広いワイルドカードを持つルールを絞り込むことができるように存在します。Claude Code はルールを保持し、それがどのように一致するかについて何も変更しません。警告はルールとその括弧内のソースに名前を付けます。

Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).

対応方法：

• サブコマンドの前の * を意味する正確な値に置き換えてください。Bash(git * main) の代わりに Bash(git checkout main) を使用してください。
• すべての * をサブコマンドの後に移動してください。Bash(git -C * status *) の代わりに Bash(git status *) を使用してください。許可したいサブコマンドごとに 1 つのルールを書いてください。
• 警告が括弧内に名前を付けるソースでルールを修正してください。設定ファイルパス、または --allowed-tools フラグ自体。ディスク上に存在しない claude-settings-<hash>.json パスはインライン --settings 値を表します。そのフラグに渡す JSON を修正してください。
• ソースが managed policy settings と読む場合は、警告を管理設定を保守している人に転送してください。自分でそれをクリアすることはできません。

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

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

crossSessionInbound は accept、hold、refuse のいずれかである必要があります

設定ファイルは crossSessionInbound を Claude Code が認識しない値に設定します。例えば、タイプミスの "reject"。警告の 2 番目の文は、どのファイルが値を保持するかによって異なります。ユーザー、プロジェクト、ローカル、または --settings ファイルでは、以下のように読みます。

"crossSessionInbound" must be one of "accept", "hold", "refuse"; received "reject". This value was ignored; while it is present, cross-session messages are held for your approval instead of being delivered. Set it to one of the values above.

管理設定 では、Claude Code は認識されない値を refuse（最も制限的な値）として扱い、警告は、管理者がそれを修正するまで、クロスセッションメッセージが拒否されることを示しています。保留が他の設定ファイルの値とどのように組み合わされるかについては、crossSessionInbound を参照してください。

対応方法：

• キーを "accept"、"hold"、または "refuse" に設定するか、削除してください。
• 警告が管理設定に名前を付ける場合は、管理者に値を修正するよう依頼してください。

v2.1.248 より前では、Claude Code は認識されない値を警告なしで無視していました。

200K 制限は強制されていません

CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定しました。これは通常、自動コンパクション が 1M コンテキストモデルのセッションを 200K ウィンドウに保持しますが、コンパクションしきい値がこのセッションを 200K 以下で上限にしないため、会話はそれを超えて成長できます。

CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it. To enforce it, set CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 (or the autoCompactWindow setting).

Claude Code は、ネイティブ 1M ウィンドウを持つと認識するすべてのモデルに対して、および認識しないモデル ID に対して、それが想定するウィンドウでコンパクトするため、200K 制限を独自に強制します。警告は、他の設定がその強制を破る場合に表示されます。

• モデル ID は Claude Code が認識しないもの（LLM ゲートウェイ エイリアスなど）であり、CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 を設定したか、CLAUDE_CODE_MAX_CONTEXT_TOKENS で想定ウィンドウを 200K を超えて上げました。この場合、メッセージは or update to a Claude Code version that recognizes <model> も提供します。
• context-1m ベータは ANTHROPIC_BETAS または --betas フラグを通じてリクエストされ、そのベータを受け入れるモデルで API に 1M ウィンドウを要求し続けますが、何もセッションを 200K でコンパクトしません。

対応方法：

• CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 を設定するか、autoCompactWindow 設定を 200000 に設定して、自動コンパクションが 200K 境界でコンパクトするようにしてください。
• メッセージがこのバージョンが認識しないモデル ID に名前を付ける場合は、claude update を実行してください。ID を 1M コンテキストモデルとして認識するバージョンは、さらなる設定なしで制限を強制します。
• セッションがモデルの完全なウィンドウを代わりに使用したい場合は、CLAUDE_CODE_DISABLE_1M_CONTEXT を設定解除してください。警告は 200K 制限が強制されていないことのみを報告します。

バックグラウンドセッション または --output-format json または stream-json では、Claude Code は警告をデバッグログに stderr の代わりに書き込みます。

リクエストで認識されないモデル ID

Claude Code は、Claude Code バージョンが認識しないモデル ID のリクエストを送信し、そのモデル ID を認識するモデルにマップする modelOverrides エントリを見つけませんでした。Claude Code は依然としてそのように設定した ID でリクエストを送信し、終了またはモデルを切り替えません。

[claude-code:unrecognized_model] {"model":"my-proxy-model","query_source":"sdk"}

stderr を読み取るスクリプトまたはハーネスでは、[claude-code:unrecognized_model] プレフィックスと一致します。プレフィックスと 1 つのスペースの後、Claude Code は 1 行の JSON オブジェクトを書き込みます。Claude Code は後のバージョンでそれにフィールドを追加できるため、予期しないフィールドを無視してください。少なくともこれら 2 つを書き込みます。

• model：設定したモデル文字列
• query_source：モデルを使用したリクエストパス。Claude Code は -p 実行に対して sdk を報告し、サブエージェントに対して agent: で始まる値を報告します。

Claude Code は、実行方法に応じて、2 つの場所のいずれかに行を書き込みます。

• 非対話型モード で -p を使用する場合、Claude Code はすべての --output-format の下で stderr に書き込むため、行をフィルタリングせずに stdout を解析できます。
• 対話型セッションまたは バックグラウンドセッション では、Claude Code は代わりにデバッグログに書き込みます。--debug で ~/.claude/debug/<session-id>.txt でキャプチャしてください。

Claude Code は、プロセスごとにモデル文字列ごとに 1 回、行を書き込みます。サブエージェント または バックグラウンド機能 が使用するものなど、さらに認識されない ID ごとに別の行を書き込みます。

Claude Code は、Amazon Bedrock us.anthropic.claude-... ID、Google Cloud の Agent Platform ID（@ バージョンサフィックス付き）、Claude モデル ID を含む Microsoft Foundry デプロイメント名など、認識するモデルに解決するプロバイダー ID の行を書き込みません。Claude Code は、ARN 自体ではなく、Amazon Bedrock アプリケーション推論プロファイル ARN の背後にあるモデルをチェックします。解決できない ARN（タイプミスされたものなど）に対して行を書き込みません。

対応方法：

• ID を意図的に設定した場合（LLM ゲートウェイ エイリアスなど）、設定ファイル に modelOverrides エントリを追加し、ID をその値として使用してください。キーとして Anthropic モデル ID を使用し、opus などのファミリエイリアスは使用しないでください。例の行の my-proxy-model の場合、このエントリを追加してください。

  {
    "modelOverrides": {
      "claude-opus-4-6": "my-proxy-model"
    }
  }
  

  Claude Code は my-proxy-model を claude-opus-4-6 として扱い、行の書き込みを停止します。

• ID が Claude Code バージョンより新しいモデルに名前を付ける場合は、claude update を実行してください。

• ID がタイプミスの場合は、モデルを設定できる場所 または エイリアス変数 のいずれかで保持する場所で修正してください。query_source が agent: で始まる場合は、代わりに サブエージェントのモデル を設定する場所で修正してください。

v2.1.233 より前では、Claude Code は認識しないモデル ID のリクエストを送信したときに行を書き込みませんでした。

殺されたセッションによって残された古いサンドボックスマスクファイル

claude doctor はその診断でこの警告を出力し、/status は同じ行をリストします。これは、サンドボックス がファイルシステム分離をオンにして有効になっている Linux および WSL2 に表示されます。

サンドボックスコマンドが実行されている間、サンドボックスはまだ存在しないファイルへの書き込み拒否を保持し、そこに 0 バイトの読み取り専用プレースホルダーを作成し、その後削除します。SIGKILL によって殺されたセッションなど、そのクリーンアップが実行される前に、プレースホルダーが残ります。後のセッションは、起動するたびにそれらを読み取り専用で再度バインドするため、「はい、今後は尋ねない」を保存するなどの設定書き込みは、そこに座っているものが失敗します。

- Stale sandbox mask files left by a killed session: /home/you/project/.claude/settings.local.json
  Fix: Remove each with `rm <path>` while no other Claude Code session is running in that project — a 0-byte read-only file where a settings file belongs makes "Yes, and don't ask again" fail to save, and the sandbox binds it read-only again on every start

対応方法：

• そのプロジェクトで実行されている他の Claude Code セッションを終了し、rm で各リストされたファイルを削除してください。警告は最大 3 つのファイルに名前を付け、残りをカウントするため、削除されるまで claude doctor を再度実行してください。別のセッションのサンドボックスがまだ使用しているプレースホルダーは、そのセッションの書き込み保護の生きた部分です。
• 「はい、今後は尋ねない」で保存した権限の選択が固定されなかった場合は、プレースホルダーを削除した後、再度保存してください。

v2.1.257 より前では、claude doctor はこれらのファイルにフラグを立てませんでした。以前のバージョンは、セッションが殺されたときに同じプレースホルダーを残します。

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

Claude の回答がいつもより能力が低いように見えるが、エラーが表示されていない場合、原因は通常、モデル自体ではなく会話の状態です。Claude Code はモデルバージョンを静かに変更することはありません。3 つの特定のケースでフォールバックモデルに切り替わることができます。

• 設定された --fallback-model は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます
• Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します
• 自動モデルフォールバック は Fable 5.1、Fable 5、Opus 5 でセッションをフラグが付いたカテゴリのフォールバックモデルに移動し、そのカテゴリにフォールバックモデルがある場合、トランスクリプトに通知が表示されます

以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、/model の変更ではなく表示されます。モデル設定 は各フォールバックが適用される時期を説明しています。

まずこれらを確認してください。

• モデル選択: /model を実行して、期待するモデルにいることを確認します。以前の /model の選択または ANTHROPIC_MODEL 環境変数により、意図したより小さいモデルにいる可能性があります。
• 努力レベル: /effort を実行して現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げます。デフォルトはモデルによって異なるため、最大値以下であると仮定する前に確認してください。努力レベルを調整する でモデルごとのデフォルトと ultrathink ショートカットを参照してください。
• コンテキスト圧力: /context を実行してウィンドウがどの程度満杯かを確認します。容量に近い場合は、自然な区切り点で /compact を実行するか、/clear を実行して新しく開始します。コンテキストウィンドウを探索する で auto-compact が以前のターンにどのように影響するかを参照してください。
• 古い指示: 大きいまたは古い CLAUDE.md ファイルと MCP ツール定義はコンテキストを消費し、応答を操作できます。/doctor チェックアップは過度に大きいメモリファイルと未使用の拡張機能にフラグを付け、/context は MCP ツールトークン使用量を表示します。v2.1.205 より前では、/doctor は過度に大きいメモリファイルとサブエージェント定義にフラグを付けた診断画面を開きました。

応答がうまくいかない場合、通常は修正で返信するよりも巻き戻す方が効果的です。Esc を 2 回押すか /rewind を実行して悪いターンの前に戻り、より具体的なプロンプトで言い換えます。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定する可能性があります。チェックポイント を参照してください。

上記を確認した後も品質がまだおかしいように見える場合は、/feedback を実行して、期待したものと得たものを説明してください。この方法で送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で /feedback が利用できない場合は、エラーを報告する を参照してください。

Claude が疑わしいプロンプトインジェクションについて警告する場合、または疑わしいインジェクションのためにリクエストを拒否する場合、警告が名前を付けるテキストがファイルまたは Web コンテンツではなく Claude Code が会話に自動的に追加するコンテキストである場合は、claude update を実行して再試行してください。更新後に警告が繰り返される場合は、フラグが付いたコンテンツをプロンプトに貼り付け直すのではなく、報告してください。v2.1.201 より前では、Sonnet 5 は同じ方法でいくつかのリクエストを拒否しました。

エラーを報告する

このページで扱っていないコンポーネントからのエラーについては、関連するガイドを参照してください。

• MCP サーバーが接続または認証に失敗した場合：MCP
• Hook スクリプトが失敗したか、ツールをブロックした場合：Debug hooks
• インストール中に権限が拒否されたか、ファイルシステムエラーが発生した場合：Troubleshoot installation and login

ここにエラーが記載されていない場合、または提案された修正が役に立たない場合：

• Claude Code 内で /feedback を実行して、トランスクリプトと説明を Anthropic に送信します。このコマンドは、事前入力された GitHub issue を開くオプションも提供します。Anthropic への送信には認証が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、その他のサードパーティプロバイダー、または Anthropic 認証情報が設定されていない場合、/feedback は代わりに Anthropic アカウント担当者に送信できるローカルアーカイブを保存します。
• シェルから claude doctor を実行して、インストールの読み取り専用診断を実行するか、Claude Code 内で /doctor チェックアップを実行してセットアップの問題を検出して修正します。
• status.claude.com でアクティブなインシデントを確認します。
• GitHub の既存の issue を検索します。