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 を表示します。
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 はターンを通常どおり終了します。
ゲートウェイ経由で待機中のバナーが表示されたり消えたりする
Claude が思考している間にWaiting for API response バナーが表示されたり消えたりし、ゲートウェイ経由で接続している場合は、Claude Code を更新して v2.1.309 以降にしてください。次の接続では、データのない状態が 45 秒続いた後にバナーが表示されます。
- LLM ゲートウェイなど、Anthropic API 以外のホストに設定された
ANTHROPIC_BASE_URL - Claude apps gateway のセッション
ANTHROPIC_AWS_BASE_URLが設定された Claude Platform on AWS
再試行の動作を調整する
次の環境変数を使用して、再試行の動作を調整できます。非ストリーミングの試行が待機する時間
非ストリーミングの試行は、リクエストタイムアウトと本文のアイドルタイムアウトのうち、早く到達した方の時点で終了します。- リクエストタイムアウト: 正の値を設定している場合は
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 レスポンスを示しています。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 はこのメッセージを表示する前に既に数回再試行しています。- 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 は接続期限前に応答しませんでした。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_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を上げて最初の試行も十分に長く待機するようにしてください。
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 を参照してください。
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またはパーサーの生のエラーで終了します。
- レスポンスの前半で、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を送信してください。
- デフォルトのテキスト出力では、Claude Code は、ターンの前半から保持している最後に完了したテキストのブロックを出力し、その後このメッセージを出力します。何も保持していない場合、Claude Code はこのメッセージのみを出力します。例えば、Claude Code がターン中に会話をコンパクト化し、そのテキストをクリアした場合です。v2.1.219 より前では、Claude Code は
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 に設定するか、変数の設定を解除して デフォルトの分類器モデル を使用してください。
- アクションを再試行してください。これは通常、次の試行で成功します
claude --debugを実行し、アクションを繰り返して、デバッグログで詳細を確認してください
-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 に返します
- これはアクションに関する決定ではありません。会話に既にあるコンテンツが、auto モードが分類器に会話を送信したときに API のセーフティフィルターをトリガーしました
- 再試行は役に立ちません。同じ会話コンテンツがフィルターを再度トリガーします
- 対話セッションでは、別の 権限モード に切り替えて、プロンプトが表示されたときにアクションを承認できるようにしてください
- トリガーするコンテンツなしで新しい会話を開始してください
- 対話セッションでは、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) など)を示します。
Auto mode check unavailable とカウントダウンを表示し、Esc を押すとターンが中断されます。
10 回連続で判定のないレスポンスが続くと、auto モードはターンを停止します。
- 対話セッションでは、メッセージはトランスクリプトに警告として表示され、ターンが終了します
- 非対話
-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 モードから切り替えてください
a hook changed this call's input after auto mode reviewed it
この拒否は、サーバーがレビューした後にフックまたは mod が 呼び出しの入力を変更した ため、実際に実行される内容がレビューの対象外になっていることを意味します。アクションが安全でないという判断ではありません。
同じ 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 に返します。
gave no verdict (the conversation is too long for the check)拒否Auto mode classifier transcript exceeded context windowメッセージ
- メッセージが予告している圧縮が成功した場合は、何もする必要はありません。
- これら 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 にタスクを再試行するか、サブエージェントを再開する よう依頼してください
使用制限
このセクションのエラーのほとんどは、アカウントまたはプランに紐づいたクォータに達したことを意味します。ただし、3 つは異なる仕組みで動作します。Server is temporarily limiting requests はプランのクォータとは無関係なサーバー側のスロットリングです。Usage credits required for 1M context はクォータの枯渇ではなく利用資格のチェックです。The prompt to confirm went unanswered は、クォータに達したかどうかにかかわらず、使用クレジットの同意プロンプトが応答のないまま閉じられたことを意味します。
You’ve hit your session limit
サブスクリプションプランには、ローリング方式の使用量枠が含まれています。これを使い切ると、次のいずれかのメッセージが表示されます。/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 を参照してください
You've used 85% of your session limit · resets 3:45pm のようなメッセージで、大部分を使用したことを警告する場合があります。残りの使用量枠を確認するには、カスタムステータスラインに rate_limits フィールドを追加するか、デスクトップアプリで使用量リングをクリックします。
Usage credits required for 1M context
選択したモデルが 100 万トークンの拡張コンテキストウィンドウを使用しており、ご利用のプランでは使用クレジットを通じてのみこれが利用可能です。/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を設定します
run /usage-credits to turn them on, or /model to switch to standard context で、再起動については触れていませんでした。
The prompt to confirm went unanswered
Fable の使用クレジット同意プロンプトが誰にも応答されないまま閉じられると、Claude Code は次のいずれかのメッセージでターンを終了します。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"に設定します
Server is temporarily limiting requests
API が、プランのクォータとは無関係な短期間のスロットリングを適用しました。- 少し待ってから再試行します
- 解消しない場合は status.claude.com を確認します
Request rejected (429)
API キー、Amazon Bedrock プロジェクト、または Google Cloud プロジェクトに設定されたレート制限に達しました。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 より前のバージョンを実行しています
spend limit reached (daily; resets 2026-08-09 00:00 UTC))。
対処方法:
- メッセージに日付がある場合は、リセットまで待つか、メッセージに運用者の注記があればそれに従います
- メッセージに日付がない場合、日付を過ぎてもブロックされている場合、または日常的に上限に達する場合は、ゲートウェイ運用者に上限の引き上げを依頼します
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
このセッションで使用できる有効な認証情報がありません。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 がどれを使用するかについては、認証の優先順位を参照してください
Could not resolve authentication method
セッションが認証情報なしで API クライアントに到達しました。バックグラウンドセッションとクラウドセッションでは、ワーカーが認証情報なしで起動したときにこのメッセージが表示されます。対話モード、-p、Agent SDK の実行では、同じ状態を Not logged in として報告し、この文字列はデバッグログにのみ書き込まれます。そのため、デバッグログでこれを見つけた場合は、代わりにそちらの項目に従ってください。
- バックグラウンドセッションまたはクラウドセッションでこれが表示され、認証情報がすでに設定されている場合は、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 はコマンドが出力した内容を、前後の空白を取り除いた上でそのまま送信していました。
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が有効にならない場合を参照してください
- マシンにどの管理ソースがあるかを管理者に伝えるには、Claude Code のプロンプトで
Couldn't load your organization's settings:接続を確認してから、Claude Code を再起動します。再起動後もメッセージが再び表示される場合は、管理者に伝えてくださいRestart Claude Code to finish signing in:Claude Code を再起動します
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 つ目の · の後には、次の完全な例のように、メッセージが問題を説明します:
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 が送信しているキーを拒否します。· の後の復旧のヒントは、キーの取得元によって異なります:
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 を再度実行しても、同じエラーが返されます。
-p 非対話モードでは、これは oauth_org_not_allowed エラーコードとして表示されます。
対処方法:
- 組織で Claude Code へのアクセスを有効にするよう管理者に依頼します
- サブスクリプションの代わりに Console API キーで認証します。設定については Claude Console 認証を参照してください。
- 管理者であるにもかかわらずアクセスを有効にするオプションが見つからない場合は、Anthropic サポートに連絡してください
Scheduled tasks are off for your organization
組織でクラウドスケジュールタスクがオフになっているため、作成も実行もできません。claude.ai からのメッセージではスケジュールタスクまたはルーティンと呼ばれ、その後に管理者に関する文が続きます:- Team または Enterprise の Owner に、Organization settings > Capabilities > Remote sessions にある Scheduled tasks (Was Routines) または Routines というラベルのトグルをオンにできるか確認します
Remote Control requires the Anthropic API
セッションが Anthropic API と直接通信していません。Remote Control にはこれが必要です。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.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 が自動的に再接続します。
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 アカウントと組織に属します。
/remote-controlを実行して、現在のアカウントまたは組織で新しい Remote Control セッションを開始します- 元に戻すには、
/loginを実行して以前のアカウントまたは組織に再度サインインします。その後/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 をオンに戻します
- アプリがアカウントを切り替えた場合、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 です:
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 です:
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 がすでにログインキーチェーンの認証情報を読み取ったり保存したりした後に、スリープやアイドルなどでキーチェーンがロックされると、これが発生することがあります。- macOS では、ログインキーチェーンのロックを解除してから、
/loginを再度実行します - その他のプラットフォームでは、
/loginを再度実行します - それでもログインが保存されない場合は、キーチェーンのロック解除コマンドやその他の認証情報ストレージの復旧手順について、ログインしていない、またはトークンの有効期限切れを参照してください
Sign in again to take your previous account or API key off the config file
サインイン後にこの警告が表示された場合、以前にサインインしていたアカウントが~/.claude.json にまだ保存されている可能性があります:
~/.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 にアカウントが保持されていないことを確認できませんでした。保存が反映されなかったか、確認のためにファイルを読み戻せなかったかのいずれかです。
~/.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を実行します。
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を削除するよう依頼します
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 が設定ディレクトリからプロファイルを検出し、その認証モードが
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_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>形式では、トークンがまだ拒否されていても再接続成功と報告されます。
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 で新しいタスクまたはチャットを開始します
/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 がそのストアを読み取れなかったため、サーバーへのリクエストが実行されなかったことを意味します: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 認証を参照してください。
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 を起動します。そのランタイムではこのチェックが実行されません。これにより混同攻撃に対する保護が失われるため、サーバー側での修正を優先してください
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 がサーバーのメニューの下に表示します。
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 です。
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 が機能することを確認します
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 に付与されていることを確認します
- プロジェクトでモデルが有効になっていることを確認します。モデルへのアクセスをリクエストするを参照してください
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 設定を参照してください
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 sso login --profile myprofileやgcloud auth application-default loginなど、プロバイダーのサインインコマンドを実行してから再試行します。Claude Code の外部で認証情報を確認する方法については、Bedrock、Agent Platform、または Foundry の認証情報が読み込まれないを参照してください- 詳細が
AWS default-chain credential resolve timed outとなっている場合は、チェーンが失敗したのではなくハングしているため、代わりに AWS default-chain credential resolve timed out の手順に従ってください
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 はこのエラーを表示する前に認証情報キャッシュをクリアして再試行するため、このエラーが表示された時点で、チェーンは繰り返しの試行でも停止しています。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 秒の制限内に完了しませんでした。ウィザードは待機を停止し、検証ステップを失敗させます。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 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 を返し、監査ログにその理由が記録されます。アップストリームによる認可の拒否は、アップストリームのエラーメッセージに従ってそのまま渡されます
Please run /login または Failed to authenticate メッセージが代わりに表示され、再度サインインしても拒否は解消されませんでした。
ネットワークと接続のエラー
これらのエラーの多くは、Claude Code からのネットワークリクエストが宛先に届かなかったか、Claude Code と API の間にある何かが戻りのレスポンスを改変したことを意味します。アーカイブの書き込み失敗など、ローカルの原因もある項目では、その本文で説明しています。通常、原因はローカルネットワーク、プロキシ、ファイアウォール、またはクラウド環境のネットワークポリシーにあります。Unable to connect to API
API への TCP 接続が失敗したか、完了しませんでした。一般的な接続エラーコードの場合、メッセージは失敗の種類を示し、コードを括弧内に残します。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 は理由を出力して終了します。
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 つでも届いていれば、試行が失敗した時点でストリームが沈黙していた時間も報告されます。
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 とモデルプロバイダーの間にあるプロキシやゲートウェイを、ストリーミングレスポンスの本文とそのヘッダーを変更せずに通過させるよう設定します
- Amazon Bedrock では、ヘッダーと本文の要件についてゲートウェイまたはプロキシの背後でのストリーミングエラーを参照してください
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 はリクエストを再試行しません。
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 がそれを信頼していません。Check your proxy or corporate SSL certificates で終わっており、OpenSSL のコードや NODE_EXTRA_CA_CERTS のヒントは含まれていませんでした。
v2.1.199 以降、証明書の検証失敗は再試行されないため、このエラーは再試行の上限をすべて使い切った後ではなく、最初の試行で表示されます。以前のバージョンでは、表示するまでに数分間再試行していました。ハンドシェイクのタイムアウトなど、一時的な TLS の状態は引き続き再試行されます。
/login と起動時の接続確認では、同じ失敗で別のメッセージが表示されます。
- 組織の CA バンドルをエクスポートし、
NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pemで Claude Code にそれを指定します - 詳しいセットアップ手順についてはネットワーク設定を参照してください
- 証明書の検証を完全に無効にする
NODE_TLS_REJECT_UNAUTHORIZED=0は設定しないでください
クラウドセッションでホストが許可されていない
クラウドセッションまたはクラウドのスケジュールタスクでは、403 や ENOTFOUND などの DNS エラーは、要求したホストがクラウド環境の許可リストに含まれていないことを意味する場合があります。確認するには、そのリストとホストを照合してください。このヘッダー付きの 403 はブロックを裏付けますが、ブロックされたリクエストの 403 すべてにこのヘッダーが付くわけではありません。
- GitHub とコネクタのトラフィック: GitHub の操作と MCP コネクタのトラフィックは別のチャネルを使用するため、他のホストがブロックされていても動作し続けることがあります
- Default 環境: Default 環境は、Allow package managers がチェックされた Limited アクセスを使用します。そのセッションは、パッケージレジストリ、クラウドプロバイダーの API、コンテナレジストリ、一般的な開発用ドメインからなるデフォルトの許可リストに到達できます。
- クラウドのスケジュールタスクのフォーム、またはクラウドセッションを開始する環境セレクターから、環境を編集用に開きます。
- Edit cloud environment ダイアログで、Network access の下の Limited を選択し、ブロックされたドメインを Allowed domains に追加します。1 行に 1 つのドメインを入力します。独自のドメインに加えてデフォルトの許可リストも許可するには、Allow package managers をチェックします。制限のないアクセスが必要な場合は、代わりに Full を選択します。
- Save changes をクリックします。次回の実行では更新された許可リストが使用されます。すでに開いているクラウドセッションについては、ネットワークアクセスの変更が既存のセッションに反映されるタイミングを参照してください。
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 許可リストを使用している組織は、このホストをプロキシ経由のままにしておく必要があります。
The cloud environments service returned an empty or unexpected response
Claude Code は、CLI からクラウドセッションを作成するときや/remote-env を実行するときなど、いくつかの時点でクラウド環境の一覧をリクエストします。サーバーの応答を読み取れない場合、次のいずれかのメッセージが表示されます。
/remote-env ダイアログでの couldn't list environments: など)。
対処方法:
- 操作を再試行します。Claude Code は毎回一覧を改めてリクエストします
- メッセージが繰り返し表示される場合は、status.claude.com で進行中のインシデントを確認してください
Failed to fetch session from Sessions API
このメッセージは、Claude Code がターミナルに取り込むよう指示されたクラウドセッションを見つけたものの、Anthropic のサーバーからその会話履歴を読み取れなかったため、セッションを開かなかったことを意味します。claude --teleport、/teleport の後、または /tasks の一覧でセッションを選択した後に表示されます。claude --teleport <session-id> はこれを出力して終了コード 1 で終了します。
対処方法:
- 同じ teleport をもう一度実行します。同じように失敗する場合は、問題を報告してください
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 のトラブルシューティングを参照してください
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 の認証情報が利用できない場合は、代わりにローカルアーカイブを保存します。このメッセージは、共有が完了しなかったことを意味します。/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 でレポートを提出してください
Feedback payload too large
フィードバックの下書きのレビュー画面に表示されるこのメッセージは、サービスが下書きを受け付けたという確認を Claude Code が得ていないことを意味します。受信されていないものとして扱ってください。下書きは/feedback のキューに残るため、もう一度送信できます。
- レビュー画面で Send transcript を
noに設定してから、下書きをもう一度送信します。詳細を短くしても削減できるのは最大 10 KB のテキストで、これは下書きの詳細に入れられる上限です。
スリープまたは時刻変更中の MCP サーバー接続タイムアウト
このメッセージは、MCP サーバーへの接続がタイムアウトし、その試行中にシステムクロックが先に進んだことを 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 サーバーが接続しないときに確認することを参照してください。コンピューターがスリープせず、時刻も変更されていないのにこのメッセージが再び表示される場合は、エラーを報告するを参照してください。
MCP server "<name>" connection timed out after <N>ms のようなタイムアウトメッセージを表示していました。
リクエストエラー
これらのエラーはリクエストの内容に関連しています。ほとんどは API がリクエストを拒否した後に返されます。いくつかはリクエストが送信される前に Claude Code によってローカルで生成されます。Prompt is too long
会話と添付ファイルがモデルのコンテキストウィンドウを超えています。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 は代わりに会話全体を要約します。
/clear を実行して新しく開始してください。v2.1.269 より前では、やり取り全体を要約できない場合は常に圧縮が失敗したため、その状態のセッションはすべてのターンでこのエラーに再度ヒットしました。
単一のやり取りからなる会話には、要約する以前のターンがありません。そのような会話で自動圧縮が実行されるはずだった場合、Claude Code は試行をスキップし、代わりにリクエストを何が占めているかを説明します。API がエラーでトークン数を報告しない場合、メッセージは次のようになります:
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)で失敗します。
DISABLE_COMPACT を設定した場合、どちらの形式も /compact の代わりに /clear を示します。
対応方法:
- コンテキスト圧縮ウィンドウの警告の後: 複数ターンの会話では、
/compactを実行して以前のターンを要約し、空き領域を確保します。代わりに新しく始める場合は、/clearを実行します。 - 使用量を削減するその他の方法については、Prompt is too longを参照してください
/context は 100% を超える使用量を表示し、それが何を意味するか、または復旧方法を説明する警告行がありませんでした。
Request too large
トークン化前の生のリクエストボディが API の 32MB 制限を超えました。通常は、大きな貼り付けコンテンツ、ツール結果、または添付ファイルが原因です。この制限は コンテキストウィンドウとは別です。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 は再試行しません。非対話モードでは、メッセージは代わりに入力を削減するか、新しいセッションを開始するよう指示します。
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 に送信する前に添付画像をダウンスケールできませんでした。2000x2000px の代わりに 2576x2576px など、異なるピクセル制限が示されることがあります。
対応方法:
- メッセージが画像を変換するよう求める場合は、PNG、JPEG、GIF、または WebP に変換して再度添付してください。Claude Code はファイルヘッダーからこれらの形式の寸法を確認でき、画像をデコードする必要はありません。
- メッセージが寸法またはサイズ制限を報告する場合は、その制限を下回るように画像をリサイズまたは再圧縮してから添付してください。
- メッセージが CMYK JPEG、アニメーション WebP、または破損している可能性のあるファイルなどの原因を示す場合は、メッセージが提案する形式で画像を再保存して再度添付してください。
Request rejected as unprocessable by the model
API は、モデルが処理できないものとしてリクエストを拒否しました。メッセージは API 自体のものです。- 画像やドキュメントを含む会話でメッセージが繰り返し表示される場合は、自分でそれらを削除します。Esc を 2 回押してそれらを追加したターンより前に戻るか、
/clearを実行して新しく始めます。
PDF エラー
添付した PDF を処理できませんでした。メッセージはここに非対話形式で表示されます。対話セッションでは、代わりに Esc キーを 2 回押して再試行するよう促します。- 大きすぎる PDF については、ファイル全体を添付するのではなく、Read ツールでページ範囲を読むよう Claude に依頼するか、
pdftotextなどのツールでテキストを抽出して、出力ファイルをパスで参照してください - 保護されているか無効な PDF については、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから再試行してください
pdftoppm でページをレンダリングします。メッセージが提供するコマンドで poppler-utils をインストールするか、他のプラットフォームでは pdftoppm を PATH に配置する poppler ビルドをインストールしてください。どの PDF がページ範囲で読まれるかについては、Read ツールの動作を参照してください。
Extra inputs are not permitted
リクエストを受け取ったエンドポイントが、リクエストのフィールドの 1 つを受け付けない入力として拒否しました。エンドポイントのメッセージにはそのフィールドが示されています。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を設定してください。正確なスコープについては プリリリース機能を無効にするで説明しています。
diagnostics が示されることがありました。これは、すでに Anthropic API を使用していたセッションが、再起動せずに Amazon Bedrock または Google Cloud’s Agent Platform に移行した場合に発生していました。たとえば、開いたままにしていたセッションは、別の Claude Code ウィンドウで /setup-bedrock を実行すると Bedrock に移行します。これらのバージョンでは、そのセッションで /clear を実行するか、セッションを再起動してください。
ツール入力スキーマが無効です
リクエスト内のツールが、API の JSON Schema 検証に失敗するinput_schema を宣言したため、API はリクエスト全体を拒否しました。tools. の後の番号は、検索可能な名前ではなく、リクエストのツールリスト内の失敗したツールの位置です。
$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 など、古い名前でサーバーまたはそのツールを参照しているものを更新してください。 - プラグインがサーバーをバンドルしている場合、ツールの完全な名前にはプラグイン名も含まれます。プラグインの保守担当者にサーバー名またはツール名を短くするよう依頼してください。
API Error: 400 ... tools.N.custom.name: String should have at most 128 characters で拒否していました。
tool_use.name が 200 文字を超えています
会話履歴内のツール呼び出しが、API がリクエストで受け入れる 200 文字の制限を超える名前を含んでいます:No such tool available ツールエラーで失敗し、会話はこの API エラーなしで続行されます。
対応方法:
claude updateを実行してから、会話を再開してください。更新されたバージョンはトランスクリプトを読み込むときに長すぎる名前を修復するため、スタックしていた会話が再度機能します。
/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 になり得ない名前も同じメッセージになります。
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 秒以内に応答がありませんでした。セッションは現在のモデルを維持します。
Try again. で終わります。
対応方法:
- モデルを再度切り替えてください
- 切り替えが失敗し続ける場合は、Claude Code が API エンドポイントに到達できることを確認してください。ネットワークと接続エラーを参照してください
選択したモデルを確認するときの API エラー
/model <name> でモデルを選択したか、セッションに接続されたアプリが切り替えを要求しました。API は、モデルを検証するために Claude Code が送信する最小限のリクエストを、レート制限やサーバーエラーなど、独自のエントリを持たない理由で拒否しました。セッションは現在のモデルを保持し、メッセージの末尾にそのことが示されます:
- サーバーの説明に対応してください。レート制限または 5xx ステータスの場合は、待機してモデルを再度選択してください
- 独自の表現を持つ拒否は、Model not foundや Model is restricted by your organization’s settingsなどの周囲のエントリで説明しています
Claude Opus is not available with the Claude Pro plan
アクティブなサブスクリプションプランには、選択したモデルが含まれていません。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 が含まれ、メッセージはどの最小値が適用されるかを示します。
- 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を実行して失敗したものを確認してから、再度切り替えてください。
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.です。対話セッションでは、この警告はデバッグログにのみ書き込まれます。
- より上位のアドバイザーか、より下位のメインモデルを選択してください。アドバイザーモデルを選択するでは、ランキングと各メインモデルで受け入れられるアドバイザーを一覧で示しています。
- アドバイザーがモデルに助言できる サブエージェントで引き続き使用したい場合は、アドバイザーを設定したままにしてください
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 と表示されます。
対応方法:
- effort レベルを
high以下に下げてください。 - 思考をオンに戻してください。たとえば、
MAX_THINKING_TOKENSを未設定にするか、設定から"alwaysThinkingEnabled": falseを削除してください。
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 を送信します。
思考予算が出力制限を超えています
設定された拡張思考の予算が最大応答長を超えているため、実際の回答のためのスペースが残っていません。CLAUDE_CODE_MAX_OUTPUT_TOKENSを思考予算より大きくしてください- 予算が出力長とどのように相互作用するかについては、拡張思考を参照してください
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 でリクエストを拒否しました。
- v2.1.281 以前を使用していて、すべてのターンがこのエラーで失敗する場合は、
claude updateを実行してセッションを再開してください - エラーが続く場合は、
/clearを実行してブロックを含まない会話を開始してください
Unsupported tool content removed
Claude Code が Anthropic API に直接接続し、保存されたセッションを読み込むまたはプレビューする場合、Anthropic API が受け入れないツールコンテンツを削除し、削除されたコンテンツが 2 つの思考ブロックの間にあった場所にこの行を残します: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 でリクエストを拒否しました:use the top-level 'system' parameter for the initial system prompt など)にも同じ復旧が適用されます。
それでもエラーが表示される場合、拒否されたシステムメッセージは Claude Code が削除できるものではありません。これは通常、Claude Code と API の間のプロキシまたは LLM ゲートウェイが独自のシステムメッセージを追加したことを意味します。
対応方法:
ANTHROPIC_BASE_URLで設定されたプロキシまたはゲートウェイの背後でエラーがすべてのターンで繰り返される場合は、プロキシなしで接続して原因を確認し、その運用者にエラーを報告してください/clearを実行して新しい会話を開始してください。そこでもエラーが再発する場合、原因は保存された会話ではなく、リクエストの経路にあります。
Invalid encrypted_content in search_result block
会話履歴に API が復号化できないホスト型 Web 検索コンテンツが含まれているため、API は 400 でリクエストを拒否しました。表現は読み取れないフィールドを示します: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を実行して、警告をトリガーしたターンの前のチェックポイントに戻り、別のアプローチを試してください。チェックポイント機能を参照してください。
- 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 と呼び、拒否メッセージには次の行が含まれます:
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 が表示されます。
対処方法:
- バックグラウンドセッションを開始するには、フラグを先頭にしてシェルでコマンドを再実行してください:
claude --bg --name nightly-audit "<task>"
システムプロンプトフラグとそのファイル形式の競合
1 回のclaude の呼び出しで --append-subagent-system-prompt と --append-subagent-system-prompt-file を同時に渡したため、claude はセッションを開始せずに終了コード 1 で終了します:
--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 はそのままセッションを開始していました。
- 値が
{で始まるのに JSON として解析できない場合、または--agentsファイルの内容を解析できない場合、Claude Code は JSON パーサー自体のメッセージを含むinvalid JSON:行を 1 行出力します - 解析はできても、エージェント定義が CLI で定義するサブエージェントのスキーマと一致しない場合、Claude Code は問題ごとに 1 行を出力します
- エージェント名が
-で始まる場合、Claude Code は<name>: agent names must not start with '-'を出力します
…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 もこのように失敗することがあります。パスまたはクォートを確認して、コマンドを再実行してください。
- メッセージに列挙されている各問題を修正してから、コマンドを再実行してください。CLI で定義するサブエージェントが受け付けるフィールドを参照してください。
Cloud sessions cannot be created from a --restricted session
--restricted でセッションを開始すると、Claude Code はそのセッションからクラウドセッションを作成することを拒否します。新しいセッションは制限付きプロセスの外部で実行され、制限モードが適用されないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:
- 制限付きセッション内でタスクをローカルに実行してください
- セッションの起動方法を制御できる場合は、
--restrictedを付けずに新しいclaudeセッションを開始し、そこからクラウドセッションを作成してください
--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 が組織のポリシーをまったく読み込めなかった場合は、代わりに別のメッセージが表示されます。
対処方法:
- 組織の Owner に、claude.ai/admin-settings/claude-code の Claude Code 管理設定でクラウドセッションを有効にするよう依頼してください
Cloud sessions use your claude.ai login
ポリシーによる拒否のメッセージにこのセッションで使用中の認証情報が示され、末尾がこの文になっている場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、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 への経路がない場合は、次のように表示されます:
ANTHROPIC_API_KEY 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその認証情報の名前と、それを解除するよう求める内容が含まれることもあります:
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 キーワードを使用するスキーマはすべて無効として扱われていました。
"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 などのデバイスファイルによってメモリが際限なく増加していました。
--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 から求められた場合は、再度サインインしてください
The current directory no longer exists
シェルが入った後に削除または移動されたディレクトリ(別のシェルが削除した worktree や一時ディレクトリなど)からclaude を起動しました。Claude Code は作業ディレクトリを読み取れないため、対話モードと非対話モードのどちらでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code はミニファイされたバンドルソースと生の ENOENT ... uv_cwd スタックを stderr に出力してクラッシュしていました。
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 を再起動し、拒否されたパスはそのままにしておくこともできます
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 が実行内容をすべて保存できなかったことを意味します:
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/の内容が読み込まれなかったことを報告するだけです
/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 を開始してください
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。
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 が開始するセッションの権限モードを設定してください
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に設定して、サンドボックス化をオンにしてください
claude remote-control から削除されたため、以前のバージョン向けに書かれたコマンドにはまだいずれかが含まれている場合があります。
claude import is not yet available in this build
claude import を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは import をプロンプトとして扱い、このメッセージを出力する代わりに対話セッションを開始していました。
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 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 を超えていることを検出したため、ファイルを読み込まずにこのエラーで終了します。
.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など、より長い待機時間(ミリ秒)に設定して、同じコマンドを再実行してください。 - ファイルが読み取り専用またはサンドボックスで保護されている場合: メッセージが示すファイルを書き込み可能にしてから同じ追加または削除コマンドを再実行するか、そのコマンドをサンドボックスの外で実行してください。
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 が実行するのと同じ方法で、
headersHelperコマンドを自分で実行してください。つまり、Claude Code がヘルパーを実行するディレクトリから、Claude Code がヘルパー用に設定する環境変数を設定し、プロジェクトの.mcp.json、プラグイン、またはプロジェクトのエージェントファイルに由来するサーバーの場合は Claude Code が削除する認証情報の変数を除いて実行します。サーバーのエンドポイントが受け付けるAuthorizationの値が出力されることを確認してください - ヘルパーまたはその認証情報のソースを修正した後、
/mcpでサーバーを選択して Reconnect を選んでください
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 は利用可能なポートを選択するためです。
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 でのリッスンを妨げています。
- セキュリティソフトウェアやサンドボックスポリシーが、プロセスによる
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リモートがないリポジトリ、または一度もフェッチしていないリポジトリ
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>。これは、ローカルの追跡 reforigin/<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が示されます。
- 対話的に作業するには、入力をパイプやリダイレクトせずに、ターミナルで
claudeを直接実行します - スクリプトなどから対話インターフェースなしで応答を得るには、
-pを追加し、claude -p "your question"やecho "your question" | claude -pのように、プロンプトを引数または stdin で渡します。--continueや--resume <session-id>でも同じように動作します。
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.
- プロンプトに可視テキストを含めます。スクリプトが変数やファイルからプロンプトを組み立てる場合は、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 はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリ使用量が増え続けていました。
- stdin に何がパイプされているかを確認します。
--input-format stream-jsonでは、すべてのメッセージが改行で終わる 1 行の JSON でなければなりません - 代わりにプレーンテキストを送信するには、
--input-format stream-jsonを外します。claude -pはデフォルトで stdin からプレーンテキストのプロンプトを読み取ります
Unknown command
対話的なターミナルセッションで、このセッションのどのコマンドにも一致しない/ 名を送信したため、Claude Code は何も実行せずにその名前を報告します。
/helpを/heplと入力するなどのタイプミス。送信前に近い候補を選ぶ方法については、コマンドメニューが入力内容と照合する仕組みを参照してください- コマンドは存在するものの、プラットフォーム、プラン、認証方法などの要件が満たされていないため、このセッションでは利用できない。
/web-setup、/schedule、/auto-mode-setupの項目を参照してください。一部のコマンドは、組織のポリシーで無効にされている場合に、Cloud sessions are disabled by your organization's policyのような独自のメッセージで応答します - このセッションにインストールまたは接続されていないプラグインまたは MCP サーバーのコマンド
/ 名にこのように応答するのは、対話的なターミナルセッションの場合だけです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示す注記と、Claude がそのセッションで実行できるコマンドの一覧を添えます。これには次のセッションが含まれます。
-pによる実行- Agent SDK アプリケーション
- デスクトップアプリの Code タブ
- VS Code 拡張機能のチャットパネル
- クラウドセッションとクラウドスケジュールタスク
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 はリポジトリのデフォルトブランチと比較し、上の例のようにベースを明示的に渡すよう提案します
- すでにクローン内にあったベースブランチを渡した場合: ヒントは
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 サブコマンドはクラウドセッションの開始前にレビューを拒否します。
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 分後にレビューを再実行します
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 を利用できない場合、メッセージにはアプリのインストールのみが示されます。
対処方法:
- ローカルの
ghCLI がリポジトリを読み取れる場合は、/web-setupを実行してそのログインを Claude アカウントに接続します - 変更後にレビューを再実行します
The GitHub App preflight failed transiently
ローカルリポジトリからクラウドセッションを開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかどうかを確認しましたが、そのチェックは明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消される可能性のあるエラーで終了しました。完全なメッセージは、Could not upload repo bundle (<error>) のようにバンドルを妨げた原因で始まり、プリフライトの文で終わります。
- 少し待ってからコマンドを再実行します。GitHub のチェックに合格すると、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗によって起動が妨げられることはなくなります
- 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば、修正してローカルリポジトリからセッションを開始できるようにします
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 分後にコマンドを再実行します
A GitHub organization policy is blocking Claude
Claude Code のプロンプトで、/autofix-pr のようなクラウドセッションを開始するコマンドを実行しました。Claude Code はセッションを作成する前に GitHub 上のリポジトリへの Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub が拒否しました。Claude Code はそこで停止し、ポリシーを示すメッセージを表示します。
IP 許可リストがアクセスをブロックしている場合、メッセージは次のとおりです。
- 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を再度実行します
Admin permissions required の警告が表示されていました。
Failed to resume the conversation
Claude Code は、claude --resume ピッカーで選択したセッションの保存済みトランスクリプトを読み取るか処理できなかったため、部分的に読み込まれた状態で続行せずにプロセスを終了します。メッセージには再試行用のコマンドが含まれます。
/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 を渡しましたが、一致する保存済みトランスクリプトがありませんでした。
- 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 を追加します
- セッションを再度再開します
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 はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました
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>を実行してから、デバッグログを確認します
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 の更新を完了できなかったため、ファイルを元のままにしました。
各メッセージにはキーマップへのパスが示され、自分で追加するキーボードショートカットのブロックで終わります。
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を再度実行します
/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 を含むすべてのプランに当てはまります。
- バグを報告するには、github.com/anthropics/claude-code/issues で issue を作成します。そこにある issue は誰でも読めるため、コード、トランスクリプト、その他の機密情報は含めないでください。
- 以前の拒否の後は、7 日間が経過するのを待ってから再度レポートを送信し、サービスがまだ拒否するかどうかを確認します
/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 で以下のいずれかのメッセージで終了しました:
claude --versionを実行してからclaude updateを実行し、新しいセッションでコマンドを再度実行してください。プラグイン eval の要件を参照してください- 現在のビルドで 2 番目のメッセージが表示される場合は、別の
claude updateの後で後で再度試してください
マーケットプレイスが信頼されていないソースから登録されています
マーケットプレイスは、公式 Anthropic マーケットプレイス用に予約されている名前で登録されていますが、登録されたソースはanthropics GitHub リポジトリではありません。Claude Code は、マーケットプレイスを読み込むか更新するたびに予約名を再確認するため、マーケットプレイスとそこからインストールされたプラグインの読み込みが停止します。v2.1.205 より前では、名前が予約される前に登録されたエントリは読み込みを続けていました。
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 以降では、メッセージに次の手順が表示されます:extraKnownMarketplacesにそのマーケットプレイスを記載している各設定ファイルで、エントリのキーとそのsource.nameに、公式のものに見えない新しいプレーン ASCII の名前を 1 つ付けます。管理者が組織の管理設定を通じてマーケットプレイスを追加している場合は、この手順は管理者が行いますclaude plugin marketplace remove <old-name>を実行するか、/pluginの Marketplaces タブで古い名前を削除します。これにより、そのプラグインもアンインストールされ、それらのデータ、オプション、シークレットが削除されます- 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、または MCPheadersHelperコマンドは、${user_config.KEY} プラグインオプションを参照し、置換された文字列はシェルに渡されます。$(...) を含む設定値、バックティック、または ; はそこでコードとして実行されるため、Claude Code は値を置換する代わりにコンポーネントの開始を拒否します。チェックはコマンドテンプレートで実行されるため、値がまだ設定されていない場合でもエラーが表示されます。v2.1.207 より前では、値はシェルコマンドに置換されていました。
表現は、どの表面がオプションを参照したかによって異なります。シェル形式フックは以下を報告します:
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:hooksmonitors/monitors.json:monitors- プラグインルートの
SKILL.md:skills
hooks/hooks.json に対するものです:
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 を再起動して、プラグインまたはコンポーネントを読み込んでください
マーケットプレイスエントリパスはマーケットプレイスディレクトリ内に留まりません
プラグインのマーケットプレイスエントリは、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 は以下を報告します:
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.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 分以内に失敗していたためです: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 のツール呼び出しから発生します。Claude はほとんどのツールエラーを自動的に修正します。変更が必要な場合、そのエラーの What to do リストに何を変更するかが記載されています。No such tool available
Claude が、セッションのツールリストにない名前でツールを呼び出しました。Claude Code はそのエラーをツール呼び出しの結果として Claude に返し、ターンは続行します。ツールが存在しない理由を Claude Code が判断できる場合は、2 行目のように、ツール名の後に理由や代わりに呼び出すべきツールを示す文を追加します。- 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 はツールが実行されたかどうかを判断できません。- ツールが操作するサービスで、アクションが実行されたかどうかを確認します。例えば、作成されるはずだった issue やレコードが存在するかどうかを確認します
- アクションが実行されていた場合は、ツールを再度実行しないでください。Claude はツールの結果の代わりにこのメッセージを受け取ったため、結果を Claude に伝えてください。
- アクションが実行されていなかった場合は、Claude にツールを再度実行するよう依頼します。Claude Code はそのサーバーのツールへの次の呼び出し時にサーバーへ再度接続するため、事前にサーバーを再接続する必要はありません。その接続も失敗する場合は、リモートサーバーのセッション中の切断 を参照してください。
- サーバーを自分でビルドしていて、ツールを 2 回呼び出しても安全な場合は、繰り返しても安全であるとマーク して、Claude Code が失われた呼び出しを繰り返せるようにします
MCP server is disabled
ツール結果にこのメッセージが含まれている場合、Claude が オフになっている MCP サーバー のツールを呼び出したことを意味します。Claude Code はサーバーに接続しなかったため、ツールは実行されず、Claude は結果の代わりにこのテキストを受け取りました。- サーバーを意図的にオフにした場合は、何もする必要はありません
- 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 を通じて入力を求めましたが、回答が届く前に呼び出しの制限時間が切れました。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 で読み取れない回答を返したため、その回答を待っていたツール呼び出しは、回答が呼び出しを許可していた場合でも実行されませんでした。
- テキストが
{"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 より前は、サブエージェントはツールなしで起動し、空または混乱した結果を返す可能性がありました。
- エラーが指定する各エントリを サブエージェントが利用可能なツール に対して修正します
- セッションが持たないツールのエントリを削除します。例えば、接続されていないサーバーからの 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 拒否ルールのみが編集をブロックしました。
and cannot be written で終わります。
What to do:
- Claude がファイルを変更できるべき場合、
/permissionsまたは 設定 のRead拒否ルールを削除または縮小します - ファイルが変更されないままである必要がある場合、ルールを保持し、NotebookEdit ツールもブロックするために同じパスの
Edit拒否ルールを追加します
Setting blocks writes outside the working directories
Claude がファイルを書き込もうとしてツール呼び出しがこのメッセージで失敗した場合、そのパスはセッションの 作業ディレクトリ の外にあり、permissions.blockWritesOutsideWorkingDirectories がオンになっています。
- 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 がオンになっています。
- 設定を変更するには、設定ファイルを自分で編集します
- 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 に返され、メッセージ自体が Claude に null バイトを削除して再度試すよう指示します
Path contains null bytes という名前のエラーで終了し、ツールは実行されませんでした。
Command contains an invisible character
PowerShell ツール が、U+FEFF または U+180E を含むコマンドの実行を拒否しました。- Claude が書いたコマンドの場合: 修正する必要はありません。メッセージが Claude にコマンドの書き直し方を伝えます。
- スキルまたはコマンドファイルの場合: メッセージは
No shell command in <name> was runの後に続きます。文字の場所と削除方法 を参照してください。
Claude Code の再起動後、承認済みのコマンドが実行されなかった
承認したシェルコマンドが実行されず、Claude はこのメッセージをコマンドの結果として受け取ります。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 はこのエラーをツール結果として受け取ります。- Claude が
File is too largeメッセージに従って、画像のサイズを変更したり、より小さいコピーを読み取ったりした場合は、何もする必要はありません - Claude がエラーで停止した場合は、解像度を下げるなどして 128 MB 未満のコピーを自分でエクスポートし、そのファイルを Claude に指定します
- パスがパイプまたはデバイスだった場合は、代わりに通常の画像ファイルを Claude に指定します
subagent_type is required
subagent_type なしで Agent ツール を呼び出し、このセッションにはフォールバックする 汎用サブエージェント がありません。これは 2 つのセットアップの場合です。
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1は非対話モードで設定されており、すべての組み込みサブエージェントを削除します- セッションのメインスレッドエージェントには
tools: Agent(...)許可リスト があり、general-purposeを除外しています
- 通常は何もしません。メッセージはセッションが持つサブエージェントをリストするため、Claude はそのうちの 1 つで再試行できます
- Claude が失敗し続ける場合、
tools: Agent(...)許可リストにgeneral-purposeを追加するか、CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSを設定解除します
Agent type 'general-purpose' not found で失敗しました。
Memory index is over its read limit
Claude は 自動メモリ インデックスMEMORY.md に書き込み、その読み取り制限の 1 つを超えたままにしました。200 行または 25KB です。書き込みは成功しましたが、最初の 200 行または 25KB のみ(どちらか先に来た方)がセッションの開始時に読み込まれるため、制限を超えるすべてのものはインデックスが読み込まれるたびに削除されます。v2.1.210 より前は、制限を超えたインデックスは書き込み時の信号なしで次の読み込み時に静かに切り詰められました。
- 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 セッションをターン中に終了しました。
- パターンを絞り込んで、意図したプロセスのみと一致するようにします。例えば、短い部分文字列ではなく、ターゲットバイナリの完全なパスです
- 現在のシェルで開始されたプロセスを停止するには、パターンで
pkill -P $$を使用します。これにより、マッチをシェルの独自の子プロセスに制限します
Failed to write to a teammate’s inbox
Claude Code は~/.claude/teams/{team-name}/inboxes/ の下のチームメイトのメールボックスファイルにメッセージを書き込むことができなかったため、受信者は何も受け取りませんでした。書き込みは、Claude Code がファイルを作成または更新できない場合に失敗します。例えば、ディスクがいっぱいである、ディレクトリが書き込み可能でない、または別のエージェントがインボックスロックを長時間保持している場合です。v2.1.224 より前は、Claude Code は書き込みが失敗した場合でも、メッセージが送信されたと報告していました。
エラーはターミナルのバナーではなく、送信エージェントのツール結果に表示され、テキストは Claude に再度試すよう指示します。
Failed to write 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 は エージェントチーム のシャットダウン承認を拒否しました。何も送信されず、何もシャットダウンされていません。拒否は送信セッションのツール結果に表示されます。- 拒否がチームリーダーのセッションに表示された場合は、まずチームメイトがその後シャットダウンしたかどうかを確認します。拒否は代わりに
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 はチームリーダーのコマンドライン拒否ルールを、分割ペインのチームメイト自身のコマンドラインで渡しますが、チームメイトがそのいずれかを異なる意味で読み取ってしまう場合は停止します。- チームリーダーのセッションで
/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 はそれを拒否し、受信セッションは何も受け取りませんでした。拒否はターミナルのバナーではなく、送信セッションのツール結果に表示されます。両方のサイズとメッセージを適合させる方法を指定します。- Claude にメッセージを要約するか、バルクコンテンツをファイルに入れてそのファイルのパスを送信するよう依頼します
- Claude にコンテンツを複数の短いメッセージに分割するよう依頼します
Too many messages to this session just now
Claude は クロスセッションメッセージ の急速なバーストをこのマシン上の 1 つのセッションに送信し、バーストはそのセッションのインボックスが受け入れるものに達しました。Claude Code は次の送信を拒否し、受信セッションはそれから何も受け取りませんでした。拒否はターミナルのバナーではなく、送信セッションのツール結果に表示されます。- 通常は何もしません。Claude は残りのコンテンツを 1 つのメッセージにバッチ処理するか、さらに送信する前に少し待ちます
- バースト自体をプロンプトした場合、Claude に残りのものを 1 つのメッセージに結合するよう依頼します
Cross-session message was dropped at the recipient session’s inbox
Claude は クロスセッションメッセージ をこのマシン上の別のセッションに送信し、そのセッションのインボックスは Claude がそのセッションで読む前にそれを破棄しました。行は受信者のアドレスを指定し、受信者が理由を与えた場合、ダッシュの後に理由を追加します。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: メッセージが、このマシンの外のセッションを含むものなど、途中で打ち切られる可能性がある返信の長いチェーン の続きでした
- 削除されたメッセージを受信者が見たことがないと仮定します。Claude Code は同じことを Claude に伝え、それでも重要なものを 1 つの後のメッセージに含めるよう指示し、すぐに再送信しないよう指示します
- セッションが互いに頻繁に更新を送信する場合、Claude にセッションが作業を完了したときなど、より少なく、より大きなメッセージを送信するよう依頼します
a relay loop between sessions was cutの場合、セッションの 1 つに自分で次の指示を入力します。Claude が自分のプロンプトに応答して送信するメッセージは新しいチェーンを開始します
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 はターゲットパスをまったく検査できませんでした。例えば、権限エラーで読み取りが失敗したためです。
- 通常は何もしません。チェックはメッセージが宛てられたセッション以外のエンドポイントに到達するのを防ぎ、何も送信されませんでした
reply target is a symlinkがセッションで繰り返される場合、そのセッションのソケットパスにリンクを作成したものを確認します。これは/statusのPeer addressに表示されます
Refusing to read, write, or search a path
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バイナリを絶対パスに解決できなかったため、拒否ルールをカバーしない検索を実行するのではなく、作業ディレクトリの外の検索を拒否します
- 通常は何もしません。拒否は Claude にツール結果として到達し、拒否された操作は実行されません
- シンボリックリンク拒否が 1 つのパスで繰り返される場合、ビルドツールやファイルウォッチャーなど、リンクをそこで書き直し続けるものを見つけるか、Claude にファイルのリンクされたパスではなく解決されたパスを使用するよう依頼します
- Windows 上の AppContainer または制限されたトークンサンドボックス内で Claude Code を実行しているときに、すべてのファイルでこの拒否が表示される場合、v2.1.265 以降にアップグレードします
- プロンプトにドラッグしたスクリーンショットなど、何も書き直していないファイルに対して macOS で読み取り拒否が表示される場合、v2.1.273 以降にアップグレードします
- ripgrep 拒否の場合、パッケージマネージャーで ripgrep をインストールして、
rgがPATH上の絶対パスに解決されるようにするか、作業ディレクトリの下で検索を保持します
where it leads on disk could not be determined 拒否は表示されませんでした。
The search failed, so this is not a “no matches” result
Claude が実行した Grep または Glob 検索が結果を返す前に失敗したため、一致が存在するかどうかは不明です。Claude が結果の代わりに受け取るメッセージは次のように始まります。- 初めて表示された場合: 何もする必要はありません。メッセージはまず再度検索するよう Claude に求めます。
- Claude が検索が失敗していると伝えた場合: バグレポート用に ripgrep のエラーを取得します。
- シェルから、検索が失敗したセッションと同じフラグに
--debug-file claude-debug.logを加えてセッションを開始します - 検索の失敗につながったリクエストを Claude に送信します
- 検索が再び失敗した場合は、
claude-debug.log内でrg error (signal=を含む行を見つけます - 問題を報告する ときにその行を含めます
- シェルから、検索が失敗したセッションと同じフラグに
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 はコマンドを停止し、その結果は以下を報告します。
- 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: の各メッセージは、実行されてゼロ以外のコードで終了したコマンドの後に表示されます。例えば次のとおりです。
- 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 にコマンドを再度実行させます
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 inodesThe 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で設定したディレクトリを保持するボリュームを確認します
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 はこの代替スタブを起動せず、代わりにこのテキストを表示します。例えば、より長いメッセージの中に表示されることがあります。
- ターミナルで
xcode-select --installを実行し、開始されるインストールを完了してから、Claude Code で行っていた操作を再試行します
File is not valid UTF-8
Claude が、バイトを UTF-8 としてデコードできないファイルに対して Edit または NotebookEdit ツールを使用したため、Claude Code は変更を拒否しました。何も書き込まれていないため、ファイルは元のままです。これらのツールはファイル全体を UTF-8 として保存し直すため、デコードできなかったすべてのバイトが置換文字U+FFFD に変わってしまうところでした。メッセージはツール結果に表示されます。
- ファイルを現在のエンコーディングのまま保持するには、メッセージが指示するとおり、そのエンコーディングでファイルを読み書きするシェルコマンドで Claude に変更を行わせます
- Edit ツールでファイルの編集を続けるには、ファイルを UTF-8 に変換するか、UTF-8 であるはずのファイルの場合は無効なバイトを修正してから、Claude に再度編集を依頼します
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 ツール結果に表示され、修正する最初の位置を指定します。
UTF-16 を指定し、それでもファイルを UTF-8 として書き直すよう指示します。指定された位置の後にさらに位置が続く場合、メッセージは位置の後に (+2 more) などのカウントを追加します。
What to do:
- 通常は何もしません。Claude はファイルを書き直して再度公開します
- ファイルが自分で書いたものまたはエクスポートしたものである場合、UTF-8 として再度保存し、各
U+FFFDを以前の編集、貼り付け、または変換が失った文字に置き換えます - ページに意図的な
U+FFFDを表示するには、リテラル文字ではなく HTML で�として書き込みます
Not published: that file is on a network share
Claude が、ネットワークホストを指定するパスにあるファイルから アーティファクト を公開しようとしました。- Windows では、起動時に
--add-dirで渡したマップ済みネットワークドライブの下にない\\server\shareパス - macOS または Linux では、
/net/<host>/page.htmlなどの自動マウントパス
- そのファイル自体が必要でない場合は、何もする必要はありません。メッセージは 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 が次に行う必要があることが示されます。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 ツール結果に表示されます。ファイルをまったく検査できない場合、代わりにその失敗を指定します。- 通常は何もしません。メッセージは Claude に接続されたフォルダ内のプレーンファイルを代わりに使用するよう指示します
- そのファイル自体をアーティファクトに入れるには、シンボリックリンクではなく通常のファイルとして、セッションの接続されたフォルダの 1 つにコピーして、再度依頼します
WebFetch cannot fetch localhost
Claude は WebFetch を、http://localhost:3000 や http://wiki/ のような単独のイントラネット名など、ドットのないホスト名を持つ URL で呼び出しました。WebFetch はリクエストを行う前にこれらの URL を拒否します。
- 通常は何もしません。メッセージは Claude を Bash ツール経由の
curlに指示します。これはローカルおよびイントラネットサーバーに到達できます
Invalid URL エラーで報告していました。
Claude Code is unable to fetch from a host
WebFetch は、ページをリクエストする前に URL のホスト名をapi.anthropic.com に送信し、Anthropic のドメイン安全ブロックリストと照合します。このメッセージは、そのホスト名はフェッチできないとチェックが回答したことを意味します。
WebFetch domain safety check failed
URL をフェッチする前に、WebFetch は URL のホスト名をapi.anthropic.com に送信して、Anthropic の ドメイン安全ブロックリスト に対してチェックします。チェックが完了できない場合、WebFetch はドメインが安全であることを確認できないため、ページをフェッチせず、ツール結果は代わりにこれらのメッセージの 1 つを持ちます。
rate-limited: チェックエンドポイントは HTTP429で応答しました。メッセージは Claude にページなしで続行し、後で最大 1 回だけ再度試すよう指示します。Claude Code は失敗したチェックをキャッシュしないため、そのドメインの後の取得はチェックを再度実行します。ネットワーク上のセッションがこれに頻繁に該当する場合、設定でskipWebFetchPreflight: trueを指定してチェックをスキップできます。Unable to verify: チェックリクエストが失敗した、タイムアウトした、または別のエラーステータスを受け取りました。ネットワークがapi.anthropic.comをブロックする場合、そのドメインを許可リストに追加するか、設定でskipWebFetchPreflight: trueを指定してチェックをスキップします。
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の場合: そのセッションを使用するか、そのセッションを停止してから再試行します
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>を実行します
Worktree has commits that are not pushed anywhere
worktree に、他の場所に保存されていることを Claude Code が確認できないコミットを含むバックグラウンドセッションを削除しようとしました。claude rm は次の進め方を示します。
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 が別の終了済みセッションにも記録されているとメッセージに示されている場合、再度削除しても破棄されません。コミットをプッシュしてから、セッションの削除を再試行してください
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…を出力し、セッションを再度開きます - シェルコマンドの行はこの方法では再起動できません。再実行するには、コマンドを再度ディスパッチしてください
opening… · esc to cancel が無期限に表示され、claude attach <id> はエラーを報告せずに待機し続けていました。
Session isn’t responding
バックグラウンドセッションを開き、バックグラウンドサービスがそのオープンを受け付けましたが、約 10 秒間出力が届きませんでした。そのため Claude Code は、セッションのターミナルを中継するプロセスが出力を配信できないと判断し、待機を続けずに試行を終了します。 エージェントビューでは、Claude Code はフッターで再起動を提案します。claude attach <id> が原因を出力して終了します。
- エージェントビューで、同じ行の
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 はセッションを停止したままにします。
- セッションを停止していない場合は、エージェントビューでその行を再度開くか、
claude respawn <id>を実行して再起動します - 自分で停止した場合は、何もする必要はありません。セッションは停止したままになります
セッションのエージェントが利用できなくなった
--agent または agent 設定で起動され、カスタムエージェントを実行していたセッションを再開しましたが、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 が停止しました。ループが次のウェイクアップを待機している間にセッションのプロセスが終了し、セッションの次のプロセスが起動する前にそのウェイクアップの予定時刻が来ました。見逃したウェイクアップが遅れて実行されることはありません。通知には、セッションが再起動した時点でウェイクアップがどれだけ遅れていたかが示されます。
- ループを続行するには、セッションに返信し、
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 コマンドを再度実行します。
- ゲートウェイがセッションに届くのは、スーパーバイザー自体が同じゲートウェイをエクスポートしたシェルから起動された場合のみです。そうでない場合は、Dispatch fails with
Not logged in · Please run /login などのサインインエラーが表示され、フォルダーは示されませんでした。
CLAUDE_CODE_PROCESS_WRAPPER ランチャーのエラー
CLAUDE_CODE_PROCESS_WRAPPER が設定されていますが、その値を使用できないため、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 プロセスが更新をダウンロードしている場合にも対応します。インストールがその待機時間を超えた場合、失敗メッセージには単なるエラーコードではなく更新の旨が示されます。
- 数秒待ってから、セッションを開くかディスパッチを再度実行します。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 はセッションを開始せず、メッセージには存在しないディレクトリが示されます。could not be resolved on disk が報告されます。
対処方法:
- メッセージに示されたディレクトリを再作成するか、存在するディレクトリからディスパッチしてから、再試行します
This forked session could not be started
claude.ai から Remote Control セッションをフォークしましたが、Claude Code はマシン上でフォークを実行するバックグラウンドセッションの起動を完了できませんでした。この通知は、フォークされたセッションのトランスクリプトに表示されます。- フォーク元のセッションに戻り、セッションがアイドル状態になったら再度フォークします
バックグラウンドセッションのディスパッチ時にワークスペースが信頼されていない
信頼していないディレクトリでバックグラウンドセッションを開始または再起動しましたが、確認のためのワークスペース信頼ダイアログを表示できませんでした。Claude Code はセッションを開始しません。The home directory is trusted one session at a time: セッションのディレクトリがホームディレクトリです。Claude Code はホームディレクトリに対する信頼を保存しないため、以前のセッションでそこでダイアログを承認していても有効になりません。<path> could not be resolved on disk: Claude Code がディスク上でセッションのディレクトリを見つけられませんでした。
- メッセージに示されたディレクトリで
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 で始まります。例:
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 分間がカウントされないようにしてください。
Subprocess initialization did not complete within 60000ms — check authentication and network connectivity が含まれていました。この文面が表示される場合は、拡張機能または SDK を更新してください。
Claude Code process exited with code N
基盤となるclaude プロセスがゼロ以外のコードで終了しました。終了コードだけでは何が失敗したかは分かりません。実際のエラーはプロセス自体の出力にあり、ラッパーはキャプチャした場合はそれを追加し、そうでない場合はログに保持します。
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バイナリに設定してください
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 は以下の場合にパスをスキップします。
- シンボリックリンク、ハードリンク、またはその他の通常ファイル以外のファイルである、またはそうなった場合
- チェックポイント以降にそのディレクトリが変更された場合
- バックアップを安全に読み取ることができない場合
/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 がファイルに書き込みまたは削除できませんでした。
/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を増やしてください。
セッション保存の警告
Claude Code は、セッショントランスクリプトを保存していない場合、入力ボックスの下の永続的な行に以下の警告を表示します。セッションはどちらの場合でも機能し続けます。警告は、後で--resume でセッションが見つからない可能性があることを示しています。
トランスクリプト書き込みが失敗しています
Claude Code は作業中にトランスクリプトをディスクに保存し、トランスクリプトファイル への書き込みが失敗しています。メッセージは原因を基になるエラーコードで示します。例えば、ディスクがいっぱいの場合:- 自動的にクリアされない条件での最初の失敗:ディスクがいっぱい、ディスククォータを超過、ファイルシステムが読み取り専用、パスがファイルシステムの長さ制限を超過、または macOS と Linux では権限エラー
- 少なくとも 1 分間にわたる繰り返しの失敗(Windows での権限エラーを含む、ウイルス対策スキャンが単一の書き込みに失敗してから再試行で成功する場合など)
--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 を実行した場合に予想されます。マーカーが長寿命の仲介者(例えば、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 を起動し、そのパスにあるファイルを開きます。
Claude Code exited after an unrecoverable interface error
Claude Code は、ターミナルインターフェースが回復できないエラーに遭遇して終了したときに、使用していたレンダラーがどちらであってもこのメッセージを表示します。2 文目は、フルスクリーンレンダラーの起動中にエラーが発生した場合にのみ表示されます。- Claude Code を再度起動します。会話を再開するには、同じディレクトリで
claude --resumeを実行します。 - メッセージにフルスクリーンレンダラーが示されている場合、次回の起動時の動作(フルスクリーンをどのようにオンにしたかによって異なります)と、フルスクリーンを再度試す方法やクラシックレンダラーを使い続ける方法については、フルスクリーンレンダリングを参照してください。
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: たとえば、ファイルが直接または他のリンクを介して自分自身に戻るリンクになっている
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のために保留されたファイルを読み込むには、そのファイルが自分自身に戻るリンクになっていないか確認します。そうなっている場合は、リンクを存在するファイルに向けるか、その場所に通常のファイルを置きます。その後、新しいセッションを開始します。
名前が予約されているため、スキル、コマンド、またはワークフローが読み込まれなかった
スキルフォルダ、フロントマターのname、.claude/commands/ 内のファイルやサブフォルダ、または保存されたワークフローが、anthropic-skills という名前、または anthropic-skills: で始まる名前を使用しています。Claude Code はこの名前を claude.ai から同期されたスキル用に予約しているため、その項目を読み込みません。
Claude Code はこの警告を stderr ではなく、会話ビューの起動時通知として表示します。
name: 行、または名前を変更するワークフローです。複数の項目が拒否された場合、通知の末尾に · 2 more のような件数が付き、デバッグログにそれぞれの項目が記録されます。
対処方法:
- 通知に示された項目の名前を変更するか、通知が指す
name:行を編集してから、セッションを再起動します。
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に含まれている場合は、そのパスを記載している設定ファイルから削除します。
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 時間以上経過している場合です。
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を実行します
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
- 自分のユーザー設定ファイルとプロジェクト設定ファイルにこれらの設定がないか確認し、変更または削除します
- 自分の設定でブロックの理由が説明できない場合は、どの管理設定がサーバーをブロックしているかを管理者に確認してください
/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 -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 は、そのソースに含まれている可能性のあるポリシーなしで実行する代わりに、起動時に終了します。claude gateway サーバーが、allowedProviders を示す 1 行目の変形版のメッセージとともに拒否されます。
root 専用ファイルなど、オペレーティングシステムによって読み取りが拒否された場合は、この終了は発生しません。セッションはそのソースのポリシーなしで開始されます。解析できないソースの場合、Claude Code はソースを示す別のメッセージで終了します。
対処方法:
- マシンを管理している場合は、
Detail:行に示された問題を修正してデプロイされたソースを読み取れるようにするか、ソースを削除します - マシンを管理していない場合は、メッセージを管理者に送ってください。自分の設定ファイルの内容がこのエラーの原因になることはなく、それによってエラーを解消することもできません
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 を起動したアプリケーションがそのエントリを親設定として渡しているため、そのアプリケーションの開発者に報告してください - それ以外の場合は、ブロックを管理者に送ってください
-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)/**)のようなルールはエスケープなしで有効です
Mismatched parentheses として報告していました。
Matches no tool · check for typos
起動バナーの下に表示されるこの行は、Claude Code がツール名を認識できない拒否ルールまたは確認ルールの権限ルールを示しており、そのルールは意図したツールに適用されません。Bsh と記述された拒否ルールは Bash には適用されず、正規名ではなくトランスクリプトに表示されるツールのラベルを使用したルールも同様です。行には、記述したとおりのルールが繰り返し表示されます。
- ルール内のツール名を修正します。たとえば、
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と表示されます。自分では解消できないため、管理設定を管理している担当者にその警告を転送してください。
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 のファイルの場合は次のようになります。
refuse として扱い、警告には、管理者が修正するまでセッション間メッセージが拒否されることが示されます。この保留が他の設定ファイルの値とどのように組み合わされるかについては、crossSessionInbound を参照してください。
対処方法:
- キーを
"accept"、"hold"、または"refuse"に設定するか、削除します - 警告に管理設定が示されている場合は、値の修正を管理者に依頼してください
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 を超えて大きくなる可能性があります。
- モデル 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 の上限が強制されていないことを報告するだけです
--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 でリクエストを送信し続け、終了したりモデルを切り替えたりはしません。
[claude-code:unrecognized_model] プレフィックスで照合してください。プレフィックスと 1 つのスペースの後に、Claude Code は 1 行の JSON オブジェクトを書き込みます。Claude Code は今後のバージョンでフィールドを追加する可能性があるため、想定していないフィールドは無視してください。少なくとも次の 2 つのフィールドが書き込まれます。
model: 設定されたとおりのモデル文字列query_source: そのモデルを使用したリクエストの経路。たとえば、-pの実行のメインの会話では値はsdkとなり、サブエージェントではagent:で始まります。
-pを使用した非対話モードでは、すべての--output-formatで stderr に書き込むため、この行を除外せずに stdout を解析できます- 対話セッションまたはバックグラウンドセッションでは、代わりにデバッグログに書き込みます。
--debugを付けて実行すると、~/.claude/debug/<session-id>.txtに記録されます
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:で始まる場合は、代わりにサブエージェントのモデルを設定している箇所で修正します。
管理ロック下ではサンドボックスの許可エントリが無視される
/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」で保存した権限の選択が保持されなかった場合は、プレースホルダーを削除した後に再度保存します
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 の旧名です。メッセージには、どちらのファイルに自分のセットアップが含まれているかを確認する方法が含まれています。
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 を起動しないでください。
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 での 自動モデルフォールバック は、指摘されたカテゴリにフォールバックモデルがある場合、セッションをそのフォールバックモデルに移動します。トランスクリプトに通知が表示されます
/model の変更ではなく表示されます。モデル設定 は各フォールバックが適用される時期を説明しています。
まずこれらを確認してください。
- モデル選択:
/modelを実行して、期待するモデルにいることを確認します。以前の/modelの選択またはANTHROPIC_MODEL環境変数により、意図したより小さいモデルにいる可能性があります。 - 努力レベル:
/effortを実行して現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げます。デフォルトはモデルによって異なるため、最大値以下であると仮定する前に確認してください。努力レベルを調整する でモデルごとのデフォルトとultrathinkショートカットを参照してください。 - コンテキスト圧力:
/contextを実行してウィンドウがどの程度満杯かを確認します。容量に近い場合は、自然な区切り点で/compactを実行するか、/clearを実行して新しく開始します。コンテキストウィンドウを探索する で auto-compact が以前のターンにどのように影響するかを参照してください。 - 古い指示: 大きいまたは古い
CLAUDE.mdファイルと MCP ツール定義はコンテキストを消費し、応答を操作できます。/doctorチェックアップは過度に大きいメモリファイルと未使用の拡張機能にフラグを付け、/contextは MCP ツールトークン使用量を表示します。v2.1.205 より前では、/doctorは過度に大きいメモリファイルとサブエージェント定義にフラグを付けた診断画面を開きました。
/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 を検索します。