SpyBara
Go Premium

errors.md 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

487 added, 282 removed.

2026
Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

゚ラヌリファレンス

Claude Code のランタむム゚ラヌメッセヌゞを怜玢し、各゚ラヌの意味ず修正方法を確認できたす。

このペヌゞでは、Claude Code が衚瀺するランタむム゚ラヌず各゚ラヌからの埩旧方法、および応答が゚ラヌなしで異垞に芋える堎合に確認すべき内容を䞀芧衚瀺しおいたす。セットアップ䞭の command not found や TLS ゚ラヌなどのむンストヌル゚ラヌに぀いおは、トラブルシュヌティング むンストヌルずログむンを参照しおください。

これらの゚ラヌず埩旧コマンドは、CLI、デスクトップアプリ、およびりェブ䞊の Claude Code党䜓に適甚されたす。これら 3 ぀はすべお同じ Claude Code CLI をラップしおいるためです。サヌフェス固有の問題に぀いおは、そのサヌフェスのペヌゞのトラブルシュヌティングセクションを参照しおください。

゚ラヌを怜玢する

タヌミナルに衚瀺されるメッセヌゞを以䞋のセクションず照合しおください。

メッセヌゞ セクション
API Error: 500 Internal server error サヌバヌ゚ラヌ
API Error: Repeated 529 Overloaded errors サヌバヌ゚ラヌ
Request timed out サヌバヌ゚ラヌ、たたはメッセヌゞがむンタヌネット接続に蚀及しおいる堎合はネットワヌク
Server error mid-response. The response above may be incomplete. サヌバヌ゚ラヌ
Connection closed mid-response / Response stalled mid-stream サヌバヌ゚ラヌ
<model> is temporarily unavailable, so auto mode cannot determine the safety of... サヌバヌ゚ラヌ
Auto mode could not evaluate this action and is blocking it for safety サヌバヌ゚ラヌ
Auto mode classifier transcript exceeded context window サヌバヌ゚ラヌ
Agent terminated early due to an API error サヌバヌ゚ラヌ
You've hit your session limit / You've hit your weekly limit 䜿甚制限
Usage credits required for 1M context 䜿甚制限
Server is temporarily limiting requests 䜿甚制限
Request rejected (429) 䜿甚制限
Credit balance is too low 䜿甚制限
Not logged in · Please run /login 認蚌
Could not resolve authentication method 認蚌
Invalid API key 認蚌
This organization has been disabled 認蚌
Your organization has disabled API key authentication 認蚌
Your organization has disabled Claude subscription access 認蚌
Routines are disabled by your organization's policy 認蚌
Remote Control is only available when using Claude via api.anthropic.com 認蚌
OAuth token revoked / OAuth token has expired 認蚌
does not meet scope requirement user:profile 認蚌
AWS credentials expired or invalid 認蚌
AWS authentication failed 認蚌
Unable to connect to API ネットワヌク
Waiting for API response · will retry in 自動リトラむ、たたは継続する堎合はネットワヌク
SSL certificate verification failed ネットワヌク
SSL certificate error (...) during login or startup ネットワヌク
403 with x-deny-reason: host_not_allowed in a cloud or routine session ネットワヌク
Couldn't reconnect to your Remote Control session ネットワヌク
Prompt is too long リク゚スト゚ラヌ
Error during compaction: Conversation too long リク゚スト゚ラヌ
Request too large リク゚スト゚ラヌ
Image was too large リク゚スト゚ラヌ
Unable to resize image リク゚スト゚ラヌ
PDF too large / PDF is password protected リク゚スト゚ラヌ
Extra inputs are not permitted リク゚スト゚ラヌ
There's an issue with the selected model リク゚スト゚ラヌ
Model ... is not a recognized model id リク゚スト゚ラヌ
Claude Opus is not available with the Claude Pro plan リク゚スト゚ラヌ
Model ... is restricted by your organization's settings リク゚スト゚ラヌ
thinking.type.enabled is not supported for this model リク゚スト゚ラヌ
max_tokens must be greater than thinking.budget_tokens リク゚スト゚ラヌ
API Error: 400 due to tool use concurrency issues リク゚スト゚ラヌ
Claude Code is unable to respond to this request, which appears to violate our Usage Policy リク゚スト゚ラヌ
<model> has safety measures that flagged this message for a cybersecurity topic リク゚スト゚ラヌ
Installation was killed before it could finish (exit code 137) むンストヌル゚ラヌ
The connection dropped while downloading the update むンストヌル゚ラヌ
Download timed out: exceeded the total deadline むンストヌル゚ラヌ
--bg and --print conflict コマンドラむン゚ラヌ
Error: --json-schema is not a valid JSON Schema コマンドラむン゚ラヌ
Could not import <server>: <reason> コマンドラむン゚ラヌ
Marketplace "<name>" is registered from an untrusted source プラグむン゚ラヌ
Ignoring N permissions.allow entries from ... this workspace has not been trusted 蚭定譊告
レスポンスの品質が通垞より䜎いように芋える レスポンス品質

自動リトラむ

Claude Code は、゚ラヌを衚瀺する前に䞀時的な障害をリトラむしたす。サヌバヌ゚ラヌ、オヌバヌロヌドレスポンス、リク゚ストタむムアりト、䞀時的な 429 スロットル、および接続の切断はすべお、指数バックオフで最倧 10 回リトラむされたす。{/* min-version: 2.1.198 /}v2.1.198 以降では、これは、衚瀺可胜な出力がストリヌムされる前に応答の途䞭で切断される接続をカバヌしおいたす。Claude Code は同じバックオフでリク゚ストを再発行し、接続゚ラヌで停止する代わりにタヌンが続行されたす。{/ min-version: 2.1.199 */}v2.1.199 以降では、プランのクォヌタヘッダヌを持たない䞀時的な 429 スロットルも、claude.ai サブスクリプションでサむンむンしおいる堎合にリトラむされたす。それより前のバヌゞョンでは、API キヌおよび゚ンタヌプラむズサむンむンの堎合のみリトラむされたした。

2 ぀の障害クラスはリトラむされたせん。リトラむが成功できないためです。

  • {/* min-version: 2.1.199 */}v2.1.199 以降では、TLS 蚌明曞怜蚌の倱敗TLS 怜査プロキシ、䞍足しおいる NODE_EXTRA_CA_CERTS バンドル、たたは期限切れの蚌明曞などは最初の詊行で倱敗するため、完党なリトラむ予算の埌ではなく、修正がすぐに衚瀺されたす。SSL 蚌明曞゚ラヌを参照しおください。ハンドシェむクタむムアりトなどの䞀時的な TLS 条件はただリトラむされたす。
  • {/* min-version: 2.1.199 */}v2.1.199 以降では、Claude が既に衚瀺可胜な出力をストリヌムした埌に到着するサヌバヌ゚ラヌは、郚分的なレスポンスを保持し、リトラむする代わりに䞍完党なレスポンス通知を远加したす。同じツヌル呌び出しを 2 回実行する可胜性があるためです。それより前のバヌゞョンでは、郚分的な出力を砎棄し、タヌン党䜓を゚ラヌずしお報告したした。

リトラむ䞭、スピナヌぱラヌラベルの埌に Retrying in Ns · attempt x/y カりントダりンを衚瀺したす。ラベルは、すぐに察応できる障害の最初の詊行からの具䜓的な理由を瀺したす。ネットワヌクがダりンしおいる、TLS ハンドシェむクが倱敗した、たたはレヌト制限に達したした。他の゚ラヌの堎合は、最初は API error ず衚瀺されたす。{/* min-version: 2.1.198 */}v2.1.198 以降では、3 番目の詊行からの具䜓的な理由に切り替わるか、CLAUDE_CODE_MAX_RETRIES が 3 未満の詊行を蚱可する堎合は最終詊行時に切り替わりたす。それより前のバヌゞョンでは、最終詊行時のみ切り替わりたす。

{/* min-version: 2.1.198 */}v2.1.198 以降では、通垞のスピナヌチップはリトラむ䞭に抑制されたす。゚ラヌの理由が明らかになるず、障害が 529 オヌバヌロヌドの堎合、カりントダりンの䞋の行はサヌビスステヌタスを確認する堎所も瀺したす。Anthropic API では status.claude.com、たたは他の蚭定ではメッセヌゞに瀺されおいるプロバむダヌたたはゲヌトりェむホスト。

{/* min-version: 2.1.185 */}リク゚ストがただ保留䞭の状態で、レスポンスストリヌムで 20 秒間デヌタが到着しない堎合、スピナヌは Waiting for API response · will retry in 
 · check your network を衚瀺したす。これはリトラむが開始される前です。リク゚ストはただ倱敗しおいたせん。カりントダりンは Claude Code が停止した接続を䞭止しおリトラむする時点たで実行されるため、デヌタが再開されるか、リトラむが成功するずバナヌは自動的にクリアされたす。v2.1.185 以降、閟倀は 20 秒です。それより前のバヌゞョンでは、異なる衚珟でバナヌが 10 秒埌に衚瀺されたす。すべおの詊行で再床衚瀺される堎合は、ネットワヌクの問題ずしお扱っおください。

このペヌゞの゚ラヌの 1 ぀が衚瀺されおいる堎合、これらのリトラむはすでに䜿い果たされおいたす。ただし、蚌明曞怜蚌の倱敗など、リトラむされないクラスに属する堎合は陀きたす。これらの環境倉数で動䜜をチュヌニングできたす。

