61| `Could not resolve authentication method` | [認証](#could-not-resolve-authentication-method) |61| `Could not resolve authentication method` | [認証](#could-not-resolve-authentication-method) |
62| `Invalid API key` | [認証](#invalid-api-key) |62| `Invalid API key` | [認証](#invalid-api-key) |
63| `Your apiKeyHelper script is failing` | [認証](#your-apikeyhelper-script-is-failing) |63| `Your apiKeyHelper script is failing` | [認証](#your-apikeyhelper-script-is-failing) |
64| `Claude Code didn't send your claude.ai login, because the API key helper your administrator set isn't in effect` | [認証](#claude-code-didnt-send-your-claude-ai-login) |64| `Your organization's settings need an update` | [認証](#claude-code-didnt-send-your-claude-ai-login) |
65| `Couldn't load your organization's settings. Check your connection` | [認証](#claude-code-didnt-send-your-claude-ai-login) |
66| `Restart Claude Code to finish signing in` | [認証](#claude-code-didnt-send-your-claude-ai-login) |
65| `Invalid auth token · Fix external auth token` | [認証](#invalid-request-header-value) |67| `Invalid auth token · Fix external auth token` | [認証](#invalid-request-header-value) |
66| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [認証](#invalid-request-header-value) |68| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [認証](#invalid-request-header-value) |
67| `Invalid request header from the environment · Fix the environment variable` | [認証](#invalid-request-header-value) |69| `Invalid request header from the environment · Fix the environment variable` | [認証](#invalid-request-header-value) |
1117 1119
1118### Claude Code didn't send your claude.ai login1120### Claude Code didn't send your claude.ai login
1119 1121
1120このメッセージ全文を管理者に送ってください。メッセージには管理者が行える変更が記載されています。このメッセージは、Claude Code がプロンプトを拒否したことを意味します。claude.ai ログインを使用している間、Claude Code は再起動後もプロンプトを拒否し続けます。1122次のメッセージは、Claude Code がリクエストを拒否し、claude.ai のログインを送信しなかったことを意味します。
1121 1123
1122```text theme={null}1124```text theme={null}
1123Claude Code didn't send your claude.ai login, because the API key helper your administrator set isn't in effect. Your organization's managed settings may be overriding it. Ask your administrator to keep the key helper and its API address in effect, to name Anthropic's API address in those managed settings, or to remove the key helper. Run /status to see your setting sources.1125Your organization's settings need an update. Ask your administrator to fix the API key helper configuration.
1126Couldn't load your organization's settings. Check your connection, then restart Claude Code.
1127Restart Claude Code to finish signing in.
1124```1128```
1125 1129
1126**対処方法:**1130**対処方法:**
1127 1131
1128* マシンにどの管理ソースがあるかを管理者に伝えるには、Claude Code のプロンプトで `/status` を実行し、[`Setting sources` 行](https://code.claude.com/docs/ja/managed-settings#read-the-source-in-/status)をコピーします。`Skipped sources` 行が表示される場合は、それもコピーします1132* `Your organization's settings need an update`: 管理者に API キーヘルパーの設定を修正するよう依頼します
1129* 設定を管理している場合は、[マシンのキーヘルパーが有効にならない理由](https://code.claude.com/docs/ja/server-managed-settings.md#machine-apikeyhelper-not-in-effect)を参照してください1133 * マシンにどの管理ソースがあるかを管理者に伝えるには、Claude Code のプロンプトで `/status` を実行し、[`Setting sources` の行](https://code.claude.com/docs/ja/managed-settings#read-the-source-in-/status)をコピーします。`Skipped sources` の行が表示されている場合は、それもコピーします
1134 * 設定を管理していて、ヘルパーがマシンの管理設定ファイルまたは MDM ポリシーにある場合は、[マシンの `apiKeyHelper` が有効になっていない場合](https://code.claude.com/docs/ja/server-managed-settings#machine-apikeyhelper-not-in-effect)を参照してください
1135* `Couldn't load your organization's settings`: 接続を確認してから、Claude Code を再起動します。再起動後もメッセージが再び表示される場合は、管理者に伝えます
1136* `Restart Claude Code to finish signing in`: Claude Code を再起動します
1137
1138v2.1.315 より前では、拒否されたプロンプトやファイルアップロードは、`Claude Code didn't send your claude.ai login` で始まる 1 つのメッセージを出力していました。
1130 1139
1131### 無効なリクエストヘッダー値1140### 無効なリクエストヘッダー値
1132 1141
3092 3101
3093## コマンドラインエラー3102## コマンドラインエラー
3094 3103
3095これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、そして `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。3104これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、および `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。
3096 3105
3097### `--bg` と `--print` の競合3106### `--bg` と `--print` の競合
3098 3107
3099このメッセージには 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 より前は、この組み合わせにより、アタッチできないバックグラウンドジョブが何も通知されずに作成されていました。3108このメッセージには 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 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが何の通知もなく作成されていました。
3100 3109
3101```text theme={null}3110```text theme={null}
3102--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>'`.3111--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>'`.
3103```3112```
3104 3113
3105**対処方法:**3114**対処方法：**
3106 3115
3107* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` だけで完全なコマンドになります。[シェルから新しいエージェントをディスパッチする](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。3116* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` で完全なコマンドになります。[シェルから新しいエージェントをディスパッチする](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。
3108* バックグラウンドセッションを作成せずにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します3117* バックグラウンドセッションを作成する代わりにプロンプトを非対話的に実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します
3109 3118
3110### Couldn't tell whether `--bg` is a flag or text3119### Couldn't tell whether `--bg` is a flag or text
3111 3120
3112`--bg` または `--background` を、Claude Code がバックグラウンドフラグとして意図したのかテキストとして意図したのかを判別できない位置に置いて `claude` を実行しました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:3121Claude Code がバックグラウンドフラグとテキストのどちらを意図したのか判断できない位置で、`--bg` または `--background` を付けて `claude` を実行しました。このコマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました：
3113 3122
3114```text theme={null}3123```text theme={null}
3115Couldn'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>3124Couldn'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>
3116```3125```
3117 3126
3118`--background` と入力した場合は、この行には代わりに `--background` が示されます。3127`--background` と入力した場合、この行には代わりに `--background` と表示されます。
3119 3128
3120**対処方法:**3129**対処方法：**
3121 3130
3122* [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始するには、フラグを先頭にしてシェルでコマンドを再実行します: `claude --bg --name nightly-audit "<task>"`3131* [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始するには、フラグを先頭に置いてシェルでコマンドを再実行します：`claude --bg --name nightly-audit "<task>"`
3123 3132
3124### システムプロンプトフラグとそのファイル形式の競合3133### システムプロンプトフラグとそのファイル形式の競合
3125 3134
31261 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:31351 回の `claude` 呼び出しで [`--append-subagent-system-prompt`](https://code.claude.com/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します：
3127 3136
3128```text theme={null}3137```text theme={null}
3129Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.3138Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
3130```3139```
3131 3140
3132v2.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)されるのではなく競合していたためです。これらのバージョンでは、メッセージには組み合わせたペアが示されます。3141v2.1.283 より前は、`--system-prompt` と `--system-prompt-file`、または `--append-system-prompt` と `--append-system-prompt-file` を渡した場合も、これらのペアが[組み合わされる](https://code.claude.com/docs/ja/cli-reference.md#system-prompt-flags)のではなく競合していたため、`claude` は同じように終了していました。これらのバージョンでは、メッセージに組み合わせたペアの名前が示されます。
3133 3142
3134**対処方法:**3143**対処方法：**
3135 3144
3136* フラグのどちらか一方の形式だけを残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします3145* フラグの一方の形式だけを残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします
3137 3146
3138### Invalid `--agents` configuration3147### Invalid `--agents` configuration
3139 3148
3140`--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 はそれでもセッションを開始していました。3149`--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 はそのままセッションを開始していました。
3141 3150
3142```text theme={null}3151```text theme={null}
3143Error: Invalid --agents configuration:3152Error: Invalid --agents configuration:
3144<what failed>3153<what failed>
3145```3154```
3146 3155
31471 行目に続く内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順番に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:3156最初の行に続く内容は、値がどのように失敗したかによって異なります。Claude Code はこれらのチェックを順番に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます：
3148 3157
31491. 値が `{` で始まっているのに JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します31581. 値が `{` で始まるが JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します
31502. 解析はできたものの、エージェント定義が [CLI で定義されたサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)のスキーマと一致しない場合、Claude Code は問題ごとに 1 行を出力します31592. 解析はできるが、エージェント定義が [CLI で定義されたサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)のスキーマと一致しない場合、Claude Code は問題ごとに 1 行を出力します
31513. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します31603. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します
3152 3161
3153問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。3162問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。
3154 3163
3155`--print` を使用する場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。たとえば次のようなものです:3164`--print` を使用する場合、`--agents` はインラインオブジェクトの代わりに [JSON ファイルへのパス](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。次のようなものがあります：
3156 3165
3157* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み取ります。3166* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**：Claude Code は対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み取ります。
3158* **`Error: --agents file not found: <path>`**: そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって壊されたインライン JSON もこの形で失敗することがあります。パスまたはクォートを確認し、コマンドを再実行してください。3167* **`Error: --agents file not found: <path>`**：そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって崩れたインライン JSON もこのように失敗することがあります。パスまたはクォートを確認して、コマンドを再実行してください。
3159 3168
3160**対処方法:**3169**対処方法：**
3161 3170
3162* メッセージに記載された各問題を修正してから、コマンドを再実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を参照してください。3171* メッセージに列挙された各問題を修正してから、コマンドを再実行します。[CLI で定義されたサブエージェントが受け取るフィールド](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)を参照してください。
3163 3172
3164### Cloud sessions cannot be created from a `--restricted` session3173### Cloud sessions cannot be created from a `--restricted` session
3165 3174
3166[`--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 はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:3175[`--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 はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません：
3167 3176
3168```text theme={null}3177```text theme={null}
3169Cloud sessions cannot be created from a --restricted session: they would not enforce it.3178Cloud sessions cannot be created from a --restricted session: they would not enforce it.
3170```3179```
3171 3180
3172**対処方法:**3181**対処方法：**
3173 3182
3174* 制限されたセッションでタスクをローカルに実行します3183* 制限されたセッションでタスクをローカルに実行します
3175* セッションの起動方法を制御できる場合は、`--restricted` を指定せずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します3184* セッションの起動方法を制御できる場合は、`--restricted` なしで新しい `claude` セッションを開始し、そこからクラウドセッションを作成します
3176 3185
3177v2.1.248 より前の Claude Code には `--restricted` フラグがなく、以前のバージョンではフラグ自体が不明なオプションのエラーとして拒否されます。3186v2.1.248 より前は、Claude Code に `--restricted` フラグはありませんでした。それ以前のバージョンでは、フラグ自体が不明なオプションのエラーで拒否されます。
3178 3187
3179### Cloud sessions are disabled by your organization's policy3188### Cloud sessions are disabled by your organization's policy
3180 3189
3181組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)とそれを使用するコマンドは利用できません:3190組織の `allow_remote_sessions` ポリシーがオフになっているため、[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)とそれを使用するコマンドは利用できません：
3182 3191
3183```text theme={null}3192```text theme={null}
3184Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.3193Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
3185```3194```
3186 3195
3187このメッセージは、[ターミナルからクラウドセッションを作成する](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) が返されていました。3196このメッセージは、[ターミナルからクラウドセッションを作成する](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) が返されていました。
3188 3197
3189メッセージがこのセッションで使用している認証情報の名前を示し、`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)が表示されます。3198メッセージが代わりにこのセッションで使用している認証情報の名前を示し、`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)が表示されます。
3190 3199
3191**対処方法:**3200**対処方法：**
3192 3201
3193* 組織の [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 管理設定でクラウドセッションを有効にしてもらいます3202* 組織の [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 管理設定でクラウドセッションを有効にするよう依頼します
3194 3203
3195### Cloud sessions use your claude.ai login3204### Cloud sessions use your claude.ai login
3196 3205
3197[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージがこのセッションで使用している認証情報の名前を示し、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai ログインが属する組織とは異なる場合があります:3206[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージがこのセッションで使用している認証情報の名前を示し、この文で終わる場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーを確認しました。その組織は、claude.ai ログインが属する組織と異なる場合があります：
3198 3207
3199```text theme={null}3208```text theme={null}
3200Cloud 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.3209Cloud 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.
3201```3210```
3202 3211
3203最後の文は、クラウドセッションはその認証情報ではなく claude.ai ログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合も Claude Code は組織の管理者に連絡するよう伝える形式を出力していました。3212最後の文は、クラウドセッションがその認証情報ではなく claude.ai ログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信するときに表示されます。v2.1.296 より前は、この場合も組織の管理者に連絡するよう伝える形式が出力されていました。
3204 3213
3205### Couldn't verify your organization's policy for cloud sessions3214### Couldn't verify your organization's policy for cloud sessions
3206 3215
3207これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、次のメッセージが表示されます:3216これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を作成、再開、またはメッセージを送信する前にこのポリシーを確認します。ポリシーのリクエストが完了していない間、メッセージは次のとおりです：
3208 3217
3209```text theme={null}3218```text theme={null}
3210Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.3219Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.
3211```3220```
3212 3221
3213セッション内では、`/teleport` や `/web-setup` などクラウドセッションを必要とするコマンドもこのメッセージを表示します。シェルであれば `Cloud sessions aren't available:` 形式が出力される場合でもこのメッセージが表示され、その 2 文目は `Check your network connection, then restart Claude Code and try again.` となります。3222セッション内では、`/teleport` や `/web-setup` などクラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルでは `Cloud sessions aren't available:` 形式が出力される場合でもこのメッセージが表示され、その 2 文目は `Check your network connection, then restart Claude Code and try again.` となります。
3214 3223
3215ポリシーのリクエストが失敗すると、メッセージには何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に適用されます。API への経路がない場合、メッセージは次のようになります:3224ポリシーのリクエストが失敗した後は、メッセージに何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用してシェルからクラウドセッションを開始、再開、またはメッセージを送信する場合に当てはまります。API への経路がない場合、メッセージは次のようになります：
3216 3225
3217```text theme={null}3226```text theme={null}
3218Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.3227Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.
3219```3228```
3220 3229
3221その他の失敗は同じ書き出しに続けてそれぞれの原因を示します。たとえば、HTTP 403 でリクエストを拒否したプロキシ、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai ログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその名前が示され、設定を解除するよう伝えられることもあります:3230その他の失敗も同じ書き出しに続けて、HTTP 403 でリクエストを拒否したプロキシ、サーバーエラー、API が受け付けなかった認証情報など、それぞれの原因を示します。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai ログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージはその名前を示し、設定を解除するよう伝えることもあります：
3222 3231
3223```text theme={null}3232```text theme={null}
3224Cloud 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.3233Cloud 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.
3226 3235
3227v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。3236v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。
3228 3237
3229**対処方法:**3238**対処方法：**
3230 3239
3231* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内では、先に Claude Code を再起動します3240* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内では、先に Claude Code を再起動します
3232* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や示された認証情報の設定解除など、その原因に応じた対処を行ってから、コマンドを再実行します3241* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や名前が示された認証情報の設定解除など、その原因に応じた対処を行ってから、コマンドを再実行します
3233 3242
3234### フォルダーが追跡対象のファイルを置き換えたため何もスタッシュされなかった3243### フォルダーが追跡対象ファイルを置き換えたため何も stash されなかった
3235 3244
3236このメッセージは、チェックアウト内で、以前 git で追跡されていたファイルまたはリンクがあった場所にフォルダーが存在することを意味します。`claude --teleport` や `/teleport` などで[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#from-cloud-to-terminal)をターミナルに取り込む際にスタッシュのオプションを選択すると表示されます。その状態をスタッシュするとフォルダー内のファイルが削除される可能性があるため、Claude Code はスタッシュを拒否し、チェックアウトとインデックスを変更しないままにします:3245このメッセージは、チェックアウト内で、以前は 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 を拒否し、チェックアウトとインデックスを変更せずに残します：
3237 3246
3238```text wrap theme={null}3247```text wrap theme={null}
3239Error: 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.3248Error: 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.
3240```3249```
3241 3250
3242**対処方法:**3251**対処方法：**
3243 3252
3244* メッセージのとおり、変更をコミットするかフォルダーを別の場所に移動してから、Teleport を再実行します3253* メッセージのとおり、変更をコミットするかフォルダーを別の場所に移動してから、teleport を再実行します
3245 3254
3246### The `--json-schema` value is not a valid JSON Schema3255### The `--json-schema` value is not a valid JSON Schema
3247 3256
3253 3262
32542 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` をアノテーションとして受け付け、強制はしません。32632 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` をアノテーションとして受け付け、強制はしません。
3255 3264
3256Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON でない値は `Error: --json-schema is not valid JSON` で拒否し、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否します。3265Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON ではない値は `Error: --json-schema is not valid JSON` で拒否し、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否します。
3257 3266
3258**対処方法:**3267**対処方法：**
3259 3268
3260* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します3269* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します
3261* 動作するスキーマとコマンドについては、[構造化出力を取得する](https://code.claude.com/docs/ja/headless.md#get-structured-output)を参照してください3270* 動作するスキーマとコマンドについては、[構造化出力を取得する](https://code.claude.com/docs/ja/headless.md#get-structured-output)を参照してください
3262 3271
3263### Settings file exceeds the 2MiB limit3272### Settings file exceeds the 2MiB limit
3264 3273
3265[`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` は起動時にそのファイルを読み込まずに終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み取っていたため、数 GB のファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。3274[`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB より大きいため、`claude` はそれを読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み取っていたため、数ギガバイトのファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。
3266 3275
3267```text theme={null}3276```text theme={null}
3268Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3277Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
3269```3278```
3270 3279
3271Claude Code は、通常のファイルではない `--settings` のパスも同様に拒否します。デバイス、FIFO、ソケットの場合はパスに続けて `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` が報告され、ディレクトリの場合は `EISDIR` が理由として報告されます。3280Claude Code は、通常のファイルではない `--settings` パスも同じように拒否します。デバイス、FIFO、またはソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` の後にパスが表示され、ディレクトリの場合は `EISDIR` の理由が表示されます。
3272 3281
3273**対処方法:**3282**対処方法：**
3274 3283
3275* `--settings` には 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](https://code.claude.com/docs/ja/settings.md)を参照してください。3284* `--settings` には 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](https://code.claude.com/docs/ja/settings.md)を参照してください。
3276 3285
3277### Configuration error in \~/.claude.json3286### Configuration error in \~/.claude.json
3278 3287
3279Claude Code は、アカウント情報、MCP サーバー、プロジェクトごとの状態を保持するファイルである `~/.claude.json` を解析できませんでした。ファイルは変更されていません。`claude -p` などの[非対話](https://code.claude.com/docs/ja/headless.md)での起動は、ファイルを修復するまで毎回終了コード 1 で終了します。3288Claude Code は、アカウントの詳細、MCP サーバー、プロジェクトごとの状態を保持するファイルである `~/.claude.json` を解析できませんでした。ファイルは変更されていません。`claude -p` などの[非対話](https://code.claude.com/docs/ja/headless.md)での起動は、ファイルを修復するまで毎回終了コード 1 で終了します。
3280 3289
3281Claude Code が[バックアップ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)を見つけた場合、出力にはそのバックアップが示され、それをコピーして元に戻す `cp` 行が出力されます：3290Claude Code が[バックアップ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)を見つけた場合、出力にはそのバックアップの名前と、それをコピーして元に戻す `cp` 行が表示されます：
3282 3291
3283```text wrap theme={null}3292```text wrap theme={null}
3284Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>3293Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>
3291 3300
3292**対処方法：**3301**対処方法：**
3293 3302
3294* **出力に `cp` 行がある場合**：その行をターミナルで実行します。Windows では PowerShell で実行します。これにより、壊れたファイルが、`~/.claude.json` の以前のバージョンであるバックアップに置き換えられます。3303* **出力に `cp` 行がある場合**：その行をターミナルで実行します。Windows では PowerShell で実行します。壊れたファイルが、`~/.claude.json` の以前のバージョンであるバックアップに置き換えられます。
3295* **出力に `cp` 行がない場合、または実行後もエラーが再発する場合**：`~/.claude.json` の JSON を修正するか、[`~/.claude/backups/`](https://code.claude.com/docs/ja/claude-directory#cleaned-up-automatically) に別の `.claude.json.backup.<timestamp>` ファイルがあればそれで上書きコピーするか、ファイルの名前を変更します。`~/.claude.json` にファイルがない場合、Claude Code はデフォルト設定で起動し、ファイルが保持していた内容は一切引き継がれません。3304* **出力に `cp` 行がない場合、または実行後もエラーが再発する場合**：`~/.claude.json` の JSON を修正するか、[`~/.claude/backups/`](https://code.claude.com/docs/ja/claude-directory#cleaned-up-automatically) に別の `.claude.json.backup.<timestamp>` ファイルがあればそれで上書きコピーするか、ファイルの名前を変更します。`~/.claude.json` にファイルがない場合、Claude Code はデフォルト設定で起動し、ファイルが保持していた内容は何も引き継がれません。
3296 3305
3297v2.1.318 より前は、非対話での起動でこのエラーが出力された後、`~/.claude.json` がデフォルトの状態になっていたため、次回の起動は設定なしで実行されていました。3306v2.1.318 より前は、非対話での起動でこのエラーが出力された後、`~/.claude.json` にデフォルト値が残されていたため、次回の起動は設定なしで実行されていました。
3298 3307
3299### Claude configuration file was empty and no backup holds anything3308### Claude configuration file was empty and no backup holds anything
3300 3309
3301起動時にこのメッセージが表示された場合、示されたファイルが空で、そのファイルの [`.backup` コピー](https://code.claude.com/docs/ja/claude-directory#cleaned-up-automatically)にも何も含まれていないことを意味します。Claude Code は、そのファイルが保持する内容についてはデフォルトで起動しました。`settings.json` ファイルと `.mcp.json` は別のファイルです。3310起動時のこのメッセージは、名前が示されたファイルが空で、そのファイルのどの [`.backup` コピー](https://code.claude.com/docs/ja/claude-directory#cleaned-up-automatically)にも内容がないことを意味します。Claude Code は、そのファイルが保持する内容についてデフォルト値で起動しました。`settings.json` ファイルと `.mcp.json` は別のファイルです。
3302 3311
3303```text wrap theme={null}3312```text wrap theme={null}
3304Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.3313Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.
3306 3315
3307**対処方法：**3316**対処方法：**
3308 3317
3309* そのファイルで設定していた内容を再度設定します。たとえば、ターミナルから `claude mcp add` を使用して、`user` スコープと `local` スコープの [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を追加します。3318* そのファイルで設定していた内容を再設定します。たとえば、ターミナルから `claude mcp add` を使用して、`user` および `local` スコープの [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を追加します。
3310* Claude Code から求められた場合は、再度サインインします3319* Claude Code から求められた場合は、再度サインインします
3311 3320
3312v2.1.318 より前は、Claude Code はバックアップのない空のファイルを[破損](#configuration-error-in-claude-json)として報告していました。3321v2.1.318 より前は、Claude Code はバックアップのない空のファイルを[破損](#configuration-error-in-claude-json)として報告していました。
3313 3322
3314### The current directory no longer exists3323### The current directory no longer exists
3315 3324
3316シェルが移動した後に削除または移動されたディレクトリ（たとえば、別のシェルが削除した worktree や一時ディレクトリ）から `claude` を起動しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](https://code.claude.com/docs/ja/headless.md)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code はミニファイされたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。3325シェルが移動した後に削除または移動されたディレクトリ（たとえば別のシェルが削除した worktree や一時ディレクトリ）から `claude` を起動しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](https://code.claude.com/docs/ja/headless.md)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、Claude Code はこのメッセージの代わりに、stderr に縮小化されたバンドルソースと生の `ENOENT ... uv_cwd` スタックを出力してクラッシュしていました。
3317 3326
3318```text theme={null}3327```text theme={null}
3319The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3328The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
3322 3331
3323原因と修正方法はどちらの形式でも同じです。3332原因と修正方法はどちらの形式でも同じです。
3324 3333
3325権限の変更など別の理由で Claude Code が作業ディレクトリを読み取れない場合、メッセージには代わりにエラーコードが示されます: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3334権限の変更など別の理由で Claude Code が作業ディレクトリを読み取れない場合、メッセージには代わりにエラーコードが示されます：`Can't read the current directory (EACCES). Start Claude Code from a different directory.`
3326 3335
3327macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が発生する場合、通常は macOS がターミナルアプリからそのフォルダーへのアクセスをブロックしていることを意味します。そのフォルダーを読み取る他のコマンドも同様に失敗します。そこで `ls` を実行すると、`sudo` を使っても `Operation not permitted` と報告されます。3336macOS では、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対する `EPERM` は、通常、macOS がターミナルアプリからそのフォルダーへのアクセスをブロックしていることを意味します。そのフォルダーを読み取る他のコマンドも同じように失敗します。そこで `ls` を実行すると、`sudo` を使用しても `Operation not permitted` と報告されます。
3328 3337
3329**対処方法:**3338**対処方法：**
3330 3339
3331* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再実行します3340* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再実行します
3332* ディレクトリが同じパスに再作成された場合、シェルは削除されたディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て再度入り直してから、`claude` を再実行します3341* ディレクトリが同じパスに再作成された場合でも、シェルは削除されたディレクトリを保持したままです。`cd "$PWD"` を実行するか、ディレクトリから出て再度入ってから、`claude` を再実行します
3333* macOS で `EPERM` が発生した場合は、Cmd+Q でターミナルアプリを終了して再度開き、そのフォルダーに戻って `claude` を実行します。それでもそのフォルダーで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ** を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを開き直します3342* macOS での `EPERM` の場合は、Cmd+Q でターミナルアプリを終了し、再度開いてそのフォルダーに戻り、`claude` を実行します。そのフォルダーで `ls` がまだ失敗する場合は、**System Settings > Privacy & Security > Files and Folders** を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを再度開きます
3334 3343
3335### 一時ディレクトリが拒否された、または作成できない3344### 一時ディレクトリが拒否される、または作成できない
3336 3345
3337macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) による上書き先の下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスにすでに存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに失敗内容を stderr に出力し、終了コード 1 で終了します:3346macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) による上書き先の下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスにすでに存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せず、失敗内容を stderr に出力して終了コード 1 で終了します：
3338 3347
3339```text wrap theme={null}3348```text wrap theme={null}
3340Claude 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.3349Claude 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.
3346Temp 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.3355Temp 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.
3347```3356```
3348 3357
3349**対処方法:**3358**対処方法：**
3350 3359
3351* `could not be created` の後に `is full (ENOSPC)` が続く場合は、メッセージに示されたボリュームのディスク容量を空けます。代わりに `your disk quota on the volume holding /tmp is used up (EDQUOT)` と表示される場合は、そのボリューム上の自分のファイルのうち不要になったものを削除します3360* `could not be created` の後に `is full (ENOSPC)` が続く場合は、メッセージが示すボリュームのディスク領域を解放します。代わりに `your disk quota on the volume holding /tmp is used up (EDQUOT)` と表示される場合は、そのボリューム上の不要になった自分のファイルを削除します
3352* `Refusing to use it` 形式の場合は、リンクの参照先ではなく、示されたエントリ自体を削除してから Claude Code を再起動します。`owned by uid` 形式の場合、そのエントリを削除できるのは管理者またはそのユーザーのみです3361* `Refusing to use it` 形式の場合は、リンク先ではなく名前が示されたエントリ自体を削除し、Claude Code を再起動します。`owned by uid` 形式の場合、削除できるのは管理者またはそのユーザーのみです
3353* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再起動します3362* `is not readable` の場合は、名前が示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再起動します
3354* いずれの場合も、拒否されたパスはそのままにして、[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) を自分が管理するディレクトリに設定し、Claude Code を再起動することもできます3363* いずれの場合も、[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars) を自分が管理するディレクトリに設定して Claude Code を再起動できます。拒否されたパスはそのままにしておきます
3355 3364
3356v2.1.309 より前は、ボリュームがいっぱいの場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。例は `ENOSPC: no space left on device, mkdir '/tmp/claude-501'` で、同じ手順が適用されます。3365v2.1.309 より前は、ボリュームが満杯の場合やクォータを使い切った場合、Claude Code はオペレーティングシステムのエラーテキストのみを出力していました。たとえば `ENOSPC: no space left on device, mkdir '/tmp/claude-501'` のようなもので、同じ手順が適用されます。
3357 3366
3358### Directory couldn't be resolved to a real location3367### Directory couldn't be resolved to a real location
3359 3368
3360作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code はそのディレクトリを実際の場所に解決できませんでした。3369作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code はそのディレクトリを実際の場所に解決できませんでした。
3361 3370
3362作業ディレクトリのサブディレクトリにはすでにファイルアクセスがあるため、`/add-dir` はそのスキル、コマンド、エージェントの読み込みのみを行います。それらを読み込む前に、Claude Code はシンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることをチェックします。Claude Code がその場所を解決できない場合は、何も読み込まずに次のメッセージを表示します:3371作業ディレクトリのサブディレクトリにはすでにファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントのみを読み込みます。これらを読み込む前に、Claude Code は、シンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることを確認します。その場所を解決できない場合、Claude Code は何も読み込まず、次のメッセージを表示します：
3363 3372
3364```text theme={null}3373```text theme={null}
3365packages/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.3374packages/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.
3366```3375```
3367 3376
3368**対処方法:**3377**対処方法：**
3369 3378
3370* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再実行します3379* パスが作業ディレクトリ内の実際のディレクトリを指していることを確認してから、`/add-dir` を再実行します
3371* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです3380* このメッセージによってファイルアクセスは変更されません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです
3372 3381
3373v2.1.261 より前は、作業ディレクトリが `/net/<host>` のオートマウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。Claude Code はこの場所では設計上パスの解決を行いません。ディレクトリ自体に問題はなく、再試行しても解決しませんでした。3382v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でこのメッセージが表示されていました。このような場所では、Claude Code は設計上パスの解決を行いません。ディレクトリに問題はなく、再試行しても解決しませんでした。
3374 3383
3375### Remote Control 起動時の Workspace not trusted3384### Workspace not trusted when starting Remote Control
3376 3385
3377> [!NOTE]3386> [!NOTE]
3378>3387>
3379> `claude ultrareview` で `Error: Workspace not trusted` が出力された場合は、代わりに [claude ultrareview 実行時の Workspace not trusted](#workspace-not-trusted-when-running-claude-ultrareview) を参照してください。3388> `claude ultrareview` で `Error: Workspace not trusted` が出力された場合は、代わりに [Workspace not trusted when running claude ultrareview](#workspace-not-trusted-when-running-claude-ultrareview) を参照してください。
3380 3389
3381信頼していないディレクトリで `claude remote-control` またはそのエイリアスの `claude rc` を使用して [Remote Control](https://code.claude.com/docs/ja/remote-control.md) のサーバーモードを開始しましたが、コマンドはそのディレクトリを信頼するかどうかを尋ねることができませんでした。たとえば、標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、コマンドの標準入力または標準出力がターミナルではない場合です。コマンドは終了コード 1 で終了します:3390信頼していないディレクトリで `claude remote-control` またはそのエイリアス `claude rc` を使用して [Remote Control](https://code.claude.com/docs/ja/remote-control.md) のサーバーモードを開始しましたが、コマンドはそのディレクトリを信頼するかどうかを尋ねることができませんでした。たとえば、標準入力または標準出力のいずれかがリダイレクトまたはパイプされているため、ターミナルではない場合です。コマンドは終了コード 1 で終了します：
3382 3391
3383```text theme={null}3392```text theme={null}
3384Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3393Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3385```3394```
3386 3395
3387同じく `Error: Workspace not trusted.` で始まる 2 つのバリエーションは、ディレクトリを信頼すると何が有効になるかを表示するにはターミナルが小さすぎる場合、またはターミナルがサイズを報告しなかった場合に表示されます。ウィンドウを拡大するか通常のターミナルウィンドウに切り替えてから、`claude rc` を再実行してください。3396`Error: Workspace not trusted.` で始まる 2 つのバリエーションは、ディレクトリを信頼することで有効になる内容を表示するには小さすぎるターミナル、またはサイズを報告しなかったターミナルで表示されます。ウィンドウを拡大するか通常のターミナルウィンドウに切り替えてから、`claude rc` を再実行します。
3388 3397
3389ホームディレクトリではメッセージが異なります。ワークスペースの信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承認してもこのチェックを満たせないからです。v2.1.214 より前は、ホームディレクトリでも上記のメッセージが表示されていましたが、その助言はホームディレクトリでは成功しません。3398ホームディレクトリではメッセージが異なります。ワークスペース信頼ダイアログはホームディレクトリに対する信頼を保存しないため、そこで承諾してもこのチェックを満たすことはできません。v2.1.214 より前は、ホームディレクトリでは上記のメッセージが表示されていましたが、その助言はホームディレクトリでは成功しません。
3390 3399
3391```text theme={null}3400```text theme={null}
3392Error: 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).3401Error: 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).
3393```3402```
3394 3403
3395[`Trust <directory>?` の質問](https://code.claude.com/docs/ja/remote-control#requirements)で `n` と答えるか Enter を押すと、コマンドはディレクトリ名を示す `Remote Control did not start` メッセージを出力し、終了コード 1 で終了します。`y` と答えるには `claude rc` を再実行してください。3404[`Trust <directory>?` の質問](https://code.claude.com/docs/ja/remote-control#requirements)に `n` と答えるか Enter を押すと、コマンドはディレクトリ名を示す `Remote Control did not start` メッセージを出力し、終了コード 1 で終了します。`y` と答えるには `claude rc` を再実行します。
3396 3405
3397**対処方法:**3406**対処方法：**
3398 3407
3399* まずターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します3408* まずターミナルからディレクトリを信頼します。そこで `claude rc` を実行して `y` と答えるか、そこで `claude` を実行して[ワークスペース信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承諾してから、元のコマンドを再実行します
3400* ホームディレクトリの場合は、プロジェクトディレクトリに移動し、そこで Remote Control を開始します3409* ホームディレクトリにいる場合は、プロジェクトディレクトリに移動してそこで Remote Control を開始します
3401 3410
3402v2.1.284 より前は、ターミナル内であってもコマンドが尋ねることはありませんでした。3411v2.1.284 より前は、ターミナル内であってもコマンドが尋ねることはありませんでした。
3403 3412
3404### claude ultrareview 実行時の Workspace not trusted3413### Workspace not trusted when running claude ultrareview
3405 3414
3406信頼していないフォルダーで、[`claude ultrareview`](https://code.claude.com/docs/ja/ultrareview#trust-the-folder-before-the-review-runs) がそのフォルダーを信頼するかどうかを尋ねられない場合、実行はレビューの開始前に終了コード 1 で終了します:3415信頼していないフォルダーで、[`claude ultrareview`](https://code.claude.com/docs/ja/ultrareview#trust-the-folder-before-the-review-runs) がフォルダーを信頼するかどうかを尋ねられない場合、レビューが開始される前に終了コード 1 で終了します：
3407 3416
3408```text theme={null}3417```text theme={null}
3409Error: 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.3418Error: 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.
3410```3419```
3411 3420
3412たとえば、標準入力または標準出力がターミナルでない場合、サブコマンドは尋ねることができません。`claude ultrareview --json > findings.json` のように出力をファイルに送ると、標準出力はターミナルではなくなります。3421たとえば、標準入力または標準出力がターミナルではない場合、このサブコマンドは尋ねることができません。`claude ultrareview --json > findings.json` のように出力をファイルに送ると、標準出力はターミナルではなくなります。
3413 3422
3414**対処方法:**3423**対処方法：**
3415 3424
3416* スクリプトまたは 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)。3425* スクリプトや 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)。
3417* 自分のマシンでは、そのフォルダーで `claude` を実行して[ワークスペースの信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承認してから、元のコマンドを再実行します3426* 自分のマシンでは、そのフォルダーで `claude` を実行して[ワークスペース信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)を承諾してから、元のコマンドを再実行します
3418 3427
3419`claude ultrareview` からの以下の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します:3428`claude ultrareview` からの次の各メッセージは、レビューが開始されず、終了コードが 1 であることを意味します：
3420 3429
3421* **`Error: Workspace not trusted. This terminal ...`**: ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告を表示しきれません。ターミナルを拡大するか、サイズを報告するターミナルを使用してから、`claude ultrareview` を再実行します。ホームディレクトリ以外では、そのフォルダーで一度 `claude` を実行して信頼ダイアログを承認しておくと、以降の実行では尋ねられなくなります。3430* **`Error: Workspace not trusted. This terminal ...`**：ターミナルが行数と列数を報告しなかったか、信頼の質問とその警告を表示できません。ターミナルを拡大するかサイズを報告するターミナルを使用してから、`claude ultrareview` を再実行します。ホームディレクトリ以外では、そのフォルダーで一度 `claude` を実行して信頼ダイアログを承諾しておくこともでき、以降そこで実行する際には尋ねられなくなります。
3422* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりに、プロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。3431* **`Error: Workspace not trusted. <folder> is your home directory`**：ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても役に立ちません。代わりに、プロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承諾した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。
3423* **`No answer in time.` に続いて `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` の質問に 5 分間回答がありませんでした。`claude ultrareview` を再実行して回答してください。3432* **`No answer in time.` の後に `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` の質問に 5 分間回答がありませんでした。`claude ultrareview` を再実行して回答します。
3424* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。3433* **`Ultrareview did not start: <folder> is not trusted`**：`n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。
3425* **``Ultrareview did not start: `--trust-workspace` takes no value``**：PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダーを信頼しない場合は、フラグを省略します。この実行に限り信頼する場合は、PR 番号またはベースブランチをフラグの前に置きます：`claude ultrareview 1234 --trust-workspace`。3434* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` の後に、PR 番号や `false` など、フラグ以外のものが続いています。フォルダーを信頼しない場合は、フラグを省略します。この実行でフォルダーを信頼するには、PR 番号またはベースブランチをフラグの前に置きます：`claude ultrareview 1234 --trust-workspace`。
3426 3435
3427v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。3436v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。
3428 3437
3429### Not carried over to the sessions Remote Control starts3438### Not carried over to the sessions Remote Control starts
3430 3439
3431`remote-control` 動詞の前にグローバルな `claude` フラグを置いて [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を開始しました。そのフラグは、`--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools`、`--mcp-config` など、Remote Control が開始するセッションを制限または設定するものです。動詞の前に置いたフラグは、それらのセッションには届きません。Claude Code は代わりに、そのフラグ名を示して開始を拒否します:3440`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 は代わりに、フラグ名を示して起動を拒否します：
3432 3441
3433```text theme={null}3442```text theme={null}
3434Error: `--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`).3443Error: `--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`).
3435```3444```
3436 3445
3437`--verbose`、`--model`、またはラッパーによって挿入される `--session-id` や `--plugin-dir` など、削除しても問題のないグローバルフラグについては、Claude Code は拒否しません。それらを無視して Remote Control を開始します。3446`--verbose`、`--model`、ラッパーによって挿入された `--session-id` や `--plugin-dir` など、削除しても無害なグローバルフラグについては、Claude Code は拒否しません。これらを無視して Remote Control を開始します。
3438 3447
3439Claude Code は、まだ無害と認識していないグローバルフラグに対しても開始を拒否します。そのため、新しいリリースで追加されたフラグは、後のリリースで無害とマークされるまでこのメッセージに表示されることがあります。3448Claude Code は、まだ無害と認識していないグローバルフラグについても起動を拒否するため、新しいリリースで追加されたフラグは、後のリリースで無害としてマークされるまでこのメッセージに表示されることがあります。
3440 3449
3441**対処方法:**3450**対処方法：**
3442 3451
3443* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でそれらの一覧を確認できます3452* 動詞の前からフラグを削除し、[Remote Control 独自のオプション](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session)を動詞の後に渡します。`claude remote-control --help` でオプションの一覧を確認できます
3444* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します3453* 拒否されたフラグが `--permission-mode` の場合は、`claude remote-control --permission-mode <mode>` を実行して、Remote Control が開始するセッションの権限モードを設定します
3445 3454
3446v2.1.248 より前は、グローバルフラグが先にある場合、`claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。3455v2.1.248 より前は、グローバルフラグが先にあると `claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。
3447 3456
3448### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3457### `--sandbox` or `--no-sandbox` is not supported by claude remote-control
3449 3458
3450このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを開始するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しているものの、`claude remote-control` がどちらのフラグも受け付けないことを意味します。サーバーは開始せずに終了コード 1 で終了します:3459このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを起動するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しているものの、`claude remote-control` がどちらのフラグも受け付けないことを意味します。サーバーは起動せずに終了コード 1 で終了します：
3451 3460
3452```text theme={null}3461```text theme={null}
3453Error: --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.3462Error: --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.
3454Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.3463Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.
3455```3464```
3456 3465
3457**対処方法:**3466**対処方法：**
3458 3467
3459* サーバーを自動的に開始するスクリプトやサービス定義も含め、コマンドからフラグを削除してから再実行します3468* サーバーを自動で起動するスクリプトやサービス定義内も含め、コマンドからフラグを削除してから再実行します
3460* サーバーが開始するセッションをサンドボックス化するには、[設定ファイル](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)をオンにします3469* サーバーが開始するセッションをサンドボックス化するには、[設定ファイル](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)をオンにします
3461 3470
3462両方のフラグは v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだいずれかが含まれている可能性があります。3471両方のフラグは v2.1.300 で `claude remote-control` から削除されたため、以前のバージョン向けに書かれたコマンドにはまだどちらかが含まれている可能性があります。
3463 3472
3464### claude import is not yet available in this build3473### claude import is not yet available in this build
3465 3474
3466[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code がインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` がプロンプトとして扱われ、このメッセージを出力する代わりに対話セッションが開始されていました。3475[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しましたが、Claude Code はインポートフローがオフになっていることを検出したため、コマンドはインポートを開始せずに終了コード 1 で終了します。v2.1.222 より前は、インポートフローがオフのビルドでは `import` をプロンプトとして扱い、このメッセージを出力する代わりに対話セッションを開始していました。
3467 3476
3468```text theme={null}3477```text theme={null}
3469`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3478`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3470```3479```
3471 3480
3472Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです:3481Claude Code は、Anthropic から取得してディスクにキャッシュする機能フラグによって `claude import` をオンにします。このメッセージは、キャッシュされた値がオフであることを意味します。原因は通常、次のいずれかです：
3473 3482
3474* インストール後にセッションを開始していないため、Claude Code がまだフラグを取得していません。機能が利用可能な場合でも、最初の `claude import` でこのメッセージが出力されることがあります。3483* インストール後にまだセッションを開始していないため、Claude Code がまだフラグを取得していません。最初の `claude import` では、機能が利用可能な場合でもこのメッセージが出力されることがあります。
3475* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway#availability-and-limitations) を通じて Claude Code を使用しています。これらのセッションでは Claude Code は機能フラグを取得しないため、`claude import` は利用できないままです。3484* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway#availability-and-limitations) を通じて Claude Code を使用しています。これらのセッションでは Claude Code は機能フラグを取得しないため、`claude import` は利用できないままです。
3476* 機能フラグの取得をオフにする `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しているため、`claude import` は利用できないままです。3485* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、または [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しています。これらは機能フラグの取得をオフにするため、`claude import` は利用できないままです。
3477 3486
3478**対処方法:**3487**対処方法：**
3479 3488
3480* 新規インストールの場合は、`claude` を起動し、セッションが読み込まれるのを待ってから終了し、`claude import` を再実行します3489* 新規インストールの場合は、`claude` を起動し、セッションが読み込まれるのを待ってから終了し、`claude import` を再実行します
3481* 機能フラグの取得がオフのままの環境では、設定を自分で行います。[`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 サーバーを読み取りません。3490* 機能フラグの取得がオフのままの環境では、設定を自分で行います。[`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 サーバーを読み取りません。
3482 3491
3483### Could not read Claude Code config3492### Could not read Claude Code config
3484 3493
3485アカウントの詳細とプロジェクトごとの状態を保存するファイルである `~/.claude.json` を Claude Code が解析できない状態で、[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否をチェックするためにこのファイルを読み取りますが、対話セッションが表示する復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルが読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログがファイルを処理していました。3494Claude Code が、アカウントの詳細とプロジェクトごとの状態を保存するファイルである `~/.claude.json` を解析できない状態で、[`claude import`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しました。このサブコマンドは利用可否を確認するためにこのファイルを読み取りますが、対話セッションで表示される復旧ダイアログは表示しないため、終了コード 1 で終了します。v2.1.222 より前は、設定ファイルを読み取れない状態で `claude import` を実行すると対話セッションが開始され、その復旧ダイアログでファイルが処理されていました。
3486 3495
3487```text theme={null}3496```text theme={null}
3488Could not read Claude Code config — run `claude` with no arguments to recover it.3497Could not read Claude Code config — run `claude` with no arguments to recover it.
3489```3498```
3490 3499
3491**対処方法:**3500**対処方法：**
3492 3501
3493* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出してリセットを提案します。その後、`claude import` を再実行します。3502* 引数なしで `claude` を実行します。Claude Code は無効なファイルを検出し、リセットを提案します。その後、`claude import` を再実行します。
3494* 手動で行った編集を残すには、代わりにエディタで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します3503* 手動で行った編集を保持するには、代わりにエディターで `~/.claude.json` の JSON 構文を修正してから、`claude import` を再実行します
3495 3504
3496### Could not import a server from Claude Desktop3505### Could not import a server from Claude Desktop
3497 3506
3498Claude Code は、`claude mcp add-from-claude-desktop` で選択したサーバーのうち 1 つを追加できませんでした。コマンドは選択された他のサーバーのインポートを続行し、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。3507Claude Code は、`claude mcp add-from-claude-desktop` で選択したサーバーの 1 つを追加できませんでした。コマンドは選択した他のサーバーのインポートを続行し、追加できなかったサーバーごとに 1 行を出力します。v2.1.205 より前は、最初に失敗したサーバーでインポートが停止していました。
3499 3508
3500```text theme={null}3509```text theme={null}
3501Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3510Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3502```3511```
3503 3512
3504サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではスペースやピリオドなどの文字をサーバー名に使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由には、検証に失敗したサーバー設定や、組織の [MCP ポリシー](https://code.claude.com/docs/ja/managed-mcp.md)によってブロックされたサーバーがあります。3513サーバー名の後のテキストが理由です。最も一般的なのは名前のチェックです。Claude Desktop ではスペースやピリオドなどの文字をサーバー名に使用できますが、`claude mcp` では英字、数字、ハイフン、アンダースコアに制限されています。その他の理由としては、検証に失敗したサーバー設定や、組織の [MCP ポリシー](https://code.claude.com/docs/ja/managed-mcp.md)によってブロックされたサーバーなどがあります。
3505 3514
3506**対処方法:**3515**対処方法：**
3507 3516
3508* `claude_desktop_config.json` でサーバー名を英字、数字、ハイフン、アンダースコアのみを使用する名前に変更してから、`claude mcp add-from-claude-desktop` を再実行します3517* `claude_desktop_config.json` でサーバー名を英字、数字、ハイフン、アンダースコアのみを使用するように変更してから、`claude mcp add-from-claude-desktop` を再実行します
3509* `claude mcp add` または `claude mcp add-json` を使用して、有効な名前でそのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](https://code.claude.com/docs/ja/mcp.md#import-mcp-servers-from-claude-desktop)を参照してください。3518* 有効な名前で `claude mcp add` または `claude mcp add-json` を使用して、そのサーバーを直接追加します。[Claude Desktop から MCP サーバーをインポートする](https://code.claude.com/docs/ja/mcp.md#import-mcp-servers-from-claude-desktop)を参照してください。
3510 3519
3511### Cannot add MCP server to the managed scope3520### Cannot add MCP server to the managed scope
3512 3521
3513`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープは、組織が [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーを保持します。Claude Code はそれらを管理設定からのみ読み取るため、コマンドはこのスコープにサーバーを書き込めません。3522`--scope managed` を指定して `claude mcp add` または `claude mcp add-json` を実行しました。このスコープは、組織が [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) 管理設定を通じて提供するサーバーを保持します。Claude Code はこれらを管理設定からのみ読み取るため、コマンドはそのスコープにサーバーを書き込むことができません。
3514 3523
3515```text theme={null}3524```text theme={null}
3516Cannot add MCP server to scope: managed3525Cannot add MCP server to scope: managed
3517```3526```
3518 3527
3519**対処方法:**3528**対処方法：**
3520 3529
3521* 書き込み可能なスコープ（`local`、`user`、または `project`）にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を参照してください3530* 書き込み可能なスコープ（`local`、`user`、`project`）にサーバーを追加します。`--scope` を指定しない場合、コマンドは `local` を使用します。[MCP のインストールスコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)を参照してください
3522* 組織内のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) にサーバーを追加します3531* 組織のすべてのユーザーにサーバーを提供するには、デプロイする管理設定の [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) に追加します
3523 3532
3524### 管理設定でプラグインのサーバーのみが許可されている場合に MCP サーバーを追加できない3533### Cannot add MCP server when managed settings allow only plugin servers
3525 3534
3526組織の管理設定で [`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 で終了します:3535組織の管理設定で [`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 で終了します：
3527 3536
3528```text theme={null}3537```text theme={null}
3529Cannot 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.3538Cannot 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.
3530```3539```
3531 3540
3532`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、理由としてこのメッセージを示します。[`/import`](https://code.claude.com/docs/ja/commands#all-commands) は追加しようとした各 MCP サーバーについてこのメッセージを報告し、検出した他の項目のインポートは続行します。3541`claude mcp add-from-claude-desktop` は、選択した各サーバーをインポートされなかったものとして報告し、このメッセージを理由として示します。[`/import`](https://code.claude.com/docs/ja/commands#all-commands) は追加しようとした各 MCP サーバーについてこのメッセージを報告し、見つかった他の項目のインポートは続行します。
3533 3542
3534v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーが読み込まれることはありませんでした。3543v2.1.284 より前は、これらのコマンドはサーバーを保存して成功を報告していましたが、サーバーが読み込まれることはありませんでした。
3535 3544
3536**対処方法:**3545**対処方法：**
3537 3546
3538* サーバーを提供する[プラグイン](https://code.claude.com/docs/ja/plugins/install.md)をインストールします3547* サーバーを提供する[プラグイン](https://code.claude.com/docs/ja/plugins/install.md)をインストールします
3539* 管理者に依頼して、サーバーを[プラグイン](https://code.claude.com/docs/ja/plugins/org.md)で配布してもらうか、リモートの HTTP または SSE サーバーであれば [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) を通じて提供してもらいます3548* 管理者に、サーバーを[プラグイン](https://code.claude.com/docs/ja/plugins/org.md)で配布するか、リモートの HTTP または SSE サーバーであれば [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers) を通じて提供するよう依頼します
3540 3549
3541### Can't read .mcp.json3550### Can't read .mcp.json
3542 3551
3543`--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 を超えていることを検出したため、ファイルを読み取らずにこのエラーで終了します。3552`--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 より大きいことを検出したため、ファイルを読み取らずにこのエラーで終了します。
3544 3553
3545```text theme={null}3554```text theme={null}
3546Can'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.3555Can'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.
3547```3556```
3548 3557
3549v2.1.257 より前は、`.mcp.json` が FIFO の場合はコマンドが出力なしで無期限に待機し、`/dev/zero` などのデバイスファイルへのシンボリックリンクの場合はプロセスが強制終了されるまでメモリが増加していました。3558v2.1.257 より前は、`.mcp.json` が FIFO の場合はコマンドが出力なしで永遠に待機し、`/dev/zero` などのデバイスファイルへのシンボリックリンクの場合はプロセスが強制終了されるまでメモリが増加していました。
3550 3559
3551**対処方法:**3560**対処方法：**
3552 3561
3553* 現在のディレクトリの `.mcp.json` に何があるかを確認します。[プロジェクトスコープの形式](https://code.claude.com/docs/ja/mcp.md#project-scope)の通常の JSON ファイルに置き換えるか、削除してから、コマンドを再実行します。3562* 現在のディレクトリの `.mcp.json` に何があるかを確認します。[プロジェクトスコープの形式](https://code.claude.com/docs/ja/mcp.md#project-scope)の通常の JSON ファイルに置き換えるか、削除してから、コマンドを再実行します。
3554 3563
3555### MCP サーバーが保存または削除されなかった3564### MCP server was not saved or removed
3556 3565
3557`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 がファイルを読み戻したところ、変更がそのファイルに反映されていませんでした。コマンドは成功の行の代わりにこのエラーで終了します。3566このエラーは、`claude mcp add` や `claude mcp remove` などのコマンドが変更を `~/.claude.json` に反映できなかったことを意味します。他の Claude Code プロセスがファイルをロックしたままにしているか、ファイルが読み取り専用であるかサンドボックスによって保護されている可能性があります。
3558 3567
3559```text theme={null}3568```text theme={null}
3560MCP 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.3569MCP server "example" was not saved to /home/user/.claude.json. If other Claude Code processes use that file, they may have kept it locked: add the server again, with CLAUDE_CODE_CONFIG_LOCK_WAIT_MS=60000 set to wait up to a minute. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox first.
3561```3570```
3562 3571
3563削除の後では、メッセージは `was not removed from` となり、`then remove the server again` で終わります。`local` スコープのサーバーの場合は、パスの後にエントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` として示されます。3572削除後は、メッセージの `was not saved to` が `was not removed from` に、`add the server again` が `remove the server again` になります。`local` スコープのサーバーの場合、パスの後に、そのエントリが属するプロジェクトディレクトリが `(local scope for /path/to/project)` として示されます。
3564 3573
3565v2.1.283 より前は、変更がファイルに反映されなかった場合でも、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は成功を報告していました。3574**対処方法：**
3566 3575
3567**対処方法:**3576* **他の Claude Code プロセスが実行中の場合**：コマンドはファイルのロックを約 10〜20 秒待機した後、書き込まずに断念します。[`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/ja/env-vars#variables) に `60000` などより長い待機時間をミリ秒単位で設定して、同じコマンドを再実行します。
3577* **ファイルが読み取り専用またはサンドボックスで保護されている場合**：メッセージが示すファイルを書き込み可能にして同じ追加または削除コマンドを再実行するか、サンドボックスの外でそのコマンドを実行します。
3568 3578
3569* メッセージに示されたファイルを書き込み可能にするか、サンドボックスの外でコマンドを実行してから、同じ追加または削除のコマンドを再実行します。3579v2.1.283 より前は、`claude mcp add`、`claude mcp add-json`、`claude mcp remove` は、変更がファイルに反映されなかった場合でも成功を報告していました。v2.1.318 より前は、メッセージにロックについての記述はなく、Claude Code は [`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`](https://code.claude.com/docs/ja/env-vars#variables) を読み取っていませんでした。
3570 3580
3571### MCP サーバーが保存または削除されていない可能性がある3581### MCP server may not have been saved or removed
3572 3582
3573`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` を読み戻すことができませんでした。変更がディスクに反映されているかどうかはわかりません。括弧内のテキストは、その読み取りのエラーです。3583`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` を読み戻すことができませんでした。変更はディスクに保存されている場合もあれば、されていない場合もあります。`to confirm the change` の後の括弧内に理由が示されます。
3574 3584
3575```text theme={null}3585```text theme={null}
3576MCP 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.3586MCP 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.
3577```3587```
3578 3588
3579削除の後では、メッセージは `may not have been removed` となり、`then remove the server again if it is still listed` で終わります。3589削除後は、メッセージは `may not have been removed` となり、`then remove the server again if it is still listed` で終わります。理由が `the file was not found` の場合、サーバーがまだ設定されている可能性があります。
3580 3590
3581v2.1.283 より前は、変更を確認できなかった場合でも、これらのコマンドは成功を報告していました。3591v2.1.283 より前は、変更を確認できなかった場合でもコマンドは成功を報告していました。
3582 3592
3583**対処方法:**3593**対処方法：**
3584 3594
3585* `claude mcp get <name>` を実行して、変更がディスクに反映されているかを確認します。`local` スコープのサーバーの場合、ローカルスコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。3595* `claude mcp get <name>` を実行して、変更がディスクに保存されているかどうかを確認します。`local` スコープのサーバーの場合、ローカルスコープはプロジェクトごとであるため、サーバーが属するプロジェクトディレクトリから実行します。
3586* 追加後にサーバーが見つからない場合、または削除後もまだ一覧に表示される場合は、同じ追加または削除のコマンドを再実行します。3596* 追加後にサーバーが見つからない場合、または削除後もまだ一覧に表示される場合は、同じ追加または削除コマンドを再実行します。
3587 3597
3588### Server is Anthropic-hosted and doesn't support local OAuth3598### Server is Anthropic-hosted and doesn't support local OAuth
3589 3599
3590URL がサードパーティのアイデンティティプロバイダーを通じて認証する 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 フローの開始を拒否します。3600URL が、サードパーティの 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 フローの開始を拒否します。
3591 3601
3592```text theme={null}3602```text theme={null}
3593"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.3603"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.
3594```3604```
3595 3605
3596**対処方法:**3606**対処方法：**
3597 3607
3598* 同じ URL の claude.ai コネクタを隠してしまわないよう、`claude mcp remove <name>` で自分のエントリを削除します3608* `claude mcp remove <name>` でエントリを削除し、同じ URL の claude.ai コネクタを隠さないようにします
3599* 削除後、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)3609* 削除後、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)
3600 3610
3601### Server rejected the Authorization header minted by the configured headersHelper3611### Server rejected the Authorization header minted by the configured headersHelper
3602 3612
3603[`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):3613[`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)：
3604 3614
3605```text theme={null}3615```text theme={null}
3606Server 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.3616Server 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.
3607```3617```
3608 3618
3609Claude Code は接続試行のたびにヘルパーを再実行するため、トークンのローテーションの競合など一時的な拒否の後の再試行では、新しい認証情報で成功する可能性があります。3619Claude Code は接続を試行するたびにヘルパーを再実行するため、トークンのローテーションの競合など一時的な拒否の後に再試行すると、新しい認証情報で成功することがあります。
3610 3620
3611**対処方法:**3621**対処方法：**
3612 3622
3613* 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` の値が出力されることを確認します3623* 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` 値が出力されることを確認します
3614* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択して **Reconnect** を選びます3624* ヘルパーまたはその認証情報のソースを修正した後、`/mcp` でサーバーを選択して **Reconnect** を選択します
3615 3625
3616v2.1.248 より前は、ヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても、Claude Code は OAuth ディスカバリーを実行していました。そのディスカバリーは、拒否された認証情報を報告する代わりに、`Incompatible auth server: does not support dynamic client registration` で失敗することがありました。3626v2.1.248 より前は、ヘルパーが `Authorization` ヘッダーを提供するサーバーに対しても、Claude Code は OAuth ディスカバリーを実行していました。このディスカバリーは、拒否された認証情報を報告する代わりに `Incompatible auth server: does not support dynamic client registration` で失敗することがありました。
3617 3627
3618### MCP サーバーが elicitation 機能を拒否した3628### MCP server rejected the elicitation capability
3619 3629
3620Java 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)を解析できません。メッセージは次のとおりです:3630Java MCP SDK 0.11.0 から 0.17.0 で構築された MCP サーバーが接続を拒否しました。これらの SDK バージョンは、Claude Code がハンドシェイクで宣言する `form` と `url` の[エリシテーションモード](https://code.claude.com/docs/ja/mcp.md#elicitation-modes-claude-code-declares)を解析できません。メッセージは次のとおりです：
3621 3631
3622```text theme={null}3632```text theme={null}
3623This 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+).3633This 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+).
3624```3634```
3625 3635
3626**対処方法:**3636**対処方法：**
3627 3637
3628* サーバーを Java MCP SDK 0.17.1 以降、またはメッセージに示された Spring AI のリリースのいずれかにアップグレードします3638* サーバーを Java MCP SDK 0.17.1 以降、またはメッセージが示す Spring AI リリースのいずれかにアップグレードします
3629* または、MCP 設定のそのサーバーのエントリに `"bareElicitationCapability": true` を追加してから、Claude Code を再起動します。このフィールドは stdio、`sse`、`http`、`ws` のエントリで受け付けられ、Claude Code v2.1.281 以降が必要です3639* または、MCP 設定のそのサーバーのエントリに `"bareElicitationCapability": true` を追加してから、Claude Code を再起動します。このフィールドは stdio、`sse`、`http`、`ws` のエントリで受け付けられ、Claude Code v2.1.281 以降が必要です
3630 3640
3631次の `.mcp.json` エントリは、1 つの HTTP サーバーに対してこのフィールドを設定します:3641次の `.mcp.json` エントリは、1 つの HTTP サーバーに対してこのフィールドを設定します：
3632 3642
3633```json theme={null}3643```json theme={null}
3634{3644{
3642}3652}
3643```3653```
3644 3654
3645再起動後、`/mcp` にはサーバーが接続済みとして表示されます。Claude Code はそのサーバーに対してのみ form モードを宣言するため、サーバーをアップグレードしたらこのフィールドを削除してください。3655再起動後、`/mcp` にはサーバーが接続済みとして表示されます。Claude Code はそのサーバーに対してのみフォームモードを宣言するため、サーバーをアップグレードしたらこのフィールドを削除してください。
3646 3656
3647サーバーが、`Unrecognized field "form"` を含むものなど、独自のエラーテキストで失敗することもあります。同じ修正方法が適用されます。3657サーバーが `Unrecognized field "form"` を含むエラーなど、独自のエラーテキストで失敗することもあります。同じ修正方法が適用されます。
3648 3658
3649### MCP permission prompt tool not found3659### MCP permission prompt tool not found
3650 3660
3651[`--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 より前は、起動時にサーバーの接続完了を待機しなかったため、起動は遅いものの正常なサーバーでもこのエラーが発生していました。3661[`--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 より前は、起動時にサーバーの接続完了を待たなかったため、起動は遅いが正常なサーバーでもこのエラーが発生していました。
3652 3662
3653```text theme={null}3663```text theme={null}
3654Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3664Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3655```3665```
3656 3666
3657`Available MCP tools:` の後のリストには、接続されていた MCP ツールが示されます。3667`Available MCP tools:` の後のリストには、接続されていた MCP ツールの名前が示されます。
3658 3668
3659**対処方法:**3669**対処方法：**
3660 3670
3661* サーバーが起動して接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして表示されることを確認します3671* サーバーが起動して接続を維持していることを確認します。同じディレクトリで `claude mcp list` を実行し、サーバーが接続済みとして一覧に表示されることを確認します
3662* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致していることを確認します3672* ツール名が、サーバーが公開する `mcp__<server>__<tool>` の名前と一致していることを確認します
3663* サーバーの起動に 30 秒以上かかる場合は、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) を引き上げます3673* サーバーの起動に 30 秒以上かかる場合は、[`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) を増やします
3664 3674
3665### OAuth callback port is already in use3675### OAuth callback port is already in use
3666 3676
3667OAuth でリモートの 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 は利用可能なポートを選択するためです。3677OAuth でリモート 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 は利用可能なポートを選択するためです。
3668 3678
3669```text theme={null}3679```text theme={null}
3670OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3680OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3671```3681```
3672 3682
3673Windows では、代わりに `netstat -ano | findstr :<port>` が提案されます。3683Windows では、推奨されるコマンドは代わりに `netstat -ano | findstr :<port>` になります。
3674 3684
3675**対処方法:**3685**対処方法：**
3676 3686
3677* メッセージに示されたコマンドを実行してポートを保持しているプロセスを特定し、停止するか終了するまで待ちます3687* メッセージのコマンドを実行してポートを保持しているプロセスを見つけ、停止するか終了するのを待ちます
3678* 別のプログラムがそのポートを恒久的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方法に応じて `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します3688* 別のプログラムがそのポートを恒久的に必要とする場合は、サーバーに別のリダイレクト URI を登録し、使用している方の `MCP_OAUTH_CALLBACK_PORT` または `--callback-port` でそのポートを設定します
3679* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します3689* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します
3680 3690
3681### No available ports for OAuth redirect3691### No available ports for OAuth redirect
3682 3692
3683[OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) でリモートの MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためのローカルリスナーを開始します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。セキュリティソフトウェアやローカルリスナーを拒否するサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。3693[OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) でリモート MCP サーバーにサインインすると、Claude Code はサインインのコールバックを受け取るためにローカルリスナーを開始します。Claude Code がそのためのローカルポートをバインドできない場合、サインインはこのメッセージで失敗します。ローカルリスナーを拒否するセキュリティソフトウェアやサンドボックスポリシーなど、マシン上の何かが `127.0.0.1` でのリッスンを妨げています。
3684 3694
3685```text theme={null}3695```text theme={null}
3686No available ports for OAuth redirect3696No available ports for OAuth redirect
3687```3697```
3688 3698
3689v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身が選んだポートだけをバインドできない場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。3699v2.1.268 より前は、Claude Code はオペレーティングシステムが割り当てるポートにフォールバックしなかったため、自身で選択したポートのみをバインドできない場合にもこのメッセージが表示されていました。これは、Claude Code が選択するポートを含むポート範囲を Hyper-V が予約している Windows ホストで発生することがあります。
3690 3700
3691**対処方法:**3701**対処方法：**
3692 3702
3693* セキュリティソフトウェアやサンドボックスポリシーがプロセスの `127.0.0.1` でのリッスンをブロックしていないかを確認し、Claude Code がローカルポートをバインドできるようにします3703* セキュリティソフトウェアやサンドボックスポリシーがプロセスによる `127.0.0.1` でのリッスンをブロックしていないか確認し、Claude Code がローカルポートをバインドできるようにします
3694* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します3704* その後、`/mcp` でサーバーを選択するなどして、サインインを再度開始します
3695 3705
3696### origin/HEAD がない場合に /security-review が失敗する3706### origin/HEAD がないと /security-review が失敗する
3697 3707
3698[`/security-review`](https://code.claude.com/docs/ja/commands#all-commands) は、ブランチと `origin/HEAD`（`origin` リモートでどのブランチがデフォルトかを記録するローカル ref）との差分を取ってレビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。3708[`/security-review`](https://code.claude.com/docs/ja/commands#all-commands) は、ブランチを `origin/HEAD`（`origin` リモートでどのブランチがデフォルトかを記録するローカル ref）と比較した差分を取って、レビューのコンテキストを構築します。その ref が存在しない場合、差分を収集する git コマンドが失敗し、レビューは開始前に停止します。
3699 3709
3700```text theme={null}3710```text theme={null}
3701Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3711Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3704'git <command> [<revision>...] -- [<file>...]'3714'git <command> [<revision>...] -- [<file>...]'
3705```3715```
3706 3716
3707メッセージには、代わりに `git log` や別の `git diff` が引用されることもあります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチを通知し、フェッチの refspec がそれを含む場合のみです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次の構成では ref が存在しません:3717メッセージには、代わりに `git log` や別の `git diff` が引用される場合があります。Git が `origin/HEAD` を作成するのは、リモートがデフォルトブランチをアドバタイズし、フェッチの refspec がそれをカバーしている場合のみです。コミットのあるリモートを完全に `git clone` した場合はこれに該当します。次のような構成では ref が存在しません：
3708 3718
3709* 狭すぎる refspec をフェッチする、単一ブランチまたは CI のチェックアウト3719* 狭すぎる refspec でフェッチするシングルブランチまたは CI のチェックアウト
3710* サーバー側の HEAD が誰もプッシュしていないブランチを指しているリモート3720* サーバー側の HEAD が誰もプッシュしていないブランチを指しているリモート
3711* `origin` リモートがないリポジトリ、または一度もフェッチしていないリポジトリ3721* `origin` リモートがないリポジトリ、または一度もフェッチしていないリポジトリ
3712 3722
3713Claude Code は、[動的コンテキストを挿入する](https://code.claude.com/docs/ja/skills.md#when-an-injected-command-fails)すべてのスキルで同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。3723Claude Code は、[動的コンテキストを挿入する](https://code.claude.com/docs/ja/skills.md#when-an-injected-command-fails)すべてのスキルに対して同じエラーを表示し、挿入されたコマンドが失敗するとそのスキルの呼び出しは中止されます。
3714 3724
3715関連するメッセージは、コマンドが実行される前に発生します:3725次の類似の文字列は、コマンドが実行される前に発生します：
3716 3726
3717* `Shell command permission check failed for pattern "..."`：コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止につながるか、および `allowed-tools` でコマンドを事前承認する方法を説明しています3727* `Shell command permission check failed for pattern "..."`：コマンドの権限チェックでコマンドが許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止につながるか、および `allowed-tools` でコマンドを事前承認する方法について説明しています
3718* ``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)を参照してください3728* ``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)を参照してください
3719 3729
3720**対処方法:**3730**対処方法：**
3721 3731
3722* リモートのデフォルトブランチを指定して 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` を再実行します。3732* リモートのデフォルトブランチを指定して 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` を再実行します。
3723* ブランチ名を指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これはリモートにどのブランチがデフォルトかを問い合わせます。リモートが空である、または HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチを通知しない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合はブランチを明示的に指定してください。クローンがそのブランチをフェッチしない場合は `error: Not a valid ref` で失敗します。先に上記のとおり refspec を広げてください。3733* ブランチを指定したくない場合は、`git fetch origin` を実行してから `git remote set-head origin --auto` を実行します。これはリモートにどのブランチがデフォルトかを問い合わせます。リモートが空であるか、その HEAD が誰もプッシュしていないブランチを指しているためにデフォルトブランチをアドバタイズしていない場合は、`error: Cannot determine remote HEAD` で失敗します。その場合はブランチを明示的に指定してください。クローンがそのブランチをフェッチしない場合は `error: Not a valid ref` で失敗します。先に上記のように refspec を広げてください。
3724* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、ref を作成する前にフェッチします。リモートが空の場合は、先に `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。`origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで `/security-review` には空の差分が表示されます。3734* リポジトリにリモートがない場合は、`git remote add origin <url>` でリモートを追加し、ref を作成する前にフェッチします。リモートが空の場合は、先に `git push -u origin HEAD` でブランチをプッシュし、set-head コマンドでそのブランチを指定します。すると `origin/HEAD` はプッシュしたばかりのブランチを指すため、ブランチがそこから分岐するまで `/security-review` には空の差分が表示されます。
3725 3735
3726### スキルまたはコマンド内のシェルコマンドが実行されなかった3736### No shell command in a skill or command was run
3727 3737
3728`No shell command in <name> was run` は、そのスキルまたはコマンドファイル内の `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)に、Bash ツールまたは PowerShell ツールが拒否する文字が含まれていることを意味します：3738`No shell command in <name> was run` は、そのスキルまたはコマンドファイル内の `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)に、Bash または PowerShell ツールが拒否する文字が含まれていることを意味します：
3729 3739
3730* **どちらのツールでも**：タブまたは改行以外の生の制御文字3740* **どちらのツールでも**：タブまたは改行以外の生の制御文字
3731* **PowerShell ツール**：さらに U+FEFF または U+180E3741* **PowerShell ツール**：U+FEFF または U+180E も
3732 3742
3733メッセージの末尾には拒否されたコマンドが表示され、拒否された各文字は `�` として示されます。次は Bash ツールの例です：3743メッセージの末尾には拒否されたコマンドが表示され、拒否された各文字は `�` として示されます。Bash ツールの例は次のとおりです：
3734 3744
3735```text theme={null}3745```text theme={null}
3736No 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.3746No 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.
3737build.sh --target�dist3747build.sh --target�dist
3738```3748```
3739 3749
3740**対処方法:**3750**対処方法：**
3741 3751
3742* メッセージの末尾に引用されたコマンド内の各 `�` を見つけます。それが表す文字を、[スキルまたはコマンドファイル](https://code.claude.com/docs/ja/skills.md#where-skills-live)から、またはファイルに代入される引数や[オプション](https://code.claude.com/docs/ja/plugins/manifest-reference.md#user-configuration)から削除します。3752* メッセージの末尾に引用されたコマンド内の各 `�` を見つけます。それが表す文字を、[スキルまたはコマンドファイル](https://code.claude.com/docs/ja/skills.md#where-skills-live)、またはファイルに代入される引数や[オプション](https://code.claude.com/docs/ja/plugins/manifest-reference.md#user-configuration)から削除します。
3743 3753
3744### Input must be provided when using `--print`3754### Input must be provided when using `--print`
3745 3755
3746引数なしの `claude` が対話 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、または PowerShell ISE や一部の IDE の出力ペインのようにコンソールが実際のターミナルでない場合、`claude` は代わりに[非対話](https://code.claude.com/docs/ja/headless.md)で実行されます。これはプロンプトを必要とする `claude -p` と同じモードであるため、フラグを渡していなくてもメッセージには `--print` が示されます。プロンプトなしで、stdin にも何もパイプせずに `-p`/`--print` を渡した場合も、どこでも同じエラーが発生します。3756引数なしの `claude` で対話型 UI を開始するには、stdout がターミナルである必要があります。stdout がリダイレクトされている場合、またはコンソールが PowerShell ISE や一部の IDE の出力ペインのように実際のターミナルではない場合、`claude` は代わりに[非対話的に](https://code.claude.com/docs/ja/headless.md)実行されます。これは `claude -p` と同じモードで、プロンプトが必要なため、フラグを渡していなくてもメッセージには `--print` が示されます。プロンプトなしで、stdin にも何もパイプせずに `-p`/`--print` を渡した場合も、どこでも同じエラーが発生します。
3747 3757
3748```text theme={null}3758```text theme={null}
3749Error: Input must be provided either through stdin or as a prompt argument when using --print3759Error: Input must be provided either through stdin or as a prompt argument when using --print
3750```3760```
3751 3761
3752**対処方法:**3762**対処方法：**
3753 3763
3754* 対話的に使用するには、実際のターミナルで `claude` を実行します。ISE ではなく Windows Terminal や PowerShell コンソール、出力ペインではなく IDE の統合ターミナルを使用します3764* 対話的に使用するには、実際のターミナルで `claude` を実行します。ISE ではなく Windows Terminal または PowerShell コンソール、出力ペインではなく IDE の統合ターミナルを使用します
3755* 1 回限りの使用では、プロンプトを渡します: `claude -p "your question"`、またはパイプで `echo "your question" | claude -p` とします3765* 1 回限りの使用では、プロンプトを渡します：`claude -p "your question"`、または `echo "your question" | claude -p` でパイプします
3756 3766
3757### Claude Code can't read the keyboard here3767### Claude Code can't read the keyboard here
3758 3768
3759[対話セッション](https://code.claude.com/docs/ja/interactive-mode.md)を開始する [`-p`](https://code.claude.com/docs/ja/headless) なしで `claude` を実行しましたが、その標準入力がターミナルではありません。何かがパイプまたはリダイレクトしているか、`claude` を起動したプログラムが独自の入力ストリームを提供しています。3769[`-p`](https://code.claude.com/docs/ja/headless) なしで `claude` を実行したため[対話セッション](https://code.claude.com/docs/ja/interactive-mode.md)が開始されますが、その標準入力がターミナルではありません。何かがパイプまたはリダイレクトしたか、`claude` を起動したプログラムが独自の入力ストリームを提供しました。
3760 3770
3761対話セッションにはキー入力を読み取るためのターミナルが必要です。ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります:3771対話セッションにはキー入力を読み取るためのターミナルが必要で、ターミナルがない場合の Claude Code の動作はプラットフォームによって異なります：
3762 3772
3763* **Windows**: Claude Code はインターフェースを開始せずに、メッセージを stderr に出力して終了コード 1 で終了します3773* **Windows**：Claude Code はインターフェースを開始せず、メッセージを stderr に出力して終了コード 1 で終了します
3764* **macOS と Linux**: Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その 1 行目には Windows の文言の代わりに `/dev/tty` が示されます。3774* **macOS と Linux**：Claude Code は `/dev/tty` からキー入力を読み取ってセッションを開始し、パイプされたテキストがあれば最初のプロンプトとして使用します。`/dev/tty` を開けない場合にメッセージが表示され、その最初の行では Windows の文言の代わりに `/dev/tty` が示されます。
3765 3775
3766Windows では、メッセージは次のようになります:3776Windows では、メッセージは次のとおりです：
3767 3777
3768```text theme={null}3778```text theme={null}
3769Claude 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.3779Claude 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.
3771To 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).3781To 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).
3772```3782```
3773 3783
3774**対処方法:**3784**対処方法：**
3775 3785
3776* 対話的に作業するには、入力をパイプまたはリダイレクトせずに、ターミナルで直接 `claude` を実行します3786* 対話的に作業するには、入力をパイプやリダイレクトせずに、ターミナルで直接 `claude` を実行します
3777* スクリプトからなど、対話インターフェースなしで回答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` と `--resume <session-id>` でも同様に機能します。3787* スクリプトからなど、対話型インターフェースなしで回答を得るには、`-p` を追加し、`claude -p "your question"` や `echo "your question" | claude -p` のように、プロンプトを引数または stdin で渡します。`--continue` と `--resume <session-id>` でも同様に機能します。
3778 3788
3779v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。3789v2.1.287 より前は、Claude Code はこのメッセージを出力する代わりにインターフェースを開始し、画面に何も表示しないか、`Raw mode is not supported` を含むエラーで失敗していました。
3780 3790
3781`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) を参照してください。3791代わりに `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) を参照してください。
3782 3792
3783### Input contained only whitespace3793### Input contained only whitespace
3784 3794
3785[非対話モード](https://code.claude.com/docs/ja/headless.md)では、Claude Code はスペース、タブ、改行のみで構成されたプロンプトを送信せずに拒否します。API は表示可能なテキストのないメッセージを拒否するためです。表示されるメッセージは、空のプロンプトがどこから来たかによって異なります:3795[非対話モード](https://code.claude.com/docs/ja/headless.md)では、API は表示可能なテキストのないメッセージを拒否するため、Claude Code はスペース、タブ、改行のみで構成されたプロンプトを送信せずに拒否します。表示されるメッセージは、空白のプロンプトがどこから来たかによって異なります：
3786 3796
3787* **`claude -p` のプロンプト引数またはパイプされた stdin**: `claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します3797* **`claude -p` のプロンプト引数またはパイプされた stdin**：`claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了します
3788* **実行中の `--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.`3798* **実行中の `--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.`
3789 3799
3790v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API はリクエストを 400 エラーで拒否していました。3800v2.1.229 より前は、Claude Code は空白のみのメッセージを API に送信し、API はリクエストを 400 エラーで拒否していました。
3791 3801
3792**対処方法:**3802**対処方法：**
3793 3803
3794* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。3804* プロンプトに表示可能なテキストを含めます。スクリプトが変数やファイルからプロンプトを構築する場合は、Claude Code を呼び出す前にソースが空でないことを確認します。
3795 3805
3796### stream-json input carried over 256M characters with no newline3806### stream-json input carried over 256M characters with no newline
3797 3807
3798プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超える文字を stdin に送信したため、Claude Code はそれ以上の入力をバッファリングせずに、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限が `256M` と表記されます。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングし、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。3808プログラムが `claude -p --input-format stream-json` の実行に対して、改行なしで 268,435,456 文字を超えるデータを stdin に送信したため、Claude Code はそれ以上入力をバッファリングせず、このエラーを stderr に出力して終了コード 1 で終了します。メッセージではこの上限を `256M` と表記しています。v2.1.257 より前は、Claude Code はこのような入力を無制限にバッファリングしていたため、プロセスがクラッシュするか強制終了されるまでメモリが増加していました。
3799 3809
3800```text theme={null}3810```text theme={null}
3801Error: 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.3811Error: 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.
3802```3812```
3803 3813
3804改行なしでこれほど長い入力は、通常、送信元がそもそも stream-json の送信元ではないことを意味します。たとえば、誤ってパイプされたバイナリファイルやプレーンなログ出力などです。上限を超える単一のメッセージも同じチェックで失敗します。3814改行なしでこれほど長い入力は、通常、誤ってパイプされたバイナリファイルやプレーンなログ出力など、送信元がそもそも stream-json の送信元ではないことを意味します。上限を超える単一のメッセージも同じチェックで失敗します。
3805 3815
3806**対処方法:**3816**対処方法：**
3807 3817
3808* stdin にパイプされているものを確認します。[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) では、すべてのメッセージが改行で終わる 1 行の JSON である必要があります3818* stdin に何がパイプされているかを確認します。[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) では、すべてのメッセージが改行で終わる 1 行の JSON である必要があります
3809* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を削除します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります3819* 代わりにプレーンテキストを送信するには、`--input-format stream-json` を削除します。`claude -p` はデフォルトで stdin からプレーンテキストのプロンプトを読み取ります
3810 3820
3811### Unknown command3821### Unknown command
3812 3822
3813対話的なターミナルセッションで、このセッションのどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告します:3823インタラクティブなターミナルセッションで、このセッションのどのコマンドにも一致しない `/` 名を送信したため、Claude Code は何も実行せずにその名前を報告しています。
3814 3824
3815```text theme={null}3825```text theme={null}
3816Unknown command: /hepl. Did you mean /help?3826Unknown command: /hepl. Did you mean /help?
3817```3827```
3818 3828
3819Claude Code は、このセッションでメニューに表示される中から最も近いコマンド名またはエイリアスを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです:3829Claude Code は、このセッションでメニューに表示されるコマンド名またはエイリアスのうち最も近いものを提案します。近いものがない場合、メッセージは名前の後で終わります。原因は通常、次のいずれかです。
3820 3830
3821* `/help` を `/hepl` と入力するなどの入力ミス。[コマンドメニューが入力内容と一致させる仕組み](https://code.claude.com/docs/ja/commands.md#how-the-command-menu-matches-what-you-type)では、送信前に近い候補を選ぶ方法を説明しています3831* `/help` を `/hepl` と入力するなどのタイプミス。送信前に近い候補を選ぶ方法については、[コマンドメニューが入力内容と照合する仕組み](https://code.claude.com/docs/ja/commands.md#how-the-command-menu-matches-what-you-type)を参照してください
3822* 存在するものの、プラットフォーム、プラン、認証方法などの要件が満たされていないためにこのセッションでは利用できないコマンド。[`/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) のように独自のメッセージで応答します3832* コマンド自体は存在するものの、プラットフォーム、プラン、認証方法などの要件を満たしていないため、このセッションでは利用できない。[`/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) のような独自のメッセージを返します
3823* このセッションでインストールまたは接続されていない[プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)または [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#use-mcp-prompts-as-commands)のコマンド3833* このセッションでインストールまたは接続されていない[プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)や [MCP サーバー](https://code.claude.com/docs/ja/mcp.md#use-mcp-prompts-as-commands)のコマンド
3824 3834
3825Claude Code が一致しない `/` 名にこのように応答するのは、対話的なターミナルセッションの場合のみです。それ以外のすべてのセッションでは、代わりにプロンプトを通常のメッセージとして Claude に送信し、コマンドが実行されなかったことを示す注記と、そのセッションで Claude が実行できるコマンドの一覧を添えます。これらのセッションには次のものが含まれます:3835Claude Code が一致しない `/` 名にこのように応答するのは、インタラクティブなターミナルセッションの場合だけです。それ以外のすべてのセッションでは、コマンドが実行されなかったことを示す注記と、そのセッションで Claude が実行できるコマンドの一覧を添えて、プロンプトを通常のメッセージとして Claude に送信します。対象となるセッションは次のとおりです。
3826 3836
3827* `-p` の実行3837* `-p` の実行
3828* [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーション3838* [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーション
3830* [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)のチャットパネル3840* [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)のチャットパネル
3831* [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)と[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)3841* [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)と[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)
3832 3842
3833これらのセッションのいずれかで実行できない組み込みコマンドについては、Claude Code はそれを Claude に送信せず、そのコマンドが利用できないことを応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとクラウドのスケジュールタスクのみでした。v2.1.273 より前は、それらも `Unknown command` を返していました。3843これらのセッションで実行できない組み込みコマンドについては、Claude Code は Claude に送信せず、コマンドが利用できないことを引き続き応答します。v2.1.274 より前は、一致しない名前を Claude に送信していたのはクラウドセッションとクラウドのスケジュールタスクだけでした。v2.1.273 より前は、これらも `Unknown command` と応答していました。
3834 3844
3835Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が、Lean のドキュメントコメントを開始する `/--` のように句読点で始まる場合、または `/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。3845Claude Code は、`/` で始まるすべてのプロンプトをコマンドとして扱うわけではありません。`/` の後の最初の単語が Lean のドキュメントコメントを開始する `/--` のように記号で始まる場合や、`/var/log/syslog` のようなパスである場合は、プロンプトを通常のメッセージとして Claude に送信します。
3836 3846
3837v2.1.236 より前は、入力した名前に近い候補がコマンドメニューに表示されている状態で `Enter` を押すと、Claude Code はその候補を実行していました。そのため、`/hepl` などの入力ミスでは、このメッセージが表示される代わりに `/help` が実行されていました。3847v2.1.236 より前は、入力した名前に近い候補をコマンドメニューが表示している状態で `Enter` を押すと、Claude Code はその候補を実行していました。そのため、`/hepl` のようなタイプミスではこのメッセージが表示されず、`/help` が実行されていました。
3838 3848
3839**対処方法:**3849**対処方法:**
3840 3850
3841* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで利用できるものを確認します3851* 提案された名前を実行するか、`/` に続けて名前の一部を入力し、このセッションで利用できるものを確認します
3842* ドキュメントに記載されたコマンドを Claude Code が不明と報告する場合は、[コマンドリファレンス](https://code.claude.com/docs/ja/commands.md)でそのコマンドの行を確認し、記載されている要件を確認します3852* ドキュメントに記載されているコマンドが不明と報告される場合は、[コマンドリファレンス](https://code.claude.com/docs/ja/commands.md)でそのコマンドの行に記載されている要件を確認します
3843 3853
3844### Diff is too large for ultrareview3854### Diff is too large for ultrareview
3845 3855
3846ブランチとベースブランチとの差分（コミットされていない変更やステージされた変更を含む）が [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のサイズ制限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドはクラウドセッションの開始前にレビューを拒否します。拒否されたレビューでは無料実行回数は消費されず、使用クレジットも請求されません。メッセージには、適用されている制限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには差分の生の統計のみが表示されていました。3856コミットされていない変更やステージ済みの変更を含む、ブランチとベースブランチとの差分が [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) のサイズ上限を超えているため、`/code-review ultra` と `claude ultrareview` サブコマンドは、クラウドセッションの開始前にレビューを拒否しています。拒否されたレビューでは、無料実行回数は消費されず、使用クレジットも請求されません。メッセージには、適用されている上限、差分のサイズ、変更行数が最も多いファイルが示されます。v2.1.216 より前は、メッセージには差分の生の統計情報だけが表示されていました。
3847 3857
3848```text theme={null}3858```text theme={null}
3849Diff 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.3859Diff 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.
3850```3860```
3851 3861
3852プルリクエストのレビューにも同じ制限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。3862プルリクエストのレビューにも同じ上限が適用されます。その場合のメッセージは `PR #<N> is too large for ultrareview` で始まり、PR のファイル数と行数が示されます。
3853 3863
3854**対処方法：**3864**対処方法:**
3855 3865
3856* `/code-review ultra develop` のように作業に近いベースブランチを渡し、そのブランチとの差分のみをレビュー対象にします3866* `/code-review ultra develop` のように、作業内容により近いベースブランチを渡して、そのブランチとの差分だけがレビュー対象になるようにします
3857* 変更を小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルが変更行数の大部分を占めているため、まずそれらを別のブランチに移すことから始めてください。3867* 変更を小さなブランチに分割し、それぞれをレビューします。メッセージに示されたファイルは変更行数が最も多いため、まずそれらを別のブランチに移します。
3858 3868
3859### Could not find merge-base with the base branch3869### Could not find merge-base with the base branch
3860 3870
3861`/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 オブジェクト形式など、ツリー全体の差分が作成できないまれなリポジトリの場合です。3871`/code-review ultra` と `claude ultrareview` サブコマンドは、ブランチとベースブランチとの差分をレビューします。そのためには、2 つのブランチが共有するコミットが必要です。`git merge-base` が共有コミットを見つけられない場合、Claude Code はクラウドセッションの開始前にレビューを拒否します。少なくとも 1 つのブランチを持ち、完全であることを Claude Code が確認できるクローンでは、拒否する代わりに[追跡対象のすべてのファイルのレビュー](https://code.claude.com/docs/ja/ultrareview.md#diff-limits-and-fallbacks)にフォールバックします。この拒否が表示されるのは、ベースブランチがまったく見つからない場合、クローンが完全であることを Claude Code が確認できない場合、または SHA-256 オブジェクト形式のようにツリー全体の差分を取得できないまれなリポジトリの場合です。
3862 3872
3863```text theme={null}3873```text theme={null}
3864Could 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.3874Could 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.
3865```3875```
3866 3876
3867最初の文に続くヒントは、Claude Code が検出した状況によって異なります。3877最初の文の後に続くヒントは、Claude Code が検出した状況によって異なります。
3868 3878
3869* **ベースブランチを渡さなかった場合**：Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースを明示的に渡すよう提案します3879* **ベースブランチを渡さなかった場合**: Claude Code はリポジトリのデフォルトブランチと比較しており、上の例のように、ベースを明示的に渡すよう提案します
3870* **クローン内にすでに存在するベースブランチを渡した場合**：ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります3880* **クローンにすでに存在するベースブランチを渡した場合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります
3871* **クローンに存在しないベースブランチを渡した場合**：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` で失敗していました。3881* **クローンに存在しないベースブランチを渡した場合**: 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` で失敗していました。
3872 3882
3873**対処方法：**3883**対処方法:**
3874 3884
3875* 別のブランチが実際のベースである場合は、`/code-review ultra <branch>` のように明示的に渡します3885* 別のブランチが実際のベースである場合は、`/code-review ultra <branch>` のように明示的に渡します
3876* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します3886* クローンに完全な履歴がない可能性がある場合は、`git fetch --unshallow origin` を実行してからレビューを再実行します
3877 3887
3878### Your checkout has no branches3888### Your checkout has no branches
3879 3889
3880チェックアウトにはコミットがあってもブランチがない場合があります。`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` サブコマンドはクラウドセッションの開始前にレビューを拒否します。3890チェックアウトには、コミットがあってもブランチがない場合があります。`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` サブコマンドは、クラウドセッションの開始前にレビューを拒否します。
3881 3891
3882```text theme={null}3892```text theme={null}
3883Your 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.3893Your 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.
3884```3894```
3885 3895
3886v2.1.221 より前は、Claude Code はこのチェックアウト内のすべての追跡対象ファイルのレビューを試み、アップロードが失敗していました。3896v2.1.221 より前は、Claude Code はこのチェックアウト内の追跡対象のすべてのファイルのレビューを試み、アップロードが失敗していました。
3887 3897
3888**対処方法：**3898**対処方法:**
3889 3899
3890* `git checkout -b <name>` で現在のコミットにブランチを作成してから、レビューを再実行します3900* `git checkout -b <name>` で現在のコミットにブランチを作成してから、レビューを再実行します
3891 3901
3892### No GitHub account is connected to your Claude account3902### No GitHub account is connected to your Claude account
3893 3903
3894`/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 は無料実行回数を消費せず、使用クレジットも請求しません。3904`/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 は無料実行回数を消費せず、使用クレジットも請求しません。
3895 3905
3896```text theme={null}3906```text theme={null}
3897Ultrareview 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).3907Ultrareview 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).
3898```3908```
3899 3909
3900セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージには claude.ai のリンクのみが示されます。3910セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージには claude.ai のリンクだけが示されます。
3901 3911
3902**対処方法：**3912**対処方法:**
3903 3913
3904* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します3914* `/web-setup` を実行して GitHub CLI のログインを Claude アカウントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカウントを接続します
3905* 接続してから 1 分ほど待ってレビューを再実行します3915* 接続してから 1 分ほど待って、レビューを再実行します
3906 3916
3907v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。3917v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。
3908 3918
3909### Your connected GitHub account can't see the repository3919### Your connected GitHub account can't see the repository
3910 3920
3911`/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 は無料実行回数を消費せず、使用クレジットも請求しません。3921`/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 は無料実行回数を消費せず、使用クレジットも請求しません。
3912 3922
3913```text theme={null}3923```text theme={null}
3914Your 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.3924Your 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.
3915```3925```
3916 3926
3917セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージにはアプリのインストールのみが示されます。3927セッションで [`/web-setup`](https://code.claude.com/docs/ja/web-quickstart#connect-from-your-terminal) が利用できない場合、メッセージにはアプリのインストールだけが示されます。
3918 3928
3919**対処方法：**3929**対処方法:**
3920 3930
3921* ローカルの `gh` CLI がリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します3931* ローカルの `gh` CLI でリポジトリを読み取れる場合は、`/web-setup` を実行してそのログインを Claude アカウントに接続します
3922* 変更後にレビューを再実行します3932* 変更後にレビューを再実行します
3923 3933
3924v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。3934v2.1.248 より前は、Claude Code は起動前にこの確認を行っていませんでした。
3925 3935
3926### The GitHub App preflight failed transiently3936### The GitHub App preflight failed transiently
3927 3937
3928ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかを確認しましたが、その確認は明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消する可能性のあるエラーで終わりました。完全なメッセージは、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因で始まり、事前確認についての文で終わります。3938ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始したところ、2 つのステップが同時に失敗しました。Claude Code はリポジトリのバンドルをビルドまたはアップロードできませんでした。アップロードの前に、クラウドサービスが GitHub からリポジトリをクローンできるかを確認しましたが、その確認は明確な結果ではなく、ネットワークエラー、タイムアウト、一時的なサーバーエラーなど、再試行で解消できる可能性のあるエラーで終わりました。完全なメッセージは、`Could not upload repo bundle (<error>)` のようにバンドルを妨げた原因で始まり、事前確認の文で終わります。
3929 3939
3930```text theme={null}3940```text theme={null}
3931Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3941Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3932```3942```
3933 3943
3934**対処方法：**3944**対処方法:**
3935 3945
3936* 少し待ってからコマンドを再実行します。GitHub の確認が通れば、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗は起動の妨げにならなくなります3946* しばらく待ってからコマンドを再実行します。GitHub の確認に成功すると、Claude Code は GitHub のクローンからセッションを開始できるため、アップロードの失敗が起動を妨げることはなくなります
3937* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が自分で修正できるものであれば修正し、ローカルリポジトリからセッションを開始できるようにします3947* 再試行しても失敗し続ける場合は、メッセージの冒頭にアップロードを妨げた原因が示されています。その原因が修正可能なものであれば、修正することで、代わりにローカルリポジトリからセッションを開始できるようになります
3938 3948
3939v2.1.251 より前は、GitHub の確認が一時的に失敗しただけの場合でも、Claude Code はメッセージを `Please set up GitHub on https://claude.ai/code` で終えていました。セットアップに関するアドバイスでは一時的な失敗は解消できません。3949v2.1.251 より前は、GitHub の確認が一時的に失敗しただけの場合でも、Claude Code はメッセージの最後に `Please set up GitHub on https://claude.ai/code` と表示していましたが、セットアップの案内では一時的な失敗は解消できません。
3940 3950
3941### リポジトリのアップロードが git の設定に対応できない3951### リポジトリのアップロードが git の設定に対応できない
3942 3952
3943[ローカルリポジトリをアップロードするクラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#send-local-repositories-without-github)、またはブランチの [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) を開始しましたが、ファイルに適用される属性ルールを決定する git 設定のいずれかに、アップロードが対応できません。アップロードを続行してルールを見落とすと、clean フィルターで暗号化されるファイルなど、git が保存前に変換するファイルが、ディスク上の状態のままクラウドに届く可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードされません。3953[ローカルリポジトリをアップロードするクラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#send-local-repositories-without-github)、またはブランチの [ultrareview](https://code.claude.com/docs/ja/ultrareview.md) を開始しましたが、ファイルに適用される属性ルールを決める git の設定のいずれかに、アップロードが対応できません。アップロードを続行してルールを見落とすと、clean フィルターで暗号化されるファイルのように git が保存前に変換するファイルが、ディスク上の状態のままクラウドに送られる可能性があります。そのため Claude Code はアップロードを拒否し、何もアップロードされません。
3944 3954
3945```text theme={null}3955```text theme={null}
3946Not 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.3956Not 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.
3947```3957```
3948 3958
3949メッセージには設定名とその設定場所が示され、該当するケースの修正方法で終わります。`core.attributesFile` と `attr.tree` についても同じ拒否が表示され、それぞれに固有の修正方法が示されます。3959メッセージには、設定項目とその設定場所が示され、該当するケースの修正方法で終わります。`core.attributesFile` と `attr.tree` についても、それぞれ固有の修正方法とともに同じ拒否が表示されます。
3950 3960
3951メッセージには、git 設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが示される場合があります。これは、そのディレクティブの条件がこのリポジトリに当てはまらない場合でも同様です。3961メッセージには、git の設定が `include` または `includeIf` ディレクティブで読み込む設定ファイルが示される場合があります。これは、そのディレクティブの条件がこのリポジトリに該当しない場合でも同様です。
3952 3962
3953**対処方法：**3963**対処方法:**
3954 3964
3955* メッセージの最後の文にある修正方法を適用します3965* メッセージの最後の文に示された修正方法を適用します
3956 3966
3957### GitHub isn't connected to your Claude account3967### GitHub isn't connected to your Claude account
3958 3968
3959`/autofix-pr` などで、ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否します。3969`/autofix-pr` などで、ローカルリポジトリから[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)を開始しました。Claude アカウントに GitHub アカウントが接続されていないか、接続の有効期限が切れているため、Claude Code は起動を拒否しています。
3960 3970
3961```text theme={null}3971```text theme={null}
3962GitHub 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-github3972GitHub 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
3963```3973```
3964 3974
3965[`/schedule`](https://code.claude.com/docs/ja/routines) でクラウドのスケジュールタスクを作成する場合、同じメッセージがリポジトリ名を含むセットアップの注記として表示されます。この注記はタスクの作成を妨げません。3975[`/schedule`](https://code.claude.com/docs/ja/routines) でクラウドのスケジュールタスクを作成する場合、同じメッセージがリポジトリ名を含むセットアップの注記として表示されます。この注記によってタスクの作成が妨げられることはありません。
3966 3976
3967**対処方法：**3977**対処方法:**
3968 3978
3969* `/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)を参照してください。3979* `/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)を参照してください。
3970* 接続してから 1 分ほど待ってコマンドを再実行します3980* 接続してから 1 分ほど待って、コマンドを再実行します
3971 3981
3972v2.1.268 より前は、Claude Code はこれを Claude GitHub App の確認の一時的な失敗として報告し、再試行またはアプリのインストールを提案していました。どちらも GitHub アカウントを接続するものではありません。3982v2.1.268 より前は、Claude Code はこれを Claude GitHub App の確認の一時的な失敗として報告し、再試行またはアプリのインストールを提案していましたが、どちらの方法でも GitHub アカウントは接続されません。
3973 3983
3974### GitHub の組織ポリシーが Claude をブロックしている3984### GitHub の組織ポリシーが Claude をブロックしている
3975 3985
3976[`/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 はその時点で停止し、該当するポリシーを示すメッセージを表示します。3986[`/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 はそこで停止し、該当するポリシーを示すメッセージを表示します。
3977 3987
3978IP 許可リストがアクセスをブロックしている場合、メッセージは次のようになります。3988IP 許可リストがアクセスをブロックしている場合、メッセージは次のようになります。
3979 3989
3993Your 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.4003Your 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.
3994```4004```
3995 4005
3996**対処方法：**4006**対処方法:**
3997 4007
3998* **IP 許可リスト**：GitHub の組織またはエンタープライズのオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更すべき GitHub の設定については、[GitHub の許可リストとファイアウォール](https://code.claude.com/docs/ja/network-config.md#github-allow-lists-and-firewalls)を参照してください。4008* **IP 許可リスト**: GitHub の組織または Enterprise のオーナーに、Anthropic の送信元 IP アドレスを許可するよう依頼します。アドレスと変更すべき GitHub の設定については、[GitHub の許可リストとファイアウォール](https://code.claude.com/docs/ja/network-config.md#github-allow-lists-and-firewalls)を参照してください。
3999* **シングルサインオン**：[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub を切断してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックし、新しい接続がその組織のシングルサインオンで認可されるようにします。4009* **シングルサインオン**: [claude.ai/customize/connectors](https://claude.ai/customize/connectors) で GitHub の接続を解除してから、再度接続します。GitHub から求められたら、組織の横にある **Authorize** をクリックして、新しい接続がその組織のシングルサインオンで認可されるようにします。
4000* **条件付きアクセスポリシー**：GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します4010* **条件付きアクセスポリシー**: GitHub Enterprise または Microsoft Entra ID の管理者に、そのポリシーで Claude を許可するよう依頼します
4001* 変更後、コマンドを再度実行します4011* 変更後、コマンドを再実行します
4002 4012
4003### Single sign-on authorization needed4013### Single sign-on authorization needed
4004 4014
4009<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.4019<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.
4010```4020```
4011 4021
4012**対処方法：**4022**対処方法:**
4013 4023
4014* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` スコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します4024* `gh auth refresh -h github.com -s repo,workflow` を実行して、`repo` と `workflow` のスコープで GitHub CLI のログインを再認可し、GitHub からシングルサインオンを求められたら組織を認可します
4015* `GH_TOKEN` の個人用アクセストークンで認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します4025* `GH_TOKEN` の個人用アクセストークンで認証している場合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トークンの **Configure SSO** を選択して組織を認可します
4016* `/install-github-app` を再度実行します4026* `/install-github-app` を再実行します
4017 4027
4018v2.1.273 より前は、この状況では代わりに `Admin permissions required` 警告が表示されていました。4028v2.1.273 より前は、この状況では代わりに `Admin permissions required` の警告が表示されていました。
4019 4029
4020### Failed to resume the conversation4030### Failed to resume the conversation
4021 4031
4022[`claude --resume` ピッカー](https://code.claude.com/docs/ja/sessions#use-the-session-picker)から選択したセッションの保存済みトランスクリプトを Claude Code が読み取りまたは処理できなかったため、部分的に読み込まれた状態で続行するのではなく、プロセスを終了します。メッセージには再試行するためのコマンドが含まれます。4032[`claude --resume` ピッカー](https://code.claude.com/docs/ja/sessions#use-the-session-picker)で選択したセッションについて、保存されたトランスクリプトを Claude Code が読み取れないか処理できなかったため、部分的に読み込まれた状態で続行するのではなく、プロセスを終了しています。メッセージには再試行用のコマンドが含まれます。
4023 4033
4024```text theme={null}4034```text theme={null}
4025Failed to resume the conversation.4035Failed to resume the conversation.
4026Run claude --resume <session-id> to retry, or claude to start a new session.4036Run claude --resume <session-id> to retry, or claude to start a new session.
4027```4037```
4028 4038
4029Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは実行を継続します。v2.1.216 より前は、`claude --resume` ピッカーからの再開に失敗すると、このメッセージを表示する代わりに `Resuming conversation…` スピナーが表示されたままになっていました。4039Claude Code はメッセージを表示した後、終了コード 1 で終了します。実行中のセッション内の `/resume` ピッカーでは、代わりに会話内に `Failed to resume conversation` と表示され、現在のセッションは引き続き実行されます。v2.1.216 より前は、`claude --resume` ピッカーからの再開に失敗すると、このメッセージを表示せずに `Resuming conversation…` スピナーのまま止まっていました。
4030 4040
4031**対処方法：**4041**対処方法:**
4032 4042
4033* メッセージに示されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します4043* メッセージに示されたセッション ID を使って `claude --resume <session-id>` を実行し、再試行します
4034* v2.1.285 より前のバージョンで、再試行が同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存済みトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。4044* v2.1.285 より前のバージョンで、再試行しても同じように失敗する場合は、`claude update` を実行してから再度再開します。これらのバージョンでは、保存されたトランスクリプトに読み取れないエントリが含まれていると再開に失敗します。
4035* 再試行が再び失敗する場合は、`claude` を実行して新しいセッションを開始します4045* 再試行しても再び失敗する場合は、`claude` を実行して新しいセッションを開始します
4036 4046
4037### No conversation found with the session ID4047### No conversation found with the session ID
4038 4048
4039`claude --resume <session-id>` にセッション ID を渡しましたが、一致する保存済みトランスクリプトがありませんでした。4049`claude --resume <session-id>` にセッション ID を渡しましたが、一致する保存済みのトランスクリプトがありませんでした。
4040 4050
4041```text theme={null}4051```text theme={null}
4042No conversation found with session ID: <session-id>4052No conversation found with session ID: <session-id>
4043```4053```
4044 4054
4045Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は [まず現在のプロジェクトを検索し、次にこのマシン上の他のすべてのプロジェクト](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)で ID を検索します。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開する必要がありました。4055Claude Code はメッセージを表示した後、終了コード 1 で終了します。Claude Code は、[まず現在のプロジェクトを、次にこのマシン上の他のすべてのプロジェクトを](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)対象にその ID を検索します。v2.1.223 より前は、検索は現在のプロジェクトディレクトリとその git worktree で止まっていたため、セッションが最後に作業していたディレクトリから再開する必要がありました。
4046 4056
4047主な原因：4057主な原因:
4048 4058
4049* **ID の入力ミス**：非対話型の実行では、ID は [`--output-format json` の出力](https://code.claude.com/docs/ja/headless#get-structured-output)の `session_id` フィールドです4059* **ID の入力ミス**: 非インタラクティブな実行の場合、ID は [`--output-format json` の出力](https://code.claude.com/docs/ja/headless#get-structured-output)の `session_id` フィールドです
4050* **トランスクリプトの削除**：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)に従って削除します4060* **トランスクリプトの削除**: 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)に従って削除します
4051* **別のマシン**：Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開してください4061* **別のマシン**: Claude Code はトランスクリプトをローカルに保存するため、セッションを実行したマシンで再開します
4052* **重複したコピー**：`~/.claude/projects` 配下のプロジェクトディレクトリをコピーして 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらか一方を任意に再開するのではなく、このメッセージを表示します4062* **重複したコピー**: `~/.claude/projects` 配下のプロジェクトディレクトリをコピーしたことで 2 つのトランスクリプトが同じ ID を持つ場合、Claude Code はどちらか一方を任意に再開するのではなく、このメッセージを表示します
4053 4063
4054**対処方法：**4064**対処方法:**
4055 4065
4056* 対話型セッションの場合は、`claude --resume` で[セッションピッカー](https://code.claude.com/docs/ja/sessions.md#use-the-session-picker)を開き、`Ctrl+A` を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します4066* インタラクティブなセッションの場合は、`claude --resume` で[セッションピッカー](https://code.claude.com/docs/ja/sessions.md#use-the-session-picker)を開き、`Ctrl+A` を押してこのマシン上のすべてのプロジェクトに範囲を広げてから、セッションを選択します
4057* `claude -p` または [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) で作成したセッションはピッカーに表示されないため、元の実行で出力された `session_id` と ID を照合し直してください4067* `claude -p` または [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) で作成したセッションはピッカーに表示されないため、元の実行で出力された `session_id` と ID を照合し直します
4058 4068
4059### Windows reported an error (EBADF) when Claude Code read this session's transcript file4069### Windows reported an error (EBADF) when Claude Code read this session's transcript file
4060 4070
4061Windows でセッションを再開したところ、保存済みの[トランスクリプトファイル](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)は正常に開いたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーからは読み取りが失敗した理由がわからないため、メッセージには考えられる原因と試すべきことが示されます。4071Windows でセッションを再開したところ、保存された[トランスクリプトファイル](https://code.claude.com/docs/ja/sessions.md#where-transcripts-are-stored)は正常に開かれたものの、その後の読み取りがシステムエラー EBADF で失敗しました。システムエラーからは読み取りが失敗した理由がわからないため、メッセージでは考えられる原因と試すべき対処が提案されます。
4062 4072
4063```text theme={null}4073```text theme={null}
4064Windows 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.4074Windows 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.
4065```4075```
4066 4076
4067このメッセージは、`Failed to resume session <session-id>` などのコマンド自体の失敗を示す行の後に表示されます。`claude --resume` または [`claude -p`](https://code.claude.com/docs/ja/headless) コマンドは、これを表示した後に終了コード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションは実行を継続します。4077このメッセージは、`Failed to resume session <session-id>` のようなコマンド自体の失敗行の後に表示されます。`claude --resume` または [`claude -p`](https://code.claude.com/docs/ja/headless) コマンドは、メッセージを表示した後、終了コード 1 で終了します。セッション内で `/resume` を実行した場合は、現在のセッションが引き続き実行されます。
4068 4078
4069**対処方法：**4079**対処方法:**
4070 4080
4071* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアの対象から、セッションのトランスクリプトを保存しているフォルダーを除外します。トランスクリプトはデフォルトでは `%USERPROFILE%\.claude\projects` 配下、または [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) で指定されたディレクトリ配下にあります4081* セキュリティ、暗号化、エンドポイント管理ツールなど、ファイルの読み取りをスキャンまたはインターセプトするソフトウェアの対象から、セッションのトランスクリプトを保存するフォルダーを除外します。トランスクリプトは、デフォルトでは `%USERPROFILE%\.claude\projects` 配下に、または [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) で指定されたディレクトリ配下に保存されます
4072* 除外を追加できない場合は、代わりにそのソフトウェアの許可アプリケーションに Claude Code を追加します4082* 除外を追加できない場合は、代わりにそのソフトウェアの許可されたアプリケーションに Claude Code を追加します
4073* セッションを再度再開します4083* セッションを再度再開します
4074 4084
4075v2.1.282 より前は、この失敗には説明がありませんでした。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終了し、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようにシステムエラーのテキストのみが出力されていました。4085v2.1.282 より前は、この失敗は説明なしで発生していました。`claude --resume <session-id>` は `Failed to resume session <session-id>` で終わり、`-p` の実行では `Failed to resume session: EBADF: bad file descriptor, read` のようなシステムエラーのテキストだけが出力されていました。
4076 4086
4077### Cannot switch renderers in this session4087### Cannot switch renderers in this session
4078 4088
4079レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を行わないセッションで [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります。4089レンダラーを切り替えると、Claude Code はプロセスを再起動します。Claude Code が再起動を見送るセッションで [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) を実行したため、切り替えは行われず、何も保存されません。表示されるメッセージによって原因がわかります。
4080 4090
4081* `Cannot switch renderers while work is running in the background`：バックグラウンドシェルやサブエージェントなど、再起動すると放棄されてしまうバックグラウンドの作業が実行中です。作業が完了するのを待つか、[`/tasks`](https://code.claude.com/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再度実行します4091* `Cannot switch renderers while work is running in the background`: バックグラウンドシェルやサブエージェントなど、再起動によって中断されてしまうバックグラウンドの作業が実行中です。作業が終わるのを待つか、[`/tasks`](https://code.claude.com/docs/ja/commands) で停止してから、`/tui fullscreen` または `/tui default` を再実行します
4082* `Cannot switch renderers in this session`：セッションに、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動されたセッションはそれらの制限なしで実行されていました4092* `Cannot switch renderers in this session`: セッションに、Claude Code が再起動後のプロセスに引き継げない制限があります。v2.1.234 より前は、Claude Code はそれでも再起動し、再起動後のセッションはそれらの制限なしで実行されていました
4083 4093
4084制限に関するメッセージでは、括弧内の部分に Claude Code が検出した制限が示されます。4094制限に関するメッセージでは、括弧内に Claude Code が検出した制限が示されます。
4085 4095
4086```text theme={null}4096```text theme={null}
4087Cannot 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.4097Cannot 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.
4089 4099
4090メッセージの括弧内に表示される可能性のある理由は次のとおりです。4100メッセージの括弧内に表示される可能性のある理由は次のとおりです。
4091 4101
4092* `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) が含まれます4102* `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) があります
4093* `permission rules set for this session only`：フックまたは SDK の呼び出し元からの[権限の更新](https://code.claude.com/docs/ja/hooks.md#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。再起動するとそれらのルールは破棄され、Claude Code は代わりに再度確認を求めます4103* `permission rules set for this session only`: フックまたは SDK の呼び出し元からの[権限の更新](https://code.claude.com/docs/ja/hooks.md#permission-update-entries)によって、`session` を宛先とする拒否ルールまたは確認ルールが追加されました。セッションスコープの許可ルールでは拒否は発生しません。許可ルールは再起動で破棄され、Claude Code は改めて確認を求めます
4094* `ask-before-running rules with no command-line form`：フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` および `--disallowed-tools` として引き継ぐルールに加えて、確認ルールが追加されました。確認ルールに対応するフラグは存在しません4104* `ask-before-running rules with no command-line form`: フックまたは SDK の呼び出し元からの権限の更新によって、Claude Code が `--allowed-tools` と `--disallowed-tools` として引き継ぐルールに加えて、確認ルールが追加されました。確認ルール用のフラグは存在しません
4095* `permission rules a command line cannot carry intact` および `added directories a command line cannot carry intact`：権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継ぐことができません4105* `permission rules a command line cannot carry intact` と `added directories a command line cannot carry intact`: 権限の更新によって、セッションの途中でルールまたはディレクトリパスが追加されました。再起動後のプロセスのコマンドラインでは、そのテキストを同じ値として引き継げません
4096 4106
4097**対処方法：**4107**対処方法:**
4098 4108
4099* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻すには `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します4109* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻す場合は `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します
4100 4110
4101### Can't restart while work is running or Remote Control is connected4111### Can't restart while work is running or Remote Control is connected
4102 4112
4103Claude Code は再起動せず、セッションはそのまま実行を続けています。メッセージに示された修正方法に従ってください。4113Claude Code は再起動せず、セッションはそのまま実行され続けています。メッセージに示された修正方法に従ってください。
4104 4114
4105### Claude Code couldn't restart4115### Claude Code couldn't restart
4106 4116
4107このメッセージで会話が保存されていると表示された場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングとの切り替えを行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。4117このメッセージで会話が保存されていると示されている場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングへの切り替えまたは解除を行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。
4108 4118
4109```text theme={null}4119```text theme={null}
4110Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.4120Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.
4111```4121```
4112 4122
4113新しいセッションで `/tui` が最初の入力だった場合など、再起動時に再び開く会話がなかった場合、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。4123新しいセッションで最初に入力したのが `/tui` だった場合など、再起動時に再度開く会話がなかったときは、メッセージは `Claude Code couldn't restart. Start Claude Code again.` となります。
4114 4124
4115**対処方法：**4125**対処方法:**
4116 4126
4117* シェルで `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)4127* シェルで `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)
4118* 再起動が失敗し続ける場合は、シェルから [`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)際にはその行を含めてください4128* 再起動が失敗し続ける場合は、シェルから [`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)際には、その行を含めてください
4119 4129
4120### Couldn't open Claude Desktop4130### Couldn't open Claude Desktop
4121 4131
4122セッション内で [`/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 で終了します。4132セッションで [`/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 で終了します。
4123 4133
4124括弧内のテキストには、失敗したコマンドと、コマンドが出力した場合はその終了ステータスとエラー出力の最初の行が示されます。macOS ではこのコマンドは次の例のように `open` で、Windows では `rundll32` です。4134括弧内のテキストには、失敗したコマンドが、終了ステータスとエラー出力の最初の行（出力があった場合）とともに示されます。macOS ではこの例のようにコマンドは `open`、Windows では `rundll32` です。
4125 4135
4126```text theme={null}4136```text theme={null}
4127Error: 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.4137Error: 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.
4128```4138```
4129 4139
4130**対処方法：**4140**対処方法:**
4131 4141
4132* Claude Desktop を手動で開いてから、`/desktop` または `claude --desktop` を再度実行します4142* 自分で Claude Desktop を開いてから、`/desktop` または `claude --desktop` を再実行します
4133* 失敗したコマンドの完全なエラー出力を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します4143* 失敗したコマンドの完全なエラー出力を確認するには、`/debug` でデバッグログをオンにして `/desktop` を再実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認します
4134 4144
4135v2.1.285 より前は、メッセージは `Open Claude Desktop and run /desktop again.` で終わっていました。v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかは示されていませんでした。4145v2.1.285 より前は、メッセージは `Open Claude Desktop and run /desktop again.` で終わっていました。v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したのかは示されていませんでした。
4136 4146
4137### /terminal-setup で Zed のキーマップが変更されなかった4147### /terminal-setup で Zed のキーマップが変更されなかった
4138 4148
4139Zed で [`/terminal-setup`](https://code.claude.com/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code は Zed の `keymap.json` の更新を完了できなかったため、ファイルを元のままにしました。4149Zed で [`/terminal-setup`](https://code.claude.com/docs/ja/terminal-config#enter-multiline-prompts) を実行しましたが、Claude Code は Zed の `keymap.json` の更新を完了できなかったため、ファイルをそのままにしました。
4140 4150
4141各メッセージにはキーマップのパスが示され、手動で追加するためのキーボードショートカットのブロックで終わります。4151各メッセージにはキーマップのパスが示され、自分で追加するためのキーボードショートカットのブロックで終わります。
4142 4152
4143```text theme={null}4153```text theme={null}
4144Couldn't update your Zed keymap, so it was left unchanged.4154Couldn't update your Zed keymap, so it was left unchanged.
4146{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }4156{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
4147```4157```
4148 4158
4149メッセージの最初の行には原因が示されます。4159メッセージの最初の行に原因が示されます。
4150 4160
4151* `Couldn't read your Zed keymap, so it was left unchanged.`：ファイルの権限などが原因で、Claude Code がファイルを読み取れませんでした4161* `Couldn't read your Zed keymap, so it was left unchanged.`: ファイルの権限などの理由で、Claude Code がファイルを読み取れませんでした
4152* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`：ファイルは読み取れましたが、`//` コメントや末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません4162* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: ファイルは読み取れましたが、`//` コメントと末尾のカンマを許容しても、キーボードショートカットのブロックの配列として解析できません
4153* `Couldn't back up your Zed keymap; not modifying it.`：Claude Code がファイルを隣の `.bak` バックアップにコピーできなかったため、何も変更しませんでした4163* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code がファイルを隣の `.bak` バックアップにコピーできなかったため、何も変更しませんでした
4154* `Couldn't update your Zed keymap, so it was left unchanged.`：マージ結果が、バインディングを含む有効なキーマップとして検証されなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックが原因となる場合があります4164* `Couldn't update your Zed keymap, so it was left unchanged.`: マージ結果が、そのキーボードショートカットを含む有効なキーマップとして検証されなかったため、Claude Code は書き込まずに破棄しました。キーが重複したキーボードショートカットのブロックが原因となる場合があります
4155 4165
4156**対処方法：**4166**対処方法:**
4157 4167
4158* メッセージのブロックを、メッセージに示されたパスにある `keymap.json` のトップレベルの配列にコピーします4168* メッセージのブロックを、メッセージに示されたパスにある `keymap.json` の最上位の配列にコピーします
4159* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルのトップレベルの値を配列にしてから、`/terminal-setup` を再度実行します4169* `isn't a readable list of keybindings` の場合は、構文エラーを修正するか、ファイルの最上位の値を配列にしてから、`/terminal-setup` を再実行します
4160 4170
4161v2.1.247 より前は、`/terminal-setup` は `//` コメントや末尾のカンマを使用した Zed のキーマップを解析できず、ファイル全体を自身のバインディングのみで置き換えたうえで、バインディングがインストールされたと報告していました。以前のバージョンで置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)で説明している `.bak` バックアップファイルを使用してください。4171v2.1.247 より前は、`/terminal-setup` は `//` コメントや末尾のカンマを使用した Zed のキーマップを解析できず、ファイル全体を自身のキーボードショートカットだけで置き換えたうえで、キーボードショートカットがインストールされたと報告していました。以前のバージョンで置き換えられたキーマップを復元するには、[複数行のプロンプトを入力する](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)で説明している `.bak` バックアップファイルを使用します。
4162 4172
4163### Skill usage reports are not available on this connection4173### Skill usage reports are not available on this connection
4164 4174
4165スマートフォンまたはブラウザから [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 経由ではスキルの使用状況レポートを送信せず、代わりに次のメッセージを返します。4175スマートフォンやブラウザから [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 経由で送信せず、代わりに次のメッセージを返します。
4166 4176
4167```text theme={null}4177```text theme={null}
4168Skill usage reports are not available on this connection.4178Skill usage reports are not available on this connection.
4169```4179```
4170 4180
4171**対処方法：**4181**対処方法:**
4172 4182
4173* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そのマシンで `claude -p "/skill-doctor"` を実行します4183* セッションが実行されているマシンのターミナルで `/skill-doctor` を実行するか、そのマシンで `claude -p "/skill-doctor"` を実行します
4174 4184
4175### Custom output styles can't be selected over Remote Control4185### Custom output styles can't be selected over Remote Control
4176 4186
4177[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)の名前には、存在しない名前と同じ応答が返されます。4187[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)の名前には、存在しない名前と同じ応答が返されます。
4178 4188
4179```text theme={null}4189```text theme={null}
4180Custom 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.4190Custom 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.
4181```4191```
4182 4192
4183**対処方法：**4193**対処方法:**
4184 4194
4185* `/output-style concise` のように組み込みスタイルを選択します4195* `/output-style concise` のように、組み込みスタイルを選択します
4186* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体にターミナルがある場合はそこで `/output-style <style>` を実行します4196* カスタムスタイルを使用するには、プロジェクトの `.claude/settings.local.json` で [`outputStyle`](https://code.claude.com/docs/ja/settings-reference#outputstyle) を設定するか、セッション自体にターミナルがある場合はそこで `/output-style <style>` を実行します
4187 4197
4188### Output styles are saved to local settings which this session doesn't load4198### Output styles are saved to local settings which this session doesn't load
4189 4199
4190設定ソースから `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 は効果のない設定を書き込む代わりに拒否します。4200設定ソースに `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 は効果のない設定を書き込む代わりに拒否します。
4191 4201
4192```text theme={null}4202```text theme={null}
4193Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.4203Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
4194```4204```
4195 4205
4196**対処方法：**4206**対処方法:**
4197 4207
4198* セッションの設定ソースに `local` を追加してから、再度切り替えます4208* セッションの設定ソースに `local` を追加してから、再度切り替えます
4199* プロジェクトの `.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)を参照してください4209* プロジェクトの `.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)を参照してください
4200 4210
4201### /recap only runs when you ask for it yourself4211### /recap only runs when you ask for it yourself
4202 4212
4203[`/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)や別のプログラムが送信したプロンプトで届きました。4213[`/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)や別のプログラムが送信したプロンプトで届いています。
4204 4214
4205中継されたメッセージは、ユーザー自身が書いたものであっても通知の対象になります。Claude Code は、中継されたメッセージや自動化されたメッセージが、セッションを実行しているアカウントの本人からのものかどうかを判断できないため、要約の代わりに次の通知で応答します。4215中継されたメッセージには、自分で書いたものであってもこの通知が表示されます。Claude Code は、中継されたメッセージや自動化されたメッセージが、セッションを実行しているアカウントの本人からのものかを判断できないため、要約の代わりに次の通知を返します。
4206 4216
4207```text theme={null}4217```text theme={null}
4208/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.4218/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.
4209```4219```
4210 4220
4211`claude -p` に渡した `/recap` や、独自の [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーションが起動したセッションに送信する `/recap` は、ユーザー自身の入力として扱われます。4221`claude -p` に渡す `/recap` や、自分の [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) アプリケーションが起動したセッションに送信する `/recap` は、ユーザー自身の入力として扱われます。
4212 4222
4213**対処方法：**4223**対処方法:**
4214 4224
4215* セッションを自分で開き、そこで `/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) 経由で実行できます4225* 自分でセッションを開き、そのターミナル、[デスクトップアプリ](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` を実行します
4216* クラウドのスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します4226* クラウドのスケジュールタスクや別のプログラムが送信した場合は、そのプロンプトから `/recap` を削除します
4217 4227
4218### /feedback is disabled by your organization's policy4228### /feedback is disabled by your organization's policy
4223/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.4233/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.
4224```4234```
4225 4235
4226メッセージが最初の文のみの場合もあります。4236メッセージが最初の文だけの場合もあります。
4227 4237
4228**対処方法：**4238**対処方法:**
4229 4239
4230* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成します。そこでの issue は誰でも閲覧できるため、コード、トランスクリプト、その他の機密情報は含めないでください。4240* バグを報告するには、[github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) で issue を作成します。そこにある issue は誰でも閲覧できるため、コード、トランスクリプト、その他の機密情報は含めないでください。
4231 4241
4232v2.1.302 より前は、完全なメッセージは `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。4242v2.1.302 より前は、完全なメッセージは `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.` でした。
4233 4243
