メインコンテンツへスキップ
このページでは、Claude Code が表示するランタイムエラーと各エラーからの復旧方法、および応答がエラーなしで問題があるように見える場合に確認すべき内容を一覧表示しています。セットアップ中の command not found や TLS エラーなどのインストールエラーについては、インストールとログインのトラブルシューティングを参照してください。 ラッパーと IDE エラーは Claude Code 自体ではなく起動元のプログラムが出力するものですが、これを除き、これらのエラーと復旧コマンドは CLI、Desktop アプリ、およびクラウドセッション全体に適用されます。これら 3 つはすべて同じ Claude Code CLI をラップしているためです。その他のサーフェス固有の問題については、そのサーフェスのページのトラブルシューティングセクションを参照してください。
Claude Code は Claude API を呼び出してモデルレスポンスを取得するため、ほとんどのランタイムエラーは基盤となる API エラーコードにマップされます。このページでは、Claude Code 内での各エラーの意味と復旧方法について説明しています。生の HTTP ステータスコード定義については、Claude Platform エラーリファレンスを参照してください。

エラーを探す

表示されたメッセージに対応するセクションを以下から見つけてください。

自動再試行

Claude Code は、一時的な障害に対して指数バックオフを使用して最大 10 回まで再試行してから、エラーを表示します。Claude の応答の途中で発生した障害については、常に再試行するとは限りません。このページに記載されているエラーのいずれかが表示された時点で、Claude Code はその障害に該当する再試行をすでに行っています。 Claude Code は次の障害を再試行します。
  • Claude の応答がまったくストリーミングされていない段階で発生したサーバーエラー、過負荷レスポンス、リクエストタイムアウト。
  • Claude が思考を終えた後、テキストやツール呼び出しを開始する前に発生したサーバーエラーまたは過負荷レスポンス。その時点でのサーバーエラーについて、Claude Code は最大 2 回まで再試行します。v2.1.284 より前は、Claude Code はその時点でエラーとともにターンを終了していました。
  • 切断された接続。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 は停止した接続を中断し、最大 1 回だけリクエストを再度ストリーミングします。Claude が思考を終えた後、テキストやツール呼び出しの前に応答が 2 回目に停止した場合、Claude Code は The response stalled before a response was produced でターンを終了します。
  • ファーストバイトの期限が適用される接続で、API がレスポンスヘッダーを返さないストリーミングリクエスト。Claude Code は期限の時点でリクエストを中断し、再試行回数の範囲内で再送信します。再送信でも期限に達した場合は、No response from API でターンを終了します。CLAUDE_CODE_RETRY_WATCHDOG を設定している場合、Claude Code は代わりに再試行回数の範囲内で再送信を続けます。
  • Claude が思考を終えるか、テキストやツール呼び出しを開始する前に、API の出力コンテンツフィルターによって停止されたストリーミングレスポンス。Claude Code は再試行回数の範囲内でリクエストを 1 回再送信し、フィルターが 2 回目の応答も停止した場合は Output blocked by content filtering policy を表示します。
  • 一時的な 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 がツールを呼び出していることを示しているにもかかわらず、ツール呼び出しを含まない応答。Claude Code は Claude にツール呼び出しを求めることで、最大 2 回まで再試行します。両方の再試行が同じように失敗した場合、The model's tool call could not be parsed (retry also failed). と表示され、ターンが終了します。もう一度試すには、別のメッセージを送信してください。v2.1.307 より前は、Claude Code はターンを終了する前に 1 回だけ再試行していました。
  • 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 ゲートウェイ経由で返された 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 を検査するプロキシ、NODE_EXTRA_CA_CERTS バンドルの欠落、期限切れの証明書などによる TLS 証明書の検証失敗。Claude Code は最初の試行でエラーを報告するため、すぐに証明書の設定を修正できます。SSL certificate errors を参照してください。ハンドシェイクのタイムアウトなど、一時的な TLS の状態については引き続き再試行します。v2.1.199 より前は、Claude Code は証明書の失敗について、再試行回数をすべて使い切るまで再試行してからエラーを表示していました。
  • Claude がテキストのブロックまたはツール呼び出しを完了した後、または思考を終えた後にそれらを開始した後、応答を終える前に発生したサーバーエラー、切断された接続、または停止したストリーム。同じツール呼び出しが 2 回実行される可能性があるため、Claude Code はリクエストを再実行しません。Claude が完了した内容を保持し、Claude が完了したツール呼び出しを実行して、その結果からターンを継続します。対話型セッションおよび非対話型セッションで表示される内容については、The response above may be incomplete を参照してください。v2.1.199 より前は、ストリームの途中でサーバーエラーが発生すると、Claude Code は部分的な出力を破棄し、ターン全体をエラーとして報告していました。
  • Claude が応答を終えた後に発生した障害。再試行する必要があるものはないため、Claude Code は完全な応答を保持し、ターンを通常どおり終了します。
  • 予期しない content-type を持つ Amazon Bedrock のストリーミングレスポンス。レスポンスを書き換えているゲートウェイやプロキシは、再試行も同じように書き換えるためです。Claude Code v2.1.208 以降が必要です。
  • 失敗したストリーミングリクエストの非ストリーミング再試行で、成功ステータスが返されたものの本文に Claude API メッセージが含まれていないもの。Claude Code はそのエラーでターンを終了します。
  • 組織のポリシーチェックによって拒否されたリクエスト。これは拒否メッセージを含む API Error: の行として表示されます。組織の管理者は Claude Enterprise の機能である Inference hooks を使用してこのチェックを設定しており、メッセージの末尾には管理者が設定した指示が表示されるか、デフォルトでは管理者に連絡するよう案内が表示されます。拒否はモデルではなくリクエストの内容に関するものであるため、Claude Code は拒否されたリクエストを同じモデルにもフォールバックモデルにも再送信しません。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、その他の構成ではメッセージに示されたプロバイダーまたはゲートウェイのホストです。

Waiting for API response

Waiting for API response · will retry in … · check your network バナーは、Claude Code があるリクエストについて、データを受信しないまま少なくとも 20 秒間待機したことを意味します。リクエストはまだ失敗していません。カウントダウンは、Claude Code が停止した接続を中断する時点までのものです。中断が発生した場合の動作は次のとおりです。
  • Claude がテキストのブロックまたはツール呼び出しを完了する前、または思考を終えた後にそれらを開始する前の場合、Claude Code はリクエストを再試行するか、エラーでターンを終了します。どの停止を何回再試行するかについては、自動再試行を参照してください。
  • Claude がテキストのブロックまたはツール呼び出しを完了した後、または思考を終えた後にそれらを開始した後で、Claude が応答を終える前の場合、Claude Code は Claude が完了した内容を保持し、Claude が完了したツール呼び出しからターンを継続して、The response above may be incomplete を表示します。非対話型セッション、およびすべてのセッションにおけるサブエージェントの応答では、Claude Code は最初に Claude に応答を続けるよう促す場合があります。それがいつ行われるか、またその場合でも通知が表示されるのはいつかについては、そのエントリを参照してください。
  • Claude が応答を終えた後の場合、Claude Code はターンを通常どおり終了します。
このバナーは、データの受信が再開されるか再試行が成功すると自動的に消えます。すべての試行でバナーが再表示される場合は、ネットワークの問題として扱ってください。ゲートウェイ経由で接続している場合は、ゲートウェイ経由で待機中のバナーが表示されたり消えたりするを参照してください。v2.1.185 より前は、バナーは 10 秒後に異なる文言で表示されていました。

ゲートウェイ経由で待機中のバナーが表示されたり消えたりする

Claude が思考している間に Waiting for API response バナーが表示されたり消えたりし、ゲートウェイ経由で接続している場合は、Claude Code を更新して v2.1.309 以降にしてください。次の接続では、データのない状態が 45 秒続いた後にバナーが表示されます。 v2.1.309 より前は、これらの接続ではバナーは 20 秒後に表示されていました。

再試行の動作を調整する

次の環境変数を使用して、再試行の動作を調整できます。

非ストリーミングの試行が待機する時間

非ストリーミングの試行は、リクエストタイムアウトと本文のアイドルタイムアウトのうち、早く到達した方の時点で終了します。
  • リクエストタイムアウト: 正の値を設定している場合は API_TIMEOUT_MS、それ以外の場合はローカルセッションでは 300 秒です。
  • 本文のアイドルタイムアウト: レスポンスがないまま 5~6 分が経過した時点です。これが動作する環境で、かつオフにしていない場合に適用され、API_TIMEOUT_MS をどれだけ大きく設定していても変わりません。

サーバーエラー

これらのエラーのほとんどは推論プロバイダーから発生します。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 レスポンスを示しています。
末尾の文は、サービスの健全性を確認する場所を示し、プロバイダーによって異なります。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry の設定は、そのプロバイダーのサービスステータスを示します。カスタム ANTHROPIC_BASE_URL はゲートウェイホストを示します。 API 自体から返される 5xx は、API 内部の予期しない障害を示しています。これはプロンプト、設定、またはアカウントが原因ではありません。 プロキシ、ロードバランサー、またはゲートウェイが HTML エラーページで応答する場合、メッセージはステータスコードとページのタイトル(API Error: 502 Bad Gateway など)を表示します。タイトルのないページの場合、メッセージはステータスコードとその標準名を代わりに表示します。v2.1.281 より前では、ページにタイトルがある場合はステータスコードが削除され、タイトルがない場合はページの生のマークアップが出力されていました。 対応方法:
  • status.claude.com またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください
  • 1 分待ってから、メッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は、全体を貼り付ける代わりに try again と入力できます。
  • ANTHROPIC_BASE_URL が LLM ゲートウェイ を指しており、すべてのリクエストがこの形で失敗する場合は、ゲートウェイとそのアップストリームが ツール検索 のフィールドを受け付けることを確認してください。デフォルトでは、Claude Code は defer_loading ツールフィールドと tool_reference ブロックを、それらを有効にする anthropic-beta ヘッダーとともに送信します。v2.1.304 より前では、ENABLE_TOOL_SEARCH でオンにしない限り、ゲートウェイの背後ではツール検索はオフになっていました。
  • エラーが投稿されたインシデントなしで続く場合は、/feedback を実行して、Anthropic がリクエストの詳細で調査できるようにしてください。環境で /feedback が利用できない場合は、Report an error を参照してください。

API Error: Repeated 529 Overloaded errors

API は全ユーザー間で一時的に容量に達しています。Claude Code はこのメッセージを表示する前に既に数回再試行しています。
末尾の文は、上記の 500 エラーと同じ方法でプロバイダーによって異なります。 529 は使用制限ではなく、クォータにもカウントされません。 対応方法:
  • status.claude.com またはメッセージに示されているプロバイダーのステータスページで、容量に関する通知を確認してください
  • 数分後に再度試してください
  • /model を実行して別のモデルに切り替えて、作業を続けてください。容量はモデルごとに追跡されるためです。Claude Code は、1 つのモデルが特に高い負荷を受けている場合、これを行うよう促します。例えば Opus is experiencing high load, please use /model to switch to Sonnet のようなメッセージが表示されます。Fable モデルでは、メッセージは Fable を示します。 Claude Desktop アプリが実行するセッション(Code タブや Cowork など)では、メッセージは Opus is experiencing high load. Switch to Sonnet. と読まれ、アプリのモデルピッカーでモデルを切り替えます。

Request timed out

API は接続期限前に応答しませんでした。
デフォルトのリクエストタイムアウトは 10 分です。API_TIMEOUT_MS を 0 に設定すると、このリクエストタイムアウトはオフになります。最初のバイトの期限 とボディのアイドルタイムアウトは 0 を設定してもオフにならないため、ストリーミングリクエストは引き続き 接続に適用されるいずれかの制限 の下で実行されます。非ストリーミングの試行は、ローカルセッションでは 300 秒の制限を維持し、引き続きこのメッセージで終了する可能性があります。 対応方法:
  • すべてのリクエストがこのメッセージで失敗し、API_TIMEOUT_MS を 0 に設定している場合は、claude --version を確認してください。v2.1.305 より前のバージョンでは、Claude Code を更新するか、正の値を設定してください。
  • リクエストを再試行してください
  • 遅いネットワークまたはプロキシが原因の場合は、Automatic retries で説明されているように API_TIMEOUT_MS を上げてください
  • タイムアウトが頻繁で、ネットワークが正常な場合は、以下の Network and connection errors を参照してください

No response from API

Claude Code はストリーミングリクエストを送信しましたが、API は最初のバイトの期限内に応答ヘッダーを返しませんでした。Claude Code はこのようなリクエストを、完全な API_TIMEOUT_MS リクエストタイムアウトを待つ代わりに中止し、retry budget が許可する場合は再度送信します。再試行でも期限が過ぎた場合、ターンはこのメッセージで終了し、各試行が待機した時間を示します。 CLAUDE_CODE_RETRY_WATCHDOG を設定すると、Claude Code はターンを終了する代わりに、Tune retry behavior で説明されているバジェットの下で再試行を続けます。
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 つの期間を示します。 Amazon Bedrock を除き、API_TIMEOUT_MS を 0 に設定した場合、再試行は 10 分に 32KB ごとに 1 秒を加えた時間、または最初の試行の待機のほうが長い場合はその時間だけ待機します。
どちらの待機も、正の API_TIMEOUT_MS より 1 秒少ない値を超えず、11 秒未満の正の API_TIMEOUT_MS は期限をオフにします。バイトレベルのウォッチドッグは応答ヘッダーが到着した後にのみ開始されるため、その後バイト送信を停止するレスポンスは、この期限ではなく stalled-stream rules に従います。 Claude apps gateway セッションでは、この期限は CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS を 1 以上に設定して オンにした 場合にのみ適用されます。 対応方法:
  • メッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は、全体を貼り付ける代わりに try again と入力できます。
  • 繰り返される場合は、ネットワークまたはプロキシの問題 として扱ってください。
  • ネットワーク上のプロキシまたはゲートウェイが応答を生成完了まで保持する場合は、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 より前では、再試行は最初の試行と同じ期限を待機し、メッセージは期間を示していませんでした。v2.1.307 より前では、Claude Code は Claude apps gateway セッションで CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS を無視していました。

The response above may be incomplete

ストリーミングリクエストがレスポンスの進行中に失敗しました。Claude がテキストのブロックまたはツール呼び出しを完了した後、または思考を終了した後に 1 つを開始した後です。リクエストを再送信すると、同じツール呼び出しが 2 回実行される可能性があるため、Claude Code は Claude が完了した出力を保持し、ターンを破棄する代わりにこの通知を追加します。表示されるバリアントは原因を示します。
  • 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 は接続を破損として扱い、読み取りを停止します。
  • Part of the response never arrived: ストリームイベントが API と Claude Code の間でドロップされたため、後のイベントが到着しなかったコンテンツを参照していました。v2.1.281 より前では、このケースは API Error: Content block not found でターンを終了していました。
  • The response stream was malformed: 既に完了していたコンテンツブロックのイベントが到着しました。または、イベントが破損した状態で到着しました。破損したイベントとは、データが有効な JSON ではない、コンテンツが欠落している、またはコンテンツがイベントのタイプと一致しないイベントです。v2.1.284 より前では、Claude が思考、テキストのブロック、またはツール呼び出しを完了した後に無効な JSON を持つイベントが到着した場合、パーサーの生のエラー(API Error: JSON Parse error で始まるものなど)が代わりに表示されていました。
  • The response stopped arriving: 接続は開いたままでしたが、データの配信を停止したため、ストリーミングアイドルウォッチドッグがそれを中止しました。v2.1.222 より前では、Claude Code は 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 と読まれていました。 Claude がテキストまたはツール呼び出しを開始する前にドロップ、重複、または破損したストリームイベントが到着した場合、この通知は表示されません。
  • Claude が思考のみを完了していた場合、Claude Code はリクエストを再発行します。再発行されたストリームが同じ方法で破損する場合、ターンは Part of the response never arrived and no response was produced. Try again. または The response stream was malformed and no response was produced. Try again. で終了します。
  • 何も完了していない場合、Claude Code はストリーミングなしでリクエストを再送信します。CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK でそのフォールバックをオフにした場合、ターンはドロップされたイベントの場合は API Error: Content block not found で、または重複したイベントの場合は API Error: Content block already closed で終了します。破損したイベントでフォールバックがオフの場合、ターンは API Error: Stream event unreadable またはパーサーの生のエラーで終了します。
4 つのケースでは、Claude Code はこの通知をすぐに表示せずに障害を処理します。
  • レスポンスの前半で、Claude Code は障害を再試行するか、別のエラーでターンを終了します。Automatic retries を参照してください。
  • これらの障害の 1 つが Claude がレスポンスを完了した後に到着した場合、Claude Code は完全なレスポンスを保持し、この通知なしでターンを正常に終了します。v2.1.222 より前では、Claude Code はレスポンスが完了した後に接続が切断またはストールした場合、この通知を表示し、レスポンスが完全であったにもかかわらずターンをエラーとして報告していました。
  • 非対話セッション(-p 実行、Agent SDK 実行、または クラウドセッション など)では、途中で切れたレスポンスがメイン会話にあり、テキストを含むがツール呼び出しを含まない場合、continue を自分で送信する必要はありません。Claude Code は部分的な出力を保持し、Claude に停止した場所から続行するよう促します(最大 3 回連続)。この通知は、Claude Code がこれらの継続を使い果たした後にのみ、そのようなレスポンスに対して表示されます。v2.1.246 より前では、Claude Code は最初の途切れでこの通知とともに非対話ターンを終了していました。
  • サブエージェントでは(セッションが対話かどうかに関わらず)、途中で切れたレスポンスがテキストを含むがツール呼び出しを含まない場合、Claude Code はサブエージェントに続行するよう促します。通知は、これらの継続が使い果たされた後にのみ、サブエージェントの最後のメッセージになります。v2.1.257 より前では、サブエージェントは最初の途切れでこの通知を表示していました。
対応方法:
  • 対話セッションでは、画面に残っているレスポンスを読んでください。Claude Code はエラーの前に Claude が完了したすべてのブロックを保持しますが、ターンが終了するときに中断された最終ブロックを破棄するため、最終文またはツール呼び出しが欠落している可能性があります。continue で返信して、Claude が最後に完了したブロックから再開するようにしてください。
  • 非対話モード(-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 モード がアクションを分類するために使用するモデルが決定を生成できなかったため、auto モードはアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した方法によって異なります。 分類器モデルが利用できない場合:
対話セッションでは、このメッセージの代わりに、ツール呼び出しの下に薄く表示される Not run · auto mode's check had no usable answer 行が現れます。この行は、サーバーが判定を返さなかったことを示すメッセージや、リモートセッション以外では Auto mode could not evaluate で始まるメッセージの代わりに表示されることもあります。Ctrl+O を押すと、トランスクリプトビューアー でそのメッセージを読むことができます。v2.1.296 より前では、メッセージは赤いエラーとして表示されていました。 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 モードの利用資格 とは無関係です。設定を変更する必要はありません
  • 再試行が失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください
  • Amazon Bedrock では、メッセージがすべての再試行で返される場合は、アカウントがそれが示すモデルを呼び出せることを確認してください。標準の Amazon Bedrock モデルの場合、IAM policy がそれを呼び出すことを許可していることを確認してください。Mantle モデル ID の場合は、AWS アカウントチームに連絡してください
  • メッセージがすべての再試行で返され、CLAUDE_CODE_AUTO_MODE_MODEL で設定したモデルを示している場合は、セッションが実行されている API またはクラウドプロバイダーがそのモデル ID を提供していることを確認してください。提供していない場合は、変数を提供されているモデル ID に設定するか、変数の設定を解除して デフォルトの分類器モデル を使用してください。
OAuth トークンの有効期限が切れたか、別のセッションによってローテーションされたために分類器リクエストが失敗した場合、Claude Code はトークンをリフレッシュし、リクエストを 1 回再試行するため、日常的なトークンの有効期限切れはこのメッセージとして表示されません。v2.1.216 より前では、有効期限が切れたまたはローテーションされたトークンによってすべての分類器リクエストが失敗し、トークンがリフレッシュされるまで auto モードはこのメッセージで確認対象のすべてのアクションを拒否していました。 分類器が解析不可能なレスポンスを返した場合:
対応方法:
  • アクションを再試行してください。これは通常、次の試行で成功します
  • claude --debug を実行し、アクションを繰り返して、デバッグログで詳細を確認してください
別の API セーフティチェックが、以前の会話コンテンツのために分類器リクエストをブロックした場合:
Claude Code はアクションを拒否しますが、Claude にこれはアクションが安全でないという判断ではなく、再試行するのではなく他のタスクを続行するよう伝えます。これらの拒否は auto モードの一時停止しきい値 にカウントされません。非対話 -p 実行では、Claude Code は実行を停止しません。Claude が受け取るものは、アクションを要求した場所によって異なります。
  • --input-format stream-json なしの -p 実行における バックグラウンドサブエージェント に対しては、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 モードが分類器に会話を送信したときに API のセーフティフィルターをトリガーしました
  • 再試行は役に立ちません。同じ会話コンテンツがフィルターを再度トリガーします
  • 対話セッションでは、別の 権限モード に切り替えて、プロンプトが表示されたときにアクションを承認できるようにしてください
  • トリガーするコンテンツなしで新しい会話を開始してください
会話が Claude Code の分類器リクエストには長すぎ、Claude Code が 自動で圧縮 できない場合:
アクションに何が起こるかは、Claude がそれを要求した場所によって異なります。
  • 対話セッションでは、auto モードはそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます
  • --input-format stream-json なしの 非対話 -p 実行における バックグラウンドサブエージェント に対しては、Claude Code は Agent aborted: auto mode classifier transcript exceeded context window in headless mode を含むエラー結果を返し、実行は続行されます
  • --permission-prompt-tool なしの -p 実行の他の場所では、フォールバックするプロンプトがないため、アクションは実行されず、実行は続行されます
対応方法:
  • 対話セッションでは、表示されるプロンプトでアクションを承認または拒否してください
  • 対話セッションでは、/compact を実行して会話サイズを削減し、後続のアクションが分類器ウィンドウ内に再び収まるようにしてください

The server returned no safety verdict

サーバー側の分類器レビュー では、auto モードはサーバーがアクションに対して判定を返さないときにそのアクションを拒否します。拒否は、Claude Code が判定できる場合、括弧内にカテゴリ((timed out) など)を示します。
メッセージの残りの部分は、1 回の再試行が役に立つかどうかを Claude に伝えます。これらの拒否の一部では、Claude の次の試行がすぐに続かないように、Claude Code は事前に待機します。対話セッションでの待機中、スピナーは Auto mode check unavailable とカウントダウンを表示し、Esc を押すとターンが中断されます。 10 回連続で判定のないレスポンスが続くと、auto モードはターンを停止します。
フックまたは mod による変更に起因する拒否 を含め、一部の拒否はこの 10 回にカウントされません。 停止メッセージは、セッションの種類ごとに異なる場所に表示されます。
  • 対話セッションでは、メッセージはトランスクリプトに警告として表示され、ターンが終了します
  • 非対話 -p 実行では、実行が終了し、実行エラーを報告します。デフォルトのテキスト出力では、メッセージは stderr に出力されます。
  • サブエージェント が制限に達した場合、サブエージェントは完了する前に停止し、Claude は auto モードがそれを停止したことを示すメモ付きで、それまでに生成されたものを受け取ります
対応方法:
  • 対話セッションでは、Ctrl+O を押して トランスクリプトビューアー で拒否のテキストを読んでください。
  • 拒否が (the conversation is too long for the check) を示している場合は、Claude Code のプロンプトで /compact を実行して会話を短くしてください。会話が短くなるまでは、別のメッセージを送信しても同じ拒否になります。自動圧縮 をオフにしている場合は、次回 Claude Code が自動で圧縮するように再度オンにしてください。
  • 別のメッセージを送信して、Claude が再度試行するようにしてください。レスポンスのカウントはリセットされます。
  • 停止が繰り返され、リクエストが LLM ゲートウェイまたはプロキシ を経由する場合は、それがストリーミングレスポンスを途中で切り詰めたり書き換えたりしていないかを確認してください。サーバー側の分類器レビュー にはどのゲートウェイの動作が拒否を引き起こすかが記載され、ゲートウェイ互換性ガイド には変更せずにそのまま渡すべきものが記載されています。
  • Claude Code を開始する前に CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定して、代わりに Claude Code 独自の分類器リクエストを使用してください。v2.1.281 より前では、Claude Code は Anthropic API への直接接続でこの変数を読み取りませんでした。
  • 代わりにアクションを自分で承認するには、auto モードから切り替えてください
v2.1.280 より前では、Claude Code は判定のないレスポンスからの各アクションを直ちに拒否し、ターンを停止することはありませんでした。 v2.1.302 より前では、Anthropic API への直接接続において、Claude Code はサーバーのチェックには長くなりすぎた会話を圧縮しませんでした。

a hook changed this call's input after auto mode reviewed it

この拒否は、サーバーがレビューした後にフックまたは mod が 呼び出しの入力を変更した ため、実際に実行される内容がレビューの対象外になっていることを意味します。アクションが安全でないという判断ではありません。 同じ Claude の応答内の後続の呼び出しも、次の理由で拒否されることがあります。
その後 Claude は、拒否された各呼び出しを再度発行して、サーバーにレビューさせることができます。権限プロンプトが開いた場合は、それに応答してください。Claude が応答の中で auto モードが呼び出しをチェックできなかったと述べない限り、他に何もする必要はありません。そう述べた場合は、変更を止めるか呼び出しを自分で承認してから、Claude にその呼び出しを再試行するよう依頼してください。
  • 変更を止める: その呼び出し、または同じ Claude の応答内のそれより前の呼び出しを変更した フック または mod をオフにするか、管理者にオフにするよう依頼してください。フックを探すには、Claude Code のプロンプトで /hooks を実行します。ターミナルセッションでは、/plugin を実行してアクティブな mod を確認できます。
  • 呼び出しを自分で承認する: Manual モードに切り替えてください

Was not reviewed and did not run

was not reviewed and did not run 拒否は、会話が長すぎて auto モード の分類器がアクションをチェックできず、アクションが実行されなかったことを意味します。Claude Code は次のメッセージを Claude に返します。
コンテキスト圧縮が失敗した場合、分類器がチェックできない以降のアクションには、次の 2 つの別のメッセージのいずれかが表示されます。 対応方法:
  • メッセージが予告している圧縮が成功した場合は、何もする必要はありません。
  • これら 2 つのメッセージのいずれかが表示された場合は、Claude Code のプロンプトで /compact を実行して、自分で会話を短くしてください。自動圧縮 をオフにしている場合は、次回 Claude Code が自動で圧縮するように再度オンにしてください。

Agent terminated early due to an API error

サブエージェント の API リクエストが回復不能な形で失敗しました。例えば、使用制限に達したか、サーバーエラーの再試行を使い果たしたため、サブエージェントはタスクを完了する前に停止しました。このメッセージには Claude Code v2.1.199 以降が必要です。それ以前は、API エラーテキストはサブエージェントの結果であるかのように Claude に返されていました。
対応方法:
  • コロンの後のエラー詳細を、このページの該当するセクション(Usage limits や Server errors など)と照合し、そのセクションの手順に従ってください
  • 根本のエラーが解消されたら、Claude にタスクを再試行するか、サブエージェントを再開する よう依頼してください
レート制限、オーバーロード、またはサーバーエラーが、既にテキスト出力を生成したフォアグラウンドサブエージェントを中断した場合、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

サブスクリプションプランには、ローリング方式の使用量枠が含まれています。これを使い切ると、次のいずれかのメッセージが表示されます。
Claude Code は、メッセージに表示されたリセット時刻まで以降のリクエストをブロックします。セッション制限と週間制限はすべてのモデルで共有されるため、モデルを切り替えてもアクセスは回復しません。Opus 制限と Sonnet 制限はそれぞれそのモデルファミリーへのリクエストにのみ適用されるため、/model でファミリー外のモデルに切り替えれば作業を続けられます。 claude.ai サブスクリプションでサインインしたインタラクティブセッションでは、Claude Code が開いているセッション内で待機し、リセット直後に中断されたタスクを続行することもできます。表示される内容、待機の開始方法やキャンセル方法、自動続行をオフにする方法については、使用制限のリセットを待つを参照してください。v2.1.234 より前の Claude Code では、この待機機能は提供されていませんでした。 使用量はセッション枠と週間枠の両方に同時に計上されます。大規模なワークフローのファンアウトなど、短時間に集中した大量の処理によって、セッションのウィンドウがリセットされる前に週間枠を使い切ってしまうことがあります。 対処方法:
  • エラーに表示されたリセット時刻まで待ちます
  • デスクトップアプリの Code タブでは、セッション制限のカードに Auto-continue when limits reset チェックボックスが表示されます。週間制限のカードには表示されません。チェックを入れると、デスクトップアプリはリセット後に中断されたターンを再試行し、カードに再試行時刻を表示します。デスクトップのチェックボックスと、CLI の /config にある Continue automatically at usage limit 設定は別々のものなので、それぞれ個別にオフにしてください。
  • Opus 制限または Sonnet 制限の場合は、/model を実行してそのファミリー外のモデルに切り替えれば作業を続けられます。モデルごとに独自のプロンプトキャッシュがあるため、次のリクエストではキャッシュヒットなしで会話全体が再度読み込まれます。モデルの切り替えを参照してください
  • /usage を実行して、プランの制限とリセット時刻を確認します
  • /usage-credits を実行すると、Pro、Max、Ultra では追加の使用量を購入でき、Team と Enterprise では管理者に追加の使用量を要求できます。課金方法については有料プランの使用クレジットを参照してください。
  • 基本の制限を引き上げるためにプランをアップグレードするには、claude.com/pricing を参照してください
ウィンドウを使い切る前に、Claude Code は You've used 85% of your session limit · resets 3:45pm のようなメッセージで、大部分を使用したことを警告する場合があります。残りの使用量枠を確認するには、カスタムステータスラインに rate_limits フィールドを追加するか、デスクトップアプリで使用量リングをクリックします。

Usage credits required for 1M context

選択したモデルが 100 万トークンの拡張コンテキストウィンドウを使用しており、ご利用のプランでは使用クレジットを通じてのみこれが利用可能です。
Claude デスクトップアプリが実行するセッションでは、ヒントにコマンド名は含まれません。claude.ai の使用量設定ページを案内するか、Team および Enterprise プランでは claude.ai/admin-settings/usage で使用クレジットをオンにするか管理者に依頼するよう案内します。 これはクォータの枯渇ではなく、利用資格のチェックです。セッション枠と週間枠に残りがある場合でも発生します。どのプランで 100 万コンテキストが直接含まれ、どのプランで使用クレジットが必要かについては、拡張コンテキストを参照してください。 コンテキストが 20 万トークンを超えたために会話の途中でこのエラーが表示された場合、Claude Code は会話を自動的にコンパクト化して標準のコンテキスト制限内に戻し、その後もセッションをその制限内に保つため、対処は不要です。v2.1.172 より前のバージョンでは、/compact を含む以降のすべてのリクエストでこのエラーが繰り返し発生していました。それらのバージョンで復旧するには /clear を実行してください。以下の手順は、明示的に [1m] モデルを選択した場合に適用されます。 対処方法:
  • /model を実行し、[1m] サフィックスのないバリアントを選択して標準のコンテキストウィンドウに戻します
  • メッセージに /usage-credits が示されている場合は、それを実行して、Pro、Max、Ultra では 100 万バリアントの従量課金をオンにし、Team と Enterprise では管理者に使用クレジットを要求します。使用クレジットがオンになったら、メッセージの指示に従って Claude Code を再起動するか、新しいセッションを開始します。それまでは、セッションは標準のコンテキスト制限のままです。
  • /model の後もエラーが続く場合は、100 万モデルの ID が別の場所で設定されている可能性があります。優先順位順に確認すべき設定場所については、モデルの設定を参照してください。
  • モデルピッカーから 100 万バリアントを完全に削除するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定します
v2.1.268 より前では、メッセージの末尾は run /usage-credits to turn them on, or /model to switch to standard context で、再起動については触れていませんでした。

The prompt to confirm went unanswered

Fable の使用クレジット同意プロンプトが誰にも応答されないまま閉じられると、Claude Code は次のいずれかのメッセージでターンを終了します。
メッセージにはセッションの Fable モデル名が含まれるため、Fable 5.2 では continuing on Fable 5.2 および Fable 5.2 now uses usage credits と表示されます。Remote Control が接続されている場合、各メッセージの末尾は代わりに Claude stopped here · send a message to be asked again, or switch models になることがあります。v2.1.257 より前では、最初のメッセージは Fable 5 limit reached で始まっていました。 これは、Remote Control セッション、バックグラウンドセッション、エージェントチームのチームメイトセッション、および別のアプリケーションが Agent SDK を通じてホストするセッションで発生します。Claude Code がプロンプトを閉じるタイミングについては、Fable と使用クレジットを参照してください。 対処方法:
  • セッションが実行されている場所(ターミナル、またはセッションをホストしているアプリケーション)で別のプロンプトを送信し、同意プロンプトが再表示されたら応答します。バックグラウンドセッションの場合は、まずエージェントビューからアタッチします。メッセージに Claude stopped here と表示されている場合は、接続しているデバイスから返信して、そこで同意プロンプトに応答することもできます。
  • /model を実行して、使用クレジットが課金されないモデルに切り替えます
  • より長い時間を確保するには、dialogExpiry をより長い値または "never" に設定します
v2.1.236 より前では、このメッセージは表示されませんでした。Remote Control クライアントが接続されている間、Claude Code は応答を 60 秒間待機し、その後デフォルトのモデルでターンを続行していました。

Server is temporarily limiting requests

API が、プランのクォータとは無関係な短期間のスロットリングを適用しました。
Claude Code は、実際の制限のレスポンスに含まれる統合クォータヘッダーがないことによって、これをプランの制限と区別します。v2.1.199 以降では、認証方法にかかわらず、表示される前にバックオフ付きで自動的に再試行されます。それ以前のバージョンでは、claude.ai サブスクリプションでサインインしたセッションは最初の発生時にターンが失敗し、API キーおよび Enterprise のサインインのみが再試行していました。 対処方法:
  • 少し待ってから再試行します
  • 解消しない場合は status.claude.com を確認します

Request rejected (429)

API キー、Amazon Bedrock プロジェクト、または Google Cloud プロジェクトに設定されたレート制限に達しました。
末尾の文はサービスの稼働状況を確認する場所を示しており、プロバイダーによって異なります。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry の設定では、Anthropic のステータスページの代わりにそのプロバイダーのサービスステータスが示されます。カスタムの ANTHROPIC_BASE_URL の場合は、ゲートウェイのホストが示されます。 Claude Code と API の間にあるプロキシ、ロードバランサー、またはゲートウェイが独自の HTML の 429 ページで応答した場合、· の後のテキストは、そのページにタイトルがあればそのタイトル(Too Many Requests など)になります。v2.1.281 より前では、ページ全体のマークアップが · の後に出力されていました。 対処方法:
  • /status を実行し、有効な認証情報が想定どおりのものであることを確認します。環境内に不要な ANTHROPIC_API_KEY が残っていると、サブスクリプションではなく低いティアのキーを経由してリクエストが送信される場合があります。
  • プロバイダーのコンソールで有効な制限を確認し、必要に応じてより高いティアをリクエストします
  • Anthropic API キーの場合、ティアの仕組みとワークスペースごとの上限の設定方法については、レート制限のリファレンスを参照してください
  • 同時実行数を減らします。多数のサブエージェントを並列で実行するのを避けるか、大量のスクリプト実行では /model でより小さなモデルに切り替えます

You’ve hit your monthly spend limit

プランに含まれる使用量ではこのリクエストをカバーできず、本来その支払いに充てられる使用クレジットが支出上限に達しています。プランの使用量ウィンドウのいずれかを使い切った場合、または使用クレジットのみがそのリクエストの支払いに充てられる場合、プランではリクエストをカバーできません。その一例が、使用クレジットに課金されるモデルへのリクエストです。 · の前の語句は、組織の月間支出上限など、ブロックの原因となった上限を示し、その後のテキストはその上限を引き上げてもらう方法を示します。クラウドセッションまたは Remote Control 下では、そのテキストに URL は含まれず、自分自身の monthly spend limit に関するメッセージには引き上げ方法が記載されません。その他のセッションでは、次のような形式で表示されます。
team's shared budget は、ユーザーが所属するグループに管理者が割り当てた共有予算です。メッセージにはグループ名は示されません。channel's monthly spend limit は、セッションが実行されている 1 つの Slack チャンネルの予算であるため、組織にはそれ以外に予算が残っている場合があります。 使い切ったのがプランのウィンドウのいずれかである場合、メッセージにはそのウィンドウのリセット時刻も示されます(例: · your session limit resets 3:45pm)。その時刻になれば、誰かが上限を引き上げなくてもアクセスが回復します。使用量ベースの請求を利用している組織では、メッセージに spend limit の代わりに usage limit と表示されます(例: You've hit your individual usage limit)。 Claude apps ゲートウェイ経由で接続していて、小文字の spend limit reached が表示される場合、それはゲートウェイ運用者による上限です。Spend limit reached を参照してください。 対処方法:
  • Pro、Max、Ultra では、claude.ai の Settings > Usage で月間支出上限を引き上げるか、/usage-credits を実行します
  • Team と Enterprise では、請求を管理している場合は Organization settings > Usage で上限を引き上げるか、管理者に依頼します。/usage-credits を使うと、その依頼が管理者に送信されます
  • チャンネルの上限の場合は、組織のオーナーまたはチャンネルの管理者に claude.ai で引き上げるよう依頼します。Claude Tag ドキュメントのチャンネルごとの上限を参照してください
  • メッセージにプランのウィンドウのリセット時刻が示されている場合は、代わりにその時刻まで待つこともできます
  • /usage を実行して、プランのウィンドウとそれぞれのリセット時刻を確認します

Spend limit reached

Claude apps ゲートウェイ経由で接続しており、ゲートウェイ運用者が設定した支出上限に達しました。ゲートウェイは、運用者が上限を引き上げるまで、または上限が $0 を超えている場合はリセットされるまで、リクエストをブロックします。ブロックされた各 429 レスポンスには x-should-retry: false が付与されるため、ターミナルでは Claude Code が再試行せずにこのメッセージを表示します。
メッセージに日付があるかどうかを確認します。
  • 日付がある場合: 上限はその日付の 00:00 UTC にリセットされます
  • 日付がない場合: 上限が $0 であるか、ゲートウェイが v2.1.225 より前のバージョンを実行しています
メッセージ内のそれ以外のテキストは、ゲートウェイ運用者からの注記です。 ゲートウェイサーバーの v2.1.225 から v2.1.319 までは、メッセージに上限の期間とリセット時刻が示されていました(例: spend limit reached (daily; resets 2026-08-09 00:00 UTC))。 対処方法:
  • メッセージに日付がある場合は、リセットまで待つか、メッセージに運用者の注記があればそれに従います
  • メッセージに日付がない場合、日付を過ぎてもブロックされている場合、または日常的に上限に達する場合は、ゲートウェイ運用者に上限の引き上げを依頼します
もう 1 つのゲートウェイメッセージ This request exceeds your group's budget は、グループの共有予算を使い切ったことを意味します。メッセージに示された手順に従ってください。
関連するメッセージ spend limit unavailable は、ゲートウェイが支出記録を読み取れなかったため、上限超過ではなく予防措置としてリクエストをブロックしたことを意味します。通常は自然に解消されます。解消しない場合は、ゲートウェイ運用者に連絡してください。

Credit balance is too low

Console の組織のプリペイドクレジットが不足しているか、サブスクリプションを使用するつもりだったのに Claude Code が Console の API キーでリクエストを送信しています。
対処方法:
  • Pro、Max、Ultra、Team、または Enterprise プランを利用していてこのメッセージが表示される場合は、/status を実行して API key の行を確認します。環境内に承認済みの ANTHROPIC_API_KEY があると、サブスクリプションではなくそのキーを経由してリクエストが送信されます。現在のシェルでその設定を解除してシェルプロファイルから削除し、claude を再起動します。まだサブスクリプションでサインインしていない場合は /login を実行します。
  • platform.claude.com/settings/billing でクレジットを追加します。残高がゼロになる前に補充されるよう、そこで自動チャージを有効にすることも検討してください
  • 1 つのプロジェクトが組織の残高を使い果たすのを防ぐため、Console でワークスペースごとの支出上限を設定します。コストを効果的に管理するを参照してください。

Could not update your spend limit

支出上限に達したときに表示されるプロンプトから行った支出上限の変更を、サーバーが拒否しました。
サーバーが拒否の理由を示した場合、メッセージの末尾にその理由が表示され、同じ値で再試行しても再び失敗します。接続の切断など、サーバーから理由が提供されない失敗の場合、メッセージは Could not update your spend limit. Press Enter to retry. となり、再試行すると成功する可能性があります。v2.1.216 より前では、Claude Code はすべての失敗に対して汎用の形式を表示していました。 上限を削除した場合、v2.1.327 以降では汎用の形式は Could not remove your spend limit で始まります。 対処方法:
  • メッセージに理由が含まれている場合は、より低い金額など、その理由を満たす上限を選択します
  • メッセージに汎用の形式のみが表示されている場合は、再試行します。一時的な失敗である可能性があります
  • 変更が何度も失敗する場合は、代わりにブラウザで claude.ai の請求設定から変更します

認証エラー

これらのエラーは、Claude Code が API に対してユーザーの身元を証明できないことを意味します。/status をいつでも実行すると、現在どの認証情報が有効かを確認できます。

Not logged in

このセッションで使用できる有効な認証情報がありません。
Code タブや Cowork など、Claude Desktop アプリが実行するセッションでは、メッセージは Authentication required · Sign in again to continue となり、アプリから再度サインインします。 同じ設定ディレクトリを使用する別の Claude Code ウィンドウで claude.ai アカウントを使ってサインインすると、このメッセージを表示している対話セッションは自動的にそのログインを使い始めます。再起動する必要はありません。 macOS の v2.1.286 より前では、別のウィンドウからサインインした後も、セッションがメッセージを表示し続けることがありました。これらのバージョンでは、メッセージを表示しているセッションを再起動してください。 対処方法:
  • /login を実行して、Claude サブスクリプションまたは Console アカウントで認証します
  • 環境変数で認証されることを想定していた場合は、claude を起動したシェルで ANTHROPIC_API_KEY が設定され、エクスポートされていることを確認します
  • 対話的なログインができない CI や自動化では、起動時にキーを取得する apiKeyHelper スクリプトを設定します
  • 誰かが同じ claude.ai アカウントと組織に再度サインインしたときに claude -p ジョブがこのメッセージで終了する場合は、そのサインインを実行している環境の Claude Code を更新します。v2.1.318 より前では、Claude Code はそのサインイン中に、新しいログインを保存する前に保存済みのログインを削除していました。
  • 複数の認証情報がある場合に Claude Code がどれを使用するかについては、認証の優先順位を参照してください
ログインを繰り返し求められる場合は、システムクロックの確認と macOS の認証情報ストレージの復旧手順について、ログインしていない、またはトークンの有効期限切れを参照してください。

Could not resolve authentication method

セッションが認証情報なしで API クライアントに到達しました。バックグラウンドセッションとクラウドセッションでは、ワーカーが認証情報なしで起動したときにこのメッセージが表示されます。対話モード、-p、Agent SDK の実行では、同じ状態を Not logged in として報告し、この文字列はデバッグログにのみ書き込まれます。そのため、デバッグログでこれを見つけた場合は、代わりにそちらの項目に従ってください。
現在のバージョンでは、このエラーはワーカープロセスが使用できる認証情報がなかったことを意味します。v2.1.174 より前では、アイドル状態の事前初期化済みワーカーに割り当てられたバックグラウンドセッションが、有効な認証情報が設定されていてもこのように失敗することがありました。v2.1.176 より前では、割り当てられる前にアイドル状態だったクラウドセッションでも同様でした。アップグレードすると復旧します。 対処方法:
  • バックグラウンドセッションまたはクラウドセッションでこれが表示され、認証情報がすでに設定されている場合は、v2.1.176 以降にアップグレードします
  • ANTHROPIC_API_KEY、CLAUDE_CODE_OAUTH_TOKEN、またはクラウドプロバイダーの認証情報が、対話シェルだけでなく、ワーカーを起動する環境で設定されていることを確認します
  • Agent SDK については、クイックスタートの認証設定を参照してください
  • 同じ環境の対話セッションで /status を実行して、どの認証情報ソースが解決されるかを確認します

Invalid API key

ANTHROPIC_API_KEY 環境変数または apiKeyHelper スクリプトが API に拒否されたキーを返したか、Claude Code が ANTHROPIC_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 ヘッダーで扱えない文字を検出し、送信前にリクエストを停止しました。説明の読み方と値の修正方法については、Invalid request header value を参照してください。 対処方法:
  • タイプミスがないか確認し、Console でキーが取り消されていないことを確認します
  • 同じシェルで env | grep ANTHROPIC を実行するか、PowerShell では Get-ChildItem Env:ANTHROPIC* を実行します。direnv、dotenv シェルプラグイン、IDE のターミナルなどのツールは、明示的に設定しなくても、プロジェクト内の .env ファイルから古いキーを読み込むことがあります。
  • ANTHROPIC_API_KEY の設定を解除し、/login を実行して代わりにサブスクリプション認証を使用します
  • キーが apiKeyHelper スクリプトから取得される場合は、スクリプトを直接実行して、有効なキーが stdout に出力されることを確認します
  • /status を実行して、Claude Code が実際に使用している認証情報ソースを確認します

Your apiKeyHelper script is failing

Claude Code は apiKeyHelper 設定のコマンドを実行しましたが、キーが返されませんでした。キーがない場合、リクエストはプレースホルダーの認証情報で API に到達し、API は 401 で拒否します。ターミナルの Authentication パネルに、次のどれが発生したかが表示されます:
  • コマンドがエラーで終了したか、タイムアウトした
  • コマンドが stdout に何も出力しなかった
  • コマンドが、ログインバナーやログ行など、キー以外のものを出力した。パネルには returned output that cannot be used as an API key と表示され、出力を繰り返さずに何が問題かが示されます。v2.1.227 より前では、Claude Code はコマンドが出力した内容を、前後の空白を取り除いた上でそのまま送信していました。
非対話モードでは、stderr にも apiKeyHelper failed: で始まる具体的な理由が出力されます。 Claude Code はこのメッセージを表示する前に、スクリプトを再実行してリクエストを最大 2 回まで再試行するため、失敗は 3 回以内の試行で表面化します。v2.1.208 より前では、Claude Code は再試行の上限をすべて使い切ってプレースホルダーの認証情報でリクエストを再送信し、その後スクリプトの失敗ではなく一般的な 401 認証エラーを報告していました。 ここで /login を実行しても解決しません。設定が存在する限り、ヘルパーの出力は保存済みのログインより優先されるためです。 対処方法:
  • apiKeyHelper に設定されたコマンドをシェルで直接実行して、失敗を再現します
  • コマンドがセッションの期限切れを報告する場合は、SSO やシークレットボールトに再度サインインするなどして、認証情報プロバイダーで再認証します
  • コマンドを修正して、キーのみを最大 16,384 文字の印刷可能な ASCII からなる単一のトークンとして stdout に出力し、終了コード 0 で終了するようにします。動作する設定については、apiKeyHelper で認証情報をローテーションするを参照してください。
  • /status を実行して失敗を確認し、apiKeyHelper が有効な認証情報ソースであることを確認します。apiKeyHelper の行には Failing と、終了コードやコマンドのエラー出力など最後の失敗の詳細が表示され、次に実行が成功すると消えます。v2.1.274 より前では、/status には認証情報ソースのみが表示され、失敗は表示されませんでした。
  • コマンドが失敗するたびに、その終了コードとエラー出力がターミナルの Authentication パネルにも表示されます。v2.1.212 より前では、パネルのタイトルは Cloud authentication でした。

Claude Code didn’t send your claude.ai login

これらのメッセージは、Claude Code がリクエストを拒否し、claude.ai のログインを送信しなかったことを意味します:
対処方法:
  • Your organization's settings need an update:管理者に API キーヘルパーの設定を修正するよう依頼します
    • マシンにどの管理ソースがあるかを管理者に伝えるには、Claude Code のプロンプトで /status を実行し、Setting sources 行をコピーします。Skipped sources 行が表示されている場合は、それもコピーします
    • 設定を管理していて、ヘルパーがマシンの管理設定ファイルまたは MDM ポリシーにある場合は、マシンの apiKeyHelper が有効にならない場合を参照してください
  • Couldn't load your organization's settings:接続を確認してから、Claude Code を再起動します。再起動後もメッセージが再び表示される場合は、管理者に伝えてください
  • Restart Claude Code to finish signing in:Claude Code を再起動します
v2.1.315 より前では、拒否されたプロンプトまたはファイルアップロードで、Claude Code didn't send your claude.ai login で始まる 1 つのメッセージが出力されていました。

Invalid request header value

Claude Code がリクエストヘッダーとして送信しようとしていた値に、HTTP ヘッダーで扱えない文字が含まれています。改行、NUL バイト、または曲線引用符やゼロ幅スペースなどの U+00FF を超える文字です。Claude Code は何かを送信する前にリクエストを停止し、修正すべき変数または設定を示します。よくある原因は、ドキュメントやチャットから貼り付けた認証情報に、目に見えない文字や余分な改行が含まれていたことです。 Claude Code は、Claude API に直接、または LLM ゲートウェイ経由でリクエストを送信するときにこのチェックを実行します。Amazon Bedrock などのサードパーティのクラウドプロバイダーでは、Claude Code は送信前にこのチェックを実行しません。
メッセージの最初の部分は、不正な値がどこから来たかによって異なります:
  • Invalid auth token:ANTHROPIC_AUTH_TOKEN または CLAUDE_CODE_OAUTH_TOKEN からのベアラートークン
  • Invalid ANTHROPIC_CUSTOM_HEADERS:ANTHROPIC_CUSTOM_HEADERS に設定したヘッダー名または値。説明では、どの Name: Value ペアに問題があるかを distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS のように番号で示し、名前や値は繰り返しません。どちらもユーザー自身が選んだものだからです。
  • Invalid request header from the environment:CLAUDE_AGENT_SDK_CLIENT_APP など、Claude Code が別の環境変数からリクエストヘッダーにコピーする値。説明には修正すべき変数が示されます。
このチェックで検出された不正な ANTHROPIC_API_KEY は、同じ末尾の説明付きで Invalid API key として報告されます。不正な保存済みの /login 認証情報は、代わりに Not logged in として報告されます。/login を実行して新しい認証情報を保存してください。apiKeyHelper スクリプトの出力がこのチェックに到達することはありません。Claude Code はスクリプトの実行時に出力を検証し、HTTP ヘッダーで扱えない出力は Your apiKeyHelper script is failing で失敗します。 2 つ目の · の後には、次の完全な例のように、メッセージが問題を説明します:
位置は 1 から始まる文字数で数えます。説明は固定の語句と文字数から組み立てられるため、値そのものが含まれることはありません。問題の文字名が示されるのは、バイトオーダーマーク、ゼロ幅スペース、曲線引用符など、よく知られた不可視文字または印刷用の文字である場合のみで、それ以外はすべて a non-ASCII character として報告されます。 対処方法:
  • メッセージが示す変数または設定を再設定します。同じソースから再度貼り付けるのではなく、報告された位置の周辺の文字を入力し直してください
  • ANTHROPIC_CUSTOM_HEADERS の場合は、1 行に 1 つの Name: Value ペアを記述し、メッセージが番号で示したペアを書き直します
  • /status を実行して、有効な認証情報ソースを確認します

This organization has been disabled

Claude Code が、無効化された Console 組織の古い ANTHROPIC_API_KEY を使用しています。保存済みのサブスクリプションログインがある場合は、キーがそれを上書きします。
· の後のヒントは、保存済みの認証情報によって異なります。1 つ目の形式は、キーの設定を解除した後に保存済みの /login が引き継げる場合に表示され、2 つ目の形式は、キーが唯一の認証情報である場合に表示されます。 シェルプロファイルでキーをエクスポートしているか、.env からキーを読み込んでいる場合、Pro、Max、Ultra のサブスクリプションが有効であっても、Claude Code は /login の代わりにそのキーを使用します。非対話モード(-p)では、キーが存在すれば常に使用されます。 対処方法:
  • 現在のシェルで ANTHROPIC_API_KEY の設定を解除してシェルプロファイルから削除し、claude を再起動します
  • メッセージに Update or unset とある場合、フォールバック先となる保存済みのログインはありません。キーの設定を解除して /login を実行するか、キーを有効な Console 組織のキーに置き換えます。
  • その後 /status を実行して、有効な認証情報がサブスクリプションであることを確認します
  • 環境変数が設定されていないのにエラーが続く場合は、サポートに連絡するか、別のアカウントでサインインしてください。

Your organization has disabled API key authentication

このメッセージには Claude Code v2.1.169 以降が必要です。Console 組織の管理者が API キー認証をオフにしているため、API は Claude Code が送信しているキーを拒否します。· の後の復旧のヒントは、キーの取得元によって異なります:
最後の形式は、Code タブや Cowork など Claude Desktop アプリが実行するセッションで表示され、その場合はアプリから再度サインインします。 環境変数と apiKeyHelper は /login より優先されるため、どちらかがまだキーを提供している間は、/login を実行するだけでは解決しません。認証の優先順位を参照してください。 対処方法:
  • メッセージに ANTHROPIC_API_KEY が示されている場合は、現在のシェルで設定を解除し、シェルプロファイルまたは .env ファイルから削除してから、claude を再起動します
  • メッセージに apiKeyHelper が示されている場合は、settings.json から apiKeyHelper 設定を削除します
  • /login を実行して claude.ai アカウントでサインインします
  • その後 /status を実行して、有効な認証情報が API キーではなくサブスクリプションであることを確認します
  • 自動化のために API キー認証が必要な場合は、組織の管理者に Console で再度有効にするよう依頼します

Your organization has disabled Claude subscription access

Claude 組織では、サブスクリプションログインによる Claude Code へのサインインが許可されていません。同じアカウントで /login を再度実行しても、同じエラーが返されます。
これはサーバー側の組織設定であるため、ローカル設定、環境変数、CLI フラグで上書きすることはできません。 Agent SDK と -p 非対話モードでは、これは oauth_org_not_allowed エラーコードとして表示されます。 対処方法:
  • 組織で Claude Code へのアクセスを有効にするよう管理者に依頼します
  • サブスクリプションの代わりに Console API キーで認証します。設定については Claude Console 認証を参照してください。
  • 管理者であるにもかかわらずアクセスを有効にするオプションが見つからない場合は、Anthropic サポートに連絡してください

Scheduled tasks are off for your organization

組織でクラウドスケジュールタスクがオフになっているため、作成も実行もできません。claude.ai からのメッセージではスケジュールタスクまたはルーティンと呼ばれ、その後に管理者に関する文が続きます:
ローカル設定、環境変数、CLI フラグでオンにすることはできません。 対処方法:

Remote Control requires the Anthropic API

セッションが Anthropic API と直接通信していません。Remote Control にはこれが必要です。
2 つ目の文では、セッションが Anthropic API 以外にルーティングされた原因が説明されます。v2.1.219 より前では、メッセージは 1 つ目の文のみでした。原因に応じて、メッセージには次のものが示されます:
  • CLAUDE_CODE_USE_* プロバイダー変数(Amazon Bedrock の場合は CLAUDE_CODE_USE_BEDROCK、Google Cloud の Agent Platform の場合は CLAUDE_CODE_USE_VERTEX など)
  • api.anthropic.com 以外のホスト(LLM ゲートウェイやプロキシなど)を指す ANTHROPIC_BASE_URL。claude.ai でサインインしている場合も含みます。v2.1.196 より前では、カスタムベース URL は Remote Control をブロックしませんでした
  • ANTHROPIC_UNIX_SOCKET が設定されているため、セッションが api.anthropic.com ではなくローカルソケット経由でリクエストを送信している
  • /login で行ったエンタープライズのクラウドゲートウェイへのサインイン。これは 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 なしで実行され続けます。このセクションでは次の行を扱います:
Claude Code はメッセージの中央に原因を示します:
  • Claude.ai login expired と Claude.ai login was rejected:保存済みのログイントークンの有効期限が切れたか取り消されたため、claude.ai がそれを受け付けなくなりました
  • OAuth token unavailable:接続の認証情報の更新時期が来たときに、Claude Code に保存済みのログイントークンがありませんでした
  • OAuth token refresh failed:Claude Code の再接続中に claude.ai が保存済みのログイントークンを拒否し、トークンを更新しても新しいトークンが得られませんでした
  • 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 として報告し、ログインの更新に一度でも応答がないとすぐに Claude.ai login expired — run /login to restore Remote Control で Remote Control を停止していました。

Remote Control could not renew this computer’s connection

この警告は、サーバーが claude.ai ログインを使用して接続の認証情報を有効期限前に更新できない場合に、claude remote-control を実行しているターミナルに表示されます。警告の最後の文には、現在の認証情報があとどれくらい有効か、またはすでに有効期限が切れていることが示されます:
対処方法:
  • 警告で claude /login を実行するよう指示されている場合は、サーバーを実行しているマシンで別のターミナルを開き、そこで claude /login を実行して claude.ai アカウントでサインインします
  • 接続の認証情報の有効期限が切れた後もサーバーがサインインできない場合、サーバーは Poll: Authentication failed (401) を含むエラーを出力して停止します。警告の 2 つ目の文の指示に従って再度サインインしてから、サーバーが停止したターミナルで claude remote-control を再度実行します。

サインイン中のアカウントが変更されたため Remote Control が停止した

このマシンで別の claude.ai アカウントまたは組織にサインインすると、Remote Control セッション中に Claude Code はこの行を表示します。この切り替えは、別のターミナルで /login を実行するなど、Claude Code セッションの外で行われたものです。 /login でサインインした状態で開始した Remote Control セッションは、その時点でサインインしていた claude.ai アカウントと組織に属します。
アカウントまたは組織が変更されたことを claude.ai が確認するとすぐに、Claude Code は Remote Control セッションを停止します。ローカルセッションは Remote Control なしで実行され続けます。 対処方法:
  • /remote-control を実行して、現在のアカウントまたは組織で新しい Remote Control セッションを開始します
  • 元に戻すには、/login を実行して以前のアカウントまたは組織に再度サインインします。その後 /remote-control を実行します。
v2.1.234 より前では、Claude Code セッションの外で別のアカウントや組織に切り替えても、Claude Code はそれを検知しませんでした。Claude Code は、後で Remote Control サーバーへのリクエストが Remote Control server rejected the request (HTTP 404) で失敗するまで、Remote Control セッションの接続を維持していました。この失敗は切り替えから数時間後に発生することもありました。

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

Claude デスクトップアプリまたは IDE がセッションをホストしている場合、Claude Code は /login ではなくそのアプリからログイントークンを取得します。claude.ai がそのトークンを拒否すると、Claude Code はアプリに新しいトークンを求めます。アプリがサインアウトしている、または別の Claude アカウントにサインインしていると応答した場合、Claude Code は Remote Control セッションを終了し、アプリに次のいずれかの行を送信します:
ローカルセッションは Remote Control なしで実行され続けます。 対処方法:
  • アプリがサインアウトしている場合は、アプリに再度サインインしてから、アプリで Remote Control をオンに戻します
  • アプリがアカウントを切り替えた場合、Claude Code は終了したセッションを新しいアカウントで続行できません。そのアカウントで新しい Remote Control セッションを開始します。
v2.1.238 より前では、どちらの場合も、Claude Code は Remote Control がログインを更新できなかったに記載されている run /login メッセージをアプリに送信していました。

OAuth token revoked or expired

保存済みのログインが無効になっています。トークンが取り消された場合は、すべての場所からサインアウトしたか、管理者がアクセスを削除したことを意味します。トークンの有効期限が切れた場合は、セッション中に自動更新が失敗したことを意味します。 どちらのメッセージも、Claude Code が送信したリクエストに対して API が返した拒否を報告するものです。更新の失敗後に保存済みのログインがすでに消去されている場合は、代わりに Login expired を参照してください。CLAUDE_CODE_OAUTH_TOKEN の長期間有効なトークンで認証している場合、そのトークンが期限切れになるか取り消されると、同じメッセージが表示されます。
非対話モード(-p)と Agent SDK では、メッセージは次のようになり、構造化エラーコードは authentication_failed です:
v2.1.287 より前では、非対話モードと Agent SDK で、取り消しのメッセージは Your account does not have access to Claude. Please login again or contact your administrator. と表示されていました。 対処方法:
  • Claude Code のプロンプトで /login を実行して再度サインインします
  • -p コマンドまたは Agent SDK プログラムが保存済みのログインを使用している場合は、同じ環境で claude を実行して /login を完了してから、コマンドまたはプログラムを再度実行します。対話的にサインインできない自動化では、ANTHROPIC_API_KEY で認証するか、claude setup-token で長期間有効なトークンを生成します。
  • CLAUDE_CODE_OAUTH_TOKEN 環境変数で認証している場合、リクエストが 401 で失敗した後も、Claude Code は保存済みログインのトークンに切り替えず、設定した値を送信し続けます。/status では、この認証情報は CLAUDE_CODE_OAUTH_TOKEN と表示される Auth token 行として示されます。claude setup-token で新しいトークンを生成してそれを使って再起動するか、変数の設定を解除して /login を実行します。v2.1.225 より前では、Claude Code がセッション中に変数の値を保存済みログインの短期間有効なアクセストークンに置き換えることがあり、そのトークンの有効期限が切れるとセッションが再び 401 エラーで失敗していました。
  • 起動のたびにログインを繰り返し求められる場合は、トラブルシューティングのシステムクロックの確認と macOS の認証情報ストレージの復旧手順を参照してください
  • 403 Forbidden や OAuth のブラウザの問題など、その他の失敗については、ログインと認証を参照してください

API Error: 401 Invalid authentication credentials

API は認証情報の形式を認識しましたが、その背後にあるアカウントまたは組織を拒否しました。Anthropic がこのメッセージを返すのは、認証情報が最近取り消された場合、組織が無効化されたか組織がアクセスを削除した場合、またはアカウント自体が無効化された場合であり、トークンの有効期限切れが原因ではありません。認証情報は保存済みのログインか承認済みの ANTHROPIC_API_KEY のいずれかで、それぞれ対処方法が異なるため、まず /status を実行してどちらが有効かを確認してください。
対処方法:
  • /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 では変わりません。代わりに、ゲートウェイが想定する認証情報を修正します。
  • ゲートウェイが想定する認証情報を受け取った後もすべてのリクエストが 401 で失敗する場合は、ゲートウェイとそのアップストリームがツール検索のフィールドを受け付けることを確認します。デフォルトでは、Claude Code は defer_loading ツールフィールドと tool_reference ブロックを、それらを有効にする anthropic-beta ヘッダーとともに送信します。v2.1.304 より前では、ENABLE_TOOL_SEARCH でオンにしない限り、ゲートウェイの背後ではツール検索はオフでした。

Login expired

Claude Code が保存済みの claude.ai ログインを更新しようとしたところ、OAuth サービスが保存されているリフレッシュトークンを拒否したため、Claude Code は保存済みの認証情報を消去しました。ほかに保存済みの認証情報がない場合、その後のモデルへのリクエストはこのメッセージで停止します:
非対話モード(-p)と Agent SDK では、メッセージは次のようになり、構造化エラーコードは authentication_failed です:
ログインが時間制限に達した場合、Claude Code v2.1.318 以降では、どちらのメッセージも代わりに reached its time limit と表示されます。or re-authenticate your Anthropic profile で終わる Login expired メッセージについては、Anthropic profile login expired を参照してください。 アカウント自体が停止されているために更新が失敗した場合、Claude Code は代わりに Your account is on hold を表示します。 対処方法:
  • /login を実行して再度サインインします。
  • 別の Claude Code ウィンドウで claude.ai アカウントを使ってサインインする場合、このセッションが自動的にそのログインを使い始める条件については Not logged in を参照してください。
  • 非対話モードでは、同じ環境で claude を実行して /login を完了してから、コマンドを再実行します。対話的にサインインできない自動化では、ANTHROPIC_API_KEY で認証するか、claude setup-token で長期間有効なトークンを生成します。
  • サインインが失敗し続ける場合は、ログインと認証を参照してください

Could not refresh your login because another Claude Code process is refreshing it

このメッセージは、ログインが拒否されたことを意味するものではありません。保存済みの claude.ai ログインの有効期限が切れていて、更新が必要でした。同じマシン上の別の Claude Code プロセスが共有のリフレッシュロックを保持していたか、ロックを残したまま終了していたため、このセッションが待機している間に更新が進みませんでした。Claude Code は送信前にリクエストを停止します:
非対話モード(-p)と Agent SDK では、メッセージは次のようになり、構造化エラーコードは server_error です:
対処方法:
  • 1 分後に再試行します。別のプロセスが先に更新を完了した場合、このセッションは更新されたログインを使用します。
  • メッセージが繰り返し表示される場合は、他の Claude Code ウィンドウとプロセスを閉じてから再試行します。
  • 他の Claude Code プロセスが実行されていないのにメッセージが表示される場合は、/login を実行します。再度サインインする場合は、リフレッシュロックを待機しません。

Could not refresh your login: the disk that holds the Claude Code config directory is full

Claude Code の設定ディレクトリがあるディスクの空き容量を確保してから、メッセージを再度送信してください。ディスクがいっぱいの間は新しいログインを保存できないため、サインインしても解決しません。CLAUDE_CONFIG_DIR を設定していない限り、設定ディレクトリはホームディレクトリ内の ~/.claude です。
非対話モード(-p)と Agent SDK では、メッセージは次のようになります:
対処方法:
  • スクリプトの場合は、その claude -p コマンドを再実行します
  • ディスクにすでに空き容量がある場合でも、ディスククォータや inode が不足していると同じメッセージが表示されます。そのディスク上の自分のファイルを削除してください。メッセージが再び表示される場合は、サイズに関係なく各ファイルが inode を 1 つ使用するため、少数の大きなファイルではなく多数の小さなファイルを削除します。

Couldn’t save your login

claude.ai でサインインしましたが、Claude Code がログインを認証情報ストアに保存できなかったため、ログインは完了しませんでした。macOS では、同じセッション中に Claude Code がすでにログインキーチェーンの認証情報を読み取ったり保存したりした後に、スリープやアイドルなどでキーチェーンがロックされると、これが発生することがあります。
1 つ目の形式は macOS で、2 つ目の形式はそれ以外の環境で表示されます。タイムアウトやストアを読み取れないなど、一時的な認証情報ストアの障害でも同じメッセージが表示されます。 対処方法:
  • macOS では、ログインキーチェーンのロックを解除してから、/login を再度実行します
  • その他のプラットフォームでは、/login を再度実行します
  • それでもログインが保存されない場合は、キーチェーンのロック解除コマンドやその他の認証情報ストレージの復旧手順について、ログインしていない、またはトークンの有効期限切れを参照してください

Sign in again to take your previous account or API key off the config file

サインイン後にこの警告が表示された場合、以前にサインインしていたアカウントが ~/.claude.json にまだ保存されている可能性があります:
Linux または Windows で Console ログインによって API キーが作成された場合は、API キーも ~/.claude.json にまだ残っている可能性があります。 対処方法:
  • シェルで claude auth login を実行して再度サインインします。その後 Claude Code は、置き換えられたアカウントまたは API キーをファイルから削除する保存処理を再試行します。

Your account or API key may still be in the config file

/logout または claude auth logout を実行し、Claude Code はこのプロセスをサインアウトしましたが、~/.claude.json にアカウントが保持されていないことを確認できませんでした。保存が反映されなかったか、確認のためにファイルを読み戻せなかったかのいずれかです。
Linux または Windows で Console ログインによって API キーが作成された場合は、API キーも ~/.claude.json にまだ残っている可能性があります。 対処方法:
  • シェルで claude auth logout を実行して、保存を再試行します。保存が完了すると、コマンドは Successfully logged out from your Anthropic account. と出力します。

Couldn’t start the local listener that receives the browser sign-in

/login、claude auth login、claude setup-token からのこれらのメッセージはいずれも、ブラウザがサインイン結果を返す 127.0.0.1 上のポートを Claude Code が開けなかったことを意味します。 The browser can't return the sign-in to Claude Code automatically で始まる通知の場合、サインインはそのポートなしで続行されます。ブラウザは開かず、通知の下にサインイン用の URL が表示されます:
Couldn't start the local listener を含むメッセージの場合、サインインは停止しています。これは、たとえば claude auth login に入力をパイプした場合に発生します:
対処方法:
  • The browser can't return the sign-in to Claude Code automatically:事前に何かを修正する必要はありません。通知の下に表示された URL をブラウザで開いてサインインします。ブラウザにコードが表示されるので、Claude Code の Paste code here > プロンプトに貼り付けると、そこからサインインが続行されます。
  • Couldn't start the local listener that receives the browser sign-in:同じコマンドを再度実行します。同じように停止する場合は、ブラウザの代わりにトークンまたは API キーでサインインします。または、claude auth login に入力をパイプしていた場合は、貼り付けたコードを受け取れるようにターミナルで実行します。
  • ブラウザの代わりにトークンまたは API キーでサインインするには:claude.ai サブスクリプションを使用している場合は、サインインが機能するマシンで claude setup-token を実行します。次に、出力されたトークンをこのマシンの CLAUDE_CODE_OAUTH_TOKEN 環境変数に設定します。それ以外の場合は、ANTHROPIC_API_KEY 環境変数に Claude Console のキーを設定します。Claude Code が認証情報をどのように選択するかについては、認証の優先順位で説明しています。
  • ブラウザからの自動的な戻りを復活させるには:Claude Code が 127.0.0.1 でリッスンできる必要があります。サンドボックス内で実行している場合は、サンドボックスのポリシーでローカルポートでのリッスンが許可されていることを確認してから、再度サインインします。そこでリッスンが機能するはずなのに通知が表示される場合は、レポートに環境の詳細が含まれるように /feedback を実行します。
v2.1.305 より前では、ポートを開けなかった時点でサインインが停止し、サインイン用の URL は表示されませんでした。メッセージは、たとえば Failed to start OAuth callback server: Failed to start server. Is port 0 in use? のようになりました。これらのバージョンでは、Claude Code を更新して再度サインインするか、ブラウザの代わりにトークンまたは API キーでサインインします。

Claude login not accepted

クラウドセッションを開始しようとしましたが、サーバーが 401 でその作成を拒否しました。このマシンが送信した Claude ログインをサーバーが受け付けなかったためで、通常はログインの有効期限が切れたか取り消されたことが原因です。 行の最初の部分は、サーバーが理由を示した場合はその理由です。それ以外の場合、行は次のようになります:
対処方法:
  • /login を実行してサインインを完了してから、セッションを再度開始します

Artifacts need a claude.ai login

セッションにアーティファクトに使用できる claude.ai ログインがないため、Claude Code はアーティファクトの公開または読み取りを拒否しました。 どの形式のメッセージも同じ文言で始まり、その後にセッションの認証方法に応じた対処方法が続きます。競合する認証情報がない場合は、次のようになります:
対処方法:
  • /login を実行し、Claude account with subscription を選択します。Anthropic Console account オプションでは claude.ai の認証情報は提供されません。
  • ANTHROPIC_API_KEY、apiKeyHelper 設定、以前の /login で保存された Console キーなど、優先される認証情報がメッセージに示されている場合は、メッセージの指示に従ってそれを削除してから、/login を実行します
  • このリモートセッションが起動元のマシンを通じて認証しているとメッセージに示されている場合は、そのマシンで claude.ai にサインインしてから、セッションを再接続します
  • 認証情報がセッションのホスト環境によって注入されているとメッセージに示されている場合、そのセッションでは変更できません。claude.ai にサインインしているセッションを開始します
  • プラン、モデルプロバイダー、組織ポリシーなど、アーティファクトのその他の要件については、利用可能性を参照してください

Administrator policy requires a Cloud gateway sign-in

このマシンの管理者の管理設定で、forceLoginMethod が "gateway" に設定されているか、forceLoginGatewayUrl が設定されています。CLAUDE_CODE_USE_BEDROCK などの変数でクラウドプロバイダーを選択していない限り、Claude Code は Claude apps ゲートウェイのサインインのみを受け付けます。次の 2 つのメッセージのいずれかが表示されます:
セッションにゲートウェイのサインインがない場合(たとえば、ポリシーがマシンに適用されてから /login を実行していない場合)、モデルリクエストはこのメッセージで失敗します。 マシンに Anthropic が発行した認証情報もあり、管理設定で forceLoginMethod または forceLoginOrgUUID が設定されている場合、Claude Code は代わりに起動時に終了します。その認証情報は、ANTHROPIC_API_KEY または ANTHROPIC_AUTH_TOKEN 変数、apiKeyHelper 設定、以前の Claude Console ログインで保存された API キーのいずれかです。 起動時のメッセージには、セッションに設定されている認証情報、その設定場所、およびそれを削除する手順が示されます。たとえば、シェルで ANTHROPIC_API_KEY 変数が設定されている場合は、次のようになります:
対処方法:
  • Not signed in to the Cloud gateway の場合は、/login を実行し、Cloud gateway 画面でサインインを完了します
  • 起動時のメッセージの場合は、メッセージの末尾の手順に従って認証情報を削除します
  • マシンでゲートウェイが必要とされるべきではないと思われる場合は、マシンを管理している管理者に、その管理設定から forceLoginMethod と forceLoginGatewayUrl を削除するよう依頼します
v2.1.284 より前では、起動時のメッセージは設定されている認証情報を示すのではなく、考えられる認証情報を列挙していました。メッセージは 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. で始まっていました。この文言が表示され、どの認証情報を削除すべきかわからない場合は、v2.1.284 以降に更新して claude を再度起動します。 v2.1.265 では、リグレッションにより、マシンに管理者の要件がない場合でも、API キー、apiKeyHelper、カスタムヘッダーで認証する一部の LLM ゲートウェイおよびプロキシの構成で 1 つ目のメッセージが表示されていました。v2.1.266 以降に更新してください。設定を変更する必要はありません。 v2.1.261 より前では、forceLoginMethod を "gateway" に設定しているマシンで、Claude Code はモデルリクエストを失敗させる代わりに残っていた保存済みのログインを使用し、設定された環境の認証情報について、起動時のメッセージではなく This machine's managed settings require a first-party login を報告していました。

Your account is on hold

ログインの背後にある Claude アカウントが停止されています。Claude Code は、保存済みのログインを更新しようとして保留を知った場合は 1 つ目のメッセージを、ブラウザで完了したサインインが保留を報告した場合は 2 つ目のメッセージを表示します:
保留はログインではなくアカウントにかかっているため、同じアカウントで再度サインインしてもメッセージは解消されません。非対話モード(-p)と Agent SDK では、構造化エラーコードは account_on_hold です。v2.1.235 より前では、Claude Code は保留中のアカウントを Login expired · Please run /login として報告しており、その復旧手順では保留を解除できませんでした。 対処方法:
  • メッセージ内のリンクを開いて、保留の詳細を確認するか異議を申し立てます
  • 保留の影響を受けない別の Claude アカウントまたは API キーがある場合は、保留が解決されるまでの間も作業を続けられます。そのアカウントで /login を実行するか、ANTHROPIC_API_KEY でキーを設定します

Anthropic profile login expired

Claude Code は Anthropic 認証情報プロファイルを通じて認証していますが、そのプロファイルの保存済みログイン認証情報の有効期限が切れており、プロファイルには Claude Code が更新に使用できるリフレッシュ認証情報がありません。Claude Code は再試行せずに、各リクエストをローカルで停止します。
対処方法:
  • メッセージが Login expired で始まる場合は、/login を実行して再度サインインします
  • キーレスの Console サインインまたは Claude Platform CLI の ant auth login が書き込んだプロファイルを更新するには、キーレスのサインインを提供しているマシンで /login を実行します。Anthropic Console アカウントを選択してから、Sign in with your Console account を選択します。Claude Code がそのプロファイル内の期限切れの認証情報を置き換えます
  • 別のツールが作成したプロファイルを更新するには、そのツールで再度サインインします。代わりに /login で Sign in with your Console account を選択した場合、Claude Code はプロファイルをそのままにして API キーを作成します
  • 管理者がプロファイルの認証情報をプロビジョニングした場合は、新しい認証情報の発行を依頼します
  • /status を実行して、有効な認証情報ソースとプロファイル名を確認します
  • プロファイルの使用をやめるには、ANTHROPIC_PROFILE を設定している場合はその設定を解除してから、/login や ANTHROPIC_API_KEY など別の方法で認証します
メッセージの始まり方から、Claude Code がプロファイルをどのように見つけたかがわかります:
  • Claude Code が設定ディレクトリからプロファイルを検出し、その認証モードが user_oauth の場合、メッセージは Login expired で始まり、最初に /login が提示されます。Claude Code は、検出されたプロファイルより機能している /login を優先し、代わりに claude.ai アカウントで認証します。v2.1.234 から v2.1.277 までは、この形式は Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile と表示されていました。v2.1.234 より前では、この場合も Claude Code は Re-authenticate your Anthropic profile の形式を表示していました。
  • ANTHROPIC_PROFILE でプロファイルを選択した場合、メッセージは Anthropic profile login expired で始まります。
これが表示されるのは、有効な認証情報が Anthropic 認証情報プロファイルから取得されている場合のみです。該当するのは、ANTHROPIC_PROFILE 環境変数で選択したプロファイル、Anthropic 設定ディレクトリ内の有効なプロファイルとして Claude Code が検出したプロファイル、または API キーなしでサインインしたときに Claude Code が書き込んだプロファイルです。API キー、ANTHROPIC_AUTH_TOKEN などのベアラートークン、またはサードパーティのプロバイダーで認証するセッションでは、このメッセージは表示されません。

OAuth scope requirement

保存されているトークンは、新しい機能が必要とする権限スコープが導入される前のものです:
対処方法:
  • /login を実行して、現在のスコープを持つ新しいトークンを取得します。事前にログアウトする必要はありません。

claude.ai rejected the session token

claude.ai が Claude Code ログインのトークンを拒否したため、claude.ai コネクタのリクエストが失敗しました。拒否されたトークンは claude.ai でのコネクタ自体の認可ではなくログインのものであるため、コネクタを再度認可しても解決しません。/mcp では、コネクタは session token rejected と表示され、その詳細ビューには次のように表示されます:
対処方法:
  • /login を実行して再度サインインします
  • /mcp からコネクタを再接続するか、/mcp reconnect <server> を実行します。再度サインインする前に再接続しても、コネクタは同じ状態のままです。/mcp パネルの Reconnect オプションは your claude.ai session token was rejected を報告しますが、入力した /mcp reconnect <server> 形式では、トークンがまだ拒否されていても再接続成功と報告されます。
v2.1.222 より前では、Claude Code は代わりにコネクタを認証が必要とマークしていたため、コネクタの認可フローを完了してもこの状態は解決しないにもかかわらず、そのフローに誘導されていました。

MCP server needs you to sign in again

リモートの MCP サーバーがセッション中のツール呼び出しで認証情報を拒否しました。通常は、サインインまたはトークンの有効期限が切れたか、トークンにツールが必要とする権限がないことが原因です。ツール呼び出しは失敗し、/mcp はサーバーを認証が必要とマークします。 claude.ai コネクタを含め、Claude Code からサインインするサーバーの場合は、サインインの有効期限が切れたか取り消されています:
/mcp を実行してサーバーを選択し、そのメニューから再度サインインします。 headersHelper スクリプトで設定されたサーバーの場合、Claude Code はこのメッセージを表示する前に、すでにヘルパーを再実行して呼び出しを 1 回再試行しています:
ヘルパーがサーバーに受け付けられる認証情報を返すことを確認してから、/mcp から再接続します。再接続するとヘルパーが再度実行されます。 設定に静的な Authorization ヘッダーがあるサーバーの場合:
サーバーが設定されている場所でヘッダーの値を更新してから、/mcp から再接続します。 Claude Desktop アプリのマシン上の Cowork セッションでは、これらのメッセージは MCP サーバーが渡された認証情報を拒否したことを意味します。メッセージが示すものを修正してから、Cowork で新しいタスクまたはチャットを開始します:
  • headersHelper の認証情報が拒否された場合:ヘルパーがサーバーに受け付けられる認証情報を返すことを確認してから、Cowork で新しいタスクまたはチャットを開始します
  • Authorization ヘッダーが拒否された場合:そのサーバーの設定の headers にある Authorization の値を更新してから、Cowork で新しいタスクまたはチャットを開始します
v2.1.302 より前では、Cowork セッションでは /mcp を使用できないにもかかわらず、代わりに run /mcp to reconnect の末尾が表示されていました。Cowork でこのような末尾が表示された場合でも、ヘルパーを確認するかヘッダーを更新してから、新しいタスクまたはチャットを開始します。v2.1.273 より前では、サインインの期限切れ、headersHelper、Authorization ヘッダーのいずれの場合も、MCP server "<name>" requires re-authorization (token expired) と表示されていました。 サーバーは、スコープの認可を求めるために HTTP 403 insufficient_scope でツール呼び出しを拒否することもあります。そのスコープがすでにトークンに含まれている場合もあります。メッセージにはそのスコープが示されます:
/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) が表示されていました。

Couldn’t read the stored credentials for MCP server

Claude Code は、OAuth MCP サーバーのサインインを認証情報ストアに保持しています。このメッセージは、Claude Code がそのストアを読み取れなかったため、サーバーへのリクエストが実行されなかったことを意味します:
保存されているサインインは変更されていません。ストアを読み取れるようになったら再試行し、その後サーバーから求められた場合にのみ再度サインインしてください。 macOS での claude -p または Agent SDK の実行では、保存済みのサインインなしでリクエストがすでに送信された後に、キーチェーンが読み取り可能になることがあります。そのリクエストは次のように失敗します:
対処方法:
  • メッセージで Mac のキーチェーンのロック解除を求められた場合は、Claude Code を実行するシェルセッションで claude doctor を実行し、そのレポートにキーチェーンの警告がないか確認します:
    • レポートに macOS Keychain is not writable で始まる警告がある場合、またはシェルに claude コマンドがない場合は、そのシェルセッションで次のロック解除コマンドを実行します:
    • レポートにキーチェーンの警告がない場合は、ロック解除コマンドをスキップします
  • メッセージが表示された場所で再試行します:
    • claude -p の場合は、コマンドを再度実行します
    • 対話セッションでは、サーバーが /mcp で失敗と表示されている場合はそこから再接続し、Claude に再試行を依頼します
    • 実行し続ける Agent SDK アプリケーションでは、TypeScript の reconnectMcpServer() または Python の ClaudeSDKClient.reconnect_mcp_server() を呼び出すか、新しいセッションを開始します
  • その後サーバーが認証が必要と報告した場合、Claude Code はそのサーバーに使用できるサインインを見つけられませんでした。対話的にサインインします。Claude Code セッションで /mcp を実行するか、シェルで claude mcp login <name> を実行します。Agent SDK アプリケーションでは、Agent SDK での OAuth2 認証を参照してください。
v2.1.307 より前では、ログインキーチェーンがロックされた Mac での claude -p または Agent SDK の実行では、どちらのメッセージも表示されず、代わりにサーバーが認証を必要としていると報告されていました。

MCP server URL is missing or not a valid URL

リモート MCP サーバーに設定された url が URL として解析できないため、Claude Code はそのサーバーの OAuth サインインの開始を拒否しました。Claude Code がそのサーバーについてより具体的な設定の問題を報告する場合を除き、シェルで claude mcp login <name> を実行すると、拒否は次のように出力されます。
対処方法:
  • サーバーが設定されている場所で、そのエントリの url をサーバーの実際のエンドポイントに設定するか、その ${VAR} 参照が指定する環境変数を設定してから、サインインを再度実行します。

Issuer mismatch in authorization response

MCP OAuth サインイン中に、認可サーバーが Claude Code にリダイレクトで戻した iss パラメータが、Claude Code がサーバーの OAuth メタデータから想定していた発行者(issuer)を示していませんでした。この段階での誤った発行者は、認可サーバー混同攻撃(mix-up attack)が現れる形そのものであるため、Claude Code は認可コードを交換せずにサインインを失敗させます。Claude Code は、ブラウザでのサインイン後に /mcp サーバーメニューにエラーを表示します。
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 は段階的なロールアウトの場合、または MCP_SDK_GENERATION=v2 を設定した場合にのみ v2 ランタイムを使用していました。

Stopped an OAuth request

このメッセージは、OAuth エンドポイントがリダイレクトしたために、Claude Code が MCP サーバーの OAuth リクエストを停止したことを意味します。どちらの形式のメッセージでも、最初のアドレスがリダイレクトを送信したアドレスです。
対処方法:
  • 最初のアドレスを運営している人(MCP サーバーの運営者など)に、リダイレクトを削除または修正するよう依頼してください。その後、/mcp から再試行します。

Refusing to send credentials to non-https token endpoint

v2 ランタイムでは、Claude Code は MCP OAuth のトークンリクエストを、HTTPS で提供されているトークンエンドポイント、または localhost、127.0.0.1、::1 にあるトークンエンドポイントにのみ送信します。このメッセージは、サーバーのトークンエンドポイントがそのどちらでもないため、Claude Code がリクエストを送信する前に停止したことを意味します。これはブラウザでのサインインの後に発生するため、ブラウザでのステップはまず成功し、その後 Claude Code がサーバーのトークンを更新するたびに再び発生します。 完全な形式では、このメッセージは MCP SDK から出力され、拒否したトークンエンドポイントを引用します。デバッグログでは、サインインの場合は Error during auth completion:、更新の場合は Token refresh failed: の後に続きます。シェルでは claude mcp login <name> が Couldn't complete authentication for "<name>": の後にこれを出力し、セッション内では /mcp がサーバーのメニューの下に表示します。
Claude Code は、クエリ文字列や長いランダムに見えるパスセグメントを含むサーバー URL を、機密情報である可能性があるものとして扱います。そのようなサーバーについては、MCP SDK が発生させたサインインエラーを表示またはログに記録する前に秘匿化します。その場合、このエラーは io のようなリリース間で変わる可能性のある短い名前の後に、from the MCP SDK for と秘匿化されたサーバー URL が続く形で表示されます。MCP SDK からのその他のエラーも、そこでは同じ形になります。秘匿化されたメッセージがこのエラーでありうるのは、サーバーのトークンエンドポイントが localhost、127.0.0.1、::1 以外のアドレスにあるプレーンな http:// である場合のみです。 対処方法:
  • そのトークンエンドポイントを HTTPS で提供します。たとえば、TLS を終端するリバースプロキシやトンネルの背後にサーバーを配置し、https:// アドレスを公開するようにサーバーを設定します
  • サーバーを変更せずに接続するには、MCP_SDK_GENERATION=v1 を指定して Claude Code を起動します。そのランタイムはこのルールを適用せず、トークンリクエストをプレーンな HTTP で送信します。この選択は終了するまで有効で、すべてのサーバーに適用されます。v1 ランタイムは発行者チェックもスキップするため、エンドポイントを HTTPS で提供する方法を優先してください

AWS credentials expired or invalid

AWS セッショントークンの有効期限が切れたか、拒否されました。このメッセージは、Claude Platform on AWS または Mantle エンドポイントから 401 が返されたときに表示されます。これらのプロバイダーは、期限切れのセキュリティトークンをこの方法で報告します。 中央のアクションヒントはセットアップによって異なります。変わらない部分は先頭の AWS credentials expired or invalid です。
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 authentication failed

AWS プロバイダーが 403 を返したか、Amazon Bedrock が 401 を返しました。 Amazon Bedrock は期限切れのセキュリティトークンを 403 として報告しますが、403 は認可の拒否(IAM 権限の不足による AccessDeniedException など)を報告する方法でもあります。Claude Code はこの 2 つの原因を区別できません。 Amazon Bedrock からの 401 も、AWS credentials expired or invalid ではなくここに該当します。Amazon Bedrock は期限切れのトークンを 401 として報告しないためです。そのエンドポイントからの 401 は通常、企業プロキシなど、リクエスト経路上の別の何かから発生します。 認証情報の更新は期限切れのトークンを修正できますが、その他の原因は修正できないため、メッセージには両方が示されます。
中央のアクションヒントはセットアップによって異なります。変わらない部分は先頭の 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 を使用しているかを確認します

Google Cloud credentials expired or invalid

Google Cloud の Agent Platform 用の Google Cloud 認証情報の有効期限が切れたか、拒否されました。リクエストは 401 を返しました。これは Agent Platform が認証情報の期限切れを報告する方法です。 中央のアクションヒントはセットアップによって異なります。変わらない部分は先頭の Google Cloud credentials expired or invalid です。
対処方法:
  • ヒントに認証情報がこの環境によって管理されていると示されている場合、Claude Code を起動したアプリが認証情報を所有しており、ここにあるほかの手順は適用されません。再試行するか、管理者に問い合わせてください
  • CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD を設定している場合は、代わりに Claude Models on Google Cloud(Anthropic managed)の手順に従ってください
  • アプリケーションのデフォルト認証情報で認証している場合は、メッセージに示されている gcpAuthRefresh コマンド、または gcloud auth application-default login を実行してサインインを完了し、再試行します
  • CLAUDE_CODE_SKIP_VERTEX_AUTH を設定して LLM ゲートウェイ経由でルーティングしている場合は、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 に対して汎用的な Please run /login または Failed to authenticate メッセージが代わりに表示されていましたが、これでは Google Cloud 認証情報を更新できません。

Google Cloud authentication failed

Google Cloud の Agent Platform が 403 を返しました。Agent Platform は 403 を、期限切れの認証情報ではなく認可の拒否に使用します。通常は、認証に使用している ID に IAM 権限が不足しているか、プロジェクトでモデルが有効になっていません。 中央のアクションヒントはセットアップによって異なります。変わらない部分は先頭の Google Cloud authentication failed です。
対処方法:
  • ヒントに認証情報がこの環境によって管理されていると示されている場合、Claude Code を起動したアプリが認証情報を所有しており、ここにあるほかの手順は適用されません。再試行するか、管理者に問い合わせてください
  • CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD を設定している場合は、代わりに Claude Models on Google Cloud(Anthropic managed)の手順に従ってください
  • IAM 設定にあるロールが、認証に使用している ID に付与されていることを確認します
  • プロジェクトでモデルが有効になっていることを確認します。モデルへのアクセスをリクエストするを参照してください
v2.1.273 より前は、Agent Platform からの 403 に対して汎用的な Please run /login または Failed to authenticate メッセージが代わりに表示されていましたが、これでは Google Cloud 認証情報を更新できません。

Microsoft Foundry authentication failed

Microsoft Foundry が 401 または 403 を返しました。リクエストの Azure 認証情報が拒否されたか、その背後にある ID が Foundry リソースへのアクセス権を持っていません。/login では Azure 認証情報を発行できません。中央のアクションヒントはセットアップによって異なります。変わらない部分は先頭の Microsoft Foundry authentication failed です。
対処方法:
  • ヒントに認証情報がこの環境によって管理されていると示されている場合、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 に対して汎用的な Please run /login または Failed to authenticate メッセージが代わりに表示されていましたが、これでは Azure 認証情報を更新できません。

Could not load AWS or Google Cloud credentials

Claude Code は、実行されているマシン上で AWS 認証情報プロバイダーチェーンまたは Google のアプリケーションのデフォルト認証情報から使用可能な認証情報を取得できなかったため、リクエストはクラウドプロバイダーに到達しませんでした。· の後の詳細には具体的な原因が示されます。たとえば、期限切れの SSO セッション、Could not load the default credentials として報告されるアプリケーションのデフォルト認証情報の欠如、invalid_grant として報告される取り消されたサインインなどです。
-p を使用した非対話モードおよび Agent SDK では、構造化エラーコードは cloud_credential_error です。v2.1.267 より前は、メッセージには API Error: の後の詳細テキストのみが表示され、構造化コードは server_error または unknown でした。 対処方法:

AWS default-chain credential resolve timed out

AWS のデフォルト認証情報プロバイダーチェーンが 60 秒以内に認証情報を生成しなかったため、Claude Code は解決を停止し、リクエストを失敗させました。このタイムアウトは Could not load AWS or Google Cloud credentials の原因の 1 つです。この失敗はローカルでの認証情報の解決によるもので、リクエストは Amazon Bedrock、Claude Platform on AWS、または Mantle エンドポイントには一度も到達していません。Claude Code はこのエラーを表示する前に認証情報キャッシュをクリアして再試行するため、このエラーが表示された時点で、チェーンは繰り返しの試行でも停止しています。
一般的な原因は、受け取ることのできない入力を待機する 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)を完了します
  • チェーンが実行する対話的なサインインに正当に 60 秒を超える時間が必要な場合(aws-vault のようなラッパーを介した MFA 付きの SSO など)は、CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS でミリ秒単位の上限を引き上げます

Bedrock setup verification timed out waiting for AWS

Bedrock セットアップウィザードの認証情報検証中の AWS への呼び出し(認証情報の検索や ID チェックなど)が、60 秒の制限内に完了しませんでした。ウィザードは待機を停止し、検証ステップを失敗させます。
この数値は設定されている上限を反映しています。デフォルトは 60 秒で、CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS を設定した場合はその値になります。 一般的な原因は、AWS へのリクエスト(SSO トークンの更新を含む)を停滞させるネットワークやプロキシと、画面に表示されない入力をまだ待機している認証情報ヘルパーです。上限を引き上げるのは、ヘルパーが正当により長い時間を必要とする場合のみにしてください。 AWS への単一のリクエストが停滞した場合、そのリクエスト自体のタイムアウトによって失敗することもあり、その場合は同じステップでより短いメッセージが表示されます。
モデル固定ステップで同じタイムアウトが発生した場合、ウィザードはどちらのメッセージも表示せず、代わりにモデルを unreachable としてマークします。 対処方法:
  • 同じシェルで aws sts get-caller-identity を実行します。これもハングする場合、停滞は Claude Code の外部(ネットワーク、プロキシ、または AWS プロファイル内の認証情報ヘルパー)にあります。まずそれを修正してください。
  • ウィザードを開く前に、対話的なサインイン(例:aws sso login --profile myprofile)を完了します
  • AWS プロファイル内の認証情報ヘルパーがプロンプトを表示するのに正当に 60 秒を超える時間が必要な場合は、CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS でミリ秒単位の上限を引き上げます

Cloud gateway session expired

Claude apps gateway 経由でサインインしており、このマシンに保存されているゲートウェイセッションの有効期限が切れて更新できなかったか、ゲートウェイがそのセッションを受け付けなくなっています(たとえば、ゲートウェイの JWT シークレットが置き換えられた後など)。claude を対話的に起動したときにこの行が表示される場合、セッションはゲートウェイからサインアウトした状態で開かれています。
同じ行は、ゲートウェイの認証情報の有効期限が切れ、Claude Code がそれを更新できない場合に、セッションの途中で表示されることもあります。 非対話実行、バックグラウンドセッションやその他の無人セッション、または claude auth 以外の claude サブコマンドでは、ゲートウェイがセッションを受け付けなくなった場合、Claude Code は代わりに次のメッセージを表示して終了します。
対処方法:
  • セッションで /login を実行し、ブラウザでのサインインを完了します
  • 非対話で起動している場合は、同じ環境で claude を起動して /login を実行してから、コマンドを再実行します

Sign-in timed out while waiting for you to continue

Claude apps gateway でのサインイン中に、ゲートウェイがサインインしたアカウントを示し、Claude Code は認証情報を保存する前にその確認を求めました。サインイン自体の有効期限を過ぎても確認画面を開いたままにしており、ゲートウェイはそれを更新できるリフレッシュトークンを発行していなかったため、続行した時点で Claude Code は何も保存しませんでした。
対処方法:
  • もう一度 /login を実行し、サインインの有効期限が切れる前にアカウントを確認します

Gateway refused the request

Claude apps gateway 経由でサインインしており、リクエストが 403 を返しました。ゲートウェイ、またはその背後にあるアップストリームがリクエストを拒否しました。再度サインインしても拒否は変わらないため、メッセージはゲートウェイ管理者への確認を案内します。
対処方法:
  • ゲートウェイ管理者にリクエストの調査を依頼してください。API Error: 以降の末尾部分には、ゲートウェイが返した拒否内容が含まれています
  • 管理者向け:ゲートウェイのアクセス制御ルールは 403 を返し、監査ログにその理由が記録されます。アップストリームによる認可の拒否は、アップストリームのエラーメッセージに従ってそのまま渡されます
v2.1.273 より前は、ゲートウェイセッションでの 403 に対して汎用的な Please run /login または Failed to authenticate メッセージが代わりに表示され、再度サインインしても拒否は解消されませんでした。

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

これらのエラーの多くは、Claude Code からのネットワークリクエストが宛先に届かなかったか、Claude Code と API の間にある何かが戻りのレスポンスを改変したことを意味します。アーカイブの書き込み失敗など、ローカルの原因もある項目では、その本文で説明しています。通常、原因はローカルネットワーク、プロキシ、ファイアウォール、またはクラウド環境のネットワークポリシーにあります。

Unable to connect to API

API への TCP 接続が失敗したか、完了しませんでした。一般的な接続エラーコードの場合、メッセージは失敗の種類を示し、コードを括弧内に残します。
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))。 一般的な原因としては、インターネットにアクセスできない、VPN が api.anthropic.com をブロックしている、必要な企業プロキシが設定されていない、などがあります。 対処方法:
  • 同じシェルから 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 ゲートウェイに接続するを参照してください。
  • ANTHROPIC_BASE_URL がすでにゲートウェイを指しているのに、すべてのリクエストが Connection dropped で終わる場合は、ゲートウェイとその上流が tool search のフィールドを受け付けることを確認してください。デフォルトでは、Claude Code は defer_loading ツールフィールドと tool_reference ブロックを、それらを有効にする anthropic-beta ヘッダーとともに送信します。v2.1.304 より前は、ENABLE_TOOL_SEARCH でオンにしない限り、ゲートウェイの背後では tool search はオフでした。
  • ファイアウォールがネットワークアクセス要件に記載されたホストを許可していることを確認します
  • 断続的な失敗は自動的に再試行されます
curl は成功するのに Claude Code が失敗する場合、原因は通常ネットワークそのものではなく、ランタイムとネットワークの間にあるものです。
  • echo $ANTHROPIC_BASE_URL(PowerShell では echo $env:ANTHROPIC_BASE_URL)を実行して ANTHROPIC_BASE_URL が設定されているかどうかを確認し、設定ファイルの env ブロックにも含まれていないか確認します。これが設定されていると、Claude Code はモデルリクエストを api.anthropic.com ではなくそのアドレスに送信します。そのため、すでに動作していないローカルのプロキシやゲートウェイを指す値が残っていると、curl は API に到達できても Connection refused が発生します。シェルプロファイルや設定からこれを削除し、新しいターミナルから Claude Code を起動してください。
  • Linux と WSL では、/etc/resolv.conf に到達できないネームサーバーがないか確認します。特に WSL は、ホストから壊れたリゾルバーを引き継ぐことがあります。
  • macOS では、切断またはアンインストールされた VPN クライアントがトンネルインターフェイスやルーティングルールを残していることがあります。ifconfig で古い utun インターフェイスがないか確認し、システム設定で VPN のネットワーク拡張機能を削除してください。
  • Docker Desktop や同様のコンテナランタイムは、送信トラフィックを横取りすることがあります。これを原因から除外するには、それらを終了してから再試行してください。

Unable to connect to Anthropic services

初回セットアップ時、Claude Code はサインイン手順を表示する前に、api.anthropic.com と platform.claude.com に到達できることを確認します。いずれかの確認が失敗すると、Claude Code は理由を出力して終了します。
Claude Code はこの確認を API リクエストと同じプロキシ設定経由で送信し、各プローブに 10 秒を与えます。失敗したプローブがプロキシを経由していた場合、メッセージにはそれを設定した環境変数(HTTPS_PROXY など)が示されます。v2.1.222 より前は、この確認はタイムアウトのない別のプロキシトランスポートを使用していました。そのため、https:// スキームのプロキシ URL の背後では、同じプロキシ経由の API リクエストが成功するにもかかわらず、Checking connectivity... で無期限に停止した後に失敗することがありました。 管理設定ファイル、MDM ポリシー、またはポリシーヘルパーが forceLoginMethod を "gateway" に設定している場合、または forceLoginMethod なしで forceLoginGatewayUrl を設定している場合、Claude Code はこの確認をスキップします。いずれの設定でも、Claude Code は Anthropic のサインイン方法ではなく Cloud gateway 画面でサインイン手順を開きます。また、マシン上に管理設定のソースが存在するものの読み取れない場合も、そのソースがゲートウェイ設定を保持している可能性があるため、Claude Code は確認をスキップします。v2.1.247 より前は、この設定でも Claude Code は確認を実行し、Anthropic のエンドポイントに到達できない場合にこのエラーで終了していました。 管理設定のないマシンで、ユーザー自身の ~/.claude/settings.json が forceLoginMethod と forceLoginGatewayUrl でゲートウェイを指定している場合も、Claude Code は確認をスキップします。v2.1.295 より前は、その場合も Claude Code は確認を実行していました。 対処方法:
  • メッセージがプロキシ変数を示している場合は、その値が正しいプロキシを指していることを確認し、メッセージに示されたホストへの HTTPS 接続をそのプロキシ経由で許可するようネットワークチームに依頼してください。ネットワーク設定を参照してください。
  • Unable to connect to API の確認事項を順に実施します。そこにある curl テストとファイアウォールに関するガイダンスは、この確認にも当てはまります。
  • ネットワークが開放されているのに失敗が続く場合は、Claude Code がお住まいの国で利用できない可能性があります

Socket is closed

Socket is closed は、ストリーミングレスポンスを運んでいた接続が、レスポンスの到着中に閉じられたことを意味します。最も一般的な原因は、Windows 上の企業プロキシが確立済みのトンネルをレスポンスの途中で切断することです。 レスポンスがどこまで進んでいたかに応じて、Claude Code はリクエストを再試行するか、Claude が生成した内容を保持するか、ターンを終了します。自動再試行を参照してください。 v2.1.214 より前は、Claude Code はこの失敗を再試行せず、ターンは Socket is closed を含むエラーで停止していました。 対処方法:
  • このエラーが表示された場合は、claude update で v2.1.214 以降に更新してから、メッセージを再送信してください
  • 更新後も同じプロキシの背後でターンが失敗し続ける場合は、Unable to connect to API の確認事項を実施し、ネットワーク設定でプロキシの設定を確認してください

API returned an empty or malformed response

失敗したストリーミングリクエストに対する非ストリーミングでの再試行が HTTP の成功ステータスを受け取ったものの、本文が Claude API のメッセージではなかった場合に、Claude Code はこのエラーを表示します。よくあるのは、HTML のエラーページやサインインページ、空の本文、または別の形式の JSON です。通常の発生源は、API の代わりに応答したプロキシ、ゲートウェイ、またはネットワークのサインインページです。Claude Code はリクエストを再試行せず、ターンはこのエラーで終了します。
この冒頭部分に続いて、メッセージは何が返ってきたか、どのリクエストが失敗したかを報告します。
  • コンテンツタイプ、本文の種類(body is an HTML page や empty body など)、バイト単位のサイズ、レスポンスに Anthropic のリクエスト ID が含まれていたかどうかを示す Response: 句。レスポンスが nginx や cloudflare など識別可能なサーバーを示している場合、または cf-ray や via などの中継ヘッダーを含む場合は、それらも句に列挙されます。
  • 失敗したストリーミングリクエストの ID と、再試行のきっかけとなった失敗を示す文。失敗の前にストリームが開いていた場合は、届いたストリームイベントの数と、1 つでも届いていれば、試行が失敗した時点でストリームが沈黙していた時間も報告されます。
v2.1.234 より前は、メッセージは intercepting the request の後で終わっていました。 v2.1.271 より前は、text/plain など JSON 以外のコンテンツタイプで有効な API メッセージを返した応答でも、ターンはこのエラーで終了していました。一部の LLM ゲートウェイは、非ストリーミングの応答にそのコンテンツタイプを使用します。 対処方法:
  • Response: 句を読んで、どのシステムが応答したかを確認します。HTML の本文、Anthropic のリクエスト ID がない、または nginx や cloudflare などのサーバー名が示されている場合は、Claude Code と API の間にある何かが API の代わりに応答したことを意味します
  • LLM ゲートウェイを経由している場合は、直接リクエストでルートをテストし、API 以外のレスポンスを返しているホップを修正します
  • ゲスト Wi-Fi などサインインページのあるネットワークでは、ブラウザーでサインインを完了してから再試行します
  • ゲートウェイ経由の非ストリーミングのルートだけが壊れている場合は、CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 を設定してこのフォールバックをオフにします。ただし、ストリーミングのエンドポイント自体が 404 を返す場合は、Claude Code は引き続きフォールバックします

Streaming response ended before any complete data was received

モデルプロバイダーからのストリーミングレスポンスが、使用可能なデータを何も届けずに完了したため、Claude Code はターンを完了するためにストリーミングなしでリクエストを再送信しました。Claude Code はこの警告を、対話型セッションでのみ、セッションごとに 1 回表示します。v2.1.239 より前は、Claude Code は何も表示せずにストリーミングなしで再試行していました。
Claude Code は影響を受けた各リクエストを 2 回送信します。空のストリーミング試行と再試行です。通常の原因は、戻りのストリーミングレスポンス本文を消費または変換するプロキシやゲートウェイです。 対処方法:

Bedrock streaming response has an unexpected content-type

Claude Code と Amazon Bedrock の間にあるゲートウェイまたはプロキシが、ストリーミングレスポンスの本文またはその Content-Type ヘッダーを変換しています。Amazon Bedrock はレスポンスを application/vnd.amazon.eventstream としてストリーミングします。Claude Code は、読み取れない本文をデコードする代わりに、異なる content-type を報告する成功したストリーミングレスポンスを拒否します。Claude Code はリクエストを再試行しません。
v2.1.208 より前は、同じ設定ミスは、レスポンス全体がバッファリングされた後に API Error: Truncated event message received として表面化していました。 対処方法:
  • InvokeModelWithResponseStream のレスポンス本文とその Content-Type ヘッダーを変更せずに通過させるようゲートウェイを設定します。ストリームを server-sent events として再送出する中継装置がよくある原因です。
  • CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 を設定するとこのエラーは表示されなくなりますが、Claude Code は書き換えられたヘッダーの下にあるバイナリ本文をデコードしないため、それらのリクエストは低速な非ストリーミングの経路にフォールバックします。ゲートウェイまたはプロキシの背後でのストリーミングエラーを参照してください。

SSL 証明書エラー

ネットワーク上のプロキシまたはセキュリティアプライアンスが独自の証明書で TLS トラフィックを傍受しており、Claude Code がそれを信頼していません。
v2.1.273 より前は、どちらのメッセージも Check your proxy or corporate SSL certificates で終わっており、OpenSSL のコードや NODE_EXTRA_CA_CERTS のヒントは含まれていませんでした。 v2.1.199 以降、証明書の検証失敗は再試行されないため、このエラーは再試行の上限をすべて使い切った後ではなく、最初の試行で表示されます。以前のバージョンでは、表示するまでに数分間再試行していました。ハンドシェイクのタイムアウトなど、一時的な TLS の状態は引き続き再試行されます。 /login と起動時の接続確認では、同じ失敗で別のメッセージが表示されます。
Amazon Bedrock では、STS や SSO のロール認証情報の呼び出し、モデルの検出、セットアップウィザードの確認など、Claude Code 自身が AWS に送信するリクエストも同じ証明書設定に依存します。TLS を検査するプロキシの背後での証明書エラーを参照してください。 対処方法:
  • 組織の CA バンドルをエクスポートし、NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem で Claude Code にそれを指定します
  • 詳しいセットアップ手順についてはネットワーク設定を参照してください
  • 証明書の検証を完全に無効にする NODE_TLS_REJECT_UNAUTHORIZED=0 は設定しないでください

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

クラウドセッションまたはクラウドのスケジュールタスクでは、403 や ENOTFOUND などの DNS エラーは、要求したホストがクラウド環境の許可リストに含まれていないことを意味する場合があります。確認するには、そのリストとホストを照合してください。このヘッダー付きの 403 はブロックを裏付けますが、ブロックされたリクエストの 403 すべてにこのヘッダーが付くわけではありません。
宛先の実際の証明書と一致しない TLS 証明書が表示されることもあります。クラウドセッションは送信トラフィックをネットワークポリシーを適用するプロキシ経由でルーティングするため、証明書が一致しない場合は、宛先ではなくプロキシが接続を終端したことを意味します。 このエラーはクライアント側のネットワークの問題ではありません。クラウドセッションとクラウドのスケジュールタスクはサンドボックス化された VM 内で実行され、セッションのネットワークを通る送信トラフィックはクラウド環境の許可リストでフィルタリングされます。
  • GitHub とコネクタのトラフィック: GitHub の操作と MCP コネクタのトラフィックは別のチャネルを使用するため、他のホストがブロックされていても動作し続けることがあります
  • Default 環境: Default 環境は、Allow package managers がチェックされた Limited アクセスを使用します。そのセッションは、パッケージレジストリ、クラウドプロバイダーの API、コンテナレジストリ、一般的な開発用ドメインからなるデフォルトの許可リストに到達できます。
対処方法: これらの手順は、ユーザー自身の環境のいずれかを変更するものです。組織共有環境はセレクターで読み取り専用として開くため、管理設定の Cloud environments ページからネットワークアクセスを変更するよう Owner に依頼してください。 アクセスレベルとデフォルトの許可リストについてはネットワークアクセスを参照してください。ローカルの CLI セッションはこのポリシーの影響を受けません。

The proxy refused the connection

このメッセージは、Claude が HTTPS_PROXY または関連するプロキシ変数で設定したプロキシ経由でアーティファクトを読み取るときに表示されます。アーティファクトのコンテンツは *.frame.claudeusercontent.com から取得されるため、Claude Code はまずプロキシに CONNECT リクエストを送信し、そのホストへのトンネルを開くよう求めます。プロキシが拒否するとホストには何も届かず、メッセージにはプロキシの HTTP ステータスが含まれます。
このステータスは、CONNECT に対するプロキシの応答です。ホストは一度も応答していないため、ステータスごとに異なる修正が必要です。
  • HTTP 407: プロキシが必要とする認証情報を受け取っていません。Basic 認証に示すように、認証情報をプロキシ URL に含めてください。
  • HTTP 403: プロキシが *.frame.claudeusercontent.com へのトンネリングを拒否しています。ネットワークアクセス要件に記載されているそのホストを許可するよう、プロキシの運用担当者に依頼してください。
  • HTTP 502 などその他のステータス: ホストに到達できなかったなど、プロキシ自身の理由でトンネルが開かれませんでした。プロキシのログでそのステータスを調べてください。
  • ステータスの代わりに unreadable reply: プロキシのアドレスにあるものが HTTP ステータス行で応答しませんでした。そのアドレスが HTTP プロキシであることを確認してください。
対処方法:
  • プロキシ設定の説明に従ってプロキシ変数のアドレスと認証情報を確認し、Claude Code を起動するシェルから、ユーザー自身のプロキシ URL を使って curl -x http://proxy.example.com:8080 -I https://api.anthropic.com を実行します。Windows PowerShell では curl.exe を実行します。このプローブが同じように失敗する場合は、まずプロキシの設定を修正してください。成功する場合、拒否はアーティファクトのホストに固有のものです。
  • ネットワークで Claude Code がアーティファクトのホストに直接到達できる場合は、NO_PROXY に .frame.claudeusercontent.com を追加します。エントリーはこの範囲に絞ってください。より広い .claudeusercontent.com というエントリーは bridge.claudeusercontent.com についてもプロキシをバイパスしてしまいますが、IP 許可リストを使用している組織は、このホストをプロキシ経由のままにしておく必要があります。
v2.1.238 より前は、Claude Code は拒否されたトンネルを一般的なネットワークエラーとして報告していました。

The cloud environments service returned an empty or unexpected response

Claude Code は、CLI からクラウドセッションを作成するときや /remote-env を実行するときなど、いくつかの時点でクラウド環境の一覧をリクエストします。サーバーの応答を読み取れない場合、次のいずれかのメッセージが表示されます。
サーバーはリクエストを受け付けましたが、環境の一覧ではない本文(空、JSON ではない、または一覧を含まない JSON)で応答しました。これは通常、サービス側の障害に伴って発生し、自然に解消します。一覧をリクエストしたサーフェスによっては、Claude Code がプレフィックスを付けることがあります(/remote-env ダイアログでの couldn't list environments: など)。 対処方法:
  • 操作を再試行します。Claude Code は毎回一覧を改めてリクエストします
  • メッセージが繰り返し表示される場合は、status.claude.com で進行中のインシデントを確認してください
v2.1.236 より前は、Claude Code はこれらのメッセージの代わりに生の JavaScript の TypeError を表示していました。

Failed to fetch session from Sessions API

このメッセージは、Claude Code がターミナルに取り込むよう指示されたクラウドセッションを見つけたものの、Anthropic のサーバーからその会話履歴を読み取れなかったため、セッションを開かなかったことを意味します。
これは claude --teleport、/teleport の後、または /tasks の一覧でセッションを選択した後に表示されます。claude --teleport <session-id> はこれを出力して終了コード 1 で終了します。 対処方法: v2.1.296 より前は、Claude Code は失敗した読み取りを再試行せず、失敗した後もこのメッセージを出力する代わりに、空の会話でセッションを開いて成功を報告することがありました。

Couldn’t load the history of cloud session

このメッセージは、Claude Code がターミナルに取り込むよう指示されたクラウドセッションを見つけたものの、その会話履歴のリクエストが見つからないという結果で返ってきたことを意味します。
対処方法:
  • メッセージ内のリンクを開いて、ブラウザーでセッションを確認します。そこでは開けるのに、同じ teleport が再びこのように失敗する場合は、問題を報告してください。

Couldn’t reconnect to your Remote Control session

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 を表示します。

Sessions ended while this machine was offline

Claude Code は、マシンが長時間オフラインになり、マシンが提供していた Remote Control 環境をサーバーがクリーンアップした後に、claude remote-control を実行しているターミナルにこのメッセージを表示します。その環境内のセッションは終了しており、再開できません。数値は終了したセッションの数です。
対処方法:
  • このメッセージの下に Claude Code が保持された worktree を一覧表示した場合は、そこからコミットされていない作業を回収します
  • claude remote-control を実行して新しい環境を開始します

Couldn’t share the transcript

セッション品質アンケートなどのアンケートのプロンプトからセッションのトランスクリプトの共有に同意すると、Claude Code はそれを Anthropic にアップロードします。サードパーティプロバイダーの場合、Claude apps gateway のセッションの場合、および Anthropic の認証情報が利用できない場合は、代わりにローカルアーカイブを保存します。このメッセージは、共有が完了しなかったことを意味します。
アップロードは 8 MiB の上限内に収まる必要があります。長いセッションでは、Claude Code は共有内容の一部を段階的に削除します。縮小したバージョンを送信できない場合、またはネットワークエラーやサーバーエラーでアップロードが止まった場合に、このメッセージを表示します。Claude Code が代わりにローカルアーカイブを保存する場合、このメッセージはアーカイブを書き込めなかったことを意味します。 対処方法:
  • /feedback を実行して、何が起きたかの説明とともにトランスクリプトを送信します。環境で /feedback を利用できない場合は、エラーを報告するを参照してください
  • 他のリクエストも失敗している場合は、ネットワーク接続を確認し、Unable to connect to API を参照してください

Couldn’t send feedback

Couldn't send feedback で始まるメッセージは、/feedback、/bug、または /share ダイアログから送信したレポート、またはキューに入ったフィードバックの下書きの受信を、フィードバックサービスが確認しなかったことを意味します。受信されていないものとして扱ってください。コロンの後に組織に関する文が続く場合は、組織がフィードバックを拒否しています。 2 つ目の例は組織による拒否です。
対処方法:
  • サインインしていない: メッセージは : not signed in. Run /login, then retry. と続きます。/login を実行してから、もう一度送信してください
  • 組織による拒否: たとえば : Feedback has not been enabled for your organization. や : Feedback collection is not available for organizations with custom data retention policies. です。その後 7 日間、/feedback は組織のポリシーにより無効化されていると応答することがあります。キューに入った下書きはキューに残り、引き続き予定どおりに期限切れになります
  • 認証情報が拒否された: メッセージは : the sign-in this session uses is not allowed to send feedback または : the server did not accept the credentials this session uses と続きます。Claude Code のプロンプトで /status を実行して、このセッションがどのログイン、トークン、または API キーを送信しているかを確認してください
  • Couldn't send feedback の直後に (request timed out) または (couldn't reach the service): レポートまたはキューに入った下書きをもう一度送信します。ダイアログは入力したテキストを保持しており、キューに入った下書きのメッセージには The draft is still queued. と表示されます。他のリクエストも失敗している場合は、ネットワーク接続を確認し、Unable to connect to API を参照してください。失敗が続く場合は、github.com/anthropics/claude-code/issues でレポートを提出してください
  • Couldn't send feedback の直後に (server returned <status>)、または理由なし: ステータスはサービスのレスポンスコードです。サービス自身のメッセージが送信された場合は、(server returned 403: Access Forbidden) のようにその後に続きます。失敗が続く場合は、github.com/anthropics/claude-code/issues でレポートを提出してください
github.com/anthropics/claude-code の Issue は公開されるため、Issue を作成する際は、コード、トランスクリプト、その他の機密情報を含めないでください。 v2.1.281 より前は、ダイアログが開いている間に Remote Control の Stop またはセッション間の緊急メッセージが届くと、以降のすべての送信がこのメッセージで失敗していました。これらのバージョンでは、ダイアログを閉じて開き直してから、もう一度送信してください。

Feedback payload too large

フィードバックの下書きのレビュー画面に表示されるこのメッセージは、サービスが下書きを受け付けたという確認を Claude Code が得ていないことを意味します。受信されていないものとして扱ってください。下書きは /feedback のキューに残るため、もう一度送信できます。
対処方法:
  • レビュー画面で Send transcript を no に設定してから、下書きをもう一度送信します。詳細を短くしても削減できるのは最大 10 KB のテキストで、これは下書きの詳細に入れられる上限です。

スリープまたは時刻変更中の MCP サーバー接続タイムアウト

このメッセージは、MCP サーバーへの接続がタイムアウトし、その試行中にシステムクロックが先に進んだことを Claude Code が検出したことを意味します。
Claude Code はコンピューターがスリープしたのか、時刻が先に進められたのかを判別できないため、メッセージでは両方を挙げています。 対処方法: サーバーにもう一度接続し、試行が完了するまでコンピューターをスリープさせないでください。サーバーが接続すれば、修正すべきことは何もありません。
  • 対話型セッションの場合: /mcp を実行し、サーバーを選択して Reconnect を選択します
  • シェルの場合: claude -p、claude mcp list、または claude mcp get コマンドをもう一度実行します。その後サーバーが Skipping connection (recent failure cached で始まるメッセージで失敗した場合は、15 分待ってからコマンドをもう一度実行してください。
  • Agent SDK アプリケーションの場合: TypeScript では reconnectMcpServer()、Python では ClaudeSDKClient.reconnect_mcp_server() を呼び出します
  • サーバーが再び失敗した場合: メッセージがこれと異なる場合は、MCP サーバーが接続しないときに確認することを参照してください。コンピューターがスリープせず、時刻も変更されていないのにこのメッセージが再び表示される場合は、エラーを報告するを参照してください。
v2.1.307 より前は、Claude Code はこのメッセージの代わりに MCP server "<name>" connection timed out after <N>ms のようなタイムアウトメッセージを表示していました。

リクエストエラー

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

Prompt is too long

会話と添付ファイルがモデルのコンテキストウィンドウを超えています。
対話セッションでは、Claude Code はこのエラーを次のように表示します:
DISABLE_COMPACT が設定されている場合、この行は /clear のみを表示します。下記のコンテキスト圧縮失敗形式などのエラーの長い形式では、Prompt is too long · という表現が保持されます。-p 出力とトランスクリプトでは、テキストは Prompt is too long のままです。 ユーザー設定で自動圧縮をオフにした場合、この行には次のように表示されます:
/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 はトークンを認識しなかったため、自動圧縮はトリガーされませんでした。 このターンで自動圧縮が実行され、モデルが利用できないか認証失敗などの基礎となるエラーで失敗した場合、メッセージはセパレータの後にそのエラーを示します:
示されたエラーを最初に解決してください。/compact は解決するまで同じエラーで失敗します。v2.1.229 より前では、失敗した自動圧縮は原因なしで Prompt is too long を表示していました。 このエラーで自動圧縮が実行される場合、通常は最も古いやり取りを要約し、最新のものを保持します。最後の手段として、Claude Code は異なる方法で要約します:
  • やり取り全体を要約できない場合、Claude Code は最新のプロンプトをそのまま保持し、その前のすべてを要約します。
  • その場合、会話がユーザーのプロンプトで終わらないときは、Claude Code は代わりに会話全体を要約します。
引き継ぐコンテンツにモデルの応答が含まれず、ユーザー自身のテキストが約 1,000 トークン未満である場合(大きすぎる貼り付けの後に送信した短い再試行など)、Claude Code はこの復旧をスキップします。/clear を実行して新しく開始してください。v2.1.269 より前では、やり取り全体を要約できない場合は常に圧縮が失敗したため、その状態のセッションはすべてのターンでこのエラーに再度ヒットしました。 単一のやり取りからなる会話には、要約する以前のターンがありません。そのような会話で自動圧縮が実行されるはずだった場合、Claude Code は試行をスキップし、代わりにリクエストを何が占めているかを説明します。API がエラーでトークン数を報告しない場合、メッセージは次のようになります:
API がエラーでトークン数を報告する場合、Claude Code はそれらを会話のサイズの独自の推定値と比較して、リクエストの大部分が何であるかを判断します:会話独自のコンテンツか、あるいは Claude Code が会話とともに送信するシステムプロンプト、ツール定義、添付ファイルコンテンツか。会話独自のコンテンツがリクエストの大部分である場合、メッセージは次のようになります:
リクエストの大部分が会話外にある場合、メッセージは次のようになります:
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 メモリファイルをトリミングするか、パススコープルールに指示を移動して、関連する場合にのみ読み込むようにしてください
  • 自動圧縮はデフォルトでオンであり、通常このエラーを防ぎます。/config または DISABLE_AUTO_COMPACT でオフにした場合は、オンに戻してください。オフのままにする場合は、ウィンドウが満杯になる前に /compact を自分で実行してください。
  • Claude Code がモデル ID を認識しないと警告した場合、その警告には Claude Code が想定したウィンドウが示されることがあります。モデルの実際のウィンドウが異なる場合は、Claude Code に実際のウィンドウを指定してください。
    • カスタムの ANTHROPIC_BASE_URL を使用していて、エラーが Prompt is too long · automatic compaction failed で始まる場合は、モデルのコンテキストウィンドウを設定するか、v2.1.299 以降に更新してください。v2.1.299 より前は、Claude Code はリクエストを送信する代わりに、想定された 200K ウィンドウ付近でそのメッセージを出してターンを終了していました。
  • Claude が会話を圧縮している最中に停止した直後にこのエラーが表示された場合、会話は変更されておらず、まだ圧縮が必要な大きさのままです。/compact を実行してから、メッセージを再送信してください。エラーの再発を防ぐには、Claude Code を v2.1.304 以降に更新してください。v2.1.304 より前は、そのタイミングで停止するとターンがこのエラーで終了することがありました。
  • v2.1.305 では、多数の MCP ツールを使用し、Anthropic API に直接接続している場合、このエラーによって API からの無関係な 400 または 422 エラーが隠れることがあります。元のエラーを確認するには、Claude Code を v2.1.306 以降に更新してください。
コンテキストウィンドウを探索して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。

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

会話がモデルのコンテキストウィンドウを超えて大きくなると、/context は出力の先頭にこの警告を表示します。
Context exceeds の警告が表示された後、自動圧縮がオン(デフォルト)であれば、どちらのコマンドも実行する必要はありません。
  • 自動圧縮がオンの場合: 次のメッセージを送信します。それでも Prompt is too long で失敗する場合は、その項目を参照してください。
  • 自動圧縮がオフの場合: セッション内で、警告に /compact が示されていればそれを実行するか、/clear を実行して最初からやり直します。どちらかを実行するまで、メッセージは Context limit reached(-p の出力では Prompt is too long)で失敗します。
超過した制限が 1M コンテキストモデルの 200K 境界などの圧縮ウィンドウである場合、警告は異なる表現になります。圧縮ウィンドウはモデルのコンテキストウィンドウより小さい場合があるため、それを超えたリクエストでも成功する可能性があります。
DISABLE_COMPACT を設定した場合、どちらの形式も /compact の代わりに /clear を示します。 対応方法:
  • コンテキスト圧縮ウィンドウの警告の後: 複数ターンの会話では、/compact を実行して以前のターンを要約し、空き領域を確保します。代わりに新しく始める場合は、/clear を実行します。
  • 使用量を削減するその他の方法については、Prompt is too longを参照してください
v2.1.216 より前では、/context は 100% を超える使用量を表示し、それが何を意味するか、または復旧方法を説明する警告行がありませんでした。

Request too large

トークン化前の生のリクエストボディが API の 32MB 制限を超えました。通常は、大きな貼り付けコンテンツ、ツール結果、または添付ファイルが原因です。この制限は コンテキストウィンドウとは別です。
リクエストが 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 はそれらをチャンクで読むことができます
  • 画像については、以下の Image was too largeを参照してください

Image was too large

貼り付けまたは添付された画像が API のサイズまたは寸法制限を超えています。
could not be processed and was removed の行は、サイズや寸法の上限を超えた画像など、会話内の画像を API が拒否したことを意味します。 これらのエラーのいずれかが繰り返し発生する場合は、Claude Code を更新してください。古いバージョンでは、次のような理由で画像エラーが繰り返されることがありました。
  • v2.1.299 より前は、多数の画像を含む長い会話で、Claude Code が上限を超えた画像ではなく、最後に添付した画像を削除することがありました。その結果、was removed の行が毎ターン繰り返され、Claude には新しい画像が見えませんでした。
  • v2.1.299 より前は、VS Code、Desktop アプリ、Agent SDK で、Claude の作業中に添付した画像には、他の添付画像に適用されるリサイズが適用されませんでした。それらの画像は元のサイズのまま API に送信されたため、長い会話で画像エラーが繰り返し発生していました。
  • v2.1.166 より前は、貼り付けた画像が会話内に残り、その後のすべてのメッセージで同じエラーが繰り返されることがありました
対応方法:
  • 貼り付ける前に画像をリサイズしてください。API は単一の画像で最長辺 8000 ピクセルまで、コンテキストに 20 枚を超える画像がある場合は 3000 ピクセルまでの画像を受け入れます。
  • 全画面ではなく、関連する領域に絞ったスクリーンショットを撮ってください
  • dimension limit for many-image requests メッセージの場合、メッセージで示されていれば Claude Code のプロンプトで /compact を実行するか、画像の数を減らして新しいセッションを開始します
dimension limit for many-image requests メッセージには、API のエラーで示されたピクセルの上限が表示されます。

Unable to resize image

Claude Code は、API に送信する前に添付画像をダウンスケールできませんでした。
Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、画像をデコードまたはリサイズして API 制限内に収めることができなかったことを意味します。 表示されるエラーでは、これらの例の 2000x2000px の代わりに 2576x2576px など、異なるピクセル制限が示されることがあります。 対応方法:
  • メッセージが画像を変換するよう求める場合は、PNG、JPEG、GIF、または WebP に変換して再度添付してください。Claude Code はファイルヘッダーからこれらの形式の寸法を確認でき、画像をデコードする必要はありません。
  • メッセージが寸法またはサイズ制限を報告する場合は、その制限を下回るように画像をリサイズまたは再圧縮してから添付してください。
  • メッセージが CMYK JPEG、アニメーション WebP、または破損している可能性のあるファイルなどの原因を示す場合は、メッセージが提案する形式で画像を再保存して再度添付してください。

Request rejected as unprocessable by the model

API は、モデルが処理できないものとしてリクエストを拒否しました。メッセージは API 自体のものです。
Claude Code は、拒否されたリクエストから最も古い画像とドキュメントを削除して再送信できます。v2.1.290 より前は、この拒否に対して Claude Code が画像を削除しなかったため、数百枚の画像が蓄積された長いセッションではターンごとにこのエラーで失敗することがありました。 対処方法:
  • 画像やドキュメントを含む会話でメッセージが繰り返し表示される場合は、自分でそれらを削除します。Esc を 2 回押してそれらを追加したターンより前に戻るか、/clear を実行して新しく始めます。

PDF エラー

添付した PDF を処理できませんでした。メッセージはここに非対話形式で表示されます。対話セッションでは、代わりに Esc キーを 2 回押して再試行するよう促します。
対応方法:
  • 大きすぎる PDF については、ファイル全体を添付するのではなく、Read ツールでページ範囲を読むよう Claude に依頼するか、pdftotext などのツールでテキストを抽出して、出力ファイルをパスで参照してください
  • 保護されているか無効な PDF については、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから再試行してください
Claude が Read ツールで PDF からページ範囲を読むとき、読み取りは異なるメッセージで失敗する可能性があります:
ページ範囲の読み取りは pdftoppm でページをレンダリングします。メッセージが提供するコマンドで poppler-utils をインストールするか、他のプラットフォームでは pdftoppm を PATH に配置する poppler ビルドをインストールしてください。どの PDF がページ範囲で読まれるかについては、Read ツールの動作を参照してください。

Extra inputs are not permitted

リクエストを受け取ったエンドポイントが、リクエストのフィールドの 1 つを受け付けない入力として拒否しました。エンドポイントのメッセージにはそのフィールドが示されています。
Claude Code は、context_management やツール検索の defer_loading などのベータ専用フィールドを、それらを有効にする anthropic-beta ヘッダーとともに送信します。ゲートウェイが本文を転送してもヘッダーを削除すると、API は認識できないフィールドを受け取ることになります。ゲートウェイが Anthropic 形式の本文を異なるスキーマを持つアップストリームに転送すると、そのアップストリームがそのようなフィールドを拒否します。ベータヘッダーと本文フィールドのペアでは、両方のケースを説明しています。 対応方法:
  • メッセージに context_management: Extra inputs are not permitted が含まれている場合は、Claude Code をアップデートして v2.1.304 以降にします。アップデート後、Claude Code はこの拒否に対してそのフィールドを除いてリクエストをもう一度送信します。v2.1.304 より前は、Claude Code はこの拒否に対して再試行しませんでした。
  • メッセージが defer_loading または tool_reference を示している場合は、Claude Code を v2.1.305 以降にアップデートしてください。その後、Claude Code はこの拒否に対して、ツール検索フィールドを除いたリクエストをもう一度送信します。
  • ゲートウェイがヘッダーを削除している場合は、anthropic-beta ヘッダーを転送するようにゲートウェイを設定します。ゲートウェイが転送する必要があるものについては、機能のパススルーを参照してください。
  • フォールバックとして、起動前に CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を設定してください。正確なスコープについては プリリリース機能を無効にするで説明しています。
v2.1.302 より前は、ゲートウェイが関与していなくても、このエラーでフィールド diagnostics が示されることがありました。これは、すでに Anthropic API を使用していたセッションが、再起動せずに Amazon Bedrock または Google Cloud’s Agent Platform に移行した場合に発生していました。たとえば、開いたままにしていたセッションは、別の Claude Code ウィンドウで /setup-bedrock を実行すると Bedrock に移行します。これらのバージョンでは、そのセッションで /clear を実行するか、セッションを再起動してください。

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

リクエスト内のツールが、API の JSON Schema 検証に失敗する input_schema を宣言したため、API はリクエスト全体を拒否しました。tools. の後の番号は、検索可能な名前ではなく、リクエストのツールリスト内の失敗したツールの位置です。
最初の形式は、スキーマが有効な JSON Schema draft 2020-12 ではないことを意味します。2 番目は、トップレベルのプロパティ名がメッセージが引用するパターンと一致しないことを意味します。 Claude Code はサーバーのツールを読み込む際に この検証に失敗する入力スキーマを持つ MCP ツールを除外するため、リクエストには通常そのようなツールは含まれません。 フラグ取得がオフになっているデプロイ、またはフラグが一度も届いていないマシンでは、Claude Code はどのツールが拒否されるかをサーバーのログに記録しますが、そのまま送信するため、このエラーが発生する可能性があります。 このエラーは、$schema で draft 2020-12 以外の JSON Schema 方言を宣言するスキーマを持つツールでも発生する可能性があります。Claude Code はこれらのスキーマを JSON Schema メタスキーマに対してチェックしませんが、トップレベルのプロパティ名チェックは引き続き適用されます。 v2.1.216 より前では、どのデプロイでも除外チェックは実行されていませんでした。 対応方法:
  • Claude Code のバージョンが v2.1.300 より前の場合は、シェルで claude update を実行します。v2.1.300 より前は、Claude Code は拒否されたツールのパラメーターを除いてリクエストを再試行することをしなかったため、そのツールを含むすべてのリクエストでこのエラーが繰り返されていました。
  • 無効なスキーマを宣言する MCP サーバーを削除するか、無効にしてください。エラーはツールを位置でのみ示します。v2.1.216 以降では、各サーバーのログで、入力スキーマが拒否されるツールを示す行を確認してください。どのログにもそれが示されていない場合は、サーバーを 1 つずつ無効にしてください。
  • サーバーを保守している場合は、ツールの input_schema を修正してください。スキーマは有効な JSON Schema である必要があり、トップレベルのプロパティ名は 1 ~ 64 文字で、ASCII 文字と数字、_、.、- のみを使用する必要があります。無効な入力スキーマを持つツールを参照してください。

MCP ツール名が 128 文字を超えています

MCP サーバーが、mcp__<server>__<tool> などの完全な名前が API が受け入れる 128 文字を超えるツールを一覧表示しています。Claude Code は そのツールを Claude に送信するツールから除外し、サーバーの他のツールは引き続き機能します。シェルから claude --debug で開始したセッションでは、Claude Code は ~/.claude/debug/<session-id>.txt のデバッグログに次のメッセージを書き込みます:
対応方法:
  • サーバーを保守している場合は、ツールの名前を短くしてください。
  • サーバーが MCP 設定にある場合は、そこでより短い名前(analytics-database の代わりに db など)を付けてください。その後、権限ルールや フック matcher など、古い名前でサーバーまたはそのツールを参照しているものを更新してください。
  • プラグインがサーバーをバンドルしている場合、ツールの完全な名前にはプラグイン名も含まれます。プラグインの保守担当者にサーバー名またはツール名を短くするよう依頼してください。
v2.1.292 より前では、Claude Code はそれでもツールを送信し、API はそのツールを含むすべてのリクエストを API Error: 400 ... tools.N.custom.name: String should have at most 128 characters で拒否していました。

tool_use.name が 200 文字を超えています

会話履歴内のツール呼び出しが、API がリクエストで受け入れる 200 文字の制限を超える名前を含んでいます:
Claude Code は、応答が到着したときと保存された会話を読み込むときに、そのような名前を 200 文字に切り詰めるため、呼び出しは No such tool available ツールエラーで失敗し、会話はこの API エラーなしで続行されます。 対応方法:
  • claude update を実行してから、会話を再開してください。更新されたバージョンはトランスクリプトを読み込むときに長すぎる名前を修復するため、スタックしていた会話が再度機能します。
v2.1.281 より前では、長すぎる名前は履歴に残り、API は /compact や --resume を含む会話を再送信するすべてのリクエストを拒否したため、このエラーが繰り返され、会話はスタックしました。

There’s an issue with the selected model

設定されたモデル名が認識されなかったか、アカウントがそれへのアクセス権を持っていません。v2.1.160 の時点で、末尾のヒント(ここでは対話形式で表示)はサーフェスによって異なります。
対応方法:
  • 対話 CLI:/model を実行して、アカウントで利用可能なモデルから選択してください。
  • 非対話モード(-p):有効なエイリアスまたは ID で --model を渡すか、ANTHROPIC_MODEL を設定してください。このサーフェスではエラーテキストに Run --model が表示されます。
  • Agent SDK:モデルはプログラムで設定されるため、エラーテキストはヒントを省略します。TypeScript で Options の model を設定するか、Python で ClaudeAgentOptions(model=...) を設定し、構造化された model_not_found エラーを処理して、独自の再試行またはモデルピッカーを表示してください。
  • 完全なバージョン付き ID ではなく、sonnet や opus などのエイリアスを使用してください。エイリアスは保守されたデフォルトに解決されるため、古くなりません。モデル設定を参照してください。
  • 間違ったモデルが CLI で戻り続ける場合は、古い ID がどこかに設定されています。優先順位順でモデルを設定できる場所を確認し、古い値を削除してください。
  • v2.1.206 より前は、更新できなくなった期限切れの claude.ai ログインにより、すべてのモデルがこのエラーで失敗していました。これらのバージョンでは /login を実行してください。
  • ANTHROPIC_BASE_URL が LLM ゲートウェイを指していて、すべてのモデルがこのように失敗する場合は、ゲートウェイとそのアップストリームがツール検索フィールドを受け付けることを確認してください。デフォルトでは、Claude Code は defer_loading ツールフィールドと tool_reference ブロックを、それらを有効にする anthropic-beta ヘッダーとともに送信します。v2.1.304 より前は、ENABLE_TOOL_SEARCH でオンにしない限り、ゲートウェイ経由ではツール検索はオフでした。
  • Google Cloud の Agent Platform デプロイについては、Google Cloud の Agent Platform トラブルシューティングを参照してください。

Model is not a recognized model id

モデルの切り替えに渡した文字列は、Claude Code がモデルとして使用できるものではないため、リクエストを送信せずに切り替えを拒否し、セッションは現在のモデルを保持します。Agent SDK の setModel() メソッドでモデルを設定した場合、Desktop app など Claude Code CLI を代わりに実行するアプリがモデルを設定した場合、または Remote Control を通じて接続されたデバイスからモデルを選択した場合に、このエラーが発生する可能性があります。v2.1.200 より前では、Claude Code は文字列を保存し、次のリクエストで There’s an issue with the selected modelとして失敗しました。
この例では、アプリは表示名 Sonnet 5 を送信し、メッセージはそれをスペースなしで繰り返しています。末尾のヒントは、最も近いエイリアスまたはモデル ID を示します。十分に近いものがない場合は、代わりに Run /model to see available models. と表示されます。Desktop app が起動するセッションでは、一致なしの場合のヒントは Switch to a different model. と表示されます。 Agent SDK または Anthropic API 上のアプリを通じて切り替える場合、表示名や空の文字列など、モデル ID になり得ない文字列のみがこのエラーになります。 Remote Control デバイスからモデルを選択する場合、Claude Code はローカルで文字列をチェックします。モデルエイリアス、Claude Code が一覧表示するモデルまたはユーザーが設定したモデル、claude- で始まる ID のいずれでもない文字列は、claud-sonnet-5 などのタイプミスされた ID を含めて、このエラーになります。v2.1.260 より前では、このチェックは Remote Control での選択を対象としていなかったため、認識されない文字列が適用され、次のリクエストで失敗しました。 対応方法:
  • 引数なしで /model を実行してピッカーを開き、アカウントで利用可能なモデルから選択してから、そこに表示されるエイリアスまたは ID を渡してください
  • 新しい Claude Code バージョンでのみサポートされるエイリアスを使用した場合は、claude update を実行するか、代わりにモデルの完全な ID を渡してください。サーバーはそのモデルに最小 Claude Code バージョンを要求する場合があります。Claude Code does not support this modelを参照してください。
  • v2.1.200 より前に保存されたモデルはこのチェックで修復されません。古い値が戻り続ける場合は、モデルの設定に記載されている場所から削除してください。
  • Anthropic API 以外のプロバイダー、またはゲートウェイやカスタム ANTHROPIC_BASE_URL の背後では、空の文字列のみがこのエラーになります。Claude Code は、すべてのプロバイダーでリクエスト時に 認識されないモデルの診断行を書き込むことがあります。

Model not found

モデルを名前で切り替えましたが、Claude Code はその名前のモデルが存在することを確認できませんでした。名前が モデルエイリアスでも Claude Code がローカルで受け入れる別の表記でもない場合、Claude Code は最小限の API リクエストでそれを検証し、このエラーは通常、API エンドポイントの応答です。/model <name> では、スペースを含むものなど、そもそもモデル ID になり得ない名前も同じメッセージになります。
プロバイダー固有のモデル ID を持つプロバイダーでは、メッセージはフォールバックモデルのプロバイダーの ID を示す Try '...' instead 提案を追加する場合があります。 対応方法:
  • 引数なしで /model を実行し、アカウントで利用可能なモデルから選択するか、sonnet などの モデルエイリアスを使用してください。これは保守されたデフォルトに解決されます
  • 完全な ID を入力した場合は、プロバイダーのモデルカタログと照合してください。新しくリリースされたモデルは、プロバイダーまたはリージョンが提供する前に Anthropic API で利用可能になる場合があります。
  • Agent SDK では、setModel() はこのメッセージで失敗し、セッションは前のモデルで実行し続けます。TypeScript SDK では、supportedModels()を呼び出して、切り替えることができるモデルを一覧表示してください。
  • v2.1.265 より前では、/model は opusplan[1m] エイリアス表記もこのエラーで拒否しました。これらのバージョンでは、Claude Code を更新するか、代わりに 設定または --model でモデルを設定してください。

Couldn’t confirm model with the API

Agent SDK の setModel() メソッド、または Desktop アプリなど Claude Code CLI を代わりに実行するアプリを通じてモデルを切り替えましたが、API エンドポイントでモデル ID を確認するリクエストに 15 秒以内に応答がありませんでした。セッションは現在のモデルを維持します。
Desktop app が起動するセッションでは、メッセージは Try again. で終わります。 対応方法:
  • モデルを再度切り替えてください
  • 切り替えが失敗し続ける場合は、Claude Code が API エンドポイントに到達できることを確認してください。ネットワークと接続エラーを参照してください

選択したモデルを確認するときの API エラー

/model <name> でモデルを選択したか、セッションに接続されたアプリが切り替えを要求しました。API は、モデルを検証するために Claude Code が送信する最小限のリクエストを、レート制限やサーバーエラーなど、独自のエントリを持たない理由で拒否しました。セッションは現在のモデルを保持し、メッセージの末尾にそのことが示されます:
メッセージの中央は HTTP ステータスとサーバー独自の説明です。 対応方法:

Claude Opus is not available with the Claude Pro plan

アクティブなサブスクリプションプランには、選択したモデルが含まれていません。
Claude Desktop アプリが実行するセッションでは、メッセージはコマンドを示すのではなく、sign out and sign in again と表示します。 対応方法:
  • /model を実行し、プランに含まれるモデルを選択してください
  • 最近プランをアップグレードしてもこれが表示される場合は、/logout を実行してから /login を実行してください。保存されたトークンはサインイン時のプランを反映するため、claude.ai でアップグレードしても、再認証するまで既存のセッションで有効になりません。
  • 各プランに含まれるモデルについては、claude.com/pricingを参照してください

Claude Code does not support this model

Claude Code バージョンが必要な最小値を下回っているため、API は 400 でリクエストを拒否しました。選択したモデルが新しいバージョンを必要としている(サーバーはモデルごとにチェックします)か、組織のポリシーが新しいバージョンを必要としています。400 にはエラーコード claude_code_version_too_old が含まれ、メッセージはどの最小値が適用されるかを示します。
組織ポリシーの表現は次のとおりです:
API がチェックするバージョンは、リクエストを行った Claude Code バイナリが報告するバージョンです。 対応方法: そのバイナリを更新してから、新しいセッションを開始してください。セルフホスト環境を除き、更新方法はバイナリの入手元によって決まります:
  • stable リリースチャネルで claude update を実行した場合、最新の stable リリースより先には進みません。そのリリースは必要な最小バージョンを下回っている可能性があります。latest チャネルに移行してから、再度更新してください。組織が 管理設定を通じてチャネルまたはバージョンを固定している場合は、管理者に変更を依頼してください
  • モデルごとの表現については、別のモデルに切り替えることで現在のセッションで作業を続けることができます。CLI で /model を実行するか、ストリーミング入力モードで TypeScript SDK の Query オブジェクトの setModel()を呼び出すか、Python SDK の ClaudeSDKClient の set_model()を呼び出してください
  • 組織ポリシーの表現については、続行する前に更新してください

Model is restricted by your organization’s settings

組織の管理者が claude.ai 管理コンソールでこのモデルを無効にしたか、管理設定が availableModels 許可リストまたは deniedModels リストを通じてそれを除外しました。--model、ANTHROPIC_MODEL、または model 設定が制限されたモデルを指定した場合、通知は起動時に表示され、セッションが代わりに使用するモデルを示します。管理設定によってセッションで使用できる許可されたモデルが残らない場合は、管理設定がデフォルトモデルをブロックを参照してください。管理者が claude.ai 管理コンソールでセッションが実行されているモデルを無効にした後、置換通知はセッション中に表示される場合もあります。
制限されたモデルに対して /model <name> を入力すると拒否され、セッションは現在のモデルを保持します。管理コンソールで無効にされたモデルの場合、拒否は Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. と表示されます。管理設定が除外するモデルの場合、Model '<name>' is not available. Your organization restricts model selection. と表示されます。 エージェント、スキル、またはコマンド名で始まる通知は、制限が サブエージェントの要求されたモデルに適用されたことを意味します:サブエージェントは置換モデルで実行され、セッションのモデルは変更されません。v2.1.223 より前では、Claude Code は Agent ツールで起動されたサブエージェントに対してのみ通知を表示していました。 Claude Code は、モデルファミリーエイリアス(opus、sonnet、haiku、fable のいずれか)を、そのファミリーの最新バージョンではなく、そのファミリーへのリクエストとして扱います。Anthropic API および Claude Platform on AWSでは、制限されたファミリーエイリアスは、組織の設定が許可するファミリーの最新バージョンに解決され、置換通知がそのバージョンを示します。Claude Code が /model <alias> を拒否するのは、ファミリーのすべてのバージョンが制限されている場合のみです。v2.1.205 より前では、ファミリーエイリアスは、同じファミリーの古いバージョンが許可されている場合でも、最新バージョンのみに基づいて置換または拒否されていました。 対応方法:
  • /model を実行して、組織が許可するモデルから選択してください。制限されたモデルはピッカーから非表示になります。
  • 制限されたモデルが --model、ANTHROPIC_MODEL、設定ファイルの model フィールド、または サブエージェント、スキル、コマンドの model フロントマターに設定されている場合は、その値を削除または更新して、通知が再度表示されないようにしてください
  • 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼してください。組織のモデル制限を参照してください。

Can’t switch to the default model

Default モデルを選択しました(たとえば、/model ピッカーで Default 行を選択するか、/model default を入力した場合)。Claude Code は切り替えを拒否したため、セッションは現在のモデルを保持します。
コロンの後の表現は、切り替えをブロックしたものを示します:
  • your organization's managed settings block it ... in "deniedModels":管理拒否リストが、Default オプションが解決するモデルをブロックしています
  • your organization allows only the models listed in "availableModels":availableModelsMatch が "exact" に設定された管理 availableModels 許可リストが、Default オプションが解決するモデルを含んでいません
  • Claude Code couldn't read your organization's managed settings to check which models they allow:管理設定を読み取ることができず、Claude Code は未確認のまま切り替えを適用するのではなく拒否します
対応方法:
  • deniedModels と availableModels の表現については、/model を実行して、組織が許可するモデルを名前で選択してください
  • メッセージが示す管理設定を更新するよう管理者に依頼してください
  • couldn't read の表現については、Claude Code を再起動してください。それでも続く場合は、管理者に管理設定を確認するよう依頼してください
代わりに、これらの管理設定の下でセッションが Claude Code can't start メッセージで起動に失敗する場合は、管理設定がデフォルトモデルをブロックを参照してください。

Model switch was blocked by a PreModelSwitch hook

PreModelSwitch フックが、ユーザーまたはクライアントが要求したモデルの切り替えを承認しなかったため、セッションは現在のモデルを保持します。切り替えが入力したコマンドではなく、Agent SDK ホストまたは Remote Control から来た場合、メッセージは Model switch blocked by a PreModelSwitch hook と表示され、ターゲットモデルは示されません。
コロンの後の理由は、何が切り替えを拒否したかを示します:
  • フックが書いた理由: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: v2.1.323 より前の Claude Code は、管理プラグインが提供する PreModelSwitch フックを判別できない場合に拒否します。このフレーズの前のテキストには、失敗した内容が示されます。拒否を止めるには、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 回再試行した後、組織が管理プラグインを持っていない場合でも、セッション内のそれ以降の切り替えを拒否していました。これらのバージョンでは、セッションを再起動してプラグインの読み込みを再度実行してください。

Couldn’t save it as your default

デフォルトとして保存するモデルを選択しましたが(たとえば、/model <name> または /model ピッカーでの Enter)、Claude Code は選択をユーザー設定ファイル ~/.claude/settings.json に書き込むことができませんでした。切り替え自体は適用されたため、現在のセッションは選択したモデルで実行されますが、デフォルトは変更されず、次のセッションは古い値で開始されます。
ファイルパスの後の理由は失敗したものを示します:
  • 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 であると表示していました。

アドバイザーが現在のメインモデルより能力が低いです

アドバイザーモデルがセッションのメインモデルより下位にランク付けされているため、Claude Code は選択を保持しますが、メインモデルのリクエストにアドバイザーを付加しません。
同じ状態を報告する他のメッセージ:
  • 対話セッションでは、Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor という通知が表示されます。
  • 非対話モードで --advisor フラグを付けて起動し、その実行がバックグラウンドセッションでない場合、警告が stderr に出力され、実行はそのまま開始されます。警告は "<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model. です。対話セッションでは、この警告はデバッグログにのみ書き込まれます。
対応方法:
  • より上位のアドバイザーか、より下位のメインモデルを選択してください。アドバイザーモデルを選択するでは、ランキングと各メインモデルで受け入れられるアドバイザーを一覧で示しています。
  • アドバイザーがモデルに助言できる サブエージェントで引き続き使用したい場合は、アドバイザーを設定したままにしてください
v2.1.287 より前では、Claude Code はいくつかの組み合わせを異なる方法でランク付けしていました。Opus 4.7 または Opus 4.8 のメインモデルに Sonnet 5.5 のアドバイザーを組み合わせた場合にこの注記を表示していましたが、この組み合わせは現在受け入れられます。また、現在この注記が表示される一部のアドバイザー(Sonnet 5.5 のメインモデルに対する Opus 4.8 のアドバイザーなど)を付加していました。

thinking.type.enabled is not supported for this model

Claude Code のバージョンが選択したモデルの最小バージョンより古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。
対応方法:
  • 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 以降が必要です。Opus 5.5 には v2.1.280 以降が必要です。Sonnet 5.5 には v2.1.284 以降が必要です
  • stable リリースチャネルでは、更新しても最新の stable リリースより先には進まず、そのリリースはこれらのバージョンより古い可能性があります。latest チャネルに移行してから更新してください
  • アップグレードできない場合は、/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 以降が必要です。Opus 5.5 には TypeScript SDK v0.3.280 以降が必要です。Sonnet 5.5 には TypeScript SDK v0.3.284 以降が必要です

Effort isn’t available with thinking turned off

拡張思考をオフにして、effort レベルを high より上にして実行しました。モデルはその組み合わせを受け入れないため、API はリクエストを拒否しました。
· の後のヒントはセッションによって異なります:非対話セッションでは use --effort high (or the effortLevel setting) と表示され、Claude Desktop アプリが実行するセッションでは you can lower effort to High と表示されます。 対応方法: 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 は設定された effort レベルでリクエストを送信していたため、思考がオフの場合、Opus 5 は high を超えるすべてのリクエストを拒否していました。現在、Claude Code は Opus 5 など、この組み合わせを拒否することがわかっているモデルには代わりに effort high を送信します。

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

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

Response exceeded the output token maximum

Claude の応答が、リクエストで許可された出力トークンの最大数に達し、そこで切り捨てられました。
a request sent without streaming を示す形式は、ストリーミングリクエストが失敗し、Claude Code がストリーミングなしで再送信したことを意味します。この場合、応答は 64,000 出力トークンに制限されます。v2.1.299 より前は、このように再送信されたリクエストで応答が切り捨てられると、このメッセージが表示されずにターンが終了し、応答が完了したかのように扱われていました。 対処方法:
  • 応答が切り捨てられる前に Claude がテキストを書いていた場合は、対話セッションで continue と返信して残りを求めます。そのテキストは会話内に残ります。
  • メッセージで CLAUDE_CODE_MAX_OUTPUT_TOKENS の設定を求められている場合は、値の上限については CLAUDE_CODE_MAX_OUTPUT_TOKENS を、設定場所については環境変数を設定するを参照してください
  • 各応答を上限内に収めるには、1 回の応答につき 1 つのファイルや 1 つのセクションなど、出力を小さな単位に分けるよう Claude に求めます

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

会話履歴が矛盾した状態で API に到達しました。
すべてのバリアントは同じことを意味します:履歴内の tool_use、tool_result、thinking ブロックのシーケンスが、API が期待するものと一致しなくなっています。 対応方法:
  • Opus 4.7 または Opus 4.8 を使用している場合は、最初に claude update を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーすることがあり、/rewind ではそれを解消できません。
  • /rewind を実行するか、Esc キーを 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。チェックポイントがどのように作成および復元されるかについては、チェックポイント機能を参照してください。

Invalid data in redacted_thinking block

会話履歴内の以前のターンに含まれる redacted_thinking ブロックを受け入れられなかったため、API は 400 でリクエストを拒否しました。
Claude Code は会話の以前の思考をリクエストから除外し、1 回再試行するため、セッションはエラーを表示せずに続行されます。v2.1.282 より前では、Claude Code は拒否されたブロックを保持し、それ以降のすべてのターンが同じエラーで失敗しました。 対応方法:
  • v2.1.281 以前を使用していて、すべてのターンがこのエラーで失敗する場合は、claude update を実行してセッションを再開してください
  • エラーが続く場合は、/clear を実行してブロックを含まない会話を開始してください

Unsupported tool content removed

Claude Code が Anthropic API に直接接続し、保存されたセッションを読み込むまたはプレビューする場合、Anthropic API が受け入れないツールコンテンツを削除し、削除されたコンテンツが 2 つの思考ブロックの間にあった場所にこの行を残します:
このようなコンテンツは、Anthropic API 以外のものが API の形式で応答した場合にセッションファイルに入り込みます。典型的には、ANTHROPIC_BASE_URL で設定された、別のプロバイダーのツール呼び出しを変換するサードパーティプロキシです。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 より前のバージョンはコンテンツを削除しません。

role ‘system’ must precede an ‘assistant’ message

システムメッセージが、API が受け入れない会話内の位置にあるため、API は 400 でリクエストを拒否しました:
Claude Code は、リマインダーや添付ファイルのテキストの一部を会話内のシステムメッセージとして送信します。API がその位置を拒否した場合、Claude Code はそのテキストを代わりに通常のユーザーメッセージとして送信して、リクエストを 1 回再試行します。API の同種の配置に関する表現(use the top-level 'system' parameter for the initial system prompt など)にも同じ復旧が適用されます。 それでもエラーが表示される場合、拒否されたシステムメッセージは Claude Code が削除できるものではありません。これは通常、Claude Code と API の間のプロキシまたは LLM ゲートウェイが独自のシステムメッセージを追加したことを意味します。 対応方法:
  • ANTHROPIC_BASE_URL で設定されたプロキシまたはゲートウェイの背後でエラーがすべてのターンで繰り返される場合は、プロキシなしで接続して原因を確認し、その運用者にエラーを報告してください
  • /clear を実行して新しい会話を開始してください。そこでもエラーが再発する場合、原因は保存された会話ではなく、リクエストの経路にあります。
v2.1.280 より前では、Claude Code はこの表現を認識しなかったため、拒否されたシステムメッセージが Claude Code 自体が送信したものである場合にもエラーが表示され、会話のそれ以降のすべてのターンが同じように失敗しました。

Invalid encrypted_content in search_result block

会話履歴に API が復号化できないホスト型 Web 検索コンテンツが含まれているため、API は 400 でリクエストを拒否しました。表現は読み取れないフィールドを示します:
API のホスト型 Web 検索ツールからの結果には、API のみが読み取れる暗号化されたフィールドが含まれています。encrypted_stdout の表現は、そのような結果を読み取ったホスト型コード実行プログラムの出力を示しており、API はこれも暗号化します。API は、別の組織向けに生成されたコンテンツなど、復号化できないコンテンツを再送するリクエストを拒否します。 Claude Code 独自の WebSearch ツールは検索結果をプレーンテキストとして記録するため、これらのブロックは通常、ホスト型 Web 検索を自ら実行したプロキシまたは LLM ゲートウェイを通じて会話に入り込みます。 3 つの Web 検索の表現については、Claude Code は検索呼び出し、結果、引用を送信内容から除外し、リクエストを 1 回再試行するため、セッションはエラーを表示せずに続行されます。encrypted_stdout の表現にはそのような復旧がないため、そのメッセージは引き続き表示されます。v2.1.282 より前では、Claude Code は拒否された Web 検索ブロックも保持し、それ以降のすべてのターンと /compact が同じように失敗しました。 対応方法:
  • v2.1.281 以前を使用していて、すべてのターンが Web 検索の表現のいずれかで失敗する場合は、claude update を実行してセッションを再開してください
  • エラーが続く場合、またはメッセージが encrypted_stdout を示す場合は、/rewind を実行してそのコンテンツを追加したターンの前のチェックポイントに戻るか、/clear を実行してそれを含まない会話を開始してください
  • Claude Code をプロキシまたはゲートウェイの背後で実行している場合は、その運用者にエラーを報告してください

使用ポリシーによる拒否

会話内のコンテンツが 使用ポリシーのチェックをトリガーしたため、API は応答を拒否しました。 メッセージに Details: `[reasoning_extraction]` という行が含まれている場合は、セーフガードが Claude の推論を求めるリクエストを警告しましたを参照してください。 メッセージには、拒否が誤りだと思われる場合にサポートに伝えることができるリクエスト ID とメッセージ ID が含まれています。
メッセージは拒否したモデルを示すか、モデルが記録されていない場合は 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 で別のモデルに切り替えることで拒否が解消される場合もあります。

安全対策がサイバーセキュリティのトピックを警告しました

モデルの安全対策が、会話内のコンテンツをサイバーセキュリティのトピックとして警告しました。メッセージはリクエストを警告したモデルを示します:
メッセージに Details: `[reasoning_extraction]` という行が含まれている場合は、セーフガードが Claude の推論を求めるリクエストを警告しましたを参照してください。 このメッセージは、正当なサイバーセキュリティ作業へのアクセスを付与する Cyber Verification Program にリンクしています。自動モデルフォールバックを備えたモデルは、このリンクを含まない別のメッセージを表示します。Opus 5.5 と Sonnet 5.5 では、そのメッセージは <model>'s safeguards flagged this session で始まります。Claude Code が代わりにモデルを切り替える場合についても、そのセクションで説明しています。 Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、サイバーセキュリティの警告は代わりに 使用ポリシーによる拒否のメッセージになります。 対応方法:
  • 作業にこのコンテンツが必要な場合は、Cyber Verification Program を通じてアクセスを申請してください
  • リクエストがサイバーセキュリティのトピックに関するものではなかった場合は、/feedback を実行して誤検知を報告してください
  • 同じセッションで作業を続けるには、Esc キーを 2 回押すか、/rewind を実行して、警告をトリガーしたターンの前のチェックポイントに戻り、別のアプローチを試してください。チェックポイント機能を参照してください。
表示されたメッセージが代わりに以下のいずれかの文言である場合は、以前のバージョンの Claude Code における同じ警告です。
  • v2.1.219 から v2.1.296 までは、メッセージの最後の文の前に Apply to the Cyber Verification Program to reduce these interruptions. が含まれることもありました
  • 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: で、その後に適用除外フォームへのリンクが続いていました

セーフガードが Claude の推論を求めるリクエストを警告しました

モデルに内部の推論を応答内で再現するよう求めるものとしてセーフガードがリクエストを警告したため、API はリクエストを拒否しました。API はこの 拒否カテゴリを reasoning_extraction と呼び、拒否メッセージには次の行が含まれます:
v2.1.234 より前では、拒否メッセージに Details 行は含まれていませんでした。 対応方法:
  • Claude に思考や推論をそのまま、または固定形式で書き出すよう求める指示(<thinking> セクション、スクラッチパッドセクション、JSON 出力の reasoning フィールドなど)を削除するか、言い換えてください。この指示は、プロンプト内にある場合もあれば、Claude Code がプロンプトとともに読み込むカスタマイズ(CLAUDE.md、スキル、サブエージェントのプロンプト、出力スタイル、MCP ツールの説明など)内にある場合もあります。
  • カスタマイズがトリガーかどうかを確認するには、ターミナルで claude --safe-mode を実行してカスタマイズを無効にしたセッションを開始し、同じプロンプトを送信してください
  • カスタマイズを変更した後は、新しいセッションを開始してください
  • すでに送信したプロンプトを言い換えるには、巻き戻しと要約を参照してください
  • Claude に回答の説明を求めることは引き続き可能です。短い説明、結果の根拠、または実行したアクションの要約を求めてください。Claude の思考の要約を読むには、showThinkingSummaries を参照してください。
  • その他の例や、言い換えたリクエストが引き続き拒否される場合の対応については、Keep reasoning in thinking blocksを参照してください

Output blocked by content filtering policy

API の出力コンテンツフィルターが、Claude が生成していた応答を停止しました。メッセージテキストは API から送られます:
対応方法:
  • 最後のメッセージを言い換えるか、別のアプローチを試してください
  • ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、/rewind を実行してください。チェックポイント機能を参照してください

コマンドラインエラー

これらのエラーは、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 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが何も通知されずに作成されていました。
対処方法:
  • -p または --print を外してください。--bg はプロンプトを位置引数として受け取るため、claude --bg "<task>" で完全なコマンドになります。シェルから新しいエージェントを Dispatch するを参照してください。
  • バックグラウンドセッションを作成せずにプロンプトを非対話モードで実行して結果を出力するには、--bg を外して claude -p "<task>" を実行してください

Couldn’t tell whether --bg is a flag or text

--bg または --background を、バックグラウンドフラグとして意図したのかテキストとして意図したのかを Claude Code が判断できない位置に付けて claude を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:
--background と入力した場合は、この行には代わりに --background が表示されます。 対処方法:

システムプロンプトフラグとそのファイル形式の競合

1 回の claude の呼び出しで --append-subagent-system-prompt と --append-subagent-system-prompt-file を同時に渡したため、claude はセッションを開始せずに終了コード 1 で終了します:
v2.1.283 より前は、--system-prompt と --system-prompt-file、または --append-system-prompt と --append-system-prompt-file を同時に渡した場合も、claude は同じように終了していました。これらの組み合わせは結合されずに競合していたためです。これらのバージョンでは、メッセージには組み合わせたフラグの組が表示されます。 対処方法:
  • フラグの一方の形式だけを残し、もう一方を外してください。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージしてください

Invalid --agents configuration

--agents に渡した値が無効なため、claude はセッションを開始せずに終了コード 1 で終了します。--safe-mode を渡すか CLAUDE_CODE_SAFE_MODE を設定すると、Claude Code は --agents を完全に無視します。--resume または --continue を使用する場合、インライン JSON の値はチェックされずにセッションが開始されますが、ファイルから読み込まれた値は起動のたびにチェックされます。v2.1.242 より前は、Claude Code はそのままセッションを開始していました。
1 行目に続く内容は、値がどのように失敗したかによって異なります。Claude Code は次のチェックを順に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:
  1. 値が { で始まるのに JSON として解析できない場合、または --agents ファイルの内容を解析できない場合、Claude Code は JSON パーサー自体のメッセージを含む invalid JSON: 行を 1 行出力します
  2. 解析はできても、エージェント定義が CLI で定義するサブエージェントのスキーマと一致しない場合、Claude Code は問題ごとに 1 行を出力します
  3. エージェント名が - で始まる場合、Claude Code は <name>: agent names must not start with '-' を出力します
問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを …and N more に置き換えます。 --print を使用する場合、--agents はインラインオブジェクトの代わりに JSON ファイルへのパスも受け付けます。v2.1.281 より前は、--agents はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。たとえば次のものがあります:
  • Error: --agents takes a JSON object, or a file path only with --print (-p): Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、-p を追加してファイルから読み込んでください。
  • Error: --agents file not found: <path>: そのパスにファイルが存在しません。{ で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって崩れたインライン JSON もこのように失敗することがあります。パスまたはクォートを確認して、コマンドを再実行してください。
対処方法:

Cloud sessions cannot be created from a --restricted session

--restricted でセッションを開始すると、Claude Code はそのセッションからクラウドセッションを作成することを拒否します。新しいセッションは制限付きプロセスの外部で実行され、制限モードが適用されないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:
対処方法:
  • 制限付きセッション内でタスクをローカルに実行してください
  • セッションの起動方法を制御できる場合は、--restricted を付けずに新しい claude セッションを開始し、そこからクラウドセッションを作成してください
v2.1.248 より前の Claude Code には --restricted フラグがありません。それ以前のバージョンでは、フラグ自体が不明なオプションのエラーとして拒否されます。

Cloud sessions are disabled by your organization’s policy

組織の allow_remote_sessions ポリシーがオフになっているため、クラウドセッションとそれを使用するコマンドは利用できません:
このメッセージは、ターミナルからクラウドセッションを作成するとき、および /teleport、/remote-env、/web-setup などのクラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドを送信すると代わりに Unknown command が返されていました。 メッセージにこのセッションで使用中の認証情報が示され、末尾が Cloud sessions use your claude.ai login. になっている場合は、Cloud sessions use your claude.ai login を参照してください。Claude Code が組織のポリシーをまったく読み込めなかった場合は、代わりに別のメッセージが表示されます。 対処方法:

Cloud sessions use your claude.ai login

ポリシーによる拒否のメッセージにこのセッションで使用中の認証情報が示され、末尾がこの文になっている場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります:
最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、--cloud や --teleport などを使用してシェルからクラウドセッションを開始、再開、またはメッセージ送信したときに表示されます。v2.1.296 より前は、この場合も組織の管理者に連絡するよう求める形式が出力されていました。

Couldn’t verify your organization’s policy for cloud sessions

これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、クラウドセッションを作成、再開、またはメッセージ送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、次のメッセージが表示されます:
セッション内では、/teleport や /web-setup などのクラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルであれば Cloud sessions aren't available: の形式が出力される場合でもこのメッセージになり、その 2 文目は Check your network connection, then restart Claude Code and try again. となります。 ポリシーのリクエストが失敗すると、メッセージには何が失敗したかが示されます。これは、--cloud や --teleport などのフラグを使用してシェルからクラウドセッションを開始、再開、またはメッセージ送信する場合に該当します。API への経路がない場合は、次のように表示されます:
その他の失敗も同じ書き出しに続けて、HTTP 403 でリクエストを拒否したプロキシ、サーバーエラー、API が受け付けなかった認証情報などの原因が示されます。ANTHROPIC_API_KEY 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその認証情報の名前と、それを解除するよう求める内容が含まれることもあります:
v2.1.296 より前は、これらの失敗でも Couldn't verify メッセージが出力されていました。 対処方法:
  • Couldn't verify メッセージの場合は、ネットワーク接続を確認して再試行してください。セッション内の場合は、先に Claude Code を再起動してください
  • Cloud sessions aren't available: メッセージの場合は、プロキシの確認や、示されている認証情報の解除など、原因に応じた対処を行ってから、コマンドを再実行してください

Nothing was stashed because a folder replaced a tracked file

このメッセージは、チェックアウト内で、以前は git で追跡されるファイルまたはリンクがあった場所にフォルダーが置かれていることを意味します。claude --teleport や /teleport などでクラウドセッションをターミナルに取り込む際に stash オプションを選択した後に表示されます。その状態を stash するとフォルダー内のファイルが削除される可能性があるため、Claude Code は stash を拒否し、チェックアウトとインデックスを変更しないままにします:
対処方法:
  • メッセージのとおり、変更をコミットするかフォルダーを別の場所に移動してから、Teleport を再実行してください

The --json-schema value is not a valid JSON Schema

非対話モードで --json-schema に渡したスキーマが JSON Schema のコンパイルに失敗したため、claude はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマはエラーなしで構造化されていない出力を生成し、format キーワードを使用するスキーマはすべて無効として扱われていました。
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 で拒否します。 対処方法:
  • 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行してください
  • 動作するスキーマとコマンドについては、構造化出力を取得するを参照してください

Settings file exceeds the 2MiB limit

--settings に渡したファイルが 2 MiB を超えているため、claude は起動時にファイルを読み込まずに終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズをチェックせずにファイルを読み込んでいたため、数ギガバイトのファイルや /dev/zero などのデバイスファイルによってメモリが際限なく増加していました。
Claude Code は、通常のファイルではない --settings のパスも同じように拒否します。デバイス、FIFO、ソケットの場合は Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) に続いてパスが表示され、ディレクトリの場合は EISDIR の理由が表示されます。 対処方法:
  • --settings に 2 MiB 未満の通常の JSON 設定ファイルを指定してください。形式については設定を参照してください。

Configuration error in ~/.claude.json

Claude Code は、アカウント情報、MCP サーバー、プロジェクトごとの状態を保持するファイルである ~/.claude.json を解析できませんでした。claude -p のような非対話モードでの起動は、終了コード 1 で終了します。 Claude Code がバックアップを見つけると、出力にその名前が示され、バックアップを元に戻す cp 行が出力されます:
対処方法:
  • 出力に cp 行がある場合: その行をターミナルで実行してください。Windows では PowerShell で実行してください。
  • 出力に cp 行がない場合、または実行後もエラーが再発する場合: ~/.claude.json に設定がまだ残っている場合は、その JSON を修正してください。修正できない場合は、~/.claude/backups/ に別の .claude.json.backup.<timestamp> ファイルがあればそれで上書きするか、ファイル名を変更してください。~/.claude.json にファイルがない場合、Claude Code はデフォルト設定で起動し、ファイルに保持されていた内容は何も引き継がれません。
  • ~/.claude.json に設定が残っていない場合: ~/.claude/backups/ またはホームディレクトリで、設定がまだ残っている .claude.json.corrupted.<timestamp> ファイルを探してください。その JSON を修正してから、~/.claude.json に上書きコピーしてください。見つからない場合や修正できない場合は、設定が残っている .claude.json.backup.<timestamp> ファイルで同じ手順を試してください。いずれにも残っていない場合は、~/.claude.json のファイル名を変更し、claude mcp add で MCP サーバーを再度追加してください。

Claude configuration file was empty and no backup holds anything

起動時のこのメッセージは、示されているファイルが空で、そのファイルの .backup コピーのいずれにも内容がないことを意味します。Claude Code は、そのファイルが保持する内容についてデフォルトで起動しました。settings.json ファイルと .mcp.json は別のファイルです。
対処方法:
  • そのファイルで設定していた内容を再設定してください。たとえば、ターミナルから claude mcp add で user スコープおよび local スコープの MCP サーバーを追加してください。
  • Claude Code から求められた場合は、再度サインインしてください
v2.1.318 より前は、バックアップのない空のファイルは破損として報告されていました。

The current directory no longer exists

シェルが入った後に削除または移動されたディレクトリ(別のシェルが削除した worktree や一時ディレクトリなど)から claude を起動しました。Claude Code は作業ディレクトリを読み取れないため、対話モードと非対話モードのどちらでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code はミニファイされたバンドルソースと生の ENOENT ... uv_cwd スタックを stderr に出力してクラッシュしていました。
原因と対処方法はどちらの形式でも同じです。 権限の変更など、別の理由で 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 は、sudo を付けても Operation not permitted を報告します。 対処方法:
  • ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、claude を再実行してください
  • ディレクトリが同じパスに再作成された場合、シェルは削除されたディレクトリをまだ保持しています。cd "$PWD" を実行するか、ディレクトリから出て入り直してから、claude を再実行してください
  • macOS で EPERM が表示される場合は、Cmd+Q でターミナルアプリを終了して再度開き、そのフォルダーに戻って claude を実行してください。そのフォルダーで ls がまだ失敗する場合は、システム設定 > プライバシーとセキュリティ > ファイルとフォルダ を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを開き直してください

一時ディレクトリが拒否された、または作成できない

macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは CLAUDE_CODE_TMPDIR による上書き先の下に、専用の一時ディレクトリ claude-<uid> を作成します。ディレクトリを作成できない場合、またはそのパスに既に存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに失敗内容を stderr に出力し、終了コード 1 で終了します:
対処方法:
  • could not be created に続いて is full (ENOSPC) が表示される場合は、メッセージに示されているボリュームのディスク容量を空けてください。代わりに your disk quota on the volume holding /tmp is used up (EDQUOT) と表示される場合は、そのボリューム上にある不要になった自分のファイルを削除してください
  • Refusing to use it の形式の場合は、リンク先ではなく示されているエントリ自体を削除してから、Claude Code を再起動してください。owned by uid の形式の場合、削除できるのは管理者またはそのユーザーのみです
  • is not readable の場合は、示されているディレクトリに対して chmod 0700 を実行するか、ディレクトリを削除してから再起動してください
  • いずれの場合も、CLAUDE_CODE_TMPDIR を自分が管理するディレクトリに設定して Claude Code を再起動し、拒否されたパスはそのままにしておくこともできます
v2.1.309 より前は、ボリュームがいっぱいの場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。たとえば ENOSPC: no space left on device, mkdir '/tmp/claude-501' のようなもので、同じ手順で対処できます。

Claude Code could not save because the disk is full

claude -p の実行後に stderr に出力されるこの行は、ディスクがいっぱいであるか、ディスククォータを使い切ったため、Claude Code が実行内容をすべて保存できなかったことを意味します:
text または json 出力の場合、実行は終了コード 1 で終了しますが、回答は既に出力されています。stream-json 出力の場合、実行は通常の終了コードのままで、回答も届きます。 対処方法:
  • the disk is full (ENOSPC): 次回の実行前に、メッセージ内のパスを保持するディスクの容量を空けてください
  • your disk quota is used up (EDQUOT): 次回の実行前に、容量を空けるか、より大きなクォータを依頼してください

Directory couldn’t be resolved to a real location

作業ディレクトリのサブディレクトリに対して /add-dir を実行しましたが、Claude Code はそのディレクトリを実際の場所に解決できませんでした。 作業ディレクトリのサブディレクトリには既にファイルアクセス権があるため、/add-dir はそのスキル、コマンド、エージェントを読み込むだけです。読み込む前に、Claude Code はシンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることを確認します。その場所を解決できない場合、Claude Code は何も読み込まず、次のメッセージを表示します:
対処方法:
  • パスが作業ディレクトリ内の実在するディレクトリを示していることを確認してから、/add-dir を再実行してください
  • このメッセージはファイルアクセスを変更しません。ディレクトリの .claude/ の内容が読み込まれなかったことを報告するだけです
v2.1.261 より前は、作業ディレクトリが /net/<host> の自動マウント上にある場合にも、すべての /add-dir <subdirectory> でこのメッセージが表示されていました。そこでは Claude Code が設計上パスの解決を行わないため、ディレクトリに問題はなく、再試行しても解決しませんでした。

Remote Control 起動時の Workspace not trusted

claude ultrareview が Error: Workspace not trusted を出力した場合は、代わりに claude ultrareview 実行時の Workspace not trusted を参照してください。
信頼していないディレクトリで claude remote-control またはそのエイリアス claude rc を使用して Remote Control のサーバーモードを開始しましたが、コマンドはそのディレクトリを信頼するかどうかを確認できませんでした。たとえば、コマンドの標準入力または標準出力がリダイレクトまたはパイプされているために、ターミナルではない場合です。コマンドは終了コード 1 で終了します:
同じく Error: Workspace not trusted. で始まる 2 つのバリエーションは、ディレクトリを信頼すると有効になる内容を表示するにはターミナルが小さすぎる場合や、ターミナルがサイズを報告しなかった場合に表示されます。ウィンドウを大きくするか通常のターミナルウィンドウに切り替えてから、claude rc を再実行してください。 ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリの信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はそこでは成功しません。
Trust <directory>? の質問に n と答えるか Enter を押すと、コマンドはディレクトリを示す Remote Control did not start メッセージを出力し、終了コード 1 で終了します。claude rc を再実行して y と答えてください。 対処方法:
  • まずターミナルからディレクトリを信頼します。そこで claude を実行してワークスペース信頼ダイアログを承認してから、元のコマンドを再実行します
  • ホームディレクトリにいる場合は、プロジェクトディレクトリに移動してそこで Remote Control を開始してください
v2.1.284 より前は、ターミナル内であってもコマンドは確認を行いませんでした。

claude ultrareview 実行時の Workspace not trusted

信頼していないフォルダーで、claude ultrareview がそのフォルダーを信頼するかどうかを確認できない場合、レビューが開始される前に実行は終了コード 1 で終了します:
たとえば、標準入力または標準出力がターミナルではない場合、サブコマンドは確認できません。claude ultrareview --json > findings.json のように出力をファイルに送ると、標準出力はターミナルではなくなります。 対処方法:
  • スクリプトや CI ジョブでは、--trust-workspace を末尾に付けて、その実行に限りフォルダーを信頼してください: claude ultrareview --trust-workspace。git と Claude Code がフォルダーの git 設定やプロジェクト設定に記載されたプログラムを実行できるようになるため、信頼できるコードに対してのみ付けてください。コードを信頼できないプルリクエストについては、信頼できるブランチからレビューを実行してください。
  • 自分のマシンでは、そのフォルダーで claude を実行してワークスペースの信頼ダイアログを承認してから、元のコマンドを再実行してください
セッション内では、/ultrareview と /code-review ultra が Ultrareview did not start: "<folder>" is not trusted, and this session started without asking whether you trust it で停止することがあります。IS_DEMO を設定せずにそのフォルダーで claude を起動し、ワークスペース信頼ダイアログを承認してから、新しいセッションでコマンドを実行してください。 claude ultrareview からの次の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します:
  • Error: Workspace not trusted. This terminal ...: ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告を表示しきれません。ターミナルを大きくするか、サイズを報告するターミナルを使用してから、claude ultrareview を再実行してください。ホームディレクトリ以外では、そのフォルダーで一度 claude を実行して信頼ダイアログを承認しておくと、以降の実行では確認されなくなります。
  • Error: Workspace not trusted. <folder> is your home directory: ホームディレクトリの信頼は保存されないため、先にそこで claude を実行しても解決しません。代わりにプロジェクトディレクトリで一度 claude を実行して信頼ダイアログを承認した後、そこから claude ultrareview を実行するか、--trust-workspace を末尾に付けてください。
  • No answer in time. に続いて Error: Workspace not trusted: Trust <folder>? [y/N] の質問に 5 分間回答がありませんでした。claude ultrareview を再実行して回答してください。
  • Ultrareview did not start: <folder> is not trusted: Trust <folder>? [y/N] の質問で、たとえば n と答えるか Enter を押して拒否しました。レビューを開始するには、claude ultrareview を再実行して y と答えてください。
  • Ultrareview did not start: `--trust-workspace` takes no value: --trust-workspace の後に、PR 番号や false など、フラグ以外のものが続いています。フォルダーを信頼しない場合は、フラグを付けないでください。この実行に限り信頼する場合は、PR 番号またはベースブランチをフラグの前に置いてください: claude ultrareview 1234 --trust-workspace。
v2.1.309 より前は、claude ultrareview は --trust-workspace を受け付けませんでした。

質問に回答がなかったため Remote Control が開始されなかった

このメッセージは、claude remote-control がメッセージ内で引用されている初回実行時の質問を行い、回答が得られなかったことを意味します:
対処方法:
  • Enable Remote Control?: スクリプトやサービスでは、誰かが回答する前に標準入力が終了します。スクリプトやサービスを実行するユーザーとして、ターミナルで一度 claude remote-control を実行し、y と答えてください。
  • Choose [1/2] (default: 1):: claude remote-control を再実行してスポーンモードを選択するか、--spawn=same-dir または --spawn=worktree を渡して質問をスキップしてください

Not carried over to the sessions Remote Control starts

remote-control 動詞の前に、Remote Control が開始するセッションを制限または設定するグローバルな claude フラグ(--settings、--setting-sources、--permission-mode、--disallowed-tools、--mcp-config など)を付けて Remote Control を開始しました。動詞の前に置いたフラグは、それらのセッションには届きません。そのため Claude Code は開始を拒否し、そのフラグを示します:
--verbose、--model、またはラッパーが挿入する --session-id や --plugin-dir など、破棄しても問題のないグローバルフラグは拒否されません。Claude Code はそれらを無視し、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 は独自のフラグを受け付けず、コマンドは unknown option エラーで失敗していました。

--settings ファイルが原因で Remote Control が開始されなかった

claude remote-control --settings に渡したファイルに問題があります:
対処方法:
  • メッセージが示す問題を修正してから、claude remote-control コマンドを再実行してください

The settings file has changed since Remote Control started

claude remote-control を実行しているターミナルでのこのメッセージは、--settings に渡したファイルの現在の内容ではセッションが開始されないことを意味します:
対処方法:
  • ファイルを現在の内容で使用するには、claude remote-control を停止して同じコマンドを再実行してください。提供していたセッションを戻すには、サーバー停止後にセッションを再開するを参照してください。
  • Remote Control の開始時の設定を維持するには、ファイルの内容を元に戻し、claude remote-control が終了している場合はコマンドを再実行してください

--sandbox or --no-sandbox is not supported by claude remote-control

このエラーは、Remote Control サーバーを開始するコマンドが remote-control の後に --sandbox または --no-sandbox を渡しており、claude remote-control がどちらのフラグも受け付けないことを意味します。サーバーは開始されずに終了コード 1 で終了します:
対処方法:
  • サーバーを自動で開始するスクリプトやサービス定義を含め、コマンドからフラグを削除してから再実行してください
  • サーバーが開始するセッションをサンドボックス化するには、設定ファイルで sandbox.enabled を true に設定して、サンドボックス化をオンにしてください
両方のフラグは v2.1.300 で claude remote-control から削除されたため、以前のバージョン向けに書かれたコマンドにはまだいずれかが含まれている場合があります。

claude import is not yet available in this build

claude import を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは import をプロンプトとして扱い、このメッセージを出力する代わりに対話セッションを開始していました。
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、CLAUDE_CODE_DISABLE_FEATURE_FLAGS、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 サーバーを読み込みません。

Could not read Claude Code config

Claude Code がアカウント情報とプロジェクトごとの状態を保存するファイルである ~/.claude.json を解析できない状態で、claude import を実行しました。このサブコマンドは利用可否を確認するためにそのファイルを読み込みますが、対話セッションが表示する復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルを読み取れない状態で claude import を実行すると対話セッションが開始され、その復旧ダイアログがファイルを処理していました。
対処方法:
  • 引数なしで claude を実行してください。Claude Code は無効なファイルを検出し、リセットを提案します。その後、claude import を再実行してください。
  • 手動で行った編集を残したい場合は、代わりにエディターで ~/.claude.json の JSON 構文を修正してから、claude import を再実行してください

Could not import a server from Claude Desktop

Claude Code は、claude mcp add-from-claude-desktop で選択したサーバーの 1 つを追加できませんでした。コマンドは選択した他のサーバーのインポートを続行し、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。
サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。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 サーバーをインポートするを参照してください。

Cannot add MCP server to the managed scope

--scope managed を付けて claude mcp add または claude mcp add-json を実行しました。このスコープには、組織が managedMcpServers 管理設定を通じて提供するサーバーが含まれます。Claude Code はそれらを管理設定からのみ読み込むため、コマンドはそのスコープにサーバーを書き込めません。
対処方法:
  • 書き込み可能なスコープ(local、user、または project)にサーバーを追加してください。--scope を指定しない場合、コマンドは local を使用します。MCP のインストールスコープを参照してください
  • 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の managedMcpServers にサーバーを追加してください

管理設定でプラグインのサーバーのみが許可されている場合に MCP サーバーを追加できない

組織の管理設定で strictPluginOnlyCustomization が true または mcp を含むリストに設定されている状態で、claude mcp add または claude mcp add-json を実行しました。この設定では、Claude Code は ~/.claude.json や .mcp.json から MCP サーバーを読み込まないため、コマンドは読み込まれることのないサーバーを保存せずに終了コード 1 で終了します:
claude mcp add-from-claude-desktop は、選択した各サーバーをインポートされなかったものとして報告し、このメッセージを理由として示します。/import は追加しようとした各 MCP サーバーについてこのメッセージを報告しますが、見つかった他の項目はインポートします。 v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーが読み込まれることはありませんでした。 対処方法:
  • サーバーを提供するプラグインをインストールしてください
  • 管理者に、サーバーをプラグインで配布するか、リモートの HTTP または SSE サーバーであれば managedMcpServers を通じて提供するよう依頼してください

Can’t read .mcp.json

--scope project を付けた claude mcp add や claude mcp add-json、または claude mcp remove など、プロジェクトの .mcp.json を読み込むコマンドが、現在のディレクトリにあるファイルが通常のファイルではないか 2 MiB を超えていることを検出したため、ファイルを読み込まずにこのエラーで終了します。
v2.1.257 より前は、.mcp.json が FIFO の場合、コマンドは出力なしで永久に待機し、/dev/zero などのデバイスファイルへのシンボリックリンクの場合は、プロセスが強制終了されるまでメモリが増加し続けていました。 対処方法:
  • 現在のディレクトリの .mcp.json に何があるかを確認してください。プロジェクトスコープの形式の通常の JSON ファイルに置き換えるか削除してから、コマンドを再実行してください。

MCP サーバーが保存または削除されなかった

このエラーは、claude mcp add や claude mcp remove などのコマンドが ~/.claude.json に変更を反映できなかったことを意味します。他の Claude Code プロセスがファイルをロックしたままにしていたか、ファイルが読み取り専用であるかサンドボックスによって保護されている可能性があります。
削除の後では、メッセージは was not saved to の代わりに was not removed from、add the server again の代わりに remove the server again となります。local スコープのサーバーの場合、パスの後に、エントリが属するプロジェクトディレクトリが (local scope for /path/to/project) として続きます。 対処方法:
  • 他の Claude Code プロセスが実行中の場合: コマンドはファイルのロックを約 10~20 秒待機した後、書き込まずに中止します。CLAUDE_CODE_CONFIG_LOCK_WAIT_MS を 60000 など、より長い待機時間(ミリ秒)に設定して、同じコマンドを再実行してください。
  • ファイルが読み取り専用またはサンドボックスで保護されている場合: メッセージが示すファイルを書き込み可能にしてから同じ追加または削除コマンドを再実行するか、そのコマンドをサンドボックスの外で実行してください。
v2.1.283 より前は、claude mcp add、claude mcp add-json、claude mcp remove は、変更がファイルに反映されなかった場合でも成功を報告していました。v2.1.318 より前は、メッセージにロックについての記載がなく、Claude Code は CLAUDE_CODE_CONFIG_LOCK_WAIT_MS を読み取っていませんでした。

MCP サーバーが保存または削除されていない可能性がある

user または local スコープのサーバーに対して claude mcp add、claude mcp add-json、または claude mcp remove を実行しましたが、Claude Code は変更を確認するために ~/.claude.json を読み戻すことができませんでした。変更はディスクに反映されている場合もあれば、されていない場合もあります。to confirm the change の後の括弧内に理由が示されます。
削除の後では、メッセージは may not have been removed となり、末尾が then remove the server again if it is still listed となります。理由が the file was not found の場合、サーバーはまだ設定されている可能性があります。 v2.1.283 より前は、変更を確認できなかった場合でもコマンドは成功を報告していました。 対処方法:
  • claude mcp get <name> を実行して、変更がディスクに反映されているかを確認してください。local スコープのサーバーの場合、ローカルスコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行してください。
  • 追加後にサーバーが見つからない場合、または削除後もまだ表示される場合は、同じ追加または削除コマンドを再実行してください。

Server is Anthropic-hosted and doesn’t support local OAuth

サードパーティの ID プロバイダーを通じて認証する、Anthropic がホストするコネクタのホストを URL が指している MCP サーバーに対してサインインを開始しました。これらのホストには、microsoft365.mcp.claude.com、gmail.mcp.claude.com、gcal.mcp.claude.com があります。これらのサインインは claude.ai を通じてのみ機能するため、Claude Code は /mcp パネルと claude mcp login のどちらからも、これらのホストに対するローカルの OAuth フローの開始を拒否します。
対処方法:
  • 同じ URL の claude.ai コネクタを隠してしまわないように、claude mcp remove <name> で自分のエントリを削除してください
  • 削除した後、Claude Code で使用しているアカウントでサインインした状態で、claude.ai/customize/connectors でサービスを接続してください。接続されると、アクティブな認証方法が claude.ai サブスクリプションのログインであれば、コネクタは Claude Code に自動的に表示されます

Server rejected the Authorization header minted by the configured headersHelper

headersHelper が Authorization ヘッダーを提供する MCP サーバーが、接続に対して HTTP 401 または 403 で応答したため、Claude Code は接続の失敗を報告します。ヘルパーが Authorization ヘッダーを提供しているため、Claude Code はそのサーバーについて OAuth にフォールバックしません:
Claude Code は接続を試行するたびにヘルパーを再実行するため、トークンのローテーションの競合など一時的な拒否の後の再試行では、新しい認証情報で成功することがあります。 対処方法: v2.1.248 より前は、ヘルパーが Authorization ヘッダーを提供するサーバーに対しても、Claude Code は OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに、Incompatible auth server: does not support dynamic client registration で失敗することがありました。

MCP サーバーが elicitation 機能を拒否した

Java MCP SDK 0.11.0 から 0.17.0 で構築された MCP サーバーが接続を拒否しました。これらの SDK バージョンは、Claude Code がハンドシェイクで宣言する form および url の elicitation モードを解析できません。メッセージは次のとおりです:
対処方法:
  • サーバーを Java MCP SDK 0.17.1 以降、またはメッセージに示されている Spring AI のリリースのいずれかにアップグレードしてください
  • または、MCP 設定のそのサーバーのエントリに "bareElicitationCapability": true を追加してから、Claude Code を再起動してください。このフィールドは stdio、sse、http、ws のエントリで受け付けられ、Claude Code v2.1.281 以降が必要です
次の .mcp.json エントリは、1 つの HTTP サーバーに対してこのフィールドを設定します:
再起動後、/mcp にはサーバーが接続済みとして表示されます。Claude Code はそのサーバーに対してのみ form モードを宣言するため、サーバーをアップグレードしたらこのフィールドを削除してください。 サーバーが、Unrecognized field "form" を含むものなど、独自のエラーテキストで失敗することもあります。同じ対処方法が適用されます。

MCP permission prompt tool not found

--permission-prompt-tool に渡したツールが、実行で最初に権限の判断が必要になった時点で、接続済みの MCP ツールの中にありませんでした。そのサーバーが接続されなかったか、接続済みのサーバーがその名前のツールを公開していないためです。Claude Code はそれでもプロンプトを送信します。非対話モードの実行は最初のツール呼び出しでこのエラーとともに終了コード 1 で終了するため、リクエストは行われたにもかかわらず回答は生成されません。最初のプロンプトの前に、Claude Code は MCP_TIMEOUT で設定されるサーバーごとの接続タイムアウト(30 秒)まで、そのサーバーの接続を待機します。v2.1.206 より前は、起動時にサーバーの接続完了を待機しなかったため、起動が遅いものの正常なサーバーでもこのエラーが発生していました。
Available MCP tools: の後のリストには、接続されていた MCP ツールが示されます。 対処方法:
  • サーバーが起動して接続を維持していることを確認してください。同じディレクトリで claude mcp list を実行し、サーバーが接続済みとして表示されることを確認してください
  • ツール名が、サーバーが公開する mcp__<server>__<tool> の名前と一致していることを確認してください
  • サーバーの起動に 30 秒を超える時間が必要な場合は、MCP_TIMEOUT を引き上げてください

OAuth callback port is already in use

OAuth でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためにローカルのリスナーを開始します。そのリスナーが必要とするポートが別のプロセスに保持されている場合、サインインはこのメッセージで失敗します。これは主に、MCP_OAUTH_CALLBACK_PORT 変数または --callback-port で固定のコールバックポートを設定している場合に発生します。固定のポートがない場合、Claude Code は利用可能なポートを選択するためです。
Windows では、代わりに netstat -ano | findstr :<port> が提案されます。 対処方法:
  • メッセージのコマンドを実行してポートを保持しているプロセスを特定し、停止するか終了を待ってください
  • 別のプログラムがそのポートを恒常的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方法に応じて MCP_OAUTH_CALLBACK_PORT または --callback-port でそのポートを設定してください
  • その後、たとえば /mcp でサーバーを選択して、サインインを再度開始してください

No available ports for OAuth redirect

OAuth でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためにローカルのリスナーを開始します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。マシン上の何か(セキュリティソフトウェアや、ローカルのリスナーを拒否するサンドボックスポリシーなど)が、127.0.0.1 でのリッスンを妨げています。
v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身が選択したポートをバインドできなかっただけの場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。 対処方法:
  • セキュリティソフトウェアやサンドボックスポリシーが、プロセスによる 127.0.0.1 でのリッスンをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるように許可してください
  • その後、たとえば /mcp でサーバーを選択して、サインインを再度開始してください

origin/HEAD がないと /security-review が失敗する

/security-review は、ブランチと origin/HEAD(origin リモートでどのブランチがデフォルトかを記録するローカル ref)との差分を取ってレビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。
メッセージには、代わりに git log や別の git diff が引用されている場合があります。Git が origin/HEAD を作成するのは、リモートがデフォルトブランチを通知し、フェッチの refspec がそれをカバーしている場合のみです。コミットのあるリモートを完全に git clone した場合はこれに該当します。次のような構成では ref が存在しません:
  • refspec が狭すぎるフェッチを行う、単一ブランチまたは CI のチェックアウト
  • サーバー側の HEAD が、誰もプッシュしていないブランチを指しているリモート
  • origin リモートがないリポジトリ、または一度もフェッチしていないリポジトリ
Claude Code は、動的コンテキストを挿入するすべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。 コマンドの実行前に発生する類似のメッセージもあります:
  • Shell command permission check failed for pattern "...": コマンドの権限チェックで許可されませんでした。各権限モードでどの結果が中止につながるか、また allowed-tools がいつコマンドを事前承認するかについては、挿入されたコマンドの権限チェックを参照してください
  • Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found: スキルのフロントマターが、bash のないマシンで bash を要求しています。Git for Windows をインストールするか、フロントマターを 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 を実行してください。これはリモートにどのブランチがデフォルトかを問い合わせます。リモートが空であるか、HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合、error: Cannot determine remote HEAD で失敗します。その場合は代わりにブランチを明示的に指定してください。クローンがそのブランチをフェッチしない場合、error: Not a valid ref で失敗します。その場合は、先に上記のように refspec を広げてください。
  • リポジトリにリモートがない場合は、git remote add origin <url> でリモートを追加し、ref を作成する前にフェッチしてください。リモートが空の場合は、先に git push -u origin HEAD でブランチをプッシュし、set-head コマンドでそのブランチを指定してください。すると origin/HEAD はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで /security-review には空の差分が表示されます。

スキルまたはコマンド内のシェルコマンドが実行されなかった

No shell command in <name> was run は、そのスキルまたはコマンドファイル内の !`<command>` 動的コンテキストコマンドに、Bash ツールまたは PowerShell ツールが拒否する文字が含まれていることを意味します:
  • どちらのツールでも: タブまたは改行以外の生の制御文字
  • PowerShell ツール: さらに U+FEFF または U+180E
メッセージの末尾には拒否されたコマンドが表示され、拒否された各文字は � として示されます。次は Bash ツールの例です:
対処方法:

4,000,000 文字の上限を超えるスキル、コマンド、またはフック

more than 4,000,000 characters を含むメッセージは、スキル、コマンド、またはプロンプトフックやエージェントフックが実行されなかったことを意味します。長いテキストを引数として貼り付けた場合は、それをファイルに保存し、テキストは会話に残るため /clear を実行してから、そのパスを渡してください。Code Mode の外では、上限を超える PreToolUse のプロンプトフックやエージェントフックは呼び出しをブロックしません。このような上限のないコマンドフックを使用してください。

Input must be provided when using --print

引数なしの claude で対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、またはコンソールが本物のターミナルではない場合(PowerShell ISE や一部の IDE の出力ペインなど)、claude は代わりに非対話モードで実行されます。これはプロンプトを必要とする claude -p と同じモードであるため、フラグを渡していなくてもメッセージには --print が示されます。プロンプトを指定せず、stdin に何もパイプせずに -p/--print を渡した場合も、どこでも同じエラーが発生します。
対処方法:
  • 対話的に使用する場合は、本物のターミナルで claude を実行してください。ISE ではなく Windows Terminal または PowerShell コンソールを、出力ペインではなく IDE の統合ターミナルを使用してください
  • 1 回限りの使用の場合は、プロンプトを渡してください: claude -p "your question"、または echo "your question" | claude -p のようにパイプしてください

Claude Code can’t read the keyboard here

-p を付けずに claude を実行したため対話セッションが開始されましたが、その標準入力がターミナルではありません。何かが標準入力をパイプまたはリダイレクトしたか、claude を起動したプログラムが独自の入力ストリームを渡しています。 対話セッションにはキー入力を読み取るためのターミナルが必要であり、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります。
  • Windows: Claude Code はインターフェースを起動する代わりに、メッセージを stderr に出力してコード 1 で終了します
  • macOS と Linux: Claude Code は /dev/tty からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして扱います。/dev/tty を開けない場合にメッセージが表示され、その 1 行目では Windows の文言の代わりに /dev/tty が示されます。
Windows では、メッセージは次のとおりです。
対処方法:
  • 対話的に作業するには、入力をパイプやリダイレクトせずに、ターミナルで claude を直接実行します
  • スクリプトなどから対話インターフェースなしで応答を得るには、-p を追加し、claude -p "your question" や echo "your question" | claude -p のように、プロンプトを引数または stdin で渡します。--continue や --resume <session-id> でも同じように動作します。
v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを起動し、画面に何も表示しないか、Raw mode is not supported を含むエラーで失敗していました。 claude install の実行中に Raw mode is not supported が表示される場合は、インストール中の Raw mode is not supported を参照してください。

Input contained only whitespace

非対話モードでは、API が可視テキストのないメッセージを拒否するため、Claude Code はスペース、タブ、改行だけで構成されたプロンプトを送信せずに拒否します。表示されるメッセージは、空のプロンプトがどこから来たかによって異なります。
  • 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 input carried over 256M characters with no newline

プログラムが claude -p --input-format stream-json の実行に対して、改行を含まずに 268,435,456 文字を超えるデータを stdin に送信したため、Claude Code はそれ以上入力をバッファリングせずに、このエラーを stderr に出力してコード 1 で終了します。メッセージではこの上限を 256M と表記しています。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリ使用量が増え続けていました。
これほど長い入力に改行がない場合、通常はプロデューサーがそもそも stream-json のプロデューサーではないことを意味します。たとえば、誤ってパイプされたバイナリファイルやプレーンなログ出力などです。上限を超える単一のメッセージも、同じチェックで失敗します。 対処方法:
  • stdin に何がパイプされているかを確認します。--input-format stream-json では、すべてのメッセージが改行で終わる 1 行の JSON でなければなりません
  • 代わりにプレーンテキストを送信するには、--input-format stream-json を外します。claude -p はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります

Unknown command

対話的なターミナルセッションで、このセッションのどのコマンドにも一致しない / 名を送信したため、Claude Code は何も実行せずにその名前を報告します。
Claude Code は、このセッションでメニューに表示されるコマンド名またはエイリアスのうち、最も近いものを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです。 Claude Code が一致しない / 名にこのように応答するのは、対話的なターミナルセッションの場合だけです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示す注記と、Claude がそのセッションで実行できるコマンドの一覧を添えます。これには次のセッションが含まれます。 これらのセッションのいずれかで実行できない組み込みコマンドについては、Claude Code は Claude に送信せずに、そのコマンドが利用できないことを引き続き応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとクラウドスケジュールタスクだけでした。v2.1.273 より前は、それらも Unknown command と応答していました。 Claude Code は、/ で始まるすべてのプロンプトをコマンドとして扱うわけではありません。/ の後の最初の単語が句読点で始まる場合(Lean のドキュメントコメントを開始する /-- など)や、/var/log/syslog のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。 v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている状態で Enter を押すと、Claude Code はその候補を実行していたため、/hepl のようなタイプミスでは、このメッセージが表示される代わりに /help が実行されていました。 対処方法:
  • 提案された名前を実行するか、/ に続けて名前の一部を入力し、このセッションで利用できるものを確認します
  • ドキュメントに記載されているコマンドが不明と報告される場合は、コマンドリファレンスでそのコマンドの行に記載されている要件を確認します

Diff is too large for ultrareview

未コミットの変更やステージ済みの変更を含む、ブランチとベースブランチの間の差分が ultrareview のサイズ上限を超えているため、/code-review ultra と claude ultrareview サブコマンドはクラウドセッションの開始前にレビューを拒否します。拒否されたレビューは無料実行回数を消費せず、使用クレジットも課金されません。メッセージには、適用されている上限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには生の差分統計のみが表示されていました。
プルリクエストのレビューにも同じ上限が適用されます。その場合のメッセージは PR #<N> is too large for ultrareview で始まり、PR のファイル数と行数が示されます。 対処方法:
  • /code-review ultra develop のように、作業に近いベースブランチを渡して、そのブランチに対する差分のみをレビュー対象にします
  • 変更を小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数への寄与が最も大きいため、まずそれらを独自のブランチに移します。

Could not find merge-base with the base branch

/code-review ultra と claude ultrareview サブコマンドは、ブランチとベースブランチの間の差分をレビューします。これには両者が共有するコミットが必要です。git merge-base がそのようなコミットを見つけられない場合、Claude Code はクラウドセッションの開始前にレビューを拒否します。完全であることを Claude Code が確認でき、少なくとも 1 つのブランチを持つクローンでは、拒否する代わりに追跡対象のすべてのファイルをレビューする方式にフォールバックします。この拒否が表示されるのは、ベースブランチがまったく見つからない場合、クローンが完全であることを Claude Code が確認できない場合、または SHA-256 オブジェクト形式のようにツリー全体の差分を取得できないまれなリポジトリの場合です。
最初の文の後のヒントは、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 を実行してからレビューを再実行します

Your checkout has no branches

チェックアウトには、コミットがあってもブランチがない場合があります。git init の後に git fetch <url> と git checkout FETCH_HEAD を実行すると、ref のない detached HEAD になります。Claude Code は ultrareview のためにリポジトリを git bundle としてパッケージ化してアップロードしますが、ブランチやその他の ref がないリポジトリはバンドルできないため、/code-review ultra と claude ultrareview サブコマンドはクラウドセッションの開始前にレビューを拒否します。
v2.1.221 より前は、Claude Code はこのチェックアウト内の追跡対象ファイルをすべてレビューしようとし、アップロードが失敗していました。 対処方法:
  • git checkout -b <name> で現在のコミットにブランチを作成してから、レビューを再実行します

No GitHub account is connected to your Claude account

/code-review ultra <PR#> または claude ultrareview <PR#> を実行しました。Claude Code はクラウドセッションを作成する前に、Claude アカウントに接続された GitHub アカウントが PR のリポジトリにアクセスできるかどうかをサーバーに問い合わせます。アカウントが接続されていないか、接続の有効期限が切れているため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、Claude Code は無料実行回数を消費せず、使用クレジットも課金しません。
セッションで /web-setup を利用できない場合、メッセージには claude.ai のリンクのみが示されます。 対処方法:
  • /web-setup を実行して GitHub CLI のログインを Claude アカウントに接続するか、claude.ai/connect-github でアカウントを接続します
  • 接続してから 1 分後にレビューを再実行します
v2.1.248 より前は、Claude Code は起動前にこれを確認していませんでした。

Your connected GitHub account can’t see the repository

/code-review ultra <PR#> または claude ultrareview <PR#> を実行しましたが、Claude アカウントに接続された GitHub アカウントが PR のリポジトリを読み取れないため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、Claude Code は無料実行回数を消費せず、使用クレジットも課金しません。
セッションで /web-setup を利用できない場合、メッセージにはアプリのインストールのみが示されます。 対処方法:
  • ローカルの gh CLI がリポジトリを読み取れる場合は、/web-setup を実行してそのログインを Claude アカウントに接続します
  • 変更後にレビューを再実行します
v2.1.248 より前は、Claude Code は起動前にこれを確認していませんでした。

The GitHub App preflight failed transiently

ローカルリポジトリからクラウドセッションを開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかどうかを確認しましたが、そのチェックは明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消される可能性のあるエラーで終了しました。完全なメッセージは、Could not upload repo bundle (<error>) のようにバンドルを妨げた原因で始まり、プリフライトの文で終わります。
対処方法:
  • 少し待ってからコマンドを再実行します。GitHub のチェックに合格すると、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗によって起動が妨げられることはなくなります
  • 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば、修正してローカルリポジトリからセッションを開始できるようにします
v2.1.251 より前は、GitHub のチェックが一時的に失敗しただけの場合でも、Claude Code はメッセージを Please set up GitHub on https://claude.ai/code で終えていましたが、セットアップに関する助言では一時的な失敗は解消できません。

The repository upload can’t follow a git setting

ローカルリポジトリをアップロードするクラウドセッション、またはブランチの ultrareview を開始しましたが、ファイルに適用される属性ルールを決定する git 設定のいずれかに、アップロードが従うことができません。アップロードを続行してルールを見落とすと、clean フィルターで暗号化されるファイルのように、git が保存前に変換するファイルが、ディスク上の状態のままクラウドに届く可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードされません。
メッセージには設定名とその設定場所が示され、該当するケースの修正方法で終わります。core.attributesFile と attr.tree についても同じ拒否が表示され、それぞれに独自の修正方法が示されます。 メッセージには、git の設定が include または includeIf ディレクティブを通じて読み込む設定ファイルが示されることがあります。これは、そのディレクティブの条件がこのリポジトリに当てはまらない場合でも同様です。 対処方法:
  • メッセージの最後の文にある修正方法を適用します

GitHub isn’t connected to your Claude account

たとえば /autofix-pr を使用して、ローカルリポジトリからクラウドセッションを開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否します。
/schedule でクラウドスケジュールタスクを作成すると、同じメッセージがリポジトリ名を示すセットアップの注記として表示されます。この注記はタスクの作成を妨げません。 対処方法:
  • /web-setup を実行して GitHub CLI のログインを Claude アカウントに接続するか、claude.ai/connect-github でアカウントを接続します。2 つの方法の違いについては、GitHub 認証オプションを参照してください。
  • 接続してから 1 分後にコマンドを再実行します
v2.1.268 より前は、Claude Code はこれを Claude GitHub App のチェックの一時的な失敗として報告し、再試行またはアプリのインストールを提案していましたが、どちらも GitHub アカウントを接続するものではありません。

A GitHub organization policy is blocking Claude

Claude Code のプロンプトで、/autofix-pr のようなクラウドセッションを開始するコマンドを実行しました。Claude Code はセッションを作成する前に GitHub 上のリポジトリへの Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub が拒否しました。Claude Code はそこで停止し、ポリシーを示すメッセージを表示します。 IP 許可リストがアクセスをブロックしている場合、メッセージは次のとおりです。
シングルサインオンがブロックしている場合、メッセージは次のとおりです。
Microsoft Entra ID の条件付きアクセスポリシーがブロックしている場合、メッセージは次のとおりです。
対処方法:
  • IP 許可リスト: GitHub 組織または Enterprise のオーナーに、Anthropic の送信 IP アドレスを許可するよう依頼します。アドレスと変更する GitHub の設定については、GitHub の許可リストとファイアウォールを参照してください。
  • シングルサインオン: claude.ai/customize/connectors で GitHub の接続を解除してから、再度接続します。GitHub から求められたら、組織の横にある Authorize をクリックして、新しい接続がその組織のシングルサインオンに対して認可されるようにします。
  • 条件付きアクセスポリシー: GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します
  • 変更後、コマンドを再度実行します

Single sign-on authorization needed

/install-github-app を実行し、SAML シングルサインオンを強制している組織のリポジトリを選択しました。セットアップの前に、Claude Code は GitHub CLI でリポジトリへのアクセスを確認しますが、gh トークンがまだその組織に対して認可されていないため、GitHub がその確認を拒否しました。ウィザードは、認可の手順とともに警告を表示します。
対処方法:
  • gh auth refresh -h github.com -s repo,workflow を実行して repo と workflow スコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します
  • GH_TOKEN の個人用アクセストークンで認証している場合は、github.com/settings/tokens を開き、トークンの Configure SSO を選択して組織を認可します
  • /install-github-app を再度実行します
v2.1.273 より前は、この状況では代わりに Admin permissions required の警告が表示されていました。

Failed to resume the conversation

Claude Code は、claude --resume ピッカーで選択したセッションの保存済みトランスクリプトを読み取るか処理できなかったため、部分的に読み込まれた状態で続行せずにプロセスを終了します。メッセージには再試行用のコマンドが含まれます。
Claude Code はメッセージを表示した後、コード 1 で終了します。実行中のセッション内の /resume ピッカーでは、代わりに会話内に Failed to resume conversation と報告され、現在のセッションは実行を続けます。v2.1.216 より前は、claude --resume ピッカーからの再開に失敗すると、このメッセージを表示せずに Resuming conversation… スピナーのまま無期限に止まっていました。 対処方法:
  • メッセージにあるセッション ID を指定して claude --resume <session-id> を実行し、再試行します
  • v2.1.285 より前のバージョンで再試行が同じように失敗する場合は、claude update を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。
  • 再試行が再び失敗する場合は、claude を実行して新しいセッションを開始します

No conversation found with the session ID

claude --resume <session-id> にセッション ID を渡しましたが、一致する保存済みトランスクリプトがありませんでした。
Claude Code はメッセージを表示した後、コード 1 で終了します。Claude Code は、その ID をまず現在のプロジェクトで検索し、次にこのマシン上の他のすべてのプロジェクトで検索します。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開してください。 よくある原因:
  • ID の入力ミス: 非対話的な実行の場合、ID は --output-format json の出力の session_id フィールドです
  • トランスクリプトの削除: Claude Code は、保持期間による削除のルールに従い、保持期間(デフォルトでは 30 日)が過ぎるとトランスクリプトを削除します
  • 別のマシン: Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシン上で再開してください
  • 重複したコピー: ~/.claude/projects 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つようになった場合、Claude Code は一方のコピーを任意に再開するのではなく、このメッセージを報告します
対処方法:
  • 対話セッションの場合は、claude --resume でセッションピッカーを開き、Ctrl+A を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します
  • claude -p や Agent SDK で作成されたセッションはピッカーに表示されないため、元の実行で出力された session_id と ID を照合し直してください

Windows reported an error (EBADF) when Claude Code read this session’s transcript file

Windows でセッションを再開したところ、保存済みのトランスクリプトファイルは正常に開かれたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーは読み取りが失敗した理由を示さないため、メッセージでは考えられる原因と試すべきことが提案されます。
このメッセージは、Failed to resume session <session-id> のようなコマンド自体の失敗行の後に続きます。claude --resume または claude -p コマンドは、メッセージを表示した後にコード 1 で終了します。セッション内で /resume を実行した場合は、現在のセッションが実行を続けます。 対処方法:
  • セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアの対象から、セッションのトランスクリプトを保存するフォルダーを除外します。トランスクリプトはデフォルトでは %USERPROFILE%\.claude\projects 配下、または CLAUDE_CONFIG_DIR が指定するディレクトリ配下に保存されます
  • 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します
  • セッションを再度再開します
v2.1.282 より前は、失敗に説明がありませんでした。claude --resume <session-id> は Failed to resume session <session-id> で終わり、-p での実行では Failed to resume session: EBADF: bad file descriptor, read のようにシステムエラーのテキストのみが出力されていました。

Cannot switch renderers in this session

レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を拒否するセッションで /tui を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります。
  • Cannot switch renderers while work is running in the background: バックグラウンドシェルやサブエージェントなど、再起動によって放棄されることになるバックグラウンド作業が実行中です。作業が終わるのを待つか /tasks で停止してから、/tui fullscreen または /tui default を再度実行します
  • Cannot switch renderers in this session: セッションに、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました
制限に関するメッセージでは、括弧内の部分に Claude Code が検出した制限が示されます。
メッセージの括弧内に表示される可能性のある各理由は次のとおりです。
  • 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 設定を保存します

Can’t restart while work is running or Remote Control is connected

Claude Code は再起動せず、セッションはそのまま実行を続けます。メッセージに示された修正方法に従ってください。

Claude Code couldn’t restart

このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば /tui の実行後にフルスクリーンレンダリングへの切り替えまたはその解除を行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。
新しいセッションで最初の入力が /tui だった場合など、再起動時に再開する会話がなかった場合、メッセージは Claude Code couldn't restart. Start Claude Code again. となります。 対処方法:
  • シェルで claude を再度実行します。メッセージで会話が保存されていると示されていた場合は、新しいセッションで /resume を実行し、その会話を選択します。一覧にない場合は、セッションピッカーの範囲を広げます
  • 再起動が失敗し続ける場合は、シェルから claude --debug-file claude-debug.log で Claude Code を起動します。そのセッションからの再起動が失敗すると、起動したディレクトリの claude-debug.log に、オペレーティングシステムのエラーを含む Failed to relaunch: 行が記録されます。問題を報告する際には、その行を含めてください

Couldn’t open Claude Desktop

セッションで /desktop またはそのエイリアス /app を実行したか、シェルで claude --desktop を実行しましたが、Claude Code が Claude Desktop を開くために使用するシステムコマンドが失敗しました。/desktop の場合、セッションはターミナルにとどまります。claude --desktop は Error: プレフィックスなしでメッセージを出力し、ステータス 1 で終了します。 括弧内のテキストには失敗したコマンドが示され、終了ステータスとエラー出力の 1 行目が生成された場合は、それらも示されます。macOS では、この例のようにコマンドは open です。Windows では rundll32 です。
対処方法:
  • Claude Desktop を自分で開いてから、/desktop または claude --desktop を再度実行します
  • 失敗したコマンドのエラー出力全体を確認するには、/debug でデバッグログをオンにして /desktop を再度実行するか、claude --desktop --debug-file <path> を実行してから、デバッグログを確認します
v2.1.285 より前は、メッセージは Open Claude Desktop and run /desktop again. で終わっていました。v2.1.275 より前は、メッセージは Failed to open Claude Desktop. Please try opening it manually. で、何が失敗したかは示されていませんでした。

/terminal-setup left your Zed keymap unchanged

Zed で /terminal-setup を実行しましたが、Claude Code は Zed の keymap.json の更新を完了できなかったため、ファイルを元のままにしました。 各メッセージにはキーマップへのパスが示され、自分で追加するキーボードショートカットのブロックで終わります。
メッセージの 1 行目に原因が示されます。
  • 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 バックアップファイルを使用します。

Skill usage reports are not available on this connection

スマートフォンやブラウザーから Remote Control 経由で /skill-doctor を実行しました。Claude Code は Remote Control 経由ではスキル使用状況レポートを送信せず、代わりにこのメッセージを返します。
対処方法:
  • セッションが実行されているマシン上のターミナルで /skill-doctor を実行するか、そこで claude -p "/skill-doctor" を実行します

Custom output styles can’t be selected over Remote Control

Remote Control 経由でモバイルアプリまたは Web から /output-style を実行したか、セッションに中継されたメッセージでコマンドが届きました。このようなターンはアカウント所有者からのものではない可能性があるため、Claude Code はそのターンでは組み込みスタイルのみを一覧表示・選択し、コマンドがスタイルを一覧表示するとき、または指定した名前を認識しないときには常にこの通知を追加します。カスタムスタイルの名前には、存在しない名前と同じ応答が返されます。
対処方法:
  • 組み込みスタイルを選択します。例: /output-style concise
  • カスタムスタイルを使用するには、プロジェクトの .claude/settings.local.json で outputStyle を設定するか、セッション自体のターミナルがある場合はそこで /output-style <style> を実行します

Output styles are saved to local settings which this session doesn’t load

設定ソースに local が含まれていないセッションで、/output-style <style> または /config outputStyle=<style> を使って出力スタイルを切り替えようとしました。たとえば、settingSources から "local" が除外されている Agent SDK セッションや、local を除外した --setting-sources の値で開始された CLI セッションです。どちらのコマンドもスタイルを .claude/settings.local.json に保存しますが、このようなセッションはこのファイルを読み込まないため、Claude Code は効果のない設定を書き込む代わりに拒否します。
対処方法:
  • セッションの設定ソースに local を追加してから、再度切り替えます
  • プロジェクトの .claude/settings.json や ~/.claude/settings.json など、セッションが読み込む設定ファイルで outputStyle キーを設定します。TypeScript SDK では、代わりにインラインの settings オブジェクト内で outputStyle を設定します。出力スタイルを有効にするを参照してください

/recap only runs when you ask for it yourself

/recap のリクエストが、自分自身の入力から送られたものではありません。Slack、Teams、またはプロジェクトのスレッドからセッションに中継されたメッセージ、あるいはクラウドスケジュールタスクや別のプログラムが送信したプロンプトで届きました。 中継されたメッセージは、自分で書いたものであっても通知の対象になります。Claude Code は、中継されたメッセージや自動化されたメッセージが、セッションを実行しているアカウントの所有者から送られたものかどうかを判断できないため、要約の代わりにこの通知で応答します。
claude -p に渡した /recap、または自分の Agent SDK アプリケーションが起動したセッションに送信する /recap は、自分自身の入力として扱われます。 対処方法:
  • 自分でセッションを開き、そこで /recap を実行します。実行場所は、そのセッションのターミナル、デスクトップアプリやモバイルアプリ、claude.ai/code、または Remote Control 経由です
  • クラウドスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから /recap を削除します

/feedback is disabled by your organization’s policy

このメッセージは、製品フィードバックがオフになっているため、入力したコマンドでフィードバックダイアログが開かないことを意味します。このメッセージは、組織のポリシーと以前の拒否のどちらによっても表示されます。
  • 組織のポリシー: 組織のポリシーで Claude Code からの製品フィードバックが許可されていません。/feedback、/bug、/share のいずれもこのメッセージで応答します。
  • 以前の拒否: フィードバックサービスが、送信したレポートを Couldn't send feedback: Feedback has not been enabled for your organization. などで拒否しました。その後、/feedback と /bug がこのメッセージで応答することがあります。この状態は、このマシン上でその拒否から 7 日間続きます。これは Pro や Max を含むすべてのプランに当てはまります。
メッセージには、Claude Code のプロンプトで入力したコマンドが示されます。
メッセージが最初の文だけの場合もあります。 対処方法:
  • バグを報告するには、github.com/anthropics/claude-code/issues で issue を作成します。そこにある issue は誰でも読めるため、コード、トランスクリプト、その他の機密情報は含めないでください。
  • 以前の拒否の後は、7 日間が経過するのを待ってから再度レポートを送信し、サービスがまだ拒否するかどうかを確認します
v2.1.319 より前は、以前の拒否によってこのメッセージが表示されることはありませんでした。 v2.1.302 より前は、完全なメッセージは /feedback is disabled by your organization's policy. Contact your organization admin to enable it. でした。

プラグインエラー

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

plugin eval は現在早期アクセス中です

claude plugin evalまたは claude plugin eval init を実行し、何もする前に終了コード 1 で以下のいずれかのメッセージで終了しました:
最初のメッセージは、ビルドが v2.1.269 より古いことを意味します。これはコマンドが一般的に利用可能になった最初のバージョンです。2 番目のメッセージは、Anthropic がサーバー側でコマンドをオフにしたことを意味します。マシン上の何もそれをオンに戻しません。 対処方法:
  • claude --version を実行してから claude update を実行し、新しいセッションでコマンドを再度実行してください。プラグイン eval の要件を参照してください
  • 現在のビルドで 2 番目のメッセージが表示される場合は、別の claude update の後で後で再度試してください

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

マーケットプレイスは、公式 Anthropic マーケットプレイス用に予約されている名前で登録されていますが、登録されたソースは anthropics GitHub リポジトリではありません。Claude Code は、マーケットプレイスを読み込むか更新するたびに予約名を再確認するため、マーケットプレイスとそこからインストールされたプラグインの読み込みが停止します。v2.1.205 より前では、名前が予約される前に登録されたエントリは読み込みを続けていました。
ソースが 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 リポジトリから再度追加してください
  • 名前が予約される前に使用した第三者マーケットプレイスを公開する場合は、名前を変更し、ユーザーにソースから再度追加するよう依頼してください
  • マーケットプレイススキーマの下の予約名リストを参照してください

マーケットプレイス名は予約名の別のスペルです

マーケットプレイスの名前自体は予約名ではありませんが、Claude Code はそれを予約名の別のスペルとして扱います。予約名は、どのスペルが予約名として数えられるかをリストします。Claude Code は、マーケットプレイスを追加するときにそのような名前を拒否します:
マーケットプレイスが既にそのような名前で登録されている場合、そのエントリは読み込みを停止し、/plugin、claude plugin install、および claude plugin update は警告します:
名前がシェルクォートを必要とする場合、追加時の拒否は This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be. と読みます。 対処方法:
  • マーケットプレイスの名前を予約名のスペルではない名前に変更し、再度追加してください
  • 無視されたエントリの警告については、提供される claude plugin marketplace remove コマンドを実行するか、~/.claude/plugins/known_marketplaces.json からエントリを削除してください

Claude Code がマーケットプレイス名を拒否します

登録されたマーケットプレイスの名前は、公式 Anthropic マーケットプレイスを偽装します。そのセクションがリストするルールの下で。 マーケットプレイスがチェックがそれをブロックする前にそのような名前で登録された場合、マーケットプレイスとそこからインストールされたプラグインは読み込みを停止します。Claude Code はマーケットプレイスのカタログを読むたびに名前をチェックするためです。名前が公式のものを模倣する場合、claude plugin list と /plugin Errors タブは、以下で始まるメッセージで影響を受けた各プラグインを報告します:
模倣する名前の場合、マーケットプレイス自体のエラーは Claude Code refuses this marketplace's name: it looks like one of Anthropic's own と読みます。claude plugin marketplace add は、Marketplace name impersonates an official Anthropic/Claude marketplace で任意の偽装名を拒否します。 v2.1.282 より前では、claude plugin list と /plugin は、マーケットプレイスの名前が原因として名前を付けずに、模倣する名前のプラグインを読み込みに失敗したものとして報告していました。 対処方法:
  • 設定ファイルが "source": "settings" でインライン宣言しているマーケットプレイスを保持するには、古い名前を削除する前に名前を変更してください。マーケットプレイスを削除すると、設定ファイルからもそのエントリが削除されるためです。Claude Code v2.1.292 以降では、メッセージに次の手順が表示されます:
    1. extraKnownMarketplaces にそのマーケットプレイスを記載している各設定ファイルで、エントリのキーとその source.name に、公式のものに見えない新しいプレーン ASCII の名前を 1 つ付けます。管理者が組織の管理設定を通じてマーケットプレイスを追加している場合は、この手順は管理者が行います
    2. claude plugin marketplace remove <old-name> を実行するか、/plugin の Marketplaces タブで古い名前を削除します。これにより、そのプラグインもアンインストールされ、それらのデータ、オプション、シークレットが削除されます
    3. Claude Code を再起動します。ファイルがプロジェクトの設定ファイルである場合は、プロジェクトのフォルダで起動します。その後、名前を変更したマーケットプレイスからプラグインをインストールします
  • その他のマーケットプレイスを保持するには、メンテナーが名前を変更するまで待ってから、claude plugin marketplace update <name> を実行してください
  • マーケットプレイスを削除するには、claude plugin marketplace remove <name> を実行してください。これにより、マーケットプレイスからインストールされたプラグインもアンインストールされ、それらのデータ、オプション、シークレットが削除されます
  • マーケットプレイスを公開する場合は、marketplace.json で名前を変更してください。ユーザーはマーケットプレイスを削除する代わりに更新します

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

セッション内またはシェルから、インストールコマンドの --marketplace <source> で新しいマーケットプレイスソースを指定しました。Claude Code がそのソースから取得したカタログは、既に別のソースから追加したマーケットプレイスと同じ名前を持っています。Claude Code は既存のマーケットプレイスを置き換えずに保持し、プラグインはインストールされません。
対処方法:
  • 既に追加したマーケットプレイスが必要なものである場合は、名前でそこからインストールしてください:/plugin install <plugin>@<name>
  • 新しいソースに切り替えるには、/plugin marketplace remove <name> を実行してから、インストールを再試行してください

プラグインコマンドがシェルコマンドで user_config を参照しています

プラグインフック、monitor、または MCP headersHelperコマンドは、${user_config.KEY} プラグインオプションを参照し、置換された文字列はシェルに渡されます。$(...) を含む設定値、バックティック、または ; はそこでコードとして実行されるため、Claude Code は値を置換する代わりにコンポーネントの開始を拒否します。チェックはコマンドテンプレートで実行されるため、値がまだ設定されていない場合でもエラーが表示されます。v2.1.207 より前では、値はシェルコマンドに置換されていました。 表現は、どの表面がオプションを参照したかによって異なります。シェル形式フックは以下を報告します:
モニターは以下を報告します:
MCP headersHelper は以下を報告します:
対処方法:
  • フックの場合、args 配列を追加して、exec 形式で実行されるようにします。ここで、各 ${user_config.KEY} は、その間にシェルがない 1 つの引数になります。または参照をドロップし、スクリプト内から $CLAUDE_PLUGIN_OPTION_<KEY> 環境変数を読み取ります
  • モニターの場合、参照をドロップし、モニタースクリプトに設定ファイルから値を読み取らせます
  • headersHelper の場合、${user_config.KEY} をサーバーの headers フィールドに移動します。これはシェル解析されません。または、ヘルパースクリプト内から値を読み取ります

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

プラグインのマーケットプレイスエントリは、sha256 ピン付きの archive ソースを使用し、ダウンロードされたファイルのダイジェストはピンと一致しません。Claude Code はインストールを拒否するため、プラグインキャッシュに何も変わりません。不一致には 3 つの考えられる原因があります:
  • 著者がピンを計算した後、URL のファイルが変更されました
  • 著者がマーケットプレイスエントリに間違ったダイジェストを入力しました
  • URL は著者がピンしたファイルとは異なるファイルを提供します
対処方法:
  • プラグインを公開する場合は、URL が提供する正確なファイルのダイジェストを再計算します。例えば shasum -a 256 my-plugin.zip または PowerShell で Get-FileHash -Algorithm SHA256 my-plugin.zip を使用し、マーケットプレイスエントリの sha256 を更新してください
  • プラグインをインストールする場合は、/plugin marketplace update <name> を実行してカタログをリフレッシュします。エントリが修正された場合、インストールを再試行してください
  • リフレッシュ後もダイジェストが一致しない場合は、インストール前にマーケットプレイス所有者にどのファイルをピンしたかを尋ねてください

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

プラグインのコンポーネントパスの 1 つがプラグインディレクトリの外を指しているか、ディレクトリ内にあることを確認できなかったため、Claude Code はそのパスをドロップし、プラグインの残りを読み込みます。プラグインが plugin.json またはそのマーケットプレイスエントリで宣言したパスの場合、メッセージ内のコンポーネント名(commands や hooks など)は、そのパスを宣言したフィールドを示します。
claude plugin コマンド出力では、同じエラーは Path escapes plugin directory: ./../shared.md (commands) と読みます。 Claude Code は、../shared-utils のように書かれたプラグイン外を指すパスと、プラグイン外に導くシンボリックリンク(マーケットプレイスシンボリックリンクルールが許可するものではない)の両方を拒否します。シンボリックリンクの場合、メッセージはパスが解決される場所も示します:
マーケットプレイスプラグイン自身のファイルのいずれか(hooks/hooks.json など)のフルパスを示すメッセージは、Claude Code がそのファイルをスキップしたことを意味します。Claude Code は、ファイルがプラグイン内にあること、またはローカルマーケットプレイス内のプラグインの場合はそのマーケットプレイス内にあることを確認できない場合、そのファイルをスキップします。メッセージでは、これらのファイルが次に示すコンポーネント名の下に報告されます:
  • hooks/hooks.json:hooks
  • monitors/monitors.json:monitors
  • プラグインルートの SKILL.md:skills
例えば、次のメッセージは、プラグインとそのローカルマーケットプレイスの両方の外に解決される hooks/hooks.json に対するものです:
macOS と Linux では、Claude Code はコンポーネントパスにバックスラッシュが含まれているパスも拒否します。パスがプラグイン内に留まる場合でも。Windows スタイルのセパレータを使用するコンポーネントパスを持つプラグインは Windows で読み込まれ、他のプラットフォームでこの拒否をトリガーします:
v2.1.251 より前では、Claude Code はマーケットプレイスエントリで宣言された commands パスを、プラグインディレクトリの外を指していても読み込みました。 v2.1.257 より前では、プラグインが宣言するパスに対するチェックはパスのスペルのみを調べ、シンボリックリンクが導く場所は調べませんでした。 対処方法:
  • プラグインをインストールしただけでメンテナンスしていない場合は、メッセージをその作成者に報告してください
  • プラグインが宣言するパスの場合は、参照されたファイルをプラグインディレクトリ内に移動し、./ 相対パスでそれを指してください
  • パス、またはプラグイン内でその上位にあるフォルダが、プラグイン外に導くシンボリックリンクである場合は、シンボリックリンクをそのリンク先のコピーに置き換えてください
  • プラグインが宣言するパスにバックスラッシュが含まれているとメッセージが示す場合は、パスをスラッシュで書いてください。例えば ./commands/deploy.md
  • メッセージが EACCES で終わる場合は、パスが示すファイルまたはフォルダに至るすべてのディレクトリに対する実行権限を復元してください。パスの上位のディレクトリを確認し、次に到達した各シンボリックリンクをたどって、そのリンク先に至るディレクトリを確認します。その他のエラーコードについては、チェックできなかったパスの原因と手順で確認してください。
  • 同じマーケットプレイス内の他のプラグインとファイルを共有するには、プラグインディレクトリ内のシンボリックリンクでそれらをリンクし、シンボリックリンクルールに従ってください

サーバーファイルのパスが読み取られませんでした

path not read メッセージは、プラグインが指定する MCP または LSP サーバーファイルを、そのファイルのパスが原因で Claude Code が読み取らなかったことを意味します。プラグインの残りの部分は、そのファイルが定義するサーバーを除いて読み込まれます。 次の例のように、パスがプラグイン内に留まる場合でも、.. を含む部分は対象になります:
対処方法:
  • プラグインをインストールしただけでメンテナンスしていない場合は、メッセージをその作成者に報告してください
  • プラグインをメンテナンスしている場合は、サーバーファイルをプラグインディレクトリ内に置いてください。マニフェストまたはマーケットプレイスエントリでは、./ で始まり .. を含まないパス(例:./servers/x.json)で指定してください
  • 同じマーケットプレイス内のプラグイン間で 1 つのサーバーファイルを共有するには、シンボリックリンクルールに従い、シンボリックリンクでそのファイルを各プラグインにリンクしてください

Plugin not loaded: its manifest was not read

Claude Code は、マーケットプレイスプラグインの .claude-plugin/plugin.json にあるマニフェストがプラグイン内にあることを確認できなかったため、そのプラグインから何も読み込みません。ローカルマーケットプレイス内のプラグインの場合、Claude Code はマニフェストがそのマーケットプレイス内にあることも確認できませんでした。メッセージは /plugin の Errors タブに表示され、末尾の理由が Claude Code の検出内容を示します。 例えば、次のメッセージは、.claude-plugin フォルダがマーケットプレイス外に導くシンボリックリンクになっている、ローカルマーケットプレイス内のプラグインに対するものです:
対処方法:
  • 理由が EACCES で終わる場合は、マニフェストに至るすべてのディレクトリに対する実行権限を復元してください。マニフェストの上位のディレクトリを確認し、次に到達した各シンボリックリンクをたどって、そのリンク先に至るディレクトリを確認します。その他のエラーコードについては、チェックできなかったパスの原因と手順で確認してください。
  • プラグインをメンテナンスしていて、理由にマニフェストの解決先が示されている場合、.claude-plugin フォルダまたは plugin.json 自体が、そこへ導くシンボリックリンクです。そのリンクをリンク先のコピーに置き換えてください。
  • プラグインをインストールしただけでメンテナンスしていない場合は、メッセージをその作成者に報告してください

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

Claude Code はプラグインパスが存在するかどうかをオペレーティングシステムに尋ね、「見つかりません」以外のエラーを取得したため、パスが名前を付けるものを読み込みません。プラグインの読み込み量は、どのパスが失敗したかによって異なります:
  • プラグインのデフォルトコンポーネント位置の 1 つ(skills/ フォルダ、monitors/monitors.json ファイル、またはプラグインルートの SKILL.md):プラグインの他のコンポーネントは引き続き読み込まれます
  • プラグイン自体のディレクトリ:そのプラグインから何も読み込まれません
このエラーは、まったく存在しないパスに対しては表示されません。/plugin では、エラーはプラグインの下に表示され、パスとオペレーティングシステムが返したコードに名前を付けます:
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 がマーケットプレイス自体のディレクトリ内の位置に解決できないソースパスを宣言するため、プラグインはインストールまたは読み込まれません。拒否は以下をカバーします:
  • 絶対的なエントリパス、.. でマーケットプレイスから登ります、またはネットワークパスのようにスペルされています
  • macOS と Linux では、先頭の ./ の後のどこかにバックスラッシュを含むエントリパス
  • git または URL などのリモートソースから取得されたマーケットプレイス内のエントリ。マーケットプレイスディレクトリの外に解決するシンボリックリンクを通じてターゲットに到達します
  • マーケットプレイスの marketplace.json への直接 URL から追加された相対エントリ:Claude Code はそのファイルのみをダウンロードするため、パスが名前を付けるローカルプラグインファイルは存在しません。相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗しますを参照してください
claude plugin install は拒否を次のように報告します:
既にインストールされているプラグインのエントリが同じチェックに失敗する場合、claude plugin list はプラグインを failed to load として表示します:
対処方法:
  • マーケットプレイスを維持する場合は、エントリの 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 plugin install は以下を報告します:
v2.1.246 より前では、claude plugin install はこの失敗を報告しませんでした。 対処方法:
  • ~/.claude/plugins/known_marketplaces.json を開き、JSON を修復するか、メッセージが名前を付けるエントリをレジストリスキーマと一致するように修正してください
  • 修復できない場合は、ファイルを削除するか、その内容を {} に置き換えてから、claude plugin marketplace add <source> で各マーケットプレイスを再度追加してください。Claude Code は、信頼したフォルダで次回起動するときに、ユーザーまたは管理設定が extraKnownMarketplaces で宣言するマーケットプレイスを再登録します。

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

claude plugin disable を実行するか、/plugin Installed タブを使用して、組織が必須としてマークする claude.ai から同期されたプラグインをオフにしました:
Claude Code は何も保存せず、プラグインは有効なままです。 必須プラグインが依存するプラグインを無効にしようとすると、Claude Code は同じ方法で拒否し、それを必要とする必須プラグインに名前を付けるメッセージを表示します。 対処方法:
  • claude.ai 組織の管理者に、プラグインの必須ステータスを claude.ai で変更するよう依頼してください

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

claude plugin uninstallを実行するか、/plugin Installed タブで Uninstall を選択し、アンインストールは "<plugin>" was not uninstalled: で始まるメッセージで停止しました。そのコロンの後のテキストが設定ファイルの名前ではなく installed_plugins.json で始まる場合、原因は installed_plugins.json 内のこのバージョンの Claude Code が読み取ることができないコンテンツです。その形式については、installed_plugins.json はこのバージョンが読み取ることができないレコードを保持していますを参照してください。 Claude Code がプラグインのエントリを enabledPlugins から削除し、そのスコープの設定ファイルを読み直したとき、プラグインはそこでまだオンに切り替えられたか、それをオンに切り替えることができるファイルを読み取ったり確認したりできませんでした。プラグインの保存されたオプション、シークレット、およびデータを削除しながら、設定エントリがそれをオンに切り替えることができるのは、それらを失うことになるため、アンインストールは代わりに停止します:プラグインはインストールされたままで、保存されたものは削除されません。
メッセージの中央はファイルと原因に名前を付けます:
  • it is still switched on in <file>, although the settings change reported no error:設定の書き込みは成功を報告しましたが、エントリはファイルを読み直すときにまだそこにあります
  • it is still switched on in <file>, and the settings change failed (<error>):ファイルを保存できませんでした。括弧内の理由のため
  • <file> is there and could not be read:ファイルは存在しますが、設定として読み取ることができませんでした。例えば、有効な JSON ではないため、プラグインを有効にしたままの可能性があります
  • <file> (not read: it is on a network path or is a link to one, or could not be checked):Claude Code はプロジェクトまたはローカル設定ファイルを読み取りませんでした。ファイル、またはそれを保持する .claude フォルダは、ネットワークの場所にリンクしているか、そのパスを調べることができなかったためです
claude plugin uninstall は終了コード 1 で、--json を使用すると結果は failureCode: "settings_still_on" を含みます。/plugin は同じメッセージを表示します。 対処方法:
  • メッセージの最後の文に従ってください:それが名前を付ける設定ファイルを修復または置き換えるか、そのファイルの enabledPlugins からプラグインのエントリを自分で削除してから、アンインストールを再度実行してください

Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)

このメッセージは、Claude Code が stdio のプラグインが提供する MCP サーバーを起動しなかったことを意味します。そのサーバーへの接続が 15 分以内に失敗していたためです:
セッションはそのサーバーのツールなしで続行され、15 分が経過しても Claude Code はそのセッション内でサーバーへの接続を再試行しません。直近の接続失敗から 15 分以上経ってから新しいセッションまたは claude -p の実行を開始すると、Claude Code はサーバーへの接続を再試行します。 対処方法: 待たずに Claude Code にサーバーへの接続を再試行させるには:
  • 対話型セッションの場合:/mcp を実行し、サーバーを選択して Reconnect を選択します
  • Agent SDK アプリケーションの場合:TypeScript では reconnectMcpServer()、Python では ClaudeSDKClient.reconnect_mcp_server() を、サーバー名を指定して呼び出します
  • claude -p の場合:実行時と同じマシン、同じオペレーティングシステムアカウント、同じ CLAUDE_CONFIG_DIR の値で、同じプラグインを読み込む対話型セッションを開始します。そこで /mcp からサーバーを再接続します。接続できたら、Claude Code は次回の実行で接続を試みます。
  • プラグインを開発している場合:プラグインの .mcp.json または plugin.json で、サーバーの command、args、または env を変更します。Claude Code は、変更されたエントリを読み込む次のセッションまたは claude -p の実行で接続を試みます。
このメッセージは、失敗した接続のエラーの代わりに表示されます。新しい試行も失敗した場合、Claude Code はこのメッセージではなく、その試行のエラーを報告します。

ツールエラー

これらのエラーは Claude のツール呼び出しから発生します。Claude はほとんどのツールエラーを自動的に修正します。変更が必要な場合、そのエラーの What to do リストに何を変更するかが記載されています。

No such tool available

Claude が、セッションのツールリストにない名前でツールを呼び出しました。Claude Code はそのエラーをツール呼び出しの結果として Claude に返し、ターンは続行します。ツールが存在しない理由を Claude Code が判断できる場合は、2 行目のように、ツール名の後に理由や代わりに呼び出すべきツールを示す文を追加します。
セッションを再開した直後は、Claude が MCP サーバーのツールを呼び出した時点で、そのサーバーがまだ最初の接続試行中である場合があります。その場合、Claude Code は サーバーを待機 し、待機が終了してもツールが利用できない場合にこのエラーを返します。v2.1.284 より前は、このような呼び出しは待機せずにすぐに失敗していました。 Claude Code が 200 文字に切り詰めた ツール名での呼び出しも、このエラーで失敗します。 What to do:
  • 1 回だけ発生した場合は、何もする必要はありません。Claude がエラーを読み取り、ターンは続行します。
  • MCP サーバーのツールへの呼び出しがこのエラーで失敗し続ける場合は、セッション内で /mcp を実行するか、シェルで claude mcp list を実行してサーバーの ステータス を確認し、失敗したサーバーを /mcp から再接続します。Agent SDK では、エラー処理 を参照してください。

MCP server connection closed before the tool call was answered

HTTP MCP サーバー または claude.ai コネクタ へのツール呼び出しで、サーバーが応答する前に接続が失われたため、Claude Code はツールが実行されたかどうかを判断できません。
呼び出しを繰り返すと、2 つ目の issue の作成など、ツールのアクションが繰り返される可能性があります。そのため Claude Code は、サーバーがそのツールを繰り返しても安全であるとマークしている場合に限り、呼び出しを自動的に 1 回だけ繰り返します。 What to do:
  • ツールが操作するサービスで、アクションが実行されたかどうかを確認します。例えば、作成されるはずだった issue やレコードが存在するかどうかを確認します
  • アクションが実行されていた場合は、ツールを再度実行しないでください。Claude はツールの結果の代わりにこのメッセージを受け取ったため、結果を Claude に伝えてください。
  • アクションが実行されていなかった場合は、Claude にツールを再度実行するよう依頼します。Claude Code はそのサーバーのツールへの次の呼び出し時にサーバーへ再度接続するため、事前にサーバーを再接続する必要はありません。その接続も失敗する場合は、リモートサーバーのセッション中の切断 を参照してください。
  • サーバーを自分でビルドしていて、ツールを 2 回呼び出しても安全な場合は、繰り返しても安全であるとマーク して、Claude Code が失われた呼び出しを繰り返せるようにします

MCP server is disabled

ツール結果にこのメッセージが含まれている場合、Claude が オフになっている MCP サーバー のツールを呼び出したことを意味します。Claude Code はサーバーに接続しなかったため、ツールは実行されず、Claude は結果の代わりにこのテキストを受け取りました。
What to do:
  • サーバーを意図的にオフにした場合は、何もする必要はありません
  • Claude がサーバーのツールを必要とする場合は、Claude Code のプロンプトで /mcp からサーバーをオンに戻します
  • Agent SDK アプリケーションでは、TypeScript では enabled を true に設定して toggleMcpServer() を呼び出し、Python では enabled を True に設定して toggle_mcp_server() を呼び出して、サーバーをオンに戻します

MCP tool call timed out with the server’s question unanswered

非対話モード で、MCP サーバー がツール呼び出し中に elicitation を通じて入力を求めましたが、回答が届く前に呼び出しの制限時間が切れました。
v2.1.310 より前は、結果は timed out after <N>s で終わり、質問については何も示されませんでした。 What to do:
  • サーバーのリクエストに回答する Elicitation フック を設定します
  • TypeScript Agent SDK アプリケーションでは、onElicitation コールバックが制限時間内に回答を返すようにします
  • 回答までの時間を延ばすには、サーバーの設定エントリでより長い timeout をミリ秒単位で設定します(例えば、10 分の場合は "timeout": 600000)
  • 代わりに対話セッションでタスクを実行し、サーバーの ダイアログ に自分で回答します

Permission prompt tool returned an invalid result

--permission-prompt-tool に渡したツールが Claude Code で読み取れない回答を返したため、その回答を待っていたツール呼び出しは、回答が呼び出しを許可していた場合でも実行されませんでした。
What to do:
  • テキストが {"behavior": "allow"} または {"behavior": "deny", "message": "<reason>"} であるテキストブロックを 1 つ返します。入力を変更するには、allow オブジェクトに updatedInput を追加します。v2.1.86 から v2.1.206 までは、入力を保持するために allow に "updatedInput": {} が必要でした。
  • structuredContent を返さないでください。これは使用している MCP SDK が自動的に追加する場合があります。例えば、ツールを次のように登録します。
    • mcp.server の FastMCP または MCPServer: structured_output=False を指定します
    • fastmcp の FastMCP: output_schema=None を指定し、文字列を返します
    • MCP TypeScript SDK: outputSchema を指定しません
  • 約 40 KB 以上の入力でのみエラーが発生する場合は、入力を updatedInput や拒否の message にコピーしないでください。それほど大きな入力を変更するには、プロンプトツールの出力制限を引き上げます。

Agent would be spawned with zero tools

サブエージェントの tools リスト のすべてのエントリが使用可能なツールと一致しなかったため、Claude Code はサブエージェントの起動を拒否しました。ツールがないと、サブエージェントは動作できません。メッセージはエントリを何が問題かでグループ化します。
  • Unrecognized: エントリがツール名と一致しません。通常は Grpe のような Grep のタイプミスです。
  • Not available to subagents: エントリが サブエージェントが使用できない 実際のツールを指定しています。バックグラウンドサブエージェントはより小さい組み込みツールセットを保持しているため、フォアグラウンドサブエージェントのみが使用できるエントリは、サブエージェントがバックグラウンドで実行される場合(これがデフォルトです)、ここに表示されます。Agent をリストする場合、メッセージは代わりに次のグループの下に報告します。
  • Matched no tools in this session: エントリは有効ですが、現在のセッションのツールが今すぐそれと一致しません。例えば、GitHub MCP サーバーが接続されていない mcp__github__* や、深さ制限 にあるサブエージェントの Agent などです。
tools フィールドを省略することは、この拒否をトリガーしません。tools リストを空のままにするか、disallowedTools がそれ内のすべてのエントリを削除する場合、Claude Code も拒否をスキップし、ツールなしでサブエージェントを起動します。 v2.1.208 より前は、サブエージェントはツールなしで起動し、空または混乱した結果を返す可能性がありました。
What to do:
  • エラーが指定する各エントリを サブエージェントが利用可能なツール に対して修正します
  • セッションが持たないツールのエントリを削除します。例えば、接続されていないサーバーからの MCP ツール
  • エントリが接続済みの MCP サーバーを指定している場合は、エントリを、そのサーバーの ツール名 に綴られているサーバー名(例えば mcp__reports__v2__get_totals の reports__v2)と比較します。そのサーバーには、mcp__reports__v2__*、つまり mcp__ の後に名前全体と __* を続けたものを記述します。reports という名前のサーバーを指す短い mcp__reports では、サブエージェントは reports__v2 のツールを 1 つも取得しません
  • バックグラウンドサブエージェントが削除する ツール(例えば CronCreate)の場合、エントリを削除します
  • 代わりに CronCreate などのツールを保持するには、Claude にサブエージェントを待機させます。Claude が待機するサブエージェントはフォアグラウンドで実行され、ツールを保持するためです。定義で background: true が設定されている場合は、サブエージェントがバックグラウンドのままになるため、先にそのフィールドを削除します
  • tools フィールドを削除して、サブエージェントに サブエージェントが利用可能なすべてのツール を与えます
  • Agent のみを含む tools リストの場合、深さ制限 を上げるか、エージェントに少なくとも 1 つの他のツールを与えます。Claude Code はその制限で Agent を保留するため、リストに他に何もない場合、ツールに解決されません

File is covered by a Read deny rule

Edit または Write ツールが Read 拒否ルール と一致するパスで呼び出されました。これには、そのパスで新しいファイルを作成することも含まれます。両方のツールは Claude が読み戻す必要があるコンテンツを変更するため、Claude Code はファイルアクセスの前に呼び出しを拒否します。NotebookEdit は Read 拒否ルールの対象ではありません。v2.1.228 より前は、ルールは Edit ツールのみをブロックし、v2.1.208 より前は、Edit 拒否ルールのみが編集をブロックしました。
Claude Code が Write ツールを拒否する場合、メッセージは代わりに and cannot be written で終わります。 What to do:
  • Claude がファイルを変更できるべき場合、/permissions または 設定 の Read 拒否ルールを削除または縮小します
  • ファイルが変更されないままである必要がある場合、ルールを保持し、NotebookEdit ツールもブロックするために同じパスの Edit 拒否ルールを追加します

Setting blocks writes outside the working directories

Claude がファイルを書き込もうとしてツール呼び出しがこのメッセージで失敗した場合、そのパスはセッションの 作業ディレクトリ の外にあり、permissions.blockWritesOutsideWorkingDirectories がオンになっています。
Claude Code はどの権限モードでもその書き込みを拒否します。拒否メッセージは次のようになる場合もあります。
What to do:
  • Claude がそこに書き込むべきでない場合は、何もしません
  • パスを含む既存のディレクトリへの書き込みを Claude に許可するには、Claude Code のプロンプトで /add-dir <directory> を実行するか、Claude Code の起動時に --add-dir <directory> を渡します
  • パスが ~/.claude/settings.json などの Claude Code の設定ファイルである場合は、自分で編集します。/add-dir でそのディレクトリを追加しても解決しません。その場合、Claude Code はその書き込みを 設定ファイルとして 拒否するためです。
  • すべてのセッションでディレクトリを書き込み可能にしておくには、ユーザー設定または管理設定の permissions.additionalDirectories にそのディレクトリを記載します
  • permissions.blockWritesOutsideWorkingDirectories をオフにするには、それを設定しているすべての設定ファイルから削除してから、Claude Code を再起動します
  • どの設定ファイルにも permissions.blockWritesOutsideWorkingDirectories がない場合は、--settings またはホストアプリケーションから設定されている可能性があります。また、Claude Code は 管理設定 の permissions を読み取れない間も、これらの書き込みを拒否します。セッションを起動または管理している担当者に問い合わせてください。

Writes to Claude Code settings files are blocked

Claude がファイルを書き込もうとしてツール呼び出しがこのメッセージで失敗した場合、Claude Code はそのファイルを自身の設定ファイルの 1 つとして扱っており、permissions.blockWritesOutsideWorkingDirectories がオンになっています。
What to do:
  • 設定を変更するには、設定ファイルを自分で編集します
  • Claude が再び設定ファイルを編集できるようにするには、permissions.blockWritesOutsideWorkingDirectories を設定しているすべての設定ファイルからそれを削除してから、Claude Code を再起動します
  • ファイルが自分の設定ファイルではない場合は、Claude Code が設定ファイルとして扱う他のファイルの中から探します。
    • --agents または --mcp-config に渡したファイル: 自分で編集します
    • サーバー管理設定 の保存されたコピーと、それと一緒に保持されるファイル: サーバー管理設定で設定を変更するよう Owner に依頼します。
    • Claude Code が managed-settings.d/ フォルダの参照先を特定できない間の、任意の .json ファイル: そのフォルダを確認するよう管理者に依頼します

Path cannot contain null bytes

ファイルツール呼び出しのパスまたはパターン引数に null バイトが含まれていました。ファイルシステムと検索ツールはこれを受け入れることができません。Read、Write、Edit、NotebookEdit、Glob、Grep はこれをチェックし、メッセージはツールと引数を指定します。
ツール呼び出しは失敗し、Claude はエラーを見て、ターンは続きます。 What to do:
  • ユーザー側で行う必要のある操作はありません。エラーはツールの結果として Claude に返され、メッセージ自体が Claude に null バイトを削除して再度試すよう指示します
v2.1.281 より前は、Read、Write、Edit、または NotebookEdit パスの null バイトがターン全体を Path contains null bytes という名前のエラーで終了し、ツールは実行されませんでした。

Command contains an invisible character

PowerShell ツール が、U+FEFF または U+180E を含むコマンドの実行を拒否しました。
What to do:
  • Claude が書いたコマンドの場合: 修正する必要はありません。メッセージが Claude にコマンドの書き直し方を伝えます。
  • スキルまたはコマンドファイルの場合: メッセージは No shell command in <name> was run の後に続きます。文字の場所と削除方法 を参照してください。

Claude Code の再起動後、承認済みのコマンドが実行されなかった

承認したシェルコマンドが実行されず、Claude はこのメッセージをコマンドの結果として受け取ります。
メッセージの 3 番目の文は、代わりに It does not keep track of that directory across a restart in a session that has been in a worktree. となる場合もあります。 What to do:
  • Claude に処理を続行させ、コマンドの再承認を求められた場合はプロンプトに応答します。

File is too large to read as an image

Claude が Read ツール でファイルを画像として読み取ろうとしましたが、そのファイルは Read が画像ファイルから読み込める上限である 128 MB を超えています。何も読み取られず、Claude はこのエラーをツール結果として受け取ります。
パスが通常のファイルではなくパイプまたはデバイスである場合、Read は 128 MB を超えるデータが届いた時点で読み取りを停止し、代わりに次のエラーを返します。
What to do:
  • Claude が File is too large メッセージに従って、画像のサイズを変更したり、より小さいコピーを読み取ったりした場合は、何もする必要はありません
  • Claude がエラーで停止した場合は、解像度を下げるなどして 128 MB 未満のコピーを自分でエクスポートし、そのファイルを Claude に指定します
  • パスがパイプまたはデバイスだった場合は、代わりに通常の画像ファイルを Claude に指定します

subagent_type is required

Claude は subagent_type なしで Agent ツール を呼び出し、このセッションにはフォールバックする 汎用サブエージェント がありません。これは 2 つのセットアップの場合です。 What to do:
  • 通常は何もしません。メッセージはセッションが持つサブエージェントをリストするため、Claude はそのうちの 1 つで再試行できます
  • Claude が失敗し続ける場合、tools: Agent(...) 許可リストに 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 は 自動メモリ インデックス MEMORY.md に書き込み、その読み取り制限の 1 つを超えたままにしました。200 行または 25KB です。書き込みは成功しましたが、最初の 200 行または 25KB のみ(どちらか先に来た方)がセッションの開始時に読み込まれるため、制限を超えるすべてのものはインデックスが読み込まれるたびに削除されます。v2.1.210 より前は、制限を超えたインデックスは書き込み時の信号なしで次の読み込み時に静かに切り詰められました。
読み込まれるコンテンツのみが制限にカウントされます。YAML フロントマターとブロックレベルの HTML コメントはインデックスが読み込まれる前に削除されるため、測定から除外されます。v2.1.211 より前は、Claude Code は生ファイルを測定し、フロントマターまたはコメントは読み込まれたコンテンツが適合しても、このエラーをトリガーする可能性がありました。 Claude Code はエラーを書き込み後に Claude に配信するため、ターミナルにバナーとして出力されず、トランスクリプトでのみ気付く可能性があります。 Claude の書き込みがファイルを制限に近づけても超えない場合、Claude Code はこのエラーの代わりにインデックスをコンパクトにするための穏やかなリマインダーを返します。 What to do:
  • Claude に MEMORY.md を書き直させるか、依頼します。エントリごとに 1 行を保持し、詳細をトピックファイルに移動し、古いエントリをマージまたは削除します
  • インデックスを自分でトリミングするには、メモリの監査と編集 を参照してください

pkill pattern matches the Claude Code process

Bash ツール呼び出しの pkill コマンドは、通常 -f を使用して、Claude Code プロセス自体と一致するパターンを使用したため、Claude Code はコマンドを実行してセッションを終了させるのではなく、コマンドを拒否します。Claude Code は pkill を実行する前に pgrep でパターンをテストし、独自のプロセス ID が結果に含まれている場合は拒否します。チェックは Linux でのみ実行されます。macOS では、pkill は変更されずに実行されます。v2.1.214 より前は、コマンドが実行され、一致するパターンが Claude Code セッションをターン中に終了しました。
拒否はターミナルのバナーではなく、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 に再度試すよう指示します。
構造化された エージェントチーム プロトコルメッセージは同じ方法で失敗し、エラーは配信されなかったメッセージを指定します。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: チームメイトの計画がチームリーダーに到達せず、チームメイトは再提出が成功するまで plan モードのままです
  • 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 が停止した エージェントチーム のチームメイトにメッセージを送信し、Claude Code はそのチームメイトを復帰させましたが、生成元の サブエージェント定義 を再適用しませんでした。通知は、送信エージェントのツール結果の再開レポートに続いて表示され、理由を示します。定義ファイルが信頼の保存されていないフォルダから来た場合、通知は次のようになります。
チェックは、プロジェクトまたは --add-dir ディレクトリの .claude/agents/ ディレクトリ内の定義に適用され、親フォルダの信頼ダイアログを受け入れることはそれを満たしません。 What to do:
  • デバッグログ が指定するフォルダで claude を実行し、信頼ダイアログを受け入れます。定義は Claude Code がチームメイトを次に復帰させるときに再適用されます。チームリーダーのセッションを再起動する必要はありません
  • または、~/.claude.json の hasTrustDialogAccepted エントリを true に設定します。デバッグログが出力する正確な projects["<path>"] キーを使用します

Only a teammate can approve a shutdown request

送信したセッションがチームメイトとして実行されていないため、Claude Code は エージェントチーム のシャットダウン承認を拒否しました。何も送信されず、何もシャットダウンされていません。拒否は送信セッションのツール結果に表示されます。
What to do:
  • 拒否がチームリーダーのセッションに表示された場合は、まずチームメイトがその後シャットダウンしたかどうかを確認します。拒否は代わりに shutdown_request を送信するよう指示とともに Claude に返され、ターンは続行します。対話型のチームリーダーセッションでは、チームメイトがシャットダウン要求を承認すると <name> has shut down. が表示されます。
  • チームメイトがまだ実行中の場合は、チームリーダーのプロンプトでチームメイトをシャットダウンするよう依頼します(例: Ask the researcher teammate to shut down)。チームメイトをシャットダウンする を参照してください。
  • claude --resume で自分で再開した元チームメイトがこの拒否を受け取った場合、何も送信されていません。そのセッションを終了するには、そのプロンプトで /exit を実行します。

A command-line deny rule cannot be handed to a teammate intact

このメッセージは、Claude Code が エージェントチーム の 分割ペイン チームメイトを起動しなかったことを意味します。Claude Code はチームリーダーのコマンドライン拒否ルールを、分割ペインのチームメイト自身のコマンドラインで渡しますが、チームメイトがそのいずれかを異なる意味で読み取ってしまう場合は停止します。
What to do:
  • チームリーダーのセッションで /config を実行し、Teammate mode を in-process に設定します。その行に overridden と表示され、すでに in-process が表示されている場合は、値を順に切り替えて in-process に戻します。その後、Claude にチームメイトを再度起動するよう依頼します。インプロセスのチームメイトは チームリーダーの現在の拒否ルールの下で実行されます。
  • /config はこの選択をユーザー設定に保存するため、ユーザー設定から teammateMode を取得する以降のセッションでも、チームメイトはインプロセスで起動します。以降のセッションで分割ペインに戻すには、Teammate mode を以前使用していた auto、tmux、iterm2 のいずれかに設定します。

Message too large for cross-session delivery

Claude の クロスセッションメッセージ は、このマシン上の別のセッションに対して長すぎて送信できませんでした。Claude Code はそれを拒否し、受信セッションは何も受け取りませんでした。拒否はターミナルのバナーではなく、送信セッションのツール結果に表示されます。両方のサイズとメッセージを適合させる方法を指定します。
同じテキストを再送信すると、同じ方法で失敗します。 What to do:
  • Claude にメッセージを要約するか、バルクコンテンツをファイルに入れてそのファイルのパスを送信するよう依頼します
  • Claude にコンテンツを複数の短いメッセージに分割するよう依頼します
v2.1.235 より前は、Claude Code は超過サイズのメッセージが送信されたと報告していました。受信セッションはそれを未読で削除しました。

Too many messages to this session just now

Claude は クロスセッションメッセージ の急速なバーストをこのマシン上の 1 つのセッションに送信し、バーストはそのセッションのインボックスが受け入れるものに達しました。Claude Code は次の送信を拒否し、受信セッションはそれから何も受け取りませんでした。拒否はターミナルのバナーではなく、送信セッションのツール結果に表示されます。
What to do:
  • 通常は何もしません。Claude は残りのコンテンツを 1 つのメッセージにバッチ処理するか、さらに送信する前に少し待ちます
  • バースト自体をプロンプトした場合、Claude に残りのものを 1 つのメッセージに結合するよう依頼します
v2.1.236 より前は、Claude Code はこれらの送信が送信されたと報告していました。受信セッションはそれらを未読で削除しました。

Cross-session message was dropped at the recipient session’s inbox

Claude は クロスセッションメッセージ をこのマシン上の別のセッションに送信し、そのセッションのインボックスは Claude がそのセッションで読む前にそれを破棄しました。行は受信者のアドレスを指定し、受信者が理由を与えた場合、ダッシュの後に理由を追加します。
1 行は複数の削除されたメッセージをカバーできます。その場合、行は複数形で始まります。例えば Cross-session messages (12) were dropped。アドレスがどのセッションに属しているかを見つけるには、各セッションで /status が表示する Peer address 行 と比較します。 ダッシュの後、行は以下の 1 つ以上の理由を与えます。
  • its queue of undelivered peer messages was full: 受信者は既に他のセッションから配信されていないメッセージを多く保持しており、そのキューが許可する限りです
  • you sent faster than that session accepts: 送信セッションのメッセージは受信者が 1 つの送信者から受け入れるより速く到着しました
  • it repeated your previous message: メッセージは送信セッションが最近この受信者に送信したものと同じでした
  • a relay loop between sessions was cut: メッセージが、このマシンの外のセッションを含むものなど、途中で打ち切られる可能性がある返信の長いチェーン の続きでした
What to do:
  • 削除されたメッセージを受信者が見たことがないと仮定します。Claude Code は同じことを Claude に伝え、それでも重要なものを 1 つの後のメッセージに含めるよう指示し、すぐに再送信しないよう指示します
  • セッションが互いに頻繁に更新を送信する場合、Claude にセッションが作業を完了したときなど、より少なく、より大きなメッセージを送信するよう依頼します
  • a relay loop between sessions was cut の場合、セッションの 1 つに自分で次の指示を入力します。Claude が自分のプロンプトに応答して送信するメッセージは新しいチェーンを開始します
v2.1.238 より前は、受信者のインボックスがメッセージを破棄したときに送信セッションはレポートを受け取りませんでした。

Refusing to send a cross-session message

Claude Code が クロスセッションメッセージ をこのマシン上の別のセッションに書き込む前に、ターゲットセッションのインボックスソケットがメッセージが宛てられたエンドポイントであることを確認します。チェックが失敗すると、Claude Code は送信セッションで送信を拒否し、ターゲットセッションは何も受け取りません。Claude が送信するメッセージの場合、拒否は送信セッションのツール結果に表示されます。
Refusing to send: の後のテキストは、失敗したチェックを指定します。
  • reply target is a symlink: シンボリックリンクがターゲットセッションのソケットパスにあります。Claude Code はそれを通じて配信しません。リンクがそこにあると、メッセージをターゲットセッションが作成しなかったエンドポイントにリダイレクトする可能性があるためです。
  • cannot vet reply target: Claude Code はターゲットパスをまったく検査できませんでした。例えば、権限エラーで読み取りが失敗したためです。
What to do:
  • 通常は何もしません。チェックはメッセージが宛てられたセッション以外のエンドポイントに到達するのを防ぎ、何も送信されませんでした
  • reply target is a symlink がセッションで繰り返される場合、そのセッションのソケットパスにリンクを作成したものを確認します。これは /status の Peer address に表示されます
Claude Code はファイルパスの 権限ルール をチェックし、ツールがファイルを開くか検索を開始するときに解決を再度確認します。パスがチェックが承認した場所にまだ導いていることを確認できない場合、Claude Code はパスをたどらずに操作を拒否します。拒否はツール結果に表示されます。
各拒否はその理由を指定します。
  • its symlink resolution changed after permission was checked: パスに沿ったシンボリックリンク、または Grep または Glob 検索ルートが、権限チェックと操作の間に置き換えられました。読み取り拒否では、括弧内のフレーズはどの比較が失敗したかを指定します。
  • its parent-directory symlink resolution changed after permission was checked: 書き込みパスが通過するディレクトリは、承認された場所に解決されなくなりました
  • where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve): Claude Code はパスをディスク上の最終的な場所まで追跡できませんでした。例えば、パス上のシンボリックリンクがループを形成しているためです
  • 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 拒否ルールはシンボリックリンクを通過するパスを指定し、そのリンクは 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 バイナリを絶対パスに解決できなかったため、拒否ルールをカバーしない検索を実行するのではなく、作業ディレクトリの外の検索を拒否します
What to do:
  • 通常は何もしません。拒否は Claude にツール結果として到達し、拒否された操作は実行されません
  • シンボリックリンク拒否が 1 つのパスで繰り返される場合、ビルドツールやファイルウォッチャーなど、リンクをそこで書き直し続けるものを見つけるか、Claude にファイルのリンクされたパスではなく解決されたパスを使用するよう依頼します
  • Windows 上の AppContainer または制限されたトークンサンドボックス内で Claude Code を実行しているときに、すべてのファイルでこの拒否が表示される場合、v2.1.265 以降にアップグレードします
  • プロンプトにドラッグしたスクリーンショットなど、何も書き直していないファイルに対して macOS で読み取り拒否が表示される場合、v2.1.273 以降にアップグレードします
  • ripgrep 拒否の場合、パッケージマネージャーで ripgrep をインストールして、rg が PATH 上の絶対パスに解決されるようにするか、作業ディレクトリの下で検索を保持します
v2.1.251 より前は、Claude Code はファイル書き込みに対してのみパスの解決を再チェックしたため、権限チェック後に置き換えられたリンクは、メッセージなしで読み取りまたは検索を別の場所にリダイレクトする可能性がありました。これらのうち、親ディレクトリ、シンボリックリンク経由、およびシンボリックリンクされたディレクトリ書き込み拒否のみが以前のバージョンに表示されます。 v2.1.280 より前は、where it leads on disk could not be determined 拒否は表示されませんでした。

The search failed, so this is not a “no matches” result

Claude が実行した Grep または Glob 検索が結果を返す前に失敗したため、一致が存在するかどうかは不明です。Claude が結果の代わりに受け取るメッセージは次のように始まります。
What to do:
  • 初めて表示された場合: 何もする必要はありません。メッセージはまず再度検索するよう Claude に求めます。
  • Claude が検索が失敗していると伝えた場合: バグレポート用に ripgrep のエラーを取得します。
    1. シェルから、検索が失敗したセッションと同じフラグに --debug-file claude-debug.log を加えてセッションを開始します
    2. 検索の失敗につながったリクエストを Claude に送信します
    3. 検索が再び失敗した場合は、claude-debug.log 内で rg error (signal= を含む行を見つけます
    4. 問題を報告する ときにその行を含めます

Task output swap refused

Claude Code は各 Bash コマンドの出力を一時ディレクトリの下のファイルに保存します。これらのファイルの 1 つを開くたびに、シンボリックリンク、追加のハードリンク、または移動されたディレクトリによってリダイレクトされることなく、パスがまだ作成したファイルに導いていることを確認します。このメッセージは、そのチェックが失敗したことを意味するため、Claude Code はそのパスを通じて出力を書き込みまたは読み取るのではなく、操作を拒否しました。メッセージは Bash ツール結果に表示されます。
括弧内のテキストは失敗したチェックを指定します。output symlink was re-pointed、output file identity changed、not a regular file などの理由はすべて同じ条件を報告します。出力パスにある、またはパスに沿ったものが、Claude Code が作成したファイルではなくなっています。一部の理由のみが To recover: 文を持ちます。 コマンドがまだ実行中にチェックが失敗する場合、Claude Code はコマンドを停止し、その結果は以下を報告します。
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 を他に何も管理しないディレクトリに設定して再起動します

Disk full or disk quota used up

Claude Code の一時ディレクトリを保持するボリュームで、空き容量、アイノード、またはディスク割り当てを確保します。コマンドの結果に含まれる Disk full:、Disk quota used up:、または Nearly out of inodes: で始まる行に、そのディレクトリが示されます。 Claude Code は各 Bash および PowerShell コマンドの出力をそのディレクトリの下のファイルに保存します。ボリュームまたはそれに対するユーザーの割り当てが満杯であるためにそのファイルを作成できない場合、コマンドは開始されず、Claude が読み取る結果は次のようになります。
Disk full:、Disk quota used up:、Nearly out of inodes: の各メッセージは、実行されてゼロ以外のコードで終了したコマンドの後に表示されます。例えば次のとおりです。
What to do:
  • macOS および Linux では、シェルで df -h <dir> を実行して、そのディレクトリを保持するボリュームとその使用状況を確認します。df -i <dir> は空きアイノードの数を表示します。<dir> はメッセージに示されたディレクトリです(例: df -i /tmp/claude-501)
  • Disk full: this computer's volume または disk is full (ENOSPC): そのボリューム上のどこでも構わないので、不要なファイルを削除します
  • Disk quota used up:、disk quota is used up (EDQUOT)、または Disk full: a test write: ボリュームにまだ空き容量が表示されている場合でも、そのボリューム上の自分のファイルを削除します
  • Nearly out of inodes:: そのボリューム上の多数のファイルを削除します。各ファイルはサイズに関係なく 1 つのアイノードを使用するため、重要なのはサイズではなくファイルの数です
  • または、CLAUDE_CODE_TMPDIR を容量のあるボリューム上のディレクトリに設定して Claude Code を再起動します
  • その後、Claude にコマンドを再度実行させます
v2.1.309 より前は、メッセージは次のとおりで、同じ手順が適用されます。
  • Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)
  • The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)
  • Command output was lost: the temp filesystem at <dir> is full または ... is out of inodes
  • The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran.、または (EDQUOT) を含む同じメッセージ。この形式はディレクトリを示さないため、/tmp などのシステムの一時ディレクトリ、または CLAUDE_CODE_TMPDIR で設定したディレクトリを保持するボリュームを確認します
v2.1.305 より前は、ディスクが満杯のために Claude Code が開始できなかったコマンドは、オペレーティングシステムのエラーテキストのみを返していました。そのテキストは、例えば ENOSPC: no space left on device, open <path>.output のようなものでした。

git is not installed on this Mac

このメッセージは、Claude Code のある手順で git が必要になり、見つかった git が /usr/bin/git にある Apple の代替スタブであったことを意味します。git を提供する開発者ツールはインストールされていません。 Claude Code はこの代替スタブを起動せず、代わりにこのテキストを表示します。例えば、より長いメッセージの中に表示されることがあります。
What to do:
  • ターミナルで xcode-select --install を実行し、開始されるインストールを完了してから、Claude Code で行っていた操作を再試行します

File is not valid UTF-8

Claude が、バイトを UTF-8 としてデコードできないファイルに対して Edit または NotebookEdit ツールを使用したため、Claude Code は変更を拒否しました。何も書き込まれていないため、ファイルは元のままです。これらのツールはファイル全体を UTF-8 として保存し直すため、デコードできなかったすべてのバイトが置換文字 U+FFFD に変わってしまうところでした。メッセージはツール結果に表示されます。
UTF-8 であるはずのファイルでも、無効なバイトシーケンスが 1 つでも含まれていればこのメッセージが表示されます。チェックはファイルのバイト全体を対象とするためです。 What to do:
  • ファイルを現在のエンコーディングのまま保持するには、メッセージが指示するとおり、そのエンコーディングでファイルを読み書きするシェルコマンドで Claude に変更を行わせます
  • Edit ツールでファイルの編集を続けるには、ファイルを UTF-8 に変換するか、UTF-8 であるはずのファイルの場合は無効なバイトを修正してから、Claude に再度編集を依頼します
v2.1.296 より前は、Edit と NotebookEdit はこのような編集を適用し、デコードできなかったすべてのバイトを U+FFFD として保存していました。これらのバージョンを使用している場合は、Claude Code をアップデートしてください。

Refusing to apply edits: a hook is configured for file edits in this session

Claude が アーティファクト を ワンステップ更新(公開に含まれる、アーティファクトのファイルへの小さな変更)で公開しようとしましたが、Claude Code が拒否しました。何も公開されておらず、ファイルも変更されていません。メッセージは Artifact ツール結果に表示されます。
セッションに Edit または Write を対象とする PreToolUse フック または mod がある間、Claude Code はワンステップ更新を許可しません。 What to do:
  • Claude がその後ファイルを編集して公開した場合は、何もする必要はありません
  • Claude がメッセージで停止した場合は、ファイルを編集して公開するよう Claude に依頼します
  • メッセージが繰り返し表示される場合は、Claude Code を終了して再起動します
  • 再起動後もメッセージが表示される場合は、ワンステップ更新をオフにします

The source file is not valid UTF-8 text

Claude は、バイトがテキストとしてデコードされないか、テキストが既に置換文字 U+FFFD を含むファイルから アーティファクト を公開しようとしたため、Claude Code は何もアップロードする前に公開を拒否しました。メッセージは Artifact ツール結果に表示され、修正する最初の位置を指定します。
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 で &#xFFFD; として書き込みます
v2.1.267 より前は、Claude Code はそのようなファイルをチェックなしでアップロードし、代わりにサーバーが公開を拒否していました。

Not published: that file is on a network share

Claude が、ネットワークホストを指定するパスにあるファイルから アーティファクト を公開しようとしました。
  • Windows では、起動時に --add-dir で渡したマップ済みネットワークドライブの下にない \\server\share パス
  • macOS または Linux では、/net/<host>/page.html などの自動マウントパス
このようなパスを参照すると、パスが指定するホストへの接続が発生し、Windows ではその接続によってホストに認証情報が送信される可能性があります。Claude Code はファイルの公開を拒否し、ファイルを読み取りません。拒否は Artifact ツール結果に表示されます。
What to do:
  • そのファイル自体が必要でない場合は、何もする必要はありません。メッセージは Claude に、代わりにセッション自身のフォルダからファイルを公開するよう指示します
  • そのファイル自体を公開するには、ローカルディスク上のフォルダにコピーして、再度依頼します
  • Windows で Claude が共有から直接公開できるようにするには、共有をドライブ文字にマップし、Claude Code の起動時にそのドライブを渡します。たとえば PowerShell では、net use Z: \\server\share を実行してから claude --add-dir Z:\ を実行します。これで Claude はそのドライブからファイルを公開できます。セッション中に /add-dir でドライブを追加するだけでは不十分です。
  • macOS または Linux では、/mnt や /Volumes の下などのディレクトリに共有をマウントし、自動マウントパスではなくそのパスから公開します

Not published: Claude sent the same content again after a newer version of the artifact turned it away

Artifact 呼び出しの下に表示されるこの赤い行は、Claude Code が繰り返しの公開を停止したことを意味します。アーティファクト は更新されず、Claude が公開元とするファイルにも何も書き込まれていません。Claude が公開せずに停止しない限り、何もする必要はありません。 セッションの前半に、アーティファクトに新しいバージョンがあったため、Claude Code は公開を拒否しました。新しいバージョンとは、たとえば 編集者 や別のセッションが公開したものです。行の末尾に、Claude が次に行う必要があることが示されます。
What to do:
  • Claude needs to work from that newer version first で終わる場合: Claude がそこで停止したら、アーティファクトの現在のバージョンを取得し、変更をマージして、再度公開するよう依頼します
  • should go through で終わる場合: Claude がそこで停止したら、再度公開するよう依頼します

Reading a local file from outside the connected folders in a Cowork session

Claude Desktop アプリでマシン上で実行されている Cowork セッションで、Claude が アーティファクト 用のローカルファイルを指定しました。Claude Code はファイルがセッションの接続されたフォルダ内のプレーンファイルであることを確認できませんでした。パスはそれらのフォルダの外にあるか、シンボリックリンクを通過するか、見た目とは異なるファイルを指定しうる方法で記述されています。そのようなファイルを読み取るには承認が必要であり、すべての承認をスキップするように設定されたセッションなど、承認カードを表示できないセッションでは、Claude Code は読み取りを拒否します。 拒否は Artifact ツール結果に表示されます。ファイルをまったく検査できない場合、代わりにその失敗を指定します。
What to do:
  • 通常は何もしません。メッセージは Claude に接続されたフォルダ内のプレーンファイルを代わりに使用するよう指示します
  • そのファイル自体をアーティファクトに入れるには、シンボリックリンクではなく通常のファイルとして、セッションの接続されたフォルダの 1 つにコピーして、再度依頼します

WebFetch cannot fetch localhost

Claude は WebFetch を、http://localhost:3000 や http://wiki/ のような単独のイントラネット名など、ドットのないホスト名を持つ URL で呼び出しました。WebFetch はリクエストを行う前にこれらの URL を拒否します。
What to do:
  • 通常は何もしません。メッセージは Claude を Bash ツール経由の curl に指示します。これはローカルおよびイントラネットサーバーに到達できます
v2.1.268 より前は、WebFetch はこれらの URL を汎用 Invalid URL エラーで報告していました。

Claude Code is unable to fetch from a host

WebFetch は、ページをリクエストする前に URL のホスト名を api.anthropic.com に送信し、Anthropic のドメイン安全ブロックリストと照合します。このメッセージは、そのホスト名はフェッチできないとチェックが回答したことを意味します。
チェックはリクエストの前に実行されるため、Claude Code はホストに接続していません。 チェックが送信する内容については、WebFetch ドメイン安全チェック を参照してください。

WebFetch domain safety check failed

URL をフェッチする前に、WebFetch は URL のホスト名を api.anthropic.com に送信して、Anthropic の ドメイン安全ブロックリスト に対してチェックします。チェックが完了できない場合、WebFetch はドメインが安全であることを確認できないため、ページをフェッチせず、ツール結果は代わりにこれらのメッセージの 1 つを持ちます。
  • rate-limited: チェックエンドポイントは HTTP 429 で応答しました。メッセージは Claude にページなしで続行し、後で最大 1 回だけ再度試すよう指示します。Claude Code は失敗したチェックをキャッシュしないため、そのドメインの後の取得はチェックを再度実行します。ネットワーク上のセッションがこれに頻繁に該当する場合、設定で skipWebFetchPreflight: true を指定してチェックをスキップできます。
  • Unable to verify: チェックリクエストが失敗した、タイムアウトした、または別のエラーステータスを受け取りました。ネットワークが api.anthropic.com をブロックする場合、そのドメインを許可リストに追加するか、設定で skipWebFetchPreflight: true を指定してチェックをスキップします。
v2.1.286 より前は、レート制限メッセージは The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way. と読みました。 v2.1.285 より前は、レート制限されたチェックは代わりに Unable to verify メッセージで報告されました。

バックグラウンドセッションのエラー

バックグラウンドセッションは専用の対話型ターミナルを持たずに実行されるため、ターミナルを必要とするコマンドはそこでは異なる動作をします。これらのメッセージは、バックグラウンドセッションのトランスクリプト、そのセッションにアタッチしたターミナル、ディスパッチ元のセッションまたはシェルに表示されます。また、以下の worktree ガードの項目については、worktree で分離された任意のセッション、または worktree で分離されたサブエージェントを実行している任意のセッションに表示されます。メッセージが 1 つのサーフェスに固有の場合は、その項目にその旨を記載しています。

バックグラウンドセッションで拒否されるコマンド

対話型ダイアログを開くコマンドは、バックグラウンドセッションにターミナルがアタッチされていない間はダイアログを開けません。/install-github-app、/mcp の設定リスト、MCP サーバーメニューの認証アクションは、メッセージを返します。/install-github-app と /mcp の設定リストの場合、セッションは エージェントビューの Needs input の下にも表示されるため、そこで見つけてアタッチし、コマンドを再度実行できます。ターミナルがアタッチされている間は、これらのコマンドは通常どおり動作します。 v2.1.216 より前は、/install-github-app または /mcp の設定リストが拒否された後、セッションは Needs input の下に表示されませんでした。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 の設定リストでは次のように表示されます。
対処方法:
  • エージェントビューからセッションにアタッチし、コマンドを再度実行します
  • または、/mcp reconnect <server>、/mcp enable、/mcp disable など、メッセージに示されている形式を使用します。これらはアタッチせずに動作します

パスを安全に解決できないため書き込みまたはコマンドがブロックされた

Claude が、worktree 分離ガードが検証可能な 1 つの場所に解決できない表記で、ファイルまたは作業ディレクトリを指定しました。このガードは、対話型かバックグラウンドかを問わず worktree で分離された任意のセッションと、worktree で分離されたサブエージェントにおいて、書き込みとコマンドの作業ディレクトリをチェックします。ガードは、操作が共有チェックアウトに及ばないことを確認する前にシンボリックリンクを解決し、解決に失敗した場合は、操作が共有チェックアウトに到達するのを許すのではなく、操作をブロックします。メッセージには、拒否されるパスの形式と再試行の方法が示されます。
ブロックされたコマンドは、作業ディレクトリについて同じ原因を報告し、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 で分離しても、このブロックは解除されません。メッセージには、代わりに使用するパスの形式が示されます。
ブロックされたコマンドは、作業ディレクトリについて同じ原因を報告し、re-run the command from its local, plainly-spelled path で終わります。v2.1.217 より前は、ガードはパスのテキストのみを比較していたため、UNC または /net のパスを通じてチェックアウト内のファイルを指定してもブロックされませんでした。 対処方法:
  • 通常は何もする必要はありません。Claude はメッセージが求めるローカルの表記で再試行します

worktree 分離チェックによってコマンドがブロックされた

Claude が worktree で分離されたセッションで Bash、PowerShell、または Monitor コマンドを実行し、Claude Code が次のいずれかの理由でそれを拒否しました。
  • コマンドがメインチェックアウトまたは別の worktree で実行されることになる。メッセージには、作業ディレクトリが resolved to the shared checkout または is in a different worktree と示されます。
  • Bash または Monitor コマンドが git をメインチェックアウトに向けている。
  • コマンドが実行する git がすべて worktree 内にとどまることを、Claude Code が Bash または Monitor コマンドのテキストから検証できない。git を一切含まないコマンドでも、この理由で拒否されることがあります。${!name} のような変数の間接参照を展開したり、${ command; } のような Bash 関数置換を実行したりすると、実行時に値が生成され、その値自体がコマンドになりうるためです。
メッセージは is isolated in the worktree <path>, but this command の後に理由が続きます。たとえば、Claude Code がテキストを検証できなかったコマンドの場合は次のようになります。
対処方法:
  • git がメインチェックアウトに向けられている場合、またはコマンドテキストを検証できない場合: 何もする必要はありません。Claude はメッセージを読み、最後の文が求める方法でコマンドを書き直します。依頼したコマンドがテキスト内の展開を理由に拒否され続ける場合は、指摘された値をリテラルで記述し、worktree 内から git を単独のシンプルなコマンドとして実行してください
  • 意図的にメインチェックアウトに対して操作するには、セッション外のターミナルで自分でコマンドを実行してください

This session has no saved transcript

← または /background でバックグラウンドに移動し、自身のターンを実行する前に停止したセッションにアタッチしました。Claude Code は移動元の会話を見つけられなかったため、このセッションには再開するものがありません。メッセージの末尾には、このセッションの claude respawn コマンドが示されます。
エージェントビューで同じセッションの行を開くと、代わりにリストの下に Press enter again to restart this session fresh が表示され、その行でもう一度 Enter を押すと、空の会話でセッションが再起動されます。 対処方法:
  • 停止したセッションを新たに開始するには、メッセージに示された ID を使って claude respawn <id> を実行するか、エージェントビューでその行の Enter を 2 回押します
  • セッションが応答を完了していたにもかかわらず、v2.1.214 より前のバージョンでこの拒否が表示される場合、~/.claude/projects 内の読み取れないフォルダーが原因で、トランスクリプトのスキャンが保存された会話を見落としている可能性があります。スキャン中に読み取れないフォルダーを許容する v2.1.214 以降に更新してください

This session is running in another terminal

エージェントビューで停止したセッションの行を開きましたが、その保存された会話はこのマシン上の別の実行中の Claude Code プロセスですでに開かれているため、Claude Code は同じトランスクリプトに書き込む 2 つ目のプロセスの起動を拒否します。表示されるメッセージは、会話を保持しているものによって異なります。
  • running in another terminal: バックグラウンドセッション以外のプロセスが会話を保持しています。たとえば、claude -p の実行や、claude --resume または /resume で会話を再開したターミナルです。行には Open in a terminal も表示されます。
  • already open in another running Claude session: 別のバックグラウンドセッションが会話を保持しています。
対処方法:
  • running in another terminal の場合: そのターミナルで続行するか、そのプロセスを終了するか完了を待ってから、再試行します
  • already open in another running Claude session の場合: そのセッションを使用するか、そのセッションを停止してから再試行します
v2.1.248 より前は、already open in another running Claude session の拒否のみが存在していました。ターミナルで再開された会話は開かれているとみなされず、行を開くと同じ会話に書き込む 2 つ目の Claude Code プロセスが起動していました。

This session’s saved conversation is no longer on disk

バックグラウンドサービスがオフの間に終了したバックグラウンドセッションを開きましたが、その後トランスクリプトのクリーンアップによって保存された会話が削除されています。たとえば、マシンが数週間オフだった場合などです。このような行を開くと、通常は保存された会話が再開されます。再開するものが何も残っていないため、Claude Code は確認なしにセッションの元のプロンプトを再実行するのではなく、拒否します。
claude attach <id> はこのテキストを出力します。エージェントビューでは、フッターはより短く、ctrl+x removes the row で終わります。 対処方法:
  • claude rm <id> を実行して行を削除します。保持されるケースのいずれかに該当する場合、claude rm は代わりに行と worktree を保持し、その理由を示します
  • セッションの元のプロンプトを新しい会話として再度実行するには、claude respawn <id> を実行します
v2.1.248 より前は、このような行を開くと拒否されずにセッションの元のプロンプトが再実行され、数週間前のタスクがフォアグラウンドに戻ってきていました。

Worktree has commits that are not pushed anywhere

worktree に、他の場所に保存されていることを Claude Code が確認できないコミットを含むバックグラウンドセッションを削除しようとしました。claude rm は次の進め方を示します。
Claude Code がコミットを要約できない場合、詳細行は代わりに The worktree has unpushed commits となります。エージェントビューでは、セッションの行に同じ理由とともに not removed が表示されます。 対処方法:
  • コミットを保持するには、プッシュしてください。プッシュによってコミットが origin/claude/fix-login などのリモート追跡ブランチに載ったら、セッションの削除を再試行します。
  • メッセージがコミットの破棄を提案している場合は、まず worktree、コミット、およびコミットされていない変更が不要であることを確認してください。その後、メッセージに示された手順を実行します。エージェントビューでセッションの行の Ctrl+X を 2 回押すか、claude rm が出力した claude rm <id> --discard-unpushed <commit>@<worktree-id> コマンドを実行します。Claude Code が再び拒否した場合は、新しいメッセージに従ってください。
  • worktree が別の終了済みセッションにも記録されているとメッセージに示されている場合、再度削除しても破棄されません。コミットをプッシュしてから、セッションの削除を再試行してください
v2.1.268 より前は、claude rm はコミットの要約を kept 行自体に表示していました。claude rm がコミットを要約できなかった場合、kept 行には要約の代わりに worktree has commits that are not pushed anywhere と表示されていました。 v2.1.260 より前は、メッセージにブランチやコミットは示されず、破棄の手段もありませんでした。その場合でもセッションは削除できますが、コミットされていない変更は失われ、ブランチとコミットは保持されます。拒否メッセージに出力されたパスを使って git worktree remove --force --force <path> を実行し、その後 claude rm <id> を実行します。ロックされた worktree では、Git は --force を 2 回必要とします。

Terminal host process died

各バックグラウンドセッションのターミナルは、バックグラウンドサービス配下のホストプロセスで実行されます。サービスが接続を保持したままそのプロセスが終了したため、セッションに到達できませんでした。 Linux と WSL では、バックグラウンドサービスが数秒ごとに各ホストプロセスをチェックし、プロセスが終了しているのにサービスへの接続が閉じられていない場合にセッションを失敗としてマークし、エージェントビューの行に理由を表示します。
シェルからは、ホストの終了によってすでに失敗としてマークされたセッションを claude attach <id> で再起動できます。それ以外の場合は、原因を出力して終了します。
いずれの場合も会話は保存されています。 シェルコマンドを実行している行では、代わりに 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> はエラーを報告せずに待機し続けていました。

Session isn’t responding

バックグラウンドセッションを開き、バックグラウンドサービスがそのオープンを受け付けましたが、約 10 秒間出力が届きませんでした。そのため Claude Code は、セッションのターミナルを中継するプロセスが出力を配信できないと判断し、待機を続けずに試行を終了します。 エージェントビューでは、Claude Code はフッターで再起動を提案します。
シェルからは、claude attach <id> が原因を出力して終了します。
シェルコマンドを実行している行は、再起動するとコマンドが再度実行されるため、Claude Code が自動的に再起動することはありません。 対処方法:
  • エージェントビューで、同じ行の Enter をもう一度押します。Claude Code は応答しないプロセスを停止してセッションを再起動し、会話が再開されます。この 2 回目の押下がない限り、何も停止されません
  • シェルから、claude stop <id> を実行し、その後 claude attach <id> を実行します
  • シェルコマンドの行の場合は、エージェントビューで Ctrl+X を押すか、claude stop <id> を実行して停止します。再実行するには、コマンドを再度ディスパッチしてください

Session was stopped while the respawn was in flight

プロセスが実行されていないバックグラウンドセッションを開き、Claude Code がそれを再起動している間に、別の Claude Code プロセスがそのセッションを停止しました。たとえば、別のターミナルでの claude stop です。Claude Code はセッションを停止したままにします。
ディスパッチしたばかりのセッションを、プロセスがまだ起動中の間に開いた場合は、代わりにプロセスを待機します。v2.1.246 より前は、そのタイミングで開くとセッションが停止し、このメッセージが表示されることがありました。 対処方法:
  • セッションを停止していない場合は、エージェントビューでその行を再度開くか、claude respawn <id> を実行して再起動します
  • 自分で停止した場合は、何もする必要はありません。セッションは停止したままになります

セッションのエージェントが利用できなくなった

--agent または agent 設定で起動され、カスタムエージェントを実行していたセッションを再開しましたが、Claude Code はその名前のエージェントを見つけられませんでした。Claude Code は、そのワークスペースを信頼している場合はまずセッションの元のディレクトリを検索し、次に再開元のディレクトリを検索します。セッションは引き続き再開されますが、デフォルトのツールが使用されるため、エージェントのツール制限は適用されなくなります。
この警告には 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 を一度実行して信頼ダイアログを承認してから、再度再開します

This session restarted after its next /loop wakeup was due

バックグラウンドセッション内の自己ペースの /loop が停止しました。ループが次のウェイクアップを待機している間にセッションのプロセスが終了し、セッションの次のプロセスが起動する前にそのウェイクアップの予定時刻が来ました。見逃したウェイクアップが遅れて実行されることはありません。通知には、セッションが再起動した時点でウェイクアップがどれだけ遅れていたかが示されます。
v2.1.295 より前は、この状況ではループが通知なしに停止していました。 対処方法:
  • ループを続行するには、セッションに返信し、keep the loop running のように続行する旨を伝えます。Claude は返信とともに通知を読み、次のウェイクアップをスケジュールできます
  • ループが不要になった場合は、何もする必要はありません。ループはすでに停止しています

No LLM gateway: a gateway set in your shell isn’t passed to a session opened from another folder

このメッセージを表示しているバックグラウンドセッションは、LLM ゲートウェイを使用していません。ゲートウェイのアドレスを受け取らなかったため、リクエストが失敗します。このメッセージは会話内で Claude の応答の代わりに表示され、セッションの ID とフォルダーが埋め込まれています。
セッションにアタッチしている間は、プロンプトの下の通知に短い形式の No LLM gateway: opened from another folder · respawn from ~/project が表示されます。 ANTHROPIC_BASE_URL がゲートウェイに設定されている状態で、メッセージに示されたフォルダー以外のフォルダーからセッションをディスパッチ、起動、または再起動しました。シェルでエクスポートしたゲートウェイがバックグラウンドセッションに届くケースについては、LLM ゲートウェイを参照してください。 対処方法:
  • ゲートウェイを設定するプロジェクトでエージェントビューを使用した場合: ANTHROPIC_BASE_URL とその API キーまたはトークンを 設定ファイルの env ブロックに記述します。~/.claude/settings.json、またはセッション自身のプロジェクト内の .claude/settings.local.json を使用してください。どちらも再起動されたセッションが読み込みます。その後、任意のフォルダーからシェルで claude respawn <id> を実行します。
  • ターミナルでゲートウェイをエクスポートした場合: ゲートウェイ変数をエクスポートしたターミナルで、メッセージに示されたフォルダーに cd し、メッセージの claude respawn <id> コマンドを実行します。セッションは保存された会話から再起動されます。
    • ゲートウェイがセッションに届くのは、スーパーバイザー自体が同じゲートウェイをエクスポートしたシェルから起動された場合のみです。そうでない場合は、Dispatch fails with Could not resolve authentication method の説明に従ってそのターミナルからスーパーバイザーを再起動し、その後 respawn コマンドを再度実行します。
v2.1.302 より前は、この状況のバックグラウンドセッションでは、代わりに Not logged in · Please run /login などのサインインエラーが表示され、フォルダーは示されませんでした。

CLAUDE_CODE_PROCESS_WRAPPER ランチャーのエラー

CLAUDE_CODE_PROCESS_WRAPPER が設定されていますが、その値を使用できないため、Claude Code はランチャーなしで実行するのではなく、影響を受けるプロセスの起動を拒否します。設定の問題は、変数名で始まり理由を示すメッセージで報告されます。たとえば次のとおりです。
起動はするものの、自身を 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 でバックグラウンドセッションを開始したときに表示されます。
一部のアカウントでは、メッセージに 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 のみをブロックするポリシーではこのエラーは発生しません。 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 以降でエラーが表示される場合は、制限ポリシーが Claude Code の実行可能ファイルをブロックしていないか、Windows 管理者に確認してください
  • ターミナルを閉じるとバックグラウンドサービスが停止する場合、Claude Code は PowerShell を使わずにサービスを起動しています。サービスがターミナルより長く存続できるように、PowerShell 7 をインストールするか、PowerShell のブロックを解除するよう管理者に依頼してください。

バックグラウンドセッション開始時の EACCES

Claude Code は、バックグラウンドセッションをホストするバックグラウンドサービスを起動するために自身のバイナリを実行できませんでした。npm インストールでは、通常これは、その時点で npm install -g @anthropic-ai/claude-code がバイナリを置き換えていたことを意味します。ユーザー自身が実行した場合も、自動アップデーターが実行した場合もあります。このエラーは、エージェントビューからセッションを開いたときに表示されます。
/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 プロセスが更新をダウンロードしている場合にも対応します。インストールがその待機時間を超えた場合、失敗メッセージには単なるエラーコードではなく更新の旨が示されます。
v2.1.257 より前は、待機はすべてのケースで 10 秒で打ち切られていたため、別の Claude Code プロセスがまだ更新をダウンロードしている間にこのエラーが表示されていました。v2.1.246 より前は、Claude Code は待機せずに即座に失敗していました。 対処方法:
  • 数秒待ってから、セッションを開くかディスパッチを再度実行します。Claude Code が更新中であるとメッセージに示されている場合は、更新が完了してから再試行してください。
  • npm インストールが実行されていないにもかかわらずエラーが続く場合、ユーザーがインストール済みのバイナリを実行できません。バイナリとそのディレクトリの権限を確認するか、Claude Code を再インストールしてください。

Background service exited before it became reachable

Claude Code がバックグラウンドサービスとして起動したプロセスが、接続を受け付ける前に終了したため、Claude Code はセッションを開けませんでした。サービスが終了前にエラーを出力した場合、括弧内の理由には終了コードまたはシグナルと、サービスが出力した最初の行が示され、その行が停止の原因を示しています。
エージェントビューからセッションを開いた場合は、同じ理由が 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 を実行して、現在サービスが実行中かどうかを確認します

バックグラウンドセッション開始時に作業ディレクトリが存在しなくなった

バックグラウンドセッションを開始したディレクトリが、セッションの起動中に削除されました。Claude Code はセッションを開始せず、メッセージには存在しないディレクトリが示されます。
v2.1.257 より前は、セッションは開始したように見え、その後エージェントビューに同じ理由の失敗した行として表示されていました。 v2.1.281 より前は、セッションを開始する前にすでにディレクトリが存在しなかった場合にも、このメッセージが表示されていました。そのケースでは could not be resolved on disk が報告されます。 対処方法:
  • メッセージに示されたディレクトリを再作成するか、存在するディレクトリからディスパッチしてから、再試行します

This forked session could not be started

claude.ai から Remote Control セッションをフォークしましたが、Claude Code はマシン上でフォークを実行するバックグラウンドセッションの起動を完了できませんでした。この通知は、フォークされたセッションのトランスクリプトに表示されます。
フォーク元のセッションは実行を続けます。 対処方法:
  • フォーク元のセッションに戻り、セッションがアイドル状態になったら再度フォークします

バックグラウンドセッションのディスパッチ時にワークスペースが信頼されていない

信頼していないディレクトリでバックグラウンドセッションを開始または再起動しましたが、確認のためのワークスペース信頼ダイアログを表示できませんでした。Claude Code はセッションを開始しません。
セッション自身のディレクトリにあるターミナルから同じコマンドを実行すると、代わりに信頼ダイアログが表示され、承認するとセッションが開始されます。このメッセージは、スクリプト内や、セッション自身のディレクトリ以外のディレクトリからセッションを再起動する場合など、ダイアログを表示できない場所で表示されます。 2 つのバリアントは、別の原因を示します。
  • The home directory is trusted one session at a time: セッションのディレクトリがホームディレクトリです。Claude Code はホームディレクトリに対する信頼を保存しないため、以前のセッションでそこでダイアログを承認していても有効になりません。
  • <path> could not be resolved on disk: Claude Code がディスク上でセッションのディレクトリを見つけられませんでした。
v2.1.286 より前は、Windows では、信頼レコードがパスの大文字・小文字が異なる形で保存されていた場合、すでに信頼したディレクトリでもこのメッセージが表示されることがありました。v2.1.286 以降に更新してください。 対処方法:
  • メッセージに示されたディレクトリで claude を実行して信頼ダイアログを承認してから、コマンドを再度実行します
  • ホームディレクトリに関するメッセージの場合は、ダイアログを表示できるようにホームディレクトリのターミナルからコマンドを実行するか、代わりにプロジェクトディレクトリからセッションを開始します
  • could not be resolved on disk のメッセージの場合は、ディレクトリを再作成するか、存在するディレクトリから新しいセッションを開始します

ラッパーと IDE エラー

これらのエラーは、IDE 拡張機能や Agent SDK アプリケーションなど、Claude Code を起動したプログラムから発生します。Claude Code 自体からではなく、ラッパーから発生するものです。

Subprocess initialization did not complete within 60000ms

このエラーは、VS Code 拡張機能 または Agent SDK アプリケーションが起動した Claude Code プロセスが、準備完了を時間内に報告しなかったことを意味します。拡張機能またはアプリケーションはその後、そのプロセスを停止しました。VS Code の会話では、このエラーは Claude Code did not finish starting で始まります。例:
拡張機能の出力ログ、サインイン画面、および Agent SDK アプリケーションでは、エラーの文面が異なります。Subprocess initialization did not complete within と制限時間で始まり、続いて Claude Code が報告した内容が示されます。例:
対応方法:
  • VS Code でもう一度試すには、メッセージを送信してください。サインイン中にエラーが表示された場合は、代わりにサインイン方法をもう一度選択してください。
  • Claude Code がどこまで進んだかを確認するには、会話のエラーの下にある View output logs をクリックするか、コマンドパレットから Claude Code: Show Logs を実行してください。問題を報告する際は、Subprocess initialization の行の前後のエントリを含めてください。
  • ネットワークを確認するには、ネットワーク設定を参照してください。メッセージにサインインまたは認証を確認するよう書かれている場合は、ログインと認証を参照してください。
  • メッセージに SessionStart フックまたは Setup フックが完了していなかったと書かれている場合は、フックの実行時間を確認してください。VS Code では、Claude Code がこれらのフックの実行を報告している最初の 10 分間は、60 秒の制限時間にカウントされません。遅いフックがより早く完了するようにするか、非同期でないフックの timeout を下げるか、フックを削除してください。
  • Agent SDK アプリケーションが startup() を呼び出す場合は、起動全体に十分な長さの initializeTimeoutMs を設定するか、未設定のままにして、報告されたフックの実行時間のうち最大 10 分間がカウントされないようにしてください。
VS Code 拡張機能 v2.1.304 および TypeScript Agent SDK v0.3.304 より前では、すべてのフックの実行時間が制限時間にカウントされていました。デフォルトの制限時間では、メッセージに Subprocess initialization did not complete within 60000ms — check authentication and network connectivity が含まれていました。この文面が表示される場合は、拡張機能または SDK を更新してください。

Claude Code process exited with code N

基盤となる claude プロセスがゼロ以外のコードで終了しました。終了コードだけでは何が失敗したかは分かりません。実際のエラーはプロセス自体の出力にあり、ラッパーはキャプチャした場合はそれを追加し、そうでない場合はログに保持します。
Windows では、ネイティブビルドはターンが完了した直後にコード 4294967295 で終了することがあります。その終了がターン境界に着地し、待機中のメッセージがなく、バックグラウンドタスクが実行されていない場合、VS Code 拡張機能 はこのエラーを表示する代わりに、セッションを静かに閉じます。次のメッセージで会話が再開されます。 v2.1.273 より前では、拡張機能は何も失われていないにもかかわらず、すべてのターン境界でそのエラーを表示していました。 対応方法:
  • VS Code では、エラーと共に表示される View output logs リンクをクリックして、基盤となるエラーを確認してください
  • Agent SDK アプリケーションでは、メッセージループの周りでエラーをキャッチしてください。CLI プロセス終了 の下のエントリは、各 SDK 言語でコードが受け取るものをカバーしています。
  • 同じプロジェクトのターミナルで claude を実行してください。通常、失敗はそこで実際のエラーメッセージと共に再現され、このページで検索できます。
  • ターミナルで claude doctor を実行して、インストールと設定を確認してください

Could not locate the Claude CLI on PATH

VS Code 拡張機能 は、Windows で統合ターミナルで Claude Code を開き、ターミナルのシェルが PowerShell で、拡張機能がインストールされた claude 実行ファイルを PATH で見つけられない場合、このエラーを表示します。拡張機能は、インストールされた claude を PATH で見つけるまで Claude Code の起動を拒否します。
対応方法:
  • VS Code の外で新しい PowerShell ウィンドウを開き、where.exe claude を実行してください。パスが出力されない場合、CLI は PATH にありません。PATH を確認する に従ってインストールディレクトリを追加してください。パスが出力される場合、エントリは PowerShell プロファイルから、または VS Code がまだ取得していない PATH 変更から来ています。次の 2 つのステップがこれらのケースをカバーしています。
  • PATH エントリを PowerShell プロファイルではなく、ユーザーまたはシステム環境変数として設定してください。拡張機能はプロファイルを実行しないため、そこにのみ存在する PATH 編集は拡張機能に到達しません。
  • PATH を変更した後、VS Code を再起動してください。拡張機能は VS Code が起動時にキャプチャした PATH をチェックするため、PATH 変更は再起動後にのみ有効になります。

The Claude Code program for this computer could not be found

VS Code 拡張機能 は、内部にバンドルされている Claude Code のコピーを探しましたが、このコンピューター向けにビルドされたものが見つかりませんでした。メッセージには、このコンピューターに必要なビルドが示されます。
対応方法:
  • 拡張機能が保持しているビルドがメッセージに示されている場合、別のプラットフォーム向けの拡張機能パッケージがインストールされています。メッセージに示されているビルド向けに作られたパッケージをインストールしてください
  • 拡張機能が保持しているビルドがメッセージに示されていない場合は、エディターの Extensions ビューから Claude Code 拡張機能を再インストールしてください
  • または、いずれの場合も、claudeCode.claudeProcessWrapper を別途インストールした claude バイナリに設定してください
v2.1.290 より前では、これは Unsupported platform: <platform>-<arch>. No compatible Claude Code binary found. として表示されていました。

The connection to Claude Code ended before this message completed

VS Code 拡張機能 はメッセージを claude プロセスに送信し、プロセスが確認または完了する前に接続がエラーなしで終了しました。拡張機能はメッセージが処理されたかどうかを判断できないため、再度送信するよう求めます。
対応方法:
  • メッセージを再度送信してください。次のメッセージは会話を再開する新しい 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 は追跡パスのリンクを通じて書き込みと削除を行い、部分的な復元を報告しませんでした。
対応方法:
  • スキップされたファイルを特定して、以下の手順で各ファイルを処理してください。メッセージはカウントのみを示します。~/.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 がファイルに書き込みまたは削除できませんでした。
Claude Code は、retention sweep でセッションのバックアップを削除します。デフォルトではセッションが最後にバックアップを保存してから約 30 日後です。その後にセッションを再開した場合、/rewind はそのチェックポイントをリストしますが、そのいずれかに rewind すると、このエラーで失敗する可能性があります。メッセージに N paths were skipped for link safety も表示されている場合は、これらのパスについて Restored the code, but skipped files を参照してください。 セッションをフォークする場合(例えば --fork-session または /branch を使用する場合)、Claude Code は元のセッションのバックアップをフォークにコピーします。Claude Code がバックアップをコピーできない場合(例えばディスクがいっぱいの場合)、そのバックアップはフォークに存在しません。それを必要とするチェックポイントに rewind すると、このエラーで失敗する可能性があります。 対応方法:
  • 別の方法で変更を元に戻してください。Claude に編集を逆にするよう依頼するか、バージョン管理からファイルを復元してください。バックアップがなくなると、/rewind を再度実行しても同じ方法で失敗します。
  • Claude Code がファイルに書き込みまたは削除できない場合は、ファイル権限など書き込みをブロックしているものを修正してから、/rewind を再度実行してください。
  • 今後のセッションでバックアップをより長く保持するには、cleanupPeriodDays を増やしてください。
v2.1.260 より前では、Claude Code はバックアップが見つからないファイルをサイレントにスキップし、rewind が成功したように見えました。

セッション保存の警告

Claude Code は、セッショントランスクリプトを保存していない場合、入力ボックスの下の永続的な行に以下の警告を表示します。セッションはどちらの場合でも機能し続けます。警告は、後で --resume でセッションが見つからない可能性があることを示しています。

トランスクリプト書き込みが失敗しています

Claude Code は作業中にトランスクリプトをディスクに保存し、トランスクリプトファイル への書き込みが失敗しています。メッセージは原因を基になるエラーコードで示します。例えば、ディスクがいっぱいの場合:
警告は、エラーに応じて異なるポイントで表示されます:
  • 自動的にクリアされない条件での最初の失敗:ディスクがいっぱい、ディスククォータを超過、ファイルシステムが読み取り専用、パスがファイルシステムの長さ制限を超過、または 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 はこのセッションのトランスクリプトまたはプロンプト履歴を書き込みません:
この変数は、一時的なスクリプト化されたセッションの意図的なオプトアウトですが、シェルプロファイル、ラッパースクリプト、またはそれをエクスポートした親プロセスを通じてセッションに到達することもあります。 対応方法:
  • 変数を意図的に設定した場合、アクションは不要です。通知は、セッションが --resume、--continue、または上矢印履歴に表示されないことを確認します
  • 設定していない場合は、claude を起動するシェルまたはスクリプトから変数を削除し、新しいセッションを開始します。現在のセッションからのメッセージは遡及的に保存されません。

CLAUDE_CODE_CHILD_SESSION マーカーを継承しているため、トランスクリプト保存がオフになっています

Claude Code は、生成するサブプロセスで CLAUDE_CODE_CHILD_SESSION を設定し、それを継承するインタラクティブセッションをネストされたものとして扱います:Claude Code はそのトランスクリプトを保存しないため、Claude 自体が開始するセッションは --resume リストを埋めません。この通知は、現在のセッションがマーカーを継承したことを意味します:
この通知は、別の Claude Code セッション内から claude を実行した場合に予想されます。マーカーが長寿命の仲介者(例えば、Claude Code セッションが元々開始したターミナル、screen セッション、またはランチャー)を通じてリークした場合、誤分類を示します。 tmux 内では、Claude Code は tmux サーバーのグローバル環境を通じて到達したマーカーを検出し、保存を続けるため、このケースではこの通知は表示されません。 対応方法:
  • このセッションを別の Claude Code セッション内から意図的に開始した場合、アクションは不要です
  • これがトップレベルセッションの場合、終了して CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 を設定して再起動します。保存は再起動から適用されるため、その前に送信されたメッセージは保存されません。
  • 同じターミナルまたはランチャーからの将来の起動を修正するには、その環境から CLAUDE_CODE_CHILD_SESSION を削除します

設定の警告

対話セッションで Claude Code が起動時に出した警告を見つけるには、まず起動バナーの下を確認し、次にデバッグログを確認します。
  • 起動バナーの下の行: ⚠ Deny rule Bsh matches no tool · check for typos など、権限ルールに関する一部の警告
  • デバッグログ: Claude Code はデバッグモードでのみこのログを保持します。ログ内の警告を読むには、シェルから claude --debug-file <path> で Claude Code を起動し、そのパスにあるファイルを開きます。
テキスト出力の非対話モードでは、バックグラウンドセッションの外であれば、起動時の警告を stderr で確認します。 v2.1.305 より前では、対話セッションでも stderr を確認してください。現在はバナーの下の行として表示される権限ルールの警告も同様です。

Claude Code exited after an unrecoverable interface error

Claude Code は、ターミナルインターフェースが回復できないエラーに遭遇して終了したときに、使用していたレンダラーがどちらであってもこのメッセージを表示します。2 文目は、フルスクリーンレンダラーの起動中にエラーが発生した場合にのみ表示されます。
対処方法:
  • Claude Code を再度起動します。会話を再開するには、同じディレクトリで claude --resume を実行します。
  • メッセージにフルスクリーンレンダラーが示されている場合、次回の起動時の動作(フルスクリーンをどのようにオンにしたかによって異なります)と、フルスクリーンを再度試す方法やクラシックレンダラーを使い続ける方法については、フルスクリーンレンダリングを参照してください。
v2.1.236 より前では、この種のエラーの後、Claude Code はメッセージを表示せずに終了していました。

Agent descriptions are over the 15.0k-token limit

Claude Code はこの警告を stderr ではなく、会話ビューの起動時通知として表示します。組み込みのものを除くサブエージェントの説明の合計が、Claude Code の推定で 15,000 トークンを超えています。各エージェントについて、名前と description フロントマターがカウントされます。合計が上限を超えているかどうかにかかわらず Claude Code はすべてのエージェントを読み込むため、この警告によって読み込まれる内容は変わりません。
対処方法:
  • エージェントファイルの description フロントマターを短くするか、Claude に短縮を依頼します。
  • 使用しなくなったエージェントファイルを削除します。

Hook needs quotes around a path with a space

会話ビューに表示されるこの通知は、フックのスクリプトのパスにスペースが含まれていて引用符で囲まれていないため、そのスクリプトが実行されなかったことを意味します。そのフックはシェル形式の asyncRewake フックです。その command では、python3 などのインタープリターの後に引用符で囲まれていないパスのプレースホルダーが続いており、解決されたパスにスペースが含まれています。 通知はフックのイベント名で始まり、スクリプトの名前が示されます。
対処方法:
  • 通知に示されたスクリプトを実行するフックの command で、パスを二重引用符で囲みます。JSON ファイルでは、"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\"" のように記述します。

Instruction file not loaded

対話セッションの会話ビューに表示されるこの通知は、存在するメモリファイルが読み込まれなかったことを意味します。読み取り制限が適用されています。
括弧内には理由が示されます。例:
  • a Read deny rule covers it: Read の拒否ルールが、記述されたとおりのファイルのパス、またはそのファイル上のリンクの参照先に一致している
  • it's read from outside your working directories, where reads are blocked: permissions.blockReadsOutsideWorkingDirectories がオンの状態で、ファイルが作業ディレクトリの外に解決される
  • where it leads couldn't be worked out: たとえば、ファイルが直接または他のリンクを介して自分自身に戻るリンクになっている
Claude がサブディレクトリ内のファイルを操作する際にそのサブディレクトリ独自のメモリファイルを読み込めない場合、同じ行がそのターン中に会話に表示されます。行に示されているよりも多くのファイルが保留された場合は、最後の行に and 3 more instruction files not loaded のように残りの件数が示されます。 対処方法:
  • 制限が意図したものであれば、何もする必要はありません。セッションはそのファイルの指示なしで実行されます。
  • a Read deny rule covers it のために保留されたファイルを読み込むには、そのルールを削除するか範囲を狭めます。その後、新しいセッションを開始します。
  • it's read from outside your working directories, where reads are blocked のために保留されたファイルを読み込むには、そのファイルまたはリンク先を作業ディレクトリ内に移動します。その後、新しいセッションを開始します。
  • where it leads couldn't be worked out のために保留されたファイルを読み込むには、そのファイルが自分自身に戻るリンクになっていないか確認します。そうなっている場合は、リンクを存在するファイルに向けるか、その場所に通常のファイルを置きます。その後、新しいセッションを開始します。
v2.1.292 より前では、通知は同じ行の理由の後の末尾にファイル名を示していました。

名前が予約されているため、スキル、コマンド、またはワークフローが読み込まれなかった

スキルフォルダ、フロントマターの name、.claude/commands/ 内のファイルやサブフォルダ、または保存されたワークフローが、anthropic-skills という名前、または anthropic-skills: で始まる名前を使用しています。Claude Code はこの名前を claude.ai から同期されたスキル用に予約しているため、その項目を読み込みません。 Claude Code はこの警告を stderr ではなく、会話ビューの起動時通知として表示します。
通知には、拒否された最初の項目について変更すべき対象が示されます。名前を変更するフォルダやファイル、編集する name: 行、または名前を変更するワークフローです。複数の項目が拒否された場合、通知の末尾に · 2 more のような件数が付き、デバッグログにそれぞれの項目が記録されます。 対処方法:
  • 通知に示された項目の名前を変更するか、通知が指す name: 行を編集してから、セッションを再起動します。
v2.1.282 より前では、Claude Code はこれらの名前のスキルやコマンドを読み込んでいました。

Skill or command name refused

この起動時通知は、Claude Code が少なくとも 1 つのスキルまたはカスタムコマンドの名前を拒否したため、そのスキルやコマンドが読み込まれなかったか、name フィールドなしで読み込まれたことを意味します。
  • 読み込まれなかった場合: Claude Code が、ディレクトリ名、コマンドファイルの名前やサブフォルダなど、スキルやコマンドの呼び名となる名前を拒否しました。そのスキルやコマンドは / メニューに表示されず、Claude も呼び出せません。デバッグログ内の該当行は <name> is not offered となります。
  • name フィールドが無視された場合: Claude Code がスキルのフロントマターの name を拒否しました。スキル自体は読み込まれますが、/ メニューには name の値が表示されず、その値を入力してもスキルは呼び出されません。デバッグログ内の該当行は <name value> is not shown for <skill> となります。
対処方法:
  • シェルから claude --debug で Claude Code を起動し、デバッグログで [names] を検索します。通知でカウントされた名前ごとに 1 行ずつ記録されています。行内では、ゼロ幅スペースを \u{200B} と表すなど一部の不可視文字がコードで表記されるため、それらの位置を確認できます。
  • フォルダやファイルの名前を変更するか name: 行を編集して、スキル名に含められない文字を取り除くか、256 文字を超える名前を短くします。その後、ファイルが Claude Code が変更を監視しているディレクトリにある場合を除き、セッションを再起動します。自分が作成していないプラグインのスキルの場合は、プラグインの作成者に名前の変更を依頼してください。

Workspace has not been trusted

Claude Code はプロジェクトの .claude/settings.json または .claude/settings.local.json に permissions.allow ルールまたは permissions.additionalDirectories エントリを見つけましたが、プロジェクト設定の許可ルールにはワークスペースの信頼が必要であるため、それらを適用しませんでした。メッセージに示される件数、設定名、ファイルは設定内容によって異なります。deny ルールと ask ルールは影響を受けません。
対処方法:
  • そのディレクトリで 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 はこのチェックを信頼ダイアログの承認後にのみ実行するため、最初の手順を使用してください。ホームディレクトリやその他の設定ホームは対象外で、ダイアログを待ちません。プロジェクトの許可ルールとワークスペースの信頼を参照してください。

Working directory is a network path

Claude Code はネットワークパスを作業ディレクトリとして追加しません。ネットワークパスを参照すると、そのパスが示すホストに接続する可能性があり、Windows ではその接続によってホストに認証情報が送信される場合があります。そのため、Claude Code はパスを参照せずに拒否します。 ネットワークパスを指定して /add-dir を実行すると、次のメッセージが表示されます。
代わりに --add-dir または permissions.additionalDirectories で起動時に渡した場合、Claude Code はそのディレクトリなしで起動します。対話セッションでは、このメッセージは他の起動時の警告とともにデバッグログに書き込まれるため、起動時には表示されません。 Claude Code がこの方法で拒否するパスには次のものがあります。
  • \\server\share などの UNC 共有
  • /net/<host> などの自動マウントパス(そのホストの自動マウント配下のディレクトリから Claude Code を起動した場合を除く)。その自動マウント配下の読み取りは、引き続きネットワークパスのチェックの対象になります。
  • シンボリックリンクやジャンクションを介してネットワーク上の場所に到達するローカルパス
マップされたドライブ文字と \\wsl$ パスはネットワークパスとして扱われません。 対処方法:
  • Windows では、共有をドライブ文字にマップし、起動時にそのドライブを渡します。たとえば PowerShell では、net use Z: \\server\share を実行してから claude --add-dir Z:\ を実行します。
  • macOS または Linux では、共有をローカルパスにマウントし、代わりにそのパスを追加します。
  • パスが permissions.additionalDirectories に含まれている場合は、そのパスを記載している設定ファイルから削除します。
v2.1.257 より前では、Claude Code は到達可能なネットワークパスを作業ディレクトリとして受け入れていました。

Remote managed settings failed to load

セッションはサーバー管理設定の対象ですが、Claude Code がそれらを取得できなかったか、サーバーから返された内容を適用できなかったため、対話セッションと Claude Desktop の Code タブでこの警告が表示されます。 括弧内の原因には、network error、request timed out、authentication rejected (401) など、失敗した内容が示されます。原因が no setting in the server response could be applied as written の場合は、サーバーは応答したものの、返された設定のいずれも検証に合格しなかったことを意味します。v2.1.282 より前では、この原因は server returned invalid settings と表示されていました。 行の残りの部分には、セッションがどのポリシーで実行されるかが示されます。
  • 以前の取得成功時にキャッシュされた設定がある場合: Claude Code は、保留される環境変数を除き、そのキャッシュされたポリシーでセッションを実行し、行には using cached policy と表示されます。
  • 適用できるキャッシュ済みの設定がない場合: Claude Code はサーバー管理設定なしでセッションを実行し、行には no remote policy applied と表示されます。たとえば、そのマシンがまだ設定を取得していない場合や、最後に取得してから 24 時間以上経過している場合です。
Code タブでは、メッセージを送信すると警告が会話内の行として表示され、取得の状態が変わると新しい行が表示されます。関連する 3 つのメッセージも同じように表示されます。
  • Remote managed settings are still loading: セッションが先に進んだ時点で、取得がまだ実行中だった
  • Remote managed settings did not load: 応答がないまま取得が終了した
  • Remote managed settings have now loaded: これらの警告のいずれかの後に設定が読み込まれた。行の残りの部分には、リモートポリシーが適用されるかどうかが示されます
対処方法:
  • メッセージに示された原因に対処します。ネットワークが原因の場合は、このマシンが api.anthropic.com に到達できるか確認します。認証が原因の場合は、/status でサインイン状態を確認します
  • no setting in the server response could be applied as written の場合は、管理者にサーバー上の設定の修正を依頼します
  • 完全な診断を確認するには、/status または claude doctor を実行します
v2.1.248 より前では、Claude Code は設定の取得失敗をデバッグログにのみ報告していました。

Claude Code が組織の設定を読み込めなかった

組織の設定(サーバー管理設定を含む)は最初に読み込まれる必要がありますが、Claude Code がそれらを読み込めなかったため、セッションは開始されていません。例:
メッセージが Claude Code can't start this session yet というタイトルのダイアログに表示されている場合、設定が読み込まれるとすぐにダイアログが閉じてセッションが開始されます。 非対話モードとバックグラウンドセッションでは、Claude Code は代わりにメッセージを出力し、ステータス 1 で終了します。 対処方法:
  • could not connect、または the reply came from a network proxy, not Anthropic: ネットワーク接続を確認し、企業ネットワークの場合は api.anthropic.com/api/claude_code/policy_limits と api.anthropic.com/api/claude_code/settings への HTTPS を許可するよう IT 部門に依頼します。その後、Retry now を選択するか、コマンドを再度実行します。
  • timed out、Anthropic returned an error、または Anthropic asked it to retry shortly: ダイアログに再試行させるか、後でコマンドを再度実行します。繰り返し発生する場合は status.anthropic.com を確認してください。
  • still loading、または couldn't verify your sign-in with Anthropic yet: ダイアログに再試行させるか、コマンドを再度実行します。サインインに関するメッセージが繰り返し表示される場合は、シェルで claude auth login を実行して再度サインインします。
  • Your Claude session has expired: このマシンに保存されているサインインは有効ではなくなったため、再試行しても解決しません。ダイアログで Sign in again を選択して Claude Code を閉じてから、シェルで claude auth login を実行します。このコマンドはセッションを開始できない間も動作します。
  • none of the settings the server returned could be applied as written: 組織のサーバー管理設定の修正を管理者に依頼してから、再試行します。

Managed settings were not approved

組織のサーバー管理設定に承認が必要な設定が含まれており、セキュリティ承認ダイアログを拒否したため、Claude Code はそれらを適用せずに終了します。
対処方法:
  • Claude Code を再度起動し、ダイアログを承認して組織の設定のもとで続行します。拒否したダイアログは記憶されないため、次回の起動時にも再び表示されます。
  • ダイアログに表示された設定について不明な点がある場合は、承認する前に組織の管理設定を管理している担当者に確認してください

Managed settings need your approval

組織のサーバー管理設定に、セキュリティ承認ダイアログでの承認が必要な設定が含まれています。実行した claude plugin コマンドはキーボードから入力を読み取れなかったため、そのダイアログを表示できませんでした。これは、コマンドの入力をパイプまたはリダイレクトしていて、かつ macOS と Linux では /dev/tty も開けない場合に発生します。コマンドは変更を加える前に停止しました。
対処方法:
  • ターミナルで claude を実行し、ダイアログが表示されたら設定を承認してから、同じ claude plugin コマンドを再度実行します。Claude Code は承認と承認済みの設定を設定ディレクトリに保持します。停止したコマンドが別のユーザーとして実行された場合や CLAUDE_CONFIG_DIR が設定された状態で実行された場合は、両方が同じディレクトリを使用するように、claude も同じ方法で実行してください。

Managed settings block the default model

組織の管理設定が、Default オプションが解決されるモデルと、その段階的フォールバック先となり得るすべてのモデルをブロックしています。Default オプションで開始されるはずのセッションは、ブロックされたモデルを実行する代わりに起動時に終了します。表示されるメッセージは、ブロックしている設定によって異なります。deniedModels リストによってブロックされている場合、メッセージは次のようになります。
availableModelsMatch が "exact" に設定された availableModels リストにそのモデルが含まれていない場合、メッセージは次のようになります。
対処方法:
  • 設定を管理している場合は、ユーザーが実行できるモデルを availableModels に追加するか、すべてのフォールバックをブロックしている deniedModels エントリの範囲を狭めます。Default オプションが段階的にフォールバックする仕組みについては、特定のモデルまたはバージョンをブロックするを参照してください
  • 設定を管理していない場合は、メッセージを管理者に送ってください。自分の設定ファイルでは、管理された availableModels リストや deniedModels リストを拡張できません

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

組織の管理設定が allowedProviders リストを設定しており、セッションの API プロバイダーがそのリストに含まれていないか、セッションがそのエントリで必要とされる方法で固定されていないエンドポイントを使用しています。Claude Code は、起動時、ログイン前、またはセッションが次に API に接続するときに拒否します。メッセージは許可されたプロバイダーの一覧から始まります。
リストが空の場合、メッセージは次のようになります。
すべてのエントリが認識されない場合、括弧内は代わりに (allowedProviders lists only unrecognized entries) となります。 対処方法:
  • メッセージの To continue: の手順に従います
  • 設定を管理している場合は、メッセージの Admins: で始まる行に、追加すべきエントリまたは固定すべき値が示されています。どのソースの env ブロックで固定できるかについては、allowedProviders の項目を参照してください

MCP server is blocked by enterprise managed policy

/mcp でサーバーの Reconnect を選択したか、無効化されたサーバーをそこで再度オンにしたものの、MCP サーバーを制限する設定がそのサーバーをブロックしています。Claude Code は接続を拒否し、次のメッセージを表示します。
次のいずれの設定でもこのメッセージが表示される可能性があります。
  • サーバーに一致する deniedMcpServers エントリ(自分の ~/.claude/settings.json やプロジェクトの .claude/settings.json にあるものを含む)
  • サーバーが一致しない allowedMcpServers リスト
  • mcp がロックされた strictPluginOnlyCustomization(~/.claude.json と .mcp.json で設定されたサーバーをブロックします)
  • サーバーが claude.ai コネクタである場合の disableClaudeAiConnectors
対処方法:
  • 自分のユーザー設定ファイルとプロジェクト設定ファイルにこれらの設定がないか確認し、変更または削除します
  • 自分の設定でブロックの理由が説明できない場合は、どの管理設定がサーバーをブロックしているかを管理者に確認してください
v2.1.257 より前では、/mcp の Reconnect や再有効化によって、セッション中のポリシー更新でブロックされたサーバーに接続できてしまう場合がありました。

MCP サーバー名が予約されている

このメッセージは、組み込みサーバーの名前など、Claude Code が予約している名前を持つ MCP サーバーの 1 つを示しています。
対処方法:
  • サーバーを定義している場所でサーバーの名前を変更します。たとえば、workspace を my-workspace に変更します
  • 避けるべき他の予約名については、MCP の設定の警告を参照してください

Managed settings document could not be parsed

組織が管理設定をデプロイしており、デプロイされたドキュメントの 1 つが存在するものの JSON オブジェクトとして解析できないため、Claude Code は、そのドキュメントに含まれるポリシーなしで実行する代わりに、起動時に終了コード 1 で終了します。行のメッセージの前に、失敗したソースが示されます。
ソースは次のいずれかです。
  • managed-settings.json ファイルのパス、または managed-settings.d 配下のドロップインファイルのパス
  • macOS の管理対象環境設定プロファイル(per-user managed preferences または device-level managed preferences)
  • Windows レジストリの値(Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings)
各ソースが解析できなくなる原因については、Claude Code が破棄したエントリを見つけるを参照してください。 Claude Code は、別の管理ソースが有効なポリシーを提供している場合でも起動を拒否します。このエラーは、対話セッション、claude -p、Agent SDK セッション、バックグラウンドセッション、および claude doctor を含むほとんどのサブコマンドで表示されます。この拒否は意図的なフェイルクローズです。Claude Code が解析できないドキュメント内の設定は強制できず、それでも起動すると組織の制御なしでセッションが実行されることになります。 解析可能なドキュメント内のスキーマの問題では、このエラーは発生しません。その場合の Claude Code の動作については、Claude Code が破棄したエントリを見つけるを参照してください。 managed-settings.d/ ディレクトリが存在するものの一覧を取得できない場合、Claude Code は代わりに Managed settings drop-in directory could not be read: に続けて根本的なエラーを報告します。読み取りの失敗によって起動時に終了する場合については、Claude Code が破棄したエントリを見つけるを参照してください。 対処方法:
  • マシンを管理している場合は、示されたドキュメントを JSON オブジェクトとして解析できるように修正するか、ファイル、プロファイル、またはレジストリの値を削除します。空の managed-settings.json は {} として扱われ、起動を妨げません。
  • マシンを管理していない場合は、デプロイされたドキュメントの修正を管理者に依頼してください。自分の設定ファイルの内容がこのエラーの原因になることはなく、それによってエラーを解消することもできません。

Unable to read managed policy settings

組織が管理設定をデプロイしており、デプロイされたソースの 1 つが存在するものの、オペレーティングシステムによる読み取り拒否ではなく I/O エラーなどの理由で読み取れませんでした。ポリシーを提供する他の管理ソースがない場合、Claude Code は、そのソースに含まれている可能性のあるポリシーなしで実行する代わりに、起動時に終了します。
同じ状態では、サインインフロー、すでに実行中のセッションからの API リクエスト、および claude gateway サーバーが、allowedProviders を示す 1 行目の変形版のメッセージとともに拒否されます。 root 専用ファイルなど、オペレーティングシステムによって読み取りが拒否された場合は、この終了は発生しません。セッションはそのソースのポリシーなしで開始されます。解析できないソースの場合、Claude Code はソースを示す別のメッセージで終了します。 対処方法:
  • マシンを管理している場合は、Detail: 行に示された問題を修正してデプロイされたソースを読み取れるようにするか、ソースを削除します
  • マシンを管理していない場合は、メッセージを管理者に送ってください。自分の設定ファイルの内容がこのエラーの原因になることはなく、それによってエラーを解消することもできません
v2.1.285 より前では、claude.ai または Claude Console の認証情報でサインインしたセッションのみがこのメッセージで終了し、オペレーティングシステムによって読み取りが拒否された場合にもこのメッセージが表示されていました。

Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded

-p の実行で表示されるこの stderr のブロックは、管理設定のソースに Claude Code が読み込めないフックエントリが含まれていることを意味します。そのフックは実行されず、ある行でソースの hooks フィールドが無視されたと示されている場合は、そのソースのフックはいずれも実行されません。 各行には、ソース、該当する場合はフィールド、および問題(不明なフックの type や、hooks キーの外で宣言されたフックなど)が示されます。
対処方法:
  • ソースを管理している場合は、ブロックに一覧表示された各エントリを修正または削除します。hooks の下で Claude Code が想定する形式については、フックの設定を参照してください。
  • 行のソースが parent managed settings となっている場合は、Claude Code を起動したアプリケーションがそのエントリを親設定として渡しているため、そのアプリケーションの開発者に報告してください
  • それ以外の場合は、ブロックを管理者に送ってください
v2.1.300 より前では、-p の実行ではこのケースが Managed settings failed to load; policies from the failed source are NOT in effect: ヘッダーの下に一覧表示されていました。

otelHeadersHelper failed

otelHeadersHelper スクリプトが失敗した場合、またはスクリプトの要件を満たさない出力を返した場合、Claude Code はこの警告をターミナルインターフェースの通知として、対話セッションごとに 1 回表示します。 スクリプトが失敗し続けている間はエクスポートが失敗し、テレメトリのバックエンドはそのセッションから何も受信しません。 See /status: の後のテキストには、スクリプトの終了コードとそれに続くエラー出力など、失敗した内容が示されます。
対処方法:
  • /status を実行して失敗の詳細を確認します。
  • スクリプトが 30 秒以内に終了コード 0 で終了し、文字列のヘッダー値を持つ JSON オブジェクトを stdout に出力するように修正します。スクリプトの要件を参照してください。
  • 組織が管理設定を通じてスクリプトをデプロイしている場合は、管理設定を管理している担当者に修正を依頼してください。
-p を使用した非対話モードでは、同じ失敗が代わりに stderr に otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error> として表示されます。

headersHelper not run

Claude Code は MCP サーバーを静的な headers のみで接続し、サーバーの headersHelper をスキップしました。ヘルパーはシェルコマンドであり、フォルダに保存された信頼がないためです。フォルダに信頼が保存されるのは、~/.claude.json でそのエントリを手動で設定した場合、またはホームディレクトリ以外で、対話セッションでそのフォルダの信頼ダイアログを承認した場合です。このチェックがどのサーバーに適用されるかについては、headersHelper を実行する前にフォルダを信頼するを参照してください。 Claude Code はこの行を非対話モードでのみ、サーバーごとに 1 回書き込みます。対話セッションでは、同じ拒否を代わりにデバッグログに書き込みます。
メッセージに表示される projects キーは、プロジェクトの許可ルールとワークスペースの信頼で説明されている、Claude Code が信頼のキーとして使用するフォルダです。親フォルダの信頼ダイアログを承認してもこのチェックは満たされず、-p セッションや SDK セッションでも満たされません。 対処方法:
  • メッセージに示されたフォルダで claude を実行して信頼ダイアログを承認し、その後 -p または SDK のコマンドを再度実行します
  • メッセージに表示された projects キーをそのまま使用して、~/.claude.json の hasTrustDialogAccepted エントリを自分で設定します
  • ホームディレクトリでセッションを開始した場合は、信頼済みのプロジェクトディレクトリから作業してください。ホームディレクトリで信頼ダイアログを承認した場合、Claude Code はその信頼を現在のセッションの間のみ保持します。

Malformed Tool(content) rule

設定ファイルのいずれかにある権限ルールが、閉じ括弧の後にテキストが続いている、または括弧の一方が欠けているなどの理由で、Tool または Tool(content) の形式になっていません。Claude Code はそのルールをスキップし、対話セッションの開始時に表示される無効な設定のダイアログと、claude doctor の出力に一覧表示します。
対処方法:
  • メッセージとともに示された設定ファイルで、ルールが閉じ括弧で終わるように書き直します。たとえば、Bash(ls) x の代わりに Bash(ls *) とします
  • content 内の括弧はそのままにしておきます。括弧はリテラルとして扱われるため、Edit(./Finance (2024)/**) のようなルールはエスケープなしで有効です
v2.1.260 より前では、Claude Code は括弧が対応していないルールを Mismatched parentheses として報告していました。

Matches no tool · check for typos

起動バナーの下に表示されるこの行は、Claude Code がツール名を認識できない拒否ルールまたは確認ルールの権限ルールを示しており、そのルールは意図したツールに適用されません。Bsh と記述された拒否ルールは Bash には適用されず、正規名ではなくトランスクリプトに表示されるツールのラベルを使用したルールも同様です。行には、記述したとおりのルールが繰り返し表示されます。
テキスト出力の非対話モードでは、Claude Code は代わりに長い形式の警告を stderr に出力します。
対処方法:
  • ルール内のツール名を修正します。たとえば、Bsh の代わりに Bash とします。正規名はツールリファレンスで確認できます。
  • ルールが定義されている場所を確認するには、セッションで /permissions を実行してルールを選択します。詳細には、From project local settings や、--disallowedTools の値の場合は From CLI argument など、ルールの出所が示されます。
  • 詳細に From enterprise managed settings と表示されている場合は、自分ではそのルールを変更できないため、管理設定を管理している担当者にこの行を転送してください。
バックグラウンドセッション、または --output-format json や stream-json を使用している場合、Claude Code は警告を stderr ではなくデバッグログに書き込みます。--debug を付けて実行すると、~/.claude/debug/<session-id>.txt に記録されます。 v2.1.305 より前では、対話セッションは行を表示する代わりに、起動時に長い形式を stderr に出力していました。

Is not matched by file permission checks

Claude Code は、設定ファイルのいずれか、管理設定、または --allowedTools、--disallowedTools、--settings フラグの値の中に、パスを指定した Write、NotebookEdit、MultiEdit、または Glob の権限ルールを見つけました。Claude Code はファイルの権限を Edit ルールと Read ルールに対してのみチェックするため、それ以外のファイルツールを指定したパスルールは参照されません。Claude Code はそのルールを保持し、それ以外は何も変更しません。
  • 対話セッション: 完全な警告はデバッグログに書き込まれ、この形式の拒否ルールまたは確認ルールは、起動バナーの下に次の行としても表示されます。
    この形式の許可ルールには行は表示されません。ルールが定義されている場所を確認するには、セッションで /permissions を実行してルールを選択します。
  • テキスト出力の非対話モード: stderr の完全な警告には、ルール、括弧内のソース、および記述すべき置き換え後のルールが示されます。
  • バックグラウンドセッション、または --output-format json や stream-json: 機械可読な出力をクリーンに保つため、完全な警告は stderr ではなくデバッグログに書き込まれます。--debug を付けて実行すると、~/.claude/debug/<session-id>.txt に記録されます。
対処方法:
  • Write(path)、NotebookEdit(path)、およびレガシーの MultiEdit(path) ルールを Edit(path) に置き換えます。Edit ルールはすべてのファイル編集ツールに適用されます。
  • Claude Code が Glob ルールを警告なしで受け入れる --allowedTools を除き、Glob(path) ルールを Read(path) に置き換えます。
  • 完全な警告の括弧内に示されたソースでルールを修正します。ソースは設定ファイルのパスか、--allowed-tools と --disallowed-tools の場合はフラグそのものです。ディスク上に存在しない claude-settings-<hash>.json パスは、インラインの --settings 値を表します。そのフラグに渡す JSON を修正してください。
  • Write や Glob などのツール名のみのルールはそのままにします。Claude Code はこれらをツールレベルで照合し、警告を出しません。
  • 管理設定由来のルールの場合、完全な警告の括弧内は managed policy settings となり、/permissions のルールの詳細には From enterprise managed settings と表示されます。自分では解消できないため、管理設定を管理している担当者にその警告を転送してください。
v2.1.210 より前では、Claude Code はこれらのルールを警告なしで受け入れていました。v2.1.305 より前では、対話セッションは完全な警告を stderr に出力していました。

Has a wildcard before the rest of the command

Claude Code は、設定ファイルのいずれか、管理設定、または --allowedTools や --settings フラグの値の中に、Bash(git * main) や Bash(git -C * status *) のように、どのコマンドであるかを決定する後続の単語よりも前に * がある Bash 許可ルールを見つけました。* はその位置に挿入されたオプションを含む任意のテキストに一致します。Bash(git * main) は git -c core.fsmonitor=<script> diff main も承認してしまい、この場合 -c によって git はコマンドで指定されたプログラムを実行します。照合のルールについては、ワイルドカードパターンを参照してください。 この警告は、ワイルドカードが意図よりも広い範囲に一致するルールを絞り込めるようにするためのものです。Claude Code はルールを保持し、照合の方法も一切変更しません。テキスト出力の非対話モードでは、stderr の警告にルールと括弧内のソースが示されます。
対話セッションでは、完全な警告はデバッグログに書き込まれ、ルールは起動バナーの下に次の行として表示されます。
ルールが定義されている場所を確認するには、セッションで /permissions を実行してルールを選択します。 対処方法:
  • サブコマンドの前にある * を、意図する正確な値に置き換えます。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 となり、/permissions のルールの詳細には From enterprise managed settings と表示されます。自分では解消できないため、管理設定を管理している担当者にその警告を転送してください。
バックグラウンドセッション、または --output-format json や stream-json を使用している場合、機械可読な出力をクリーンに保つため、Claude Code は警告を stderr ではなくデバッグログに書き込みます。--debug を付けて実行すると、~/.claude/debug/<session-id>.txt に記録されます。v2.1.246 より前では、Claude Code はこれらのルールを警告なしで受け入れていました。 v2.1.305 より前では、対話セッションは行を表示する代わりに、完全な警告を stderr に出力していました。

Denying Bash also turns off the PowerShell tool

--disallowedTools Bash を使用した場合や、設定ファイルのいずれかでツール名のみの Bash または Bash(*) の拒否ルールを使用した場合など、Bash ツール全体を削除しました。Git Bash がインストールされた Windows では、Bash を拒否すると PowerShell ツールもオフになるため、セッションはシェルツールなしで開始されます。 テキスト出力の非対話モードでは、Claude Code は起動時にこの警告を stderr に出力し、対話セッションではデバッグログにのみ書き込みます。
対処方法:
  • Claude に PowerShell を使用させるには、PowerShell ツールを有効にするで示されているように、環境または設定ファイルの env ブロックで CLAUDE_CODE_USE_POWERSHELL_TOOL を 1 に設定します。これにより、Bash の拒否ルールと併用しても PowerShell ツールはオンのままになります。
  • ツール全体ではなく特定のコマンドをブロックするには、同じ設定ファイルまたはフラグで、ツール名のみの Bash エントリを Bash(git push *) のような範囲を限定したルールに置き換えます。Claude は Bash ツールを維持し、PowerShell ツールは、この変数も設定するか、範囲を限定した PowerShell 権限ルールを追加するまでオフのままです。
バックグラウンドセッション、または --output-format json や stream-json を使用している場合、Claude Code は警告を stderr ではなくデバッグログに書き込みます。--debug を付けて実行すると、~/.claude/debug/<session-id>.txt に記録されます。v2.1.287 より前では、Claude Code は同じように PowerShell ツールをオフにしていましたが、警告は表示していませんでした。 v2.1.305 より前では、対話セッションでも起動時に警告を stderr に出力していました。

crossSessionInbound must be one of accept, hold, refuse

設定ファイルで crossSessionInbound が、タイプミスの "reject" など、Claude Code が認識しない値に設定されています。警告の 2 文目は、値がどのファイルにあるかによって異なります。ユーザー、プロジェクト、ローカル、または --settings のファイルの場合は次のようになります。
管理設定では、Claude Code は認識されない値を最も制限の厳しい値である refuse として扱い、警告には、管理者が修正するまでセッション間メッセージが拒否されることが示されます。この保留が他の設定ファイルの値とどのように組み合わされるかについては、crossSessionInbound を参照してください。 対処方法:
  • キーを "accept"、"hold"、または "refuse" に設定するか、削除します
  • 警告に管理設定が示されている場合は、値の修正を管理者に依頼してください
v2.1.248 より前では、Claude Code は認識されない値を警告なしで無視していました。

ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name

ANTHROPIC_FOUNDRY_RESOURCE を、エンドポイント URL やそのホスト名など、Microsoft Foundry のリソース名のみ以外の値に設定しました。Claude Code はリクエストを送信する前にその値を拒否しました。このメッセージは起動時の警告としてではなく、Claude の応答の代わりに表示されます。
対処方法:
  • ANTHROPIC_FOUNDRY_RESOURCE にリソース名のみを設定し、Claude Code を再起動します。エンドポイントが https://my-resource.services.ai.azure.com/anthropic の場合、名前は my-resource です。
  • 代わりに完全なエンドポイント URL を指定するには、ANTHROPIC_FOUNDRY_BASE_URL にその URL を設定して ANTHROPIC_FOUNDRY_RESOURCE を削除し、Claude Code を再起動します。Claude Code は 2 つの変数のうち一方のみを受け付けます。

The 200K limit isn’t enforced

CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定しました。この設定は通常、自動圧縮によって 1M コンテキストモデルのセッションを 200K のウィンドウに抑えますが、このセッションを 200K 以下に制限するコンテキスト圧縮のしきい値がないため、会話が 200K を超えて大きくなる可能性があります。
Claude Code は、ネイティブの 1M ウィンドウを持つと認識するすべてのモデルについて 200K の上限を自動的に強制し、認識しないモデル ID については想定するウィンドウで圧縮します。警告は、他の設定がこの強制を無効にしている場合に表示されます。
  • モデル ID が、LLM ゲートウェイのエイリアスなど Claude Code が認識しないものであり、かつ CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 を設定したか、CLAUDE_CODE_MAX_CONTEXT_TOKENS で想定ウィンドウを 200K より大きくした場合。この場合、メッセージには対処方法として or update to a Claude Code version that recognizes <model> も示されます。
  • ANTHROPIC_BETAS または --betas フラグで要求した context-1m ベータが、そのベータを受け付けるモデルで引き続き API に 1M ウィンドウを要求しており、かつセッションを 200K で圧縮するものが何もない場合
対処方法:
  • CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 を設定するか、autoCompactWindow 設定を 200000 にして、自動圧縮が 200K の境界で圧縮するようにします
  • メッセージにこのバージョンが認識しないモデル ID が示されている場合は、claude update を実行します。その ID を 1M コンテキストモデルとして認識するバージョンでは、追加の設定なしで上限が強制されます。
  • 代わりにセッションでモデルの完全なウィンドウを使用したい場合は、CLAUDE_CODE_DISABLE_1M_CONTEXT の設定を解除します。この警告は 200K の上限が強制されていないことを報告するだけです
テキスト出力の非対話モードでは、この警告は stderr に表示されます。対話セッション、バックグラウンドセッション、または --output-format json や stream-json を使用している場合は、代わりにデバッグログに書き込まれます。--debug を付けて実行すると、~/.claude/debug/<session-id>.txt に記録されます。 v2.1.305 より前では、対話セッションは起動時に警告を stderr に出力していました。

リクエストでの認識されないモデル ID

Claude Code は、使用中の Claude Code のバージョンが認識しないモデル ID でリクエストを送信し、その ID を認識可能なモデルにマッピングする modelOverrides エントリも見つかりませんでした。Claude Code は設定されたとおりの ID でリクエストを送信し続け、終了したりモデルを切り替えたりはしません。
stderr を読み取るスクリプトやハーネスでは、[claude-code:unrecognized_model] プレフィックスで照合してください。プレフィックスと 1 つのスペースの後に、Claude Code は 1 行の JSON オブジェクトを書き込みます。Claude Code は今後のバージョンでフィールドを追加する可能性があるため、想定していないフィールドは無視してください。少なくとも次の 2 つのフィールドが書き込まれます。
  • model: 設定されたとおりのモデル文字列
  • query_source: そのモデルを使用したリクエストの経路。たとえば、-p の実行のメインの会話では値は sdk となり、サブエージェントでは agent: で始まります。
Claude Code は、実行方法に応じて次の 2 つの場所のいずれかにこの行を書き込みます。
  • -p を使用した非対話モードでは、すべての --output-format で stderr に書き込むため、この行を除外せずに stdout を解析できます
  • 対話セッションまたはバックグラウンドセッションでは、代わりにデバッグログに書き込みます。--debug を付けて実行すると、~/.claude/debug/<session-id>.txt に記録されます
Claude Code はこの行を、プロセスごとにモデル ID ごとに 1 回書き込みます。サブエージェントやバックグラウンド機能が使用する ID など、さらに認識されない ID があれば、それぞれ別の行を書き込みます。 Amazon Bedrock の us.anthropic.claude-... ID、@ バージョンサフィックス付きの Google Cloud の Agent Platform ID、Claude のモデル ID を含む Microsoft Foundry のデプロイ名など、Claude Code が認識可能なモデルに解決できるプロバイダー ID については、この行は書き込まれません。Amazon Bedrock のアプリケーション推論プロファイル ARN については、Claude Code は ARN そのものではなく、その背後にあるモデルをチェックします。入力ミスのある ARN など、解決できない ARN については行を書き込みません。 対処方法:
  • LLM ゲートウェイのエイリアスなど、意図的にその ID を設定している場合は、その ID を値とする modelOverrides エントリを設定ファイルに追加します。キーには opus のようなファミリーエイリアスではなく、Anthropic のモデル ID を使用してください。例の行の my-proxy-model の場合は、次のエントリを追加します。
    これにより、Claude Code は my-proxy-model を claude-opus-4-6 として扱い、この行の書き込みを停止します。
  • ID が使用中の Claude Code のバージョンより新しいモデルを指している場合は、claude update を実行します
  • ID がタイプミスの場合は、モデルを設定できる場所またはエイリアス変数のうち、その ID が設定されている箇所で修正します。query_source が agent: で始まる場合は、代わりにサブエージェントのモデルを設定している箇所で修正します。
v2.1.233 より前では、Claude Code は認識しないモデル ID でリクエストを送信しても、行を書き込んでいませんでした。

管理ロック下ではサンドボックスの許可エントリが無視される

/status と claude doctor に表示されるこの警告は、管理設定で allowManagedReadPathsOnly または allowManagedDomainsOnly が設定されているため、警告に示されたファイル内の allowRead または allowedDomains エントリが適用されないことを意味します。
ネットワークのロックの場合、警告には sandbox.network.allowedDomains と allowManagedDomainsOnly が示され、only allowed domains (and WebFetch domain rules) from managed settings are honored と表示されます。 対処方法:
  • この警告に対処する必要はありません
  • それらのパスやドメインが必要で、組織の管理設定でロックが設定されている場合は、それらを管理設定に追加するよう管理者に依頼してください。示されたファイルからもエントリを削除するまで、警告は表示されたままになります。
  • 警告を解消するには、示されたファイルからエントリを削除します。プロジェクトの .claude/settings.json など共有しているファイルの場合は、ロックのないチームメイトのためにエントリを残し、警告を表示させたままにしておくこともできます。

Sandbox mask files left behind at write-deny paths

claude doctor と /status に表示されるこの警告は、マスクファイル、つまりサンドボックスが書き込みを拒否するパスに置かれた 0 バイトの読み取り専用のプレースホルダーファイルを一覧表示します。この警告は、Linux および WSL2 で、ファイルシステムの分離を有効にした状態でサンドボックス化が有効になっている場合に表示されます。それらのファイルを保持しているプロジェクトで Claude Code セッションが開いていない状態になったら、シェルから削除してください。 サンドボックスは、サンドボックス化されたコマンドの実行中にプレースホルダーを作成し、コマンドの終了時に削除します。次のような場合には、プレースホルダーが残ります。
  • SIGKILL などにより、コマンドの終了前にセッションが強制終了された
  • バックグラウンドで実行中のコマンドなど、サンドボックス化されたコマンドがまだ実行中の状態でセッションを終了した
claude doctor では、警告は次のように表示されます。
対処方法:
  • 一覧に表示されたファイルを保持しているプロジェクトで開いているすべての Claude Code セッション(/status に警告が表示されたセッションを含む)を終了してから、シェルで作業します。別のセッションのサンドボックスがまだ使用しているプレースホルダーは、そのセッションの書き込み保護として機能している部分です
  • シェルで、一覧に表示された各ファイルを rm で削除し、rm が書き込み保護されたファイルについて確認を求めた場合は確定します。警告には最大 3 つのファイルが示され、残りは件数として表示されるため、警告が表示されなくなるまで削除後に claude doctor を再実行してください
  • 「Yes, and don’t ask again」で保存した権限の選択が保持されなかった場合は、プレースホルダーを削除した後に再度保存します
v2.1.309 より前では、警告は Stale sandbox mask files left by a killed session と表示されていました。 v2.1.257 より前では、claude doctor はこれらのファイルを警告しませんでした。それ以前のバージョンでも、セッションが強制終了されると同じプレースホルダーが残ります。

Two Claude Code config files exist

Claude Code はこのメッセージが示す 1 つ目のファイルを使用しているため、2 つ目のファイルの内容は有効になっていません。1 つ目は .config.json で、これは .claude.json の旧名です。メッセージには、どちらのファイルに自分のセットアップが含まれているかを確認する方法が含まれています。
Windows では、grep コマンドを含む文の代わりに The one with hasCompletedOnboarding or mcpServers in it is usually yours. が表示されます。 対処方法:
1

自分のセットアップを含むファイルを見つける

  • Windows の場合: 両方のファイルを開き、hasCompletedOnboarding または mcpServers が含まれているのはどちらかを確認します
  • その他のプラットフォームの場合: シェルでメッセージにある grep コマンドを実行し、どちらのファイルのカウントが大きいかを確認します
2

ホームディレクトリを共有するすべてのホストを更新する

複数のホストがこのホームディレクトリを共有している場合は、まずすべてのホストで Claude Code をメッセージに示されたバージョン以降に更新します。
3

Claude Code を停止する

すべてのホストで Claude Code のプロセスを停止します。
4

不要なファイルを移動する

不要なファイルをそのフォルダの外に移動します。元に戻せるように、削除ではなく移動してください。
5

Claude Code を再度起動する前に待つ

移動したファイルを元のパスにあるものとして一覧表示するホストがなくなるまで、どのホストでも Claude Code を起動しないでください。
2 つのファイルのいずれかがなくなると、このメッセージは表示されなくなります。

Make this change again later: ~/.claude.json could not be updated

stderr に表示されるこの通知は、サインインや信頼プロンプトへの回答など、~/.claude.json への変更がファイルに保存されなかったことを意味します。
対処方法:
  • 後のセッションで同じ変更を再度行います。たとえば、/login を再度実行するか、信頼プロンプトに再度回答します。

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

Claude の回答がいつもより能力が低いように見えるが、エラーが表示されていない場合、原因は通常、モデル自体ではなく会話の状態です。Claude Code はモデルバージョンを静かに変更することはありません。これらのケースでフォールバックモデルに切り替わることができます。
  • 設定された --fallback-model は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます
  • Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出するか、アカウントが セッション中にそれへのアクセスを失う
  • Fable モデル、Opus 5.5、Sonnet 5.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 アカウント担当者に送信できるローカルアーカイブを保存します。
  • /feedback が組織のポリシーによって無効化されていると応答した場合は、そのメッセージの項目を参照してください。
  • シェルから claude doctor を実行して、インストールの読み取り専用診断を実行するか、Claude Code 内で /doctor チェックアップを実行してセットアップの問題を検出して修正します。
  • status.claude.com でアクティブなインシデントを確認します。
  • GitHub の既存の issue を検索します。