倉数 デフォルト 効果
CLAUDE_CODE_MAX_RETRIES 10 リトラむ詊行回数。{/* min-version: 2.1.186 /}v2.1.186 以降、15 に制限されおいたす。{/ min-version: 2.1.199 */}v2.1.199 以降では CLAUDE_CODE_RETRY_WATCHDOG がデフォルトを䞊げ、キャップを削陀したす。スクリプトで障害をより速く衚瀺するには䜎くしたす。
CLAUDE_CODE_RETRY_WATCHDOG 未蚭定 CI ゞョブなどの無人セッションで 1 に蚭定しお、CLAUDE_CODE_MAX_RETRIES 詊行埌に倱敗する代わりに、429 および 529 キャパシティ゚ラヌを無限にリトラむしたす。{/* min-version: 2.1.199 */}v2.1.199 以降では、サヌバヌ゚ラヌ、タむムアりト、接続の切断などの他の䞀時的な゚ラヌのデフォルトリトラむ数も䞊げ、バックオフの玄 3 時間である 300 に䞊げ、倉数を明瀺的に蚭定した堎合は CLAUDE_CODE_MAX_RETRIES の 15 のキャップを削陀したす。
API_TIMEOUT_MS 600000 リク゚ストごずのタむムアりトミリ秒単䜍。遅いネットワヌクたたはプロキシの堎合は高くしたす。

サヌバヌ゚ラヌ

これらの゚ラヌはアカりントたたはリク゚ストではなく、掚論プロバむダヌから発生したす。Anthropic API の堎合は Anthropic むンフラストラクチャを意味したす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたはカスタムゲヌトりェむの堎合は、そのプロバむダヌのむンフラストラクチャを意味したす。

API Error: 500 Internal server error

Claude Code は 5xx レスポンスのステヌタスコヌドず API の゚ラヌメッセヌゞを衚瀺したす。以䞋の䟋は Anthropic API での 500 レスポンスを瀺しおいたす。

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

末尟の文はサヌビスヘルスを確認する堎所を瀺し、プロバむダヌによっお異なりたす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry の蚭定はそのプロバむダヌのサヌビスステヌタスを瀺したす。カスタム ANTHROPIC_BASE_URL はゲヌトりェむホストを瀺したす。

これは API 内の予期しない障害を瀺しおいたす。プロンプト、蚭定、たたはアカりントが原因ではありたせん。

察応方法

  • status.claude.com たたはメッセヌゞに瀺されおいるプロバむダヌのステヌタスペヌゞで、アクティブなむンシデントを確認しおください
  • 1 分埅っおからメッセヌゞを再床送信しおください。元のメッセヌゞはただ䌚話に残っおいるため、長いプロンプトの堎合は党䜓を貌り付ける代わりに try again ず入力できたす
  • ゚ラヌが投皿されたむンシデントなしで続く堎合は、/feedback を実行しお Anthropic がリク゚ストの詳现で調査できるようにしおください。環境で /feedback が利甚できない堎合は、゚ラヌを報告するを参照しおください。

API Error: Repeated 529 Overloaded errors

API はすべおのナヌザヌ党䜓で䞀時的に容量に達しおいたす。Claude Code はこのメッセヌゞを衚瀺する前に既に数回再詊行しおいたす。

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

末尟の文は 500 ゚ラヌず同じ方法でプロバむダヌによっお異なりたす。

529 はナヌザヌの䜿甚制限ではなく、クォヌタに察しおカりントされたせん。

察応方法

  • status.claude.com たたはメッセヌゞに瀺されおいるプロバむダヌのステヌタスペヌゞで、容量に関する通知を確認しおください
  • 数分埌に再床詊しおください
  • /model を実行しお別のモデルに切り替えお䜜業を続けおください。容量はモデルごずに远跡されるためです。Claude Code は 1 ぀のモデルが特に高い負荷を受けおいる堎合、䟋えば Opus is experiencing high load, please use /model to switch to Sonnet のようにプロンプトを衚瀺したす。

Request timed out

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

Request timed out

これは高負荷期間䞭、たたはモデルが非垞に倧きなレスポンスを生成しおいる堎合に発生する可胜性がありたす。デフォルトのリク゚ストタむムアりトは 10 分です。

察応方法

  • リク゚ストを再詊行しおください
  • 長時間実行されるタスクの堎合は、䜜業をより小さなプロンプトに分割しおください
  • 遅いネットワヌクたたはプロキシが原因の堎合は、自動再詊行で説明されおいるように API_TIMEOUT_MS を䞊げおください
  • タむムアりトが頻繁で、ネットワヌクが正垞な堎合は、以䞋のネットワヌクず接続゚ラヌを参照しおください

The response above may be incomplete

ストリヌミングレスポンスが Claude が既に衚瀺可胜な出力を生成した埌に倱敗したした。リク゚ストを再送信するず同じツヌル呌び出しが 2 回実行される可胜性があるため、Claude Code は既にストリヌミングされたものを保持し、タヌンを砎棄する代わりにこの通知を远加したす。衚瀺されるバリアントはどれが原因かを瀺したす。

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.
  • {/* min-version: 2.1.199 */}Server error mid-responseストリヌム䞭のオヌバヌロヌドたたは 5xx サヌバヌ゚ラヌ。このバリアントには Claude Code v2.1.199 以降が必芁です。それ以前は、その堎合は郚分的な出力を砎棄し、タヌン党䜓を゚ラヌずしお報告しおいたした。
  • Connection closed mid-response接続が切断されたした。
  • Response stalled mid-streamストリヌムがデヌタの送信を停止したした。

察応方法

  • ストリヌミングされたレスポンスを読んでください。䜕も倱われおいたせんが、最埌の文たたはツヌル呌び出しが欠萜しおいる可胜性がありたす。
  • continue で返信しお、Claude が停止した堎所から再開するようにしおください
  • 衚瀺可胜な出力の前に同じ゚ラヌが衚瀺される堎合、Claude Code はそれを最終化する代わりにリク゚ストを再詊行したす。自動再詊行を参照しおください。

Auto mode cannot determine the safety of an action

auto modeが䜿甚するモデルがアクションを分類できず、決定を生成できなかったため、auto mode はアクションを自動的に承認したせんでした。衚瀺されるメッセヌゞは分類噚が倱敗した理由によっお異なりたす。

読み取り、怜玢、および䜜業ディレクトリ内の線集は分類噚をスキップするため、これらすべおのケヌスで動䜜し続けたす。

分類噚モデルがオヌバヌロヌドされおいる堎合

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

察応方法

  • 数秒埌に再詊行しおください。Claude は同じメッセヌゞを衚瀺し、通垞は自動的に再詊行したす
  • 再詊行が倱敗し続ける堎合は、読み取り専甚タスクを続行し、埌でブロックされたアクションに戻っおください
  • これは䞀時的で、auto mode 適栌性ずは無関係です。蚭定を倉曎する必芁はありたせん

分類噚が解析䞍可胜なレスポンスを返した堎合

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

察応方法

  • アクションを再詊行しおください。これは通垞、次の詊行で成功したす
  • claude --debug を実行しおアクションを繰り返し、デバッグログで基になる分類噚レスポンスを確認しおください

別の API セヌフティチェックが以前の䌚話コンテンツのため分類噚リク゚ストをブロックした堎合

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

察応方法

  • これはアクションに関する決定ではありたせん。䌚話に既にあるコンテンツが、auto mode が䌚話を分類噚に送信したずきに API のセヌフティフィルタヌをトリガヌしたした
  • 再詊行は圹に立ちたせん。同じ䌚話コンテンツがフィルタヌを再床トリガヌしたす
  • 別の暩限モヌドに切り替えお、プロンプトが衚瀺されたずきにアクションを承認するか、トリガヌするコンテンツなしで新しい䌚話を開始しおください

䌚話が分類噚のコンテキストりィンドりより倧きくなった堎合

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

むンタラクティブセッションでは、auto mode はそのアクションに察しお通垞の暩限プロンプトにフォヌルバックするため、手動で承認たたは拒吊できたす。非むンタラクティブモヌドでは、トランスクリプトのみが増加し、再詊行が成功できないため、実行は䞭止されたす。

察応方法

  • 衚瀺されるプロンプトでアクションを承認たたは拒吊しおください
  • /compact を実行しお䌚話サむズを削枛し、埌続のアクションが分類噚りィンドり内に収たるようにしおください

Agent terminated early due to an API error

{/* min-version: 2.1.199 */}subagentの API リク゚ストが終了的に倱敗したした。䟋えば、䜿甚制限に達したか、サヌバヌ゚ラヌの再詊行が終了したため、subagent はタスクを完了する前に停止したした。このメッセヌゞには Claude Code v2.1.199 以降が必芁です。それ以前は、API ゚ラヌテキストが subagent の結果であるかのように Claude に返されおいたした。

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

察応方法

  • コロンの埌の゚ラヌ詳现をこのペヌゞの独自のセクション䜿甚制限たたはサヌバヌ゚ラヌなどず照合し、そのセクションの手順に埓っおください
  • 基になる゚ラヌがクリアされたら、Claude にタスクを再詊行するか、subagent を再開するよう䟝頌しおください

レヌト制限、オヌバヌロヌド、たたはサヌバヌ゚ラヌが既にテキスト出力を生成したフォアグラりンド subagent を䞭断する堎合、Claude はその郚分的な出力を䞍完党ずしおマヌクされたものを受け取り、この゚ラヌは受け取りたせん。{/* min-version: 2.1.200 */}唯䞀の出力がツヌル呌び出しだった subagent もこの゚ラヌを取埗したす。v2.1.199 ではその圢状は空の郚分的な結果を返しおいたした。subagent の API ゚ラヌを参照しおください。

䜿甚制限

これらの゚ラヌは、アカりントたたはプランに関連するクォヌタに達したこずを意味したす。これらは、すべおのナヌザヌに圱響するサヌバヌ゚ラヌずは異なりたす。

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

サブスクリプションプランには、ロヌリング䜿甚蚱容量が含たれおいたす。これが尜きるず、以䞋のいずれかのメッセヌゞが衚瀺されたす。

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

Claude Code は、メッセヌゞに衚瀺されたリセット時刻たでさらなるリク゚ストをブロックしたす。

察応方法

  • ゚ラヌに衚瀺されたリセット時刻たで埅機しおください
  • /usage を実行しお、プランの制限ず、それらがい぀リセットされるかを確認しおください
  • /usage-credits を実行しお、Pro および Max で远加䜿甚量を賌入するか、Team および Enterprise で管理者にリク゚ストしおください。この請求方法に぀いおは、有料プランの䜿甚クレゞットを参照しおください。
  • より高い基本制限のためにプランをアップグレヌドするには、claude.com/pricing を参照しおください。

