21ターミナルに表示されるメッセージを以下のセクションと照合してください。21ターミナルに表示されるメッセージを以下のセクションと照合してください。
22 22
23| メッセージ | セクション |23| メッセージ | セクション |
24| :-------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------- |24| :------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------- |
25| `API Error: 500 Internal server error` | [サーバーエラー](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [サーバーエラー](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [サーバーエラー](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [サーバーエラー](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [サーバーエラー](#request-timed-out)、またはメッセージがインターネット接続に言及している場合は[ネットワーク](#unable-to-connect-to-api) |27| `Request timed out` | [サーバーエラー](#request-timed-out)、またはメッセージがインターネット接続に言及している場合は[ネットワーク](#unable-to-connect-to-api) |
39| `Not logged in · Please run /login` | [認証](#not-logged-in) |39| `Not logged in · Please run /login` | [認証](#not-logged-in) |
40| `Could not resolve authentication method` | [認証](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [認証](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [認証](#invalid-api-key) |41| `Invalid API key` | [認証](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [認証](#your-apikeyhelper-script-is-failing) |
42| `This organization has been disabled` | [認証](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [認証](#this-organization-has-been-disabled) |
43| `Your organization has disabled API key authentication` | [認証](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [認証](#your-organization-has-disabled-api-key-authentication) |
44| `Your organization has disabled Claude subscription access` | [認証](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [認証](#your-organization-has-disabled-claude-subscription-access) |
45| `Routines are disabled by your organization's policy` | [認証](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [認証](#routines-are-disabled-by-your-organizations-policy) |
46| `Remote Control is only available when using Claude via api.anthropic.com` | [認証](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [認証](#remote-control-requires-the-anthropic-api) |
47| `OAuth token revoked` / `OAuth token has expired` | [認証](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [認証](#oauth-token-revoked-or-expired) |
49| `Login expired · Please run /login` | [認証](#login-expired) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [認証](#login-expired) |
48| `does not meet scope requirement user:profile` | [認証](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [認証](#oauth-scope-requirement) |
49| `AWS credentials expired or invalid` | [認証](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [認証](#aws-credentials-expired-or-invalid) |
50| `AWS authentication failed` | [認証](#aws-authentication-failed) |53| `AWS authentication failed` | [認証](#aws-authentication-failed) |
54| `AWS default-chain credential resolve timed out` | [認証](#aws-default-chain-credential-resolve-timed-out) |
51| `Unable to connect to API` | [ネットワーク](#unable-to-connect-to-api) |55| `Unable to connect to API` | [ネットワーク](#unable-to-connect-to-api) |
52| `Waiting for API response · will retry in` | [自動リトライ](#automatic-retries)、または継続する場合は[ネットワーク](#unable-to-connect-to-api) |56| `Waiting for API response · will retry in` | [自動リトライ](#automatic-retries)、または継続する場合は[ネットワーク](#unable-to-connect-to-api) |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [ネットワーク](#bedrock-streaming-response-has-an-unexpected-content-type) |
53| `SSL certificate verification failed` | [ネットワーク](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [ネットワーク](#ssl-certificate-errors) |
54| `SSL certificate error (...)` during login or startup | [ネットワーク](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [ネットワーク](#ssl-certificate-errors) |
55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [ネットワーク](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [ネットワーク](#host-not-allowed-in-a-cloud-session) |
76| `--bg and --print conflict` | [コマンドラインエラー](#command-line-errors) |81| `--bg and --print conflict` | [コマンドラインエラー](#command-line-errors) |
77| `Error: --json-schema is not a valid JSON Schema` | [コマンドラインエラー](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [コマンドラインエラー](#command-line-errors) |
78| `Could not import <server>: <reason>` | [コマンドラインエラー](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [コマンドラインエラー](#could-not-import-a-server-from-claude-desktop) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [コマンドラインエラー](#mcp-permission-prompt-tool-not-found) |
79| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [プラグインエラー](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [プラグインエラー](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [プラグインエラー](#plugin-command-references-user-config) |
89| `would be spawned with zero tools — refusing` | [ツールエラー](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [ツールエラー](#file-is-covered-by-a-read-deny-rule) |
91| `Can't open MCP settings in a background session` | [バックグラウンドセッションエラー](#commands-refused-in-a-background-session) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [バックグラウンドセッションエラー](#claude_code_process_wrapper-launcher-errors) |
80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定警告](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定警告](#workspace-has-not-been-trusted) |
81| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |94| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |
82 95
86 99
87Claude 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 キーおよびエンタープライズサインインの場合のみリトライされました。100Claude 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 キーおよびエンタープライズサインインの場合のみリトライされました。
88 101
892 つの障害クラスはリトライされません。リトライが成功できないためです。102リトライが成功できないため、リトライされない障害クラスがあります。
90 103
91* {/* min-version: 2.1.199 */}v2.1.199 以降では、TLS 証明書検証の失敗（TLS 検査プロキシ、不足している `NODE_EXTRA_CA_CERTS` バンドル、または期限切れの証明書など）は最初の試行で失敗するため、完全なリトライ予算の後ではなく、修正がすぐに表示されます。[SSL 証明書エラー](#ssl-certificate-errors)を参照してください。ハンドシェイクタイムアウトなどの一時的な TLS 条件はまだリトライされます。104* {/* min-version: 2.1.199 */}v2.1.199 以降では、TLS 証明書検証の失敗（TLS 検査プロキシ、不足している `NODE_EXTRA_CA_CERTS` バンドル、または期限切れの証明書など）は最初の試行で失敗するため、完全なリトライ予算の後ではなく、修正がすぐに表示されます。[SSL 証明書エラー](#ssl-certificate-errors)を参照してください。ハンドシェイクタイムアウトなどの一時的な TLS 条件はまだリトライされます。
92* {/* min-version: 2.1.199 */}v2.1.199 以降では、Claude が既に表示可能な出力をストリームした後に到着するサーバーエラーは、部分的なレスポンスを保持し、リトライする代わりに[不完全なレスポンス通知](#the-response-above-may-be-incomplete)を追加します。同じツール呼び出しを 2 回実行する可能性があるためです。それより前のバージョンでは、部分的な出力を破棄し、ターン全体をエラーとして報告しました。105* {/* min-version: 2.1.199 */}v2.1.199 以降では、Claude が既に表示可能な出力をストリームした後に到着するサーバーエラーは、部分的なレスポンスを保持し、リトライする代わりに[不完全なレスポンス通知](#the-response-above-may-be-incomplete)を追加します。同じツール呼び出しを 2 回実行する可能性があるためです。それより前のバージョンでは、部分的な出力を破棄し、ターン全体をエラーとして報告しました。
106* {/* min-version: 2.1.208 */}[Amazon Bedrock ストリーミングレスポンスに予期しないコンテンツタイプがある](#bedrock-streaming-response-has-an-unexpected-content-type)場合は最初の試行で失敗します。ゲートウェイまたはプロキシがレスポンスを書き換えると、リトライも同じ方法で書き換えるためです。Claude Code v2.1.208 以降が必要です。
93 107
94リトライ中、スピナーはエラーラベルの後に `Retrying in Ns · attempt x/y` カウントダウンを表示します。ラベルは、すぐに対応できる障害の最初の試行からの具体的な理由を示します。ネットワークがダウンしている、TLS ハンドシェイクが失敗した、またはレート制限に達しました。他のエラーの場合は、最初は `API error` と表示されます。{/* min-version: 2.1.198 */}v2.1.198 以降では、3 番目の試行からの具体的な理由に切り替わるか、`CLAUDE_CODE_MAX_RETRIES` が 3 未満の試行を許可する場合は最終試行時に切り替わります。それより前のバージョンでは、最終試行時のみ切り替わります。108リトライ中、スピナーはエラーラベルの後に `Retrying in Ns · attempt x/y` カウントダウンを表示します。ラベルは、すぐに対応できる障害の最初の試行からの具体的な理由を示します。ネットワークがダウンしている、TLS ハンドシェイクが失敗した、またはレート制限に達しました。他のエラーの場合は、最初は `API error` と表示されます。{/* min-version: 2.1.198 */}v2.1.198 以降では、3 番目の試行からの具体的な理由に切り替わるか、`CLAUDE_CODE_MAX_RETRIES` が 3 未満の試行を許可する場合は最終試行時に切り替わります。それより前のバージョンでは、最終試行時のみ切り替わります。
95 109
285 299
286Claude Code は、メッセージに表示されたリセット時刻までさらなるリクエストをブロックします。セッションおよび週間制限はすべてのモデル間で共有されるため、モデルを切り替えてもアクセスは復元されません。Opus 制限は Opus リクエストにのみ適用されるため、`/model` で別のモデルに切り替えると作業を続行できます。300Claude Code は、メッセージに表示されたリセット時刻までさらなるリクエストをブロックします。セッションおよび週間制限はすべてのモデル間で共有されるため、モデルを切り替えてもアクセスは復元されません。Opus 制限は Opus リクエストにのみ適用されるため、`/model` で別のモデルに切り替えると作業を続行できます。
287 301
302使用量はセッションおよび週間許容量に対して同時にカウントされます。大規模なワークフロー ファンアウトなどの大量アクティビティの単一バースト は、セッションウィンドウがリセットされる前に週間許容量を枯渇させることができます。
303
288**対応方法：**304**対応方法：**
289 305
290* エラーに表示されたリセット時刻まで待機してください306* エラーに表示されたリセット時刻まで待機してください
430* キーが [`apiKeyHelper`](/ja/settings#available-settings) スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーが出力されることを確認します446* キーが [`apiKeyHelper`](/ja/settings#available-settings) スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーが出力されることを確認します
431* `/status` を実行して、Claude Code が実際に使用している認証情報ソースを確認します447* `/status` を実行して、Claude Code が実際に使用している認証情報ソースを確認します
432 448
449<h3 id="your-apikeyhelper-script-is-failing">
450 apiKeyHelper スクリプトが失敗しています
451</h3>
452
453[`apiKeyHelper`](/ja/settings#available-settings) 設定で設定されたコマンドがエラーで終了したか、タイムアウトしたか、stdout に何も出力しませんでした。スクリプトからキーがないと、リクエストはプレースホルダー認証情報で API に到達し、API は `401` で拒否します。
454
455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```
458
459Claude Code はスクリプトを再実行し、このメッセージを表示する前に最大 2 回までリクエストを再試行するため、障害は 3 回の試行内に表示されます。{/* min-version: 2.1.208 */}v2.1.208 より前では、Claude Code は完全な [再試行予算](#automatic-retries) を費やしてプレースホルダー認証情報でリクエストを再送信し、スクリプト障害の代わりに汎用の `401` 認証エラーを報告していました。
460
461`/login` を実行しても役に立ちません。ここでは、ヘルパーの出力が [優先順位](/ja/authentication#authentication-precedence) を取り、設定が存在する限り保存されたログインより優先されます。
462
463**対応方法：**
464
465* `apiKeyHelper` で設定されたコマンドをシェルで直接実行して、障害を再現します
466* コマンドが期限切れのセッションを報告する場合は、SSO または秘密保管庫に再度サインインするなど、認証情報プロバイダーで再認証します
467* コマンドを修正して、キーを stdout に出力し、コード 0 で終了するようにします。[apiKeyHelper で認証情報をローテーション](/ja/llm-gateway-connect#rotate-credentials-with-apikeyhelper) を参照して、動作するセットアップを確認してください
468* `/status` を実行して、`apiKeyHelper` がアクティブな認証情報ソースであることを確認します。コマンドが失敗するたびに、その終了コードとエラー出力がターミナルの `Cloud authentication` パネルに表示されます。
469
433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
434 この組織は無効になっています471 この組織は無効になっています
435</h3>472</h3>
532 569
533保存されたログインは有効ではなくなりました。失効したトークンは、どこからでもサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動更新がセッション中に失敗したことを意味します。570保存されたログインは有効ではなくなりました。失効したトークンは、どこからでもサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動更新がセッション中に失敗したことを意味します。
534 571
572両方のメッセージは、Claude Code が送信したリクエストに対して API が返した拒否を報告します。保存されたログインが失敗した更新後に既にクリアされている場合は、代わりに [ログイン期限切れ](#login-expired) が表示されます。
573
535```text theme={null}574```text theme={null}
536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login
537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login
545* 起動全体でログインを繰り返し求められる場合は、[トラブルシューティング](/ja/troubleshoot-install#not-logged-in-or-token-expired) のシステムクロックと macOS キーチェーンチェックを参照してください584* 起動全体でログインを繰り返し求められる場合は、[トラブルシューティング](/ja/troubleshoot-install#not-logged-in-or-token-expired) のシステムクロックと macOS キーチェーンチェックを参照してください
546* `403 Forbidden` や OAuth ブラウザーの問題を含む他の障害については、[ログインと認証](/ja/troubleshoot-install#login-and-authentication) を参照してください585* `403 Forbidden` や OAuth ブラウザーの問題を含む他の障害については、[ログインと認証](/ja/troubleshoot-install#login-and-authentication) を参照してください
547 586
587<h3 id="login-expired">
588 ログイン期限切れ
589</h3>
590
591Claude Code は保存された claude.ai または Claude Console ログインを更新しようとしましたが、OAuth サービスが保存されたリフレッシュトークンを拒否したため、Claude Code は保存された認証情報をクリアしました。その後、新しい認証情報を作成できるのは `/login` だけであるため、各リクエストはローカルで停止し、API に到達しません。{/* min-version: 2.1.206 */}v2.1.206 より前では、Claude Code はリクエストを送信し、ログインを求めるプロンプトの代わりに、残っている認証情報で [選択されたモデルに問題があります](#theres-an-issue-with-the-selected-model) または 401 で失敗していました。
592
593```text theme={null}
594Login expired · Please run /login
595```
596
597[非対話モード](/ja/headless)（`-p`）および [Agent SDK](/ja/agent-sdk/overview) では、メッセージは以下のように読み取られ、構造化エラーコードは `authentication_failed` です：
598
599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed
601```
602
603これは [OAuth トークンが失効または期限切れです](#oauth-token-revoked-or-expired) と同じ状態ではありません。これらのメッセージは API が返した 401 を報告します。Claude Code 自体は既に更新に失敗したログインに対して `Login expired` を生成するため、リクエストを送信しません。
604
605API キー、[`CLAUDE_CODE_OAUTH_TOKEN`](/ja/env-vars)、または第三者プロバイダーで認証されたセッションは、保存されたログインを使用せず、このメッセージを表示しません。
606
607**対応方法：**
608
609* `/login` を実行して再度サインインします。サインインせずに再試行すると、すべてのリクエストで同じメッセージが表示されます。
610* 非対話モードでは、同じ環境で `claude` を実行し、`/login` を完了してから、コマンドを再実行します。対話的にサインインできない自動化の場合は、`ANTHROPIC_API_KEY` で認証するか、[`claude setup-token` で長期トークンを生成](/ja/authentication#generate-a-long-lived-token) します。
611* サインインが失敗し続ける場合は、[ログインと認証](/ja/troubleshoot-install#login-and-authentication) を参照してください
612
548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
549 OAuth スコープ要件614 OAuth スコープ要件
550</h3>615</h3>
603* 認証情報が最新の場合は、[IAM 設定](/ja/amazon-bedrock#iam-configuration) の IAM 権限が使用している ID に接続されていることを確認し、選択したモデルがアカウントとリージョンで有効になっていることを確認します668* 認証情報が最新の場合は、[IAM 設定](/ja/amazon-bedrock#iam-configuration) の IAM 権限が使用している ID に接続されていることを確認し、選択したモデルがアカウントとリージョンで有効になっていることを確認します
604* `aws sts get-caller-identity` を実行して、リクエストが使用する ID を確認します。古い `AWS_PROFILE` またはデフォルトプロファイルは、権限の不一致の一般的な原因です669* `aws sts get-caller-identity` を実行して、リクエストが使用する ID を確認します。古い `AWS_PROFILE` またはデフォルトプロファイルは、権限の不一致の一般的な原因です
605 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 AWS デフォルトチェーン認証情報解決がタイムアウトしました
673</h3>
674
675AWS デフォルト認証情報プロバイダーチェーンが 60 秒以内に認証情報を生成しなかったため、Claude Code は解決を停止し、リクエストを失敗させました。障害はローカル認証情報解決です。リクエストは [Amazon Bedrock](/ja/amazon-bedrock)、[AWS 上の Claude Platform](/ja/claude-platform-on-aws)、または [Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint) に到達しませんでした。Claude Code はこのエラーが表示される前に [認証情報キャッシュ](/ja/amazon-bedrock#credential-caching-and-resolution-timeout) をクリアして再試行するため、このメッセージが表示される時点ではチェーンが繰り返された試行でスタックしています。
676
677```text theme={null}
678API Error: AWS default-chain credential resolve timed out
679```
680
681一般的な原因は、AWS プロファイルの `credential_process` コマンドが受け取ることができない入力を待機していることと、インスタンスメタデータサービス（IMDS）がチェーンのプローブに応答しないコンテナまたは VM です。{/* min-version: 2.1.207 */}v2.1.207 より前では、スタックしたチェーンはリクエストを無期限に待機させ、このメッセージで失敗する代わりに待機させていました。
682
683**対応方法：**
684
685* 同じシェルで同じ `AWS_PROFILE` を使用して `aws sts get-caller-identity` を実行します。これもハングする場合は、プロファイルを修正します。対話的にプロンプトを表示する `credential_process` コマンドが一般的な原因です。
686* Claude Code を起動する前にサインインステップを完了します。例えば `aws sso login --profile myprofile` を実行して、チェーンがブラウザーフローを待機する代わりにローカル SSO キャッシュから解決されるようにします
687* チェーンが MFA を使用した SSO などの `aws-vault` のようなラッパーを実行する対話的サインインを実行し、正当に 60 秒以上必要な場合は、[`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/ja/env-vars) でミリ秒単位で制限を上げます
688
606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
607 ネットワークと接続エラー690 ネットワークと接続エラー
608</h2>691</h2>
609 692
610これらのエラーは、Claude Code からのネットワークリクエストが宛先に到達できなかったことを意味します。通常、ローカルネットワーク、プロキシ、ファイアウォール、またはクラウド環境のネットワークポリシーに起因します。693これらのエラーは、Claude Code からのネットワークリクエストが宛先に到達できなかったこと、または Claude Code と API の間で応答が何らかの方法で変更されたことを意味します。通常、ローカルネットワーク、プロキシ、ファイアウォール、またはクラウド環境のネットワークポリシーに起因します。
611 694
612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">
613 API に接続できない696 API に接続できない
640* macOS では、切断またはアンインストールされた VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。`ifconfig` で古い `utun` インターフェースを確認し、システム設定から VPN のネットワーク拡張機能を削除してください。723* macOS では、切断またはアンインストールされた VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。`ifconfig` で古い `utun` インターフェースを確認し、システム設定から VPN のネットワーク拡張機能を削除してください。
641* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。これを除外するために、それらを終了して再試行してください。724* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。これを除外するために、それらを終了して再試行してください。
642 725
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
727 Bedrock ストリーミング応答に予期しないコンテンツタイプがある
728</h3>
729
730Claude Code と [Amazon Bedrock](/ja/amazon-bedrock) の間のゲートウェイまたはプロキシが、ストリーミング応答本体またはその `Content-Type` ヘッダーを変換しています。Amazon Bedrock は応答を `application/vnd.amazon.eventstream` としてストリーミングし、Claude Code は読み取ることができない本体をデコードする代わりに、異なるコンテンツタイプを報告する成功したストリーミング応答を拒否します。リクエストは再試行されません。
731
732```text theme={null}
733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
734```
735
736{/* min-version: 2.1.208 */}v2.1.208 より前では、同じ設定ミスが、応答全体がバッファリングされた後に `API Error: Truncated event message received` として表示されました。
737
738**対応方法：**
739
740* ゲートウェイを設定して、`InvokeModelWithResponseStream` 応答本体とその `Content-Type` ヘッダーを変更されずに通すようにしてください。ストリームをサーバー送信イベントとして再発行する仲介者が一般的な原因です。
741* ゲートウェイがヘッダーのみを書き換え、バイナリ本体をそのまま通す場合は、[`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/ja/env-vars)を設定して、ゲートウェイが修正されるまでチェックをスキップしてください。[ゲートウェイまたはプロキシの背後でのストリーミングエラー](/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)を参照してください。
742
643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
644 SSL 証明書エラー744 SSL 証明書エラー
645</h3>745</h3>
859* **Agent SDK**：モデルがプログラムで設定されているため、エラーテキストはヒントを省略します。TypeScript で [`Options` の `model`](/ja/agent-sdk/typescript#options) を設定するか、Python で [`ClaudeAgentOptions(model=...)`](/ja/agent-sdk/python#claudeagentoptions) を設定し、構造化された `model_not_found` エラーを処理して、独自の再試行またはモデルピッカーを表示します959* **Agent SDK**：モデルがプログラムで設定されているため、エラーテキストはヒントを省略します。TypeScript で [`Options` の `model`](/ja/agent-sdk/typescript#options) を設定するか、Python で [`ClaudeAgentOptions(model=...)`](/ja/agent-sdk/python#claudeagentoptions) を設定し、構造化された `model_not_found` エラーを処理して、独自の再試行またはモデルピッカーを表示します
860* 完全なバージョン付き ID ではなく、`sonnet` や `opus` などのエイリアスを使用します。エイリアスは保守されたデフォルトに解決されるため、古くなりません。[モデル設定](/ja/model-config) を参照してください960* 完全なバージョン付き ID ではなく、`sonnet` や `opus` などのエイリアスを使用します。エイリアスは保守されたデフォルトに解決されるため、古くなりません。[モデル設定](/ja/model-config) を参照してください
861* CLI で間違ったモデルが戻り続ける場合は、どこかに古い ID が設定されています。[優先順位順](/ja/model-config#setting-your-model) で確認します：`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、次に `.claude/settings.local.json` の `model` フィールド、プロジェクトの `.claude/settings.json`、および `~/.claude/settings.json`。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします961* CLI で間違ったモデルが戻り続ける場合は、どこかに古い ID が設定されています。[優先順位順](/ja/model-config#setting-your-model) で確認します：`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、次に `.claude/settings.local.json` の `model` フィールド、プロジェクトの `.claude/settings.json`、および `~/.claude/settings.json`。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします
962* {/* min-version: 2.1.206 */}Claude Code は期限切れの claude.ai ログインを [ログイン期限切れ](#login-expired) として報告します。これはこのエラーではありません。v2.1.206 より前は、更新できなくなった期限切れのログインがすべてのモデルで失敗しました。古いバージョンでこれが表示される場合は、`/login` を実行してください
862* Google Cloud の Agent Platform デプロイメントについては、[Google Cloud の Agent Platform トラブルシューティング](/ja/google-vertex-ai#troubleshooting) を参照してください963* Google Cloud の Agent Platform デプロイメントについては、[Google Cloud の Agent Platform トラブルシューティング](/ja/google-vertex-ai#troubleshooting) を参照してください
863 964
864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
880* 引数なしで `/model` を実行してピッカーを開き、アカウントで利用可能なモデルから選択してから、そこに表示されているエイリアスまたは ID を渡します981* 引数なしで `/model` を実行してピッカーを開き、アカウントで利用可能なモデルから選択してから、そこに表示されているエイリアスまたは ID を渡します
881* 新しい Claude Code バージョンがサポートするエイリアスを使用した場合は、`claude update` を実行します。`claude-` で始まる完全な ID はこのチェックに合格します。モデルが Claude Code バージョンより新しい場合でも、アップグレードは不要です982* 新しい Claude Code バージョンがサポートするエイリアスを使用した場合は、`claude update` を実行します。`claude-` で始まる完全な ID はこのチェックに合格します。モデルが Claude Code バージョンより新しい場合でも、アップグレードは不要です
882* v2.1.200 より前に保存されたモデルはこのチェックで修復されません。古い値が戻り続ける場合は、[選択されたモデルに問題があります](#theres-an-issue-with-the-selected-model) に記載されている場所から削除します983* v2.1.200 より前に保存されたモデルはこのチェックで修復されません。古い値が戻り続ける場合は、[選択されたモデルに問題があります](#theres-an-issue-with-the-selected-model) に記載されている場所から削除します
883* チェックは Anthropic API でのみ実行されます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および [LLM ゲートウェイ](/ja/llm-gateway) または カスタム `ANTHROPIC_BASE_URL` の背後では、プロバイダーまたはゲートウェイがモデル名を定義するため、Claude Code は任意の文字列を受け入れて渡します984* チェックは Anthropic API でのみ実行されます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および [LLM ゲートウェイ](/ja/llm-gateway) またはカスタム `ANTHROPIC_BASE_URL` の背後では、プロバイダーまたはゲートウェイがモデル名を定義するため、Claude Code は任意の文字列を受け入れて渡します
884 985
885<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
886 Claude Opus は Claude Pro プランでは利用できません987 Claude Opus は Claude Pro プランでは利用できません
1070 \--bg と --print の競合1171 \--bg と --print の競合
1071</h3>1172</h3>
1072 1173
1073このメッセージは Claude Code v2.1.198 以降が必要です。同じ `claude` 呼び出しで `--bg` を `-p` または `--print` と組み合わせました。`--bg` は[バックグラウンドセッション](/ja/agent-view#from-your-shell)を開始し、後で `claude agents` で接続できます。一方、`--print` は[非対話的に](/ja/headless)実行され、`claude agents` が接続するインタラクティブセッションを開始しません。v2.1.198 より前では、この組み合わせは接続できないバックグラウンドジョブを静かに作成していました。1174このメッセージは Claude Code v2.1.198 以降が必要です。同じ `claude` 呼び出しで `--bg` と `-p` または `--print` を組み合わせました。`--bg` は [バックグラウンドセッション](/ja/agent-view#from-your-shell) を開始し、後で `claude agents` で接続できます。一方、`--print` は [非対話的に](/ja/headless) 実行され、`claude agents` が接続するインタラクティブセッションを開始しません。v2.1.198 より前では、この組み合わせは接続できないバックグラウンドジョブを静かに作成していました。
1074 1175
1075```text theme={null}1176```text theme={null}
1177--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
1076```1178```
1077 1179
1078**対応方法:**1180**対応方法：**
1079 1181
1080* `-p` または `--print` を削除してください。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` が完全なコマンドです。[シェルから新しいエージェントをディスパッチする](/ja/agent-view#from-your-shell)を参照してください。1182* `-p` または `--print` を削除してください。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` が完全なコマンドです。[シェルから新しいエージェントをディスパッチする](/ja/agent-view#from-your-shell) を参照してください。
1081* プロンプトを非対話的に実行し、バックグラウンドセッションを作成する代わりに結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行してください。1183* プロンプトを非対話的に実行し、バックグラウンドセッションを作成する代わりに結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行してください。
1082 1184
1083<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
1084 \--json-schema 値が有効な JSON Schema ではありません1186 \--json-schema 値が有効な JSON Schema ではありません
1085</h3>1187</h3>
1086 1188
1087[非対話的モード](/ja/headless#get-structured-output)で [`--json-schema`](/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema コンパイルに失敗したため、`claude` はプロンプトを実行する代わりに終了コード 1 で終了します。v2.1.205 より前では、無効なスキーマは エラーなしで非構造化出力を生成し、`format` キーワードを使用したスキーマはすべて無効として扱われていました。1189[非対話的モード](/ja/headless#get-structured-output) で [`--json-schema`](/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema コンパイルに失敗したため、`claude` はプロンプトを実行する代わりに終了コード 1 で終了します。v2.1.205 より前では、無効なスキーマは エラーなしで非構造化出力を生成し、`format` キーワードを使用したスキーマはすべて無効として扱われていました。
1088 1190
1089```text theme={null}1191```text theme={null}
1090Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1095 1196
1096Claude Code はスキーマコンパイルの前に 2 つのチェックを実行します。解析不可能な JSON の値は `Error: --json-schema is not valid JSON` で拒否され、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。1197Claude Code はスキーマコンパイルの前に 2 つのチェックを実行します。解析不可能な JSON の値は `Error: --json-schema is not valid JSON` で拒否され、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。
1097 1198
1098**対応方法:**1199**対応方法：**
1099 1200
1100* 診断が示すスキーマの部分を修正し、コマンドを再実行してください。1201* 診断が示すスキーマの部分を修正し、コマンドを再実行してください。
1101* 診断が `schema too large` の場合は、スキーマのネストと `$ref` の再利用を減らしてください。1202* 診断が `schema too large` の場合は、スキーマのネストと `$ref` の再利用を減らしてください。
1102* [構造化出力を取得する](/ja/headless#get-structured-output)で動作するスキーマとコマンドを参照してください。1203* [構造化出力を取得する](/ja/headless#get-structured-output) で動作するスキーマとコマンドを参照してください。
1103 1204
1104<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1105 Claude Desktop からサーバーをインポートできませんでした1206 Claude Desktop からサーバーをインポートできませんでした
1111Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
1112```1213```
1113 1214
1114サーバー名の後のテキストは理由です。最も一般的なのは名前チェックです。Claude Desktop はサーバー名にスペースやピリオドなどの文字を許可していますが、`claude mcp` はこれらを文字、数字、ハイフン、アンダースコアのみに制限しています。その他の理由には、検証に失敗するサーバー設定と、組織の [MCP ポリシー](/ja/managed-mcp)によってブロックされたサーバーが含まれます。1215サーバー名の後のテキストは理由です。最も一般的なのは名前チェックです。Claude Desktop はサーバー名にスペースやピリオドなどの文字を許可していますが、`claude mcp` はこれらを文字、数字、ハイフン、アンダースコアに制限しています。その他の理由には、検証に失敗するサーバー設定と、組織の [MCP ポリシー](/ja/managed-mcp) によってブロックされたサーバーが含まれます。
1216
1217**対応方法：**
1218
1219* `claude_desktop_config.json` でサーバーの名前を変更して、文字、数字、ハイフン、アンダースコアのみを使用し、`claude mcp add-from-claude-desktop` を再度実行してください。
1220* そのサーバーを `claude mcp add` または `claude mcp add-json` で有効な名前の下に直接追加してください。[Claude Desktop から MCP サーバーをインポートする](/ja/mcp#import-mcp-servers-from-claude-desktop) を参照してください。
1115 1221
1116**対応方法:**1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 MCP 権限プロンプトツールが見つかりません
1224</h3>
1117 1225
1118* `claude_desktop_config.json` でサーバーの名前を変更して、文字、数字、ハイフン、アンダースコアのみを使用するようにしてから、`claude mcp add-from-claude-desktop` を再度実行してください。1226[`--permission-prompt-tool`](/ja/cli-reference#cli-flags) に渡したツールは、実行が最初に権限決定を必要とした時点で接続された MCP ツールの中にありませんでした。これは、そのサーバーが接続されなかったか、接続されたサーバーがその名前のツールを公開していないためです。Claude Code はプロンプトを送信します。[非対話的](/ja/headless) な実行は、承認が必要なツール呼び出しで最初にこのエラーで終了し、終了コード 1 で終了するため、リクエストが行われたにもかかわらず答えを生成しません。最初のプロンプトの前に、Claude Code は [`MCP_TIMEOUT`](/ja/env-vars) で設定された 30 秒のサーバーごとの接続タイムアウトまでそのサーバーの接続を待ちます。{/* min-version: 2.1.206 */}v2.1.206 より前では、スタートアップはサーバーの接続完了を待たなかったため、遅く開始しても健全なサーバーはこのエラーを生成していました。
1119* 有効な名前で `claude mcp add` または `claude mcp add-json` を使用してそのサーバーを直接追加してください。[Claude Desktop から MCP サーバーをインポートする](/ja/mcp#import-mcp-servers-from-claude-desktop)を参照してください。1227
1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1230```
1231
1232`Available MCP tools:` の後のリストは、待機が終了した時点で接続されていた MCP ツールを示します。
1233
1234**対応方法：**
1235
1236* サーバーが起動して接続されたままであることを確認してください。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとしてリストされていることを確認してください。
1237* ツール名がサーバーが公開する `mcp__<server>__<tool>` 名と一致することを確認してください。
1238* サーバーの起動に 30 秒以上必要な場合は、[`MCP_TIMEOUT`](/ja/env-vars) を上げてください。
1120 1239
1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1122 プラグインエラー1241 プラグインエラー
1136 1255
1137**対処方法：**1256**対処方法：**
1138 1257
1139* `claude plugin marketplace remove <name>` を実行してから、公式の `github.com/anthropics` リポジトリからマーケットプレイスを再度追加してください1258* `claude plugin marketplace remove <name>` を実行してから、公式の `github.com/anthropics` リポジトリからマーケットプレイスを再度追加します
1140* 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開している場合は、名前を変更し、ユーザーにあなたのソースから再度追加するよう依頼してください1259* 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開する場合は、名前を変更し、ユーザーにソースから再度追加するよう依頼してください
1141* [マーケットプレイススキーマ](/ja/plugin-marketplaces#marketplace-schema)の予約名リストを参照してください1260* [マーケットプレイススキーマ](/ja/plugin-marketplaces#marketplace-schema)の予約名リストを参照してください
1142 1261
1262<h3 id="plugin-command-references-user-config">
1263 プラグインコマンドがシェルコマンド内で user\_config を参照している
1264</h3>
1265
1266プラグインフック、[monitor](/ja/plugins-reference#monitors)、または MCP [`headersHelper`](/ja/mcp#use-dynamic-headers-for-custom-authentication)コマンドが `${user_config.KEY}` [プラグインオプション](/ja/plugins-reference#user-configuration)を参照しており、置換された文字列がシェルに渡されます。`$(...)` 、バックティック、または `;` を含む設定値がそこでコードとして実行される可能性があるため、Claude Code は値を置換する代わりにコンポーネントの起動を拒否します。チェックはコマンドテンプレートで実行されるため、値がまだ設定されていない場合でもエラーが表示されます。v2.1.207 より前では、値がシェルコマンドに置換されていました。
1267
1268表現は、どのサーフェスがオプションを参照したかによって異なります。シェル形式フックは以下のように報告します：
1269
1270```text theme={null}
1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
1272```
1273
1274モニターは以下のように報告します：
1275
1276```text theme={null}
1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
1278```
1279
1280MCP `headersHelper` は以下のように報告します：
1281
1282```text theme={null}
1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
1284```
1285
1286**対処方法：**
1287
1288* フックの場合、`args` 配列を追加して、各 `${user_config.KEY}` が間にシェルなしで 1 つの引数になる [exec 形式](/ja/hooks#exec-form-and-shell-form)で実行されるようにします。または参照を削除し、スクリプト内から `$CLAUDE_PLUGIN_OPTION_<KEY>` 環境変数を読み取ります
1289* モニターの場合、参照を削除し、モニタースクリプトが設定ファイルから値を読み取るようにします
1290* `headersHelper` の場合、`${user_config.KEY}` をシェル解析されない サーバーの `headers` フィールドに移動するか、ヘルパースクリプト内から値を読み取ります
1291
1292<h2 id="tool-errors">
1293 ツールエラー
1294</h2>
1295
1296これらのエラーは Claude の組み込みツールが入力を拒否することから発生します。Claude はほとんどのツールエラーを自動的に修正しますが、以下の 2 つは、サブエージェント定義またはあなたが制御する権限ルールから発生するため、あなたからの変更が必要です。
1297
1298<h3 id="agent-would-be-spawned-with-zero-tools">
1299 Agent would be spawned with zero tools
1300</h3>
1301
1302[サブエージェントの `tools` リスト](/ja/sub-agents#supported-frontmatter-fields)内のなにもツールに解決されなかったため、Claude Code はサブエージェントを起動することを拒否します。これは、アクションを実行できないサブエージェントを起動するのではなく、起動を拒否するためです。メッセージは、エントリが解決されなかった理由でグループ化されます。認識されたツールではない、サブエージェントで利用できないツール、または認識されているが現在のセッション内のツールと一致しないツールです。`tools` フィールドを省略することは、この拒否をトリガーしません。`mcp__github__*` などの MCP サーバーパターンは免除されません。そのサーバーから接続されたツールがない場合、起動は一致しないグループのパターンで拒否されます。v2.1.208 より前では、サブエージェントはツールなしで起動され、空の結果または混乱した結果を返していました。
1303
1304```text theme={null}
1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
1306```
1307
1308**対応方法：**
1309
1310* エラーが名前を付けた各エントリを [サブエージェントで利用可能なツール](/ja/sub-agents#available-tools)に対して修正してください
1311* セッションが持たないツール（接続されていないサーバーからの MCP ツールなど）のエントリを削除してください
1312* サブエージェントに親が持つすべてのツールを与えるには、ツールをリストする代わりに `tools` フィールドを削除してください
1313
1314<h3 id="file-is-covered-by-a-read-deny-rule">
1315 File is covered by a Read deny rule
1316</h3>
1317
1318Edit ツールが [`Read` 拒否ルール](/ja/permissions#read-and-edit)に一致するパス（そのパスで新しいファイルを作成することを含む）で呼び出されました。編集は Claude が読み直す必要があるコンテンツを書き直すため、ファイルアクセスの前に呼び出しが拒否されます。ルールは Edit ツールのみをブロックします。Write と NotebookEdit は `Read` 拒否ルールでカバーされていません。v2.1.208 より前では、`Edit` 拒否ルールのみが編集をブロックし、`Read` 拒否ルール単独ではブロックしていませんでした。
1319
1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1322```
1323
1324**対応方法：**
1325
1326* Claude がファイルを編集できるようにする場合は、`/permissions` または [設定](/ja/settings#permission-settings)で `Read` 拒否ルールを削除または縮小してください
1327* ファイルが変更されないままである必要がある場合は、ルールを保持し、同じパスに対して `Edit` 拒否ルールを追加して、Write と NotebookEdit ツールもブロックしてください
1328
1329<h2 id="background-session-errors">
1330 バックグラウンドセッションエラー
1331</h2>
1332
1333[バックグラウンドセッション](/ja/agent-view)は独自のインタラクティブターミナルなしで実行されるため、ターミナルが必要なコマンドはそこで異なる動作をします。これらのメッセージはバックグラウンドセッションのトランスクリプト、エージェントビュー、またはアタッチ後に表示されます。
1334
1335<h3 id="commands-refused-in-a-background-session">
1336 バックグラウンドセッションで拒否されるコマンド
1337</h3>
1338
1339インタラクティブダイアログを開くコマンドはバックグラウンドセッションで拒否され、そこで機能するフォームの名前を示すメッセージ、またはコマンドを通常のターミナルから実行するよう指示するメッセージが表示されます。`/install-github-app`、`/mcp` 設定リスト、および MCP サーバーメニューの認証アクションはすべてこのように拒否されます。v2.1.208 より前では、これらはバックグラウンドセッション内でダイアログを開いていました。
1340{/* max-version: 2.1.208 */}v2.1.208 のみでは、`/model` ピッカーもバックグラウンドセッションで拒否され、`/upgrade` はブラウザを開く代わりにアップグレード URL を出力していました。
1341
1342メッセージの文言は拒否されたコマンドの名前を示します。`/mcp` 設定リストは以下を報告します：
1343
1344```text theme={null}
1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.
1346```
1347
1348**対応方法：**
1349
1350* メッセージが示すフォーム（`/mcp reconnect <server>`、`/mcp enable`、`/mcp disable` など）を使用する
1351* サインインおよび認可フローの場合は、ターミナルの通常の `claude` セッションからコマンドを実行する
1352
1353<h3 id="claude_code_process_wrapper-launcher-errors">
1354 CLAUDE\_CODE\_PROCESS\_WRAPPER ランチャーエラー
1355</h3>
1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/ja/corporate-launcher) が設定されており、その値を使用できないため、Claude Code はランチャーなしで実行するのではなく、影響を受けるプロセスの起動を拒否します。設定の問題は、変数名で始まり理由を述べるメッセージで報告されます。例えば：
1358
1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1361```
1362
1363起動しても Claude Code で自身を置き換えずに終了するランチャーは、起動していたセッションを失敗させ、エージェントビューのセッションの行はランチャーが `must exec, not daemonize` であることを報告し、その後にランチャーが出力したものが続きます。ランチャーのためにバックグラウンドサービスを開始または到達できないセッションは、ランチャーの問題を `Couldn't reach the background service (...)` 内の理由として報告します。
1364
1365**対応方法：**
1366
1367* 変数を `exec "$@"` を呼び出して終了する実行可能ファイルの絶対パスに設定する。完全な契約については[ランチャー契約](/ja/corporate-launcher#the-launcher-contract)を参照してください
1368* `/status` をチェックします。これは Self-exec エントリで解決されたランチコマンドを表示し、実行中のバックグラウンドサービスが一致しない場合に警告するか、シェルから `claude daemon status` を実行します
1369* [設定](/ja/corporate-launcher#set-up-the-launcher)の `env` ブロックで値を修正した後、`claude daemon stop --any` でバックグラウンドサービスを再起動して、次のディスパッチがラップされたものを開始するようにします
1370
1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1144 設定に関する警告1372 設定に関する警告
1145</h2>1373</h2>
1150 ワークスペースが信頼されていません1378 ワークスペースが信頼されていません
1151</h3>1379</h3>
1152 1380
1153Claude Code は、プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で `permissions.allow` ルールまたは `permissions.additionalDirectories` エントリを見つけましたが、[プロジェクト設定からの allow ルールはワークスペース信頼が必要](/ja/permissions#project-allow-rules-and-workspace-trust)であるため、それらを適用しませんでした。メッセージに表示されるカウント、設定名、ファイル名は、設定によって異なります。`deny` ルールと `ask` ルールは影響を受けません。1381Claude Code は、プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で `permissions.allow` ルールまたは `permissions.additionalDirectories` エントリを見つけましたが、[プロジェクト設定からの allow ルールはワークスペースの信頼が必要](/ja/permissions#project-allow-rules-and-workspace-trust)であるため、それらを適用しませんでした。メッセージに表示されるカウント、設定名、ファイル名は、お客様の設定によって異なります。`deny` ルールと `ask` ルールは影響を受けません。
1154 1382
1155```text theme={null}1383```text theme={null}
1156Ignoring 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.1384Ignoring 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.
1160 1388
1161* ディレクトリで `claude` を実行し、信頼ダイアログを受け入れます。{/* min-version: 2.1.200 */}親ディレクトリが既に信頼されている場合でも、ダイアログが表示され、保留中のルールが一覧表示され、それらなしで作業を続けることを拒否できます。v2.1.200 より前では、その状況ではダイアログが表示されなかったため、そこではこのステップを完了できませんでした。1389* ディレクトリで `claude` を実行し、信頼ダイアログを受け入れます。{/* min-version: 2.1.200 */}親ディレクトリが既に信頼されている場合でも、ダイアログが表示され、保留中のルールが一覧表示され、それらなしで作業を続けることを拒否できます。v2.1.200 より前では、その状況ではダイアログが表示されなかったため、そこではこのステップを完了できませんでした。
1162* [非対話型モード](/ja/headless)で `-p` を使用する場合、ダイアログは表示されません。メッセージが出力する正確な `projects` キーを使用して、`~/.claude.json` の `hasTrustDialogAccepted` エントリを設定します。1390* [非対話型モード](/ja/headless)で `-p` を使用する場合、ダイアログは表示されません。メッセージが出力する正確な `projects` キーを使用して、`~/.claude.json` の `hasTrustDialogAccepted` エントリを設定します。
1163* {/* 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 ルールとワークスペース信頼](/ja/permissions#project-allow-rules-and-workspace-trust)を参照してください。1391* {/* min-version: 2.1.200 */}メッセージが `.claude/settings.local.json` という名前で、Claude Code を git リポジトリの外部またはホームディレクトリで起動した場合は、v2.1.200 以降に更新してください。バージョン 2.1.196 から 2.1.199 では、これらのワークスペースで独自の `.claude/settings.local.json` をリポジトリ提供として扱いました。{/* min-version: 2.1.207 */}v2.1.207 以降では、git リポジトリの外部でフォルダを信頼していない場合、更新だけでは不十分です。フォルダがリポジトリ内にないことを判断するには git を実行する必要があり、Claude Code はその確認を信頼ダイアログを受け入れた後にのみ実行するため、最初のステップを使用してください。ホームディレクトリおよび他の[設定ホーム](/ja/permissions#project-allow-rules-and-workspace-trust)は除外され、ダイアログを待ちません。[プロジェクト allow ルールとワークスペースの信頼](/ja/permissions#project-allow-rules-and-workspace-trust)を参照してください。
1164 1392
1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1166 応答の品質がいつもより低いように見える1394 応答の品質がいつもより低いように見える
1172* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します1400* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します
1173* [自動モデルフォールバック](/ja/model-config#automatic-model-fallback) は Fable 5 でセッションをデフォルトの Opus モデルに移動し、トランスクリプトに通知を表示します1401* [自動モデルフォールバック](/ja/model-config#automatic-model-fallback) は Fable 5 でセッションをデフォルトの Opus モデルに移動し、トランスクリプトに通知を表示します
1174 1402
1175以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースは `/model` の変更ではなくトランスクリプト通知として表示されます。[モデル設定](/ja/model-config) は各フォールバックが適用される時期を説明しています。1403以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、`/model` の変更ではなく表示されます。[モデル設定](/ja/model-config) は各フォールバックが適用される時期を説明しています。
1176 1404
1177まずこれらを確認してください。1405まずこれらを確認してください。
1178 1406
1179* **モデル選択**: `/model` を実行して、期待するモデルにいることを確認します。以前の `/model` の選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。1407* **モデル選択**: `/model` を実行して、期待するモデルにいることを確認します。以前の `/model` の選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。
1180* **努力レベル**: `/effort` を実行して現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げます。デフォルトはモデルによって異なるため、最大値以下であると仮定する前に確認してください。[努力レベルを調整](/ja/model-config#adjust-effort-level) でモデルごとのデフォルトと `ultrathink` ショートカットを参照してください。1408* **努力レベル**: `/effort` を実行して現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げます。デフォルトはモデルによって異なるため、最大値以下であると仮定する前に確認してください。[努力レベルを調整](/ja/model-config#adjust-effort-level) でモデルごとのデフォルトと `ultrathink` ショートカットを参照してください。
1181* **コンテキスト圧力**: `/context` を実行してウィンドウがどの程度満杯かを確認します。容量に近い場合は、自然な区切り点で `/compact` を実行するか、新しく開始するために `/clear` を実行します。[コンテキストウィンドウを探索](/ja/context-window) で自動コンパクトが以前のターンにどのように影響するかを参照してください。1409* **コンテキスト圧力**: `/context` を実行してウィンドウがどの程度満杯かを確認します。容量に近い場合は、自然な区切り点で `/compact` を実行するか、`/clear` を実行して新たに開始します。[コンテキストウィンドウを探索](/ja/context-window) で自動コンパクトが以前のターンにどのように影響するかを参照してください。
1182* **古い指示**: 大きいまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、応答を操作できます。{/* min-version: 2.1.205 */}`/doctor` チェックアップは過度に大きいメモリファイルと未使用の拡張機能にフラグを立て、`/context` は MCP ツールトークン使用量を表示します。v2.1.205 より前では、`/doctor` は過度に大きいメモリファイルとサブエージェント定義にフラグを立てた診断画面を開きました。1410* **古い指示**: 大きいまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、応答を操作できます。{/* min-version: 2.1.205 */}`/doctor` チェックアップは過度に大きいメモリファイルと未使用の拡張機能にフラグを立て、`/context` は MCP ツールトークン使用量を表示します。v2.1.205 より前では、`/doctor` は過度に大きいメモリファイルとサブエージェント定義にフラグを立てた診断画面を開きました。
1183 1411
1184応答がうまくいかない場合、修正で返信するよりも通常は巻き戻しの方がうまく機能します。Esc を 2 回押すか `/rewind` を実行して悪いターンの前に戻り、より具体的なプロンプトで言い換えます。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定する可能性があります。[チェックポイント](/ja/checkpointing) を参照してください。1412応答がうまくいかない場合、修正で返信するよりも巻き戻しの方が通常はうまく機能します。Esc を 2 回押すか `/rewind` を実行して悪いターンの前に戻り、より具体的なプロンプトで言い換えます。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定する可能性があります。[チェックポイント](/ja/checkpointing) を参照してください。
1185 1413
1186上記を確認した後も品質がまだおかしいように見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。この方法で送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[エラーを報告](#report-an-error) を参照してください。1414上記を確認した後も品質がまだおかしいように見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。この方法で送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[エラーを報告](#report-an-error) を参照してください。
1187 1415
1188{/* min-version: 2.1.201 */}Sonnet 5 がリクエストを拒否し、Claude Code v2.1.200 以前で疑わしいプロンプトインジェクションを引用する場合は、`claude update` を実行して v2.1.201 修正を取得します。1416Claude が疑わしいプロンプトインジェクションについて警告する場合、または疑わしいインジェクションのためにリクエストを拒否する場合、警告が名前を付けるテキストがファイルまたはウェブコンテンツではなく Claude Code が会話に自動的に追加するコンテキストである場合は、`claude update` を実行して再試行してください。更新後に警告が繰り返される場合は、フラグが付いたコンテンツをプロンプトに貼り付け直すのではなく、[報告](#report-an-error) してください。{/* min-version: 2.1.201 */}v2.1.201 より前では、Sonnet 5 は同じ方法でいくつかのリクエストを拒否しました。
1189 1417
1190<h2 id="report-an-error">1418<h2 id="report-an-error">
1191 エラーを報告する1419 エラーを報告する
1192</h2>1420</h2>
1193 1421
1194このページでカバーされていないコンポーネントからのエラーについては、関連するガイドを参照してください。1422このページで扱っていないコンポーネントからのエラーについては、関連するガイドを参照してください。
1195 1423
1196* MCP サーバーが接続またはアテンティケーションに失敗した場合：[MCP](/ja/mcp)1424* MCP サーバーが接続または認証に失敗した場合：[MCP](/ja/mcp)
1197* フック スクリプトが失敗したか、ツールをブロックした場合：[フックのデバッグ](/ja/hooks#debug-hooks)1425* Hook スクリプトが失敗したか、ツールをブロックした場合：[Debug hooks](/ja/hooks#debug-hooks)
1198* インストール中にパーミッション拒否またはファイルシステム エラーが発生した場合：[インストールとログインのトラブルシューティング](/ja/troubleshoot-install)1426* インストール中に権限が拒否されたか、ファイルシステムエラーが発生した場合：[Troubleshoot installation and login](/ja/troubleshoot-install)
1199 1427
1200ここにエラーが記載されていない場合、または提案された修正が役に立たない場合：1428ここにエラーが記載されていない場合、または提案された修正が役に立たない場合：
1201 1429
1202* Claude Code 内で `/feedback` を実行して、トランスクリプトと説明を Anthropic に送信します。このコマンドは、事前入力された GitHub issue を開くオプションも提供します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、およびその他のサードパーティ プロバイダーでは、`/feedback` はローカル アーカイブを保存し、Anthropic アカウント担当者に送信できます。1430* Claude Code 内で `/feedback` を実行して、トランスクリプトと説明を Anthropic に送信します。このコマンドは、事前入力された GitHub issue を開くオプションも提供します。Anthropic への送信には[認証](/ja/authentication)が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、その他のサードパーティプロバイダー、または Anthropic 認証情報が設定されていない場合、`/feedback` は代わりに Anthropic アカウント担当者に送信できるローカルアーカイブを保存します。
1203* シェルから `claude doctor` を実行して、インストールの読み取り専用診断を実行するか、Claude Code 内で `/doctor` チェックアップを実行してセットアップの問題を検出して修正します。1431* シェルから `claude doctor` を実行して、インストールの読み取り専用診断を実行するか、Claude Code 内で `/doctor` チェックアップを実行してセットアップの問題を検出して修正します。
1204* [status.claude.com](https://status.claude.com) で有効なインシデントを確認します。1432* [status.claude.com](https://status.claude.com) でアクティブなインシデントを確認します。
1205* GitHub の[既存の issue](https://github.com/anthropics/claude-code/issues) を検索します。1433* GitHub の[既存の issue](https://github.com/anthropics/claude-code/issues) を検索します。
