SpyBara
Go Premium

Documentation 2026-11-12 23:02 UTC to 2026-11-13 02:00 UTC

36 files changed +155 −127. View all changes and history on the product overview
2026
Fri 13 02:00 Thu 12 23:02 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57
Details

349 349 

350### モデルがセッション中に無効化される場合350### モデルがセッション中に無効化される場合

351 351 

352セッションが実行されているモデルへのアカウントアクセスが失われた場合(例えば、管理者が Amazon Bedrock アカウントでそれを無効化した場合)、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。スタートアップフォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合、デフォルト Sonnet モデルを試します。352Amazon Bedrock がセッションのモデルをアカウントで利用できないとして拒否した場合、Claude Code はセッションを別のモデルに切り替えるため、作業を続けられます。`Switched to <fallback> because <model> is not available` で始まるメッセージが表示されます。これは、例えば管理者がモデルを無効化した場合や、最新のモデルがまだアカウントで利用できない場合に発生します。

353 353 

354切り替えは、ピン留めしていないティアにのみ適用されます。これはスタートアップフォールバックと同じ条件です。選択した特定のバージョン、または[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)でセッションを実行している場合、そのモデルを保持し、フォールバックモデルチェーンがないため、リクエストは失敗します。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Amazon Bedrock で auto モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは[AWS 認証失敗](https://code.claude.com/docs/ja/errors.md#aws-authentication-failed)で失敗し、モデルを有効にするためのヒントが表示されます。354[フォールバックモデルチェーン](https://code.claude.com/docs/ja/model-config.md#fallback-model-chains)を設定している場合、Claude Code は代わりに設定したフォールバックに切り替えます。チェーンがない場合、次のようなケースではリクエストが失敗します。

355 355 

356設定した[フォールバックモデルチェーン](https://code.claude.com/docs/ja/model-config.md#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否では Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わるのではなく失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否で切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。356* セッションが、ピン留めされたモデル、選択した特定のバージョン、または[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile) で実行されている

357* [Claude Code が試すモデル](#startup-model-checks)がどれも利用できない。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Amazon Bedrock で auto モードがサポートするモデルにのみ切り替えます。

358 

359作業を続けるには、セッションで `/model` を実行し、アカウントで使用できるモデル上で `s` を押してください。この操作ではデフォルトは変更されません。`403` は [AWS authentication failed](https://code.claude.com/docs/ja/errors.md#aws-authentication-failed) として表示されます。

360 

361拒否されたリクエストが切り替わるのではなく失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。フォールバックモデルチェーンを設定している場合は、Claude Code が引き続きそのフォールバックに移行するため、チェーンも削除してください。

357 362 

358## クロスリージョン推論プロファイルプレフィックス363## クロスリージョン推論プロファイルプレフィックス

359 364 

Details

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

Details

74| PostgreSQL 11 以降 | デバイスサインインフローとレート制限カウンターをサポートします。最小層を含むマネージド PostgreSQL サービスが利用できます。[サポートされているデータベース](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#postgres)を参照してください。[支出制限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md)を使用すると、バックアップする必要がある耐久的な支出、監査、およびアイデンティティテーブルも保持します。`?sslmode=require` 経由の TLS が推奨されます。PostgreSQL 11、12、13 には、ゲートウェイサーバーで Claude Code v2.1.290 以降が必要です。PostgreSQL プロジェクトはこれらのバージョンの保守を終了しているため、可能な場合は新しいバージョンを使用してください。 |74| PostgreSQL 11 以降 | デバイスサインインフローとレート制限カウンターをサポートします。最小層を含むマネージド PostgreSQL サービスが利用できます。[サポートされているデータベース](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#postgres)を参照してください。[支出制限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md)を使用すると、バックアップする必要がある耐久的な支出、監査、およびアイデンティティテーブルも保持します。`?sslmode=require` 経由の TLS が推奨されます。PostgreSQL 11、12、13 には、ゲートウェイサーバーで Claude Code v2.1.290 以降が必要です。PostgreSQL プロジェクトはこれらのバージョンの保守を終了しているため、可能な場合は新しいバージョンを使用してください。 |

75| モデルアップストリーム | Amazon Bedrock 認証情報、Claude Platform on AWS 認証情報、Google Cloud 認証情報、Microsoft Foundry リソース、または Anthropic API キー。複数のアップストリームがサポートされ、フェイルオーバーがあります。 |75| モデルアップストリーム | Amazon Bedrock 認証情報、Claude Platform on AWS 認証情報、Google Cloud 認証情報、Microsoft Foundry リソース、または Anthropic API キー。複数のアップストリームがサポートされ、フェイルオーバーがあります。 |

76| HTTPS | ゲートウェイは開発者ラップトップとサインインに使用されるブラウザから `https://` 経由で到達可能である必要があります。ゲートウェイは同じリスナーでデバイス検証ページを提供します。`listen.tls` 経由で TLS 証明書を提供するか、TLS 終了イングレスの背後で実行し、いずれの場合も `listen.public_url` を外部オリジンに設定します。`/login` では、Claude Code はゲートウェイホストがループバック(`localhost`、`127.0.0.1`、または `::1`)の場合にのみプレーン `http://` オリジンを受け入れます。 |76| HTTPS | ゲートウェイは開発者ラップトップとサインインに使用されるブラウザから `https://` 経由で到達可能である必要があります。ゲートウェイは同じリスナーでデバイス検証ページを提供します。`listen.tls` 経由で TLS 証明書を提供するか、TLS 終了イングレスの背後で実行し、いずれの場合も `listen.public_url` を外部オリジンに設定します。`/login` では、Claude Code はゲートウェイホストがループバック(`localhost`、`127.0.0.1`、または `::1`)の場合にのみプレーン `http://` オリジンを受け入れます。 |

77| プライベートネットワークアドレス | `/login` では、Claude Code はゲートウェイのホスト名または IP アドレスがプライベートアドレスのみに解決されることを要求します。RFC 1918、リンクローカル、CGNAT `100.64.0.0/10`、IPv6 ULA `fc00::/7`、またはループバック。ホストするゲートウェイの場合、宣言するブロック外のパブリックアドレスは拒否されます。デプロイガイドの[脅威モデル](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#threat-model-summary)を参照してください。開発者マシンが HTTPS を企業プロキシ経由でルーティングする場合、サインインはプロキシホストもプライベートアドレスに解決されることを要求します。そうでない場合は、ゲートウェイホストを `NO_PROXY` に追加して、CLI が直接接続するようにします。内部ネットワークが組織が所有するパブリック IPv4 スペースから番号付けされている場合は、[これらのブロックを宣言](#allow-a-gateway-on-public-address-space-you-own)して、`/login` がそこでゲートウェイを受け入れるようにします。 |77| プライベートネットワークアドレス | `/login` では、Claude Code はゲートウェイのホスト名または IP アドレスがプライベートアドレスのみに解決されることを要求します。プライベートアドレスとは、RFC 1918 およびリンクローカル範囲、CGNAT `100.64.0.0/10`、IPv6 ULA `fc00::/7`、ループバックです。[脅威モデル](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#threat-model-summary)を参照してください。内部ネットワークが組織が所有するパブリック IPv4 スペースから番号付けされている場合は、[これらのブロックを宣言](#allow-a-gateway-on-public-address-space-you-own)して、`/login` がそこでゲートウェイを受け入れるようにします。 |

78| Linux ランタイム | ゲートウェイサーバーはネイティブ Linux バイナリでのみ実行されます。macOS はローカル開発用に機能します。Windows はサーバープラットフォームとしてサポートされていません。 |78| Linux ランタイム | ゲートウェイサーバーはネイティブ Linux バイナリでのみ実行されます。macOS はローカル開発用に機能します。Windows はサーバープラットフォームとしてサポートされていません。 |

79 79 

80ゲートウェイホストに `HTTPS_PROXY` または `HTTP_PROXY` が適用される場合、サインインには、ホスト名がプライベートアドレスに解決されるプロキシか、開発者マシンの `NO_PROXY` にゲートウェイホストが含まれていることも必要です。これらのマシンで `no_proxy` も設定している場合は、そこにもゲートウェイホストを追加してください。追加しないと、モデルリクエストは引き続きプロキシを経由します。

81 

80### ステップ82### ステップ

81 83 

82**1. IdP で OAuth クライアントを登録する**84**1. IdP で OAuth クライアントを登録する**

Details

654 654 

655| セットアップ | 方法 |655| セットアップ | 方法 |

656| - | - |656| - | - |

657| RBAC | ゲートウェイの ID に、Microsoft Foundry リソースに対する `Azure AI User` または `Cognitive Services User` を付与します |657| RBAC | ゲートウェイの ID に、Microsoft Foundry リソースに対する `Foundry User` または `Cognitive Services User` ロールを付与します |

658| デプロイ | Microsoft Foundry は、正規のモデル ID ではなく管理者が選択したデプロイ名を使用します。各正規 ID をデプロイ名にマッピングする [`models:`](#models) ブロックを追加してください。 |658| デプロイ | Microsoft Foundry は、正規のモデル ID ではなく管理者が選択したデプロイ名を使用します。各正規 ID をデプロイ名にマッピングする [`models:`](#models) ブロックを追加してください。 |

659| AKS(ワークロード ID) | ユーザー割り当てマネージド ID をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` が `WorkloadIdentityCredential` 経由でそれを取得します。 |659| AKS(ワークロード ID) | ユーザー割り当てマネージド ID をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` が `WorkloadIdentityCredential` 経由でそれを取得します。 |

660| ACI / App Service | リソースでシステム割り当てまたはユーザー割り当てのマネージド ID を有効にします。`use_azure_ad: true` がそれを取得します。 |660| ACI / App Service | リソースでシステム割り当てまたはユーザー割り当てのマネージド ID を有効にします。`use_azure_ad: true` がそれを取得します。 |


999 999 

1000`upstream_model` の各キーは、設定された上流の `name` と一致する必要があります。デフォルトはプロバイダー名です。キーが上流と一致しない場合、ブート失敗を引き起こすため、使用しないプロバイダーの行は省略してください。1000`upstream_model` の各キーは、設定された上流の `name` と一致する必要があります。デフォルトはプロバイダー名です。キーが上流と一致しない場合、ブート失敗を引き起こすため、使用しないプロバイダーの行は省略してください。

1001 1001 

1002`auto_include_builtin_models: false` で開発者が `fable` エイリアスを使用できるようにするには、`models` に `claude-fable-5` エントリを追加します。これは、ゲートウェイにサインインした開発者に対して [`fable` エイリアス](https://code.claude.com/docs/ja/model-config#fable-alias-resolution) が解決される ID です。これがないと、メッセージは `API Error: 400 model claude-fable-5 is not in the operator's model allowlist` で始まるエラーで失敗します。

1003 

1002### `managed`1004### `managed`

1003 1005 

1004`managed` ブロックは、IdP グループまたはメールドメインをキーとするロールベースのアクセスポリシーを定義します。ポリシーは順番に評価されます。デフォルトでは最初に一致したポリシーが選択され、`match: {}` のキャッチオールのベースにマージされます。2 つのロールポリシーに一致するユーザーには最初のポリシーのみが適用されるため、[一致するすべてのポリシーを適用](#apply-every-matching-policy)しない限り、2 番目のポリシーの拒否ルールは適用されません。ポリシーは `GET /managed/settings` でユーザーごとに提供され、ETag/304 によるキャッシュが行われます。1006`managed` ブロックは、IdP グループまたはメールドメインをキーとするロールベースのアクセスポリシーを定義します。ポリシーは順番に評価されます。デフォルトでは最初に一致したポリシーが選択され、`match: {}` のキャッチオールのベースにマージされます。2 つのロールポリシーに一致するユーザーには最初のポリシーのみが適用されるため、[一致するすべてのポリシーを適用](#apply-every-matching-policy)しない限り、2 番目のポリシーの拒否ルールは適用されません。ポリシーは `GET /managed/settings` でユーザーごとに提供され、ETag/304 によるキャッシュが行われます。


1023`match: {}` キャッチオール(慣例的に最後にリストされる)は基盤層として扱われます。他のすべてのポリシーは、設定しないキーをキャッチオールから継承するため、ロールごとのエントリは組織のデフォルトと異なる内容のみをリストすれば済みます。マージルールはキータイプに依存します:1025`match: {}` キャッチオール(慣例的に最後にリストされる)は基盤層として扱われます。他のすべてのポリシーは、設定しないキーをキャッチオールから継承するため、ロールごとのエントリは組織のデフォルトと異なる内容のみをリストすれば済みます。マージルールはキータイプに依存します:

1024 1026 

1025* **許可リスト**:`availableModels` と `permissions.allow`。特定のポリシーのリストは基盤のリストを完全に置き換えます。1027* **許可リスト**:`availableModels` と `permissions.allow`。特定のポリシーのリストは基盤のリストを完全に置き換えます。

1026* **拒否リストとフック配列**:`permissions.deny`、`permissions.ask`、`disabledMcpjsonServers`、`deniedMcpServers`、`blockedMarketplaces`、`deniedModels`、およびすべての `hooks` イベントタイプ配列。これらはベースとポリシーの和集合をとるため、組織全体の拒否や監査フックがロールごとの上書きによって誤って失われることはありません。1028* **拒否リストとフック配列**: ベースとポリシーの和集合になります。

1029 * `permissions.deny` と `permissions.ask`

1030 * `disabledMcpjsonServers` と `deniedMcpServers`

1031 * `blockedMarketplaces` と `deniedModels`

1032 * `hooks` のイベントタイプ配列

1027* **レコード型キー**:`env`、`modelOverrides`、`skillOverrides`。これらは浅くマージされるため、ロールごとの `env` ブロックは設定するキーを上書きし、残りを基盤から継承します。1033* **レコード型キー**:`env`、`modelOverrides`、`skillOverrides`。これらは浅くマージされるため、ロールごとの `env` ブロックは設定するキーを上書きし、残りを基盤から継承します。

1028 1034 

1029`availableModels` は `/v1/messages` でサーバー側でも強制されるため、拒否されたモデルはクライアントが送信する内容に関わらず `400` を返します。空のリストはすべてのモデルを拒否します。このチェックは、デベロッパーがモデルを選択する前にセッションが開始するモデルにも適用されるため、[ポリシーが許可するモデルでセッションを開始](#start-sessions-on-a-model-the-policy-allows) してください。1035`availableModels` は `/v1/messages` でサーバー側でも強制されるため、拒否されたモデルはクライアントが送信する内容に関わらず `400` を返します。空のリストはすべてのモデルを拒否します。このチェックは、デベロッパーがモデルを選択する前にセッションが開始するモデルにも適用されるため、[ポリシーが許可するモデルでセッションを開始](#start-sessions-on-a-model-the-policy-allows) してください。

Details

92 92 

93バイナリを超えて、イメージは以下が必要です:93バイナリを超えて、イメージは以下が必要です:

94 94 

95* **glibc ベースのイメージ**:glibc ビルドの唯一の動的依存関係は glibc ライブラリです。Musl ベースのイメージは `linux-x64-musl` または `linux-arm64-musl` ビルドと追加パッケージが必要です。[Alpine Linux セットアップ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions) を参照してください。95* **glibc ベースのイメージ**:glibc ビルドの唯一の動的依存関係は glibc ライブラリです。Musl ベースのイメージには `linux-x64-musl` または `linux-arm64-musl` ビルドが必要で、その唯一の動的依存関係は musl です。

96* **書き込み可能な状態ディレクトリ**:ゲートウェイは任意のユーザーとして実行されますが、最小限のイメージには書き込み可能なホームがありません。`CLAUDE_CONFIG_DIR` を `/tmp/.claude` などの書き込み可能なパスに設定します。96* **書き込み可能な状態ディレクトリ**:ゲートウェイは任意のユーザーとして実行されますが、最小限のイメージには書き込み可能なホームがありません。`CLAUDE_CONFIG_DIR` を `/tmp/.claude` などの書き込み可能なパスに設定します。

97* **コンテナコマンド**:`claude gateway --config /etc/claude/gateway.yaml`。設定ファイルは読み取り専用でマウントされ、シークレットは環境変数として提供されます。ゲートウェイは `listen.port` でリッスンします。デフォルトは `8080` です。97* **コンテナコマンド**:`claude gateway --config /etc/claude/gateway.yaml`。設定ファイルは読み取り専用でマウントされ、シークレットは環境変数として提供されます。ゲートウェイは `listen.port` でリッスンします。デフォルトは `8080` です。

98 98 

Details

274 274 

275スレッドは[自動モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)で実行されるため、Claude はそのフォルダー内のコマンドを実行し、毎回あなたに尋ねることなくファイルを編集します。自動モードがそのコンピューターの Claude Code で利用できないか、オフになっている場合、スレッドはそれなしで実行され、発生するすべての権限プロンプトは、[承認を待機しているスレッドのブロックを解除する](#unblock-a-thread-waiting-on-approval)が説明するように、スレッドであなたの答えを待ちます。275スレッドは[自動モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)で実行されるため、Claude はそのフォルダー内のコマンドを実行し、毎回あなたに尋ねることなくファイルを編集します。自動モードがそのコンピューターの Claude Code で利用できないか、オフになっている場合、スレッドはそれなしで実行され、発生するすべての権限プロンプトは、[承認を待機しているスレッドのブロックを解除する](#unblock-a-thread-waiting-on-approval)が説明するように、スレッドであなたの答えを待ちます。

276 276 

277別のモードでスレッドを実行するには、[`--settings`](https://code.claude.com/docs/ja/remote-control#start-a-remote-control-session) を付けて `claude remote-control` を開始します。そのうえで、そのファイルまたはそのコンピューターの設定にある [`permissions.defaultMode`](https://code.claude.com/docs/ja/permission-modes#start-in-a-different-mode) で別のモードを選択できます。

278 

277スレッドが実行されている間、ヘッダーのラップトップアイコンはコンピューターが接続されているかどうかを示します。クリックしてスレッドが使用しているフォルダーを確認するか、接続をオフにします。そのコンピューターがスリープ状態の間、スレッドは一時停止し、デスクトップアプリまたは `claude remote-control` が終了すると停止します。279スレッドが実行されている間、ヘッダーのラップトップアイコンはコンピューターが接続されているかどうかを示します。クリックしてスレッドが使用しているフォルダーを確認するか、接続をオフにします。そのコンピューターがスリープ状態の間、スレッドは一時停止し、デスクトップアプリまたは `claude remote-control` が終了すると停止します。

278 280 

279* **スレッドを再開するには**:[フォルダーとの接続を失った](#lost-contact-with-your-folder)を参照してください281* **スレッドを再開するには**:[フォルダーとの接続を失った](#lost-contact-with-your-folder)を参照してください

commands.md +0 −2

Details

35以下の表は、Claude Code に含まれるすべてのコマンドを一覧にしています。ほとんどは組み込みコマンドで、その動作は CLI にコード化されています。2 種類のエントリが標記されています:35以下の表は、Claude Code に含まれるすべてのコマンドを一覧にしています。ほとんどは組み込みコマンドで、その動作は CLI にコード化されています。2 種類のエントリが標記されています:

36 36 

37* **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills)**: バンドルスキル。自分で書くスキルと同じように機能します:Claude に渡されるプロンプトです。37* **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills)**: バンドルスキル。自分で書くスキルと同じように機能します:Claude に渡されるプロンプトです。

38 * `/verify` は呼び出したときのみ実行されます。

39* **[Workflow](https://code.claude.com/docs/ja/workflows.md#bundled-workflows)**: バンドルされた[動的ワークフロー](https://code.claude.com/docs/ja/workflows.md)で、多くのサブエージェントに作業を展開し、バックグラウンドで実行されます。38* **[Workflow](https://code.claude.com/docs/ja/workflows.md#bundled-workflows)**: バンドルされた[動的ワークフロー](https://code.claude.com/docs/ja/workflows.md)で、多くのサブエージェントに作業を展開し、バックグラウンドで実行されます。

40 * `/deep-research` は呼び出したときのみ実行されます。

41 39 

42独自のコマンドを追加するには、[スキル](https://code.claude.com/docs/ja/skills.md)を参照してください。40独自のコマンドを追加するには、[スキル](https://code.claude.com/docs/ja/skills.md)を参照してください。

43 41 

Details

71 71 

72アプリケーションランチャーから **Claude** を起動するか、ターミナルから `claude-desktop` を実行して、Anthropic アカウントでサインインします。72アプリケーションランチャーから **Claude** を起動するか、ターミナルから `claude-desktop` を実行して、Anthropic アカウントでサインインします。

73 73 

74Linux アプリは macOS と Windows と同じ方法でサインインします。claude.ai サブスクリプション、または組織の SSO を通じてサインインします。API キー認証には [CLI](https://code.claude.com/docs/ja/quickstart.md) を使用してください。代わりに Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または LLM ゲートウェイで Desktop を使用する場合は、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) を参照してください。これらのデプロイにおけるプロキシサーバーとカスタム認証局については、[ネットワーク設定](https://code.claude.com/docs/ja/network-config.md) を参照してください。74Linux アプリは macOS と Windows と同じ方法でサインインします。claude.ai サブスクリプション、または組織の SSO を通じてサインインします。代わりに Claude API キー、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または LLM ゲートウェイで Desktop を使用する場合は、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) を参照してください。これらのデプロイにおけるプロキシサーバーとカスタム認証局については、[ネットワーク設定](https://code.claude.com/docs/ja/network-config.md) を参照してください。

75 75 

76### ダウンロードしたファイルからインストールする76### ダウンロードしたファイルからインストールする

77 77 

Details

83 83 

84**8. 権限モードとモデルを選択する**84**8. 権限モードとモデルを選択する**

85 85 

86指示ボックスのツールバーで、[権限モード](#permissions-for-scheduled-tasks)とモデルを選択します。変更しない場合、実行には Claude Code の設定とデフォルトのモデルが使用されます。86指示ボックスのツールバーで、[権限モード](#permissions-for-scheduled-tasks)とモデルを選択します。

87 

88* **権限モード**:変更しない場合、実行には Claude Code の設定が使用されます。

89* **モデル**:モデルメニューに **Default · Set by admin** と表示されていて、別のモデルを選択しない場合、実行には組織が[管理設定](https://code.claude.com/docs/ja/managed-settings.md)で設定したモデルが使用されます。アプリの起動時に開始される[キャッチアップ実行](#missed-runs)では、代わりに[アカウントのランタイムデフォルト](https://code.claude.com/docs/ja/model-config.md#default-model-setting)が使用される場合があります。

87 90 

88**9. タスクを作成する**91**9. タスクを作成する**

89 92 

90**Create** をクリックします。まだフォルダを信頼していない場合は、この時点で Desktop がフォルダを信頼するよう求めます。タスクの詳細ページが開きます。93**Create** をクリックします。まだフォルダを信頼していない場合は、この時点で Desktop がフォルダを信頼するよう求めます。タスクの詳細ページが開きます。

91 94 

95**Default · Set by admin** がどのモデルを表しているかを確認するには、詳細ページで **Run now** をクリックしてタスクをすぐに実行します。次に[その実行のセッションを開く](#find-a-runs-session)と、プロンプトボックスの下の行にモデル名が表示されます。

96 

92詳細ページで鉛筆アイコンをクリックすると、[**Edit** フォーム](#manage-scheduled-tasks)が開きます。そこでは、Desktop が指示から自動入力した **Description** を変更したり、**Worktree** を選択したり、スケジュールを **Manual** または **Custom** に切り替えたりできます。97詳細ページで鉛筆アイコンをクリックすると、[**Edit** フォーム](#manage-scheduled-tasks)が開きます。そこでは、Desktop が指示から自動入力した **Description** を変更したり、**Worktree** を選択したり、スケジュールを **Manual** または **Custom** に切り替えたりできます。

93 98 

94任意のセッションで実行したい内容を説明することで、タスクを作成することもできます。たとえば、「毎朝 9 時に実行される毎日のコードレビューを設定する」と言うと、定期的なタスクが作成されます。「明日午後 3 時にデプロイをチェックするよう通知する」のようなリクエストでは、実行後に自分自身を無効にする 1 回限りのタスクが作成されます。99任意のセッションで実行したい内容を説明することで、タスクを作成することもできます。たとえば、「毎朝 9 時に実行される毎日のコードレビューを設定する」と言うと、定期的なタスクが作成されます。「明日午後 3 時にデプロイをチェックするよう通知する」のようなリクエストでは、実行後に自分自身を無効にする 1 回限りのタスクが作成されます。


181 186 

182タスクが `update_scheduled_task` MCP ツールを使用して自身のスケジュールまたはプロンプトを変更できるようにするには、**Run now** をクリックし、その呼び出しを毎回承認してください。187タスクが `update_scheduled_task` MCP ツールを使用して自身のスケジュールまたはプロンプトを変更できるようにするには、**Run now** をクリックし、その呼び出しを毎回承認してください。

183 188 

184ディスク上のタスクのプロンプトを編集するには、`~/.claude/scheduled-tasks/<task-name>/SKILL.md` を開きます([`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) が設定されている場合はその下)。ファイルは `name` と `description` の YAML frontmatter を使用し、プロンプトが本文です。変更は次の実行時に有効になります。スケジュール、フォルダ、モデル、および有効な状態はこのファイルにはありません。Edit フォームを通じて変更するか、Claude に尋ねます。189ディスク上のタスクのプロンプトを編集するには、`~/.claude/scheduled-tasks/<task-name>/SKILL.md` を開きます([`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) が設定されている場合はその下)。ファイルは `name` と `description` の YAML フロントマターを使用し、プロンプトが本文です。変更は次の実行時に有効になります。スケジュール、フォルダ、および有効な状態はこのファイルにはありません。Edit フォームを通じて変更するか、Claude に尋ねます。

185 190 

186## 関連リソース191## 関連リソース

187 192 

errors.md +50 −7

Details

122| `A request to MCP server "<name>" was sent without your stored credentials` | [認証](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [認証](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [認証](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [認証](#mcp-server-url-is-missing-or-not-a-valid-url) |

124| `Issuer mismatch in authorization response (RFC 9207)` | [認証](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [認証](#issuer-mismatch-in-authorization-response) |

125| `Stopped an OAuth request` | [認証](#stopped-an-oauth-request) |

125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [認証](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [認証](#refusing-to-send-credentials-to-non-https-token-endpoint) |

126| `Cloud gateway session expired — run /login to reconnect.` | [認証](#cloud-gateway-session-expired) |127| `Cloud gateway session expired — run /login to reconnect.` | [認証](#cloud-gateway-session-expired) |

127| `Cloud gateway <url> no longer accepts this session` | [認証](#cloud-gateway-session-expired) |128| `Cloud gateway <url> no longer accepts this session` | [認証](#cloud-gateway-session-expired) |


251| `Ultrareview did not start` | [コマンドラインエラー](#ultrareview-did-not-start) |252| `Ultrareview did not start` | [コマンドラインエラー](#ultrareview-did-not-start) |

252| `Remote Control did not start: "<question>" got no answer` | [コマンドラインエラー](#remote-control-did-not-start-got-no-answer) |253| `Remote Control did not start: "<question>" got no answer` | [コマンドラインエラー](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラインエラー](#not-carried-over-to-the-sessions-remote-control-starts) |254| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラインエラー](#not-carried-over-to-the-sessions-remote-control-starts) |

255| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [コマンドラインエラー](#remote-control-did-not-start-because-of-the-settings-file) |

256| `The settings file <file> has changed since Remote Control started, so this session did not start` | [コマンドラインエラー](#settings-file-changed-since-remote-control-started) |

254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [コマンドラインエラー](#sandbox-is-not-supported-by-claude-remote-control) |257| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [コマンドラインエラー](#sandbox-is-not-supported-by-claude-remote-control) |

255| `` `claude import` is not yet available in this build `` | [コマンドラインエラー](#claude-import-is-not-yet-available-in-this-build) |258| `` `claude import` is not yet available in this build `` | [コマンドラインエラー](#claude-import-is-not-yet-available-in-this-build) |

256| `Could not read Claude Code config` | [コマンドラインエラー](#could-not-read-claude-code-config) |259| `Could not read Claude Code config` | [コマンドラインエラー](#could-not-read-claude-code-config) |


825同じ Claude の応答内の後続の呼び出しも、次の理由で拒否されることがあります。828同じ Claude の応答内の後続の呼び出しも、次の理由で拒否されることがあります。

826 829 

827```text theme={null}830```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged831another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```832```

830 833 

831その後 Claude は、拒否された各呼び出しを再度発行して、サーバーにレビューさせることができます。権限プロンプトが開いた場合は、それに応答してください。Claude が応答の中で auto モードが呼び出しをチェックできなかったと述べない限り、他に何もする必要はありません。そう述べた場合は、変更を止めるか呼び出しを自分で承認してから、Claude にその呼び出しを再試行するよう依頼してください。834その後 Claude は、拒否された各呼び出しを再度発行して、サーバーにレビューさせることができます。権限プロンプトが開いた場合は、それに応答してください。Claude が応答の中で auto モードが呼び出しをチェックできなかったと述べない限り、他に何もする必要はありません。そう述べた場合は、変更を止めるか呼び出しを自分で承認してから、Claude にその呼び出しを再試行するよう依頼してください。


1822 1825 

1823v2.1.232 より前では、Claude Code は段階的なロールアウトの対象となった場合、または `MCP_SDK_GENERATION=v2` を設定した場合にのみ v2 ランタイムを使用していました。1826v2.1.232 より前では、Claude Code は段階的なロールアウトの対象となった場合、または `MCP_SDK_GENERATION=v2` を設定した場合にのみ v2 ランタイムを使用していました。

1824 1827 

1828### Stopped an OAuth request

1829 

1830このメッセージは、OAuth エンドポイントがリダイレクトを行ったため、Claude Code が [MCP サーバーの OAuth リクエスト](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers)を停止したことを意味します。どちらの形式のメッセージでも、最初のアドレスがリダイレクトを送信した側です。

1831 

1832```text theme={null}

1833Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.

1834Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.

1835```

1836 

1837**対処方法:**

1838 

1839* MCP サーバーの運用者など、最初のアドレスを運用している人にリダイレクトの削除または修正を依頼してください。その後、`/mcp` からもう一度試します。

1840 

1825### 非 https のトークンエンドポイントへの認証情報の送信を拒否しました1841### 非 https のトークンエンドポイントへの認証情報の送信を拒否しました

1826 1842 

1827[v2 ランタイム](https://code.claude.com/docs/ja/mcp.md#mcp-client-runtimes)では、Claude Code は [MCP OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) のトークンリクエストを、HTTPS で提供されているトークンエンドポイント、または `localhost`、`127.0.0.1`、`::1` にあるトークンエンドポイントにのみ送信します。このメッセージは、サーバーのトークンエンドポイントがそのいずれでもないため、Claude Code がリクエストを送信する前に停止したことを意味します。これはブラウザでのサインイン後に発生するため、ブラウザのステップは先に成功します。また、Claude Code がサーバーのトークンを更新するたびにも発生します。1843[v2 ランタイム](https://code.claude.com/docs/ja/mcp.md#mcp-client-runtimes)では、Claude Code は [MCP OAuth](https://code.claude.com/docs/ja/mcp.md#authenticate-with-remote-mcp-servers) のトークンリクエストを、HTTPS で提供されているトークンエンドポイント、または `localhost`、`127.0.0.1`、`::1` にあるトークンエンドポイントにのみ送信します。このメッセージは、サーバーのトークンエンドポイントがそのいずれでもないため、Claude Code がリクエストを送信する前に停止したことを意味します。これはブラウザでのサインイン後に発生するため、ブラウザのステップは先に成功します。また、Claude Code がサーバーのトークンを更新するたびにも発生します。


2207 2223 

2208### クラウドセッションでホストが許可されていません2224### クラウドセッションでホストが許可されていません

2209 2225 

2210クラウドセッションまたはクラウドスケジュールタスクからのアウトバウンド HTTP リクエストが環境のネットワークポリシーによってブロックされました。2226クラウドセッションまたはクラウドスケジュールタスクでは、`403` や `ENOTFOUND` などの DNS エラーは、リクエストされたホストが [クラウド環境の許可リスト](https://code.claude.com/docs/ja/cloud-environments.md#access-levels) に含まれていないことを意味する場合があります。確認するには、ホストをそのリストと照合してください。次のヘッダーを含む `403` はブロックを裏付けますが、ブロックされたリクエストのすべての `403` にこのヘッダーが含まれるわけではありません。

2211 2227 

2212```text theme={null}2228```text theme={null}

2213HTTP 4032229HTTP 403


2565 2581 

2566Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、画像をデコードまたはリサイズして API 制限内に収めることができなかったことを意味します。2582Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、画像をデコードまたはリサイズして API 制限内に収めることができなかったことを意味します。

2567 2583 

2584表示されるエラーでは、これらの例の `2000x2000px` の代わりに `2576x2576px` など、異なるピクセル制限が示されることがあります。

2585 

2568**対応方法:**2586**対応方法:**

2569 2587 

2570* メッセージが画像を変換するよう求める場合は、PNG、JPEG、GIF、または WebP に変換して再度添付してください。Claude Code はファイルヘッダーからこれらの形式の寸法を確認でき、画像をデコードする必要はありません。2588* メッセージが画像を変換するよう求める場合は、PNG、JPEG、GIF、または WebP に変換して再度添付してください。Claude Code はファイルヘッダーからこれらの形式の寸法を確認でき、画像をデコードする必要はありません。


3499* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリの信頼は保存されないため、先にそこで `claude` を実行しても役に立ちません。代わりにプロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を付けます。3517* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリの信頼は保存されないため、先にそこで `claude` を実行しても役に立ちません。代わりにプロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を付けます。

3500* **`No answer in time.` の後に `Error: Workspace not trusted` が続く場合**: `Trust <folder>? [y/N]` の質問が 5 分間回答されませんでした。`claude ultrareview` を再実行して回答します。3518* **`No answer in time.` の後に `Error: Workspace not trusted` が続く場合**: `Trust <folder>? [y/N]` の質問が 5 分間回答されませんでした。`claude ultrareview` を再実行して回答します。

3501* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。3519* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。

3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**:PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダーを信頼しない場合は、フラグを省略します。この実行でフォルダーを信頼するには、PR 番号またはベースブランチをフラグの前に置きます:`claude ultrareview 1234 --trust-workspace`。3520* **``Ultrareview did not start: `--trust-workspace` takes no value``**: `--trust-workspace` の後に、PR 番号や `false` など、フラグ以外のものが続いています。フォルダを信頼しない場合は、フラグを省略します。この実行に限り信頼する場合は、PR 番号またはベースブランチをフラグの前に置きます: `claude ultrareview 1234 --trust-workspace`。

3503 3521 

3504v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。3522v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けませんでした。

3505 3523 


3522`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 は代わりに、フラグ名を示して開始を拒否します:3540`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 は代わりに、フラグ名を示して開始を拒否します:

3523 3541 

3524```text theme={null}3542```text theme={null}

3525Error: `--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`).3543Error: `--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`). Pass settings with `claude remote-control --settings <file>`.

3526```3544```

3527 3545 

3528`--verbose`、`--model`、またはラッパーによって挿入された `--session-id` や `--plugin-dir` など、破棄しても問題のないグローバルフラグについては、Claude Code は拒否しません。それらを無視して Remote Control を開始します。3546`--verbose`、`--model`、またはラッパーによって挿入された `--session-id` や `--plugin-dir` など、破棄しても問題のないグローバルフラグについては、Claude Code は拒否しません。それらを無視して Remote Control を開始します。


3536 3554 

3537v2.1.248 より前は、グローバルフラグが先にある場合、`claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。3555v2.1.248 より前は、グローバルフラグが先にある場合、`claude remote-control` は独自のフラグを受け付けず、コマンドは `unknown option` エラーで失敗していました。

3538 3556 

3557### Remote Control did not start because of the `--settings` file

3558 

3559[`claude remote-control --settings`](https://code.claude.com/docs/ja/remote-control#start-a-remote-control-session) に渡したファイルに問題があります:

3560 

3561```text theme={null}

3562Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3563```

3564 

3565**対処方法:**

3566 

3567* メッセージに示された問題を修正してから、`claude remote-control` コマンドを再度実行します

3568 

3569### The settings file has changed since Remote Control started

3570 

3571`claude remote-control` を実行しているターミナルに表示されるこのメッセージは、[`--settings`](https://code.claude.com/docs/ja/remote-control#start-a-remote-control-session) に渡したファイルの現在の内容ではセッションが開始されないことを意味します:

3572 

3573```text theme={null}

3574Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.

3575```

3576 

3577**対処方法:**

3578 

3579* ファイルを現在の内容で使用するには、`claude remote-control` を停止して同じコマンドを再度実行します。提供していたセッションを復元するには、[サーバー停止後にセッションを再開する](https://code.claude.com/docs/ja/remote-control.md#resume-sessions-after-stopping-the-server)を参照してください。

3580* Remote Control の開始時の設定を維持するには、ファイルの内容を元に戻し、`claude remote-control` が終了している場合はコマンドを再度実行します

3581 

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3582### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3583 

3541このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを起動するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しているが、`claude remote-control` はどちらのフラグも受け付けないことを意味します。サーバーは起動せずに終了コード 1 で終了します:3584このエラーは、[Remote Control](https://code.claude.com/docs/ja/remote-control.md) サーバーを起動するコマンドが `remote-control` の後に `--sandbox` または `--no-sandbox` を渡しているが、`claude remote-control` はどちらのフラグも受け付けないことを意味します。サーバーは起動せずに終了コード 1 で終了します:


3806 3849 

3807関連するメッセージは、コマンドが実行される前に発生します:3850関連するメッセージは、コマンドが実行される前に発生します:

3808 3851 

3809* `Shell command permission check failed for pattern "..."`:コマンドの権限チェックで許可されませんでした。[注入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止につながるか、`allowed-tools` でコマンドを事前承認する方法について説明しています3852* `Shell command permission check failed for pattern "..."`: コマンドの権限チェックで許可されませんでした。[挿入されたコマンドの権限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各権限モードでどの結果が中止につながるか、および `allowed-tools` でコマンドを事前承認する方法を説明しています

3810* ``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)を参照してください3853* ``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)を参照してください

3811 3854 

3812**対処方法:**3855**対処方法:**

3813 3856 


3960 4003 

3961* **ベースブランチを渡さなかった場合**: Claude Code はリポジトリのデフォルトブランチと比較しており、上の例のようにベースブランチを明示的に渡すよう提案します4004* **ベースブランチを渡さなかった場合**: Claude Code はリポジトリのデフォルトブランチと比較しており、上の例のようにベースブランチを明示的に渡すよう提案します

3962* **クローン内に既に存在するベースブランチを渡した場合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります4005* **クローン内に既に存在するベースブランチを渡した場合**: ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります

3963* **クローンに存在しないベースブランチを渡した場合**: 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>`)`` となります。クローンが shallow かどうかを Claude Code が判別できない場合は、代わりに `git fetch --unshallow origin` を提案します。v2.1.221 より前は、フェッチしたすべてのベースブランチに対して `git fetch --unshallow origin` を提案しており、完全なクローンではこのコマンドが `fatal: --unshallow on a complete repository does not make sense` で失敗していました。4006* **クローン内に存在しないベースブランチを渡した場合**: 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` で失敗していました。

3964 4007 

3965**対処方法:**4008**対処方法:**

3966 4009 

gateways.md +1 −1

Details

63* **クライアントテレメトリ**: Claude Code はセッションが Claude apps ゲートウェイにサインインするとき、Anthropic バウンドクライアント分析を無効にします。サインイン前のスタートアップ分析もオフに保つには、各デバイスの [クライアント側マネージドセッティング](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#client-side-managed-settings) で [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ja/managed-settings#turn-telemetry-off-for-your-organization) を配信します。63* **クライアントテレメトリ**: Claude Code はセッションが Claude apps ゲートウェイにサインインするとき、Anthropic バウンドクライアント分析を無効にします。サインイン前のスタートアップ分析もオフに保つには、各デバイスの [クライアント側マネージドセッティング](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#client-side-managed-settings) で [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ja/managed-settings#turn-telemetry-off-for-your-organization) を配信します。

64* **他のゲートウェイ上のクライアントテレメトリ**: Claude Code がオプションのクライアントテレメトリストリームを送信するかどうかはプロバイダーに依存し、[テレメトリデフォルトテーブル](https://code.claude.com/docs/ja/data-usage.md#default-behaviors-by-api-provider) は各ケースについて説明しています。64* **他のゲートウェイ上のクライアントテレメトリ**: Claude Code がオプションのクライアントテレメトリストリームを送信するかどうかはプロバイダーに依存し、[テレメトリデフォルトテーブル](https://code.claude.com/docs/ja/data-usage.md#default-behaviors-by-api-provider) は各ケースについて説明しています。

65* **テレメトリの宛先**: Claude Code がゲートウェイセッションのテレメトリを送信する場所は、セッションがどのようにサインインしたかに依存し、[開発者に対して何が強制されるか](https://code.claude.com/docs/ja/claude-apps-gateway#whats-enforced-on-developers) は各種類のセッションのエクスポート先を示しています。65* **テレメトリの宛先**: Claude Code がゲートウェイセッションのテレメトリを送信する場所は、セッションがどのようにサインインしたかに依存し、[開発者に対して何が強制されるか](https://code.claude.com/docs/ja/claude-apps-gateway#whats-enforced-on-developers) は各種類のセッションのエクスポート先を示しています。

66* **企業 HTTP プロキシ**: `HTTPS_PROXY` は Claude Code とそれが通信するすべてのサーバー(ゲートウェイを含む)の間に位置します。ネットワークが必要な場合、ゲートウェイに加えて [プロキシを設定](https://code.claude.com/docs/ja/network-config.md) してください。Claude apps ゲートウェイをホストする場合、[サインインはプロキシホストもプライベートネットワーク上にあることを確認します](https://code.claude.com/docs/ja/claude-apps-gateway#prerequisites)。そうでない場合、ゲートウェイホストを `NO_PROXY` に追加して、CLI がそれに直接接続するようにします。66* **企業 HTTP プロキシ**: Claude Code は、ゲートウェイへのリクエストを含むリクエストを `HTTPS_PROXY` のプロキシ経由で送信します。ネットワークでプロキシが必要な場合は、[プロキシを設定](https://code.claude.com/docs/ja/network-config.md)してください。ホストしている Claude apps ゲートウェイにプロキシが適用される場合、[サインイン](https://code.claude.com/docs/ja/claude-apps-gateway#prerequisites)には、プロキシのホスト名がプライベートアドレスに解決されるか、ゲートウェイホストが `NO_PROXY` に含まれている必要があります。

67 67 

68## 次のステップ68## 次のステップ

69 69 

Details

84> リポジトリ用のフェデレーション認証情報を持つ Microsoft Entra アプリケーションを作成し、[GitHub Actions から認証するための Microsoft ガイド](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect) に従います。84> リポジトリ用のフェデレーション認証情報を持つ Microsoft Entra アプリケーションを作成し、[GitHub Actions から認証するための Microsoft ガイド](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect) に従います。

85>85>

86> * Microsoft Entra アプリケーションを登録し、GitHub がリポジトリに発行するトークンを信頼するフェデレーション ID 認証情報を追加します。ユーザー割り当てマネージドアイデンティティはアプリケーションの代わりに機能します。どちらも以下でメモするクライアント ID を持ちます86> * Microsoft Entra アプリケーションを登録し、GitHub がリポジトリに発行するトークンを信頼するフェデレーション ID 認証情報を追加します。ユーザー割り当てマネージドアイデンティティはアプリケーションの代わりに機能します。どちらも以下でメモするクライアント ID を持ちます

87> * Foundry リソースでアプリケーションに `Azure AI User` ロールを割り当てます。より狭いカスタムロールについては [Azure RBAC 構成](https://code.claude.com/docs/ja/microsoft-foundry.md#azure-rbac-configuration) を参照してください87> * Foundry リソースでアプリケーションに `Foundry User` ロールを割り当てます。もう 1 つの組み込みロールとカスタムロールについては [Azure RBAC 構成](https://code.claude.com/docs/ja/microsoft-foundry.md#azure-rbac-configuration) を参照してください

88>88>

89> アプリケーションのクライアント ID、テナント ID、サブスクリプション ID をメモします。次のステップでシークレットとして追加します。89> アプリケーションのクライアント ID、テナント ID、サブスクリプション ID をメモします。次のステップでシークレットとして追加します。

90 90 

Details

228 228 

229### セッション中にモデルが無効化された場合229### セッション中にモデルが無効化された場合

230 230 

231プロジェクトがセッションで実行しているモデルへのアクセスを失った場合(例えば、管理者が [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で無効化した場合)、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。起動時フォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合は、デフォルト Sonnet モデルを試します。231Agent Platform がセッションのモデルをプロジェクトまたはリージョンで利用できないとして拒否した場合、Claude Code はセッションを別のモデルに切り替えるため、作業を続けることができます。`Switched to <fallback> because <model> is not available` で始まるメッセージが表示されます。これは、例えば管理者が [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) でモデルを無効化した場合や、リージョンでそのモデルが提供されていない場合に発生します。

232 232 

233切り替えは、ピン留めしていないティアにのみ適用されます。これは起動時フォールバックと同じ条件です。選択した特定のバージョンでのセッションはそのモデルを保持し、フォールバックモデルチェーンがない場合、リクエストは失敗します。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Agent Platform で auto モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは失敗します。233[フォールバックモデルチェーン](https://code.claude.com/docs/ja/model-config.md#fallback-model-chains)を設定している場合、Claude Code は代わりに設定したフォールバックに切り替えます。チェーンがない場合、次のようなケースではリクエストが失敗します。

234 234 

235設定した[フォールバックモデルチェーン](https://code.claude.com/docs/ja/model-config.md#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否時に Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わらずに失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否時に切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。235* セッションがピン留めされたモデル、または選択した特定のバージョンを使用している

236* [Claude Code が試すモデル](#startup-model-checks)のいずれも利用できない。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Agent Platform で auto モードがサポートするモデルにのみ切り替えます。

237 

238作業を続けるには、セッションで `/model` を実行し、プロジェクトとリージョンで利用可能なモデル上で `s` を押してください。この操作ではデフォルトは変更されません。

239 

240拒否されたリクエストが切り替わらずに失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。フォールバックモデルチェーンを設定している場合は、それも削除してください。Claude Code はそのフォールバックには引き続き移行するためです。

236 241 

237## IAM 設定242## IAM 設定

238 243 

hooks.md +9 −3

Details

3000 3000 

3001セッション中に設定ファイルが変更されたときに実行されます。設定変更の監査、セキュリティポリシーの適用、設定ファイルへの不正な変更のブロックに使用します。3001セッション中に設定ファイルが変更されたときに実行されます。設定変更の監査、セキュリティポリシーの適用、設定ファイルへの不正な変更のブロックに使用します。

3002 3002 

3003Claude Code は、設定ファイル、管理ポリシーファイル、またはスキルファイルが変更されたときに ConfigChange フックを実行します。管理ポリシーについては、`managed-settings.json` または `managed-settings.d/` 内のファイルが変更された場合にのみ実行します。[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)や、macOS の管理された環境設定、Windows レジストリのポリシーへの変更は、フックを実行せずに適用されます。[`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) を使用した WSL では、変更された Windows 側の管理設定ファイルも、ポリシーのポーリング時にフックを実行せずに適用されます。3003Claude Code は、設定ファイル、管理ポリシーファイル、またはスキルファイルが変更されたときに ConfigChange フックを実行します。管理ポリシーについては、`managed-settings.json` または `managed-settings.d/` 内のファイルが変更された場合にのみ実行します。

3004 3004 

3005matcher は設定のソースでフィルタリングします。3005matcher は設定のソースでフィルタリングします。

3006 3006 


3012| `policy_settings` | `managed-settings.json` または `managed-settings.d/` 内のファイルが変更されたとき |3012| `policy_settings` | `managed-settings.json` または `managed-settings.d/` 内のファイルが変更されたとき |

3013| `skills` | `.claude/skills/` 内のスキルファイルが変更されたとき |3013| `skills` | `.claude/skills/` 内のスキルファイルが変更されたとき |

3014 3014 

3015次の例は、セキュリティ監査のためにすべての設定変更をログに記録します。3015次のような変更は、フックを実行せずに反映されます。

3016 

3017* **Yes, and don't ask again**、`/permissions`、または `/model` で保存したルールと設定(保存元のセッション内)。同じファイルを別の開いているセッションが読み込む場合、そのセッションではフックが実行されます。

3018* [サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)、macOS の管理プリファレンス、または Windows レジストリポリシーの更新

3019* [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) を使用している WSL で、Windows 側の管理設定ファイルが変更された場合(Claude Code はポリシーのポーリング時にこれを取り込みます)

3020 

3021次の例は、セキュリティ監査のために設定の変更をログに記録します。

3016 3022 

3017```json theme={null}3023```json theme={null}

3018{3024{


3335 "hooks": [3341 "hooks": [

3336 {3342 {

3337 "type": "command",3343 "type": "command",

3338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3344 "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"

3339 }3345 }

3340 ]3346 ]

3341 }3347 }

hooks-guide.md +3 −3

Details

50 "PostToolUse": [50 "PostToolUse": [

51 {51 {

52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",

53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]53 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]

54 }54 }

55 ],55 ],

56 "Notification": [56 "Notification": [


221 "hooks": [221 "hooks": [

222 {222 {

223 "type": "command",223 "type": "command",

224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"224 "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""

225 }225 }

226 ]226 ]

227 }227 }


336 336 

337セッション中に設定ファイルやスキルファイルが変更されたタイミングを追跡します。`ConfigChange` イベントは、外部プロセスやエディタが設定ファイルを変更したときに発火するため、コンプライアンスのために変更をログに記録したり、許可されていない変更をブロックしたりできます。337セッション中に設定ファイルやスキルファイルが変更されたタイミングを追跡します。`ConfigChange` イベントは、外部プロセスやエディタが設定ファイルを変更したときに発火するため、コンプライアンスのために変更をログに記録したり、許可されていない変更をブロックしたりできます。

338 338 

339この例では、各変更を監査ログに追記します。これを `~/.claude/settings.json` に追加します。339この例では、各イベントを監査ログに追記します。以下を `~/.claude/settings.json` に追加します:

340 340 

341```json theme={null}341```json theme={null}

342{342{

Details

30| `Ctrl+T` | Claude のタスクチェックリストを切り替え | ステータス領域に[Claude のやることリスト](#task-list)を表示または非表示にします。これはバックグラウンドタスクビューではありません。実行中のシェルとサブエージェントを確認するには [`/tasks`](https://code.claude.com/docs/ja/commands) を使用してください |30| `Ctrl+T` | Claude のタスクチェックリストを切り替え | ステータス領域に[Claude のやることリスト](#task-list)を表示または非表示にします。これはバックグラウンドタスクビューではありません。実行中のシェルとサブエージェントを確認するには [`/tasks`](https://code.claude.com/docs/ja/commands) を使用してください |

31| `Ctrl+S` | プロンプトを保存または復元 | 入力にテキストがある場合、それを保存してプロンプトをクリアします。空のプロンプトで再度押すと、保存されたテキスト、カーソル位置、貼り付けられたコンテンツ、および入力モードが復元されるため、保存された `!` [シェルコマンド](#shell-mode-with-prefix)はシェルモードで戻ります |31| `Ctrl+S` | プロンプトを保存または復元 | 入力にテキストがある場合、それを保存してプロンプトをクリアします。空のプロンプトで再度押すと、保存されたテキスト、カーソル位置、貼り付けられたコンテンツ、および入力モードが復元されるため、保存された `!` [シェルコマンド](#shell-mode-with-prefix)はシェルモードで戻ります |

32| `Ctrl+Z` | Claude Code を一時停止 | Unix のみ。プロセスをシェルに一時停止します。`fg` を実行して再開します |32| `Ctrl+Z` | Claude Code を一時停止 | Unix のみ。プロセスをシェルに一時停止します。`fg` を実行して再開します |

33| `左/右矢印` | ダイアログタブを循環 | 権限ダイアログとメニューのタブ間を移動します。タブ付きダイアログでは、タブ行がフォーカスされている間、キーはタブを切り替えます。[タブアクション](https://code.claude.com/docs/ja/keybindings.md#tabs-actions)を参照して、フォーカスがどのように移動するかを確認してください |33| `Left/Right arrows` | ダイアログタブを循環 | 権限ダイアログとメニューのタブ間を移動します。タブ付きダイアログでは、タブ行がフォーカスされている間、キーはタブを切り替えます。[タブアクション](https://code.claude.com/docs/ja/keybindings.md#tabs-actions)を参照して、フォーカスがどのように移動するかを確認してください |

34| `Tab` | オートコンプリート候補を受け入れるか、権限回答にコメントを追加 | プロンプト入力にオートコンプリート候補が表示されている場合、選択された候補を受け入れます。ほとんどの権限プロンプトで、**はい**または**いいえ**がフォーカスされている場合、そのオプションのコメントフィールドを開き、再度押すとフィールドを閉じます。[権限プロンプトに回答するときにコメントを追加](https://code.claude.com/docs/ja/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)を参照してください |34| `Tab` | オートコンプリート候補を受け入れるか、権限回答にコメントを追加 | プロンプト入力にオートコンプリート候補が表示されている場合、選択された候補を受け入れます。ほとんどの権限プロンプトで、**はい**または**いいえ**がフォーカスされている場合、そのオプションのコメントフィールドを開き、再度押すとフィールドを閉じます。[権限プロンプトに回答するときにコメントを追加](https://code.claude.com/docs/ja/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)を参照してください |

35| `上/下矢印` または `Ctrl+P`/`Ctrl+N` | カーソルを移動またはコマンド履歴を移動 | 入力が複数の視覚行にまたがる場合(ラップされているか複数行かどうか)、最初にプロンプト内でカーソルを移動します。カーソルが最初または最後の視覚行にある場合、再度押すとコマンド履歴を移動します。メッセージがキューに入っている場合、最初の行から `Up` を押すと代わりに[キューに入れたものを取り戻します](#take-back-what-you-queued) |35| `Up/Down arrows` または `Ctrl+P`/`Ctrl+N` | カーソルを移動またはコマンド履歴を移動 | 入力が複数の視覚行にまたがる場合(ラップされているか複数行かどうか)、最初にプロンプト内でカーソルを移動します。カーソルが最初または最後の視覚行にある場合、再度押すとコマンド履歴を移動します。メッセージがキューに入っている場合、最初の行から `Up` を押すと代わりに[キューに入れたものを取り戻します](#take-back-what-you-queued) |

36| `Esc` | Claude を割り込むか、ダイアログを閉じる | 現在の応答またはツール呼び出しを途中で停止して、リダイレクトできます。Claude はこれまでの作業を保持します。[メッセージがキューに入っている](#queue-messages-while-claude-works)場合、Claude Code は次にそれらを送信します。ダイアログが開いている場合、`Esc` はダイアログを閉じます。フッター項目([サブエージェントパネル](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)内の行など)が選択されている場合、`Esc` は割り込みの代わりに[それを選択解除](https://code.claude.com/docs/ja/keybindings.md#footer-actions)します。権限プロンプトでは、`Esc` はアクション([コメントなしの**いいえ**](https://code.claude.com/docs/ja/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)と同じ)を拒否します |36| `Esc` | Claude を割り込むか、ダイアログを閉じる | 現在の応答またはツール呼び出しを途中で停止して、リダイレクトできます。Claude はこれまでの作業を保持します。[メッセージがキューに入っている](#queue-messages-while-claude-works)場合、Claude Code は次にそれらを送信します。ダイアログが開いている場合、`Esc` はダイアログを閉じます。フッター項目([サブエージェントパネル](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)内の行など)が選択されている場合、`Esc` は割り込みの代わりに[それを選択解除](https://code.claude.com/docs/ja/keybindings.md#footer-actions)します。権限プロンプトでは、`Esc` はアクション([コメントなしの**いいえ**](https://code.claude.com/docs/ja/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)と同じ)を拒否します |

37| `Esc` + `Esc` | 入力ドラフトをクリアするか、巻き戻す | プロンプト入力にテキストが含まれている場合、ダブル `Esc` はそれをクリアし、ドラフトを履歴に保存して `Up` で呼び出せるようにします。入力が空の場合、ダブル `Esc` は[巻き戻しメニュー](https://code.claude.com/docs/ja/checkpointing.md)を開いて、前の時点からコードと会話を復元または要約できます |37| `Esc` + `Esc` | 入力ドラフトをクリアするか、巻き戻す | プロンプト入力にテキストが含まれている場合、ダブル `Esc` はそれをクリアし、ドラフトを履歴に保存して `Up` で呼び出せるようにします。入力が空の場合、ダブル `Esc` は[巻き戻しメニュー](https://code.claude.com/docs/ja/checkpointing.md)を開いて、前の時点からコードと会話を復元または要約できます |

38| `Ctrl+Enter` または `Ctrl+X Ctrl+S` | キューに入れたメッセージを今すぐ送信 | [キューに入れたメッセージ](#queue-messages-while-claude-works)とドラフトを直ちに送信します。[Claude Code がキューに入れたものを送信するとき](#when-claude-code-sends-what-you-queued)は、Claude が作業中のターンに何が起こるかについて説明しています。[シェルモード](#shell-mode-with-prefix)では、キーはコマンドをキューに入れるだけです。拡張キーを報告しないターミナルでは、`Ctrl+Enter` は通常の `Enter` として到着します。`Ctrl+X Ctrl+S` はすべてのターミナルで機能します。Claude Code v2.1.275 以降が必要です |38| `Ctrl+Enter` または `Ctrl+X Ctrl+S` | キューに入れたメッセージを今すぐ送信 | [キューに入れたメッセージ](#queue-messages-while-claude-works)とドラフトを直ちに送信します。[Claude Code がキューに入れたものを送信するとき](#when-claude-code-sends-what-you-queued)は、Claude が作業中のターンに何が起こるかについて説明しています。[シェルモード](#shell-mode-with-prefix)では、キーはコマンドをキューに入れるだけです。拡張キーを報告しないターミナルでは、`Ctrl+Enter` は通常の `Enter` として到着します。`Ctrl+X Ctrl+S` はすべてのターミナルで機能します。Claude Code v2.1.275 以降が必要です |

39| `Shift+Tab`、または Node または Bun ランタイムが VT 入力モードを有効にしない場合は Windows で `Alt+M` | 権限モードを循環 | `default`(モード指標で Manual とラベル付け)、`acceptEdits`、`plan`、および利用可能な場合は `bypassPermissions` と `auto` を循環します。`auto` から、最初のプレスは `default` に切り替わります。[権限モード](https://code.claude.com/docs/ja/permission-modes.md)を参照してください。ファイル権限プロンプトでは、同じキーが開いている[コメントフィールド](https://code.claude.com/docs/ja/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)を閉じます。フィールドが開いていない場合、プロンプトがそのオプションを提供するときに、セッションの残りの部分でアクションを許可するオプションを選択します |39| `Shift+Tab`、または Node または Bun ランタイムが VT 入力モードを有効にしない場合は Windows で `Alt+M` | 権限モードを循環 | `default`(モード指標で Manual とラベル付け)、`acceptEdits`、`plan`、および利用可能な場合は `bypassPermissions` と `auto` を循環します。[権限モード](https://code.claude.com/docs/ja/permission-modes.md)を参照してください。ファイル権限プロンプトでは、同じキーが開いている[コメントフィールド](https://code.claude.com/docs/ja/permissions.md#add-a-comment-when-you-answer-a-permission-prompt)を閉じます。フィールドが開いていない場合、プロンプトがそのオプションを提供するときに、セッションの残りの部分でアクションを許可するオプションを選択します。プラン承認プロンプトでは、プランを承認します |

40| `Option+P`(macOS)または `Alt+P`(Windows/Linux) | モデルを切り替え | プロンプトをクリアせずにモデルを切り替え |40| `Option+P`(macOS)または `Alt+P`(Windows/Linux) | モデルを切り替え | プロンプトをクリアせずにモデルを切り替え |

41| `Option+T`(macOS)または `Alt+T`(Windows/Linux) | 拡張思考を切り替え | 拡張思考モードを有効または無効にします。Opus 5.5、Sonnet 5.5、Haiku 5.5、または Fable モデルには効果がありません。これらは常に拡張思考を使用します。macOS で Option を Meta として設定せずに動作します |41| `Option+T`(macOS)または `Alt+T`(Windows/Linux) | 拡張思考を切り替え | 拡張思考モードを有効または無効にします。Opus 5.5、Sonnet 5.5、Haiku 5.5、または Fable モデルには効果がありません。これらは常に拡張思考を使用します。macOS で Option を Meta として設定せずに動作します |

42| `Option+O`(macOS)または `Alt+O`(Windows/Linux) | 高速モードを切り替え | [高速モード](https://code.claude.com/docs/ja/fast-mode.md)を有効または無効にします |42| `Option+O`(macOS)または `Alt+O`(Windows/Linux) | 高速モードを切り替え | [高速モード](https://code.claude.com/docs/ja/fast-mode.md)を有効または無効にします |


81| :- | :- | :- |81| :- | :- | :- |

82| クイックエスケープ | `\` + `Enter` | すべてのターミナルで機能 |82| クイックエスケープ | `\` + `Enter` | すべてのターミナルで機能 |

83| Option キー | `Option+Enter` | macOS で[Option を Meta として](https://code.claude.com/docs/ja/terminal-config.md#enable-option-key-shortcuts-on-macos)有効にした後 |83| Option キー | `Option+Enter` | macOS で[Option を Meta として](https://code.claude.com/docs/ja/terminal-config.md#enable-option-key-shortcuts-on-macos)有効にした後 |

84| Shift+Enter | `Shift+Enter` | iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal でネイティブ。他のターミナルについては、[複数行プロンプトを入力](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)を参照してください |84| Shift+Enter | `Shift+Enter` | iTerm2、WezTerm、Ghostty、Kitty、Warp、Windows Terminal でネイティブ。他のターミナルについては、[複数行プロンプトを入力](https://code.claude.com/docs/ja/terminal-config.md#enter-multiline-prompts)を参照してください |

85| 制御シーケンス | `Ctrl+J` | 設定なしで任意のターミナルで機能 |85| 制御シーケンス | `Ctrl+J` | 設定なしで任意のターミナルで機能 |

86| ペーストモード | 直接貼り付け | コードブロック、ログの場合 |86| ペーストモード | 直接貼り付け | コードブロック、ログの場合 |

87 87 


137 137 

138`/config` → Editor mode から vim スタイルの編集を有効にします。138`/config` → Editor mode から vim スタイルの編集を有効にします。

139 139 

140Claude Code は、`Ctrl+O` で[トランスクリプトビューア](#transcript-viewer)を切り替えたり、`/config` などのパネルを開いたり閉じたりするときに、vim モードとカーソル位置を保持します。プロンプトを NORMAL モードのままにしておくと、戻ってきたときも NORMAL モードのままで、カーソルは置いた場所にあります。

141 

142### モード切り替え140### モード切り替え

143 141 

144| コマンド | アクション | 元のモード |142| コマンド | アクション | 元のモード |


302 * `Ctrl+C` を押してキャンセルし、元の入力を復元します300 * `Ctrl+C` を押してキャンセルし、元の入力を復元します

303 * 空の検索で `Backspace` を押してキャンセルします301 * 空の検索で `Backspace` を押してキャンセルします

304 302 

305マッチを受け入れるか検索をキャンセルすると、Claude Code がまだ履歴を読み込んでいる場合でも、直ちに有効になります。

306 

307エラーログなど、以前のプロンプトに貼り付けた長い内容しか覚えていない場合にそのプロンプトを見つけるには、`Ctrl+R` を押して貼り付けた内容に含まれる単語を入力します。Claude Code v2.1.314 以降が必要です。303エラーログなど、以前のプロンプトに貼り付けた長い内容しか覚えていない場合にそのプロンプトを見つけるには、`Ctrl+R` を押して貼り付けた内容に含まれる単語を入力します。Claude Code v2.1.314 以降が必要です。

308 304 

309## バックグラウンド Bash コマンド305## バックグラウンド Bash コマンド


600 596 

601### Claude Code が下線を引く内容597### Claude Code が下線を引く内容

602 598 

603入力を一時停止した直後、Claude Code は辞書が認識しない単語に下線を引きます。入力中の単語はそれを超えるまで放置し、テキストを変更することはありません。また、コードのように見えるテキストもスキップします。599入力を一時停止した直後、Claude Code は辞書が認識しない単語に下線を引きます。入力中の単語は、カーソルがその単語を通り過ぎるまでそのままにします。また、コードのように見えるテキストもスキップします。

604 600 

605* `/help`、`@` メンション、URL、ファイルパス、`--verbose` などのフラグなどのコマンド601* `/help`、`@` メンション、URL、ファイルパス、`--verbose` などのフラグなどのコマンド

606* 数字、アンダースコア、または最初の後に大文字を含む単語、およびバッククォート内のテキスト602* 数字、アンダースコア、または最初の後に大文字を含む単語、およびバッククォート内のテキスト

keybindings.md +6 −1

Details

581 581 

582Claude Code は、`ctrl+x` プレフィックスに以下のデフォルトの chord をコンテキストごとにバインドしています。582Claude Code は、`ctrl+x` プレフィックスに以下のデフォルトの chord をコンテキストごとにバインドしています。

583 583 

584* `Chat`:`ctrl+x ctrl+k`、`ctrl+x ctrl+e`、`ctrl+x enter`、`ctrl+x ctrl+a`、`ctrl+x ctrl+s`、`ctrl+x tab`584* `Chat`:`ctrl+x ctrl+k`、`ctrl+x ctrl+e`、`ctrl+x enter`、`ctrl+x ctrl+a`、`ctrl+x ctrl+s`、`ctrl+x tab`、`ctrl+x ctrl+=`、`ctrl+x ctrl+-`、`ctrl+x ctrl+_`、`ctrl+x =`、`ctrl+x -`

585* `Task`:`ctrl+x ctrl+b`585* `Task`:`ctrl+x ctrl+b`

586* `DiffPanel`:`ctrl+x b`586* `DiffPanel`:`ctrl+x b`

587* `Pane`:`ctrl+x left`、`ctrl+x right`、`ctrl+x up`、`ctrl+x down`、`ctrl+x x`587* `Pane`:`ctrl+x left`、`ctrl+x right`、`ctrl+x up`、`ctrl+x down`、`ctrl+x x`


631 "ctrl+x ctrl+a": null,631 "ctrl+x ctrl+a": null,

632 "ctrl+x ctrl+s": null,632 "ctrl+x ctrl+s": null,

633 "ctrl+x tab": null,633 "ctrl+x tab": null,

634 "ctrl+x ctrl+=": null,

635 "ctrl+x ctrl+-": null,

636 "ctrl+x ctrl+_": null,

637 "ctrl+x =": null,

638 "ctrl+x -": null,

634 "ctrl+x": "chat:newline"639 "ctrl+x": "chat:newline"

635 }640 }

636 }641 }

Details

156 156 

157### 既存のログインとの競合157### 既存のログインとの競合

158 158 

159ゲートウェイ認証情報変数は、保存された claude.ai ログインまたは Console キーより優先されます。`ANTHROPIC_AUTH_TOKEN` では、変数は直ちに優先されます。`ANTHROPIC_API_KEY` では、キーが引き継ぐ前に、インタラクティブモードで 1 回承認するよう求められます。159リクエストには、保存された claude.ai ログインではなく、ゲートウェイ認証情報変数が使用されます。`ANTHROPIC_AUTH_TOKEN` では、変数は直ちに優先されます。`ANTHROPIC_API_KEY` では、キーが引き継ぐ前に、インタラクティブモードで 1 回承認するよう求められます。

160 160 

161`/status` を実行して、どの認証情報ソースがアクティブかを確認します。起動が 2 つのソースという名前の認証競合警告を表示する場合は、[トラブルシューティングテーブル](#troubleshoot-gateway-errors)の最初の行を参照して、どちらを削除するかを確認してください。保存されたログインをクリアしてゲートウェイ認証情報のみを残すには、`/logout` を実行してください。161`/status` を実行して、どの認証情報ソースがアクティブかを確認します。起動が 2 つのソースという名前の認証競合警告を表示する場合は、[トラブルシューティングテーブル](#troubleshoot-gateway-errors)の最初の行を参照して、どちらを削除するかを確認してください。保存されたログインをクリアしてゲートウェイ認証情報のみを残すには、`/logout` を実行してください。

162 162 


506 506 

507| エラー | 原因 | 修正 |507| エラー | 原因 | 修正 |

508| :- | :- | :- |508| :- | :- | :- |

509| 2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。 | ゲートウェイ認証情報と保存されたログインの両方がアクティブです。変数はリクエストに使用されますが、古いログインは予期しない認証動作を引き起こす可能性があります | 変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します |509| 2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。 | ゲートウェイ認証情報と保存されたログインの両方がアクティブです | 変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します |

510| 無効または認識されないトークンという名前の `401` エラー | 認証情報はゲートウェイが発行したものではないか、ゲートウェイが読まないヘッダーにあります | [認証情報テーブル](#set-the-credential-variable)で変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します |510| 無効または認識されないトークンという名前の `401` エラー | 認証情報はゲートウェイが発行したものではないか、ゲートウェイが読まないヘッダーにあります | [認証情報テーブル](#set-the-credential-variable)で変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します |

511| `Your apiKeyHelper script is failing`、または非対話型モードで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](https://code.claude.com/docs/ja/settings-reference#apikeyhelper) 設定のコマンドが使用可能なキーを生成しなかったため、リクエストはプレースホルダーキーを含みます | コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。[エラーリファレンス](https://code.claude.com/docs/ja/errors.md#your-apikeyhelper-script-is-failing)を参照してください |511| `Your apiKeyHelper script is failing`、または非対話型モードで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](https://code.claude.com/docs/ja/settings-reference#apikeyhelper) 設定のコマンドが使用可能なキーを生成しなかったため、リクエストはプレースホルダーキーを含みます | コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。[エラーリファレンス](https://code.claude.com/docs/ja/errors.md#your-apikeyhelper-script-is-failing)を参照してください |

512| アドレスで何も応答しない場合は `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`、またはホスト名が解決しない場合は `Can't reach the API server — check your internet or DNS (ENOTFOUND)`。多くの場合、Claude Code が[バックオフで再試行](https://code.claude.com/docs/ja/errors.md#automatic-retries)している間の静かな一時停止の後です。括弧内のコードは異なります。[Unable to connect to API](https://code.claude.com/docs/ja/errors.md#unable-to-connect-to-api) はコードのスペルと以前の表現をカバーしています | 基本 URL で何も応答しません。アドレスが間違っているか、VPN またはファイアウォールがゲートウェイへのパスをブロックしています | 上記の [curl テスト](#verify-the-connection)を実行します。これは同じ原因で直ちに失敗し、URL とネットワークパスをゲートウェイチームで確認します |512| アドレスで何も応答しない場合は `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`、またはホスト名が解決しない場合は `Can't reach the API server — check your internet or DNS (ENOTFOUND)`。多くの場合、Claude Code が[バックオフで再試行](https://code.claude.com/docs/ja/errors.md#automatic-retries)している間の静かな一時停止の後です。括弧内のコードは異なります。[Unable to connect to API](https://code.claude.com/docs/ja/errors.md#unable-to-connect-to-api) はコードのスペルと以前の表現をカバーしています | 基本 URL で何も応答しません。アドレスが間違っているか、VPN またはファイアウォールがゲートウェイへのパスをブロックしています | 上記の [curl テスト](#verify-the-connection)を実行します。これは同じ原因で直ちに失敗し、URL とネットワークパスをゲートウェイチームで確認します |


520| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックは `api.anthropic.com` に直接送られ、`ANTHROPIC_BASE_URL` に従いません。そのため、直接エグレスがブロックされているとチェックに失敗します | エグレスがブロックされている場合は `api.anthropic.com` を許可リストに登録するか、スキップ変数を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |520| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックは `api.anthropic.com` に直接送られ、`ANTHROPIC_BASE_URL` に従いません。そのため、直接エグレスがブロックされているとチェックに失敗します | エグレスがブロックされている場合は `api.anthropic.com` を許可リストに登録するか、スキップ変数を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

521| `ANTHROPIC_API_KEY` のゲートウェイ発行キーで認証するセッションで、`/fast` が `Fast mode is currently unavailable` を報告します | `ANTHROPIC_BASE_URL` がゲートウェイを指していて、キーが Anthropic API キーの形式ではない間、Claude Code は [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックを送信しません。以前に成功したチェックがキャッシュされていない場合、fast mode を利用不可として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |521| `ANTHROPIC_API_KEY` のゲートウェイ発行キーで認証するセッションで、`/fast` が `Fast mode is currently unavailable` を報告します | `ANTHROPIC_BASE_URL` がゲートウェイを指していて、キーが Anthropic API キーの形式ではない間、Claude Code は [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックを送信しません。以前に成功したチェックがキャッシュされていない場合、fast mode を利用不可として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

522| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が fast mode を有効にしている場合でも | 可用性チェックには claude.ai ログインまたは API キーが必要です。ベアラートークンのみの場合、Claude Code は fast mode をチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |522| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が fast mode を有効にしている場合でも | 可用性チェックには claude.ai ログインまたは API キーが必要です。ベアラートークンのみの場合、Claude Code は fast mode をチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

523| `ANTHROPIC_BASE_URL` を使用するセッションで、`/feedback` がローカルファイルを保存します | ゲートウェイの背後では、`ANTHROPIC_AUTH_TOKEN` および Anthropic API キーの形式ではないキーは Anthropic の認証情報ではありません。これがない場合、Claude Code はレポートを送信する代わりに、`~/.claude/feedback-bundles/` 配下のローカルアーカイブに書き込みます | ファイルを Anthropic のアカウント担当者に送信するか、サポートリクエストに添付します。[テレメトリサービス](https://code.claude.com/docs/ja/data-usage.md#telemetry-services)を参照してください |

523| [curl テスト](#verify-the-connection)が成功しても、Claude Code はログインするよう求めます | CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、対話型セッションではプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと[信頼プロンプト](https://code.claude.com/docs/ja/permissions.md#what-runs-before-you-trust-a-folder)の後にのみ適用されます | `ANTHROPIC_AUTH_TOKEN` を Claude Code が最初の実行セットアップの前に読み取る場所に設定します。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定 |524| [curl テスト](#verify-the-connection)が成功しても、Claude Code はログインするよう求めます | CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、対話型セッションではプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと[信頼プロンプト](https://code.claude.com/docs/ja/permissions.md#what-runs-before-you-trust-a-folder)の後にのみ適用されます | `ANTHROPIC_AUTH_TOKEN` を Claude Code が最初の実行セットアップの前に読み取る場所に設定します。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定 |

524| `ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます | キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます | `/config` で `Use custom API key` オプションで有効にします |525| `ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます | キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます | `/config` で `Use custom API key` オプションで有効にします |

525| `This machine's managed settings require a first-party login`、または管理設定が `forceLoginMethod` を `"gateway"` に設定する場合は [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)、または `forceLoginGatewayUrl` も設定する場合 | 管理設定に `forceLoginMethod` または `forceLoginOrgUUID` が含まれています。これは `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` と共存できません | 管理者は管理設定から `forceLoginMethod`、`forceLoginOrgUUID`、および `forceLoginGatewayUrl` を削除してゲートウェイ認証情報を使用するか、ゲートウェイ認証情報を削除して管理設定が必要とするサインインを使用する必要があります。2 つは組み合わせることはできません |526| `This machine's managed settings require a first-party login`、または管理設定が `forceLoginMethod` を `"gateway"` に設定する場合は [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)、または `forceLoginGatewayUrl` も設定する場合 | 管理設定に `forceLoginMethod` または `forceLoginOrgUUID` が含まれています。これは `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` と共存できません | 管理者は管理設定から `forceLoginMethod`、`forceLoginOrgUUID`、および `forceLoginGatewayUrl` を削除してゲートウェイ認証情報を使用するか、ゲートウェイ認証情報を削除して管理設定が必要とするサインインを使用する必要があります。2 つは組み合わせることはできません |

Details

142claude -p "Reply with one word: connected"142claude -p "Reply with one word: connected"

143```143```

144 144 

145**チェックポイント**:プロンプトが応答を返し、リクエストがゲートウェイのログに `/v1/messages` パスへの `POST` として状態 `200` で表示されます。Claude Code は `?beta=true` などのクエリ文字列を追加するため、完全な URL ではなくパスで一致させてください。 2 つの失敗メッセージは異なる方向を指しています。145**チェックポイント**:プロンプトが応答を返し、リクエストがゲートウェイのログに `/v1/messages` パスへの `POST` としてステータス `200` で表示されます。Claude Code は `?beta=true` などのクエリ文字列を追加するため、完全な URL ではなくパスで照合してください。失敗メッセージを確認してください。

146 146 

147* `Not logged in`:ゲートウェイログをチェックして 2 つの原因を区別します。ログが空の場合、認証情報がセッションに到達せず、リクエストがマシンから出ていません。テストしているシェルで exports を再実行してください。`401` ボディに `x-api-key` が表示されている拒否されたリクエストが表示される場合、ゲートウェイは代わりにそのヘッダーでキーを期待しています。`ANTHROPIC_API_KEY` に切り替えてください。147* `Not logged in`:ゲートウェイのログを確認してください。ログが空の場合、認証情報がセッションに到達しておらず、リクエストはマシンから送信されていません。テストしているシェルで export を再実行してください。ゲートウェイからの `x-api-key` を示す `401` が表示される場合、ゲートウェイは代わりにそのヘッダーでキーを受け取ることを想定しています。`ANTHROPIC_API_KEY` に切り替えてください。`api.anthropic.com` またはプロバイダーのエンドポイントからの `401` が表示される場合は、ゲートウェイが保持するプロバイダー認証情報を修正してください

148* `Failed to authenticate. API Error: 401` は、認証情報が送信されて拒否されたことを意味し、ゲートウェイログはどこかを示しています。`api.anthropic.com` またはプロバイダーのエンドポイントに名前を付けた `401` は、ゲートウェイがアップストリームに到達したが、ゲートウェイが保持するプロバイダー認証情報が拒否されたことを意味します。開発者キーは機能し、ゲートウェイが保持するプロバイダー認証情報が間違っているか、プレースホルダーです。148* `Failed to authenticate. API Error: 401` は、認証情報が送信されて拒否されたことを意味し、ゲートウェイログはどこかを示しています。`api.anthropic.com` またはプロバイダーのエンドポイントに名前を付けた `401` は、ゲートウェイがアップストリームに到達したが、ゲートウェイが保持するプロバイダー認証情報が拒否されたことを意味します。開発者キーは機能し、ゲートウェイが保持するプロバイダー認証情報が間違っているか、プレースホルダーです。

149 149 

150間違ったまたは到達不可能なベース URL は異なる症状を生成します。Claude Code は [バックオフで接続を再試行](https://code.claude.com/docs/ja/errors.md#automatic-retries)し、エラーを報告する前に数分間出力がない状態で待機できます。コマンドがハングしているように見える場合は、待つ代わりにゲートウェイログをチェックしてください。到着するリクエストがないことは、`ANTHROPIC_BASE_URL` がゲートウェイを指していないことを意味します。150間違ったまたは到達不可能なベース URL は異なる症状を生成します。Claude Code は [バックオフで接続を再試行](https://code.claude.com/docs/ja/errors.md#automatic-retries)し、エラーを報告する前に数分間出力がない状態で待機できます。コマンドがハングしているように見える場合は、待つ代わりにゲートウェイログをチェックしてください。到着するリクエストがないことは、`ANTHROPIC_BASE_URL` がゲートウェイを指していないことを意味します。


247 247 

248`data:` 行が段階的に到着するのが見えるはずです。一時停止後にすべての応答が一度に到着することは、ゲートウェイがバッファリングしていることを意味し、Claude Code を停止させます。`404` はモデル名がルーティングされていないことを意味します。モデル名ごとに繰り返します。248`data:` 行が段階的に到着するのが見えるはずです。一時停止後にすべての応答が一度に到着することは、ゲートウェイがバッファリングしていることを意味し、Claude Code を停止させます。`404` はモデル名がルーティングされていないことを意味します。モデル名ごとに繰り返します。

249 249 

250次に `claude` を開始してメッセージを送信します。このステップでの各症状には 1 つの原因があります。250次に `claude` を起動してメッセージを送信し、表示された内容を以下と照らし合わせます。

251 251 

252* ログインプロンプトは認証情報ギャップを意味します。`/status` を実行し、**Status** タブを開きます。`Setting sources` 行にマネージドセッティングが含まれていない場合、配布がマシンに到達しませんでした。含まれている場合、開発者認証情報が配布されなかったため、`ANTHROPIC_AUTH_TOKEN` または `apiKeyHelper` を設定してください。252* ログイン画面、またはゲートウェイのログに新しい記録がない状態での `Not logged in` は、認証情報の欠落を意味します。`/status` を実行し、**Status** タブを開きます。`Setting sources` 行に管理設定が含まれていない場合、配布がマシンに届いていません。含まれている場合は、開発者の認証情報が配布されていないため、`ANTHROPIC_AUTH_TOKEN` または `apiKeyHelper` を設定してください

253* `Failed to authenticate` エラーはゲートウェイがリクエストを拒否していることを意味します。そのログはどの認証情報が失敗したかを示しています。ゲートウェイ自体がログする拒否は開発者キーに名前を付けますが、`api.anthropic.com` またはプロバイダーのエンドポイントからの `401` は、ゲートウェイが保持するプロバイダー認証情報が拒否されたことを意味します。253* ゲートウェイのログに `401` がある状態での `Please run /login · API Error: 401`、`Not logged in`、または `Invalid API key`:`401` を返したのがどこかを確認してください。ゲートウェイが返した場合は開発者キーまたはそのヘッダーを修正し、`api.anthropic.com` またはプロバイダーのエンドポイントから返された場合はゲートウェイが保持するプロバイダー認証情報を修正してください

254* ゲートウェイが `x-api-key` ヘッダーでキーを期待し、`ANTHROPIC_API_KEY` として設定されている場合、初回使用時のキーに対する 1 回限りの承認プロンプトは想定どおりの動作です。254* ゲートウェイが `x-api-key` ヘッダーでキーを期待し、`ANTHROPIC_API_KEY` として設定されている場合、初回使用時のキーに対する 1 回限りの承認プロンプトは想定どおりの動作です。

255 255 

256組織が [高速モード](https://code.claude.com/docs/ja/fast-mode.md)を使用する場合は、ここで `/fast` も実行してください。可用性チェックはゲートウェイベース URL に従う代わりに `api.anthropic.com` に直接呼び出すため、ゲートウェイルーティングセッションは推論が機能していても高速モードが利用不可または無効として報告できます。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)は、各メッセージを、[設定の残り](#distribute-the-configuration)と一緒に配布される変数にマップします。256組織が [高速モード](https://code.claude.com/docs/ja/fast-mode.md)を使用する場合は、ここで `/fast` も実行してください。可用性チェックはゲートウェイベース URL に従う代わりに `api.anthropic.com` に直接呼び出すため、ゲートウェイルーティングセッションは推論が機能していても高速モードが利用不可または無効として報告できます。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)は、各メッセージを、[設定の残り](#distribute-the-configuration)と一緒に配布される変数にマップします。

Details

147 147 

148## Azure RBAC 構成148## Azure RBAC 構成

149 149 

150`Azure AI User` および `Cognitive Services User` デフォルトロールには、Claude モデルを呼び出すために必要なすべての権限が含まれています。150Microsoft Entra ID、またはそれが発行したベアラートークンで認証する場合は、Foundry リソースに対して ID に `Foundry User` ロールまたは `Cognitive Services User` ロールを割り当ててください。`Foundry User` は、以前の名前である `Azure AI User` で表示される場合もあります。

151 151 

152より制限的な権限の場合は、以下を含むカスタムロールを作成します:152これらのロールが要件を満たさない場合は、カスタムロールについて [Microsoft Foundry RBAC ドキュメント](https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry)を参照してください。

153 

154```json theme={null}

155{

156 "permissions": [

157 {

158 "dataActions": [

159 "Microsoft.CognitiveServices/accounts/providers/*"

160 ]

161 }

162 ]

163}

164```

165 

166詳細については、[Microsoft Foundry RBAC ドキュメント](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry)を参照してください。

167 153 

168## 1M トークンのコンテキストウィンドウ154## 1M トークンのコンテキストウィンドウ

169 155 

model-config.md +1 −1

Details

903 903 

904### ゲートウェイまたはカスタムモデル ID のウィンドウを修正する904### ゲートウェイまたはカスタムモデル ID のウィンドウを修正する

905 905 

906次の起動時の警告のいずれかが表示された場合、Claude Code はセッションのモデル ID を認識していないため、そのモデルのコンテキストウィンドウを判別できず、200K トークンを想定しています。906次の警告のいずれかが表示された場合、Claude Code はセッションのモデル ID を認識していないため、そのモデルのコンテキストウィンドウを判別できず、200K トークンを想定しています。

907 907 

908```text theme={null}908```text theme={null}

909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

Details

431> * **スペース不可**: 値にスペースを含めることはできません。たとえば、`user.organizationName=My Company` は無効です431> * **スペース不可**: 値にスペースを含めることはできません。たとえば、`user.organizationName=My Company` は無効です

432> * **フォーマット**: カンマ区切りの key=value ペアである必要があります: `key1=value1,key2=value2`432> * **フォーマット**: カンマ区切りの key=value ペアである必要があります: `key1=value1,key2=value2`

433> * **使用可能な文字**: 制御文字、空白、二重引用符、カンマ、セミコロン、バックスラッシュを除く US-ASCII 文字のみ433> * **使用可能な文字**: 制御文字、空白、二重引用符、カンマ、セミコロン、バックスラッシュを除く US-ASCII 文字のみ

434> * **特殊文字**: 使用可能な範囲外の文字はパーセントエンコードする必要があります434> * **特殊文字**: 使用可能な範囲外の文字はパーセントエンコードする必要があり、値の中の `=` は `%3D` と記述する必要があります

435>435>

436> スペースが必要な値には、代わりにアンダースコアまたはキャメルケースを使用してください。以下の例では、それぞれの形式で `org.name` を設定しています。436> スペースが必要な値には、代わりにアンダースコアまたはキャメルケースを使用してください。以下の例では、それぞれの形式で `org.name` を設定しています。

437>437>

Details

304claude --permission-mode plan304claude --permission-mode plan

305```305```

306 306 

307計画を承認せずに plan モードを終了するには、もう一度 `Shift+Tab` を押します。307承認プロンプトが表示されていない状態で plan モードを終了するには、もう一度 `Shift+Tab` を押します。承認プロンプトでは `Shift+Tab` を押すと計画が承認されるため、先に `Esc` を押してください。

308 308 

309### 計画をレビューして承認する309### 計画をレビューして承認する

310 310 

Details

344 "PostToolUse": [344 "PostToolUse": [

345 {345 {

346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]

348 }348 }

349 ]349 ]

350 }350 }

Details

196 196 

197### `expect` で結果を確認する197### `expect` で結果を確認する

198 198 

199キットには次のアサーションがあります。選んだアサーションは、`expect(answer.text).toBe('ok')` のように、確認する値の後に続けます。199`expect` には `toEqual` や `toHaveLength` などの独自のアサーションがあり、`expect(answer.text).toBe('ok')` のように、確認する値の後に続けます。完全な一覧については、[ビルドに対応する型](https://code.claude.com/docs/ja/plugins/mods/create.md#get-the-types-for-your-build)の `claude-code/index.d.ts` で `type Matchers` を検索してください。アサーションの前に `.not` を付けると逆の条件を確認できます。promise が何で確定するかを確認するには、`expect(...)` の直後に `.resolves` または `.rejects` を付け、`await expect(promise).rejects.toThrow()` のようにその行を `await` します。

200 

201* **等価性**: 同じ値またはオブジェクトには `toBe`、構造には `toEqual`、構造に加えて `undefined` フィールドとプロトタイプも比較するには `toStrictEqual`、指定したフィールドには `toMatchObject`

202* **テキスト**: 正規表現または部分文字列を受け取る `toMatch`、`toStartWith`、`toEndWith`

203* **数値**: `toBeGreaterThan`、`toBeGreaterThanOrEqual`、`toBeLessThan`、`toBeLessThanOrEqual`

204* **内容**: 部分文字列またはメンバーには `toContain`、構造で比較するメンバーには `toContainEqual`、`toHaveLength`、`toHaveProperty`

205* **存在と型**: `toBeDefined`、`toBeUndefined`、`toBeNull`、`toBeTruthy`、`toBeFalsy`、`toBeNaN`、`toBeInstanceOf`

206* **スロー**: `toThrow`。`expect` が呼び出す関数、または `.rejects` で確認する promise に対して使います

207 

208アサーションの前に `.not` を付けると逆の条件を確認でき、`.resolves` または `.rejects` を付けると promise が何で確定するかを確認できます。

209 200 

210非同期ジェネレーターではなくプレーンな関数として `on` に渡したスタブまたはフックの中で `expect` が失敗すると、テストは失敗します。エンジンはそのフックをスキップし、失敗時の出力には `in the test's store.set hook` のようにそのフックの名前が示されます。201非同期ジェネレーターではなくプレーンな関数として `on` に渡したスタブまたはフックの中で `expect` が失敗すると、テストは失敗します。エンジンはそのフックをスキップし、失敗時の出力には `in the test's store.set hook` のようにそのフックの名前が示されます。

211 202 

Details

67> | `--capacity <N>` | 同時セッションの最大数です。デフォルトは 32 です。`--spawn=session` とは併用できません。 |67> | `--capacity <N>` | 同時セッションの最大数です。デフォルトは 32 です。`--spawn=session` とは併用できません。 |

68> | `--[no-]create-session-in-dir` | サーバー起動時に現在のディレクトリにセッションを 1 つ事前作成し、すぐに入力できるようにします。`worktree` モードでは、このセッションは現在のディレクトリに留まり、オンデマンドのセッションは分離された worktree を取得します。デフォルトでオンです。`--no-create-session-in-dir` を渡してセッションなしで起動した場合、Claude Code はサーバーを停止したときにそのセッションをアーカイブするため、[再開](#resume-sessions-after-stopping-the-server)できるものは残りません。 |68> | `--[no-]create-session-in-dir` | サーバー起動時に現在のディレクトリにセッションを 1 つ事前作成し、すぐに入力できるようにします。`worktree` モードでは、このセッションは現在のディレクトリに留まり、オンデマンドのセッションは分離された worktree を取得します。デフォルトでオンです。`--no-create-session-in-dir` を渡してセッションなしで起動した場合、Claude Code はサーバーを停止したときにそのセッションをアーカイブするため、[再開](#resume-sessions-after-stopping-the-server)できるものは残りません。 |

69> | `--permission-mode <mode>` | サーバーのセッションの開始時の[権限モード](https://code.claude.com/docs/ja/permission-modes.md)(`acceptEdits` など)を設定します。`manual` は `default` のエイリアスとして受け付けます。認識できないモードを指定すると、サーバーは起動時に停止し、有効なモードを一覧表示します。 |69> | `--permission-mode <mode>` | サーバーのセッションの開始時の[権限モード](https://code.claude.com/docs/ja/permission-modes.md)(`acceptEdits` など)を設定します。`manual` は `default` のエイリアスとして受け付けます。認識できないモードを指定すると、サーバーは起動時に停止し、有効なモードを一覧表示します。 |

70> | `--settings <file>` | `claude --settings` と同じ[優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)で、JSON 設定ファイルをサーバーのセッションに適用します。JSON 文字列ではなく、ファイルパスを指定してください。Claude Code v2.1.321 以降が必要です。 |

70> | `--chrome` / `--no-chrome` | サーバーが作成するセッションで [Chrome 統合](https://code.claude.com/docs/ja/chrome.md)をオンまたはオフにし、別のデバイスから作業している間に Claude がマシン上の Chrome を使用できるようにします。どちらのフラグも指定しない場合、サーバーが事前作成するセッションと、claude.ai/code または Claude アプリから自分で開始したセッションは、[Chrome をデフォルトで有効にした](https://code.claude.com/docs/ja/chrome.md#enable-chrome-by-default)場合でも Chrome がオフの状態で開始されます。サーバーが[プロジェクト](https://code.claude.com/docs/ja/claude-projects.md)のスレッドのために開始するセッションは、代わりにその設定に従います(`bypassPermissions` モードを除く)。Claude Code v2.1.273 以降が必要です。 |71> | `--chrome` / `--no-chrome` | サーバーが作成するセッションで [Chrome 統合](https://code.claude.com/docs/ja/chrome.md)をオンまたはオフにし、別のデバイスから作業している間に Claude がマシン上の Chrome を使用できるようにします。どちらのフラグも指定しない場合、サーバーが事前作成するセッションと、claude.ai/code または Claude アプリから自分で開始したセッションは、[Chrome をデフォルトで有効にした](https://code.claude.com/docs/ja/chrome.md#enable-chrome-by-default)場合でも Chrome がオフの状態で開始されます。サーバーが[プロジェクト](https://code.claude.com/docs/ja/claude-projects.md)のスレッドのために開始するセッションは、代わりにその設定に従います(`bypassPermissions` モードを除く)。Claude Code v2.1.273 以降が必要です。 |

71> | `-d`, `--debug[=<filter>]` | サーバーのデバッグログをオンにします。必要に応じてカテゴリでフィルタリングできます。フィルターは `--debug=api,hooks` のように `=` 形式でのみ渡します。Claude Code v2.1.282 以降が必要です。 |72> | `-d`, `--debug[=<filter>]` | サーバーのデバッグログをオンにします。必要に応じてカテゴリでフィルタリングできます。フィルターは `--debug=api,hooks` のように `=` 形式でのみ渡します。Claude Code v2.1.282 以降が必要です。 |

72> | `--debug-file <path>` | デバッグログを指定したファイルに書き込みます。 |73> | `--debug-file <path>` | デバッグログを指定したファイルに書き込みます。 |

73> | `--verbose` | 詳細な接続ログとセッションログを表示します。 |74> | `--verbose` | 詳細な接続ログとセッションログを表示します。 |

74> | `--sandbox`, `--no-sandbox` | v2.1.300 で削除されました。どちらかのフラグを渡すと、サーバーは起動せずに[エラーで終了](https://code.claude.com/docs/ja/errors.md#sandbox-is-not-supported-by-claude-remote-control)します。 |75> | `--sandbox`, `--no-sandbox` | v2.1.300 で削除されました。どちらかのフラグを渡すと、サーバーは起動せずに[エラーで終了](https://code.claude.com/docs/ja/errors.md#sandbox-is-not-supported-by-claude-remote-control)します。 |

75>76>

76> `remote-control` の前にグローバルな `claude` フラグを渡した場合、またはラッパースクリプトがフラグを追加した場合、Claude Code はそのフラグをサーバーが作成するセッションに引き継ぎません。Claude Code がフラグを通すのは、`--verbose` や `--model` のように、それを削除してもセッションでできることが変わらないとわかっている場合だけです。`--settings` などその他のフラグの場合、Claude Code は[起動を拒否](https://code.claude.com/docs/ja/errors.md#not-carried-over-to-the-sessions-remote-control-starts)し、削除すべきフラグ名を表示します。77> `remote-control` の前にグローバルな `claude` フラグを渡した場合、またはラッパースクリプトがフラグを追加した場合、Claude Code はそのフラグをサーバーが作成するセッションに引き継ぎません。`--verbose` や `--model` など一部のフラグでは、サーバーはそのまま起動します。その他のフラグの場合、サーバーは[起動しません](https://code.claude.com/docs/ja/errors.md#not-carried-over-to-the-sessions-remote-control-starts)。設定ファイルを渡すには、`remote-control` の後に `--settings` を指定します。

77>78>

78> サーバーが開始するセッションをサンドボックス化するには、設定ファイルで[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)をオンにします。79> サーバーが開始するセッションをサンドボックス化するには、設定ファイルで[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)をオンにします。

79>80>

routines.md +1 −1

Details

431 431 

432各スケジュールタスクは、ネットワークアクセス、環境変数、セットアップスクリプトを制御する[クラウド環境](https://code.claude.com/docs/ja/cloud-environments.md)を使用します。タスクは、すべての実行でその環境のネットワークポリシーを継承します。432各スケジュールタスクは、ネットワークアクセス、環境変数、セットアップスクリプトを制御する[クラウド環境](https://code.claude.com/docs/ja/cloud-environments.md)を使用します。タスクは、すべての実行でその環境のネットワークポリシーを継承します。

433 433 

434**Default** 環境は、**Allow package managers** がチェックされた **Limited** アクセスを使用するため、その実行は[デフォルト許可リスト](https://code.claude.com/docs/ja/cloud-environments.md#default-allowed-domains)にアクセスできます。ブロックされたホストへのリクエストは `403` と `x-deny-reason: host_not_allowed` で失敗します。MCP コネクタのトラフィックは Anthropic のサーバーを通じてルーティングされるため、タスクに追加するコネクタは **Allowed domains** にホストを追加しなくても機能します。不要なコネクタは[コネクタ](#connectors)で削除してください。434**Default** 環境は、**Allow package managers** がチェックされた **Limited** アクセスを使用するため、その実行は[デフォルト許可リスト](https://code.claude.com/docs/ja/cloud-environments.md#default-allowed-domains)にアクセスできます。ブロックされたホストへのリクエストは、[`403` や `ENOTFOUND` などのエラー](https://code.claude.com/docs/ja/errors#host-not-allowed-in-a-cloud-session)で失敗します。MCP コネクタのトラフィックは Anthropic のサーバーを通じてルーティングされるため、タスクに追加するコネクタは **Allowed domains** にホストを追加しなくても機能します。不要なコネクタは[コネクタ](#connectors)で削除してください。

435 435 

436独自の環境のいずれかで追加のドメインを許可するには、以下の手順に従います。[組織共有環境](https://code.claude.com/docs/ja/cloud-environments.md#organization-shared-environments)はここでは読み取り専用で開くため、その場合は Owner が[管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページからネットワークアクセスを変更します。436独自の環境のいずれかで追加のドメインを許可するには、以下の手順に従います。[組織共有環境](https://code.claude.com/docs/ja/cloud-environments.md#organization-shared-environments)はここでは読み取り専用で開くため、その場合は Owner が[管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページからネットワークアクセスを変更します。

437 437 

sandboxing.md +5 −3

Details

276 276 

277これらのパスは OS レベルで適用されるため、サンドボックス内で実行されるすべてのコマンドは、その子プロセスも含めてこれらに従います。ツールが特定の場所への書き込みアクセスを必要とする場合は、`excludedCommands` でツールをサンドボックスから完全に除外するのではなく、この方法を使用することを推奨します。277これらのパスは OS レベルで適用されるため、サンドボックス内で実行されるすべてのコマンドは、その子プロセスも含めてこれらに従います。ツールが特定の場所への書き込みアクセスを必要とする場合は、`excludedCommands` でツールをサンドボックスから完全に除外するのではなく、この方法を使用することを推奨します。

278 278 

279Linux と WSL2 では、まだ存在しないパスのエントリは効果がないため、先にそのパスを作成してください。

280 

279同じファイルシステム配列を複数の[設定スコープ](https://code.claude.com/docs/ja/settings.md#settings-precedence)で定義した場合、Claude Code はそれらをマージし、あるスコープの配列を別のスコープの配列で置き換えるのではなく、すべてのスコープのパスを結合します。[開発者がポリシーを広げないようにする](#keep-developers-from-widening-the-policy)で説明しているロックがエントリを対象としている場合、Claude Code はそのエントリをマージから除外します。281同じファイルシステム配列を複数の[設定スコープ](https://code.claude.com/docs/ja/settings.md#settings-precedence)で定義した場合、Claude Code はそれらをマージし、あるスコープの配列を別のスコープの配列で置き換えるのではなく、すべてのスコープのパスを結合します。[開発者がポリシーを広げないようにする](#keep-developers-from-widening-the-policy)で説明しているロックがエントリを対象としている場合、Claude Code はそのエントリをマージから除外します。

280 282 

281CLI の [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference) や Agent SDK の [`settingSources`](https://code.claude.com/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) で設定ソースを除外した場合、Claude Code はサンドボックス設定を構築する際に、そのソースの `sandbox.filesystem` エントリ、`Edit` 権限ルール、`Read` 拒否ルールを無視します。Claude Code v2.1.246 以降が必要です。283CLI の [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference) や Agent SDK の [`settingSources`](https://code.claude.com/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) で設定ソースを除外した場合、Claude Code はサンドボックス設定を構築する際に、そのソースの `sandbox.filesystem` エントリ、`Edit` 権限ルール、`Read` 拒否ルールを無視します。Claude Code v2.1.246 以降が必要です。


376 378 

377ファイルシステム分離をオフにすると、サンドボックス化されたコマンドができることが広がるため、Claude Code は以下の設定ソースからの `filesystem.disabled` のみを尊重します。379ファイルシステム分離をオフにすると、サンドボックス化されたコマンドができることが広がるため、Claude Code は以下の設定ソースからの `filesystem.disabled` のみを尊重します。

378 380 

379* ユーザー設定、管理設定、および `--settings` CLI フラグで設定できます。`.claude/settings.json` と `.claude/settings.local.json` のプロジェクト設定では設定できないため、チェックアウトしたプロジェクトがファイルシステム分離をオフにすることはできません。381* ユーザー設定、管理設定、および `--settings` CLI フラグで設定できます。`.claude/settings.json` と `.claude/settings.local.json` のプロジェクト設定では設定できません。

380* 管理設定が `sandbox.filesystem` を何らかの形で設定している場合、または `"mode": "deny"` の `sandbox.credentials.files` エントリを記載している場合は、管理設定のみがこのキーを設定できます。これにより、そのようなデプロイで開発者がファイルシステム分離をオフにすることを防ぎます。全員に対してオフにするには、管理設定で `"disabled": true` を設定します。382* 管理設定が `sandbox.filesystem` を何らかの形で設定している場合、または `"mode": "deny"` の `sandbox.credentials.files` エントリを記載している場合は、管理設定のみがこのキーを設定できます。全員に対してファイルシステム分離をオフにするには、管理設定で `"disabled": true` を設定します。

381* [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/ja/env-vars) が設定されている場合、Claude Code は管理設定を含むすべてのソースからの `filesystem.disabled` を無視し、ファイルシステム分離をオンのまま維持します。383* [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/ja/env-vars) が設定されている場合、Claude Code は管理設定を含むすべてのソースからの `filesystem.disabled` を無視します。

382 384 

383[有効な](https://code.claude.com/docs/ja/settings-reference.md#invalid-credential-entries-in-managed-settings) `mask` エントリは、起動時に Claude Code がそのエントリについて [`deny` にフォールバック](#mask-credential-files)した場合でも、このキーを固定しません。認証情報ディレクトリのようにマスクできないパスは、管理設定で明示的な `deny` エントリとして記載してください。これによりキーが固定されます。385[有効な](https://code.claude.com/docs/ja/settings-reference.md#invalid-credential-entries-in-managed-settings) `mask` エントリは、起動時に Claude Code がそのエントリについて [`deny` にフォールバック](#mask-credential-files)した場合でも、このキーを固定しません。認証情報ディレクトリのようにマスクできないパスは、管理設定で明示的な `deny` エントリとして記載してください。これによりキーが固定されます。

384 386 

settings.md +1 −1

Details

177 177 

178Claude Code は設定ファイルを監視し、変更時に再読み込みするため、`permissions`、`hooks`、および `apiKeyHelper` などの認証情報ヘルパーへの編集を含む、ほとんどの編集は再起動なしで実行中のセッションに適用されます。Claude Code は、セッションの途中で作成した設定ファイルも、そのフォルダがセッション開始時に存在していれば読み込みます。プロジェクトの `.claude/` フォルダについては、同じセッション内でフォルダを作成した場合でもファイルを読み込みます。178Claude Code は設定ファイルを監視し、変更時に再読み込みするため、`permissions`、`hooks`、および `apiKeyHelper` などの認証情報ヘルパーへの編集を含む、ほとんどの編集は再起動なしで実行中のセッションに適用されます。Claude Code は、セッションの途中で作成した設定ファイルも、そのフォルダがセッション開始時に存在していれば読み込みます。プロジェクトの `.claude/` フォルダについては、同じセッション内でフォルダを作成した場合でもファイルを読み込みます。

179 179 

180再読み込みはユーザー、プロジェクト、ローカル、および管理設定をカバーし、Claude Code は検出した各設定ファイル変更に対して [`ConfigChange` hook](https://code.claude.com/docs/ja/hooks#configchange) を実行します。MDM または claude.ai コンソールから到達する管理設定ではありません。MDM または claude.ai コンソールから到達する管理設定は、保存時ではなくスケジュールに従って実行中のセッションに到達します。[配信テーブル](https://code.claude.com/docs/ja/managed-settings.md#choose-a-delivery-mechanism)はソースごとにそれを提供します。180再読み込みはユーザー、プロジェクト、ローカル、および管理設定をカバーします。Claude Code は設定ファイルへの直接の編集に対して [`ConfigChange` フック](https://code.claude.com/docs/ja/hooks#configchange)を実行しますが、MDM または claude.ai コンソールから到達する管理設定に対しては実行しません。MDM または claude.ai コンソールから到達する管理設定は、保存時ではなくスケジュールに従って実行中のセッションに到達します。[配信テーブル](https://code.claude.com/docs/ja/managed-settings.md#choose-a-delivery-mechanism)はソースごとにそれを示しています。

181 181 

182Claude Code はセッション開始時に一度だけいくつかのキーを読み込むため、そのうちの 1 つへの編集は実行中のセッションに到達しません。`requiredMinimumVersion` などの管理者側のキーも再起動を待ちます。[ポリシーが適用される場所と時期](https://code.claude.com/docs/ja/managed-settings.md#where-and-when-a-policy-applies)の下にリストされています。セッション中に編集する可能性が最も高いもの:182Claude Code はセッション開始時に一度だけいくつかのキーを読み込むため、そのうちの 1 つへの編集は実行中のセッションに到達しません。`requiredMinimumVersion` などの管理者側のキーも再起動を待ちます。[ポリシーが適用される場所と時期](https://code.claude.com/docs/ja/managed-settings.md#where-and-when-a-policy-applies)の下にリストされています。セッション中に編集する可能性が最も高いもの:

183 183 

Details

1533}1533}

1534```1534```

1535 1535 

1536Linux と WSL2 では、まだ存在しないパスのエントリは効果がないため、先にパスを作成してください。

1537 

1536Claude Code は `allowWrite` エントリと `Edit(...)` 許可権限ルールからのパスをセッションが読み込むすべての設定スコープ全体でマージし、[`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block)がオンの間、リポジトリ設定からのものを除外します。[リポジトリロック](https://code.claude.com/docs/ja/sandboxing.md#repository-settings-under-an-admin-required-sandbox)によってリポジトリのエントリが除外されることもあります。`allowWrite` エントリは[保護されたパス](https://code.claude.com/docs/ja/sandboxing.md#protected-paths)を解除できません。1538Claude Code は `allowWrite` エントリと `Edit(...)` 許可権限ルールからのパスをセッションが読み込むすべての設定スコープ全体でマージし、[`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block)がオンの間、リポジトリ設定からのものを除外します。[リポジトリロック](https://code.claude.com/docs/ja/sandboxing.md#repository-settings-under-an-admin-required-sandbox)によってリポジトリのエントリが除外されることもあります。`allowWrite` エントリは[保護されたパス](https://code.claude.com/docs/ja/sandboxing.md#protected-paths)を解除できません。

1537 1539 

1538### `sandbox.filesystem.denyWrite`1540### `sandbox.filesystem.denyWrite`

setup.md +8 −26

Details

40>40>

41> **macOS、Linux、WSL:**41> **macOS、Linux、WSL:**

42>42>

43> ```bash theme={null}43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>


48>48>

49> **Windows PowerShell:**49> **Windows PowerShell:**

50>50>

51> ```powershell theme={null}51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD:**55> **Windows CMD:**

56>56>

57> ```batch theme={null}57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>


72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

75> ```bash theme={null}75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>


84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null}87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>


141 141 

142### Alpine Linux と musl ベースのディストリビューション142### Alpine Linux と musl ベースのディストリビューション

143 143 

144Alpine およびその他の musl/uClibc ベースのディストリビューション上に Claude Code をインストールするには、インストールコマンド用に `bash` と `curl` が必要であり、実行時に `libgcc`、`libstdc++`、および `ripgrep` が必要です。Alpine はデフォルトで `bash` と `curl` を含まないため、ドキュメント化されたインストールコマンドは `not found` エラーで失敗します。これらをインストールするまで、ディストリビューションのパッケージマネージャーを使用してこれらのパッケージをインストールしてから、`USE_BUILTIN_RIPGREP=0` を設定します。144Alpine およびその他の musl ベースのディストリビューションでは、[インストールコマンド](#install-claude-code)に `bash` と `curl` が必要であり、Claude Code 自体には `bash` または `zsh` が必要です。Alpine にはデフォルトで `bash` も `curl` も含まれていないため、これらをインストールするまで、ドキュメントに記載されたインストールコマンドは `not found` エラーで失敗します。

145 145 

146この例は Alpine で必要なパッケージをインストールします。146この例は Alpine で必要なパッケージをインストールします。

147 147 

148```bash theme={null}148```bash theme={null}

149apk add bash curl libgcc libstdc++ ripgrep149apk add bash curl

150```

151 

152Alpine では、`ripgrep` はコミュニティリポジトリにあります。`apk` がパッケージが見つからないと報告する場合は、Alpine バージョンを使用して `/etc/apk/repositories` にコミュニティリポジトリを追加します。

153 

154```bash theme={null}

155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

156```

157 

158`apk update` を実行してパッケージインデックスを更新し、`apk add` コマンドを再試行します。

159 

160次に、[`settings.json`](https://code.claude.com/docs/ja/settings-reference#all-settings)ファイルで `USE_BUILTIN_RIPGREP` を `0` に設定します。

161 

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151 

170## インストールを確認152## インストールを確認


443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \

444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub

445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories

446> apk add claude-code428> apk add bash claude-code

447> ```429> ```

448>430>

449> `latest` チャネルに切り替えるには、`stable` リポジトリ行を削除し、`latest` リポジトリを追加します:431> `latest` チャネルに切り替えるには、`stable` リポジトリ行を削除し、`latest` リポジトリを追加します:

Details

26 26 

27| ターミナル | 改行用の Shift+Enter |27| ターミナル | 改行用の Shift+Enter |

28| :- | :- |28| :- | :- |

29| Ghostty、Kitty、iTerm2、WezTerm、Warp、Apple Terminal、Windows Terminal | セットアップなしで機能 |29| Ghostty、Kitty、iTerm2、WezTerm、Warp、Windows Terminal | セットアップなしで機能 |

30| kitty キーボードプロトコルをサポートする他のターミナル(foot や Alacritty 0.16 以降など) | セットアップなしで機能。Claude Code v2.1.269 以降が必要です |30| kitty キーボードプロトコルをサポートする他のターミナル(foot や Alacritty 0.16 以降など) | セットアップなしで機能。Claude Code v2.1.269 以降が必要です |

31| VS Code、Cursor、Devin Desktop、Alacritty 0.16 より前のバージョン、Zed | 1 回 `/terminal-setup` を実行 |31| VS Code、Cursor、Devin Desktop、Alacritty 0.16 より前のバージョン、Zed | 1 回 `/terminal-setup` を実行 |

32| gnome-terminal、PyCharm や Android Studio などの JetBrains IDE | 利用不可。Ctrl+J または `\` の後に Enter を使用 |32| gnome-terminal、PyCharm や Android Studio などの JetBrains IDE | 利用不可。Ctrl+J または `\` の後に Enter を使用 |

Details

127 127 

128Claude は `AskUserQuestion` を使用して、決定や確認が必要な場合に複数選択肢の質問をします。オプションを選択して回答するか、`Other` 行またはメモフィールドを通じて独自のテキストを入力してください。128Claude は `AskUserQuestion` を使用して、決定や確認が必要な場合に複数選択肢の質問をします。オプションを選択して回答するか、`Other` 行またはメモフィールドを通じて独自のテキストを入力してください。

129 129 

130独自のテキストを入力して回答した場合、Claude Code は中立的な表現で回答を伝えるため、Claude は書かれた内容に従います。これには、待機や先に説明することを求める指示も含まれます。

131 

132### 質問の自動継続タイムアウト130### 質問の自動継続タイムアウト

133 131 

134質問は、回答するまで開いたままになります。回答しないままにした質問が最終的に閉じて、Claude がユーザーを待たずに続行できるようにしたい場合は、[`askUserQuestionTimeout`](https://code.claude.com/docs/ja/settings-reference#askuserquestiontimeout) 設定を `60s`、`5m`、または `10m` に設定します。これはユーザーの `settings.json` または `/config` の **Question auto-continue timeout** 行から設定できます。132質問は、回答するまで開いたままになります。回答しないままにした質問が最終的に閉じて、Claude がユーザーを待たずに続行できるようにしたい場合は、[`askUserQuestionTimeout`](https://code.claude.com/docs/ja/settings-reference#askuserquestiontimeout) 設定を `60s`、`5m`、または `10m` に設定します。これはユーザーの `settings.json` または `/config` の **Question auto-continue timeout** 行から設定できます。


525 523 

526## Read ツールの動作524## Read ツールの動作

527 525 

528Read ツールはファイルパスを受け取り、行番号付きでコンテンツを返します。Claude は常に絶対パスを渡すように指示されています。526Read ツールはファイルパスを受け取り、行番号付きでコンテンツを返します。

529 527 

530空のファイルを読み込むと、ファイルは存在するがコンテンツが空であることを示す通知が返され、最後の行を超えた `offset` はファイルの行数を示す通知を返します。528空のファイルを読み込むと、ファイルは存在するがコンテンツが空であることを示す通知が返され、最後の行を超えた `offset` はファイルの行数を示す通知を返します。

531 529 

Details

388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source

389> ```389> ```

390 390 

391Linux では、不足している共有ライブラリを確認してください。`ldd` が不足しているライブラリを表示する場合は、システムパッケージをインストールする必要があるかもしれません。Alpine Linux およびその他の musl ベースのディストリビューションについては、[Alpine Linux セットアップ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions)を参照してください。391Linux では、不足している共有ライブラリを確認してください。`ldd` が不足しているライブラリを表示する場合は、システムパッケージをインストールする必要があるかもしれません。Alpine Linux およびその他の musl ベースのディストリビューションについては、[Linux の musl または glibc バイナリの不一致](#linux-musl-or-glibc-binary-mismatch)を参照してください。

392 392 

393```bash theme={null}393```bash theme={null}

394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"


906 906 

907### Linux musl または glibc バイナリの不一致907### Linux musl または glibc バイナリの不一致

908 908 

909インストール後に `libstdc++.so.6` や `libgcc_s.so.1` などの共有ライブラリが見つからないというエラーが表示される場合、インストーラーはシステムの間違ったバイナリバリアントをダウンロードした可能性があります。909インストール後に `ld-linux-x86-64.so.2` や `ld-linux-aarch64.so.1` などの共有ライブラリが見つからないというエラーが表示される場合、インストーラーはシステムの間違ったバイナリバリアントをダウンロードした可能性があります。

910 910 

911```text theme={null}911```text theme={null}

912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory

913```913```

914 914 

915これは、musl クロスコンパイルパッケージがインストールされている glibc ベースのシステムで発生する可能性があり、インストーラーがシステムを musl として誤検出します。

916 

917**解決策:**915**解決策:**

918 916 

9191. **システムが使用する libc を確認する**:9171. **システムが使用する libc を確認する**:


924 922 

9252. **glibc にいるが musl バイナリを取得した場合**、インストールを削除して再インストールしてください。`https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。`ldd --version` と `ls /lib/libc.musl*` の出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。9232. **glibc にいるが musl バイナリを取得した場合**、インストールを削除して再インストールしてください。`https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。`ldd --version` と `ls /lib/libc.musl*` の出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。

926 924 

9273. **実際に musl にいる場合**(Alpine Linux など)、必要なパッケージをインストールしてください。9253. **musl にいるが glibc バイナリを取得した場合**、[インストールを削除](https://code.claude.com/docs/ja/setup.md#uninstall-claude-code)してください。Alpine Linux では、まず [Alpine Linux セットアップ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions)に記載されているパッケージをインストールしてください。その後、[インストールコマンド](https://code.claude.com/docs/ja/setup.md#install-claude-code)を実行すると、musl バイナリがインストールされます。

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 Alpine では、`ripgrep` はコミュニティリポジトリにあります。`apk` がパッケージが見つからないと報告する場合は、[Alpine Linux セットアップ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions)を参照してください。

932 926 

933### `Illegal instruction`927### `Illegal instruction`

934 928 

Details

152> apk add ripgrep152> apk add ripgrep

153> ```153> ```

154>154>

155> `ripgrep` は Alpine のコミュニティリポジトリにあります。`apk` がパッケージが見つからないと報告する場合は、[Alpine Linux セットアップ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions)を参照してください。155> `ripgrep` は Alpine のコミュニティリポジトリにあります。

156 156 

157> [tab] Arch157> [tab] Arch

158>158>

workflows.md +0 −2

Details

75| :- | :- |75| :- | :- |

76| `/deep-research <question>` | 複数の角度から質問に対する Web 検索を展開し、見つけたソースを取得してクロスチェックし、各クレームに投票し、クロスチェックで生き残らなかったクレームがフィルタリングされた引用されたレポートを返します。[WebSearch ツール](https://code.claude.com/docs/ja/tools-reference.md#websearch-tool-behavior)が利用可能である必要があります |76| `/deep-research <question>` | 複数の角度から質問に対する Web 検索を展開し、見つけたソースを取得してクロスチェックし、各クレームに投票し、クロスチェックで生き残らなかったクレームがフィルタリングされた引用されたレポートを返します。[WebSearch ツール](https://code.claude.com/docs/ja/tools-reference.md#websearch-tool-behavior)が利用可能である必要があります |

77 77 

78`/deep-research` は、呼び出すときのみ実行されます。

79 

80[自分で保存](#save-the-workflow-for-reuse)したワークフローは同じ方法でコマンドになり、バンドルされたものと一緒に `/` オートコンプリートに表示されます。78[自分で保存](#save-the-workflow-for-reuse)したワークフローは同じ方法でコマンドになり、バンドルされたものと一緒に `/` オートコンプリートに表示されます。

81 79 

82### 実行を監視する80### 実行を監視する