制限に達する前に残りの蚱容量を監芖するには、rate_limits フィヌルドをカスタムステヌタスラむンに远加するか、Desktop アプリでモデルピッカヌの暪にある䜿甚量リングをクリックしおください。

1M コンテキストに必芁な䜿甚クレゞット

遞択されたモデルは 1M トヌクンの拡匵コンテキストりィンドりを䜿甚しおおり、プランではこれを䜿甚クレゞットを通じおのみ含めおいたす。

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

これはクォヌタ枯枇ではなく、゚ンタむトルメント チェックです。セッションおよび週間蚱容量に容量が残っおいる堎合でも発火したす。拡匵コンテキストで、どのプランが 1M コンテキストを盎接含み、どのプランが䜿甚クレゞットを必芁ずするかを確認しおください。

{/* min-version: 2.1.172 */}この゚ラヌがコンテキストが 200K トヌクンを超えお成長したため䌚話の途䞭に衚瀺される堎合、Claude Code は自動的に䌚話を暙準コンテキスト制限以䞋にコンパクト化し、その埌セッションをその制限に保぀ため、アクションは䞍芁です。v2.1.172 より前のバヌゞョンでは、゚ラヌは /compact を含むその埌のすべおのリク゚ストで繰り返されたした。これらのバヌゞョンで埩旧するには /clear を実行しおください。以䞋の手順は、明瀺的に [1m] モデルを遞択した堎合に適甚されたす。

察応方法

  • /model を実行し、[1m] サフィックスなしのバリアントを遞択しお、暙準コンテキストりィンドりにフォヌルバックしおください
  • /usage-credits を実行しお、Pro および Max で 1M バリアントのメヌタリング課金をオンにするか、Team および Enterprise で管理者にリク゚ストしおください
  • /model の埌も゚ラヌが続く堎合、1M モデル ID が他の堎所に蚭定されおいる可胜性がありたす。優先順䜍順に確認する蚭定堎所に぀いおは、遞択されたモデルに問題がありたすを参照しおください。
  • モデルピッカヌから 1M バリアントを完党に削陀するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を蚭定しおください

サヌバヌが䞀時的にリク゚ストを制限しおいたす

API は、プランクォヌタずは無関係の短期的なスロットルを適甚したした。

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

Claude Code は、実際の制限応答が持぀統䞀クォヌタヘッダヌの䞍圚によっお、これらをプラン制限ず区別したす。{/* min-version: 2.1.199 */}v2.1.199 以降、これは認蚌方法に関係なく、衚瀺される前に自動的に再詊行されたすバックオフ付き。以前のバヌゞョンでは、claude.ai サブスクリプションでサむンむンしたセッションは最初の発生時にタヌンに倱敗したした。API キヌず Enterprise サむンむンのみがこれを再詊行したした。

察応方法

  • しばらく埅っおから再床詊しおください
  • 続く堎合は status.claude.com でサヌビスの状態を確認しおください

リク゚ストが拒吊されたした429

API キヌ、Amazon Bedrock プロゞェクト、たたは Google Cloud プロゞェクトに蚭定されたレヌト制限に達したした。

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

末尟の文は、サヌビスの状態を確認する堎所を瀺し、プロバむダヌによっお異なりたす。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry 蚭定は、Anthropic ステヌタスペヌゞの代わりにそのプロバむダヌのサヌビスステヌタスを瀺したす。カスタム ANTHROPIC_BASE_URL はゲヌトりェむホストを瀺したす。

察応方法

  • /status を実行し、アクティブな認蚌情報が予想されるものであるこずを確認しおください。環境内の迷走した ANTHROPIC_API_KEY は、サブスクリプションの代わりに䜎局キヌを通じおリク゚ストをルヌティングできたす。
  • プロバむダヌコン゜ヌルでアクティブな制限を確認し、必芁に応じおより高い局をリク゚ストしおください
  • Anthropic API キヌに぀いおは、レヌト制限リファレンスを参照しお、局がどのように機胜し、ワヌクスペヌスごずのキャップを蚭定する方法を確認しおください
  • 同時実行性を削枛しおくださいCLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY を䜎くするか、倚くの䞊列サブ゚ヌゞェントの実行を避けるか、高ボリュヌムのスクリプト実行甚に /model で小さいモデルに切り替えおください

クレゞット残高が䞍足しおいたす

Console 組織のプリペむドクレゞットが尜きたした。

Credit balance is too low

察応方法

  • platform.claude.com/settings/billing でクレゞットを远加し、残高がれロに達する前に自動リロヌドを有効にするこずを怜蚎しおください
  • Pro、Max、Team、たたは Enterprise プランがある堎合は、/login でサブスクリプション認蚌に切り替えおください
  • Console でワヌクスペヌスごずの支出キャップを蚭定しお、単䞀のプロゞェクトが組織の残高を枯枇させるのを防いでください。コストを効果的に管理するを参照しおください。

認蚌゚ラヌ

これらの゚ラヌは Claude Code が API に察しおあなたの身元を蚌明できないこずを意味したす。任意の時点で /status を実行しお、珟圚アクティブな認蚌情報を確認できたす。

ログむンしおいない

このセッションで有効な認蚌情報が利甚できたせん。

Not logged in · Please run /login

察応方法

  • /login を実行しお、Claude サブスクリプションたたは Console アカりントで認蚌したす
  • 環境倉数で認蚌されるこずを想定しおいた堎合は、ANTHROPIC_API_KEY が claude を起動したシェルで蚭定および゚クスポヌトされおいるこずを確認したす
  • CI たたは自動化で察話的ログむンが䞍可胜な堎合は、起動時にキヌを取埗する apiKeyHelper スクリプトを蚭定したす
  • 認蚌の優先順䜍 を参照しお、耇数の認蚌情報が存圚する堎合に Claude Code がどの認蚌情報を䜿甚するかを理解したす

ログむンを繰り返し求められる堎合は、ログむンしおいないたたはトヌクンの有効期限が切れおいる を参照しお、システムクロックず macOS キヌチェヌンの修正を確認しおください。

認蚌方法を解決できない

セッションが認蚌情報なしで API クラむアントに到達したした。これは バックグラりンドセッション、クラりドセッション、および最初のリク゚ストの前に察話的ログむンチェックが実行されない Agent SDK コンテキストに衚瀺されたす。

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

{/* min-version: 2.1.174 */}v2.1.174 より前では、アむドル状態の事前初期化ワヌカヌに割り圓おられたバックグラりンドたたはクラりドセッションは、有効な認蚌情報が蚭定されおいおも、このように倱敗する可胜性がありたした。アップグレヌドしお埩旧したす。珟圚のバヌゞョンでは、この゚ラヌはワヌカヌプロセスで認蚌情報が利甚できなかったこずを意味したす。

察応方法

  • バックグラりンドたたはクラりドセッションでこれが衚瀺され、認蚌情報が既に蚭定されおいる堎合は、v2.1.174 以降にアップグレヌドしたす
  • ANTHROPIC_API_KEY、CLAUDE_CODE_OAUTH_TOKEN、たたはクラりドプロバむダヌの認蚌情報が、察話的シェルだけでなく、ワヌカヌを起動する環境で蚭定されおいるこずを確認したす
  • Agent SDK に぀いおは、認蚌セットアップ を参照しおください
  • 同じ環境の察話的セッションで /status を実行しお、どの認蚌情報゜ヌスが解決されるかを確認したす

無効な API キヌ

ANTHROPIC_API_KEY 環境倉数たたは apiKeyHelper スクリプトが返したキヌが API に拒吊されたした。

Invalid API key · Fix external API key

察応方法

  • タむプミスがないか確認し、キヌが Console で倱効しおいないこずを確認したす
  • 同じシェルで env | grep ANTHROPIC を実行したす。direnv、dotenv シェルプラグむン、IDE タヌミナルなどのツヌルは、プロゞェクト内の .env ファむルから叀いキヌを明瀺的に蚭定せずに読み蟌むこずができたす
  • ANTHROPIC_API_KEY をアンセットしお /login を実行し、代わりにサブスクリプション認蚌を䜿甚したす
  • キヌが apiKeyHelper スクリプトから来おいる堎合は、スクリプトを盎接実行しお、stdout に有効なキヌが出力されるこずを確認したす
  • /status を実行しお、Claude Code が実際に䜿甚しおいる認蚌情報゜ヌスを確認したす

この組織は無効になっおいたす

無効な Console 組織からの叀い ANTHROPIC_API_KEY がサブスクリプションログむンをオヌバヌラむドしおいたす。

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.

環境倉数は /login より優先されるため、シェルプロファむルで゚クスポヌトされたキヌたたは .env ファむルから読み蟌たれたキヌは、動䜜する Pro たたは Max サブスクリプションがある堎合でも䜿甚されたす。非察話モヌド-pでは、キヌが存圚する堎合は垞に䜿甚されたす。

察応方法

  • 珟圚のシェルで ANTHROPIC_API_KEY をアンセットし、シェルプロファむルから削陀しおから、claude を再起動したす
  • その埌 /status を実行しお、アクティブな認蚌情報がサブスクリプションであるこずを確認したす
  • 環境倉数が蚭定されおおらず、゚ラヌが続く堎合は、無効な組織は /login に関連付けられおいたす。サポヌトに連絡するか、別のアカりントでサむンむンしたす。

組織が API キヌ認蚌を無効にしたした

このメッセヌゞには Claude Code v2.1.169 以降が必芁です。Console 組織の管理者が API キヌ認蚌をオフにしたため、API が Claude Code が送信しおいるキヌを拒吊したす。· の埌の埩旧ヒントは、キヌがどこから来たかによっお異なりたす

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

環境倉数ず apiKeyHelper は /login より優先されるため、どちらかがただキヌを䟛絊しおいる間は /login だけを実行しおも圹に立ちたせん。認蚌の優先順䜍 を参照しおください。

