244| `MCP server "<name>" was not saved to` / `was not removed from` | [コマンドラインエラー](#mcp-server-was-not-saved-or-removed) |244| `MCP server "<name>" was not saved to` / `was not removed from` | [コマンドラインエラー](#mcp-server-was-not-saved-or-removed) |
245| `MCP server "<name>" may not have been saved` / `may not have been removed` | [コマンドラインエラー](#mcp-server-may-not-have-been-saved-or-removed) |245| `MCP server "<name>" may not have been saved` / `may not have been removed` | [コマンドラインエラー](#mcp-server-may-not-have-been-saved-or-removed) |
246| `Server rejected the Authorization header minted by the configured headersHelper` | [コマンドラインエラー](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |246| `Server rejected the Authorization header minted by the configured headersHelper` | [コマンドラインエラー](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |
247| `This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability` | [コマンドラインエラー](#mcp-server-rejected-the-elicitation-capability) |
247| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [コマンドラインエラー](#mcp-permission-prompt-tool-not-found) |248| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [コマンドラインエラー](#mcp-permission-prompt-tool-not-found) |
248| `OAuth callback port <port> is already in use — another process may be holding it` | [コマンドラインエラー](#oauth-callback-port-is-already-in-use) |249| `OAuth callback port <port> is already in use — another process may be holding it` | [コマンドラインエラー](#oauth-callback-port-is-already-in-use) |
249| `No available ports for OAuth redirect` | [コマンドラインエラー](#no-available-ports-for-oauth-redirect) |250| `No available ports for OAuth redirect` | [コマンドラインエラー](#no-available-ports-for-oauth-redirect) |
2985* 最後のメッセージを言い換えるか、別のアプローチを試してください2986* 最後のメッセージを言い換えるか、別のアプローチを試してください
2986* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください2987* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください
2987 2988
2988## コマンドラインエラー2989## コマンドラインのエラー
2989 2990
2990これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、および `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。2991これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、そして `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。
2991 2992
2992### `--bg` と `--print` の競合2993### `--bg` と `--print` の競合
2993 2994
2994このメッセージには 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 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが通知なしに作成されていました。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 より前は、この組み合わせによって、決してアタッチできないバックグラウンドジョブが何も通知されずに作成されていました。
2995 2996
2996```text theme={null}2997```text theme={null}
2997--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>'`.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>'`.
2998```2999```
2999 3000
3000**対処方法:**3001**対処方法:**
3001 3002
3002* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` で完全なコマンドになります。[シェルから新しいエージェントを起動する](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。3003* `-p` または `--print` を外します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` で完全なコマンドになります。[シェルから新しいエージェントを Dispatch する](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。
3003* バックグラウンドセッションを作成せずに、プロンプトを非対話的に実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します3004* バックグラウンドセッションを作成する代わりに、プロンプトを非対話で実行して結果を出力するには、`--bg` を外して `claude -p "<task>"` を実行します
3004 3005
3005### Couldn't tell whether `--bg` is a flag or text3006### Couldn't tell whether `--bg` is a flag or text
3006 3007
3007`--bg` または `--background` を、バックグラウンドフラグとテキストのどちらを意図したのか Claude Code が判断できない位置に指定して `claude` を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:3008`--bg` または `--background` を、Claude Code がバックグラウンドフラグとテキストのどちらとして意図されたかを判別できない位置に置いて `claude` を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:
3008 3009
3009```text theme={null}3010```text theme={null}
3010Couldn'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>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>
3011```3012```
3012 3013
3013`--background` と入力した場合は、この行には代わりに `--background` と表示されます。3014`--background` と入力した場合は、この行には代わりに `--background` が示されます。
3014 3015
3015**対処方法:**3016**対処方法:**
3016 3017
3017* [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始するには、フラグを先頭に置いてシェルでコマンドを再実行します: `claude --bg --name nightly-audit "<task>"`3018* [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始するには、フラグを先頭に置いてシェルでコマンドを再度実行します:`claude --bg --name nightly-audit "<task>"`
3018 3019
3019### システムプロンプトフラグとそのファイル形式の競合3020### システムプロンプトフラグとそのファイル形式の競合
3020 3021
30211 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:30221 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:
3022 3023
3023```text theme={null}3024```text theme={null}
3024Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.3025Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
3025```3026```
3026 3027
3027v2.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)のではなく競合していたためです。これらのバージョンでは、メッセージに組み合わせたペアの名前が表示されます。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)されずに競合していたためです。これらのバージョンでは、メッセージには組み合わせたフラグの組が示されます。
3028 3029
3029**対処方法:**3030**対処方法:**
3030 3031
3031* フラグの一方の形式を残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします3032* フラグの一方の形式だけを残し、もう一方を外します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします
3032 3033
3033### Invalid `--agents` configuration3034### Invalid `--agents` configuration
3034 3035
3035`--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 はそれでもセッションを開始していました。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 はそれでもセッションを開始していました。
3036 3037
3037```text theme={null}3038```text theme={null}
3038Error: Invalid --agents configuration:3039Error: Invalid --agents configuration:
3039<what failed>3040<what failed>
3040```3041```
3041 3042
30421 行目の後に続く内容は、値がどのように失敗したかによって異なります。Claude Code は次のチェックを順に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:30431 行目に続く内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順に実行し、最初に失敗したところで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:
3043 3044
30441. 値が `{` で始まるのに JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` の行を 1 行出力します30451. 値が `{` で始まるものの JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します
30452. 解析はできても、エージェント定義が [CLI で定義されたサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します30462. 解析はできるものの、エージェント定義が [CLI で定義されたサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します
30463. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します30473. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します
3047 3048
3048問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。3049問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。
3049 3050
3050`--print` を使用する場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスは無効な JSON として扱われていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。たとえば次のものがあります:3051`--print` を使用している場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。次のようなものがあります:
3051 3052
3052* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: 対話セッションで、Claude Code が値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み込みます。3053* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**:Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み込みます。
3053* **`Error: --agents file not found: <path>`**: そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって崩れたインライン JSON もこの方法で失敗することがあります。パスまたはクォートを確認して、コマンドを再実行してください。3054* **`Error: --agents file not found: <path>`**:そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって壊されたインライン JSON もこの形で失敗することがあります。パスまたは引用符を確認し、コマンドを再度実行します。
3054 3055
3055**対処方法:**3056**対処方法:**
3056 3057
3057* メッセージに列挙された各問題を修正してから、コマンドを再実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を参照してください。3058* メッセージに列挙された各問題を修正してから、コマンドを再度実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を参照してください。
3058 3059
3059### Cloud sessions cannot be created from a `--restricted` session3060### Cloud sessions cannot be created from a `--restricted` session
3060 3061
3061[`--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 はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません: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 はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:
3062 3063
3063```text theme={null}3064```text theme={null}
3064Cloud sessions cannot be created from a --restricted session: they would not enforce it.3065Cloud sessions cannot be created from a --restricted session: they would not enforce it.
3065```3066```
3066 3067
3067**対処方法:**3068**対処方法:**
3068 3069
3069* 制限されたセッションでタスクをローカルに実行します3070* 制限されたセッションでタスクをローカルに実行します
3070* セッションの起動方法を制御できる場合は、`--restricted` を付けずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します3071* セッションの起動方法を制御できる場合は、`--restricted` を付けずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します
3071 3072
3072v2.1.248 より前の Claude Code には `--restricted` フラグがありません。以前のバージョンでは、フラグ自体が不明なオプションのエラーで拒否されます。3073v2.1.248 より前の Claude Code には `--restricted` フラグがなく、それより前のバージョンでは不明なオプションのエラーでフラグ自体が拒否されます。
3073 3074
3074### Cloud sessions are disabled by your organization's policy3075### Cloud sessions are disabled by your organization's policy
3075 3076
3076組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)とそれを使用するコマンドは利用できません:3077組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)とそれを使用するコマンドは利用できません:
3077 3078
3078```text theme={null}3079```text theme={null}
3079Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.3080Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
3080```3081```
3081 3082
3082このメッセージは、[ターミナルからクラウドセッションを作成する](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) が返されていました。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) が返されていました。
3083 3084
3084メッセージにこのセッションが使用している認証情報の名前が含まれ、`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)が表示されます。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)が表示されます。
3085 3086
3086**対処方法:**3087**対処方法:**
3087 3088
3088* 組織の [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 管理設定でクラウドセッションを有効にしてもらいます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 管理設定でクラウドセッションを有効にするよう依頼します
3089 3090
3090### Cloud sessions use your claude.ai login3091### Cloud sessions use your claude.ai login
3091 3092
3092[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージに、このセッションが使用している認証情報の名前が含まれ、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります:3093[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージがこのセッションで使用している認証情報を示し、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります:
3093 3094
3094```text theme={null}3095```text theme={null}
3095Cloud 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.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.
3096```3097```
3097 3098
3098最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合も Claude Code は組織の管理者に連絡するよう指示する形式を出力していました。3099最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合も Claude Code は組織の管理者に連絡するよう促す形式を出力していました。
3099 3100
3100### Couldn't verify your organization's policy for cloud sessions3101### Couldn't verify your organization's policy for cloud sessions
3101 3102
3102これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、次のメッセージが表示されます:3103これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間、メッセージは次のとおりです:
3103 3104
3104```text theme={null}3105```text theme={null}
3105Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.3106Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.
3106```3107```
3107 3108
3108セッション内では、`/teleport` や `/web-setup` など、クラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルでは `Cloud sessions aren't available:` 形式が出力される状況でもこのメッセージが表示され、その 2 文目は `Check your network connection, then restart Claude Code and try again.` となります。3109セッション内では、`/teleport` や `/web-setup` など、クラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルであれば `Cloud sessions aren't available:` 形式が出力される場合でもこのメッセージが表示され、2 文目は `Check your network connection, then restart Claude Code and try again.` となります。
3109 3110
3110ポリシーのリクエストが失敗すると、メッセージには何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に該当します。API への経路がない場合は、次のように表示されます:3111ポリシーのリクエストが失敗した後は、メッセージに何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に適用されます。API への経路がない場合、次のように表示されます:
3111 3112
3112```text theme={null}3113```text theme={null}
3113Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.3114Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.
3114```3115```
3115 3116
3116その他の失敗も同じ書き出しで始まり、その後に固有の原因が続きます。たとえば、プロキシが HTTP 403 でリクエストを拒否した場合、サーバーエラー、または API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその名前が示され、設定を解除するよう指示されることもあります:3117その他の失敗も同じ書き出しで、それぞれの原因が続きます。たとえば、HTTP 403 でリクエストを拒否したプロキシ、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージはその認証情報を示し、設定を解除するよう促すこともあります:
3117 3118
3118```text theme={null}3119```text theme={null}
3119Cloud 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.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.
3121 3122
3122v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。3123v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。
3123 3124
3124**対処方法:**3125**対処方法:**
3125 3126
3126* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内の場合は、まず Claude Code を再起動します3127* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認してから再試行します。セッション内の場合は、先に Claude Code を再起動します
3127* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や、示された認証情報の設定解除など、原因に応じた対応を行ってから、コマンドを再実行します3128* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や示された認証情報の設定解除など、原因に応じた対処を行ってから、コマンドを再度実行します
3128 3129
3129### Nothing was stashed because a folder replaced a tracked file3130### 追跡対象ファイルがフォルダに置き換えられたため何も stash されなかった
3130 3131
3131このメッセージは、チェックアウト内で、以前 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 を拒否し、チェックアウトとインデックスを変更しません: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 を拒否し、チェックアウトとインデックスを変更せずに残します:
3132 3133
3133```text wrap theme={null}3134```text wrap theme={null}
3134Error: 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.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.
3135```3136```
3136 3137
3137**対処方法:**3138**対処方法:**
3138 3139
3139* メッセージの指示どおり、変更をコミットするかフォルダーを別の場所に移動してから、teleport を再実行します3140* メッセージのとおり、変更をコミットするかフォルダを別の場所に移動してから、teleport を再度実行します
3140 3141
3141### The `--json-schema` value is not a valid JSON Schema3142### `--json-schema` の値が有効な JSON Schema ではない
3142 3143
3143[非対話モード](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` キーワードを使用するスキーマはすべて無効として扱われていました。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` キーワードを使用するスキーマはすべて無効として扱われていました。
3144 3145
3145```text theme={null}3146```text theme={null}
3146Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values3147Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
3147```3148```
3148 3149
31492 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` をアノテーションとして受け付け、適用はしません。31502 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` を注釈として受け付け、適用はしません。
3150 3151
3151Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON ではない値は `Error: --json-schema is not valid JSON` で拒否し、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否します。3152Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON ではない値は `Error: --json-schema is not valid JSON` で、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。
3152 3153
3153**対処方法:**3154**対処方法:**
3154 3155
3155* 診断メッセージが示すスキーマの箇所を修正してから、コマンドを再実行します3156* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します
3156* 動作するスキーマとコマンドについては、[構造化出力を取得する](https://code.claude.com/docs/ja/headless.md#get-structured-output)を参照してください3157* 動作するスキーマとコマンドについては、[構造化出力を取得する](https://code.claude.com/docs/ja/headless.md#get-structured-output)を参照してください
3157 3158
3158### Settings file exceeds the 2MiB limit3159### Settings file exceeds the 2MiB limit
3159 3160
3160[`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` はファイルを読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み込んでいたため、数 GB のファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。3161[`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` は読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み込んでおり、数ギガバイトのファイルや `/dev/zero` のようなデバイスファイルによってメモリが際限なく増加していました。
3161 3162
3162```text theme={null}3163```text theme={null}
3163Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3164Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
3164```3165```
3165 3166
3166Claude Code は、通常のファイルではない `--settings` パスも同様に拒否します。デバイス、FIFO、ソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` の後にパスが表示され、ディレクトリの場合は理由として `EISDIR` が表示されます。3167Claude Code は、通常のファイルではない `--settings` のパスも同様に拒否します。デバイス、FIFO、ソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` の後にパスが表示され、ディレクトリの場合は `EISDIR` の理由が表示されます。
3167 3168
3168**対処方法:**3169**対処方法:**
3169 3170
3170* `--settings` には、2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](https://code.claude.com/docs/ja/settings.md)を参照してください。3171* `--settings` に 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](https://code.claude.com/docs/ja/settings.md)を参照してください。
3171 3172
3172### The current directory no longer exists3173### The current directory no longer exists
3173 3174
3174シェルがディレクトリに入った後に削除または移動されたディレクトリ(たとえば別のシェルが削除した worktree や一時ディレクトリ)から `claude` を開始しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](https://code.claude.com/docs/ja/headless.md)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code は圧縮されたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。3175シェルがディレクトリに入った後で削除または移動されたディレクトリ(たとえば、別のシェルが削除した worktree や一時ディレクトリ)から `claude` を開始しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](https://code.claude.com/docs/ja/headless.md)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code は stderr に minify されたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを出力してクラッシュしていました。
3175 3176
3176```text theme={null}3177```text theme={null}
3177The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3178The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
3178error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3179error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
3179```3180```
3180 3181
3181どちらの形式も原因と解決方法は同じです。3182どちらの形式も、原因と修正方法は同じです。
3182 3183
3183権限の変更など、別の理由で Claude Code が作業ディレクトリを読み取れない場合は、代わりにメッセージにエラーコードが示されます: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3184権限の変更など、別の理由で Claude Code が作業ディレクトリを読み取れない場合は、メッセージに代わりにエラーコードが示されます:`Can't read the current directory (EACCES). Start Claude Code from a different directory.`
3184 3185
3185macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリで `EPERM` が発生する場合、通常は macOS がターミナルアプリからそのフォルダーへのアクセスをブロックしていることを意味します。そのフォルダーを読み取る他のコマンドも同様に失敗します。そこで `ls` を実行すると、`sudo` を使っても `Operation not permitted` と表示されます。3186macOS で `~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が表示される場合、通常は macOS がターミナルアプリによるそのフォルダへのアクセスをブロックしていることを意味します。そのフォルダを読み取る他のコマンドも同じように失敗します。そこで `ls` を実行すると、`sudo` を付けても `Operation not permitted` が報告されます。
3186 3187
3187**対処方法:**3188**対処方法:**
3188 3189
3189* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再実行します3190* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再度実行します
3190* ディレクトリが同じパスに再作成された場合でも、シェルは削除された方のディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て入り直してから、`claude` を再実行します3191* 同じパスにディレクトリが再作成された場合でも、シェルは削除されたディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て再び入ってから、`claude` を再度実行します
3191* macOS で `EPERM` が発生する場合は、Cmd+Q でターミナルアプリを終了し、再度開いてそのフォルダーに戻り、`claude` を実行します。それでもそのフォルダーで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ**を開いてターミナルアプリに対してそのフォルダーをオンにし、ターミナルを開き直します3192* macOS での `EPERM` の場合は、Cmd+Q でターミナルアプリを終了して再度開き、そのフォルダに戻って `claude` を実行します。それでもそのフォルダで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ**を開き、ターミナルアプリに対してそのフォルダをオンにしてから、ターミナルを開き直します
3192 3193
3193### 一時ディレクトリが拒否された、または作成できない3194### 一時ディレクトリが拒否される、または作成できない
3194 3195
3195macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) による上書き先の下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。このディレクトリを作成できない場合、またはそのパスに既に存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに、失敗内容を stderr に出力して終了コード 1 で終了します:3196macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) による上書き先の下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスに既に存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに、失敗内容を stderr に出力して終了コード 1 で終了します:
3196 3197
3197```text wrap theme={null}3198```text wrap theme={null}
3198Claude 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.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.
3204Temp 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.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.
3205```3206```
3206 3207
3207**対処方法:**3208**対処方法:**
3208 3209
3209* `could not be created` の後に `is full (ENOSPC)` が続く場合は、メッセージに示されたボリュームのディスク容量を空けます。代わりに `your disk quota on the volume holding /tmp is used up (EDQUOT)` と表示される場合は、そのボリューム上の不要になった自分のファイルを削除します3210* `could not be created` の後に `is full (ENOSPC)` が続く場合は、メッセージが示すボリュームのディスク容量を空けます。代わりに `your disk quota on the volume holding /tmp is used up (EDQUOT)` と表示される場合は、そのボリューム上の不要になった自分のファイルを削除します
3210* `Refusing to use it` 形式の場合は、リンク先ではなく、示されたエントリ自体を削除してから Claude Code を再起動します。`owned by uid` 形式の場合、削除できるのは管理者またはそのユーザーのみです3211* `Refusing to use it` 形式の場合は、リンクの参照先ではなく、示されたエントリ自体を削除してから、Claude Code を再度開始します。`owned by uid` 形式の場合、それを削除できるのは管理者またはそのユーザーのみです
3211* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再起動します3212* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再度開始します
3212* いずれの場合も、拒否されたパスはそのままにして、[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) を自分が管理するディレクトリに設定し、Claude Code を再起動することもできます3213* いずれの場合も、拒否されたパスはそのままにして、[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) を自分が管理するディレクトリに設定し、Claude Code を再度開始できます
3213 3214
3214v2.1.309 より前は、ボリュームがいっぱいになった場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。例としては `ENOSPC: no space left on device, mkdir '/tmp/claude-501'` があり、同じ手順が適用されます。3215v2.1.309 より前は、ボリュームがいっぱいの場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。例としては `ENOSPC: no space left on device, mkdir '/tmp/claude-501'` があり、同じ手順が適用されます。
3215 3216
3216### Directory couldn't be resolved to a real location3217### ディレクトリを実際の場所に解決できなかった
3217 3218
3218作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code はそのディレクトリを実際の場所に解決できませんでした。3219作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code がそのディレクトリを実際の場所に解決できませんでした。
3219 3220
3220作業ディレクトリのサブディレクトリには既にファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントのみを読み込みます。これらを読み込む前に、Claude Code は、シンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることを確認します。その場所を解決できない場合、Claude Code は何も読み込まずに次のメッセージを表示します:3221作業ディレクトリのサブディレクトリには既にファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントを読み込むだけです。Claude Code はそれらを読み込む前に、シンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることをチェックします。その場所を解決できない場合、Claude Code は何も読み込まずに次のメッセージを表示します:
3221 3222
3222```text theme={null}3223```text theme={null}
3223packages/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.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.
3224```3225```
3225 3226
3226**対処方法:**3227**対処方法:**
3227 3228
3228* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再実行します3229* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再度実行します
3229* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです3230* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです
3230 3231
3231v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。この場所では Claude Code は設計上パスを解決しないため、ディレクトリに問題はなく、再試行しても解決しませんでした。3232v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。この場所では Claude Code は設計上パスの解決を行わないため、ディレクトリに問題はなく、再試行しても解決しませんでした。
3232 3233
3233### Workspace not trusted when starting Remote Control3234### Remote Control の起動時の Workspace not trusted
3234 3235
3235> [!NOTE]3236> [!NOTE]
3236>3237>
3237> `claude ultrareview` で `Error: Workspace not trusted` が出力された場合は、代わりに [Workspace not trusted when running claude ultrareview](#workspace-not-trusted-when-running-claude-ultrareview) を参照してください。3238> `claude ultrareview` が `Error: Workspace not trusted` を出力した場合は、代わりに [claude ultrareview の実行時の Workspace not trusted](#workspace-not-trusted-when-running-claude-ultrareview) を参照してください。
3238 3239
3239信頼していないディレクトリで `claude remote-control` またはそのエイリアスの `claude rc` を使用して [Remote Control](https://code.claude.com/docs/ja/remote-control.md) のサーバーモードを開始しましたが、コマンドはそのディレクトリを信頼するかどうかを尋ねることができませんでした。たとえば、コマンドの標準入力または標準出力がリダイレクトまたはパイプされているため、ターミナルではない場合です。コマンドは終了コード 1 で終了します:3240信頼していないディレクトリで `claude remote-control` またはそのエイリアス `claude rc` を使用して [Remote Control](https://code.claude.com/docs/ja/remote-control.md) のサーバーモードを開始しましたが、コマンドがそのディレクトリを信頼するかどうかを尋ねることができませんでした。たとえば、標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、ターミナルではない場合です。コマンドは終了コード 1 で終了します:
3240 3241
3241```text theme={null}3242```text theme={null}
3242Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3243Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3243```3244```
3244 3245
3245同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションは、ディレクトリを信頼することで有効になる内容を表示するにはターミナルが小さすぎる場合、またはターミナルがサイズを報告しなかった場合に表示されます。ウィンドウを大きくするか、通常のターミナルウィンドウに切り替えてから、`claude rc` を再実行します。3246同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションが、ディレクトリを信頼することで有効になる内容を表示するには小さすぎるターミナル、またはサイズを報告しなかったターミナルで表示されます。ウィンドウを大きくするか通常のターミナルウィンドウに切り替えてから、`claude rc` を再度実行します。
3246 3247
3247ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでは上記のメッセージが表示されていましたが、その助言はホームディレクトリでは成功しません。3248ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はそこでは成功しません。
3248 3249
3249```text theme={null}3250```text theme={null}
3250Error: 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).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).
3251```3252```
3252 3253
3253[`Trust <directory>?` の質問](https://code.claude.com/docs/ja/remote-control#requirements)で `n` と答えるか Enter キーを押すと、コマンドはディレクトリ名を含む `Remote Control did not start` メッセージを出力して終了コード 1 で終了します。`claude rc` を再実行して `y` と答えてください。3254[`Trust <directory>?` の質問](https://code.claude.com/docs/ja/remote-control#requirements)に `n` と答えるか Enter を押した場合、コマンドはディレクトリを示す `Remote Control did not start` メッセージを出力し、終了コード 1 で終了します。`claude rc` を再度実行して `y` と答えます。
3254 3255
3255**対処方法:**3256**対処方法:**
3256 3257
3257* まずターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します3258* 先にターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再度実行します
3258* ホームディレクトリの場合は、プロジェクトディレクトリに移動してそこで Remote Control を開始します3259* ホームディレクトリの場合は、プロジェクトディレクトリに移動してそこで Remote Control を開始します
3259 3260
3260v2.1.284 より前は、ターミナル内であってもコマンドは確認を求めませんでした。3261v2.1.284 より前は、ターミナル内であってもコマンドは質問しませんでした。
3261 3262
3262### Workspace not trusted when running claude ultrareview3263### claude ultrareview の実行時の Workspace not trusted
3263 3264
3264信頼していないフォルダーで、[`claude ultrareview`](https://code.claude.com/docs/ja/ultrareview#trust-the-folder-before-the-review-runs) がそのフォルダーを信頼するかどうかを尋ねられない場合、レビューが始まる前に終了コード 1 で終了します:3265信頼していないフォルダで、[`claude ultrareview`](https://code.claude.com/docs/ja/ultrareview#trust-the-folder-before-the-review-runs) がそのフォルダを信頼するかどうかを尋ねられない場合、レビューが開始される前に実行は終了コード 1 で終了します:
3265 3266
3266```text theme={null}3267```text theme={null}
3267Error: 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.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.
3268```3269```
3269 3270
3270たとえば、標準入力または標準出力がターミナルではない場合、サブコマンドは確認を求めることができません。`claude ultrareview --json > findings.json` のように出力をファイルに送る場合、標準出力はターミナルではありません。3271たとえば、標準入力または標準出力がターミナルではない場合、サブコマンドは質問できません。`claude ultrareview --json > findings.json` のように出力をファイルに送ると、標準出力はターミナルではなくなります。
3271 3272
3272**対処方法:**3273**対処方法:**
3273 3274
3274* スクリプトや 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)してください。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)。
3275* 自分のマシンでは、そのフォルダーで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します3276* 自分のマシンでは、そのフォルダで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再度実行します
3276 3277
3277`claude ultrareview` からの次の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します:3278`claude ultrareview` からの次の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します:
3278 3279
3279* **`Error: Workspace not trusted. This terminal ...`**: ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告が収まりません。ターミナルを大きくするか、サイズを報告するターミナルを使用してから、`claude ultrareview` を再実行します。ホームディレクトリ以外では、そのフォルダーで一度 `claude` を実行して信頼ダイアログを承認しておくと、以降の実行では確認されなくなります。3280* **`Error: Workspace not trusted. This terminal ...`**:ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告を表示しきれません。ターミナルを大きくするか、サイズを報告するターミナルを使用してから、`claude ultrareview` を再度実行します。ホームディレクトリ以外では、そのフォルダで一度 `claude` を実行して信頼ダイアログを承認しておくこともでき、以降のそこでの実行では質問されなくなります。
3280* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりに、プロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。3281* **`Error: Workspace not trusted. <folder> is your home directory`**:ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりにプロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。
3281* **`No answer in time.` の後に `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` の質問に 5 分間回答がありませんでした。`claude ultrareview` を再実行して回答してください。3282* **`No answer in time.` の後に `Error: Workspace not trusted`**:`Trust <folder>? [y/N]` の質問に 5 分間回答がありませんでした。`claude ultrareview` を再度実行して回答します。
3282* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter キーを押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。3283* **`Ultrareview did not start: <folder> is not trusted`**:`n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再度実行して `y` と答えます。
3283* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダーを信頼しない場合は、フラグを省略します。この実行に限り信頼する場合は、PR 番号またはベースブランチをフラグの前に置きます: `claude ultrareview 1234 --trust-workspace`。3284* **``Ultrareview did not start: `--trust-workspace` takes no value``**:PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダを信頼しない場合は、フラグを外します。この実行に限り信頼するには、PR 番号またはベースブランチをフラグの前に置きます:`claude ultrareview 1234 --trust-workspace`。
3284 3285
3285v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。3286v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。
3286 3287
3287### Not carried over to the sessions Remote Control starts3288### Remote Control が開始するセッションに引き継がれない
3288 3289
3289`remote-control` という動詞の前に、`--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools`、`--mcp-config` など、Remote Control が開始するセッションを制限または設定するグローバルな `claude` フラグを付けて [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を開始しました。動詞の前に置いたフラグは、これらのセッションには渡されません。そのため Claude Code は、フラグ名を示して開始を拒否します: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 は代わりに、フラグを示して開始を拒否します:
3290 3291
3291```text theme={null}3292```text theme={null}
3292Error: `--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`).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`).
3293```3294```
3294 3295
3295`--verbose`、`--model`、またはラッパーが挿入した `--session-id` や `--plugin-dir` など、削除しても問題のないグローバルフラグについては、Claude Code は拒否しません。これらを無視し、Remote Control は開始されます。3296Claude Code は、`--verbose`、`--model`、またはラッパーが挿入した `--session-id` や `--plugin-dir` など、除外しても問題のないグローバルフラグは拒否しません。それらは無視され、Remote Control が開始されます。
3296 3297
3297Claude Code は、まだ無害と認識していないグローバルフラグに対しても開始を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。3298Claude Code は、まだ無害と認識していないグローバルフラグに対しても開始を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。
3298 3299
3299**対処方法:**3300**対処方法:**
3300 3301
3301* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でオプションの一覧を確認できます3302* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でそれらが一覧表示されます
3302* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します3303* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します
3303 3304
3304v2.1.248 より前は、グローバルフラグが先にあると `claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。3305v2.1.248 より前は、グローバルフラグが先にある場合、`claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。
3305 3306
3306### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3307### `--sandbox` or `--no-sandbox` is not supported by claude remote-control
3307 3308
3308このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを開始するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しているものの、`claude remote-control` がどちらのフラグも受け付けないことを意味します。サーバーは開始されずに終了コード 1 で終了します:3309このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを開始するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しており、`claude remote-control` がどちらのフラグも受け付けないことを意味します。サーバーは開始せずに終了コード 1 で終了します:
3309 3310
3310```text theme={null}3311```text theme={null}
3311Error: --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.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.
3312Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.3313Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.
3313```3314```
3314 3315
3315**対処方法:**3316**対処方法:**
3316 3317
3317* サーバーを開始するスクリプトやサービス定義に含まれるものも含めて、コマンドからフラグを削除してから、再実行します3318* サーバーを開始するスクリプトやサービス定義を含め、コマンドからフラグを削除してから、再度実行します
3318* サーバーが開始するセッションをサンドボックス内で実行するには、[設定ファイル](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)をオンにします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)をオンにします
3319 3320
3320どちらのフラグも v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだ含まれている可能性があります。3321両方のフラグは v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだ含まれている場合があります。
3321 3322
3322### claude import is not yet available in this build3323### claude import is not yet available in this build
3323 3324
3324[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code はインポートフローがオフになっていると判断したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。3325[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。
3325 3326
3326```text theme={null}3327```text theme={null}
3327`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3328`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3328```3329```
3329 3330
3330Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです:3331Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです:
3331 3332
3332* インストール後にまだセッションを開始していないため、Claude Code がフラグをまだ取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。3333* インストール後にまだセッションを開始していないため、Claude Code がまだフラグを取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。
3333* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps ゲートウェイ](https://code.claude.com/docs/ja/claude-apps-gateway#availability-and-limitations)経由で Claude Code を使用しています。これらのセッションでは 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` は利用できないままです。
3334* 機能フラグの取得をオフにする `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しているため、`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` は利用できないままです。
3335 3336
3336**対処方法:**3337**対処方法:**
3337 3338
3338* 新規インストールの場合は、`claude` を起動し、セッションが読み込まれるのを待ってから終了し、`claude import` を再実行します3339* 新規インストールの場合は、`claude` を開始してセッションの読み込みを待ち、終了してから `claude import` を再度実行します
3339* 機能フラグの取得がオフのままの環境では、設定を自分で行います。[`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 サーバーを読み込みません。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 サーバーを読み込みません。
3340 3341
3341### Could not read Claude Code config3342### Could not read Claude Code config
3342 3343
3343Claude Code がアカウント情報とプロジェクトごとの状態を保存するファイル `~/.claude.json` を解析できない状態で、[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否を確認するためにこのファイルを読み取りますが、対話セッションが表示する復旧ダイアログを表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルが読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログがファイルを処理していました。3344Claude Code が `~/.claude.json`(アカウントの詳細とプロジェクトごとの状態を保存するファイル)を解析できない状態で [`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否をチェックするためにこのファイルを読み込みますが、対話セッションが表示する復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルが読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログがファイルを処理していました。
3344 3345
3345```text theme={null}3346```text theme={null}
3346Could not read Claude Code config — run `claude` with no arguments to recover it.3347Could not read Claude Code config — run `claude` with no arguments to recover it.
3347```3348```
3348 3349
3349**対処方法:**3350**対処方法:**
3350 3351
3351* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出し、リセットを提案します。その後、`claude import` を再実行します。3352* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出し、リセットを提案します。その後、`claude import` を再度実行します。
3352* 手動で加えた編集を保持したい場合は、代わりにエディターで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します3353* 手動で加えた編集を残したい場合は、代わりにエディターで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します
3353 3354
3354### Could not import a server from Claude Desktop3355### Claude Desktop からサーバーをインポートできなかった
3355 3356
3356`claude mcp add-from-claude-desktop` で選択したサーバーのうち 1 つを Claude Code が追加できませんでした。コマンドは選択した他のサーバーをインポートし、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。3357Claude Code は、`claude mcp add-from-claude-desktop` で選択したサーバーのうち 1 つを追加できませんでした。コマンドは選択された他のサーバーのインポートを続行し、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。
3357 3358
3358```text theme={null}3359```text theme={null}
3359Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3360Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3360```3361```
3361 3362
3362サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではサーバー名にスペースやピリオドなどの文字を使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由には、検証に失敗するサーバー設定や、組織の [MCP ポリシー](https://code.claude.com/docs/ja/managed-mcp.md)によってブロックされたサーバーなどがあります。3363サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではサーバー名にスペースやピリオドなどの文字を使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由には、検証に失敗したサーバー設定や、組織の [MCP ポリシー](https://code.claude.com/docs/ja/managed-mcp.md)によってブロックされたサーバーなどがあります。
3363 3364
3364**対処方法:**3365**対処方法:**
3365 3366
3366* `claude_desktop_config.json` 内のサーバー名を、英字、数字、ハイフン、アンダースコアのみを使用するように変更してから、`claude mcp add-from-claude-desktop` を再実行します3367* `claude_desktop_config.json` 内のサーバー名を英字、数字、ハイフン、アンダースコアのみを使用するように変更してから、`claude mcp add-from-claude-desktop` を再度実行します
3367* `claude mcp add` または `claude mcp add-json` を使用して、有効な名前でそのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](https://code.claude.com/docs/ja/mcp.md#import-mcp-servers-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)を参照してください。
3368 3369
3369### Cannot add MCP server to the managed scope3370### managed スコープに MCP サーバーを追加できない
3370 3371
3371`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープには、組織が [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーが含まれます。Claude Code はこれらを管理設定からのみ読み込むため、コマンドでこのスコープにサーバーを書き込むことはできません。3372`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープは、組織が [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーを保持します。Claude Code はこれらを管理設定からのみ読み込むため、コマンドはこのスコープにサーバーを書き込めません。
3372 3373
3373```text theme={null}3374```text theme={null}
3374Cannot add MCP server to scope: managed3375Cannot add MCP server to scope: managed
3375```3376```
3376 3377
3377**対処方法:**3378**対処方法:**
3378 3379
3379* 書き込み可能なスコープ(`local`、`user`、または `project`)にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を参照してください3380* 書き込み可能なスコープ(`local`、`user`、`project`)にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を参照してください
3380* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) にサーバーを追加します3381* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) にサーバーを追加します
3381 3382
3382### Cannot add MCP server when managed settings allow only plugin servers3383### 管理設定がプラグインのサーバーのみを許可している場合に MCP サーバーを追加できない
3383 3384
3384組織の管理設定で [`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 で終了します: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 で終了します:
3385 3386
3386```text theme={null}3387```text theme={null}
3387Cannot 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.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.
3388```3389```
3389 3390
3390`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、その理由としてこのメッセージを示します。[`/import`](https://code.claude.com/docs/ja/commands#all-commands) は、追加しようとした各 MCP サーバーについてこのメッセージを報告し、見つかった他の項目は引き続きインポートします。3391`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、このメッセージを理由として示します。[`/import`](https://code.claude.com/docs/ja/commands#all-commands) は、追加しようとした各 MCP サーバーについてこのメッセージを報告し、検出した他の項目のインポートは続行します。
3391 3392
3392v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーは読み込まれませんでした。3393v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーは決して読み込まれませんでした。
3393 3394
3394**対処方法:**3395**対処方法:**
3395 3396
3396* サーバーを提供する[プラグイン](https://code.claude.com/docs/ja/plugins/install.md)をインストールします3397* サーバーを提供する[プラグイン](https://code.claude.com/docs/ja/plugins/install.md)をインストールします
3397* 管理者に依頼して、サーバーを[プラグイン](https://code.claude.com/docs/ja/plugins/org.md)で配布してもらうか、リモート HTTP サーバーまたは SSE サーバーの場合は [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) を通じて提供してもらいます3398* 管理者に、サーバーを[プラグイン](https://code.claude.com/docs/ja/plugins/org.md)で配布するか、リモートの HTTP または SSE サーバーであれば [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) を通じて提供するよう依頼します
3398 3399
3399### Can't read .mcp.json3400### Can't read .mcp.json
3400 3401
3401`--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 を超えていることを検出したため、ファイルを読み取らずにこのエラーで終了します。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 を超えていることを検出したため、ファイルを読み込まずにこのエラーで終了します。
3402 3403
3403```text theme={null}3404```text theme={null}
3404Can'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.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.
3405```3406```
3406 3407
3407v2.1.257 より前は、`.mcp.json` が FIFO の場合、コマンドは出力なしで永久に待機し続け、`/dev/zero` などのデバイスファイルへのシンボリックリンクの場合は、プロセスが強制終了されるまでメモリが増加していました。3408v2.1.257 より前は、`.mcp.json` にある FIFO によってコマンドが何も出力せずに永久に待機し、`/dev/zero` のようなデバイスファイルへのシンボリックリンクによってプロセスが強制終了されるまでメモリが増加していました。
3408 3409
3409**対処方法:**3410**対処方法:**
3410 3411
3411* 現在のディレクトリの `.mcp.json` にあるものを確認します。[プロジェクトスコープの形式](https://code.claude.com/docs/ja/mcp.md#project-scope)の通常の JSON ファイルに置き換えるか削除してから、コマンドを再実行します。3412* 現在のディレクトリの `.mcp.json` に何があるかを確認します。それを[プロジェクトスコープの形式](https://code.claude.com/docs/ja/mcp.md#project-scope)の通常の JSON ファイルに置き換えるか削除してから、コマンドを再度実行します。
3412 3413
3413### MCP server was not saved or removed3414### MCP サーバーが保存または削除されなかった
3414 3415
3415`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 がファイルを読み戻したときに、変更がファイルに反映されていませんでした。コマンドは成功の行を出力する代わりに、このエラーで終了します。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 が読み返したとき、その変更がファイルにありませんでした。コマンドは成功の行の代わりにこのエラーで終了します。
3416 3417
3417```text theme={null}3418```text theme={null}
3418MCP 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.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.
3419```3420```
3420 3421
3421削除の後では、メッセージは `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合、パスの後に、エントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` の形式で続きます。3422削除の後では、メッセージは `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合、パスの後に、エントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` として続きます。
3422 3423
3423v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。3424v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。
3424 3425
3425**対処方法:**3426**対処方法:**
3426 3427
3427* メッセージに示されたファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除のコマンドを再実行します。3428* メッセージが示すファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除のコマンドを再度実行します。
3428 3429
3429### MCP server may not have been saved or removed3430### MCP サーバーが保存または削除されなかった可能性がある
3430 3431
3431`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` を読み戻すことができませんでした。変更はディスクに反映されている場合もあれば、反映されていない場合もあります。括弧内のテキストは、その読み取りで発生したエラーです。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` を読み返すことができませんでした。変更はディスクに反映されている場合も、されていない場合もあります。括弧内のテキストは、その読み込みのエラーです。
3432 3433
3433```text theme={null}3434```text theme={null}
3434MCP 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.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.
3438 3439
3439v2.1.283 より前は、変更を確認できなかった場合でも、コマンドは成功を報告していました。3440v2.1.283 より前は、変更を確認できなかった場合でも、コマンドは成功を報告していました。
3440 3441
3441**対処方法:**3442**対処方法:**
3442 3443
3443* `claude mcp get <name>` を実行して、変更がディスクに反映されているかを確認します。`local` スコープのサーバーの場合、ローカルスコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。3444* `claude mcp get <name>` を実行して、変更がディスクに反映されているかどうかを確認します。`local` スコープのサーバーの場合、local スコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。
3444* 追加後にサーバーが見つからない場合、または削除後もまだ一覧に表示される場合は、同じ追加または削除のコマンドを再実行します。3445* 追加の後でサーバーが見つからない場合、または削除の後でもまだ一覧に表示される場合は、同じ追加または削除のコマンドを再度実行します。
3445 3446
3446### Server is Anthropic-hosted and doesn't support local OAuth3447### サーバーが Anthropic ホストでローカル OAuth に対応していない
3447 3448
3448サードパーティの ID プロバイダーを通じて認証する、Anthropic がホストするコネクタのホストを URL が指している 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 フローの開始を拒否します。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 フローの開始を拒否します。
3449 3450
3450```text theme={null}3451```text theme={null}
3451"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.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.
3452```3453```
3453 3454
3454**対処方法:**3455**対処方法:**
3455 3456
3456* 同じ URL の claude.ai コネクタを隠さないように、`claude mcp remove <name>` で自分のエントリを削除します3457* 同じ URL の claude.ai コネクタを隠してしまわないように、`claude mcp remove <name>` で自分のエントリを削除します
3457* 削除した後、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)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)
3458 3459
3459### Server rejected the Authorization header minted by the configured headersHelper3460### Server rejected the Authorization header minted by the configured headersHelper
3460 3461
3461[`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):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):
3462 3463
3463```text theme={null}3464```text theme={null}
3464Server 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.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.
3465```3466```
3466 3467
3467Claude Code は接続を試みるたびにヘルパーを再実行するため、トークンのローテーションの競合など、一時的な拒否の後に再試行すると、新しい認証情報で成功することがあります。3468Claude Code は接続を試みるたびにヘルパーを再実行するため、トークンローテーションの競合などの一時的な拒否の後の再試行では、新しい認証情報で成功する可能性があります。
3468 3469
3469**対処方法:**3470**対処方法:**
3470 3471
3471* 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` の値が出力されることを確認してください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` の値が出力されることを確認します
3472* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択して **Reconnect** を選択します3473* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択し、**Reconnect** を選択します
3473 3474
3474v2.1.248 より前は、ヘルパーが `Authorization` ヘッダーを提供するサーバーに対して、Claude Code は OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。3475v2.1.248 より前は、Claude Code はヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。
3475 3476
3476### MCP permission prompt tool not found3477### MCP サーバーが elicitation 機能を拒否した
3477 3478
3478[`--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 より前は、起動時にサーバーの接続完了を待たなかったため、起動が遅いだけで正常なサーバーでもこのエラーが発生していました。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` は、サーバー自身のエラーの代わりにこのメッセージとともに、サーバーを失敗として表示します:
3480
3481```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+).
3483```
3484
3485**対処方法:**
3486
3487* サーバーを Java MCP SDK 0.17.1 以降、またはメッセージが示す Spring AI のリリースのいずれかにアップグレードします
3488* または、MCP 設定のそのサーバーのエントリに `"bareElicitationCapability": true` を追加してから、Claude Code を再起動します。このフィールドは stdio、`sse`、`http`、`ws` のエントリで受け付けられ、Claude Code v2.1.281 以降が必要です
3489
3490次の `.mcp.json` エントリは、1 つの HTTP サーバーに対してこのフィールドを設定します:
3491
3492```json theme={null}
3493{
3494 "mcpServers": {
3495 "inventory": {
3496 "type": "http",
3497 "url": "https://mcp.example.com/mcp",
3498 "bareElicitationCapability": true
3499 }
3500 }
3501}
3502```
3503
3504再起動後、`/mcp` はサーバーを接続済みとして表示します。Claude Code はそのサーバーに対してのみ form モードを宣言するため、サーバーをアップグレードしたらフィールドを削除してください。
3505
3506サーバーが、`Unrecognized field "form"` を含むものなど、独自のエラーテキストで失敗することもあります。同じ修正が適用されます。
3507
3508### MCP 権限プロンプトツールが見つからない
3509
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 より前は、起動時にサーバーの接続完了を待たなかったため、起動が遅いだけの正常なサーバーでもこのエラーが発生していました。
3479 3511
3480```text theme={null}3512```text theme={null}
3481Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3513Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3482```3514```
3483 3515
3484`Available MCP tools:` の後の一覧には、接続されていた MCP ツールが示されます。3516`Available MCP tools:` の後のリストには、接続されていた MCP ツールが示されます。
3485 3517
3486**対処方法:**3518**対処方法:**
3487 3519
3488* サーバーが起動し、接続が維持されていることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして表示されることを確認してください3520* サーバーが起動して接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして一覧に表示されることを確認します
3489* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致していることを確認します3521* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致していることを確認します
3490* サーバーの起動に 30 秒以上かかる場合は、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) の値を大きくします3522* サーバーの起動に 30 秒より長くかかる場合は、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) を増やします
3491 3523
3492### OAuth callback port is already in use3524### OAuth callback port is already in use
3493 3525
3494OAuth でリモート 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 は使用可能なポートを選択するためです。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 は利用可能なポートを選択するためです。
3495 3527
3496```text theme={null}3528```text theme={null}
3497OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3529OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3498```3530```
3499 3531
3500Windows では、提案されるコマンドは代わりに `netstat -ano | findstr :<port>` になります。3532Windows では、代わりに `netstat -ano | findstr :<port>` が提案されます。
3501 3533
3502**対処方法:**3534**対処方法:**
3503 3535
3504* メッセージに示されたコマンドを実行してポートを保持しているプロセスを見つけ、停止するか終了するまで待ちます3536* メッセージのコマンドを実行してポートを保持しているプロセスを見つけ、それを停止するか終了を待ちます
3505* 別のプログラムがそのポートを恒久的に必要とする場合は、別のリダイレクト URI をサーバーに登録し、使用している方法に応じて `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します3537* 別のプログラムがそのポートを恒常的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方の `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します
3506* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します3538* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します
3507 3539
3508### No available ports for OAuth redirect3540### No available ports for OAuth redirect
3509 3541
3510[OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受信するためのローカルリスナーを起動します。そのためのローカルポートを Claude Code がバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアや、ローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。3542[OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためにローカルリスナーを開始します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアやローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。
3511 3543
3512```text theme={null}3544```text theme={null}
3513No available ports for OAuth redirect3545No available ports for OAuth redirect
3514```3546```
3515 3547
3516v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身が選択したポートをバインドできないだけの場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。3548v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身で選択したポートをバインドできないだけの場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。
3517 3549
3518**対処方法:**3550**対処方法:**
3519 3551
3520* セキュリティソフトウェアまたはサンドボックスポリシーが、プロセスによる `127.0.0.1` でのリッスンをブロックしていないか確認し、Claude Code がローカルポートをバインドできるよう許可します3552* セキュリティソフトウェアやサンドボックスポリシーがプロセスによる `127.0.0.1` でのリッスンをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるように許可します
3521* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します3553* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します
3522 3554
3523### origin/HEAD がないと /security-review が失敗する3555### origin/HEAD がないと /security-review が失敗する
3524 3556
3525[`/security-review`](https://code.claude.com/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD`(`origin` リモートでどのブランチがデフォルトかを記録するローカルの ref)との差分を取ることで、レビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する Git コマンドが失敗し、レビューは開始前に停止します。3557[`/security-review`](https://code.claude.com/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD`(`origin` リモートでどのブランチがデフォルトかを記録するローカル ref)との差分を取ることでレビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。
3526 3558
3527```text theme={null}3559```text theme={null}
3528Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3560Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3531'git <command> [<revision>...] -- [<file>...]'3563'git <command> [<revision>...] -- [<file>...]'
3532```3564```
3533 3565
3534メッセージには、代わりに `git log` や別の `git diff` が示される場合もあります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、かつフェッチの refspec がそれをカバーしている場合のみです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次の構成では ref が存在しません:3566メッセージには、代わりに `git log` や別の `git diff` が引用されている場合があります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、かつ fetch の refspec がそれをカバーしている場合のみです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次の構成では ref が存在しません:
3535 3567
3536* 狭すぎる refspec をフェッチする、単一ブランチのチェックアウトまたは CI のチェックアウト3568* refspec の fetch 範囲が狭すぎる、シングルブランチまたは CI のチェックアウト
3537* サーバー側の HEAD が、誰もプッシュしていないブランチを指しているリモート3569* サーバー側の HEAD が誰もプッシュしていないブランチを指しているリモート
3538* `origin` リモートがないリポジトリ、または一度もフェッチしていないリポジトリ3570* `origin` リモートがない、または一度も fetch していないリポジトリ
3539 3571
3540Claude Code は、[動的コンテキストを挿入する](https://code.claude.com/docs/ja/skills.md#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。3572Claude Code は、[動的コンテキストを挿入する](https://code.claude.com/docs/ja/skills.md#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。
3541 3573
3542次の類似のメッセージは、コマンドがまったく実行される前に発生します:3574関連する次のメッセージは、コマンドが実行される前に発生します:
3543 3575
3544* `Shell command permission check failed for pattern "..."`: コマンドの権限チェックでコマンドが許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止になるか、`allowed-tools` でコマンドを事前承認する方法を説明しています3576* `Shell command permission check failed for pattern "..."`:コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)で、各権限モードでどの結果が中止されるか、および `allowed-tools` でコマンドを事前承認する方法を説明しています
3545* ``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)を参照してください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)を参照してください
3546* `No shell command in <name> was run`: ファイル内の `!` コマンドのいずれかに、タブや改行以外の生の制御文字が含まれているため、どのコマンドも実行されません。[文字を見つけて削除する方法](#no-shell-command-was-run)を参照してください3578* `No shell command in <name> was run`:ファイル内の `!` コマンドのいずれかに、タブや改行以外の生の制御文字が含まれているため、どのコマンドも実行されません。[文字を見つけて削除する方法](#no-shell-command-was-run)を参照してください
3547 3579
3548**対処方法:**3580**対処方法:**
3549 3581
3550* リモートのデフォルトブランチを指定して 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` を再実行します。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` を再実行します。
3551* ブランチを指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これにより、どのブランチがデフォルトかをリモートに問い合わせます。リモートが空であるか、その HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合、`error: Cannot determine remote HEAD` で失敗します。その場合は、代わりにブランチを明示的に指定します。クローンがそのブランチをフェッチしない場合は `error: Not a valid ref` で失敗します。その場合は、まず上記のように refspec を広げます。3583* ブランチを指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これは、どのブランチがデフォルトかをリモートに問い合わせます。リモートが空である、または HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合はブランチを明示的に指定します。クローンがそのブランチを fetch しない場合は、`error: Not a valid ref` で失敗します。先に上記のように refspec を広げます。
3552* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、フェッチしてから ref を作成します。リモートが空の場合は、まず `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。この場合、`origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで `/security-review` には空の差分が表示されます。3584* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、ref を作成する前に fetch します。リモートが空の場合は、先に `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。`origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで、`/security-review` には空の差分が表示されます。
3553 3585
3554### No shell command in a skill or command was run3586### スキルまたはコマンド内のシェルコマンドが実行されなかった
3555 3587
3556スキルまたはカスタムコマンドファイル内の `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)のいずれかに、タブや改行以外の生の制御文字が含まれています。Claude Code は、ファイル内のどのコマンドも実行する前に、呼び出し全体を拒否します。3588スキルまたはカスタムコマンドのファイル内の `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)のいずれかに、タブや改行以外の生の制御文字が含まれています。Claude Code は、ファイル内のどのコマンドも実行する前に、呼び出し全体を拒否します。
3557 3589
3558メッセージには、コマンドを実行するはずだったシェルツール(Bash または PowerShell)の名前が示され、最後に拒否されたコマンドが表示されます。該当する文字はそれぞれ `�` に置き換えられるため、その位置を確認できます:3590メッセージには、コマンドを実行するはずだったシェルツール(Bash または PowerShell)が示され、最後に拒否されたコマンドが表示されます。該当する各文字は、位置がわかるように `�` に置き換えられます:
3559 3591
3560```text theme={null}3592```text theme={null}
3561No 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.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.
3562build.sh --target�dist3594build.sh --target�dist
3563```3595```
3564 3596
3565**対処方法:**3597**対処方法:**
3566 3598
3567* メッセージの最後に引用されたコマンド内の各 `�` を見つけます。それが表す文字を、スキルまたはコマンドファイルから、またはファイルに代入される引数やオプションから削除します。3599* メッセージの最後に引用されたコマンド内の各 `�` を見つけます。それが表す文字を、スキルまたはコマンドのファイル、あるいはファイルに代入される引数やオプションから削除します。
3568 3600
3569### Input must be provided when using `--print`3601### Input must be provided when using `--print`
3570 3602
3571引数なしの `claude` で対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、またはコンソールが PowerShell ISE や一部の IDE の出力ペインのように実際のターミナルではない場合、`claude` は代わりに[非対話的に](https://code.claude.com/docs/ja/headless.md)実行されます。これはプロンプトを必要とする `claude -p` と同じモードであるため、フラグを渡していなくてもメッセージには `--print` が示されます。プロンプトなしで `-p`/`--print` を渡し、stdin に何もパイプしていない場合も、どこでも同じエラーが発生します。3603引数なしの `claude` で対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、またはコンソールが本物のターミナルではない場合(PowerShell ISE や一部の IDE の出力ペインなど)、`claude` は代わりに[非対話](https://code.claude.com/docs/ja/headless.md)で実行されます。これは `claude -p` と同じモードであり、プロンプトが必要なため、フラグを渡していない場合でもメッセージには `--print` が示されます。プロンプトを指定せず stdin に何もパイプせずに `-p`/`--print` を渡した場合も、どこでも同じエラーが発生します。
3572 3604
3573```text theme={null}3605```text theme={null}
3574Error: Input must be provided either through stdin or as a prompt argument when using --print3606Error: Input must be provided either through stdin or as a prompt argument when using --print
3575```3607```
3576 3608
3577**対処方法:**3609**対処方法:**
3578 3610
3579* 対話的に使用するには、実際のターミナルで `claude` を実行します。ISE ではなく Windows Terminal または PowerShell コンソールを、出力ペインではなく IDE の統合ターミナルを使用してください3611* 対話的に使用するには、本物のターミナルで `claude` を実行します。ISE ではなく Windows Terminal または PowerShell コンソールを、出力ペインではなく IDE の統合ターミナルを使用します
3580* 1 回限りの使用では、プロンプトを渡します: `claude -p "your question"`、またはパイプで渡します: `echo "your question" | claude -p`3612* 1 回限りの使用では、プロンプトを渡すか(`claude -p "your question"`)、`echo "your question" | claude -p` のようにパイプします
3581 3613
3582### Claude Code can't read the keyboard here3614### Claude Code can't read the keyboard here
3583 3615
3584[`-p`](https://code.claude.com/docs/ja/headless) を付けずに `claude` を実行したため[対話セッション](https://code.claude.com/docs/ja/interactive-mode.md)が開始されますが、その標準入力がターミナルではありません。何かがパイプまたはリダイレクトしているか、`claude` を起動したプログラムが独自の入力ストリームを渡しています。3616[`-p`](https://code.claude.com/docs/ja/headless) を付けずに `claude` を実行して[対話セッション](https://code.claude.com/docs/ja/interactive-mode.md)を開始しましたが、その標準入力がターミナルではありません。何かがそれをパイプまたはリダイレクトしたか、`claude` を起動したプログラムが独自の入力ストリームを提供しています。
3585 3617
3586対話セッションでキー入力を読み取るにはターミナルが必要で、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります:3618対話セッションではキー入力を読み取るためのターミナルが必要であり、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります:
3587 3619
3588* **Windows**: Claude Code はインターフェースを開始せず、stderr にメッセージを出力して終了コード 1 で終了します3620* **Windows**:Claude Code はインターフェースを開始せずに、メッセージを stderr に出力して終了コード 1 で終了します
3589* **macOS と Linux**: Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストを最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その 1 行目には Windows の文言の代わりに `/dev/tty` が示されます。3621* **macOS と Linux**:Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その 1 行目には Windows の文言の代わりに `/dev/tty` が示されます。
3590 3622
3591Windows では、メッセージは次のようになります:3623Windows では、メッセージは次のとおりです:
3592 3624
3593```text theme={null}3625```text theme={null}
3594Claude 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.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.
3596To 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).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).
3597```3629```
3598 3630
3599**対処方法:**3631**対処方法:**
3600 3632
3601* 対話的に作業するには、入力をパイプやリダイレクトせずに、ターミナルで直接 `claude` を実行します3633* 対話的に作業するには、入力をパイプやリダイレクトせずに、ターミナルで直接 `claude` を実行します
3602* スクリプトからなど、対話インターフェースを使わずに応答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` と `--resume <session-id>` でも同じように機能します。3634* スクリプトなどから対話インターフェースなしで返答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` と `--resume <session-id>` でも同様に機能します。
3603 3635
3604v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。3636v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。
3605 3637
3606代わりに `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) を参照してください。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) を参照してください。
3607 3639
3608### Input contained only whitespace3640### Input contained only whitespace
3609 3641
3610[非対話モード](https://code.claude.com/docs/ja/headless.md)では、API は目に見えるテキストのないメッセージを拒否するため、Claude Code はスペース、タブ、改行だけで構成されたプロンプトを送信せずに拒否します。表示されるメッセージは、空のプロンプトがどこから来たかによって異なります:3642[非対話モード](https://code.claude.com/docs/ja/headless.md)では、API は表示可能なテキストのないメッセージを拒否するため、Claude Code はスペース、タブ、改行のみで構成されたプロンプトを送信せずに拒否します。表示されるメッセージは、空白のプロンプトがどこから来たかによって異なります:
3611 3643
3612* **`claude -p` のプロンプト引数またはパイプされた stdin**: `claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します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` で終了します
3613* **実行中の `--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.`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.`
3614 3646
3615v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API はリクエストを 400 エラーで拒否していました。3647v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API は 400 エラーでリクエストを拒否していました。
3616 3648
3617**対処方法:**3649**対処方法:**
3618 3650
3619* プロンプトに目に見えるテキストを含めます。スクリプトが変数やファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。3651* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。
3620 3652
3621### stream-json input carried over 256M characters with no newline3653### stream-json input carried over 256M characters with no newline
3622 3654
3623プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超えるデータを stdin に送信したため、Claude Code はそれ以上の入力をバッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージでは、この上限が `256M` と表記されています。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。3655プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超える内容を stdin に送信したため、Claude Code はそれ以上の入力をバッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限を `256M` と表記しています。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。
3624 3656
3625```text theme={null}3657```text theme={null}
3626Error: 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.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.
3627```3659```
3628 3660
3629改行なしでこれほど長い入力がある場合、通常は、誤ってパイプされたバイナリファイルやプレーンなログ出力など、送信元がそもそも stream-json の送信元ではないことを意味します。上限を超える単一のメッセージも、同じチェックで失敗します。3661改行なしでこれほど長い入力がある場合、通常は、誤ってパイプされたバイナリファイルやプレーンなログ出力など、プロデューサーがそもそも stream-json のプロデューサーではないことを意味します。上限を超える単一のメッセージも、同じチェックで失敗します。
3630 3662
3631**対処方法:**3663**対処方法:**
3632 3664
3633* stdin に何がパイプされているかを確認します。[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) では、各メッセージは改行で終わる 1 行の JSON である必要があります3665* stdin に何がパイプされているかを確認します。[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) では、すべてのメッセージが改行で終わる 1 行の JSON である必要があります
3634* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を削除します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります3666* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を外します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み込みます
3635 3667
3636### Unknown command3668### Unknown command
3637 3669
3638対話型のターミナルセッションで、このセッションのどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告します:3670対話型のターミナルセッションで、このセッション内のどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告します:
3639 3671
3640```text theme={null}3672```text theme={null}
3641Unknown command: /hepl. Did you mean /help?3673Unknown command: /hepl. Did you mean /help?
3642```3674```
3643 3675
3644Claude Code は、このセッションでメニューに表示される中から最も近いコマンド名またはエイリアスを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです:3676Claude Code は、このセッションでメニューに表示されるコマンド名またはエイリアスのうち、最も近いものを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです:
3645 3677
3646* `/help` を `/hepl` と入力するなどのタイプミス。送信前に近い候補を選ぶ方法については、[コマンドメニューが入力に一致させる方法](https://code.claude.com/docs/ja/commands.md#how-the-command-menu-matches-what-you-type)を参照してください3678* `/help` を `/hepl` とするなどの入力ミス。[コマンドメニューが入力内容と照合する仕組み](https://code.claude.com/docs/ja/commands.md#how-the-command-menu-matches-what-you-type)で、送信前に近い候補を選ぶ方法を説明しています
3647* 存在するものの、プラットフォーム、プラン、認証方法などの要件を満たしていないため、このセッションでは利用できないコマンド。[`/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) のような独自のメッセージで応答します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) のように独自のメッセージで応答します
3648* このセッションでインストールまたは接続されていない[プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)または [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#use-mcp-prompts-as-commands)のコマンド3680* このセッションでインストールまたは接続されていない[プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)や [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#use-mcp-prompts-as-commands)のコマンド
3649 3681
3650Claude Code が一致しない `/` 名にこのように応答するのは、対話型のターミナルセッションのみです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示す注記と、そのセッションで Claude が実行できるコマンドの一覧を添えます。これらのセッションには次のものがあります:3682Claude Code が一致しない `/` 名にこのように応答するのは、対話型のターミナルセッションのみです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったという注記と、そのセッションで Claude が実行できるコマンドの一覧を添えます。そのようなセッションには次のものがあります:
3651 3683
3652* `-p` の実行3684* `-p` の実行
3653* [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーション3685* [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーション
3655* [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)のチャットパネル3687* [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)のチャットパネル
3656* [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)と[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)3688* [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)と[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)
3657 3689
3658これらのセッションのいずれかで実行できない組み込みコマンドの場合、Claude Code は Claude に送信せず、そのコマンドが利用できないと応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとクラウドのスケジュールタスクのみでした。v2.1.273 より前は、これらも `Unknown command` と応答していました。3690これらのセッションのいずれかで実行できない組み込みコマンドについては、Claude Code は Claude に送信せずに、そのコマンドは利用できないと応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのは、クラウドセッションとクラウドのスケジュールタスクのみでした。v2.1.273 より前は、これらも `Unknown command` と応答していました。
3659 3691
3660Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合、または `/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。3692Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合や、`/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。
3661 3693
3662v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている状態で `Enter` を押すと、Claude Code はその候補を実行していたため、`/hepl` のようなタイプミスではこのメッセージの代わりに `/help` が実行されていました。3694v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている間に `Enter` を押すと、Claude Code はその候補を実行していたため、`/hepl` のような入力ミスではこのメッセージが表示される代わりに `/help` が実行されていました。
3663 3695
3664**対処方法:**3696**対処方法:**
3665 3697
3666* 提案された名前を実行するか、`/` の後に名前の一部を入力して、このセッションで利用できるものを確認します3698* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで何が利用できるかを確認します
3667* ドキュメントに記載されているコマンドを Claude Code が不明と報告する場合は、[コマンドリファレンス](https://code.claude.com/docs/ja/commands.md)でそのコマンドの行を確認し、示されている要件を確認します3699* ドキュメントに記載されたコマンドを Claude Code が不明と報告する場合は、[コマンドリファレンス](https://code.claude.com/docs/ja/commands.md)でそのコマンドの行を確認し、示されている要件を確認します
3668 3700
3669### Diff is too large for ultrareview3701### Diff is too large for ultrareview
3670 3702
3671コミットされていない変更やステージされた変更を含む、ブランチとベースブランチの差分が [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のサイズ制限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドは、クラウドセッションが開始される前にレビューを拒否します。拒否されたレビューは無料の実行回数を消費せず、使用クレジットも請求されません。メッセージには、適用されている制限、差分のサイズ、および変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには生の差分統計のみが表示されていました。3703ブランチとベースブランチの間の差分(コミットされていない変更とステージされた変更を含む)が [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のサイズ上限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。拒否されたレビューは無料実行回数を消費せず、使用クレジットも請求されません。メッセージには、適用されている上限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには差分の統計情報がそのまま表示されるだけでした。
3672 3704
3673```text theme={null}3705```text theme={null}
3674Diff 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.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.
3675```3707```
3676 3708
3677プルリクエストのレビューにも同じ制限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。3709プルリクエストのレビューにも同じ上限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。
3678 3710
3679**対処方法:**3711**対処方法:**
3680 3712
3681* `/code-review ultra develop` のように、作業内容により近いベースブランチを渡して、レビューがそのブランチとの差分のみを対象にするようにします3713* `/code-review ultra develop` のように、作業内容により近いベースブランチを指定して、そのブランチに対する差分だけがレビュー対象になるようにします
3682* 変更をより小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数が最も多いため、まずそれらを専用のブランチに移動することから始めてください。3714* 変更を小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数への寄与が最も大きいため、まずそれらを別のブランチに移してください。
3683 3715
3684### Could not find merge-base with the base branch3716### Could not find merge-base with the base branch
3685 3717
3686`/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 オブジェクト形式のようにツリー全体の差分が取れないリポジトリの場合です。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 オブジェクト形式のようにツリー全体の差分を取得できないまれなリポジトリの場合です。
3687 3719
3688```text theme={null}3720```text theme={null}
3689Could 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.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.
3690```3722```
3691 3723
3692最初の文の後に続くヒントは、Claude Code が検出した状況によって異なります。3724最初の文に続くヒントは、Claude Code が確認した状況によって異なります。
3693 3725
3694* **ベースブランチを指定しなかった場合**: Claude Code はリポジトリのデフォルトブランチと比較しており、上の例のようにベースを明示的に指定するよう提案します3726* **ベースブランチを指定しなかった場合**:Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースブランチを明示的に指定するよう提案します
3695* **クローン内に既に存在するベースブランチを指定した場合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります3727* **クローンにすでに存在するベースブランチを指定した場合**:ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります
3696* **クローンに存在しないベースブランチを指定した場合**: 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` で失敗していました。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` で失敗していました。
3697 3729
3698**対処方法:**3730**対処方法:**
3699 3731
3700* 別のブランチが実際のベースである場合は、`/code-review ultra <branch>` のように明示的に指定します3732* 別のブランチが本来のベースである場合は、`/code-review ultra <branch>` で明示的に指定します
3701* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します3733* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します
3702 3734
3703### Your checkout has no branches3735### Your checkout has no branches
3704 3736
3705チェックアウトには、コミットはあってもブランチがない場合があります。`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` サブコマンドはクラウドセッションの開始前にレビューを拒否します。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` サブコマンドはクラウドセッションの開始前にレビューを拒否します。
3706 3738
3707```text theme={null}3739```text theme={null}
3708Your 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.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.
3709```3741```
3710 3742
3711v2.1.221 より前は、Claude Code はこのチェックアウトで追跡中のすべてのファイルをレビューしようとし、アップロードが失敗していました。3743v2.1.221 より前は、Claude Code はこのチェックアウトで追跡対象のすべてのファイルのレビューを試み、アップロードが失敗していました。
3712 3744
3713**対処方法:**3745**対処方法:**
3714 3746
3715* `git checkout -b <name>` で現在のコミットにブランチを作成してから、レビューを再実行します3747* `git checkout -b <name>` で現在のコミットにブランチを作成してから、レビューを再実行します
3716 3748
3717### No GitHub account is connected to your Claude account3749### No GitHub account is connected to your Claude account
3718 3750
3719`/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 は無料実行回数を消費せず、使用クレジットも請求しません。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 は無料実行回数を消費せず、使用クレジットも請求しません。
3720 3752
3721```text theme={null}3753```text theme={null}
3722Ultrareview 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).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).
3723```3755```
3724 3756
3725セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージには claude.ai のリンクのみが記載されます。3757セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージには claude.ai のリンクのみが示されます。
3726 3758
3727**対処方法:**3759**対処方法:**
3728 3760
3729* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します3761* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します
3730* 接続してから 1 分ほど待ってレビューを再実行します3762* 接続してから 1 分ほど待ってレビューを再実行します
3731 3763
3732v2.1.248 より前は、Claude Code は起動前にこのチェックを行っていませんでした。3764v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。
3733 3765
3734### Your connected GitHub account can't see the repository3766### Your connected GitHub account can't see the repository
3735 3767
3736`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行しましたが、[Claude アカウントに接続された GitHub アカウント](https://code.claude.com/docs/ja/ultrareview.md#review-a-pull-request)が PR のリポジトリを読み取れないため、クラウドでのクローンが失敗すると判断され、Claude Code は起動を拒否しています。拒否された起動に対して、Claude Code は無料実行回数を消費せず、使用クレジットも請求しません。3768`/code-review ultra <PR#>` または `claude ultrareview <PR#>` を実行しましたが、[Claude アカウントに接続された GitHub アカウント](https://code.claude.com/docs/ja/ultrareview.md#review-a-pull-request)が PR のリポジトリを読み取れないため、クラウドでのクローンが失敗することになり、Claude Code は起動を拒否します。拒否された起動では、Claude Code は無料実行回数を消費せず、使用クレジットも請求しません。
3737 3769
3738```text theme={null}3770```text theme={null}
3739Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3771Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
3740```3772```
3741 3773
3742セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージにはアプリのインストールのみが記載されます。3774セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージにはアプリのインストールのみが示されます。
3743 3775
3744**対処方法:**3776**対処方法:**
3745 3777
3746* ローカルの `gh` CLI でリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します3778* ローカルの `gh` CLI でリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します
3747* 変更後にレビューを再実行します3779* 変更後にレビューを再実行します
3748 3780
3749v2.1.248 より前は、Claude Code は起動前にこのチェックを行っていませんでした。3781v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。
3750 3782
3751### The GitHub App preflight failed transiently3783### The GitHub App preflight failed transiently
3752 3784
3753ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかどうかを確認しましたが、そのチェックは明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消しうるエラーで終了しました。メッセージ全体は、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因で始まり、事前チェックに関する文で終わります。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>)` のようにバンドルを妨げた原因で始まり、プリフライトに関する文で終わります。
3754 3786
3755```text theme={null}3787```text theme={null}
3756Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3788Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3757```3789```
3758 3790
3759**対処方法:**3791**対処方法:**
3760 3792
3761* 少し待ってからコマンドを再実行します。GitHub のチェックに合格すると、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗によって起動がブロックされることはなくなります3793* しばらく待ってからコマンドを再実行します。GitHub の確認が成功すると、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗によって起動が妨げられることはなくなります
3762* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が記載されています。その原因が自分で修正できるものであれば修正し、ローカルリポジトリからセッションを開始できるようにします3794* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば、修正してローカルリポジトリからセッションを開始できるようにします
3763 3795
3764v2.1.251 より前は、GitHub のチェックが一時的に失敗しただけの場合でも、Claude Code はメッセージの末尾に `Please set up GitHub on https://claude.ai/code` を表示していました。一時的な失敗はセットアップの案内では解消できません。3796v2.1.251 より前は、GitHub の確認が一時的に失敗しただけの場合でも、Claude Code はメッセージの末尾に `Please set up GitHub on https://claude.ai/code` を表示していましたが、セットアップの案内では一時的な失敗は解消できません。
3765 3797
3766### The repository upload can't follow a git setting3798### リポジトリのアップロードが git 設定に対応できない
3767 3799
3768[ローカルリポジトリをアップロードするクラウドセッション](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 つに、アップロードが従うことができません。アップロードを続行してルールを見落とすと、git が保存前に変換するファイル(たとえば clean フィルターで暗号化されるファイル)が、ディスク上の状態のままクラウドに送られる可能性があります。そのため、Claude Code はアップロードを拒否し、何もアップロードされません。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 はアップロードを拒否し、何もアップロードされません。
3769 3801
3770```text theme={null}3802```text theme={null}
3771Not 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.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.
3772```3804```
3773 3805
3774メッセージには該当する設定とその設定場所が記載され、該当するケースに応じた修正方法で終わります。`core.attributesFile` と `attr.tree` についても同じ拒否が表示され、それぞれに固有の修正方法が示されます。3806メッセージには設定項目とその設定場所が示され、該当するケースの修正方法で締めくくられます。`core.attributesFile` と `attr.tree` でも同じ拒否が発生し、それぞれに固有の修正方法が示されます。
3775 3807
3776メッセージには、git の設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが記載されることがあります。これは、そのディレクティブの条件がこのリポジトリに該当しない場合でも同様です。3808メッセージには、git の設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが示されることがあります。これは、そのディレクティブの条件がこのリポジトリに該当しない場合でも同様です。
3777 3809
3778**対処方法:**3810**対処方法:**
3779 3811
3780* メッセージの最後の文に記載された修正を適用します3812* メッセージの最後の文に示された修正を適用します
3781 3813
3782### GitHub isn't connected to your Claude account3814### GitHub isn't connected to your Claude account
3783 3815
3784`/autofix-pr` などで、ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否しています。3816`/autofix-pr` などでローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか接続の有効期限が切れているため、Claude Code は起動を拒否します。
3785 3817
3786```text theme={null}3818```text theme={null}
3787GitHub 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-github3819GitHub 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
3788```3820```
3789 3821
3790[`/schedule`](https://code.claude.com/docs/ja/routines) でクラウドのスケジュールタスクを作成する場合、同じメッセージがリポジトリ名を含むセットアップの注記として表示されます。この注記によってタスクの作成がブロックされることはありません。3822[`/schedule`](https://code.claude.com/docs/ja/routines) でクラウドのスケジュールタスクを作成する場合、同じメッセージがリポジトリ名を示すセットアップの注意書きとして表示されます。この注意書きはタスクの作成を妨げません。
3791 3823
3792**対処方法:**3824**対処方法:**
3793 3825
3794* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します。2 つの方法の違いについては、[GitHub の認証オプション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#github-authentication-options)を参照してください。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)を参照してください。
3795* 接続してから 1 分ほど待ってコマンドを再実行します3827* 接続してから 1 分ほど待ってコマンドを再実行します
3796 3828
3797v2.1.268 より前は、Claude Code はこれを Claude GitHub App のチェックの一時的な失敗として報告し、再試行またはアプリのインストールを提案していました。いずれの方法でも GitHub アカウントは接続されません。3829v2.1.268 より前は、Claude Code はこれを Claude GitHub App の確認の一時的な失敗として報告し、再試行またはアプリのインストールを提案していましたが、どちらも GitHub アカウントを接続するものではありません。
3798 3830
3799### A GitHub organization policy is blocking Claude3831### GitHub 組織のポリシーが Claude をブロックしている
3800 3832
3801Claude Code のプロンプトで、[`/autofix-pr`](https://code.claude.com/docs/ja/claude-code-on-the-web#auto-fix-pull-requests) などのクラウドセッションを開始するコマンドを実行しました。Claude Code はセッションを作成する前に GitHub 上のリポジトリへの Claude のアクセスを確認しますが、GitHub 組織に Claude をブロックするポリシーがあるため、GitHub がアクセスを拒否しました。Claude Code はそこで停止し、該当するポリシーを示すメッセージを表示します。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 はその時点で停止し、該当するポリシーを示すメッセージを表示します。
3802 3834
3803IP 許可リストによってアクセスがブロックされている場合、メッセージは次のとおりです。3835IP 許可リストによってアクセスがブロックされている場合、メッセージは次のようになります。
3804 3836
3805```text theme={null}3837```text theme={null}
3806Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.3838Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.
3807```3839```
3808 3840
3809シングルサインオンによってブロックされている場合、メッセージは次のとおりです。3841シングルサインオンによってブロックされている場合、メッセージは次のようになります。
3810 3842
3811```text theme={null}3843```text theme={null}
3812Your 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.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.
3813```3845```
3814 3846
3815Microsoft Entra ID の条件付きアクセスポリシーによってブロックされている場合、メッセージは次のとおりです。3847Microsoft Entra ID の条件付きアクセスポリシーによってブロックされている場合、メッセージは次のようになります。
3816 3848
3817```text theme={null}3849```text theme={null}
3818Your 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.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.
3819```3851```
3820 3852
3821**対処方法:**3853**対処方法:**
3822 3854
3823* **IP 許可リスト**: GitHub の組織または Enterprise のオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更が必要な GitHub の設定については、[GitHub の許可リストとファイアウォール](https://code.claude.com/docs/ja/network-config.md#github-allow-lists-and-firewalls)を参照してください。3855* **IP 許可リスト**:GitHub の組織または Enterprise のオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更する GitHub の設定については、[GitHub の許可リストとファイアウォール](https://code.claude.com/docs/ja/network-config.md#github-allow-lists-and-firewalls)を参照してください。
3824* **シングルサインオン**: [claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub の接続を解除してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックし、新しい接続がその組織のシングルサインオンに対して認可されるようにします。3856* **シングルサインオン**:[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub の接続を解除してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックして、新しい接続がその組織のシングルサインオンで認可されるようにします。
3825* **条件付きアクセスポリシー**: GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します3857* **条件付きアクセスポリシー**:GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します
3826* 変更後、コマンドを再実行します3858* 変更後、コマンドを再度実行します
3827 3859
3828### Single sign-on authorization needed3860### Single sign-on authorization needed
3829 3861
3830[`/install-github-app`](https://code.claude.com/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサインオンを強制している組織のリポジトリを選択しました。Claude Code はセットアップの前に GitHub CLI でリポジトリへのアクセスを確認しますが、`gh` トークンがまだその組織に対して認可されていないため、GitHub がそのチェックを拒否しました。ウィザードには、認可の手順とともに次の警告が表示されます。3862[`/install-github-app`](https://code.claude.com/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサインオンを強制している組織のリポジトリを選択しました。Claude Code はセットアップの前に GitHub CLI でリポジトリへのアクセスを確認しますが、`gh` トークンがまだその組織に対して認可されていないため、GitHub がその確認を拒否しました。ウィザードには、認可の手順とともに次の警告が表示されます。
3831 3863
3832```text theme={null}3864```text theme={null}
3833Single sign-on authorization needed3865Single sign-on authorization needed
3834<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.3866<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.
3835```3867```
3836 3868
3837**対処方法:**3869**対処方法:**
3838 3870
3839* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` のスコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します3871* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` のスコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します
3840* `GH_TOKEN` の個人用アクセストークンで認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します3872* `GH_TOKEN` で個人用アクセストークンを使って認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します
3841* `/install-github-app` を再度実行します3873* `/install-github-app` を再度実行します
3842 3874
3843v2.1.273 より前は、Claude Code はこの状況で代わりに `Admin permissions required` の警告を表示していました。3875v2.1.273 より前は、Claude Code はこの状況で代わりに `Admin permissions required` の警告を表示していました。
3844 3876
3845### Failed to resume the conversation3877### Failed to resume the conversation
3846 3878
3847[`claude --resume` ピッカー](https://code.claude.com/docs/ja/sessions#use-the-session-picker)で選択したセッションについて、保存されたトランスクリプトを Claude Code が読み取ることも処理することもできなかったため、部分的に読み込まれた状態で続行するのではなく、プロセスを終了します。メッセージには再試行用のコマンドが含まれます。3879[`claude --resume` のピッカー](https://code.claude.com/docs/ja/sessions#use-the-session-picker)で選択したセッションの保存済みトランスクリプトを Claude Code が読み取れないか処理できなかったため、部分的に読み込まれた状態で続行するのではなくプロセスを終了します。メッセージには再試行用のコマンドが含まれます。
3848 3880
3849```text theme={null}3881```text theme={null}
3850Failed to resume the conversation.3882Failed to resume the conversation.
3851Run claude --resume <session-id> to retry, or claude to start a new session.3883Run claude --resume <session-id> to retry, or claude to start a new session.
3852```3884```
3853 3885
3854Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは実行を続けます。v2.1.216 より前は、`claude --resume` ピッカーからの再開に失敗すると、このメッセージを表示せずに `Resuming conversation…` のスピナーが表示されたままになっていました。3886Claude Code はメッセージを表示した後、コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは引き続き実行されます。v2.1.216 より前は、`claude --resume` のピッカーから再開に失敗すると、このメッセージを表示する代わりに `Resuming conversation…` のスピナーが表示されたままになっていました。
3855 3887
3856**対処方法:**3888**対処方法:**
3857 3889
3858* メッセージに記載されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します3890* メッセージに示されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します
3859* v2.1.285 より前のバージョンで再試行が同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存されたトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。3891* v2.1.285 より前のバージョンで、再試行しても同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。
3860* 再試行が再び失敗する場合は、`claude` を実行して新しいセッションを開始します3892* 再試行しても再び失敗する場合は、`claude` を実行して新しいセッションを開始します
3861 3893
3862### No conversation found with the session ID3894### No conversation found with the session ID
3863 3895
3867No conversation found with session ID: <session-id>3899No conversation found with session ID: <session-id>
3868```3900```
3869 3901
3870Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は ID を[まず現在のプロジェクトで検索し、次にこのマシン上の他のすべてのプロジェクトで検索](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)します。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree までに限られていたため、セッションが最後に作業していたディレクトリから再開する必要がありました。3902Claude Code はメッセージを表示した後、コード 1 で終了します。Claude Code は [ID を現在のプロジェクトから検索し、その後このマシン上の他のすべてのプロジェクトを検索します](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開してください。
3871 3903
3872主な原因:3904主な原因:
3873 3905
3874* **ID の入力ミス**: 非インタラクティブな実行の場合、ID は [`--output-format json` の出力](https://code.claude.com/docs/ja/headless#get-structured-output)の `session_id` フィールドです3906* **ID の入力ミス**:非対話型の実行の場合、ID は [`--output-format json` の出力](https://code.claude.com/docs/ja/headless#get-structured-output)の `session_id` フィールドです
3875* **トランスクリプトの削除**: 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)に従って削除します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)に従ってトランスクリプトを削除します
3876* **別のマシン**: Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開します3908* **別のマシン**:Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開してください
3877* **重複したコピー**: `~/.claude/projects` 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらかのコピーを任意に再開するのではなく、このメッセージを表示します3909* **重複したコピー**:`~/.claude/projects` 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらかのコピーを任意に再開するのではなく、このメッセージを報告します
3878 3910
3879**対処方法:**3911**対処方法:**
3880 3912
3881* インタラクティブセッションの場合は、`claude --resume` で[セッションピッカー](https://code.claude.com/docs/ja/sessions.md#use-the-session-picker)を開き、`Ctrl+A` を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します3913* 対話型セッションの場合は、`claude --resume` で[セッションピッカー](https://code.claude.com/docs/ja/sessions.md#use-the-session-picker)を開き、`Ctrl+A` を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します
3882* `claude -p` や [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) で作成したセッションはピッカーに表示されないため、元の実行で出力された `session_id` と ID を照合し直します3914* `claude -p` または [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) で作成したセッションはピッカーに表示されないため、元の実行で出力された `session_id` と ID を照合し直してください
3883 3915
3884### Windows reported an error (EBADF) when Claude Code read this session's transcript file3916### Windows reported an error (EBADF) when Claude Code read this session's transcript file
3885 3917
3886Windows でセッションを再開したところ、保存された[トランスクリプトファイル](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)は正常に開けたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーには読み取りが失敗した理由が示されないため、メッセージには考えられる原因と試すべきことが示されます。3918Windows でセッションを再開したところ、保存済みの[トランスクリプトファイル](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)は正常に開けたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーからは読み取りが失敗した理由がわからないため、メッセージには考えられる原因と試すべきことが示されます。
3887 3919
3888```text theme={null}3920```text theme={null}
3889Windows 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.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.
3890```3922```
3891 3923
3892このメッセージは、`Failed to resume session <session-id>` のようなコマンド自体の失敗を示す行の後に続きます。`claude --resume` または [`claude -p`](https://code.claude.com/docs/ja/headless) コマンドは、メッセージを表示した後、終了コード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションは実行を続けます。3924このメッセージは、`Failed to resume session <session-id>` のようなコマンド自体の失敗を示す行に続いて表示されます。`claude --resume` または [`claude -p`](https://code.claude.com/docs/ja/headless) コマンドは、これを表示した後にコード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションが引き続き実行されます。
3893 3925
3894**対処方法:**3926**対処方法:**
3895 3927
3896* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアの対象から、セッションのトランスクリプトを保存するフォルダーを除外します。トランスクリプトはデフォルトでは `%USERPROFILE%\.claude\projects` 配下、または [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) で指定したディレクトリ配下に保存されます3928* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたは傍受するソフトウェアの対象から、セッションのトランスクリプトを保存するフォルダーを除外します。トランスクリプトはデフォルトでは `%USERPROFILE%\.claude\projects` 配下、または [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) で指定されたディレクトリ配下に保存されます
3897* 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します3929* 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します
3898* セッションを再度再開します3930* セッションを再度再開します
3899 3931
3900v2.1.282 より前は、この失敗には説明がありませんでした。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようなシステムエラーのテキストのみが出力されていました。3932v2.1.282 より前は、失敗時に説明が表示されませんでした。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようなシステムエラーのテキストのみが出力されていました。
3901 3933
3902### Cannot switch renderers in this session3934### Cannot switch renderers in this session
3903 3935
3904レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を断るセッションで [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります。3936レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を見送るセッションで [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージから原因がわかります。
3905 3937
3906* `Cannot switch renderers while work is running in the background`: バックグラウンドシェルやサブエージェントなど、再起動によって破棄されてしまうバックグラウンドの作業が実行中です。作業が完了するのを待つか、[`/tasks`](https://code.claude.com/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します3938* `Cannot switch renderers while work is running in the background`:バックグラウンドのシェルやサブエージェントなど、再起動によって放棄されることになるバックグラウンドの作業が実行中です。作業が完了するのを待つか [`/tasks`](https://code.claude.com/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します
3907* `Cannot switch renderers in this session`: このセッションには、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました3939* `Cannot switch renderers in this session`:再起動後のプロセスに Claude Code が引き継げない制限がセッションに設定されています。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました
3908 3940
3909制限に関するメッセージでは、括弧内に Claude Code が検出した制限が示されます。3941制限に関するメッセージでは、括弧内の部分に Claude Code が検出した制限が示されます。
3910 3942
3911```text theme={null}3943```text theme={null}
3912Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3944Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
3914 3946
3915メッセージの括弧内に表示される可能性のある理由は次のとおりです。3947メッセージの括弧内に表示される可能性のある理由は次のとおりです。
3916 3948
3917* `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) が含まれます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) があります
3918* `permission rules set for this session only`: フックまたは SDK の呼び出し元からの[権限の更新](https://code.claude.com/docs/ja/hooks.md#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。許可ルールは再起動で破棄され、Claude Code は代わりに再度確認を求めます3950* `permission rules set for this session only`:フックまたは SDK の呼び出し元からの[権限の更新](https://code.claude.com/docs/ja/hooks.md#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。再起動するとそれらは破棄され、Claude Code は代わりに再度確認を求めます
3919* `ask-before-running rules with no command-line form`: フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` および `--disallowed-tools` として引き継ぐルールに加えて、確認ルールが追加されました。確認ルール用のフラグは存在しません3951* `ask-before-running rules with no command-line form`:フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` および `--disallowed-tools` として引き継ぐルールとあわせて確認ルールが追加されました。確認ルールに対応するフラグはありません
3920* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`: 権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継ぐことができません3952* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`:権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継ぐことができません
3921 3953
3922**対処方法:**3954**対処方法:**
3923 3955
3924* これらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻す場合は `/tui default` を実行します。Claude Code は、そのセッションで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します3956* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻す場合は `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します
3925 3957
3926### Claude Code couldn't restart3958### Claude Code couldn't restart
3927 3959
3928このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は自身を再起動している最中(たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングへの切り替えまたは解除を行うため)に新しいプロセスを開始できなかったため、ステータス 1 で終了しました。3960このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングへの切り替えやその解除のために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。
3929 3961
3930```text theme={null}3962```text theme={null}
3931Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.3963Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.
3932```3964```
3933 3965
3934再起動時に再開する会話がなかった場合(たとえば、新しいセッションで最初の入力が `/tui` だった場合)、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。3966新しいセッションで最初の入力が `/tui` だった場合など、再起動時に再び開く会話がなかった場合、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。
3935 3967
3936**対処方法:**3968**対処方法:**
3937 3969
3938* シェルで `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)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)
3939* 再起動が失敗し続ける場合は、シェルから [`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)際には、その行を含めてください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)際にはその行を含めてください
3940 3972
3941### Couldn't open Claude Desktop3973### Couldn't open Claude Desktop
3942 3974
3943セッション内で [`/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 で終了します。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 で終了します。
3944 3976
3945括弧内のテキストには、失敗したコマンドが、その終了ステータスとエラー出力の最初の行(出力があった場合)とともに示されます。macOS では、この例のようにコマンドは `open` です。Windows では `rundll32` です。3977括弧内のテキストには、失敗したコマンドと、終了ステータスおよびエラー出力の 1 行目(出力された場合)が示されます。macOS ではこの例のようにコマンドは `open` で、Windows では `rundll32` です。
3946 3978
3947```text theme={null}3979```text theme={null}
3948Error: 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.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.
3949```3981```
3950 3982
3951**対処方法:**3983**対処方法:**
3952 3984
3953* Claude Desktop を手動で開いてから、`/desktop` または `claude --desktop` を再度実行します3985* Claude Desktop を自分で開いてから、`/desktop` または `claude --desktop` を再度実行します
3954* 失敗したコマンドのエラー出力全体を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します3986* 失敗したコマンドのエラー出力全体を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します
3955 3987
3956v2.1.285 より前は、メッセージの末尾は `Open Claude Desktop and run /desktop again.` でした。v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されていませんでした。3988v2.1.285 より前は、メッセージの末尾は `Open Claude Desktop and run /desktop again.` でした。v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されていませんでした。
3957 3989
3958### /terminal-setup left your Zed keymap unchanged3990### /terminal-setup で Zed のキーマップが変更されなかった
3959 3991
3960Zed で [`/terminal-setup`](https://code.claude.com/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code は Zed の `keymap.json` の更新を完了できなかったため、ファイルをそのままにしました。3992Zed で [`/terminal-setup`](https://code.claude.com/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code が Zed の `keymap.json` の更新を完了できなかったため、ファイルはそのままにされました。
3961 3993
3962各メッセージにはキーマップのパスが示され、末尾には自分で追加するためのキーボードショートカットのブロックが記載されます。3994各メッセージにはキーマップのパスが示され、自分で追加するためのキーボードショートカットのブロックで締めくくられます。
3963 3995
3964```text theme={null}3996```text theme={null}
3965Couldn't update your Zed keymap, so it was left unchanged.3997Couldn't update your Zed keymap, so it was left unchanged.
3967{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3999{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
3968```4000```
3969 4001
3970メッセージの最初の行に原因が示されます。4002メッセージの 1 行目に原因が示されます。
3971 4003
3972* `Couldn't read your Zed keymap, so it was left unchanged.`: ファイルの権限などの理由で、Claude Code がファイルを読み取れませんでした4004* `Couldn't read your Zed keymap, so it was left unchanged.`:ファイルの権限などが原因で、Claude Code がファイルを読み取れませんでした
3973* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: ファイルは読み取れましたが、`//` コメントと末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません4005* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`:ファイルは読み取れましたが、`//` コメントと末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません
3974* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code がファイルを同じ場所の `.bak` バックアップにコピーできなかったため、何も変更しませんでした4006* `Couldn't back up your Zed keymap; not modifying it.`:Claude Code がファイルを同じ場所の `.bak` バックアップにコピーできなかったため、何も変更しませんでした
3975* `Couldn't update your Zed keymap, so it was left unchanged.`: マージ結果が、ショートカットを含む有効なキーマップであると検証できなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックが原因となることがあります4007* `Couldn't update your Zed keymap, so it was left unchanged.`:マージした結果が、キーボードショートカットを含む有効なキーマップとして検証できなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックがあると、これが発生することがあります
3976 4008
3977**対処方法:**4009**対処方法:**
3978 4010
3979* メッセージに記載されたブロックを、メッセージに示されたパスにある `keymap.json` のトップレベルの配列にコピーします4011* メッセージに示されたパスにある `keymap.json` のトップレベルの配列に、メッセージのブロックをコピーします
3980* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します4012* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します
3981 4013
3982v2.1.247 より前は、`/terminal-setup` は `//` コメントや末尾のカンマを使用した Zed のキーマップを解析できず、ファイル全体を自身のショートカットのみで置き換えたうえで、ショートカットがインストールされたと報告していました。以前のバージョンによって置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)で説明されている `.bak` バックアップファイルを使用します。4014v2.1.247 より前は、`/terminal-setup` は `//` コメントや末尾のカンマを使用している Zed のキーマップを解析できず、キーボードショートカットがインストールされたと報告しながら、ファイル全体を自身のキーボードショートカットのみに置き換えていました。以前のバージョンで置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)で説明している `.bak` バックアップファイルを使用してください。
3983 4015
3984### Skill usage reports are not available on this connection4016### Skill usage reports are not available on this connection
3985 4017
3986スマートフォンやブラウザから [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 経由では送信せず、代わりにこのメッセージを返します。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 経由で送信せず、代わりに次のメッセージで応答します。
3987 4019
3988```text theme={null}4020```text theme={null}
3989Skill usage reports are not available on this connection.4021Skill usage reports are not available on this connection.
3990```4022```
3991 4023
3992**対処方法:**4024**対処方法:**
3993 4025
3994* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そこで `claude -p "/skill-doctor"` を実行します4026* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そこで `claude -p "/skill-doctor"` を実行します
3995 4027
3996### Custom output styles can't be selected over Remote Control4028### Custom output styles can't be selected over Remote Control
3997 4029
3998モバイルアプリまたは Web から [Remote Control](https://code.claude.com/docs/ja/remote-control.md) 経由で [`/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)の名前を指定した場合も、存在しない名前と同じ応答が返されます。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)の名前には、存在しない名前と同じ応答が返されます。
3999 4031
4000```text theme={null}4032```text theme={null}
4001Custom 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.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.
4002```4034```
4003 4035
4004**対処方法:**4036**対処方法:**
4005 4037
4006* `/output-style concise` のように、組み込みスタイルを選択します4038* `/output-style concise` のように、組み込みスタイルを選択します
4007* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体のターミナルがある場合はそこで `/output-style <style>` を実行します4039* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体のターミナルがある場合はそこで `/output-style <style>` を実行します
4008 4040
4009### Output styles are saved to local settings which this session doesn't load4041### Output styles are saved to local settings which this session doesn't load
4010 4042
4011設定ソースから `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 は効果のない設定を書き込む代わりに拒否します。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 は効果のない設定を書き込む代わりに拒否します。
4012 4044
4013```text theme={null}4045```text theme={null}
4014Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.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.
4015```4047```
4016 4048
4017**対処方法:**4049**対処方法:**
4018 4050
4019* セッションの設定ソースに `local` を追加してから、再度切り替えます4051* セッションの設定ソースに `local` を追加してから、再度切り替えます
4020* プロジェクトの `.claude/settings.json` や `~/.claude/settings.json` など、セッションが読み込む設定ファイルで [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) キーを設定します。TypeScript SDK では、代わりにインラインの `settings` オブジェクト内で `outputStyle` を設定します。[出力スタイルを有効にする](https://code.claude.com/docs/ja/agent-sdk/modifying-system-prompts.md#activate-an-output-style)を参照してください4052* プロジェクトの `.claude/settings.json` や `~/.claude/settings.json` など、セッションが読み込む設定ファイルで [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) キーを設定します。TypeScript SDK では、代わりにインラインの `settings` オブジェクト内で `outputStyle` を設定します。[出力スタイルを有効にする](https://code.claude.com/docs/ja/agent-sdk/modifying-system-prompts.md#activate-an-output-style)を参照してください
4021 4053
4022### /recap only runs when you ask for it yourself4054### /recap only runs when you ask for it yourself
4023 4055
4024[`/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)や別のプログラムが送信したプロンプトで届きました。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)や別のプログラムが送信したプロンプトで届きました。
4025 4057
4026中継されたメッセージは、自分で書いたものであってもこの通知の対象になります。Claude Code は、中継または自動化されたメッセージがセッションを実行しているアカウントの本人からのものかどうかを判別できないため、要約の代わりにこの通知で応答します。4058中継されたメッセージは、自分で書いたものであっても通知の対象になります。Claude Code は、中継または自動化されたメッセージがセッションを実行しているアカウントの本人から送られたものかどうかを判別できないため、要約の代わりに次の通知で応答します。
4027 4059
4028```text theme={null}4060```text theme={null}
4029/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.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.
4030```4062```
4031 4063
4032`claude -p` に渡した `/recap`、または自分の [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーションが起動したセッションに送信する `/recap` は、自分自身の入力として扱われます。4064`claude -p` に渡した `/recap` や、自分の [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーションが起動したセッションに送信する `/recap` は、ユーザー自身の入力として扱われます。
4033 4065
4034**対処方法:**4066**対処方法:**
4035 4067
4036* 自分でセッションを開いて `/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) 経由で実行できます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` を実行します
4037* クラウドのスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します4069* クラウドのスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します
4038 4070
4039### /feedback is disabled by your organization's policy4071### /feedback is disabled by your organization's policy
4044/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.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.
4045```4077```
4046 4078
4047メッセージが最初の文のみの場合もあります。4079メッセージが最初の文だけの場合もあります。
4048 4080
4049**対処方法:**4081**対処方法:**
4050 4082
4051* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成します。そこにある issue は誰でも閲覧できるため、コード、トランスクリプト、その他の機密情報は含めないでください。4083* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成します。そこにある issue は誰でも閲覧できるため、コード、トランスクリプト、その他の機密情報は含めないでください。
4052 4084
4053v2.1.302 より前は、メッセージ全体は `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。4085v2.1.302 より前は、完全なメッセージは `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。
4054 4086
4055## プラグインエラー4087## プラグインエラー
4056 4088