146| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [ネットワーク](#sessions-ended-while-this-machine-was-offline) |146| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [ネットワーク](#sessions-ended-while-this-machine-was-offline) |
147| `Couldn't share the transcript.` | [ネットワーク](#couldnt-share-the-transcript) |147| `Couldn't share the transcript.` | [ネットワーク](#couldnt-share-the-transcript) |
148| `Couldn't send feedback` | [ネットワーク](#couldnt-send-feedback) |148| `Couldn't send feedback` | [ネットワーク](#couldnt-send-feedback) |
149| `Feedback payload too large. Try again without the transcript, or shorten the details.` | [ネットワーク](#feedback-payload-too-large) |
149| `MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.` | [ネットワーク](#mcp-server-connection-timed-out-during-a-sleep-or-clock-change) |150| `MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.` | [ネットワーク](#mcp-server-connection-timed-out-during-a-sleep-or-clock-change) |
150| `Prompt is too long` / `Input is too long for requested model` | [リクエストエラー](#prompt-is-too-long) |151| `Prompt is too long` / `Input is too long for requested model` | [リクエストエラー](#prompt-is-too-long) |
151| `Prompt is too long · automatic compaction failed:` | [リクエストエラー](#prompt-is-too-long) |152| `Prompt is too long · automatic compaction failed:` | [リクエストエラー](#prompt-is-too-long) |
335| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [ツールエラー](#failed-to-write-to-a-teammate-inbox) |336| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [ツールエラー](#failed-to-write-to-a-teammate-inbox) |
336| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [ツールエラー](#teammate-agent-definition-not-restored) |337| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [ツールエラー](#teammate-agent-definition-not-restored) |
337| `Only a teammate can approve a shutdown request` | [ツールエラー](#only-a-teammate-can-approve-a-shutdown-request) |338| `Only a teammate can approve a shutdown request` | [ツールエラー](#only-a-teammate-can-approve-a-shutdown-request) |
339| `A command-line deny rule cannot be handed to a teammate intact` | [ツールエラー](#command-line-deny-rule-cannot-be-handed-to-a-teammate) |
338| `Message too large for cross-session delivery` | [ツールエラー](#message-too-large-for-cross-session-delivery) |340| `Message too large for cross-session delivery` | [ツールエラー](#message-too-large-for-cross-session-delivery) |
339| `Too many messages to this session just now` | [ツールエラー](#too-many-messages-to-this-session-just-now) |341| `Too many messages to this session just now` | [ツールエラー](#too-many-messages-to-this-session-just-now) |
340| `Cross-session message was dropped at the recipient session's inbox` | [ツールエラー](#cross-session-message-dropped-at-the-inbox) |342| `Cross-session message was dropped at the recipient session's inbox` | [ツールエラー](#cross-session-message-dropped-at-the-inbox) |
375| `This conversation is already open in another running Claude session` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |377| `This conversation is already open in another running Claude session` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |
376| `This session's saved conversation is no longer on disk` | [バックグラウンドセッションエラー](#this-sessions-saved-conversation-is-no-longer-on-disk) |378| `This session's saved conversation is no longer on disk` | [バックグラウンドセッションエラー](#this-sessions-saved-conversation-is-no-longer-on-disk) |
377| `Bypass permissions was requested at launch and ignored` | [バックグラウンドセッションで Bypass permissions が無視される](https://code.claude.com/docs/ja/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |379| `Bypass permissions was requested at launch and ignored` | [バックグラウンドセッションで Bypass permissions が無視される](https://code.claude.com/docs/ja/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |
378| `kept <id> — its worktree is still at <path>` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |380| `kept <id> — its worktree is still at <path>` | メッセージの次の行にプッシュされていないコミットへの言及がある場合は [バックグラウンドセッションのエラー](#worktree-has-commits-that-are-not-pushed-anywhere)、それ以外の場合は [セッションを削除すると何が削除されるか](https://code.claude.com/docs/ja/agent-view.md#what-deleting-a-session-removes) |
379| `kept <id> — <n> unpushed commits on <branch>` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |381| `kept <id> — <n> unpushed commits on <branch>` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |
380| `kept <id> — worktree has commits that are not pushed anywhere` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |382| `kept <id> — worktree has commits that are not pushed anywhere` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |
381| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [バックグラウンドセッションエラー](#terminal-host-process-died) |383| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [バックグラウンドセッションエラー](#terminal-host-process-died) |
2188 2190
2189### Couldn't send feedback2191### Couldn't send feedback
2190 2192
2191`Couldn't send feedback` で始まるメッセージは、[`/feedback`、`/bug`、または `/share` ダイアログ](https://code.claude.com/docs/ja/commands#all-commands) から送信したレポート、またはキューに入っている [フィードバックドラフト](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior) が送信されなかったことを意味します。コロンの後に組織に関する文が続く場合は、組織がフィードバックを拒否しているため、同じレポートを送っても同じ結果になります。2193`Couldn't send feedback` で始まるメッセージは、[`/feedback`、`/bug`、または `/share` ダイアログ](https://code.claude.com/docs/ja/commands#all-commands) から送信したレポート、またはキューに入っている [フィードバックドラフト](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior) の受信をフィードバックサービスが確認しなかったことを意味します。受信されなかったものとして扱ってください。コロンの後に組織に関する文が続く場合は、組織がフィードバックを拒否しているため、同じレポートを送っても同じ結果になります。
2192 2194
2193次の 2 つの例のうち、1 つ目はネットワーク障害、2 つ目は組織による拒否です。2195次の 2 つの例のうち、2 つ目は組織による拒否です。
2194 2196
2195```text wrap theme={null}2197```text wrap theme={null}
2196Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.2198Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.
2203* **サインインしていない場合**：メッセージは `: not signed in. Run /login, then retry.` と続きます。`/login` を実行してから、再度送信してください。2205* **サインインしていない場合**：メッセージは `: not signed in. Run /login, then retry.` と続きます。`/login` を実行してから、再度送信してください。
2204* **組織による拒否**：例えば `: Feedback has not been enabled for your organization.` や `: Feedback collection is not available for organizations with custom data retention policies.` です。メッセージに `To report a bug, open an issue` が追加されている場合は、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成してください。キューに入っているドラフトはキューに残り、[破棄](https://code.claude.com/docs/ja/tools-reference.md#discard-or-keep-a-draft) することもできます。2206* **組織による拒否**：例えば `: Feedback has not been enabled for your organization.` や `: Feedback collection is not available for organizations with custom data retention policies.` です。メッセージに `To report a bug, open an issue` が追加されている場合は、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成してください。キューに入っているドラフトはキューに残り、[破棄](https://code.claude.com/docs/ja/tools-reference.md#discard-or-keep-a-draft) することもできます。
2205* **拒否された認証情報**：メッセージは `: the sign-in this session uses is not allowed to send feedback` または `: the server did not accept the credentials this session uses` と続きます。Claude Code のプロンプトで `/status` を実行して、このセッションが送信するログイン、トークン、または API キーを確認してください。2207* **拒否された認証情報**：メッセージは `: the sign-in this session uses is not allowed to send feedback` または `: the server did not accept the credentials this session uses` と続きます。Claude Code のプロンプトで `/status` を実行して、このセッションが送信するログイン、トークン、または API キーを確認してください。
2206* **`Couldn't send feedback` の直後に `(request timed out)` または `(couldn't reach the service)` がある場合**：これらはネットワーク障害です。レポートまたはキューに入っているドラフトを再度送信してください。ダイアログはテキストを保持し、キューに入っているドラフトのメッセージには `The draft is still queued.` と表示されます。他のリクエストも失敗している場合は、ネットワーク接続を確認し、[Unable to connect to API](#unable-to-connect-to-api) を参照してください。失敗し続ける場合は、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) でレポートを提出してください。2208* **`Couldn't send feedback` の直後に `(request timed out)` または `(couldn't reach the service)` がある場合**：レポートまたはキューに入っているドラフトを再度送信してください。ダイアログはテキストを保持し、キューに入っているドラフトのメッセージには `The draft is still queued.` と表示されます。他のリクエストも失敗している場合は、ネットワーク接続を確認し、[Unable to connect to API](#unable-to-connect-to-api) を参照してください。失敗し続ける場合は、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) でレポートを提出してください。
2207* **`Couldn't send feedback` の直後に `(server returned <status>)` がある場合、または理由がない場合**：ステータスはサービスの応答コードです。サービス独自のメッセージが送信された場合は、`(server returned 403: Access Forbidden)` のようにステータスの後に続きます。失敗し続ける場合は、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) でレポートを提出してください。2209* **`Couldn't send feedback` の直後に `(server returned <status>)` がある場合、または理由がない場合**：ステータスはサービスの応答コードです。サービス独自のメッセージが送信された場合は、`(server returned 403: Access Forbidden)` のようにステータスの後に続きます。失敗し続ける場合は、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) でレポートを提出してください。
2208 2210
2209github.com/anthropics/claude-code の issue は公開されるため、作成時にはコード、トランスクリプト、その他の機密情報を含めないでください。2211github.com/anthropics/claude-code の issue は公開されるため、作成時にはコード、トランスクリプト、その他の機密情報を含めないでください。
2210 2212
2211v2.1.281 より前では、ダイアログを開いている間に Remote Control の **Stop** または緊急のクロスセッションメッセージが到着すると、以降のすべての送信がこのメッセージで失敗しました。これらのバージョンでは、ダイアログを閉じて再度開き、もう一度送信してください。2213v2.1.281 より前では、ダイアログを開いている間に Remote Control の **Stop** または緊急のクロスセッションメッセージが到着すると、以降のすべての送信がこのメッセージで失敗しました。これらのバージョンでは、ダイアログを閉じて再度開き、もう一度送信してください。
2212 2214
2215### Feedback payload too large
2216
2217[フィードバックドラフト](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior) の [レビュー画面](https://code.claude.com/docs/ja/tools-reference.md#review-and-edit-a-draft) に表示されるこのメッセージは、サービスがドラフトを受け入れたという確認を Claude Code が得られていないことを意味します。受信されなかったものとして扱ってください。ドラフトは `/feedback` キューに残るため、再度送信できます。
2218
2219```text wrap theme={null}
2220Feedback payload too large. Try again without the transcript, or shorten the details.
2221```
2222
2223**対応方法：**
2224
2225* レビュー画面で **Send transcript** を `no` に設定してから、ドラフトを再度送信してください。詳細を短くしても削減できるテキストは最大 10 KB で、これはドラフトの詳細に保持できる上限です。
2226
2213### MCP server connection timed out during a sleep or clock change2227### MCP server connection timed out during a sleep or clock change
2214 2228
2215このメッセージは、[MCP サーバー](https://code.claude.com/docs/ja/mcp.md) への接続がタイムアウトし、その試行中にシステムクロックが先に進んだことを Claude Code が検出したことを意味します。2229このメッセージは、[MCP サーバー](https://code.claude.com/docs/ja/mcp.md) への接続がタイムアウトし、その試行中にシステムクロックが先に進んだことを Claude Code が検出したことを意味します。
2986* 最後のメッセージを言い換えるか、別のアプローチを試してください3000* 最後のメッセージを言い換えるか、別のアプローチを試してください
2987* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください3001* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください
2988 3002
2989## コマンドラインのエラー3003## コマンドラインエラー
2990 3004
2991これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、そして `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。3005これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、そして `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。
2992 3006
2993### `--bg` と `--print` の競合3007### `--bg` と `--print` の競合
2994 3008
2995このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` を `-p` または `--print` と組み合わせています。`--bg` は後で `claude agents` でアタッチする[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始しますが、`--print` は[非対話](https://code.claude.com/docs/ja/headless.md)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、決してアタッチできないバックグラウンドジョブが何も通知されずに作成されていました。3009このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` と `-p` または `--print` を組み合わせました。`--bg` は後で `claude agents` でアタッチする[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始しますが、`--print` は[非対話](https://code.claude.com/docs/ja/headless.md)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせにより、アタッチできないバックグラウンドジョブが何も通知されずに作成されていました。
2996 3010
2997```text theme={null}3011```text theme={null}
2998--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>'`.3012--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>'`.
2999```3013```
3000 3014
3001**対処方法：**3015**対処方法:**
3002 3016
3003* `-p` または `--print` を外します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` で完全なコマンドになります。[シェルから新しいエージェントを Dispatch する](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。3017* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` だけで完全なコマンドになります。[シェルから新しいエージェントをディスパッチする](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。
3004* バックグラウンドセッションを作成する代わりに、プロンプトを非対話で実行して結果を出力するには、`--bg` を外して `claude -p "<task>"` を実行します3018* バックグラウンドセッションを作成せずにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します
3005 3019
3006### Couldn't tell whether `--bg` is a flag or text3020### Couldn't tell whether `--bg` is a flag or text
3007 3021
3008`--bg` または `--background` を、Claude Code がバックグラウンドフラグとテキストのどちらとして意図されたかを判別できない位置に置いて `claude` を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました：3022`--bg` または `--background` を、Claude Code がバックグラウンドフラグとして意図したのかテキストとして意図したのかを判別できない位置に置いて `claude` を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:
3009 3023
3010```text theme={null}3024```text theme={null}
3011Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>3025Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>
3013 3027
3014`--background` と入力した場合は、この行には代わりに `--background` が示されます。3028`--background` と入力した場合は、この行には代わりに `--background` が示されます。
3015 3029
3016**対処方法：**3030**対処方法:**
3017 3031
3018* [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始するには、フラグを先頭に置いてシェルでコマンドを再度実行します：`claude --bg --name nightly-audit "<task>"`3032* [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始するには、フラグを先頭にしてシェルでコマンドを再実行します: `claude --bg --name nightly-audit "<task>"`
3019 3033
3020### システムプロンプトフラグとそのファイル形式の競合3034### システムプロンプトフラグとそのファイル形式の競合
3021 3035
30221 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します：30361 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:
3023 3037
3024```text theme={null}3038```text theme={null}
3025Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.3039Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
3026```3040```
3027 3041
3028v2.1.283 より前は、`--system-prompt` を `--system-prompt-file` と、または `--append-system-prompt` を `--append-system-prompt-file` と一緒に渡した場合も、`claude` は同じように終了していました。これらの組み合わせは[結合](https://code.claude.com/docs/ja/cli-reference.md#system-prompt-flags)されずに競合していたためです。これらのバージョンでは、メッセージには組み合わせたフラグの組が示されます。3042v2.1.283 より前は、`--system-prompt` と `--system-prompt-file`、または `--append-system-prompt` と `--append-system-prompt-file` を一緒に渡した場合も、`claude` は同じように終了していました。これらの組み合わせは[結合](https://code.claude.com/docs/ja/cli-reference.md#system-prompt-flags)されるのではなく競合していたためです。これらのバージョンでは、メッセージには組み合わせたペアが示されます。
3029 3043
3030**対処方法：**3044**対処方法:**
3031 3045
3032* フラグの一方の形式だけを残し、もう一方を外します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします3046* フラグのどちらか一方の形式だけを残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします
3033 3047
3034### Invalid `--agents` configuration3048### Invalid `--agents` configuration
3035 3049
3036`--agents` に渡した値が無効なため、`claude` はセッションを開始せずに終了コード 1 で終了します。`--safe-mode` を渡すか [`CLAUDE_CODE_SAFE_MODE`](https://code.claude.com/docs/ja/env-vars#variables) を設定している場合、Claude Code は `--agents` を完全に無視します。`--resume` または `--continue` を使用している場合、インラインの JSON 値はチェックされずにセッションが開始されますが、ファイルから読み込んだ値は起動のたびにチェックされます。v2.1.242 より前は、Claude Code はそれでもセッションを開始していました。3050`--agents` に渡した値が無効なため、`claude` はセッションを開始せずに終了コード 1 で終了します。`--safe-mode` を渡すか [`CLAUDE_CODE_SAFE_MODE`](https://code.claude.com/docs/ja/env-vars#variables) を設定した場合、Claude Code は `--agents` を完全に無視します。`--resume` または `--continue` を使用した場合、インライン JSON の値はチェックされずにセッションが開始されます。ファイルから読み取った値は起動のたびにチェックされます。v2.1.242 より前は、Claude Code はそれでもセッションを開始していました。
3037 3051
3038```text theme={null}3052```text theme={null}
3039Error: Invalid --agents configuration:3053Error: Invalid --agents configuration:
3040<what failed>3054<what failed>
3041```3055```
3042 3056
30431 行目に続く内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順に実行し、最初に失敗したところで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます：30571 行目に続く内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順番に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:
3044 3058
30451. 値が `{` で始まるものの JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します30591. 値が `{` で始まっているのに JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します
30462. 解析はできるものの、エージェント定義が [CLI で定義されたサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します30602. 解析はできたものの、エージェント定義が [CLI で定義されたサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)のスキーマと一致しない場合、Claude Code は問題ごとに 1 行を出力します
30473. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します30613. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します
3048 3062
3049問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。3063問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。
3050 3064
3051`--print` を使用している場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。次のようなものがあります：3065`--print` を使用する場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。たとえば次のようなものです:
3052 3066
3053* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**：Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み込みます。3067* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み取ります。
3054* **`Error: --agents file not found: <path>`**：そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって壊されたインライン JSON もこの形で失敗することがあります。パスまたは引用符を確認し、コマンドを再度実行します。3068* **`Error: --agents file not found: <path>`**: そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって壊されたインライン JSON もこの形で失敗することがあります。パスまたはクォートを確認し、コマンドを再実行してください。
3055 3069
3056**対処方法：**3070**対処方法:**
3057 3071
3058* メッセージに列挙された各問題を修正してから、コマンドを再度実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を参照してください。3072* メッセージに記載された各問題を修正してから、コマンドを再実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を参照してください。
3059 3073
3060### Cloud sessions cannot be created from a `--restricted` session3074### Cloud sessions cannot be created from a `--restricted` session
3061 3075
3062[`--restricted`](https://code.claude.com/docs/ja/cli-reference#cli-flags) を指定してセッションを開始した場合、Claude Code はそのセッションから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-terminal-to-cloud)を作成することを拒否します。新しいセッションは制限されたプロセスの外で実行され、制限モードを適用しないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません：3076[`--restricted`](https://code.claude.com/docs/ja/cli-reference#cli-flags) を指定してセッションを開始した場合、Claude Code はそのセッションから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-terminal-to-cloud)を作成することを拒否します。新しいセッションは制限されたプロセスの外部で実行され、制限モードが適用されないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:
3063 3077
3064```text theme={null}3078```text theme={null}
3065Cloud sessions cannot be created from a --restricted session: they would not enforce it.3079Cloud sessions cannot be created from a --restricted session: they would not enforce it.
3066```3080```
3067 3081
3068**対処方法：**3082**対処方法:**
3069 3083
3070* 制限されたセッションでタスクをローカルに実行します3084* 制限されたセッションでタスクをローカルに実行します
3071* セッションの起動方法を制御できる場合は、`--restricted` を付けずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します3085* セッションの起動方法を制御できる場合は、`--restricted` を指定せずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します
3072 3086
3073v2.1.248 より前の Claude Code には `--restricted` フラグがなく、それより前のバージョンでは不明なオプションのエラーでフラグ自体が拒否されます。3087v2.1.248 より前の Claude Code には `--restricted` フラグがなく、以前のバージョンではフラグ自体が不明なオプションのエラーとして拒否されます。
3074 3088
3075### Cloud sessions are disabled by your organization's policy3089### Cloud sessions are disabled by your organization's policy
3076 3090
3077組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)とそれを使用するコマンドは利用できません：3091組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)とそれを使用するコマンドは利用できません:
3078 3092
3079```text theme={null}3093```text theme={null}
3080Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.3094Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
3081```3095```
3082 3096
3083このメッセージは、[ターミナルからクラウドセッションを作成する](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-terminal-to-cloud)とき、および `/teleport`、`/remote-env`、`/web-setup` など、クラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドを送信すると代わりに [`Unknown command`](#unknown-command) が返されていました。3097このメッセージは、[ターミナルからクラウドセッションを作成する](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-terminal-to-cloud)とき、および`/teleport`、`/remote-env`、`/web-setup` などクラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドを送信すると代わりに [`Unknown command`](#unknown-command) が返されていました。
3084 3098
3085メッセージが代わりにこのセッションで使用している認証情報を示し、`Cloud sessions use your claude.ai login.` で終わる場合は、[Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login) を参照してください。Claude Code が組織のポリシーをまったく読み込めなかった場合は、代わりに[別のメッセージ](#couldnt-verify-your-organizations-policy-for-cloud-sessions)が表示されます。3099メッセージがこのセッションで使用している認証情報の名前を示し、`Cloud sessions use your claude.ai login.` で終わる場合は、[Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login) を参照してください。Claude Code が組織のポリシーをまったく読み込めなかった場合は、代わりに[別のメッセージ](#couldnt-verify-your-organizations-policy-for-cloud-sessions)が表示されます。
3086 3100
3087**対処方法：**3101**対処方法:**
3088 3102
3089* 組織の [Owner](https://code.claude.com/docs/ja/server-managed-settings.md#access-control) に、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理設定でクラウドセッションを有効にするよう依頼します3103* 組織の [Owner](https://code.claude.com/docs/ja/server-managed-settings.md#access-control) に依頼して、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理設定でクラウドセッションを有効にしてもらいます
3090 3104
3091### Cloud sessions use your claude.ai login3105### Cloud sessions use your claude.ai login
3092 3106
3093[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージがこのセッションで使用している認証情報を示し、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります：3107[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージがこのセッションで使用している認証情報の名前を示し、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai ログインが属する組織とは異なる場合があります:
3094 3108
3095```text theme={null}3109```text theme={null}
3096Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.3110Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.
3097```3111```
3098 3112
3099最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合も Claude Code は組織の管理者に連絡するよう促す形式を出力していました。3113最後の文は、クラウドセッションはその認証情報ではなく claude.ai ログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合も Claude Code は組織の管理者に連絡するよう伝える形式を出力していました。
3100 3114
3101### Couldn't verify your organization's policy for cloud sessions3115### Couldn't verify your organization's policy for cloud sessions
3102 3116
3103これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間、メッセージは次のとおりです：3117これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、次のメッセージが表示されます:
3104 3118
3105```text theme={null}3119```text theme={null}
3106Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.3120Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.
3107```3121```
3108 3122
3109セッション内では、`/teleport` や `/web-setup` など、クラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルであれば `Cloud sessions aren't available:` 形式が出力される場合でもこのメッセージが表示され、2 文目は `Check your network connection, then restart Claude Code and try again.` となります。3123セッション内では、`/teleport` や `/web-setup` などクラウドセッションを必要とするコマンドもこのメッセージを表示します。シェルであれば `Cloud sessions aren't available:` 形式が出力される場合でもこのメッセージが表示され、その 2 文目は `Check your network connection, then restart Claude Code and try again.` となります。
3110 3124
3111ポリシーのリクエストが失敗した後は、メッセージに何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に適用されます。API への経路がない場合、次のように表示されます：3125ポリシーのリクエストが失敗すると、メッセージには何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に適用されます。API への経路がない場合、メッセージは次のようになります:
3112 3126
3113```text theme={null}3127```text theme={null}
3114Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.3128Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.
3115```3129```
3116 3130
3117その他の失敗も同じ書き出しで、それぞれの原因が続きます。たとえば、HTTP 403 でリクエストを拒否したプロキシ、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージはその認証情報を示し、設定を解除するよう促すこともあります：3131その他の失敗は同じ書き出しに続けてそれぞれの原因を示します。たとえば、HTTP 403 でリクエストを拒否したプロキシ、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai ログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその名前が示され、設定を解除するよう伝えられることもあります:
3118 3132
3119```text theme={null}3133```text theme={null}
3120Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.3134Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.
3122 3136
3123v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。3137v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。
3124 3138
3125**対処方法：**3139**対処方法:**
3126 3140
3127* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認してから再試行します。セッション内の場合は、先に Claude Code を再起動します3141* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内では、先に Claude Code を再起動します
3128* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や示された認証情報の設定解除など、原因に応じた対処を行ってから、コマンドを再度実行します3142* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や示された認証情報の設定解除など、その原因に応じた対処を行ってから、コマンドを再実行します
3129 3143
3130### 追跡対象ファイルがフォルダに置き換えられたため何も stash されなかった3144### フォルダーが追跡対象のファイルを置き換えたため何もスタッシュされなかった
3131 3145
3132このメッセージは、チェックアウト内で、git で追跡されていたファイルまたはリンクがあった場所に、現在はフォルダがあることを意味します。`claude --teleport` や `/teleport` などで[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-cloud-to-terminal)をターミナルに取り込む際に stash オプションを選択した後に表示されます。その状態を stash するとフォルダ内のファイルが削除される可能性があるため、Claude Code は stash を拒否し、チェックアウトとインデックスを変更せずに残します：3146このメッセージは、チェックアウト内で、以前 git で追跡されていたファイルまたはリンクがあった場所にフォルダーが存在することを意味します。`claude --teleport` や `/teleport` などで[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-cloud-to-terminal)をターミナルに取り込む際にスタッシュのオプションを選択すると表示されます。その状態をスタッシュするとフォルダー内のファイルが削除される可能性があるため、Claude Code はスタッシュを拒否し、チェックアウトとインデックスを変更しないままにします:
3133 3147
3134```text wrap theme={null}3148```text wrap theme={null}
3135Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.3149Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.
3136```3150```
3137 3151
3138**対処方法：**3152**対処方法:**
3139 3153
3140* メッセージのとおり、変更をコミットするかフォルダを別の場所に移動してから、teleport を再度実行します3154* メッセージのとおり、変更をコミットするかフォルダーを別の場所に移動してから、Teleport を再実行します
3141 3155
3142### `--json-schema` の値が有効な JSON Schema ではない3156### The `--json-schema` value is not a valid JSON Schema
3143 3157
3144[非対話モード](https://code.claude.com/docs/ja/headless.md#get-structured-output)で [`--json-schema`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema のコンパイルに失敗したため、`claude` はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマではエラーなしで非構造化の出力が生成され、`format` キーワードを使用するスキーマはすべて無効として扱われていました。3158[非対話モード](https://code.claude.com/docs/ja/headless.md#get-structured-output)で [`--json-schema`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema のコンパイルに失敗したため、`claude` はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマはエラーなしで構造化されていない出力を生成し、`format` キーワードを使用するスキーマはすべて無効として扱われていました。
3145 3159
3146```text theme={null}3160```text theme={null}
3147Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values3161Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
3148```3162```
3149 3163
31502 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` を注釈として受け付け、適用はしません。31642 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` をアノテーションとして受け付け、強制はしません。
3151 3165
3152Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON ではない値は `Error: --json-schema is not valid JSON` で、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。3166Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON でない値は `Error: --json-schema is not valid JSON` で拒否し、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否します。
3153 3167
3154**対処方法：**3168**対処方法:**
3155 3169
3156* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します3170* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します
3157* 動作するスキーマとコマンドについては、[構造化出力を取得する](https://code.claude.com/docs/ja/headless.md#get-structured-output)を参照してください3171* 動作するスキーマとコマンドについては、[構造化出力を取得する](https://code.claude.com/docs/ja/headless.md#get-structured-output)を参照してください
3158 3172
3159### Settings file exceeds the 2MiB limit3173### Settings file exceeds the 2MiB limit
3160 3174
3161[`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` は読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み込んでおり、数ギガバイトのファイルや `/dev/zero` のようなデバイスファイルによってメモリが際限なく増加していました。3175[`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` は起動時にそのファイルを読み込まずに終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み取っていたため、数 GB のファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。
3162 3176
3163```text theme={null}3177```text theme={null}
3164Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3178Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
3165```3179```
3166 3180
3167Claude Code は、通常のファイルではない `--settings` のパスも同様に拒否します。デバイス、FIFO、ソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` の後にパスが表示され、ディレクトリの場合は `EISDIR` の理由が表示されます。3181Claude Code は、通常のファイルではない `--settings` のパスも同様に拒否します。デバイス、FIFO、ソケットの場合はパスに続けて `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` が報告され、ディレクトリの場合は `EISDIR` が理由として報告されます。
3168 3182
3169**対処方法：**3183**対処方法:**
3170 3184
3171* `--settings` に 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](https://code.claude.com/docs/ja/settings.md)を参照してください。3185* `--settings` には 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](https://code.claude.com/docs/ja/settings.md)を参照してください。
3172 3186
3173### The current directory no longer exists3187### The current directory no longer exists
3174 3188
3175シェルがディレクトリに入った後で削除または移動されたディレクトリ（たとえば、別のシェルが削除した worktree や一時ディレクトリ）から `claude` を開始しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](https://code.claude.com/docs/ja/headless.md)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code は stderr に minify されたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを出力してクラッシュしていました。3189シェルが移動した後に削除または移動されたディレクトリ（たとえば、別のシェルが削除した worktree や一時ディレクトリ）から `claude` を起動しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](https://code.claude.com/docs/ja/headless.md)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code はミニファイされたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。
3176 3190
3177```text theme={null}3191```text theme={null}
3178The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3192The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
3179error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3193error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
3180```3194```
3181 3195
3182どちらの形式も、原因と修正方法は同じです。3196原因と修正方法はどちらの形式でも同じです。
3183 3197
3184権限の変更など、別の理由で Claude Code が作業ディレクトリを読み取れない場合は、メッセージに代わりにエラーコードが示されます：`Can't read the current directory (EACCES). Start Claude Code from a different directory.`3198権限の変更など別の理由で Claude Code が作業ディレクトリを読み取れない場合、メッセージには代わりにエラーコードが示されます: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`
3185 3199
3186macOS で `~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が表示される場合、通常は macOS がターミナルアプリによるそのフォルダへのアクセスをブロックしていることを意味します。そのフォルダを読み取る他のコマンドも同じように失敗します。そこで `ls` を実行すると、`sudo` を付けても `Operation not permitted` が報告されます。3200macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が発生する場合、通常は macOS がターミナルアプリからそのフォルダーへのアクセスをブロックしていることを意味します。そのフォルダーを読み取る他のコマンドも同様に失敗します。そこで `ls` を実行すると、`sudo` を使っても `Operation not permitted` と報告されます。
3187 3201
3188**対処方法：**3202**対処方法:**
3189 3203
3190* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再度実行します3204* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再実行します
3191* 同じパスにディレクトリが再作成された場合でも、シェルは削除されたディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て再び入ってから、`claude` を再度実行します3205* ディレクトリが同じパスに再作成された場合、シェルは削除されたディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て再度入り直してから、`claude` を再実行します
3192* macOS での `EPERM` の場合は、Cmd+Q でターミナルアプリを終了して再度開き、そのフォルダに戻って `claude` を実行します。それでもそのフォルダで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ**を開き、ターミナルアプリに対してそのフォルダをオンにしてから、ターミナルを開き直します3206* macOS で `EPERM` が発生した場合は、Cmd+Q でターミナルアプリを終了して再度開き、そのフォルダーに戻って `claude` を実行します。それでもそのフォルダーで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ** を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを開き直します
3193 3207
3194### 一時ディレクトリが拒否される、または作成できない3208### 一時ディレクトリが拒否された、または作成できない
3195 3209
3196macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) による上書き先の下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスに既に存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに、失敗内容を stderr に出力して終了コード 1 で終了します：3210macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) による上書き先の下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスにすでに存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに失敗内容を stderr に出力し、終了コード 1 で終了します:
3197 3211
3198```text wrap theme={null}3212```text wrap theme={null}
3199Claude Code's temporary directory /tmp/claude-501 could not be created: the volume holding /tmp is full (ENOSPC). Free space on that volume, or set CLAUDE_CODE_TMPDIR to a directory on another one, then try again.3213Claude Code's temporary directory /tmp/claude-501 could not be created: the volume holding /tmp is full (ENOSPC). Free space on that volume, or set CLAUDE_CODE_TMPDIR to a directory on another one, then try again.
3205Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.3219Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.
3206```3220```
3207 3221
3208**対処方法：**3222**対処方法:**
3209 3223
3210* `could not be created` の後に `is full (ENOSPC)` が続く場合は、メッセージが示すボリュームのディスク容量を空けます。代わりに `your disk quota on the volume holding /tmp is used up (EDQUOT)` と表示される場合は、そのボリューム上の不要になった自分のファイルを削除します3224* `could not be created` の後に `is full (ENOSPC)` が続く場合は、メッセージに示されたボリュームのディスク容量を空けます。代わりに `your disk quota on the volume holding /tmp is used up (EDQUOT)` と表示される場合は、そのボリューム上の自分のファイルのうち不要になったものを削除します
3211* `Refusing to use it` 形式の場合は、リンクの参照先ではなく、示されたエントリ自体を削除してから、Claude Code を再度開始します。`owned by uid` 形式の場合、それを削除できるのは管理者またはそのユーザーのみです3225* `Refusing to use it` 形式の場合は、リンクの参照先ではなく、示されたエントリ自体を削除してから Claude Code を再起動します。`owned by uid` 形式の場合、そのエントリを削除できるのは管理者またはそのユーザーのみです
3212* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再度開始します3226* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再起動します
3213* いずれの場合も、拒否されたパスはそのままにして、[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) を自分が管理するディレクトリに設定し、Claude Code を再度開始できます3227* いずれの場合も、拒否されたパスはそのままにして、[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) を自分が管理するディレクトリに設定し、Claude Code を再起動することもできます
3214 3228
3215v2.1.309 より前は、ボリュームがいっぱいの場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。例としては `ENOSPC: no space left on device, mkdir '/tmp/claude-501'` があり、同じ手順が適用されます。3229v2.1.309 より前は、ボリュームがいっぱいの場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。例は `ENOSPC: no space left on device, mkdir '/tmp/claude-501'` で、同じ手順が適用されます。
3216 3230
3217### ディレクトリを実際の場所に解決できなかった3231### Directory couldn't be resolved to a real location
3218 3232
3219作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code がそのディレクトリを実際の場所に解決できませんでした。3233作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code はそのディレクトリを実際の場所に解決できませんでした。
3220 3234
3221作業ディレクトリのサブディレクトリには既にファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントを読み込むだけです。Claude Code はそれらを読み込む前に、シンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることをチェックします。その場所を解決できない場合、Claude Code は何も読み込まずに次のメッセージを表示します：3235作業ディレクトリのサブディレクトリにはすでにファイルアクセスがあるため、`/add-dir` はそのスキル、コマンド、エージェントの読み込みのみを行います。それらを読み込む前に、Claude Code はシンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることをチェックします。Claude Code がその場所を解決できない場合は、何も読み込まずに次のメッセージを表示します:
3222 3236
3223```text theme={null}3237```text theme={null}
3224packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3238packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
3225```3239```
3226 3240
3227**対処方法：**3241**対処方法:**
3228 3242
3229* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再度実行します3243* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再実行します
3230* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです3244* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです
3231 3245
3232v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。この場所では Claude Code は設計上パスの解決を行わないため、ディレクトリに問題はなく、再試行しても解決しませんでした。3246v2.1.261 より前は、作業ディレクトリが `/net/<host>` のオートマウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。Claude Code はこの場所では設計上パスの解決を行いません。ディレクトリ自体に問題はなく、再試行しても解決しませんでした。
3233 3247
3234### Remote Control の起動時の Workspace not trusted3248### Remote Control 起動時の Workspace not trusted
3235 3249
3236> [!NOTE]3250> [!NOTE]
3237>3251>
3238> `claude ultrareview` が `Error: Workspace not trusted` を出力した場合は、代わりに [claude ultrareview の実行時の Workspace not trusted](#workspace-not-trusted-when-running-claude-ultrareview) を参照してください。3252> `claude ultrareview` で `Error: Workspace not trusted` が出力された場合は、代わりに [claude ultrareview 実行時の Workspace not trusted](#workspace-not-trusted-when-running-claude-ultrareview) を参照してください。
3239 3253
3240信頼していないディレクトリで `claude remote-control` またはそのエイリアス `claude rc` を使用して [Remote Control](https://code.claude.com/docs/ja/remote-control.md) のサーバーモードを開始しましたが、コマンドがそのディレクトリを信頼するかどうかを尋ねることができませんでした。たとえば、標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、ターミナルではない場合です。コマンドは終了コード 1 で終了します：3254信頼していないディレクトリで `claude remote-control` またはそのエイリアスの `claude rc` を使用して [Remote Control](https://code.claude.com/docs/ja/remote-control.md) のサーバーモードを開始しましたが、コマンドはそのディレクトリを信頼するかどうかを尋ねることができませんでした。たとえば、標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、コマンドの標準入力または標準出力がターミナルではない場合です。コマンドは終了コード 1 で終了します:
3241 3255
3242```text theme={null}3256```text theme={null}
3243Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3257Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3244```3258```
3245 3259
3246同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションが、ディレクトリを信頼することで有効になる内容を表示するには小さすぎるターミナル、またはサイズを報告しなかったターミナルで表示されます。ウィンドウを大きくするか通常のターミナルウィンドウに切り替えてから、`claude rc` を再度実行します。3260同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションは、ディレクトリを信頼すると何が有効になるかを表示するにはターミナルが小さすぎる場合、またはターミナルがサイズを報告しなかった場合に表示されます。ウィンドウを拡大するか通常のターミナルウィンドウに切り替えてから、`claude rc` を再実行してください。
3247 3261
3248ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はそこでは成功しません。3262ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はホームディレクトリでは成功しません。
3249 3263
3250```text theme={null}3264```text theme={null}
3251Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3265Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
3252```3266```
3253 3267
3254[`Trust <directory>?` の質問](https://code.claude.com/docs/ja/remote-control#requirements)に `n` と答えるか Enter を押した場合、コマンドはディレクトリを示す `Remote Control did not start` メッセージを出力し、終了コード 1 で終了します。`claude rc` を再度実行して `y` と答えます。3268[`Trust <directory>?` の質問](https://code.claude.com/docs/ja/remote-control#requirements)で `n` と答えるか Enter を押すと、コマンドはディレクトリ名を示す `Remote Control did not start` メッセージを出力し、終了コード 1 で終了します。`y` と答えるには `claude rc` を再実行してください。
3255 3269
3256**対処方法：**3270**対処方法:**
3257 3271
3258* 先にターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再度実行します3272* まずターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します
3259* ホームディレクトリの場合は、プロジェクトディレクトリに移動してそこで Remote Control を開始します3273* ホームディレクトリの場合は、プロジェクトディレクトリに移動し、そこで Remote Control を開始します
3260 3274
3261v2.1.284 より前は、ターミナル内であってもコマンドは質問しませんでした。3275v2.1.284 より前は、ターミナル内であってもコマンドが尋ねることはありませんでした。
3262 3276
3263### claude ultrareview の実行時の Workspace not trusted3277### claude ultrareview 実行時の Workspace not trusted
3264 3278
3265信頼していないフォルダで、[`claude ultrareview`](https://code.claude.com/docs/ja/ultrareview#trust-the-folder-before-the-review-runs) がそのフォルダを信頼するかどうかを尋ねられない場合、レビューが開始される前に実行は終了コード 1 で終了します：3279信頼していないフォルダーで、[`claude ultrareview`](https://code.claude.com/docs/ja/ultrareview#trust-the-folder-before-the-review-runs) がそのフォルダーを信頼するかどうかを尋ねられない場合、実行はレビューの開始前に終了コード 1 で終了します:
3266 3280
3267```text theme={null}3281```text theme={null}
3268Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. Or, in a script or CI job, pass `--trust-workspace` to trust the folder for this run only.3282Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. Or, in a script or CI job, pass `--trust-workspace` to trust the folder for this run only.
3269```3283```
3270 3284
3271たとえば、標準入力または標準出力がターミナルではない場合、サブコマンドは質問できません。`claude ultrareview --json > findings.json` のように出力をファイルに送ると、標準出力はターミナルではなくなります。3285たとえば、標準入力または標準出力がターミナルでない場合、サブコマンドは尋ねることができません。`claude ultrareview --json > findings.json` のように出力をファイルに送ると、標準出力はターミナルではなくなります。
3272 3286
3273**対処方法：**3287**対処方法:**
3274 3288
3275* スクリプトや CI ジョブでは、`--trust-workspace` を追加してその実行に限りフォルダを信頼します：`claude ultrareview --trust-workspace`。git と Claude Code がフォルダの git 設定とプロジェクト設定で指定されたプログラムを実行できるようになるため、信頼するコードに対してのみ追加してください。コードを信頼していないプルリクエストの場合は、[信頼するブランチからレビューを実行します](https://code.claude.com/docs/ja/ultrareview.md#trust-the-folder-before-the-review-runs)。3289* スクリプトまたは CI ジョブでは、`--trust-workspace` を追加してその実行に限りフォルダーを信頼します: `claude ultrareview --trust-workspace`。git と Claude Code がフォルダーの git 設定およびプロジェクト設定に記載されたプログラムを実行できるようになるため、信頼できるコードに対してのみ追加してください。コードを信頼できないプルリクエストの場合は、[信頼できるブランチからレビューを実行します](https://code.claude.com/docs/ja/ultrareview.md#trust-the-folder-before-the-review-runs)。
3276* 自分のマシンでは、そのフォルダで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再度実行します3290* 自分のマシンでは、そのフォルダーで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します
3277 3291
3278`claude ultrareview` からの次の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します：3292`claude ultrareview` からの以下の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します:
3279 3293
3280* **`Error: Workspace not trusted. This terminal ...`**：ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告を表示しきれません。ターミナルを大きくするか、サイズを報告するターミナルを使用してから、`claude ultrareview` を再度実行します。ホームディレクトリ以外では、そのフォルダで一度 `claude` を実行して信頼ダイアログを承認しておくこともでき、以降のそこでの実行では質問されなくなります。3294* **`Error: Workspace not trusted. This terminal ...`**: ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告を表示しきれません。ターミナルを拡大するか、サイズを報告するターミナルを使用してから、`claude ultrareview` を再実行します。ホームディレクトリ以外では、そのフォルダーで一度 `claude` を実行して信頼ダイアログを承認しておくと、以降の実行では尋ねられなくなります。
3281* **`Error: Workspace not trusted. <folder> is your home directory`**：ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりにプロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。3295* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりに、プロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。
3282* **`No answer in time.` の後に `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` の質問に 5 分間回答がありませんでした。`claude ultrareview` を再度実行して回答します。3296* **`No answer in time.` に続いて `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` の質問に 5 分間回答がありませんでした。`claude ultrareview` を再実行して回答してください。
3283* **`Ultrareview did not start: <folder> is not trusted`**：`n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再度実行して `y` と答えます。3297* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。
3284* **``Ultrareview did not start: `--trust-workspace` takes no value``**：PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダを信頼しない場合は、フラグを外します。この実行に限り信頼するには、PR 番号またはベースブランチをフラグの前に置きます：`claude ultrareview 1234 --trust-workspace`。3298* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダーを信頼しない場合は、フラグを省略します。この実行に限り信頼する場合は、PR 番号またはベースブランチをフラグの前に置きます: `claude ultrareview 1234 --trust-workspace`。
3285 3299
3286v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。3300v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。
3287 3301
3288### Remote Control が開始するセッションに引き継がれない3302### Not carried over to the sessions Remote Control starts
3289 3303
3290`remote-control` 動詞の前に、Remote Control が開始するセッションを制限または設定するグローバルな `claude` フラグ（`--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools`、`--mcp-config` など）を付けて [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を開始しました。動詞の前に置いたフラグは、これらのセッションには決して届きません。Claude Code は代わりに、フラグを示して開始を拒否します：3304`remote-control` 動詞の前にグローバルな `claude` フラグを置いて [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を開始しました。そのフラグは、`--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools`、`--mcp-config` など、Remote Control が開始するセッションを制限または設定するものです。動詞の前に置いたフラグは、それらのセッションには届きません。Claude Code は代わりに、そのフラグ名を示して開始を拒否します:
3291 3305
3292```text theme={null}3306```text theme={null}
3293Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3307Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).
3294```3308```
3295 3309
3296Claude Code は、`--verbose`、`--model`、またはラッパーが挿入した `--session-id` や `--plugin-dir` など、除外しても問題のないグローバルフラグは拒否しません。それらは無視され、Remote Control が開始されます。3310`--verbose`、`--model`、またはラッパーによって挿入される `--session-id` や `--plugin-dir` など、削除しても問題のないグローバルフラグについては、Claude Code は拒否しません。それらを無視して Remote Control を開始します。
3297 3311
3298Claude Code は、まだ無害と認識していないグローバルフラグに対しても開始を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。3312Claude Code は、まだ無害と認識していないグローバルフラグに対しても開始を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。
3299 3313
3300**対処方法：**3314**対処方法:**
3301 3315
3302* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でそれらが一覧表示されます3316* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でそれらの一覧を確認できます
3303* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します3317* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します
3304 3318
3305v2.1.248 より前は、グローバルフラグが先にある場合、`claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。3319v2.1.248 より前は、グローバルフラグが先にある場合、`claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。
3306 3320
3307### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3321### `--sandbox` or `--no-sandbox` is not supported by claude remote-control
3308 3322
3309このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを開始するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しており、`claude remote-control` がどちらのフラグも受け付けないことを意味します。サーバーは開始せずに終了コード 1 で終了します：3323このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを開始するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しているものの、`claude remote-control` がどちらのフラグも受け付けないことを意味します。サーバーは開始せずに終了コード 1 で終了します:
3310 3324
3311```text theme={null}3325```text theme={null}
3312Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings.3326Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings.
3313Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.3327Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.
3314```3328```
3315 3329
3316**対処方法：**3330**対処方法:**
3317 3331
3318* サーバーを開始するスクリプトやサービス定義を含め、コマンドからフラグを削除してから、再度実行します3332* サーバーを自動的に開始するスクリプトやサービス定義も含め、コマンドからフラグを削除してから再実行します
3319* サーバーが開始するセッションをサンドボックス化するには、[設定ファイル](https://code.claude.com/docs/ja/settings.md#where-settings-live)で [`sandbox.enabled`](https://code.claude.com/docs/ja/settings-reference#sandbox-enabled) を `true` に設定して[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)をオンにします3333* サーバーが開始するセッションをサンドボックス化するには、[設定ファイル](https://code.claude.com/docs/ja/settings.md#where-settings-live)で [`sandbox.enabled`](https://code.claude.com/docs/ja/settings-reference#sandbox-enabled) を `true` に設定して[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)をオンにします
3320 3334
3321両方のフラグは v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだ含まれている場合があります。3335両方のフラグは v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだいずれかが含まれている可能性があります。
3322 3336
3323### claude import is not yet available in this build3337### claude import is not yet available in this build
3324 3338
3325[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。3339[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code がインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。
3326 3340
3327```text theme={null}3341```text theme={null}
3328`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3342`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3329```3343```
3330 3344
3331Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです：3345Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです:
3332 3346
3333* インストール後にまだセッションを開始していないため、Claude Code がまだフラグを取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。3347* インストール後にセッションを開始していないため、Claude Code がまだフラグを取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。
3334* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude アプリゲートウェイ](https://code.claude.com/docs/ja/claude-apps-gateway#availability-and-limitations)経由で Claude Code を使用しています。これらのセッションでは Claude Code は機能フラグを取得しないため、`claude import` は利用できないままです。3348* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway#availability-and-limitations) を通じて Claude Code を使用しています。これらのセッションでは Claude Code は機能フラグを取得しないため、`claude import` は利用できないままです。
3335* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しています。これらは機能フラグの取得をオフにするため、`claude import` は利用できないままです。3349* 機能フラグの取得をオフにする `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しているため、`claude import` は利用できないままです。
3336 3350
3337**対処方法：**3351**対処方法:**
3338 3352
3339* 新規インストールの場合は、`claude` を開始してセッションの読み込みを待ち、終了してから `claude import` を再度実行します3353* 新規インストールの場合は、`claude` を起動し、セッションが読み込まれるのを待ってから終了し、`claude import` を再実行します
3340* 機能フラグの取得がオフのままの場合は、設定を自分で構成します。[`claude mcp add`](https://code.claude.com/docs/ja/mcp#installing-mcp-servers) で MCP サーバーを追加し、引き継ぎたい [`CLAUDE.md` ファイル](https://code.claude.com/docs/ja/memory#how-claude-md-files-load)、[スキルとコマンド](https://code.claude.com/docs/ja/skills.md#where-skills-live)、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を作成します。メッセージには `~/.claude/settings.json` も示されています。`claude import` が引き継ぐ設定のうち、このファイルが保持するのは[権限モード](https://code.claude.com/docs/ja/settings-reference.md#permission-settings)のみで、Claude Code はこのファイルから MCP サーバーを読み込みません。3354* 機能フラグの取得がオフのままの環境では、設定を自分で行います。[`claude mcp add`](https://code.claude.com/docs/ja/mcp#installing-mcp-servers) で MCP サーバーを追加し、引き継ぎたい [`CLAUDE.md` ファイル](https://code.claude.com/docs/ja/memory#how-claude-md-files-load)、[スキルとコマンド](https://code.claude.com/docs/ja/skills.md#where-skills-live)、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を作成します。メッセージには `~/.claude/settings.json` も示されています。`claude import` が引き継ぐ設定のうち、このファイルが保持するのは[権限モード](https://code.claude.com/docs/ja/settings-reference.md#permission-settings)のみです。Claude Code はこのファイルから MCP サーバーを読み取りません。
3341 3355
3342### Could not read Claude Code config3356### Could not read Claude Code config
3343 3357
3344Claude Code が `~/.claude.json`（アカウントの詳細とプロジェクトごとの状態を保存するファイル）を解析できない状態で [`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否をチェックするためにこのファイルを読み込みますが、対話セッションが表示する復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルが読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログがファイルを処理していました。3358アカウントの詳細とプロジェクトごとの状態を保存するファイルである `~/.claude.json` を Claude Code が解析できない状態で、[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否をチェックするためにこのファイルを読み取りますが、対話セッションが表示する復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルが読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログがファイルを処理していました。
3345 3359
3346```text theme={null}3360```text theme={null}
3347Could not read Claude Code config — run `claude` with no arguments to recover it.3361Could not read Claude Code config — run `claude` with no arguments to recover it.
3348```3362```
3349 3363
3350**対処方法：**3364**対処方法:**
3351 3365
3352* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出し、リセットを提案します。その後、`claude import` を再度実行します。3366* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出してリセットを提案します。その後、`claude import` を再実行します。
3353* 手動で加えた編集を残したい場合は、代わりにエディターで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します3367* 手動で行った編集を残すには、代わりにエディタで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します
3354 3368
3355### Claude Desktop からサーバーをインポートできなかった3369### Could not import a server from Claude Desktop
3356 3370
3357Claude Code は、`claude mcp add-from-claude-desktop` で選択したサーバーのうち 1 つを追加できませんでした。コマンドは選択された他のサーバーのインポートを続行し、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。3371Claude Code は、`claude mcp add-from-claude-desktop` で選択したサーバーのうち 1 つを追加できませんでした。コマンドは選択された他のサーバーのインポートを続行し、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。
3358 3372
3360Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3374Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3361```3375```
3362 3376
3363サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではサーバー名にスペースやピリオドなどの文字を使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由には、検証に失敗したサーバー設定や、組織の [MCP ポリシー](https://code.claude.com/docs/ja/managed-mcp.md)によってブロックされたサーバーなどがあります。3377サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではスペースやピリオドなどの文字をサーバー名に使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由には、検証に失敗したサーバー設定や、組織の [MCP ポリシー](https://code.claude.com/docs/ja/managed-mcp.md)によってブロックされたサーバーがあります。
3364 3378
3365**対処方法：**3379**対処方法:**
3366 3380
3367* `claude_desktop_config.json` 内のサーバー名を英字、数字、ハイフン、アンダースコアのみを使用するように変更してから、`claude mcp add-from-claude-desktop` を再度実行します3381* `claude_desktop_config.json` でサーバー名を英字、数字、ハイフン、アンダースコアのみを使用する名前に変更してから、`claude mcp add-from-claude-desktop` を再実行します
3368* `claude mcp add` または `claude mcp add-json` を使用して、有効な名前でそのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](https://code.claude.com/docs/ja/mcp.md#import-mcp-servers-from-claude-desktop)を参照してください。3382* `claude mcp add` または `claude mcp add-json` を使用して、有効な名前でそのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](https://code.claude.com/docs/ja/mcp.md#import-mcp-servers-from-claude-desktop)を参照してください。
3369 3383
3370### managed スコープに MCP サーバーを追加できない3384### Cannot add MCP server to the managed scope
3371 3385
3372`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープは、組織が [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーを保持します。Claude Code はこれらを管理設定からのみ読み込むため、コマンドはこのスコープにサーバーを書き込めません。3386`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープは、組織が [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーを保持します。Claude Code はそれらを管理設定からのみ読み取るため、コマンドはこのスコープにサーバーを書き込めません。
3373 3387
3374```text theme={null}3388```text theme={null}
3375Cannot add MCP server to scope: managed3389Cannot add MCP server to scope: managed
3376```3390```
3377 3391
3378**対処方法：**3392**対処方法:**
3379 3393
3380* 書き込み可能なスコープ（`local`、`user`、`project`）にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を参照してください3394* 書き込み可能なスコープ（`local`、`user`、または `project`）にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を参照してください
3381* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) にサーバーを追加します3395* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) にサーバーを追加します
3382 3396
3383### 管理設定がプラグインのサーバーのみを許可している場合に MCP サーバーを追加できない3397### 管理設定でプラグインのサーバーのみが許可されている場合に MCP サーバーを追加できない
3384 3398
3385組織の管理設定で [`strictPluginOnlyCustomization`](https://code.claude.com/docs/ja/settings-reference#strictpluginonlycustomization) が `true` または `mcp` を含むリストに設定されている状態で、`claude mcp add` または `claude mcp add-json` を実行しました。この設定では、Claude Code は `~/.claude.json` や `.mcp.json` から MCP サーバーを読み込まないため、コマンドは決して読み込まれないサーバーを保存する代わりに、終了コード 1 で終了します：3399組織の管理設定で [`strictPluginOnlyCustomization`](https://code.claude.com/docs/ja/settings-reference#strictpluginonlycustomization) が `true` または `mcp` を含むリストに設定されている状態で、`claude mcp add` または `claude mcp add-json` を実行しました。この設定では、Claude Code は `~/.claude.json` や `.mcp.json` から MCP サーバーを読み込まないため、コマンドは読み込まれることのないサーバーを保存するのではなく、終了コード 1 で終了します:
3386 3400
3387```text theme={null}3401```text theme={null}
3388Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.3402Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.
3389```3403```
3390 3404
3391`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、このメッセージを理由として示します。[`/import`](https://code.claude.com/docs/ja/commands#all-commands) は、追加しようとした各 MCP サーバーについてこのメッセージを報告し、検出した他の項目のインポートは続行します。3405`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、理由としてこのメッセージを示します。[`/import`](https://code.claude.com/docs/ja/commands#all-commands) は追加しようとした各 MCP サーバーについてこのメッセージを報告し、検出した他の項目のインポートは続行します。
3392 3406
3393v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーは決して読み込まれませんでした。3407v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーが読み込まれることはありませんでした。
3394 3408
3395**対処方法：**3409**対処方法:**
3396 3410
3397* サーバーを提供する[プラグイン](https://code.claude.com/docs/ja/plugins/install.md)をインストールします3411* サーバーを提供する[プラグイン](https://code.claude.com/docs/ja/plugins/install.md)をインストールします
3398* 管理者に、サーバーを[プラグイン](https://code.claude.com/docs/ja/plugins/org.md)で配布するか、リモートの HTTP または SSE サーバーであれば [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) を通じて提供するよう依頼します3412* 管理者に依頼して、サーバーを[プラグイン](https://code.claude.com/docs/ja/plugins/org.md)で配布してもらうか、リモートの HTTP または SSE サーバーであれば [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) を通じて提供してもらいます
3399 3413
3400### Can't read .mcp.json3414### Can't read .mcp.json
3401 3415
3402プロジェクトの [`.mcp.json`](https://code.claude.com/docs/ja/mcp#project-scope) を読み込むコマンド（`--scope project` を指定した `claude mcp add` や `claude mcp add-json`、または `claude mcp remove` など）が、現在のディレクトリにあるファイルが通常のファイルではないか、2 MiB を超えていることを検出したため、ファイルを読み込まずにこのエラーで終了します。3416`--scope project` を指定した `claude mcp add` や `claude mcp add-json`、または `claude mcp remove` など、プロジェクトの [`.mcp.json`](https://code.claude.com/docs/ja/mcp#project-scope) を読み取るコマンドが、現在のディレクトリにあるそのファイルが通常のファイルではないか 2 MiB を超えていることを検出したため、ファイルを読み取らずにこのエラーで終了します。
3403 3417
3404```text theme={null}3418```text theme={null}
3405Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3419Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
3406```3420```
3407 3421
3408v2.1.257 より前は、`.mcp.json` にある FIFO によってコマンドが何も出力せずに永久に待機し、`/dev/zero` のようなデバイスファイルへのシンボリックリンクによってプロセスが強制終了されるまでメモリが増加していました。3422v2.1.257 より前は、`.mcp.json` が FIFO の場合はコマンドが出力なしで無期限に待機し、`/dev/zero` などのデバイスファイルへのシンボリックリンクの場合はプロセスが強制終了されるまでメモリが増加していました。
3409 3423
3410**対処方法：**3424**対処方法:**
3411 3425
3412* 現在のディレクトリの `.mcp.json` に何があるかを確認します。それを[プロジェクトスコープの形式](https://code.claude.com/docs/ja/mcp.md#project-scope)の通常の JSON ファイルに置き換えるか削除してから、コマンドを再度実行します。3426* 現在のディレクトリの `.mcp.json` に何があるかを確認します。[プロジェクトスコープの形式](https://code.claude.com/docs/ja/mcp.md#project-scope)の通常の JSON ファイルに置き換えるか、削除してから、コマンドを再実行します。
3413 3427
3414### MCP サーバーが保存または削除されなかった3428### MCP サーバーが保存または削除されなかった
3415 3429
3416`user` または `local` [スコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しました。どちらのスコープも `~/.claude.json` に保存されますが、書き込み後に Claude Code が読み返したとき、その変更がファイルにありませんでした。コマンドは成功の行の代わりにこのエラーで終了します。3430`user` または `local` [スコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しました。どちらのスコープも `~/.claude.json` に保存されますが、書き込み後に Claude Code がファイルを読み戻したところ、変更がそのファイルに反映されていませんでした。コマンドは成功の行の代わりにこのエラーで終了します。
3417 3431
3418```text theme={null}3432```text theme={null}
3419MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3433MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.
3420```3434```
3421 3435
3422削除の後では、メッセージは `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合、パスの後に、エントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` として続きます。3436削除の後では、メッセージは `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合は、パスの後にエントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` として示されます。
3423 3437
3424v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。3438v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。
3425 3439
3426**対処方法：**3440**対処方法:**
3427 3441
3428* メッセージが示すファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除のコマンドを再度実行します。3442* メッセージに示されたファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除のコマンドを再実行します。
3429 3443
3430### MCP サーバーが保存または削除されなかった可能性がある3444### MCP サーバーが保存または削除されていない可能性がある
3431 3445
3432`user` または `local` [スコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しましたが、Claude Code は変更を確認するために `~/.claude.json` を読み返すことができませんでした。変更はディスクに反映されている場合も、されていない場合もあります。括弧内のテキストは、その読み込みのエラーです。3446`user` または `local` [スコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)のサーバーに対して `claude mcp add`、`claude mcp add-json`、または `claude mcp remove` を実行しましたが、Claude Code は変更を確認するために `~/.claude.json` を読み戻すことができませんでした。変更がディスクに反映されているかどうかはわかりません。括弧内のテキストは、その読み取りのエラーです。
3433 3447
3434```text theme={null}3448```text theme={null}
3435MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3449MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
3437 3451
3438削除の後では、メッセージは `may not have been removed` となり、`then remove the server again if it is still listed` で終わります。3452削除の後では、メッセージは `may not have been removed` となり、`then remove the server again if it is still listed` で終わります。
3439 3453
3440v2.1.283 より前は、変更を確認できなかった場合でも、コマンドは成功を報告していました。3454v2.1.283 より前は、変更を確認できなかった場合でも、これらのコマンドは成功を報告していました。
3441 3455
3442**対処方法：**3456**対処方法:**
3443 3457
3444* `claude mcp get <name>` を実行して、変更がディスクに反映されているかどうかを確認します。`local` スコープのサーバーの場合、local スコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。3458* `claude mcp get <name>` を実行して、変更がディスクに反映されているかを確認します。`local` スコープのサーバーの場合、ローカルスコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。
3445* 追加の後でサーバーが見つからない場合、または削除の後でもまだ一覧に表示される場合は、同じ追加または削除のコマンドを再度実行します。3459* 追加後にサーバーが見つからない場合、または削除後もまだ一覧に表示される場合は、同じ追加または削除のコマンドを再実行します。
3446 3460
3447### サーバーが Anthropic ホストでローカル OAuth に対応していない3461### Server is Anthropic-hosted and doesn't support local OAuth
3448 3462
3449URL が、サードパーティの ID プロバイダーを通じて認証する Anthropic ホストのコネクタのホストを指している MCP サーバーに対して、サインインを開始しました。これらのホストには、`microsoft365.mcp.claude.com`、`gmail.mcp.claude.com`、`gcal.mcp.claude.com` などがあります。[これらのサインインは claude.ai 経由でのみ機能する](https://code.claude.com/docs/ja/mcp.md#use-mcp-servers-from-claude-ai)ため、Claude Code は `/mcp` パネルと `claude mcp login` のどちらからも、これらのホストに対するローカル OAuth フローの開始を拒否します。3463URL がサードパーティのアイデンティティプロバイダーを通じて認証する Anthropic ホストのコネクタホストを指す MCP サーバーに対して、サインインを開始しました。これらのホストには `microsoft365.mcp.claude.com`、`gmail.mcp.claude.com`、`gcal.mcp.claude.com` が含まれます。[これらのサインインは claude.ai を通じてのみ機能する](https://code.claude.com/docs/ja/mcp.md#use-mcp-servers-from-claude-ai)ため、Claude Code は `/mcp` パネルと `claude mcp login` のどちらからも、これらのホストに対するローカルの OAuth フローの開始を拒否します。
3450 3464
3451```text theme={null}3465```text theme={null}
3452"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3466"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
3453```3467```
3454 3468
3455**対処方法：**3469**対処方法:**
3456 3470
3457* 同じ URL の claude.ai コネクタを隠してしまわないように、`claude mcp remove <name>` で自分のエントリを削除します3471* 同じ URL の claude.ai コネクタを隠してしまわないよう、`claude mcp remove <name>` で自分のエントリを削除します
3458* 削除後、Claude Code で使用しているアカウントにサインインした状態で、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) でサービスを接続します。接続後、アクティブな認証方法が claude.ai のサブスクリプションログインであれば、[コネクタは Claude Code に自動的に表示されます](https://code.claude.com/docs/ja/mcp.md#use-mcp-servers-from-claude-ai)3472* 削除後、Claude Code で使用しているアカウントにサインインした状態で、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) でサービスを接続します。接続すると、アクティブな認証方法が claude.ai のサブスクリプションログインであれば、[コネクタが Claude Code に自動的に表示されます](https://code.claude.com/docs/ja/mcp.md#use-mcp-servers-from-claude-ai)
3459 3473
3460### Server rejected the Authorization header minted by the configured headersHelper3474### Server rejected the Authorization header minted by the configured headersHelper
3461 3475
3462[`headersHelper`](https://code.claude.com/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) が `Authorization` ヘッダーを提供する MCP サーバーが、接続に HTTP 401 または 403 で応答したため、Claude Code は接続を失敗として報告します。ヘルパーが `Authorization` ヘッダーを提供するため、Claude Code はそのサーバーについて [OAuth にフォールバックしません](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers)：3476[`headersHelper`](https://code.claude.com/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) が `Authorization` ヘッダーを提供する MCP サーバーが、接続に対して HTTP 401 または 403 を返したため、Claude Code は接続を失敗として報告します。ヘルパーが `Authorization` ヘッダーを提供するため、Claude Code はそのサーバーに対して [OAuth にフォールバックしません](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers):
3463 3477
3464```text theme={null}3478```text theme={null}
3465Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3479Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
3466```3480```
3467 3481
3468Claude Code は接続を試みるたびにヘルパーを再実行するため、トークンローテーションの競合などの一時的な拒否の後の再試行では、新しい認証情報で成功する可能性があります。3482Claude Code は接続試行のたびにヘルパーを再実行するため、トークンのローテーションの競合など一時的な拒否の後の再試行では、新しい認証情報で成功する可能性があります。
3469 3483
3470**対処方法：**3484**対処方法:**
3471 3485
3472* Claude Code が実行するのと同じ方法で、`headersHelper` コマンドを自分で実行します。つまり、[Claude Code が実行するディレクトリ](https://code.claude.com/docs/ja/mcp.md#where-the-helper-runs)から、[Claude Code が設定する環境変数](https://code.claude.com/docs/ja/mcp.md#use-dynamic-headers-for-custom-authentication)を付けて、プロジェクトの `.mcp.json`、プラグイン、またはプロジェクトのエージェントファイルのサーバーの場合は [Claude Code が削除する認証情報の変数](https://code.claude.com/docs/ja/mcp.md#which-variables-a-helper-can-read)なしで実行します。サーバーのエンドポイントが受け付ける `Authorization` の値が出力されることを確認します3486* Claude Code が実行するのと同じ方法で `headersHelper` コマンドを自分で実行します。つまり、[Claude Code がヘルパーを実行するディレクトリ](https://code.claude.com/docs/ja/mcp.md#where-the-helper-runs)から、[Claude Code がヘルパーに設定する環境変数](https://code.claude.com/docs/ja/mcp.md#use-dynamic-headers-for-custom-authentication)を設定し、プロジェクトの `.mcp.json`、プラグイン、またはプロジェクトのエージェントファイルからのサーバーの場合は [Claude Code が削除する認証情報の変数](https://code.claude.com/docs/ja/mcp.md#which-variables-a-helper-can-read)なしで実行します。サーバーのエンドポイントが受け付ける `Authorization` の値が出力されることを確認します
3473* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択し、**Reconnect** を選択します3487* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択して **Reconnect** を選びます
3474 3488
3475v2.1.248 より前は、Claude Code はヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。3489v2.1.248 より前は、ヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても、Claude Code は OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。
3476 3490
3477### MCP サーバーが elicitation 機能を拒否した3491### MCP サーバーが elicitation 機能を拒否した
3478 3492
3479Java MCP SDK 0.11.0 から 0.17.0 で構築された MCP サーバーが接続を拒否しました。これらの SDK バージョンは、Claude Code がハンドシェイクで宣言する `form` と `url` の [elicitation モード](https://code.claude.com/docs/ja/mcp.md#elicitation-modes-claude-code-declares)を解析できません。`claude mcp list` は、サーバー自身のエラーの代わりにこのメッセージとともに、サーバーを失敗として表示します：3493Java MCP SDK 0.11.0 から 0.17.0 で構築された MCP サーバーが接続を拒否しました。これらの SDK バージョンは、Claude Code がハンドシェイクで宣言する `form` と `url` の [elicitation モード](https://code.claude.com/docs/ja/mcp.md#elicitation-modes-claude-code-declares)を解析できません。メッセージは次のとおりです:
3480 3494
3481```text theme={null}3495```text theme={null}
3482This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability. Set "bareElicitationCapability": true for it, or upgrade to Java MCP SDK 0.17.1+ (Spring AI 1.0.7+ or 1.1.6+).3496This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability. Set "bareElicitationCapability": true for it, or upgrade to Java MCP SDK 0.17.1+ (Spring AI 1.0.7+ or 1.1.6+).
3483```3497```
3484 3498
3485**対処方法：**3499**対処方法:**
3486 3500
3487* サーバーを Java MCP SDK 0.17.1 以降、またはメッセージが示す Spring AI のリリースのいずれかにアップグレードします3501* サーバーを Java MCP SDK 0.17.1 以降、またはメッセージに示された Spring AI のリリースのいずれかにアップグレードします
3488* または、MCP 設定のそのサーバーのエントリに `"bareElicitationCapability": true` を追加してから、Claude Code を再起動します。このフィールドは stdio、`sse`、`http`、`ws` のエントリで受け付けられ、Claude Code v2.1.281 以降が必要です3502* または、MCP 設定のそのサーバーのエントリに `"bareElicitationCapability": true` を追加してから、Claude Code を再起動します。このフィールドは stdio、`sse`、`http`、`ws` のエントリで受け付けられ、Claude Code v2.1.281 以降が必要です
3489 3503
3490次の `.mcp.json` エントリは、1 つの HTTP サーバーに対してこのフィールドを設定します：3504次の `.mcp.json` エントリは、1 つの HTTP サーバーに対してこのフィールドを設定します:
3491 3505
3492```json theme={null}3506```json theme={null}
3493{3507{
3501}3515}
3502```3516```
3503 3517
3504再起動後、`/mcp` はサーバーを接続済みとして表示します。Claude Code はそのサーバーに対してのみ form モードを宣言するため、サーバーをアップグレードしたらフィールドを削除してください。3518再起動後、`/mcp` にはサーバーが接続済みとして表示されます。Claude Code はそのサーバーに対してのみ form モードを宣言するため、サーバーをアップグレードしたらこのフィールドを削除してください。
3505 3519
3506サーバーが、`Unrecognized field "form"` を含むものなど、独自のエラーテキストで失敗することもあります。同じ修正が適用されます。3520サーバーが、`Unrecognized field "form"` を含むものなど、独自のエラーテキストで失敗することもあります。同じ修正方法が適用されます。
3507 3521
3508### MCP 権限プロンプトツールが見つからない3522### MCP permission prompt tool not found
3509 3523
3510[`--permission-prompt-tool`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したツールが、実行で最初に権限の判断が必要になった時点で、接続済みの MCP ツールの中にありませんでした。その原因は、サーバーが接続されなかったか、接続済みのサーバーがその名前のツールを公開していないかのいずれかです。Claude Code はそれでもプロンプトを送信します。[非対話](https://code.claude.com/docs/ja/headless.md)の実行は最初のツール呼び出しでこのエラーと終了コード 1 で終了するため、リクエストは行われても回答は生成されません。最初のプロンプトの前に、Claude Code はそのサーバーが接続されるまで、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) で設定されるサーバーごとの接続タイムアウトである最大 30 秒待機します。v2.1.206 より前は、起動時にサーバーの接続完了を待たなかったため、起動が遅いだけの正常なサーバーでもこのエラーが発生していました。3524[`--permission-prompt-tool`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したツールが、実行で最初に権限の判断が必要になった時点で、接続済みの MCP ツールの中にありませんでした。その原因は、サーバーが接続されなかったか、接続済みのサーバーがその名前のツールを公開していないかのいずれかです。Claude Code はそれでもプロンプトを送信します。[非対話](https://code.claude.com/docs/ja/headless.md)の実行は最初のツール呼び出しでこのエラーと終了コード 1 で終了するため、リクエストは行われたものの回答は生成されません。最初のプロンプトの前に、Claude Code は [`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) で設定されるサーバーごとの接続タイムアウト（30 秒）まで、そのサーバーの接続を待機します。v2.1.206 より前は、起動時にサーバーの接続完了を待機しなかったため、起動は遅いものの正常なサーバーでもこのエラーが発生していました。
3511 3525
3512```text theme={null}3526```text theme={null}
3513Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3527Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3515 3529
3516`Available MCP tools:` の後のリストには、接続されていた MCP ツールが示されます。3530`Available MCP tools:` の後のリストには、接続されていた MCP ツールが示されます。
3517 3531
3518**対処方法：**3532**対処方法:**
3519 3533
3520* サーバーが起動して接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして一覧に表示されることを確認します3534* サーバーが起動して接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして表示されることを確認します
3521* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致していることを確認します3535* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致していることを確認します
3522* サーバーの起動に 30 秒より長くかかる場合は、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) を増やします3536* サーバーの起動に 30 秒以上かかる場合は、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) を引き上げます
3523 3537
3524### OAuth callback port is already in use3538### OAuth callback port is already in use
3525 3539
3526OAuth でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためにローカルリスナーを開始します。そのリスナーが必要とするポートを別のプロセスが保持している場合、サインインはこのメッセージで失敗します。これは主に、[`MCP_OAUTH_CALLBACK_PORT`](https://code.claude.com/docs/ja/env-vars) 変数または `--callback-port` で設定した[固定のコールバックポート](https://code.claude.com/docs/ja/mcp.md#use-a-fixed-oauth-callback-port)で発生します。固定ポートがない場合、Claude Code は利用可能なポートを選択するためです。3540OAuth でリモートの MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを開始します。そのリスナーが必要とするポートを別のプロセスが保持している場合、サインインはこのメッセージで失敗します。これは主に、[`MCP_OAUTH_CALLBACK_PORT`](https://code.claude.com/docs/ja/env-vars) 変数または `--callback-port` で[固定のコールバックポート](https://code.claude.com/docs/ja/mcp.md#use-a-fixed-oauth-callback-port)を設定している場合に発生します。設定していない場合、Claude Code は利用可能なポートを選択するためです。
3527 3541
3528```text theme={null}3542```text theme={null}
3529OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3543OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3531 3545
3532Windows では、代わりに `netstat -ano | findstr :<port>` が提案されます。3546Windows では、代わりに `netstat -ano | findstr :<port>` が提案されます。
3533 3547
3534**対処方法：**3548**対処方法:**
3535 3549
3536* メッセージのコマンドを実行してポートを保持しているプロセスを見つけ、それを停止するか終了を待ちます3550* メッセージに示されたコマンドを実行してポートを保持しているプロセスを特定し、停止するか終了するまで待ちます
3537* 別のプログラムがそのポートを恒常的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方の `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します3551* 別のプログラムがそのポートを恒久的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方法に応じて `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します
3538* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します3552* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します
3539 3553
3540### No available ports for OAuth redirect3554### No available ports for OAuth redirect
3541 3555
3542[OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためにローカルリスナーを開始します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアやローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。3556[OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) でリモートの MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを開始します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアやローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。
3543 3557
3544```text theme={null}3558```text theme={null}
3545No available ports for OAuth redirect3559No available ports for OAuth redirect
3546```3560```
3547 3561
3548v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身で選択したポートをバインドできないだけの場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。3562v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身が選んだポートだけをバインドできない場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。
3549 3563
3550**対処方法：**3564**対処方法:**
3551 3565
3552* セキュリティソフトウェアやサンドボックスポリシーがプロセスによる `127.0.0.1` でのリッスンをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるように許可します3566* セキュリティソフトウェアやサンドボックスポリシーがプロセスの `127.0.0.1` でのリッスンをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるようにします
3553* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します3567* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します
3554 3568
3555### origin/HEAD がないと /security-review が失敗する3569### origin/HEAD がない場合に /security-review が失敗する
3556 3570
3557[`/security-review`](https://code.claude.com/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD`（`origin` リモートでどのブランチがデフォルトかを記録するローカル ref）との差分を取ることでレビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。3571[`/security-review`](https://code.claude.com/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD`（`origin` リモートでどのブランチがデフォルトかを記録するローカル ref）との差分を取ってレビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。
3558 3572
3559```text theme={null}3573```text theme={null}
3560Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3574Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3563'git <command> [<revision>...] -- [<file>...]'3577'git <command> [<revision>...] -- [<file>...]'
3564```3578```
3565 3579
3566メッセージには、代わりに `git log` や別の `git diff` が引用されている場合があります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、かつ fetch の refspec がそれをカバーしている場合のみです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次の構成では ref が存在しません：3580メッセージには、代わりに `git log` や別の `git diff` が引用されることもあります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、フェッチの refspec がそれを含む場合のみです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次の構成では ref が存在しません:
3567 3581
3568* refspec の fetch 範囲が狭すぎる、シングルブランチまたは CI のチェックアウト3582* 狭すぎる refspec をフェッチする、単一ブランチまたは CI のチェックアウト
3569* サーバー側の HEAD が誰もプッシュしていないブランチを指しているリモート3583* サーバー側の HEAD が誰もプッシュしていないブランチを指しているリモート
3570* `origin` リモートがない、または一度も fetch していないリポジトリ3584* `origin` リモートがないリポジトリ、または一度もフェッチしていないリポジトリ
3571 3585
3572Claude Code は、[動的コンテキストを挿入する](https://code.claude.com/docs/ja/skills.md#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。3586Claude Code は、[動的コンテキストを挿入する](https://code.claude.com/docs/ja/skills.md#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。
3573 3587
3574関連する次のメッセージは、コマンドが実行される前に発生します：3588関連するメッセージは、コマンドが実行される前に発生します:
3575 3589
3576* `Shell command permission check failed for pattern "..."`：コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)で、各権限モードでどの結果が中止されるか、および `allowed-tools` でコマンドを事前承認する方法を説明しています3590* `Shell command permission check failed for pattern "..."`: コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止を引き起こすか、および `allowed-tools` でコマンドを事前承認する方法を説明しています
3577* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：スキルのフロントマターが、bash のないマシンで bash を要求しています。Git for Windows をインストールするか、フロントマターを `shell: powershell` に変更します。[挿入されたコマンドの実行方法](https://code.claude.com/docs/ja/skills.md#how-injected-commands-run)を参照してください3591* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: スキルのフロントマターが、bash のないマシンで bash を要求しています。Git for Windows をインストールするか、フロントマターを `shell: powershell` に変更します。[挿入されたコマンドの実行方法](https://code.claude.com/docs/ja/skills.md#how-injected-commands-run)を参照してください
3578* `No shell command in <name> was run`：ファイル内の `!` コマンドのいずれかに、タブや改行以外の生の制御文字が含まれているため、どのコマンドも実行されません。[文字を見つけて削除する方法](#no-shell-command-was-run)を参照してください3592* `No shell command in <name> was run`: ファイルの `!` コマンドのいずれかに、タブや改行以外の生の制御文字が含まれているため、どのコマンドも実行されません。[文字を見つけて削除する方法](#no-shell-command-was-run)を参照してください
3579 3593
3580**対処方法：**3594**対処方法:**
3581 3595
3582* リモートのデフォルトブランチを指定して ref を作成します：`git remote set-head origin <default-branch>`。これは、ローカルの追跡 ref `origin/<default-branch>` が存在する場合に機能します。シングルブランチのクローンのように存在しない場合は、先にブランチを fetch します。`git remote set-branches --add origin <branch>` を実行し、続いて `git fetch origin` を実行してから、set-head コマンドを再実行します。その後、`/security-review` を再実行します。3596* リモートのデフォルトブランチを指定して ref を作成します: `git remote set-head origin <default-branch>`。これはローカルの追跡 ref `origin/<default-branch>` が存在すれば機能します。単一ブランチのクローンなどで存在しない場合は、先にブランチをフェッチします。`git remote set-branches --add origin <branch>`、続いて `git fetch origin` を実行してから、set-head コマンドを再実行します。その後、`/security-review` を再実行します。
3583* ブランチを指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これは、どのブランチがデフォルトかをリモートに問い合わせます。リモートが空である、または HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合はブランチを明示的に指定します。クローンがそのブランチを fetch しない場合は、`error: Not a valid ref` で失敗します。先に上記のように refspec を広げます。3597* ブランチ名を指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これはリモートにどのブランチがデフォルトかを問い合わせます。リモートが空である、または HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合はブランチを明示的に指定してください。クローンがそのブランチをフェッチしない場合は `error: Not a valid ref` で失敗します。先に上記のとおり refspec を広げてください。
3584* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、ref を作成する前に fetch します。リモートが空の場合は、先に `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。`origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで、`/security-review` には空の差分が表示されます。3598* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、ref を作成する前にフェッチします。リモートが空の場合は、先に `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。`origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで `/security-review` には空の差分が表示されます。
3585 3599
3586### スキルまたはコマンド内のシェルコマンドが実行されなかった3600### スキルまたはコマンド内のシェルコマンドが実行されなかった
3587 3601
3588スキルまたはカスタムコマンドのファイル内の `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)のいずれかに、タブや改行以外の生の制御文字が含まれています。Claude Code は、ファイル内のどのコマンドも実行する前に、呼び出し全体を拒否します。3602スキルまたはカスタムコマンドのファイル内にある `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)のいずれかに、タブや改行以外の生の制御文字が含まれています。Claude Code は、ファイルのどのコマンドも実行する前に、呼び出し全体を拒否します。
3589 3603
3590メッセージには、コマンドを実行するはずだったシェルツール（Bash または PowerShell）が示され、最後に拒否されたコマンドが表示されます。該当する各文字は、位置がわかるように `�` に置き換えられます：3604メッセージには、コマンドを実行するはずだったシェルツール（Bash または PowerShell）が示され、最後に拒否されたコマンドが表示されます。該当する各文字は `�` に置き換えられるため、その位置を確認できます:
3591 3605
3592```text theme={null}3606```text theme={null}
3593No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.3607No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.
3594build.sh --target�dist3608build.sh --target�dist
3595```3609```
3596 3610
3597**対処方法：**3611**対処方法:**
3598 3612
3599* メッセージの最後に引用されたコマンド内の各 `�` を見つけます。それが表す文字を、スキルまたはコマンドのファイル、あるいはファイルに代入される引数やオプションから削除します。3613* メッセージの最後に引用されたコマンド内の各 `�` を見つけます。それが表す文字を、スキルまたはコマンドのファイルから、あるいはファイルに代入される引数やオプションから削除します。
3600 3614
3601### Input must be provided when using `--print`3615### Input must be provided when using `--print`
3602 3616
3603引数なしの `claude` で対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、またはコンソールが本物のターミナルではない場合（PowerShell ISE や一部の IDE の出力ペインなど）、`claude` は代わりに[非対話](https://code.claude.com/docs/ja/headless.md)で実行されます。これは `claude -p` と同じモードであり、プロンプトが必要なため、フラグを渡していない場合でもメッセージには `--print` が示されます。プロンプトを指定せず stdin に何もパイプせずに `-p`/`--print` を渡した場合も、どこでも同じエラーが発生します。3617引数なしの `claude` が対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、または PowerShell ISE や一部の IDE の出力ペインのようにコンソールが実際のターミナルでない場合、`claude` は代わりに[非対話](https://code.claude.com/docs/ja/headless.md)で実行されます。これはプロンプトを必要とする `claude -p` と同じモードであるため、フラグを渡していなくてもメッセージには `--print` が示されます。プロンプトなしで、stdin にも何もパイプせずに `-p`/`--print` を渡した場合も、どこでも同じエラーが発生します。
3604 3618
3605```text theme={null}3619```text theme={null}
3606Error: Input must be provided either through stdin or as a prompt argument when using --print3620Error: Input must be provided either through stdin or as a prompt argument when using --print
3607```3621```
3608 3622
3609**対処方法：**3623**対処方法:**
3610 3624
3611* 対話的に使用するには、本物のターミナルで `claude` を実行します。ISE ではなく Windows Terminal または PowerShell コンソールを、出力ペインではなく IDE の統合ターミナルを使用します3625* 対話的に使用するには、実際のターミナルで `claude` を実行します。ISE ではなく Windows Terminal や PowerShell コンソール、出力ペインではなく IDE の統合ターミナルを使用します
3612* 1 回限りの使用では、プロンプトを渡すか（`claude -p "your question"`）、`echo "your question" | claude -p` のようにパイプします3626* 1 回限りの使用では、プロンプトを渡します: `claude -p "your question"`、またはパイプで `echo "your question" | claude -p` とします
3613 3627
3614### Claude Code can't read the keyboard here3628### Claude Code can't read the keyboard here
3615 3629
3616[`-p`](https://code.claude.com/docs/ja/headless) を付けずに `claude` を実行して[対話セッション](https://code.claude.com/docs/ja/interactive-mode.md)を開始しましたが、その標準入力がターミナルではありません。何かがそれをパイプまたはリダイレクトしたか、`claude` を起動したプログラムが独自の入力ストリームを提供しています。3630[対話セッション](https://code.claude.com/docs/ja/interactive-mode.md)を開始する [`-p`](https://code.claude.com/docs/ja/headless) なしで `claude` を実行しましたが、その標準入力がターミナルではありません。何かがパイプまたはリダイレクトしているか、`claude` を起動したプログラムが独自の入力ストリームを提供しています。
3617 3631
3618対話セッションではキー入力を読み取るためのターミナルが必要であり、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります：3632対話セッションにはキー入力を読み取るためのターミナルが必要です。ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります:
3619 3633
3620* **Windows**：Claude Code はインターフェースを開始せずに、メッセージを stderr に出力して終了コード 1 で終了します3634* **Windows**: Claude Code はインターフェースを開始せずに、メッセージを stderr に出力して終了コード 1 で終了します
3621* **macOS と Linux**：Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その 1 行目には Windows の文言の代わりに `/dev/tty` が示されます。3635* **macOS と Linux**: Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その 1 行目には Windows の文言の代わりに `/dev/tty` が示されます。
3622 3636
3623Windows では、メッセージは次のとおりです：3637Windows では、メッセージは次のようになります:
3624 3638
3625```text theme={null}3639```text theme={null}
3626Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.3640Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.
3628To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).3642To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).
3629```3643```
3630 3644
3631**対処方法：**3645**対処方法:**
3632 3646
3633* 対話的に作業するには、入力をパイプやリダイレクトせずに、ターミナルで直接 `claude` を実行します3647* 対話的に作業するには、入力をパイプまたはリダイレクトせずに、ターミナルで直接 `claude` を実行します
3634* スクリプトなどから対話インターフェースなしで返答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` と `--resume <session-id>` でも同様に機能します。3648* スクリプトからなど、対話インターフェースなしで回答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` と `--resume <session-id>` でも同様に機能します。
3635 3649
3636v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。3650v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。
3637 3651
3638代わりに `claude install` の実行中に `Raw mode is not supported` が表示される場合は、[インストール中の `Raw mode is not supported`](https://code.claude.com/docs/ja/troubleshoot-install#raw-mode-is-not-supported-during-install) を参照してください。3652`claude install` の実行中に `Raw mode is not supported` が表示された場合は、代わりに[インストール中の `Raw mode is not supported`](https://code.claude.com/docs/ja/troubleshoot-install#raw-mode-is-not-supported-during-install) を参照してください。
3639 3653
3640### Input contained only whitespace3654### Input contained only whitespace
3641 3655
3642[非対話モード](https://code.claude.com/docs/ja/headless.md)では、API は表示可能なテキストのないメッセージを拒否するため、Claude Code はスペース、タブ、改行のみで構成されたプロンプトを送信せずに拒否します。表示されるメッセージは、空白のプロンプトがどこから来たかによって異なります：3656[非対話モード](https://code.claude.com/docs/ja/headless.md)では、Claude Code はスペース、タブ、改行のみで構成されたプロンプトを送信せずに拒否します。API は表示可能なテキストのないメッセージを拒否するためです。表示されるメッセージは、空のプロンプトがどこから来たかによって異なります:
3643 3657
3644* **`claude -p` のプロンプト引数またはパイプされた stdin**：`claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します3658* **`claude -p` のプロンプト引数またはパイプされた stdin**: `claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します
3645* **実行中の `--input-format stream-json` または [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) セッションに送信されたメッセージ**：Claude Code はモデルを呼び出さずにターンを終了し、セッションは引き続き使用できます。拒否は、情報メッセージとして、またターンの結果テキストとして届きます：`Blank prompt — the message was only whitespace, so nothing was sent to the model.`3659* **実行中の `--input-format stream-json` または [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) セッションに送信されたメッセージ**: Claude Code はモデルを呼び出さずにターンを終了し、セッションは引き続き使用できます。拒否は情報メッセージとして、またターンの結果テキストとして届きます: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`
3646 3660
3647v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API は 400 エラーでリクエストを拒否していました。3661v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API はリクエストを 400 エラーで拒否していました。
3648 3662
3649**対処方法：**3663**対処方法:**
3650 3664
3651* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。3665* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。
3652 3666
3653### stream-json input carried over 256M characters with no newline3667### stream-json input carried over 256M characters with no newline
3654 3668
3655プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超える内容を stdin に送信したため、Claude Code はそれ以上の入力をバッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限を `256M` と表記しています。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。3669プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超える文字を stdin に送信したため、Claude Code はそれ以上の入力をバッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限が `256M` と表記されます。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。
3656 3670
3657```text theme={null}3671```text theme={null}
3658Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3672Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
3659```3673```
3660 3674
3661改行なしでこれほど長い入力がある場合、通常は、誤ってパイプされたバイナリファイルやプレーンなログ出力など、プロデューサーがそもそも stream-json のプロデューサーではないことを意味します。上限を超える単一のメッセージも、同じチェックで失敗します。3675改行なしでこれほど長い入力は、通常、送信元がそもそも stream-json の送信元ではないことを意味します。たとえば、誤ってパイプされたバイナリファイルやプレーンなログ出力などです。上限を超える単一のメッセージも同じチェックで失敗します。
3662 3676
3663**対処方法：**3677**対処方法:**
3664 3678
3665* stdin に何がパイプされているかを確認します。[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) では、すべてのメッセージが改行で終わる 1 行の JSON である必要があります3679* stdin にパイプされているものを確認します。[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) では、すべてのメッセージが改行で終わる 1 行の JSON である必要があります
3666* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を外します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み込みます3680* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を削除します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります
3667 3681
3668### Unknown command3682### Unknown command
3669 3683
3670対話型のターミナルセッションで、このセッション内のどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告します：3684対話的なターミナルセッションで、このセッションのどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告します:
3671 3685
3672```text theme={null}3686```text theme={null}
3673Unknown command: /hepl. Did you mean /help?3687Unknown command: /hepl. Did you mean /help?
3674```3688```
3675 3689
3676Claude Code は、このセッションでメニューに表示されるコマンド名またはエイリアスのうち、最も近いものを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです：3690Claude Code は、このセッションでメニューに表示される中から最も近いコマンド名またはエイリアスを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです:
3677 3691
3678* `/help` を `/hepl` とするなどの入力ミス。[コマンドメニューが入力内容と照合する仕組み](https://code.claude.com/docs/ja/commands.md#how-the-command-menu-matches-what-you-type)で、送信前に近い候補を選ぶ方法を説明しています3692* `/help` を `/hepl` と入力するなどの入力ミス。[コマンドメニューが入力内容と一致させる仕組み](https://code.claude.com/docs/ja/commands.md#how-the-command-menu-matches-what-you-type)では、送信前に近い候補を選ぶ方法を説明しています
3679* コマンドは存在するものの、プラットフォーム、プラン、認証方法などの要件を満たしていないため、このセッションでは利用できない。[`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command)、[`/schedule`](https://code.claude.com/docs/ja/routines#schedule-returns-unknown-command)、または [`/auto-mode-setup`](https://code.claude.com/docs/ja/auto-mode-config#auto-mode-setup-returns-unknown-command) の項目を参照してください。一部のコマンドは、組織のポリシーによって無効化されている場合、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) のように独自のメッセージで応答します3693* 存在するものの、プラットフォーム、プラン、認証方法などの要件が満たされていないためにこのセッションでは利用できないコマンド。[`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command)、[`/schedule`](https://code.claude.com/docs/ja/routines#schedule-returns-unknown-command)、または [`/auto-mode-setup`](https://code.claude.com/docs/ja/auto-mode-config#auto-mode-setup-returns-unknown-command) の項目を参照してください。一部のコマンドは、組織のポリシーで無効化されている場合、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) のように独自のメッセージで応答します
3680* このセッションでインストールまたは接続されていない[プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)や [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#use-mcp-prompts-as-commands)のコマンド3694* このセッションでインストールまたは接続されていない[プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)または [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#use-mcp-prompts-as-commands)のコマンド
3681 3695
3682Claude Code が一致しない `/` 名にこのように応答するのは、対話型のターミナルセッションのみです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったという注記と、そのセッションで Claude が実行できるコマンドの一覧を添えます。そのようなセッションには次のものがあります：3696Claude Code が一致しない `/` 名にこのように応答するのは、対話的なターミナルセッションの場合のみです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示す注記と、そのセッションで Claude が実行できるコマンドの一覧を添えます。これらのセッションには次のものが含まれます:
3683 3697
3684* `-p` の実行3698* `-p` の実行
3685* [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーション3699* [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーション
3687* [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)のチャットパネル3701* [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)のチャットパネル
3688* [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)と[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)3702* [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)と[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)
3689 3703
3690これらのセッションのいずれかで実行できない組み込みコマンドについては、Claude Code は Claude に送信せずに、そのコマンドは利用できないと応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのは、クラウドセッションとクラウドのスケジュールタスクのみでした。v2.1.273 より前は、これらも `Unknown command` と応答していました。3704これらのセッションのいずれかで実行できない組み込みコマンドについては、Claude Code はそれを Claude に送信せず、そのコマンドが利用できないことを応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとクラウドのスケジュールタスクのみでした。v2.1.273 より前は、それらも `Unknown command` を返していました。
3691 3705
3692Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合や、`/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。3706Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合、または `/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。
3693 3707
3694v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている間に `Enter` を押すと、Claude Code はその候補を実行していたため、`/hepl` のような入力ミスではこのメッセージが表示される代わりに `/help` が実行されていました。3708v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている状態で `Enter` を押すと、Claude Code はその候補を実行していました。そのため、`/hepl` などの入力ミスでは、このメッセージが表示される代わりに `/help` が実行されていました。
3695 3709
3696**対処方法：**3710**対処方法:**
3697 3711
3698* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで何が利用できるかを確認します3712* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで利用できるものを確認します
3699* ドキュメントに記載されたコマンドを Claude Code が不明と報告する場合は、[コマンドリファレンス](https://code.claude.com/docs/ja/commands.md)でそのコマンドの行を確認し、示されている要件を確認します3713* ドキュメントに記載されたコマンドを Claude Code が不明と報告する場合は、[コマンドリファレンス](https://code.claude.com/docs/ja/commands.md)でそのコマンドの行を確認し、記載されている要件を確認します
3700 3714
3701### Diff is too large for ultrareview3715### Diff is too large for ultrareview
3702 3716
3703ブランチとベースブランチの間の差分（コミットされていない変更とステージされた変更を含む）が [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のサイズ上限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。拒否されたレビューは無料実行回数を消費せず、使用クレジットも請求されません。メッセージには、適用されている上限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには差分の統計情報がそのまま表示されるだけでした。3717ブランチとベースブランチとの差分（コミットされていない変更やステージされた変更を含む）が [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のサイズ制限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。拒否されたレビューでは無料実行回数は消費されず、使用クレジットも請求されません。メッセージには、適用されている制限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには差分の生の統計のみが表示されていました。
3704 3718
3705```text theme={null}3719```text theme={null}
3706Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3720Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
3707```3721```
3708 3722
3709プルリクエストのレビューにも同じ上限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。3723プルリクエストのレビューにも同じ制限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。
3710 3724
3711**対処方法：**3725**対処方法：**
3712 3726
3713* `/code-review ultra develop` のように、作業内容により近いベースブランチを指定して、そのブランチに対する差分だけがレビュー対象になるようにします3727* `/code-review ultra develop` のように作業に近いベースブランチを渡し、そのブランチとの差分のみをレビュー対象にします
3714* 変更を小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数への寄与が最も大きいため、まずそれらを別のブランチに移してください。3728* 変更を小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルが変更行数の大部分を占めているため、まずそれらを別のブランチに移すことから始めてください。
3715 3729
3716### Could not find merge-base with the base branch3730### Could not find merge-base with the base branch
3717 3731
3718`/code-review ultra` と `claude ultrareview` サブコマンドは、ブランチとベースブランチの間の差分をレビューするため、両者が共有するコミットが必要です。`git merge-base` がそのようなコミットを見つけられない場合、Claude Code はクラウドセッションの開始前にレビューを拒否します。Claude Code が完全であることを確認できるクローンで、ブランチが 1 つ以上ある場合は、拒否する代わりに[追跡対象のすべてのファイルのレビュー](https://code.claude.com/docs/ja/ultrareview.md#diff-limits-and-fallbacks)にフォールバックします。この拒否が表示されるのは、ベースブランチがまったく見つからない場合、Claude Code がクローンの完全性を確認できない場合、または SHA-256 オブジェクト形式のようにツリー全体の差分を取得できないまれなリポジトリの場合です。3732`/code-review ultra` と `claude ultrareview` サブコマンドは、ブランチとベースブランチとの差分をレビューします。そのためには両者が共有するコミットが必要です。`git merge-base` で共有コミットが見つからない場合、Claude Code はクラウドセッションの開始前にレビューを拒否します。Claude Code が完全であることを確認でき、少なくとも 1 つのブランチを持つクローンでは、拒否する代わりに[すべての追跡対象ファイルのレビュー](https://code.claude.com/docs/ja/ultrareview.md#diff-limits-and-fallbacks)にフォールバックします。この拒否が表示されるのは、ベースブランチがまったく見つからない場合、Claude Code がクローンの完全性を確認できない場合、または SHA-256 オブジェクト形式など、ツリー全体の差分が作成できないまれなリポジトリの場合です。
3719 3733
3720```text theme={null}3734```text theme={null}
3721Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3735Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
3722```3736```
3723 3737
3724最初の文に続くヒントは、Claude Code が確認した状況によって異なります。3738最初の文に続くヒントは、Claude Code が検出した状況によって異なります。
3725 3739
3726* **ベースブランチを指定しなかった場合**：Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースブランチを明示的に指定するよう提案します3740* **ベースブランチを渡さなかった場合**：Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースを明示的に渡すよう提案します
3727* **クローンにすでに存在するベースブランチを指定した場合**：ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります3741* **クローン内にすでに存在するベースブランチを渡した場合**：ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります
3728* **クローンに存在しないベースブランチを指定した場合**：Claude Code は比較の前に origin からそのブランチを取得しました。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` となります。クローンがシャロークローンかどうかを Claude Code が判断できない場合は、代わりに `git fetch --unshallow origin` を提案します。v2.1.221 より前は、取得したすべてのベースブランチに対して `git fetch --unshallow origin` が提案され、完全なクローンではこのコマンドが `fatal: --unshallow on a complete repository does not make sense` で失敗していました。3742* **クローン内に存在しないベースブランチを渡した場合**：Claude Code は比較の前に origin からそのブランチをフェッチしています。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` となります。クローンがシャロークローンかどうかを Claude Code が判断できない場合は、代わりに `git fetch --unshallow origin` を提案します。v2.1.221 より前は、フェッチしたすべてのベースブランチについて `git fetch --unshallow origin` を提案していましたが、完全なクローンではこのコマンドは `fatal: --unshallow on a complete repository does not make sense` で失敗します。
3729 3743
3730**対処方法：**3744**対処方法：**
3731 3745
3732* 別のブランチが本来のベースである場合は、`/code-review ultra <branch>` で明示的に指定します3746* 別のブランチが実際のベースである場合は、`/code-review ultra <branch>` のように明示的に渡します
3733* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します3747* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します
3734 3748
3735### Your checkout has no branches3749### Your checkout has no branches
3736 3750
3737チェックアウトには、コミットがあってもブランチがない場合があります。`git init` の後に `git fetch <url>` と `git checkout FETCH_HEAD` を実行すると、ref のない detached HEAD になります。Claude Code は [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のためにリポジトリを git バンドルとしてパッケージ化してアップロードしますが、ブランチやその他の ref がないリポジトリはバンドルできないため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。3751チェックアウトにはコミットがあってもブランチがない場合があります。`git init` の後に `git fetch <url>` と `git checkout FETCH_HEAD` を実行すると、ref のない detached HEAD の状態になります。Claude Code は [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のためにリポジトリを git バンドルとしてパッケージ化してアップロードしますが、ブランチやその他の ref を持たないリポジトリはバンドルできないため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。
3738 3752
3739```text theme={null}3753```text theme={null}
3740Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3754Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
3741```3755```
3742 3756
3743v2.1.221 より前は、Claude Code はこのチェックアウトで追跡対象のすべてのファイルのレビューを試み、アップロードが失敗していました。3757v2.1.221 より前は、Claude Code はこのチェックアウト内のすべての追跡対象ファイルのレビューを試み、アップロードが失敗していました。
3744 3758
3745**対処方法：**3759**対処方法：**
3746 3760
3748 3762
3749### No GitHub account is connected to your Claude account3763### No GitHub account is connected to your Claude account
3750 3764
3751`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行すると、Claude Code はクラウドセッションを作成する前に、[Claude アカウントに接続された GitHub アカウント](https://code.claude.com/docs/ja/ultrareview.md#review-a-pull-request)が PR のリポジトリにアクセスできるかどうかをサーバーに問い合わせます。アカウントが接続されていないか接続の有効期限が切れているため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、Claude Code は無料実行回数を消費せず、使用クレジットも請求しません。3765`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行すると、Claude Code はクラウドセッションを作成する前に、[Claude アカウントに接続された GitHub アカウント](https://code.claude.com/docs/ja/ultrareview.md#review-a-pull-request)が PR のリポジトリにアクセスできるかをサーバーに確認します。アカウントが接続されていないか、接続の有効期限が切れているため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、Claude Code は無料実行回数を消費せず、使用クレジットも請求しません。
3752 3766
3753```text theme={null}3767```text theme={null}
3754Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3768Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
3775 3789
3776**対処方法：**3790**対処方法：**
3777 3791
3778* ローカルの `gh` CLI でリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します3792* ローカルの `gh` CLI がリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します
3779* 変更後にレビューを再実行します3793* 変更後にレビューを再実行します
3780 3794
3781v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。3795v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。
3782 3796
3783### The GitHub App preflight failed transiently3797### The GitHub App preflight failed transiently
3784 3798
3785ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しましたが、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、Claude Code はクラウドサービスが GitHub からリポジトリをクローンできるかどうかを確認しますが、その確認は明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消する可能性のあるエラーで終わりました。完全なメッセージは、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因で始まり、プリフライトに関する文で終わります。3799ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかを確認しましたが、その確認は明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消する可能性のあるエラーで終わりました。完全なメッセージは、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因で始まり、事前確認についての文で終わります。
3786 3800
3787```text theme={null}3801```text theme={null}
3788Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3802Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3790 3804
3791**対処方法：**3805**対処方法：**
3792 3806
3793* しばらく待ってからコマンドを再実行します。GitHub の確認が成功すると、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗によって起動が妨げられることはなくなります3807* 少し待ってからコマンドを再実行します。GitHub の確認が通れば、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗は起動の妨げにならなくなります
3794* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば、修正してローカルリポジトリからセッションを開始できるようにします3808* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が自分で修正できるものであれば修正し、ローカルリポジトリからセッションを開始できるようにします
3795 3809
3796v2.1.251 より前は、GitHub の確認が一時的に失敗しただけの場合でも、Claude Code はメッセージの末尾に `Please set up GitHub on https://claude.ai/code` を表示していましたが、セットアップの案内では一時的な失敗は解消できません。3810v2.1.251 より前は、GitHub の確認が一時的に失敗しただけの場合でも、Claude Code はメッセージを `Please set up GitHub on https://claude.ai/code` で終えていました。セットアップに関するアドバイスでは一時的な失敗は解消できません。
3797 3811
3798### リポジトリのアップロードが git 設定に対応できない3812### リポジトリのアップロードが git の設定に対応できない
3799 3813
3800[ローカルリポジトリをアップロードするクラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#send-local-repositories-without-github)、またはブランチの [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) を開始しましたが、ファイルに適用される属性ルールを決定する git 設定の 1 つにアップロードが対応できません。アップロードを続行してルールを見落とすと、clean フィルターで暗号化されるファイルのように git が保存前に変換するファイルが、ディスク上の状態のままクラウドに届く可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードされません。3814[ローカルリポジトリをアップロードするクラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#send-local-repositories-without-github)、またはブランチの [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) を開始しましたが、ファイルに適用される属性ルールを決定する git 設定のいずれかに、アップロードが対応できません。アップロードを続行してルールを見落とすと、clean フィルターで暗号化されるファイルなど、git が保存前に変換するファイルが、ディスク上の状態のままクラウドに届く可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードされません。
3801 3815
3802```text theme={null}3816```text theme={null}
3803Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.3817Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
3804```3818```
3805 3819
3806メッセージには設定項目とその設定場所が示され、該当するケースの修正方法で締めくくられます。`core.attributesFile` と `attr.tree` でも同じ拒否が発生し、それぞれに固有の修正方法が示されます。3820メッセージには設定名とその設定場所が示され、該当するケースの修正方法で終わります。`core.attributesFile` と `attr.tree` についても同じ拒否が表示され、それぞれに固有の修正方法が示されます。
3807 3821
3808メッセージには、git の設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが示されることがあります。これは、そのディレクティブの条件がこのリポジトリに該当しない場合でも同様です。3822メッセージには、git 設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが示される場合があります。これは、そのディレクティブの条件がこのリポジトリに当てはまらない場合でも同様です。
3809 3823
3810**対処方法：**3824**対処方法：**
3811 3825
3812* メッセージの最後の文に示された修正を適用します3826* メッセージの最後の文にある修正方法を適用します
3813 3827
3814### GitHub isn't connected to your Claude account3828### GitHub isn't connected to your Claude account
3815 3829
3816`/autofix-pr` などでローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか接続の有効期限が切れているため、Claude Code は起動を拒否します。3830`/autofix-pr` などで、ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否します。
3817 3831
3818```text theme={null}3832```text theme={null}
3819GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3833GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
3820```3834```
3821 3835
3822[`/schedule`](https://code.claude.com/docs/ja/routines) でクラウドのスケジュールタスクを作成する場合、同じメッセージがリポジトリ名を示すセットアップの注意書きとして表示されます。この注意書きはタスクの作成を妨げません。3836[`/schedule`](https://code.claude.com/docs/ja/routines) でクラウドのスケジュールタスクを作成する場合、同じメッセージがリポジトリ名を含むセットアップの注記として表示されます。この注記はタスクの作成を妨げません。
3823 3837
3824**対処方法：**3838**対処方法：**
3825 3839
3826* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します。両者の違いについては [GitHub の認証オプション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#github-authentication-options)を参照してください。3840* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します。両者の違いについては [GitHub 認証オプション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#github-authentication-options)を参照してください。
3827* 接続してから 1 分ほど待ってコマンドを再実行します3841* 接続してから 1 分ほど待ってコマンドを再実行します
3828 3842
3829v2.1.268 より前は、Claude Code はこれを Claude GitHub App の確認の一時的な失敗として報告し、再試行またはアプリのインストールを提案していましたが、どちらも GitHub アカウントを接続するものではありません。3843v2.1.268 より前は、Claude Code はこれを Claude GitHub App の確認の一時的な失敗として報告し、再試行またはアプリのインストールを提案していました。どちらも GitHub アカウントを接続するものではありません。
3830 3844
3831### GitHub 組織のポリシーが Claude をブロックしている3845### GitHub の組織ポリシーが Claude をブロックしている
3832 3846
3833[`/autofix-pr`](https://code.claude.com/docs/ja/claude-code-on-the-web#auto-fix-pull-requests) など、クラウドセッションを開始するコマンドを Claude Code のプロンプトで実行しました。Claude Code はセッションを作成する前に GitHub 上のリポジトリへの Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub がアクセスを拒否しました。Claude Code はその時点で停止し、該当するポリシーを示すメッセージを表示します。3847[`/autofix-pr`](https://code.claude.com/docs/ja/claude-code-on-the-web#auto-fix-pull-requests) など、クラウドセッションを開始するコマンドを Claude Code のプロンプトで実行しました。Claude Code はセッションを作成する前に GitHub 上のリポジトリへの Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub が拒否しました。Claude Code はその時点で停止し、該当するポリシーを示すメッセージを表示します。
3834 3848
3835IP 許可リストによってアクセスがブロックされている場合、メッセージは次のようになります。3849IP 許可リストがアクセスをブロックしている場合、メッセージは次のようになります。
3836 3850
3837```text theme={null}3851```text theme={null}
3838Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.3852Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.
3839```3853```
3840 3854
3841シングルサインオンによってブロックされている場合、メッセージは次のようになります。3855シングルサインオンがブロックしている場合、メッセージは次のようになります。
3842 3856
3843```text theme={null}3857```text theme={null}
3844Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.3858Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.
3845```3859```
3846 3860
3847Microsoft Entra ID の条件付きアクセスポリシーによってブロックされている場合、メッセージは次のようになります。3861Microsoft Entra ID の条件付きアクセスポリシーがブロックしている場合、メッセージは次のようになります。
3848 3862
3849```text theme={null}3863```text theme={null}
3850Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.3864Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.
3852 3866
3853**対処方法：**3867**対処方法：**
3854 3868
3855* **IP 許可リスト**：GitHub の組織または Enterprise のオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更する GitHub の設定については、[GitHub の許可リストとファイアウォール](https://code.claude.com/docs/ja/network-config.md#github-allow-lists-and-firewalls)を参照してください。3869* **IP 許可リスト**：GitHub の組織またはエンタープライズのオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更すべき GitHub の設定については、[GitHub の許可リストとファイアウォール](https://code.claude.com/docs/ja/network-config.md#github-allow-lists-and-firewalls)を参照してください。
3856* **シングルサインオン**：[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub の接続を解除してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックして、新しい接続がその組織のシングルサインオンで認可されるようにします。3870* **シングルサインオン**：[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub を切断してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックし、新しい接続がその組織のシングルサインオンで認可されるようにします。
3857* **条件付きアクセスポリシー**：GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します3871* **条件付きアクセスポリシー**：GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します
3858* 変更後、コマンドを再度実行します3872* 変更後、コマンドを再度実行します
3859 3873
3860### Single sign-on authorization needed3874### Single sign-on authorization needed
3861 3875
3862[`/install-github-app`](https://code.claude.com/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサインオンを強制している組織のリポジトリを選択しました。Claude Code はセットアップの前に GitHub CLI でリポジトリへのアクセスを確認しますが、`gh` トークンがまだその組織に対して認可されていないため、GitHub がその確認を拒否しました。ウィザードには、認可の手順とともに次の警告が表示されます。3876[`/install-github-app`](https://code.claude.com/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサインオンを強制している組織のリポジトリを選択しました。Claude Code はセットアップの前に GitHub CLI でリポジトリへのアクセスを確認しますが、`gh` トークンがまだその組織に対して認可されていないため、GitHub がその確認を拒否しました。ウィザードには、認可の手順とともに警告が表示されます。
3863 3877
3864```text theme={null}3878```text theme={null}
3865Single sign-on authorization needed3879Single sign-on authorization needed
3868 3882
3869**対処方法：**3883**対処方法：**
3870 3884
3871* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` のスコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します3885* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` スコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します
3872* `GH_TOKEN` で個人用アクセストークンを使って認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します3886* `GH_TOKEN` の個人用アクセストークンで認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します
3873* `/install-github-app` を再度実行します3887* `/install-github-app` を再度実行します
3874 3888
3875v2.1.273 より前は、Claude Code はこの状況で代わりに `Admin permissions required` の警告を表示していました。3889v2.1.273 より前は、この状況では代わりに `Admin permissions required` 警告が表示されていました。
3876 3890
3877### Failed to resume the conversation3891### Failed to resume the conversation
3878 3892
3879[`claude --resume` のピッカー](https://code.claude.com/docs/ja/sessions#use-the-session-picker)で選択したセッションの保存済みトランスクリプトを Claude Code が読み取れないか処理できなかったため、部分的に読み込まれた状態で続行するのではなくプロセスを終了します。メッセージには再試行用のコマンドが含まれます。3893[`claude --resume` ピッカー](https://code.claude.com/docs/ja/sessions#use-the-session-picker)から選択したセッションの保存済みトランスクリプトを Claude Code が読み取りまたは処理できなかったため、部分的に読み込まれた状態で続行するのではなく、プロセスを終了します。メッセージには再試行するためのコマンドが含まれます。
3880 3894
3881```text theme={null}3895```text theme={null}
3882Failed to resume the conversation.3896Failed to resume the conversation.
3883Run claude --resume <session-id> to retry, or claude to start a new session.3897Run claude --resume <session-id> to retry, or claude to start a new session.
3884```3898```
3885 3899
3886Claude Code はメッセージを表示した後、コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは引き続き実行されます。v2.1.216 より前は、`claude --resume` のピッカーから再開に失敗すると、このメッセージを表示する代わりに `Resuming conversation…` のスピナーが表示されたままになっていました。3900Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは実行を継続します。v2.1.216 より前は、`claude --resume` ピッカーからの再開に失敗すると、このメッセージを表示する代わりに `Resuming conversation…` スピナーが表示されたままになっていました。
3887 3901
3888**対処方法：**3902**対処方法：**
3889 3903
3890* メッセージに示されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します3904* メッセージに示されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します
3891* v2.1.285 より前のバージョンで、再試行しても同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。3905* v2.1.285 より前のバージョンで、再試行が同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。
3892* 再試行しても再び失敗する場合は、`claude` を実行して新しいセッションを開始します3906* 再試行が再び失敗する場合は、`claude` を実行して新しいセッションを開始します
3893 3907
3894### No conversation found with the session ID3908### No conversation found with the session ID
3895 3909
3899No conversation found with session ID: <session-id>3913No conversation found with session ID: <session-id>
3900```3914```
3901 3915
3902Claude Code はメッセージを表示した後、コード 1 で終了します。Claude Code は [ID を現在のプロジェクトから検索し、その後このマシン上の他のすべてのプロジェクトを検索します](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開してください。3916Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は [まず現在のプロジェクトを検索し、次にこのマシン上の他のすべてのプロジェクト](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)で ID を検索します。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開する必要がありました。
3903 3917
3904主な原因：3918主な原因：
3905 3919
3906* **ID の入力ミス**：非対話型の実行の場合、ID は [`--output-format json` の出力](https://code.claude.com/docs/ja/headless#get-structured-output)の `session_id` フィールドです3920* **ID の入力ミス**：非対話型の実行では、ID は [`--output-format json` の出力](https://code.claude.com/docs/ja/headless#get-structured-output)の `session_id` フィールドです
3907* **トランスクリプトの削除**：Claude Code は[保持期間](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)（デフォルトでは 30 日）が過ぎると、[保持期間による削除ルール](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)に従ってトランスクリプトを削除します3921* **トランスクリプトの削除**：Claude Code は、[保持期間](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)（デフォルトでは 30 日）を過ぎたトランスクリプトを、[保持期間のクリーンアップルール](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)に従って削除します
3908* **別のマシン**：Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開してください3922* **別のマシン**：Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開してください
3909* **重複したコピー**：`~/.claude/projects` 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらかのコピーを任意に再開するのではなく、このメッセージを報告します3923* **重複したコピー**：`~/.claude/projects` 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらか一方を任意に再開するのではなく、このメッセージを表示します
3910 3924
3911**対処方法：**3925**対処方法：**
3912 3926
3915 3929
3916### Windows reported an error (EBADF) when Claude Code read this session's transcript file3930### Windows reported an error (EBADF) when Claude Code read this session's transcript file
3917 3931
3918Windows でセッションを再開したところ、保存済みの[トランスクリプトファイル](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)は正常に開けたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーからは読み取りが失敗した理由がわからないため、メッセージには考えられる原因と試すべきことが示されます。3932Windows でセッションを再開したところ、保存済みの[トランスクリプトファイル](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)は正常に開いたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーからは読み取りが失敗した理由がわからないため、メッセージには考えられる原因と試すべきことが示されます。
3919 3933
3920```text theme={null}3934```text theme={null}
3921Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.3935Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
3922```3936```
3923 3937
3924このメッセージは、`Failed to resume session <session-id>` のようなコマンド自体の失敗を示す行に続いて表示されます。`claude --resume` または [`claude -p`](https://code.claude.com/docs/ja/headless) コマンドは、これを表示した後にコード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションが引き続き実行されます。3938このメッセージは、`Failed to resume session <session-id>` などのコマンド自体の失敗を示す行の後に表示されます。`claude --resume` または [`claude -p`](https://code.claude.com/docs/ja/headless) コマンドは、これを表示した後に終了コード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションは実行を継続します。
3925 3939
3926**対処方法：**3940**対処方法：**
3927 3941
3928* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたは傍受するソフトウェアの対象から、セッションのトランスクリプトを保存するフォルダーを除外します。トランスクリプトはデフォルトでは `%USERPROFILE%\.claude\projects` 配下、または [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) で指定されたディレクトリ配下に保存されます3942* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアの対象から、セッションのトランスクリプトを保存しているフォルダーを除外します。トランスクリプトはデフォルトでは `%USERPROFILE%\.claude\projects` 配下、または [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) で指定されたディレクトリ配下にあります
3929* 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します3943* 除外を追加できない場合は、代わりにそのソフトウェアの許可アプリケーションに Claude Code を追加します
3930* セッションを再度再開します3944* セッションを再度再開します
3931 3945
3932v2.1.282 より前は、失敗時に説明が表示されませんでした。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようなシステムエラーのテキストのみが出力されていました。3946v2.1.282 より前は、この失敗には説明がありませんでした。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようにシステムエラーのテキストのみが出力されていました。
3933 3947
3934### Cannot switch renderers in this session3948### Cannot switch renderers in this session
3935 3949
3936レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を見送るセッションで [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージから原因がわかります。3950レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を行わないセッションで [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります。
3937 3951
3938* `Cannot switch renderers while work is running in the background`：バックグラウンドのシェルやサブエージェントなど、再起動によって放棄されることになるバックグラウンドの作業が実行中です。作業が完了するのを待つか [`/tasks`](https://code.claude.com/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します3952* `Cannot switch renderers while work is running in the background`：バックグラウンドシェルやサブエージェントなど、再起動すると放棄されてしまうバックグラウンドの作業が実行中です。作業が完了するのを待つか、[`/tasks`](https://code.claude.com/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します
3939* `Cannot switch renderers in this session`：再起動後のプロセスに Claude Code が引き継げない制限がセッションに設定されています。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました3953* `Cannot switch renderers in this session`：セッションに、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました
3940 3954
3941制限に関するメッセージでは、括弧内の部分に Claude Code が検出した制限が示されます。3955制限に関するメッセージでは、括弧内の部分に Claude Code が検出した制限が示されます。
3942 3956
3946 3960
3947メッセージの括弧内に表示される可能性のある理由は次のとおりです。3961メッセージの括弧内に表示される可能性のある理由は次のとおりです。
3948 3962
3949* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`：再起動後のプロセスに Claude Code が引き継がないフラグを指定してセッションを開始しました。該当するフラグには、[`--system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](https://code.claude.com/docs/ja/cli-reference#cli-flags) による許可リスト、[`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、[`--permission-prompt-tool`](https://code.claude.com/docs/ja/cli-reference#cli-flags) があります3963* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`：Claude Code が再起動後のプロセスに引き継がないフラグを付けてセッションを開始しました。これらのフラグには、[`--system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](https://code.claude.com/docs/ja/cli-reference#cli-flags) の許可リスト、[`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、[`--permission-prompt-tool`](https://code.claude.com/docs/ja/cli-reference#cli-flags) が含まれます
3950* `permission rules set for this session only`：フックまたは SDK の呼び出し元からの[権限の更新](https://code.claude.com/docs/ja/hooks.md#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。再起動するとそれらは破棄され、Claude Code は代わりに再度確認を求めます3964* `permission rules set for this session only`：フックまたは SDK の呼び出し元からの[権限の更新](https://code.claude.com/docs/ja/hooks.md#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。再起動するとそれらのルールは破棄され、Claude Code は代わりに再度確認を求めます
3951* `ask-before-running rules with no command-line form`：フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` および `--disallowed-tools` として引き継ぐルールとあわせて確認ルールが追加されました。確認ルールに対応するフラグはありません3965* `ask-before-running rules with no command-line form`：フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` および `--disallowed-tools` として引き継ぐルールに加えて、確認ルールが追加されました。確認ルールに対応するフラグは存在しません
3952* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`：権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継ぐことができません3966* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`：権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継ぐことができません
3953 3967
3954**対処方法：**3968**対処方法：**
3955 3969
3956* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻す場合は `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します3970* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻すには `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します
3957 3971
3958### Claude Code couldn't restart3972### Claude Code couldn't restart
3959 3973
3960このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングへの切り替えやその解除のために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。3974このメッセージで会話が保存されていると表示された場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングとの切り替えを行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。
3961 3975
3962```text theme={null}3976```text theme={null}
3963Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.3977Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.
3964```3978```
3965 3979
3966新しいセッションで最初の入力が `/tui` だった場合など、再起動時に再び開く会話がなかった場合、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。3980新しいセッションで `/tui` が最初の入力だった場合など、再起動時に再び開く会話がなかった場合、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。
3967 3981
3968**対処方法：**3982**対処方法：**
3969 3983
3970* シェルで `claude` を再度実行します。メッセージで会話が保存されていると示されていた場合は、新しいセッションで [`/resume`](https://code.claude.com/docs/ja/sessions#resume-a-session) を実行して会話を選択します。一覧にない場合は、[セッションピッカーの範囲を広げます](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)3984* シェルで `claude` を再度実行します。メッセージで会話が保存されていると表示された場合は、新しいセッションで [`/resume`](https://code.claude.com/docs/ja/sessions#resume-a-session) を実行し、会話を選択します。一覧に表示されない場合は、[セッションピッカーの範囲を広げます](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)
3971* 再起動が失敗し続ける場合は、シェルから [`claude --debug-file claude-debug.log`](https://code.claude.com/docs/ja/cli-reference#cli-flags) で Claude Code を起動します。そのセッションからの再起動が失敗すると、起動したディレクトリにある `claude-debug.log` に、オペレーティングシステムのエラーを含む `Failed to relaunch:` の行が記録されます。[問題を報告する](#report-an-error)際にはその行を含めてください3985* 再起動が失敗し続ける場合は、シェルから [`claude --debug-file claude-debug.log`](https://code.claude.com/docs/ja/cli-reference#cli-flags) で Claude Code を起動します。そのセッションからの再起動が失敗すると、起動したディレクトリの `claude-debug.log` に、オペレーティングシステムのエラーを含む `Failed to relaunch:` 行が記録されます。[問題を報告する](#report-an-error)際にはその行を含めてください
3972 3986
3973### Couldn't open Claude Desktop3987### Couldn't open Claude Desktop
3974 3988
3975セッション内で [`/desktop`](https://code.claude.com/docs/ja/desktop#coming-from-the-cli) またはそのエイリアスの `/app` を実行したか、シェルで [`claude --desktop`](https://code.claude.com/docs/ja/cli-reference#cli-flags) を実行しましたが、Claude Code が Claude Desktop を開くために使用するシステムコマンドが失敗しました。`/desktop` の後はセッションはターミナルにとどまります。`claude --desktop` は `Error:` の接頭辞なしでメッセージを出力し、ステータス 1 で終了します。3989セッション内で [`/desktop`](https://code.claude.com/docs/ja/desktop#coming-from-the-cli) またはそのエイリアスである `/app` を実行したか、シェルで [`claude --desktop`](https://code.claude.com/docs/ja/cli-reference#cli-flags) を実行しましたが、Claude Code が Claude Desktop を開くために使用するシステムコマンドが失敗しました。`/desktop` の後は、セッションはターミナルに残ります。`claude --desktop` は `Error:` プレフィックスなしでメッセージを出力し、ステータス 1 で終了します。
3976 3990
3977括弧内のテキストには、失敗したコマンドと、終了ステータスおよびエラー出力の 1 行目（出力された場合）が示されます。macOS ではこの例のようにコマンドは `open` で、Windows では `rundll32` です。3991括弧内のテキストには、失敗したコマンドと、コマンドが出力した場合はその終了ステータスとエラー出力の最初の行が示されます。macOS ではこのコマンドは次の例のように `open` で、Windows では `rundll32` です。
3978 3992
3979```text theme={null}3993```text theme={null}
3980Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.3994Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.
3982 3996
3983**対処方法：**3997**対処方法：**
3984 3998
3985* Claude Desktop を自分で開いてから、`/desktop` または `claude --desktop` を再度実行します3999* Claude Desktop を手動で開いてから、`/desktop` または `claude --desktop` を再度実行します
3986* 失敗したコマンドのエラー出力全体を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します4000* 失敗したコマンドの完全なエラー出力を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します
3987 4001
3988v2.1.285 より前は、メッセージの末尾は `Open Claude Desktop and run /desktop again.` でした。v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されていませんでした。4002v2.1.285 より前は、メッセージは `Open Claude Desktop and run /desktop again.` で終わっていました。v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されていませんでした。
3989 4003
3990### /terminal-setup で Zed のキーマップが変更されなかった4004### /terminal-setup で Zed のキーマップが変更されなかった
3991 4005
3992Zed で [`/terminal-setup`](https://code.claude.com/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code が Zed の `keymap.json` の更新を完了できなかったため、ファイルはそのままにされました。4006Zed で [`/terminal-setup`](https://code.claude.com/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code は Zed の `keymap.json` の更新を完了できなかったため、ファイルを元のままにしました。
3993 4007
3994各メッセージにはキーマップのパスが示され、自分で追加するためのキーボードショートカットのブロックで締めくくられます。4008各メッセージにはキーマップのパスが示され、手動で追加するためのキーボードショートカットのブロックで終わります。
3995 4009
3996```text theme={null}4010```text theme={null}
3997Couldn't update your Zed keymap, so it was left unchanged.4011Couldn't update your Zed keymap, so it was left unchanged.
3999{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }4013{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
4000```4014```
4001 4015
4002メッセージの 1 行目に原因が示されます。4016メッセージの最初の行には原因が示されます。
4003 4017
4004* `Couldn't read your Zed keymap, so it was left unchanged.`：ファイルの権限などが原因で、Claude Code がファイルを読み取れませんでした4018* `Couldn't read your Zed keymap, so it was left unchanged.`：ファイルの権限などが原因で、Claude Code がファイルを読み取れませんでした
4005* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`：ファイルは読み取れましたが、`//` コメントと末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません4019* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`：ファイルは読み取れましたが、`//` コメントや末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません
4006* `Couldn't back up your Zed keymap; not modifying it.`：Claude Code がファイルを同じ場所の `.bak` バックアップにコピーできなかったため、何も変更しませんでした4020* `Couldn't back up your Zed keymap; not modifying it.`：Claude Code がファイルを隣の `.bak` バックアップにコピーできなかったため、何も変更しませんでした
4007* `Couldn't update your Zed keymap, so it was left unchanged.`：マージした結果が、キーボードショートカットを含む有効なキーマップとして検証できなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックがあると、これが発生することがあります4021* `Couldn't update your Zed keymap, so it was left unchanged.`：マージ結果が、バインディングを含む有効なキーマップとして検証されなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックが原因となる場合があります
4008 4022
4009**対処方法：**4023**対処方法：**
4010 4024
4011* メッセージに示されたパスにある `keymap.json` のトップレベルの配列に、メッセージのブロックをコピーします4025* メッセージのブロックを、メッセージに示されたパスにある `keymap.json` のトップレベルの配列にコピーします
4012* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します4026* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します
4013 4027
4014v2.1.247 より前は、`/terminal-setup` は `//` コメントや末尾のカンマを使用している Zed のキーマップを解析できず、キーボードショートカットがインストールされたと報告しながら、ファイル全体を自身のキーボードショートカットのみに置き換えていました。以前のバージョンで置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)で説明している `.bak` バックアップファイルを使用してください。4028v2.1.247 より前は、`/terminal-setup` は `//` コメントや末尾のカンマを使用した Zed のキーマップを解析できず、ファイル全体を自身のバインディングのみで置き換えたうえで、バインディングがインストールされたと報告していました。以前のバージョンで置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)で説明している `.bak` バックアップファイルを使用してください。
4015 4029
4016### Skill usage reports are not available on this connection4030### Skill usage reports are not available on this connection
4017 4031
4018スマートフォンまたはブラウザから [Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由で [`/skill-doctor`](https://code.claude.com/docs/ja/skills#find-unused-skills) を実行しました。Claude Code はスキルの使用状況レポートを Remote Control 経由で送信せず、代わりに次のメッセージで応答します。4032スマートフォンまたはブラウザから [Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由で [`/skill-doctor`](https://code.claude.com/docs/ja/skills#find-unused-skills) を実行しました。Claude Code は Remote Control 経由ではスキルの使用状況レポートを送信せず、代わりに次のメッセージを返します。
4019 4033
4020```text theme={null}4034```text theme={null}
4021Skill usage reports are not available on this connection.4035Skill usage reports are not available on this connection.
4023 4037
4024**対処方法：**4038**対処方法：**
4025 4039
4026* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そこで `claude -p "/skill-doctor"` を実行します4040* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そのマシンで `claude -p "/skill-doctor"` を実行します
4027 4041
4028### Custom output styles can't be selected over Remote Control4042### Custom output styles can't be selected over Remote Control
4029 4043
4030[Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由でモバイルアプリまたは Web から [`/output-style`](https://code.claude.com/docs/ja/output-styles#change-your-output-style) を実行したか、セッションに中継されたメッセージでコマンドが届きました。このようなターンはアカウントの所有者から送られたものとは限らないため、Claude Code はそのターンでは[組み込みスタイル](https://code.claude.com/docs/ja/output-styles.md#built-in-output-styles)のみを一覧表示・選択し、コマンドがスタイルを一覧表示するときや指定された名前を認識できないときには、この通知を追加します。[カスタムスタイル](https://code.claude.com/docs/ja/output-styles.md#create-a-custom-output-style)の名前には、存在しない名前と同じ応答が返されます。4044[Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由でモバイルアプリまたは Web から [`/output-style`](https://code.claude.com/docs/ja/output-styles#change-your-output-style) を実行したか、セッションに中継されたメッセージでコマンドが届きました。このようなターンはアカウント所有者からのものではない可能性があるため、Claude Code はそのターンでは[組み込みスタイル](https://code.claude.com/docs/ja/output-styles.md#built-in-output-styles)のみを一覧表示・選択し、コマンドがスタイルを一覧表示する場合や指定された名前を認識できない場合には、この通知を追加します。[カスタムスタイル](https://code.claude.com/docs/ja/output-styles.md#create-a-custom-output-style)の名前には、存在しない名前と同じ応答が返されます。
4031 4045
4032```text theme={null}4046```text theme={null}
4033Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.4047Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
4035 4049
4036**対処方法：**4050**対処方法：**
4037 4051
4038* `/output-style concise` のように、組み込みスタイルを選択します4052* `/output-style concise` のように組み込みスタイルを選択します
4039* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体のターミナルがある場合はそこで `/output-style <style>` を実行します4053* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体にターミナルがある場合はそこで `/output-style <style>` を実行します
4040 4054
4041### Output styles are saved to local settings which this session doesn't load4055### Output styles are saved to local settings which this session doesn't load
4042 4056
4043設定ソースから `local` が除外されているセッションで、`/output-style <style>` または `/config outputStyle=<style>` を使って[出力スタイル](https://code.claude.com/docs/ja/output-styles.md)を切り替えようとしました。たとえば、[`settingSources`](https://code.claude.com/docs/ja/agent-sdk/typescript#options) から `"local"` を除外した [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/typescript.md) のセッションや、`local` を除外した [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) の値で開始した CLI セッションがこれに該当します。どちらのコマンドもスタイルを `.claude/settings.local.json` に保存しますが、そのようなセッションはこのファイルを読み込まないため、Claude Code は効果のない設定を書き込む代わりに拒否します。4057設定ソースから `local` が除外されているセッションで、`/output-style <style>` または `/config outputStyle=<style>` を使って[出力スタイル](https://code.claude.com/docs/ja/output-styles.md)を切り替えようとしました。たとえば、[`settingSources`](https://code.claude.com/docs/ja/agent-sdk/typescript#options) に `"local"` が含まれていない [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/typescript.md) のセッションや、`local` を含まない [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) の値で開始した CLI セッションがこれに該当します。どちらのコマンドもスタイルを `.claude/settings.local.json` に保存しますが、このようなセッションではこのファイルが読み込まれることはないため、Claude Code は効果のない設定を書き込む代わりに拒否します。
4044 4058
4045```text theme={null}4059```text theme={null}
4046Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.4060Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
4053 4067
4054### /recap only runs when you ask for it yourself4068### /recap only runs when you ask for it yourself
4055 4069
4056[`/recap`](https://code.claude.com/docs/ja/interactive-mode#session-recap) のリクエストがユーザー自身の入力によるものではありませんでした。Slack、Teams、または[プロジェクト](https://code.claude.com/docs/ja/claude-projects.md)のスレッドからセッションに中継されたメッセージ、あるいは[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)や別のプログラムが送信したプロンプトで届きました。4070[`/recap`](https://code.claude.com/docs/ja/interactive-mode#session-recap) のリクエストがユーザー自身の入力からのものではありませんでした。Slack、Teams、または[プロジェクト](https://code.claude.com/docs/ja/claude-projects.md)のスレッドからセッションに中継されたメッセージ、あるいは[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)や別のプログラムが送信したプロンプトで届きました。
4057 4071
4058中継されたメッセージは、自分で書いたものであっても通知の対象になります。Claude Code は、中継または自動化されたメッセージがセッションを実行しているアカウントの本人から送られたものかどうかを判別できないため、要約の代わりに次の通知で応答します。4072中継されたメッセージは、ユーザー自身が書いたものであっても通知の対象になります。Claude Code は、中継されたメッセージや自動化されたメッセージが、セッションを実行しているアカウントの本人からのものかどうかを判断できないため、要約の代わりに次の通知で応答します。
4059 4073
4060```text theme={null}4074```text theme={null}
4061/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.4075/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.
4062```4076```
4063 4077
4064`claude -p` に渡した `/recap` や、自分の [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーションが起動したセッションに送信する `/recap` は、ユーザー自身の入力として扱われます。4078`claude -p` に渡した `/recap` や、独自の [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーションが起動したセッションに送信する `/recap` は、ユーザー自身の入力として扱われます。
4065 4079
4066**対処方法：**4080**対処方法：**
4067 4081
4068* セッションを自分で開き、ターミナル、[デスクトップアプリ](https://code.claude.com/docs/ja/desktop.md)や[モバイルアプリ](https://code.claude.com/docs/ja/mobile.md)、[claude.ai/code](https://claude.ai/code)、または [Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由で `/recap` を実行します4082* セッションを自分で開き、そこで `/recap` を実行します。セッションのターミナル、[デスクトップアプリ](https://code.claude.com/docs/ja/desktop.md)や[モバイルアプリ](https://code.claude.com/docs/ja/mobile.md)、[claude.ai/code](https://claude.ai/code)、または [Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由で実行できます
4069* クラウドのスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します4083* クラウドのスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します
4070 4084
4071### /feedback is disabled by your organization's policy4085### /feedback is disabled by your organization's policy
4076/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.4090/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
4077```4091```
4078 4092
4079メッセージが最初の文だけの場合もあります。4093メッセージが最初の文のみの場合もあります。
4080 4094
4081**対処方法：**4095**対処方法：**
4082 4096
4083* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成します。そこにある issue は誰でも閲覧できるため、コード、トランスクリプト、その他の機密情報は含めないでください。4097* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成します。そこでの issue は誰でも閲覧できるため、コード、トランスクリプト、その他の機密情報は含めないでください。
4084 4098
4085v2.1.302 より前は、完全なメッセージは `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。4099v2.1.302 より前は、完全なメッセージは `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。
4086 4100
4678* チームメイトがまだ実行中の場合は、チームリーダーのプロンプトでチームメイトをシャットダウンするよう依頼します（例: `Ask the researcher teammate to shut down`）。[チームメイトをシャットダウンする](https://code.claude.com/docs/ja/agent-teams.md#shut-down-teammates) を参照してください。4692* チームメイトがまだ実行中の場合は、チームリーダーのプロンプトでチームメイトをシャットダウンするよう依頼します（例: `Ask the researcher teammate to shut down`）。[チームメイトをシャットダウンする](https://code.claude.com/docs/ja/agent-teams.md#shut-down-teammates) を参照してください。
4679* `claude --resume` で自分で再開した元チームメイトがこの拒否を受け取った場合、何も送信されていません。そのセッションを終了するには、そのプロンプトで `/exit` を実行します。4693* `claude --resume` で自分で再開した元チームメイトがこの拒否を受け取った場合、何も送信されていません。そのセッションを終了するには、そのプロンプトで `/exit` を実行します。
4680 4694
4695### A command-line deny rule cannot be handed to a teammate intact
4696
4697このメッセージは、Claude Code が [エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md) の [分割ペイン](https://code.claude.com/docs/ja/agent-teams.md#choose-a-display-mode) チームメイトを起動しなかったことを意味します。Claude Code はチームリーダーのコマンドライン拒否ルールを、分割ペインのチームメイト自身のコマンドラインで渡しますが、チームメイトがそのいずれかを異なる意味で読み取ってしまう場合は停止します。
4698
4699```text wrap theme={null}
4700A command-line deny rule cannot be handed to a teammate intact, so the teammate would not enforce it — spawn aborted
4701```
4702
4703**What to do:**
4704
4705* チームリーダーのセッションで `/config` を実行して **Teammate mode** を `in-process` に設定し、Claude にチームメイトを再度起動するよう依頼します。ルールを探したり、チームリーダーを再起動したりする必要はありません。インプロセスのチームメイトは [チームリーダーの現在の拒否ルールの下で実行されます](https://code.claude.com/docs/ja/agent-teams.md#permissions)。
4706* `/config` はこの選択をユーザー設定に保存するため、ユーザー設定から [`teammateMode`](https://code.claude.com/docs/ja/settings-reference#teammatemode) を取得する以降のセッションでも、チームメイトはインプロセスで起動します。以降のセッションで分割ペインに戻すには、**Teammate mode** を以前使用していた `auto`、`tmux`、`iterm2` のいずれかに設定します。
4707
4681### Message too large for cross-session delivery4708### Message too large for cross-session delivery
4682 4709
4683Claude の [クロスセッションメッセージ](https://code.claude.com/docs/ja/cross-session-messaging.md) は、このマシン上の別のセッションに対して長すぎて送信できませんでした。Claude Code はそれを拒否し、受信セッションは何も受け取りませんでした。拒否はターミナルのバナーではなく、送信セッションのツール結果に表示されます。両方のサイズとメッセージを適合させる方法を指定します。4710Claude の [クロスセッションメッセージ](https://code.claude.com/docs/ja/cross-session-messaging.md) は、このマシン上の別のセッションに対して長すぎて送信できませんでした。Claude Code はそれを拒否し、受信セッションは何も受け取りませんでした。拒否はターミナルのバナーではなく、送信セッションのツール結果に表示されます。両方のサイズとメッセージを適合させる方法を指定します。
5115**対処方法：**5142**対処方法：**
5116 5143
5117* コミットを保持するには、worktree のブランチをプッシュするか、メインチェックアウトでチェックアウトされたデフォルトブランチにマージしてから、セッションを再度削除します5144* コミットを保持するには、worktree のブランチをプッシュするか、メインチェックアウトでチェックアウトされたデフォルトブランチにマージしてから、セッションを再度削除します
5118* コミットを破棄するには、メッセージが出力した `claude rm <id> --discard-unpushed` コマンドを実行するか、エージェントビューのセッション行で再度 `Ctrl+X` を 2 回押します。これにより、セッション、worktree、そのブランチ、プッシュされていないコミット、およびコミットされていない変更が削除されます。worktree が拒否以降にコミットを獲得した場合、Claude Code はそれを再度保持し、更新された状態を表示します5145* コミットを破棄するには、メッセージが出力した `claude rm <id> --discard-unpushed` コマンドを実行するか、エージェントビューのセッション行で再度 `Ctrl+X` を 2 回押します。これにより、セッション、worktree、そのブランチ、プッシュされていないコミット、およびコミットされていない変更が削除されます。削除が再度拒否された場合は、新しいメッセージに従ってください。
5119* メッセージが worktree が別の完了したセッションによっても記録されていることを示す場合、再度削除してもそれは破棄されません：コミットをプッシュしてから、セッションを再度削除します5146* メッセージが worktree が別の完了したセッションによっても記録されていることを示す場合、再度削除してもそれは破棄されません：コミットをプッシュしてから、セッションを再度削除します
5120 5147
5121v2.1.268 より前では、`claude rm` はコミット要約を `kept` 行自体に置いていました。`claude rm` がコミットを要約できない場合、`kept` 行は要約の代わりに `worktree has commits that are not pushed anywhere` となっていました。5148v2.1.268 より前では、`claude rm` はコミット要約を `kept` 行自体に置いていました。`claude rm` がコミットを要約できない場合、`kept` 行は要約の代わりに `worktree has commits that are not pushed anywhere` となっていました。
5122 5149
5123v2.1.260 より前では、メッセージはブランチまたはコミットに名前を付けず、再度削除することは同じ方法で拒否されました：セッションを削除してプッシュしないことは、`git worktree remove --force <path>` で worktree を自分で削除してから、`claude rm <id>` を再度実行することを意味していました。5150v2.1.260 より前では、メッセージはブランチやコミットを示さず、破棄する手段もありませんでした。その場合でも、コミットされていない変更は失われますが、ブランチとコミットは保持したままセッションを削除できます。拒否メッセージが出力したパスを指定して `git worktree remove --force --force <path>` を実行してから、`claude rm <id>` を実行します。ロックされた worktree の場合、Git では `--force` を 2 回指定する必要があります。
5124 5151
5125v2.1.248 より前では、メインチェックアウトでチェックアウトされたデフォルトブランチはカウントされませんでした：既にそこにマージしたブランチは、そのコミットがリモートに到達するまで、この拒否をトリガーしました。5152v2.1.248 より前では、メインチェックアウトでチェックアウトされたデフォルトブランチはカウントされませんでした：既にそこにマージしたブランチは、そのコミットがリモートに到達するまで、この拒否をトリガーしました。
5126 5153