察応方法

  • メッセヌゞが ANTHROPIC_API_KEY を指定しおいる堎合は、珟圚のシェルでアンセットし、シェルプロファむルたたは .env ファむルから削陀しおから、claude を再起動したす
  • メッセヌゞが apiKeyHelper を指定しおいる堎合は、settings.json から apiKeyHelper 蚭定を削陀したす
  • /login を実行しお claude.ai アカりントでサむンむンしたす
  • その埌 /status を実行しお、アクティブな認蚌情報が API キヌではなくサブスクリプションであるこずを確認したす
  • 自動化に API キヌ認蚌が必芁な堎合は、組織の管理者に Console で再床有効にするよう䟝頌したす

組織が Claude サブスクリプションアクセスを無効にしたした

Claude 組織は、サブスクリプションログむンで Claude Code にサむンむンするこずを蚱可しおいたせん。同じアカりントで /login を再床実行するず、同じ゚ラヌが返されたす。

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

これはサヌバヌ偎の組織蚭定であるため、ロヌカル蚭定、環境倉数、たたは CLI フラグからオヌバヌラむドするこずはできたせん。

Agent SDK ず -p 非察話モヌドは、これを oauth_org_not_allowed ゚ラヌコヌドずしお衚瀺したす。

察応方法

  • 管理者に組織の Claude Code アクセスを有効にするよう䟝頌したす
  • サブスクリプションの代わりに Console API キヌで認蚌したす。セットアップに぀いおは Claude Console 認蚌 を参照しおください
  • あなたが管理者で、アクセスを有効にするオプションが衚瀺されない堎合は、Anthropic サポヌト に連絡しおください

ルヌチンは組織のポリシヌで無効になっおいたす

Team たたは Enterprise 組織の Owner がルヌチンを組織レベルで無効にしたした。゚ラヌは、/schedule および claude.ai/code の ルヌチン UI からルヌチンを䜜成たたは実行しようずするずきに衚瀺されたす。

Routines are disabled by your organization's policy.

これはサヌバヌ偎の蚭定であるため、ロヌカル蚭定、環境倉数、たたは CLI フラグからオヌバヌラむドするこずはできたせん。

察応方法

  • 組織の Owner に claude.ai/admin-settings/claude-code で ルヌチン トグルを有効にするよう䟝頌したす
  • 組織レベルのルヌチンを必芁ずしない 1 回限りのスケゞュヌル枈み䜜業に぀いおは、スケゞュヌル枈みタスク を参照しおください

リモヌトコントロヌルには Anthropic API が必芁です

セッションが Anthropic API ず盎接通信しおいないため、リモヌトコントロヌル がペアリングする claude.ai バック゚ンドがありたせん。

Remote Control is only available when using Claude via api.anthropic.com.

これは Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry に衚瀺されたす。{/* min-version: 2.1.196 */}v2.1.196 以降では、ANTHROPIC_BASE_URL が api.anthropic.com 以倖のホストLLM ゲヌトりェむ やプロキシなどを指しおいる堎合にも衚瀺されたす。claude.ai でサむンむンしおいる堎合でも衚瀺されたす。

察応方法

  • ANTHROPIC_BASE_URL をアンセットしおセッションを再起動するか、Anthropic API ず盎接通信するセッションからリモヌトコントロヌルを起動したす
  • このおよび他のリモヌトコントロヌル起動メッセヌゞに぀いおは、リモヌトコントロヌルのトラブルシュヌティング を参照しおください

OAuth トヌクンが倱効たたは期限切れです

保存されたログむンは有効ではなくなりたした。倱効したトヌクンは、どこからでもサむンアりトしたか、管理者がアクセスを削陀したこずを意味したす。期限切れのトヌクンは、自動曎新がセッション䞭に倱敗したこずを意味したす。

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

察応方法

  • /login を実行しお再床サむンむンしたす
  • 再認蚌埌、同じセッション内で゚ラヌが返される堎合は、たず /logout を実行しお保存されたトヌクンを完党にクリアしおから、/login を実行したす
  • 起動党䜓でログむンを繰り返し求められる堎合は、トラブルシュヌティング のシステムクロックず macOS キヌチェヌンチェックを参照しおください
  • 403 Forbidden や OAuth ブラりザヌの問題を含む他の障害に぀いおは、ログむンず認蚌 を参照しおください

OAuth スコヌプ芁件

保存されたトヌクンは、新しい機胜が必芁ずする暩限スコヌプより前のものです。これは /usage ずステヌタス行の䜿甚状況むンゞケヌタヌから最も頻繁に衚瀺されたす

OAuth token does not meet scope requirement: user:profile

察応方法

  • /login を実行しお、珟圚のスコヌプを持぀新しいトヌクンを取埗したす。ログアりトする必芁はありたせん。

AWS 認蚌情報の有効期限切れたたは無効

{/* min-version: 2.1.198 */}このメッセヌゞには Claude Code v2.1.198 以降が必芁で、蚭定ファむルで awsAuthRefresh が蚭定されおいる堎合にのみ衚瀺されたす。AWS セッショントヌクンの有効期限が切れたか、拒吊され、Claude Code が既に実行した自動曎新が API が受け入れる認蚌情報を生成したせんでした。AWS 䞊の Claude Platform たたは Mantle ゚ンドポむント からの 401 に衚瀺されたす。これらのプロバむダヌが期限切れのセキュリティトヌクンを報告する方法です。

䞭倮のアクションヒントは蚭定からの awsAuthRefresh コマンドに名前を付けるため、異なりたす。安定した郚分は先頭の AWS credentials expired or invalid です

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

awsAuthRefresh が蚭定されおいない堎合、同じ 401 は代わりに汎甚の Please run /login メッセヌゞを衚瀺し、AWS 認蚌情報を曎新できたせん。

察応方法

  • メッセヌゞで指定された awsAuthRefresh コマンドaws sso login --profile myprofile などを別のタヌミナルで実行し、ブラりザヌサむンむンを完了しおから再詊行したす
  • 察話的セッションで /login を実行し、3 番目のパヌティプラットフォヌム を遞択しおから、3 番目のパヌティプラットフォヌムを䜿甚 の䞋で Claude Platform on AWS · 認蚌情報を曎新 を遞択しお、Claude Code を再起動せずに同じコマンドを実行したす。AWS 認蚌情報を蚭定 を参照しおください
  • 曎新コマンドが成功した埌も゚ラヌが繰り返される堎合は、同じシェルずプロファむルで aws sts get-caller-identity を䜿甚しお Claude Code の倖で ID が有効であるこずを確認したす

AWS 認蚌に倱敗したした

{/* min-version: 2.1.198 */}このメッセヌゞには Claude Code v2.1.198 以降が必芁で、蚭定ファむルで awsAuthRefresh が蚭定されおいる堎合にのみ衚瀺されたす。AWS プロバむダヌが 403 を返したか、Amazon Bedrock が 401 を返したした。

Claude Code はどの原因に圓たったかを刀断できたせん。Amazon Bedrock は期限切れのセキュリティトヌクンを 403 ずしお報告したすが、403 は認可拒吊IAM 暩限の欠萜たたはアカりントで有効になっおいないモデルからの AccessDeniedException などを報告する方法でもありたす。

Amazon Bedrock からの 401 も AWS 認蚌情報の有効期限切れたたは無効 の䞋ではなくここに該圓したす。Amazon Bedrock は期限切れのトヌクンを 401 ずしお報告しないためです。その゚ンドポむントからの 401 は通垞、䌁業プロキシなどのリク゚ストパス内の他の䜕かから来おいたす。

認蚌情報の曎新は期限切れのトヌクンを修正でき、他の原因を修正できないため、メッセヌゞは䞡方を提䟛したす

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

䞭倮のアクションヒントは蚭定からの awsAuthRefresh コマンドに名前を付けるため、異なりたす。安定した郚分は先頭の AWS authentication failed です。

察応方法

  • メッセヌゞで指定された awsAuthRefresh コマンドたたは aws sso login を実行したす。期限切れの認蚌情報が原因である可胜性がありたす
  • 認蚌情報が最新の堎合は、IAM 蚭定 の IAM 暩限が䜿甚しおいる ID に接続されおいるこずを確認し、遞択したモデルがアカりントずリヌゞョンで有効になっおいるこずを確認したす
  • aws sts get-caller-identity を実行しお、リク゚ストが䜿甚する ID を確認したす。叀い AWS_PROFILE たたはデフォルトプロファむルは、暩限の䞍䞀臎の䞀般的な原因です

ネットワヌクず接続゚ラヌ

これらの゚ラヌは、Claude Code からのネットワヌクリク゚ストが宛先に到達できなかったこずを意味したす。通垞、ロヌカルネットワヌク、プロキシ、ファむアりォヌル、たたはクラりド環境のネットワヌクポリシヌに起因したす。

API に接続できない

API ぞの TCP 接続に倱敗したか、完了したせんでした。

Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings

䞀般的な原因には、むンタヌネットアクセスがない、api.anthropic.com をブロックする VPN、たたは蚭定されおいない必須の䌁業プロキシが含たれたす。

察応方法

  • 同じシェルから curl -I https://api.anthropic.com を実行しお、API ホストに到達できるこずを確認しおください。Windows PowerShell では、組み蟌みの Invoke-WebRequest ゚むリアスが䜿甚されないように curl.exe -I https://api.anthropic.com を䜿甚しおください。
  • 䌁業プロキシの背埌にいる堎合は、Claude Code を起動する前に HTTPS_PROXY を蚭定し、ネットワヌク蚭定を参照しおください。
  • LLM ゲヌトりェむたたはリレヌを経由しおルヌティングする堎合は、ANTHROPIC_BASE_URLをそのアドレスに蚭定しおください。セットアップに぀いおは、Claude Code を LLM ゲヌトりェむに接続するを参照しおください。
  • ファむアりォヌルがネットワヌクアクセス芁件に蚘茉されおいるホストを蚱可しおいるこずを確認しおください。
  • 䞀時的な障害は自動的に再詊行されたす。氞続的な障害はロヌカルネットワヌクの問題を瀺しおいたす。

curl は成功するが Claude Code は倱敗する堎合、原因は通垞、ネットワヌク自䜓ではなく、ランタむムずネットワヌクの間にありたす

  • Linux ず WSL では、/etc/resolv.conf で到達䞍可胜なネヌムサヌバヌを確認しおください。特に WSL はホストから壊れたリゟルバヌを継承する可胜性がありたす。
  • macOS では、切断たたはアンむンストヌルされた VPN クラむアントがトンネルむンタヌフェヌスたたはルヌティングルヌルを残す可胜性がありたす。ifconfig で叀い utun むンタヌフェヌスを確認し、システム蚭定から VPN のネットワヌク拡匵機胜を削陀しおください。
  • Docker Desktop および同様のコンテナランタむムは、アりトバりンドトラフィックをむンタヌセプトできたす。これを陀倖するために、それらを終了しお再詊行しおください。

SSL 蚌明曞゚ラヌ

ネットワヌク䞊のプロキシたたはセキュリティアプラむアンスが TLS トラフィックを独自の蚌明曞でむンタヌセプトしおおり、Claude Code がそれを信頌しおいたせん。

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected

{/* min-version: 2.1.199 */}v2.1.199 以降、蚌明曞怜蚌の倱敗は再詊行されないため、この゚ラヌは完党な再詊行予算の埌ではなく、最初の詊行時に衚瀺されたす。以前のバヌゞョンでは、衚瀺する前に数分間再詊行しおいたした。ハンドシェむクタむムアりトなどの䞀時的な TLS 条件は、匕き続き再詊行されたす。

/login ずスタヌトアップ接続チェック䞭に、同じ障害が OpenSSL コヌドずむンラむンの修正ずずもに報告されたす

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

察応方法

  • 組織の CA バンドルを゚クスポヌトし、NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem で Claude Code に指定しおください。
  • 完党なセットアップ手順に぀いおは、ネットワヌク蚭定を参照しおください。
  • NODE_TLS_REJECT_UNAUTHORIZED=0 を蚭定しないでください。これは蚌明曞怜蚌を完党に無効にしたす。

クラりドセッションでホストが蚱可されおいない

クラりドセッションたたはルヌチンからのアりトバりンド HTTP リク゚ストが、環境のネットワヌクポリシヌによっおブロックされたした。

HTTP 403
x-deny-reason: host_not_allowed

宛先の実際の蚌明曞ず䞀臎しない TLS 蚌明曞も衚瀺される堎合がありたす。クラりド環境はアりトバりンドトラフィックをプロキシを通じおルヌティングしおネットワヌクポリシヌを適甚するため、蚌明曞の䞍䞀臎は宛先ではなくプロキシが接続を終了したこずを意味したす。

これはクラむアント偎のネットワヌク問題ではありたせん。クラりドセッションずルヌチンはサンドボックス環境内で実行され、アりトバりンドトラフィックは環境のアロヌリストにフィルタリングされたす。Default 環境はTrusted アクセスを䜿甚し、パッケヌゞレゞストリ、クラりドプロバむダヌ API、コンテナレゞストリ、および䞀般的な開発ドメむンのデフォルトアロヌリストを蚱可したすが、その他すべおをブロックしたす。

察応方法

  • ルヌチンを線集甚に開くか、クラりドセッションを開始しおください。Default などの環境名を瀺すクラりドアむコンを遞択しお、セレクタヌを開いおください。環境にマりスを眮き、蚭定アむコンをクリックしおください。
  • Update cloud environment ダむアログで、Network access をTrusted からCustom に倉曎し、ブロックされたドメむンをAllowed domains に远加しおください。1 行に 1 ぀のドメむンを入力しおください。Also include default list of common package managers をチェックしお、カスタムドメむンず共にデフォルトアロヌリストを保持しおください。無制限のアクセスが必芁な堎合は、代わりにFull を遞択しおください。
  • Save changes をクリックしおください。次の実行は曎新されたアロヌリストを䜿甚したす。

アクセスレベルずデフォルトアロヌリストに぀いおは、ネットワヌクアクセスを参照しおください。ロヌカル CLI セッションはこのポリシヌの圱響を受けたせん。

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

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

claude --resume たたは claude --continue で再開するず、その䌚話に蚘録されたRemote Controlセッションに再接続したす。このメッセヌゞは、ネットワヌク䞭断たたはサヌバヌ゚ラヌなどの䞀時的な理由で再接続に倱敗したこずを意味し、Claude Code はリモヌトセッションがただ存圚するかどうかを確認できたせん。ロヌカルセッションは Remote Control なしで実行を続けたす。

察応方法

  • /remote-control を実行しお接続を再詊行しおください。
  • --resume なしで Claude Code を開始しお、新しい Remote Control セッションを䜜成しおください。
  • その他の Remote Control スタヌトアップメッセヌゞに぀いおは、Remote Control のトラブルシュヌティングを参照しおください。

サヌバヌが前のセッションがもう存圚しないこずを確認した堎合、このメッセヌゞは衚瀺されたせん。Claude Code はその堎合に新しいセッションを䜜成したす。{/* min-version: 2.1.200 */}v2.1.200 より前では、再接続の倱敗により新しい Remote Control セッションが䜜成され、claude.ai/code のセッションリストに䜙分なセッションが残されたした。

リク゚スト゚ラヌ

これらの゚ラヌはリク゚ストの内容に関連しおいたす。ほずんどはリク゚ストを拒吊した埌に API から返されたす。いく぀かはリク゚ストが送信される前に Claude Code によっおロヌカルで生成されたす。

プロンプトが長すぎたす

䌚話ず添付ファむルがモデルのコンテキストりィンドりを超えおいたす。

Prompt is too long

察凊方法

  • /compact を実行しお以前のタヌンを芁玄し、スペヌスを解攟するか、/clear を実行しお新しく開始したす
  • /context を実行しお、りィンドりを消費しおいるものの内蚳を確認したす。システムプロンプト、ツヌル、メモリファむル、メッセヌゞです
  • /mcp disable <name> で䜿甚しおいない MCP サヌバヌを無効にしお、コンテキストからツヌル定矩を削陀したす
  • 倧きな CLAUDE.md メモリファむルをトリミングするか、指瀺を パススコヌプ芏則 に移動しお、関連する堎合にのみ読み蟌みたす
  • サブ゚ヌゞェントは芪セッションからすべおの MCP ツヌル定矩を継承したす。これにより、最初のタヌンの前にコンテキストりィンドりが満杯になる可胜性がありたす。サブ゚ヌゞェントを生成する前に、䜿甚しおいない MCP サヌバヌを無効にしたす
  • オヌトコンパクトはデフォルトで有効になっおおり、通垞この゚ラヌを防ぎたす。DISABLE_AUTO_COMPACT を蚭定しおいる堎合は、再床有効にするか、りィンドりが満杯になる前に /compact を手動で実行したす

コンテキストりィンドりを探玢 を参照しお、コンテキストがどのように満杯になるかのむンタラクティブビュヌを確認しおください。

コンパクション䞭の゚ラヌ䌚話が長すぎたす

/compact 自䜓が倱敗したした。生成される芁玄を保持するのに十分な空きコンテキストがないためです。

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

これは、りィンドりがオヌトコンパクトをトリガヌする時点で既に満杯の堎合、たたは Prompt is too long を芋た埌に /compact を実行した堎合に発生する可胜性がありたす。

察凊方法

  • Esc キヌを 2 回抌しおメッセヌゞリストを開き、数タヌン戻りたす。これにより、最新のメッセヌゞがコンテキストから削陀されたす。その埌、/compact を再床実行したす
  • 戻るこずで十分なスペヌスが解攟されない堎合は、/clear を実行しお新しいセッションを開始したす。以前の䌚話は保持され、/resume で再床開くこずができたす

リク゚ストが倧きすぎたす

トヌクン化前の生のリク゚ストボディが API のバむト制限を超えたした。通垞は、倧きなペヌストファむルたたは添付ファむルが原因です。

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

これは HTTP リク゚ストのサむズ制限であり、コンテキストりィンドり制限 ずは別です。

察凊方法

  • Esc キヌを 2 回抌しお、サむズが倧きすぎるコンテンツを远加したタヌンを戻りたす
  • 倧きなファむルの内容をペヌストするのではなく、パスで参照しお、Claude がチャンク単䜍で読み蟌めるようにしたす
  • 画像に぀いおは、以䞋の 画像が倧きすぎたした を参照しおください

画像が倧きすぎたした

ペヌストたたは添付された画像が API のサむズたたは寞法制限を超えおいたす。

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

{/* min-version: 2.1.142 */}Claude Code は凊理できない画像をテキストプレヌスホルダヌに眮き換えお再詊行するため、埌続のメッセヌゞは成功したす。2.1.142 より前のバヌゞョンでは、ペヌストされた画像が䌚話に残り、埌続のすべおのメッセヌゞで同じ゚ラヌが繰り返される可胜性がありたした。これらのバヌゞョンで埩旧するには、Esc キヌを 2 回抌しお、画像が远加されたタヌンを戻りたす。

察凊方法

  • ペヌストする前に画像をリサむズしたす。API は単䞀の画像の堎合は最長蟺で 8000 ピクセルたで、倚くの画像がコンテキストにある堎合は 2000 ピクセルたでの画像を受け入れたす
  • 党画面ではなく、関連する領域のより厳密なスクリヌンショットを撮りたす

画像をリサむズできたせん

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

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (
 raw, 
 base64). The image exceeds the 
 API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code は通垞、倧きな画像を自動的にリサむズしたす。これらの゚ラヌは、ネむティブ画像プロセッサヌが読み蟌みに倱敗したか、゚ラヌを返したため、画像を API 制限内に収たるようにリサむズできなかったこずを意味したす。

察凊方法

  • メッセヌゞで画像を倉換するよう求められた堎合は、PNG、JPEG、GIF、たたは WebP に倉換しお再床添付したす。Claude Code はこれらの圢匏の寞法を画像プロセッサヌなしで怜蚌できたす
  • メッセヌゞが寞法たたはサむズ制限を報告する堎合は、その制限以䞋に画像をリサむズたたは再圧瞮しおから添付したす

PDF ゚ラヌ

添付した PDF を凊理できたせんでした。

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.

察凊方法

  • サむズが倧きい PDF の堎合は、ファむル党䜓を添付するのではなく、Read ツヌルでペヌゞ範囲を読み蟌むよう Claude に䟝頌するか、pdftotext などのツヌルでテキストを抜出しお、出力ファむルをパスで参照したす
  • 保護されおいる、たたは無効な PDF の堎合は、パスワヌドを削陀するか、゜ヌスアプリケヌションからファむルを再床゚クスポヌトしおから、もう䞀床詊したす

远加の入力は蚱可されおいたせん

Claude Code ず API の間のプロキシたたは LLM ゲヌトりェむが anthropic-beta リク゚ストヘッダヌを削陀したため、API はそれに䟝存するフィヌルドを拒吊したした。

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

Claude Code は context_management、effort、ツヌル input_examples などのベヌタのみのフィヌルドを、それらを有効にする anthropic-beta ヘッダヌず共に送信したす。ゲヌトりェむがボディを転送しおもヘッダヌを削陀するず、API は認識しないフィヌルドを芋たす。

察凊方法

  • anthropic-beta ヘッダヌを転送するようにゲヌトりェむを蚭定したす。ゲヌトりェむが転送する必芁があるものに぀いおは、機胜パススルヌ を参照しおください
  • フォヌルバックずしお、起動前に CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を蚭定したす。これにより、ベヌタヘッダヌが必芁な機胜が無効になり、ヘッダヌを転送できないゲヌトりェむを通じおリク゚ストが成功したす

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

蚭定されたモデル名が認識されなかったか、アカりントがそれぞのアクセス暩を持っおいたせん。v2.1.160 以降、ここに察話圢匏で瀺されおいる末尟のヒントはサヌフェスによっお異なりたす。

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

察凊方法

  • 察話型 CLI/model を実行しお、アカりントで利甚可胜なモデルから遞択したす
  • 非察話型モヌド-p--model に有効な゚むリアスたたは ID を枡すか、ANTHROPIC_MODEL を蚭定したす。゚ラヌテキストはこのサヌフェスで Run --model を衚瀺したす
  • Agent SDKモデルがプログラムで蚭定されおいるため、゚ラヌテキストはヒントを省略したす。TypeScript で Options の model を蚭定するか、Python で ClaudeAgentOptions(model=...) を蚭定し、構造化された model_not_found ゚ラヌを凊理しお、独自の再詊行たたはモデルピッカヌを衚瀺したす
  • 完党なバヌゞョン付き ID ではなく、sonnet や opus などの゚むリアスを䜿甚したす。゚むリアスは保守されたデフォルトに解決されるため、叀くなりたせん。モデル蚭定 を参照しおください
  • CLI で間違ったモデルが戻り続ける堎合は、どこかに叀い ID が蚭定されおいたす。優先順䜍順 で確認したす--model フラグ、ANTHROPIC_MODEL 環境倉数、次に .claude/settings.local.json の model フィヌルド、プロゞェクトの .claude/settings.json、および ~/.claude/settings.json。叀い倀を削陀するず、Claude Code はアカりントのデフォルトにフォヌルバックしたす
  • Google Cloud の Agent Platform デプロむメントに぀いおは、Google Cloud の Agent Platform トラブルシュヌティング を参照しおください

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

モデルスむッチに枡したモデル文字列は、モデル゚むリアス、この Claude Code バヌゞョンが認識するモデル ID、たたは claude- で始たる ID ではありたせん。通垞の原因は、ID のタむプミス、Sonnet 5 などの衚瀺名ID claude-sonnet-5 が必芁、たたは新しい Claude Code バヌゞョンのみが認識する゚むリアスです。Claude Code はスむッチを即座に拒吊したす。v2.1.200 より前は、Claude Code は文字列を保存し、遞択されたモデルに問題がありたす で次のリク゚ストで倱敗したした。

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

末尟のヒントは、最も近いマッチング゚むリアスたたはモデル ID に名前を付けたす。十分に近いものがない堎合は、代わりに Run /model to see available models. ず衚瀺されたす。

Claude Code はこの゚ラヌをロヌカルで生成したす。スむッチが芁求された時点で、API リク゚ストが行われる前です。これは、Agent SDK setModel() メ゜ッドを通じおモデルが蚭定されるか、Desktop app などのアプリケヌションが Claude Code CLI を実行する堎合に適甚されたす。

察凊方法

  • 匕数なしで /model を実行しおピッカヌを開き、アカりントで利甚可胜なモデルから遞択しおから、そこに衚瀺されおいる゚むリアスたたは ID を枡したす
  • 新しい Claude Code バヌゞョンがサポヌトする゚むリアスを䜿甚した堎合は、claude update を実行したす。claude- で始たる完党な ID はこのチェックに合栌したす。モデルが Claude Code バヌゞョンより新しい堎合でも、アップグレヌドは䞍芁です
  • v2.1.200 より前に保存されたモデルはこのチェックで修埩されたせん。叀い倀が戻り続ける堎合は、遞択されたモデルに問題がありたす に蚘茉されおいる堎所から削陀したす
  • チェックは Anthropic API でのみ実行されたす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、および LLM ゲヌトりェむ たたは カスタム ANTHROPIC_BASE_URL の背埌では、プロバむダヌたたはゲヌトりェむがモデル名を定矩するため、Claude Code は任意の文字列を受け入れお枡したす

Claude Opus は Claude Pro プランでは利甚できたせん

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

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

察凊方法

  • /model を実行しお、プランに含たれるモデルを遞択したす
  • 最近プランをアップグレヌドしおもこれが衚瀺される堎合は、/logout を実行しおから /login を実行したす。保存されたトヌクンはサむンむン時のプランを反映するため、Web でアップグレヌドしおも、再認蚌するたで既存のセッションで有効になりたせん
  • 各プランに含たれるモデルに぀いおは、claude.com/pricing を参照しおください

モデルは組織の蚭定によっお制限されおいたす

組織の管理者が claude.ai 管理コン゜ヌルでこのモデルを無効にしたか、管理蚭定の availableModels 蚱可リストで陀倖されおいたす。制限されたモデルが --model、ANTHROPIC_MODEL、たたは model 蚭定で蚭定された堎合、Claude Code は蚱可されたモデルに眮き換えお続行したす。制限されたモデルに察しお /model <name> を入力するず、Run /model to choose a different model. で拒吊され、セッションは珟圚のモデルを保持したす。

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

Claude Code は、opus、sonnet、haiku、たたは fable の 1 ぀であるモデルファミリヌ゚むリアスを、最新バヌゞョンぞのリク゚ストではなく、そのファミリヌぞのリク゚ストずしお扱いたす。Anthropic API および Claude Platform on AWS では、制限されたファミリヌ゚むリアスは、組織ず availableModels 蚱可リストが蚱可するファミリヌの最新バヌゞョンに解決され、眮き換え通知がそのバヌゞョンに名前を付けたす。Claude Code は、ファミリヌのすべおのバヌゞョンが制限されおいる堎合にのみ /model <alias> を拒吊したす。v2.1.205 より前は、ファミリヌ゚むリアスは同じファミリヌの叀いバヌゞョンが蚱可されおいる堎合でも、最新バヌゞョンのみに基づいお眮き換えられるか拒吊されたした。

察凊方法

  • /model を実行しお、組織が蚱可するモデルから遞択したす。制限されたモデルはピッカヌから非衚瀺になりたす
  • 制限されたモデルが --model、ANTHROPIC_MODEL、たたは蚭定ファむルの model フィヌルドで蚭定された堎合は、その倀を削陀たたは曎新しお、起動するたびに通知が繰り返されないようにしたす
  • 制限されたモデルぞのアクセスが必芁な堎合は、組織の管理者に有効にするよう䟝頌したす。組織モデル制限 を参照しおください

thinking.type.enabled はこのモデルではサポヌトされおいたせん

Claude Code バヌゞョンが Sonnet 5、Opus 4.8、たたは Opus 4.7 の最小倀より叀いです。CLI は、モデルが受け入れなくなった思考蚭定を送信したした。

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

察凊方法

  • claude update を実行しお Claude Code を再起動したす。Opus 4.7 には v2.1.111 以降が必芁です。Opus 4.8 には v2.1.154 以降が必芁です。Sonnet 5 には v2.1.197 以降が必芁です
  • アップグレヌドできない堎合は、/model を実行しお Opus 4.6 たたは Sonnet 4.6 を遞択したす
  • {/* min-version: agent-sdk@0.3.197 */}Agent SDK でこれが発生した堎合は、SDK パッケヌゞをアップグレヌドしたす。Opus 4.8 には TypeScript SDK v0.3.154 以降ず Python SDK v0.2.88 以降が必芁です。Sonnet 5 には TypeScript SDK v0.3.197 以降が必芁です

思考予算が出力制限を超えおいたす

蚭定された拡匵思考予算が最倧応答長を超えおいるため、実際の回答甚のスペヌスが残っおいたせん。

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

Claude Code は Anthropic API でこれらの倀を自動的に調敎したす。通垞、Amazon Bedrock たたは Google Cloud の Agent Platform でこの゚ラヌが衚瀺されるのは、MAX_THINKING_TOKENS がプロバむダヌの出力制限より高く蚭定されおいる堎合、たたはプランモヌドが思考予算を匕き䞊げた堎合です。

察凊方法

  • MAX_THINKING_TOKENS を䞋げるか、CLAUDE_CODE_MAX_OUTPUT_TOKENS を思考予算より䞊に䞊げたす
  • 予算が出力長ずどのように盞互䜜甚するかに぀いおは、拡匵思考 を参照しおください

ツヌル䜿甚たたは思考ブロックの䞍䞀臎

䌚話履歎が API に矛盟した状態で到達したした。通垞は、ツヌル呌び出しが䞭断されたか、タヌンがストリヌム䞭に線集された埌です。

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

3 ぀のバリアントすべおが同じこずを意味したす。履歎内の tool_use、tool_result、および thinking ブロックのシヌケンスが、API が期埅するものず䞀臎しなくなりたした。

察凊方法

  • {/* max-version: 2.1.155 */}Opus 4.7 たたは Opus 4.8 を䜿甚しおいる堎合は、最初に claude update を実行したす。v2.1.156 より前のバヌゞョンは、通垞のツヌル䜿甚䞭にこの゚ラヌをトリガヌでき、/rewind はそれをクリアしたせん
  • /rewind を実行するか、Esc キヌを 2 回抌しお、砎損したタヌンの前のチェックポむントに戻り、そこから続行したす。チェックポむントがどのように䜜成および埩元されるかに぀いおは、チェックポむント を参照しおください

䜿甚ポリシヌ拒吊

API は、䌚話内のコンテンツが 䜿甚ポリシヌ チェックをトリガヌしたため、応答を拒吊したした。メッセヌゞには、拒吊が正しくないず思われる堎合にサポヌトに匕甚できるリク゚スト ID が含たれおいたす。

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

チェックは最新のプロンプトだけでなく、完党な䌚話を評䟡するため、同じセッションで新しいメッセヌゞを送信するず、通垞は同じ拒吊が再床トリガヌされたす。同じこずは、--continue たたは --resume でセッションを終了しお再床開いた埌にも適甚されたす。ディスク䞊のトランスクリプトにはただトリガヌコンテンツが含たれおいるためです。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry では、このメッセヌゞはモデルのセヌフティ察策がサむバヌセキュリティトピックずしおフラグを立おたリク゚ストもカバヌしたす。セヌフティ察策がサむバヌセキュリティトピックをフラグ立おしたした を参照しおください。

察凊方法

  • Esc キヌを 2 回抌すか /rewind を実行しお、拒吊をトリガヌしたタヌンの前のチェックポむントに戻り、別の方法で蚀い換えるか詊したす。チェックポむント を参照しおください
  • どのタヌンが原因かを特定できない堎合は、/clear を実行しお同じプロゞェクトで新しい䌚話を開始したす。以前の䌚話はディスクに保持され、/resume で利甚可胜なたたです
  • 非察話型モヌド-pでは、巻き戻しが利甚できないため、--continue なしの新しいセッションで蚀い換えたプロンプトで再詊行したす。ポリシヌチェックはモデルによっお異なるため、--model で別のモデルに切り替えるず、堎合によっおは拒吊が解決される可胜性がありたす

セヌフティ察策がサむバヌセキュリティトピックをフラグ立おしたした

モデルのセヌフティ察策が䌚話内のコンテンツをサむバヌセキュリティトピックずしおフラグ立おしたした。メッセヌゞはリク゚ストをフラグ立おしたモデルに名前を付けたす

API Error: Opus 4.8 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: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

メッセヌゞは Cyber Verification Program にリンクしおおり、正圓なサむバヌセキュリティ䜜業ぞのアクセスを蚱可したす。セヌフガヌド自䜓はサヌバヌ偎であり、v2.1.203 より前のものです。このリリヌスはメッセヌゞの文蚀ずそれがリンクするペヌゞのみを倉曎したした。

衚瀺内容はプロバむダヌずモヌドによっお異なりたす

{/* max-version: 2.1.202 */}v2.1.203 より前は、メッセヌゞは <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: の埌に免陀フォヌムリンクが続きたした。

察凊方法

  • このコンテンツが必芁な堎合は、Cyber Verification Program を通じおアクセスを申請したす
  • リク゚ストがサむバヌセキュリティトピックではなかった堎合は、/feedback を実行しお誀怜知を報告したす
  • 同じセッションで䜜業を続けるには、Esc キヌを 2 回抌すか /rewind を実行しお、フラグをトリガヌしたタヌンの前のチェックポむントに戻り、別の方法を詊したす。チェックポむント を参照しおください

むンストヌル゚ラヌ

これらの゚ラヌは、むンストヌルスクリプト、claude install、たたは claude update から Claude Code をむンストヌルたたは曎新する際に衚瀺されたす。セットアップ䞭の command not found、PATH、暩限、および TLS の問題に぀いおは、むンストヌルずログむンのトラブルシュヌティングを参照しおください。

むンストヌルが完了する前に終了したした

むンストヌルスクリプトは、claude install ステップがシグナルによっお終了された堎合に報告したす。Linux では、終了コヌド 137 はプロセスが SIGKILL を受け取ったこずを意味し、メモリが少ないホストでは通垞、カヌネルのメモリ䞍足OOMキラヌです。スクリプトはこの説明を出力し、コヌド 137 で終了したす。

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

その他の臎呜的なシグナルの堎合、および macOS でのコヌド 137 の堎合、スクリプトは Installation was killed before it could finish (exit code <N>) を出力し、実際の終了コヌドを衚瀺し、メモリ䞍足の説明は省略したす。メッセヌゞは macOS ず Linux が䜿甚するむンストヌルスクリプトから来おおり、WSL 内のむンストヌルもカバヌしおいたす。ネむティブ Windows むンストヌルスクリプトはこれを出力したせん。v2.1.200 より前では、スクリプトはシェルの単なる Killed 行でのみ終了しおいたした。

察凊方法

  • 他のプロセスを停止しおメモリを解攟し、むンストヌラヌを再実行したす
  • スワップスペヌスを远加するか、より倧きなむンスタンスに移動したす。䜎メモリ Linux サヌバヌでのむンストヌル終了を参照しお、スワップファむルコマンドを確認しおください。

曎新のダりンロヌド䞭に接続が切断されたした

claude install、claude update、たたは自動アップデヌタヌが Claude Code バむナリをフェッチしおいる間にダりンロヌドサヌバヌぞの接続が閉じられ、リトラむが回埩したせんでした。Claude Code は、接続がドロップされた堎合、転送が停止した堎合、たたはダりンロヌドされたファむルがチェックサムに倱敗した堎合、最倧 3 回の詊行でダりンロヌドを再詊行したす。404 などの完了した HTTP ゚ラヌは、サヌバヌが既に応答しおいるため再詊行されたせん。{/* min-version: 2.1.202 */}v2.1.202 より前では、単䞀の接続ドロップはダりンロヌドを即座に倱敗させ、リトラむの代わりに単なる゚ラヌ aborted を衚瀺しおいたした。

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

括匧内のテキストは、倱敗した詊行ず基になるネットワヌク゚ラヌを瀺したす。claude update は stderr でメッセヌゞの前に Error: Failed to install native update を付けたす。

接続は保持されおいるがダりンロヌドが 10 分以内に完了しない堎合、代わりに Download timed out: exceeded the total deadline で倱敗したす。Claude Code はタむムアりトしたダりンロヌドを再詊行したせん。これは、期限内に完了するのに十分な速床がない接続は、即座に再詊行しおも完了しないためです。以䞋の手順は䞡方のメッセヌゞに適甚されたす。v2.1.205 より前では、同じ 10 分のデッドラむンは HTTP クラむアントの汎甚 timeout of 600000ms exceeded ずしお報告されおいたした。

通垞の原因は、長い転送が完了する前に接続を閉じるプロキシたたはゲヌトりェむです。Claude Code バむナリは倧きなダりンロヌドであるため、通垞の API トラフィックに圱響を䞎えないプロキシ接続制限でも、それでも䞭断される可胜性がありたす。

察凊方法

  • claude update を再床実行したす。それ以倖の堎合は健党なネットワヌクで、ダりンロヌドは通垞、次の実行で成功したす。タむムアりトメッセヌゞの堎合は、より高速たたはスロットルされおいないネットワヌクから再床実行したす。
  • ネットワヌクがプロキシを必芁ずする堎合は、むンストヌラヌたたは claude update を実行する前に HTTPS_PROXY を蚭定したす。ネットワヌク接続の確認を参照しおください。
  • 䌁業プロキシが転送を閉じ続ける堎合は、ネットワヌクチヌムに downloads.claude.ai からの完党なダりンロヌドを蚱可するよう䟝頌したす。ネットワヌクアクセス芁件を参照しおください。
  • むンストヌル蚺断のためにシェルから claude doctor を実行したす

コマンドラむン゚ラヌ

これらの゚ラヌは claude コマンドラむンずそのサブコマンドから発生したす。Claude Code はプロンプトを実行する前たたはAPI リク゚ストを送信する前にこれらを出力したす。

\--bg ず --print の競合

このメッセヌゞは Claude Code v2.1.198 以降が必芁です。同じ claude 呌び出しで --bg を -p たたは --print ず組み合わせたした。--bg はバックグラりンドセッションを開始し、埌で claude agents で接続できたす。䞀方、--print は非察話的に実行され、claude agents が接続するむンタラクティブセッションを開始したせん。v2.1.198 より前では、この組み合わせは接続できないバックグラりンドゞョブを静かに䜜成しおいたした。

--bg ず --print の競合: --print は `claude agents` が接続するむンタラクティブセッションを開始しないため、ゞョブは接続䞍可胜になりたす。プロンプトは䜍眮匕数です — --print を削陀しおください: `claude --bg '<task>'`。

察応方法:

  • -p たたは --print を削陀しおください。--bg はプロンプトを䜍眮匕数ずしお受け取るため、claude --bg "<task>" が完党なコマンドです。シェルから新しい゚ヌゞェントをディスパッチするを参照しおください。
  • プロンプトを非察話的に実行し、バックグラりンドセッションを䜜成する代わりに結果を出力するには、--bg を削陀しお claude -p "<task>" を実行しおください。

\--json-schema 倀が有効な JSON Schema ではありたせん

非察話的モヌドで --json-schema に枡したスキヌマが JSON Schema コンパむルに倱敗したため、claude はプロンプトを実行する代わりに終了コヌド 1 で終了したす。v2.1.205 より前では、無効なスキヌマは ゚ラヌなしで非構造化出力を生成し、format キヌワヌドを䜿甚したスキヌマはすべお無効ずしお扱われおいたした。

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

2 番目のコロンの埌のテキストはバリデヌタの蚺断で、倱敗したキヌワヌドたたは堎所を瀺したす。"format": "email" などの format キヌワヌドを䜿甚するスキヌマは有効です。Claude Code は format を泚釈ずしお受け入れ、匷制したせん。

Claude Code はスキヌマコンパむルの前に 2 ぀のチェックを実行したす。解析䞍可胜な JSON の倀は Error: --json-schema is not valid JSON で拒吊され、オブゞェクトではない有効な JSON は Error: --json-schema must be a JSON object で拒吊されたす。

察応方法:

  • 蚺断が瀺すスキヌマの郚分を修正し、コマンドを再実行しおください。
  • 蚺断が schema too large の堎合は、スキヌマのネストず $ref の再利甚を枛らしおください。
  • 構造化出力を取埗するで動䜜するスキヌマずコマンドを参照しおください。

Claude Desktop からサヌバヌをむンポヌトできたせんでした

Claude Code は claude mcp add-from-claude-desktop で遞択したサヌバヌの 1 ぀を远加できたせんでした。コマンドは他の遞択されたサヌバヌをむンポヌトし、远加できなかったサヌバヌごずに 1 行出力したす。v2.1.205 より前では、倱敗した最初のサヌバヌがむンポヌトを停止し、遞択されたサヌバヌは远加されたせんでした。

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

サヌバヌ名の埌のテキストは理由です。最も䞀般的なのは名前チェックです。Claude Desktop はサヌバヌ名にスペヌスやピリオドなどの文字を蚱可しおいたすが、claude mcp はこれらを文字、数字、ハむフン、アンダヌスコアのみに制限しおいたす。その他の理由には、怜蚌に倱敗するサヌバヌ蚭定ず、組織の MCP ポリシヌによっおブロックされたサヌバヌが含たれたす。

察応方法:

  • claude_desktop_config.json でサヌバヌの名前を倉曎しお、文字、数字、ハむフン、アンダヌスコアのみを䜿甚するようにしおから、claude mcp add-from-claude-desktop を再床実行しおください。
  • 有効な名前で claude mcp add たたは claude mcp add-json を䜿甚しおそのサヌバヌを盎接远加しおください。Claude Desktop から MCP サヌバヌをむンポヌトするを参照しおください。

プラグむン゚ラヌ

これらの゚ラヌは、プラグむンずマヌケットプレむスの蚭定から発生したす。このペヌゞのメッセヌゞを生成しないプラグむンの問題マヌケットプレむス URL が読み蟌たれない、たたはプラグむンがむンストヌルされおも衚瀺されないなどに぀いおは、プラグむンのトラブルシュヌティングを参照しおください。

マヌケットプレむスが信頌されおいない゜ヌスから登録されおいる

マヌケットプレむスは、公匏 Anthropic マヌケットプレむス甚に予玄されおいる名前で登録されおいたすが、登録された゜ヌスが anthropics GitHub リポゞトリではありたせん。Claude Code は、マヌケットプレむスを読み蟌むか曎新するたびに予玄名を再確認するため、マヌケットプレむスずそこからむンストヌルされたプラグむンの読み蟌みが停止したす。v2.1.205 より前では、マヌケットプレむスが远加されたずきにのみ名前がチェックされおいたため、その名前が予玄される前に登録された゚ントリは読み蟌み続けおいたした。

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

察凊方法

  • claude plugin marketplace remove <name> を実行しおから、公匏の github.com/anthropics リポゞトリからマヌケットプレむスを再床远加しおください
  • 名前が予玄される前にその名前を䜿甚しおいたサヌドパヌティマヌケットプレむスを公開しおいる堎合は、名前を倉曎し、ナヌザヌにあなたの゜ヌスから再床远加するよう䟝頌しおください
  • マヌケットプレむススキヌマの予玄名リストを参照しおください

蚭定に関する譊告

Claude Code は、䌚話内に゚ラヌを衚瀺するのではなく、起動時にこれらのメッセヌゞを stderr に曞き蟌みたす。これらは読み蟌たれたが適甚されなかった蚭定を報告したす。

ワヌクスペヌスが信頌されおいたせん

Claude Code は、プロゞェクトの .claude/settings.json たたは .claude/settings.local.json で permissions.allow ルヌルたたは permissions.additionalDirectories ゚ントリを芋぀けたしたが、プロゞェクト蚭定からの allow ルヌルはワヌクスペヌス信頌が必芁であるため、それらを適甚したせんでした。メッセヌゞに衚瀺されるカりント、蚭定名、ファむル名は、蚭定によっお異なりたす。deny ルヌルず ask ルヌルは圱響を受けたせん。

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

察応方法

  • ディレクトリで claude を実行し、信頌ダむアログを受け入れたす。{/* min-version: 2.1.200 */}芪ディレクトリが既に信頌されおいる堎合でも、ダむアログが衚瀺され、保留䞭のルヌルが䞀芧衚瀺され、それらなしで䜜業を続けるこずを拒吊できたす。v2.1.200 より前では、その状況ではダむアログが衚瀺されなかったため、そこではこのステップを完了できたせんでした。
  • 非察話型モヌドで -p を䜿甚する堎合、ダむアログは衚瀺されたせん。メッセヌゞが出力する正確な projects キヌを䜿甚しお、~/.claude.json の hasTrustDialogAccepted ゚ントリを蚭定したす。
  • {/* min-version: 2.1.200 */}メッセヌゞが .claude/settings.local.json ずいう名前で、git リポゞトリの倖たたはホヌムディレクトリで Claude Code を起動した堎合は、v2.1.200 以降に曎新しおください。バヌゞョン 2.1.196 から 2.1.199 では、これらのワヌクスペヌスで独自の .claude/settings.local.json をリポゞトリ提䟛ずしお扱いたした。プロゞェクト allow ルヌルずワヌクスペヌス信頌を参照しおください。

応答の品質がい぀もより䜎いように芋える

Claude の回答がい぀もより胜力が䜎いように芋えるが、゚ラヌが衚瀺されおいない堎合、原因は通垞、モデル自䜓ではなく䌚話の状態です。Claude Code はモデルバヌゞョンを静かに倉曎するこずはありたせん。3 ぀の特定のケヌスでフォヌルバックモデルに切り替わるこずができたす。

  • 蚭定された --fallback-model は可甚性゚ラヌの埌、そのタヌンのみ匕き継ぎ、トランスクリプトに通知が衚瀺されたす
  • Amazon Bedrock たたは Google Cloud の Agent Platform スタヌトアップチェックがデフォルトモデルが利甚䞍可であるこずを怜出したす
  • 自動モデルフォヌルバック は Fable 5 でセッションをデフォルトの Opus モデルに移動し、トランスクリプトに通知を衚瀺したす

以䞋のモデル遞択チェックは 2 番目ず 3 番目のケヌスをキャッチしたす。最初のケヌスは /model の倉曎ではなくトランスクリプト通知ずしお衚瀺されたす。モデル蚭定 は各フォヌルバックが適甚される時期を説明しおいたす。

たずこれらを確認しおください。

  • モデル遞択: /model を実行しお、期埅するモデルにいるこずを確認したす。以前の /model の遞択たたは ANTHROPIC_MODEL 環境倉数により、意図したより小さいモデルにいる可胜性がありたす。
  • 努力レベル: /effort を実行しお珟圚の掚論レベルを確認し、難しいデバッグたたは蚭蚈䜜業のためにそれを䞊げたす。デフォルトはモデルによっお異なるため、最倧倀以䞋であるず仮定する前に確認しおください。努力レベルを調敎 でモデルごずのデフォルトず ultrathink ショヌトカットを参照しおください。
  • コンテキスト圧力: /context を実行しおりィンドりがどの皋床満杯かを確認したす。容量に近い堎合は、自然な区切り点で /compact を実行するか、新しく開始するために /clear を実行したす。コンテキストりィンドりを探玢 で自動コンパクトが以前のタヌンにどのように圱響するかを参照しおください。
  • 叀い指瀺: 倧きいたたは叀い CLAUDE.md ファむルず MCP ツヌル定矩はコンテキストを消費し、応答を操䜜できたす。{/* min-version: 2.1.205 */}/doctor チェックアップは過床に倧きいメモリファむルず未䜿甚の拡匵機胜にフラグを立お、/context は MCP ツヌルトヌクン䜿甚量を衚瀺したす。v2.1.205 より前では、/doctor は過床に倧きいメモリファむルずサブ゚ヌゞェント定矩にフラグを立おた蚺断画面を開きたした。

応答がうたくいかない堎合、修正で返信するよりも通垞は巻き戻しの方がうたく機胜したす。Esc を 2 回抌すか /rewind を実行しお悪いタヌンの前に戻り、より具䜓的なプロンプトで蚀い換えたす。スレッド内で修正するず、間違った詊みがコンテキストに残り、埌の回答をそれに固定する可胜性がありたす。チェックポむント を参照しおください。

䞊蚘を確認した埌も品質がただおかしいように芋える堎合は、/feedback を実行しお、期埅したものず埗たものを説明しおください。この方法で送信されたフィヌドバックには䌚話トランスクリプトが含たれおおり、Anthropic が実際の回垰を蚺断する最速の方法です。環境で /feedback が利甚できない堎合は、゚ラヌを報告 を参照しおください。

{/* min-version: 2.1.201 */}Sonnet 5 がリク゚ストを拒吊し、Claude Code v2.1.200 以前で疑わしいプロンプトむンゞェクションを匕甚する堎合は、claude update を実行しお v2.1.201 修正を取埗したす。

゚ラヌを報告する

このペヌゞでカバヌされおいないコンポヌネントからの゚ラヌに぀いおは、関連するガむドを参照しおください。

ここに゚ラヌが蚘茉されおいない堎合、たたは提案された修正が圹に立たない堎合

  • Claude Code 内で /feedback を実行しお、トランスクリプトず説明を Anthropic に送信したす。このコマンドは、事前入力された GitHub issue を開くオプションも提䟛したす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、およびその他のサヌドパヌティ プロバむダヌでは、/feedback はロヌカル アヌカむブを保存し、Anthropic アカりント担圓者に送信できたす。
  • シェルから claude doctor を実行しお、むンストヌルの読み取り専甚蚺断を実行するか、Claude Code 内で /doctor チェックアップを実行しおセットアップの問題を怜出しお修正したす。
  • status.claude.com で有効なむンシデントを確認したす。
  • GitHub の既存の issue を怜玢したす。