SpyBara
Go Premium

Documentation 2026-09-29 23:58 UTC to 2026-09-30 08:58 UTC

61 files changed +1,147 −691. View all changes and history on the product overview
2026
Wed 30 09:59 Tue 29 23:58 Mon 28 22:59 Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02

agent-view.md +28 −2

Details

64 </Step>64 </Step>

65</Steps>65</Steps>

66 66 

67`claude agents` を `claude` の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、`←` を押してテーブルに戻ります。

68 

69通常の `claude` セッション内では、プロンプトフッターの `←` ヒントは、`← 2 agents` のように入力を待機中のバックグラウンドエージェントの数をカウントし、入力が必要なエージェントがない場合は `← for agents` に戻ります。99 を超えるカウントは `99+` として表示されます。カウントはターミナルがフォーカスされている間は約 10 秒ごとに更新され、フォーカスが戻ると即座に更新されます。カウントが移動したときとエージェントが完了したときに色が一時的に変わり、バックグラウンドセッションが完了して入力が必要なエージェントがない場合は、`← 2 done` のように完了した数を一時的に表示します。[`prefersReducedMotion` 設定](/docs/ja/settings-reference#prefersreducedmotion)がオンの場合は両方のフラッシュがオフになり、[スクリーンリーダーモード](/docs/ja/accessibility)ではヒントは非表示になります。67通常の `claude` セッション内では、プロンプトフッターの `←` ヒントは、`← 2 agents` のように入力を待機中のバックグラウンドエージェントの数をカウントし、入力が必要なエージェントがない場合は `← for agents` に戻ります。99 を超えるカウントは `99+` として表示されます。カウントはターミナルがフォーカスされている間は約 10 秒ごとに更新され、フォーカスが戻ると即座に更新されます。カウントが移動したときとエージェントが完了したときに色が一時的に変わり、バックグラウンドセッションが完了して入力が必要なエージェントがない場合は、`← 2 done` のように完了した数を一時的に表示します。[`prefersReducedMotion` 設定](/docs/ja/settings-reference#prefersreducedmotion)がオンの場合は両方のフラッシュがオフになり、[スクリーンリーダーモード](/docs/ja/accessibility)ではヒントは非表示になります。

70 68 

69<h3 id="open-agent-view-by-default">

70 デフォルトでエージェントビューを開く

71</h3>

72 

73引数なしの `claude` がエージェントビューを新しい会話の代わりに開くようにするには、`/config` 設定をオンにします。

74 

75<Steps>

76 <Step title="設定をオンにする">

77 通常の `claude` セッションで `/config` を実行し、**デフォルトでエージェントビューを開く**をオンにします。メニューをスキップするには、[`defaultToAgentsView`](/docs/ja/settings-reference#defaulttoagentsview) キーを直接設定します。

78 

79 ```text theme={null}

80 /config defaultToAgentsView=true

81 ```

82 </Step>

83 

84 <Step title="Claude Code を開始する">

85 セッションを終了し、引数なしで `claude` を実行します。

86 

87 ```bash theme={null}

88 claude

89 ```

90 

91 エージェントビューが新しい会話の代わりに開きます。

92 </Step>

93</Steps>

94 

95設定がオンの場合に通常のセッションを開始するには、プロンプトを渡します。`claude "fix the login test"`。設定をオフにするには、通常のセッションで、またはエージェントビューからアタッチしたセッションで `/config defaultToAgentsView=false` を実行します。

96 

71<h2 id="monitor-sessions-with-agent-view">97<h2 id="monitor-sessions-with-agent-view">

72 エージェントビューでセッションを監視する98 エージェントビューでセッションを監視する

73</h2>99</h2>

Details

483 483 

484Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Amazon Bedrock で [1M トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#context-window-sizes-by-model)をサポートしています。Sonnet 5 は Invoke API と [Mantle エンドポイント](#use-the-mantle-endpoint)の両方で常に 1M ウィンドウで実行され、選択する `[1m]` バリアントはありません。Invoke API 上の他のモデルについては、Claude Code は 1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。484Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Amazon Bedrock で [1M トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#context-window-sizes-by-model)をサポートしています。Sonnet 5 は Invoke API と [Mantle エンドポイント](#use-the-mantle-endpoint)の両方で常に 1M ウィンドウで実行され、選択する `[1m]` バリアントはありません。Invoke API 上の他のモデルについては、Claude Code は 1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。

485 485 

486[セットアップウィザード](#sign-in-with-bedrock)は、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/docs/ja/model-config#pin-models-for-third-party-deployments)を参照してください。486[セットアップウィザード](#sign-in-with-bedrock)は、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/docs/ja/model-config#pin-models-for-third-party-deployments)を参照してください。1M ウィンドウをピンを変更せずに使用する方法を含みます。

487 487 

488<h2 id="service-tiers">488<h2 id="service-tiers">

489 サービスティア489 サービスティア

artifacts.md +11 −11

Details

100共有できる相手はプランによって異なります。100共有できる相手はプランによって異なります。

101 101 

102* **組織内**: Team プランと Enterprise プランでは、組織内の特定のユーザーまたは全員にアクセス権を付与できます。ビューアーは、ページを表示するために claude.ai に組織のメンバーとしてサインインします。102* **組織内**: Team プランと Enterprise プランでは、組織内の特定のユーザーまたは全員にアクセス権を付与できます。ビューアーは、ページを表示するために claude.ai に組織のメンバーとしてサインインします。

103* **公開**: インターネット上の誰でも開くことができるリンクを共有でき、claude.ai へのサインインは不要です。Pro プランと Max プランでは、公開リンクがアーティファクトを共有する唯一の方法です。Team プランと Enterprise プランでは、Owner が [組織に対して公開共有を有効にする](#control-public-sharing) まで、公開共有はオフになっています。103* **公開**: インターネット上の誰でも開くことができるリンクを共有でき、claude.ai へのサインインは不要です。Team プランと Enterprise プランでは、Owner が [組織に対して公開共有を有効にする](#control-public-sharing) まで、公開共有はオフになっています。

104 104 

105<h3 id="let-someone-edit-with-you">105<h3 id="let-someone-edit-with-you">

106 他のユーザーと一緒に編集する106 他のユーザーと一緒に編集する


122 アーティファクトのコメントを収集する122 アーティファクトのコメントを収集する

123</h2>123</h2>

124 124 

125組織内でアーティファクトを共有すると、共有相手はページにコメントを残すことができ、Claude がそのコメントを読んで返信することができます。Claude Code v2.1.221 以降と Team または Enterprise プランが必要です。これは、[組織内で共有](#share-an-artifact)したアーティファクトのみがコメントを受け付けるためです。Claude がコメントを読む場合は 2 つあります。125組織内でアーティファクトを共有すると、共有相手はページにコメントを残すことができ、Claude がそのコメントを読んで返信することができます。Claude Code v2.1.221 以降が必要です。Claude がコメントを読む場合は 2 つあります。

126 126 

127* **Claude に読むよう依頼する場合**:Claude にアーティファクトの URL を提供し、コメントを求めます。Claude は各スレッドをリストアップし、アーティファクトを編集できるユーザーが送信したコメントをマークします。127* **Claude に読むよう依頼する場合**:Claude にアーティファクトの URL を提供し、コメントを求めます。Claude は各スレッドをリストアップし、アーティファクトを編集できるユーザーが送信したコメントをマークします。

128* **アーティファクトを編集できるユーザーが Claude にコメントを送信する場合**:ページのスレッドで、**Send to Claude** でコメントを送信するか、その中で `@claude` にメンションします。どちらの方法でも、スレッドが有効になります。128* **アーティファクトを編集できるユーザーが Claude にコメントを送信する場合**:ページのスレッドで、**Send to Claude** でコメントを送信するか、その中で `@claude` にメンションします。どちらの方法でも、スレッドが有効になります。

129 129 

130Claude は有効になったスレッドにのみ返信または解決できます。その他のスレッドは、ユーザーがページで解決するまで開いたままになります。ビューアーは、各返信が Claude から送信されたものとして表示されます(あなた経由で)。130Claude は有効になったスレッドにのみ返信または解決できます。その他のスレッドは、ユーザーがページで解決するまで開いたままになります。ビューアーは、各返信が Claude から送信されたものとして表示されます(あなた経由で)。

131 131 

132アーティファクトを公開共有する場合、ビューアーはコメントできません。ページに「`Comments aren't available while this Artifact is shared publicly.`」と表示されます。既にコメントスレッドがあるアーティファクトを公開リンクに切り替えるには、まずスレッドを削除してください。132アーティファクトを公開共有する場合、公開リンク経由でのみアクセスできるユーザーはコメントを表示できず、追加することもできません。既存のコメントスレッドはアーティファクトに残り、あなたとそのエディターはまだそれらを読んで返信できます。

133 133 

134コメントを自分で読むよう Claude に依頼するには、URL を提供します。134コメントを自分で読むよう Claude に依頼するには、URL を提供します。

135 135 


195 195 

196コネクタバックアップページを共有する予定がある場合は、Claude に各ライブセクションに必要なコネクタを指定するフォールバックメッセージを含めるよう依頼してください。接続が不足しているビューアには、空のセクションの代わりに接続する内容が表示されます。196コネクタバックアップページを共有する予定がある場合は、Claude に各ライブセクションに必要なコネクタを指定するフォールバックメッセージを含めるよう依頼してください。接続が不足しているビューアには、空のセクションの代わりに接続する内容が表示されます。

197 197 

198コネクタを呼び出すアーティファクトは、どのプランでも公開リンクで共有することはできません。Team および Enterprise プランでは、プライベートに保つか、[組織内で共有](#share-an-artifact) することができます。公開リンクが唯一の共有方法である Pro および Max プランでは、コネクタバックアップアーティファクトはあなたのみにプライベートのままです。198[アーティファクトを共有](#share-an-artifact) する場合、組織内またはパブリックで共有できます。これはプランと組織の設定によります。コネクタ呼び出しは、claude.ai にサインインせずにパブリックリンクを開いたビューア、または組織外からアクセスしたビューアに対しては実行されません。そのビューアはページをライブセクションなしで表示します。

199 199 

200<h3 id="the-page-shows-no-live-data-for-a-viewer">200<h3 id="the-page-shows-no-live-data-for-a-viewer">

201 ページがビューアのライブデータを表示しない201 ページがビューアのライブデータを表示しない

202</h3>202</h3>

203 203 

204コネクタバックアップページがレンダリングされても、共有した人のライブセクションが空のままの場合は、これらの原因を確認してください。204コネクタバックアップページがレンダリングされても、組織内のビューアのライブセクションが空のままの場合は、これらの原因を確認してください。

205 205 

206* **ビューアがコネクタを接続していない**。コネクタはアカウントごとであるため、各ビューアはページが呼び出すすべてのコネクタへの独自の接続が必要です。claude.ai の **Settings > Connectors** で接続を追加してから、ページを再度読み込むことができます。206* **ビューアがコネクタを接続していない**。コネクタはアカウントごとであるため、各ビューアはページが呼び出すすべてのコネクタへの独自の接続が必要です。claude.ai の **Settings > Connectors** で接続を追加してから、ページを再度読み込むことができます。

207* **ビューアが権限要求を拒否した**。拒否はそのページロードの残りの間続きます。ページを再度読み込むと、権限要求が戻ります。207* **ビューアが権限要求を拒否した**。拒否はそのページロードの残りの間続きます。ページを再度読み込むと、権限要求が戻ります。


375 375 

376| 要件 | 利用可能な場合 |376| 要件 | 利用可能な場合 |

377| :- | :- |377| :- | :- |

378| プラン | Pro、Max、Team、または Enterprise。Pro および Max プランでは、Artifacts は共有するまであなたのみがアクセスでき、管理者管理は適用されません。Team プランでは、Artifacts はデフォルトで有効です。Enterprise プランでは、Owner が claude.ai 管理設定で[それらを有効にします](#manage-artifacts-for-your-organization)。 |378| プラン | Pro、Max、Team、または Enterprise。Pro および Max プランでは、Artifacts は共有するまであなたのみがアクセスでき、管理者管理は適用されません。Team および Enterprise プランでは、Artifacts はデフォルトで有効です。Owner が claude.ai 管理設定で[それらを組織に対して無効にする](#manage-artifacts-for-your-organization)ことができます。 |

379| 認証 | セッションが claude.ai アカウントでサポートされています。CLI またはデスクトップアプリで `/login` でサインインします。Claude Tag セッションはエージェントの ID を通じてサインインするため、追加の手順は不要です。API キー、[ゲートウェイトークン](/docs/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |379| 認証 | セッションが claude.ai アカウントでサポートされています。CLI またはデスクトップアプリで `/login` でサインインします。Claude Tag セッションはエージェントの ID を通じてサインインするため、追加の手順は不要です。API キー、[ゲートウェイトークン](/docs/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |

380| モデルプロバイダー | Anthropic API。[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、または[Microsoft Foundry](/docs/ja/microsoft-foundry)では利用できません。 |380| モデルプロバイダー | Anthropic API。[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、または[Microsoft Foundry](/docs/ja/microsoft-foundry)では利用できません。 |

381| 組織ポリシー | カスタマー管理暗号化キー(CMEK)、HIPAA、および[Zero Data Retention](/docs/ja/zero-data-retention)は組織に対して有効になっていません。 |381| 組織ポリシー | カスタマー管理暗号化キー(CMEK)、HIPAA、および[Zero Data Retention](/docs/ja/zero-data-retention)は組織に対して有効になっていません。 |


408 組織のアーティファクトを管理する408 組織のアーティファクトを管理する

409</h2>409</h2>

410 410 

411Team プランと Enterprise プランのオーナーは、[claude.ai 管理設定](https://claude.ai/admin-settings/claude-code)からアーティファクトを管理できます。アーティファクトのコンテンツは Anthropic が運用するインフラストラクチャに保存され、アーティファクトが[公開で共有](#control-public-sharing)されていない限り、発行元の組織の認証済みメンバーのみに表示されます。411Team プランと Enterprise プランのオーナーは、[claude.ai 管理設定](https://claude.ai/admin-settings/artifacts)からアーティファクトを管理できます。アーティファクトのコンテンツは Anthropic が運用するインフラストラクチャに保存され、アーティファクトが[公開で共有](#control-public-sharing)されていない限り、発行元の組織の認証済みメンバーと共有先の人のみに表示されます。

412 412 

413<h3 id="enable-or-disable-artifacts">413<h3 id="enable-or-disable-artifacts">

414 アーティファクトを有効または無効にする414 アーティファクトを有効または無効にする

415</h3>415</h3>

416 416 

417組織全体のアーティファクトを有効または無効にするには、[**Settings > Claude Code > Capabilities**](https://claude.ai/admin-settings/claude-code)に移動して、**Artifacts** トグルを使用します。ロールベースのアクセス制御を備えた Enterprise プランでは、アーティファクトを特定のロールにスコープすることもできます。[**Settings > Roles**](https://claude.ai/admin-settings/roles)に移動してロールを編集し、**Claude Code** グループの下の **Artifacts** 権限を設定します。417組織全体のアーティファクトを有効または無効にするには、[**Organization settings > Artifacts**](https://claude.ai/admin-settings/artifacts)に移動して、**Artifacts** トグルを使用します。ロールベースのアクセス制御を備えた Enterprise プランでは、アーティファクトを特定のロールにスコープすることもできます。[**Organization settings > Roles**](https://claude.ai/admin-settings/roles)に移動してロールを編集し、**Artifacts** 権限を設定します。

418 418 

419<h3 id="control-connector-calls-from-artifacts">419<h3 id="control-connector-calls-from-artifacts">

420 アーティファクトからのコネクタ呼び出しを制御する420 アーティファクトからのコネクタ呼び出しを制御する

421</h3>421</h3>

422 422 

423[アーティファクトからのコネクタ呼び出し](#pull-live-data-with-mcp-connectors)には、アーティファクトのオン/オフを切り替える **Artifacts** トグルとは別の専用トグルがあります。[**Settings > Capabilities**](https://claude.ai/admin-settings/capabilities)に移動して、**Enable artifact connectors** トグルを使用します。同じトグルは claude.ai の会話で作成されたアーティファクトからのコネクタ呼び出しも管理します。そのため、**Settings > Claude Code** ではなく **Settings > Capabilities** の下に配置されています。423[アーティファクトからのコネクタ呼び出し](#pull-live-data-with-mcp-connectors)には、アーティファクトのオン/オフを切り替える **Artifacts** トグルとは別の専用トグルがあります。[**Organization settings > Capabilities**](https://claude.ai/admin-settings/capabilities)に移動して、**Enable artifact connectors** トグルを使用します。同じトグルは claude.ai の会話で作成されたアーティファクトからのコネクタ呼び出しも管理します。

424 424 

425<h3 id="control-public-sharing">425<h3 id="control-public-sharing">

426 公開共有を制御する426 公開共有を制御する

427</h3>427</h3>

428 428 

429公開共有は Team プランと Enterprise プランではデフォルトでオフになっているため、メンバーはオーナーがオンにするまで、組織内でのみアーティファクトを共有できます。メンバーがサインインなしで誰でも表示できるパブリックリンクにアーティファクトを公開できるようにするには、**Settings > Claude Code > Capabilities** に移動して、**Artifacts** トグルの下の **External sharing** をオンにします。オフに戻すと、各アーティファクトのオーディエンスを変更することなく、既存のパブリックリンク経由のアクセスがブロックされます。再度有効にすると、アクセスが再開されます。429公開共有は Team プランと Enterprise プランではデフォルトでオフになっています。メンバーがサインインなしで誰でも表示できるパブリックリンクにアーティファクトを公開できるようにするには、[**Organization settings > Artifacts**](https://claude.ai/admin-settings/artifacts)に移動して、**Artifacts** トグルの下の **External sharing** をオンにします。オフに戻すと、各アーティファクトのオーディエンスを変更することなく、既存のパブリックリンク経由のアクセスがブロックされます。再度有効にすると、アクセスが再開されます。

430 430 

431<h3 id="set-a-retention-policy">431<h3 id="set-a-retention-policy">

432 保持ポリシーを設定する432 保持ポリシーを設定する

433</h3>433</h3>

434 434 

435アーティファクトが自動削除される前に保持される期間を設定するには、[**Settings > Data & privacy controls**](https://claude.ai/admin-settings/data-privacy-controls)に移動します。作成者にのみプライベートなアーティファクトと共有されたアーティファクトに対して、別々の保持期間を設定できます。435アーティファクトが自動削除される前に保持される期間を設定するには、[**Organization settings > Data and privacy**](https://claude.ai/admin-settings/data-privacy-controls)に移動します。作成者にのみプライベートなアーティファクトと共有されたアーティファクトに対して、別々の保持期間を設定できます。

436 436 

437<h3 id="review-the-audit-log">437<h3 id="review-the-audit-log">

438 監査ログを確認する438 監査ログを確認する

Details

32 32 

33ログアウトして再認証するには、Claude Code プロンプトで `/logout` と入力します。ログアウトすると、初回起動セットアップ状態もリセットされるため、次回 `claude` を実行するときはログインとセットアップを再度実行します。33ログアウトして再認証するには、Claude Code プロンプトで `/logout` と入力します。ログアウトすると、初回起動セットアップ状態もリセットされるため、次回 `claude` を実行するときはログインとセットアップを再度実行します。

34 34 

35ログインに問題がある場合は、[認証のトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication)を参照してください。

36 

37<h3 id="log-in-with-multiple-accounts">

38 複数のアカウントでログインする

39</h3>

40 

35複数のアカウント(仕事用と個人用など)に同時にログインしたままにするには、各アカウントに独自の設定ディレクトリを指定します。`claude` を起動するときに、[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars#variables) 環境変数を使用するアカウントのディレクトリに設定します。各ディレクトリには、独自の設定、セッション履歴、および claude.ai ログインまたは API キーがあります。たとえば、Bash または Zsh では、`~/.bashrc` または `~/.zshrc` に次のエイリアスを追加して、`claude-work` が仕事用アカウントを使用し、`claude` が個人用アカウントを保持するようにできます。41複数のアカウント(仕事用と個人用など)に同時にログインしたままにするには、各アカウントに独自の設定ディレクトリを指定します。`claude` を起動するときに、[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars#variables) 環境変数を使用するアカウントのディレクトリに設定します。各ディレクトリには、独自の設定、セッション履歴、および claude.ai ログインまたは API キーがあります。たとえば、Bash または Zsh では、`~/.bashrc` または `~/.zshrc` に次のエイリアスを追加して、`claude-work` が仕事用アカウントを使用し、`claude` が個人用アカウントを保持するようにできます。

36 42 

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


40 46 

41新しいターミナルを開いて初めて `claude-work` を実行した後、Claude Code は新しいディレクトリのログインとセットアップを実行します。別のディレクトリは、Claude Code がそのような種類のサインインを設定ディレクトリの外に保存するため、2 つの Claude Console サインイン[API キーなし](#sign-in-without-an-api-key)を区別しません。47新しいターミナルを開いて初めて `claude-work` を実行した後、Claude Code は新しいディレクトリのログインとセットアップを実行します。別のディレクトリは、Claude Code がそのような種類のサインインを設定ディレクトリの外に保存するため、2 つの Claude Console サインイン[API キーなし](#sign-in-without-an-api-key)を区別しません。

42 48 

43ログインに問題がある場合は、[認証のトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication)を参照してください。

44 

45<h2 id="set-up-team-authentication">49<h2 id="set-up-team-authentication">

46 チーム認証を設定する50 チーム認証を設定する

47</h2>51</h2>

Details

163 ペイロードは Claude のコンテキストに `<channel>` タグとして到着します:163 ペイロードは Claude のコンテキストに `<channel>` タグとして到着します:

164 164 

165 ```text theme={null}165 ```text theme={null}

166 <channel source="webhook" path="/" method="POST">build failed on main: https://ci.example.com/run/1234</channel>166 <channel source="webhook" path="/" method="POST">

167 build failed on main: https://ci.example.com/run/1234

168 </channel>

167 ```169 ```

168 170 

169 ターミナルはイベントを 1 行の概要として、`← webhook: build failed on main: https://ci.example.com/run/1234` としてレンダリングします。これは生のタグではなく、その後 Claude が応答を開始するのが見えます:ファイルを読み込み、コマンドを実行、またはメッセージが要求するもの。これは一方向チャネルなので、Claude はセッションで動作しますが、webhook を通じて何も返送しません。返信を追加するには、[返信ツールを公開](#expose-a-reply-tool) を参照してください。171 ターミナルはイベントを 1 行の概要として、`← webhook: build failed on main: https://ci.example.com/run/1234` としてレンダリングします。これは生のタグではなく、その後 Claude が応答を開始するのが見えます:ファイルを読み込み、コマンドを実行、またはメッセージが要求するもの。これは一方向チャネルなので、Claude はセッションで動作しますが、webhook を通じて何も返送しません。返信を追加するには、[返信ツールを公開](#expose-a-reply-tool) を参照してください。

Details

360 360 

361Claude Desktop のみを実行するマシンはそれを必要とします。Claude Desktop は埋め込みセッションにモデルリストと無効化されたツールリストを適用しますが、出力許可リストは親設定としてのみそれらに到達します。`WebFetch` ドメインルールとサンドボックスネットワークルールの形式です。オプトインなしでは、これらのセッションは出力制限なしで実行され、何も警告しません。ゲートウェイはポリシーが許可しないモデルの推論リクエストを引き続き拒否します。361Claude Desktop のみを実行するマシンはそれを必要とします。Claude Desktop は埋め込みセッションにモデルリストと無効化されたツールリストを適用しますが、出力許可リストは親設定としてのみそれらに到達します。`WebFetch` ドメインルールとサンドボックスネットワークルールの形式です。オプトインなしでは、これらのセッションは出力制限なしで実行され、何も警告しません。ゲートウェイはポリシーが許可しないモデルの推論リクエストを引き続き拒否します。

362 362 

363プラグインマーケットプレイス許可リストも埋め込みセッションにのみ親設定として到達します。Claude Desktop の管理設定でユーザーが追加したプラグインマーケットプレイスをオフにすると、Claude Desktop 2.16120.0 以降は組織がプロビジョニングしなかったマーケットプレイスを非表示にし、それらからのインストールを拒否します。埋め込みセッションがそれらのマーケットプレイスから既にインストールされているプラグインの読み込みを停止するために、親設定として `strictKnownMarketplaces` リストを送信します。オプトインなしでは、Claude Code はそのリストを無視し、それらのプラグインは読み込み続けます。

364 

363`/login` を通じてサインインする開発者のマシンはそれを必要としません。各 Claude Code セッションはゲートウェイからポリシーをフェッチします。365`/login` を通じてサインインする開発者のマシンはそれを必要としません。各 Claude Code セッションはゲートウェイからポリシーをフェッチします。

364 366 

365[`policyHelper`](/docs/ja/settings-reference#policyhelper)が管理設定を提供するフリートはそれを使用できません。Claude Code はそれらのフリートで親設定をマージしません。ヘルパーの出力からのみ管理設定を読み取るためです。367[`policyHelper`](/docs/ja/settings-reference#policyhelper)が管理設定を提供するフリートはそれを使用できません。Claude Code はそれらのフリートで親設定をマージしません。ヘルパーの出力からのみ管理設定を読み取るためです。


453* **`forceLoginOrgUUID`**:最優先の管理ソースが組織 UUID を設定しない場合、Claude Code は親が提供した値を尊重します。ゲートウェイサインインはこのキーをチェックしません。最優先の管理ソースの組織 UUID は親の値をブロックし、Claude Code が強制するものです。455* **`forceLoginOrgUUID`**:最優先の管理ソースが組織 UUID を設定しない場合、Claude Code は親が提供した値を尊重します。ゲートウェイサインインはこのキーをチェックしません。最優先の管理ソースの組織 UUID は親の値をブロックし、Claude Code が強制するものです。

454* **`allowedMcpServers`**:最優先の管理ソースが設定しない場合、Claude Code は親が提供した許可リストを尊重します。`allowManagedMcpServersOnly` はそれをブロックしません。ロックは勝者の許可リストを管理値として強制するため、最優先の管理ソースが設定しない場合は親が提供した許可リストを含みます。最優先の管理ソースのリストは親のリストをブロックし、Claude Code が強制するリストです。ロックの隣にそこに `allowedMcpServers` を設定します。v2.1.223 より前では、任意の管理ソースのいずれかのキーの値は親のリストをブロックしました。456* **`allowedMcpServers`**:最優先の管理ソースが設定しない場合、Claude Code は親が提供した許可リストを尊重します。`allowManagedMcpServersOnly` はそれをブロックしません。ロックは勝者の許可リストを管理値として強制するため、最優先の管理ソースが設定しない場合は親が提供した許可リストを含みます。最優先の管理ソースのリストは親のリストをブロックし、Claude Code が強制するリストです。ロックの隣にそこに `allowedMcpServers` を設定します。v2.1.223 より前では、任意の管理ソースのいずれかのキーの値は親のリストをブロックしました。

455* **`availableModels`**:勝者の管理ソースが設定しない場合、Claude Code は親が提供したモデルリストを尊重します。フリートがモデルを制限する場合、勝者ソースに `availableModels` を設定します。457* **`availableModels`**:勝者の管理ソースが設定しない場合、Claude Code は親が提供したモデルリストを尊重します。フリートがモデルを制限する場合、勝者ソースに `availableModels` を設定します。

456* **`strictKnownMarketplaces`**:勝者の管理ソースが設定しない場合、Claude Code は親が提供したプラグインマーケットプレイス許可リストを尊重します。フリートがマーケットプレイスを制限する場合、勝者ソースに `strictKnownMarketplaces` を設定します。Claude Code v2.1.282 以降が必要です。458* **`strictKnownMarketplaces`**:勝者の管理ソースが設定しない場合、Claude Code は親が提供したプラグインマーケットプレイス許可リストを尊重します。Claude Desktop 2.16120.0 以降は、その管理設定でユーザーが追加したプラグインマーケットプレイスをオフにするときに 1 つを送信します。フリートがマーケットプレイスを制限する場合、勝者ソースに `strictKnownMarketplaces` を設定します。Claude Code v2.1.282 以降が必要です。

457* **`blockedMarketplaces`**:親が提供したマーケットプレイスブロックリストは通過し、管理ソースが設定するブロックリストに追加されます。ブロックリストはさらに制限することのみができるためです。Claude Code v2.1.282 以降が必要です。459* **`blockedMarketplaces`**:親が提供したマーケットプレイスブロックリストは通過し、管理ソースが設定するブロックリストに追加されます。ブロックリストはさらに制限することのみができるためです。Claude Code v2.1.282 以降が必要です。

458* **`strictPluginOnlyCustomization`**:このキーはロックに関係なくフィルターを通過し、Claude Code が開発者独自のカスタマイズ(保護フックを含む)を無視するようにします。ロックはそれをブロックしません。460* **`strictPluginOnlyCustomization`**:このキーはロックに関係なくフィルターを通過し、Claude Code が開発者独自のカスタマイズ(保護フックを含む)を無視するようにします。ロックはそれをブロックしません。

459 461 

Details

303| - | - | - |303| - | - | - |

304| 推論(プロンプト、完了) | CLI → ゲートウェイ → 上流 | Anthropic API が設定された上流の場合のみ |304| 推論(プロンプト、完了) | CLI → ゲートウェイ → 上流 | Anthropic API が設定された上流の場合のみ |

305| テレメトリ(OTLP メトリクス、プラス [オプトイン ログとトレース](/docs/ja/claude-apps-gateway-config#telemetry)) | CLI → ゲートウェイ → コレクター | なし |305| テレメトリ(OTLP メトリクス、プラス [オプトイン ログとトレース](/docs/ja/claude-apps-gateway-config#telemetry)) | CLI → ゲートウェイ → コレクター | なし |

306| アイデンティティ(メール、グループ、sub) | IdP → ゲートウェイ → JWT → CLI。CLI はそれを OTLP エクスポートにスタンプします。[`forward_user_identity`](/docs/ja/claude-apps-gateway-config#per-user-identity-headers-for-a-proxy-you-run) をオンにすると、ゲートウェイは開発者のメールと IdP サブジェクトをヘッダーとしてプロキシに送信します | なし |306| アイデンティティ(メール、グループ、sub) | IdP → ゲートウェイ → CLI。CLI はそれを OTLP エクスポートにスタンプします。[`forward_user_identity`](/docs/ja/claude-apps-gateway-config#per-user-identity-headers-for-a-proxy-you-run) をオンにすると、ゲートウェイは開発者のメールと IdP サブジェクトをヘッダーとしてプロキシに送信します | なし |

307| 管理設定 | ゲートウェイ YAML → CLI | なし |307| 管理設定 | ゲートウェイ YAML → CLI | なし |

308| 監査ログ | ゲートウェイ stderr → アグリゲーター | なし |308| 監査ログ | ゲートウェイ stderr → アグリゲーター | なし |

309 309 

Details

512 テレメトリ512 テレメトリ

513</h2>513</h2>

514 514 

515ゲートウェイは、マシンごとの OTEL 設定なしで開発者ごとの使用メトリクスを提供します。Claude Code は OpenTelemetry(OTLP)メトリクス、ログ、およびオプトインのトレースを発行します。[使用状況の監視](/docs/ja/monitoring-usage)は CLI が報告するすべてをカバーしています。ゲートウェイセッションでは、CLI は各エクスポートに認証された IdP ID 属性 `user.id`、`user.email`、および `user.groups` でスタンプを付けるため、使用状況は `OTEL_RESOURCE_ATTRIBUTES` 配管なしで開発者ごとにロールアップされます。515ゲートウェイは、マシンごとの OTEL 設定なしで、開発者ごとの使用状況メトリクスを提供します。Claude Code は OpenTelemetry(OTLP)メトリクス、ログ、およびオプトイン トレースを出力します。[使用状況の監視](/docs/ja/monitoring-usage)では、CLI が報告するすべての内容をカバーしています。`/login` を通じてサインインしたセッションでは、CLI は各エクスポートに認証された IdP ID 属性 `user.id`、`user.email`、および `user.groups` をスタンプし、使用状況は開発者ごとにロールアップされます。

516 516 

517ゲートウェイ自体は認証された OTLP リレーです。[`telemetry.forward_to`](/docs/ja/claude-apps-gateway-config#telemetry) を `listen.public_url` と一緒に設定し、OTEL エクスポーター設定をすべての接続されたクライアントにプッシュし、OTLP トラフィックを逐語的にリストするすべての宛先に転送します。各宛先はメトリクス、ログ、およびトレースを独立して選択し、デフォルトはメトリクスのみです。[`telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)を参照してください。シグナルごとのフィールドとそれらの感度トレードオフについて。ゲートウェイはバッファ、集約、またはテレメトリを保存しないため、データが到達する場所は完全にコレクターのエクスポーター設定です。517ゲートウェイ自体は認証された OTLP リレーです。[`telemetry.forward_to`](/docs/ja/claude-apps-gateway-config#telemetry) を `listen.public_url` と一緒に設定すると、OTEL エクスポーター設定がすべての接続クライアントにプッシュされ、OTLP トラフィックが指定した各宛先に逐語的に転送されます。各宛先はメトリクス、ログ、およびトレースに独立してオプトインでき、デフォルトはメトリクスのみです。[`telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)で、シグナルごとのフィールドとそれらの感度トレードオフを参照してください。ゲートウェイはテレメトリをバッファリング、集約、または保存しないため、データが到達する場所はコレクターのエクスポーター設定に完全に依存します。

518 518 

519クライアントテレメトリはデフォルトでオフです。`telemetry.forward_to` を設定することは、接続された開発者のためにそれをオンにするものです。各インタラクティブクライアントは、[設定リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)で説明されているように、プッシュされた設定の 1 回限りのセキュリティ承認ダイアログを表示します。AWS では、各シグナルは次のように宛先にマップされます。519クライアント テレメトリはデフォルトでオフです。`telemetry.forward_to` を設定することで、接続された開発者に対してオンになり、各インタラクティブ クライアントはプッシュされた設定に対するセキュリティ承認ダイアログを表示します。詳細は[設定リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)に記載されています。AWS では、各シグナルは次のように宛先にマップされます。

520 520 

521<h3 id="client-metrics-logs-and-traces">521<h3 id="client-metrics-logs-and-traces">

522 クライアントメトリクス、ログ、およびトレース522 クライアント メトリクス、ログ、およびトレース

523</h3>523</h3>

524 524 

525`telemetry.forward_to` を OpenTelemetry コレクター([AWS Distro for OpenTelemetry(ADOT)コレクター](https://aws-otel.github.io/)など)に指し、Amazon CloudWatch、Amazon Managed Service for Prometheus、または任意の OTLP バックエンドにエクスポートします。525`telemetry.forward_to` を OpenTelemetry コレクター([AWS Distro for OpenTelemetry(ADOT)コレクター](https://aws-otel.github.io/)など)に指定し、そこから Amazon CloudWatch、Amazon Managed Service for Prometheus、または任意の OTLP バックエンドにエクスポートします。

526 526 

527`https://` 経由で到達可能な独自の内部サービスとしてコレクターを実行します。ゲートウェイはループバック URL に対してのみプレーンテキスト `http://` を受け入れ、その場合でも [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)はデフォルトで送信時にループバック接続をブロックします。`http://localhost:4318` のサイドカーコレクターは設定検証を渡しますが、トラフィックを受け取りません。エクスポートは `ECONNREFUSED_SSRF` として失敗します。ゲートウェイログで、`CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` がゲートウェイの環境に設定されていない限り。その変数はすべてのオペレーター設定 URL のループバックブロックを緩和し、テレメトリのみではなく、ネットワークが他の方法でロックダウンされているタスクのサイドカープラスフラグセットアップを予約してください。内部サービスパターンを優先します。527コレクターを `https://` で到達可能な独自の内部サービスとして実行します。[`telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)では、ループバック例外と `CLAUDE_GATEWAY_ALLOW_LOOPBACK` をカバーしています。

528 528 

529<h3 id="gateway-logs">529<h3 id="gateway-logs">

530 ゲートウェイログ530 ゲートウェイ ログ

531</h3>531</h3>

532 532 

533ECS Fargate では、追加のセットアップはありません。`awslogs` ドライバーはゲートウェイの stderr を配信します。これは監査イベントと運用ログを運びます。`/ecs/claude-gateway` ロググループに上記で作成されました。EKS では、ポッドログはデフォルトで CloudWatch に到達しないため、監査証跡は失われます。ログ収集をインストールするまで:コンテナログキャプチャが有効な Amazon CloudWatch Observability アドオン、または Fluent Bit DaemonSet。どちらのトラックでも、CloudWatch Logs Insights でログをクエリし、メトリクスフィルターからアラームを駆動します。533ECS Fargate では、追加のセットアップは不要です。`awslogs` ドライバーがゲートウェイの stderr(監査イベントと運用ログを含む)を上記で作成した `/ecs/claude-gateway` ログ グループに配信します。EKS では、ポッド ログはデフォルトで CloudWatch に到達しないため、ログ収集をインストールするまで監査証跡が失われます。Amazon CloudWatch Observability アドオン(コンテナ ログ キャプチャ有効)または Fluent Bit DaemonSet をインストールしてください。どちらの場合でも、CloudWatch Logs Insights でログをクエリし、メトリック フィルターからアラームを駆動します。

534 534 

535<h3 id="container-metrics">535<h3 id="container-metrics">

536 コンテナメトリクス536 コンテナ メトリクス

537</h3>537</h3>

538 538 

539`aws ecs update-cluster-settings --cluster claude-gateway --settings name=containerInsights,value=enabled` でクラスタで Container Insights を有効にして、タスクごとの CPU、メモリ、およびネットワーク。EKS では、Amazon CloudWatch Observability アドオンをインストールします。539`aws ecs update-cluster-settings --cluster claude-gateway --settings name=containerInsights,value=enabled` でクラスターの Container Insights を有効にして、タスクごとの CPU、メモリ、およびネットワークを取得します。EKS では、Amazon CloudWatch Observability アドオンをインストールしてください。

540 540 

541<h3 id="spend">541<h3 id="spend">

542 支出542 支出

543</h3>543</h3>

544 544 

545テレメトリは事後に使用状況を表示します。[支出制限](/docs/ja/claude-apps-gateway-spend-limits)は、共有アップストリーム認証情報の上にゲートウェイのライブ開発者ごとのビューと実装です。545テレメトリは使用状況を事後的に表示します。[支出制限](/docs/ja/claude-apps-gateway-spend-limits)は、共有アップストリーム認証情報の上に、ゲートウェイのライブな開発者ごとのビューと実装です。

546 546 

547<h2 id="next-steps">547<h2 id="next-steps">

548 次のステップ548 次のステップ

Details

1569| `feedback/drafts/` | キューに入った [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)。`/feedback` でのレビューを待機中です。`cleanupPeriodDays` または 30 日のいずれか短い方の後にスイープされます。キューが 10 ドラフトの上限に達すると、Claude Code は最も古いドラフトを削除して空き容量を作ります |1569| `feedback/drafts/` | キューに入った [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)。`/feedback` でのレビューを待機中です。`cleanupPeriodDays` または 30 日のいずれか短い方の後にスイープされます。キューが 10 ドラフトの上限に達すると、Claude Code は最も古いドラフトを削除して空き容量を作ります |

1570| `usage-data/` | `report.html` と [`/insights`](/docs/ja/costs#analyze-your-usage-patterns)で書き込まれたタイムスタンプ付きレポートコピー。それらを構築するために使用されるキャッシュされたセッションごとの分析データ |1570| `usage-data/` | `report.html` と [`/insights`](/docs/ja/costs#analyze-your-usage-patterns)で書き込まれたタイムスタンプ付きレポートコピー。それらを構築するために使用されるキャッシュされたセッションごとの分析データ |

1571| `skills/.trash/`、`plugins/.trash/` | [スキル](/docs/ja/skills#how-synced-skills-behave)と [プラグイン](/docs/ja/plugins/loading#synced-plugins)。claude.ai 同期で削除されたもの。例えば、claude.ai でオフにした後、または同期を停止した後。ファイルはここに残るため、スイープが削除するまで復元できます |1571| `skills/.trash/`、`plugins/.trash/` | [スキル](/docs/ja/skills#how-synced-skills-behave)と [プラグイン](/docs/ja/plugins/loading#synced-plugins)。claude.ai 同期で削除されたもの。例えば、claude.ai でオフにした後、または同期を停止した後。ファイルはここに残るため、スイープが削除するまで復元できます |

1572| `plugins/installed_plugins.set-aside.<date>.<hash>.json`、`plugins/installed_plugins.unreadable.<date>.<hash>.kept` | 日付付きコピー。Claude Code が [`installed_plugins.json`](/docs/ja/plugins/loading#find-plugins-on-disk) を書き直す前に作成します。削除したインストールレコード、および読み込めなかったファイルの内容 |

1572| `todos/`、`statsig/`、`logs/` | 古いバージョンのレガシーディレクトリ。現在は書き込まれていません。スイープはその内容を削除してから、空のディレクトリを削除します |1573| `todos/`、`statsig/`、`logs/` | 古いバージョンのレガシーディレクトリ。現在は書き込まれていません。スイープはその内容を削除してから、空のディレクトリを削除します |

1573 1574 

1574`sessions/` のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います:1575`sessions/` のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います:


1715| `~/.claude/policy-limits.json` | なし。自動的に更新されます |1716| `~/.claude/policy-limits.json` | なし。自動的に更新されます |

1716| `~/.claude/tasks/` | 再開されたセッションが取得するタスクリスト |1717| `~/.claude/tasks/` | 再開されたセッションが取得するタスクリスト |

1717| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した[同期されたスキル](/docs/ja/skills#how-synced-skills-behave)と[同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)を復元する機会 |1718| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した[同期されたスキル](/docs/ja/skills#how-synced-skills-behave)と[同期されたプラグイン](/docs/ja/plugins/loading#synced-plugins)を復元する機会 |

1719| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`、`~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Claude Code が削除したプラグインインストールレコード、または読み込めなかったファイルのコピー。何もそれらを読み込み直しません |

1718| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザーに見える何もなし |1720| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザーに見える何もなし |

1719| `~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/` | なし。現在のバージョンで書き込まれていないレガシーディレクトリ |1721| `~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/` | なし。現在のバージョンで書き込まれていないレガシーディレクトリ |

1720 1722 

claude-projects.md +26 −12

Details

4 4 

5# Claude がプロジェクトで進行中の作業を調整する5# Claude がプロジェクトで進行中の作業を調整する

6 6 

7> 関連する作業の本体を 1 つの会話で Claude に提供し、リポジトリ、指示、メモリを共有する並列クラウドセッションを調整させます。7> 関連する作業のストリームを 1 つの会話で Claude に提供し、リポジトリ、指示、メモリを共有する並列クラウドセッションを調整させます。

8 8 

9<Note>9<Note>

10 Projects は Pro および Max プランで公開ベータ版であり、段階的にロールアウト中です。[クラウドセッション](/docs/ja/claude-code-on-the-web) を使用したアカウントで、claude.ai チャットまたは Cowork に既存のプロジェクトがないアカウントから始まり、段階的にロールアウト中です。Team または Enterprise プランではまだ利用できません。[claude.ai/code](https://claude.ai/code) のサイドバーまたは [デスクトップアプリ](/docs/ja/desktop) の Code タブに **Projects** が表示されない場合、ロールアウトがまだアカウントに到達していません。その場合は [ウェイトリストに参加](https://claude.com/form/projects) できます。[エージェントを並列実行する](/docs/ja/agents) で、その間に利用可能なオプションを確認してください。10 Projects は Pro および Max プランで公開ベータ版であり、段階的にロールアウト中です。[クラウドセッション](/docs/ja/claude-code-on-the-web) を使用したアカウントで、claude.ai チャットまたは Cowork に既存のプロジェクトがないアカウントから始まり、段階的にロールアウト中です。Team または Enterprise プランではまだ利用できません。[claude.ai/code](https://claude.ai/code) のサイドバーまたは [デスクトップアプリ](/docs/ja/desktop) の Code タブに **Projects** が表示されない場合、ロールアウトがまだアカウントに到達していません。その場合は [ウェイトリストに参加](https://claude.com/form/projects) できます。[エージェントを並列実行する](/docs/ja/agents) で、その間に利用可能なオプションを確認してください。


80プロジェクトは [claude.ai/code](https://claude.ai/code)、デスクトップアプリの Code タブ、または [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) と [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) 向けの Claude モバイルアプリで作成および使用します。ブラウザとデスクトップアプリでは、プロジェクトを開始する 2 つの方法があります。80プロジェクトは [claude.ai/code](https://claude.ai/code)、デスクトップアプリの Code タブ、または [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) と [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) 向けの Claude モバイルアプリで作成および使用します。ブラウザとデスクトップアプリでは、プロジェクトを開始する 2 つの方法があります。

81 81 

82* **ゼロから開始**:Claude に実行させたい作業の流れが決まっている場合は、**New project** ダイアログを開いて名前を付けます。[ゼロからプロジェクトを開始する](#start-a-new-project-from-scratch)でダイアログの手順を説明しています。82* **ゼロから開始**:Claude に実行させたい作業の流れが決まっている場合は、**New project** ダイアログを開いて名前を付けます。[ゼロからプロジェクトを開始する](#start-a-new-project-from-scratch)でダイアログの手順を説明しています。

83* **既に作業を行っているクラウドセッションから開始**:そのセッションのメニューから **Continue as a project** を選択すると、Claude がセッションで行っていた内容からプロジェクトのセットアップを提案します。[既存のクラウドセッションから開始する](#start-from-an-existing-cloud-session)を参照してください。83* **既に作業を行っているクラウドセッションから開始**:そのセッションのメニューから **Continue as project** を選択すると、Claude がセッションで行っていた内容からプロジェクトのセットアップを提案します。[既存のクラウドセッションから開始する](#start-from-an-existing-cloud-session)を参照してください。

84 84 

85どちらの方法でも、まず [前提条件を確認](#check-the-prerequisites)してください。85どちらの方法でも、まず [前提条件を確認](#check-the-prerequisites)してください。

86 86 


131 既存のクラウドセッションから開始する131 既存のクラウドセッションから開始する

132</h3>132</h3>

133 133 

134既にプロジェクトに属する作業を行っているクラウドセッションがある場合は、サイドバーのセッションのメニューを開いて **Continue as a project** または **Move to project** を選択します。134既にプロジェクトに属する作業を行っているクラウドセッションがある場合は、サイドバーのセッションのメニューを開いて **Continue as project** または **Move to project** を選択します。

135 135 

136* **Continue as a project** はセッションにちなんで名付けられた新しいプロジェクトを作成して開きます。Claude はセッションを読み取り、確認するための **Setup recommendations** を会話に投稿します。元のセッションはセッションリストに残り、ターンの途中だった場合は実行を続けるため、両方が同時に作業するのを望まない場合は自分で停止してください。クラウドセッションのメッセージボックスの上に表示される可能性がある **Set up project** バナーを使用する場合、結果は同じですが、プロジェクトが開くとセッションの実行中のターンが停止します。136* **Continue as project** はセッションにちなんで名付けられた新しいプロジェクトを作成して開きます。Claude はセッションを読み取り、確認するための **Setup recommendations** を会話に投稿します。元のセッションはセッションリストに残り、ターンの途中だった場合は実行を続けるため、両方が同時に作業するのを望まない場合は自分で停止してください。クラウドセッションのメッセージボックスの上に表示される可能性がある **Set up project** バナーを使用する場合、結果は同じですが、プロジェクトが開くとセッションの実行中のターンが停止します。

137* **Move to project** はセッションの作業を既存のプロジェクトに持ち込みます。そのプロジェクトの会話にメッセージを投稿し、Claude にセッションを読み取って中断したところから再開するよう求め、新しい作業はプロジェクト独自のスレッドで続行されます。元のセッションはセッションリストに変更されずに残ります。137* **Move to project** はセッションの作業を既存のプロジェクトに持ち込みます。そのプロジェクトの会話にメッセージを投稿し、Claude にセッションを読み取って中断したところから再開するよう求め、新しい作業はプロジェクト独自のスレッドで続行されます。元のセッションはセッションリストに変更されずに残ります。

138 138 

139ローカルセッションにはこれらのオプションがありません。プロジェクトでその作業を続行するには、プロジェクト会話で作業を説明するか、ブランチをプッシュし、そのリポジトリをプロジェクトに追加して、タスクでブランチに名前を付けます。

140 

139<h3 id="set-up-github-access">141<h3 id="set-up-github-access">

140 GitHub アクセスをセットアップする142 GitHub アクセスをセットアップする

141</h3>143</h3>


275 277 

276スレッドはスレッドのモデルがサポートしている場合、[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で実行されるため、ほとんどのツール呼び出しはあなたに尋ねずに実行されます。スレッドがあなたの承認を必要とする場合、プロンプトはそのスレッド内にあり、スレッドはあなたがそこで答えるまで待機します。プロジェクト会話で Claude に先に進むように伝えることはそれに到達しません。278スレッドはスレッドのモデルがサポートしている場合、[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で実行されるため、ほとんどのツール呼び出しはあなたに尋ねずに実行されます。スレッドがあなたの承認を必要とする場合、プロンプトはそのスレッド内にあり、スレッドはあなたがそこで答えるまで待機します。プロジェクト会話で Claude に先に進むように伝えることはそれに到達しません。

277 279 

278各承認はそのプロンプト、またはより広いオプションを選択した場合はそのスレッドの残りをカバーします。すべてのスレッドが特定のコマンドを尋ねずに実行できるようにするか、いくつかをブロックするには、リポジトリの`.claude/settings.json`に[権限ルール](/docs/ja/permissions)を追加します。クラウドスレッドはそれらを 1 つのリポジトリを持つプロジェクトでのみ適用します。[スレッドがリポジトリから何を取得するか](#what-threads-pick-up-from-your-repositories)を参照してください。280各承認はそのプロンプト、またはより広いオプションを選択した場合はそのスレッドの残りをカバーします。すべてのスレッドが特定のコマンドを尋ねずに実行できるようにするか、いくつかをブロックするには、リポジトリの`.claude/settings.json`に[権限ルール](/docs/ja/permissions)を追加します。クラウドスレッドはそれらを 1 つのリポジトリを持つプロジェクトでのみ適用します。[スレッドがリポジトリから何を取得するか](#what-threads-pick-up-from-your-repositories)を参照してください。複数のリポジトリを持つプロジェクトでは、リポジトリの権限ルールはクラウドスレッドに到達しないため、自動モードとスレッド内で与える承認に依存します。

279 281 

280<h3 id="run-a-thread-on-your-own-computer">282<h3 id="run-a-thread-on-your-own-computer">

281 コンピューターでスレッドを実行する283 コンピューターでスレッドを実行する


283 285 

284タスクがローカルデータベース、デバイスエミュレーター、または VPN の背後にある API など、コンピューターのみが持つものを必要とする場合、Claude にクラウドではなくコンピューターでそのタスクのスレッドを実行するよう求めます。プロジェクト会話で要求すると、スレッドはマシン上のフォルダー内の Claude Code セッションであり、[Remote Control](/docs/ja/remote-control)を通じて接続されます。プロジェクトの他のスレッドはクラウドで実行し続けます。クラウドスレッドと比較して、コンピューター上のスレッドは以下のようになります。286タスクがローカルデータベース、デバイスエミュレーター、または VPN の背後にある API など、コンピューターのみが持つものを必要とする場合、Claude にクラウドではなくコンピューターでそのタスクのスレッドを実行するよう求めます。プロジェクト会話で要求すると、スレッドはマシン上のフォルダー内の Claude Code セッションであり、[Remote Control](/docs/ja/remote-control)を通じて接続されます。プロジェクトの他のスレッドはクラウドで実行し続けます。クラウドスレッドと比較して、コンピューター上のスレッドは以下のようになります。

285 287 

286* そのマシン上のファイル、ツール、MCP サーバー、および Claude Code 設定で機能し、プロジェクトのクラウド環境ではなく288* そのマシン上のファイル、ツール、MCP サーバー、および Claude Code 設定で機能し、プロジェクトのクラウド環境ではなく、hooks と権限ルールを含む

287* プロジェクトの指示で開始しますが、メモリファイルが読み込まれていない状態で289* プロジェクトの指示で開始しますが、メモリファイルが読み込まれていない状態で

288* そのコンピューターが起動していて Remote Control がオンになっている間のみ実行290* そのコンピューターが起動していて Remote Control がオンになっている間のみ実行

289 291 


292 タスクが必要とするフォルダーを持つコンピューター上で、次の 2 つの方法のいずれかで Remote Control を通じて利用可能にします。どちらも、そのコンピューター上の Claude Code v2.1.280 以降が必要です。294 タスクが必要とするフォルダーを持つコンピューター上で、次の 2 つの方法のいずれかで Remote Control を通じて利用可能にします。どちらも、そのコンピューター上の Claude Code v2.1.280 以降が必要です。

293 295 

294 * **Claude デスクトップアプリで**:**設定 > Claude Code**を開き、**このコンピューターを電話と claude.ai から使用する**をオンにし、そのスイッチの下のリストにフォルダーを追加します。アプリが開いている間、スレッドはこのコンピューター上で実行できます。296 * **Claude デスクトップアプリで**:**設定 > Claude Code**を開き、**このコンピューターを電話と claude.ai から使用する**をオンにし、そのスイッチの下のリストにフォルダーを追加します。アプリが開いている間、スレッドはこのコンピューター上で実行できます。

295 * **ターミナルで**:フォルダーで`claude remote-control`を実行し、実行したままにします。297 * **ターミナルで**:フォルダーで`claude remote-control`を実行し、実行したままにします。Git リポジトリでは、`--spawn worktree`を追加して、各スレッドにフォルダー自体ではなく独自の[worktree](/docs/ja/worktrees)を与えます。

296 </Step>298 </Step>

297 299 

298 <Step title="「ローカルで作業」でタスクを要求する">300 <Step title="「ローカルで作業」でタスクを要求する">


300 </Step>302 </Step>

301 303 

302 <Step title="カードで許可する">304 <Step title="カードで許可する">

303 Claude は**デバイス上のフォルダーで作業することを Claude に許可する**カードで応答します。複数のフォルダーを接続した場合はフォルダーを選択します。次に**1 回許可する**をクリックします。305 Claude は**デバイス上のフォルダーで作業することを Claude に許可する**カードで応答します。複数のフォルダーを接続した場合はフォルダーを選択します。1 つのフォルダーで同時に 2 つのスレッドが作業している場合、互いの変更を上書きする可能性があるため、フォルダーが Git リポジトリの場合、フォルダーのオプションで**Worktree**をオンにして、このスレッドに独自の worktree を与えることができます。次に**1 回許可する**をクリックします。

304 </Step>306 </Step>

305</Steps>307</Steps>

306 308 


320| :- | :- | :- |322| :- | :- | :- |

321| プロジェクトメモリ | Claude がプロジェクトについて保持するメモ(要件、決定、落とし穴など)をファイルとして保存します。すべてのクラウドスレッドは開始時にインデックスファイル `MEMORY.md` を読み込み、必要に応じて他のファイルを開きます | プロジェクト会話またはクラウドスレッド内で Claude に要件、決定、落とし穴を記憶するよう依頼するか、忘れるよう依頼します。**プロジェクト設定 > メモリ** でファイルを読み込み、編集、削除します |323| プロジェクトメモリ | Claude がプロジェクトについて保持するメモ(要件、決定、落とし穴など)をファイルとして保存します。すべてのクラウドスレッドは開始時にインデックスファイル `MEMORY.md` を読み込み、必要に応じて他のファイルを開きます | プロジェクト会話またはクラウドスレッド内で Claude に要件、決定、落とし穴を記憶するよう依頼するか、忘れるよう依頼します。**プロジェクト設定 > メモリ** でファイルを読み込み、編集、削除します |

322| プロジェクト指示 | 各新しいスレッドおよびプロジェクト会話内の Claude に送信されるテキスト(最大 16,000 文字)。[プロジェクト指示を書く](#write-project-instructions) に記載内容を説明しています | **プロジェクト設定 > メモリ > プロジェクト指示**、または会話内で Claude に指示の変更を依頼します |324| プロジェクト指示 | 各新しいスレッドおよびプロジェクト会話内の Claude に送信されるテキスト(最大 16,000 文字)。[プロジェクト指示を書く](#write-project-instructions) に記載内容を説明しています | **プロジェクト設定 > メモリ > プロジェクト指示**、または会話内で Claude に指示の変更を依頼します |

323| リポジトリ、ファイル、環境 | すべてのクラウドスレッドがクローンするリポジトリ、すべてのクラウドスレッドが `/mnt/project-files` の下で読み取ることができるフォルダとファイル、およびクラウドスレッドが実行されるクラウド環境 | **プロジェクト設定 > 環境** のリポジトリと環境、または会話内で Claude にリポジトリをプロジェクトに追加するよう依頼します。**概要** の **ライブラリ** タブの **追加** からファイルとフォルダを追加します |325| リポジトリ、ファイル、環境 | すべてのクラウドスレッドがクローンするリポジトリ、すべてのクラウドスレッドが `/mnt/project-files` の下で読み取ることができるフォルダとファイル、およびクラウドスレッドが実行されるクラウド環境 | **プロジェクト設定 > 環境** のリポジトリと環境、または会話内で Claude にリポジトリをプロジェクトに追加するよう依頼します。[ファイルとフォルダを追加](#add-files-and-folders) から **概要** の **ライブラリ** タブの **追加** を使用します |

324 326 

325**プロジェクト設定 > メモリ** は、これらのファイルを **自動メモリ** の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](/docs/ja/memory) とは別です。両方とも `MEMORY.md` インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の `CLAUDE.md` ファイルとは別です。各クラウドスレッドは開始時にクローンからこれらの `CLAUDE.md` ファイルを読み込むため、リポジトリに関する指示をその `CLAUDE.md` に、プロジェクトに関するメモをプロジェクトメモリに記載してください。327**プロジェクト設定 > メモリ** は、これらのファイルを **自動メモリ** の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](/docs/ja/memory) とは別です。両方とも `MEMORY.md` インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の `CLAUDE.md` ファイルとは別です。各クラウドスレッドは開始時にクローンからこれらの `CLAUDE.md` ファイルを読み込むため、リポジトリに関する指示をその `CLAUDE.md` に、プロジェクトに関するメモをプロジェクトメモリに記載してください。

326 328 


364 366 

365サーバー、ウェブ、モバイル、デスクトップコードを持つ機能など、多くのリポジトリにまたがるプロジェクトの場合、ほぼすべてのタスクが触れる 1 つまたは 2 つのリポジトリを追加し、[プロジェクト指示](#write-project-instructions) で他のリポジトリに名前を付けて、Claude が残りのコードがどこにあるかを知るようにします。クラウドスレッドは小さく開始し、それらが必要なタスクに対してのみ他のリポジトリを取得します。367サーバー、ウェブ、モバイル、デスクトップコードを持つ機能など、多くのリポジトリにまたがるプロジェクトの場合、ほぼすべてのタスクが触れる 1 つまたは 2 つのリポジトリを追加し、[プロジェクト指示](#write-project-instructions) で他のリポジトリに名前を付けて、Claude が残りのコードがどこにあるかを知るようにします。クラウドスレッドは小さく開始し、それらが必要なタスクに対してのみ他のリポジトリを取得します。

366 368 

369<h3 id="add-files-and-folders">

370 ファイルとフォルダを追加する

371</h3>

372 

373**新規プロジェクト** ダイアログの **コンテキスト** フィールド、または後で **概要** の **ライブラリ** タブの **追加** を使用して、スレッドに読み込ませたいファイルとフォルダを追加します。追加するものに適用される制限は以下の通りです:

374 

375* **ライブラリタブ**:1 回の選択で最大 100 ファイル、2 GB、単一ファイルは最大 480 MB。

376* **新規プロジェクトダイアログ**:30 MB を超えるファイルはスキップされるため、プロジェクト作成後に **ライブラリ** タブから大きなファイルを追加してください。

377* **フォルダ**:どちらの場所からフォルダを追加する場合でも、プロジェクトは最初の 100 ファイルまで 200 MB までのコピーを受け取ります。30 MB を超えるファイル、隠しファイル、`node_modules` は含まれません。プロジェクトは最大 10 個のフォルダと Google Drive フォルダを保持でき、単一ファイルはこの制限にカウントされません。

378* **アップロード後の変更**:アップロードはコピーであるため、その後コンピュータで行った変更は、ファイルを再度アップロードして既存の名前について **置換** を選択するまで、プロジェクトに到達しません。

379 

367<h3 id="what-threads-pick-up-from-your-repositories">380<h3 id="what-threads-pick-up-from-your-repositories">

368 スレッドがリポジトリから取得するもの381 スレッドがリポジトリから取得するもの

369</h3>382</h3>


472複数の Claude Code 機能により、複数のセッションを同時に実行できるため、並列で作業を実行することだけがプロジェクトの目的ではありません。プロジェクトでは、Claude があなたの代わりにセッションを開始して追跡し、各セッションは同じ指示から開始します。各隣接機能がプロジェクトにどのように接続するかは以下の通りです。485複数の Claude Code 機能により、複数のセッションを同時に実行できるため、並列で作業を実行することだけがプロジェクトの目的ではありません。プロジェクトでは、Claude があなたの代わりにセッションを開始して追跡し、各セッションは同じ指示から開始します。各隣接機能がプロジェクトにどのように接続するかは以下の通りです。

473 486 

474* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) は Team および Enterprise プランでチームの Slack チャネルに存在する Claude です。チャネル内の誰もが作業を割り当てることができ、チャネル内の全員がそれを見て操作でき、管理者がそのチャネル用に設定した接続を使用します。プロジェクトはあなただけのものです。作業を送信したり、スレッドを見たりするのはあなただけで、独自の GitHub アクセスとコネクタを使用し、Pro および Max で利用できます。[Claude Tag が Cowork および Claude Code とどのように異なるか](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code)に並べて比較があります。487* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) は Team および Enterprise プランでチームの Slack チャネルに存在する Claude です。チャネル内の誰もが作業を割り当てることができ、チャネル内の全員がそれを見て操作でき、管理者がそのチャネル用に設定した接続を使用します。プロジェクトはあなただけのものです。作業を送信したり、スレッドを見たりするのはあなただけで、独自の GitHub アクセスとコネクタを使用し、Pro および Max で利用できます。[Claude Tag が Cowork および Claude Code とどのように異なるか](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code)に並べて比較があります。

475* **Cloud sessions**: すべてのスレッドは [cloud session](/docs/ja/claude-code-on-the-web) です。ただし、Claude にマシン上で実行するよう要求する場合を除きます。どちらの場合でも、Claude があなたの代わりにそれを開始して追跡します。自分で開始した cloud session は、[**Continue as a project** または **Move to project**](#start-from-an-existing-cloud-session) を通じてプロジェクトになるか、プロジェクトにフィードすることができます。488* **Cloud sessions**: すべてのスレッドは [cloud session](/docs/ja/claude-code-on-the-web) です。ただし、Claude にマシン上で実行するよう要求する場合を除きます。どちらの場合でも、Claude があなたの代わりにそれを開始して追跡します。自分で開始した cloud session は、[**Continue as project** または **Move to project**](#start-from-an-existing-cloud-session) を通じてプロジェクトになるか、プロジェクトにフィードすることができます。

476* **Routines**: プロジェクトでスケジュール済みの作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その **Routines** タブに表示される [routine](/docs/ja/routines) を作成します。プロジェクト外で作成した Routines は独立して動作し続けます。489* **Routines**: プロジェクトでスケジュール済みの作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その **Routines** タブに表示される [routine](/docs/ja/routines) を作成します。プロジェクト外で作成した Routines は独立して動作し続けます。

477* **Remote Control**: [Remote Control](/docs/ja/remote-control) は claude.ai をマシン上で実行している Claude Code セッションに接続します。プロジェクトで Claude にコンピュータ上でスレッドを実行するよう要求すると、プロジェクトは [Remote Control を使用してそれを実行します](#run-a-thread-on-your-own-computer)。490* **Remote Control**: [Remote Control](/docs/ja/remote-control) は claude.ai をマシン上で実行している Claude Code セッションに接続します。プロジェクトで Claude にコンピュータ上でスレッドを実行するよう要求すると、プロジェクトは [Remote Control を使用してそれを実行します](#run-a-thread-on-your-own-computer)。

478* **Local sessions と agent view**: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトに追加できません。[Agent view](/docs/ja/agent-view) は複数のローカルセッションを並べて追跡するための画面であり、各セッションを自分で開始してタスクを割り当てます。491* **Local sessions と agent view**: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトに追加できません。[Agent view](/docs/ja/agent-view) は複数のローカルセッションを並べて追跡するための画面であり、各セッションを自分で開始してタスクを割り当てます。

479* **Worktrees**: [worktree](/docs/ja/worktrees) は各ローカルセッションにリポジトリの独自の作業コピーを提供するため、マシン上の並列セッションが互いに上書きしません。Cloud スレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。492* **Worktrees**: [worktree](/docs/ja/worktrees) は各ローカルセッションにリポジトリの独自の作業コピーを提供するため、マシン上の並列セッションが互いに上書きしません。Cloud スレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。

480* **Agent teams**: [agent team](/docs/ja/agent-teams) は、マシン上またはクラウドセッション内で単一のタスク用にチームメイトセッションを開始し、そのタスクで終了する 1 つのセッションです。493* **Agent teams**: [agent team](/docs/ja/agent-teams) は、マシン上またはクラウドセッション内で単一のタスク用にチームメイトセッションを開始し、そのタスクで終了する 1 つのセッションです。

494* **Subagents**: [subagent](/docs/ja/sub-agents) は 1 つのセッション内で実行され、独自のコンテキストウィンドウで副次的なタスクを実行し、そのセッションに概要を返します。プロジェクトのスレッドは Claude が開始し、プロジェクト会話に報告する完全なセッションであり、スレッドは独自の副次的なタスク用に subagents を使用することができます。

481* **Projects in claude.ai chat and Cowork**: [以前の Projects エクスペリエンス](https://support.claude.com/en/articles/9517075-what-are-projects)。これはスレッドやコーディネーターなしで会話と参照ファイルをグループ化します。これらのプロジェクトは、再設計されたエクスペリエンスがそれらに到達するまで、今日のように動作し続けます。495* **Projects in claude.ai chat and Cowork**: [以前の Projects エクスペリエンス](https://support.claude.com/en/articles/9517075-what-are-projects)。これはスレッドやコーディネーターなしで会話と参照ファイルをグループ化します。これらのプロジェクトは、再設計されたエクスペリエンスがそれらに到達するまで、今日のように動作し続けます。

482 496 

483[Run agents in parallel](/docs/ja/agents) はこれらのオプションを並べて比較します。497[Run agents in parallel](/docs/ja/agents) はこれらのオプションを並べて比較します。


486 制限事項500 制限事項

487</h2>501</h2>

488 502 

489* プロジェクトは claude.ai/code、デスクトップアプリ、Claude モバイルアプリで利用可能です。ターミナル CLI、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。CLI の [`claude project`](/docs/ja/cli-reference) コマンドはディレクトリの Claude Code ローカル状態を管理するもので、関連がありません。503* プロジェクトは claude.ai/code、デスクトップアプリ、Claude モバイルアプリで利用可能です。ターミナル CLI、VS Code 拡張機能、JetBrains プラグイン、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。CLI の [`claude project`](/docs/ja/cli-reference) コマンドはディレクトリの Claude Code ローカル状態を管理するもので、関連がありません。

490* プロジェクトスレッドは [クラウドセッション](/docs/ja/claude-code-on-the-web) です。または [Remote Control](/docs/ja/remote-control) を通じてお客様のマシン上のセッションです。どちらの場合も Anthropic がモデルプロバイダーです。[セキュリティ](/docs/ja/security) および [データ使用](/docs/ja/data-usage) はクラウドセッションがどのように分離され、何が保持されるかをカバーしています。また [接続とセキュリティ](/docs/ja/remote-control#connection-and-security) はお客様のマシン上のスレッドがどのように接続され、何が保存されるかをカバーしています。504* プロジェクトスレッドは [クラウドセッション](/docs/ja/claude-code-on-the-web) です。または [Remote Control](/docs/ja/remote-control) を通じてお客様のマシン上のセッションです。どちらの場合も Anthropic がモデルプロバイダーです。[セキュリティ](/docs/ja/security) および [データ使用](/docs/ja/data-usage) はクラウドセッションがどのように分離され、何が保持されるかをカバーしています。また [接続とセキュリティ](/docs/ja/remote-control#connection-and-security) はお客様のマシン上のスレッドがどのように接続され、何が保存されるかをカバーしています。

491* お客様のマシン上で自分で開始したセッションをプロジェクトに追加することはできません。プロジェクトがお客様のマシン上でスレッドを実行するには、[Remote Control を通じてお客様のマシン上でスレッドを実行](#run-a-thread-on-your-own-computer) し、そのセクションに必要なものが記載されています。505* お客様のマシン上で自分で開始したセッションをプロジェクトに追加することはできません。プロジェクトがお客様のマシン上でスレッドを実行するには、[Remote Control を通じてお客様のマシン上でスレッドを実行](#run-a-thread-on-your-own-computer) し、そのセクションに必要なものが記載されています。

492* クラウドスレッドのサンドボックスはターン間で一時停止し、スレッドが続くときに再開されます。サンドボックスを再開できない場合、スレッドは新しいクローンから続きます。コミットされていない変更は失われる可能性があります。長いタスクでは、Claude にコミットしてプログレス作業をプッシュするよう求めてください。506* クラウドスレッドのサンドボックスはターン間で一時停止し、スレッドが続くときに再開されます。サンドボックスを再開できない場合、スレッドは新しいクローンから続きます。コミットされていない変更は失われる可能性があります。長いタスクでは、Claude にコミットしてプログレス作業をプッシュするよう求めてください。

493* プロジェクトは 1 人のユーザーに属します。プロジェクトまたはそのスレッドを別のユーザーと共有することはできず、スレッドトランスクリプトは他のクラウドセッションが持つ共有オプションを持ちません。ベータ中、プロジェクトの組織レベルコントロールはありません。507* プロジェクトは 1 人のユーザーに属します。プロジェクトまたはそのスレッドを別のユーザーと共有することはできず、スレッドトランスクリプトは他のクラウドセッションが持つ共有オプションを持ちません。ベータ中、プロジェクトの組織レベルコントロールはありません。

494* スレッドはそれを開始した 1 つのプロジェクトに属します。スレッドを別のプロジェクトに移動またはコピーすることはできず、それを単独で移動することはできません。[**Move to project**](#start-from-an-existing-cloud-session) は別の方向のみです。クラウドセッションの作業をプロジェクトに持ち込みます。508* スレッドはそれを開始した 1 つのプロジェクトに属します。スレッドを別のプロジェクトに移動またはコピーすることはできず、それを単独で移動することはできません。[**プロジェクトに移動**](#start-from-an-existing-cloud-session) は別の方向のみです。クラウドセッションの作業をプロジェクトに持ち込みます。2 つのプロジェクトを 1 つにマージすることはできません。

495 509 

496<h2 id="troubleshooting">510<h2 id="troubleshooting">

497 トラブルシューティング511 トラブルシューティング

Details

6 6 

7> Claude Security プラグインをインストールして、Claude Code セッション内でコードベースの脆弱性をスキャンし、検出結果をレビューして適用できるパッチに変換します。7> Claude Security プラグインをインストールして、Claude Code セッション内でコードベースの脆弱性をスキャンし、検出結果をレビューして適用できるパッチに変換します。

8 8 

9Claude Security プラグインは、Claude Code セッション内でコードベースのマルチエージェント脆弱性スキャンを実行します。Claude エージェントのチームがアーキテクチャをマッピングし、脅威モデルを構築し、脆弱性を検出し、すべての検出結果を独立してレビューしてからレポートを作成します。プラグインを使用して、リポジトリ全体をスキャンするか、[変更のみをスキャン](#scan-only-your-changes)することができます。例えば、ブランチの diff、プルリクエストの diff、または単一のコミットなど、選択した検出結果をレビューして自分で適用できるパッチに変換します。9Claude Security プラグインは、Claude Code セッション内でコードベースのマルチエージェント脆弱性スキャンを実行します。Claude エージェントのチームがアーキテクチャをマッピングし、脅威モデルを構築し、脆弱性を検出し、すべての検出結果を独立してレビューしてからレポートを作成します。プラグインを使用して、リポジトリ全体をスキャンするか、[変更のみをスキャン](#scan-only-your-changes)することができます。例えば、ブランチの diff、プルリクエストの diff、または単一のコミットなどです。その後、選択した検出結果をレビューして自分で適用できるパッチに変換します。

10 10 

11プラグインはセッション内でローカルに実行され、Claude Code で利用可能なモデルを使用し、各スキャンはプランの使用制限にカウントされます。リポジトリを監視するマネージドサービスが必要な場合、または [Claude Mythos 5](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) でスキャンを実行したい場合は、Enterprise プランで利用可能な [Claude Security](https://claude.com/product/claude-security) プロダクトを参照してください。プラグインは、GitLab や Bitbucket でホストされているリポジトリ、または受信接続を許可しないネットワーク上のリポジトリなど、マネージドプロダクトが到達できないコードに到達します。11プラグインはセッション内でローカルに実行され、[Claude Code でアクセスできるモデルを使用](#models-and-providers)し、各スキャンは[使用量](/docs/ja/costs)にカウントされます。リポジトリを監視するマネージドサービスが必要な場合、または [Claude Mythos](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) でスキャンを実行したい場合は、Enterprise プランで利用可能な [Claude Security](https://claude.com/product/claude-security) プロダクトを参照してください。プラグインは、GitLab や Bitbucket でホストされているリポジトリ、または受信接続を許可しないネットワーク上のリポジトリなど、マネージドプロダクトが到達できないコードに到達できます。

12 12 

13プラグインは、Claude Code に既に存在するレビューツールとも異なります。[security guidance プラグイン](/docs/ja/security-guidance)は Claude が記述するコードをレビューし、[`/security-review`](/docs/ja/commands#all-commands)はブランチに対して単一パスを実行し、[Code Review](/docs/ja/code-review)はプルリクエストをレビューします。レイヤーがどのようにスタックするかについては、[プラグインが他のセキュリティツールとどのように適合するか](#how-the-plugin-fits-with-other-security-tools)を参照してください。13プラグインは、Claude Code に既に含まれているレビューツールとも異なります。[security guidance プラグイン](/docs/ja/security-guidance)は Claude が記述するコードをレビューし、[`/security-review`](/docs/ja/commands#all-commands)はブランチに対して単一パスを実行し、[Code Review](/docs/ja/code-review)はプルリクエストをレビューします。レイヤーがどのようにスタックするかについては、[プラグインが他のセキュリティツールとどのように適合するか](#how-the-plugin-fits-with-other-security-tools)を参照してください。

14 14 

15<h2 id="prerequisites">15<h2 id="prerequisites">

16 前提条件16 前提条件


18 18 

19プラグインを実行するには、以下が必要です。19プラグインを実行するには、以下が必要です。

20 20 

21* 有料プラン。スキャンがエージェントをオーケストレーションするために使用する [動的ワークフロー](/docs/ja/workflows)用です。Pro では、`/config` の Dynamic workflows 行から有効にしてください。21* 有料プラン、Anthropic API アクセス、または[サードパーティプロバイダー](#models-and-providers)。スキャンが使用する[動的ワークフロー](/docs/ja/workflows)でエージェントをオーケストレーションするためです。Pro では、`/config` の Dynamic workflows 行から有効にしてください。

22* Python 3.9 以降が `PATH` で `python3` として利用可能です。`python3 --version` で確認してください。プラグインのツーリングは Python 標準ライブラリのみを使用するため、何もインストールされません。22* Python 3.9 以降が `PATH` で `python3` として利用可能であること。`python3 --version` で確認してください。プラグインのツーリングは Python 標準ライブラリのみを使用するため、何もインストールされません。

23* Linux、macOS、または Windows。23* Linux、macOS、または Windows。

24* Git(変更スキャンおよび検出結果をパッチに変換するため)。これらのジョブは他のバージョン管理システムをサポートしていません。完全スキャンは、バージョン管理の有無にかかわらず、任意のディレクトリで機能します。24* Git。変更スキャンと検出結果をパッチに変換するためです。これらのジョブは他のバージョン管理システムをサポートしていません。完全スキャンは、バージョン管理の有無を問わず、任意のディレクトリで機能します。

25 

26<h2 id="models-and-providers">

27 モデルとプロバイダー

28</h2>

29 

30スキャンは Claude Code セッション内で実行されます。プラグインは独自のモデル呼び出しを行わないため、設定する必要のある個別の API キーやプロバイダー設定はありません。

31 

32* **モデル**: 脆弱性を検出し、検出結果を検証し、パッチを作成およびレビューするエージェントは、[セッションのモデル](/docs/ja/sub-agents#choose-a-model)で実行されます。これを変更するには、スキャンを開始する前にセッションで [`/model`](/docs/ja/model-config#setting-your-model) を実行してください。リポジトリのマッピングなどのいくつかのサポート手順では、代わりに [`sonnet` エイリアス](/docs/ja/model-config#model-aliases)を使用します。

33* **プロバイダー**: スキャンは有料プラン、Anthropic API アクセス、または [Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)などの[サードパーティプロバイダー](/docs/ja/third-party-integrations)で実行されます。

34 

35サードパーティプロバイダーでは、`sonnet` エイリアスが Anthropic API での場合とは異なるバージョンに解決される可能性があります。アカウントがそのバージョンを使用できない場合は、`ANTHROPIC_DEFAULT_SONNET_MODEL` を含む[モデルバージョンをピン留めしてください](/docs/ja/model-config#pin-models-for-third-party-deployments)。

36 

37[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)は、モデルのセーフガードがフラグを立てたリクエストを再実行します。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry では、[デプロイメントの設定方法](/docs/ja/model-config#enable-fallback-on-bedrock-agent-platform-and-foundry)に応じて、リクエストが拒否メッセージで終了する可能性があります。

25 38 

26<h2 id="install-the-plugin">39<h2 id="install-the-plugin">

27 プラグインをインストールする40 プラグインをインストールする


156 169 

157**`/claude-security` メニューが Python 警告で開きます。** プラグインは `PATH` に Python 3.9 以降の `python3` が必要です。`python3` がまったく見つからない場合、メニューは Claude Security がインストールされるまで機能しないことを警告します。`PATH` の最初の `python3` が古い場合、警告は見つかったバージョンを名前で指定します。Python 3 をインストールするか、新しい `python3` を `PATH` の最初に配置してから、新しいセッションを開始してください。170**`/claude-security` メニューが Python 警告で開きます。** プラグインは `PATH` に Python 3.9 以降の `python3` が必要です。`python3` がまったく見つからない場合、メニューは Claude Security がインストールされるまで機能しないことを警告します。`PATH` の最初の `python3` が古い場合、警告は見つかったバージョンを名前で指定します。Python 3 をインストールするか、新しい `python3` を `PATH` の最初に配置してから、新しいセッションを開始してください。

158 171 

159**Fable モデルでスキャンするときに「safeguards flagged this message」という通知が表示される場合があります。** メッセージはモデルを名前で指定します。例えば「Fable 5.1's safeguards flagged this message」。Fable のサイバーセキュリティ安全分類器により、特定のリクエストがフラグされ、Claude Code は [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)を通じてフラグされたリクエストを Opus モデルで再実行します。これは予想されており、スキャンは引き続き正常に完了するはずです。172**Fable モデルでスキャンするときに「safeguards flagged this message」という通知が表示される場合があります。** メッセージは実行しているモデルを名前で指定します。Fable のサイバーセキュリティ安全分類器により、特定のリクエストがフラグされ、Claude Code は [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)を通じてフラグされたリクエストを Opus モデルで再実行します。これは予想されており、リクエストが再実行されるとき、スキャンは引き続き正常に完了するはずです。

160 173 

161<h2 id="related-resources">174<h2 id="related-resources">

162 関連リソース175 関連リソース

Details

22| `claude -c -p "query"` | SDK 経由で続行 | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | SDK 経由で続行 | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | セッション ID または名前でセッションを再開 | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | セッション ID または名前でセッションを再開 | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | 最新バージョンに更新 | `claude update` |24| `claude update` | 最新バージョンに更新 | `claude update` |

25| `claude gateway` | 自己ホスト型 [Claude apps gateway](/docs/ja/claude-apps-gateway) サーバーを開始します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 上の Claude Code の前に SSO とポリシーをデプロイする管理者向けです。`--config` で [`gateway.yaml`](/docs/ja/claude-apps-gateway-config) を指す必要があります。Claude Code v2.1.195 以降で利用可能です。 | `claude gateway --config gateway.yaml` |25| `claude gateway` | 自己ホスト型 [Claude apps gateway](/docs/ja/claude-apps-gateway) サーバーを開始します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 上の Claude Code の前に SSO とポリシーをデプロイする管理者向けです。`--config` で [`gateway.yaml`](/docs/ja/claude-apps-gateway-config) を指す必要があります。 | `claude gateway --config gateway.yaml` |

26| `claude install [version]` | ネイティブバイナリをインストールまたは再インストールします。`2.1.118` のようなバージョン、または `stable` または `latest` を受け入れます。[特定のバージョンをインストール](/docs/ja/setup#install-a-specific-version) を参照してください | `claude install stable` |26| `claude install [version]` | ネイティブバイナリをインストールまたは再インストールします。`2.1.118` のようなバージョン、または `stable` または `latest` を受け入れます。[特定のバージョンをインストール](/docs/ja/setup#install-a-specific-version) を参照してください | `claude install stable` |

27| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |27| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |

28| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |28| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |

Details

566 * platform.claude.com566 * platform.claude.com

567 * code.claude.com567 * code.claude.com

568 * claude.ai568 * claude.ai

569 * claude.com

570 * support.claude.com

571 * anthropic.com

572 * [www.anthropic.com](http://www.anthropic.com)

569 </Accordion>573 </Accordion>

570 574 

571 <Accordion title="バージョン管理">575 <Accordion title="バージョン管理">


596 * hub.docker.com600 * hub.docker.com

597 * [www.docker.com](http://www.docker.com)601 * [www.docker.com](http://www.docker.com)

598 * production.cloudflare.docker.com602 * production.cloudflare.docker.com

603 * production.cloudfront.docker.com

599 * download.docker.com604 * download.docker.com

600 * gcr.io605 * gcr.io

601 * \*.gcr.io606 * \*.gcr.io

commands.md +7 −4

Details

56| `/add-dir <path>` | ファイルアクセスのための作業ディレクトリを現在のセッション中に追加します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)。ほとんどの[ネットワークパス](/docs/ja/errors#working-directory-is-a-network-path)(`\\server\share` など)は追加できません。正常に追加された後、[`DirectoryAdded` hooks](/docs/ja/hooks#directoryadded) が実行されます。Claude が応答している間に実行すると、Claude Code はディレクトリをすぐに確認するよう求め、確認すると Claude の同じターンの次のツール呼び出しがアクセスできます。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました |56| `/add-dir <path>` | ファイルアクセスのための作業ディレクトリを現在のセッション中に追加します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)。ほとんどの[ネットワークパス](/docs/ja/errors#working-directory-is-a-network-path)(`\\server\share` など)は追加できません。正常に追加された後、[`DirectoryAdded` hooks](/docs/ja/hooks#directoryadded) が実行されます。Claude が応答している間に実行すると、Claude Code はディレクトリをすぐに確認するよう求め、確認すると Claude の同じターンの次のツール呼び出しがアクセスできます。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました |

57| `/advisor [model\|off]` | [advisor ツール](/docs/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談します。`fable`、`opus`、`sonnet`、または完全なモデル ID を受け入れます。`fable` には [Fable アクセス](/docs/ja/advisor#choose-an-advisor-model)が必要です。引数がない場合、ピッカーが開きます。インタラクティブなターミナルがないセッション、または [Remote Control](/docs/ja/remote-control#limitations) 経由では、モデルまたは `off` を引数として渡します。引数がない場合、コマンドは現在の advisor をテキストとして出力します。これらの形式には Claude Code v2.1.260 以降が必要です |57| `/advisor [model\|off]` | [advisor ツール](/docs/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談します。`fable`、`opus`、`sonnet`、または完全なモデル ID を受け入れます。`fable` には [Fable アクセス](/docs/ja/advisor#choose-an-advisor-model)が必要です。引数がない場合、ピッカーが開きます。インタラクティブなターミナルがないセッション、または [Remote Control](/docs/ja/remote-control#limitations) 経由では、モデルまたは `off` を引数として渡します。引数がない場合、コマンドは現在の advisor をテキストとして出力します。これらの形式には Claude Code v2.1.260 以降が必要です |

58| `/agents` | v2.1.198 以降、`/agents` を実行すると、Claude に [subagents](/docs/ja/sub-agents) を作成または管理するよう求めるか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが出力されます。v2.1.197 以前では、subagent 設定を作成および管理するためのインタラクティブなインターフェイスが開きます |58| `/agents` | v2.1.198 以降、`/agents` を実行すると、Claude に [subagents](/docs/ja/sub-agents) を作成または管理するよう求めるか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが出力されます。v2.1.197 以前では、subagent 設定を作成および管理するためのインタラクティブなインターフェイスが開きます |

59| `/artifact-capabilities` | **[Skill](/docs/ja/skills#bundled-skills).** 公開された[アーティファクト](/docs/ja/artifacts)が使用できるランタイム機能のリファレンスを読み込みます。たとえば、[コネクタを呼び出す](/docs/ja/artifacts#pull-live-data-with-mcp-connectors)か[ファイルダウンロードを提供する](/docs/ja/artifacts#offer-a-file-download)など、アカウントが持つものを含みます。Claude は通常、1 つを使用するページを構築する前にそれを自動的に読み込みます。[アーティファクト](/docs/ja/artifacts#availability)が利用可能な場所で利用できます |

60| `/artifact-diagramming` | **[Skill](/docs/ja/skills#bundled-skills).** [アーティファクト](/docs/ja/artifacts)で Claude が従うべき図作成ガイダンスを読み込みます:図が役立つ場合、何を描くか、明るいテーマと暗いテーマで読みやすいままのインライン SVG を書く方法。Claude Code v2.1.221 以降が必要です |

59| `/artifacts` | 所有または共有されている[アーティファクト](/docs/ja/artifacts#find-an-artifact-again)を一覧表示し、セッションに添付するか、ブラウザで開くか、そのリンクをコピーします。[アーティファクト](/docs/ja/artifacts#availability)が利用可能な場所で利用できます。Claude Code v2.1.208 以降が必要です。`Enter` で添付するには v2.1.216 が必要です |61| `/artifacts` | 所有または共有されている[アーティファクト](/docs/ja/artifacts#find-an-artifact-again)を一覧表示し、セッションに添付するか、ブラウザで開くか、そのリンクをコピーします。[アーティファクト](/docs/ja/artifacts#availability)が利用可能な場所で利用できます。Claude Code v2.1.208 以降が必要です。`Enter` で添付するには v2.1.216 が必要です |

60| `/auto-mode-setup` | プロジェクトと最近のセッションから [`autoMode.environment` エントリ](/docs/ja/auto-mode-config#generate-environment-entries)をドラフトし、ドラフトを確認してユーザー設定に保存します。Pro、Max、または Team プランと Claude Code v2.1.228 以降が必要です。ネイティブ Windows では v2.1.233 以降が必要です |62| `/auto-mode-setup` | プロジェクトと最近のセッションから [`autoMode.environment` エントリ](/docs/ja/auto-mode-config#generate-environment-entries)をドラフトし、ドラフトを確認してユーザー設定に保存します。Pro、Max、または Team プランと Claude Code v2.1.228 以降が必要です。ネイティブ Windows では v2.1.233 以降が必要です |

61| `/autocompact [auto\|<tokens>]` | auto-compact ウィンドウを設定します:Claude Code が自動的にコンパクトする前にコンテキストウィンドウがどのくらい満杯になるかです。`500k` などのサイズを渡すか、`auto` を渡してモデル用に調整されたウィンドウに戻します。Claude Code は値をユーザー設定に保存し、現在のセッションに適用します。受け入れられる値と何がそれをオーバーライドするかについては、[auto-compact ウィンドウを設定する](/docs/ja/model-config#set-the-auto-compact-window)を参照してください。引数がない場合、現在のウィンドウを表示するダイアログが開きます。Claude Code v2.1.221 以降が必要です |63| `/autocompact [auto\|<tokens>]` | auto-compact ウィンドウを設定します:Claude Code が自動的にコンパクトする前にコンテキストウィンドウがどのくらい満杯になるかです。`500k` などのサイズを渡すか、`auto` を渡してモデル用に調整されたウィンドウに戻します。Claude Code は値をユーザー設定に保存し、現在のセッションに適用します。受け入れられる値と何がそれをオーバーライドするかについては、[auto-compact ウィンドウを設定する](/docs/ja/model-config#set-the-auto-compact-window)を参照してください。引数がない場合、現在のウィンドウを表示するダイアログが開きます。Claude Code v2.1.221 以降が必要です |


67| `/bug [report]` | バグを報告するか、会話を共有します。セッション履歴をどのくらい含めるかを選択し、何かが送信される前に同意画面で確認します。Anthropic への最初のパーティ接続でサインインしている場合、レポートは Anthropic に送信されます。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、Claude Code はレポートを [`~/.claude/feedback-bundles/`](/docs/ja/data-usage#telemetry-services) の[ローカルアーカイブ](/docs/ja/data-usage#telemetry-services)に書き込み、自分で転送します。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡張機能独自のフィードバックダイアログを開きます。Claude Code v2.1.229 以降が必要です。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開きます。v2.1.232 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス:`/share`。v2.1.212 より前は、`/bug` と `/share` は `/feedback` のエイリアスでした |69| `/bug [report]` | バグを報告するか、会話を共有します。セッション履歴をどのくらい含めるかを選択し、何かが送信される前に同意画面で確認します。Anthropic への最初のパーティ接続でサインインしている場合、レポートは Anthropic に送信されます。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、Claude Code はレポートを [`~/.claude/feedback-bundles/`](/docs/ja/data-usage#telemetry-services) の[ローカルアーカイブ](/docs/ja/data-usage#telemetry-services)に書き込み、自分で転送します。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡張機能独自のフィードバックダイアログを開きます。Claude Code v2.1.229 以降が必要です。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開きます。v2.1.232 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス:`/share`。v2.1.212 より前は、`/bug` と `/share` は `/feedback` のエイリアスでした |

68| `/cd <path>` | このセッションを新しい作業ディレクトリに移動し、会話を保持します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。提案には Claude Code v2.1.206 以降が必要です。Claude Code が新しいディレクトリからすぐに適用するもの、および `/cd` が `/add-dir` とどのように異なるかについては、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照してください |70| `/cd <path>` | このセッションを新しい作業ディレクトリに移動し、会話を保持します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。提案には Claude Code v2.1.206 以降が必要です。Claude Code が新しいディレクトリからすぐに適用するもの、および `/cd` が `/add-dir` とどのように異なるかについては、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照してください |

69| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 設定を構成します |71| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 設定を構成します |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。`migrate` を実行して既存の Claude API コードを新しいモデルに更新します。`upgrade` を実行してプロジェクトの Anthropic SDK 依存関係をメジャーバージョン全体で移動します。現在、Python `anthropic` パッケージを 0.x から 1.x に移動します。`managed-agents-onboard` を実行して、新しい Managed Agent を作成するウォークスルーを取得します。`prompt-audit` を実行して、プロンプト、スキル、ツール説明で古いモデル用に書かれた指示にフラグを立て、修正を diff として提案します。`cost-optimize` を実行して、プロジェクトの Claude API 支出がどこに行くかをプロファイルし、prompt caching、不要な入出力トークンのトリミング、バッチ処理、努力、モデル選択などのオプションから節約を提案します。一度に 1 つの変更を行います。`build-eval` を実行して Claude 搭載アプリの eval セットを構築し、`hillclimb` を実行して既存の eval に対してアプリを反復的に改善します。`prompt-audit` サブコマンドには Claude Code v2.1.221 以降が必要です。`upgrade` には v2.1.236 以降が必要です。`cost-optimize` には v2.1.247 以降が必要です。`build-eval` と `hillclimb` には v2.1.259 以降が必要です |72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。各サブコマンドが何をするか、および必要なバージョンについては、[Claude API プロジェクトで作業する](/docs/ja/skills#work-on-claude-api-projects)を参照してください |

73| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラウザでタスクを実行させます。ページのテスト、フォームの入力、コンソールログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じて。Chrome 統合がセッションで有効な場合(たとえば `claude --chrome` など)、または Claude Code が[拡張機能をインストール](/docs/ja/chrome#install-the-extension-when-claude-asks)することを提案できる場合に利用可能です |

71| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話に `/resume` ピッカーでラベルを付けるために名前を渡します。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用します。`/resume` で前の会話を再開するか、同じ Claude Code プロセスで、[rewind メニューの previous-session エントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から復元します。エイリアス:`/reset`、`/new` |74| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話に `/resume` ピッカーでラベルを付けるために名前を渡します。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用します。`/resume` で前の会話を再開するか、同じ Claude Code プロセスで、[rewind メニューの previous-session エントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から復元します。エイリアス:`/reset`、`/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在の diff、または渡す PR 番号、ブランチ、またはパスを正確性バグについてレビューします。モデルと努力レベルに応じて、レビューはクリーンアップの機会もカバーします。`--fix` を渡して検出結果を適用し、`--comment` を渡して GitHub PR または GitLab マージリクエストに投稿するか、`ultra` を渡してディープ[クラウドレビュー](/docs/ja/ultrareview)を実行します。GitLab マージリクエストに投稿するには Claude Code v2.1.257 以降が必要です。`github.com` PR ターゲットで `ultra` を使用する場合、`--post` を渡して [PR に完成した検出結果を投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)ことを起動ダイアログで事前選択します。`--post` には Claude Code v2.1.227 以降が必要です。努力レベル、ターゲット、および `/simplify` との関係については、[diff をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。エイリアス:`/review` |75| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在の diff、または渡す PR 番号、ブランチ、またはパスを正確性バグについてレビューします。モデルと努力レベルに応じて、レビューはクリーンアップの機会もカバーします。`--fix` を渡して検出結果を適用し、`--comment` を渡して GitHub PR または GitLab マージリクエストに投稿するか、`ultra` を渡してディープ[クラウドレビュー](/docs/ja/ultrareview)を実行します。GitLab マージリクエストに投稿するには Claude Code v2.1.257 以降が必要です。`github.com` PR ターゲットで `ultra` を使用する場合、`--post` を渡して [PR に完成した検出結果を投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)ことを起動ダイアログで事前選択します。`--post` には Claude Code v2.1.227 以降が必要です。努力レベル、ターゲット、および `/simplify` との関係については、[diff をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。エイリアス:`/review` |

73| `/color [color\|default]` | 現在のセッションのプロンプトバーのカラーを設定します。利用可能なカラー:`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を使用してリセットするか、引数なしで実行してランダムなカラーを選択します。[Remote Control](/docs/ja/remote-control) が接続されている場合、カラーは claude.ai/code に同期されます。非インタラクティブモード(`-p`)でも利用可能です。Claude Code v2.1.205 以降が必要です |76| `/color [color\|default]` | 現在のセッションのプロンプトバーのカラーを設定します。利用可能なカラー:`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を使用してリセットするか、引数なしで実行してランダムなカラーを選択します。[Remote Control](/docs/ja/remote-control) が接続されている場合、カラーは claude.ai/code に同期されます。非インタラクティブモード(`-p`)でも利用可能です。Claude Code v2.1.205 以降が必要です |


84| `/design-sync [hint]` | **[Skill](/docs/ja/skills#bundled-skills).** リポジトリの React 設計システムを変換して [Claude Design](https://claude.ai/design) にアップロードし、生成される設計が実際のコンポーネントを使用するようにします。オプションで設計システムに名前を付けます。たとえば `/design-sync Acme DS`。初回同期はすべてのコンポーネントを検証し、大規模なリポジトリでは数時間かかる場合があります。Anthropic API で利用可能です。CLI が接触しない claude.ai が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では、コマンドは利用できません |87| `/design-sync [hint]` | **[Skill](/docs/ja/skills#bundled-skills).** リポジトリの React 設計システムを変換して [Claude Design](https://claude.ai/design) にアップロードし、生成される設計が実際のコンポーネントを使用するようにします。オプションで設計システムに名前を付けます。たとえば `/design-sync Acme DS`。初回同期はすべてのコンポーネントを検証し、大規模なリポジトリでは数時間かかる場合があります。Anthropic API で利用可能です。CLI が接触しない claude.ai が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では、コマンドは利用できません |

85| `/desktop` | 現在のセッションを Claude Code Desktop アプリで続行します。macOS または x64 Windows と Claude サブスクリプションが必要です。エイリアス:`/app` |88| `/desktop` | 現在のセッションを Claude Code Desktop アプリで続行します。macOS または x64 Windows と Claude サブスクリプションが必要です。エイリアス:`/app` |

86| `/diff` | 作業ツリーの変更(Claude がこれまでに行った編集を含む)を確認します。[/diff で変更を確認する](/docs/ja/interactive-mode#review-changes-with-%2Fdiff)を参照してください |89| `/diff` | 作業ツリーの変更(Claude がこれまでに行った編集を含む)を確認します。[/diff で変更を確認する](/docs/ja/interactive-mode#review-changes-with-%2Fdiff)を参照してください |

87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ja/skills#bundled-skills).** セットアップチェックアップを実行して、問題を診断して修正できます。重複またはレフトオーバーインストール、`PATH` の問題、解析不可能な設定ファイルを含むインストール正常性をチェックします。未使用のスキル、MCP サーバー、プラグインとそのコンテキストコストを検出し、遅い [hooks](/docs/ja/hooks) にフラグを立て、[リリースチャネル](/docs/ja/setup#configure-release-channel)で新しいバージョンをチェックします。ローカル `CLAUDE.md` ファイルをチェックイン済みのファイルに対して重複排除し、チェックイン済みの [`CLAUDE.md`](/docs/ja/memory#my-claude-md-is-too-large) ファイルをコードベースから導出できるコンテンツをカットしてトリミングし、常にロードされるガイダンスを [skills](/docs/ja/skills) とオンデマンドでロードされるネストされた `CLAUDE.md` ファイルに移行します。また、[auto mode](/docs/ja/permissions#permission-modes) をデフォルトにすることと、頻繁に拒否される読み取り専用コマンドを[事前承認](/docs/ja/permissions)することを提案します。最初に検出結果を報告し、何かを変更する前に確認を求めます。ターミナルから、`claude doctor` はセッションを開始せずに読み取り専用インストール診断を出力します。エイリアス:`/checkup`。`/doctor prompt-audit` を実行して、Claude に [`CLAUDE.md` ファイル、スキル、その他の設定](/docs/ja/memory#write-effective-instructions)を監査させ、古い指示または競合する指示を検出する代わりにチェックアップを実行します。`prompt-audit` サブコマンドには Claude Code v2.1.283 以降が必要です。`CLAUDE.md` トリミングチェックには Claude Code v2.1.206 以降が必要です。v2.1.205 より前は、`/doctor` は読み取り専用診断画面を開き、`f` を押すとレポートを Claude に送信しました |90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ja/skills#bundled-skills).** セットアップチェックアップを実行して、問題を診断して修正できます。重複またはレフトオーバーインストール、`PATH` の問題、解析不可能な設定ファイルを含むインストール正常性をチェックします。未使用のスキル、MCP サーバー、プラグインとそのコンテキストコストを検出し、遅い [hooks](/docs/ja/hooks) にフラグを立て、[リリースチャネル](/docs/ja/setup#configure-release-channel)で新しいバージョンをチェックします。ローカル `CLAUDE.md` ファイルをチェックイン済みのファイルに対して重複排除し、チェックイン済みの [`CLAUDE.md`](/docs/ja/memory#my-claude-md-is-too-large) ファイルをコードベースから導出できるコンテンツをカットしてトリミングし、常にロードされるガイダンスを [skills](/docs/ja/skills) とオンデマンドでロードされるネストされた `CLAUDE.md` ファイルに移行します。また、[auto mode](/docs/ja/permissions#permission-modes) をデフォルトにすることと、頻繁に拒否される読み取り専用コマンドを[事前承認](/docs/ja/permissions)することを提案します。最初に検出結果を報告し、何かを変更する前に確認を求めます。ターミナルから、`claude doctor` はセッションを開始せずに読み取り専用インストール診断を出力します。エイリアス:`/checkup`。`/doctor prompt-audit` を実行して、Claude に [`CLAUDE.md` ファイル、スキル、その他の設定](/docs/ja/memory#audit-your-instruction-files)を監査させ、古い指示または競合する指示を検出する代わりにチェックアップを実行します。`prompt-audit` サブコマンドには Claude Code v2.1.283 以降が必要です。`CLAUDE.md` トリミングチェックには Claude Code v2.1.206 以降が必要です。v2.1.205 より前は、`/doctor` は読み取り専用診断画面を開き、`f` を押すとレポートを Claude に送信しました |

88| `/effort [level\|auto\|status\|ultracode [on\|off]]` | [努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します:`low` から `xhigh`、`max`、または `auto`。`status` はそれを出力します。`ultracode` または `ultracode on` は現在のレベルで[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)をセッションでオンにし、`ultracode off` はそれをオフにします。[`ultracode`](/docs/ja/settings-reference#ultracode) キーは永続化されます。`max` はセッションのみです。`on` および `off` 引数と現在のレベルを保持するには Claude Code v2.1.284 以降が必要です。v2.1.284 より前は、`/effort ultracode` はセッションを `xhigh` に設定し、`/effort ultracode off` は `Invalid argument` で失敗しました。Claude が応答している間に実行し、[キャッシュ警告](/docs/ja/prompt-caching#changing-effort-level)を確認すると、Claude Code が表示する場合、Claude Code は新しいレベルをそのターンの次のリクエストに適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション([サードパーティプロバイダー](/docs/ja/third-party-integrations)など)では常にキューに入れていました。非インタラクティブモード(`-p`)で機能します |91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | [努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します:`low` から `xhigh`、`max`、または `auto`。`status` はそれを出力します。`ultracode` または `ultracode on` は現在のレベルで[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)をセッションでオンにし、`ultracode off` はそれをオフにします。[`ultracode`](/docs/ja/settings-reference#ultracode) キーは永続化されます。`max` はセッションのみです。`on` および `off` 引数と現在のレベルを保持するには Claude Code v2.1.284 以降が必要です。v2.1.284 より前は、`/effort ultracode` はセッションを `xhigh` に設定し、`/effort ultracode off` は `Invalid argument` で失敗しました。Claude が応答している間に実行し、[キャッシュ警告](/docs/ja/prompt-caching#changing-effort-level)を確認すると、Claude Code が表示する場合、Claude Code は新しいレベルをそのターンの次のリクエストに適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション([サードパーティプロバイダー](/docs/ja/third-party-integrations)など)では常にキューに入れていました。非インタラクティブモード(`-p`)で機能します |

89| `/exit` | CLI を終了します。アタッチされた[バックグラウンドセッション](/docs/ja/agent-view#attach-to-a-session)では、これはデタッチし、セッションは実行し続けます。エイリアス:`/quit` |92| `/exit` | CLI を終了します。アタッチされた[バックグラウンドセッション](/docs/ja/agent-view#attach-to-a-session)では、これはデタッチし、セッションは実行し続けます。エイリアス:`/quit` |

90| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するためのダイアログが開きます |93| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するためのダイアログが開きます |

91| `/fast [on\|off]` | [fast mode](/docs/ja/fast-mode) をオンまたはオフに切り替えます。Claude が応答している間に実行し、Claude Code はターンの終了を待たずに fast mode を切り替えます。ただし、実行中のターンは元の速度で終了します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは常にキューに入れていました。非インタラクティブモードでの `-p` での可用性は限定的です。[fast mode を切り替える](/docs/ja/fast-mode#toggle-fast-mode)を参照してください。Claude Code v2.1.205 以降が必要です |94| `/fast [on\|off]` | [fast mode](/docs/ja/fast-mode) をオンまたはオフに切り替えます。Claude が応答している間に実行し、Claude Code はターンの終了を待たずに fast mode を切り替えます。ただし、実行中のターンは元の速度で終了します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは常にキューに入れていました。非インタラクティブモードでの `-p` での可用性は限定的です。[fast mode を切り替える](/docs/ja/fast-mode#toggle-fast-mode)を参照してください。Claude Code v2.1.205 以降が必要です |

92| `/feedback [report]` | Claude Code に関する製品フィードバックを送信します。[`/bug`](#all-commands) と同じダイアログを開き、同じ同意ステップ、送信ルール、ミッドターン動作があります。[Claude がドラフトしたフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、引数なしで `/feedback` を実行するとドラフトキューが代わりに開き、Claude がキューに入れたドラフトを確認、編集、送信、または破棄できます。キューには新しいレポートをダイアログで書き込むオプションが含まれます。引数を指定した場合、および `/bug` の場合は常に、ダイアログが直接開きます |95| `/feedback [report]` | Claude Code に関する製品フィードバックを送信します。[`/bug`](#all-commands) と同じダイアログを開き、同じ同意ステップ、送信ルール、ミッドターン動作があります。[Claude がドラフトしたフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、引数なしで `/feedback` を実行するとドラフトキューが代わりに開き、Claude がキューに入れたドラフトを確認、編集、送信、または破棄できます。キューには新しいレポートをダイアログで書き込むオプションが含まれます。引数を指定した場合、および `/bug` の場合は常に、ダイアログが直接開きます |

93| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで一般的な読み取り専用 Bash および MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先許可リストを追加して権限プロンプトを減らします |96| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで一般的な読み取り専用 Bash および MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先許可リストを追加して権限プロンプトを減らします |

94| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動された subagents もカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション全体で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定してオーバーライドします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニュー切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |97| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動された subagents もカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション全体で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定してオーバーライドします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[Remote Control](/docs/ja/remote-control) クライアントから、`/focus [on\|off]` を実行して、保存された選択を変更せずに現在のセッションのみのフォーカスビューをオンまたはオフにします。これには Claude Code v2.1.281 以降が必要です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニュー切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |

95| `/fork [prompt]` | [現在の会話をコピー](/docs/ja/agent-view#copy-the-session-with-%2Ffork)して新しいバックグラウンドセッションを作成し、ここで作業を続けます。プロンプトを渡すとコピーはすぐにそれに対して作業を開始します。渡さない場合、エージェントビューで最初のプロンプトを待ちます。コピーが[その場で編集](/docs/ja/agent-view#how-file-edits-are-isolated)する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。分離指示には Claude Code v2.1.221 以降が必要です。結果がこの会話に戻ってくる subagent に副タスクを渡すには、`/subtask` を使用します。自分でコピーに切り替えるには、`/branch` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ~ v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合は常に、`/fork` は [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を開始します |98| `/fork [prompt]` | [現在の会話をコピー](/docs/ja/agent-view#copy-the-session-with-%2Ffork)して新しいバックグラウンドセッションを作成し、ここで作業を続けます。プロンプトを渡すとコピーはすぐにそれに対して作業を開始します。渡さない場合、エージェントビューで最初のプロンプトを待ちます。コピーが[その場で編集](/docs/ja/agent-view#how-file-edits-are-isolated)する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。分離指示には Claude Code v2.1.221 以降が必要です。結果がこの会話に戻ってくる subagent に副タスクを渡すには、`/subtask` を使用します。自分でコピーに切り替えるには、`/branch` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ~ v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合は常に、`/fork` は [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を開始します |

96| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を設定します:Claude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるまでターン全体で作業を続けます。引数がない場合、現在または最近達成された goal を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな goal を早期に削除します |99| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を設定します:Claude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるまでターン全体で作業を続けます。引数がない場合、現在または最近達成された goal を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな goal を早期に削除します |

97| `/heapdump` | JavaScript ヒープスナップショットとメモリ内訳を `~/Desktop` または Linux のホームディレクトリ(Desktop フォルダがない場合)に書き込んで、高いメモリ使用量を診断します。メモリ問題を報告するときは `-diagnostics.json` ファイルのみを添付してください。`.heapsnapshot` には完全な会話と認証情報が含まれているため、共有しないでください。[出力で何をするか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |100| `/heapdump` | JavaScript ヒープスナップショットとメモリ内訳を `~/Desktop` または Linux のホームディレクトリ(Desktop フォルダがない場合)に書き込んで、高いメモリ使用量を診断します。メモリ問題を報告するときは `-diagnostics.json` ファイルのみを添付してください。`.heapsnapshot` には完全な会話と認証情報が含まれているため、共有しないでください。[出力で何をするか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |


121| `/pr-comments [PR]` | v2.1.91 で削除されました。代わりに Claude に直接プルリクエストコメントを表示するよう求めてください。以前のバージョンでは、GitHub プルリクエストからコメントをフェッチして表示します。現在のブランチの PR を自動的に検出するか、PR URL または番号を渡します。`gh` CLI が必要です |124| `/pr-comments [PR]` | v2.1.91 で削除されました。代わりに Claude に直接プルリクエストコメントを表示するよう求めてください。以前のバージョンでは、GitHub プルリクエストからコメントをフェッチして表示します。現在のブランチの PR を自動的に検出するか、PR URL または番号を渡します。`gh` CLI が必要です |

122| `/privacy-settings` | プライバシー設定を表示および更新します。Pro および Max プランサブスクライバーのみが利用可能です |125| `/privacy-settings` | プライバシー設定を表示および更新します。Pro および Max プランサブスクライバーのみが利用可能です |

123| `/radio` | ブラウザで Claude FM lo-fi ラジオを開きます。ブラウザが利用できない場合、ストリーム URL を出力します |126| `/radio` | ブラウザで Claude FM lo-fi ラジオを開きます。ブラウザが利用できない場合、ストリーム URL を出力します |

124| `/rate-limit-options` | claude.ai 使用制限がリクエストをブロックしている場合に作業を続ける方法を表示します:待機して[制限がリセットされたときに自動的に続行](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)、[使用クレジット](/docs/ja/costs#add-usage-credits-to-your-subscription)を追加、またはプランをアップグレードします。Claude Code は制限に達したときに独自のターミナルでこのメニューを開くこともできます。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。claude.ai サブスクリプションが必要です。コマンドメニューに表示されません。完全に入力してください。待機と続行行には Claude Code v2.1.234 以降が必要です |127| `/rate-limit-options` | claude.ai 使用制限がリクエストをブロックしている場合に作業を続ける方法を表示します:待機して[制限がリセットされたときに自動的に続行](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)、[使用クレジット](/docs/ja/costs#add-usage-credits-to-your-subscription)を追加、またはプランをアップグレードします。Claude Code は制限に達したときに独自のターミナルでこのメニューを開くこともできます。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。claude.ai サブスクリプションが必要です。待機と続行行には Claude Code v2.1.234 以降が必要です |

125| `/recap` | 現在のセッションの 1 行の要約をオンデマンドで生成します。[セッション要約](/docs/ja/interactive-mode#session-recap)を参照してください。これは、離れていた後に表示される自動要約です |128| `/recap` | 現在のセッションの 1 行の要約をオンデマンドで生成します。[セッション要約](/docs/ja/interactive-mode#session-recap)を参照してください。これは、離れていた後に表示される自動要約です |

126| `/release-notes` | インタラクティブなバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します。ノートは Claude が見るトランスクリプトに表示されます |129| `/release-notes` | インタラクティブなバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します。ノートは Claude が見るトランスクリプトに表示されます |

127| `/reload-plugins [--force]` | すべてのアクティブな [plugins](/docs/ja/plugins/overview) を再度読み込んで、保留中の変更を再起動なしで適用します。再度読み込まれた各コンポーネントのカウントを報告し、読み込みエラーにフラグを立てます。再度読み込むと読み込まれた MCP ツールが変更され、プロンプトキャッシュが無効になる場合、コマンドは警告を出し、`--force` を渡さない限りスキップします。非インタラクティブモード(`-p`)、Agent SDK、デスクトップアプリでも利用可能です。セッションに直接入力されたテキストでのみ実行され、プラグイン MCP サーバーの変更は適用されません。Claude Code v2.1.260 以降が必要です。[再起動なしでプラグイン変更を適用する](/docs/ja/plugins/cli-reference#reload-plugins)を参照してください |130| `/reload-plugins [--force]` | すべてのアクティブな [plugins](/docs/ja/plugins/overview) を再度読み込んで、保留中の変更を再起動なしで適用します。再度読み込まれた各コンポーネントのカウントを報告し、読み込みエラーにフラグを立てます。再度読み込むと読み込まれた MCP ツールが変更され、プロンプトキャッシュが無効になる場合、コマンドは警告を出し、`--force` を渡さない限りスキップします。非インタラクティブモード(`-p`)、Agent SDK、デスクトップアプリでも利用可能です。セッションに直接入力されたテキストでのみ実行され、プラグイン MCP サーバーの変更は適用されません。Claude Code v2.1.260 以降が必要です。[再起動なしでプラグイン変更を適用する](/docs/ja/plugins/cli-reference#reload-plugins)を参照してください |

costs.md +2 −0

Details

99 99 

100[`/insights`](/docs/ja/commands#all-commands) を実行して、使用したトークン数ではなく、作業方法に関するレポートを取得します。このマシン上の最近のセッションを分析し、作業内容、誤解されたリクエストやバグのあるコードなどの摩擦点、および Claude Code をより効果的に使用するための提案をカバーする HTML レポートを作成します。1 回の実行は、まだ見たことのない最大 200 セッションを分析し、非常に短いセッションはスキップします。セッションが除外される場合、レポートヘッダーは分析されたカウントを括弧内の合計とともに表示します。例えば `200 sessions (412 total)` のようにです。100[`/insights`](/docs/ja/commands#all-commands) を実行して、使用したトークン数ではなく、作業方法に関するレポートを取得します。このマシン上の最近のセッションを分析し、作業内容、誤解されたリクエストやバグのあるコードなどの摩擦点、および Claude Code をより効果的に使用するための提案をカバーする HTML レポートを作成します。1 回の実行は、まだ見たことのない最大 200 セッションを分析し、非常に短いセッションはスキップします。セッションが除外される場合、レポートヘッダーは分析されたカウントを括弧内の合計とともに表示します。例えば `200 sessions (412 total)` のようにです。

101 101 

102[auto mode](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) がセッションで利用可能で、最近のセッションのほとんどがそれなしで実行された場合、レポートはそれらのセッション全体で auto mode が処理できたであろう権限プロンプトの数の推定値も含めることができます。

103 

102Claude Code は最新のレポートを `~/.claude/usage-data/report.html` に書き込み、各実行のタイムスタンプ付きコピーを同じディレクトリに保存するため、以前のレポートは上書きされません。Claude Code はセッションデータの残りと同じスケジュールでレポートを削除します。起動時に、[`cleanupPeriodDays`](/docs/ja/claude-directory#cleaned-up-automatically) より古いファイルを削除します。デフォルトは 30 日です。104Claude Code は最新のレポートを `~/.claude/usage-data/report.html` に書き込み、各実行のタイムスタンプ付きコピーを同じディレクトリに保存するため、以前のレポートは上書きされません。Claude Code はセッションデータの残りと同じスケジュールでレポートを削除します。起動時に、[`cleanupPeriodDays`](/docs/ja/claude-directory#cleaned-up-automatically) より古いファイルを削除します。デフォルトは 30 日です。

103 105 

104任意のプランおよび任意のプロバイダーで `/insights` を実行できます。分析は通常のセッションと同じプロバイダーとアカウントを通じて実行され、トークンはプランまたは API 使用量に対してカウントされます。他のデバイスおよび claude.ai からのセッションは含まれていません。106任意のプランおよび任意のプロバイダーで `/insights` を実行できます。分析は通常のセッションと同じプロバイダーとアカウントを通じて実行され、トークンはプランまたは API 使用量に対してカウントされます。他のデバイスおよび claude.ai からのセッションは含まれていません。

desktop.md +6 −0

Details

834* **Remote Control**:組織の[Remote Control](/docs/ja/remote-control)を有効または無効にします834* **Remote Control**:組織の[Remote Control](/docs/ja/remote-control)を有効または無効にします

835* **Disable Bypass permissions mode**:組織内のユーザーが bypass permissions モードを有効にするのを防ぎます835* **Disable Bypass permissions mode**:組織内のユーザーが bypass permissions モードを有効にするのを防ぎます

836 836 

837<Note>

838 管理コンソールの[データとプライバシー設定](https://claude.ai/admin-settings/data-privacy-controls)の**Monitoring**下の Cowork 用 OpenTelemetry フォームは、Cowork セッションのみに適用されます。このマシン上の Cowork セッションでは、デスクトップアプリはそのコレクタを Claude Code に`OTEL_*`環境変数として渡すため、Claude Code がそのセッションで[管理コンソール設定をフェッチしない](#managed-settings)場合でも、フォームは有効になります。

839 

840 Code タブセッションからテレメトリをエクスポートするには、Claude Code 管理設定の`env`ブロックで`CLAUDE_CODE_ENABLE_TELEMETRY`と`OTEL_*`変数を設定します。[監視用の管理者設定](/docs/ja/monitoring-usage#administrator-configuration)に示されているとおりです。ローカル、クラウド、SSH セッションは、それぞれ[異なるソースから管理設定を読み取ります](#managed-settings)。クラウドセッションが到達できるホストについては、[ネットワークアクセス](/docs/ja/cloud-environments#network-access)を参照してください。Code タブセッションが報告する`service.name`については、[サービス情報](/docs/ja/monitoring-usage#service-information)を参照してください。

841</Note>

842 

837<h3 id="managed-settings">843<h3 id="managed-settings">

838 管理設定844 管理設定

839</h3>845</h3>

env-vars.md +287 −287

Details

110 110 

111いくつかの動作には環境変数と専用の設定キーの両方があり、Claude Code がどちらを最初に読むかはキーごとに異なります。`ANTHROPIC_MODEL` と `CLAUDE_CODE_AUTO_CONNECT_IDE` の場合、Claude Code は変数を最初に読み、変数が設定されていない場合にのみ `model` または `autoConnectIde` 設定を使用します。設定しているペアについては、以下の変数の行と [設定リファレンス](/docs/ja/settings-reference) のキーのエントリを確認してください。111いくつかの動作には環境変数と専用の設定キーの両方があり、Claude Code がどちらを最初に読むかはキーごとに異なります。`ANTHROPIC_MODEL` と `CLAUDE_CODE_AUTO_CONNECT_IDE` の場合、Claude Code は変数を最初に読み、変数が設定されていない場合にのみ `model` または `autoConnectIde` 設定を使用します。設定しているペアについては、以下の変数の行と [設定リファレンス](/docs/ja/settings-reference) のキーのエントリを確認してください。

112 112 

113同じ変数がシェルと設定ファイルの `env` ブロックの両方で設定されている場合、設定ファイルの値が適用されます。Claude Code は各 `env` エントリをプロセス環境に書き込み、シェルから継承された値を置き換えます。[`env` 設定](/docs/ja/settings-reference#when-claude-code-applies-env-values) は、それらがいつ適用されるかを示しています。いくつかの変数は特別な扱いを受けます。[`env` 設定](/docs/ja/settings-reference#env) は例外をリストしています。113同じ変数がシェルと設定ファイルの `env` ブロックの両方で設定されている場合、ほとんどのセッションで設定ファイルの値が適用されます。Claude Code は各 `env` エントリをプロセス環境に書き込み、シェルから継承された値を置き換えます。[`env` 値がシェルとどのように相互作用するか](/docs/ja/settings-reference#how-env-values-interact-with-your-shell) は、代わりに継承された値を保持するセッションについて説明しており、[`env` 設定](/docs/ja/settings-reference#when-claude-code-applies-env-values) はそれらがいつ適用されるかを示しています。いくつかの変数は特別な扱いを受けます。[`env` 設定](/docs/ja/settings-reference#env) は例外をリストしています。

114 114 

115設定ファイルでは変数を設定できますが、削除することはできません。制御していないシェルプロファイルによってエクスポートされた古い `CLAUDE_CODE_USE_VERTEX` など、設定を解除できない変数をオーバーライドするには、`env` ブロックで空の文字列に設定します。`"CLAUDE_CODE_USE_VERTEX": ""`。Claude Code は空の値をプロバイダー選択の未設定として扱います。サブプロセスは引き続き空の値を継承します。115設定ファイルでは変数を設定できますが、削除することはできません。制御していないシェルプロファイルによってエクスポートされた古い `CLAUDE_CODE_USE_VERTEX` など、設定を解除できない変数をオーバーライドするには、`env` ブロックで空の文字列に設定します。`"CLAUDE_CODE_USE_VERTEX": ""`。Claude Code は空の値をプロバイダー選択の未設定として扱います。サブプロセスは引き続き空の値を継承します。

116 116 


124 変数124 変数

125</h2>125</h2>

126 126 

127タイムアウト、トークン予算、再試行回数などの数値変数は、変数の行に「プレーンな数字のみ」と記載されている場合を除き、プレーンな数字に加えて科学記法と数字区切り文字の表記を受け入れます。例えば、Claude Code は `2e3` を 2000 として、`64_000` を 64000 として読み込みます。v2.1.211 より前は、これらの表記により、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が静かに設定される可能性がありました。127タイムアウト、トークン予算、再試行回数などの数値変数は、変数の行に「プレーンな数字のみ」と記載されている場合を除き、プレーンな数字に加えて科学記法と数字区切り記法を受け入れます。例えば、Claude Code は `2e3` を 2000 として、`64_000` を 64000 として読み込みます。v2.1.211 より前は、これらの記法により、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が静かに設定される可能性がありました。

128 128 

129<Note>129<Note>

130 動作をオン/オフにする変数の場合、`1` または `true` を設定してオンにし、`0` または `false` を設定してオフにします。大文字小文字は問いません。130 動作をオン/オフにする変数の場合、`1` または `true` を設定してオンにし、`0` または `false` を設定してオフにします。大文字小文字は問いません。

131 131 

132 一部の変数は、設定したかどうかのみを読み取るため、`0` を含む空でない値はその動作をオンにし、変数を設定解除するか空の値に設定することで動作をオフにします。これらの変数はこのように機能します:132 一部の変数は、設定されているかどうかのみを読み取るため、`0` を含む空でない値はすべて動作をオンにし、変数を設定解除するか空の値に設定することで動作をオフにします。これらの変数は次のように機能します:

133 133 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`


138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140 

141 別の変数には独自のルールがあります:`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフになります。各変数の行には独自のルールも記載されています。141 別の変数には独自のルールがあります:`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフになります。各変数の行には、独自のルールも記載されています。

142</Note>142</Note>

143 143 

144| 変数 | 目的 |144| 変数 | 目的 |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定されている場合、ログインしていても、このキーは Claude Pro、Max、Team、または Enterprise サブスクリプションの代わりに使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションをオーバーライドする前に、一度承認するよう求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行してください |146| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定されている場合、ログインしていても、このキーが Claude Pro、Max、Team、または Enterprise サブスクリプションの代わりに使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションをオーバーライドする前に、一度承認するよう求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行します |

147| `ANTHROPIC_AUTH_TOKEN` | `Authorization` ヘッダーのカスタム値(ここで設定した値には `Bearer ` が付加されます) |147| `ANTHROPIC_AUTH_TOKEN` | `Authorization` ヘッダーのカスタム値(ここで設定した値には `Bearer ` が付加されます) |

148| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のワークスペース API キー。AWS コンソールで生成されます。`x-api-key` として送信され、AWS SigV4 より優先されます |148| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のワークスペース API キー。AWS コンソールで生成されます。`x-api-key` として送信され、AWS SigV4 より優先されます |

149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) エンドポイント URL をオーバーライドします。カスタムリージョンの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock と同じ優先順位でリージョンを解決します](/docs/ja/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) エンドポイント URL をオーバーライドします。カスタムリージョンの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock と同じ優先順位でリージョンを解決します](/docs/ja/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) に必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) に必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |

151| `ANTHROPIC_BASE_URL` | API エンドポイントをオーバーライドして、プロキシまたはゲートウェイを通じてリクエストをルーティングします。ファーストパーティ以外のホストに設定されている場合、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで無効になります。プロキシが `tool_reference` ブロックを転送する場合は、`ENABLE_TOOL_SEARCH=true` を設定してください。v2.1.196 以降、[Remote Control](/docs/ja/remote-control#requirements) は、これが `api.anthropic.com` 以外のホストを指している場合は無効になり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry での動作と一致します |151| `ANTHROPIC_BASE_URL` | API エンドポイントをオーバーライドして、プロキシまたはゲートウェイを通じてリクエストをルーティングします。非ファーストパーティホストに設定されている場合、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで無効になります。プロキシが `tool_reference` ブロックを転送する場合は、`ENABLE_TOOL_SEARCH=true` を設定します。v2.1.196 以降、[リモートコントロール](/docs/ja/remote-control#requirements) は、これが `api.anthropic.com` 以外のホストを指している場合は無効になり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry での動作と一致します |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock エンドポイント URL をオーバーライドします。カスタム Amazon Bedrock エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock エンドポイント URL をオーバーライドします。カスタム Amazon Bedrock エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle エンドポイント URL をオーバーライドします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を参照してください |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle エンドポイント URL をオーバーライドします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を参照してください |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | クロスリージョン推論プロファイルプレフィックス(`us`、`eu`、`apac`、`jp`、`au`、または `global`)Claude Code が AWS リージョンから派生したものの代わりに最初に試します。AWS GovCloud リージョンでは無視されます。Claude Code v2.1.224 以降が必要です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照してください |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | クロスリージョン推論プロファイルプレフィックス(`us`、`eu`、`apac`、`jp`、`au`、または `global`)Claude Code が AWS リージョンから派生したものの代わりに最初に試します。AWS GovCloud リージョンでは無視されます。Claude Code v2.1.224 以降が必要です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照してください |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)(`default`、`flex`、または `priority`)。`X-Amzn-Bedrock-Service-Tier` ヘッダーとして送信されます。[Amazon Bedrock](/docs/ja/amazon-bedrock#service-tiers) を参照してください |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)(`default`、`flex`、または `priority`)。`X-Amzn-Bedrock-Service-Tier` ヘッダーとして送信されます。[Amazon Bedrock](/docs/ja/amazon-bedrock#service-tiers) を参照してください |

156| `ANTHROPIC_BETAS` | API リクエストに含める追加の `anthropic-beta` ヘッダー値のカンマ区切りリスト。Claude Code は既に必要なベータヘッダーを送信します。Claude Code がネイティブサポートを追加する前に [Anthropic API ベータ](https://platform.claude.com/docs/en/api/beta-headers) にオプトインするために使用します。[`--betas` フラグ](/docs/ja/cli-reference#cli-flags) とは異なり、API キー認証が必要ですが、この変数は Claude.ai サブスクリプションを含むすべての認証方法で機能します |156| `ANTHROPIC_BETAS` | API リクエストに含める追加の `anthropic-beta` ヘッダー値のカンマ区切りリスト。Claude Code は既に必要なベータヘッダーを送信します。Claude Code がネイティブサポートを追加する前に [Anthropic API ベータ](https://platform.claude.com/docs/en/api/beta-headers) にオプトインするために使用します。[`--betas` フラグ](/docs/ja/cli-reference#cli-flags) とは異なり、API キー認証が必要ですが、この変数は Claude.ai サブスクリプションを含むすべての認証方法で機能します |

157| `ANTHROPIC_CUSTOM_HEADERS` | リクエストに追加するカスタムヘッダー(`Name: Value` 形式、複数ヘッダーの場合は改行区切り)。名前または値に HTTP ヘッダーが処理できない文字(例えば、カーリークォートまたはゼロ幅スペース)が含まれている場合、リクエストは位置で対を識別するエラーで失敗します。Claude Code v2.1.227 以降が必要です。[無効なリクエストヘッダー値](/docs/ja/errors#invalid-request-header-value) は正確な文字セットとチェックが実行される場所をリストしています。`Authorization` または `Host` などの認証情報、組織またはテナント、ルーティング、または API 動作ヘッダーを設定する値は、サーバー管理設定がそれを配信する場合、[承認が必要な設定](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog) としてカウントされます。プロジェクトまたはローカル設定からは、そのような値は [`env` 値が適用される場合のルール](/docs/ja/settings-reference#when-claude-code-applies-env-values) に従います |157| `ANTHROPIC_CUSTOM_HEADERS` | リクエストに追加するカスタムヘッダー(`Name: Value` 形式、複数ヘッダーの場合は改行区切り)。名前または値に HTTP ヘッダーが処理できない文字(カーリークォートやゼロ幅スペースなど)が含まれている場合、リクエストは位置で識別されるペアを示すエラーで失敗します。Claude Code v2.1.227 以降が必要です。[無効なリクエストヘッダー値](/docs/ja/errors#invalid-request-header-value) は正確な文字セットとチェックが実行される場所をリストしています。`Authorization` や `Host` などの認証情報、組織またはテナント、ルーティング、または API 動作ヘッダーを設定する値は、サーバー管理設定がそれを配信する場合、[承認が必要な設定](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog) としてカウントされます。プロジェクトまたはローカル設定からは、そのような値は [`env` 値が適用される場合のルール](/docs/ja/settings-reference#when-claude-code-applies-env-values) に従います |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みエイリアスを置き換えずに、非標準またはゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option) を参照してください |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みエイリアスを置き換えずに、非標準またはゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option) を参照してください |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) 場合はモデルの名前を表示し、そうでない場合はモデル ID を表示します |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) 場合はエントリはモデルの名前を表示し、そうでない場合はモデル ID を表示します |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | カスタムモデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | カスタムモデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決するモデル ID、および Claude Code がサードパーティプロバイダーで [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) のために Fable モデルとして認識する ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決するモデル ID、および Claude Code がサードパーティプロバイダーで [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) のために Fable モデルとして認識する ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Fable モデルの表示説明。設定されていない場合、行は `Custom Fable model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Fable モデルの表示説明。設定されていない場合、行は `Custom Fable model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーのピン留めされた Fable モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーのピン留めされた Fable モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Fable モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Fable モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決するモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage) にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決するモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage) にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Haiku モデルの表示説明。設定されていない場合、行は `Custom Haiku model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Haiku モデルの表示説明。設定されていない場合、行は `Custom Haiku model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーのピン留めされた Haiku モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーのピン留めされた Haiku モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Haiku モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Haiku モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

170| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定](/docs/ja/model-config#set-a-default-model-for-new-sessions) を参照してください |170| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定](/docs/ja/model-config#set-a-default-model-for-new-sessions) を参照してください |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決するモデル ID、および Plan Mode がアクティブな場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決するモデル ID、および Plan Mode がアクティブな場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Opus モデルの表示説明。設定されていない場合、行は `Custom Opus model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Opus モデルの表示説明。設定されていない場合、行は `Custom Opus model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーのピン留めされた Opus モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーのピン留めされた Opus モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Opus モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Opus モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決するモデル ID、および Plan Mode がアクティブでない場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決するモデル ID、および Plan Mode がアクティブでない場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Sonnet モデルの表示説明。設定されていない場合、行は `Custom Sonnet model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Sonnet モデルの表示説明。設定されていない場合、行は `Custom Sonnet model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーのピン留めされた Sonnet モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーのピン留めされた Sonnet モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Sonnet モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Sonnet モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のフェデレーションルール ID。`ANTHROPIC_ORGANIZATION_ID` と一緒に設定すると、Claude Code はフェデレーション認証情報を選択します。これは `/login` 認証情報より上位にランクされます。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |179| `ANTHROPIC_FEDERATION_RULE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のフェデレーションルール ID。`ANTHROPIC_ORGANIZATION_ID` と一緒に設定すると、Claude Code はフェデレーション認証情報を選択します。これは `/login` 認証情報より上位にランクされます。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 認証用の API キー([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 認証用の API キー([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Foundry 認証用のベアラートークン。例えば、Microsoft Entra アクセストークン。Claude Code は `Authorization: Bearer` ヘッダーとして送信します。`ANTHROPIC_FOUNDRY_API_KEY` および Azure デフォルト認証情報チェーンより優先されます。[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。Claude Code v2.1.203 以降が必要です |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Foundry 認証用のベアラートークン。Microsoft Entra アクセストークンなど。Claude Code はそれを `Authorization: Bearer` ヘッダーとして送信します。`ANTHROPIC_FOUNDRY_API_KEY` および Azure デフォルト認証情報チェーンより優先されます。[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。Claude Code v2.1.203 以降が必要です |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL(例えば、`https://my-resource.services.ai.azure.com/anthropic`)。`ANTHROPIC_FOUNDRY_RESOURCE` の代替([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL(例:`https://my-resource.services.ai.azure.com/anthropic`)。`ANTHROPIC_FOUNDRY_RESOURCE` の代替([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry リソース名(例えば、`my-resource`)。`ANTHROPIC_FOUNDRY_BASE_URL` が設定されていない場合は必須([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry リソース名(例:`my-resource`)。`ANTHROPIC_FOUNDRY_BASE_URL` が設定されていない場合は必須([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |

184| `ANTHROPIC_MODEL` | 使用するモデル設定の名前([モデル設定](/docs/ja/model-config#environment-variables) を参照) |184| `ANTHROPIC_MODEL` | 使用するモデル設定の名前([モデル設定](/docs/ja/model-config#environment-variables) を参照) |

185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) の組織 ID。`ANTHROPIC_FEDERATION_RULE_ID` と一緒に設定します。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |185| `ANTHROPIC_ORGANIZATION_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) の組織 ID。`ANTHROPIC_FEDERATION_RULE_ID` と一緒に設定します。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |

186| `ANTHROPIC_PROFILE` | 認証するための Anthropic プロファイルの名前。例えば、[`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で作成されたもの、または [API キーなしで Console アカウントにサインイン](/docs/ja/authentication#sign-in-without-an-api-key) したもの。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |186| `ANTHROPIC_PROFILE` | 認証する Anthropic プロファイルの名前。[`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で作成されたもの、または [API キーなしで Console アカウントにサインイン](/docs/ja/authentication#sign-in-without-an-api-key) したもの。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[非推奨] [バックグラウンドタスク用の Haiku クラスモデル](/docs/ja/costs) の名前 |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[非推奨] [バックグラウンドタスク用の Haiku クラスモデル](/docs/ja/costs) の名前 |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock または Amazon Bedrock Mantle を使用する場合、Haiku クラスモデルの AWS リージョンをオーバーライドします。Amazon Bedrock では、`ANTHROPIC_DEFAULT_HAIKU_MODEL` または非推奨の `ANTHROPIC_SMALL_FAST_MODEL` も設定されている場合のみ有効になります。Amazon Bedrock はそれ以外の場合、[デフォルト Sonnet モデルまたはセッションリージョンのプライマリモデル](/docs/ja/amazon-bedrock#4-pin-model-versions) でバックグラウンドタスクを実行するためです |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock または Amazon Bedrock Mantle を使用する場合、Haiku クラスモデルの AWS リージョンをオーバーライドします。Amazon Bedrock では、`ANTHROPIC_DEFAULT_HAIKU_MODEL` または非推奨の `ANTHROPIC_SMALL_FAST_MODEL` も設定されている場合のみ有効になります。Amazon Bedrock はそれ以外の場合、バックグラウンドタスクをセッションリージョンの [デフォルト Sonnet モデルまたはプライマリモデル](/docs/ja/amazon-bedrock#4-pin-model-versions) で実行するため |

189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud の Agent Platform エンドポイント URL をオーバーライドします。カスタム Google Cloud の Agent Platform エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) を参照してください |189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud の Agent Platform エンドポイント URL をオーバーライドします。カスタム Google Cloud の Agent Platform エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) を参照してください |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud の Agent Platform リクエストが対象とする GCP プロジェクト ID。[GCP 認証情報を設定](/docs/ja/google-vertex-ai#3-configure-gcp-credentials) を参照してください |190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud の Agent Platform リクエストが対象とする GCP プロジェクト ID。[GCP 認証情報を設定](/docs/ja/google-vertex-ai#3-configure-gcp-credentials) を参照してください |

191| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールが複数のワークスペースにスコープされている場合、トークン交換がどのワークスペースをターゲットにするかを知るために設定します |191| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールが複数のワークスペースにスコープされている場合、トークン交換がどのワークスペースをターゲットにするかを知るために設定します |

192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーに対してオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーに対してオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |

193| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒単位)(デフォルト:600000、または 10 分;最大:2147483647)。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |193| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒単位)(デフォルト:600000、または 10 分;最大:2147483647)。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |

194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 認証用の API キー([Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照) |194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 認証用の API キー([Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照) |

195| `BASH_DEFAULT_TIMEOUT_MS` | 長時間実行される bash コマンドのデフォルトタイムアウト(デフォルト:120000、または 2 分) |195| `BASH_DEFAULT_TIMEOUT_MS` | 長時間実行される bash コマンドのデフォルトタイムアウト(デフォルト:120000、または 2 分) |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数(デフォルト:30000;最大:150000)。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数(デフォルト:30000;最大:150000)。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |

197| `BASH_MAX_TIMEOUT_MS` | モデルが長時間実行される bash コマンドに設定できる最大タイムアウト(デフォルト:600000、または 10 分)。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です |197| `BASH_MAX_TIMEOUT_MS` | モデルが長時間実行される bash コマンドに設定できる最大タイムアウト(デフォルト:600000、または 10 分)。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です |

198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) 用の OTLP エンドポイント:`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) の OTLP エンドポイント:`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) をローカルリポジトリをリモートから複製する代わりにバンドルしてアップロードするように強制するには、`1` に設定します |199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートから複製する代わりにローカルリポジトリをバンドルしてアップロードするように強制するには `1` に設定します |

200| `CLAUDECODE` | Claude Code が生成するサブプロセス(Bash および PowerShell ツール、tmux セッション、[hook](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス)で `1` に設定します。IDE 拡張機能は統合ターミナルでもこれを設定します。スクリプトが Claude Code によって生成されたサブプロセス内で実行されているかどうかを検出するために使用します。現在のプロセスがツール呼び出しまたはフック によって直接生成されたのか、Claude Code が開始した stdio MCP サーバー内ではなく、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用してください |200| `CLAUDECODE` | Claude Code が生成するサブプロセス(Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス)で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。Claude Code が生成したサブプロセス内でスクリプトが実行されているかどうかを検出するために使用します。Claude Code が開始した stdio MCP サーバー内ではなく、ツール呼び出しまたはフックによって直接生成されたプロセスであるかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

201| `CLAUDE_AFK_COUNTDOWN_MS` | 自動継続前に、未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログに画面上のカウントダウンが表示されるまでのミリ秒数。デフォルト `20000`(20 秒)。自動継続タイムアウトでキャップされます。自動継続がオンでない限り効果がありません;[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定および `CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必要です |201| `CLAUDE_AFK_COUNTDOWN_MS` | 自動継続前に、未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログに画面上のカウントダウンが表示されるまでのミリ秒数。デフォルト `20000`(20 秒)。自動継続タイムアウトでキャップされます。自動継続がオンでない限り効果がありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定と `CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必要です |

202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが自動継続されるまでのアイドル時間(ミリ秒単位)。自動継続はデフォルトでオフです;[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモと自動テスト用のオーバーライドです:設定されている場合、その設定より優先され、設定が設定されていない場合または `never` の場合でも自動継続をオンにします。`0` を設定してもタイムアウトはオフになりません;ダイアログを直ちに閉じます。v2.1.198 および v2.1.199 では、自動継続はデフォルトでオンで、`60000`(60 秒)タイムアウトでした。Claude Code v2.1.198 以降が必要です |202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが自動継続されるまでのアイドル時間(ミリ秒単位)。自動継続はデフォルトではオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモと自動テストのオーバーライドです:設定されている場合、その設定より優先され、設定が設定されていない場合または `never` の場合でも自動継続をオンにします。`0` を設定してもタイムアウトはオフになりません。ダイアログが直ちに閉じます。v2.1.198 および v2.1.199 では、自動継続はデフォルトでオンで、`60000`(60 秒)タイムアウトでした。Claude Code v2.1.198 以降が必要です |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [サブエージェント](/docs/ja/sub-agents) タイプ(Explore や Plan など)を無効にするには、`1` に設定します。非対話モード(`-p` フラグ)にのみ適用されます。SDK ユーザーが白紙の状態を望む場合に便利です。これにより、エージェントツール呼び出しが `subagent_type` を省略した場合に実行される `general-purpose` も削除されます。その場合、呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [サブエージェント](/docs/ja/sub-agents) タイプ(Explore や Plan など)を無効にするには `1` に設定します。非対話モード(`-p` フラグ)にのみ適用されます。SDK ユーザーが白紙の状態を望む場合に便利です。これにより、エージェントツール呼び出しが `subagent_type` を省略した場合に Claude Code が実行する `general-purpose` も削除されます。そのような呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには、`1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのスタルタイムアウト(ミリ秒単位)。デフォルト `600000`(10 分);`CLAUDE_STREAM_IDLE_TIMEOUT_MS` を上げながらストリーム監視犬がオンの場合、デフォルトは [遅いまたは停止した API 応答を処理](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されているように上昇します。タイマーはストリーミング進捗イベントごとにリセットされます;ウィンドウ内に進捗が到着しない場合、Claude Code はサブエージェントを中止し、スタルを親に報告します |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのスタルタイムアウト(ミリ秒単位)。デフォルト `600000`(10 分);`CLAUDE_STREAM_IDLE_TIMEOUT_MS` を上げながらストリーム監視犬がオンの場合、デフォルトは [遅いまたは停止した API 応答を処理](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されているように上昇します。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、Claude Code はサブエージェントを中止し、スタルを親に報告します |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動コンパクション がトリガーされる自動コンパクトウィンドウのパーセンテージ(1~100)を設定します。`50` などの低い値を使用して早期にコンパクトします;変数はしきい値を上げることはできないため、デフォルトパーセンテージを超える値は無視されます。[モデルのコンテキスト制限の前にコンパクト](/docs/ja/model-config#context-window-and-auto-compaction) するセッションにのみ適用されます。メイン会話とサブエージェントの両方に適用されます |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動コンパクション がトリガーされる自動コンパクトウィンドウのパーセンテージ(1~100)を設定します。`50` などの低い値を使用して早期にコンパクトします。変数はしきい値を上げることはできないため、デフォルトパーセンテージを超える値は無視されます。[モデルのコンテキスト制限の前にコンパクト](/docs/ja/model-config#context-window-and-auto-compaction) するセッションにのみ適用されます。メイン会話とサブエージェントの両方に適用されます |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには、`1` に設定します。有効にすると、サブエージェントは約 2 分間実行した後、バックグラウンドに移動されます。また、Claude Code v2.1.212 以降の非対話モードで [長い MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) を有効にします |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには `1` に設定します。有効にすると、サブエージェントは約 2 分間実行した後、バックグラウンドに移動されます。また、Claude Code v2.1.212 以降の非対話モードで [長い MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) も有効にします |

208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility#what-your-screen-reader-hears) では、カーソルが行の開始位置にある状態で、Claude Code が新しい行または変更された行を書き込む前に待機するミリ秒数。デフォルト `50`。`0` に設定して直ちに書き込みます。Claude Code は待機を `5000` でキャップします。Claude Code v2.1.233 以降が必要です |208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility#what-your-screen-reader-hears) では、カーソルが行の開始位置にある状態で、Claude Code が新しい行または変更された行を書き込む前に待機するミリ秒数。デフォルト `50`。`0` に設定して直ちに書き込みます。Claude Code は待機を `5000` でキャップします。Claude Code v2.1.233 以降が必要です |

209| `CLAUDE_AX_SCREEN_READER` | スクリーンリーダーフレンドリーな出力をレンダリングするには、`1` に設定します:装飾的なボーダーやアニメーションのないフラットテキスト。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でも、スクリーンリーダーモードを強制的にオフにするには `0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |209| `CLAUDE_AX_SCREEN_READER` | スクリーンリーダーフレンドリーな出力をレンダリングするには `1` に設定します:装飾的なボーダーやアニメーションのないフラットテキスト。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でも、スクリーンリーダーモードを強制的にオフにするには `0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility) では、スタートアップ確認行の後の最初のインターフェイスレンダリングを Claude Code が保持するミリ秒数。スクリーンリーダーが新しい出力が割り込む前に行全体を話すことができるようにします。デフォルト `3000`。`0` に設定して直ちにレンダリングします。Claude Code は保持を `600000`(10 分)でキャップします。最初のキーストロークが保持を早期に終了します。Claude Code v2.1.217 以降が必要です |210| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility) では、スタートアップ確認行の後の最初のインターフェイスレンダリングを Claude Code が保持するミリ秒数。スクリーンリーダーが新しい出力が割り込む前に行全体を話すことができるようにします。デフォルト `3000`。`0` に設定して直ちにレンダリングします。Claude Code は保持を `600000`(10 分)でキャップします。最初のキーストロークが保持を早期に終了します。Claude Code v2.1.217 以降が必要です |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | メインセッションの各 Bash または PowerShell コマンドの後、元の作業ディレクトリに戻ります |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | メインセッションの各 Bash または PowerShell コマンドの後、元の作業ディレクトリに戻ります |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルストリーミングアイドル監視犬のタイムアウト(ミリ秒単位);設定されている場合、その監視犬の `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルの監視犬は変更されません。Claude Code はこの変数を 10 秒~ 30 分の間にクランプします。Claude Code v2.1.210 以降が必要です |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルストリーミングアイドル監視犬のタイムアウト(ミリ秒単位);設定されている場合、その監視犬の `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベル監視犬は変更されません。Claude Code はこの変数を 10 秒~ 30 分の間にクランプします。Claude Code v2.1.210 以降が必要です |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | スクリーンロックリスナーなどの外部ツールが、スクリーンのロックを解除するときに作成し、ロックするときに削除するファイルへのパス。ファイルが存在する間、Claude Code は [Remote Control モバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications) をスキップするため、コンピューターをアクティブに使用している間はプッシュを受け取らなくなります。ファイルが存在しないか読み取り不可の場合、通知は通常どおり送信されます。Claude Code はプッシュトリガーイベントごとにファイルをチェックし、ポーリングしません。Claude Code v2.1.181 以降が必要です |213| `CLAUDE_CLIENT_PRESENCE_FILE` | スクリーンロックリスナーなどの外部ツールが、画面のロックを解除するときに作成し、ロックするときに削除するファイルへのパス。ファイルが存在する間、Claude Code は [リモートコントロールモバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications) をスキップするため、コンピューターをアクティブに使用している間はプッシュを受け取りません。ファイルが存在しないか読み取り不可の場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュトリガーイベントごとに 1 回チェックします。Claude Code v2.1.181 以降が必要です |

214| `CLAUDE_CODE_ACCESSIBILITY` | ネイティブターミナルカーソルを表示したままにし、反転テキストカーソルインジケーターを無効にするには、`1` に設定します。macOS Zoom などのスクリーンマグニファイアーがカーソル位置を追跡できるようにします |214| `CLAUDE_CODE_ACCESSIBILITY` | ネイティブターミナルカーソルを表示したままにし、反転テキストカーソルインジケーターを無効にするには `1` に設定します。macOS Zoom などのスクリーン拡大鏡がカーソル位置を追跡できるようにします |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir` で指定されたディレクトリからメモリファイルを読み込むには、`1` に設定します。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリはメモリファイルを読み込みません |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir` で指定されたディレクトリからメモリファイルを読み込むには `1` に設定します。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリはメモリファイルを読み込みません |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で増分更新を送信する代わりに、すべてのフレームで画面全体を再描画するには、`1` に設定します。フルスクリーンモードが古いテキストフラグメントまたは配置ずれを示す場合に使用します。Claude Code はバックグラウンドセッションおよび Windows の [エージェントビュー](/docs/ja/agent-view) に対してこれを自動的に有効にします |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で、増分更新を送信する代わりに、すべてのフレームで画面全体を再描画するには `1` に設定します。フルスクリーンモードが古いテキストフラグメントまたは配置ずれを示す場合に使用します。Claude Code はバックグラウンドセッションと Windows の [エージェントビュー](/docs/ja/agent-view) に対してこれを自動的に有効にします |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code がモデル ID を努力対応として認識しない場合でも、すべてのリクエストで [努力](/docs/ja/model-config#adjust-effort-level) パラメーターを送信するには、`1` に設定します。[LLM ゲートウェイ](/docs/ja/llm-gateway) またはカスタム識別子でモデルを提供するサードパーティプロバイダーを通じてルーティングする場合に使用します。Claude 3 モデル、Sonnet 4.0 および 4.5、Opus 4.0 および 4.1、Haiku 4.5 を含む、API で努力パラメーターを拒否するモデルは、リクエストが失敗しないように除外されます |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code がモデル ID を努力対応として認識しない場合でも、すべてのリクエストで [努力](/docs/ja/model-config#adjust-effort-level) パラメーターを送信するには `1` に設定します。[LLM ゲートウェイ](/docs/ja/llm-gateway) またはカスタム識別子の下でモデルを提供するサードパーティプロバイダーを通じてルーティングする場合に使用します。Claude 3 モデル、Sonnet 4.0 および 4.5、Opus 4.0 および 4.1、Haiku 4.5 を含む、API で努力パラメーターを拒否するモデルは、リクエストが失敗しないようにまだ除外されています |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報をリフレッシュする間隔(ミリ秒単位)([`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報をリフレッシュすべき間隔(ミリ秒単位)([`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 新しい [アーティファクト](/docs/ja/artifacts#create-an-artifact) が公開されたときに Claude Code がブラウザーを自動的に開くのを停止するには、`0` に設定します |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 新しい [アーティファクト](/docs/ja/artifacts#create-an-artifact) が公開されたときに Claude Code がブラウザーを自動的に開くのを停止するには `0` に設定します |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Claude が [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読み取り、返信するのを停止するには、`0` に設定します。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が [アーティファクトをオフ](/docs/ja/artifacts#availability) にした場合は効果がありません。Claude Code v2.1.221 以降が必要です |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読み取り、返信するのを停止するには `0` に設定します。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が [アーティファクトをオフ](/docs/ja/artifacts#availability) にした場合は効果がありません。Claude Code v2.1.221 以降が必要です |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Claude が [送信されたコメントに自動的に返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) するのを停止するには、`0` に設定します。Claude Code v2.1.228 以降が必要です |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Claude が [送信されたコメントに自動的に返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) するのを停止するには `0` に設定します。Claude Code v2.1.228 以降が必要です |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | [帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)(クライアントバージョンとプロンプトフィンガープリントを含む)をシステムプロンプトの開始から省略するには、`0` に設定します。Anthropic API への直接接続でのキャッシングはどちらの方法でも影響を受けません。一部の直接接続セットアップでは、Claude Code は [オートモード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器リクエストで `0` を設定した場合でもブロックをオンに保ちます。[システムプロンプト帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block) で、これがカバーする接続と認証情報を確認してください。v2.1.181 より前は、ブロックにはカスタムベース URL および Microsoft Foundry 接続でのリクエストごとのトークンが含まれていたため、LLM ゲートウェイがリクエスト本体でキャッシュするか、リクエストをサードパーティプロバイダーに転送する場合、またはMicrosoft Foundry に直接接続する場合は、これらのバージョンで `0` に設定します |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | [属性ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)(クライアントバージョンとプロンプトフィンガープリントを含む)をシステムプロンプトの開始から省略するには `0` に設定します。Anthropic API への直接接続でのキャッシングは、どちらの方法でも影響を受けません。一部の直接接続セットアップでは、Claude Code は `0` を設定した場合でも [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器リクエストでブロックをオンに保ちます。[システムプロンプト属性ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block) で、これがカバーする接続と認証情報を確認してください。v2.1.181 より前は、ブロックはカスタムベース URL と Microsoft Foundry 接続でリクエストごとのトークンを含んでいたため、これらのバージョンでは、LLM ゲートウェイがリクエスト本体でキャッシュするか、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合は `0` に設定します |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な場合、Claude に [バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) がまだ実行されているかをチェックするよう促すリマインダー間の秒数。`1` ~ `86400` のプレーンな整数のみを受け入れます;その他の値または表記は設定されていないものとして読み取られます。設定されていない場合、チェックインリマインダーはありません。Claude Code v2.1.248 以降が必要です |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な場合、Claude に [バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) がまだ実行されているかどうかを確認するよう促すリマインダー間の秒数。`1` ~ `86400` の範囲の平文整数のみを受け入れます。他の値またはスペルは設定されていないものとして読み取られます。設定されていない場合、チェックインリマインダーはありません。Claude Code v2.1.248 以降が必要です |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動コンパクトウィンドウ](/docs/ja/model-config#set-the-auto-compact-window) をトークン単位で設定します。`100000` ~ `1000000`。`500000` などのプレーンな整数のみを受け入れます:`500k` などの値は `500` として読み取られ、100K 最小値にクランプされます。有効なウィンドウはモデルのコンテキストウィンドウでもキャップされます。`/autocompact` コマンド、`--autocompact` フラグ、および `autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルの完全なコンテキストウィンドウに対して測定されるため、この変数が設定されると、そのパーセンテージはコンパクションが実行されるときを示さなくなります |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動コンパクトウィンドウ](/docs/ja/model-config#set-the-auto-compact-window) をトークン単位で設定します。`100000` ~ `1000000`。`500000` などの平文整数のみを受け入れます:`500k` などの値は `500` として読み取られ、100K 最小値にクランプされます。有効なウィンドウはモデルのコンテキストウィンドウでもキャップされます。`/autocompact` コマンド、`--autocompact` フラグ、および `autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルの完全なコンテキストウィンドウに対して測定されるため、この変数が設定されると、そのパーセンテージはコンパクションが実行されるときを示さなくなります |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) をオーバーライドします。デフォルトでは、Claude Code はサポートされている IDE の統合ターミナル内で起動されたときに自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠すなど、自動検出が失敗した場合に接続を試みるように強制するには `true` に設定します。グローバル設定の [`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) より優先されます |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) をオーバーライドします。デフォルトでは、Claude Code はサポートされている IDE の統合ターミナル内で起動されたときに自動的に接続されます。これを防ぐには `false` に設定します。tmux が親ターミナルを隠すなど、自動検出が失敗した場合に接続を試みるように強制するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [オートモードアクションをレビュー](/docs/ja/permission-modes#server-side-classifier-review) するよう要求するかどうかを制御します。`0` に設定して、代わりに Claude Code 独自の分類器リクエストを使用します。Anthropic API への直接接続では、v2.1.281 以降が必要です。リンクされたセクションは、変数が設定されていない場合にサーバーを要求するセッションと、どのバージョンからかをリストしています。Claude Code v2.1.271 以降が必要です |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [自動モードアクションをレビュー](/docs/ja/permission-modes#server-side-classifier-review) するよう要求するかどうかを制御します。Claude Code 独自の分類器リクエストを使用するには `0` に設定します。Anthropic API への直接接続では、v2.1.281 以降が必要です。リンクされたセクションは、変数が設定されていない場合にどのセッションがサーバーに要求するか、およびどのバージョンからかをリストしています。Claude Code v2.1.271 以降が必要です |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code が AWS デフォルト認証情報プロバイダーチェーンが認証情報を生成するのを待つ時間(ミリ秒単位)。その後、リクエストは [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗します(デフォルト:`60000`)。チェーン内のステップが正当に長い時間を必要とする場合は増加させます。例えば、`aws-vault` などのラッパーを通じた MFA を使用したブラウザベースの SSO サインイン。[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) でデフォルトチェーンで署名する Claude Code のすべての場所に適用されます。Claude Code v2.1.207 以降が必要です |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code がリクエストが [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗する前に AWS デフォルト認証情報プロバイダーチェーンが認証情報を生成するのを待つ時間(ミリ秒単位)(デフォルト:`60000`)。MFA を使用したブラウザベースの SSO サインインなど、チェーン内のステップが正当に長い時間を必要とする場合は増加させます。Claude Code がデフォルトチェーンで署名する場所に適用されます:[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必要です |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Bash コマンドの実行中に変更されたファイルの [差分](/docs/ja/hooks#bash) をオフにするには `0` に設定するか、すべての権限モードで記録するには `1` に設定します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | [Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash) をオフにするには `0` に設定するか、すべての権限モードで記録するには `1` に設定します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 非対話セッションがバックグラウンド作業がまだ実行されている場合でも、ターン終了時にホストにアイドルステータスを報告するには、`0` に設定します。デフォルトでは、セッションはバックグラウンド作業(バックグラウンドエージェントや [ワークフロー](/docs/ja/workflows) 実行など)がまだ実行されている間、ターン終了を過ぎて実行ステータスを報告し続けます。これにより、セッションリストなどのステータスを監視するホストが、Claude が作業中にあなたの入力を待っていることを発表するのを防ぎます。バックグラウンドシェルコマンド(開発サーバーなど)は実行ステータスを保持しません。実行ステータスのデフォルトと `0` オプトアウトには Claude Code v2.1.269 以降が必要です;以前のバージョンでは、バックグラウンドステータスを保持するには `1` を設定します |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | バックグラウンド作業がまだ実行されている場合でも、非対話セッションがターンエンドでホストにアイドルステータスを報告するには `0` に設定します。デフォルトでは、セッションはバックグラウンド作業(バックグラウンドエージェントや [ワークフロー](/docs/ja/workflows) 実行など)がまだ実行されている間、ターンエンド後も実行ステータスを報告し続けます。これにより、セッションリストなどのステータスを監視するホストが、Claude が作業中に入力を待機していることを発表するのを防ぎます。バックグラウンドシェルコマンド(開発サーバーなど)は実行ステータスを保持しません。実行ステータスのデフォルトと `0` オプトアウトには Claude Code v2.1.269 以降が必要です。以前のバージョンでは、実行ステータスを保持するには `1` を設定します |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | セッションがアクティブな [Remote Control](/docs/ja/remote-control) 接続を持っている間、Bash ツールおよび [hook コマンド](/docs/ja/hooks) サブプロセスで自動的に設定され、接続が終了すると削除されます。値はセッションの ID(`session_` 形式)で、セッションの `claude.ai/code` URL に表示される同じ識別子です。スクリプトはそれを実行したセッションにリンクバックできます。Claude Code v2.1.199 以降が必要です。[クラウドセッション](/docs/ja/claude-code-on-the-web) では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ります |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | セッションがアクティブな [リモートコントロール](/docs/ja/remote-control) 接続を持っている間、Bash ツールおよび [フックコマンド](/docs/ja/hooks) サブプロセスで自動的に設定され、接続が終了すると削除されます。値はセッションの ID(`session_` 形式)で、セッションの `claude.ai/code` URL に表示される同じ識別子であるため、スクリプトはそれを実行したセッションにリンクバックできます。Claude Code v2.1.199 以降が必要です。[クラウドセッション](/docs/ja/claude-code-on-the-web) では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ります |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Claude Code が `0x08` バイト(`^H` とも書かれます)をプレーンバックスペースとして読み取るには `0` に設定するか、Ctrl+Backspace として読み取るには `1` に設定します。どちらの値もプラットフォームのデフォルトを置き換えます。デフォルトでは、Claude Code は Windows で Ctrl+Backspace として読み取ります。ただし、`TERM_PROGRAM` が `mintty` または `TERM` が `cygwin` の場合を除き、macOS および Linux ではプレーンバックスペースとして読み取ります。Windows ターミナルで [Backspace が単語全体を削除](/docs/ja/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) する場合は `0` に設定します |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Claude Code が `0x08` バイト(`^H` とも書かれる)をプレーンバックスペースとして読み取るには `0` に設定するか、Ctrl+Backspace として読み取るには `1` に設定します。どちらの値もプラットフォームのデフォルトを置き換えます。デフォルトでは、Claude Code は Windows で Ctrl+Backspace として読み取ります。ただし、`TERM_PROGRAM` が `mintty` または `TERM` が `cygwin` の場合を除き、macOS および Linux ではプレーンバックスペースとして読み取ります。Windows ターミナルで [Backspace が単語全体を削除](/docs/ja/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) する場合は `0` に設定します |

232| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアで、`tls.getCACertificates` を持つランタイムでのみ読み取られます:ネイティブバイナリ、または npm インストール用の Node 22.15 以降。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |232| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セット。`system` はオペレーティングシステムの信頼ストアで、`tls.getCACertificates` を持つランタイムでのみ読み取られます:ネイティブバイナリ、または npm インストール用の Node 22.15 以降。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |

233| `CLAUDE_CODE_CHILD_SESSION` | Bash、PowerShell、Monitor ツール、[hook](/docs/ja/hooks) コマンド、および [ステータスライン](/docs/ja/statusline) コマンドを通じて Claude Code が生成するサブプロセスで `1` に設定されます。stdio [MCP サーバー](/docs/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらを生成したセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 自体がサブプロセスを起動するときのみ設定され、IDE 拡張機能では設定されないため、ネストされたセッションを IDE 統合ターミナルで起動されたトップレベルの `claude` から確実に区別します。この方法で開始されたネストされた対話型 `claude` TUI は、`--resume`、`--continue`、上矢印履歴、および `claude agents` リストから自動的に除外されます。非対話型 `claude -p` セッションは引き続き永続化されます。このセッションを除外をオーバーライドするには、`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定します。Claude Code v2.1.172 以降が必要です |233| `CLAUDE_CODE_CHILD_SESSION` | Bash、PowerShell、Monitor ツール、[フック](/docs/ja/hooks) コマンド、および [ステータスライン](/docs/ja/statusline) コマンドを通じて Claude Code が生成するサブプロセスで `1` に設定されます。stdio [MCP サーバー](/docs/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらを生成したセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 自体がサブプロセスを起動するときのみ設定され、IDE 拡張機能では設定されないため、ネストされたセッションをトップレベルの `claude` と確実に区別します。IDE 統合ターミナルで起動されたネストされたインタラクティブ `claude` TUI は、`--resume`、`--continue`、上矢印履歴、および `claude agents` リストから自動的に除外されます。非対話的な `claude -p` セッションは依然として永続化されます。この除外をオーバーライドするには `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定します。Claude Code v2.1.172 以降が必要です |

234| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |234| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |

235| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |235| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(オプション) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(オプション) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は no-op です。以前は、ストリーミング API リクエストの接続、TLS、応答ヘッダーフェーズの個別タイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストの応答ヘッダーフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は no-op です。以前は、ストリーミング API リクエストの接続、TLS、応答ヘッダーフェーズの個別タイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストの応答ヘッダーフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルパスをオーバーライドします。名前に関わらず、これはディレクトリではなくファイルパスです。デバッグモードは `--debug`、`/debug`、または `DEBUG` 環境変数を通じて別途有効にする必要があります:この変数を設定するだけではログが有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に実行します。デフォルトは `~/.claude/debug/<session-id>.txt` です |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルパスをオーバーライドします。名前に反して、これはディレクトリではなくファイルパスです。デバッグモードは `--debug`、`/debug`、または `DEBUG` 環境変数を通じて別途有効にする必要があります:この変数を設定するだけではログが有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に実行します。デフォルトは `~/.claude/debug/<session-id>.txt` です |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。フルステータスラインコマンド出力などの大量の診断を含めるには `verbose` に設定するか、ノイズを減らすには `error` に上げます |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。フルステータスラインコマンド出力などの大量の診断を含めるには `verbose` に設定するか、ノイズを減らすには `error` に上げます |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M コンテキストウィンドウ](/docs/ja/model-config#extended-context) サポートを無効にするには、`1` に設定します。設定されている場合、1M モデルバリアントはモデルピッカーで利用できず、Claude Code は [Sonnet 5.5](/docs/ja/model-config#sonnet-5-5-and-sonnet-5-context-window) などのネイティブ 1M ウィンドウを持つモデルおよび Fable モデルのセッションを 200K ウィンドウに保持します;[拡張コンテキスト](/docs/ja/model-config#extended-context) でホールドがどのように実装されるかを参照してください。コンプライアンス要件を持つエンタープライズ環境に便利です。認識されない `[1m]` モデル ID のウィンドウを修正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M コンテキストウィンドウ](/docs/ja/model-config#extended-context) サポートを無効にするには `1` に設定します。設定されている場合、1M モデルバリアントはモデルピッカーで利用できず、Claude Code は [Sonnet 5.5](/docs/ja/model-config#sonnet-5-5-and-sonnet-5-context-window) や Fable モデルなど、ネイティブ 1M ウィンドウを持つモデルのセッションを 200K ウィンドウに保持します。[拡張コンテキスト](/docs/ja/model-config#extended-context) を参照して、保持がどのように実装されるかを確認してください。エンタープライズ環境でコンプライアンス要件がある場合に便利です。認識されない `[1m]` モデル ID のウィンドウを修正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 および Sonnet 4.6 で [適応的推論](/docs/ja/model-config#adjust-effort-level) を無効にし、`MAX_THINKING_TOKENS` で制御される固定思考予算にフォールバックするには、`1` に設定します。[Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5 以降、または Opus 4.7 以降には効果がありません。これらは常に適応的推論を使用します |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 および Sonnet 4.6 で [適応的推論](/docs/ja/model-config#adjust-effort-level) を無効にし、`MAX_THINKING_TOKENS` で制御される固定思考予算にフォールバックするには `1` に設定します。[Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5 以降、または Opus 4.7 以降には効果がありません。これらは常に適応的推論を使用します |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Claude Code が [管理設定](/docs/ja/managed-settings#precedence-within-the-managed-tier) `env` ブロックをキーごとにマージするのを停止し、v2.1.223 より前のように最高優先度ソースの全体 `env` ブロックのみが適用されるようにするには、`1` に設定します。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するためです。Claude Code v2.1.223 以降が必要です |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Claude Code が [管理設定](/docs/ja/managed-settings#precedence-within-the-managed-tier) `env` ブロックをキーごとにマージするのを停止し、v2.1.223 より前のように最高優先度ソースの全体 `env` ブロックのみが適用されるようにするには `1` に設定します。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するため。Claude Code v2.1.223 以降が必要です |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [アドバイザーツール](/docs/ja/advisor) を無効にするには、`1` に設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け入れられますが効果がないため、既存のスクリプトがそれを渡し続けてもエラーなく機能します |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [アドバイザーツール](/docs/ja/advisor) を無効にするには `1` に設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け入れられますが効果がないため、既存のスクリプトがそれを渡し続けてもエラーなく機能します |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view) をオフにするには、`1` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view) をオフにするには `1` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を無効にし、クラシックメインスクリーンレンダラーを使用するには、`1` に設定します。会話はターミナルのネイティブスクロールバックに留まるため、`Cmd+f` と tmux コピーモードが通常どおり機能します。`CLAUDE_CODE_NO_FLICKER` および [`tui`](/docs/ja/settings-reference#tui) 設定より優先されます。`/tui default` で切り替えることもできます。[エージェントビュー](/docs/ja/agent-view) から開かれたバックグラウンドセッションには適用されません。これらは常にフルスクリーンレンダリングを使用します |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を無効にし、クラシックメインスクリーンレンダラーを使用するには `1` に設定します。会話はターミナルのネイティブスクロールバックに留まるため、`Cmd+f` と tmux コピーモードが通常どおり機能します。`CLAUDE_CODE_NO_FLICKER` および [`tui`](/docs/ja/settings-reference#tui) 設定より優先されます。`/tui default` で切り替えることもできます。[エージェントビュー](/docs/ja/agent-view) から開かれたバックグラウンドセッションには適用されません。これらは常にフルスクリーンレンダリングを使用します |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | [アーティファクト](/docs/ja/artifacts) ツールをオフにするには、`1` に設定します。これは claude.ai でセッション出力をプライベート Web ページとして公開します。設定されると、設定ファイルはツールをオンに戻しません。代わりに設定ファイルからツールをオフにするには、[`enableArtifact`](/docs/ja/settings-reference#enableartifact) を `false` に設定します;非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) キーもそれをオフにします |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | [アーティファクト](/docs/ja/artifacts) ツールをオフにするには `1` に設定します。これは claude.ai でセッション出力をプライベート Web ページとして公開します。設定されると、設定ファイルはツールをオンに戻しません。代わりに設定ファイルからツールをオフにするには、[`enableArtifact`](/docs/ja/settings-reference#enableartifact) を `false` に設定します。非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) キーもツールをオフにします |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには、`1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開されるのではなくプレーンテキストとして送信されます |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには `1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開されるのではなく、プレーンテキストとして送信されます |

248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [自動メモリ](/docs/ja/memory#auto-memory) を無効にするには、`1` に設定します。`--bare` モードまたは [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) が自動メモリを無効にする場合でも、自動メモリをオンに強制するには `0` に設定します。無効にされている場合、Claude は自動メモリファイルを作成または読み込みません |248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [自動メモリ](/docs/ja/memory#auto-memory) を無効にするには `1` に設定します。`--bare` モードまたは [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) が無効にする場合でも、自動メモリを強制的にオンにするには `0` に設定します。無効にされている場合、Claude は自動メモリファイルを作成または読み込みません |

249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にするには、`1` に設定します |249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にするには `1` に設定します |

250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Claude Code が [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答を、`Content-Type` ヘッダーが欠落または空の Amazon Bedrock バイナリイベントストリームとして扱うのを停止するには、`1` に設定します。デフォルトでは、Claude Code はゲートウェイがそれ以外は変更されていない応答からヘッダーをドロップしたと想定するため、本体をデコードしてストリーミングが機能し続けます。これはレスポンスをサーバー送信イベントとして再発行するゲートウェイの場合のみ設定します;Claude Code はヘッダーレス本体をサーバー送信イベントとして読み取ります。Claude Code v2.1.239 以降が必要です |250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Claude Code が [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答を、欠落または空の `Content-Type` ヘッダーを持つ Amazon Bedrock のバイナリイベントストリームとして扱うのを停止するには `1` に設定します。デフォルトでは、Claude Code はゲートウェイがそれ以外は変更されていない応答からヘッダーをドロップしたと仮定するため、本体をデコードしてストリーミングが機能し続けます。ゲートウェイがストリームをサーバー送信イベントとして再発行する場合のみ設定します。Claude Code はヘッダーレス本体をサーバー送信イベントとして読み取ります。Claude Code v2.1.239 以降が必要です |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答が `application/vnd.amazon.eventstream` コンテンツタイプを持つかどうかをチェックするのをスキップするには、`1` に設定します。この変数がない場合、応答が異なるコンテンツタイプを持つと、Claude Code はそのタイプを名前で指定するエラーでリクエストを失敗させます。これは [ゲートウェイまたはプロキシが応答を変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) ことを意味します。この変数を設定する代わりに、`Content-Type` ヘッダーと本体を変更されていない状態で転送するようにゲートウェイを設定します。Claude Code v2.1.208 以降が必要です |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答が `application/vnd.amazon.eventstream` コンテンツタイプを持つかどうかのチェックをスキップするには `1` に設定します。この変数がない場合、応答が異なるコンテンツタイプを持つと、Claude Code はそのタイプを名前で示すエラーでリクエストを失敗させます。これは [ゲートウェイまたはプロキシが応答を変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) ことを意味します。この変数を設定する代わりに、ゲートウェイを設定して `Content-Type` ヘッダーと本体を変更されていない状態で転送します。Claude Code v2.1.208 以降が必要です |

252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | [バックグラウンドセッション](/docs/ja/agent-view) の実行中のバックグラウンドシェルコマンド、動的ワークフロー、および v2.1.198 以降のバックグラウンドサブエージェントが [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) がそのセッションのプロセスを停止、再起動、または更新するときに停止するのを停止するには、`1` に設定します。セッションの次のプロセスに引き継ぐ代わりに。このハンドオフのみに影響します:`←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化すると、進行中の作業が引き継がれます。`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必要です |252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | [バックグラウンドセッション](/docs/ja/agent-view) の実行中のバックグラウンドシェルコマンド、動的ワークフロー、および v2.1.198 以降のバックグラウンドサブエージェントが [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) がそのセッションのプロセスを停止、再起動、または更新するときに停止するのを停止するには `1` に設定します。セッションの次のプロセスへの引き継ぎのみに影響します:`←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化すると、進行中の作業が引き継がれ、`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必要です |

253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Claude Code がメモリ圧力下で [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) を終了するのを停止するには、`1` に設定します。デフォルトでは、macOS および Linux では、オペレーティングシステムが重大なメモリ圧力を報告し、セッションが 30 分間アイドル状態で、ターンまたはサブエージェントが実行されていない場合、Claude Code はバックグラウンドシェルを終了します。Windows にはメモリ圧力信号がないため、この変数は効果がありません。Claude Code v2.1.193 以降が必要です |253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | メモリ圧力下で [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) を終了するのを停止するには `1` に設定します。デフォルトでは、macOS および Linux では、オペレーティングシステムが重大なメモリ圧力を報告し、セッションが 30 分間アイドル状態で、ターンまたはサブエージェントが実行されていない場合、Claude Code はバックグラウンドシェルを終了します。Windows にはメモリ圧力信号がないため、この変数は効果がありません。Claude Code v2.1.193 以降が必要です |

254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に含まれる [スキル](/docs/ja/skills) とワークフローを無効にするには、`1` に設定します:バンドルされたスキルとワークフローは完全に削除されます。一方、`/init` などの組み込みコマンドは入力可能なままですが、モデルから非表示になります。`/doctor` は組み込みコマンドのように入力可能なままです;代わりに `DISABLE_DOCTOR_COMMAND` で非表示にします。プラグイン、`.claude/skills/`、および `.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 設定と同等です |254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に含まれる [スキル](/docs/ja/skills) とワークフローを無効にするには `1` に設定します:バンドルされたスキルとワークフローは完全に削除されますが、`/init` などの組み込みコマンドは入力可能なままですが、モデルから非表示になります。`/doctor` は組み込みコマンドのように入力可能なままです。代わりに `DISABLE_DOCTOR_COMMAND` で非表示にします。プラグイン、`.claude/skills/`、および `.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 設定と同等です |

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | [Claude in Chrome](/docs/ja/chrome) ブラウザーツールを利用可能に保ちながら、システムプロンプトの Chrome セクションと `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills) を省略するには、`1` に設定します。Claude Code を埋め込み、独自のブラウザーガイダンスを提供するホスト向け。Claude Code v2.1.257 以降が必要です |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | [Chrome の Claude](/docs/ja/chrome) ブラウザーツールを利用可能に保ちながら、システムプロンプトの Chrome セクションと `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills) を省略するには `1` に設定します。Claude Code を埋め込み、独自のブラウザーガイダンスを提供するホスト向け。Claude Code v2.1.257 以降が必要です |

256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | CLAUDE.md メモリファイル(ユーザー、プロジェクト、自動メモリファイルを含む)をコンテキストに読み込むのを防ぐには、`1` に設定します |256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | ユーザー、プロジェクト、自動メモリファイルを含む、CLAUDE.md メモリファイルの読み込みを防ぐには `1` に設定します |

257| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/docs/ja/scheduled-tasks) を無効にするには、`1` に設定します。`/loop` スキルと cron ツールは利用できなくなり、既にスケジュール済みのタスク(セッション中に既に実行されているタスクを含む)は発火を停止します |257| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/docs/ja/scheduled-tasks) を無効にするには `1` に設定します。`/loop` スキルと cron ツールは利用できなくなり、既にスケジュール済みのタスクは停止します。既に実行中のタスクを含みます |

258| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | [重要パス削除](/docs/ja/permission-modes#critical-paths) プロンプトの時間制限をオフにするには、`1` に設定します。`auto` モードでは Claude Code はこれらの削除を分類器に送信し、`bypassPermissions` モードではプロンプトはあなたの回答を待ちます。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するためです。Claude Code v2.1.281 以降が必要です |258| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | [重要パス削除](/docs/ja/permission-modes#critical-paths) プロンプトの時間制限をオフにするには `1` に設定します。`auto` モードでは Claude Code はこれらの削除を分類器に送信し、`bypassPermissions` モードではプロンプトが回答を待ちます。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するため。Claude Code v2.1.281 以降が必要です |

259| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーと `defer_loading` および `eager_input_streaming` などのベータツールスキーマフィールドを API リクエストから削除するには、`1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」または「追加入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド(`name`、`description`、`input_schema`、`cache_control`)は保持されます。[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) は無効になり、すべての MCP ツールは、`ENABLE_TOOL_SEARCH` を設定した場合でも事前に読み込まれます。Claude Code v2.1.227 以降では、[管理設定](/docs/ja/managed-settings) はツール検索をオンに保つことができます。[プリリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) はオーバーライドが適用される場所をカバーしています |259| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーとベータツールスキーマフィールド(`defer_loading` や `eager_input_streaming` など)を API リクエストから削除するには `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」や「追加入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド(`name`、`description`、`input_schema`、`cache_control`)は保持されます。[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) は無効になり、すべての MCP ツールは、この変数を設定した場合でも事前にロードされます。Claude Code v2.1.227 以降では、[管理設定](/docs/ja/managed-settings) はツール検索をオンに保つことができます。[プリリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) はオーバーライドが適用される場所をカバーしています |

260| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 組み込み [Explore および Plan サブエージェント](/docs/ja/sub-agents#built-in-subagents) を無効にするには、`1` に設定します。Claude は検索ツールまたは汎用サブエージェントで探索し、[プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) はファイルを直接読み取り、Explore および Plan エージェントを起動しません。`Explore` または `Plan` という名前のカスタムサブエージェントは影響を受けません。Agent SDK または非対話モードのすべての組み込みサブエージェントタイプを削除するには、`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用します。Claude Code v2.1.198 以降が必要です |260| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 組み込み [Explore および Plan サブエージェント](/docs/ja/sub-agents#built-in-subagents) を無効にするには `1` に設定します。Claude は検索ツールまたは汎用サブエージェントで探索し、[プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) はファイルを直接読み取り、Explore および Plan エージェントを起動しません。`Explore` または `Plan` という名前のカスタムサブエージェントは影響を受けません。Agent SDK または非対話モードのすべての組み込みサブエージェントタイプを削除するには、代わりに `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用します。Claude Code v2.1.198 以降が必要です |

261| `CLAUDE_CODE_DISABLE_FAST_MODE` | [高速モード](/docs/ja/fast-mode) を無効にするには、`1` に設定します |261| `CLAUDE_CODE_DISABLE_FAST_MODE` | [高速モード](/docs/ja/fast-mode) を無効にするには `1` に設定します |

262| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 「Claude はどのように機能していますか?」セッション品質調査を無効にするには、`1` に設定します。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合、調査も無効になります。ただし、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` がオプトバックインしない限り。完全に無効にする代わりにサンプルレートを設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質調査](/docs/ja/data-usage#session-quality-surveys) を参照してください |262| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 「Claude はどのように機能していますか?」セッション品質調査を無効にするには `1` に設定します。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合、調査も無効になります。ただし、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` がオプトバックインしない限り。完全に無効にする代わりにサンプルレートを設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質調査](/docs/ja/data-usage#session-quality-surveys) を参照してください |

263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには、`1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |

264| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 組み込みコミットおよび PR ワークフロー指示と git ステータススナップショットを Claude のコンテキストから削除するには、`1` に設定します。独自の git ワークフロースキルを使用する場合に便利です。[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定が設定されている場合、これが優先されます |264| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 組み込みコミットおよび PR ワークフロー指示と git ステータススナップショットを Claude のコンテキストから削除するには `1` に設定します。独自の git ワークフロースキルを使用する場合に便利です。設定されている場合、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |

265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐには、`1` に設定します。古いモデルを意図的にピン留めする場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐには `1` に設定します。古いモデルを意図的にピン留めしたい場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |

266| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには、`1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |266| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |

267| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには、`1` に設定します。ホイールスクロールが Claude Code 内で機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにする場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |267| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには `1` に設定します。ホイールスクロールが Claude Code 内で機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにしたい場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |

268| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | API リクエストが接続リセットまたは TLS ハンドシェイクエラーなどの接続レベルエラーで失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには、`1` に設定します。リロードが無効になっている場合、Claude Code は設定を次に適用するか、次のスタートアップ時にのみ回転されたファイルを読み込みます。Claude Code v2.1.232 以降が必要です |268| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで API リクエストが失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには `1` に設定します。リロードが無効な場合、Claude Code は回転されたファイルを次に設定を適用するか、次のスタートアップ時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |

269| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 非必須ネットワークトラフィックを無効にするには、`1` などの空でない値に設定します:自動更新、テレメトリ、エラー報告、`/feedback` コマンド、[Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)、リリースノート、[PR および MR ステータスバッジ](/docs/ja/interactive-mode#pr-review-status) チェック、[高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) チェックなどの可用性チェック。また、[プラグイン `command` ソースのバックグラウンド実行](/docs/ja/plugins/loading#when-a-command-source-re-runs) を停止します。これらはネットワークトラフィックではなくローカルコマンドですが、依存関係のインストールをトリガーできます。**`0` または `false` に設定してもこのトラフィックは無効になります**。ほとんどのオン/オフ変数とは異なり;変数を設定解除してそれを再度許可します。また、機能フラグ取得を無効にします。これにより、[Remote Control](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。公式プラグインマーケットプレイスの自動インストールはカバーされていません;`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` で無効にします。[ゲートウェイモデル検出](/docs/ja/llm-gateway-connect#add-gateway-models-to-the-model-picker) には影響しません。これには独自のオプトインがあります |269| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 非必須ネットワークトラフィックを無効にするには、`1` などの空でない値に設定します:自動更新、テレメトリ、エラー報告、`/feedback` コマンド、[Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)、リリースノート、[PR および MR ステータスバッジ](/docs/ja/interactive-mode#pr-review-status) チェック、[高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) チェックなどの可用性チェック。また、[プラグイン `command` ソースのバックグラウンド実行](/docs/ja/plugins/loading#when-a-command-source-re-runs) を停止します。これらはネットワークトラフィックではなくローカルコマンドですが、依存関係のインストールをトリガーできます。**`0` または `false` に設定してもこのトラフィックは無効になります**。ほとんどのオン/オフ変数とは異なり、変数を設定解除してもう一度許可します。また、機能フラグ取得を無効にします。これにより、[リモートコントロール](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。公式プラグインマーケットプレイスの自動インストールはカバーされていません。`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` で無効にします。[ゲートウェイモデル検出](/docs/ja/llm-gateway-connect#add-gateway-models-to-the-model-picker) には影響しません。これには独自のオプトインがあります |

270| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | ストリーミングリクエストがストリーム中に失敗した場合、非ストリーミングフォールバックを無効にするには、`1` に設定します。ストリーミングエラーは再試行レイヤーに代わりに伝播されます。プロキシまたはゲートウェイがフォールバックで重複したツール実行を生成する場合に便利です |270| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | ストリーミングリクエストがストリーム中に失敗した場合、非ストリーミングフォールバックを無効にするには `1` に設定します。ストリーミングエラーは再試行レイヤーに代わりに伝播されます。プロキシまたはゲートウェイがフォールバックで重複したツール実行を生成する場合に便利です |

271| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | ターミナルで入力または焦点を当てている間でも、`PushNotification` ツールのデスクトップ通知を送信するには、`1` に設定します。デフォルトでは、ツールは最近のキーボード活動またはターミナルフォーカスを検出すると、デスクトップ通知と [モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications) の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、サーバーはあなたがアクティブであることを検出したときにモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |271| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | ターミナルで入力または焦点を当てている間でも、`PushNotification` ツールのデスクトップ通知を送信するには `1` に設定します。デフォルトでは、ツールは最近のキーボード活動またはターミナルフォーカスを検出すると、デスクトップ通知と [モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications) の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、サーバーはアクティブであることを検出したときにモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |

272| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 公式プラグインマーケットプレイスの自動登録を無効にするには、`1` に設定します。Claude Code はマーケットプレイスを登録しようとしているときに変数を読み取ります。通常、マシンの最初の対話的起動中です。その時点で変数が設定されている場合、Claude Code は登録を永続的にスキップします。後で変数を設定解除してもスキップは元に戻りません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行して、いつでもマーケットプレイスを登録します |272| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 公式プラグインマーケットプレイスの自動登録を無効にするには `1` に設定します。Claude Code は通常、マシンの最初のインタラクティブ起動中にマーケットプレイスを登録しようとするときに変数を読み取ります。その時点で変数が設定されている場合、Claude Code は登録を永続的にスキップします。後で変数を設定解除してもスキップは元に戻りません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行して、いつでもマーケットプレイスを登録します |

273| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Claude Code が [未回答の権限リクエストの `Notification` フック](/docs/ja/hooks#notification) を実行するのを停止するには、`1` に設定します。Claude Code がそれらを Agent SDK の `canUseTool` コールバックに送信するセッションでは、これは Claude Desktop および VS Code 拡張機能が Claude Code をホストする方法です。ターミナルセッションには効果がありません。Claude Code v2.1.233 以降が必要です |273| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Claude Code が [未回答の権限リクエストの `Notification` フック](/docs/ja/hooks#notification) を実行するのを停止するには `1` に設定します。Claude Desktop および VS Code 拡張機能が Claude Code をホストするセッションでは、Agent SDK の `canUseTool` コールバックに送信されます。ターミナルセッションには効果がありません。Claude Code v2.1.233 以降が必要です |

274| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | システム全体の管理スキルディレクトリからスキルを読み込むのをスキップするには、`1` に設定します。オペレーター提供のスキルを読み込むべきではないコンテナまたは CI セッションに便利です |274| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | システム全体の管理スキルディレクトリからスキルを読み込むのをスキップするには `1` に設定します。コンテナまたは CI セッションがオペレーター提供のスキルを読み込まないようにする場合に便利です |

275| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) チェックを [システムパス](/docs/ja/permission-modes#remove-item-in-powershell)(ドライブルートやホームディレクトリなど)で `cmd` 組み込み `rd`、`rmdir`、`del`、`erase` を拒否するのをオフにするには、`1` に設定します。Claude Code はこの変数を設定ファイルの `env` ブロックで無視します。Claude Code v2.1.283 以降が必要です |275| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) チェックを無効にするには `1` に設定します。これは、[システムパス](/docs/ja/permission-modes#remove-item-in-powershell)(ドライブルートやホームディレクトリなど)で `cmd` 組み込み `rd`、`rmdir`、`del`、`erase` を拒否します。Claude Code はこの変数を設定ファイルの `env` ブロックで無視します。Claude Code v2.1.283 以降が必要です |

276| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | [重要パス](/docs/ja/permission-modes#critical-paths) チェックを、ターゲットが完全にコマンド置換の出力である再帰的 `rm`(例えば `rm -rf "$(pwd)"`)に対してオフにするには、`1` に設定します。他の重要パスチェックは実行され続けます。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するためです。Claude Code v2.1.281 以降が必要です |276| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | [重要パス](/docs/ja/permission-modes#critical-paths) チェックを無効にするには `1` に設定します。これは、`rm -rf "$(pwd)"` などのコマンド置換の出力が完全に対象である再帰的 `rm` です。他の重要パスチェックは実行され続けます。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するため。Claude Code v2.1.281 以降が必要です |

277| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 会話コンテキストに基づいて自動ターミナルタイトル更新を無効にするには、`1` に設定します。これにより、[セッションタイトルを生成](/docs/ja/sessions#name-your-sessions) するバックグラウンド小型/高速モデルリクエストもスキップされます |277| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 会話コンテキストに基づいて自動ターミナルタイトル更新を無効にするには `1` に設定します。これにより、[セッションタイトルを生成](/docs/ja/sessions#name-your-sessions) するバックグラウンド小型/高速モデルリクエストもスキップされます |

278| `CLAUDE_CODE_DISABLE_THINKING` | API リクエストから `thinking` パラメーターを完全に省略するには、`1` に設定します。これはパラメーターを拒否するプロキシとゲートウェイの互換性オプションです。デフォルトで考えるモデルでは、パラメーターを省略してもモデルは考える可能性があります。Anthropic API で [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) を明示的に無効にするには、代わりに `MAX_THINKING_TOKENS=0` を使用します。どちらの変数も Opus 5.5、Sonnet 5.5、または Fable モデルで思考をオフにしません。これらは思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、2 つの変数は同じように動作します |278| `CLAUDE_CODE_DISABLE_THINKING` | API リクエストから `thinking` パラメーターを完全に省略するには `1` に設定します。これはプロキシとゲートウェイがパラメーターを拒否する場合の互換性オプションです。デフォルトで考えるモデルでは、パラメーターを省略してもモデルは考える可能性があります。Anthropic API で [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) を明示的に無効にするには、代わりに `MAX_THINKING_TOKENS=0` を使用します。どちらの変数も Opus 5.5、Sonnet 5.5、または Fable モデルで思考をオフにしません。これらは思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、2 つの変数は同じように動作します |

279| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Claude Code がモデル ID を認識しない場合(例えば、[LLM ゲートウェイ](/docs/ja/llm-gateway) エイリアス)、プロアクティブな [自動コンパクション](/docs/ja/costs#reduce-token-usage) をスキップするには、`1` に設定します。この変数がない場合、Claude Code は ID に対して想定するコンテキストウィンドウでコンパクトします。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` は代わりに想定されるウィンドウを修正できます;各変数が適用される場合については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。Claude Code v2.1.223 以降が必要です |279| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Claude Code がモデル ID を認識しない場合([LLM ゲートウェイ](/docs/ja/llm-gateway) エイリアスなど)、プロアクティブな [自動コンパクション](/docs/ja/costs#reduce-token-usage) をスキップするには `1` に設定します。この変数がない場合、Claude Code は ID に対して想定するコンテキストウィンドウでコンパクトします。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` は代わりに想定されるウィンドウを修正できます。各変数が適用される場合については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。Claude Code v2.1.223 以降が必要です |

280| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングするには、`1` に設定します。フルスクリーンモードでのスクロールがメッセージが表示されるべき場所に空白の領域を示す場合に使用します |280| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングするには `1` に設定します。フルスクリーンモードでのスクロールがメッセージが表示されるべき場所に空白の領域を表示する場合に使用します |

281| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Windows で `cmd.exe` ランチャーを通じてではなく直接 [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) コマンドを開始するには、`1` に設定します。デフォルトでは、ランチャーは [バックグラウンド](/docs/ja/tools-reference#background-commands) で実行されている PowerShell コマンドが [セッションの次のプロセス](/docs/ja/agent-view#the-supervisor-process) に [引き継がれる](/docs/ja/agent-view#from-inside-a-session) ことを許可します。例えば、セッションをバックグラウンド化する場合。変数を設定すると、バックグラウンド化された PowerShell コマンドはセッションのプロセスが終了するときに停止します。Bash コマンドは影響を受けません。Claude Code v2.1.269 以降が必要です |281| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Windows で `cmd.exe` ランチャーを通じてではなく、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) コマンドを直接開始するには `1` に設定します。デフォルトでは、ランチャーは [バックグラウンドで実行](/docs/ja/tools-reference#background-commands) している PowerShell コマンドが [セッションの次のプロセス](/docs/ja/agent-view#the-supervisor-process) に [引き継がれる](/docs/ja/agent-view#from-inside-a-session) ようにします。例えば、セッションをバックグラウンド化する場合。変数を設定すると、バックグラウンド化された PowerShell コマンドはセッションのプロセスが終了するときに停止します。Bash コマンドは影響を受けません。Claude Code v2.1.269 以降が必要です |

282| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [ワークフロー](/docs/ja/workflows#turn-workflows-off) を無効にするには、`1` に設定します。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |282| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [ワークフロー](/docs/ja/workflows#turn-workflows-off) を無効にするには `1` に設定します。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |

283| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの努力レベルを設定します。値:`low`、`medium`、`high`、`xhigh`、`max`、またはモデルのデフォルトを使用する `auto`。利用可能なレベルはモデルに依存します。`--effort`、`/effort`、および `modelSettings` および `effortLevel` 設定より優先されます。[`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) キャップは引き続き適用されます。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level) を参照してください |283| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの努力レベルを設定します。値:`low`、`medium`、`high`、`xhigh`、`max`、またはモデルのデフォルトを使用する `auto`。利用可能なレベルはモデルに依存します。`--effort`、`/effort`、および `modelSettings` および `effortLevel` 設定より優先されます。[`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) キャップは引き続き適用されます。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level) を参照してください |

284| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 古いリリースとの互換性のために受け入れられ、効果がありません。オートモードはすべてのプロバイダーで利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および署名済み [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) セッション。v2.1.158 ~ v2.1.206 では、これを `1` に設定することが [オートモード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) をこれらのプロバイダーで利用可能にするために必要でした |284| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 古いリリースとの互換性のために受け入れられ、効果がありません。自動モードはすべてのプロバイダーで利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および署名済み [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) セッション。v2.1.158 ~ v2.1.206 では、これらのプロバイダーで [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を利用可能にするために `1` に設定する必要がありました |

285| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションリキャップ](/docs/ja/interactive-mode#session-recap) の可用性をオーバーライドします。リキャップを `/config` トグルに関わらず強制的にオフにするには `0` に設定します。[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合でもリキャップをオンに強制するには `1` に設定します。設定および `/config` トグルより優先されます |285| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションリキャップ](/docs/ja/interactive-mode#session-recap) の可用性をオーバーライドします。`/config` トグルに関係なく、リキャップを強制的にオフにするには `0` に設定します。[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合、リキャップを強制的にオンにするには `1` に設定します。設定と `/config` トグルより優先されます |

286| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | バックグラウンドインストールが完了した後、[非対話モード](/docs/ja/headless) でターン境界でプラグイン状態をリフレッシュするには、`1` に設定します。リフレッシュはセッション中にシステムプロンプトを変更するため、デフォルトではオフです。これにより、そのターンの [プロンプトキャッシング](/docs/ja/prompt-caching) が無効になります |286| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | バックグラウンドインストールが完了した後、[非対話モード](/docs/ja/headless) でターン境界でプラグイン状態をリフレッシュするには `1` に設定します。リフレッシュはセッション中にシステムプロンプトを変更するため、デフォルトではオフです。これにより、そのターンの [プロンプトキャッシング](/docs/ja/prompt-caching) が無効になります |

287| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic バウンドの非必須トラフィックがブロックされている場合、「Claude はどのように機能していますか?」セッション品質調査を独自の [OpenTelemetry コレクター](/docs/ja/monitoring-usage) にルーティングするには、`1` に設定します。調査評価は OTEL イベントとしてのみ設定されたコレクターに発行されます。このモードではサーベイデータは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` および組織製品フィードバックポリシーが優先されます |287| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic バウンドの非必須トラフィックがブロックされている場合、「Claude はどのように機能していますか?」セッション品質調査を独自の [OpenTelemetry コレクター](/docs/ja/monitoring-usage) にルーティングするには `1` に設定します。調査評価は、このモードでは設定されたコレクターへの OTEL イベントとしてのみ発行されます。このモードでは調査データは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` および組織製品フィードバックポリシーが優先されます |

288| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | ツール呼び出し入力が Claude が生成するときに API からストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みなどの大きなツール入力は、Claude がそれを生成した後にのみ到着します。これはハングしているように見える可能性があります。Anthropic API でデフォルトで有効になっています。Amazon Bedrock および Google Cloud の Agent Platform では、デプロイされたコンテナがサポートしている場合、モデルごとに有効になります。`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を通じてプロキシを通じてルーティングする場合は、`1` に設定して強制的にオンにします。Microsoft Foundry および [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |288| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | ツール呼び出し入力が Claude が生成するときに API からストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みなどの大きなツール入力は、Claude がそれを生成した後にのみ到着します。これはハングしているように見える可能性があります。Anthropic API でデフォルトで有効になっています。Amazon Bedrock および Google Cloud の Agent Platform では、デプロイされたコンテナがサポートしている場合、モデルごとに有効になります。プロキシを通じてルーティングする場合は `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を通じて強制的にオンにするには `1` に設定します。Microsoft Foundry および [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |

289| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、または内部プロキシなどの Anthropic 互換ゲートウェイを指している場合、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを設定するには、`1` に設定します。デフォルトではオフです。共有 API キーでバックアップされたゲートウェイはそれ以外の場合、すべてのユーザーにキーがアクセスできるすべてのモデルを表示します。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストでフィルタリングされます;[MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じてリストを配信します。[ゲートウェイ設定ではサーバー管理配信は利用できません](/docs/ja/server-managed-settings#platform-availability) |289| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、または内部プロキシなどの Anthropic 互換ゲートウェイを指している場合、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを設定するには `1` に設定します。共有 API キーでバックアップされたゲートウェイはそれ以外の場合、すべてのユーザーにキーがアクセスできるすべてのモデルを表示するため、デフォルトではオフです。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストでフィルタリングされます。[MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じてリストを配信します。[サーバー管理配信はゲートウェイ設定では利用できません](/docs/ja/server-managed-settings#platform-availability) |

290| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。[高速モード](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移動したときです |290| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。[高速モード](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移動したとき |

291| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | プロンプト入力に表示される灰色の予測であるプロンプト提案をオフにするには、`false` に設定します。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定より優先されます。これは `/config` の **プロンプト提案** トグルが書き込むものです。Claude Code は [アカウントが使用制限に近い場合または達している場合、提案を一時停止](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) します。制限に達するまでそれらをオンに保つには `true` に設定します。Claude Code v2.1.238 以降が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions) を参照してください |291| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | プロンプト入力に表示される灰色の予測であるプロンプト提案をオフにするには `false` に設定します。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定より優先されます。これは `/config` の **プロンプト提案** トグルが書き込むものです。Claude Code はまた、[アカウントが使用制限に近い場合または達している場合、提案を一時停止](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) します。制限に達するまでそれらをオンに保つには `true` に設定します。Claude Code v2.1.238 以降が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions) を参照してください |

292| `CLAUDE_CODE_ENABLE_TASKS` | [タスク追跡ツール](/docs/ja/tools-reference#task-tool-availability) を持つセッションで Claude Code が提供するツールを選択します。デフォルトでは、Claude Code は Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList` を提供します。レガシー `TodoWrite` ツールを代わりに取得するには `0` に設定します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |292| `CLAUDE_CODE_ENABLE_TASKS` | Claude Code が [それらを持つセッション](/docs/ja/tools-reference#task-tool-availability) で提供するタスク追跡ツールを選択します。デフォルトでは、Claude Code は Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、および `TaskList` を提供します。レガシー `TodoWrite` ツールを代わりに取得するには `0` に設定します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

293| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry データ収集をメトリクスとログ用に有効にするには、`1` に設定します。OTel エクスポーターを設定する前に必須です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage) を参照してください |293| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry データ収集をメトリクスとログ用に有効にするには `1` に設定します。OTel エクスポーターを設定する前に必須です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage) を参照してください |

294| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | すべてのモデルでタスク追跡ツールを取得するには、`1` に設定します。これがない場合、Claude Code はデフォルトでは [タスクツール可用性](/docs/ja/tools-reference#task-tool-availability) の下にリストされているモデルでのみそれらを提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールまたは `TodoWrite` を選択します。Claude Code v2.1.233 以降が必要です |294| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | すべてのモデルでタスク追跡ツールを取得するには `1` に設定します。これがない場合、Claude Code はデフォルトでは [タスクツール可用性](/docs/ja/tools-reference#task-tool-availability) の下にリストされているモデルでのみそれらを提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールまたは `TodoWrite` を選択します。Claude Code v2.1.233 以降が必要です |

295| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になった後、自動的に終了するまで待機するミリ秒単位の時間。自動化されたワークフローおよび SDK モードを使用するスクリプトに便利です |295| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になった後、自動的に終了するまでの待機時間(ミリ秒単位)。自動化されたワークフローと SDK モードを使用するスクリプトに便利です |

296| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/docs/ja/agent-teams) を有効にするには、`1` に設定します。エージェントチームは実験的で、デフォルトで無効になっています |296| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/docs/ja/agent-teams) を有効にするには `1` に設定します。エージェントチームは実験的で、デフォルトで無効になっています |

297| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエスト本体のトップレベルにマージする JSON オブジェクト。Claude Code が直接公開しないプロバイダー固有のパラメーターを渡すのに便利です。シェルでエクスポートされた値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルエクスポート値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使用していました |297| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエスト本体の最上位にマージする JSON オブジェクト。Claude Code が直接公開しないプロバイダー固有のパラメーターを渡すのに便利です。シェルでエクスポートされた値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルエクスポート値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使用していました |

298| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトトークン制限をオーバーライドします。より大きなファイルを完全に読み取る必要がある場合に便利です |298| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトトークン制限をオーバーライドします。より大きなファイルを完全に読み取る必要がある場合に便利です |

299| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 別の Claude Code セッション内から起動された場合でも、トランスクリプト永続化、プロンプト履歴、および `claude agents` 登録を強制するには、`1` に設定します。例えば、`screen` セッションまたは Claude Code の Bash ツールによって最初に開始されたバックグラウンドランチャーから継承された `CLAUDE_CODE_CHILD_SESSION` 値により、本物のトップレベルセッションがネストされたものとして誤分類される場合に使用します。v2.1.178 以降、Claude Code は tmux ケースを自動的に検出し、継承されたマーカーを無視するため、tmux はこの変数を必要としなくなります。v2.1.169 以前でも受け入れられます;v2.1.170 および v2.1.171 では効果がありません。ネストされたセッション検出が削除されました |299| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 別の Claude Code セッション内から起動された場合でも、トランスクリプト永続化、プロンプト履歴、および `claude agents` 登録を強制するには `1` に設定します。例えば、`screen` セッションまたは Claude Code の Bash ツールによって最初に開始されたバックグラウンドランチャーから継承された `CLAUDE_CODE_CHILD_SESSION` 値により、本物のトップレベルセッションが誤分類される場合に使用します。v2.1.178 以降、Claude Code は tmux ケースを自動的に検出し、継承されたマーカーを無視するため、tmux はこの変数を必要としなくなります。また、v2.1.169 以前で尊重されます。v2.1.170 および v2.1.171 では効果がありません。ネストされたセッション検出が削除されたとき |

300| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルがサポートしているが自動検出されていない場合(例えば、`TERM_PROGRAM` が転送されていない SSH 経由)、Claude の応答で `~~text~~` の取り消し線レンダリングを強制するには、`1` に設定します。これがない場合、検出されていないターミナルはリテラル `~~` マーカーを表示します。Claude Code v2.1.186 以降が必要です |300| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルがサポートしているが自動検出されていない場合(SSH 経由で `TERM_PROGRAM` が転送されていない場合など)、Claude の応答で `~~text~~` の取り消し線レンダリングを強制するには `1` に設定します。これがない場合、検出されていないターミナルはリテラル `~~` マーカーを表示します。Claude Code v2.1.186 以降が必要です |

301| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているが自動検出されていない場合、DEC プライベートモード 2026 [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にするには、`1` に設定します。BSU/ESU を実装しているが機能プローブに応答しない Emacs `eat` などのエミュレーターに便利です。tmux では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` とは異なり、これはレンダラーを変更しません |301| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているが自動検出されていない場合、DEC プライベートモード 2026 [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にするには `1` に設定します。Emacs `eat` などの BSU/ESU を実装するが、機能プローブに応答しないエミュレーターに便利です。tmux では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` とは異なり、これはレンダラーを変更しません |

302| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) を制御します。これにより Claude は [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を自身で生成でき、対話セッションではデフォルトでオンです。`claude -p` および Agent SDK でもオンにするには `1` に設定するか、すべての種類のセッションでオフにするには `0` に設定します。フォークモードがオンかどうかに関わらず `/subtask` を実行できます。対話デフォルトには Claude Code v2.1.232 以降が必要です;以前のバージョンでは、フォークモードをオンにするために変数を `1` に設定します |302| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) を制御します。これにより Claude は [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を自身で生成でき、対話セッションではデフォルトでオンです。`claude -p` および Agent SDK でもオンにするには `1` に設定するか、すべての種類のセッションでオフにするには `0` に設定します。フォークモードがオンかどうかに関係なく、`/subtask` を実行できます。対話デフォルトには Claude Code v2.1.232 以降が必要です。以前のバージョンでは、フォークモードをオンにするために変数を `1` に設定します |

303| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | [サブエージェント](/docs/ja/sub-agents) テキストと思考ブロックを `claude -p --output-format stream-json` 出力で発行するには、`1` に設定します。[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作。ハーネスが `claude` を呼び出し、フラグ自体を渡すことができない場合に変数を使用します。フラグとは異なり、非対話モードで stream-json 出力の外でエラーで終了しますが、変数はそこで無視されるため、ネストされた呼び出しはプロセス全体で設定されている場合も機能し続けます。Claude Code v2.1.211 以降が必要です |303| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | [サブエージェント](/docs/ja/sub-agents) テキストと思考ブロックを `claude -p --output-format stream-json` 出力で発行するには `1` に設定します。[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作。ハーネスが `claude` を呼び出し、フラグ自体を渡すことができない場合に変数を使用します。フラグとは異なり、非対話モードで stream-json 出力の外でエラーで終了しますが、変数はそこで無視されるため、ネストされた呼び出しはプロセス全体で設定されている場合も機能し続けます。Claude Code v2.1.211 以降が必要です |

304| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers)(`x-claude-code-request-class` および `x-claude-code-compaction` など)をカスタムプロキシまたは Amazon Bedrock や Claude Platform on AWS などのサードパーティプロバイダーで送信するには、`1` に設定します。Anthropic API への直接接続を含むすべての接続でそれらを送信するのを停止するには `0` に設定します。Claude Code はデフォルトでそこで送信します。Claude Code v2.1.273 以降が必要です |304| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | カスタムプロキシまたは Amazon Bedrock や Claude Platform on AWS などのサードパーティプロバイダーで [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers)(`x-claude-code-request-class` や `x-claude-code-compaction` など)を送信するには `1` に設定します。Anthropic API への直接接続を含むすべての接続でそれらの送信を停止するには `0` に設定します。Claude Code はデフォルトでそこに送信します。Claude Code v2.1.273 以降が必要です |

305| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | [ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト(ミリ秒単位)。`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにします(デフォルト:`3000`)。ゲートウェイが 3 秒以上かかって `/v1/models` に応答する必要がある場合は増加させます。プレーンな数字のみを受け入れます;`0`、負の値、その他の表記はデフォルトを保持します。Claude Code v2.1.269 以降が必要です |305| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにする [ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト(ミリ秒単位)(デフォルト:`3000`)。ゲートウェイが 3 秒以上かかって `/v1/models` に応答する必要がある場合は増加させます。平文数字のみを受け入れます。`0`、負の値、その他のスペルはデフォルトを保持します。Claude Code v2.1.269 以降が必要です |

306| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ:Git Bash 実行可能ファイル(`bash.exe`)へのパス。Git Bash がインストールされているが PATH にない場合に使用します。パスが存在しないか、ファイルが `bash.exe`、`sh.exe`、`bash`、または `sh` という名前でない場合、Claude Code は変数を無視し、`--debug` で表示されるログ警告を使用して Git Bash を自動検出します。v2.1.219 より前は、パスが存在しない場合 Claude Code はスタートアップで終了し、bash または sh であることを確認せずに既存のファイルをシェルとして使用していました。[Windows セットアップ](/docs/ja/setup#set-up-on-windows) を参照してください |306| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ:Git Bash 実行可能ファイル(`bash.exe`)へのパス。Git Bash がインストールされているが PATH にない場合に使用します。パスが存在しないか、ファイルが `bash.exe`、`sh.exe`、`bash`、または `sh` という名前でない場合、Claude Code は変数を無視し、`--debug` で表示される警告をログして、Git Bash を設定されていないかのように自動検出します。v2.1.219 より前は、パスが存在しない場合、Claude Code はスタートアップで終了し、bash または sh であることを確認せずに既存のファイルをシェルとして使用していました。[Windows セットアップ](/docs/ja/setup#set-up-on-windows) を参照してください |

307| `CLAUDE_CODE_GLOB_HIDDEN` | Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出すときに、結果からドットファイルを除外するには `false` に設定します。デフォルトで含まれます。`@` ファイルオートコンプリート、`ls`、Grep、Read には影響しません |307| `CLAUDE_CODE_GLOB_HIDDEN` | Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出すときに、結果からドットファイルを除外するには `false` に設定します。デフォルトで含まれます。`@` ファイルオートコンプリート、`ls`、Grep、または Read には影響しません |

308| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンを尊重するようにするには `false` に設定します。デフォルトでは、Glob は gitignored されたものを含むすべての一致ファイルを返します。`@` ファイルオートコンプリートには影響しません。これには独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) があります |308| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンを尊重するようにするには `false` に設定します。デフォルトでは、Glob は gitignored されたものを含むすべての一致ファイルを返します。`@` ファイルオートコンプリートには影響しません。これには独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) があります |

309| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob ツールファイル検出のタイムアウト(秒単位)。ほとんどのプラットフォームでデフォルト 20 秒、WSL では 60 秒 |309| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob ツールファイル検出のタイムアウト(秒単位)。ほとんどのプラットフォームでデフォルト 20 秒、WSL では 60 秒 |

310| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを待機させることができる分数。Claude Code が [それをチェックするよう Claude に要求](/docs/ja/goal#background-work-defers-evaluation) する前。デフォルト `30`。チェックインをオフにするには `0` に設定します。プレーンな数字で全分を指定します。最大 `10080`(1 週間)。Claude Code は他の値を設定されていないものとして扱い、デフォルトを使用します。Claude Code v2.1.234 以降が必要です |310| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを待機させることができる分数。Claude Code が [それをチェックするよう Claude に要求](/docs/ja/goal#background-work-defers-evaluation) する前。デフォルト `30`。チェックインをオフにするには `0` に設定します。平文数字で全分を指定します。最大 `10080`(1 週間)。他の値またはスペルは設定されていないものとして読み取られ、デフォルトが使用されます。Claude Code v2.1.234 以降が必要です |

311| `CLAUDE_CODE_HIDE_CWD` | スタートアップロゴで作業ディレクトリを非表示にするには、`1` に設定します。スクリーンシェアまたは記録でパスが OS ユーザー名を公開する場合に便利です |311| `CLAUDE_CODE_HIDE_CWD` | スタートアップロゴで作業ディレクトリを非表示にするには `1` に設定します。スクリーンシェアまたは記録でパスが OS ユーザー名を公開する場合に便利です |

312| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用されるホストアドレスをオーバーライドします。デフォルトでは Claude Code は WSL-to-Windows ルーティングを含む正しいアドレスを自動検出します |312| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用されるホストアドレスをオーバーライドします。デフォルトでは Claude Code は WSL-to-Windows ルーティングを含む正しいアドレスを自動検出します |

313| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 拡張機能の自動インストールをスキップするには、`1` に設定します。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |313| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 拡張機能の自動インストールをスキップするには `1` に設定します。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定することと同等です |

314| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 接続中に IDE ロックファイルエントリの検証をスキップするには、`1` に設定します。自動接続が実行中にもかかわらず IDE を見つけられない場合に使用します |314| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 接続中に IDE ロックファイルエントリの検証をスキップするには `1` に設定します。自動接続が実行中の IDE を見つけられない場合に使用します |

315| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが別のツールを生成するのを拒否する前に、1 つのセッションで実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数(デフォルト:20)。プレーンな数字で正の整数を受け入れます;その他は無視されるため、変数は上限を調整できますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |315| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが別のスポーンを拒否する前に、1 つのセッションで実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数(デフォルト:20)。平文数字の正の整数を受け入れます。他のものは無視されるため、変数は上限を調整できますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |

316| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウサイズをオーバーライドします。v2.1.193 以降、それがどのように適用されるかは Claude Code がモデル ID をどのように解決するかに依存します;[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を通じてコンテキストウィンドウが組み込みサイズと一致しないモデルにルーティングする場合に使用します |316| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウサイズをオーバーライドします。v2.1.193 以降、それがどのように適用されるかは Claude Code がモデル ID をどのように解決するかに依存します。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を通じてモデルにルーティングする場合、コンテキストウィンドウが組み込みサイズと一致しない場合に使用します |

317| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する各 MCP ツール説明および各 MCP サーバーの指示の最大文字数(デフォルト:2048)。Claude Code は [より長いテキストを切り詰めます](/docs/ja/mcp#for-mcp-server-authors)。プレーンな数字で正の整数を受け入れます。その他は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |317| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する各 MCP ツール説明と各 MCP サーバーの指示の最大文字数(デフォルト:2048)。Claude Code は [より長いテキストを切り詰めます](/docs/ja/mcp#for-mcp-server-authors)。平文数字の正の整数を受け入れます。他のものは無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |

318| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります;[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。Claude Code は認識しないモデル ID(ゲートウェイ固有の名前など)に対してデフォルト 32000 を使用し、モデルの上限を超える値をその上限に低下させます。この値を増加させると、[自動コンパクション](/docs/ja/costs#reduce-token-usage) がトリガーされる前に利用可能な有効コンテキストウィンドウが減少します |318| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。Claude Code は、モデルの上限を超える値を上限に低下させます。Claude Code が認識できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動コンパクション](/docs/ja/costs#reduce-token-usage) がトリガーされる前に利用可能な有効なコンテキストウィンドウが減少します |

319| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数をオーバーライドします(デフォルト:10)。v2.1.186 以降、15 でキャップされます;v2.1.199 以降、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルトを上げ、キャップを削除します。無人セッションがより長い停止を待つ必要がある場合は、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定します |319| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数をオーバーライドします(デフォルト:10)。v2.1.186 以降、15 でキャップされます。v2.1.199 以降、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルトを上げ、キャップを削除します。無人セッションがより長い停止を待つ必要がある場合は、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定します |

320| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は no-op です。以前は、1 つのセッションで Agent ツールが生成できる [サブエージェント](/docs/ja/sub-agents) の総数をキャップしていました(デフォルト:200);上限を超えて生成すると `Subagent spawn limit reached` で失敗しました。[同時サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit) および [深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |320| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は no-op です。以前は、1 つのセッションで Agent ツールを使用して Claude が生成できる [サブエージェント](/docs/ja/sub-agents) の総数をキャップしていました(デフォルト:200)。上限を超えてスポーンすると、`Subagent spawn limit reached` で失敗しました。[同時サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit) および [深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |

321| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メイン会話の下で許可される [サブエージェントレイヤー](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数(デフォルト:3)。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目のレイヤーのサブエージェントはさらに生成できません;ネストをオフにするには `1` に設定します。v2.1.217 ~ v2.1.218 では、デフォルトは 1 でした。サブエージェントは制限を上げない限り独自のサブエージェントを生成できませんでした;v2.1.219 はデフォルトを 3 に上げました。プレーンな数字で正の整数を受け入れます;その他は無視されるため、制限を調整できますが、削除することはできません。Claude Code v2.1.217 以降が必要です |321| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メイン会話の下で許可される [サブエージェントレイヤー](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数(デフォルト:3)。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目のレイヤーのサブエージェントはさらに生成できません。ネストをオフにするには `1` に設定します。v2.1.217 ~ v2.1.218 では、デフォルトは 1 でした。サブエージェントは制限を上げない限り独自のサブエージェントを生成できませんでした。v2.1.219 はデフォルトを 3 に上げました。平文数字の正の整数を受け入れます。他のものは無視されるため、制限を調整できますが、削除することはできません。Claude Code v2.1.217 以降が必要です |

322| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 読み取り専用ツールおよびサブエージェントが並列で実行できる最大数(デフォルト:10)。より高い値は並列性を増加させますが、より多くのリソースを消費します |322| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 読み取り専用ツールとサブエージェントが並列で実行できる最大数(デフォルト:10)。より高い値は並列性を増加させますが、より多くのリソースを消費します |

323| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合、エージェントターンの数をキャップします。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。両方が設定されている場合、フラグが優先されます。正の整数ではない値は、上限なしとして扱われるのではなく、スタートアップでエラーで拒否されます |323| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合、エージェント的ターン数をキャップします。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すことと同等です。両方が設定されている場合、フラグが優先されます。正の整数ではない値は、キャップなしとして扱われるのではなく、スタートアップでエラーで拒否されます |

324| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 1 つのセッションが実行できる [WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) 呼び出しの総数の上限(デフォルト:200)。Claude が上限に達すると、さらなる WebSearch 呼び出しは、既に収集した情報で続行するよう指示する通知を返します。上限なしで正の整数を受け入れます。その他は無視され、デフォルトが適用されるため、上限を上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |324| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 1 つのセッションが実行できる [WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) 呼び出しの総数のキャップ(デフォルト:200)。Claude が上限に達すると、さらなる WebSearch 呼び出しは、既に収集した情報で続行するよう指示する通知を返します。上限なしで正の整数を受け入れます。他のものは無視され、デフォルトが適用されるため、上限を上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |

325| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP サーバーをシェル環境を継承する代わりに、安全なベースライン環境とサーバーの設定された `env` のみで生成するには、`1` に設定します |325| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP サーバーをシェル環境を継承する代わりに、安全なベースライン環境とサーバーの設定された `env` のみで生成するには `1` に設定します |

326| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | MCP ツール呼び出しが [バックグラウンドタスク](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) に移動するまでの経過時間(ミリ秒単位)(デフォルト:120000、または 2 分)。自動バックグラウンド化をオフにするには `0` に設定します。Claude Code v2.1.212 以降が必要です |326| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | MCP ツール呼び出しが [バックグラウンドタスク](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) に移動する前の経過時間(ミリ秒単位)(デフォルト:120000、または 2 分)。自動バックグラウンド化をオフにするには `0` に設定します。Claude Code v2.1.212 以降が必要です |

327| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless) セッションの最初のターンが、デフォルト [最初のターン待機](/docs/ja/agent-sdk/mcp#connection-timing) の代わりに、まだ接続中の MCP サーバーを待つ時間(ミリ秒単位)。設定されている場合、待機はすべての保留中のサーバーをカバーします。待機をスキップするには `0` に設定します。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) サーバーは、値に関わらず独自の `MCP_TIMEOUT` 待機を保持します。Claude Code v2.1.274 以降が必要です |327| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless) セッションの最初のターンが、デフォルト [最初のターン待機](/docs/ja/agent-sdk/mcp#connection-timing) の代わりに、まだ接続中の MCP サーバーを待つ時間(ミリ秒単位)。設定されている場合、待機はすべての保留中のサーバーをカバーします。待機をスキップするには `0` に設定します。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) サーバーは、値に関係なく独自の `MCP_TIMEOUT` 待機を保持します。Claude Code v2.1.274 以降が必要です |

328| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツール呼び出しのアイドルタイムアウト(ミリ秒単位)。stdio、HTTP、SSE、WebSocket、または [claude.ai コネクター](/docs/ja/mcp#use-mcp-servers-from-claude-ai) MCP サーバーが応答を送信せず、この長さの間進捗通知を送信しない場合、ツール呼び出しは全体的な `MCP_TOOL_TIMEOUT` を待つ代わりにエラーで中止されます。ネットワークサーバーの 300000(5 分)および stdio サーバーの 1800000(30 分)のトランスポート別デフォルトをオーバーライドします。`0` に設定してアイドルチェックを無効にします。1000 未満の値は 1 秒に上げられ、値は有効な `MCP_TOOL_TIMEOUT` でキャップされます。`.mcp.json` の少なくとも 1000 のサーバーごとの `timeout` はそのサーバーのアイドルウィンドウを少なくとも `timeout` 値に上げます。IDE サーバーまたは SDK インプロセスサーバーには適用されません。Claude Code v2.1.187 以降が必要です。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトから除外されていました |328| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツール呼び出しのアイドルタイムアウト(ミリ秒単位)。stdio、HTTP、SSE、WebSocket、または [claude.ai コネクター](/docs/ja/mcp#use-mcp-servers-from-claude-ai) MCP サーバーが応答も進捗通知も送信しない場合、全体的な `MCP_TOOL_TIMEOUT` を待つ代わりに、ツール呼び出しはエラーで中止されます。ネットワークサーバーの 300000(5 分)および stdio サーバーの 1800000(30 分)のトランスポート別デフォルトをオーバーライドします。アイドルチェックを無効にするには `0` に設定します。1000 未満の値は 1 秒に上げられ、値は有効な `MCP_TOOL_TIMEOUT` でキャップされます。`.mcp.json` の少なくとも 1000 のサーバーごとの `timeout` は、そのサーバーのアイドルウィンドウを少なくとも `timeout` 値に上げます。IDE サーバーまたは SDK インプロセスサーバーには適用されません。Claude Code v2.1.187 以降が必要です。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトから除外されていました |

329| `CLAUDE_CODE_MESSAGING_SOCKET` | Claude Code によって設定されます。あなたではなく:[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code はそのソケットのパスをフック および Bash コマンドにエクスポートします。メッセージングでセッションが開始される場合、Claude Code はいずれかのフックが実行される前にソケットをバインドします。マシン上の他のセッションはこのパスにメッセージを配信します。各セッションは親から継承されたものではなく、独自のソケットをエクスポートし、そこに到着するメッセージはセッションの [インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages) を通じて処理されます。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.224 以降が必要です |329| `CLAUDE_CODE_MESSAGING_SOCKET` | Claude Code によって設定されます。あなたではなく:[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code はそのソケットのパスをフックと Bash コマンドにエクスポートします。メッセージングがオンで開始するセッションでは、Claude Code はフックが実行される前にソケットをバインドします。マシン上の他のセッションはこのパスにメッセージを配信します。各セッションは親から継承されたものではなく、独自のソケットをエクスポートし、それに到着するメッセージはセッションの [インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages) を通じて処理されます。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.224 以降が必要です |

330| `CLAUDE_CODE_MESSAGING_TOKEN` | Claude Code によって設定されます。あなたではなく:[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code は `CLAUDE_CODE_MESSAGING_SOCKET` と一緒にこのセッションごとのトークンをフック および Bash コマンドにエクスポートします。ソケットに投稿するスクリプトは、`{"type":"auth","token":"<token>"}` を最初の行として送信して、セッションに属していることを証明できます。ネイティブ Windows では、Claude Code はこの行を要求し、有効なトークンで開かれていない接続を閉じます。[独自の子ルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) は Claude Code がトークンを参照する場合を示しています。各セッションは親セッションから継承されたものではなく、独自のトークンをエクスポートします。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.228 以降が必要です |330| `CLAUDE_CODE_MESSAGING_TOKEN` | Claude Code によって設定されます。あなたではなく:[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code はこのセッションごとのトークンをフックと Bash コマンドと一緒にエクスポートします。ソケットに投稿するスクリプトは、`{"type":"auth","token":"<token>"}` を最初の行として送信して、セッションに属していることを証明できます。ネイティブ Windows では、Claude Code はこの行を要求し、有効なものを開かないすべての接続を閉じます。[独自の子ルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) は、Claude Code がトークンを参照するときを示しています。各セッションは親セッションから継承されたものではなく、独自のトークンをエクスポートします。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.228 以降が必要です |

331| `CLAUDE_CODE_NATIVE_CURSOR` | 入力キャレットでターミナル独自のカーソルを表示するには、`1` に設定します。描画されたブロックの代わりに。カーソルはターミナルのまばたき、形状、フォーカス設定を尊重します |331| `CLAUDE_CODE_NATIVE_CURSOR` | 入力キャレットでターミナル独自のカーソルを表示するには `1` に設定します。描画されたブロックの代わりに。カーソルはターミナルのまばたき、形状、フォーカス設定を尊重します |

332| `CLAUDE_CODE_NEW_INIT` | `/init` が対話的なセットアップフローを実行するようにするには、`1` に設定します。フローは、CLAUDE.md、スキル、フック を含む、生成するファイルを尋ねてから、コードベースを探索してそれらを書き込みます。この変数がない場合、`/init` はプロンプトなしに CLAUDE.md を自動的に生成します |332| `CLAUDE_CODE_NEW_INIT` | `/init` がインタラクティブセットアップフローを実行するようにするには `1` に設定します。フローは、CLAUDE.md、スキル、フックを含む、生成するファイルを尋ねてから、コードベースを探索してそれらを書き込みます。この変数がない場合、`/init` はプロンプトなしに CLAUDE.md を自動的に生成します |

333| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 2 番目の非ブロッキングファイルディスクリプタを通じてターミナル出力を書き込むには、`1` に設定します。ターミナルが読み取りを停止する場合(一時停止した tmux コントロールモードペインまたは停止した SSH 接続など)、Claude Code をセッション中にフリーズできません。stdout がターミナルの場合、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |333| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 2 番目の非ブロッキングファイル記述子を通じてターミナル出力を書き込むには `1` に設定します。読み取りを停止したターミナル(一時停止した tmux コントロールモードペインまたは停止した SSH 接続など)が Claude Code をセッション中にフリーズできないようにします。macOS、Linux、WSL で stdout がターミナルの場合に適用されます。Claude Code v2.1.261 以降が必要です |

334| `CLAUDE_CODE_NO_FLICKER` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にするには、`1` に設定します。ちらつきを減らし、長い会話でメモリをフラットに保つ研究プレビュー。[`tui`](/docs/ja/settings-reference#tui) 設定をオーバーライドします;`/tui fullscreen` で切り替えることもできます |334| `CLAUDE_CODE_NO_FLICKER` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にするには `1` に設定します。ちらつきを減らし、長い会話でメモリをフラットに保つ研究プレビュー。[`tui`](/docs/ja/settings-reference#tui) 設定をオーバーライドします。`/tui fullscreen` で切り替えることもできます |

335| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定されている場合、`claude auth login` はブラウザーを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必須です。自動化された環境での認証のプロビジョニングに便利です |335| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定されている場合、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必須です。自動化された環境での認証のプロビジョニングに便利です |

336| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンが発行されたスペース区切り OAuth スコープ。例えば `"user:profile user:inference user:sessions:claude_code"`。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |336| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンが発行されたスペース区切り OAuth スコープ。例:`"user:profile user:inference user:sessions:claude_code"`。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |

337| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK および自動化された環境の `/login` の代替。キーチェーンに保存された認証情報より優先されます。[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) で生成します。[`/login`](/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体に対して設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動します |337| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK および自動化された環境の `/login` の代替。キーチェーン保存認証情報より優先されます。[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) で生成します。`/login` を実行しない限り、Claude Code はセッション全体に設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動します |

338| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は no-op です。以前は [高速モード](/docs/ja/fast-mode) を現在のデフォルトの代わりに Claude Opus 4.6 にピン留めしていました。Opus 4.6 はもはや高速モードをサポートしていません |338| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は no-op です。以前は [高速モード](/docs/ja/fast-mode) を現在のデフォルトではなく Claude Opus 4.6 にピン留めしていました。Opus 4.6 はもはや高速モードをサポートしていません |

339| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性の最大長(モデル応答、ツールコンテンツ、システムプロンプト、生 API 本体)。切り詰めマーカーを含む UTF-16 コード単位(デフォルト:61440、つまり 60 KB)。テレメトリバックエンドが 64 KB を超える属性値を受け入れる場合のみ上げるか、テレメトリボリュームを削減するために低下させます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |339| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性(モデル応答、ツールコンテンツ、システムプロンプト、生 API 本体)の最大長。切り詰めマーカーを含む UTF-16 コード単位(デフォルト:61440、つまり 60 KB)。テレメトリバックエンドが 64 KB より大きい属性値を受け入れる場合のみ上げるか、テレメトリボリュームを削減するために低下させます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |

340| `CLAUDE_CODE_OTEL_DIAG_STDERR` | OpenTelemetry エクスポーター診断エラーを stderr に書き込むには、`1` に設定します。デフォルトでは、これらのエラーは `--debug` でのみ表示されるため、Prometheus ポート衝突などの設定ミスエクスポーターはそれ以外の場合は静かに失敗します。Claude Code v2.1.179 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |340| `CLAUDE_CODE_OTEL_DIAG_STDERR` | OpenTelemetry エクスポーター診断エラーを stderr に書き込むには `1` に設定します。デフォルトでは、これらのエラーは `--debug` でのみ表示されるため、Prometheus ポート衝突などの設定ミスエクスポーターはそれ以外の場合は静かに失敗します。Claude Code v2.1.179 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |

341| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュするためのタイムアウト(ミリ秒単位)(デフォルト:5000)。[監視](/docs/ja/monitoring-usage) を参照してください |341| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュするためのタイムアウト(ミリ秒単位)(デフォルト:5000)。[監視](/docs/ja/monitoring-usage) を参照してください |

342| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的 OpenTelemetry ヘッダーをリフレッシュするための間隔(ミリ秒単位)(デフォルト:1740000 / 29 分)。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |342| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的 OpenTelemetry ヘッダーをリフレッシュするための間隔(ミリ秒単位)(デフォルト:1740000 / 29 分)。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |

343| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry エクスポーターがシャットダウン時に完了するためのタイムアウト(ミリ秒単位)(デフォルト:2000)。メトリクスが終了時にドロップされる場合は増加させます。[監視](/docs/ja/monitoring-usage) を参照してください |343| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するためのタイムアウト(ミリ秒単位)(デフォルト:2000)。メトリクスが終了時にドロップされる場合は増加させます。[監視](/docs/ja/monitoring-usage) を参照してください |

344| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 新しいバージョンが利用可能な場合、Claude Code がバックグラウンドでパッケージマネージャーのアップグレードコマンドを実行できるようにするには、`1` に設定します。Homebrew および WinGet インストールに適用されます。他のパッケージマネージャーは、実行せずにアップグレードコマンドを表示し続けます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |344| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 新しいバージョンが利用可能な場合、Claude Code がバックグラウンドでパッケージマネージャーのアップグレードコマンドを実行できるようにするには `1` に設定します。Homebrew および WinGet インストールに適用されます。他のパッケージマネージャーは、実行せずにアップグレードコマンドを表示し続けます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |

345| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 対応の書き込み保護を有効にするには、`1` に設定します。設定されている場合、Edit、Write、NotebookEdit は、ターゲットファイルが所有者書き込みビットを欠いている場合、`p4 edit <file>` ヒント で失敗します。Perforce は同期されたファイルでこれをクリアします。`p4 edit` がそれらを開くまで。これにより、Claude Code が Perforce 変更追跡をバイパスするのを防ぎます |345| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 対応の書き込み保護を有効にするには `1` に設定します。設定されている場合、Edit、Write、NotebookEdit は、ターゲットファイルが所有者書き込みビットを欠いている場合、`p4 edit <file>` ヒントで失敗します。Perforce は同期されたファイルでこれをクリアします。`p4 edit` がそれらを開くまで。これにより、Claude Code が Perforce 変更追跡をバイパスするのを防ぎます |

346| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインルートディレクトリをオーバーライドします。名前に関わらず、これは親ディレクトリを設定します:マーケットプレイスとプラグインキャッシュはこのパスの下のサブディレクトリに存在します。デフォルトは `~/.claude/plugins` です |346| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインルートディレクトリをオーバーライドします。名前に反して、これは親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュはこのパスの下のサブディレクトリに存在します。デフォルトは `~/.claude/plugins` です |

347| `CLAUDE_CODE_PLUGIN_DIRS` | セッション用に読み込むプラグインディレクトリ。各ディレクトリは [`--plugin-dir`](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) フラグが読み込む方法で読み込まれます。Unix では `:` で、Windows では `;` で複数のパスを分離します。各パスを絶対パスとして指定するか、`~` で開始します。Claude Code は相対パスをスキップするためです。Claude Code v2.1.280 以降が必要です。[1 つのセッション用にプラグインを読み込む](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session) を参照してください |347| `CLAUDE_CODE_PLUGIN_DIRS` | セッション用に読み込むプラグインディレクトリ。各ディレクトリは [`--plugin-dir`](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) フラグが読み込む方法で読み込まれます。複数のパスを Unix では `:` で、Windows では `;` で区切ります。各パスを絶対パスとして指定するか、`~` で開始します。Claude Code は相対パスをスキップするため。Claude Code v2.1.280 以降が必要です。[1 つのセッション用にプラグインを読み込む](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session) を参照してください |

348| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインマーケットプレイスをクローンまたはリフレッシュするためのタイムアウト(ミリ秒単位)(デフォルト:120000)。大規模なリポジトリまたは遅いネットワーク接続の場合はこの値を増加させます。[Git クローンが 120 秒後にタイムアウト](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s) を参照してください |348| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインマーケットプレイスのクローンまたはリフレッシュのタイムアウト(ミリ秒単位)(デフォルト:120000)。大規模なリポジトリまたは遅いネットワーク接続の場合は、この値を増加させます。[Git クローンが 120 秒後にタイムアウト](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s) を参照してください |

349| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | マーケットプレイスリフレッシュがリモートに到達または認証できない場合、再クローン試行をスキップし、既存のマーケットプレイスチェックアウトを使用し続けるには、`1` に設定します。オフラインまたはエアギャップ環境で再クローンが同じ方法で失敗する場合に便利です。[マーケットプレイス更新がオフライン環境で失敗し続ける](/docs/ja/plugins/troubleshooting#marketplace-updates-keep-failing-offline) を参照してください |349| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | マーケットプレイスリフレッシュがリモートに到達または認証できない場合、再クローン試行をスキップし、既存のマーケットプレイスチェックアウトを使用し続けるには `1` に設定します。オフラインまたはエアギャップ環境で再クローンが同じ方法で失敗する場合に便利です。[マーケットプレイス更新がオフライン環境で失敗し続ける](/docs/ja/plugins/troubleshooting#marketplace-updates-keep-failing-offline) を参照してください |

350| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` ショートハンドソースを SSH の代わりに HTTPS 経由でクローンするには、`1` に設定します。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用に設定された SSH キーがない環境で便利です |350| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` ショートハンドソースを SSH ではなく HTTPS 経由でクローンするには `1` に設定します。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用に設定された SSH キーのない環境で便利です |

351| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:` で、Windows では `;` で分離します。プリポピュレートされたプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code はこれらのディレクトリからマーケットプレイスを登録し、再クローンなしで事前キャッシュされたプラグインを使用します。[コンテナおよび CI 用にプラグインを事前設定](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |351| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:` で、Windows では `;` で区切ります。事前に設定されたプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code はこれらのディレクトリからマーケットプレイスを登録し、再クローンなしで事前キャッシュされたプラグインを使用します。[コンテナと CI 用にプラグインを事前設定](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |

352| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | ツール呼び出し、フック、ステータスラインコマンド用に PowerShell を生成するときに Claude Code が `-ExecutionPolicy Bypass` を渡すのを停止し、マシンの有効な実行ポリシーを尊重するには、`1` に設定します。デフォルトでは Claude Code はプロセススコープで実行ポリシーをバイパスするため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関わらず、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |352| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | ツール呼び出し、フック、ステータスラインコマンド用に PowerShell を生成するときに Claude Code が `-ExecutionPolicy Bypass` を渡すのを停止し、マシンの有効な実行ポリシーを尊重するには `1` に設定します。デフォルトでは Claude Code はプロセススコープで実行ポリシーをバイパスするため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関係なく、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |

353| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非対話モード](/docs/ja/headless#background-tasks-at-exit) で `-p` フラグを使用した最終ターン後、バックグラウンドサブエージェントおよびワークフローを待つアイドル待機の上限(ミリ秒単位)。アイドル待機は Claude がバックグラウンド結果を処理するターンを取るたびに開始します。デフォルト:`600000`、または 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクを待つのを停止して終了します。無期限に待つには `0` に設定します。このキャップはプレーンバックグラウンドシェルに適用される 5 秒の猶予期間とは別です。Claude Code v2.1.182 以降が必要です |353| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非対話モード](/docs/ja/headless#background-tasks-at-exit) で `-p` フラグを使用した最終ターン後、バックグラウンドサブエージェントとワークフローを待つアイドル待機の上限(ミリ秒単位)。アイドル待機は、Claude がバックグラウンド結果を処理するためにターンを取るたびに開始します。デフォルト:`600000`、または 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止して終了します。無期限に待機するには `0` に設定します。このキャップは、プレーンバックグラウンドシェルに適用される 5 秒の猶予期間とは別です。Claude Code v2.1.182 以降が必要です |

354| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が独自のバイナリから開始するプロセス([エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど)を、`/opt/corp/launcher` などの argv プレフィックスとして指定されたコーポレートランチャーを通じて起動します。ユーザーまたは [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定します。プロジェクトおよびローカル設定は設定できません。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等です。Claude Code v2.1.210 以降が必要です;両方が設定されている場合、この変数が優先されます。VS Code 拡張機能は `claudeProcessWrapper` 設定を通じて独自のランチャーを個別に設定します。Windows では無視されます。値形式、ランチャーがカバーするもの、ランチャーが満たす必要があるコントラクトについては、[コーポレートランチャーの背後で Claude Code を実行](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |354| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が独自のバイナリから開始するプロセス([エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど)を、`/opt/corp/launcher` などの argv プレフィックスとして指定されたコーポレートランチャーを通じて起動します。ユーザーまたは [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定します。プロジェクトおよびローカル設定では設定できません。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等です。Claude Code v2.1.210 以降が必要です。この変数は両方が設定されている場合に優先されます。VS Code 拡張機能は `claudeProcessWrapper` 設定を通じて独自のランチャーを個別に設定します。Windows では無視されます。[コーポレートランチャーの背後で Claude Code を実行](/docs/ja/corporate-launcher) を参照してください。値形式、ランチャーがカバーするもの、ランチャーが満たす必要があるコントラクト。Claude Code v2.1.208 以降が必要です |

355| `CLAUDE_CODE_PROJECT_DIR_NAME` | セッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリ名を選択するために `CLAUDE_CONFIG_DIR` と一緒に設定します。作業ディレクトリパスから派生したものの代わりに。例えば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で開始すると、`/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が設定されていない場合、Claude Code はこの変数を無視し、`claude` を開始する環境からのみ読み取ります。設定ファイルの `env` ブロックからではなく。[プロジェクトディレクトリに自分で名前を付ける](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |355| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定して、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリ名を選択します。作業ディレクトリパスから派生したものの代わりに。例えば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` を使用して開始すると、`/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が設定されていない場合、Claude Code はこの変数を無視し、`claude` を開始する環境からのみ読み取ります。設定ファイル `env` ブロックからではなく。[プロジェクトディレクトリ名を自分で選択](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |

356| `CLAUDE_CODE_PROMPT_CACHE_TTL` | メイン会話の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択するには、`5m` または `1h` に設定します。これらは Claude Code が受け入れる唯一の値です:対話的、`-p`、SDK ターン、およびそれらと一緒に実行されるヘルパー。`promptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` はそれをオーバーライドします。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |356| `CLAUDE_CODE_PROMPT_CACHE_TTL` | メイン会話の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択するには `5m` または `1h` に設定します。唯一の値 Claude Code が受け入れます:対話的、`-p`、SDK ターン、およびそれらと一緒に実行されるヘルパー。[`promptCacheTtl` 設定](/docs/ja/settings-reference#promptcachettl) および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` はそれをオーバーライドします。API は 1 時間キャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |

357| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合、W3C トレースコンテキストを伝播するには、`1` に設定します。伝播はモデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フック サブプロセスの `TRACEPARENT` 環境変数をカバーします。デフォルトでは、伝播は Anthropic API に直接接続されている場合のみ有効になります。v2.1.152 で追加されました。[トレース(ベータ)](/docs/ja/monitoring-usage#traces-beta) を参照してください |357| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合、W3C トレースコンテキストを伝播するには `1` に設定します。伝播は、モデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックサブプロセスの `TRACEPARENT` 環境変数をカバーします。デフォルトでは、伝播は Anthropic API への直接接続でのみ有効になります。v2.1.152 で追加されました。[トレース(ベータ)](/docs/ja/monitoring-usage#traces-beta) を参照してください |

358| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を埋め込み、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などのプロバイダー選択、エンドポイント、認証変数を設定ファイルで無視するため、ユーザー設定はホストのルーティングをオーバーライドできません。Claude Code は、[管理設定](/docs/ja/managed-settings) で配信されるマネージド ソースに関わらず、`model`、`fallbackModel`、`modelOverrides` などのモデル選択キーも無視するため、ホストのモデル設定は古い管理モデルピンより優先されます。Claude Code は、管理 `env` ブロックで `ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数も無視します;管理設定の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストはホストが独自のものを提供しない限り引き続き適用されます。Claude Code はまた、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで適用する自動テレメトリオプトアウトをスキップするため、テレメトリは標準 `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |358| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を埋め込み、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などのプロバイダー選択、エンドポイント、認証変数を設定ファイルで無視するため、ユーザー設定はホストのルーティングをオーバーライドできません。Claude Code はまた、[管理設定](/docs/ja/managed-settings) で `model`、`fallbackModel`、`modelOverrides` などのモデル選択キーを無視します。どの管理ソースがそれらを配信するかに関係なく、ホストのモデル設定が古い管理モデルピンより優先されます。Claude Code はまた、管理 `env` ブロックで `ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数を無視します。管理設定の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストはホストが独自のものを提供しない限り引き続き適用されます。Claude Code はまた、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用される自動テレメトリオプトアウトをスキップするため、テレメトリは標準 `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |

359| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | プロキシが DNS 解決を実行できるようにするには、`1` に設定します。呼び出し元の代わりに。プロキシがホスト名解決を処理する必要がある環境のオプトイン |359| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | プロキシが DNS 解決を実行できるようにするには `1` に設定します。呼び出し元の代わりに。プロキシがホスト名解決を処理すべき環境のオプトイン |

360| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合、自動的に `true` に設定されます。フック またはセットアップスクリプトからこれを読み取って、クラウドセッションにいるかどうかを検出します |360| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合、自動的に `true` に設定されます。フックまたはセットアップスクリプトからこれを読み取って、クラウドセッションにいるかどうかを検出します |

361| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で現在のセッション ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[セッションに出力をリンク](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |361| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で現在のセッション ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[セッションに出力をリンク](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |

362| `CLAUDE_CODE_RESTRICTED` | セッションを制限モードで開始するには、`1` に設定します。[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡すのと同じです。Claude Code はこの変数を設定ファイルの `env` ブロックで無視します。Claude Code v2.1.248 以降が必要です |362| `CLAUDE_CODE_RESTRICTED` | セッションを制限モードで開始するには `1` に設定します。[`--restricted`](/docs/ja/cli-reference#cli-flags) フラグを渡すのと同じです。Claude Code はこの変数を設定ファイルの `env` ブロックで無視します。Claude Code v2.1.248 以降が必要です |

363| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションがターン中に終了した場合、自動的に再開するには、`1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行できます。これをオフにするには、変数を設定解除するか `0` に設定します。v2.1.221 より前は、Claude Code は `0` およびその他の falsy 値を無視したため、非対話モードで `0` を設定してもリジュームがトリガーされ、変数を設定解除することが唯一の方法でした |363| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションがターン中に終了した場合、自動的に再開するには `1` に設定します。SDK モードで使用されるため、モデルは SDK が プロンプトを再送信する必要なく続行されます。これをオフにするには、変数を設定解除するか `0` に設定します。v2.1.221 より前は、Claude Code は `0` および他の falsy 値を無視したため、`0` を設定すると非対話モードで再開がトリガーされ、変数を設定解除することが唯一の方法でした |

364| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターン中に終了したセッションが自動的に再開するための最後のトランスクリプトメッセージの最大経過時間(ミリ秒単位)。最後のメッセージがこのバウンドより古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 自動リジュームおよび `CLAUDE_CODE_RESUME_PROMPT` 継続メッセージをスキップし、セッションはアイドル状態で開始されるため、明示的に続行できます。設定解除または `0` は制限なしを意味します。ただし、最後のリクエストが API エラーで失敗したターンは、そのエラーが 6 時間未満の間のみ再開されます。正の値はすべてのターンをバウンドします;負の値または非数値は 1 時間のバウンドを適用します。長時間実行されるエージェント用のスポーン スクリプトはこれを設定して、古いトランスクリプトに対する再起動が古いプロンプトを再実行しないようにできます。Claude Code は、クラッシュした [エージェントビュー](/docs/ja/agent-view) セッションを再起動するときに、対話セッションから会話を継承した場合、1 時間のバウンドを自身で設定します。Claude Code v2.1.211 以降が必要です |364| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターン中に終了したセッションが自動的に再開するための最後のトランスクリプトメッセージの最大経過時間(ミリ秒単位)。最後のメッセージがこの境界より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 自動再開とその `CLAUDE_CODE_RESUME_PROMPT` 継続メッセージをスキップし、セッションはアイドル状態で開始されるため、明示的に続行します。設定されていないか `0` は境界がないことを意味します。ただし、最後のリクエストが API エラーで失敗したターンは、そのエラーが 6 時間未満の間のみ再開されます。正の値はすべてのターンをバウンドします。負またはアルファベット値は 1 時間の境界を適用します。長時間実行されるエージェント用のスポーンスクリプトはこれを設定して、古いトランスクリプトに対する再起動が古いプロンプトを再実行しないようにすることができます。Claude Code は、クラッシュした [エージェントビュー](/docs/ja/agent-view) セッションを再起動するときに、対話セッションから会話を継承した場合、1 時間の境界を自身で設定します。Claude Code v2.1.211 以降が必要です |

365| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` がプロンプトを再送信する代わりに中断されたターンを続行するときに Claude に送信する継続メッセージをオーバーライドします。または、`-p` で [遅延ツール呼び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開するときに。デフォルトは `Continue from where you left off.`。空の文字列はデフォルトを使用します |365| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` がプロンプトを再送信する代わりに中断されたターンを続行するときに Claude に送信する継続メッセージをオーバーライドします。または、`-p` で [遅延ツール呼び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開するときに。デフォルトは `Continue from where you left off.`。空の文字列はデフォルトを使用します |

366| `CLAUDE_CODE_RETRY_WATCHDOG` | eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに、`429` および `529` 容量エラーを無期限に再試行します。Claude Code は、標準速度リクエストが支出制限または使用済みクレジットを報告する `429` を取得すると直ちに失敗します。[ゲートウェイ支出キャップ](/docs/ja/errors#spend-limit-reached) からリセットされるものであっても。v2.1.239 より前は、監視犬はこれらを無期限に再試行していました。高速モードリクエストについては、[レート制限を処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。監視犬は試行間で最大 5 分バックオフするか、レスポンスがレート制限リセット時間を運ぶ場合はリセットまで待機するため、使用制限に達したセッションは残りのウィンドウを待ちます。v2.1.199 以降では、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーのデフォルト再試行回数も上げて、約 3 時間のバックオフに対して 300 に上げ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合は 15 のキャップを削除します。Claude Code v2.1.186 以降が必要です |366| `CLAUDE_CODE_RETRY_WATCHDOG` | eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに、`429` および `529` 容量エラーを無期限に再試行します。Claude Code は、標準速度リクエストが支出制限またはクレジット使用済みを報告する `429` を取得すると直ちに失敗します。[ゲートウェイ支出キャップ](/docs/ja/errors#spend-limit-reached) からリセットされるもの。v2.1.239 より前は、監視犬はこれらを無期限に再試行していました。高速モードリクエストについては、[レート制限を処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。監視犬は試行間で最大 5 分バックオフするか、応答がレート制限リセット時間を報告する場合はリセットまで待機するため、使用制限に達したセッションは残りのウィンドウを待ちます。v2.1.199 以降では、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーのデフォルト再試行回数も上げられます。約 3 時間のバックオフに対して 300 に、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合、15 のキャップを削除します。Claude Code v2.1.186 以降が必要です |

367| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには、`1` に設定します:CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインおよびファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。設定の破損をトラブルシューティングするため。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含む;管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは読み込まれません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。直接生成された子プロセスは変数を継承します |367| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します:CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインおよびファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。設定の破損をトラブルシューティングするため。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含む。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは読み込まれません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すことと同等です。直接生成された子プロセスは変数を継承します |

368| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです;値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースであるため、`./scripts/deploy.sh $(evil)` などのシェル展開トリックは引き続きキャップに対してカウントされます。`xargs` または `find -exec` を通じたランタイムファンアウトは検出されません;これは多層防御コントロールです |368| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースであるため、`./scripts/deploy.sh $(evil)` などのシェル展開トリックはキャップに対してカウントされます。`xargs` または `find -exec` を通じたランタイムファンアウトは検出されません。これは多層防御コントロールです |

369| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。`0.5` などの 1 未満の小数値を含む、最大 20 までの正の値を受け入れます。加速トラックパッドおよびホイールスクロールを既に増幅するターミナルで遅くします。ターミナルが増幅なしで 1 ホイールイベントを送信する場合は `3` に設定して `vim` と一致させます。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |369| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。最大 20 までの正の値を受け入れます。`0.5` などの 1 未満の小数値を含めて、加速トラックパッドおよびホイールスクロールを遅くします。ターミナルが既に増幅されたホイールイベントを送信します。ターミナルが増幅なしで 1 ホイールイベントを送信する場合は `3` に設定して `vim` と一致させます。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |

370| `CLAUDE_CODE_SEND_FEEDBACK` | セッションの [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにするには `0` に設定します。アカウントがアクセス権を持つ場所でオンにするには `1` に設定します;変数はアクセス権を付与できず、`DISABLE_FEEDBACK_COMMAND` および [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値などのフィードバックをオフにする他のスイッチは引き続き適用されます |370| `CLAUDE_CODE_SEND_FEEDBACK` | セッションの [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにするには `0` に設定します。アカウントが既にアクセス権を持つ場所でオンにするには `1` に設定します。変数はアクセス権を付与できず、`DISABLE_FEEDBACK_COMMAND` および [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値などのフィードバックをオフにする他のスイッチは引き続き適用されます |

371| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算をミリ秒単位でオーバーライドします。値は、独自の `timeout` を設定しないフックのタイムアウトでもあります。セッション終了、`/clear`、および対話型 `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定された最高のフックごとの `timeout` に自動的に上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を上げません |371| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算をオーバーライドします(ミリ秒単位)。値は、独自の `timeout` を設定しないフックのタイムアウトでもあります。セッション終了、`/clear`、および対話的 `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定された最高のフックごとの `timeout` に自動的に上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を上げません |

372| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールサブプロセス、[hook コマンド](/docs/ja/hooks) サブプロセス、stdio [MCP サーバー](/docs/ja/mcp) サブプロセスで現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックの場合、これはフック JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーサブプロセスは、生成されたときに受け取った ID を保持します。`--resume <session-id>` では再開された ID を受け取ります。`--continue` または明示的な ID なしで `--resume` では、初期スタートアップ ID を代わりに受け取る可能性があります。スクリプトおよび外部ツールを Claude Code セッションと相関させるために使用します |372| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールサブプロセス、[フックコマンド](/docs/ja/hooks) サブプロセス、および stdio [MCP サーバー](/docs/ja/mcp) サブプロセスで現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックの場合、これはフック JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーサブプロセスは、生成されたときに受け取った ID を保持します。`--resume <session-id>` では、再開された ID を受け取ります。`--continue` または明示的な ID なしで `--resume` では、初期スタートアップ ID を代わりに受け取る可能性があります。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |

373| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールコマンドを実行するために使用するシェルを設定します。`/opt/homebrew/bin/bash` などの `bash` または `zsh` バイナリへのパスを受け入れます。`fish` などの他のシェルはサポートされていません。値が機能する `bash` または `zsh` パスでない場合、Claude Code はそれを無視し、自動検出にフォールバックします。自動検出は `bash` または `zsh` を指す場合に `$SHELL` を使用し、そうでない場合は `PATH` および標準インストール場所で見つかった最初の機能する `zsh` を選択してから `bash` を選択します |373| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールコマンドを実行するために使用するシェルを設定します。`/opt/homebrew/bin/bash` などの `bash` または `zsh` バイナリへのパスを受け入れます。`fish` などの他のシェルはサポートされていません。値が機能する `bash` または `zsh` パスでない場合、Claude Code はそれを無視し、自動検出にフォールバックします。自動検出は、`bash` または `zsh` を指している場合は `$SHELL` を使用します。そうでない場合は、`PATH` および標準インストール場所で見つかった最初の機能的な `zsh` を選択してから `bash` を選択します |

374| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code が生成するシェルコマンドをラップするコマンドプレフィックス:Bash ツール呼び出し、[hook](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) スタートアップコマンド。PowerShell フックおよび exec フォームフックはプレフィックスなしで実行されます。ログまたは監査に便利です。`/path/to/logger.sh` などのベアな実行可能ファイルパスを設定すると、各コマンドが `/path/to/logger.sh '<command>'` として実行されます。ラッパーは `$1` の単一シェルクォート引数としてコマンドラインを受け取るため、ラッパーは `$1` を `exec bash -c "$1"` などのシェルで再評価する必要があります。`$1` をベアな実行可能ファイルパスとして扱うと、`npx -y <package>` などの引数を渡す stdio MCP サーバーが破損します。Bash ツール呼び出しの場合、`$1` には Claude Code が組み立てる完全なシェル呼び出しが含まれます。環境セットアップを含む。実行した コマンドのみではなく |374| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code が生成するシェルコマンドをラップするコマンドプレフィックス:Bash ツール呼び出し、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) スタートアップコマンド。PowerShell フックと exec フォームフックはプレフィックスなしで実行されます。ログまたは監査に便利です。`/path/to/logger.sh` などのベアの実行可能ファイルパスを設定すると、各コマンドが `/path/to/logger.sh '<command>'` として実行されます。ラッパーはコマンドラインを `$1` の単一シェルクォート引数として受け取るため、ラッパーは `$1` を `exec bash -c "$1"` などのシェルで再評価する必要があります。`$1` をベアの実行可能ファイルパスとして扱うと、`npx -y <package>` などの引数を渡す stdio MCP サーバーが破損します。Bash ツール呼び出しの場合、`$1` には Claude Code が組み立てる完全なシェル呼び出しが含まれます。環境セットアップを含む。実行したコマンドのみではなく |

375| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトおよび Bash、ファイル読み取り、ファイル編集ツールのみで実行するには、`1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、カスタムコマンド、サブエージェント、インストール済みプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。`--add-dir` で渡すディレクトリのスキルは引き続き読み込まれます。OAuth トークンおよびキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から来る必要があります。[`--bare`](/docs/ja/headless#start-faster-with-bare-mode) を渡すのと同等です |375| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトと Bash、ファイル読み取り、ファイル編集ツールのみで実行するには `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、カスタムコマンド、サブエージェント、インストール済みプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。`--add-dir` で渡すディレクトリ内のスキルは引き続き読み込まれます。OAuth トークンとキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から来る必要があります。[`--bare`](/docs/ja/headless#start-faster-with-bare-mode) を渡すことと同等です |

376| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトおよび省略されたツール説明を使用するには、`1` に設定します。実験またはサーバー設定がそれ以外の場合有効にする場合でも、オプトアウトするには `0`、`false`、`no`、`off` に設定します。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |376| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトと省略されたツール説明を使用するには `1` に設定します。実験またはサーバー設定がそれ以外の場合有効にしても、オプトアウトするには `0`、`false`、`no`、または `off` に設定します。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |

377| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします。ゲートウェイが自身でリクエストに署名する場合 |377| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします。ゲートウェイが自身でリクエストに署名する場合 |

378| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | AWS デフォルト認証情報プロバイダーチェーンのインプロセスキャッシュをオフにするには、`1` に設定します。Claude Code はすべての API リクエストでチェーンを解決します。キャッシュがオフの場合、SSO バックアップされたプロファイルはすべてのリクエストで IAM Identity Center から認証情報をリクエストします。[認証情報キャッシングおよび解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout) を参照してください。Claude Code v2.1.207 以降が必要です |378| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | AWS デフォルト認証情報プロバイダーチェーンから解決された認証情報のインプロセスキャッシュをオフにするには `1` に設定します。キャッシュがオフの場合、Claude Code はすべての API リクエストでチェーンを解決します。SSO バックアップされたプロファイルは、すべてのリクエストで IAM Identity Center から認証情報をリクエストします。[認証情報キャッシングと解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout) を参照してください。Claude Code v2.1.207 以降が必要です |

379| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock の AWS 認証をスキップします(例えば、LLM ゲートウェイを使用する場合) |379| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock の AWS 認証をスキップします(例えば、LLM ゲートウェイを使用する場合) |

380| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックが失敗した場合、利用可能として扱うには、`1` に設定します。チェックの直接リクエストを `api.anthropic.com` にブロックするネットワークの場合。Claude Code は「組織によって無効」レスポンスを引き続き尊重します |380| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックが失敗した場合、利用可能として扱うには `1` に設定します。チェックの直接リクエストを `api.anthropic.com` にブロックするネットワークの場合。Claude Code は「組織によって無効化」応答を引き続き尊重します |

381| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには、`1` に設定します。チェックのリクエストをインターセプトするプロキシの場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |381| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには `1` に設定します。プロキシがチェックのリクエストを拒否するのではなく傍受する場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |

382| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを挿入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、例えば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |382| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを挿入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、例えば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |

383| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします(例えば、LLM ゲートウェイを使用する場合) |383| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします(例えば、LLM ゲートウェイを使用する場合) |

384| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴およびセッショントランスクリプトをディスクに書き込むのをスキップするには、`1` に設定します。この変数で開始されたセッションは `--resume`、`--continue`、上矢印履歴に表示されません。一時的なスクリプト化されたセッションに便利です |384| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴とセッショントランスクリプトをディスクに書き込むのをスキップするには `1` に設定します。この変数で開始されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプト化されたセッションに便利です |

385| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud の Agent Platform の Google 認証をスキップします(例えば、LLM ゲートウェイを使用する場合) |385| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud の Agent Platform の Google 認証をスキップします(例えば、LLM ゲートウェイを使用する場合) |

386| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前で指定する結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには、`1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |386| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前で示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには `1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |

387| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターン終了をブロックできる連続回数の最大数(デフォルト:8)。Claude Code がそれをオーバーライドしてターンを終了する前。キャップを無効にするには `0` に設定します。フックが解決するために正当に必要な場合は上げます |387| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了をブロックできる連続回数の最大数。Claude Code がそれをオーバーライドしてターンを終了する前(デフォルト:8)。キャップを無効にするには `0` に設定します。フックが解決するのに正当に必要な場合は上げます |

388| `CLAUDE_CODE_SUBAGENT_MODEL` | [サブエージェント](/docs/ja/sub-agents#choose-a-model)、[エージェントチーム](/docs/ja/agent-teams#specify-teammates-and-models) チームメイト、別の方法でモデルが割り当てられていない [ワークフロー](/docs/ja/workflows) エージェントのデフォルトモデル。`haiku` などのエイリアスまたは完全なモデル名を受け入れます。2 つのソースが優先されます:Claude がエージェントを生成するときに渡すモデル、およびエージェント定義の `model` フィールド(`inherit` を含む)。それを変更するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ja/sub-agents#run-every-subagent-on-one-model) を設定します。[モデルを選択](/docs/ja/sub-agents#choose-a-model) で完全な順序を参照してください。`inherit` に設定することは、設定解除するのと同じです。v2.1.251 より前は、この変数は呼び出しごとのモデルと定義の `model` フィールドの両方をオーバーライドしました |388| `CLAUDE_CODE_SUBAGENT_MODEL` | [サブエージェント](/docs/ja/sub-agents#choose-a-model)、[エージェントチーム](/docs/ja/agent-teams#specify-teammates-and-models) チームメイト、別の方法で割り当てられていない [ワークフロー](/docs/ja/workflows) エージェントのデフォルトモデル。`haiku` などのエイリアスまたは完全なモデル名を受け入れます。2 つのソースはそれより優先されます:Claude がエージェントを生成するときに渡すモデル、およびエージェント定義の `model` フィールド(`inherit` を含む)。それを変更するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ja/sub-agents#run-every-subagent-on-one-model) を設定します。[モデルを選択](/docs/ja/sub-agents#choose-a-model) を参照して、完全な順序を確認してください。`inherit` に設定することは、設定されていないままにすることと同じです。v2.1.251 より前は、この変数は呼び出しごとのモデルと定義の `model` フィールドの両方をオーバーライドしました |

389| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | サブエージェント、チームメイト、ワークフロー エージェントに 1 つのモデルを強制するには、`1` に設定します。[すべてのサブエージェントを 1 つのモデルで実行](/docs/ja/sub-agents#run-every-subagent-on-one-model) はそのモデルがどれであるかを示しています。Claude Code v2.1.257 以降が必要です |389| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | サブエージェント、チームメイト、ワークフロー エージェントに 1 つのモデルを強制するには `1` に設定します。[すべてのサブエージェントを 1 つのモデルで実行](/docs/ja/sub-agents#run-every-subagent-on-one-model) はそのモデルが何であるかを示しています。Claude Code v2.1.257 以降が必要です |

390| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | メイン会話外のリクエスト([サブエージェント](/docs/ja/sub-agents)、ワークフロー、バックグラウンド作業など)の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択するには、`5m` または `1h` に設定します。これらは Claude Code が受け入れる唯一の値です。`subagentPromptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` はそれをオーバーライドします。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |390| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | [サブエージェント](/docs/ja/sub-agents)、ワークフロー、バックグラウンド作業などのメイン会話外のリクエストの [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択するには `5m` または `1h` に設定します。唯一の値 Claude Code が受け入れます。`subagentPromptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` はそれをオーバーライドします。API は 1 時間キャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |

391| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | サブプロセス環境から認証情報を削除するには、`1` に設定します(Bash ツール、フック、MCP stdio サーバー):Anthropic およびクラウドプロバイダー認証情報、Claude Code が認証情報として認識する他の変数、パッケージレジストリ URL に埋め込まれた認証情報。親 Claude プロセスはこれらの認証情報を API 呼び出し用に保持しますが、子プロセスはそれらを読み取ることができず、シェル展開を通じた秘密流出を試みるプロンプトインジェクション攻撃への露出を減らします。v2.1.251 以降では、スクラブは Claude Code の独自の設定ストアポインター変数(`CLAUDE_CONFIG_DIR` など)も削除するため、子プロセスは再配置された設定ディレクトリを見つけることができません。子プロセスがこれらの変数を必要とする場合は、スクラブを設定解除したままにします。Linux では、これは Bash サブプロセスを分離された PID 名前空間で実行するため、`/proc` を通じてホストプロセス環境を読み取ることができません;副作用として、`ps`、`pgrep`、`kill` はホストプロセスを見たり、シグナルを送ったりすることができません。`claude-code-action` は `allowed_non_write_users` が設定されている場合、これを自動的に設定します |391| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | サブプロセス環境から認証情報を削除するには `1` に設定します(Bash ツール、フック、MCP stdio サーバー):Anthropic およびクラウドプロバイダー認証情報、Claude Code が認証情報として認識する他の変数、パッケージレジストリ URL に埋め込まれた認証情報。親 Claude プロセスはこれらの認証情報を API 呼び出しに保持しますが、子プロセスはそれらを読み取ることができず、プロンプトインジェクション攻撃がシェル展開を通じてシークレットを流出させようとする露出を減らします。v2.1.251 以降では、スクラブは Claude Code 独自の設定ストアポインター変数(`CLAUDE_CONFIG_DIR` など)も削除するため、子プロセスは再配置された設定ディレクトリを見つけることができません。子プロセスがこれらの変数を必要とする場合は、スクラブを設定されていないままにします。Linux では、これは Bash サブプロセスを分離された PID 名前空間で実行するため、`/proc` を通じてホストプロセス環境を読み取ることができません。副作用として、`ps`、`pgrep`、`kill` はホストプロセスを見たり、シグナルを送ったりすることができません。`claude-code-action` は `allowed_non_write_users` が設定されている場合、これを自動的に設定します |

392| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード(`-p` フラグ)でプラグインインストールが完了するまで待つには、`1` に設定します。最初のクエリの前。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機をバウンドします |392| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード(`-p` フラグ)で、最初のクエリの前にプラグインインストールが完了するまで待機するには `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機をバウンドします |

393| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト(ミリ秒単位)。超過した場合、Claude Code はプラグインなしで進行し、エラーをログします。デフォルトなし:この変数がない場合、同期インストールは完了まで待機します |393| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト(ミリ秒単位)。超過すると、Claude Code はプラグインなしで進行し、エラーをログします。デフォルトなし:この変数がない場合、同期インストールは完了まで待機します |

394| `CLAUDE_CODE_SYNC_SKILLS` | 非対話モードで `-p` フラグを使用して、Claude Code が claude.ai アカウント用に有効なスキルをダウンロードし、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` まで最初のクエリの前にそれらのリストを待つようにするには、`1` に設定します。ダウンロード自体はバックグラウンドで完了し、Claude はスキルを呼び出すときにそのスキルのダウンロードを待ちます。claude.ai 認証が必要です。claude.ai アカウントでサインインするターミナルセッションは [これらのスキルをダウンロード](/docs/ja/skills#where-synced-skills-load) して `~/.claude/skills/synced/` に約 10 分ごとに再同期します。この変数なしで、`-p` 実行がその最初のクエリでこれらのスキルを必要とする場合のみ設定します。v2.1.273 より前は、ターミナルセッションはこの変数セットで `-p` 実行でのみダウンロードしました。`synced` フォルダ名は [このダウンロード用に予約されています](/docs/ja/skills#where-skills-live)。v2.1.227 より前は、スキルは `~/.claude/skills/` に直接ダウンロードされました。Claude Code は [ダウンロードされたスキルに追加ルール](/docs/ja/skills#how-synced-skills-behave) を適用します。例えば、マシンで `!` コマンドを実行しません |394| `CLAUDE_CODE_SYNC_SKILLS` | 非対話モードで `-p` フラグを使用して、Claude Code が claude.ai アカウント用に有効なスキルをダウンロードし、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` まで最初のクエリの前にそれらのリストを待機するには `1` に設定します。ダウンロード自体はバックグラウンドで完了し、Claude はスキルを呼び出すときにそのスキルのダウンロードを待ちます。claude.ai 認証が必要です。claude.ai アカウントでサインインするターミナルセッションは [これらのスキルをダウンロード](/docs/ja/skills#where-synced-skills-load) して `~/.claude/skills/synced/` に再同期します。この変数を設定せずに約 10 分ごと。`-p` 実行がその最初のクエリでスキルを必要とする場合のみ設定します。v2.1.273 より前は、ターミナルセッションはこの変数が設定された `-p` 実行でのみそれらをダウンロードしました。`synced` フォルダ名は [このダウンロード用に予約されています](/docs/ja/skills#where-skills-live)。v2.1.227 より前は、スキルは `~/.claude/skills/` に直接ダウンロードされました。Claude Code は [ダウンロードされたスキルに追加ルール](/docs/ja/skills#how-synced-skills-behave) を適用します。例えば、マシンで `!` コマンドを実行しません |

395| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | アプリが [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) に基づいてスキルをリロードするときに実行される、セッション中のスキル再同期のタイムアウト(ミリ秒単位)(デフォルト:30000)。超過した場合、リロードは到着したスキルで続行され、残りのダウンロードはバックグラウンドで完了します |395| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | アプリが [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) に基づいて構築されたスキルをリロードするときに実行される、セッション中のスキル再同期のタイムアウト(ミリ秒単位)(デフォルト:30000)。超過すると、リロードは到着したスキルで続行され、残りのダウンロードはバックグラウンドで完了します |

396| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、最初のクエリが初期スキルリストを待つためのタイムアウト(ミリ秒単位)(デフォルト:5000)。超過した場合、最初のクエリは到着したスキルで実行されます。ダウンロードはどちらの方法でもバックグラウンドで完了し、Claude はスキルを呼び出すときにそのスキルのダウンロードを待ちます |396| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、最初のクエリが初期スキルリストを待機するタイムアウト(ミリ秒単位)(デフォルト:5000)。超過すると、最初のクエリは到着したスキルで実行されます。ダウンロードはどちらの方法でもバックグラウンドで完了し、Claude はスキルを呼び出すときにそのスキルのダウンロードを待ちます |

397| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 出力での構文強調表示を無効にするには、`false` に設定します。色がターミナルセットアップに干渉する場合に便利です。コードブロックおよびファイルプレビューでの強調表示も無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用します |397| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 出力での構文強調表示を無効にするには `false` に設定します。色がターミナルセットアップに干渉する場合に便利です。コードブロックおよびファイルプレビューでの強調表示も無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用します |

398| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。複数の Claude Code インスタンスで同じ ID を設定して、[Task ツール](/docs/ja/tools-reference#task-tool-availability) を持つセッションで共有タスクリストで調整します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |398| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。複数の Claude Code インスタンスで同じ ID を設定して、[Task ツール](/docs/ja/tools-reference#task-tool-availability) を持つセッションで共有タスクリストで調整します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

399| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) がティアダウンを完了するまで待つ時間(ミリ秒単位)をオーバーライドします。1000 ~ 60000 を受け入れます;範囲外の値は無視され、デフォルト 10000 が適用されます。Claude Code v2.1.206 以降が必要です |399| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) の破棄を完了するまで待機する時間(ミリ秒単位)をオーバーライドします。1000 ~ 60000 を受け入れます。範囲外の値は無視され、デフォルト 10000 が適用されます。Claude Code v2.1.206 以降が必要です |

400| `CLAUDE_CODE_TMPDIR` | 内部一時ファイルに使用される一時ディレクトリをオーバーライドします。Claude Code は Unix で `/claude-{uid}/` を、Windows で `/claude/` をこのパスに追加します。デフォルト:macOS では `/tmp`、Linux および Windows では `os.tmpdir()`。macOS および Linux では、[サンドボックス化](/docs/ja/sandboxing) Bash サブプロセスは、オーバーライドが長いパスの場合、システムデフォルトの下で短いフォールバック `$TMPDIR` を受け取ります。一部のツールは一時パスが長すぎるときに失敗するためです。サンドボックス化されていない Bash コマンドは、設定されている場合、シェルの `$TMPDIR` を継承します。Claude Code の独自の一時ファイルは常にオーバーライドを使用します。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |400| `CLAUDE_CODE_TMPDIR` | 内部一時ファイルに使用される一時ディレクトリをオーバーライドします。Claude Code は Unix で `/claude-{uid}/` を、Windows で `/claude/` をこのパスに追加します。デフォルト:macOS では `/tmp`、Linux および Windows では `os.tmpdir()`。macOS および Linux では、[サンドボックス化](/docs/ja/sandboxing) された Bash サブプロセスは、オーバーライドが長いパスの場合、システムデフォルトの下で短いフォールバック `$TMPDIR` を受け取ります。一部のツールは一時パスが長すぎるときに失敗するため。サンドボックス化されていない Bash コマンドは、設定されている場合、シェルの `$TMPDIR` を継承します。ネイティブ Windows では、シェルが `$TMPDIR` を設定しない場合、`$TMPDIR` を参照する Bash コマンドはオーバーライドを受け取るか、設定していない場合は `%TEMP%` を受け取ります。Claude Code 独自の一時ファイルは常にオーバーライドを使用します。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

401| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 内で 24 ビット truecolor 出力を許可するには、`1` などの空でない値に設定します。**`0` または `false` に設定してもまだ truecolor を許可します**。ほとんどのオン/オフ変数とは異なり;変数を設定解除して 256 色クランプを復元します。デフォルトでは、`$TMUX` が設定されている場合、Claude Code は 256 色にクランプします。tmux は設定されていない限り truecolor エスケープシーケンスを通さないためです。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を追加した後、これを設定します。[ターミナル設定](/docs/ja/terminal-config) で他の tmux 設定を参照してください |401| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 内で 24 ビット truecolor 出力を許可するには、`1` などの空でない値に設定します。**`0` または `false` に設定してもまだ truecolor を許可します**。ほとんどのオン/オフ変数とは異なり。変数を設定解除して 256 色クランプを復元します。デフォルトでは、`$TMUX` が設定されている場合、Claude Code は 256 色にクランプされます。tmux は設定されていない限り truecolor エスケープシーケンスを通さないため。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を追加した後、これを設定します。[ターミナル設定](/docs/ja/terminal-config) を参照して、他の tmux 設定を確認してください |

402| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux および WSL では、Claude Code が [ツールメモリキャップから除外](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するプロセスの種類のカンマ区切りリストに設定します。例えば `mcp` または `lsp`。すべての種類をキャップするには `none` に設定するか、Bash、PowerShell、Monitor ツールコマンドのみをキャップするには `all-new` に設定します。Claude Code は、リストするものに関わらず、Bash、PowerShell、Monitor ツールコマンドをキャップの下に保ちます。Claude Code v2.1.246 以降が必要です |402| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux および WSL では、Claude Code が [ツールメモリキャップから除外](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するプロセスの種類のカンマ区切りリストに設定します。例えば `mcp` または `lsp`。すべての種類をキャップするには `none` に設定するか、Bash、PowerShell、Monitor ツールコマンドのみをキャップするには `all-new` に設定します。Claude Code は、リストするものに関係なく、Bash、PowerShell、Monitor ツールコマンドをキャップの下に保ちます。Claude Code v2.1.246 以降が必要です |

403| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux および WSL では、[Bash および PowerShell ツールコマンドが使用できるメモリをキャップ](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するために `4G` などのサイズに設定します。v2.1.246 以降の Monitor ツールコマンド。プレーンな数字で、バイト数のみ、または `K`、`M`、`G`、`T` サフィックス付きで書き込みます。キャップをオフにするには `0` または `off` に設定します。Claude Code が開始する最初のプロセスがキャップをオンまたはオフにした後、変更された値は `claude` を次に起動するときに有効になります。Claude Code v2.1.233 以降が必要です |403| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux および WSL では、[Bash および PowerShell ツールコマンドが使用できるメモリをキャップ](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するには `4G` などのサイズに設定します。v2.1.246 以降の Monitor ツールコマンド。平文数字で、単独でバイト数、または `K`、`M`、`G`、`T` サフィックス付きで書き込みます。キャップをオフにするには `0` または `off` に設定します。Claude Code が開始する最初のプロセスがキャップをオンまたはオフにした後、変更された値は `claude` を次に起動するときに有効になります。Claude Code v2.1.233 以降が必要です |

404| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [Remote Control](/docs/ja/remote-control) または SDK ホストなどのリモートクライアントに転送するダイアログ、または [保持されたクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages) の承認ダイアログをキャンセルするまでのデッドライン(ミリ秒単位);権限プロンプトおよび `AskUserQuestion` 質問は独自のフローを使用し、それによって管理されません。Claude Code v2.1.236 以降では、無人で実行されている可能性があるセッションの中期 [Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) もバウンドします。[インバウンドメッセージを制御](/docs/ja/cross-session-messaging#control-inbound-messages) および [非対話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions) は、デッドラインが適用されない場合を含む、完全な保持メッセージ有効期限ルールをカバーします。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 設定をオーバーライドします。`0` または負の値はデッドラインを無効にします |404| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [リモートコントロール](/docs/ja/remote-control) または SDK ホストなどのリモートクライアント、または [保持されたクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages) の承認ダイアログに転送するダイアログをキャンセルするまでの期限(ミリ秒単位)。権限プロンプトと `AskUserQuestion` 質問は独自のフローを使用し、それによって管理されません。Claude Code v2.1.236 以降では、セッションが無人で実行されている可能性がある場合、セッション中の [Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) もバウンドします。[インバウンドメッセージを制御](/docs/ja/cross-session-messaging#control-inbound-messages) および [非対話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions) は、期限が適用されない場合を含む、完全な保持メッセージ有効期限ルールをカバーしています。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 設定をオーバーライドします。`0` または負の値は期限を無効にします |

405| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を使用します |405| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を使用します |

406| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ja/amazon-bedrock) を使用します |406| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ja/amazon-bedrock) を使用します |

407| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/ja/microsoft-foundry) を使用します |407| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/ja/microsoft-foundry) を使用します |

408| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を使用します |408| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を使用します |

409| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | ripgrep の代わりに Node.js ファイル API を使用してカスタムコマンド、サブエージェント、出力スタイルを検出するには、`1` に設定します。バンドルされた ripgrep バイナリが利用できないか、環境でブロックされている場合に設定します。Grep またはファイル検索ツールには影響しません |409| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Node.js ファイル API を使用してカスタムコマンド、サブエージェント、出力スタイルを検出するには `1` に設定します。ripgrep の代わりに。バンドルされた ripgrep バイナリが環境で利用できないか、ブロックされている場合に設定します。Grep またはファイル検索ツールには影響しません |

410| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツールを制御します。Git Bash がない Windows では、ツールは自動的に有効になります;無効にするには `0` に設定します。Git Bash がインストールされている Windows では、ツールは claude.ai および Console アカウントでデフォルトでオンです;Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッションで有効にするには `1` に設定するか、オフにするには `0` に設定します。Linux、macOS、WSL では、有効にするには `1` に設定します。これには `PATH` に `pwsh` が必要です。Windows で有効にされている場合、Claude は Git Bash を通じてルーティングする代わりにネイティブに PowerShell コマンドを実行できます。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を参照してください |410| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツールを制御します。Git Bash のない Windows では、ツールは自動的に有効になります。無効にするには `0` に設定します。Git Bash がインストールされている Windows では、ツールは claude.ai および Console アカウントでデフォルトでオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッションで有効にするには `1` に設定するか、オフにするには `0` に設定します。Linux、macOS、WSL では、有効にするには `1` に設定します。これには `PATH` に `pwsh` が必要です。Windows で有効にされている場合、Claude は Git Bash を通じてルーティングする代わりに PowerShell コマンドをネイティブに実行できます。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を参照してください |

411| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) を使用します |411| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) を使用します |

412| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が各フェッチされた URL のレスポンスをキャッシュする時間(ミリ秒単位)に設定します。デフォルトは `900000`(15 分)です。プレーンな数字のみを受け入れます;`0`、小数、その他の表記はデフォルトを保持します。Claude Code はセッションごとに値を読み取るため、設定 `env` ブロックの変更は `claude` を次に起動するときに適用されます。Claude Code v2.1.233 以降が必要です |412| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が各フェッチされた URL の応答をキャッシュする時間(ミリ秒単位)に設定します。デフォルトは `900000`(15 分)。平文数字のみを受け入れます。`0`、小数、その他のスペルはデフォルトを保持します。Claude Code はセッションごとに値を 1 回読み取るため、設定 `env` ブロックの変更は `claude` を次に起動するときに適用されます。Claude Code v2.1.233 以降が必要です |

413| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロードを待つ時間の上限(ミリ秒単位)。リダイレクトを含む。その時点までに完了していないダウンロードはデッドラインエラーで失敗します。デフォルトは `300000`(5 分)です。制限を削除するには `0` に設定します。プレーンな数字のみを受け入れます;小数またはその他の表記はデフォルトを保持します。Claude Code v2.1.268 以降が必要です |413| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロードを待つ時間の上限(ミリ秒単位)。リダイレクトを含む。その時点までに完了していないダウンロードは期限エラーで失敗します。デフォルトは `300000`(5 分)。制限を削除するには `0` に設定します。平文数字のみを受け入れます。小数またはその他のスペルはデフォルトを保持します。Claude Code v2.1.268 以降が必要です |

414| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 単一 [ワークフロー](/docs/ja/workflows) 実行が一度に実行するエージェント数。`1` ~ `256`。デフォルトでは、実行は一度に最大 16 エージェントを実行します。Claude Code が利用可能な CPU が少ない場合は少なくなります;キューに入れられた `agent()` 呼び出しは無料スロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに留まるため、より高い値はメモリ使用量を上げます。プレーンな数字のみを受け入れます;範囲外の値およびその他の表記はデフォルトを保持します。Claude Code v2.1.269 以降が必要です |414| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 単一 [ワークフロー](/docs/ja/workflows) 実行が一度に実行するエージェント数。`1` ~ `256`。デフォルトでは、実行は一度に最大 16 エージェントを実行します。Claude Code が少ないプロセッサを持つ場合は少なくなります。キューに入れられた `agent()` 呼び出しは無料スロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに留まるため、より高い値はメモリ使用量を上げます。平文数字のみを受け入れます。範囲外の値とその他のスペルはデフォルトを保持します。Claude Code v2.1.269 以降が必要です |

415| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows) エージェントが同じプレフィックスシブリングの最初のレスポンスが開始されるまで待つ時間の上限(ミリ秒単位)。複数のエージェントがファンアウトを開始し、[プロンプトキャッシュプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out) を共有する場合、Claude Code は最初のエージェント以外をこの長さまで保持するため、残りはキャッシュされたプレフィックスを読み取ります。デフォルト `5000`。待機を無効にするには `0` に設定します。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは決して待機しません。Claude Code v2.1.229 以降が必要です |415| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows) エージェントが同じプレフィックスシブリングの最初の応答が開始されるまで待機する時間の上限(ミリ秒単位)。複数のエージェントがファンアウトを開始し、[プロンプトキャッシュプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out) を共有する場合、Claude Code は最初のエージェント以外をすべて保持するため、残りはキャッシュされたプレフィックスを読み取ります。デフォルト `5000`。待機を無効にするには `0` に設定します。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |

416| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします(デフォルト:`~/.claude`)。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management) を参照してください。複数のアカウントを並行して実行するのに便利です:例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |416| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします(デフォルト:`~/.claude`)。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management) を参照してください。複数のアカウントを並行して実行するのに便利です。例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

417| `CLAUDE_DISABLE_ADOPT` | `←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) を押してセッションをバックグラウンド化するときに、進行中のバックグラウンド作業を引き継ぐ代わりに停止するには、`1` に設定します。Claude Code はバックグラウンド化する前に確認を求め、それ以外の場合は引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |417| `CLAUDE_DISABLE_ADOPT` | `←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化するときに、進行中のバックグラウンド作業を引き継ぐ代わりに停止するには `1` に設定します。Claude Code はバックグラウンド化する前に確認を求め、それ以外の場合は引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |

418| `CLAUDE_EFFORT` | サブプロセスが開始されるときに有効な [努力レベル](/docs/ja/model-config#adjust-effort-level) に Bash ツールサブプロセスおよびフックコマンドで自動的に設定されます:`low`、`medium`、`high`、`xhigh`、`max`。[フック](/docs/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメーターをサポートする場合のみ設定されます |418| `CLAUDE_EFFORT` | サブプロセスが開始するときに有効な [努力レベル](/docs/ja/model-config#adjust-effort-level) に Bash ツールサブプロセスとフックコマンドで自動的に設定されます:`low`、`medium`、`high`、`xhigh`、または `max`。[フック](/docs/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメーターをサポートする場合のみ設定されます |

419| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドル監視犬を強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。`0` は、その監視犬が実行される接続の [最初バイトデッドライン](/docs/ja/network-config#streaming-idle-watchdogs) もオフにします。設定されていない場合、監視犬は直接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 接続でデフォルトで有効になり、`ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を通じて到達した [ゲートウェイ](/docs/ja/gateways) 接続でのストリーミング応答に対して有効になります;v2.1.222 より前は、これらのゲートウェイ接続では実行されず、キープアライブピングが到着している間でもイベントレベルの監視犬がスタルを報告する可能性がありました。タイムアウトおよびタイマーがどのように相互作用するかについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |419| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドル監視犬を強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。`0` はまた、その監視犬が実行される接続で [最初バイト期限](/docs/ja/network-config#streaming-idle-watchdogs) をオフにします。設定されていない場合、監視犬は直接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 接続でデフォルトで有効になり、`ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を通じて到達した [ゲートウェイ](/docs/ja/gateways) 接続でのストリーミング応答に対して有効になります。v2.1.222 より前は、これらのゲートウェイ接続では実行されず、イベントレベル監視犬はそこで停止を報告する可能性があります。キープアライブピングが到着していても。タイムアウトおよびタイマーがどのように相互作用するかについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |

420| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` レスポンスでバイトレベルストリーミングアイドル監視犬を有効にするには、`1` に設定します。これにより、Bedrock ストリーミングリクエストの [最初バイトデッドライン](/docs/ja/network-config#streaming-idle-watchdogs) も有効になります。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |420| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 応答でバイトレベルストリーミングアイドル監視犬を有効にするには `1` に設定します。これにより、Bedrock ストリーミングリクエストで [最初バイト期限](/docs/ja/network-config#streaming-idle-watchdogs) も有効になります。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |

421| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドル監視犬を強制的に無効にするには `0` に設定するか、強制的に有効にするには `1` に設定します。設定されていない場合、監視犬はすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、設定されていないデフォルトは直接 Anthropic API でサーバー制御され、他のプロバイダーではオフでした。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します;このタイムアウトと一緒に実行される他のスタルタイマーについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |421| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドル監視犬を強制的に無効にするには `0` に設定するか、強制的に有効にするには `1` に設定します。設定されていない場合、監視犬はすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、設定されていないデフォルトは直接 Anthropic API でサーバー制御され、他のプロバイダーではオフでした。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します。このタイムアウトと一緒に実行される他の停止タイマーについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |

422| `CLAUDE_ENV_FILE` | シェルスクリプトへのパス。その内容は Claude Code が同じシェルプロセスで各 Bash コマンドの前に実行するため、ファイルのエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。また、[SessionStart](/docs/ja/hooks#persist-environment-variables)、[Setup](/docs/ja/hooks#setup)、[CwdChanged](/docs/ja/hooks#cwdchanged)、[FileChanged](/docs/ja/hooks#filechanged) フック によって動的に設定されます |422| `CLAUDE_ENV_FILE` | シェルスクリプトへのパス。その内容は Claude Code が同じシェルプロセスで各 Bash コマンドの前に実行するため、ファイル内のエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。また、[SessionStart](/docs/ja/hooks#persist-environment-variables)、[Setup](/docs/ja/hooks#setup)、[CwdChanged](/docs/ja/hooks#cwdchanged)、[FileChanged](/docs/ja/hooks#filechanged) フックによって動的に設定されます |

423| `CLAUDE_JOB_DIR` | Claude Code によって各 [バックグラウンドセッション](/docs/ja/agent-view) でそのセッションの `~/.claude/jobs/<id>` ディレクトリに設定されます。セッションが実行するシェルコマンドはそれを継承します。スクラッチファイルを [`$CLAUDE_JOB_DIR/tmp`](/docs/ja/agent-view#where-state-is-stored) に書き込みます。Claude の `Write` および `Edit` 呼び出しはそこで権限を求めず、セッションが削除されるとディレクトリは削除されます |423| `CLAUDE_JOB_DIR` | Claude Code によって各 [バックグラウンドセッション](/docs/ja/agent-view) でそのセッションの `~/.claude/jobs/<id>` ディレクトリに設定されます。セッションが実行するシェルコマンドはそれを継承します。スクラッチファイルを [`$CLAUDE_JOB_DIR/tmp`](/docs/ja/agent-view#where-state-is-stored) に書き込みます。Claude の `Write` および `Edit` 呼び出しはそこで権限を求めず、セッションが削除されるとディレクトリは削除されます |

424| `CLAUDE_PID` | Claude Code はこれを生成するサブプロセスで独自のプロセス ID に設定します:Bash および PowerShell ツールコマンドおよびフックコマンド。Linux では、Bash ツールのシェル統合はそれを使用して、Claude Code プロセス自体と一致する `pkill` パターンを拒否します;[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process) を参照してください。独自のスクリプトからそれを読み取って、親 Claude Code プロセスを意図的に識別またはシグナルします。Claude Code v2.1.214 以降が必要です |424| `CLAUDE_PID` | Claude Code はこれを生成するサブプロセスで独自のプロセス ID に設定します:Bash および PowerShell ツールコマンドとフックコマンド。Linux では、Bash ツールのシェル統合はそれを使用して、Claude Code プロセス自体と一致する `pkill` パターンを拒否します。[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process) を参照してください。独自のスクリプトからそれを読み取って、親 Claude Code プロセスを意図的に識別またはシグナルします。Claude Code v2.1.214 以降が必要です |

425| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が提供されない場合、自動生成された [Remote Control](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一呼び出しに対して同じ値を設定します |425| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が提供されない場合、自動生成された [リモートコントロール](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一呼び出しに対して同じ値を設定します |

426| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | ストリーミングリクエストの最初のレスポンスバイトのデッドライン(ミリ秒単位)。[最初バイトデッドライン](/docs/ja/network-config#streaming-idle-watchdogs) が実行される接続で。Claude Code がそれをクランプする方法、大きなリクエスト本体に追加する追加時間、設定されていない場合にデッドラインを選択する方法については、[API からの応答がない](/docs/ja/errors#no-response-from-api) を参照してください。Claude Code v2.1.242 以降が必要です |426| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | ストリーミングリクエストの最初の応答バイトの期限(ミリ秒単位)。[最初バイト期限](/docs/ja/network-config#streaming-idle-watchdogs) が実行される接続で。Claude Code がそれをクランプする方法、大きなリクエスト本体に追加する追加時間、設定されていない場合に期限を選択する方法については、[API からの応答がない](/docs/ja/errors#no-response-from-api) を参照してください。Claude Code v2.1.242 以降が必要です |

427| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントレベルおよびバイトレベルストリーミングアイドル監視犬が停止した接続を閉じるまでのタイムアウト(ミリ秒単位)。この変数を明示的に設定すると、最小値は `300000`(5 分)です;低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために 1 秒に静かにクランプされ、バイトレベルの監視犬は値を 30 分でキャップします。`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` はバイトレベルの監視犬に対してこの変数より優先されます。監視犬ごとの設定されていないデフォルトについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |427| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントレベルおよびバイトレベルストリーミングアイドル監視犬が停止した接続を閉じるまでのタイムアウト(ミリ秒単位)。この変数を明示的に設定すると、最小値は `300000`(5 分)です。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために 1 秒に静かにクランプされ、バイトレベル監視犬は値を 30 分でキャップします。`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` はバイトレベル監視犬のこの変数より優先されます。監視犬ごとの設定されていないデフォルトについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |

428| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は no-op です。以前は、[サブエージェント](/docs/ja/sub-agents) が開始した [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) が実行できる時間の上限(ミリ秒単位)をキャップしていました。デフォルト 60 分。[バックグラウンドコマンドライフタイムルール](/docs/ja/tools-reference#background-commands) を参照してください |428| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は no-op です。以前は、[サブエージェント](/docs/ja/sub-agents) が開始した [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) が実行できる最大時間(ミリ秒単位)をキャップしていました。デフォルト 60 分。[バックグラウンドコマンドライフタイムルール](/docs/ja/tools-reference#background-commands) を参照してください |

429| `DEBUG` | デバッグモードを有効にするには、`1` に設定します。[`--debug`](/docs/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` のみが truthy 値でデバッグモードを有効にするため、他のツール用に設定された `DEBUG=express:*` などの名前空間パターンはそれをトリガーしません |429| `DEBUG` | デバッグモードを有効にするには `1` に設定します。[`--debug`](/docs/ja/cli-reference#cli-flags) で起動することと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` のみが truthy 値であるため、`DEBUG=express:*` などの名前空間パターンは他のツール用に設定されてもトリガーしません |

430| `DISABLE_AUTOUPDATER` | 自動バックグラウンド更新を無効にするには、`1` に設定します。手動 `claude update` は引き続き機能します。自動更新と手動更新の両方をブロックするには `DISABLE_UPDATES` を使用します |430| `DISABLE_AUTOUPDATER` | 自動バックグラウンド更新を無効にするには `1` に設定します。手動 `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |

431| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づいたときの自動コンパクションを無効にするには、`1` に設定します。手動 `/compact` コマンドは利用可能なままです。コンパクションが発生するときに明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定をオーバーライドします |431| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づいたときの自動コンパクションを無効にするには `1` に設定します。手動 `/compact` コマンドは利用可能なままです。コンパクションが発生するときに明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定をオーバーライドします |

432| `DISABLE_COMPACT` | すべてのコンパクション(自動コンパクションと手動 `/compact` コマンド)を無効にするには、`1` に設定します |432| `DISABLE_COMPACT` | すべてのコンパクション(自動コンパクションと手動 `/compact` コマンド)を無効にするには `1` に設定します |

433| `DISABLE_COST_WARNINGS` | コスト警告メッセージを無効にするには、`1` に設定します |433| `DISABLE_COST_WARNINGS` | コスト警告メッセージを無効にするには `1` に設定します |

434| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルおよびその `/checkup` エイリアスを非表示にするには、`1` に設定します。ユーザーがセッションからセットアップ診断を実行すべきではない管理デプロイメントに便利です。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断スクリーンコマンドを非表示にしていました |434| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとその `/checkup` エイリアスを非表示にするには `1` に設定します。ユーザーがセッションからセットアップ診断を実行すべきでない管理デプロイメントに便利です。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断スクリーンコマンドを非表示にしていました |

435| `DISABLE_ERROR_REPORTING` | エラー報告をオプトアウトするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**します。ほとんどのオン/オフ変数とは異なり;変数を設定解除してエラー報告をオンに戻します |435| `DISABLE_ERROR_REPORTING` | エラー報告をオプトアウトするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してエラー報告をオンに戻します |

436| `DISABLE_EXTRA_USAGE_COMMAND` | レート制限を超えて追加使用を購入できるようにする `/usage-credits` コマンドを非表示にするには、`1` に設定します |436| `DISABLE_EXTRA_USAGE_COMMAND` | レート制限を超えた追加使用を購入できるようにする `/usage-credits` コマンドを非表示にするには `1` に設定します |

437| `DISABLE_FEEDBACK_COMMAND` | `/feedback` コマンドおよび [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を無効にするには、`1` に設定します。また、`/bug` および `/share` を無効にします。これらは同じパスを通じて報告します;v2.1.212 より前は、それらは `/feedback` のエイリアスであったため、コマンドはすべての名前で無効になっていました。古い名前 `DISABLE_BUG_COMMAND` も受け入れられます |437| `DISABLE_FEEDBACK_COMMAND` | `/feedback` コマンドと [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を無効にするには `1` に設定します。また、`/bug` および `/share` を無効にします。これらは同じパスを通じて報告します。v2.1.212 より前は、それらは `/feedback` のエイリアスであったため、コマンドはすべての名前で無効になっていました。古い名前 `DISABLE_BUG_COMMAND` も受け入れられます |

438| `DISABLE_GROWTHBOOK` | GrowthBook 機能フラグ取得を無効にし、すべてのフラグにコードデフォルトを使用するには、`1` または `true` に設定します。これにより、[Remote Control](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。`0` または `false` に設定すると、取得がオンのままになります。テレメトリイベントログは `DISABLE_TELEMETRY` も設定されていない限りオンのままです |438| `DISABLE_GROWTHBOOK` | GrowthBook 機能フラグ取得を無効にし、すべてのフラグにコードデフォルトを使用するには `1` または `true` に設定します。これにより、[リモートコントロール](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。`0` または `false` に設定すると、取得がオンのままになります。テレメトリイベントログは `DISABLE_TELEMETRY` も設定されていない限りオンのままです |

439| `DISABLE_INSTALLATION_CHECKS` | インストール警告を無効にするには、`1` に設定します。インストール場所を手動で管理する場合のみ使用します。標準インストールの問題をマスクできるためです |439| `DISABLE_INSTALLATION_CHECKS` | インストール警告を無効にするには `1` に設定します。インストール場所を手動で管理する場合のみ使用します。標準インストールの問題をマスクできるため |

440| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` コマンドを非表示にするには、`1` に設定します。サードパーティプロバイダー(Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry)を使用する場合は既に非表示です |440| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` コマンドを非表示にするには `1` に設定します。サードパーティプロバイダー(Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry)を使用する場合は既に非表示です |

441| `DISABLE_INTERLEAVED_THINKING` | インターリーブ思考ベータヘッダーの送信を防ぐには、`1` に設定します。LLM ゲートウェイまたはプロバイダーが [インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) をサポートしていない場合に便利です |441| `DISABLE_INTERLEAVED_THINKING` | インターリーブ思考ベータヘッダーの送信を防ぐには `1` に設定します。LLM ゲートウェイまたはプロバイダーが [インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) をサポートしていない場合に便利です |

442| `DISABLE_LOGIN_COMMAND` | `/login` コマンドを非表示にするには、`1` に設定します。認証が API キーまたは `apiKeyHelper` を通じて外部で処理される場合に便利です |442| `DISABLE_LOGIN_COMMAND` | `/login` コマンドを非表示にするには `1` に設定します。認証が API キーまたは `apiKeyHelper` を通じて外部で処理される場合に便利です |

443| `DISABLE_LOGOUT_COMMAND` | `/logout` コマンドを非表示にするには、`1` に設定します |443| `DISABLE_LOGOUT_COMMAND` | `/logout` コマンドを非表示にするには `1` に設定します |

444| `DISABLE_PROMPT_CACHING` | すべてのモデルの [プロンプトキャッシング](/docs/ja/prompt-caching#disable-prompt-caching) を無効にするには、`1` に設定します(モデルごとの設定より優先されます) |444| `DISABLE_PROMPT_CACHING` | すべてのモデルの [プロンプトキャッシング](/docs/ja/prompt-caching#disable-prompt-caching) を無効にするには `1` に設定します(モデルごとの設定より優先) |

445| `DISABLE_PROMPT_CACHING_FABLE` | Fable モデルのプロンプトキャッシングを無効にするには、`1` に設定します |445| `DISABLE_PROMPT_CACHING_FABLE` | Fable モデルのプロンプトキャッシングを無効にするには `1` に設定します |

446| `DISABLE_PROMPT_CACHING_HAIKU` | [デフォルト Haiku モデル](/docs/ja/prompt-caching#disable-prompt-caching) のプロンプトキャッシングを無効にするには、`1` に設定します。どこで実行されるかに関わらず |446| `DISABLE_PROMPT_CACHING_HAIKU` | [デフォルト Haiku モデル](/docs/ja/prompt-caching#disable-prompt-caching) のプロンプトキャッシングを無効にするには `1` に設定します。どこで実行されるか |

447| `DISABLE_PROMPT_CACHING_OPUS` | Opus モデルのプロンプトキャッシングを無効にするには、`1` に設定します |447| `DISABLE_PROMPT_CACHING_OPUS` | [デフォルト Opus モデル](/docs/ja/prompt-caching#disable-prompt-caching) のプロンプトキャッシングを無効にするには `1` に設定します |

448| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet モデルのプロンプトキャッシングを無効にするには、`1` に設定します |448| `DISABLE_PROMPT_CACHING_SONNET` | [デフォルト Sonnet モデル](/docs/ja/prompt-caching#disable-prompt-caching) のプロンプトキャッシングを無効にするには `1` に設定します |

449| `DISABLE_TELEMETRY` | テレメトリをオプトアウトするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**します。ほとんどのオン/オフ変数とは異なり;変数を設定解除してテレメトリをオンに戻します。テレメトリイベントはコード、ファイルパス、Bash コマンドなどのユーザーデータを含みません。また、[機能フラグ取得](#features-that-need-feature-flag-fetching) を無効にします。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization) を参照してください |449| `DISABLE_TELEMETRY` | テレメトリをオプトアウトするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してテレメトリをオンに戻します。テレメトリイベントにはコード、ファイルパス、Bash コマンドなどのユーザーデータは含まれません。また、[機能フラグ取得](#features-that-need-feature-flag-fetching) を無効にします。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization) を参照してください |

450| `DISABLE_UPDATES` | 手動 `claude update` および `claude install` を含むすべての更新をブロックするには、`1` に設定します。`DISABLE_AUTOUPDATER` より厳しい。独自のチャネルを通じて Claude Code を配布し、ユーザーが自己更新すべきでない場合に使用します |450| `DISABLE_UPDATES` | 手動 `claude update` および `claude install` を含むすべての更新をブロックするには `1` に設定します。`DISABLE_AUTOUPDATER` より厳しい。独自のチャネルを通じて Claude Code を配布し、ユーザーが自動更新すべきでない場合に使用します |

451| `DISABLE_UPGRADE_COMMAND` | `/upgrade` コマンドを非表示にするには、`1` に設定します |451| `DISABLE_UPGRADE_COMMAND` | `/upgrade` コマンドを非表示にするには `1` に設定します |

452| `DO_NOT_TRACK` | テレメトリをオプトアウトするには、`1` に設定します。`DISABLE_TELEMETRY` と同じ効果。[機能フラグ取得](#features-that-need-feature-flag-fetching) を含む。Claude Code はこの変数を標準ブール値として読み取るため、`0` はテレメトリをオンのままにし、多くの開発者 CLI で認識されるクロスツール規約として尊重します |452| `DO_NOT_TRACK` | テレメトリをオプトアウトするには `1` に設定します。`DISABLE_TELEMETRY` と同じ効果。[機能フラグ取得](#features-that-need-feature-flag-fetching) を含む。Claude Code はこの変数を標準ブール値として読み取るため、`0` はテレメトリをオンのままにし、多くの開発者 CLI で認識されるクロスツール規約として尊重します |

453| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT` と一緒に、[詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) をオンにするには、`1` に設定します。コンテンツを含むスパン属性および `claude_code.hook` スパンを追加します。対話型 CLI セッションは、組織がベータ用にホワイトリストに登録されている必要もあります。両方の変数は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |453| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT` と一緒に [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) をオンにするには `1` に設定します。コンテンツを含むスパン属性と `claude_code.hook` スパンを追加します。対話 CLI セッションはまた、組織がベータ用にホワイトリストに登録されている必要があります。両方の変数は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

454| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code が [claude.ai MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai) をフェッチするのを停止するには、`false` に設定します。ログインしたユーザーでデフォルトで有効になります。プロジェクトごとまたは組織ごとに無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定します |454| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code が [claude.ai MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai) をフェッチするのを停止するには `false` に設定します。ログインしたユーザーではデフォルトで有効になります。プロジェクトごとまたは組織ごとに無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定します |

455| `ENABLE_PROMPT_CACHING_1H` | デフォルト 5 分の代わりに 1 時間の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストするには、`1` に設定します。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ユーザー向け。含まれた使用内のサブスクリプションユーザーは [メイン会話](/docs/ja/prompt-caching#which-ttl-each-request-gets) で自動的に 1 時間 TTL を受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を引き出すサブスクリプションユーザーは、1 時間 TTL を保持するために設定できます。1 時間のキャッシュ書き込みはより高いレートで請求されます。リクエストバケットごとに TTL を選択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` および `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用します。これらはこの変数より優先されます |455| `ENABLE_PROMPT_CACHING_1H` | デフォルト 5 分ではなく 1 時間の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストするには `1` に設定します。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ユーザー向け。サブスクリプションユーザーは、含まれた使用内で [メイン会話](/docs/ja/prompt-caching#which-ttl-each-request-gets) で自動的に 1 時間 TTL を受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を引き出すサブスクリプションユーザーは、1 時間 TTL を保持するために設定できます。1 時間キャッシュ書き込みはより高いレートで請求されます。リクエストバケットごとに TTL を選択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` および `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用します。これらはこの変数より優先されます |

456| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨。代わりに `ENABLE_PROMPT_CACHING_1H` を使用します |456| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨。代わりに `ENABLE_PROMPT_CACHING_1H` を使用します |

457| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) を制御します。設定されていない場合、Claude Code はデフォルトですべての MCP ツールを遅延させます。ただし、`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合、Google Cloud の Agent Platform モデルが Claude 4.5 世代より前の場合、Azure でホストされている Microsoft Foundry デプロイメントの場合は事前に読み込みます。`true` は常に遅延させ、ベータヘッダーを送信します。ただし、これらの同じ Agent Platform モデルおよび Microsoft Foundry デプロイメントを除きます;`tool_reference` をサポートしないプロキシではリクエストが失敗します。`auto` は、ツール定義がコンテキストの 10% 以内に収まる場合、事前に読み込みます。`auto:N` はカスタムしきい値を設定します。例えば、5% の場合は `auto:5`。`false` はすべてのツールを事前に読み込みます。自分で設定した値は、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合は無視されます。v2.1.221 より前は、Claude Code は、この変数を `true` に設定しない限り、Google Cloud の Agent Platform のすべてのモデルのツール検索を無効にしていました |457| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) を制御します。設定されていない場合、Claude Code はデフォルトですべての MCP ツールを遅延させます。ただし、Google Cloud の Agent Platform モデルの Claude 4.5 世代より前のモデル、Azure でホストされている Microsoft Foundry デプロイメント、`ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は、事前に読み込みます。`true` は常に遅延させ、ベータヘッダーを送信します。ただし、これらの同じ Agent Platform モデルと Microsoft Foundry デプロイメント上では除外されます。リクエストは `tool_reference` をサポートしないプロキシで失敗します。`auto` は、ツール定義がコンテキストの 10% 以内に収まる場合、事前に読み込みます。`auto:N` はカスタムしきい値を設定します。例えば `auto:5` は 5% です。`false` はすべてのツールを事前に読み込みます。自分で設定した値は、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合は無視されます。v2.1.221 より前は、Claude Code は、この変数を `true` に設定しない限り、Google Cloud の Agent Platform のすべてのモデルのツール検索を無効にしていました |

458| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Claude Code が設定されたフォールバックモデルがない場合、すべてのモデルで繰り返されたオーバーロードエラーで再試行を停止するようにするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもこれを有効にします**。ほとんどのオン/オフ変数とは異なり;変数を設定解除してデフォルト再試行動作を復元します。これがない場合、Claude Code は API キーまたは [サードパーティプロバイダー](/docs/ja/third-party-integrations) ではなく Claude サブスクリプションで認証する場合、Opus、Fable、Mythos モデルとして認識するモデルでこのように再試行を停止します。Claude Code v2.1.160 以降では、Claude Code は繰り返されたオーバーロードエラーで設定された [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) に切り替えるため、この変数はプライマリモデルへの切り替えに影響しません |458| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Claude Code が設定されたフォールバックモデルがない場合、すべてのモデルで繰り返されたオーバーロードエラーで再試行を停止するようにするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもこれを有効にします**。ほとんどのオン/オフ変数とは異なり。設定されていない場合、Claude Code は、API キーまたは [サードパーティプロバイダー](/docs/ja/third-party-integrations) で認証する場合、Opus、Fable、Mythos モデルとして認識するモデルでこの方法で再試行を停止します。Claude サブスクリプションではなく。Claude Code v2.1.160 以降では、Claude Code は繰り返されたオーバーロードエラーで設定された [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) に切り替えるため、この変数はフォールバックモデルへの切り替えに影響しません |

459| `FORCE_AUTOUPDATE_PLUGINS` | メイン自動アップデーターが `DISABLE_AUTOUPDATER` を通じて無効になっている場合でも、プラグイン自動更新を強制するには、`1` に設定します |459| `FORCE_AUTOUPDATE_PLUGINS` | メイン自動アップデーターが `DISABLE_AUTOUPDATER` を通じて無効になっている場合でも、プラグイン自動更新を強制するには `1` に設定します |

460| `FORCE_HYPERLINK` | ターミナルがサポートしているが自動検出されていない場合、クリック可能な OSC 8 ハイパーリンクを有効にするには `1` に設定するか、無効にするには `0` に設定します。設定されていない場合、Claude Code はターミナルサポートを検出した場合のみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にする代わりに有効にします。フッター [PR またはマージリクエストバッジ](/docs/ja/interactive-mode#pr-review-status) は、SSH 経由など Claude Code がターミナルサポートを検出できない場合でも、ハイパーリンクとしてレンダリングされます。バッジをプレーンテキストとしてレンダリングするには `0` に設定します |460| `FORCE_HYPERLINK` | ターミナルがサポートしているが自動検出されていない場合、クリック可能な OSC 8 ハイパーリンクを有効にするには `1` に設定するか、無効にするには `0` に設定します。設定されていない場合、Claude Code はターミナルサポートが検出された場合のみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にするのではなく有効にします。フッター [PR またはマージリクエストバッジ](/docs/ja/interactive-mode#pr-review-status) は、Claude Code がターミナルサポートを検出できない場合(SSH 経由など)でも、ハイパーリンクとしてレンダリングされます。バッジをプレーンテキストとしてレンダリングするには `0` に設定します |

461| `FORCE_PROMPT_CACHING_5M` | 1 時間 TTL がそれ以外の場合適用される場合でも、5 分のプロンプトキャッシュ TTL を強制するには、`1` に設定します。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` および `subagentPromptCacheTtl` 設定をオーバーライドします |461| `FORCE_PROMPT_CACHING_5M` | 1 時間 TTL がそれ以外の場合適用される場合でも、5 分プロンプトキャッシュ TTL を強制するには `1` に設定します。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` および `subagentPromptCacheTtl` 設定をオーバーライドします |

462| `HTTP_PROXY` | ネットワーク接続用の HTTP プロキシサーバーを指定します |462| `HTTP_PROXY` | ネットワーク接続用の HTTP プロキシサーバーを指定します |

463| `HTTPS_PROXY` | ネットワーク接続用の HTTPS プロキシサーバーを指定します |463| `HTTPS_PROXY` | ネットワーク接続用の HTTPS プロキシサーバーを指定します |

464| `IS_DEMO` | デモモードを有効にするには、`1` などの空でない値に設定します:ヘッダーおよび `/status` 出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**`0` または `false` に設定してもデモモードを有効にします**。ほとんどのオン/オフ変数とは異なり;変数を設定解除してオフにします。セッションをストリーミングまたは記録する場合に便利です |464| `IS_DEMO` | デモモードを有効にするには、`1` などの空でない値に設定します:ヘッダーと `/status` 出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**`0` または `false` に設定してもデモモードを有効にします**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してオフにします。セッションをストリーミングまたは記録する場合に便利です |

465| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールはテキストコンテンツにその文字制限を使用しますが、これらのツールからの画像コンテンツはこの変数の対象です(デフォルト:25000) |465| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールは、テキストコンテンツにはその文字制限を使用しますが、これらのツールからの画像コンテンツはこの変数の対象です(デフォルト:25000) |

466| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モードで `-p` フラグを使用して、モデルのレスポンスが [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合、Claude Code が許可する試行回数;その後、有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows) サブエージェントの構造化出力が検証に失敗した場合も同じキャップが適用されます。デフォルト 5(最初の試行と 4 回の再試行) |466| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モードで `-p` フラグを使用して、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合、Claude Code が許可する試行回数。その後、有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows) サブエージェントの構造化出力が検証に失敗した場合にも同じキャップが適用されます。デフォルト 5。最初の試行と 4 回の再試行 |

467| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) の固定トークン予算。Claude Code はリクエストの最大出力トークンの 1 トークン下でキャップし、1,024 未満にはしません。[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/model-config#adjust-effort-level) でその制限を設定する方法を参照してください。設定されていない場合、[適応的推論](/docs/ja/model-config#adjust-effort-level) を持つモデルは独自の思考深度を選択し、他のモデルはキャップを使用します。Anthropic API で思考をオフにするには `0` に設定します。ただし、Opus 5.5、Sonnet 5.5、Fable モデルを除きます。これらは思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`0` も同様にパラメーターを省略するため、2 つの変数は同じように動作します。Anthropic API で思考がオフの場合、Claude Code は `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が思考をオフにしない限り、Opus 5 などの [その組み合わせを受け入れないモデル](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off) に努力 `high` を送信します。Claude Code は適応的推論モデルで非ゼロ値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が適応的推論をオフにするモデルを除きます |467| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) の固定トークン予算。Claude Code はそれをリクエストの最大出力トークンの 1 トークン下にキャップし、1,024 未満にはしません。[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/model-config#adjust-effort-level) でその制限がどのように設定されるかを参照してください。設定されていない場合、思考が有効な場合、[適応的推論](/docs/ja/model-config#adjust-effort-level) を持つモデルは独自の思考深度を選択し、他のモデルはキャップを使用します。Anthropic API で思考を無効にするには `0` に設定します。ただし、Opus 5.5、Sonnet 5.5、Fable モデルは除外されます。これらは思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`0` はパラメーターを省略します。Anthropic API で思考がオフの場合、Claude Code は、Opus 5 などの [その組み合わせを受け入れないモデル](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off) に努力 `high` を送信します。Claude Code は、適応的推論モデルでゼロ以外の値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が適応的推論をオフにするモデルは除外されます |

468| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバー用の OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |468| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときにインタラクティブプロンプトを回避します |

469| `MCP_CONNECTION_NONBLOCKING` | MCP サーバーが最初のクエリの前に接続するまで起動が待機するかどうかを制御します。MCP スタートアップはデフォルトで非ブロッキングです:サーバーはバックグラウンドで接続し、完了するとそれらのツールが利用可能になります。`0` に設定して、最初のクエリの前にサーバーが接続するまで Claude Code を待たせます。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、[検出キャッシュ](/docs/ja/mcp#server-status-detail) から提供される場合を除き、最初のプロンプトが構築されるときにツールが存在する必要があるため、スタートアップを待たせます。非対話モード(`-p`)で `--input-format stream-json` なしでは、Claude Code は最初のターンの前に保留中のサーバーを待ちます。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡す場合、待機にはより長いデッドラインがあります;キャッシュされたサーバーの例外についてはそのフラグのエントリを参照してください |469| `MCP_CONNECTION_NONBLOCKING` | MCP サーバーが最初のクエリの前に接続するのを待つかどうかを制御します。MCP スタートアップはデフォルトでは非ブロッキングです:サーバーはバックグラウンドで接続し、完了するとそれらのツールが利用可能になります。最初のクエリの前にサーバーが接続するのを待つには `0` に設定します。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、[検出キャッシュ](/docs/ja/mcp#server-status-detail) から提供される場合を除き、最初のプロンプトが構築されるときにツールが存在する必要があるため、スタートアップを待つようにします。非対話モード(`-p`)で `--input-format stream-json` なしの場合、Claude Code はまた、この変数に関係なく、最初のターンの前に保留中のサーバーを待ちます。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡す場合、待機にはより長い期限があります。キャッシュされたサーバーの例外については、そのフラグのエントリを参照してください |

470| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップがツールリストをスナップショットする前に接続バッチを待つ時間(ミリ秒単位)(デフォルト:5000)。`MCP_CONNECTION_NONBLOCKING=0` または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。デッドラインで保留中のサーバーはバックグラウンドで接続し続けます。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行をバウンドします |470| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップが接続バッチを待つ時間(ミリ秒単位)。ツールリストをスナップショットする前(デフォルト:5000)。`MCP_CONNECTION_NONBLOCKING=0` または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。サーバーは期限で保留中のままバックグラウンドで接続し続けます。`MCP_TIMEOUT` とは異なります。これは個々のサーバーの接続試行をバウンドします |

471| `MCP_DISCOVERY_CACHE` | [MCP 検出キャッシュ](/docs/ja/mcp#server-status-detail) をオンまたはオフにします。キャッシュがオンの場合、以前に使用したリモート HTTP または SSE サーバーは [`cached` ステータス](/docs/ja/mcp#server-status-detail) を表示でき、Claude Code は最初のツール呼び出しでそれに接続します。スタートアップではなく。キャッシュはデフォルトではオフです。段階的ロールアウトがアカウントに対して有効にしない限り。オンにするには `1` に設定するか、ロールアウトが有効にしている場合でもオフに保つには `0` に設定します。v2.1.238 より前は、キャッシュはデフォルトでオンでした。`cached` ステータスには Claude Code v2.1.221 以降が必要です |471| `MCP_DISCOVERY_CACHE` | [MCP 検出キャッシュ](/docs/ja/mcp#server-status-detail) をオンまたはオフにします。キャッシュがオンの場合、以前使用したリモート HTTP または SSE サーバーは [`cached` ステータス](/docs/ja/mcp#server-status-detail) を表示でき、Claude Code はスタートアップではなく最初のツール呼び出しで接続します。キャッシュはデフォルトではオフです。段階的ロールアウトがアカウントに対して有効にしていない限り。オンにするには `1` に設定するか、ロールアウトが有効にしている場合でもオフに保つには `0` に設定します。v2.1.238 より前は、キャッシュはデフォルトでオンでした。`cached` ステータスには Claude Code v2.1.221 以降が必要です |

472| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリの最大経過時間(秒単位)(デフォルト:14400、または 4 時間)。エントリがそれより古い開始では、Claude Code はそれを破棄し、スタートアップでサーバーに接続します。キャッシュがオフの場合と同様に。Claude Code は値を 7 日でキャップします。v2.1.238 より前は、デフォルトは 86400(24 時間)で、Claude Code は値をキャップしませんでした |472| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリの最大経過時間(秒単位)(デフォルト:14400、または 4 時間)。エントリがそれより古い開始では、Claude Code はそれを破棄し、スタートアップでサーバーに接続します。キャッシュがオフの場合と同じです。Claude Code は値を 7 日でキャップします。v2.1.238 より前は、デフォルトは 86400(24 時間)で、Claude Code は値をキャップしませんでした |

473| `MCP_DISCOVERY_CACHE_STRIKES` | [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い開始では、Claude Code はバックグラウンドでそれをリフレッシュします。この変数は、Claude Code がエントリを破棄し、代わりに次の開始でサーバーに接続する前に、連続でリフレッシュが失敗できる回数を設定します(デフォルト:1)。ネットワーク接続が時々ドロップする場合は上げます。1 回の失敗したリフレッシュがエントリを破棄しないようにします。Claude Code v2.1.238 以降が必要です |473| `MCP_DISCOVERY_CACHE_STRIKES` | 開始時に [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い場合、Claude Code はバックグラウンドでリフレッシュします。この変数は、リフレッシュが連続して失敗してからエントリを破棄し、次の開始でサーバーに接続する前に失敗できる回数を設定します(デフォルト:1)。ネットワーク接続が時々ドロップする場合は上げます。1 回の失敗したリフレッシュがエントリを破棄しないようにします。Claude Code v2.1.238 以降が必要です |

474| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリをリフレッシュなしで使用する秒数(デフォルト:900)。エントリがそれより古い開始では、Claude Code は引き続きそれを使用しますが、バックグラウンドでリフレッシュします。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古い場合、Claude Code は代わりに破棄します。Claude Code は値を `MCP_DISCOVERY_CACHE_MAX_STALE_S`(デフォルト 4 時間)でキャップします。v2.1.238 より前は、Claude Code は値をキャップしませんでした |474| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリをリフレッシュせずに使用する秒数(デフォルト:900)。エントリがそれより古い開始では、Claude Code はそれでも使用しますがバックグラウンドでリフレッシュします。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古い場合、Claude Code は代わりにそれを破棄します。Claude Code は値を `MCP_DISCOVERY_CACHE_MAX_STALE_S`(デフォルト 4 時間)でキャップします。v2.1.238 より前は、Claude Code は値をキャップしませんでした |

475| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) を使用して MCP サーバーを追加するときの OAuth リダイレクトコールバック用の固定ポート。`--callback-port` の代替 |475| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) を使用して MCP サーバーを追加するときの OAuth リダイレクトコールバックの固定ポート。`--callback-port` の代替 |

476| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) でのみ、Claude Code が MCP プロトコルリビジョン 2026-07-28 のサーバーをプローブするかどうか。HTTP、claude.ai コネクター、stdio サーバーをプローブするには `auto` に設定します;プローブに応答しないサーバーは以前のプロトコルで接続します。SSE および WebSocket サーバーは常にそうします。すべてのサーバーのプローブをスキップするには `legacy` に設定します。変数がない場合、Claude Code は HTTP サーバーをプローブし、機能フラグを [フェッチ](#features-that-need-feature-flag-fetching) するセッションで claude.ai コネクターサーバーもプローブします。その他の値は警告で無視されます。デバッグログで。Claude Code v2.1.221 以降が必要です |476| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) でのみ、Claude Code が MCP プロトコルリビジョン 2026-07-28 のサーバーをプローブするかどうか。HTTP、claude.ai コネクター、stdio サーバーをプローブするには `auto` に設定します。プローブに応答しないサーバーは以前のプロトコルで接続します。SSE および WebSocket サーバーは常にそうします。すべてのサーバーのプローブをスキップするには `legacy` に設定します。変数がない場合、Claude Code は HTTP サーバーをプローブし、[機能フラグを取得](/docs/ja/monitoring-usage#traces-beta) するセッションで claude.ai コネクターサーバーもプローブします。他の値は警告で無視されます。デバッグログで。Claude Code v2.1.221 以降が必要です |

477| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト:20) |477| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト:20) |

478| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーに接続する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) をピン留めします:`v1`(MCP TypeScript SDK 1.x に基づく)または `v2`([MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) に基づく)。変数がない場合、Claude Code は v2 を使用します。そのセクションにリストされているバージョンから開始します。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可レスポンスで返す発行者をチェックし、一致しない場合、`Issuer mismatch in authorization response` で始まるエラーでサインインに失敗します。v1 ランタイムはこのチェックを実行しません。認識されない値を設定した場合、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を読み取ります。Claude Code v2.1.218 以降が必要です |478| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーに接続する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) をピン留めします:`v1`(MCP TypeScript SDK 1.x に基づく)または `v2`([MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) に基づく)。変数がない場合、Claude Code は v2 を使用します。そのセクションにリストされているバージョンから開始。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可応答で返す発行者をチェックし、一致しない場合、`Issuer mismatch in authorization response` で始まるエラーでサインインを失敗させます。v1 ランタイムはこのチェックを実行しません。認識されない値を設定した場合、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を 1 回読み取ります。Claude Code v2.1.218 以降が必要です |

479| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するローカル MCP サーバー(stdio)の最大数(デフォルト:3) |479| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するローカル MCP サーバー(stdio)の最大数(デフォルト:3) |

480| `MCP_TIMEOUT` | MCP サーバースタートアップのタイムアウト(ミリ秒単位)(デフォルト:30000、または 30 秒) |480| `MCP_TIMEOUT` | MCP サーバースタートアップのタイムアウト(ミリ秒単位)(デフォルト:30000、または 30 秒) |

481| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト(ミリ秒単位)(デフォルト:100000000、約 28 時間)。HTTP、SSE、claude.ai コネクターサーバーの場合、各リクエストもデフォルトで 60 秒後にタイムアウトします;この変数またはサーバーごとの `timeout` を 60000 を超えて設定して、そのリクエストごとの制限を上げます。低い値はまだ全体的なツール実行タイムアウトを短縮しますが、リクエストごとの制限を 60 秒のままにします。Stdio および WebSocket サーバーにはリクエストごとのタイマーがありません。`.mcp.json` のサーバーごとの `timeout` フィールドはこのサーバーをオーバーライドします。少なくとも 1000 のサーバーごとの `timeout` はそのサーバーのツール呼び出しの最小アイドルウィンドウも設定するため、`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` はそれらを早期に中止しません;このフロアには Claude Code v2.1.203 以降が必要です。変数の場合、1000 未満の値は 1 秒にフロアされます;サーバーごとのフィールドの場合、1000 未満の値は無視されます |481| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト(ミリ秒単位)(デフォルト:100000000、約 28 時間)。HTTP、SSE、または claude.ai コネクターサーバーの場合、各リクエストもデフォルトで 60 秒後にタイムアウトします。この変数またはサーバーごとの `timeout` を 60000 以上に設定して、リクエストごとの制限を上げます。低い値はツール実行全体のタイムアウトを短縮しますが、リクエストごとの制限を 60 秒のままにします。Stdio および WebSocket サーバーにはリクエストごとのタイマーがありません。`.mcp.json` のサーバーごとの `timeout` フィールドはこのサーバーをオーバーライドします。少なくとも 1000 のサーバーごとの `timeout` はそのサーバーのツール呼び出しの最小アイドルウィンドウも設定するため、`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` はそれらを早期に中止しません。このフロアには Claude Code v2.1.203 以降が必要です。env 変数の場合、1000 未満の値は 1 秒にフロアされます。サーバーごとのフィールドの場合、1000 未満の値は無視されます |

482| `NO_PROXY` | リクエストが直接発行されるドメインおよび IP のリスト。プロキシをバイパスします |482| `NO_PROXY` | リクエストが直接発行されるドメインと IP のリスト。プロキシをバイパスします |

483| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 標準 OpenTelemetry SDK 属性値長制限。Claude Code はコンテンツを含むテレメトリ属性をこれと `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` の小さい方でキャップするため、切り詰めマーカーは SDK 制限内に留まります。Claude Code は `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` および `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` バリアントを同じ方法で読み取り、最小セット値がすべてのシグナルに適用されます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage#common-configuration-variables) を参照してください |483| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 属性値長の標準 OpenTelemetry SDK 制限。Claude Code はコンテンツを含むテレメトリ属性をこれと `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` の小さい方でキャップするため、切り詰めマーカーは SDK 制限内に留まります。Claude Code は `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` および `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` バリアントを同じ方法で読み取り、設定された最小値がすべてのシグナルに適用されます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage#common-configuration-variables) を参照してください |

484| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` OpenTelemetry ログイベントにモデルのレスポンステキストを含めるには、`1` に設定します。設定されていない場合、Claude Code は代わりに `OTEL_LOG_USER_PROMPTS` の値を使用します。`OTEL_LOG_USER_PROMPTS` が設定されている場合でも応答を編集のままにするには `0` に設定します。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。Claude Code v2.1.193 以降が必要です。[監視](/docs/ja/monitoring-usage#assistant-response-event) を参照してください |484| `OTEL_LOG_ASSISTANT_RESPONSES` | モデルの応答テキストを `assistant_response` OpenTelemetry ログイベントに含めるには `1` に設定します。設定されていない場合、Claude Code は `OTEL_LOG_USER_PROMPTS` の値を代わりに使用します。`OTEL_LOG_USER_PROMPTS` が設定されている場合でも応答を編集したままにするには `0` に設定します。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。Claude Code v2.1.193 以降が必要です。[監視](/docs/ja/monitoring-usage#assistant-response-event) を参照してください |

485| `OTEL_LOG_MANAGED_SETTINGS` | `managed_settings_resolved` OpenTelemetry ログイベントに編集された管理設定および編集前の設定の SHA-256 ダイジェストを追加するには、`1` に設定します。デフォルトで無効です。シェル、ユーザー設定、または管理設定で設定します;プロジェクトまたはローカル設定の値はそれをオンにしません。Claude Code v2.1.274 以降が必要です。[監視](/docs/ja/monitoring-usage#managed-settings-resolved-event) を参照してください |485| `OTEL_LOG_MANAGED_SETTINGS` | 編集された管理設定と、編集前の設定の SHA-256 ダイジェストを `managed_settings_resolved` OpenTelemetry ログイベントに追加するには `1` に設定します。デフォルトで無効。シェル、ユーザー設定、または管理設定で設定します。プロジェクトまたはローカル設定の値はそれをオンにしません。Claude Code v2.1.274 以降が必要です。[監視](/docs/ja/monitoring-usage#managed-settings-resolved-event) を参照してください |

486| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストおよびレスポンス JSON を `api_request_body` / `api_response_body` ログイベントとして発行します。コンテンツ制限でトリガーされたインラインボディの場合は `1` に設定するか、編集されていないボディをディスクに書き込み、代わりに `body_ref` パスを発行するには `file:<dir>` に設定します。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` はコンテンツ制限を設定します。デフォルト 60 KB。デフォルトで無効です;ボディは会話履歴全体を含みます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage#api-request-body-event) を参照してください |486| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストおよび応答 JSON を `api_request_body` / `api_response_body` ログイベントとして発行します。コンテンツ制限で切り詰められたインラインボディの場合は `1` に設定するか、切り詰められていないボディをディスクに書き込み、`body_ref` パスを代わりに発行するには `file:<dir>` に設定します。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` はコンテンツ制限を設定します。デフォルト 60 KB。デフォルトで無効。ボディには会話履歴全体が含まれます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage#api-request-body-event) を参照してください |

487| `OTEL_LOG_TOOL_CONTENT` | `tool.output` OpenTelemetry スパンイベントにツールコンテンツを含めるには、`1` に設定します。スパン属性は [独自のゲート](/docs/ja/monitoring-usage#new-context-gates) の下でツールコンテンツを運びます。[トレーシング](/docs/ja/monitoring-usage#traces-beta) が必要です。デフォルトで無効です。機密データを保護するため。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage#tool-output-span-event) を参照してください |487| `OTEL_LOG_TOOL_CONTENT` | `tool.output` OpenTelemetry スパンイベントにツールコンテンツを含めるには `1` に設定します。スパン属性は [独自のゲート](/docs/ja/monitoring-usage#new-context-gates) の下でツールコンテンツを実行します。[トレーシング](/docs/ja/monitoring-usage#traces-beta) が必要です。デフォルトで無効。機密データを保護するため。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage#tool-output-span-event) を参照してください |

488| `OTEL_LOG_TOOL_DETAILS` | ツール入力引数を含めるには、`1` に設定します;MCP サーバー名;ユーザー作成ワークフロー名;ツール失敗時の生エラー文字列;`api_refusal` イベントの拒否 `category`;[コストおよびトークンメトリクス](/docs/ja/monitoring-usage#cost-counter) の実際のエージェント、スキル、プラグイン、MCP サーバー名;およびその他のツール詳細。OpenTelemetry メトリクス、トレース、ログで。デフォルトで無効です。PII を保護するため。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage) を参照してください |488| `OTEL_LOG_TOOL_DETAILS` | ツール入力引数を含めるには `1` に設定します。MCP サーバー名。ユーザー作成ワークフロー名。ツール失敗時の生エラー文字列。`api_refusal` イベントの拒否 `category`。[コストおよびトークンメトリクス](/docs/ja/monitoring-usage#cost-counter) の実際のエージェント、スキル、プラグイン、MCP サーバー名。その他のツール詳細。OpenTelemetry メトリクス、トレース、ログで。デフォルトで無効。PII を保護するため。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage) を参照してください |

489| `OTEL_LOG_USER_PROMPTS` | OpenTelemetry トレースおよびログにユーザープロンプトテキストを含めるには、`1` に設定します。デフォルトで無効です(プロンプトは編集されます)。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage) を参照してください |489| `OTEL_LOG_USER_PROMPTS` | OpenTelemetry トレースおよびログにユーザープロンプトテキストを含めるには `1` に設定します。デフォルトで無効(プロンプトは編集されます)。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage) を参照してください |

490| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | メトリクス属性からアカウント UUID を除外するには、`false` に設定します(デフォルト:含まれます)。[監視](/docs/ja/monitoring-usage) を参照してください |490| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | メトリクス属性からアカウント UUID を除外するには `false` に設定します(デフォルト:含まれる)。[監視](/docs/ja/monitoring-usage) を参照してください |

491| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | メトリクス属性にセッションエントリポイントを含めるには、`true` に設定します(デフォルト:除外)。v2.1.152 で追加されました。[監視](/docs/ja/monitoring-usage) を参照してください |491| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | メトリクス属性にセッションエントリポイントを含めるには `true` に設定します(デフォルト:除外)。v2.1.152 で追加されました。[監視](/docs/ja/monitoring-usage) を参照してください |

492| `OTEL_METRICS_INCLUDE_REPOSITORY` | OpenTelemetry メトリクスおよびイベントにセッションのリポジトリを識別する `vcs.*` 属性でタグ付けするには、`true` に設定します(デフォルト:除外)。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes) を参照してください |492| `OTEL_METRICS_INCLUDE_REPOSITORY` | OpenTelemetry メトリクスおよびイベントにセッションのリポジトリを識別する `vcs.*` 属性でタグ付けするには `true` に設定します(デフォルト:除外)。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes) を参照してください |

493| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` キーをメトリクスデータポイントラベルに添付します。除外するには `false` に設定します(デフォルト:含まれます)。[監視](/docs/ja/monitoring-usage#multi-team-organization-support) を参照してください |493| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` キーをメトリクスデータポイントラベルに添付します。除外するには `false` に設定します(デフォルト:含まれる)。[監視](/docs/ja/monitoring-usage#multi-team-organization-support) を参照してください |

494| `OTEL_METRICS_INCLUDE_SESSION_ID` | メトリクス属性からセッション ID を除外するには、`false` に設定します(デフォルト:含まれます)。[監視](/docs/ja/monitoring-usage) を参照してください |494| `OTEL_METRICS_INCLUDE_SESSION_ID` | メトリクス属性からセッション ID を除外するには `false` に設定します(デフォルト:含まれる)。[監視](/docs/ja/monitoring-usage) を参照してください |

495| `OTEL_METRICS_INCLUDE_VERSION` | メトリクス属性に Claude Code バージョンを含めるには、`true` に設定します(デフォルト:除外)。[監視](/docs/ja/monitoring-usage) を参照してください |495| `OTEL_METRICS_INCLUDE_VERSION` | メトリクス属性に Claude Code バージョンを含めるには `true` に設定します(デフォルト:除外)。[監視](/docs/ja/monitoring-usage) を参照してください |

496| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill) に表示されるスキルメタデータの文字予算をオーバーライドします。予算はコンテキストウィンドウの 1% で動的にスケーリングされます。フォールバック 8,000 文字。後方互換性のために古い名前を保持 |496| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill) に表示されるスキルメタデータの文字予算をオーバーライドします。予算はコンテキストウィンドウの 1% で動的にスケーリングされ、フォールバックは 8,000 文字です。後方互換性のために古い名前を保持 |

497| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で削除され、現在は no-op です。それがサイズした `TaskOutput` ツールと一緒に。以前は、[バックグラウンドタスク](/docs/ja/tools-reference#background-commands) の出力の最大文字数を `TaskOutput` ツールが保持していました。Claude は代わりに `Read` でバックグラウンドタスクの出力ファイルを読み取ります |497| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で削除され、現在は no-op です。それがサイズした `TaskOutput` ツールと一緒に。以前は、[バックグラウンドタスク](/docs/ja/tools-reference#background-commands) の出力の最大文字数を設定していました。`TaskOutput` ツールが保持していました。Claude は代わりに `Read` でバックグラウンドタスクの出力ファイルを読み取ります |

498| `USE_BUILTIN_RIPGREP` | Claude Code に含まれる `rg` の代わりにシステムインストール `rg` を使用するには、`0` に設定します |498| `USE_BUILTIN_RIPGREP` | Claude Code に含まれる `rg` の代わりにシステムインストール `rg` を使用するには `0` に設定します |

499| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Google Cloud の Agent Platform を使用する場合、Claude 3.5 Haiku のリージョンをオーバーライドします |499| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Google Cloud の Agent Platform を使用する場合、Claude 3.5 Haiku のリージョンをオーバーライドします |

500| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Google Cloud の Agent Platform を使用する場合、Claude 3.5 Sonnet のリージョンをオーバーライドします |500| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Google Cloud の Agent Platform を使用する場合、Claude 3.5 Sonnet のリージョンをオーバーライドします |

501| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Google Cloud の Agent Platform を使用する場合、Claude 3.7 Sonnet のリージョンをオーバーライドします |501| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Google Cloud の Agent Platform を使用する場合、Claude 3.7 Sonnet のリージョンをオーバーライドします |


518 518 

519標準 OpenTelemetry エクスポーター変数(`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES`、およびシグナル固有バリアント)もサポートされています。設定の詳細については、[監視](/docs/ja/monitoring-usage) を参照してください。519標準 OpenTelemetry エクスポーター変数(`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES`、およびシグナル固有バリアント)もサポートされています。設定の詳細については、[監視](/docs/ja/monitoring-usage) を参照してください。

520 520 

521`CLAUDE_CODE_ENABLE_TELEMETRY` および OpenTelemetry 変数をエクスポート先を選択するか、コンテンツをキャプチャするか、シェル、ユーザー設定、または管理設定で設定します。Claude Code は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視します。ただし、セクションで説明されているオフ値を除きます。`OTEL_RESOURCE_ATTRIBUTES` およびエクスポート間隔、タイムアウト、圧縮変数(`OTEL_METRIC_EXPORT_INTERVAL` など)は、プロジェクトおよびローカル設定から引き続き適用されます。521`CLAUDE_CODE_ENABLE_TELEMETRY` および OpenTelemetry 変数をエクスポート、宛先を選択、またはコンテンツをキャプチャするシェル、ユーザー設定、または管理設定で設定します。Claude Code は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。ただし、オフ値は除外されます。`OTEL_RESOURCE_ATTRIBUTES` およびエクスポート間隔、タイムアウト、圧縮変数(`OTEL_METRIC_EXPORT_INTERVAL` など)はプロジェクトおよびローカル設定から引き続き適用されます。

522 522 

523<h2 id="features-that-need-feature-flag-fetching">523<h2 id="features-that-need-feature-flag-fetching">

524 フィーチャーフラグの取得が必要なフィーチャー524 フィーチャーフラグの取得が必要なフィーチャー

errors.md +91 −15

Details

152| `There's an issue with the selected model` | [リクエストエラー](#theres-an-issue-with-the-selected-model) |152| `There's an issue with the selected model` | [リクエストエラー](#theres-an-issue-with-the-selected-model) |

153| `Model ... is not a recognized model id` | [リクエストエラー](#model-is-not-a-recognized-model-id) |153| `Model ... is not a recognized model id` | [リクエストエラー](#model-is-not-a-recognized-model-id) |

154| `Model ... not found` | [リクエストエラー](#model-not-found) |154| `Model ... not found` | [リクエストエラー](#model-not-found) |

155| `Couldn't confirm model ... with the API` | [リクエストエラー](#couldnt-confirm-model-with-the-api) |

155| `API error: ... · model not changed` | [リクエストエラー](#api-error-model-not-changed) |156| `API error: ... · model not changed` | [リクエストエラー](#api-error-model-not-changed) |

156| `Claude Opus is not available with the Claude Pro plan` | [リクエストエラー](#claude-opus-is-not-available-with-the-claude-pro-plan) |157| `Claude Opus is not available with the Claude Pro plan` | [リクエストエラー](#claude-opus-is-not-available-with-the-claude-pro-plan) |

157| `Claude Code ... does not support this model; version ... or newer is required` | [リクエストエラー](#claude-code-does-not-support-this-model) |158| `Claude Code ... does not support this model; version ... or newer is required` | [リクエストエラー](#claude-code-does-not-support-this-model) |

158| `Claude Code ... is older than the minimum version required by your organization's policy` | [リクエストエラー](#claude-code-does-not-support-this-model) |159| `Claude Code ... is older than the minimum version required by your organization's policy` | [リクエストエラー](#claude-code-does-not-support-this-model) |

159| `Model ... is restricted by your organization's settings` | [リクエストエラー](#model-is-restricted-by-your-organizations-settings) |160| `Model ... is restricted by your organization's settings` | [リクエストエラー](#model-is-restricted-by-your-organizations-settings) |

160| `Model ... is not available. Your organization restricts model selection.` | [リクエストエラー](#model-is-restricted-by-your-organizations-settings) |161| `Model ... is not available. Your organization restricts model selection.` | [リクエストエラー](#model-is-restricted-by-your-organizations-settings) |

162| `Can't switch to the default model` | [リクエストエラー](#cant-switch-to-the-default-model) |

161| `Model switch ... blocked by a PreModelSwitch hook` | [リクエストエラー](#model-switch-was-blocked-by-a-premodelswitch-hook) |163| `Model switch ... blocked by a PreModelSwitch hook` | [リクエストエラー](#model-switch-was-blocked-by-a-premodelswitch-hook) |

162| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [リクエストエラー](#couldnt-save-it-as-your-default) |164| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [リクエストエラー](#couldnt-save-it-as-your-default) |

163| `thinking.type.enabled is not supported for this model` | [リクエストエラー](#thinking-type-enabled-is-not-supported-for-this-model) |165| `thinking.type.enabled is not supported for this model` | [リクエストエラー](#thinking-type-enabled-is-not-supported-for-this-model) |


219| `Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected` | [コマンドラインエラー](#no-github-account-is-connected-to-your-claude-account) |221| `Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected` | [コマンドラインエラー](#no-github-account-is-connected-to-your-claude-account) |

220| `Your connected GitHub account can't see <owner>/<repo>` | [コマンドラインエラー](#your-connected-github-account-cant-see-the-repository) |222| `Your connected GitHub account can't see <owner>/<repo>` | [コマンドラインエラー](#your-connected-github-account-cant-see-the-repository) |

221| `The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead` | [コマンドラインエラー](#the-github-app-preflight-failed-transiently) |223| `The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead` | [コマンドラインエラー](#the-github-app-preflight-failed-transiently) |

224| `Not uploading this working tree` with `the upload cannot follow that setting` | [コマンドラインエラー](#the-repository-upload-cant-follow-a-git-setting) |

222| `GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud` | [コマンドラインエラー](#github-isnt-connected-to-your-claude-account) |225| `GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud` | [コマンドラインエラー](#github-isnt-connected-to-your-claude-account) |

223| `Single sign-on authorization needed` | [コマンドラインエラー](#single-sign-on-authorization-needed) |226| `Single sign-on authorization needed` | [コマンドラインエラー](#single-sign-on-authorization-needed) |

224| `Failed to resume the conversation` | [コマンドラインエラー](#failed-to-resume-the-conversation) |227| `Failed to resume the conversation` | [コマンドラインエラー](#failed-to-resume-the-conversation) |


252| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [プラグインエラー](#plugin-is-required-by-your-organization) |255| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [プラグインエラー](#plugin-is-required-by-your-organization) |

253| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [プラグインエラー](#plugin-was-not-uninstalled) |256| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [プラグインエラー](#plugin-was-not-uninstalled) |

254| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [プラグインエラー](#plugin-was-not-uninstalled) |257| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [プラグインエラー](#plugin-was-not-uninstalled) |

258| `Plugin "<plugin>" was not uninstalled: installed_plugins.json` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read) |

255| `would be spawned with zero tools — refusing` | [ツールエラー](#agent-would-be-spawned-with-zero-tools) |259| `would be spawned with zero tools — refusing` | [ツールエラー](#agent-would-be-spawned-with-zero-tools) |

256| `File is covered by a Read deny rule in your permission settings` | [ツールエラー](#file-is-covered-by-a-read-deny-rule) |260| `File is covered by a Read deny rule in your permission settings` | [ツールエラー](#file-is-covered-by-a-read-deny-rule) |

257| `cannot contain null bytes (\0)` | [ツールエラー](#path-cannot-contain-null-bytes) |261| `cannot contain null bytes (\0)` | [ツールエラー](#path-cannot-contain-null-bytes) |


727 確認プロンプトが未回答のまま終了しました731 確認プロンプトが未回答のまま終了しました

728</h3>732</h3>

729 733 

730アカウントが [Fable 使用クレジット同意](/docs/ja/model-config#fable-and-usage-credits) を必要とする場合、Claude Code は Fable リクエストが使用クレジットを請求する前に確認するよう求めます。ターミナルがないセッションで誰もその同意プロンプトに答えない場合、Claude Code はプロンプトを閉じ、次のいずれかのメッセージでターンを終了します。734アカウントが [Fable 使用クレジット同意](/docs/ja/model-config#fable-and-usage-credits) を必要とする場合、Claude Code は Fable リクエストが使用クレジットを請求する前に確認するよう求めます。同意プロンプトが誰も答えないまま閉じられた場合、Claude Code はターンを次のいずれかのメッセージで終了します。

731 735 

732```text theme={null}736```text theme={null}

733Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change737Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change


736 740 

737メッセージはセッションの Fable モデルを指定するため、Fable 5 では `continuing on Fable 5` と `Fable 5 now uses usage credits` と表示されます。v2.1.257 より前では、最初のメッセージは `Fable 5 limit reached` で始まりました。741メッセージはセッションの Fable モデルを指定するため、Fable 5 では `continuing on Fable 5` と `Fable 5 now uses usage credits` と表示されます。v2.1.257 より前では、最初のメッセージは `Fable 5 limit reached` で始まりました。

738 742 

739これは [Remote Control](/docs/ja/remote-control) セッション、[バックグラウンドセッション](/docs/ja/agent-view)、および [エージェントチーム](/docs/ja/agent-teams) チームメイトセッションで発生します。Claude Code は同意プロンプトをセッション独自のインタラクティブビューにのみ表示します。実行されるターミナル、またはバックグラウンドセッションの場合は、アタッチしたら [エージェントビュー](/docs/ja/agent-view) です。Remote Control クライアントはそれを表示できません。Claude Code は [`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) デッドラインでプロンプトを閉じます。デフォルトは 5 分、またはそのターミナルで誰も入力していない間に新しいプロンプトが到着するとすぐに、例えば Remote Control クライアントから送信されたプロンプトなどです。セッションが実行されるターミナルで入力するとデッドラインがキャンセルされ、Claude Code は回答を待ちます。バックグラウンドセッションのアタッチされたビューでは、入力はデッドラインをキャンセルせず、新しいプロンプトは同意プロンプトを閉じるため、どちらかが発生する前に回答してください。Claude Code は何も送信せず、モデルを保持するため、次のプロンプトを送信すると、Claude Code は同意プロンプトを再度表示します。743これは [Remote Control](/docs/ja/remote-control) セッション、[バックグラウンドセッション](/docs/ja/agent-view)、[エージェントチーム](/docs/ja/agent-teams) チームメイトセッション、および Agent SDK を通じてホストする別のアプリケーションで発生します。Claude Code がプロンプトを閉じるタイミングについては、[Fable と使用クレジット](/docs/ja/model-config#fable-and-usage-credits) を参照してください。

740 744 

741**対応方法:**745**対応方法:**

742 746 

743* セッションが実行されるターミナルで別のプロンプトを送信し、再度表示されたら同意プロンプトに答えます。バックグラウンドセッションの場合、最初に [エージェントビュー](/docs/ja/agent-view) からアタッチします。Remote Control クライアントから再送信すると、クライアントがプロンプトを表示できないため、このメッセージが再度表示されます。747* セッションが実行されるターミナルまたはそれをホストするアプリケーションで、別のプロンプトを送信し、再度表示されたら同意プロンプトに答えます。バックグラウンドセッションの場合、最初に [エージェントビュー](/docs/ja/agent-view) からアタッチします。Remote Control クライアントから再送信すると、クライアントがプロンプトを表示できないため、このメッセージが再度表示されます。

744* `/model` を実行して、使用クレジットを請求しないモデルに切り替えます748* `/model` を実行して、使用クレジットを請求しないモデルに切り替えます

745* そのターミナルに到達するまでの時間を増やすには、[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) をより長い値または `"never"` に設定します749* より多くの時間を確保するには、[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) をより長い値または `"never"` に設定します

746 750 

747v2.1.236 より前では、このメッセージは表示されませんでした。Remote Control クライアントが接続されている間、Claude Code は回答を 60 秒待ってからデフォルトモデルでターンを続行しました。751v2.1.236 より前では、このメッセージは表示されませんでした。Remote Control クライアントが接続されている間、Claude Code は回答を 60 秒待ってからデフォルトモデルでターンを続行しました。

748 752 


2346 モデルは認識されたモデル ID ではありません2350 モデルは認識されたモデル ID ではありません

2347</h3>2351</h3>

2348 2352 

2349モデルスイッチに渡したモデル文字列は、モデルエイリアス、このClaudeCode バージョンが知っているモデル ID、または `claude-` で始まる ID ではありません。通常の原因は、ID のタイプミス、`Sonnet 5` などの表示名(ID `claude-sonnet-5` が予想される)、または新しい Claude Code バージョンのみが認識するエイリアスです。Claude Code はスイッチを即座に拒否します。v2.1.200 より前では、Claude Code は文字列を保存し、[選択されたモデルに問題があります](#theres-an-issue-with-the-selected-model)で次のリクエストで失敗しました。2353モデルスイッチに渡した文字列は、Claude Code がモデルとして使用できるものではないため、スイッチを拒否し、セッションは現在のモデルを保持します。[Agent SDK](/docs/ja/agent-sdk/typescript) `setModel()` メソッド、[Desktop app](/docs/ja/desktop) などのアプリが Claude Code CLI を実行する場合、または [Remote Control](/docs/ja/remote-control) を通じて接続されたデバイスからモデルを選択する場合に、このエラーが発生する可能性があります。v2.1.200 より前では、Claude Code は文字列を保存し、[選択されたモデルに問題があります](#theres-an-issue-with-the-selected-model)で次のリクエストで失敗しました。

2350 2354 

2351```text theme={null}2355```text theme={null}

2352Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2356Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2353```2357```

2354 2358 

2355末尾のヒントは、最も近いマッチングエイリアスまたはモデル ID を名前付けします。十分に近いものがない場合は、`Run /model to see available models.` と読みます。[Desktop app](/docs/ja/desktop)が起動するセッションでは、ヒントは `Switch to a different model.` と読みます。2359この例では、アプリは表示名 `Sonnet 5` を送信しました。メッセージはスペースなしで繰り返します。末尾のヒントは、最も近いマッチングエイリアスまたはモデル ID を名前付けします。十分に近いものがない場合は、`Run /model to see available models.` と読みます。[Desktop app](/docs/ja/desktop)が起動するセッションでは、ヒントは `Switch to a different model.` と読みます。

2356 2360 

2357Claude Code はこのエラーをローカルで生成します。スイッチが要求された時点で、API リクエストが行われる前です。[Agent SDK](/docs/ja/agent-sdk/typescript) `setModel()` メソッド、[Desktop app](/docs/ja/desktop) などのアプリが Claude Code CLI を実行する場合、または [Remote Control](/docs/ja/remote-control) を通じて接続されたデバイスからモデルを選択する場合に適用されます。v2.1.260 より前では、チェックは Remote Control ピックをカバーしなかったため、Claude Code はピックを適用し、次のリクエストは [選択されたモデルに問題があります](#theres-an-issue-with-the-selected-model)で失敗しました。2361Agent SDK またはプロバイダーの Anthropic API を通じてスイッチする場合、表示名または空の文字列などのモデル ID になることができない文字列のみがこのエラーを取得します。

2362 

2363Remote Control デバイスからモデルを選択する場合、Claude Code はローカルで文字列をチェックします。モデルエイリアス、Claude Code がリストするか構成するモデル、または `claude-` で始まる ID ではない文字列は、`claud-sonnet-5` などのタイプミスされた ID を含めて、このエラーを取得します。v2.1.260 より前では、このチェックは Remote Control ピックをカバーしなかったため、認識されない文字列が適用され、次のリクエストで失敗しました。

2358 2364 

2359**対応方法:**2365**対応方法:**

2360 2366 

2361* 引数なしで `/model` を実行してピッカーを開き、アカウントで利用可能なモデルから選択してから、そこに表示されるエイリアスまたは ID を渡してください2367* 引数なしで `/model` を実行してピッカーを開き、アカウントで利用可能なモデルから選択してから、そこに表示されるエイリアスまたは ID を渡してください

2362* 新しい Claude Code バージョンがサポートするエイリアスを使用した場合は、`claude update` を実行してください。`claude-` で始まる完全な ID はこのローカルチェックを通過します。モデルが新しい場合でも。サーバーはそのモデルの最小バージョンを要求する可能性があります。[Claude Code はこのモデルをサポートしていません](#claude-code-does-not-support-this-model)を参照してください。2368* 新しい Claude Code バージョンがサポートするエイリアスを使用した場合は、`claude update` を実行するか、モデルの完全な ID を代わりに渡してください。サーバーはそのモデルの最小 Claude Code バージョンを要求する可能性があります。[Claude Code はこのモデルをサポートしていません](#claude-code-does-not-support-this-model)を参照してください。

2363* v2.1.200 より前に保存されたモデルはこのチェックで修復されません。古い値が戻り続ける場合は、[モデルの設定](/docs/ja/model-config#setting-your-model)の下にリストされている場所から削除してください。2369* v2.1.200 より前に保存されたモデルはこのチェックで修復されません。古い値が戻り続ける場合は、[モデルの設定](/docs/ja/model-config#setting-your-model)の下にリストされている場所から削除してください。

2364* チェックは Anthropic API でのみ実行されます。カスタム `ANTHROPIC_BASE_URL` を含む他のプロバイダーまたはゲートウェイでは、プロバイダーがモデル名を定義するため、Claude Code は任意の文字列を受け入れて渡します。Claude Code は、すべてのプロバイダーでリクエスト時に [認識されないモデル診断行](#unrecognized-model-id-on-a-request)を書き込むことができます。2370* Anthropic API 以外のプロバイダー、またはゲートウェイやカスタム `ANTHROPIC_BASE_URL` の背後では、空の文字列のみがこのエラーを取得します。Claude Code は、すべてのプロバイダーでリクエスト時に [認識されないモデル診断行](#unrecognized-model-id-on-a-request)を書き込むことができます。

2365 2371 

2366<h3 id="model-not-found">2372<h3 id="model-not-found">

2367 モデルが見つかりません2373 モデルが見つかりません

2368</h3>2374</h3>

2369 2375 

2370`/model <name>` でモデルを選択し、Claude Code はそのモデルが存在することを確認できませんでした。名前が [モデルエイリアス](/docs/ja/model-config#model-aliases)または Claude Code がローカルで受け入れる別のスペルではない場合、`/model` は最小限の API リクエストで検証し、このエラーは通常、API エンドポイントの応答です。スペースを含むものなど、モデル ID になることができない名前は同じメッセージを取得します。2376モデルを名前で切り替え、Claude Code はそのモデルが存在することを確認できませんでした。名前が [モデルエイリアス](/docs/ja/model-config#model-aliases)または Claude Code がローカルで受け入れる別のスペルではない場合、Claude Code はモデル ID を確認するために最小限の API リクエストを検証し、このエラーは通常、API エンドポイントの応答です。`/model <name>` で、スペースを含むものなど、モデル ID になることができない名前は同じメッセージを取得します。

2371 2377 

2372```text theme={null}2378```text theme={null}

2373Model 'claude-opus-9' not found2379Model 'claude-opus-9' not found


2379 2385 

2380* 引数なしで `/model` を実行し、アカウントで利用可能なモデルから選択するか、`sonnet` などの [モデルエイリアス](/docs/ja/model-config#model-aliases)を使用してください。これは保持されたデフォルトに解決されます2386* 引数なしで `/model` を実行し、アカウントで利用可能なモデルから選択するか、`sonnet` などの [モデルエイリアス](/docs/ja/model-config#model-aliases)を使用してください。これは保持されたデフォルトに解決されます

2381* 完全な ID を入力した場合は、プロバイダーのモデルカタログに対して確認してください。新しく起動されたモデルは、プロバイダーまたは地域が提供する前に Anthropic API で利用可能になる可能性があります。2387* 完全な ID を入力した場合は、プロバイダーのモデルカタログに対して確認してください。新しく起動されたモデルは、プロバイダーまたは地域が提供する前に Anthropic API で利用可能になる可能性があります。

2388* Agent SDK では、`setModel()` はこのメッセージで失敗し、セッションは前のモデルで実行し続けます。TypeScript SDK では、[`supportedModels()`](/docs/ja/agent-sdk/typescript#query-object)を呼び出して、切り替えることができるモデルをリストしてください。

2382* v2.1.265 より前では、`/model` は `opusplan[1m]` エイリアススペルもこのエラーで拒否しました。これらのバージョンでは、Claude Code を更新するか、[設定](/docs/ja/model-config#setting-your-model)または `--model` でモデルを設定してください。2389* v2.1.265 より前では、`/model` は `opusplan[1m]` エイリアススペルもこのエラーで拒否しました。これらのバージョンでは、Claude Code を更新するか、[設定](/docs/ja/model-config#setting-your-model)または `--model` でモデルを設定してください。

2383 2390 

2391<h3 id="couldnt-confirm-model-with-the-api">

2392 モデルを API で確認できませんでした

2393</h3>

2394 

2395[Agent SDK](/docs/ja/agent-sdk/typescript) `setModel()` メソッドまたは [Desktop app](/docs/ja/desktop) などのアプリが Claude Code CLI を実行する場合を通じてモデルを切り替え、モデル ID を API エンドポイントで確認するために Claude Code が送信する最小限のリクエストが 5 秒以内に応答を取得しませんでした。セッションは現在のモデルを保持します。

2396 

2397```text theme={null}

2398Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.

2399```

2400 

2401[Desktop app](/docs/ja/desktop)が起動するセッションでは、メッセージは `Try again.` で終わります。

2402 

2403**対応方法:**

2404 

2405* モデルを再度切り替えてください

2406* スイッチが失敗し続ける場合は、Claude Code が API エンドポイントに到達できることを確認してください。[ネットワークと接続エラー](#network-and-connection-errors)を参照してください

2407 

2384<h3 id="api-error-model-not-changed">2408<h3 id="api-error-model-not-changed">

2385 モデルを確認するときの API エラー2409 モデルを確認するときの API エラー

2386</h3>2410</h3>


2432API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.2456API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

2433```2457```

2434 2458 

2459リクエストを行った Claude Code バイナリが報告するバージョンは、API がチェックするバージョンです。

2460 

2435**対応方法:**2461**対応方法:**

2436 2462 

2437* `claude update` を実行するか、Claude デスクトップアプリを更新してから、新しいセッションを開始してください2463そのバイナリを更新してから、新しいセッションを開始してください。バイナリの出所は、以下を除いて、どのように更新するかを決定します。[自己ホスト環境](/docs/ja/self-hosted-environments-deploy#pin-the-version):

2438* モデルごとの表現については、`/model` で別のモデルに切り替えることで、現在のセッションで作業を続けることができます2464 

2465| リクエストを行ったバイナリ | 更新方法 |

2466| :- | :- |

2467| インストールした Claude Code | `claude update` を実行 |

2468| Claude デスクトップアプリ | アプリを更新 |

2469| [VS Code 拡張機能](/docs/ja/vs-code)がバンドルするバイナリ | 拡張機能を更新 |

2470| Agent SDK パッケージがバンドルするバイナリ | [SDK パッケージをアップグレード](/docs/ja/agent-sdk/hosting#runtime-dependencies)してから、アプリケーションを再開します。[コンパイルされた単一ファイル実行可能ファイル](/docs/ja/agent-sdk/typescript#compile-to-a-single-executable)では、それを再構築します |

2471 

2472* モデルごとの表現については、`/model` で別のモデルに切り替えることで、現在のセッションで作業を続けることができます。ストリーミング入力モードで TypeScript SDK の `Query` オブジェクトで [`setModel()`](/docs/ja/agent-sdk/typescript#query-object)を呼び出すか、Python SDK の `ClaudeSDKClient` で [`set_model()`](/docs/ja/agent-sdk/python#claudesdkclient)を呼び出してください

2439* 組織ポリシーの表現については、続行する前に更新してください2473* 組織ポリシーの表現については、続行する前に更新してください

2440 2474 

2441<h3 id="model-is-restricted-by-your-organizations-settings">2475<h3 id="model-is-restricted-by-your-organizations-settings">


2460* 制限されたモデルが `--model`、`ANTHROPIC_MODEL`、設定ファイルの `model` フィールド、または [サブエージェント](/docs/ja/sub-agents#choose-a-model)、スキル、またはコマンドの `model` frontmatter に設定された場合は、その値を削除または更新して、通知が再度発生しないようにしてください2494* 制限されたモデルが `--model`、`ANTHROPIC_MODEL`、設定ファイルの `model` フィールド、または [サブエージェント](/docs/ja/sub-agents#choose-a-model)、スキル、またはコマンドの `model` frontmatter に設定された場合は、その値を削除または更新して、通知が再度発生しないようにしてください

2461* 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼してください。[組織モデル制限](/docs/ja/model-config#organization-model-restrictions)を参照してください。2495* 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼してください。[組織モデル制限](/docs/ja/model-config#organization-model-restrictions)を参照してください。

2462 2496 

2497<h3 id="cant-switch-to-the-default-model">

2498 デフォルトモデルに切り替えることができません

2499</h3>

2500 

2501Default モデルを選択しました。たとえば、`/model` ピッカーで Default 行を選択するか、`/model default` を入力してください。Claude Code はスイッチを拒否したため、セッションは現在のモデルを保持します。

2502 

2503```text theme={null}

2504Can't switch to the default model: your organization's managed settings block it (claude-opus-4-6) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

2505```

2506 

2507コロンの後の表現は、スイッチをブロックしたものを名前付けします:

2508 

2509* **`your organization's managed settings block it ... in "deniedModels"`**:管理拒否リストが Default オプションが解決するモデルをブロックします

2510* **`your organization allows only the models listed in "availableModels"`**:[`availableModels`](/docs/ja/model-config#restrict-model-selection)を持つ管理許可リストと [`availableModelsMatch`](/docs/ja/settings-reference#availablemodelsmatch) が `"exact"` に設定されている場合、Default オプションが解決するモデルを除外します

2511* **`Claude Code couldn't read your organization's managed settings to check which models they allow`**:[管理設定](/docs/ja/managed-settings)を読み取ることができず、Claude Code はチェックされていないスイッチを適用するのではなく拒否します

2512 

2513**対応方法:**

2514 

2515* [`deniedModels`](/docs/ja/settings-reference#deniedmodels) と `availableModels` の表現については、`/model` を実行して、組織が許可するモデルを名前で選択してください

2516* メッセージが名前付けする管理設定を更新するよう管理者に依頼してください

2517* `couldn't read` の表現については、Claude Code を再開してください。ブロックし続ける場合は、管理者に管理設定を確認するよう依頼してください

2518 

2519セッションが代わりに `Claude Code can't start` メッセージで起動に失敗する場合は、これらの管理設定の下で [管理設定がデフォルトモデルをブロック](#managed-settings-block-the-default-model)を参照してください。

2520 

2463<h3 id="model-switch-was-blocked-by-a-premodelswitch-hook">2521<h3 id="model-switch-was-blocked-by-a-premodelswitch-hook">

2464 モデルスイッチが PreModelSwitch フックによってブロックされました2522 モデルスイッチが PreModelSwitch フックによってブロックされました

2465</h3>2523</h3>


3376 3434 

3377v2.1.251 より前は、Claude Code は GitHub チェックが一時的にのみ失敗した場合でも `Please set up GitHub on https://claude.ai/code` でメッセージを終了し、セットアップアドバイスは一時的な失敗を解決することはできません。3435v2.1.251 より前は、Claude Code は GitHub チェックが一時的にのみ失敗した場合でも `Please set up GitHub on https://claude.ai/code` でメッセージを終了し、セットアップアドバイスは一時的な失敗を解決することはできません。

3378 3436 

3437<h3 id="the-repository-upload-cant-follow-a-git-setting">

3438 リポジトリのアップロードは git 設定に従うことができません

3439</h3>

3440 

3441ローカルリポジトリをアップロードする[クラウドセッション](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github)、またはブランチの[ultrareview](/docs/ja/ultrareview)を開始しました。アップロードは、ファイルに適用される属性ルールを決定する git 設定の 1 つに従うことができません。アップロードが進行し、ルールを逃した場合、git が保存する前に変換するファイル(例えば、クリーンフィルタが暗号化するファイル)は、ディスク上のままクラウドに到達する可能性があります。Claude Code はアップロードを拒否する代わりに、何もアップロードされません。

3442 

3443```text theme={null}

3444Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository's .git/config or directly into your ~/.gitconfig, then retry.

3445```

3446 

3447メッセージは設定と場所を示し、ヒットしたケースの修正で終わります。同じ拒否は `core.attributesFile` と `attr.tree` に対して表示され、それぞれ独自の修正があります。

3448 

3449メッセージは、その指令の条件がこのリポジトリに適用されない場合でも、git 設定が `include` または `includeIf` 指令を通じてプルインする設定ファイルに名前を付ける可能性があります。

3450 

3451**対処方法:**

3452 

3453* メッセージの最後の文の修正を適用してください。

3454 

3379<h3 id="github-isnt-connected-to-your-claude-account">3455<h3 id="github-isnt-connected-to-your-claude-account">

3380 GitHub が Claude アカウントに接続されていません3456 GitHub がアカウントに接続されていません

3381</h3>3457</h3>

3382 3458 

3383ローカルリポジトリから[クラウドセッション](/docs/ja/claude-code-on-the-web)を開始しました。例えば、`/autofix-pr` を使用しています。GitHub アカウントが Claude アカウントに接続されていないか、接続が期限切れになっているため、Claude Code は起動を拒否します。3459ローカルリポジトリから[クラウドセッション](/docs/ja/claude-code-on-the-web)を開始しました。例えば、`/autofix-pr` を使用しています。GitHub アカウントが Claude アカウントに接続されていないか、接続が期限切れになっているため、Claude Code は起動を拒否します。


3888 プラグインはアンインストールされませんでした3964 プラグインはアンインストールされませんでした

3889</h3>3965</h3>

3890 3966 

3891[`claude plugin uninstall`](/docs/ja/plugins/cli-reference#plugin-uninstall)を実行するか、`/plugin` **Installed** タブで **Uninstall** を選択し、アンインストールが `"<plugin>" was not uninstalled:` で始まるメッセージで停止しました。3967[`claude plugin uninstall`](/docs/ja/plugins/cli-reference#plugin-uninstall)を実行するか、`/plugin` **Installed** タブで **Uninstall** を選択し、アンインストールが `"<plugin>" was not uninstalled:` で始まるメッセージで停止しました。そのコロンの後のテキストが `installed_plugins.json` の代わりに設定ファイルに名前を付けている場合、原因は `installed_plugins.json` 内のコンテンツで、このバージョンの Claude Code が読み込めません。その形式については、[`installed_plugins.json` がこのバージョンが読み込めないレコードを保持している](/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read)を参照してください。

3892 3968 

3893Claude Code がプラグインのエントリを `enabledPlugins` から削除し、そのスコープの設定ファイルを読み込み直したとき、プラグインはまだそこでオンになっていたか、またはそれをオンにできるファイルを読み込むか確認できませんでした。設定エントリがそれをオンに戻す可能性があるときにプラグインの保存されたオプション、シークレット、およびデータを削除すると、それらが失われるため、アンインストールは代わりに停止します:プラグインはインストールされたままで、保存されたものは何も削除されません。3969Claude Code がプラグインのエントリを `enabledPlugins` から削除し、そのスコープの設定ファイルを読み込み直したとき、プラグインはまだそこでオンになっていたか、またはそれをオンにできるファイルを読み込むか確認できませんでした。設定エントリがそれをオンに戻す可能性があるときにプラグインの保存されたオプション、シークレット、およびデータを削除すると、それらが失われるため、アンインストールは代わりに停止します:プラグインはインストールされたままで、保存されたものは何も削除されません。

3894 3970 

fast-mode.md +2 −0

Details

72 72 

73セッションで `/fast on` と入力して高速モードをオンにします。そのセッションのみオンのままで、デフォルトとして保存されません。[要件](#requirements)はクラウドセッションにも適用されます。73セッションで `/fast on` と入力して高速モードをオンにします。そのセッションのみオンのままで、デフォルトとして保存されません。[要件](#requirements)はクラウドセッションにも適用されます。

74 74 

75ブラウザの [claude.ai/code](https://claude.ai/code)では、メッセージボックスのモデルメニューから高速モードをオンおよびオフにすることもできます。メニューは、プランに高速モードが含まれており、選択されたモデルがそれをサポートしている場合に表示されます。

76 

75<h2 id="understand-the-cost-tradeoff">77<h2 id="understand-the-cost-tradeoff">

76 コストのトレードオフを理解する78 コストのトレードオフを理解する

77</h2>79</h2>

Details

312| [Computer use](/docs/ja/computer-use) | ✓ | ✓ | ✗ | ✗ |312| [Computer use](/docs/ja/computer-use) | ✓ | ✓ | ✗ | ✗ |

313| Dispatch([Desktop](/docs/ja/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |313| Dispatch([Desktop](/docs/ja/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

314| [Code Review](/docs/ja/code-review) | ✗ | ✗ | ✓ | ✓ |314| [Code Review](/docs/ja/code-review) | ✗ | ✗ | ✓ | ✓ |

315| [Artifacts](/docs/ja/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |315| [Artifacts](/docs/ja/artifacts) | ✓ | ✓ | ✓ | ✓ |

316| [アナリティクスダッシュボードと貢献メトリクス](/docs/ja/analytics) | ✗ | ✗ | ✓ | ✓ |316| [アナリティクスダッシュボードと貢献メトリクス](/docs/ja/analytics) | ✗ | ✗ | ✓ | ✓ |

317| [Enterprise Analytics API](/docs/ja/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |317| [Enterprise Analytics API](/docs/ja/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

318| [サーバー管理設定](/docs/ja/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |318| [サーバー管理設定](/docs/ja/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

fullscreen.md +1 −1

Details

294 294 

295マウスキャプチャが無効な場合、`PgUp`、`PgDn`、`Ctrl+Home`、`Ctrl+End` を使用したキーボードスクロールは引き続き機能し、ターミナルはネイティブに選択を処理します。クリックでカーソルを配置、クリックでツール出力を展開、URL クリック、Claude Code 内でのホイールスクロールが失われます。295マウスキャプチャが無効な場合、`PgUp`、`PgDn`、`Ctrl+Home`、`Ctrl+End` を使用したキーボードスクロールは引き続き機能し、ターミナルはネイティブに選択を処理します。クリックでカーソルを配置、クリックでツール出力を展開、URL クリック、Claude Code 内でのホイールスクロールが失われます。

296 296 

297ホイールスクロールは保持しながらクリック、ドラッグ、ホバー処理をオフにするには、代わりに `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1` を設定します。Claude Code v2.1.195 以降が必要です。両方の変数が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。297ホイールスクロールは保持しながらクリック、ドラッグ、ホバー処理をオフにするには、代わりに `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1` を設定します。`CLAUDE_CODE_DISABLE_MOUSE` は両方の変数が設定されている場合に優先されます。

298 298 

299クリックが無効な場合、Claude Code はまだマウスをキャプチャするため、ホイールとタッチパッドは会話をスクロールしますが、Claude Code 内では左クリックは何もしません。ネイティブなクリックアンドドラッグ選択のためにターミナルのキーを押し続ける必要があります。右クリックと中央クリックペーストは、それをサポートするターミナルで引き続き機能します。299クリックが無効な場合、Claude Code はまだマウスをキャプチャするため、ホイールとタッチパッドは会話をスクロールしますが、Claude Code 内では左クリックは何もしません。ネイティブなクリックアンドドラッグ選択のためにターミナルのキーを押し続ける必要があります。右クリックと中央クリックペーストは、それをサポートするターミナルで引き続き機能します。

300 300 

Details

43 43 

44Claude Code はその後、選択したワークフローファイルを含むブランチをプッシュし、既にそのシークレットを使用するように設定され、ブラウザで GitHub を開いてプルリクエストを作成する準備ができています。そのプルリクエストを作成してマージすると、リポジトリで `@claude` が機能します。44Claude Code はその後、選択したワークフローファイルを含むブランチをプッシュし、既にそのシークレットを使用するように設定され、ブラウザで GitHub を開いてプルリクエストを作成する準備ができています。そのプルリクエストを作成してマージすると、リポジトリで `@claude` が機能します。

45 45 

46セットアップを途中で停止するには、Esc キーを押します。既に進行中のステップは完了し、後続のステップは開始しません。終了メッセージには、プッシュされたブランチやシークレットの保存など、リポジトリで既に発生したことがリストされます。

47 

46レビューワークフローを選択した場合、Claude は各レビューをプルリクエスト自体に投稿します。見つかった各イシューのインラインコメントとして、または見つからない場合は 1 つの概要コメントとして投稿します。Claude は下書きなどの一部のプルリクエストをスキップします。[レビューワークフロー例](#run-a-skill)は同じスキルを使用し、それらをリストします。v2.1.229 より前では、Claude はレビューをワークフロー実行ログにのみ書き込みました。48レビューワークフローを選択した場合、Claude は各レビューをプルリクエスト自体に投稿します。見つかった各イシューのインラインコメントとして、または見つからない場合は 1 つの概要コメントとして投稿します。Claude は下書きなどの一部のプルリクエストをスキップします。[レビューワークフロー例](#run-a-skill)は同じスキルを使用し、それらをリストします。v2.1.229 より前では、Claude はレビューをワークフロー実行ログにのみ書き込みました。

47 49 

48以前のバージョンが生成したレビューワークフローを更新するには、以下のいずれかを実行します。50以前のバージョンが生成したレビューワークフローを更新するには、以下のいずれかを実行します。

Details

35 管理者セットアップ35 管理者セットアップ

36</h2>36</h2>

37 37 

38管理者が GHES インスタンスを Claude Code に 1 回接続します。その後、組織の開発者は追加の設定なしで GHES リポジトリを使用できます。Claude 組織への Owner または Primary Owner ロールと、GHES インスタンスで GitHub App を作成する権限が必要です。38Owner は GHES インスタンスを Claude Code に 1 回接続します。その後、組織内の開発者は追加の設定なしで GHES リポジトリを使用できます。Claude 組織で Owner または Primary Owner ロールを持ち、GHES インスタンスで GitHub Apps を作成する権限が必要です。

39 39 

40ガイド付きセットアップは GitHub App マニフェストを生成し、GHES インスタンスにリダイレクトして 1 クリックでアプリを作成します。環境がリダイレクトフローをブロックしている場合は、[代替手動セットアップ](#manual-setup) が利用可能です。40ガイド付きセットアップは GitHub App マニフェストを生成し、GHES インスタンスにリダイレクトしてアプリをワンクリックで作成します。環境がリダイレクトフローをブロックしている場合は、[代替の手動セットアップ](#manual-setup)が利用可能です。

41 41 

42<Steps>42<Steps>

43 <Step title="Claude Code 管理者設定を開く">43 <Step title="Claude Code 管理者設定を開く">

44 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) にアクセスして、GitHub Enterprise Server セクションを見つけます。44 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) にアクセスして、GitHub Enterprise Server セクションを見つけます。

45 </Step>45 </Step>

46 46 

47 <Step title="ガイド付きセットアップを開始">47 <Step title="ガイド付きセットアップを開始する">

48 **Connect** をクリックします。接続の表示名(最大 20 文字)と GHES ホスト名(例:`github.example.com`)を入力します。GHES インスタンスが自己署名証明書またはプライベート認証局を使用している場合は、CA 証明書をオプションフィールドに貼り付けます。48 **接続** をクリックします。接続の表示名(最大 20 文字)と GHES ホスト名(例:`github.example.com`)を入力します。GHES インスタンスが自己署名証明書またはプライベート認証局を使用している場合は、CA 証明書をオプションフィールドに貼り付けます。

49 </Step>49 </Step>

50 50 

51 <Step title="GitHub App を作成">51 <Step title="GitHub App を作成する">

52 **Continue to GitHub Enterprise** をクリックします。ブラウザが事前入力されたアプリマニフェストを含む GHES インスタンスにリダイレクトされます。設定を確認して **Create GitHub App** をクリックします。GHES はアプリ認証情報が自動的に保存された状態で Claude にリダイレクトします。52 **GitHub Enterprise に続行** をクリックします。ブラウザが GHES インスタンスにリダイレクトされ、事前入力されたアプリマニフェストが表示されます。設定を確認して **GitHub App を作成** をクリックします。GHES はアプリ認証情報を自動的に保存して Claude に戻します。

53 </Step>53 </Step>

54 54 

55 <Step title="リポジトリにアプリをインストール">55 <Step title="リポジトリにアプリをインストールする">

56 GHES インスタンスの GitHub App ページから、Claude がアクセスする必要があるリポジトリまたは組織にアプリをインストールします。最初はサブセットで開始して、後で追加できます。56 GHES インスタンスの GitHub App ページから、Claude がアクセスしたいリポジトリまたは組織にアプリをインストールします。最初はサブセットで開始して、後で追加できます。

57 </Step>57 </Step>

58 58 

59 <Step title="機能を有効化">59 <Step title="機能を有効にする">

60 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) に戻り、GHES リポジトリの [Code Review](/docs/ja/code-review#set-up-code-review)、Claude Security、および [貢献度メトリクス](/docs/ja/analytics#enable-contribution-metrics) を github.com と同じ設定で有効化します。60 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) に戻り、GHES リポジトリの [コードレビュー](/docs/ja/code-review#set-up-code-review)、Claude Security、および [貢献メトリクス](/docs/ja/analytics#enable-contribution-metrics) を github.com と同じ設定を使用して有効にします。

61 </Step>61 </Step>

62</Steps>62</Steps>

63 63 

64<h3 id="github-app-permissions">64<h3 id="github-app-permissions">

65 GitHub App の権限65 GitHub App 権限

66</h3>66</h3>

67 67 

68マニフェストは、クラウドセッション、Code Review、Claude Security、プラグインマーケットプレイス、および貢献度メトリクスをカバーする権限と Webhook イベントで GitHub App を設定します。68マニフェストは GitHub App を以下の権限と webhook イベントで設定します。これらは一緒にクラウドセッション、コードレビュー、Claude Security、プラグインマーケットプレイス、および貢献メトリクスをカバーします。

69 69 

70| 権限 | アクセス | 用途 |70| 権限 | アクセス | 用途 |

71| :- | :- | :- |71| :- | :- | :- |

72| Contents | 読み取りと書き込み | リポジトリのクローンとブランチのプッシュ |72| Contents | 読み取りと書き込み | リポジトリのクローンとブランチのプッシュ |

73| Pull requests | 読み取りと書き込み | PR の作成とレビューコメントの投稿 |73| Pull requests | 読み取りと書き込み | PR の作成とレビューコメントの投稿 |

74| Issues | 読み取りと書き込み | Issue メンションへの応答 |74| Issues | 読み取りと書き込み | Issue メンションへの応答 |

75| Checks | 読み取りと書き込み | Code Review チェック実行の投稿 |75| Checks | 読み取りと書き込み | コードレビューチェック実行の投稿 |

76| Actions | 読み取り | 自動修正用の CI ステータスの読み取り |76| Actions | 読み取り | 自動修正の CI ステータスの読み取り |

77| Commit statuses | 読み取り | チェック実行の代わりにコミットステータスを報告するプロバイダーから CI ステータスを読み取る |77| Commit statuses | 読み取り | チェック実行の代わりにコミットステータスを報告するプロバイダーから CI ステータスを読み取る |

78| Repository hooks | 読み取りと書き込み | [Organization settings > Plugins & skills](https://claude.ai/admin-settings/skills?tab=marketplaces) でマーケットプレイスの **Sync automatically** がオンになっている場合、プラグインマーケットプレイスリポジトリに Webhook を作成する |78| Repository hooks | 読み取りと書き込み | [**組織設定 > プラグイン & スキル**](https://claude.ai/admin-settings/skills?tab=marketplaces) でマーケットプレイスの **自動同期** がオンになっている場合、プラグインマーケットプレイスリポジトリに webhook を作成する |

79| Metadata | 読み取り | すべてのアプリで GitHub が必須 |79| Metadata | 読み取り | すべてのアプリに GitHub が必須 |

80| Organization members | 読み取り | github.com の Claude GitHub App と一致させます。これは接続ユーザーの組織ロールをチェックするときにインストールをリンクするために使用されます |80| Organization members | 読み取り | github.com の Claude GitHub App と一致させるため。インストールをリンクするときに接続ユーザーの組織ロールを確認するために使用します |

81 81 

82アプリは `pull_request`、`issue_comment`、`pull_request_review_comment`、`pull_request_review`、`check_run`、および `status` イベントをサブスクライブします。82アプリは `pull_request`、`issue_comment`、`pull_request_review_comment`、`pull_request_review`、`check_run`、および `status` イベントをサブスクライブします。

83 83 

84GitHub はマニフェストをアプリ作成時にのみ適用するため、マニフェストの以前のバージョンから作成されたアプリは、作成時の権限とイベントを保持します。アプリが上記の権限またはイベントのいずれかが不足している場合は、GHES インスタンスのアプリ設定で追加してください。その後、GitHub は各インストールの所有者に新しい権限を承認するよう求め、インストールは承認されるまで古い権限を保持します。84GitHub はアプリ作成時にのみマニフェストを適用するため、マニフェストの以前のバージョンから作成されたアプリは、作成時の権限とイベントを保持します。アプリが上記の権限またはイベントのいずれかが不足している場合は、GHES インスタンスのアプリ設定で追加します。その後、GitHub は各インストールの所有者に新しい権限を承認するよう求め、インストールは承認されるまで古い権限を保持します。

85 85 

86<h3 id="manual-setup">86<h3 id="manual-setup">

87 手動セットアップ87 手動セットアップ

88</h3>88</h3>

89 89 

90ネットワーク設定によってガイド付きリダイレクトフローがブロックされている場合は、Connect の代わりに **Add manually** をクリックします。[上記の権限とイベント](#github-app-permissions) を使用して GHES インスタンスで GitHub App を作成し、フォームに接続詳細を入力します。表示名、GHES ホスト名とオプションのポート、およびアプリの ID、クライアント ID、クライアントシークレット、Webhook シークレット、および秘密鍵です。フォームはオプションのカスタム CA 証明書と読み取りレプリカホスト名も受け入れます。90ガイド付きリダイレクトフローがネットワーク設定によってブロックされている場合は、接続の代わりに **手動で追加** をクリックします。GHES インスタンスで [上記の権限とイベント](#github-app-permissions) を使用して GitHub App を作成し、フォームに接続詳細を入力します。表示名、GHES ホスト名とオプションのポート、アプリの ID、クライアント ID、クライアントシークレット、webhook シークレット、および秘密鍵です。フォームはオプションのカスタム CA 証明書と読み取りレプリカホスト名も受け入れます。

91 91 

92Claude は接続を保存するときにアプリの Webhook URL を生成します。**Add configuration** をクリックした後、接続の **More options** メニューを開き、**Copy webhook URL** を選択して、URL をアプリの Webhook 設定に貼り付けます。フォームに入力したのと同じ Webhook シークレットを使用してください。92Claude は接続を保存するときにアプリの webhook URL を生成します。**設定を追加** をクリックした後、接続の **その他のオプション** メニューを開き、**webhook URL をコピー** を選択して、URL をアプリの webhook 設定に GHES インスタンスで貼り付けます。フォームに入力したのと同じ webhook シークレットを使用します。

93 93 

94<h3 id="network-requirements">94<h3 id="network-requirements">

95 ネットワーク要件95 ネットワーク要件

96</h3>96</h3>

97 97 

98Anthropic ホスト型セッションの場合、GHES インスタンスは Anthropic インフラストラクチャから到達可能である必要があります。これにより Claude はリポジトリをクローンしてレビューコメントを投稿できます。GHES インスタンスがファイアウォールの背後にある場合は、Anthropic の [アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) をホワイトリストに登録します。[自己ホスト型環境](/docs/ja/self-hosted-environments-deploy#configure-git) のセッションは、ランナーが [Anthropic git プロキシ](/docs/ja/self-hosted-environments-deploy#use-the-anthropic-git-proxy) にオプトインしない限り、ネットワーク内からクローンします。Anthropic git プロキシは Anthropic 側からフェッチし、同じ到達可能性が必要です。[SCM コネクタ](/docs/ja/self-hosted-environments-reference#scm-connector-flags) は、内部的にのみルーティング可能な GHES ホストのリポジトリピッカーなどのホスト型プリセッションフローをカバーします。98Anthropic ホスト型セッションの場合、GHES インスタンスは Anthropic インフラストラクチャから到達可能である必要があります。これにより Claude はリポジトリをクローンしてレビューコメントを投稿できます。GHES インスタンスがファイアウォールの背後にある場合は、Anthropic の [アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) をホワイトリストに登録します。[自己ホスト型環境](/docs/ja/self-hosted-environments-deploy#configure-git) のセッションはネットワーク内からクローンします。ただし、ランナーが [Anthropic git プロキシ](/docs/ja/self-hosted-environments-deploy#use-the-anthropic-git-proxy) にオプトインする場合は除きます。このプロキシは Anthropic 側からフェッチし、同じ到達可能性が必要です。

99 

100リポジトリピッカーなどのホスト型プリセッションフローは、セッション開始前に Anthropic 側で実行されます。セッションが自己ホスト型環境で実行される場合でも、GHES インスタンスが Anthropic インフラストラクチャから到達可能である必要があります。[SCM コネクタ](/docs/ja/self-hosted-environments-reference#scm-connector-flags) は利用できないため、これらのフローは内部的にのみルーティング可能な GHES ホストに到達できません。

99 101 

100<h2 id="developer-workflow">102<h2 id="developer-workflow">

101 開発者ワークフロー103 開発者ワークフロー


246 GHES インスタンスに到達不可248 GHES インスタンスに到達不可

247</h3>249</h3>

248 250 

249レビューまたは Anthropic ホスト型クラウドセッションがタイムアウトする場合、GHES インスタンスは Anthropic インフラストラクチャから到達不可能な可能性があります。ファイアウォールが Anthropic の [アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) からのインバウンド接続を許可していることを確認してください。[セルフホスト環境](/docs/ja/self-hosted-environments) のセッションは、ネットワーク内から GHES に到達するため、代わりにランナー自体のネットワークパスと [SCM コネクタ](/docs/ja/self-hosted-environments-reference#scm-connector-flags) を確認してください。251レビューまたは Anthropic ホスト型クラウドセッションがタイムアウトする場合、GHES インスタンスは Anthropic インフラストラクチャから到達不可能な可能性があります。ファイアウォールが Anthropic の [アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) からのインバウンド接続を許可していることを確認してください。[セルフホスト環境](/docs/ja/self-hosted-environments) のセッションは、ネットワーク内から GHES に到達するため、代わりにランナー自体のネットワークパスを確認してください。リポジトリピッカーおよび他のホスト型セッション前フローについては、[ネットワーク要件](#network-requirements) を参照してください。

250 252 

251<h3 id="session-start-fails-with-unable-to-get-organization-uuid">253<h3 id="session-start-fails-with-unable-to-get-organization-uuid">

252 セッション開始が `Unable to get organization UUID` で失敗254 セッション開始が `Unable to get organization UUID` で失敗

glossary.md +1 −1

Details

56 Artifact56 Artifact

57</h3>57</h3>

58 58 

59Claude Code がセッションから claude.ai 上のプライベート URL に公開するライブでインタラクティブな Web ページ。出力を視覚的に確認したり、ターミナルテキストを読む代わりに共有したりできます。セッションが再公開されると、ページはその場で更新されます。Claude Code から作成した Artifact は、claude.ai の会話から作成した Artifact と同じギャラリーに表示されます。共有はプランに依存します: Pro と Max では、誰でも開くことができるパブリックリンク。Team と Enterprise では、組織内での共有、およびオーナーが有効にした後のパブリックリンク。59Claude Code がセッションから claude.ai 上のプライベート URL に公開するライブでインタラクティブな Web ページ。出力を視覚的に確認したり、ターミナルテキストを読む代わりに共有したりできます。セッションが再公開されると、ページはその場で更新されます。Claude Code から作成した Artifact は、claude.ai の会話から作成した Artifact と同じギャラリーに表示されます。共有オプションはプランに依存します: [Share an artifact](/docs/ja/artifacts#share-an-artifact) を参照してください。

60 60 

61詳細情報: [Share session output as artifacts](/docs/ja/artifacts)61詳細情報: [Share session output as artifacts](/docs/ja/artifacts)

62 62 

Details

315 315 

316Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Google Cloud の Agent Platform で[100 万トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#context-window-sizes-by-model)をサポートしています。Sonnet 5 は常に 100 万ウィンドウで実行され、選択する `[1m]` バリアントはありません。その他のモデルについては、Claude Code は 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。316Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Google Cloud の Agent Platform で[100 万トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#context-window-sizes-by-model)をサポートしています。Sonnet 5 は常に 100 万ウィンドウで実行され、選択する `[1m]` バリアントはありません。その他のモデルについては、Claude Code は 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。

317 317 

318[セットアップウィザード](#sign-in-with-agent-platform)は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/docs/ja/model-config#pin-models-for-third-party-deployments)を参照してください。318[セットアップウィザード](#sign-in-with-agent-platform)は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/docs/ja/model-config#pin-models-for-third-party-deployments)を参照してください。1M ウィンドウを使用する際にピン留めを変更しない方法を含みます。

319 319 

320<h2 id="troubleshooting">320<h2 id="troubleshooting">

321 トラブルシューティング321 トラブルシューティング

hooks-guide.md +1 −1

Details

196| `elicitation_url_dialog` | MCP サーバーがブラウザURL を開くよう求め、約 6 秒入力していない |196| `elicitation_url_dialog` | MCP サーバーがブラウザURL を開くよう求め、約 6 秒入力していない |

197| `elicitation_complete` | MCP サーバーが[URL モード引き出し](/docs/ja/hooks#elicitation-input)が完了したことを報告する |197| `elicitation_complete` | MCP サーバーが[URL モード引き出し](/docs/ja/hooks#elicitation-input)が完了したことを報告する |

198| `elicitation_response` | MCP 引き出し応答がサーバーに送り返されたとき |198| `elicitation_response` | MCP 引き出し応答がサーバーに送り返されたとき |

199| `agent_needs_input` | バックグラウンドセッションがあなたの入力を待つのを開始するか、現在のセッションが[agent team チームメイトのターミナルセットアップ質問](/docs/ja/agent-teams#choose-a-display-mode)を尋ね、約 6 秒入力していない。[agent view](/docs/ja/agent-view) が開いている間のみ発火します |199| `agent_needs_input` | バックグラウンドセッションがあなたの入力を待つのを開始するか、[agent view](/docs/ja/agent-view) が開いている間のみ発火します。また、ターミナルセッションが[agent team チームメイトのターミナルセットアップ質問](/docs/ja/agent-teams#choose-a-display-mode)を表示するか、auto mode の[分類器リクエスト料金](/docs/ja/auto-mode-classifier-billing)に関する通知を表示し、約 6 秒入力していないときも発火します |

200| `agent_completed` | バックグラウンドセッションが完了または失敗します。[agent view](/docs/ja/agent-view) が開いている間のみ発火します |200| `agent_completed` | バックグラウンドセッションが完了または失敗します。[agent view](/docs/ja/agent-view) が開いている間のみ発火します |

201| `quota_auto_resume_fired` | Claude Code は claude.ai 使用制限が一時停止した後、タスクを続行します:リセット時、または Claude Code 中に何かを行うことで使用可能になったとき(使用クレジットの追加、プランのアップグレード、モデルの切り替えなど)。[モデル設定の例外](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)を参照してください |201| `quota_auto_resume_fired` | Claude Code は claude.ai 使用制限が一時停止した後、タスクを続行します:リセット時、または Claude Code 中に何かを行うことで使用可能になったとき(使用クレジットの追加、プランのアップグレード、モデルの切り替えなど)。[モデル設定の例外](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)を参照してください |

202| `quota_auto_resume_stale` | claude.ai 使用制限がコンピュータが約 30 分以上スリープしている間にリセットされました。Claude Code はタスクを続行する代わりに `Enter` キーを押すのを待ちます。より短いスリープの後、それは続行し、代わりに `quota_auto_resume_fired` を発火します |202| `quota_auto_resume_stale` | claude.ai 使用制限がコンピュータが約 30 分以上スリープしている間にリセットされました。Claude Code はタスクを続行する代わりに `Enter` キーを押すのを待ちます。より短いスリープの後、それは続行し、代わりに `quota_auto_resume_fired` を発火します |

keybindings.md +5 −2

Details

301| `footer:down` | Down | フッター内を下に移動 |301| `footer:down` | Down | フッター内を下に移動 |

302| `footer:openSelected` | Enter | 選択したフッター項目を開く |302| `footer:openSelected` | Enter | 選択したフッター項目を開く |

303| `footer:clearSelection` | Escape | フッター選択をクリア |303| `footer:clearSelection` | Escape | フッター選択をクリア |

304| `footer:dismiss` | (バインドなし) | v2.1.281 で削除されました。アクションをまだ名前付けする `keybindings.json` は有効なままで、バインディングは何もしません。v2.1.281 より前では、Backspace と Delete はフッターから選択したアーティファクトリンクを削除しました |304| `footer:dismiss` | (バインドなし) | このアクションにキーをバインドしても効果がなく、それを名前付けする `keybindings.json` は有効なままです。v2.1.281 より前では、Backspace と Delete はフッターから選択したアーティファクトリンクを削除しました。 |

305 305 

306フッター項目が選択されている場合(プロンプトの下のエージェントパネルの行など)、`chat:submit` を `chat:queueSubmit` または `chat:newline` に再バインドしても、`Enter` はそれを開きます。306フッター項目が選択されている場合(プロンプトの下のエージェントパネルの行など)、`chat:submit` を `chat:queueSubmit` または `chat:newline` に再バインドしても、`Enter` はそれを開きます。

307 307 


417| `select:accept` | Enter | 選択を受け入れ |417| `select:accept` | Enter | 選択を受け入れ |

418| `select:cancel` | Escape | 選択をキャンセル |418| `select:cancel` | Escape | 選択をキャンセル |

419 419 

420`/skills` や `/mcp` などのリストパネルでは、Claude Code は `select:pageUp`、`select:pageDown`、`select:first`、および `select:last` バインディングを適用します。`/model` ピッカーなどのほとんどの他のリストでは、`select:first` と `select:last` バインディングが適用されます。PageUp と PageDown は、バインディングに関係なく、これらのリストのオプションをページングします。420`/skills`、`/mcp`、`/tasks` などのリストパネルでは、Claude Code は `select:pageUp`、`select:pageDown`、`select:first`、および `select:last` バインディングを適用します。`/model` ピッカーなどのほとんどの他のリストでは、`select:first` と `select:last` バインディングが適用されます。PageUp と PageDown は、バインディングに関係なく、これらのリストのオプションをページングします。

421 421 

422v2.1.280 より前では、これらの他のリストは Home、End、および `select:first` と `select:last` バインディングを無視していました。422v2.1.280 より前では、これらの他のリストは Home、End、および `select:first` と `select:last` バインディングを無視していました。

423 423 

424v2.1.283 より前では、`/mcp` ツールリストは、バインディングに関係なく固定 PageUp と PageDown キーでページングしました。

425 

424<h3 id="plugin-actions">426<h3 id="plugin-actions">

425 プラグインアクション427 プラグインアクション

426</h3>428</h3>


692Claude Code はキーバインディングを検証し、以下の警告をデバッグログに書き込みます。694Claude Code はキーバインディングを検証し、以下の警告をデバッグログに書き込みます。

693 695 

694* 解析エラー(無効な JSON または構造)696* 解析エラー(無効な JSON または構造)

697* スペルミスのあるモディファイア(例:`ctl+k`)。Claude Code は認識できない部分を削除し、残りのキーストロークにバインディングを適用します。この例では `k` です。

695* 無効なコンテキスト名698* 無効なコンテキスト名

696* 無効なアクション値(アクションが文字列または `null` ではない場合など)699* 無効なアクション値(アクションが文字列または `null` ではない場合など)

697* 不明なアクション名(登録されたアクションのタイプミスなど)。Claude Code はバインディングをスキップし、そのキーのデフォルトバインディングを有効に保ちます。v2.1.246 より前では、不明なアクション名を持つバインディングはそのキーを静かに無効化していました700* 不明なアクション名(登録されたアクションのタイプミスなど)。Claude Code はバインディングをスキップし、そのキーのデフォルトバインディングを有効に保ちます。v2.1.246 より前では、不明なアクション名を持つバインディングはそのキーを静かに無効化していました

Details

79 79 

80クライアントが Amazon Bedrock フォーマットを使用する場合、`InvokeModelWithResponseStream` レスポンスボディとその `Content-Type: application/vnd.amazon.eventstream` ヘッダーを変更せずにリレーし、ストリームをサーバー送信イベントに変換しないでください。[ゲートウェイまたはプロキシの背後でのストリーミングエラー](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) を参照してください。80クライアントが Amazon Bedrock フォーマットを使用する場合、`InvokeModelWithResponseStream` レスポンスボディとその `Content-Type: application/vnd.amazon.eventstream` ヘッダーを変更せずにリレーし、ストリームをサーバー送信イベントに変換しないでください。[ゲートウェイまたはプロキシの背後でのストリーミングエラー](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) を参照してください。

81 81 

82キープアライブピングもリレーします。`ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を通じた接続では、Claude Code はゲートウェイがリレーするすべてのバイト(SSE `ping` イベントとコメント行を含む)をカウントし、300 秒間デフォルトで無音のストリームを中止します。アップストリームのピングは長い思考の一時停止中の唯一のトラフィックであるため、ゲートウェイがそれらをストリップまたはバッファリングする場合、Claude Code はそれらの一時停止中にストリームを中止します。[自動再試行](/docs/ja/errors#automatic-retries) は、レスポンスがどこまで進行したかに基づいて、中止されたストリームが報告する内容をカバーしています。Amazon Bedrock のバイナリイベントストリームなど、ピングをまったく送信しないアップストリームは、それらの一時停止を転送するものがありません。そのようなアップストリームから変換する場合、無音のギャップ中に独自の `ping` イベントを発行します。`ANTHROPIC_BEDROCK_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_FOUNDRY_BASE_URL` を通じて到達するゲートウェイは、Anthropic Messages フォーマットをリレーする場合でも、このバイトレベルのウォッチドッグでラップされません。そこでは、[5 分のアイドルタイムアウト](/docs/ja/env-vars) が無音のストリームを中止し、`ANTHROPIC_BEDROCK_BASE_URL` 接続では [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/ja/env-vars) でバイトウォッチドッグを追加できます。82キープアライブピングもリレーします。Claude Code は [5 分のデフォルト](/docs/ja/network-config#streaming-idle-watchdogs) でストリーミングレスポンスを中止します。長い思考の一時停止中、アップストリームの SSE `ping` イベントはストリーム上の唯一のバイトである可能性があります。ゲートウェイがそれらをストリップまたはバッファリングする場合、Claude Code は一時停止の途中でレスポンスを中止します。Amazon Bedrock のバイナリイベントストリームなど、ピングをまったく送信しないアップストリームから変換する場合、無音のギャップ中に独自の `ping` イベントを発行します。

83 83 

84<h3 id="format-mismatch-with-the-upstream">84<h3 id="format-mismatch-with-the-upstream">

85 アップストリームとのフォーマット不一致85 アップストリームとのフォーマット不一致

managed-mcp.md +40 −17

Details

31 31 

32| パターン | 機能 | 設定 |32| パターン | 機能 | 設定 |

33| :- | :- | :- |33| :- | :- | :- |

34| **MCP を無効化** | サーバーは読み込まれません。ただし、[セッションを開始したアプリが登録するインプロセスサーバー](#exclusive-control-with-managed-mcp-json)と、[`managedMcpServers` を通じて提供するサーバー](#provide-servers-through-managed-settings)は除きます | 空のサーバーマップを含む `managed-mcp.json` |34| **MCP を無効化** | [排他的制御](#exclusive-control-with-managed-mcp-json)の下で読み込まれるいくつかのサーバーを除き、サーバーは読み込まれません | 空のサーバーマップを含む `managed-mcp.json` |

35| **固定デプロイ** | すべてのユーザーが同じサーバーを取得し、他のサーバーを追加できません | 必要なサーバーを含む `managed-mcp.json` |35| **固定デプロイ** | すべてのユーザーが同じサーバーを取得し、他のサーバーを追加できません | 必要なサーバーを含む `managed-mcp.json` |

36| **提供されるサーバー** | すべてのユーザーがリストされたリモートサーバーを取得し、独自のサーバーを保持します | マネージド設定の `managedMcpServers` |36| **提供されるサーバー** | すべてのユーザーがリストされたリモートサーバーを取得し、独自のサーバーを保持します | マネージド設定の `managedMcpServers` |

37| **承認されたカタログ** | 承認されたサーバーのリストを公開します。ユーザーは必要なものを追加し、その他はすべてブロックされます | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |37| **承認されたカタログ** | 承認されたサーバーのリストを公開します。ユーザーは必要なものを追加し、その他はすべてブロックされます | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |


48 managed-mcp.json による排他的制御48 managed-mcp.json による排他的制御

49</h2>49</h2>

50 50 

51`managed-mcp.json` ファイルをデプロイすると、Claude Code はそのファイルで定義されたサーバー、[`managedMcpServers` を通じて提供するサーバー](#provide-servers-through-managed-settings)、およびセッションを開始したアプリが登録するインプロセスサーバー(VS Code 拡張機能独自のサーバーや[デスクトップアプリが提供するコネクタ](/docs/ja/mcp#how-connectors-reach-claude-code)など)のみを読み込みます。ユーザーは、プラグイン提供のサーバーや [`--mcp-config` CLI フラグ](/docs/ja/cli-reference#cli-flags)で渡されたサーバーを含む、その他の MCP サーバーを追加、変更、または使用することはできません。このファイルは、[マネージドセットと共にそれらを許可](#allow-claude-ai-connectors-alongside-the-managed-set)しない限り、Claude Code が自身で取得する claude.ai コネクタも抑制します。51`managed-mcp.json` ファイルをデプロイすると、Claude Code はこれらの MCP サーバーのみを読み込みます。

52 

53* ファイルで定義されたサーバー

54* [「`managedMcpServers` を通じて提供するサーバー」](#provide-servers-through-managed-settings)

55* セッションを開始したアプリが登録するインプロセスサーバー(VS Code 拡張機能独自のサーバーや[デスクトップアプリが提供するコネクタ](/docs/ja/mcp#how-connectors-reach-claude-code)など)

56* [「Claude in Chrome」](/docs/ja/chrome)の組み込みサーバー([マネージドセットと共にそれを許可](#allow-claude-in-chrome-alongside-the-managed-set)する場合)

57 

58ユーザーは、プラグイン提供のサーバーや[「`--mcp-config` CLI フラグ」](/docs/ja/cli-reference#cli-flags)で渡されたサーバーを含む、その他の MCP サーバーを追加、変更、または使用することはできません。このファイルは、[マネージドセットと共にそれらを許可](#allow-claude-ai-connectors-alongside-the-managed-set)しない限り、Claude Code が自身で取得する claude.ai コネクタも抑制します。

52 59 

53<h3 id="deploy-managed-mcp-json">60<h3 id="deploy-managed-mcp-json">

54 managed-mcp.json をデプロイする61 managed-mcp.json をデプロイする

55</h3>62</h3>

56 63 

57`managed-mcp.json` はスタンドアロンファイルであるため、[サーバー管理設定](/docs/ja/server-managed-settings)を通じて配信することはできません。マネージドセットなしで管理設定を通じてサーバーを配信するには、代わりに [`managedMcpServers`](#provide-servers-through-managed-settings) を使用してください。64`managed-mcp.json` はスタンドアロンファイルであるため、[サーバー管理設定](/docs/ja/server-managed-settings)を通じて配信することはできません。マネージドセットなしで管理設定を通じてサーバーを配信するには、代わりに[「`managedMcpServers`」](#provide-servers-through-managed-settings)を使用してください。

58 65 

59管理者権限を持つシステムパスに書き込むことができるすべてのプロセスがファイルをデプロイできます。フリート全体では、通常は Jamf などのデバイス管理ツール、macOS 上の構成プロファイル、Windows 上のグループポリシーまたは Intune、または Linux 上の選択したフリート管理を通じて行われます。Claude Code は以下のパスのいずれかでファイルを探します。66管理者権限を持つシステムパスに書き込むことができるすべてのプロセスがファイルをデプロイできます。フリート全体では、通常は Jamf などのデバイス管理ツール、macOS 上の構成プロファイル、Windows 上のグループポリシーまたは Intune、または Linux 上の選択したフリート管理を通じて行われます。Claude Code は以下のパスのいずれかでファイルを探します。

60 67 


64| Linux と WSL | `/etc/claude-code/managed-mcp.json` |71| Linux と WSL | `/etc/claude-code/managed-mcp.json` |

65| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |72| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |

66 73 

67このファイルはプロジェクト [`.mcp.json`](/docs/ja/mcp#project-scope) ファイルと同じ形式を使用します。74このファイルはプロジェクト[「`.mcp.json`」](/docs/ja/mcp#project-scope)ファイルと同じ形式を使用します。

68 75 

69```json theme={null}76```json theme={null}

70{77{


95 102 

96マシン上のすべてのユーザーがこのファイルを読むことができるため、API キーやその他の認証情報を `env` ブロックに保存しないでください。代わりに、以下のいずれかを使用してユーザーごとの認証情報を渡してください。103マシン上のすべてのユーザーがこのファイルを読むことができるため、API キーやその他の認証情報を `env` ブロックに保存しないでください。代わりに、以下のいずれかを使用してユーザーごとの認証情報を渡してください。

97 104 

98* [環境変数展開](/docs/ja/mcp#environment-variable-expansion-in-mcp-json)を使用して、各ユーザーの環境からシークレットを読み込む。105* [「`${VAR}` 展開」](/docs/ja/mcp#environment-variable-expansion-in-mcp-json)を使用して、各ユーザーの環境からシークレットを読み込む。

99* [OAuth またはユーザーごとのヘッダー](/docs/ja/mcp#authenticate-with-remote-mcp-servers)を使用して、各ユーザーが自分自身として認証する。106* [「OAuth またはユーザーごとのヘッダー」](/docs/ja/mcp#authenticate-with-remote-mcp-servers)を使用して、各ユーザーが自分自身として認証する。

100* [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication)を使用して、接続時に認証情報を生成する。107* [「`headersHelper`」](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication)を使用して、接続時に認証情報を生成する。

101 108 

102<h3 id="servers-passed-with-mcp-config-or-strict-mcp-config">109<h3 id="servers-passed-with-mcp-config-or-strict-mcp-config">

103 `--mcp-config` または `--strict-mcp-config` で渡されたサーバー110 `--mcp-config` または `--strict-mcp-config` で渡されたサーバー


106セッションが `managed-mcp.json` がデプロイされている間に `--mcp-config` を通じてサーバーを受け取る場合、ユーザーが見るものはワークステーションとクラウドセッション間で異なります。113セッションが `managed-mcp.json` がデプロイされている間に `--mcp-config` を通じてサーバーを受け取る場合、ユーザーが見るものはワークステーションとクラウドセッション間で異なります。

107 114 

108* ワークステーション上では、Claude Code は `You cannot dynamically configure MCP servers when an enterprise MCP config is present` というメッセージで起動時に終了します。115* ワークステーション上では、Claude Code は `You cannot dynamically configure MCP servers when an enterprise MCP config is present` というメッセージで起動時に終了します。

109* ファイルがデプロイされているホスト上の[クラウドセッション](/docs/ja/claude-code-on-the-web)([セルフホストランナー](/docs/ja/self-hosted-environments-configuration#mcp-servers)など)では、Claude Code はマネージドサーバーのみで起動し、claude.ai コネクタおよびクラウドホストが `--mcp-config` を通じて配信するその他のサーバーをスキップします。セッション内のどのサーバーが除外されたかをユーザーに伝えるものはありません。Claude Code はそれらを stderr の警告で名前を付けます。これはセルフホストランナーが `debug` ログレベルで記録します。116* ファイルがデプロイされているホスト上の[「クラウドセッション」](/docs/ja/claude-code-on-the-web)([「セルフホストランナー」](/docs/ja/self-hosted-environments-configuration#mcp-servers)など)では、Claude Code はマネージドサーバーのみで起動し、claude.ai コネクタおよびクラウドホストが `--mcp-config` を通じて配信するその他のサーバーをスキップします。セッション内のどのサーバーが除外されたかをユーザーに伝えるものはありません。Claude Code はそれらを stderr の警告で名前を付けます。これはセルフホストランナーが `debug` ログレベルで記録します。

110 117 

111`--strict-mcp-config` フラグはマネージドセットを置き換えるよう要求します。ユーザーがそのようなファイルがデプロイされている間にそれを渡す場合、Claude Code はワークステーション上とクラウドセッション上の両方で起動時に終了します。118`--strict-mcp-config` フラグはマネージドセットを置き換えるよう要求します。ユーザーがそのようなファイルがデプロイされている間にそれを渡す場合、Claude Code はワークステーション上とクラウドセッション上の両方で起動時に終了します。

112 119 


119* `deniedMcpServers` はマネージドサーバーにも適用されるため、エントリに一致するマネージドサーバーは読み込まれません。126* `deniedMcpServers` はマネージドサーバーにも適用されるため、エントリに一致するマネージドサーバーは読み込まれません。

120* ユーザー独自の `deniedMcpServers` は設定からマージされるため、ユーザーはマネージドサーバーを自分自身でブロックできます。127* ユーザー独自の `deniedMcpServers` は設定からマージされるため、ユーザーはマネージドサーバーを自分自身でブロックできます。

121 128 

122`allowedMcpServers` は `managed-mcp.json` 内のサーバーには適用されません。ただし 1 つの例外があります。Claude Code は定義が [`${VAR}` 展開](/docs/ja/mcp#environment-variable-expansion-in-mcp-json)を使用するサーバーを許可リストに対してチェックします。そのサーバーの有効な構成はファイルだけではなく各ユーザーの環境から来るためです。v2.1.259 より前では、許可リストが設定されている場合、すべてのマネージドサーバーが許可リストを通過する必要がありました。どのフィールドが `${VAR}` チェックをトリガーするか、およびチェックの完全な順序については、[サーバーがどのように評価されるか](#how-a-server-is-evaluated)を参照してください。129`allowedMcpServers` は `managed-mcp.json` 内のサーバーには適用されません。ただし 1 つの例外があります。Claude Code は定義が[「`${VAR}` 展開」](/docs/ja/mcp#environment-variable-expansion-in-mcp-json)を使用するサーバーを許可リストに対してチェックします。そのサーバーの有効な構成はファイルだけではなく各ユーザーの環境から来るためです。v2.1.259 より前では、許可リストが設定されている場合、すべてのマネージドサーバーが許可リストを通過する必要がありました。どのフィールドが `${VAR}` チェックをトリガーするか、およびチェックの完全な順序については、[「サーバーがどのように評価されるか」](#how-a-server-is-evaluated)を参照してください。

123 130 

124`allowedMcpServers` を使用して独自の `managed-mcp.json` サーバーの一部が読み込まれないようにしていた場合、`${VAR}` 展開を使用しない限り、各ユーザーが v2.1.259 以降の最初の起動時にそれらのサーバーが読み込まれ始めます。プロンプトや通知はありません。`deniedMcpServers` のみがそれらのサーバーから差し引かれます。それらの拒否リストエントリを追加するか、ユーザーがアップグレードする前に、グループごとに別の `managed-mcp.json` をデプロイしてください。131`allowedMcpServers` を使用して独自の `managed-mcp.json` サーバーの一部が読み込まれないようにしていた場合、`${VAR}` 展開を使用しない限り、各ユーザーが v2.1.259 以降の最初の起動時にそれらのサーバーが読み込まれ始めます。プロンプトや通知はありません。`deniedMcpServers` のみがそれらのサーバーから差し引かれます。それらの拒否リストエントリを追加するか、ユーザーがアップグレードする前に、グループごとに別の `managed-mcp.json` をデプロイしてください。

125 132 


138 MCP を完全に無効にする145 MCP を完全に無効にする

139</h3>146</h3>

140 147 

141空のサーバーマップを含む `managed-mcp.json` をデプロイして、[セッションを開始したアプリが登録するインプロセスサーバー](#exclusive-control-with-managed-mcp-json)を除くすべての MCP サーバーをブロックします。148空のサーバーマップを含む `managed-mcp.json` をデプロイして、[「排他的制御」](#exclusive-control-with-managed-mcp-json)の下で読み込まれるもの以外のすべての MCP サーバーをブロックします。

142 149 

143```json theme={null}150```json theme={null}

144{151{


146}153}

147```154```

148 155 

149`claude mcp add` は上記のエンタープライズポリシーエラーで失敗します。ユーザーが以前に構成したサーバーは、次回セッションを開始するときに読み込まれなくなります。ポリシーが理由であることについての警告はありません。`managedMcpServers` を通じて提供するサーバーは空のマップの下でも読み込まれるため、MCP を完全に無効にするにはそのキーも設定しないままにしてください。156`claude mcp add` は上記のエンタープライズポリシーエラーで失敗します。ユーザーが以前に構成したサーバーは、次回セッションを開始するときに読み込まれなくなります。ポリシーが理由であることについての警告はありません。`managedMcpServers` を通じて提供するサーバーと、マネージドセットと共に許可するその他のすべてのものは、空のマップの下でも読み込まれるため、MCP を完全に無効にするにはそれらのキーを設定しないままにしてください。

150 157 

151<h3 id="allow-claude-ai-connectors-alongside-the-managed-set">158<h3 id="allow-claude-ai-connectors-alongside-the-managed-set">

152 マネージドセットと共に claude.ai コネクタを許可する159 マネージドセットと共に claude.ai コネクタを許可する

153</h3>160</h3>

154 161 

155デフォルトでは、`managed-mcp.json` をデプロイすると、Claude Code が自身で取得する [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)(管理者が claude.ai 管理コンソールで組織用に構成したコネクタを含む)が抑制されます。`managed-mcp.json` 内のサーバーと共にそれらのコネクタを読み込むには、[マネージド設定ソース](/docs/ja/admin-setup#decide-how-settings-reach-devices)で `"allowAllClaudeAiMcps": true` を設定してください。162デフォルトでは、`managed-mcp.json` をデプロイすると、Claude Code が自身で取得する[「claude.ai コネクタ」](/docs/ja/mcp#use-mcp-servers-from-claude-ai)(管理者が claude.ai 管理コンソールで組織用に構成したコネクタを含む)が抑制されます。`managed-mcp.json` 内のサーバーと共にそれらのコネクタを読み込むには、[「マネージド設定ソース」](/docs/ja/admin-setup#decide-how-settings-reach-devices)で `"allowAllClaudeAiMcps": true` を設定してください。

156 163 

157設定が有効になると、Claude Code は `managed-mcp.json` がデプロイされていない場合に読み込むのと同じ claude.ai コネクタを読み込みます。[許可リストと拒否リスト](#policy-based-control-with-allowlists-and-denylists)はそれらのコネクタに引き続き適用されるため、`deniedMcpServers` で特定のコネクタをブロックできます。この設定は Claude Code が自身で取得する claude.ai コネクタのみに影響します。プラグイン提供のサーバーは抑制されたままです。164設定が有効になると、Claude Code は `managed-mcp.json` がデプロイされていない場合に読み込むのと同じ claude.ai コネクタを読み込みます。[「許可リストと拒否リスト」](#policy-based-control-with-allowlists-and-denylists)はそれらのコネクタに引き続き適用されるため、`deniedMcpServers` で特定のコネクタをブロックできます。この設定は Claude Code が自身で取得する claude.ai コネクタのみに影響します。プラグイン提供のサーバーは抑制されたままです。

158 165 

159クラウドセッションとデスクトップアプリのローカルおよび SSH セッションは、別の方法でコネクタを受け取ります。これは[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code)で説明されています。クラウドセッションを実行するホスト上の `managed-mcp.json`([セルフホストランナーホスト](/docs/ja/self-hosted-environments-configuration#mcp-servers)など)は、`allowAllClaudeAiMcps` を設定するかどうかに関わらず、そのセッションのコネクタを抑制します。デスクトップアプリがローカルおよび SSH セッションに配信するコネクタには `managed-mcp.json` は到達しません。166クラウドセッションとデスクトップアプリのローカルおよび SSH セッションは、別の方法でコネクタを受け取ります。これは[「コネクタが Claude Code に到達する方法」](/docs/ja/mcp#how-connectors-reach-claude-code)で説明されています。クラウドセッションを実行するホスト上の `managed-mcp.json`([「セルフホストランナーホスト」](/docs/ja/self-hosted-environments-configuration#mcp-servers)など)は、`allowAllClaudeAiMcps` を設定するかどうかに関わらず、そのセッションのコネクタを抑制します。デスクトップアプリがローカルおよび SSH セッションに配信するコネクタには `managed-mcp.json` は到達しません。

160 167 

161Claude Code は `allowAllClaudeAiMcps` を管理者制御のポリシー層からのみ読み込みます。サーバー管理設定、MDM デプロイされた plist または HKLM レジストリキー、またはシステム `managed-settings.json` ファイルです。ユーザーまたはプロジェクト設定に配置しても効果がないため、ユーザーは排他的制御が抑制したコネクタを再度有効にすることはできません。168Claude Code は `allowAllClaudeAiMcps` を管理者制御のポリシー層からのみ読み込みます。サーバー管理設定、MDM デプロイされた plist または HKLM レジストリキー、またはシステム `managed-settings.json` ファイルです。ユーザーまたはプロジェクト設定に配置しても効果がないため、ユーザーは排他的制御が抑制したコネクタを再度有効にすることはできません。

162 169 

170<h3 id="allow-claude-in-chrome-alongside-the-managed-set">

171 マネージドセットと共に Claude in Chrome を許可する

172</h3>

173 

174デフォルトでは、`managed-mcp.json` をデプロイすると、Claude Code はターミナルセッションで組み込みの[「Claude in Chrome」](/docs/ja/chrome)サーバーをブロックします。ユーザーは[「拡張機能インストールプロンプト」](/docs/ja/chrome#install-the-extension-when-claude-asks)を取得しません。また、ユーザーが[「Chrome をデフォルトで有効にした」](/docs/ja/chrome#enable-chrome-by-default)セッションは、Chrome なしで起動し、警告を出力しません。Chrome を実行できるユーザーが `claude --chrome` または `CLAUDE_CODE_ENABLE_CFC=1` で起動する場合、Claude Code は `allowClaudeInChromeWithManagedMcp` 設定に名前を付けるエラーで起動時に終了します。

175 

176ユーザーが `managed-mcp.json` 内のサーバーと共に Claude in Chrome を実行できるようにするには、デバイス独自のマネージド設定で `"allowClaudeInChromeWithManagedMcp": true` を設定してください。MDM デプロイされた plist または HKLM レジストリキー、またはシステム `managed-settings.json` ファイルに配置してください。Claude Code がそのデバイスで[「選択」](/docs/ja/managed-settings#precedence-within-the-managed-tier)するもののいずれかです。Claude Code v2.1.282 以降が必要です。v2.1.282 より前では、Claude Code は設定を無視し、起動エラーは代わりに `You cannot dynamically configure MCP servers when an enterprise MCP config is present` と表示されます。

177 

178Claude Code は[「サーバー管理設定」](/docs/ja/server-managed-settings)がポリシーの残りを配信する場合でも、それらのデバイスソースから設定を読み込みます。サーバー管理設定自体、ユーザー書き込み可能な HKCU レジストリ、およびユーザーまたはプロジェクト設定では設定を無視します。[「`deniedMcpServers`」](#policy-based-control-with-allowlists-and-denylists)の `claude-in-chrome` エントリは、設定がオンの場合でもサーバーをブロックします。

179 

163<h2 id="provide-servers-through-managed-settings">180<h2 id="provide-servers-through-managed-settings">

164 マネージド設定を通じてサーバーを提供する181 マネージド設定を通じてサーバーを提供する

165</h2>182</h2>


297 314 

298| 設定 | 設定なし(デフォルト) | 空の配列 `[]` | 設定あり |315| 設定 | 設定なし(デフォルト) | 空の配列 `[]` | 設定あり |

299| :- | :- | :- | :- |316| :- | :- | :- | :- |

300| `allowedMcpServers` | すべてのサーバーが許可される | [組織自身のサーバー](#how-a-server-is-evaluated)を除き、サーバーは許可されません | マッチするサーバーのみが許可され、[組織自身のサーバー](#how-a-server-is-evaluated)は除外されます |317| `allowedMcpServers` | すべてのサーバーが許可される | [allowlist チェックをスキップするサーバー](#how-a-server-is-evaluated)を除き、サーバーは許可されません | マッチするサーバーのみが許可され、[allowlist チェックをスキップするサーバー](#how-a-server-is-evaluated)は除外されます |

301| `deniedMcpServers` | サーバーはブロックされません | サーバーはブロックされません | マッチするサーバーがブロックされます |318| `deniedMcpServers` | サーバーはブロックされません | サーバーはブロックされません | マッチするサーバーがブロックされます |

302 319 

303エントリがスキーマ検証に失敗した場合の詳細は、[管理設定の無効なエントリ](/docs/ja/managed-settings#invalid-entries-in-managed-settings)を参照してください。320エントリがスキーマ検証に失敗した場合の詳細は、[管理設定の無効なエントリ](/docs/ja/managed-settings#invalid-entries-in-managed-settings)を参照してください。


3232. **denylist をチェックします。** URL、コマンド、または名前で denylist エントリにマッチするサーバーはブロックされます。denylist マッチをオーバーライドするものはありません。3402. **denylist をチェックします。** URL、コマンド、または名前で denylist エントリにマッチするサーバーはブロックされます。denylist マッチをオーバーライドするものはありません。

3243. **allowlist をチェックします。** `allowedMcpServers` がどこにも設定されていない場合、denylist を通過したすべてのサーバーがロードされます。設定されている場合、サーバーがマッチする必要があるものはそのタイプに依存し、以下の表に示されています。3413. **allowlist をチェックします。** `allowedMcpServers` がどこにも設定されていない場合、denylist を通過したすべてのサーバーがロードされます。設定されている場合、サーバーがマッチする必要があるものはそのタイプに依存し、以下の表に示されています。

325 342 

326 組織自身のサーバーはこのチェックをスキップします。すべての `managedMcpServers` エントリ、および `${VAR}` 展開を使用しない値を持つ `managed-mcp.json` エントリです。Chrome の Claude、Claude Code が実行中の VS Code または JetBrains IDE に接続する `ide` サーバー、CLI 自身が設定するサーバーなどの組み込みサーバーもスキップします。343 3 つのサーバーグループはこのチェックをスキップします。

344 

345 * 組織自身のサーバー:すべての `managedMcpServers` エントリ、および `${VAR}` 展開を使用しない値を持つ `managed-mcp.json` エントリ。

346 * Chrome の Claude、Claude Code が実行中の VS Code または JetBrains IDE に接続する `ide` サーバー、CLI 自身が設定するサーバーなどの組み込みサーバー。

347 * [Claude Tag](/docs/ja/claude-tag) セッションの Slack ツール:スレッドを読み取り、返信を投稿するために使用するサーバーは allowlist エントリなしでロードされます。

327 348 

328 コマンド、引数、`env`、URL、またはヘッダーで `${VAR}` 展開を使用する `managed-mcp.json` サーバーは、ユーザー、プラグイン、`--mcp-config`、または claude.ai が追加するすべてのサーバーと同様にチェックされます。349 コマンド、引数、`env`、URL、またはヘッダーで `${VAR}` 展開を使用する `managed-mcp.json` サーバーはまだチェックされます。ユーザー、プラグイン、claude.ai が追加するすべてのサーバー、および `--mcp-config` でユーザーが渡すすべてのサーバーも同様です。

329 350 

330| サーバータイプ | マッチ時に許可される |351| サーバータイプ | マッチ時に許可される |

331| :- | :- |352| :- | :- |


508| 制限 | ユーザーに表示される内容 |529| 制限 | ユーザーに表示される内容 |

509| :- | :- |530| :- | :- |

510| `managed-mcp.json` が存在し、ユーザーが `claude mcp add` を実行する | `Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers` |531| `managed-mcp.json` が存在し、ユーザーが `claude mcp add` を実行する | `Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers` |

532| `managed-mcp.json` が存在し、Chrome で Claude を実行できるユーザーが `claude --chrome` を実行する | Claude Code はスタートアップ時に `Claude in Chrome is blocked by your organization's managed MCP configuration (managed-mcp.json). An administrator can allow it with allowClaudeInChromeWithManagedMcp in device policy.` で終了します |

511| サーバーがデニーリストにあり、ユーザーが `claude mcp add` を実行する | `Cannot add MCP server "<name>": server is explicitly blocked by enterprise policy` |533| サーバーがデニーリストにあり、ユーザーが `claude mcp add` を実行する | `Cannot add MCP server "<name>": server is explicitly blocked by enterprise policy` |

512| サーバーがアローリストになく、ユーザーが `claude mcp add` を実行する | `Cannot add MCP server "<name>": not allowed by enterprise policy` |534| サーバーがアローリストになく、ユーザーが `claude mcp add` を実行する | `Cannot add MCP server "<name>": not allowed by enterprise policy` |

513| ユーザーが `managedMcpServers` のサーバーで `claude mcp remove` を実行する | `MCP server "<name>" is provided by your organization (managed settings) and cannot be removed locally.` |535| ユーザーが `managedMcpServers` のサーバーで `claude mcp remove` を実行する | `MCP server "<name>" is provided by your organization (managed settings) and cannot be removed locally.` |


535| `allowedMcpServers` | 許可されたサーバーのホワイトリスト | 任意の[設定スコープ](/docs/ja/settings#where-settings-live)。[サーバーの評価方法](#how-a-server-is-evaluated)に、複数のスコープと管理ソースからのリストがどのように組み合わされるかが記載されています | 強制するには、[管理設定ソース](/docs/ja/admin-setup#decide-how-settings-reach-devices):サーバー管理設定、`managed-settings.json`、MDM プロファイル、またはレジストリ |557| `allowedMcpServers` | 許可されたサーバーのホワイトリスト | 任意の[設定スコープ](/docs/ja/settings#where-settings-live)。[サーバーの評価方法](#how-a-server-is-evaluated)に、複数のスコープと管理ソースからのリストがどのように組み合わされるかが記載されています | 強制するには、[管理設定ソース](/docs/ja/admin-setup#decide-how-settings-reach-devices):サーバー管理設定、`managed-settings.json`、MDM プロファイル、またはレジストリ |

536| `deniedMcpServers` | ブロックされたサーバーのブラックリスト | 任意の設定スコープ。[サーバーの評価方法](#how-a-server-is-evaluated)に、複数のスコープと管理ソースからのリストがどのように組み合わされるかが記載されています | `allowedMcpServers` と同じ |558| `deniedMcpServers` | ブロックされたサーバーのブラックリスト | 任意の設定スコープ。[サーバーの評価方法](#how-a-server-is-evaluated)に、複数のスコープと管理ソースからのリストがどのように組み合わされるかが記載されています | `allowedMcpServers` と同じ |

537| `allowManagedMcpServersOnly` | ホワイトリストを管理ソースのみにロック | 管理設定ソースのみ。[すべての管理ソースから読み込まれるキー](/docs/ja/managed-settings#keys-read-from-every-admin-source)に、どの管理ソースがこれをオンにできるかが記載されています。この設定は他のスコープでは効果がありません | `allowedMcpServers` と同じ |559| `allowManagedMcpServersOnly` | ホワイトリストを管理ソースのみにロック | 管理設定ソースのみ。[すべての管理ソースから読み込まれるキー](/docs/ja/managed-settings#keys-read-from-every-admin-source)に、どの管理ソースがこれをオンにできるかが記載されています。この設定は他のスコープでは効果がありません | `allowedMcpServers` と同じ |

560| `allowClaudeInChromeWithManagedMcp` | 組み込みの Claude in Chrome サーバーが `managed-mcp.json` と並行して実行されることを許可します | デバイス上の管理設定のみ:MDM プロファイル、HKLM レジストリ、または `managed-settings.json`。サーバー管理設定とユーザー書き込み可能なソースは効果がありません | MDM、GPO、フリート管理、または管理者権限を持つプロセス |

538| `allowAllClaudeAiMcps` | Claude Code が自身で取得する claude.ai コネクタを `managed-mcp.json` と並行して読み込みます。[クラウドセッションを実行するホスト上の `managed-mcp.json` は、そのセッションのコネクタを依然として抑制します](#allow-claude-ai-connectors-alongside-the-managed-set) | 管理設定ソースのみ。この設定は他の場所では効果がありません | `allowedMcpServers` と同じ |561| `allowAllClaudeAiMcps` | Claude Code が自身で取得する claude.ai コネクタを `managed-mcp.json` と並行して読み込みます。[クラウドセッションを実行するホスト上の `managed-mcp.json` は、そのセッションのコネクタを依然として抑制します](#allow-claude-ai-connectors-alongside-the-managed-set) | 管理設定ソースのみ。この設定は他の場所では効果がありません | `allowedMcpServers` と同じ |

539 562 

540<h2 id="related-resources">563<h2 id="related-resources">

Details

433 マネージドソースのみが設定できるキー433 マネージドソースのみが設定できるキー

434</h2>434</h2>

435 435 

436Claude Code は次のキーをマネージドソースからのみ読み取ります。ユーザーまたはプロジェクト設定ファイルに配置しても効果がありません。436Claude Code は以下のキーをマネージドソースからのみ読み込みます。ユーザーまたはプロジェクト設定ファイルに配置しても効果がありません。

437 437 

438ほとんどはロックです。ロックが管理するキー(権限ルールまたは `sandbox.network.allowedDomains` など)は、任意のレベルが設定できる通常のキーであり、ロックは Claude Code にマネージド値のみを尊重するよう指示します。438これらのほとんどはロックです。ロックが管理する値(権限ルールや `sandbox.network.allowedDomains` など)は、任意のレベルで設定できる通常のキーであり、ロックは Claude Code にマネージド値のみを尊重するよう指示します。

439 439 

440テーブルは権限、プラグイン、配信コントロールをカバーしています。ここにリストされていないキーについては、[設定リファレンス](/docs/ja/settings-reference#all-settings) インデックスの Scope 列は、それがマネージドのみであるかどうかを示しています。残りのマネージドのみキーには、ゲートウェイログイン URL、バージョン、ブラウザ、モバイルシミュレーター、SSH ホスト、Desktop ローカルセッション、サンドボックスバイナリパス、モデル価格、モデル制限、CLAUDE.md コントロールが含まれます。440このテーブルは権限、プラグイン、配信制御をカバーしています。ここに記載されていないキーについては、[設定リファレンス](/docs/ja/settings-reference#all-settings)インデックスの Scope 列に、それがマネージドのみかどうかが記載されています。そこに記載されている残りのマネージドのみのキーには、ゲートウェイログイン URL、バージョン、ブラウザ、モバイルシミュレータ、SSH ホスト、Desktop ローカルセッション、サンドボックスバイナリパス、モデル価格設定、モデル制限、CLAUDE.md 制御が含まれます。

441 441 

442| 設定 | 説明 |442| 設定 | 説明 |

443| :- | :- |443| :- | :- |

444| [`allowAllClaudeAiMcps`](/docs/ja/settings-reference#allowallclaudeaimcps) | Claude Code が自身でフェッチする claude.ai コネクタをデプロイされた `managed-mcp.json` と一緒にロードします。それらを抑制する代わりに |444| [`allowAllClaudeAiMcps`](/docs/ja/settings-reference#allowallclaudeaimcps) | デプロイされた `managed-mcp.json` と一緒に Claude Code が自身で取得する claude.ai コネクタを読み込みます。それ以外の場合は抑制されます |

445| [`allowedChannelPlugins`](/docs/ja/settings-reference#allowedchannelplugins) | メッセージをプッシュできるチャネルプラグインの許可リスト。設定されている場合、デフォルト Anthropic 許可リストを置き換えます。`channelsEnabled: true` が必要です。[実行できるチャネルプラグインを制限する](/docs/ja/channels#restrict-which-channel-plugins-can-run) を参照してください |445| [`allowedChannelPlugins`](/docs/ja/settings-reference#allowedchannelplugins) | メッセージをプッシュできるチャネルプラグインのアローリスト。設定時にデフォルトの Anthropic アローリストを置き換えます。`channelsEnabled: true` が必要です。[チャネルプラグインの実行を制限する](/docs/ja/channels#restrict-which-channel-plugins-can-run)を参照してください |

446| [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) | `true` の場合、実行するフックを制限します。[`allowManagedHooksOnly` の下で実行するもの](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly) の完全な効果リストを参照してください |446| [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) | `true` の場合、どのフックが実行されるかを制限します。完全な効果リストについては[`allowManagedHooksOnly` の下で実行されるもの](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)を参照してください |

447| [`allowManagedMcpServersOnly`](/docs/ja/settings-reference#allowmanagedmcpserversonly) | `true` の場合、マネージド設定からの `allowedMcpServers` のみが尊重されます。`deniedMcpServers` はすべてのソースからマージされます。[すべての管理ソースから読み取られるキー](#keys-read-from-every-admin-source) でどのマネージドソースがそれを設定できるかを参照し、[マネージド MCP 構成](/docs/ja/managed-mcp) を参照してください |447| [`allowManagedMcpServersOnly`](/docs/ja/settings-reference#allowmanagedmcpserversonly) | `true` の場合、マネージド設定からの `allowedMcpServers` のみが尊重されます。`deniedMcpServers` はすべてのソースからマージされます。どのマネージドソースがこれを設定できるかについては[すべての管理者ソースから読み込まれるキー](#keys-read-from-every-admin-source)を参照し、[マネージド MCP 設定](/docs/ja/managed-mcp)を参照してください |

448| [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) | マネージド設定を権限ルールの唯一の設定ソースにします。エントリは無視するすべてのソースをリストします |448| [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) | マネージド設定を権限ルールの唯一の設定ソースにします。エントリは無視するすべてのソースをリストします |

449| [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) | マーケットプレイスソースのブロックリスト。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れません。[マネージドマーケットプレイス制限](/docs/ja/plugins/org#restrict-what-users-can-install) を参照してください |449| [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) | マーケットプレイスソースのブロックリスト。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。[マネージドマーケットプレイス制限](/docs/ja/plugins/org#restrict-what-users-can-install)を参照してください |

450| [`channelsEnabled`](/docs/ja/settings-reference#channelsenabled) | 組織の [チャネル](/docs/ja/channels) を許可します。各プランのデフォルトについては [エンタープライズコントロール](/docs/ja/channels#enterprise-controls) を参照してください |450| [`channelsEnabled`](/docs/ja/settings-reference#channelsenabled) | 組織の[チャネル](/docs/ja/channels)を許可します。各プランのデフォルトについては[エンタープライズ制御](/docs/ja/channels#enterprise-controls)を参照してください |

451| [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) | `true` の場合、[`command` プラグインソース](/docs/ja/plugins/marketplace-reference#command-plugin-source) を完全にブロックするため、マーケットプレイス宣言コマンドは実行されません。マーケットプレイス [`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) もブロックします。ただし、マネージド設定自体が宣言するマーケットプレイスは除きます。設定されていない場合、`allowManagedHooksOnly` に従います。Claude Code v2.1.229 以降が必要で、`headersHelper` ブロックは v2.1.238 以降が必要です |451| [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) | `true` の場合、[`command` プラグインソース](/docs/ja/plugins/marketplace-reference#command-plugin-source)を完全にブロックするため、マーケットプレイスで宣言されたコマンドは実行されません。また、マーケットプレイスの[`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads)もブロックします。ただし、マネージド設定自体が宣言するマーケットプレイスは除きます。設定されていない場合は、`allowManagedHooksOnly` に従います。Claude Code v2.1.229 以降が必要であり、`headersHelper` ブロックには v2.1.238 以降が必要です |

452| [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) | スタートアップで `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` フラグを拒否します。クラウドセッションでは、Claude Code はサーバーが `--mcp-config` を通じて配信した MCP サーバーをドロップします。ただし、プロセス内 `type: "sdk"` エントリは除き、セッションを開始します。Claude Code v2.1.193 以降が必要です |452| [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) | 起動時に `--plugin-dir`、`--plugin-url`、`--agents`、`--mcp-config` フラグを拒否します。クラウドセッションでは、Claude Code はセッションを開始し、サーバー配信の `--mcp-config` サーバーをドロップします。ただし、その[リファレンスエントリ](/docs/ja/settings-reference#disablesideloadflags)がリストする例外は除きます。Claude Code v2.1.193 以降が必要です |

453| [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) | `true` の場合、リモートマネージド設定が新しくフェッチされるまで CLI スタートアップをブロックし、フェッチが失敗する場合は終了します。[失敗閉じ強制](/docs/ja/server-managed-settings#enforce-fail-closed-startup) を参照してください |453| [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) | `true` の場合、リモートマネージド設定が新たに取得されるまで CLI 起動をブロックし、取得に失敗した場合は終了します。[フェイルクローズ実装](/docs/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください |

454| [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) | すべてのユーザーに独自と一緒に提供されるリモート MCP サーバー。何かをロックするのではなく、サーバーを提供します。[マネージド設定を通じてサーバーを提供する](/docs/ja/managed-mcp#provide-servers-through-managed-settings) を参照してください。Claude Code v2.1.259 以降が必要です |454| [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) | すべてのユーザーに自身のサーバーと一緒に提供されるリモート MCP サーバー。何かをロックダウンするのではなく、サーバーを提供します。[マネージド設定を通じてサーバーを提供する](/docs/ja/managed-mcp#provide-servers-through-managed-settings)を参照してください。Claude Code v2.1.259 以降が必要です |

455| [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) | Claude Code が最高優先度のマネージドソースのみを適用するか、[それらすべてを構成する](#compose-every-managed-source) か |455| [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) | Claude Code が最優先のマネージドソースのみを適用するか、[すべてのマネージドソースを構成する](#compose-every-managed-source)かどうか |

456| [`parentSettingsBehavior`](/docs/ja/settings-reference#parentsettingsbehavior) | ホスト提供の親設定がマネージドポリシーの下でマージするかどうか |456| [`parentSettingsBehavior`](/docs/ja/settings-reference#parentsettingsbehavior) | ホスト提供の親設定がマネージドポリシーの下でマージされるかどうか |

457| [`pluginSuggestionMarketplaces`](/docs/ja/settings-reference#pluginsuggestionmarketplaces) | Claude Code がユーザーに提案できるプラグインのマーケットプレイス |457| [`pluginSuggestionMarketplaces`](/docs/ja/settings-reference#pluginsuggestionmarketplaces) | Claude Code がユーザーに提案できるプラグインのマーケットプレイス |

458| [`pluginTrustMessage`](/docs/ja/settings-reference#plugintrustmessage) | インストール前に表示されるプラグイン信頼警告に追加されるカスタムメッセージ |458| [`pluginTrustMessage`](/docs/ja/settings-reference#plugintrustmessage) | インストール前に表示されるプラグイン信頼警告に追加されるカスタムメッセージ |

459| [`policyHelper`](/docs/ja/settings-reference#policyhelper) | スタートアップでマネージド設定を計算する実行可能ファイル。[ポリシーヘルパーでマネージド設定を計算する](/docs/ja/settings-reference#policyhelper) を参照してください |459| [`policyHelper`](/docs/ja/settings-reference#policyhelper) | 起動時にマネージド設定を計算する実行可能ファイル。[ポリシーヘルパーでマネージド設定を計算する](/docs/ja/settings-reference#policyhelper)を参照してください |

460| [`sandbox.filesystem.allowManagedReadPathsOnly`](/docs/ja/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) | `true` の場合、マネージド設定からの `filesystem.allowRead` パスのみが尊重されます。`denyRead` はすべてのソースからマージされます |460| [`sandbox.filesystem.allowManagedReadPathsOnly`](/docs/ja/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) | `true` の場合、マネージド設定からの `filesystem.allowRead` パスのみが尊重されます。`denyRead` はすべてのソースからマージされます |

461| [`sandbox.network.allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) | マネージド `allowedDomains` および `WebFetch(domain:...)` 許可ルールのみを尊重します。プロンプトなしで他のドメインをブロックします |461| [`sandbox.network.allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) | マネージドの `allowedDomains` と `WebFetch(domain:...)` アロールールのみを尊重します。他のドメインはプロンプトなしでブロックします |

462| [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) | ユーザーが追加してプラグインをインストールできるプラグインマーケットプレイスソースを制御します。[マネージドマーケットプレイス制限](/docs/ja/plugins/org#restrict-what-users-can-install) を参照してください |462| [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) | ユーザーが追加してプラグインをインストールできるプラグインマーケットプレイスソースを制御します。[マネージドマーケットプレイス制限](/docs/ja/plugins/org#restrict-what-users-can-install)を参照してください |

463| [`strictPluginOnlyCustomization`](/docs/ja/settings-reference#strictpluginonlycustomization) | ユーザーおよびプロジェクトソースからのスキル、エージェント、フック、MCP サーバーをブロックします。`true` はすべて 4 つをロックし、配列はどれかに名前を付けます |463| [`strictPluginOnlyCustomization`](/docs/ja/settings-reference#strictpluginonlycustomization) | ユーザーおよびプロジェクトソースからのスキル、エージェント、フック、MCP サーバーをブロックします。`true` はすべて 4 つをロックし、配列はどれをロックするかを指定します |

464| [`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) | `HKLM` レジストリまたは `C:\Program Files\ClaudeCode` の下のファイルに設定されている場合、WSL が Windows ポリシーチェーンを読み取り、[Windows 管理ドキュメントが存在しない](#present-admin-documents) 場合のみ `/etc/claude-code` を読み取ります。エントリは順序を示しています |464| [`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) | HKLM レジストリまたは `C:\Program Files\ClaudeCode` の下のファイルに設定されている場合、WSL に Windows ポリシーチェーンを読み込ませ、[Windows 管理ドキュメントが存在しない](#present-admin-documents)場合にのみ `/etc/claude-code` を読み込みます。エントリは順序を指定します |

465 465 

466<Note>466<Note>

467 Team および Enterprise プランでは、Owner は [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code) で [リモートコントロール](/docs/ja/remote-control) および [クラウドセッション](/docs/ja/claude-code-on-the-web) を組織全体で有効または無効にします。リモートコントロールは [`disableRemoteControl`](/docs/ja/settings-reference#disableremotecontrol) 設定でデバイスごとに無効にすることもできます。クラウドセッションにはデバイスごとのマネージド設定キーがありません。467 Team および Enterprise プランでは、オーナーが [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code)で組織全体の[リモートコントロール](/docs/ja/remote-control)と[クラウドセッション](/docs/ja/claude-code-on-the-web)を有効または無効にします。リモートコントロールは [`disableRemoteControl`](/docs/ja/settings-reference#disableremotecontrol) 設定でデバイスごとに無効にすることもできます。クラウドセッションにはデバイスごとのマネージド設定キーはありません。

468 468 

469 これらの組織設定が特定のマシンに到達したかどうかを確認するには、そこで `claude doctor` を実行し、`Organization policy` 行を読みます。これは Claude Code がポリシーをロードした場所、またはロードしなかった理由を示しています。Claude Code v2.1.261 以降が必要です。実行中のセッションでは、ポリシーがロードされなかった場合、`/status` は同じ行を表示します。469 これらの組織設定が特定のマシンに到達したかどうかを確認するには、そこで `claude doctor` を実行し、`Organization policy` 行を読みます。この行は Claude Code がポリシーをどこから読み込んだか、または読み込まなかった理由を示します。Claude Code v2.1.261 以降が必要です。実行中のセッションでは、ポリシーが読み込まれなかった場合、`/status` は同じ行を表示します。

470</Note>470</Note>

471 471 

472<h2 id="turn-telemetry-off-for-your-organization">472<h2 id="turn-telemetry-off-for-your-organization">

mcp.md +3 −3

Details

542 * [クラウドセッション](/docs/ja/claude-code-on-the-web) では、まだ接続されていないプラグインサーバーへの MCP 呼び出し(アイドルセッションが起動した直後など)は、サーバーをオンデマンドで開始し、接続を待ちます542 * [クラウドセッション](/docs/ja/claude-code-on-the-web) では、まだ接続されていないプラグインサーバーへの MCP 呼び出し(アイドルセッションが起動した直後など)は、サーバーをオンデマンドで開始し、接続を待ちます

543* **パスプレースホルダー**: `${CLAUDE_PLUGIN_ROOT}` はプラグインのインストールディレクトリに解決され、`${CLAUDE_PLUGIN_DATA}` はその [永続状態](/docs/ja/plugins/components#path-variables-and-persistent-data) ディレクトリに解決され、`${CLAUDE_PROJECT_DIR}` は安定したプロジェクトルートに解決されます。置換は以下に適用されます。543* **パスプレースホルダー**: `${CLAUDE_PLUGIN_ROOT}` はプラグインのインストールディレクトリに解決され、`${CLAUDE_PLUGIN_DATA}` はその [永続状態](/docs/ja/plugins/components#path-variables-and-persistent-data) ディレクトリに解決され、`${CLAUDE_PROJECT_DIR}` は安定したプロジェクトルートに解決されます。置換は以下に適用されます。

544 * `stdio` サーバー: `command`、`args`、`env`544 * `stdio` サーバー: `command`、`args`、`env`

545 * `http`、`sse`、`ws` サーバー: `url`、`headers`、`headersHelper`。v2.1.195 より前では、`headersHelper` はプレースホルダーをリテラル文字列として渡していました545 * `http`、`sse`、`ws` サーバー: `url`、`headers`、`headersHelper`

546* **ユーザー環境アクセス**: 手動で設定されたサーバーと同じ環境変数へのアクセス546* **ユーザー環境アクセス**: 手動で設定されたサーバーと同じ環境変数へのアクセス

547* **複数のトランスポートタイプ**: stdio、SSE、HTTP、WebSocket トランスポートのサポート。ただし、トランスポートサポートはサーバーによって異なる場合があります547* **複数のトランスポートタイプ**: stdio、SSE、HTTP、WebSocket トランスポートのサポート。ただし、トランスポートサポートはサーバーによって異なる場合があります

548 548 


1101 1101 

1102| サーバーを設定した場所 | 作業ディレクトリ |1102| サーバーを設定した場所 | 作業ディレクトリ |

1103| :- | :- |1103| :- | :- |

1104| [プラグイン](/docs/ja/plugins/components#mcp-servers) | プラグインのルートディレクトリ。Claude Code v2.1.195 以降が必要です |1104| [プラグイン](/docs/ja/plugins/components#mcp-servers) | プラグインのルートディレクトリ |

1105| プロジェクト `.mcp.json` または [ローカルスコープ](#local-scope)サーバー | サーバーが宣言されているプロジェクトディレクトリ |1105| プロジェクト `.mcp.json` または [ローカルスコープ](#local-scope)サーバー | サーバーが宣言されているプロジェクトディレクトリ |

1106| プロジェクト内のエージェントファイル、SDK の `mcpServers` オプションまたは `setMcpServers()` メソッドからのサーバー、または [`--mcp-config`](/docs/ja/cli-reference) | セッションの[プライマリ作業ディレクトリ](/docs/ja/permissions#working-directories) |1106| プロジェクト内のエージェントファイル、SDK の `mcpServers` オプションまたは `setMcpServers()` メソッドからのサーバー、または [`--mcp-config`](/docs/ja/cli-reference) | セッションの[プライマリ作業ディレクトリ](/docs/ja/permissions#working-directories) |

1107| [ユーザースコープ](#user-scope)、[管理 MCP](/docs/ja/managed-mcp)、[claude.ai コネクタ](#use-mcp-servers-from-claude-ai)、またはプロジェクト外のエージェントファイル(`--add-dir` ディレクトリからのものを含む) | 設定ディレクトリ `~/.claude`([`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars)を設定していない場合) |1107| [ユーザースコープ](#user-scope)、[管理 MCP](/docs/ja/managed-mcp)、[claude.ai コネクタ](#use-mcp-servers-from-claude-ai)、またはプロジェクト外のエージェントファイル(`--add-dir` ディレクトリからのものを含む) | 設定ディレクトリ `~/.claude`([`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars)を設定していない場合) |


1440 1440 

1441サーバーは Claude が選択した引数を受け取るため、サーバー側で組み合わせの検証を続けてください。1441サーバーは Claude が選択した引数を受け取るため、サーバー側で組み合わせの検証を続けてください。

1442 1442 

1443Claude Code が API が受け入れるスキーマを生成できない場合、またはスキーマの書き換えを有効にするリモート設定を受け取らないデプロイメントの場合、そのツール 1 つをスキップし、理由をサーバーのログに記録し、サーバーの他のツールは利用可能なままにします。v2.1.195 より前のバージョンは、入力スキーマにルートレベルの `anyOf`、`oneOf`、または `allOf` を持つすべてのツールをスキップします。1443Claude Code が API が受け入れるスキーマを生成できない場合、またはスキーマの書き換えを有効にするリモート設定を受け取らないデプロイメントの場合、そのツール 1 つをスキップし、理由をサーバーのログに記録し、サーバーの他のツールは利用可能なままにします。

1444 1444 

1445<h2 id="tools-with-invalid-input-schemas">1445<h2 id="tools-with-invalid-input-schemas">

1446 無効な入力スキーマを持つツール1446 無効な入力スキーマを持つツール

memory.md +87 −77

Details

41 CLAUDE.md ファイル41 CLAUDE.md ファイル

42</h2>42</h2>

43 43 

44CLAUDE.md ファイルは、プロジェクト、個人的なワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルはプレーンテキストで記述し、Claude はすべてのセッションの開始時にそれらを読みます。リポジトリが代わりに `AGENTS.md` を使用している場合は、[AGENTS.md](#agents-md) を参照してください。44CLAUDE.md ファイルは、プロジェクト、個人のワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルはプレーンテキストで記述し、Claude はすべてのセッションの開始時にそれらを読みます。リポジトリが代わりに `AGENTS.md` を使用している場合は、[AGENTS.md](#agents-md) を参照してください。

45 45 

46<h3 id="when-to-add-to-claude-md">46<h3 id="when-to-add-to-claude-md">

47 CLAUDE.md に追加するタイミング47 CLAUDE.md に追加するタイミング


60 CLAUDE.md ファイルの配置場所を選択する60 CLAUDE.md ファイルの配置場所を選択する

61</h3>61</h3>

62 62 

63CLAUDE.md ファイルはいくつかの場所に配置でき、それぞれ異なるスコープを持ちます。以下の表は、読み込み順序でそれらをリストしており、最も広いスコープから最も具体的なスコープまでなので、プロジェクト指示はユーザー指示の後のコンテキストに表示されます。63CLAUDE.md ファイルはいくつかの場所に配置でき、それぞれ異なるスコープを持ちます。以下の表は、ロード順に、最も広いスコープから最も具体的なスコープまでリストしているため、プロジェクト指示はユーザー指示の後のコンテキストに表示されます。

64 64 

65| スコープ | 場所 | 目的 | ユースケース例 | 共有対象 |65| スコープ | 場所 | 目的 | ユースケース例 | 共有対象 |

66| - | - | - | - | - |66| - | - | - | - | - |

67| **管理ポリシー** | • macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`<br />• Linux と WSL: `/etc/claude-code/CLAUDE.md`<br />• Windows: `C:\Program Files\ClaudeCode\CLAUDE.md` | IT/DevOps が管理する組織全体の指示 | 企業のコーディング標準、セキュリティポリシー、コンプライアンス要件 | 組織内のすべてのユーザー |67| **管理ポリシー** | • macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`<br />• Linux と WSL: `/etc/claude-code/CLAUDE.md`<br />• Windows: `C:\Program Files\ClaudeCode\CLAUDE.md` | IT/DevOps が管理する組織全体の指示 | 企業のコーディング標準、セキュリティポリシー、コンプライアンス要件 | 組織内のすべてのユーザー |

68| **ユーザー指示** | `~/.claude/CLAUDE.md` | すべてのプロジェクトの個人的な設定 | コードスタイルの設定、個人的なツーリングショートカット | あなただけ(すべてのプロジェクト) |68| **ユーザー指示** | `~/.claude/CLAUDE.md` | すべてのプロジェクトの個人的な設定 | コードスタイルの設定、個人的なツーリングショートカット | あなただけ(すべてのプロジェクト) |

69| **プロジェクト指示** | `./CLAUDE.md` または `./.claude/CLAUDE.md`。`./AGENTS.md` が代わりにまたは一緒に読み込まれるタイミングについては [AGENTS.md](#agents-md) を参照してください | プロジェクトのチーム共有指示 | プロジェクトアーキテクチャ、コーディング標準、一般的なワークフロー | ソース管理を通じたチームメンバー |69| **プロジェクト指示** | `./CLAUDE.md` または `./.claude/CLAUDE.md`。`./AGENTS.md` がそれらの代わりに、または一緒にロードされるタイミングについては [AGENTS.md](#agents-md) を参照してください | プロジェクトのチーム共有指示 | プロジェクトアーキテクチャ、コーディング標準、一般的なワークフロー | ソース管理を通じたチームメンバー |

70| **ローカル指示** | `./CLAUDE.local.md` | 個人的なプロジェクト固有の設定。`.gitignore` に追加してください | サンドボックス URL、推奨テストデータ | あなただけ(現在のプロジェクト) |70| **ローカル指示** | `./CLAUDE.local.md` | 個人的なプロジェクト固有の設定。`.gitignore` に追加してください | サンドボックス URL、推奨テストデータ | あなただけ(現在のプロジェクト) |

71 71 

72作業ディレクトリより上のディレクトリ階層内の CLAUDE.md および CLAUDE.local.md ファイルは起動時に読み込まれます。サブディレクトリ内のファイルは、Claude がそれらのディレクトリ内のファイルを読むときにオンデマンドで読み込まれます。完全な解決順序については、[CLAUDE.md ファイルの読み込み方法](#how-claude-md-files-load) を参照してください。72作業ディレクトリより上のディレクトリ階層内の CLAUDE.md および CLAUDE.local.md ファイルは起動時にロードされます。サブディレクトリ内のファイルは、Claude がそれらのディレクトリ内のファイルを読むときにオンデマンドでロードされます。完全な解決順序については、[CLAUDE.md ファイルのロード方法](#how-claude-md-files-load) を参照してください。

73 73 

74大規模なプロジェクトの場合、[プロジェクトルール](#organize-rules-with-claude/rules/) を使用して指示をトピック固有のファイルに分割できます。ルールを使用すると、指示を特定のファイルタイプまたはサブディレクトリにスコープできます。74大規模なプロジェクトの場合、[プロジェクトルール](#organize-rules-with-claude/rules/) を使用してトピック固有のファイルに指示を分割できます。ルールを使用すると、特定のファイルタイプまたはサブディレクトリに指示をスコープできます。

75 75 

76<h3 id="set-up-a-project-claude-md">76<h3 id="set-up-a-project-claude-md">

77 プロジェクト CLAUDE.md をセットアップする77 プロジェクト CLAUDE.md をセットアップする

78</h3>78</h3>

79 79 

80プロジェクト CLAUDE.md は `./CLAUDE.md` または `./.claude/CLAUDE.md` に保存できます。このファイルを作成し、プロジェクトで作業する誰もが適用される指示を追加してください。ビルドおよびテストコマンド、コーディング標準、アーキテクチャの決定、命名規約、一般的なワークフローなどです。これらの指示はバージョン管理を通じてチームと共有されるため、個人的な設定ではなくプロジェクトレベルの標準に焦点を当ててください。ファイルが読み込まれたことを確認するには、セッションで `/context` を実行し、**Memory files** の下のリストを確認してください。80プロジェクト CLAUDE.md は `./CLAUDE.md` または `./.claude/CLAUDE.md` に保存できます。このファイルを作成し、プロジェクトで作業する誰もが適用される指示を追加してください。ビルドおよびテストコマンド、コーディング標準、アーキテクチャの決定、命名規約、一般的なワークフローなどです。これらの指示はバージョン管理を通じてチームと共有されるため、個人的な設定ではなくプロジェクトレベルの標準に焦点を当ててください。ファイルがロードされたことを確認するには、セッションで `/context` を実行し、**Memory files** の下のリストを確認してください。

81 81 

82<Tip>82<Tip>

83 `/init` を実行して、開始用の CLAUDE.md を自動的に生成します。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。CLAUDE.md が既に存在する場合、`/init` は上書きするのではなく改善を提案します。そこから Claude が自分で発見しない指示で改善してください。83 `/init` を実行して、開始用の CLAUDE.md を自動的に生成します。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。CLAUDE.md が既に存在する場合、`/init` は上書きするのではなく改善を提案します。そこから Claude が自分で発見しない指示で洗練させてください。

84 84 

85 インタラクティブなマルチフェーズフローの場合は、`/init` を実行する前に `CLAUDE_CODE_NEW_INIT` 環境変数を `1` に設定してください。シェルまたは [環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように設定ファイルの `env` ブロックで設定してください。設定すると、`/init` はセットアップするアーティファクトを尋ねます。CLAUDE.md ファイル、スキル、フック。その後、サブエージェントでコードベースを探索し、フォローアップの質問でギャップを埋め、ファイルを書き込む前に確認可能な提案を提示します。変数は `/init` の実行方法のみを変更するため、設定したままにしておくことができます。85 代わりにインタラクティブなマルチフェーズフローの場合は、`/init` を実行する前に `CLAUDE_CODE_NEW_INIT` 環境変数を `1` に設定してください。シェルまたは [環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように設定ファイルの `env` ブロックで設定します。設定すると、`/init` はセットアップするアーティファクトを尋ねます。CLAUDE.md ファイル、スキル、フック。その後、サブエージェントでコードベースを探索し、フォローアップの質問を通じてギャップを埋め、ファイルを書き込む前に確認可能な提案を提示します。変数は `/init` の実行方法のみを変更するため、設定したままにしておくことができます。

86</Tip>86</Tip>

87 87 

88<h3 id="write-effective-instructions">88<h3 id="write-effective-instructions">

89 効果的な指示を書く89 効果的な指示を書く

90</h3>90</h3>

91 91 

92CLAUDE.md ファイルはすべてのセッションの開始時にコンテキストウィンドウに読み込まれ、会話と一緒にトークンを消費します。[コンテキストウィンドウの可視化](/docs/ja/context-window) は、CLAUDE.md が起動コンテキストの残りの部分に対してどこに読み込まれるかを示しています。これらはコンテキストであり、強制的な設定ではないため、指示の書き方は Claude がそれらに従う信頼性に影響します。具体的で簡潔で、よく構造化された指示が最も効果的です。92Claude は CLAUDE.md ファイルをコンテキストとして扱い、強制的な設定ではないため、指示の書き方は Claude がそれらに従う信頼性に影響します。検証可能なほど具体的な指示を書いてください。

93 

94**サイズ**: CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。指示が大きくなっている場合は、[パススコープ付きルール](#path-specific-rules) を使用して、Claude が一致するファイルで作業するときにのみ指示が読み込まれるようにしてください。また、コンテンツを [インポート](#import-additional-files) に分割して整理することもできますが、インポートされたファイルは起動時に読み込まれてコンテキストウィンドウに入ります。

95 

96**構造**: マークダウンヘッダーと箇条書きを使用して関連する指示をグループ化してください。Claude は読者と同じ方法で構造をスキャンします。整理されたセクションは密集した段落よりも従いやすいです。

97 

98**具体性**: 検証できるほど具体的な指示を書いてください。例えば:

99 93 

100* 「コードを適切にフォーマットする」ではなく「2 スペースのインデントを使用する」94* 「コードを適切にフォーマットする」ではなく「2 スペースのインデントを使用する」

101* 「変更をテストする」ではなく「コミット前に `npm test` を実行する」95* 「変更をテストする」ではなく「コミット前に `npm test` を実行する」

102* 「ファイルを整理しておく」ではなく「API ハンドラーは `src/api/handlers/` に存在する」96* 「ファイルを整理しておく」ではなく「API ハンドラーは `src/api/handlers/` に存在する」

103 97 

104**一貫性**: 2 つのルールが矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および [`.claude/rules/`](#organize-rules-with-claude/rules/) を定期的に確認して、古い指示または矛盾する指示を削除してください。モノレポでは、[`claudeMdExcludes`](#exclude-specific-claude-md-files) を使用して、作業に関連のない他のチームの CLAUDE.md ファイルをスキップしてください。98ファイルを短く、整理され、一貫性のあるものに保ってください。

99 

100* **サイズ**: CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。コードベースの一部にのみ関連する指示を [パススコープ付きルール](#path-specific-rules) に移動してください。これらは、一致するファイルで Claude が作業するときにのみロードされます。[インポート](#import-additional-files) は長いファイルを整理するのに役立ちますが、インポートされたファイルも起動時にロードされるため、コンテキストコストは削減されません。

101* **構造**: 関連する指示をマークダウンヘッダーと箇条書きの下にグループ化してください。整理されたセクションは、密集した段落よりも Claude が従いやすくなります。

102* **一貫性**: 2 つの指示が矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および [`.claude/rules/`](#organize-rules-with-claude/rules/) を定期的に確認して、古い指示または矛盾する指示を削除してください。Claude に見つけてもらうには、[プロンプト監査を実行](#audit-your-instruction-files) してください。

103 

104<h4 id="audit-your-instruction-files">

105 指示ファイルを監査する

106</h4>

105 107 

106これらのファイルで古い指示または矛盾する指示を確認するために Claude に確認させるには、セッションで `/doctor prompt-audit` を実行してください。Claude は CLAUDE.md、CLAUDE.local.md、および AGENTS.md ファイルを読み取り、`.claude/` および `~/.claude/` の下のルール、スキル、コマンド、サブエージェント、および出力スタイルを読み取ります。古いモデル用に書かれた指示、存在しないファイルまたはコマンドへの参照、互いに矛盾するファイルなどの問題を探します。検出結果のレポートと提案された編集のセットを取得し、ファイル内の何も変更されません。Claude に適用するよう求めるまで。108Claude に指示ファイルで古い内容または矛盾する内容をチェックさせるには、セッションで `/doctor prompt-audit` を実行してください。Claude は、古いモデル用に書かれた指示、存在しないファイルまたはコマンドへの参照、互いに矛盾するファイルなどの問題を探します。提案された編集を含む調査結果のレポートが表示され、ファイル内の何も変更されません。Claude に適用するよう依頼するまで。

107 109 

1081 つのファイルまたはディレクトリを監査する代わりに、そのパスを渡してください。例えば `/doctor prompt-audit .claude/skills/deploy`。監査は bundled `/claude-api` スキルを通じて実行されるため、[`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) でそのスキルがオフになっているか、[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) で利用できません。`/doctor prompt-audit` には Claude Code v2.1.283 以降が必要です。110デフォルトでは、監査は CLAUDE.md、CLAUDE.local.md、AGENTS.md ファイル、および `.claude/` と `~/.claude/` の下のルール、スキル、コマンド、サブエージェント、出力スタイルをカバーします。代わりに 1 つのファイルまたはディレクトリを監査するには、そのパスを渡してください。例えば `/doctor prompt-audit .claude/skills/deploy`。

111 

112監査はバンドルされた `/claude-api` スキルを通じて実行されます。そのスキルが [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) で無効になっているか、[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) で無効になっている場合は利用できません。`/doctor prompt-audit` には Claude Code v2.1.283 以降が必要です。

109 113 

110<h3 id="import-additional-files">114<h3 id="import-additional-files">

111 追加ファイルをインポートする115 追加ファイルをインポートする

112</h3>116</h3>

113 117 

114CLAUDE.md ファイルは `@path/to/import` 構文を使用して追加ファイルをインポートできます。インポートされたファイルは展開され、それらを参照する CLAUDE.md と一緒に起動時にコンテキストに読み込まれます。118CLAUDE.md ファイルは `@path/to/import` 構文を使用して追加ファイルをインポートできます。インポートされたファイルは展開され、それらを参照する CLAUDE.md と一緒に起動時にコンテキストにロードされます。

119 

120相対パスと絶対パスの両方が許可されます。相対パスは、作業ディレクトリではなく、インポートを含むファイルを基準に解決されます。インポートされたファイルは他のファイルを再帰的にインポートでき、最大深度は 4 ホップです。

121 

122パスにスペースが含まれるファイルをインポートするには、各スペースの前にバックスラッシュを付けます。バックスラッシュがない場合、パスは最初のスペースで終了します。インポートが独自の行にある場合でも同じです。引用符で囲まれたパスはまったくインポートされません。バックスラッシュの有無にかかわらず。このインポートは `Design Docs` という名前のフォルダからファイルをロードします。

115 123 

116相対パスと絶対パスの両方が許可されます。相対パスは、作業ディレクトリではなく、インポートを含むファイルに対して相対的に解決されます。インポートされたファイルは他のファイルを再帰的にインポートでき、最大深度は 4 ホップです。124```text theme={null}

125- API conventions @Design\ Docs/api-conventions.md

126```

117 127 

118インポート解析は Markdown コードスパンとフェンスコードブロックをスキップします。パスを CLAUDE.md で言及するがインポートしないようにするには、バッククォートでラップしてください。`` `@README` `` を書くとテキストはリテラルのままですが、バッククォートの外の `@README` はファイルをインポートします。128インポート解析はマークダウンコードスパンとフェンスコードブロックをスキップします。CLAUDE.md でパスに言及する場合、インポートせずに、バックティックで囲んでください。`` `@README` `` を書くとテキストはリテラルのままですが、バックティックの外の `@README` はファイルをインポートします。

119 129 

120README、package.json、ワークフローガイドを取り込むには、CLAUDE.md の任意の場所で `@` 構文で参照してください。130README、package.json、ワークフローガイドを取得するには、CLAUDE.md の任意の場所で `@` 構文を使用してそれらを参照してください。

121 131 

122```text theme={null}132```text theme={null}

123See @README for project overview and @package.json for available npm commands for this project.133See @README for project overview and @package.json for available npm commands for this project.


126- git workflow @docs/git-instructions.md136- git workflow @docs/git-instructions.md

127```137```

128 138 

129バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに `CLAUDE.local.md` を作成してください。これは `CLAUDE.md` と一緒に読み込まれ、同じ方法で扱われます。`CLAUDE.local.md` を `.gitignore` に追加して、コミットされないようにしてください。`CLAUDE_CODE_NEW_INIT=1` が設定されている場合、`/init` を実行して個人オプションを選択するとこれが自動的に行われます。139バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに `CLAUDE.local.md` を作成してください。これは `CLAUDE.md` と一緒にロードされ、同じ方法で扱われます。`CLAUDE.local.md` を `.gitignore` に追加して、コミットされないようにしてください。`CLAUDE_CODE_NEW_INIT=1` が設定されている場合、`/init` を実行して個人オプションを選択するとこれが自動的に行われます。

130 140 

131同じリポジトリの複数の git worktrees で作業する場合、gitignored `CLAUDE.local.md` は作成した worktree にのみ存在します。worktree 全体で個人的な指示を共有するには、代わりにホームディレクトリからファイルをインポートしてください。141同じリポジトリの複数の git ワークツリーで作業する場合、gitignored `CLAUDE.local.md` は作成したワークツリーにのみ存在します。ワークツリー全体で個人的な指示を共有するには、代わりにホームディレクトリからファイルをインポートしてください。

132 142 

133```text theme={null}143```text theme={null}

134# Individual Preferences144# Individual Preferences


136```146```

137 147 

138<Warning>148<Warning>

139 プロジェクトレベルのメモリファイル内のインポートは、ホームディレクトリインポートのように作業ディレクトリの外に解決されるパスを持つ場合、外部です。Claude Code が初めてプロジェクト内の外部インポートを検出すると、ファイルをリストする承認ダイアログが表示されます。拒否した場合、インポートは無効のままになり、ダイアログは再度表示されません。149 プロジェクトレベルのメモリファイル内のインポートは、ホームディレクトリインポートのように、作業ディレクトリの外に解決されるパスを持つ場合、外部です。Claude Code が初めてプロジェクトで外部インポートを検出すると、ファイルをリストする承認ダイアログが表示されます。拒否すると、インポートは無効のままになり、ダイアログは再度表示されません。

140 150 

141 Claude Code はダイアログを表示して、共有プロジェクトに他の人がコミットしたファイルから保護します。`~/.claude/CLAUDE.md` および `~/.claude/rules/` などのユーザースコープメモリファイルは、あなたが自分で書いたファイルです。[Cowork](https://claude.com/product/cowork) セッションをデスクトップで実行している場合を除き、Claude Code はダイアログなしでそれらのインポートを読み込み、個人設定の残りの部分と同じように信頼します。151 Claude Code はダイアログを表示して、共有プロジェクトにコミットされた他の人のファイルから保護します。`~/.claude/CLAUDE.md` や `~/.claude/rules/` などのユーザースコープメモリファイルは、自分で書いたファイルです。[Cowork](https://claude.com/product/cowork) セッションをデスクトップで実行する場合を除き、Claude Code はダイアログなしでそれらのインポートをロードし、残りの個人設定のように信頼します。

142 152 

143 デスクトップの Cowork セッションでは、Claude Code はユーザースコープファイル内のセッションの作業ディレクトリの外に解決されるパスを持つインポートをスキップし、ファイルの残りを読み込みます。これらのセッションでは、シンボリックリンクまたはハードリンクである `~/.claude/CLAUDE.md` と、作業ディレクトリの外を指すシンボリックリンク `~/.claude/rules/` ディレクトリまたはルールファイルもスキップします。153 デスクトップの Cowork セッションでは、Claude Code はユーザースコープファイル内のセッションの作業ディレクトリの外に解決されるパスを持つインポートをスキップし、ファイルの残りをロードします。これらのセッションでは、シンリンクまたはハードリンクである `~/.claude/CLAUDE.md` と、作業ディレクトリの外を指すシンリンクされた `~/.claude/rules/` ディレクトリまたはルールファイルもスキップします。

144</Warning>154</Warning>

145 155 

146<h3 id="how-claude-md-files-load">156<h3 id="how-claude-md-files-load">

147 CLAUDE.md ファイルの読み込み方法157 CLAUDE.md ファイルのロード方法

148</h3>158</h3>

149 159 

150Claude Code は、現在の作業ディレクトリとそれより上のすべてのディレクトリから `CLAUDE.md` および `CLAUDE.local.md` を読み込みます。Claude Code を `foo/bar/` で実行すると、`foo/bar/CLAUDE.md`、`foo/CLAUDE.md`、およびそれらの横にある `CLAUDE.local.md` ファイルから指示を読み込みます。160Claude Code は、現在の作業ディレクトリとそれより上のすべてのディレクトリから `CLAUDE.md` と `CLAUDE.local.md` をロードします。`foo/bar/` で Claude Code を実行すると、`foo/bar/CLAUDE.md`、`foo/CLAUDE.md`、およびそれらと一緒にある `CLAUDE.local.md` ファイルから指示をロードします。

151 161 

152発見されたすべてのファイルは、互いにオーバーライドするのではなく、コンテキストに連結されます。ディレクトリツリー全体で、コンテンツはファイルシステムルートから作業ディレクトリまで順序付けられます。`foo/bar/` の例では、`foo/CLAUDE.md` は `foo/bar/CLAUDE.md` の前にコンテキストに表示されるため、Claude を起動した場所に近い指示が最後に読まれます。各ディレクトリ内では、`CLAUDE.local.md` は `CLAUDE.md` の後に追加されるため、個人的なメモはそのレベルで Claude が読む最後のものです。162発見されたすべてのファイルは、互いにオーバーライドするのではなく、コンテキストに連結されます。ディレクトリツリー全体で、コンテンツはファイルシステムルートから作業ディレクトリまで順序付けられます。`foo/bar/` の例では、`foo/CLAUDE.md` は `foo/bar/CLAUDE.md` の前にコンテキストに表示されるため、Claude を起動した場所に近い指示が最後に読まれます。各ディレクトリ内で、`CLAUDE.local.md` は `CLAUDE.md` の後に追加されるため、個人的なメモはそのレベルで Claude が読む最後のものです。

153 163 

154Claude はまた、現在の作業ディレクトリの下のサブディレクトリ内の `CLAUDE.md` および `CLAUDE.local.md` ファイルを発見します。起動時に読み込む代わりに、Claude がそれらのディレクトリ内のファイルを読むときに含まれます。164Claude はまた、現在の作業ディレクトリの下のサブディレクトリで `CLAUDE.md` と `CLAUDE.local.md` ファイルを発見します。起動時にロードするのではなく、Claude がそれらのサブディレクトリ内のファイルを読むときに含まれます。

155 165 

156大規模なモノレポで他のチームの CLAUDE.md ファイルが取得される場合は、[`claudeMdExcludes`](#exclude-specific-claude-md-files) を使用してそれらをスキップしてください。ルートおよびディレクトリごとの CLAUDE.md ファイルとルールの完全なレイアウトについては、[モノレポと大規模リポジトリ](/docs/ja/large-codebases) を参照してください。166大規模なモノレポで他のチームの CLAUDE.md ファイルが取得される場合は、[`claudeMdExcludes`](#exclude-specific-claude-md-files) を使用してそれらをスキップしてください。ルートおよびディレクトリごとの CLAUDE.md ファイルとルールの完全なレイアウトについては、[モノレポと大規模リポ](/docs/ja/large-codebases) を参照してください。

157 167 

158CLAUDE.md ファイル内のブロックレベル HTML コメント(`<!-- maintainer notes -->`)は、コンテンツが Claude のコンテキストに注入される前に削除されます。コンテキストトークンを費やさずに人間のメンテナーのためのメモを残すために使用してください。コードブロック内のコメントは保持されます。Read ツールで CLAUDE.md ファイルを直接開くと、コメントは表示されたままになります。168CLAUDE.md ファイル内のブロックレベル HTML コメント(`<!-- maintainer notes -->`)は、コンテンツが Claude のコンテキストに注入される前に削除されます。ファイルのコンテキストトークンを消費せずに、人間のメンテナーのためのメモを残すために使用してください。コードブロック内のコメントは保持されます。Read ツールで CLAUDE.md ファイルを直接開くと、コメントは表示されたままになります。

159 169 

160<h4 id="load-from-additional-directories">170<h4 id="load-from-additional-directories">

161 追加ディレクトリから読み込む171 追加ディレクトリからロードする

162</h4>172</h4>

163 173 

164`--add-dir` フラグは、メイン作業ディレクトリの外の追加ディレクトリへのアクセスを Claude に与えます。デフォルトでは、これらのディレクトリからの CLAUDE.md ファイルは読み込まれません。174`--add-dir` フラグは、メインの作業ディレクトリの外の追加ディレクトリに Claude がアクセスできるようにします。デフォルトでは、これらのディレクトリからのメモリファイルはロードされません。

165 175 

166追加ディレクトリからメモリファイルも読み込むには、`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` 環境変数を設定してください。176追加ディレクトリからメモリファイルもロードするには、`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` 環境変数を設定してください。

167 177 

168```bash theme={null}178```bash theme={null}

169CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config179CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

170```180```

171 181 

172インライン形式はその 1 回の起動に対して Bash または Zsh で変数を設定します。すべてのセッションで有効に保つには、[環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように `~/.claude/settings.json` の `env` ブロックに追加してください。182インライン形式は、Bash または Zsh でそのロンチに対して変数を設定します。すべてのセッションで有効にするには、[環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように `~/.claude/settings.json` の `env` ブロックに追加してください。

173 183 

174これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。[`--setting-sources`](/docs/ja/cli-reference) から `local` を除外した場合、`CLAUDE.local.md` はスキップされます。184これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` をロードします。`CLAUDE.local.md` は [`--setting-sources`](/docs/ja/cli-reference) から `local` を除外する場合はスキップされます。

175 185 

176<h3 id="organize-rules-with-claude/rules/">186<h3 id="organize-rules-with-claude/rules/">

177 `.claude/rules/` でルールを整理する187 `.claude/rules/` でルールを整理する

178</h3>188</h3>

179 189 

180大規模なプロジェクトの場合、`.claude/rules/` ディレクトリを使用して指示を複数のファイルに整理できます。これにより、指示がモジュール化され、チームが保守しやすくなります。ルールは [特定のファイルパスにスコープ](#path-specific-rules) することもできるため、Claude が一致するファイルで作業するときにのみコンテキストに読み込まれ、ノイズを減らしてコンテキストスペースを節約します。190大規模なプロジェクトの場合、`.claude/rules/` ディレクトリを使用して指示を複数のファイルに整理できます。これにより、指示がモジュール化され、チームが保守しやすくなります。ルールは [特定のファイルパスにスコープ](#path-specific-rules) することもできるため、Claude が一致するファイルで作業するときにのみコンテキストにロードされ、ノイズを減らしてコンテキストスペースを節約します。

181 191 

182<Note>192<Note>

183 ルールはすべてのセッションまたは一致するファイルが開かれたときにコンテキストに読み込まれます。タスク固有の指示で常にコンテキストに必要ない場合は、代わりに [スキル](/docs/ja/skills) を使用してください。これは呼び出すときまたは Claude がプロンプトに関連していると判断したときにのみ読み込まれます。193 ルールはすべてのセッションまたは一致するファイルが開かれるときにコンテキストにロードされます。タスク固有の指示で常にコンテキストに含まれる必要がない場合は、代わりに [スキル](/docs/ja/skills) を使用してください。これは、呼び出すときまたは Claude がプロンプトに関連していると判断したときにのみロードされます。

184</Note>194</Note>

185 195 

186<h4 id="set-up-rules">196<h4 id="set-up-rules">

187 ルールをセットアップする197 ルールをセットアップする

188</h4>198</h4>

189 199 

190プロジェクトの `.claude/rules/` ディレクトリにマークダウンファイルを配置してください。各ファイルは 1 つのトピックをカバーし、`testing.md` または `api-design.md` のような説明的なファイル名を持つべきです。すべての `.md` ファイルは再帰的に発見されるため、`frontend/` または `backend/` のようなサブディレクトリにルールを整理できます。200プロジェクトの `.claude/rules/` ディレクトリにマークダウンファイルを配置してください。各ファイルは 1 つのトピックをカバーし、`testing.md` や `api-design.md` のような説明的なファイル名を持つ必要があります。すべての `.md` ファイルは再帰的に発見されるため、`frontend/` や `backend/` のようなサブディレクトリにルールを整理できます。

191 201 

192```text theme={null}202```text theme={null}

193your-project/203your-project/


199│ └── security.md # Security requirements209│ └── security.md # Security requirements

200```210```

201 211 

202[`paths` frontmatter](#path-specific-rules) のないルールは、`.claude/CLAUDE.md` と同じ優先度で起動時に読み込まれます。212[`paths` frontmatter](#path-specific-rules) のないルールは、`.claude/CLAUDE.md` と同じ優先度で起動時にロードされます。

203 213 

204[`--setting-sources`](/docs/ja/cli-reference) から `project` を除外した場合、プロジェクトルールはスキップされます。v2.1.211 より前では、パススコープ付きルールやネストされた `.claude/rules/` ディレクトリ内のルールを含む、オンデマンドで読み込まれるルールは、`project` が除外されている場合でも読み込まれました。214[`--setting-sources`](/docs/ja/cli-reference) から `project` を除外する場合、プロジェクトルールはスキップされます。v2.1.211 より前では、パススコープ付きルールやネストされた `.claude/rules/` ディレクトリ内のルールを含む、オンデマンドでロードするルールは、`project` が除外されている場合でもロードされました。

205 215 

206<h4 id="path-specific-rules">216<h4 id="path-specific-rules">

207 パス固有のルール217 パススコープ付きルール

208</h4>218</h4>

209 219 

210ルールは YAML frontmatter の `paths` フィールドを使用して特定のファイルにスコープできます。これらの条件付きルールは、Claude が指定されたパターンに一致するファイルで作業するときにのみ適用されます。220ルールは YAML frontmatter と `paths` フィールドを使用して特定のファイルにスコープできます。これらの条件付きルールは、指定されたパターンに一致するファイルで Claude が作業するときにのみ適用されます。

211 221 

212```markdown theme={null}222```markdown theme={null}

213---223---


222- Include OpenAPI documentation comments232- Include OpenAPI documentation comments

223```233```

224 234 

225`paths` フィールドのないルールは無条件に読み込まれ、すべてのファイルに適用されます。パススコープ付きルールは、すべてのツール使用時ではなく、パターンに一致するファイルを読むときにトリガーされます。v2.1.198 の時点で、マッチングは Claude がシンボリックリンクされたパスを通じてファイルに到達するときにも機能します。例えば、プロジェクトディレクトリへのシンボリックリンクされたチェックアウト。235`paths` フィールドのないルールは無条件にロードされ、すべてのファイルに適用されます。パススコープ付きルールは、すべてのツール使用時ではなく、Claude がパターンに一致するファイルを読むときにトリガーされます。v2.1.198 の時点で、マッチングは Claude がシンリンクされたパスを通じてファイルに到達するときにも機能します。例えば、プロジェクトディレクトリへのシンリンクされたチェックアウト。

226 236 

227`paths` フィールドでグロブパターンを使用して、拡張子、ディレクトリ、またはそれらの任意の組み合わせでファイルをマッチしてください。237`paths` フィールドでグロブパターンを使用して、拡張子、ディレクトリ、またはそれらの組み合わせでファイルをマッチさせてください。

228 238 

229| パターン | マッチ |239| パターン | マッチ |

230| - | - |240| - | - |


233| `*.md` | プロジェクトルート内のマークダウンファイル |243| `*.md` | プロジェクトルート内のマークダウンファイル |

234| `src/components/*.tsx` | 特定のディレクトリ内の React コンポーネント |244| `src/components/*.tsx` | 特定のディレクトリ内の React コンポーネント |

235 245 

236複数のパターンを指定し、ブレース展開を使用して 1 つのパターンで複数の拡張子をマッチできます。246複数のパターンを指定し、ブレース展開を使用して 1 つのパターンで複数の拡張子をマッチさせることができます。

237 247 

238```markdown theme={null}248```markdown theme={null}

239---249---


246 256 

247各ブレースグループは展開されたパターンの数を乗算します。`src/*.{ts,tsx}` は 2 つのパターンに展開され、`{a,b}/{c,d}/*.{ts,tsx}` は 8 つに展開されます。展開を制限するために、ルール全体の `paths` リストは 1,000 展開パターンと 4 MiB の 1 つの予算を共有し、ブレースのないパターンはそれに対してカウントされません。257各ブレースグループは展開されたパターンの数を乗算します。`src/*.{ts,tsx}` は 2 つのパターンに展開され、`{a,b}/{c,d}/*.{ts,tsx}` は 8 つに展開されます。展開を制限するために、ルール全体の `paths` リストは 1,000 展開パターンと 4 MiB の 1 つの予算を共有し、ブレースのないパターンはそれに対してカウントされません。

248 258 

249Claude Code は予算を超えるパターンを展開されていない状態で使用し、その文字通りのブレースはファイルをマッチしません。v2.1.217 より前では、多くのブレースグループを持つ `paths` 値は起動時に CLI をスタールまたはクラッシュさせました。259Claude Code は予算を超えるパターンを展開されていない状態で使用し、その文字通りのブレースはファイルをマッチさせません。v2.1.217 より前では、多くのブレースグループを持つ `paths` 値は起動時に CLI をスタールまたはクラッシュさせました。

250 260 

251グロブ構文は `[` をブラケット式(`[abc]` など)の開始として扱います。`photos [2024/**` のようにブラケット式として読めない `[` を持つパターンは無効です。何もマッチしず、ルールの他のパターンは機能し続けます。ファイル名内のリテラル `[` をマッチするには、`photos \[2024/**` としてエスケープしてください。v2.1.207 より前では、1 つの無効なパターンは、マッチしない代わりに、ルールが評価されたすべてのファイルに対して Read ツールを失敗させました。261グロブ構文は `[` をブラケット式(`[abc]` など)の開始として扱います。`photos [2024/**` のようにブラケット式として読むことができない `[` を持つパターンは無効です。何もマッチせず、ルールの他のパターンは機能し続けます。ファイル名内のリテラル `[` をマッチさせるには、`photos \[2024/**` のようにエスケープしてください。v2.1.207 より前では、1 つの無効なパターンは、マッチングなしではなく、ルールが評価されたすべてのファイルに対して Read ツールを失敗させました。

252 262 

253<h4 id="rules-frontmatter-reference">263<h4 id="rules-frontmatter-reference">

254 ルール frontmatter リファレンス264 ルール frontmatter リファレンス

255</h4>265</h4>

256 266 

257YAML [frontmatter](/docs/ja/glossary#frontmatter) を使用してルールを設定してください。`---` マーカーの間に配置します。`paths` は Claude Code が読み取る唯一のフィールドです。その他のフィールドはエラーなしで無視されます。Claude Code はルールをコンテキストに読み込む前に frontmatter を削除します。267YAML [frontmatter](/docs/ja/glossary#frontmatter) を使用してルールを設定します。`---` マーカーの間のファイルの上部。`paths` は Claude Code が読む唯一のフィールドです。他のフィールドはエラーなしで無視されます。Claude Code はルールをコンテキストにロードする前に frontmatter を削除します。

258 268 

259| フィールド | 必須 | 説明 |269| フィールド | 必須 | 説明 |

260| :- | :- | :- |270| :- | :- | :- |

261| `paths` | いいえ | [ルールを一致するファイルにスコープする](#path-specific-rules) グロブパターン。YAML リストまたはカンマ区切り文字列を受け入れます |271| `paths` | いいえ | [ルールを一致するファイルにスコープする](#path-specific-rules) グロブパターン。YAML リストまたはカンマ区切り文字列を受け入れます |

262 272 

263マーカー間の YAML が解析されない場合、Claude Code は frontmatter を無視し、`paths` がないかのようにルールを読み込みます。`claude --debug` を実行して解析エラーを確認してください。273マーカー間の YAML が解析されない場合、Claude Code は frontmatter を無視し、`paths` がないかのようにルールをロードします。`claude --debug` を実行してパース エラーを確認してください。

264 274 

265<h4 id="share-rules-across-projects-with-symlinks">275<h4 id="share-rules-across-projects-with-symlinks">

266 シンボリックリンクでプロジェクト全体でルールを共有する276 シンリンクを使用してプロジェクト全体でルールを共有する

267</h4>277</h4>

268 278 

269`.claude/rules/` ディレクトリはシンボリックリンクをサポートしているため、共有ルールセットを保持し、複数のプロジェクトにリンクできます。循環シンボリックリンクは検出され、適切に処理されます。279`.claude/rules/` ディレクトリはシンリンクをサポートしているため、共有ルールセットを保持し、複数のプロジェクトにリンクできます。循環シンリンクは検出され、適切に処理されます。

270 280 

271Claude Code は、ターゲットが作業ディレクトリの外にあるシンボリックリンクを [外部インポート](#import-additional-files) のように扱います。リンクされたルールは、プロジェクトの外部インポートを承認するまで読み込まれず、その後は [`paths` フィールド](#path-specific-rules) のないものだけが読み込まれます。Claude Code は、`@path` でファイルをディレクトリの外にインポートするプロジェクトメモリファイルに対してのみ承認を求め、シンボリックリンク単独に対しては求めません。その承認なしで共有ルールを読み込むには、[`~/.claude/rules/`](#user-level-rules) に保持してください。ここでは、マシン上のすべてのプロジェクトに適用されます。281Claude Code は、ターゲットが作業ディレクトリの外にあるシンリンクを [外部インポート](#import-additional-files) のように扱います。リンクされたルールは、プロジェクトの外部インポートを承認するまでロードされず、その後は [`paths` フィールド](#path-specific-rules) のないものだけがロードされます。Claude Code は、プロジェクトメモリファイルが `@path` でディレクトリの外のファイルをインポートするときではなく、シンリンク単独ではなく、その承認を求めます。承認なしで共有ルールをロードするには、[`~/.claude/rules/`](#user-level-rules) に保持してください。ここで、マシン上のすべてのプロジェクトに適用されます。

272 282 

273この例は、共有ディレクトリと個別ファイルの両方をリンクしています。283この例は、共有ディレクトリと個別ファイルの両方をリンクします。

274 284 

275```bash theme={null}285```bash theme={null}

276ln -s ~/shared-claude-rules .claude/rules/shared286ln -s ~/shared-claude-rules .claude/rules/shared

277ln -s ~/company-standards/security.md .claude/rules/security.md287ln -s ~/company-standards/security.md .claude/rules/security.md

278```288```

279 289 

280`.claude/rules/` またはシンボリックリンク `CLAUDE.md` を `\\server\share` のような UNC 共有またはパス `/net` または `/Network` の下のネットワークパスに指す場合、リンクされた指示は読み込まれません。Claude Code はリンクをフォローしません。そのようなパスを検索すると、それが名前を付けるホストに接続できるためです。`\\wsl$` パスはネットワークパスとしてカウントされません。290`.claude/rules/` または `CLAUDE.md` シンリンクを `\\server\share` のような UNC 共有またはパス `/net` または `/Network` の下のネットワークパスに指す場合、リンクされた指示はロードされません。Claude Code はリンクに従いません。そのようなパスを検索すると、それが名前を付けるホストに接続できるためです。`\\wsl$` パスはネットワークパスとしてカウントされません。

281 291 

282<h4 id="user-level-rules">292<h4 id="user-level-rules">

283 ユーザーレベルのルール293 ユーザーレベルルール

284</h4>294</h4>

285 295 

286`~/.claude/rules/` 内の個人的なルールはマシン上のすべてのプロジェクトに適用されます。プロジェクト固有ではない設定に使用してください。296`~/.claude/rules/` の個人的なルールはマシン上のすべてのプロジェクトに適用されます。プロジェクト固有ではない設定に使用してください。

287 297 

288```text theme={null}298```text theme={null}

289~/.claude/rules/299~/.claude/rules/


291└── workflows.md # Your preferred workflows301└── workflows.md # Your preferred workflows

292```302```

293 303 

294ユーザーレベルのルールはプロジェクトルールの前に読み込まれるため、プロジェクトルールは Claude のコンテキストでユーザールールより後に表示されます。どちらのセットも他方をオーバーライドしません。ユーザールールとプロジェクトルールが矛盾する場合、Claude はどちらか一方に従う可能性があるため、2 つを一貫性のあるものに保ってください。304Claude Code はプロジェクトルールの前にユーザーレベルルールをロードするため、プロジェクトルールはユーザールールより後に Claude のコンテキストに表示されます。どちらのセットも他をオーバーライドしません。ユーザールールとプロジェクトルールが矛盾する場合、Claude はどちらかに従う可能性があるため、2 つを一貫性のあるものに保ってください。

295 305 

296<h3 id="manage-claude-md-for-large-teams">306<h3 id="manage-claude-md-for-large-teams">

297 大規模なチーム向けに CLAUDE.md を管理する307 大規模なチーム向けに CLAUDE.md を管理する

298</h3>308</h3>

299 309 

300Claude Code をチーム全体にデプロイする組織の場合、指示を一元化し、どの CLAUDE.md ファイルが読み込まれるかを制御できます。310Claude Code を複数のチームにデプロイする組織の場合、指示を一元化し、どの CLAUDE.md ファイルがロードされるかを制御できます。

301 311 

302<h4 id="deploy-organization-wide-claude-md">312<h4 id="deploy-organization-wide-claude-md">

303 組織全体の CLAUDE.md をデプロイする313 組織全体の CLAUDE.md をデプロイする


306組織は、マシン上のすべてのユーザーに適用される一元管理の CLAUDE.md をデプロイできます。このファイルは個別の設定で除外することはできません。316組織は、マシン上のすべてのユーザーに適用される一元管理の CLAUDE.md をデプロイできます。このファイルは個別の設定で除外することはできません。

307 317 

308<Steps>318<Steps>

309 <Step title="Create the file at the managed policy location">319 <Step title="管理ポリシーの場所にファイルを作成する">

310 * macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`320 * macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`

311 * Linux と WSL: `/etc/claude-code/CLAUDE.md`321 * Linux と WSL: `/etc/claude-code/CLAUDE.md`

312 * Windows: `C:\Program Files\ClaudeCode\CLAUDE.md`322 * Windows: `C:\Program Files\ClaudeCode\CLAUDE.md`

313 </Step>323 </Step>

314 324 

315 <Step title="Deploy with your configuration management system">325 <Step title="設定管理システムでデプロイする">

316 MDM、グループポリシー、Ansible、または同様のツールを使用して、開発者マシン全体にファイルを配布してください。その他の組織全体の設定オプションについては、[管理設定](/docs/ja/managed-settings) を参照してください。326 MDM、グループポリシー、Ansible、または同様のツールを使用して、開発者マシン全体にファイルを配布してください。その他の組織全体の設定オプションについては、[管理設定](/docs/ja/managed-settings) を参照してください。

317 </Step>327 </Step>

318</Steps>328</Steps>

319 329 

320`claudeMd` キーを使用すると、別のファイルをデプロイする代わりに、管理された CLAUDE.md コンテンツを `managed-settings.json` 内に直接配置できます。330`claudeMd` キーを使用すると、別のファイルをデプロイする代わりに、管理された CLAUDE.md コンテンツを `managed-settings.json` に直接配置できます。

321 331 

322**スコープ**: マシン上のすべての Claude Code セッション、すべてのリポジトリ内。リポジトリ固有のガイダンスについては、プロジェクト CLAUDE.md をコミットしてください。332**スコープ**: マシン上のすべての Claude Code セッション、すべてのリポジトリで。リポジトリ固有のガイダンスについては、プロジェクト CLAUDE.md をコミットしてください。

323 333 

324**優先度**: 管理された CLAUDE.md ファイルと同じ。ユーザーおよびプロジェクト CLAUDE.md の前に読み込まれます。334**優先度**: 管理された CLAUDE.md ファイルと同じ。ユーザーおよびプロジェクト CLAUDE.md の前にロードされます。

325 335 

326**どこで尊重されるか**: 管理および管理ポリシー設定のみ。ユーザー、プロジェクト、またはローカル設定で `claudeMd` を設定しても効果がありません。336**どこで尊重されるか**: 管理および ポリシー設定のみ。ユーザー、プロジェクト、またはローカル設定で `claudeMd` を設定しても効果がありません。

327 337 

328以下の例は、管理設定ファイル内に直接動作指示を追加します。338以下の例は、管理設定ファイルに直接動作指示を追加します。

329 339 

330```json theme={null}340```json theme={null}

331{341{


337 347 

338| 懸念事項 | 設定対象 |348| 懸念事項 | 設定対象 |

339| :- | :- |349| :- | :- |

340| 特定のツール、コマンド、またはファイルパスをブロック | 管理設定: `permissions.deny` |350| 特定のツール、コマンド、またはファイルパスをブロックする | 管理設定: `permissions.deny` |

341| サンドボックス分離を強制 | 管理設定: `sandbox.enabled` |351| サンドボックス分離を強制する | 管理設定: `sandbox.enabled` |

342| 環境変数と API プロバイダーのルーティング | 管理設定: `env` |352| 環境変数と API プロバイダーのルーティング | 管理設定: `env` |

343| ログイン方法と組織制限 | 管理設定: `forceLoginMethod`、`forceLoginOrgUUID` |353| ログイン方法と組織の制限 | 管理設定: `forceLoginMethod`、`forceLoginOrgUUID` |

344| コードスタイルと品質ガイドライン | 管理 CLAUDE.md |354| コードスタイルと品質ガイドライン | 管理 CLAUDE.md |

345| データ処理とコンプライアンスのリマインダー | 管理 CLAUDE.md |355| データ処理とコンプライアンスのリマインダー | 管理 CLAUDE.md |

346| Claude の動作指示 | 管理 CLAUDE.md |356| Claude の動作指示 | 管理 CLAUDE.md |

347 357 

348設定ルールは、Claude が何をするかに関係なく、クライアントによって強制されます。CLAUDE.md 指示は Claude の動作を形作りますが、ハード強制レイヤーではありません。358設定ルールは、Claude が何をするかに関わらず、クライアントによって強制されます。CLAUDE.md 指示は Claude の動作を形作りますが、ハード強制レイヤーではありません。

349 359 

350<h4 id="exclude-specific-claude-md-files">360<h4 id="exclude-specific-claude-md-files">

351 特定の CLAUDE.md ファイルを除外する361 特定の CLAUDE.md ファイルを除外する

352</h4>362</h4>

353 363 

354大規模なモノレポでは、祖先 CLAUDE.md ファイルに、作業に関連のない指示が含まれている可能性があります。`claudeMdExcludes` 設定を使用すると、パスまたはグロブパターンで特定のファイルをスキップできます。364大規模なモノレポでは、祖先の CLAUDE.md ファイルに、作業に関連しない指示が含まれている可能性があります。`claudeMdExcludes` 設定を使用すると、パスまたはグロブパターンで特定のファイルをスキップできます。

355 365 

356この例は、トップレベルの CLAUDE.md と親フォルダのルールディレクトリを除外します。`.claude/settings.local.json` に追加して、除外をマシンにローカルに保つようにしてください。366この例は、トップレベルの CLAUDE.md と親フォルダのルールディレクトリを除外します。`.claude/settings.local.json` に追加して、除外をマシンにローカルに保ってください。

357 367 

358```json theme={null}368```json theme={null}

359{369{


364}374}

365```375```

366 376 

367パターンはグロブ構文を使用して絶対ファイルパスに対してマッチされます。`claudeMdExcludes` は任意の [設定レイヤー](/docs/ja/settings#where-settings-live) で設定できます。ユーザー、プロジェクト、ローカル、または管理ポリシー。配列はレイヤー全体でマージされます。377パターンは、グロブ構文を使用して絶対ファイルパスに対してマッチされます。`claudeMdExcludes` は任意の [設定レイヤー](/docs/ja/settings#where-settings-live) で設定できます。ユーザー、プロジェクト、ローカル、または管理ポリシー。配列はレイヤー全体でマージされます。

368 378 

369[シンボリックリンク](#share-rules-across-projects-with-symlinks) を通じて到達するルールファイルを除外するには、ファイルまたはそのディレクトリがリンクであるかどうかに関わらず、パスに対してパターンを書いてください。`.claude/rules/` の下のファイルのパスまたはそのリンクターゲット。パターンがいずれかのパスに一致する場合、ファイルは除外されます。v2.1.239 より前では、リンクターゲットに一致するパターンのみがファイルを除外しました。379[シンリンク](#share-rules-across-projects-with-symlinks) を通じて到達するルールファイルを除外するには、ファイルまたはそのディレクトリがリンクであるかどうかに関わらず、いずれかのパスに対してパターンを記述してください。`.claude/rules/` の下のファイルのパスまたはそのリンクターゲット。どちらかのパスに一致するパターンはファイルを除外します。v2.1.239 より前では、リンクターゲットに一致するパターンのみがファイルを除外しました。

370 380 

371管理ポリシー CLAUDE.md ファイルは除外できません。これにより、個別の設定に関係なく、組織全体の指示が常に適用されることが保証されます。381管理ポリシー CLAUDE.md ファイルは除外できません。これにより、個別の設定に関わらず、組織全体の指示が常に適用されることが保証されます。

372 382 

373<h2 id="agents-md">383<h2 id="agents-md">

374 AGENTS.md384 AGENTS.md

Details

64}64}

65```65```

66 66 

67Claude Desktop アプリでは、Code タブセッションは[各種 Desktop セッションに到達する](/docs/ja/desktop#managed-settings)ソースからこれらの管理設定を読み込みます。管理コンソールの[データとプライバシー設定](https://claude.ai/admin-settings/data-privacy-controls)の**監視**下にある Cowork の OpenTelemetry フォームは Cowork セッションのみに適用されるため、ターミナル CLI も Code タブも、そこで設定したコレクターにはエクスポートしません。

68 

67Claude Code は、リポジトリの `.claude/settings.json` と `.claude/settings.local.json` の [OpenTelemetry エクスポーター変数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を無視するため、リポジトリはそれらを使用してテレメトリをオンにしたり、送信先を選択したり、コンテンツをキャプチャしたりすることはできません。管理設定で設定するか、各開発者がシェルまたは `~/.claude/settings.json` で設定してください。リポジトリは、`OTEL_LOGS_EXPORTER` などのエクスポーターセレクターを `none` に設定することでシグナルをオフにすることはできますが、管理設定、`--settings` ファイル、または Claude Code を起動する環境がその変数を設定している場合を除きます。69Claude Code は、リポジトリの `.claude/settings.json` と `.claude/settings.local.json` の [OpenTelemetry エクスポーター変数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を無視するため、リポジトリはそれらを使用してテレメトリをオンにしたり、送信先を選択したり、コンテンツをキャプチャしたりすることはできません。管理設定で設定するか、各開発者がシェルまたは `~/.claude/settings.json` で設定してください。リポジトリは、`OTEL_LOGS_EXPORTER` などのエクスポーターセレクターを `none` に設定することでシグナルをオフにすることはできますが、管理設定、`--settings` ファイル、または Claude Code を起動する環境がその変数を設定している場合を除きます。

68 70 

69Claude Code は、Bash ツール、フック、MCP サーバー、言語サーバーを含む、生成するサブプロセスに `OTEL_*` 環境変数を渡しません。OpenTelemetry でインストルメント化されたアプリケーションを Bash ツール経由で実行する場合、Claude Code のエクスポーターエンドポイントまたはヘッダーを継承しないため、そのアプリケーションが独自のテレメトリをエクスポートする必要がある場合は、コマンド内でこれらの変数を直接設定してください。71Claude Code は、Bash ツール、フック、MCP サーバー、言語サーバーを含む、生成するサブプロセスに `OTEL_*` 環境変数を渡しません。OpenTelemetry でインストルメント化されたアプリケーションを Bash ツール経由で実行する場合、Claude Code のエクスポーターエンドポイントまたはヘッダーを継承しないため、そのアプリケーションが独自のテレメトリをエクスポートする必要がある場合は、コマンド内でこれらの変数を直接設定してください。


584 586 

585Claude Code が[Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)にサインインしている場合、CLI はゲートウェイセッションの認証済みアイデンティティでエクスポートをスタンプします。`user.id` は匿名インストール識別子ではなく IdP サブジェクト、`user.email` はサインイン済みメール、`user.groups` は IdP グループメンバーシップをカンマ区切り文字列として保持します。各エクスポートは `identity.source: gateway-oidc` も保持します。ゲートウェイアイデンティティは最後に適用されるため、`OTEL_RESOURCE_ATTRIBUTES` を通じて設定された `user.*` および `identity.*` キーはゲートウェイセッションで無視されます。587Claude Code が[Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)にサインインしている場合、CLI はゲートウェイセッションの認証済みアイデンティティでエクスポートをスタンプします。`user.id` は匿名インストール識別子ではなく IdP サブジェクト、`user.email` はサインイン済みメール、`user.groups` は IdP グループメンバーシップをカンマ区切り文字列として保持します。各エクスポートは `identity.source: gateway-oidc` も保持します。ゲートウェイアイデンティティは最後に適用されるため、`OTEL_RESOURCE_ATTRIBUTES` を通じて設定された `user.*` および `identity.*` キーはゲートウェイセッションで無視されます。

586 588 

589Claude Desktop および Cowork セッションがゲートウェイ経由で接続する場合のアイデンティティ属性については、[ゲートウェイ `telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)を参照してください。

590 

587イベントには、以下の追加属性が含まれます。これらはメトリクスに添付されることはありません。無制限のカーディナリティを引き起こすためです。591イベントには、以下の追加属性が含まれます。これらはメトリクスに添付されることはありません。無制限のカーディナリティを引き起こすためです。

588 592 

589* `prompt.id`: ユーザープロンプトと、次のプロンプトまでのすべての後続イベントを相関させる UUID。[イベント相関属性](#event-correlation-attributes)を参照。593* `prompt.id`: ユーザープロンプトと、次のプロンプトまでのすべての後続イベントを相関させる UUID。[イベント相関属性](#event-correlation-attributes)を参照。


1540 属性アクションをユーザーに関連付ける1544 属性アクションをユーザーに関連付ける

1541</h3>1545</h3>

1542 1546 

1543各イベントの [標準属性](#standard-attributes) には、認証されたユーザーの ID が含まれます:Claude アカウントでサインインしている場合は `user.email`、`user.account_uuid`、`user.account_id`、および `organization.id`、さらに [クラウドセッション](/docs/ja/claude-code-on-the-web) では、セッション自体の認証情報がそれらを持つ場合、`user.id` とセッションごとの `session.id`。`user.id` はインストールスコープの識別子です。ただし、[Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは、ゲートウェイが発行したトークンからの IdP サブジェクトです。1547各イベントの [標準属性](#standard-attributes) には、認証されたユーザーの ID が含まれます:Claude アカウントでサインインしている場合は `user.email`、`user.account_uuid`、`user.account_id`、および `organization.id`、さらに [クラウドセッション](/docs/ja/claude-code-on-the-web) では、セッション自体の認証情報がそれらを持つ場合、`user.id` とセッションごとの `session.id`。`user.id` はインストールスコープの識別子です。ただし、[Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは `/login` を通じてサインインしている場合、ゲートウェイが発行したトークンからの IdP サブジェクトです。

1544 1548 

1545開発者が開始したセッションでは、MCP ツール呼び出し、Bash コマンド、ファイル編集はその開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでの開発者の IdP ID です。Claude Tag チャネルセッションでは、Claude はあなたの組織の [共有 ID](/docs/ja/cloud-environments#set-the-environment-a-claude-tag-channel-uses) として機能します。1549開発者が開始したセッションでは、MCP ツール呼び出し、Bash コマンド、ファイル編集はその開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでの開発者の IdP ID です。Claude Tag チャネルセッションでは、Claude はあなたの組織の [共有 ID](/docs/ja/cloud-environments#set-the-environment-a-claude-tag-channel-uses) として機能します。

1546 1550 

1547Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、`user.id` と `session.id` のみが入力されます。これらのデプロイメントでは、`OTEL_RESOURCE_ATTRIBUTES` を使用してユーザー ID を自分で添付し、[管理設定](#administrator-configuration) ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません:CLI は [標準属性](#standard-attributes) で説明されているように、IdP ID を自動的にスタンプします。1551Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、`user.id` と `session.id` のみが入力されます。これらのデプロイメントでは、`OTEL_RESOURCE_ATTRIBUTES` を使用してユーザー ID を自分で添付し、[管理設定](#administrator-configuration) ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません:[標準属性](#standard-attributes) を参照して、それらのエクスポートが持つ ID を確認してください。

1548 1552 

1549```bash theme={null}1553```bash theme={null}

1550export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."1554export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."

network-config.md +14 −12

Details

203 ストリーミングアイドルウォッチドッグ203 ストリーミングアイドルウォッチドッグ

204</h2>204</h2>

205 205 

206Claude Code は 4 つの独立したタイマーを実行し、ストリーミングモデルレスポンスが静止状態になるとそれを中止するため、接続が切れた場合はハングするのではなく失敗して再試行します。最初のバイト期限はレスポンスヘッダーの到着を待つ間をカバーし、レスポンスが到着する前です。他の 3 つのそれぞれは、異なるシグナルについてライブレスポンスを監視します。206Claude Code は 4 つの独立したタイマーを実行し、ストリーミングモデルレスポンスが静止状態になるとそれを中止するため、接続が切れた場合はハングするのではなく失敗して再試行されます。最初のバイト期限はレスポンスヘッダーの到着を待つ間をカバーし、レスポンスが到着する前です。他の 3 つのタイマーはそれぞれ、ライブレスポンスの異なるシグナルを監視します。

207 207 

208| タイマー | 中止する条件 | 実行対象 | デフォルトタイムアウト |208| タイマー | 中止する条件 | 実行対象 | デフォルトタイムアウト |

209| :- | :- | :- | :- |209| :- | :- | :- | :- |

210| 最初のバイト期限 | Claude Code がリクエストを送信した後、レスポンスヘッダーが到着しない | Anthropic API 直接接続および [AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)(HTTPS プロキシ経由を含む)。ただし `ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` が [ゲートウェイ](/docs/ja/gateways) を経由する場合は除外。Amazon Bedrock では `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトイン。Google Cloud の Agent Platform または Microsoft Foundry では実行されない | Anthropic API 直接接続では 180 秒、その他では 300 秒、加えてリクエストボディの 32KB あたり 1 秒 |210| 最初のバイト期限 | Claude Code がリクエストを送信した後、レスポンスヘッダーが到着しない | 直接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws)(HTTPS プロキシを含む)。ただし、`ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` が [gateway](/docs/ja/gateways) を経由する場合は除外。Amazon Bedrock では `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトイン。Google Cloud の Agent Platform または Microsoft Foundry では実行されない | 直接 Anthropic API では 180 秒、その他では 300 秒、加えてリクエストボディの 32KB ごとに 1 秒 |

211| イベントレベルウォッチドッグ | レスポンスイベントが解析されない。バイトレベルウォッチドッグが実行される接続では、キープアライブピングを含む到着バイトもこのウォッチドッグをリセットし、解析されたイベントがない状態で約 5 分間実行される | すべてのプロバイダー | 300 秒 |211| イベントレベルウォッチドッグ | レスポンスイベントが解析されない。バイトレベルウォッチドッグが Amazon Bedrock 以外の接続で実行される場合、キープアライブピングを含む到着バイトもこのウォッチドッグをリセットし、解析されたイベントがない状態で約 5 分間まで実行される | すべてのプロバイダー | 300 秒 |

212| バイトレベルウォッチドッグ | SSE キープアライブピングを含む、ネットワーク上にバイトが到着しない | Anthropic API 直接接続、[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)、および [ゲートウェイ](/docs/ja/gateways) 接続(カスタム `ANTHROPIC_BASE_URL` を含む)。Amazon Bedrock `vnd.amazon.eventstream` レスポンスでは `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトイン。Google Cloud の Agent Platform または Microsoft Foundry では実行されない | Anthropic API 直接接続では 180 秒、その他では 300 秒 |212| バイトレベルウォッチドッグ | ワイヤー上にバイトが到着しない(SSE キープアライブピングを含む) | 直接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [gateway](/docs/ja/gateways) 接続(カスタム `ANTHROPIC_BASE_URL` を含む)。Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでは `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` でオプトイン。Google Cloud の Agent Platform または Microsoft Foundry では実行されない | 直接 Anthropic API では 180 秒、その他では 300 秒 |

213| ボディアイドルタイムアウト | 5 分間バイトが到着しない | Anthropic API 直接接続および AWS 上の Claude Platform 以外のプロバイダー。[`API_FORCE_IDLE_TIMEOUT`](/docs/ja/env-vars) で変更される場合を除く | 5 分 |213| ボディアイドルタイムアウト | 5 分間バイトが到着しない | 直接 Anthropic API、Claude Platform on AWS、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダー。ただし、[`API_FORCE_IDLE_TIMEOUT`](/docs/ja/env-vars) がこれを変更する場合は除外 | 5 分 |

214 214 

215これらの変数でタイマーを設定します。各変数の詳細は [環境変数リファレンス](/docs/ja/env-vars) に記載されています。215`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` を設定した場合、バイトレベルウォッチドッグは Bedrock のボディアイドルタイムアウトを置き換え、並行して実行されるのではなく実行されます。その後、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` は Bedrock ストリームが接続を切断されたものとして扱われるまで静止状態を保つことができる期間も制御し、以下にリストされた制限内です。到着バイトは Bedrock のイベントレベルウォッチドッグをリセットしません。デバッグログが有効な場合、各 Bedrock ストリームは `wire-heartbeat: _chunkTimes absent` で始まるデバッグメッセージをログに記録します。

216 216 

217* `CLAUDE_ENABLE_STREAM_WATCHDOG` および `CLAUDE_ENABLE_BYTE_WATCHDOG` は、テーブルに記載されている接続内で、`1` で対応するウォッチドッグをオンにするか、`0` でオフにします。どちらの変数もウォッチドッグをカバーしていない接続タイプに拡張することはありません。`CLAUDE_ENABLE_BYTE_WATCHDOG` を `0` に設定すると、最初のバイト期限もオフになります。217これらの変数を使用してタイマーを設定します。各変数の詳細は [環境変数リファレンス](/docs/ja/env-vars) に記載されています。

218 

219* `CLAUDE_ENABLE_STREAM_WATCHDOG` および `CLAUDE_ENABLE_BYTE_WATCHDOG` は、テーブルにリストされている接続内で、対応するウォッチドッグを `1` でオンまたは `0` でオフに強制します。どちらの変数もウォッチドッグをカバーしていない接続タイプに拡張しません。`CLAUDE_ENABLE_BYTE_WATCHDOG` を `0` に設定すると、最初のバイト期限もオフになります。

218* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` は両方のウォッチドッグのタイムアウトを設定します。Claude Code は 5 分未満の値を 5 分に引き上げ、バイトレベルウォッチドッグの値を 30 分でキャップします。220* `CLAUDE_STREAM_IDLE_TIMEOUT_MS` は両方のウォッチドッグのタイムアウトを設定します。Claude Code は 5 分未満の値を 5 分に引き上げ、バイトレベルウォッチドッグの値を 30 分でキャップします。

219* `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` はイベントレベルウォッチドッグを変更せずにバイトレベルウォッチドッグのタイムアウトを設定し、10 秒から 30 分の間にクランプされ、そのウォッチドッグについて `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先されます。221* `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` はイベントレベルウォッチドッグを変更せずにバイトレベルウォッチドッグのタイムアウトを設定し、10 秒から 30 分の間にクランプされ、そのウォッチドッグについて `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先されます。

220* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` は最初のバイト期限を直接設定します。設定しないままにすると、Claude Code はバイトレベルウォッチドッグのタイムアウトを使用するため、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` および `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` も期限を変更します。クランプ、アップロード許容量、`API_TIMEOUT_MS` キャップ、および応答なし中止後の再試行待機時間については、[API からの応答なし](/docs/ja/errors#no-response-from-api) を参照してください。222* `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` は最初のバイト期限を直接設定します。設定しないままにすると、Claude Code はバイトレベルウォッチドッグのタイムアウトを使用するため、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` および `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` も期限を変更します。クランプ、アップロード許容量、`API_TIMEOUT_MS` キャップ、および no-response 中止後の再試行待機時間については、[API からのレスポンスなし](/docs/ja/errors#no-response-from-api) を参照してください。

221* `API_FORCE_IDLE_TIMEOUT` を `0` に設定するとボディアイドルタイムアウトがオフになり、`1` に設定するとすべてのプロバイダーでオンになります。ウォッチドッグはそれとは独立して実行されるため、ストリームをそれらのしきい値より長く一時停止させるには、それらも引き上げるか無効にしてください。223* `API_FORCE_IDLE_TIMEOUT` を `0` に設定するとボディアイドルタイムアウトがオフになり、`1` に設定するとすべてのプロバイダーでオンになります。ウォッチドッグはそれとは独立して実行されるため、ストリームをそれらのしきい値より長く一時停止させるには、それらも引き上げるか無効にしてください。

222 224 

223ウォッチドッグが停止したストリームを中止すると、Claude Code は中止を中流の失敗として扱い、表示される内容はレスポンスがどこまで進んだかによって異なります。Claude Code はリクエストを再試行するか、エラーでターンを終了し、完了した出力を保持して [不完全なレスポンス通知](/docs/ja/errors#the-response-above-may-be-incomplete) を表示するか、ターンを正常に終了します。[自動再試行](/docs/ja/errors#automatic-retries) は各結果がどこに適用されるかを説明しています。225ウォッチドッグが停止したストリームを中止すると、Claude Code は中止を mid-stream 失敗として扱い、表示される内容はレスポンスがどこまで進んだかによって異なります。Claude Code はリクエストを再試行するか、エラーで ターンを終了し、完了した出力を保持して [不完全なレスポンス通知](/docs/ja/errors#the-response-above-may-be-incomplete) を表示するか、ターンを正常に終了します。[自動再試行](/docs/ja/errors#automatic-retries) は各結果がどこに適用されるかを説明しています。

224 226 

225[非対話型セッション](/docs/ja/headless) では、および任意のセッションでサブエージェントのレスポンスについては、Claude Code は最初に Claude にカットオフレスポンスを続行するよう促す場合があります。[その通知のエントリ](/docs/ja/errors#the-response-above-may-be-incomplete) は、それがいつ行われるか、およびいつ通知がまだ表示されるかを説明しています。227[非対話型セッション](/docs/ja/headless) では、およびいかなるセッションでもサブエージェントのレスポンスについて、Claude Code は最初に Claude にカットオフレスポンスを続行するよう促す場合があります。[その通知のエントリ](/docs/ja/errors#the-response-above-may-be-incomplete) は、それがいつ行われるか、およびいつ通知が表示されるかを説明しています。

226 228 

227最初のバイト期限が発火すると、レスポンスが開始されていないため、保持する部分的な出力はありません。Claude Code がリクエストを再送信する方法と、ターンが代わりに終了する場合については、[API からの応答なし](/docs/ja/errors#no-response-from-api) を参照してください。229最初のバイト期限が発火すると、レスポンスが開始されていないため、保持する部分的な出力はありません。Claude Code がリクエストを再送信する方法と、ターンが代わりに終了する場合については、[API からのレスポンスなし](/docs/ja/errors#no-response-from-api) を参照してください。

228 230 

229<h2 id="network-access-requirements">231<h2 id="network-access-requirements">

230 ネットワークアクセス要件232 ネットワークアクセス要件


277 279 

278GitHub Enterprise Cloud 組織が IP アドレスでアクセスを制限している場合、[インストール済み GitHub Apps の IP ホワイトリスト継承を有効にし](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)、Anthropic の[アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)の[ホワイトリストエントリを追加](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)してください。継承は Claude GitHub App がインストールとして行うリクエストのみをカバーし、ユーザーの代わりに行うリクエストはカバーしません。他のファイアウォールについては、[Anthropic API IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses)を参照してください。280GitHub Enterprise Cloud 組織が IP アドレスでアクセスを制限している場合、[インストール済み GitHub Apps の IP ホワイトリスト継承を有効にし](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)、Anthropic の[アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)の[ホワイトリストエントリを追加](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)してください。継承は Claude GitHub App がインストールとして行うリクエストのみをカバーし、ユーザーの代わりに行うリクエストはカバーしません。他のファイアウォールについては、[Anthropic API IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses)を参照してください。

279 281 

280ファイアウォールの背後にある自己ホスト [GitHub Enterprise Server](/docs/ja/github-enterprise-server) インスタンスの場合、Anthropic の[アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)をホワイトリストに登録して、Anthropic インフラストラクチャが GHES ホストに到達してリポジトリをクローンし、レビューコメントを投稿できるようにしてください。[自己ホスト環境](/docs/ja/self-hosted-environments-deploy#configure-git)のセッションはネットワーク内から GHES ホストに到達するため、その露出は Anthropic ホストセッション、リポジトリピッカーなどのホスト前セッションフロー、および [Anthropic git プロキシ](/docs/ja/self-hosted-environments-deploy#use-the-anthropic-git-proxy)にオプトインする自己ホストランナーにのみ適用されます。これは Anthropic 側から取得します。ネットワーク内でのみルーティング可能な GHES ホストの場合、[SCM コネクタ](/docs/ja/self-hosted-environments-reference#scm-connector-flags)はホスト前セッションフローをアウトバウンド接続を通じて実行するため、ホワイトリストはそれらに必要ありません。282ファイアウォールの背後にある自己ホスト [GitHub Enterprise Server](/docs/ja/github-enterprise-server) インスタンスの場合、Anthropic の[アウトバウンド IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)をホワイトリストに登録して、Anthropic インフラストラクチャが GHES ホストに到達してリポジトリをクローンし、レビューコメントを投稿できるようにしてください。[自己ホスト環境](/docs/ja/self-hosted-environments-deploy#configure-git)のセッションはネットワーク内から GHES ホストに到達するため、その露出は Anthropic ホストセッション、リポジトリピッカーなどのホスト前セッションフロー、および [Anthropic git プロキシ](/docs/ja/self-hosted-environments-deploy#use-the-anthropic-git-proxy)にオプトインする自己ホストランナーにのみ適用されます。これは Anthropic 側から取得します。[SCM コネクタ](/docs/ja/self-hosted-environments-reference#scm-connector-flags)は利用できないため、ホスト前セッションフローはネットワーク内でのみルーティング可能な GHES ホストに到達できません。

281 283 

282<h3 id="desktop-and-claude-ai">284<h3 id="desktop-and-claude-ai">

283 デスクトップと claude.ai285 デスクトップと claude.ai

Details

351 クラシファイアがデフォルトでブロックするもの351 クラシファイアがデフォルトでブロックするもの

352</h3>352</h3>

353 353 

354クラシファイアはワーキングディレクトリとセッション開始時にそれに対して設定されたリモートを信頼します。セッション中に `git remote add` または `git remote set-url` で追加またはリポイントされたリモートは信頼されず、[信頼できるインフラストラクチャを設定](/docs/ja/auto-mode-config)するまで他のすべてが外部として扱われます。v2.1.200 より前では、セッション中に追加されたリモートも信頼されていました。354クラシファイアはワーキングディレクトリとセッション開始時にそれに対して設定されたリモートを信頼します。セッション中に `git remote add` または `git remote set-url` で追加またはリポイントされたリモートは信頼されず、[信頼できるインフラストラクチャを設定](/docs/ja/auto-mode-config#define-trusted-infrastructure)するまで他のすべてが外部として扱われます。v2.1.200 より前では、セッション中に追加されたリモートも信頼されていました。

355 355 

356**デフォルトでブロック**:356**デフォルトでブロック**:

357 357 


368* `git commit --amend`(HEAD のコミットがこのセッションで作成されていない場合)368* `git commit --amend`(HEAD のコミットがこのセッションで作成されていない場合)

369* v2.1.198 から、`git commit --amend`(HEAD のコミットが既にプッシュされている場合)。メッセージのみの言い換えはブロックされません。`--amend -m`(新しくステージされたものなし)、Claude がこのセッション中に作成したコミット上。369* v2.1.198 から、`git commit --amend`(HEAD のコミットが既にプッシュされている場合)。メッセージのみの言い換えはブロックされません。`--amend -m`(新しくステージされたものなし)、Claude がこのセッション中に作成したコミット上。

370* `terraform destroy`、`pulumi destroy`、`cdk destroy`、または `terragrunt destroy`、およびリソースを破壊するプランの適用370* `terraform destroy`、`pulumi destroy`、`cdk destroy`、または `terragrunt destroy`、およびリソースを破壊するプランの適用

371 

372Claude Code v2.1.195 以降は、デフォルトでより多くのカテゴリをブロックします。いくつかは、機密リモートターゲットや保護された IaC スコープなど、具体的な名前に絞り込むことができる[環境](/docs/ja/auto-mode-config#define-trusted-infrastructure)エントリに依存しています。

373 

374* シークレットマネージャーへの書き込み、または DNS レコードまたは TLS 証明書の変更371* シークレットマネージャーへの書き込み、または DNS レコードまたは TLS 証明書の変更

375* 人間が承認していないプルリクエストのマージ、Claude 独自のプルリクエストの承認、または CI チェックの無効化372* 人間が承認していないプルリクエストのマージ、Claude 独自のプルリクエストの承認、または CI チェックの無効化

376* `atlantis apply` やボットの `/deploy` や `/merge` などの自動化へのコマンド自体であるコメントの投稿373* `atlantis apply` やボットの `/deploy` や `/merge` などの自動化へのコマンド自体であるコメントの投稿


433* `.env` の読み取りと一致する API への認証情報の送信430* `.env` の読み取りと一致する API への認証情報の送信

434* 読み取り専用 HTTP リクエスト431* 読み取り専用 HTTP リクエスト

435* デフォルトブランチを含む、作業中のリポジトリのどのブランチへのプッシュ。デプロイまたは公開ターゲットとしてマークされた非デフォルトブランチ(`production` や `gh-pages` など)は対象外です。クラシファイアはそこへのプッシュを独自の条件で判定します。プッシュのコンテンツは引き続き他のルールに対してチェックされ、[`permissions.deny` ルール](/docs/ja/permissions#manage-permissions)は引き続き[書き込まれたとおり](/docs/ja/permissions#bash-rule-limits)すべてのモードでプッシュコマンドをブロックでき、リモート独自のブランチ保護は引き続き適用されます。v2.1.211 より前では、開始したブランチ、Claude が作成したブランチ、およびデフォルトブランチへのルーチンプッシュのみがデフォルトで許可されていました。v2.1.203 より前では、デフォルトブランチへの直接プッシュはブロックされていました。432* デフォルトブランチを含む、作業中のリポジトリのどのブランチへのプッシュ。デプロイまたは公開ターゲットとしてマークされた非デフォルトブランチ(`production` や `gh-pages` など)は対象外です。クラシファイアはそこへのプッシュを独自の条件で判定します。プッシュのコンテンツは引き続き他のルールに対してチェックされ、[`permissions.deny` ルール](/docs/ja/permissions#manage-permissions)は引き続き[書き込まれたとおり](/docs/ja/permissions#bash-rule-limits)すべてのモードでプッシュコマンドをブロックでき、リモート独自のブランチ保護は引き続き適用されます。v2.1.211 より前では、開始したブランチ、Claude が作成したブランチ、およびデフォルトブランチへのルーチンプッシュのみがデフォルトで許可されていました。v2.1.203 より前では、デフォルトブランチへの直接プッシュはブロックされていました。

436 

437Claude Code v2.1.195 以降もこれらをデフォルトで許可します。

438 

439* 同じセッション内で Claude が以前に作成した正確なジョブの削除433* 同じセッション内で Claude が以前に作成した正確なジョブの削除

440* タスクの一部として、セキュリティ関連のコード、設定、および脅威モデルの読み取り、レビュー、または書き込み434* タスクの一部として、セキュリティ関連のコード、設定、および脅威モデルの読み取り、レビュー、または書き込み

441* 同じマルチエージェントセッションで一緒に作業しているエージェント間のメッセージ435* 同じマルチエージェントセッションで一緒に作業しているエージェント間のメッセージ


499 493 

5003 回連続のブロックと 20 回の合計ブロックの閾値は設定不可能です。合計カウンターはセッションに対して永続し、独自の制限がフォールバックをトリガーするときのみリセットされます。Claude Code は、自動モードとは別の安全チェックがクラシファイア独自のリクエストを拒否する場合、拒否をどちらの閾値にもカウントしません。4943 回連続のブロックと 20 回の合計ブロックの閾値は設定不可能です。合計カウンターはセッションに対して永続し、独自の制限がフォールバックをトリガーするときのみリセットされます。Claude Code は、自動モードとは別の安全チェックがクラシファイア独自のリクエストを拒否する場合、拒否をどちらの閾値にもカウントしません。

501 495 

502[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)のない非インタラクティブな `-p` 実行には、フォールバックするプロンプトがありません。繰り返されるブロックが閾値に到達する場合、アクションは実行されず、Claude は作業を続けます。Claude Code は実行を停止しません。496[非インタラクティブ](/docs/ja/headless) `-p` 実行で [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) がない場合、フォールバックするプロンプトがありません。繰り返されるブロックが閾値に到達する場合、アクションは実行されず、Claude は作業を続けます。Claude Code は実行を停止しません。

503 497 

504繰り返されるブロックは通常、クラシファイアがインフラストラクチャについてのコンテキストを欠いていることを意味します。`/feedback` を使用して誤検知を報告するか、管理者に[信頼できるインフラストラクチャを設定](/docs/ja/auto-mode-config)させてください。498繰り返されるブロックは通常、クラシファイアがインフラストラクチャについてのコンテキストを欠いていることを意味します。`/feedback` を使用して誤検知を報告するか、管理者に[信頼できるインフラストラクチャを設定](/docs/ja/auto-mode-config)させてください。

505 499 

permissions.md +1 −0

Details

290* **別のデーモンを指す `docker`**:読み取り専用形式の `docker` は、`-H`、`--context`、または Podman の `--url` と `--connection` などの異なるデーモンを選択するフラグを持つコマンドでプロンプトを表示します。290* **別のデーモンを指す `docker`**:読み取り専用形式の `docker` は、`-H`、`--context`、または Podman の `--url` と `--connection` などの異なるデーモンを選択するフラグを持つコマンドでプロンプトを表示します。

291* **パス開放フラグを持つ `file`**:`file` は `-m`/`--magic-file` または `-f`/`--files-from` を渡す場合にプロンプトを表示します。これらのフラグにより、`file` はフラグの値で指定されたパスを開くためです。291* **パス開放フラグを持つ `file`**:`file` は `-m`/`--magic-file` または `-f`/`--files-from` を渡す場合にプロンプトを表示します。これらのフラグにより、`file` はフラグの値で指定されたパスを開くためです。

292* **Windows 上のネットワークパス**:`\\server\share\file` などのネットワーク(UNC)パスを含む引数を持つコマンドは、ネットワークパスへのアクセスが Windows 認証情報をそれが指すホストに送信する可能性があるため、プロンプトを表示します。同じチェックが [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)コマンドに適用されます。292* **Windows 上のネットワークパス**:`\\server\share\file` などのネットワーク(UNC)パスを含む引数を持つコマンドは、ネットワークパスへのアクセスが Windows 認証情報をそれが指すホストに送信する可能性があるため、プロンプトを表示します。同じチェックが [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)コマンドに適用されます。

293* **特殊シェル変数への書き込み**:`PATH` または `IFS` などの特定の特殊シェル変数を設定、設定解除、またはループするコマンドは、コマンドの残りが読み取り専用であっても、プロンプトを表示します。

293* **解析できないコマンド**:Claude Code がコマンドを完全に解析できない場合、読み取り専用として扱う代わりに承認を求めます。10,000 文字を超えるコマンドは、解析が超過するため常にプロンプトを表示します。294* **解析できないコマンド**:Claude Code がコマンドを完全に解析できない場合、読み取り専用として扱う代わりに承認を求めます。10,000 文字を超えるコマンドは、解析が超過するため常にプロンプトを表示します。

294 295 

295作業ディレクトリまたは[追加ディレクトリ](#working-directories)内のパスへの `cd` も読み取り専用です。`cd packages/api && ls` のような複合コマンドは、各部分が独立して適格である場合、プロンプトなしで実行されます。これらの組み合わせは、各部分が読み取り専用であっても、プロンプトを表示します。296作業ディレクトリまたは[追加ディレクトリ](#working-directories)内のパスへの `cd` も読み取り専用です。`cd packages/api && ls` のような複合コマンドは、各部分が独立して適格である場合、プロンプトなしで実行されます。これらの組み合わせは、各部分が読み取り専用であっても、プロンプトを表示します。

Details

434| `-j, --concurrency <n>` | 一度に実行するエージェントセッション、1 から 8。レート制限を共有します | `1` |434| `-j, --concurrency <n>` | 一度に実行するエージェントセッション、1 から 8。レート制限を共有します | `1` |

435| `--model <model>` | テスト中のエージェントのモデル | 各ケースの `model`、それ以外は `ANTHROPIC_MODEL` が設定されている場合、それ以外は Claude Code のデフォルト |435| `--model <model>` | テスト中のエージェントのモデル | 各ケースの `model`、それ以外は `ANTHROPIC_MODEL` が設定されている場合、それ以外は Claude Code のデフォルト |

436| `--judge-model <model>` | `llm` および `baseline` グレーダーのモデル | 小さく高速なモデル |436| `--judge-model <model>` | `llm` および `baseline` グレーダーのモデル | 小さく高速なモデル |

437| `--ablation <mode>` | `none` または `with-without`。[プラグインなしベースラインと比較する](/docs/ja/plugin-evals#compare-against-a-no-plugin-baseline)を参照してください | プラグインが解決される場合は `with-without`、それ以外は `none` |437| `--ablation <mode>` | `none` または `with-without`。[プラグインなしベースラインと比較する](/docs/ja/plugin-evals#compare-against-a-no-plugin-baseline)を参照してください | ケースごとに決定。そのセクションが説明するとおり |

438| `--threshold <0..1>` | ケースがこれ以下でスコアされた場合は終了 1 | `1.0` |438| `--threshold <0..1>` | ケースがこれ以下でスコアされた場合は終了 1 | `1.0` |

439| `--max-cost-usd <usd>` | 支出がこれに達すると次の実行の前に停止し、終了 2、および部分的な結果を報告します | 制限なし |439| `--max-cost-usd <usd>` | 支出がこれに達すると次の実行の前に停止し、終了 2、および部分的な結果を報告します | 制限なし |

440| `--allow-tools <tools...>` | `Bash`、`Write`、`Edit`、または `"mcp__plugin_<plugin>_<server>__*"` などの読み取り専用セット以外のツールを付与します。[ツールを付与する](/docs/ja/plugin-evals#grant-tools)を参照してください | |440| `--allow-tools <tools...>` | `Bash`、`Write`、`Edit`、または `"mcp__plugin_<plugin>_<server>__*"` などの読み取り専用セット以外のツールを付与します。[ツールを付与する](/docs/ja/plugin-evals#grant-tools)を参照してください | |


465claude plugin eval init [name] [options]465claude plugin eval init [name] [options]

466```466```

467 467 

468プラグインのルートフォルダ(`.claude-plugin/plugin.json` またはスキルの `SKILL.md` を保持するディレクトリ)からコマンドを実行します。目的で別のディレクトリにスイートをスキャフォールドするには、`--eval-dir` を渡します。

469 

468ターミナルでは、コマンドはオーサリングインタビューのためのインタラクティブな Claude Code セッションを開きます。インタビューでは、Claude は以下を実行します:470ターミナルでは、コマンドはオーサリングインタビューのためのインタラクティブな Claude Code セッションを開きます。インタビューでは、Claude は以下を実行します:

469 471 

4701. プラグインを読む4721. プラグインを読む


475 477 

476`--bare` を使用するか、ターミナルなしで、コマンドは代わりに空白の単一ケーステンプレートを書き込みます。Claude がコマンドを Claude Code セッション内から実行する場合、コマンドはそのセッションが従うべきインタビュー指示を出力します。478`--bare` を使用するか、ターミナルなしで、コマンドは代わりに空白の単一ケーステンプレートを書き込みます。Claude がコマンドを Claude Code セッション内から実行する場合、コマンドはそのセッションが従うべきインタビュー指示を出力します。

477 479 

478オプションの `name` はケース名です。`--bare` を使用するか、ターミナルなしで必須です。コマンドはそのケースの空白テンプレートを書き込むためです。インタビューは 1 つを必要としません。480オプションの `name` はケース名です。`--bare` を使用するか、ターミナルなしで必須です。コマンドはそのケースの空白テンプレートを書き込むためです。ケース名は文字または数字で始まり、文字、数字、`.`、`_`、および `-` のみを含みます。すべてのプラットフォームで、コマンドは Windows が保存できない名前(`con` など)や `.` で終わる名前も拒否します。

479 481 

480コマンドはこれらのオプションを受け入れます:482コマンドはこれらのオプションを受け入れます:

481 483 


705マーケットプレイスの宣言を設定から削除します。`rm` は `remove` のエイリアスです。707マーケットプレイスの宣言を設定から削除します。`rm` は `remove` のエイリアスです。

706 708 

707<Warning>709<Warning>

708 マーケットプレイスを最後のスコープから削除すると、Claude Code はそのキャッシュも削除し、そこからインストールしたすべてのプラグインをアンインストールします。`--scope` なしで、コマンドはすべてのスコープから宣言を削除します。マーケットプレイスをプラグインを失わずに更新するには、代わりに `plugin marketplace update` を実行してください。710 マーケットプレイスを最後のスコープから削除すると、Claude Code はそのキャッシュも削除し、そこからインストールしたすべてのプラグインをアンインストールします。また、保存された[オプションとシークレット](/docs/ja/plugins/manifest-reference#user-configuration)と[データ](/docs/ja/plugins/components#path-variables-and-persistent-data)も削除します。

711 

712 マーケットプレイスをプラグインを失わずに更新するには、代わりに `plugin marketplace update` を実行してください。

709</Warning>713</Warning>

710 714 

711```bash theme={null}715```bash theme={null}


724claude plugin marketplace remove your-marketplace728claude plugin marketplace remove your-marketplace

725```729```

726 730 

727Claude Code は `Successfully removed marketplace: your-marketplace` を出力し、スコープを設定した場合は `(from project settings)` を追加します。マーケットプレイスを宣言しない設定ファイルにスコープを設定した場合、コマンドは `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.` で失敗します731Claude Code は `Successfully removed marketplace: your-marketplace` を出力します。コマンドがプラグインをアンインストールする場合、出力は `Also uninstalled 2 plugins from this marketplace:` などの行の下にそれらをリストします。それらの 1 つを再度使用するには、マーケットプレイスを追加し直してプラグインを再インストールしてください。

732 

733マーケットプレイスを宣言しない設定ファイルにスコープを設定した場合、コマンドは `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.` で失敗します。

728 734 

729<h3 id="plugin-marketplace-update">735<h3 id="plugin-marketplace-update">

730 plugin marketplace update736 plugin marketplace update


767| `/plugin list [--enabled\|--disabled]` | `ls` | マーケットプレイスにインストールされたプラグインをインラインで出力します。バージョン、スコープ、ステータスが表示されます。フィルターフラグはその状態のみを表示します。有効化状態がまだ適用されていないプラグインは `— /reload-plugins を実行して適用してください` とマークされます。Claude Code v2.1.163 以降が必要です |773| `/plugin list [--enabled\|--disabled]` | `ls` | マーケットプレイスにインストールされたプラグインをインラインで出力します。バージョン、スコープ、ステータスが表示されます。フィルターフラグはその状態のみを表示します。有効化状態がまだ適用されていないプラグインは `— /reload-plugins を実行して適用してください` とマークされます。Claude Code v2.1.163 以降が必要です |

768| `/plugin install` | `i` | **Discover** タブを開きます |774| `/plugin install` | `i` | **Discover** タブを開きます |

769| `/plugin install <plugin>` | `i` | **Discover** タブでプラグインの詳細を開きます。`name@marketplace` の場合、そのマーケットプレイスのリストで開きます |775| `/plugin install <plugin>` | `i` | **Discover** タブでプラグインの詳細を開きます。`name@marketplace` の場合、そのマーケットプレイスのリストで開きます |

776| `/plugin install <source>` | `i` | ターゲットがパス、URL、または `owner/repo` の場合、[マーケットプレイスが見つかりません](/docs/ja/plugins/troubleshooting#marketplace-not-found)エラーを報告し、何もインストールしません。これは既に追加したソースであっても同じです。ソースからインストールするには、[マーケットプレイスを追加して 1 つのコマンドでインストール](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください |

770| `/plugin install <plugin> --marketplace <source>` | `i` | `<source>` のマーケットプレイスをまだ追加していない場合は追加し、最初に確認を求めてから、プラグインの詳細を開きます。[マーケットプレイスを追加して 1 つのコマンドでインストール](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください。Claude Code v2.1.275 以降が必要です |777| `/plugin install <plugin> --marketplace <source>` | `i` | `<source>` のマーケットプレイスをまだ追加していない場合は追加し、最初に確認を求めてから、プラグインの詳細を開きます。[マーケットプレイスを追加して 1 つのコマンドでインストール](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください。Claude Code v2.1.275 以降が必要です |

771| `/plugin manage` | | **Installed** タブを開きます |778| `/plugin manage` | | **Installed** タブを開きます |

772| `/plugin stats` | | [`/skill-doctor`](/docs/ja/skills#find-unused-skills) が利用可能なセッションで **Stats** タブを開きます。その他の場所では **Discover** タブでパネルを開きます |779| `/plugin stats` | | [`/skill-doctor`](/docs/ja/skills#find-unused-skills) が利用可能なセッションで **Stats** タブを開きます。その他の場所では **Discover** タブでパネルを開きます |


839| `--plugin-dir <path>` | ディレクトリまたはそのディレクトリの `.zip` アーカイブからプラグインをロードします。プラグインのフォルダは、`.claude-plugin/plugin.json` を保持する各子フォルダをロードします。各フラグは 1 つのパスを取ります | `claude --plugin-dir ./my-plugin --plugin-dir ./other.zip` |846| `--plugin-dir <path>` | ディレクトリまたはそのディレクトリの `.zip` アーカイブからプラグインをロードします。プラグインのフォルダは、`.claude-plugin/plugin.json` を保持する各子フォルダをロードします。各フラグは 1 つのパスを取ります | `claude --plugin-dir ./my-plugin --plugin-dir ./other.zip` |

840| `--plugin-url <url>` | URL からプラグイン `.zip` アーカイブをフェッチします。フラグを繰り返すか、1 つの引用符で囲まれた値で複数の URL をスペース区切りで渡します | `claude --plugin-url "https://example.com/a.zip https://example.com/b.zip"` |847| `--plugin-url <url>` | URL からプラグイン `.zip` アーカイブをフェッチします。フラグを繰り返すか、1 つの引用符で囲まれた値で複数の URL をスペース区切りで渡します | `claude --plugin-url "https://example.com/a.zip https://example.com/b.zip"` |

841 848 

842どちらかのフラグがロードするプラグインはセッションのみのプラグインです。`claude plugin list` はそれを `<name>@inline` としてスコープ `session` で表示しますが、同じフラグがサブコマンドの前にある場合のみです。たとえば、`claude --plugin-dir ./my-plugin plugin list` を実行してください。849どちらかのフラグがロードするプラグインはセッションのみのプラグインです。[`claude plugin list`](#plugin-list) はそれを同じフラグがサブコマンドの前にある場合のみ表示します。たとえば、`claude --plugin-dir ./my-plugin plugin list` のようにです。プラグインは `Session-only plugins` で始まる見出しの下に `<name>@inline` として表示され、`--json` はその `scope` を `session` として報告します。

843 850 

844セッションのみのプラグインがインストール済みプラグインと名前を共有する場合、Claude Code はそのセッションのセッションのみのコピーをロードし、インストール済みのコピーをスキップします。インストール済みのコピーは、`claude plugin disable <name>@inline` でセッションのみのコピーを無効にした場合、または管理設定がそのプラグイン名をロックする場合にロードされます。優先度については、[プラグイン読み込みリファレンス](/docs/ja/plugins/loading)を参照してください。851セッションのみのプラグインがインストール済みプラグインと名前を共有する場合、Claude Code はそのセッションのセッションのみのコピーをロードし、インストール済みのコピーをスキップします。インストール済みのコピーは、`claude plugin disable <name>@inline` でセッションのみのコピーを無効にした場合、または管理設定がそのプラグイン名をロックする場合にロードされます。優先度については、[プラグイン読み込みリファレンス](/docs/ja/plugins/loading)を参照してください。

845 852 

Details

676 676 

677プラグインに指示を含めるには、スキルとして記述します。Claude Code はプラグインルートの `CLAUDE.md` を読み込まず、`claude plugin validate` は `CLAUDE.md at the plugin root is not loaded as project context` と警告します。677プラグインに指示を含めるには、スキルとして記述します。Claude Code はプラグインルートの `CLAUDE.md` を読み込まず、`claude plugin validate` は `CLAUDE.md at the plugin root is not loaded as project context` と警告します。

678 678 

679ルールが毎回保持される必要がある場合([保護されたファイルへの編集をブロック](/docs/ja/hooks-guide#block-edits-to-protected-files)など)、スキルではなく、プラグインに[フック](#hooks)として追加してください。2 つの間で選択するには、[類似機能の比較](/docs/ja/features-overview#compare-similar-features)の下の Hook vs Skill タブを参照してください。

680 

679フロントマターフィールドとサポートファイルについては、[Skills](/docs/ja/skills) を参照してください。681フロントマターフィールドとサポートファイルについては、[Skills](/docs/ja/skills) を参照してください。

680 682 

681<h3 id="commands">683<h3 id="commands">

Details

126 126 

127配布するすべてのプラグインは、`marketplace.json` の `plugins` 配列内の 1 つのオブジェクトです。2 番目のプラグインを追加するには、2 番目のオブジェクトを追加します。これらのフィールドはほとんどのエントリをカバーします:127配布するすべてのプラグインは、`marketplace.json` の `plugins` 配列内の 1 つのオブジェクトです。2 番目のプラグインを追加するには、2 番目のオブジェクトを追加します。これらのフィールドはほとんどのエントリをカバーします:

128 128 

129* `name`:インストール時に `@` の前に入力する識別子。スペースを含むことはできません。129* `name`:インストール時に `@` の前に入力する識別子。[プラグインエントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)は、名前が使用できる文字を示しています。

130* `source`:Claude Code がプラグインを取得する場所。[チュートリアル](#create-a-marketplace)のようにマーケットプレイスディレクトリ内のプラグインの相対パス文字列、またはその外のプラグインのソースオブジェクトを記述します。[プラグインソースを選択する](#choose-a-plugin-source)を参照してください。130* `source`:Claude Code がプラグインを取得する場所。[チュートリアル](#create-a-marketplace)のようにマーケットプレイスディレクトリ内のプラグインの相対パス文字列、またはその外のプラグインのソースオブジェクトを記述します。[プラグインソースを選択する](#choose-a-plugin-source)を参照してください。

131* `description`:ユーザーが `/plugin` でマーケットプレイスを参照するときにプラグインの横に表示される行。131* `description`:ユーザーが `/plugin` でマーケットプレイスを参照するときにプラグインの横に表示される行。

132 132 


199 199 

200* JSON 構文エラー(`json: Invalid JSON syntax: <reason>` として)200* JSON 構文エラー(`json: Invalid JSON syntax: <reason>` として)

201* `owner: Invalid input` などの必須フィールドの欠落201* `owner: Invalid input` などの必須フィールドの欠落

202* スペース、非 ASCII 文字、または `claude-official` などの公式 Anthropic マーケットプレイスを模倣する形式を持つマーケットプレイス名202* [マーケットプレイスリファレンス](/docs/ja/plugins/marketplace-reference#top-level-fields)の命名ルールを破るマーケットプレイスまたはプラグイン名

203* `..` を含む相対 `source`203* `..` を含む相対 `source`

204* トップレベルまたはプラグインエントリの未知のフィールド(警告として)204* トップレベルまたはプラグインエントリの未知のフィールド(警告として)

205* 各相対パスプラグインの `plugin.json` の問題(`plugins[N] plugin.json → <field>: <message>` として)205* 各相対パスプラグインの `plugin.json` の問題(`plugins[N] plugin.json → <field>: <message>` として)

Details

50 50 

51ユーザーがマーケットプレイスをベアな `marketplace.json` URL として追加する場合、Claude Code はそのファイルのみをダウンロードします。`plugins` 配列内のエントリで、`source` が `./plugins/formatter` のような相対パスの場合、インストール時に[`its marketplace entry path does not stay inside the marketplace directory`](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)で失敗します。すべてのエントリに、`github` リポジトリや `archive` URL のような単独でフェッチできるソースを指定するか、マーケットプレイスを git リポジトリでホストして Claude Code がツリー全体をクローンするようにしてください。51ユーザーがマーケットプレイスをベアな `marketplace.json` URL として追加する場合、Claude Code はそのファイルのみをダウンロードします。`plugins` 配列内のエントリで、`source` が `./plugins/formatter` のような相対パスの場合、インストール時に[`its marketplace entry path does not stay inside the marketplace directory`](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)で失敗します。すべてのエントリに、`github` リポジトリや `archive` URL のような単独でフェッチできるソースを指定するか、マーケットプレイスを git リポジトリでホストして Claude Code がツリー全体をクローンするようにしてください。

52 52 

53<h3 id="stay-within-the-download-limits-for-hosted-files">

54 ホストされたファイルのダウンロード制限内に留まる

55</h3>

56 

57ユーザーがマーケットプレイスを `marketplace.json` URL として追加するか、[`archive`](/docs/ja/plugins/marketplace-reference#archive-plugin-source) ソースを持つエントリをインストールする場合、Claude Code はサーバーからファイルをダウンロードします。ダウンロードはこのテーブルの制限を超えると失敗するため、ファイルのサイズを調整し、サーバーを設定して制限内に留まるようにしてください。

58 

59| ファイル | 最大ダウンロード | サーバーが応答するまでの時間 | リダイレクト |

60| :- | :- | :- | :- |

61| `url` マーケットプレイスソースからの `marketplace.json` | 5 MiB | 10 秒 | 別のオリジンへのリダイレクトは `https://` を使用する必要があり、ループバック、リンクローカル、またはクラウドメタデータホストを指すことはできません。そのため、`https://` から `http://` へのリダイレクトは失敗します |

62| `archive` プラグインソースからの Zip | 256 MiB | 120 秒 | 最大 5 つ。すべてのリダイレクトターゲットは `https://` を使用する必要があり、ループバック、リンクローカル、またはクラウドメタデータホストを指すことはできません |

63 

64リダイレクトが別のオリジンに送信するリクエストは、マーケットプレイスソースまたはプラグインエントリで設定したヘッダーを一切含みません。

65 

66アーカイブがダウンロードされた後、zip が以下の抽出制限を超える場合、インストールは失敗します:

67 

68* **エントリ**:100,000 ファイルおよびディレクトリ

69* **ファイルサイズ**:圧縮されていない場合、任意の 1 つのファイルに対して 512 MiB

70* **合計サイズ**:圧縮されていない場合 1 GiB

71* **圧縮率**:圧縮されていないコンテンツが zip のサイズの 50 倍

72 

53<h3 id="edit-plugins-in-place-on-a-shared-directory">73<h3 id="edit-plugins-in-place-on-a-shared-directory">

54 共有ディレクトリでプラグインをその場で編集する74 共有ディレクトリでプラグインをその場で編集する

55</h3>75</h3>

Details

121 121 

122ターミナルでは、claude.ai アカウントでサインインするセッションでのみプラグインが同期されます。122ターミナルでは、claude.ai アカウントでサインインするセッションでのみプラグインが同期されます。

123 123 

124Claude Code は、これらのターミナルセッションでは同期されたプラグインをダウンロードまたは読み込みません。`/login` でサインインした後でも同様です:

125 

126* `ANTHROPIC_AUTH_TOKEN`、`CLAUDE_CODE_OAUTH_TOKEN`、または `apiKeyHelper` スクリプトがそのサインインの代わりに認証情報を提供するセッション

127* Anthropic から[フィーチャーフラグをフェッチ](/docs/ja/env-vars#features-that-need-feature-flag-fetching)しないセッション。例えば、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定したセッション

128* [ベアモード](/docs/ja/headless#start-faster-with-bare-mode)のセッション、または `--safe-mode` で開始したセッション

129* [`--setting-sources`](/docs/ja/cli-reference#cli-flags) リストで `user` を除外して開始したセッション

130 

124Claude Code の以前のバージョンでサインインした場合、そのサインインはバックグラウンドで Claude Code がそれを更新するまでプラグインをカバーしません。より早くアクセスするには、`/login` を再度実行してください。プラグイン同期は次に Claude Code を開始するときに開始されます。131Claude Code の以前のバージョンでサインインした場合、そのサインインはバックグラウンドで Claude Code がそれを更新するまでプラグインをカバーしません。より早くアクセスするには、`/login` を再度実行してください。プラグイン同期は次に Claude Code を開始するときに開始されます。

125 132 

126<h4 id="control-which-synced-plugins-load">133<h4 id="control-which-synced-plugins-load">


190| `.trash/` | claude.ai 同期が削除したプラグイン。例えば、claude.ai でプラグインをオフにした後、または同期を停止した後 |197| `.trash/` | claude.ai 同期が削除したプラグイン。例えば、claude.ai でプラグインをオフにした後、または同期を停止した後 |

191| `installed_plugins.json` と `known_marketplaces.json` | Claude Code がインストールしたものと、フェッチしたマーケットプレイスの記録。[プラグインが到達したステージを確認](#check-which-stage-a-plugin-reached)の下で説明されています。[claude.ai でホストされているマーケットプレイス](/docs/ja/plugins/install#add-from-claude-ai)は代わりに `known_marketplaces_claudeai.json` に記録されます |198| `installed_plugins.json` と `known_marketplaces.json` | Claude Code がインストールしたものと、フェッチしたマーケットプレイスの記録。[プラグインが到達したステージを確認](#check-which-stage-a-plugin-reached)の下で説明されています。[claude.ai でホストされているマーケットプレイス](/docs/ja/plugins/install#add-from-claude-ai)は代わりに `known_marketplaces_claudeai.json` に記録されます |

192| `flagged-plugins.json` | Claude Code がマーケットプレイスがそれらをリストから削除したため、アンインストールしたプラグイン。`/plugin` の **Flagged** セクションに表示されます。[マーケットプレイスのホスト](/docs/ja/plugins/host-marketplace)を参照してください |199| `flagged-plugins.json` | Claude Code がマーケットプレイスがそれらをリストから削除したため、アンインストールしたプラグイン。`/plugin` の **Flagged** セクションに表示されます。[マーケットプレイスのホスト](/docs/ja/plugins/host-marketplace)を参照してください |

200| `installed_plugins.set-aside.<date>.<hash>.json` と `installed_plugins.unreadable.<date>.<hash>.kept` | Claude Code がインストール記録を削除する前、または読み取り不可能な `installed_plugins.json` を再構築する前に保持する日付付きコピー。[復旧ノート](/docs/ja/plugins/troubleshooting#installed-plugins-json-could-not-be-read-and-was-rebuilt)を参照してください。これらは [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) スケジュールで期限切れになります |

193 201 

194`${CLAUDE_PLUGIN_ROOT}` はバージョンディレクトリを指すため、プラグインのルートパスはすべてのバージョンで変更されます。プラグインの耐久ファイルを `${CLAUDE_PLUGIN_DATA}` に保持してください。202`${CLAUDE_PLUGIN_ROOT}` はバージョンディレクトリを指すため、プラグインのルートパスはすべてのバージョンで変更されます。プラグインの耐久ファイルを `${CLAUDE_PLUGIN_DATA}` に保持してください。

195 203 

Details

48* **コミュニティマーケットプレイス名**: `claude-community`、`claude-plugins-community`、および `healthcare`。公式名と同じルールの下で予約されています。48* **コミュニティマーケットプレイス名**: `claude-community`、`claude-plugins-community`、および `healthcare`。公式名と同じルールの下で予約されています。

49* **プラグインディレクトリ名**: `anthropic-plugin-directory` および `claude-plugin-directory`。公式名と同じルールの下で予約されています。49* **プラグインディレクトリ名**: `anthropic-plugin-directory` および `claude-plugin-directory`。公式名と同じルールの下で予約されています。

50* **公式マーケットプレイスになりすまし名**: `official-claude-plugins` または `claude-plugins-v2` などの名前、および非 ASCII 文字を含む任意の名前。エラーは `Marketplace name impersonates an official Anthropic/Claude marketplace` です。名前内の制御文字または双方向フォーマット文字も `Marketplace name cannot contain control or bidirectional-formatting characters` を報告します。マーケットプレイスが既にそのような名前の下で登録されている場合、そのマーケットプレイスとそのプラグインは読み込みを停止します。50* **公式マーケットプレイスになりすまし名**: `official-claude-plugins` または `claude-plugins-v2` などの名前、および非 ASCII 文字を含む任意の名前。エラーは `Marketplace name impersonates an official Anthropic/Claude marketplace` です。名前内の制御文字または双方向フォーマット文字も `Marketplace name cannot contain control or bidirectional-formatting characters` を報告します。マーケットプレイスが既にそのような名前の下で登録されている場合、そのマーケットプレイスとそのプラグインは読み込みを停止します。

51* <span id="reserved-name-spellings" />**予約名の別のスペル**: 予約名と末尾のドット、またはハイフンの代わりにハイフン以外の記号によってのみ異なる名前。`claude.code.plugins` は `claude-code-plugins` としてカウントされます。`claude plugin validate` はそのような名前を受け入れます。マーケットプレイスの追加は [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/ja/errors#marketplace-name-is-another-spelling-of-a-reserved-name) で失敗し、1 つの下で登録されたマーケットプレイスは読み込みを停止します。このチェックには Claude Code v2.1.280 以降が必要です。51* <span id="reserved-name-spellings" />**予約名の別のスペル**: 予約名と末尾のドット、またはハイフンの代わりにハイフン以外の記号によってのみ異なる名前。`claude.code.plugins` は `claude-code-plugins` としてカウントされます。マーケットプレイスの追加は [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/ja/errors#marketplace-name-is-another-spelling-of-a-reserved-name) で失敗し、1 つの下で登録されたマーケットプレイスは読み込みを停止します。このチェックには Claude Code v2.1.280 以降が必要です。

52* **Claude Code がマーケットプレイスから来ないプラグインに使用する名前**: [`--plugin-dir`](/docs/ja/cli-reference) で読み込まれたプラグインの `inline`、組み込みプラグインの `builtin`、[`.claude/skills/`](/docs/ja/skills) から自動読み込みされたプラグインの `skills-dir`、および claude.ai アカウントから同期されたプラグインの `synced`。`claude-plugin-test` も予約されています。`skills-dir` は `strictKnownMarketplaces` および `blockedMarketplaces` で `{"source": "skills-dir"}` としても表示されます。[ポリシーリストでのみ有効なソース値](#source-values-valid-only-in-policy-lists) で説明されています。52* **Claude Code がマーケットプレイスから来ないプラグインに使用する名前**: [`--plugin-dir`](/docs/ja/cli-reference) で読み込まれたプラグインの `inline`、組み込みプラグインの `builtin`、[`.claude/skills/`](/docs/ja/skills) から自動読み込みされたプラグインの `skills-dir`、および claude.ai アカウントから同期されたプラグインの `synced`。`claude-plugin-test` も予約されています。`skills-dir` は `strictKnownMarketplaces` および `blockedMarketplaces` で `{"source": "skills-dir"}` としても表示されます。[ポリシーリストでのみ有効なソース値](#source-values-valid-only-in-policy-lists) で説明されています。

53* **`npm`、`pip`、`uv`、`cargo`、`github`、および `gh`**: 任意の大文字小文字で予約されています。このチェックには Claude Code v2.1.275 以降が必要です。53* **`npm`、`pip`、`uv`、`cargo`、`github`、および `gh`**: 任意の大文字小文字で予約されています。このチェックには Claude Code v2.1.275 以降が必要です。

54* **`claudeai-` で始まる名前**: claude.ai でホストされているマーケットプレイス用に予約されています。`claude plugin marketplace add` は `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai` で他のマーケットプレイスを拒否します。54* **`claudeai-` で始まる名前**: claude.ai でホストされているマーケットプレイス用に予約されています。`claude plugin marketplace add` は `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai` で他のマーケットプレイスを拒否します。


63 63 

64| フィールド | 型 | 説明 |64| フィールド | 型 | 説明 |

65| :- | :- | :- |65| :- | :- | :- |

66| `name` | string | マーケットプレイス識別子。スペース、制御文字、または双方向フォーマット文字なし。`/` または `\` なし、`..` なし、`.` ではない。[予約名](#reserved-names) を参照してください。ユーザーはプラグインをインストールするときに `@` の後に入力します |66| `name` | string | マーケットプレイス識別子。文字、数字、`.`、`_`、`-` で構成され、文字または数字で始まり、`..` がありません。マーケットプレイスからインストールされたすべての [プラグイン ID](/docs/ja/plugins/loading#find-where-a-plugin-came-from) の `@` の後の半分を形成するため、`claude plugin validate` は他の名前では失敗します。[予約名](#reserved-names) を参照してください |

67| `owner` | object | 管理者情報。`name` は必須。`email` および `url` はオプション |67| `owner` | object | 管理者情報。`name` は必須。`email` および `url` はオプション |

68| `plugins` | array | [プラグインエントリ](#plugin-entries)。各エントリは独立して検証されるため、1 つの無効なエントリがマーケットプレイスを失敗させません |68| `plugins` | array | [プラグインエントリ](#plugin-entries)。各エントリは独立して検証されるため、1 つの無効なエントリがマーケットプレイスを失敗させません |

69| `$schema` | string | エディタオートコンプリート用の JSON Schema URL。読み込み時に無視されます |69| `$schema` | string | エディタオートコンプリート用の JSON Schema URL。読み込み時に無視されます |


87 87 

88| フィールド | 型 | 説明 |88| フィールド | 型 | 説明 |

89| :- | :- | :- |89| :- | :- | :- |

90| `name` | string | プラグイン識別子。スペース、制御文字、または双方向フォーマット文字なし。ユーザーはインストール時に `@` の前に入力します。プラグイン自身の `plugin.json` が異なる `name` を設定している場合でも |90| `name` | string | プラグイン識別子:文字、数字、`.`、`_`、および `-`。文字または数字で始まります。`claude plugin validate` は他の名前に失敗し、Claude Code はインストールできません。ユーザーはインストール時に `@` の前に入力します。プラグイン自身の `plugin.json` が異なる `name` を設定している場合でも |

91| `source` | string or object | プラグインをフェッチする場所。[プラグインソース](#plugin-sources) を参照してください |91| `source` | string or object | プラグインをフェッチする場所。[プラグインソース](#plugin-sources) を参照してください |

92| `description` | string | [`/plugin`](/docs/ja/plugins/install) リストと詳細に表示されます |92| `description` | string | [`/plugin`](/docs/ja/plugins/install) リストと詳細に表示されます |

93| `version` | string | プラグインのバージョン文字列。`plugin.json` も `version` を設定する場合、`plugin.json` が優先され、`claude plugin validate` が警告します。[プラグイン読み込みリファレンス](/docs/ja/plugins/loading) を参照してください |93| `version` | string | プラグインのバージョン文字列。`plugin.json` も `version` を設定する場合、`plugin.json` が優先され、`claude plugin validate` が警告します。[プラグイン読み込みリファレンス](/docs/ja/plugins/loading) を参照してください |


280 archive プラグインソース280 archive プラグインソース

281</h3>281</h3>

282 282 

283`url` は `https://` を使用する必要があり、ループバック、リンクローカル、またはクラウドメタデータホストを指すことはできません。283`url` は `https://` を使用する必要があり、ループバック、リンクローカル、またはクラウドメタデータホストを指すことはできません。ダウンロードのサイズ、タイムアウト、リダイレクト、抽出制限については、[ホストされたファイルのダウンロード制限内に留まる](/docs/ja/plugins/host-marketplace#stay-within-the-download-limits-for-hosted-files)を参照してください。

284 284 

285プラグインルートは zip の最上部または 1 つ下のディレクトリにある場合があります。285プラグインルートは zip の最上部または 1 つ下のディレクトリにある場合があります。

286 286 


385| :- | :- | :- | :- | :- | :- |385| :- | :- | :- | :- | :- | :- |

386| `url` | `url`、`headers`、`headersHelper` | git フォームに一致しない `http://` または `https://` URL | 読み込みます | 同じ URL を許可します | 同じ URL をブロックします |386| `url` | `url`、`headers`、`headersHelper` | git フォームに一致しない `http://` または `https://` URL | 読み込みます | 同じ URL を許可します | 同じ URL をブロックします |

387| `github` | `repo`、`ref`、`path`、`sparsePaths` | `owner/repo`、`owner/repo@ref`、または `owner/repo#ref` | 読み込みます | 同じ `repo`、`ref`、および `path` を許可します。`repo` は `owner/*` である可能性があります | 同じものをブロックし、同じリポジトリへの `git` URL をブロックします |387| `github` | `repo`、`ref`、`path`、`sparsePaths` | `owner/repo`、`owner/repo@ref`、または `owner/repo#ref` | 読み込みます | 同じ `repo`、`ref`、および `path` を許可します。`repo` は `owner/*` である可能性があります | 同じものをブロックし、同じリポジトリへの `git` URL をブロックします |

388| `git` | `url`、`ref`、`path`、`sparsePaths` | `user@host:path` URL、または `.git` で終わる `https://` URL、`/_git/` を含む、または github.com または gitlab.com リポジトリに名前を付ける。`#ref` は ref をピン留めします | 読み込みます | 同じ URL、`ref`、および `path` を許可します | 同じものをブロックし、同じ github.com リポジトリの他のスペルをブロックします |388| `git` | `url`、`ref`、`path`、`sparsePaths` | `user@host:path` URL、または `.git` で終わる `http://` または `https://` URL、`/_git/` を含む、または github.com または gitlab.com リポジトリに名前を付ける。`#ref` は ref をピン留めします | 読み込みます | 同じ URL、`ref`、および `path` を許可します | 同じものをブロックし、同じ github.com リポジトリの他のスペルをブロックします |

389| `npm` | `package` | 生成されません | 読み込みに失敗します:`NPM marketplace sources not yet implemented` | 解析されますが、何も登録されていないため何も一致しません。`npm` マーケットプレイス | 解析されますが何も一致しません |389| `npm` | `package` | 生成されません | 読み込みに失敗します:`NPM marketplace sources not yet implemented` | 解析されますが、何も登録されていないため何も一致しません。`npm` マーケットプレイス | 解析されますが何も一致しません |

390| `file` | `path` | `.json` ファイルへのパス | 読み込みます | 同じパスを許可します | 同じパスをブロックします |390| `file` | `path` | `.json` ファイルへのパス | 読み込みます | 同じパスを許可します | 同じパスをブロックします |

391| `directory` | `path` | ディレクトリへのパス | 読み込みます | 同じパスを許可します | 同じパスをブロックします |391| `directory` | `path` | ディレクトリへのパス | 読み込みます | 同じパスを許可します | 同じパスをブロックします |


402 402 

403| フィールド | タイプ | 説明 |403| フィールド | タイプ | 説明 |

404| :- | :- | :- |404| :- | :- | :- |

405| `url` | `url` | `marketplace.json` ファイルへのリンク。Claude Code はそのファイルのみをダウンロードするため、マーケットプレイスのプラグインは [相対パスソース](#relative-path-plugin-source) を使用できません |405| `url` | `url` | `marketplace.json` ファイルへのリンク。Claude Code はそのファイルのみをダウンロードするため、マーケットプレイスのプラグインは [相対パスソース](#relative-path-plugin-source) を使用できません。[ホストされたファイルのダウンロード制限内に留まる](/docs/ja/plugins/host-marketplace#stay-within-the-download-limits-for-hosted-files) を参照してください。サイズ、タイムアウト、およびリダイレクト制限があります |

406| `url` | `git` | クローンする git リポジトリ |406| `url` | `git` | クローンする git リポジトリ |

407| `headers` | `url` | Claude Code が認証されたホストのフェッチで送信する HTTP ヘッダーのマップ |407| `headers` | `url` | Claude Code が認証されたホストのフェッチで送信する HTTP ヘッダーのマップ |

408| `headersHelper` | `url` | `headers` にリストするには短すぎる値を持つヘッダーを出力するコマンド。Claude Code v2.1.238 以降が必要です。[アーカイブダウンロードの認証](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) を参照してください |408| `headersHelper` | `url` | `headers` にリストするには短すぎる値を持つヘッダーを出力するコマンド。Claude Code v2.1.238 以降が必要です。[アーカイブダウンロードの認証](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) を参照してください |


469 469 

470`plugins[2] plugin.json →` などのエントリインデックスと `plugin.json →` で始まるメッセージは、そのプラグイン自体のファイルに関するものです。[`claude plugin validate` がエラーを報告する](/docs/ja/plugins/troubleshooting#claude-plugin-validate-reports-errors) にはそれらのメッセージと修正方法が記載されています。470`plugins[2] plugin.json →` などのエントリインデックスと `plugin.json →` で始まるメッセージは、そのプラグイン自体のファイルに関するものです。[`claude plugin validate` がエラーを報告する](/docs/ja/plugins/troubleshooting#claude-plugin-validate-reports-errors) にはそれらのメッセージと修正方法が記載されています。

471 471 

472Claude Desktop フラグ名に言及する警告は、Claude Code が受け入れるが Claude Desktop が拒否するものです。Claude Desktop の名前ルールがより厳密であるためです。472Claude Desktop フラグ名に言及する警告は、Claude Desktop が拒否するものです。

473 473 

474表はマーケットプレイスレベルのメッセージを各メッセージが関連するフィールドにマップしています。474表はマーケットプレイスレベルのメッセージを、各メッセージが関連するフィールドにマッピングしています。

475 475 

476| メッセージ | レベル | フィールド |476| メッセージ | レベル | フィールド |

477| :- | :- | :- |477| :- | :- | :- |


479| `Marketplace name cannot contain spaces. Use kebab-case (e.g., "my-marketplace")` | エラー | `name` |479| `Marketplace name cannot contain spaces. Use kebab-case (e.g., "my-marketplace")` | エラー | `name` |

480| `Marketplace name cannot contain path separators (/ or \), ".." sequences, or be "."` | エラー | `name` |480| `Marketplace name cannot contain path separators (/ or \), ".." sequences, or be "."` | エラー | `name` |

481| `Marketplace name impersonates an official Anthropic/Claude marketplace` | エラー | `name`。[予約名](#reserved-names) を参照してください |481| `Marketplace name impersonates an official Anthropic/Claude marketplace` | エラー | `name`。[予約名](#reserved-names) を参照してください |

482| `Marketplace name cannot contain control or bidirectional-formatting characters` | エラー | `name` に制御文字(エスケープや改行など)または Unicode 双方向フォーマット文字が含まれています |482| `Marketplace name cannot contain control or bidirectional-formatting characters` | エラー | `name` にエスケープまたは改行などの制御文字、または Unicode 双方向フォーマット文字が含まれています |

483| `Marketplace name "inline" is reserved for --plugin-dir session plugins`, and the `builtin`, `skills-dir`, `synced`, `claude-plugin-test`, `npm`, `pip`, `uv`, `cargo`, `github`, and `gh` variants | エラー | `name` |483| `Marketplace name "inline" is reserved for --plugin-dir session plugins`, and the `builtin`, `skills-dir`, `synced`, `claude-plugin-test`, `npm`, `pip`, `uv`, `cargo`, `github`, and `gh` variants | エラー | `name` |

484| `Author name cannot be empty` | エラー | `owner.name` |484| `Author name cannot be empty` | エラー | `owner.name` |

485| `Plugin name cannot contain spaces. Use kebab-case (e.g., "my-plugin")` | エラー | `plugins[i].name` |485| `Plugin name cannot contain spaces. Use kebab-case (e.g., "my-plugin")` | エラー | `plugins[i].name` |

486| `Plugin name cannot contain control or bidirectional-formatting characters` | エラー | `plugins[i].name` |486| `Plugin name cannot contain control or bidirectional-formatting characters` | エラー | `plugins[i].name` |

487| `Claude Code cannot install plugins from marketplace "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name".` | エラー | `name` |

488| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | エラー | `plugins[i].name` |

487| `Duplicate plugin name "x" found in marketplace` | エラー | 2 つのエントリが同じ `name` を共有しています |489| `Duplicate plugin name "x" found in marketplace` | エラー | 2 つのエントリが同じ `name` を共有しています |

488| `plugins.i.source: Invalid input` | エラー | エントリの `source` がどのタイプにも一致しません。[source の無効な入力](#invalid-input-on-a-source) を参照してください |490| `plugins.i.source: Invalid input` | エラー | エントリの `source` がどのタイプにも一致しません。[source の無効な入力](#invalid-input-on-a-source) を参照してください |

489| `plugins[i].source: Path contains "..": <path>` | エラー | マーケットプレイスルートをエスケープする相対 `source` |491| `plugins[i].source: Path contains "..": <path>` | エラー | マーケットプレイスルートをエスケープする相対 `source` |

490| `source.source: 'unsupported' is a parse-time placeholder and cannot be authored` | エラー | `plugins[i].source` |492| `source.source: 'unsupported' is a parse-time placeholder and cannot be authored` | エラー | `plugins[i].source` |

491| `Plugin "x" sets headersHelper but is not "strict": false` | エラー | `plugins[i].headersHelper`、`archive` エントリ上 |493| `Plugin "x" sets headersHelper but is not "strict": false` | エラー | `plugins[i].headersHelper`(`archive` エントリ上) |

492| `chain does not resolve (<reason>) — target must be a name in plugins[], a key in renames, or null` | エラー | `renames.<old>` |494| `chain does not resolve (<reason>) — target must be a name in plugins[], a key in renames, or null` | エラー | `renames.<old>` |

493| `target "x" is not a valid plugin name (PluginIdSchema)` | エラー | `renames.<old>` |495| `target "x" is not a valid plugin name (PluginIdSchema)` | エラー | `renames.<old>` |

494| `Unknown field 'x'. Claude Code ignores it at load time.` | 警告 | トップレベル、`metadata` の下、エントリ内、またはエントリの `relevance` の下の名前付きキー |496| `Unknown field 'x'. Claude Code ignores it at load time.` | 警告 | トップレベル、`metadata` の下、エントリ内、またはエントリの `relevance` の下の名前付きキー |

495| `Marketplace has no plugins defined` | 警告 | `plugins` が空です |497| `Marketplace has no plugins defined` | 警告 | `plugins` が空です |

496| `Plugin "x" sets headers/headersHelper, which only apply to "archive" sources; they have no effect on this entry.` | 警告 | `plugins[i].headers` または `plugins[i].headersHelper`、`source` が `archive` ではないエントリ上 |498| `Plugin "x" sets headers/headersHelper, which only apply to "archive" sources; they have no effect on this entry.` | 警告 | `plugins[i].headers` または `plugins[i].headersHelper`(`source` が `archive` ではないエントリ上) |

497| `Plugin "x" fetches its archive with a headersHelper but sets no sha256 pin` | 警告 | `plugins[i].source.sha256` |499| `Plugin "x" fetches its archive with a headersHelper but sets no sha256 pin` | 警告 | `plugins[i].source.sha256` |

498| `Header "x" is a request-routing/identity header that catalog entries may not set; Claude Code drops it at download time.` | 警告 | `plugins[i].headers.<name>` |500| `Header "x" is a request-routing/identity header that catalog entries may not set; Claude Code drops it at download time.` | 警告 | `plugins[i].headers.<name>` |

499| `Local source "x" is or traverses a symlink, so <path> was not read` | 警告 | `plugins[i].source` |501| `Local source "x" is or traverses a symlink, so <path> was not read` | 警告 | `plugins[i].source` |

500| `No marketplace description provided. Adding a description helps users understand what this marketplace offers` | 警告 | `description` |502| `No marketplace description provided. Adding a description helps users understand what this marketplace offers` | 警告 | `description` |

501| `Entry declares version "x" but <path>/plugin.json says "y". At install time, plugin.json wins` | 警告 | `plugins[i].version`、相対パスエントリ上 |503| `Entry declares version "x" but <path>/plugin.json says "y". At install time, plugin.json wins` | 警告 | `plugins[i].version`(相対パスエントリ上) |

502| `'relevance' must be an object containing topic and signals; got <type>. It will be ignored at load time.` | 警告 | `plugins[i].relevance` |504| `'relevance' must be an object containing topic and signals; got <type>. It will be ignored at load time.` | 警告 | `plugins[i].relevance` |

503| `'metadata' must be a free-form object; got <type>. It will be ignored at load time.` | 警告 | `plugins[i].metadata` |505| `'metadata' must be a free-form object; got <type>. It will be ignored at load time.` | 警告 | `plugins[i].metadata` |

504| `'experimental' must be an object containing component declarations; got <type>. It will be ignored at load time.` | 警告 | `plugins[i].experimental` |506| `'experimental' must be an object containing component declarations; got <type>. It will be ignored at load time.` | 警告 | `plugins[i].experimental` |

505| `Marketplace name "x" is reserved in Claude Desktop` | 警告 | `name` が `org`、`org-provisioned`、または `unknown` です。Claude Desktop はマーケットプレイスを拒否します |507| `Marketplace name "x" is reserved in Claude Desktop` | 警告 | `name` が `org`、`org-provisioned`、または `unknown` です。Claude Desktop がマーケットプレイスを拒否します |

506| `Marketplace name "x" is not accepted by Claude Desktop (letters, digits, ".", "_", "-"; must start alphanumeric; max 128 chars)` | 警告 | `name`。Claude Desktop はマーケットプレイスを拒否します |508| `Marketplace name "x" is not accepted by Claude Desktop (letters, digits, ".", "_", "-"; must start alphanumeric; max 128 chars)` | 警告 | `name`。Claude Desktop がマーケットプレイスを拒否します |

507| `Plugin name "x" is not accepted by Claude Desktop (letters, digits, ".", "_", "-"; must start alphanumeric; max 128 chars)` | 警告 | `plugins[i].name`。Claude Desktop はエントリを削除します |509| `Plugin name "x" is not accepted by Claude Desktop (letters, digits, ".", "_", "-"; must start alphanumeric; max 128 chars)` | 警告 | `plugins[i].name`。Claude Desktop がエントリをドロップします |

508 510 

509<h3 id="invalid-input-on-a-source">511<h3 id="invalid-input-on-a-source">

510 source の無効な入力512 source の無効な入力

511</h3>513</h3>

512 514 

513`source` の `Invalid input` は、オブジェクトがどのソースタイプにも一致しなかったことを意味します。これらの原因を確認してください:515`source` の `Invalid input` は、オブジェクトがどのソースタイプにも一致しなかったことを意味します。以下の原因をチェックしてください。

514 516 

515* `./` で始まらない相対パス。ただし `"."` または [metadata.pluginRoot の下のベアネーム](#relative-path-plugin-source) を除く517* `./` で始まらない相対パス(`"."` または [metadata.pluginRoot の下のベア名](#relative-path-plugin-source) を除く)

516* `..` を含む `npm` `package`518* `..` を含む `npm` `package`

517* [プラグインソース](#plugin-sources) の 1 つではない `source` タイプ519* [プラグインソース](#plugin-sources) の 1 つではない `source` タイプ

518* `github` なしの `repo` など、必須フィールドが欠落しているか間違った型の既知のタイプ520* `github` に `repo` がないなど、必須フィールドが欠落しているか、型が間違っている既知のタイプ

519 521 

520<h3 id="failures-that-validation-doesn’t-catch">522<h3 id="failures-that-validation-doesn’t-catch">

521 検証が検出しない失敗523 検証が検出しない失敗

522</h3>524</h3>

523 525 

524`claude plugin validate` はすべての失敗を報告するわけではありません。ファイルパスまたは配列として記述されたエントリ `hooks` は検証に合格し、エラーはプラグインが読み込まれるときにのみ表示されます。[エントリ内の Hooks](#hooks-in-an-entry) で説明されているとおりです。`source` をフェッチするエラーも、検証時ではなくインストール後にのみ表示されます。526`claude plugin validate` はすべての失敗を報告するわけではありません。ファイルパスまたは配列として記述されたエントリ `hooks` は検証に合格し、エラーはプラグインが読み込まれるときにのみ表示されます。[エントリ内の Hooks](#hooks-in-an-entry) で説明されているとおりです。`source` をフェッチするエラーも、検証時ではなく、インストール後にのみ表示されます。

525 527 

526[`claude plugin list`](/docs/ja/plugins/cli-reference) は読み込みに失敗したプラグインをそのエラーとともに表示し、[プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting) は読み込み時の文字列をカバーしています。528[`claude plugin list`](/docs/ja/plugins/cli-reference) は読み込みに失敗したプラグインをそのエラーとともに表示し、[プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting) は読み込み時の文字列をカバーしています。

527 529 

Details

145 `Marketplace "<name>" not found`145 `Marketplace "<name>" not found`

146</h3>146</h3>

147 147 

148セッションで `/plugin install <plugin>@<name>` を実行し、多くの場合は誰かが送信したインストール行から、Claude Code はこの名前のマーケットプレイスがないと報告しました。148セッションで `/plugin install` を実行し、Claude Code はこの名前のマーケットプレイスがないと報告しました。このコマンドの 2 つの形式がこのメッセージに到達します:

149 

150* **`/plugin install <plugin>@<name>`**:インストール行(多くの場合は誰かが送信したもの)は、追加していないマーケットプレイスを名前付けします。このエントリの残りの部分は、それを見つけて追加することをカバーしています。

151* **`/plugin install <source>`(パス、URL、または `owner/repo` を使用)**:このフォームは、既に追加したソースであっても、インストールする代わりにメッセージを報告します。1 つのコマンドでソースからインストールするには、[マーケットプレイスを追加してインストール](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください。

149 152 

150名前が `claudeai-` で始まる場合、マーケットプレイスは claude.ai でホストされており、シェルから `claude plugin marketplace add --claudeai <name>` で名前で追加します。[claude.ai からマーケットプレイスを追加](/docs/ja/plugins/install#add-from-claude-ai)を参照してください。153名前が `claudeai-` で始まる場合、マーケットプレイスは claude.ai でホストされており、シェルから `claude plugin marketplace add --claudeai <name>` で名前で追加します。[claude.ai からマーケットプレイスを追加](/docs/ja/plugins/install#add-from-claude-ai)を参照してください。

151 154 


646 649 

647次に、セッションで `/reload-plugins` を実行してください。**Errors** タブエントリが消え、プラグインが **Installed** の下に戻ります。650次に、セッションで `/reload-plugins` を実行してください。**Errors** タブエントリが消え、プラグインが **Installed** の下に戻ります。

648 651 

652<h3 id="installed-plugins-json-holds-a-record-this-version-cannot-read">

653 `installed_plugins.json holds a record under "<id>" that this version of Claude Code cannot read`

654</h3>

655 

656メッセージは次の形式で表示されます。

657 

658* **`claude plugin list`**: `Note:` として出力します

659* **`claude plugin install`、`uninstall`、および `update`**: `Plugin "<name>" was not installed:`、`Plugin "<name>" was not uninstalled:`、または `Plugin "<name>" was not updated:` で拒否し、その後に同じテキストが続きます

660* **これら 3 つのコマンドのいずれかで `--json`**: 結果行は同じ `message` と `failureCode: "install_records_unreadable"` を含みます

661* **複数のそのようなレコード**: メッセージは `holds records under` と読みます

662* **ファイル全体がこのバージョンが知らない形式を宣言する**: メッセージは代わりに `installed_plugins.json is in a format (version <N>) that this version of Claude Code does not know` と読みます

663 

664`installed_plugins.json` の名前付きレコードは有効なプラグイン ID の下で有効な JSON ですが、そのフィールドはこのバージョンに対して解析されません。おそらく Claude Code の別のバージョン(おそらくより新しいバージョン)がそれを書きました。

665 

666レコードがある間、このバージョンはファイルを書き直さないため、レコードは失われません。

667 

668メッセージのオプションを順番に実行してください。

669 

6701. `claude update` で Claude Code を更新してください。

6712. 更新できない場合は、レコードを書いた Claude Code のバージョンで名前付きプラグインをアンインストールしてください。

6723. どちらも役に立たない場合は、`installed_plugins.json` からレコードを手動で削除してから、Claude Code を再起動するか `/reload-plugins` を実行してください。

673 

674<h3 id="installed-plugins-json-could-not-be-read-and-was-rebuilt">

675 `installed_plugins.json could not be read and was rebuilt`

676</h3>

677 

678`claude plugin list` はこのメモを出力し、`installed_plugins.json` の横に `installed_plugins.unreadable.<date>.<hash>.kept` という名前の保持されたファイルのパスを出力します。そのファイルが `installed_plugins.json` の横に存在する限り。

679 

680有効な JSON ではない、またはプラグインのリストではない `installed_plugins.json` は、インストールしたものを言うことができません。

681 

682`.kept` ファイルを開いて、古いファイルが何を記録したかを確認し、不足しているプラグインを再度インストールしてください。Claude Code はファイルを再度読み込むことはなく、ファイルは [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) スケジュールで期限切れになります。

683 

684<h3 id="install-records-under-names-that-no-version-can-use">

685 `install records under names that no version of Claude Code can use were removed from installed_plugins.json`

686</h3>

687 

688`claude plugin list` はこのメモを出力し、`installed_plugins.json` の横に `installed_plugins.set-aside.<date>.<hash>.json` という名前のコピーのパスを出力します。そのコピーが `installed_plugins.json` の横に存在する限り。メモは `Nothing needs doing about these copies.` で終わります。

689 

690`installed_plugins.json` のレコードは、Claude Code のどのバージョンも使用できない有効なプラグイン ID ではないキーの下に存在していたため、ファイルの残りは正常にロードされます。

691 

692Claude Code は使用不可能なレコードを `.set-aside` ファイルにコピーし、リストからドロップします。Claude Code はコピーを再度読み込むことはなく、コピーは [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) スケジュールで期限切れになります。

693 

649<h3 id="a-plugin-you-disabled-still-loads">694<h3 id="a-plugin-you-disabled-still-loads">

650 `Disabled in ~/.claude/settings.json but still loads`695 `Disabled in ~/.claude/settings.json but still loads`

651</h3>696</h3>


981| `Path contains "..": <path>` under `plugins[N].source` | エラー | `..` セグメントなしでマーケットプレイスルートに対して相対パスを使用してください。 |1026| `Path contains "..": <path>` under `plugins[N].source` | エラー | `..` セグメントなしでマーケットプレイスルートに対して相対パスを使用してください。 |

982| `Marketplace name cannot contain control or bidirectional-formatting characters` | エラー | 名前からエスケープまたは改行などの文字を削除してください。 |1027| `Marketplace name cannot contain control or bidirectional-formatting characters` | エラー | 名前からエスケープまたは改行などの文字を削除してください。 |

983| `Plugin name cannot contain control or bidirectional-formatting characters` | エラー | プラグイン `name` から文字を削除してください。 |1028| `Plugin name cannot contain control or bidirectional-formatting characters` | エラー | プラグイン `name` から文字を削除してください。 |

1029| `Claude Code cannot install plugins from marketplace "<name>". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name".` | エラー | マーケットプレイスの名前をメッセージが述べるルールに合わせて変更してください。 |

1030| `Claude Code cannot install plugin "<name>". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | エラー | エントリの名前をメッセージが述べるルールに合わせて変更してください。 |

984| `Marketplace has no plugins defined` | 警告 | `plugins` に少なくとも 1 つのエントリを追加してください。 |1031| `Marketplace has no plugins defined` | 警告 | `plugins` に少なくとも 1 つのエントリを追加してください。 |

985| `No marketplace description provided` | 警告 | トップレベルの `description` を追加してください。 |1032| `No marketplace description provided` | 警告 | トップレベルの `description` を追加してください。 |

986| `Plugin name "<name>" is not kebab-case` under `plugins[N] plugin.json → name` | 警告 | 小文字、数字、ハイフンに名前を変更してください。Claude Code は他の形式を受け入れますが、claude.ai マーケットプレイス同期はそれらを拒否します。 |1033| `Plugin name "<name>" is not kebab-case` under `plugins[N] plugin.json → name` | 警告 | 小文字、数字、ハイフンに名前を変更してください。claude.ai マーケットプレイス同期はその形式を必要とします。 |

987| `Entry declares version "<a>" but <path>/plugin.json says "<b>"` | 警告 | エントリを `plugin.json` と一致するように更新してください。これはインストール時に権威です。 |1034| `Entry declares version "<a>" but <path>/plugin.json says "<b>"` | 警告 | エントリを `plugin.json` と一致するように更新してください。これはインストール時に権威です。 |

988| `Marketplace name "<name>" is reserved in Claude Desktop` | 警告 | マーケットプレイスの名前を変更してください。Claude Desktop の管理マーケットプレイス同期は、任意のケースで `org`、`org-provisioned`、`unknown` を拒否します。 |1035| `Marketplace name "<name>" is reserved in Claude Desktop` | 警告 | マーケットプレイスの名前を変更してください。Claude Desktop の管理マーケットプレイス同期は、任意のケースで `org`、`org-provisioned`、`unknown` を拒否します。 |

989| `Marketplace name "<name>" is not accepted by Claude Desktop` または `Plugin name "<name>" is not accepted by Claude Desktop` | 警告 | 最大 128 文字の文字、数字、`.`、`_`、`-` に名前を変更し、文字または数字で始まります。 |1036| `Marketplace name "<name>" is not accepted by Claude Desktop` または `Plugin name "<name>" is not accepted by Claude Desktop` | 警告 | 最大 128 文字の文字、数字、`.`、`_`、`-` に名前を変更し、文字または数字で始まります。 |

Details

412| - | - |412| - | - |

413| `DISABLE_PROMPT_CACHING` | すべてのモデルに対して無効にする |413| `DISABLE_PROMPT_CACHING` | すべてのモデルに対して無効にする |

414| `DISABLE_PROMPT_CACHING_HAIKU` | デフォルトの Haiku モデルに対して無効にする |414| `DISABLE_PROMPT_CACHING_HAIKU` | デフォルトの Haiku モデルに対して無効にする |

415| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet のみに対して無効にする |415| `DISABLE_PROMPT_CACHING_SONNET` | デフォルトの Sonnet モデルに対して無効にする |

416| `DISABLE_PROMPT_CACHING_OPUS` | Opus のみに対して無効にする |416| `DISABLE_PROMPT_CACHING_OPUS` | デフォルトの Opus モデルに対して無効にする |

417| `DISABLE_PROMPT_CACHING_FABLE` | Fable のみに対して無効にする |417| `DISABLE_PROMPT_CACHING_FABLE` | Fable のみに対して無効にする |

418 418 

419`DISABLE_PROMPT_CACHING_HAIKU` はデフォルトの Haiku モデル、`haiku` エイリアスが解決するモデルに適用されます。そのモデルがメインモデルである場合のメイン会話を含め、そのモデルが実行される場所ならどこでもキャッシングを無効にします。メイン会話をカバーするには Claude Code v2.1.283 以降が必要です。419`DISABLE_PROMPT_CACHING_HAIKU` はデフォルトの Haiku モデル、`haiku` エイリアスが解決するモデルに適用されます。そのモデルがメインモデルである場合のメイン会話を含め、そのモデルが実行される場所ならどこでもキャッシングを無効にします。メイン会話をカバーするには Claude Code v2.1.283 以降が必要です。


422 422 

423メインモデルとしてピン留めした別の Haiku バージョンはキャッシングを保持します。それに対してキャッシングを無効にするには `DISABLE_PROMPT_CACHING` を設定してください。423メインモデルとしてピン留めした別の Haiku バージョンはキャッシングを保持します。それに対してキャッシングを無効にするには `DISABLE_PROMPT_CACHING` を設定してください。

424 424 

425`DISABLE_PROMPT_CACHING_SONNET` と `DISABLE_PROMPT_CACHING_OPUS` はそれぞれ、`sonnet` または `opus` エイリアスが解決するモデルに適用されます。別の Sonnet または Opus モデル ID をメインモデルとして設定した場合、そのモデルはキャッシングを保持します。たとえば、`claude-sonnet-5` でのセッションはキャッシングを保持しますが、`sonnet` は `claude-sonnet-5-5` に解決されます。そのモデルに対してキャッシングを無効にするには、`DISABLE_PROMPT_CACHING` を設定してください。

426 

425組織全体でキャッシングポリシーを設定するには、これらのいずれかまたは [TTL 変数](#cache-lifetime)を [管理設定](/docs/ja/managed-settings)の `env` ブロックに入れます。通常の使用では、キャッシングを有効のままにしてください。427組織全体でキャッシングポリシーを設定するには、これらのいずれかまたは [TTL 変数](#cache-lifetime)を [管理設定](/docs/ja/managed-settings)の `env` ブロックに入れます。通常の使用では、キャッシングを有効のままにしてください。

426 428 

427<h2 id="related-resources">429<h2 id="related-resources">

Details

34 * `DISABLE_TELEMETRY` または `DO_NOT_TRACK` のみを設定した場合、組織が [Trusted Devices](#trusted-devices) を要求しない限り、Remote Control は利用可能なままです。要求する場合は、Remote Control を使用するために変数を設定解除してください。いずれかの変数を設定した状態で Remote Control を使用するには、Claude Code v2.1.283 以降が必要です。34 * `DISABLE_TELEMETRY` または `DO_NOT_TRACK` のみを設定した場合、組織が [Trusted Devices](#trusted-devices) を要求しない限り、Remote Control は利用可能なままです。要求する場合は、Remote Control を使用するために変数を設定解除してください。いずれかの変数を設定した状態で Remote Control を使用するには、Claude Code v2.1.283 以降が必要です。

35* **ワークスペース信頼**: まだ信頼していないディレクトリで、`claude remote-control` は信頼を有効にする内容を出力し、開始する前に `Trust <directory>? [y/N]` と尋ねます。`y` と答えると選択が保存されます。ただし、ホームディレクトリでは信頼は保存されず、実行するたびに質問が返されます。標準入力または出力がターミナルでない場合、コマンドは質問できず、[`Workspace not trusted`](/docs/ja/errors#workspace-not-trusted-when-starting-remote-control) エラーで終了します。35* **ワークスペース信頼**: まだ信頼していないディレクトリで、`claude remote-control` は信頼を有効にする内容を出力し、開始する前に `Trust <directory>? [y/N]` と尋ねます。`y` と答えると選択が保存されます。ただし、ホームディレクトリでは信頼は保存されず、実行するたびに質問が返されます。標準入力または出力がターミナルでない場合、コマンドは質問できず、[`Workspace not trusted`](/docs/ja/errors#workspace-not-trusted-when-starting-remote-control) エラーで終了します。

36 36 

37***

38 

39title: "リモートコントロールセッションを開始する"

40description: "CLI、Claude Desktop アプリ、または VS Code 拡張機能からリモートコントロールセッションを開始する方法を学びます。"

41------------------------------------------------------------------------------------

42 

37<h2 id="start-a-remote-control-session">43<h2 id="start-a-remote-control-session">

38 リモートコントロールセッションを開始する44 リモートコントロールセッションを開始する

39</h2>45</h2>


200 206 

201同じトグルは CLI の外に表示されます:207同じトグルは CLI の外に表示されます:

202 208 

203* **Desktop アプリ**:**Settings > Claude Code > Enable remote control by default**。209* **Desktop アプリ**:**Settings > Claude Code > Connect new sessions to Remote Control**。

204* **VS Code 拡張機能**:[コマンドメニューの](/docs/ja/vs-code#use-the-prompt-box) Settings セクションの **Enable Remote Control for all sessions**。210* **VS Code 拡張機能**:[コマンドメニューの](/docs/ja/vs-code#use-the-prompt-box) Settings セクションの **Enable Remote Control for all sessions**。

205 211 

206代わりに設定ファイルから自動接続をオンにするには、ユーザー `~/.claude/settings.json` または [管理設定](/docs/ja/managed-settings)で [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を `true` に設定します。プロジェクトまたはローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)では、Claude Code は `false` を尊重し、そのリポジトリの自動接続をオフにしますが、`true` は無視するため、チェックインされたファイルはリポジトリを開くすべての人のリモートコントロールをオンにすることはできません。212代わりに設定ファイルから自動接続をオンにするには、ユーザー `~/.claude/settings.json` または [管理設定](/docs/ja/managed-settings)で [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を `true` に設定します。プロジェクトまたはローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)では、Claude Code は `false` を尊重し、そのリポジトリの自動接続をオフにしますが、`true` は無視するため、チェックインされたファイルはリポジトリを開くすべての人のリモートコントロールをオンにすることはできません。

routines.md +16 −6

Details

66 66 

67その他のすべての場合(新しい artifact を公開する場合を含む)、Claude は最初に確認します。ルーチンの仕事がページを最新に保つことである場合、既に公開した artifact を与えます。67その他のすべての場合(新しい artifact を公開する場合を含む)、Claude は最初に確認します。ルーチンの仕事がページを最新に保つことである場合、既に公開した artifact を与えます。

68 68 

69ルーチンは個別の claude.ai アカウントに属します。チームメイトと共有されず、アカウントの日次実行許容量に対してカウントされます。ルーチンが接続された GitHub ID またはコネクタを通じて実行するすべてのことは、あなたとして表示されます。コミットとプルリクエストは GitHub ユーザーを含み、Slack メッセージ、Linear チケット、またはその他のコネクタアクションはこれらのサービスのリンクされたアカウントを使用します。69ルーチンは個別の claude.ai アカウントに属します。チームメイトと共有されず、アカウントの [usage and limits](#usage-and-limits) に対してカウントされます。ルーチンが接続された GitHub ID またはコネクタを通じて実行するすべてのことは、あなたとして表示されます。コミットとプルリクエストは GitHub ユーザーを含み、Slack メッセージ、Linear チケット、またはその他のコネクタアクションはこれらのサービスのリンクされたアカウントを使用します。

70 70 

71<h3 id="create-from-the-web">71<h3 id="create-from-the-web">

72 ウェブから作成する72 ウェブから作成する


174 174 

175定期的なスケジュールと同じローカル UTC 変換が 1 回限りのタイムスタンプに適用されます。175定期的なスケジュールと同じローカル UTC 変換が 1 回限りのタイムスタンプに適用されます。

176 176 

1771 回限りの実行は日次ルーティン実行上限にカウントされません。詳細については、[使用量と制限](#usage-and-limits) を参照してください。1771 回限りの実行は他のスケジュール実行と同じ時間単位の制限にカウントされます。詳細については、[使用量と制限](#usage-and-limits) を参照してください。

178 178 

179<h3 id="add-an-api-trigger">179<h3 id="add-an-api-trigger">

180 API トリガーを追加する180 API トリガーを追加する


256GitHub トリガーは、接続されたリポジトリで一致するイベントが発生したときに、新しいセッションを自動的に開始します。Claude Code はイベント間でセッションを再利用しないため、2 つの PR 更新は 2 つの独立したセッションを生成します。256GitHub トリガーは、接続されたリポジトリで一致するイベントが発生したときに、新しいセッションを自動的に開始します。Claude Code はイベント間でセッションを再利用しないため、2 つの PR 更新は 2 つの独立したセッションを生成します。

257 257 

258<Note>258<Note>

259 リサーチプレビュー中、GitHub webhook イベントはルーティンごとおよびアカウントごとの時間単位の上限の対象です。制限を超えるイベントはウィンドウがリセットされるまでドロップされます。現在の制限は [claude.ai/code/routines](https://claude.ai/code/routines) で確認してください。259 GitHub webhook イベントはルーティンごとおよびアカウントごとの時間単位の上限の対象です。制限を超えるイベントはウィンドウがリセットされるまでドロップされます。

260</Note>260</Note>

261 261 

262Claude GitHub App は、サブスクライブするリポジトリにインストールする必要があります。262Claude GitHub App は、サブスクライブするリポジトリにインストールする必要があります。


421 使用と制限421 使用と制限

422</h2>422</h2>

423 423 

424ルーティンは対話型セッションと同じ方法でサブスクリプション使用量を削減します。標準的なサブスクリプション制限に加えて、ルーティンはアカウントごとに 1 日に開始できる実行数の上限があります。現在の消費と残りの日次ルーティン実行数は [claude.ai/code/routines](https://claude.ai/code/routines) または [claude.ai/settings/usage](https://claude.ai/settings/usage) で確認してください。424ルーティンは対話型セッションと同じ方法でサブスクリプション使用量を削減します。現在の消費は [claude.ai/settings/usage](https://claude.ai/settings/usage) で確認してください。

425 425 

426ルーティンが日次上限またはサブスクリプション使用制限に達したとき、使用クレジットが有効な組織は、メーター付きオーバーエッジでルーティンを実行し続けることができます。使用クレジットがない場合、ウィンドウがリセットされるまで追加実行は拒否されます。[claude.ai/settings/usage](https://claude.ai/settings/usage) で使用クレジットを有効にしてください。Team プランと Enterprise プランでは、管理者が [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) で組織の使用クレジットを有効にします。426サブスクリプション使用量とは別に、実行を開始する各方法には時間単位の制限があります。

427 427 

4281 回限りの実行は日次ルーティン実行上限にはカウントされません。他のセッションと同じように通常のサブスクリプション使用量を削減します。428| アクション | 制限 | カウント対象 | 制限超過時 |

429| :- | :- | :- | :- |

430| スケジュール実行(1 回限りの実行を含む) | 1 時間あたり 100 回 | アカウント | 制限がリセットされるまで実行は待機します |

431| **今すぐ実行**、API 発火、および 1 回限りのルーティンを再度実行するように設定 | 1 時間あたり 30 回 | 各ルーティン、3 つすべてで共有される 1 カウント | 制限がリセットされるまでアクションは失敗します |

432| **今すぐ実行**および 1 回限りのルーティンを再度実行するように設定 | 1 時間あたり 100 回 | アカウント | 同じ |

433| API 発火 | 1 時間あたり 100 回 | アカウント、**今すぐ実行**とは別にカウント | 同じ |

434| GitHub イベント | [GitHub トリガーを追加](#add-a-github-trigger)を参照 | | |

435 

436これらの時間単位の制限にはオーバーエッジがありません。

437 

438ルーティンがサブスクリプション使用制限に達したとき、使用クレジットが有効な組織はメーター付きオーバーエッジでルーティンを実行し続けることができます。使用クレジットがない場合、使用ウィンドウがリセットされるまで追加実行は拒否されます。[claude.ai/settings/usage](https://claude.ai/settings/usage) で使用クレジットを有効にしてください。Team プランと Enterprise プランでは、管理者が [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) で組織の使用クレジットを有効にします。

429 439 

430サブスクリプションが一時停止されている間、ルーティンは保留中になり、実行されません。サブスクリプションが再度アクティブになったら、ルーティンを再度有効にしてください。440サブスクリプションが一時停止されている間、ルーティンは保留中になり、実行されません。サブスクリプションが再度アクティブになったら、ルーティンを再度有効にしてください。

431 441 

Details

88組み込みツール、MCP サーバー、hooks をすべて 1 つの OS 境界の背後に配置するには、Claude Code プロセス全体を [サンドボックスランタイム](#sandbox-runtime)、[dev コンテナ](#dev-containers)、または [カスタムコンテナ](#custom-container)内で実行してください。88組み込みツール、MCP サーバー、hooks をすべて 1 つの OS 境界の背後に配置するには、Claude Code プロセス全体を [サンドボックスランタイム](#sandbox-runtime)、[dev コンテナ](#dev-containers)、または [カスタムコンテナ](#custom-container)内で実行してください。

89 89 

90<h2 id="sandbox-runtime">90<h2 id="sandbox-runtime">

91 サンドボックスランタイム91 Sandbox ランタイム

92</h2>92</h2>

93 93 

94[`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) パッケージは、組み込みの Bash サンドボックスが使用するのと同じ Seatbelt または bubblewrap 分離でプロセス全体をラップします。Claude Code をそれを通して実行すると、シェルコマンドだけでなく、セッション内のすべてのツール、hook、MCP サーバーが制限されます。ランタイムはベータ研究プレビューであり、パッケージが進化するにつれて設定形式が変わる可能性があります。94[`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) パッケージは、プロセス全体を、組み込み Bash sandbox が使用するのと同じ Seatbelt または bubblewrap 分離でラップします。Claude Code をランタイムを通じて実行すると、シェルコマンドだけでなく、セッション内のすべてのツール、hook、MCP サーバーが制約されます。ランタイムはベータ版の研究プレビューであり、パッケージの進化に伴い、その設定形式が変わる可能性があります。

95 95 

96このセクションでは、設定する内容とランタイムが独自に実施する内容について説明します。Agent SDK アプリケーションでランタイムをデプロイする場合は、[セキュアデプロイメントガイド](/docs/ja/agent-sdk/secure-deployment#sandbox-runtime)を参照してください。96このセクションでは、設定する内容とランタイムが独自に実施する内容について説明します。Agent SDK アプリケーションでランタイムをデプロイする場合は、[セキュアデプロイメントガイド](/docs/ja/agent-sdk/secure-deployment#sandbox-runtime)を参照してください。

97 97 


99 ランタイムのセットアップと起動99 ランタイムのセットアップと起動

100</h3>100</h3>

101 101 

102Linux と WSL2 では、ランタイムは組み込みサンドボックスと同じ `bubblewrap` および `socat` パッケージに加えて、Claude Code がバンドルしているが、スタンドアロンランタイムは PATH から解決する `ripgrep` に依存しています。[Linux と WSL2 のセットアップ](/docs/ja/sandboxing#set-up-linux-and-wsl2)で説明されているように `bubblewrap` と `socat` をインストールし、ディストリビューションのパッケージマネージャーから `ripgrep` をインストールしてください。macOS では追加のパッケージは必要ありません。ランタイムはそこで組み込みの Seatbelt サンドボックスを使用します。102Linux と WSL2 では、ランタイムは組み込み sandbox と同じ `bubblewrap` および `socat` パッケージに加えて、`ripgrep` に依存します。Claude Code はこれをバンドルしていますが、スタンドアロンランタイムは PATH から解決します。[Linux と WSL2 のセットアップ](/docs/ja/sandboxing#set-up-linux-and-wsl2)で説明されているように `bubblewrap` と `socat` をインストールし、ディストリビューションのパッケージマネージャーから `ripgrep` をインストールしてください。macOS では追加のパッケージは不要です。ランタイムはそこで組み込み Seatbelt sandbox を使用します。

103 103 

104デフォルトでは、ランタイムはネットワークアクセスを拒否し、書き込みを小さな組み込みランタイムパスセットに限定するため、Claude Code を起動する前に設定してください。設定を `~/.srt-settings.json` に、または `--settings` で渡すファイルに配置します。パッケージ [README](https://github.com/anthropic-experimental/sandbox-runtime) は完全な設定スキーマを文書化しています。104デフォルトでは、ランタイムはネットワークアクセスを拒否し、書き込みを組み込みランタイムパスの小さなセットに限定するため、Claude Code を通じて起動する前に設定してください。設定を `~/.srt-settings.json` に配置するか、`--settings` で渡すファイルに配置します。パッケージの [README](https://github.com/anthropic-experimental/sandbox-runtime) に完全な設定スキーマが記載されています。

105 105 

106少なくとも以下への書き込みアクセスを許可してください。106少なくとも以下への書き込みアクセスを許可してください:

107 107 

108* プロジェクトディレクトリ。108* プロジェクトディレクトリ。

109* Claude Code の設定パス `~/.claude` および `~/.claude.json`。109* Claude Code の設定パス `~/.claude` および `~/.claude.json`。

110* `/tmp`。Claude Code はランタイムファイルをここに書き込みます。110* `/tmp`。Claude Code はここにランタイムファイルを書き込みます。

111 111 

112セッションが必要とするネットワークドメインを許可してください。112セッションが必要とするネットワークドメインを許可してください:

113 113 

114* `api.anthropic.com`、またはプロバイダーのエンドポイント。サードパーティプロバイダーでは、`api.anthropic.com` も保持してください。WebFetch ドメインセーフティチェックは、`skipWebFetchPreflight: true` を設定しない限り、デフォルトでそれを呼び出します。114* `api.anthropic.com`、またはカスタマーが設定したプロバイダーのエンドポイント。サードパーティプロバイダーでは、`api.anthropic.com` も保持してください。WebFetch ドメインセーフティチェックは、`skipWebFetchPreflight: true` を設定しない限り、デフォルトでそれを呼び出します。

115* `claude.ai` および `platform.claude.com`。[OAuth サインインとトークンリフレッシュ](/docs/ja/network-config#network-access-requirements)に必要です。API キーで認証されたランは、これら 2 つを削除できます。115* `claude.ai` および `platform.claude.com`。[OAuth サインインとトークンリフレッシュ](/docs/ja/network-config#network-access-requirements)に必要です。API キーで認証されたランは、これら 2 つを削除できます。

116 116 

117Linux と WSL2 では、ランタイムは既に存在するパスにのみ書き込み許可を適用します。新しい環境では、最初の起動前に Claude Code の設定パスを作成してください。117Linux と WSL2 では、ランタイムは既に存在するパスにのみ書き込み許可を適用します。新しい環境では、最初の起動前に Claude Code の設定パスを作成してください:

118 118 

119```bash theme={null}119```bash theme={null}

120mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }120mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }

121```121```

122 122 

123設定ファイルが配置されたら、`npx` で Claude Code を起動し、ラップするコマンドとして `claude` を渡します。123設定ファイルが配置されたら、`npx` で Claude Code を起動し、ラップするコマンドとして `claude` を渡します:

124 124 

125```bash theme={null}125```bash theme={null}

126npx @anthropic-ai/sandbox-runtime claude126npx @anthropic-ai/sandbox-runtime claude

127```127```

128 128 

129Claude Code はサンドボックス内で起動し、設定したファイルシステムとネットワーク境界があります。同じコマンドは、スタンドアロン MCP サーバーまたは他のヘルパープロセスのサンドボックス化に機能します。129Claude Code は、カスタマーが設定したファイルシステムおよびネットワーク境界を持つ sandbox 内で起動します。同じコマンドは、スタンドアロン MCP サーバーまたは他のヘルパープロセスのサンドボックス化に機能します。

130 130 

131<h3 id="what-the-runtime-blocks-on-its-own">131<h3 id="what-the-runtime-blocks-on-its-own">

132 ランタイムが独自にブロックするもの132 ランタイムが独自にブロックするもの

133</h3>133</h3>

134 134 

135ランタイムは、設定なしで最高リスクの書き込みをブロックします。135ランタイムは、カスタマーからの設定なしで最高リスクの書き込みをブロックします:

136 136 

137* `denyWrite` は `allowWrite` より優先されます。137* `denyWrite` は `allowWrite` より優先されます。

138* プロジェクトルートでは、ランタイムは `.git/hooks` を拒否し、`filesystem.allowGitConfig: true` を設定しない限り `.git/config` を拒否し、`.mcp.json`、`.claude/commands`、`.claude/agents`、およびシェルスタートアップファイルを拒否します。138* プロジェクトルートでは、ランタイムは `.git/hooks` を拒否し、`filesystem.allowGitConfig: true` を設定しない限り `.git/config` を拒否し、`.mcp.json`、`.claude/commands`、`.claude/agents`、およびシェルスタートアップファイルを拒否します。

139* macOS では、これらの拒否は書き込みが発生したときにチェックされるため、ネストされたファイルとセッション中に作成されたリポジトリもカバーします。139* macOS では、これらの拒否は書き込みが発生したときにチェックされるため、ネストされたファイルとセッション中に作成されたリポジトリもカバーします。

140* Linux と WSL2 では、ランタイムは起動時に拒否リストを構築します。プロジェクトルートを確実にカバーし、その時点で存在するネストされたコピーの最善の努力による浅いスキャンを行い、`git init`、`git clone`、またはスキャフォルディングなど、セッションが後で作成するものはカバーしません。README の `mandatoryDenySearchDepth` セクションはスキャンの正確なセマンティクスを説明しています。140* Linux と WSL2 では、ランタイムは起動時に拒否リストを構築します。プロジェクトルートを確実にカバーし、その時点で存在するネストされたコピーの浅いスキャンをベストエフォートで実行し、`git init`、`git clone`、またはスキャフォルディングなど、セッションが後で作成するものはカバーしません。README の `mandatoryDenySearchDepth` セクションでは、スキャンの正確なセマンティクスについて説明しています。

141* 有効な `~/.srt-settings.json` がない場合、ランタイムは起動しますが、ネットワークアクセスをブロックし、書き込みを `/tmp/claude`、`~/.npm/_logs`、`~/.claude/debug` などの組み込みランタイムパスに限定します。クリーンスタートを設定が読み込まれた証拠として受け取らないでください。141* `~/.srt-settings.json` が存在せず、`--settings` を渡さない場合、ランタイムは起動します。ネットワークアクセスをブロックし、書き込みを `/tmp/claude`、`~/.npm/_logs`、`~/.claude/debug` などの組み込みランタイムパスに限定します。クリーンスタートを設定が読み込まれた証拠として受け取らないでください。

142* `--settings` を渡すと、ファイルの読み込みに失敗した場合、ランタイムは起動を拒否します。142* 設定ファイルが存在するが空、読み取り不可、または無効な場合、ランタイムは起動を拒否します。これは `~/.srt-settings.json` でも、`--settings` で渡すファイルでも同じです。また、`--settings` ファイルが存在しない場合も起動を拒否します。

143 143 

144書き込み許可には、Claude Code が設定を読み込む他のパスも含まれるため、`denyWrite` でそれらを拒否してください。それらに書き込みできるサンドボックス化されたセッションは、次に Claude Code を起動するときに、サンドボックス化されていない hook、権限ルール、または MCP サーバーを永続化できます。144カスタマーの書き込み許可には、Claude Code が設定を読み込む他のパスも含まれるため、`denyWrite` でそれらを拒否してください。それらに書き込みできるサンドボックス化されたセッションは、次に Claude Code を起動するときに、サンドボックス化されていない hook、権限ルール、または MCP サーバーを永続化できます。

145 145 

146<h3 id="after-unattended-runs">146<h3 id="after-unattended-runs">

147 無人実行後147 無人実行後

Details

48* **ゼロデータ保持**: [ゼロデータ保持](/docs/ja/zero-data-retention)が有効になっている組織では利用できません。48* **ゼロデータ保持**: [ゼロデータ保持](/docs/ja/zero-data-retention)が有効になっている組織では利用できません。

49* **モデル推論**: セッションは Anthropic API を使用し、推論は[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)、または[LLM ゲートウェイ](/docs/ja/llm-gateway)を通じてルーティングできません。49* **モデル推論**: セッションは Anthropic API を使用し、推論は[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)、または[LLM ゲートウェイ](/docs/ja/llm-gateway)を通じてルーティングできません。

50* **サーフェス**: [claude.ai/code](https://claude.ai/code)、モバイルおよびデスクトップアプリ、[スケジュール済みルーチン](/docs/ja/routines)、およびターミナルから開始されたセッション([`claude --cloud`](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)または[`--environment`ディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)を使用)は、自己ホスト環境で実行できます。[Claude Tag](https://claude.com/docs/claude-tag/overview)セッションもそれらで実行できますが、Claude はまだそれらのセッションで[アクセスバンドル](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle)を使用できません。[Claude Security](/docs/ja/claude-security)および[Code Review](/docs/ja/code-review)セッションはまだそれらにルーティングされません。これら 2 つのサーフェスのサポートは別途提供されます。50* **サーフェス**: [claude.ai/code](https://claude.ai/code)、モバイルおよびデスクトップアプリ、[スケジュール済みルーチン](/docs/ja/routines)、およびターミナルから開始されたセッション([`claude --cloud`](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)または[`--environment`ディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)を使用)は、自己ホスト環境で実行できます。[Claude Tag](https://claude.com/docs/claude-tag/overview)セッションもそれらで実行できますが、Claude はまだそれらのセッションで[アクセスバンドル](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle)を使用できません。[Claude Security](/docs/ja/claude-security)および[Code Review](/docs/ja/code-review)セッションはまだそれらにルーティングされません。これら 2 つのサーフェスのサポートは別途提供されます。

51* **リポジトリ**: セッションは GitHub からリポジトリをチェックアウトします。[GitHub 認証オプション](/docs/ja/claude-code-on-the-web#github-authentication-options)を参照してください。51* **リポジトリ**: セッションは GitHub からリポジトリをチェックアウトします。[GitHub 認証オプション](/docs/ja/claude-code-on-the-web#github-authentication-options)を参照してください。GitHub Enterprise Server ホストについては、その[ネットワーク要件](/docs/ja/github-enterprise-server#network-requirements)を参照してください。

52* **請求**: 自己ホスト環境のセッションは、Anthropic ホスト環境のセッションと同じ方法で組織の Claude Code 使用量を消費します。52* **請求**: 自己ホスト環境のセッションは、Anthropic ホスト環境のセッションと同じ方法で組織の Claude Code 使用量を消費します。

53 53 

54<h2 id="why-self-host">54<h2 id="why-self-host">

Details

170 170 

171git ホストが認証情報を拒否するか、認証情報を設定しなかった場合、ランナーは数回再試行してから失敗します。リポジトリがセッションがプッシュする結果のリポジトリである場合、ランナーはリポジトリ準備に失敗します。セッションが読み取り専用のリポジトリの場合、[トラブルシューティング](#troubleshooting)はランナーがスキップする場合をカバーしています。ランナーはこれらの設定をセッション環境に渡しません。171git ホストが認証情報を拒否するか、認証情報を設定しなかった場合、ランナーは数回再試行してから失敗します。リポジトリがセッションがプッシュする結果のリポジトリである場合、ランナーはリポジトリ準備に失敗します。セッションが読み取り専用のリポジトリの場合、[トラブルシューティング](#troubleshooting)はランナーがスキップする場合をカバーしています。ランナーはこれらの設定をセッション環境に渡しません。

172 172 

173`GIT_SSH_COMMAND` または `GIT_ASKPASS` で名前を付けるプログラムを、セッションが書き込めない場所に保持してください。[強化チェックリスト](#harden-your-deployment)がフックディレクトリとラッパースクリプトに要求する方法と同じです。そのプログラムのコマンドラインのキーまたはファイルについても同じです。ランナー独自の git は、クローンまたはフェッチするときにそのプログラムを実行します。

174 

173チェックアウトディレクトリがランナープロセスと異なる uid で所有されている場合、git は操作を拒否します。`safe.directory` を追加してください:175チェックアウトディレクトリがランナープロセスと異なる uid で所有されている場合、git は操作を拒否します。`safe.directory` を追加してください:

174 176 

175```dockerfile theme={null}177```dockerfile theme={null}


184 186 

185プロキシは `--capacity 1` を必要とします。プロキシ URL はセッションごとであり、git 2.32 以降が必要です。古い git はプロキシがセッションを相互に分離するために使用する設定メカニズムを無視するためです。ランナーは要件のいずれかが満たされない場合、起動を拒否します。プロキシは Anthropic 側からフェッチするため、git ホストは Anthropic インフラストラクチャから到達可能である必要があります。これは Anthropic ホストセッションと同じ要件です。ネットワーク内でのみルーティング可能な git ホストの場合は、代わりに [`checkout` ライフサイクルフック](/docs/ja/self-hosted-environments-configuration#checkout)を使用してください。各ランナープロセスは一度に 1 つのセッションを処理するため、並列処理のためにより多くのレプリカを実行してください。プロキシが有効な場合、`--git-host-rewrite` と `--git-ssh-rewrite` は効果がありません:プロキシ URL は git ホストではなく `api.anthropic.com` を指します。187プロキシは `--capacity 1` を必要とします。プロキシ URL はセッションごとであり、git 2.32 以降が必要です。古い git はプロキシがセッションを相互に分離するために使用する設定メカニズムを無視するためです。ランナーは要件のいずれかが満たされない場合、起動を拒否します。プロキシは Anthropic 側からフェッチするため、git ホストは Anthropic インフラストラクチャから到達可能である必要があります。これは Anthropic ホストセッションと同じ要件です。ネットワーク内でのみルーティング可能な git ホストの場合は、代わりに [`checkout` ライフサイクルフック](/docs/ja/self-hosted-environments-configuration#checkout)を使用してください。各ランナープロセスは一度に 1 つのセッションを処理するため、並列処理のためにより多くのレプリカを実行してください。プロキシが有効な場合、`--git-host-rewrite` と `--git-ssh-rewrite` は効果がありません:プロキシ URL は git ホストではなく `api.anthropic.com` を指します。

186 188 

189<Warning>

190 このページの [Kubernetes](#kubernetes) および [Docker Compose](#docker-compose) レシピは `--capacity 4` を使用しています。`--use-anthropic-git-proxy` または `CLAUDE_RUNNER_USE_GIT_PROXY=1` をそのいずれかに追加する場合、容量を `1` に変更しないと、オーケストレーターがそれを再起動するたびにランナーは起動時に終了します。`--capacity 1` を設定し、並列処理のためにより多くのレプリカを実行してください。[ランナーが終了するとき](#when-the-runner-exits)はランナーが出力する行を示しています。

191</Warning>

192 

187ランナーは登録時に Anthropic にオプトインを報告し、起動時に `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` を出力します。オプトインの報告には Claude Code v2.1.267 以降が必要です。それより前のバージョンはフラグを受け入れますが、報告しないか、その行を出力しません。その後、オプトインランナー上の各セッションは、Anthropic 管理の git またはセッションごとのプロキシ URL のいずれかを使用します。セッションがセッションごとのプロキシ URL を使用する場合、ランナーは 1 つの `[runner:warn]` 行をログに記録します。193ランナーは登録時に Anthropic にオプトインを報告し、起動時に `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` を出力します。オプトインの報告には Claude Code v2.1.267 以降が必要です。それより前のバージョンはフラグを受け入れますが、報告しないか、その行を出力しません。その後、オプトインランナー上の各セッションは、Anthropic 管理の git またはセッションごとのプロキシ URL のいずれかを使用します。セッションがセッションごとのプロキシ URL を使用する場合、ランナーは 1 つの `[runner:warn]` 行をログに記録します。

188 194 

195<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

196 Anthropic 管理の git でプライベート認証局を信頼する

197</h4>

198 

199このセクションは、セッションが Anthropic 管理の git を使用するランナーの環境で `GIT_SSL_CAINFO` または `GIT_SSL_NO_VERIFY` を設定した場合に適用されます。説明する処理には、ランナーが Claude Code v2.1.283 以降を実行する必要があります。

200 

201ランナー上の git が TLS 検査プロキシが署名するプライベート認証局(CA)などのプライベート認証局を信頼する必要がある場合、通常のアプローチは次のように機能します:

202 

203* **システム証明書ストア**:ランナーホストのシステム証明書ストアに CA をインストールし、git は変数なしでそれを信頼します。

204* **`GIT_SSL_CAINFO`**:CA の PEM ファイルに設定します。例えば `GIT_SSL_CAINFO=/etc/ssl/corp-ca.pem`。

205* **`GIT_SSL_NO_VERIFY`**:再署名プロキシの背後では役に立ちません。Anthropic 管理の git を通じたランナー独自のクローンは、変数が設定されている場合でも証明書をチェックするため、git が他の 2 つのアプローチのいずれかを通じて CA を信頼するまで、そのクローンは失敗します。

206 

207セッションのトークンを Anthropic 管理の git に運ぶ git 接続の場合、ランナーは 2 つの変数を次のように適用します。[`command` フック](/docs/ja/self-hosted-environments-configuration#command)はセッションの環境で開始するため、git がセッション内で取得するものを取得します:

208 

209* **`GIT_SSL_CAINFO`**:git が Anthropic 管理の git に対してチェックするものは、git が実行される場所によって異なります:

210 * **ランナー独自のクローンとフェッチ**:変数なしで実行され、ランナーが書き込むセッションごとの証明書ファイルに対して Anthropic 管理の git をチェックします。そのファイルはランナーホストのシステム CA バンドルとファイルからの証明書を保持します。

211 * **セッション内の git**:変数の代わりに `http.sslCAInfo` 設定を取得し、ファイルに名前を付けます。また、セッションごとのファイルに対して Anthropic 管理の git をチェックする `http.<url>.sslCAInfo` エントリを取得します。

212 * **`checkout` および `post-session` フック**:変数を変更されずに継承します。

213* **`GIT_SSL_NO_VERIFY`**:証明書チェックが無効のままであるかは、git が実行される場所によって異なります:

214 * **ランナー独自のクローンとフェッチ**:変数なしで実行され、提示される証明書をチェックします。

215 * **セッション内の git**:変数の代わりに `http.sslVerify=false` 設定を取得するため、他のホストのチェックは無効のままです。また、Anthropic 管理の git のチェックを有効に保つ `http.<url>.sslVerify=true` エントリを取得します。

216 * **`checkout` および `post-session` フック**:セッションが Anthropic 管理の git 上のリポジトリを持つ場合、変数の代わりに `http.sslVerify=false` 設定を取得します。また、Anthropic 管理の git のチェックを有効に保つ `http.<url>.sslVerify=true` エントリを取得します。

217 

218セッションごとの証明書ファイルには、ランナーホスト上の `/etc/ssl/certs/ca-certificates.crt` または `/etc/pki/tls/certs/ca-bundle.crt` のシステム CA バンドルが必要です。また、ランナーのユーザーが読み取ることができ、PEM `CERTIFICATE` ブロックを保持し、最大 1 MiB である `GIT_SSL_CAINFO` ファイルが必要です。ランナーがセッションごとのファイルを構築できない場合、`[runner:warn]` 行を記録します。これには `did not build the certificate file` と理由が含まれます。git はその後、Anthropic 管理の git のファイルをそのまま使用します。行が名前を付けるものを修正してください。

219 

220Anthropic 管理の git を使用する各セッションについて、ランナーは `[runner:warn]` 行をログに記録します。これは `governed git: GIT_SSL_CAINFO is set` または `governed git: GIT_SSL_NO_VERIFY is set` で始まります。行は、ランナーが独自の git、セッション内の git、およびライフサイクルフックのその変数で何をしたかを示します。何かを変更する必要があるかどうかで終わります。

221 

189<h3 id="rewrite-git-urls-for-private-networks">222<h3 id="rewrite-git-urls-for-private-networks">

190 プライベートネットワークの git URL を書き直す223 プライベートネットワークの git URL を書き直す

191</h3>224</h3>


203 236 

204Anthropic は事前にビルドされたランナーイメージを公開していません。`claude` バイナリの周りに独自のイメージをビルドし、リポジトリが必要とするツールチェーン(言語ランタイム、コンパイラ、パッケージマネージャー、[MCP](/docs/ja/mcp) サイドカー)をレイヤーに追加してください。237Anthropic は事前にビルドされたランナーイメージを公開していません。`claude` バイナリの周りに独自のイメージをビルドし、リポジトリが必要とするツールチェーン(言語ランタイム、コンパイラ、パッケージマネージャー、[MCP](/docs/ja/mcp) サイドカー)をレイヤーに追加してください。

205 238 

206以下のレシピは `--capacity 4` を使用しているため、1 つのコンテナが同じロックされたオーナーからの最大 4 つの同時セッションを処理します。これは[ハードニングセクション](#harden-your-deployment)のコンテナ分離をセッションごとに提供していません。環境を本番システムに接続する前に、レシピを `--capacity 1` で実行してセッションごとに 1 つのコンテナを使用するか、[オンデマンドランナー](/docs/ja/self-hosted-environments-configuration#on-demand-runners)を使用してください。オンデマンドランナーは、セッション実行ホストから環境シークレットを保持します。239以下のレシピは `--capacity 4` を使用しているため、1 つのコンテナが同じロックされたオーナーからの最大 4 つの同時セッションを処理します。これは[ハードニングセクション](#harden-your-deployment)のセッションごとのコンテナ分離を提供していません。環境を本番システムに接続する前に、レシピを `--capacity 1` で実行してセッションごとに 1 つのコンテナを使用するか、[オンデマンドランナー](/docs/ja/self-hosted-environments-configuration#on-demand-runners)を使用してください。オンデマンドランナーは、セッション実行ホストから環境シークレットを保持します。これらのレシピのいずれかに[Anthropic git プロキシ](#use-the-anthropic-git-proxy)を追加する場合は、`--capacity` も `1` に変更してください。

207 240 

208これは最小限の開始点となる Dockerfile です。241これは最小限の開始点となる Dockerfile です。

209 242 


338 371 

339以下の Compose サービスは、ランナーが終了するたびに再起動します。これはクラッシュと通常のドレイン後の終了の両方をカバーします。Docker 再起動ポリシーは、書き込み可能なレイヤーを保持して同じコンテナを再起動するため、ランナーは[強化姿勢](#harden-your-deployment)が推奨する新しいファイルシステムではなく、再利用されたファイルシステムで戻ります。このレシピを評価に使用し、本番環境ではコンテナを実行ごとに再作成するか、そうするオーケストレーターを使用してください。372以下の Compose サービスは、ランナーが終了するたびに再起動します。これはクラッシュと通常のドレイン後の終了の両方をカバーします。Docker 再起動ポリシーは、書き込み可能なレイヤーを保持して同じコンテナを再起動するため、ランナーは[強化姿勢](#harden-your-deployment)が推奨する新しいファイルシステムではなく、再利用されたファイルシステムで戻ります。このレシピを評価に使用し、本番環境ではコンテナを実行ごとに再作成するか、そうするオーケストレーターを使用してください。

340 373 

374Docker は、コンテナが終了し続ける前に、より長く待機してから再起動します。上限に達するまで、ランナーが起動できない場合、このレシピの下で厳しいループで再起動し続けることはありません。[ランナーが終了するとき](#when-the-runner-exits)は、その場合に確認する内容について説明しています。

375 

341```yaml theme={null}376```yaml theme={null}

342services:377services:

343 claude-runner:378 claude-runner:


451 486 

452各セッションの子 Claude Code プロセスはランナー独自のバイナリを実行し、ランナーはセッション内でオートアップデートをオフにするため、すべてのセッションはホストにインストールされたか、イメージに組み込まれたバージョンを実行します。ホストレベルのアップデートはランナーが次に開始するときに有効になります。487各セッションの子 Claude Code プロセスはランナー独自のバイナリを実行し、ランナーはセッション内でオートアップデートをオフにするため、すべてのセッションはホストにインストールされたか、イメージに組み込まれたバージョンを実行します。ホストレベルのアップデートはランナーが次に開始するときに有効になります。

453 488 

489セッションが使用するモデルは、セッションが実行する Claude Code バージョンより新しい Claude Code バージョンを必要とする場合があります。その場合、サーバーはそのモデルのリクエストを [Claude Code does not support this model](/docs/ja/errors#claude-code-does-not-support-this-model) で拒否します。バージョンをピンする前に、セッションが使用するすべてのモデルについて [モデルが必要とする Claude Code バージョン](/docs/ja/model-config#available-models) を確認してください。

490 

454* **フリートを 1 つのバージョンに保持するには**:ピンされたバージョンでイメージをビルドするか、ベアホストで特定のバージョンをインストールし、[オートアップデートを無効にしてください](/docs/ja/setup#disable-auto-updates)491* **フリートを 1 つのバージョンに保持するには**:ピンされたバージョンでイメージをビルドするか、ベアホストで特定のバージョンをインストールし、[オートアップデートを無効にしてください](/docs/ja/setup#disable-auto-updates)

455* **アップグレードするには**:新しいバージョンをインストールするか、イメージを再ビルドしてから、ランナーを再起動してください492* **アップグレードするには**:新しいバージョンをインストールするか、イメージを再ビルドしてから、ランナーを再起動してください

456* **プラグイン**:プラグインマーケットプレイスもオートアップデートしません。ランナーの環境で `FORCE_AUTOUPDATE_PLUGINS=1` を設定して、バイナリがピンされたままの間、プラグインをオートアップデートさせます493* **プラグイン**:プラグインマーケットプレイスもオートアップデートしません。ランナーの環境で `FORCE_AUTOUPDATE_PLUGINS=1` を設定して、バイナリがピンされたままの間、プラグインをオートアップデートさせます


554 591 

555各セッションの子プロセスは個別のデバッグログを書き込みます。失敗時、ランナーはログのテールを claude.ai/code のセッションと一緒に表示します。[`--remove-session-state`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) でランナーを起動しない限り、失敗したセッションのログもディスク上に保持し、ランナーログにそのパスを出力します。592各セッションの子プロセスは個別のデバッグログを書き込みます。失敗時、ランナーはログのテールを claude.ai/code のセッションと一緒に表示します。[`--remove-session-state`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) でランナーを起動しない限り、失敗したセッションのログもディスク上に保持し、ランナーログにそのパスを出力します。

556 593 

594<h3 id="when-the-runner-exits">

595 ランナーが終了する場合

596</h3>

597 

598[オンデマンドランナー](/docs/ja/self-hosted-environments-configuration#on-demand-runners)を再起動しないでください。その作業指示は単一用途だからです。ランナーが起動直後に終了する場合は、他の理由で終了するランナーとは異なる処理が必要です。

599 

600* **通常の終了**:ランナーはセッションを完了してドレインし、リタイア時間に達した、または停止するよう指示されました。環境に容量を戻すために再起動してください。[ランナーライフサイクル](/docs/ja/self-hosted-environments#runner-lifecycle)はこれらの終了について説明しています。

601* **失敗した開始**:ランナーは与えられた設定またはホストで開始できないため、起動後数秒で終了し、再起動するたびに同じ方法で終了します。より速く再起動しても役に立ちません。誰かが出力を読んで原因を修正する必要があります。

602 

603ランナーが終了するたびに再起動するようにスーパーバイザーを設定し、ランナーが起動直後に終了し続ける場合は再起動間の待機時間を長くし、それが起こり続ける場合は誰かに通知してください。

604 

605<h4 id="recognize-a-failed-start">

606 失敗した開始を認識する

607</h4>

608 

609ランナーが開始できない場合、理由を示す行を出力してから終了します。ほとんどの原因では、行に `[runner:fatal]` が含まれています。一部の原因では、行は代わりに `error:` で始まります。これには、ランナーがフラグを解析できない場合、環境シークレットを読み取れない場合、またはベースディレクトリを作成または書き込みできない場合が含まれます。次の行は `--help` を指します。

610 

611ほとんどのログ行はタイムスタンプと `[self-hosted-runner]` で始まります。以下のサンプルは省略しています。例えば、Anthropic git プロキシと 1 より大きい容量で起動されたランナーは、次のような行を出力します:

612 

613```text theme={null}

614[runner:fatal] --use-anthropic-git-proxy requires --capacity 1 (the proxy URL is per-session and linked worktrees share origin). Omit --use-anthropic-git-proxy or set --capacity 1.

615```

616 

617ランナーの標準出力と標準エラー、プラットフォームのコンテナログ、または [`--log-file`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) で設定したファイルで行を探してください。ランナーはログファイルを開く前に `error:` 行を出力するため、[トラブルシューティング](#troubleshooting)で述べられているように、ターミナルまたはコンテナログで探してください。

618 

619失敗した開始を読むときに、これらも役に立ちます:

620 

621* **行がまったくない**:ホストが強制終了するランナーはどちらも出力しません。出力が `[runner:fatal]` 行も `error:` 行もなく終わる場合、ホストまたはオーケストレーターがプロセスを停止したかどうかを確認してください。例えば、メモリ制限を超えたため。

622* **終了コード**:ランナーは、すべての開始で繰り返されるエラーのために終了コードを確保しません。設定エラー(サポートされていないフラグの組み合わせなど)と、自分自身で解決できる失敗(API がランナー自身の再試行を通じて到達不可能なままなど)に対して同じコードで終了します。再起動をより長く待つ決定は、ランナーがどのくらい速く終了したかに基づいて、ランナーの出力を読んで理由を学んでください。

623* **健全に見える環境**:[`--configure-git`](#let-the-runner-configure-git) や Anthropic git プロキシの認証情報セットアップなど、ランナーが環境に登録した後に実行される起動ステップがあります。これらのステップの 1 つが失敗する場合、環境はプロセスが終了した後も数分間そのランナーをリストし続けることができ、**クラウド環境** ページは **健全** を読むことができますが、ランナーは作業をピックアップしていません。セッションが健全に見える環境でキューに留まる場合、スーパーバイザーがランナーを再起動しているかどうかを確認してください。

624 

625<h4 id="restart-with-a-wait-that-grows">

626 増加する待機で再起動する

627</h4>

628 

629増加する待機を取得する方法はスーパーバイザーに依存します。

630 

631* **Kubernetes**:このページの [Deployment](#kubernetes) は変更を必要としません。コンテナが終了した後、kubelet はデフォルトでコンテナを再起動する前に待機し、再起動のたびに待機が増加して上限に達します。コンテナがしばらく終了せずに実行されると、待機がリセットされます。

632 

633 kubelet はコンテナが短時間だけ実行された場合、通常の終了後も同じ待機を適用します。頻繁にドレインするランナーは、したがって `CrashLoopBackOff` ステータスも表示できるため、ランナーが開始できないと結論付ける前に出力を読んでください。以下のコマンドは、Deployment の 1 つのポッドから最後の実行の出力を読みます:

634 

635 ```bash theme={null}

636 kubectl logs --previous -n claude-runners deploy/claude-runner

637 ```

638 

639 最後の実行が失敗した開始だった場合、`[runner:fatal]` または `error:` 行は出力の最後の行の中にあります。別のポッドの最後の実行を読むには、`deploy/claude-runner` の代わりにそのポッドを名前付けしてください。

640* **Docker と Docker Compose**:このページの [Compose レシピ](#docker-compose)は変更を必要としません。`restart: always` を使用すると、Docker は終了し続けるコンテナの再起動前に長く待機し、上限に達します。以下のコマンドで `<container>` をコンテナの名前に置き換えます。これは Docker がコンテナを再起動した回数を読みます:

641 

642 ```bash theme={null}

643 docker inspect --format '{{.RestartCount}}' <container>

644 ```

645 

646 コマンドは数字を出力します。増加し続ける数字は Docker がランナーを再起動し続けることを意味します。

647* **systemd ユニット**:デフォルトでは systemd はすべての再起動の前に同じ `RestartSec` を待機し、それを長くしません。したがって、`Restart=always` を持つユニットは、開始できないランナーをその同じ間隔で毎回再起動します。開始が十分に速く来て、ユニットの開始レート制限に達する場合、デフォルトでは 10 秒間に 5 回の開始、systemd はユニットの再起動を停止します。ユニットは停止したままになり、誰かが再起動するまで。systemd はレート制限の間隔が経過した後、または `systemctl reset-failed` の後に再起動を許可します。`RestartSec` はすべての再起動に適用されるため、より長い値は通常の終了後の再起動も遅延させます。2 つのバランスを取る値を選択し、ユニットの再起動カウントでアラートしてください。

648* **シェルループまたは独自のスーパーバイザー**:同じルールを自分で適用してください。5 秒の待機で開始してください。1 分以内に終了した各実行の後、次の再起動の待機を 5 分まで 2 倍にしてください。1 分以上続いた実行の後、5 秒に戻ってください。

649 

650<h4 id="check-why-the-runner-keeps-exiting">

651 ランナーが終了し続ける理由を確認する

652</h4>

653 

654ランナーが行に続いて起動直後に終了した場合、再起動する前に停止してこれらを確認してください。

655 

656* **最後の `[runner:fatal]` または `error:` 行**:ランナーが停止した理由を示します。[トラブルシューティング](#troubleshooting)は一般的な原因をリストしています。

657* **フラグの組み合わせ**:[Anthropic git プロキシ](#use-the-anthropic-git-proxy)は `--capacity 1` を必要とします。このページのレシピはより高い容量を使用するため、プロキシを 1 つに追加する場合は低くしてください。

658* **サービスの環境が到達できるもの**:ランナーが手で開始し、スーパーバイザーの下で失敗する場合、ユーザー、ホームディレクトリ、`PATH`、およびメモリ制限を比較してください。`--configure-git` と Anthropic git プロキシは `PATH` 上の git と書き込み可能な `~/.gitconfig` を必要とします。

659* **環境シークレット**:シークレットを取り消したか、誤入力した場合、ランナーは `RegisterRunner auth failed` を含む行を出力します。

660* **環境のアクティビティタブ**:環境を開き、**アクティビティ** を選択してください。新しいランナーが表示され続け、どれも作業をピックアップしない場合、スーパーバイザーはランナーを再起動しています。

661 

662ランナーホストでのガイド付き診断については、[doctor サブコマンド](#troubleshooting)を実行してください。

663 

557<h2 id="what’s-next">664<h2 id="what’s-next">

558 次のステップ665 次のステップ

559</h2>666</h2>

Details

57 環境とランナーをセットアップする57 環境とランナーをセットアップする

58</h2>58</h2>

59 59 

60Claude Code には、ガイド付きセットアップが含まれています。管理 UI で環境を作成する手順を説明するインタラクティブな Claude Code セッション。保存したシークレットファイルでローカルランナーを起動し、ランナーが登録されたことを確認し、`./runner-setup/CHEAT-SHEET.md` にチートシートを書き込みます。`claude auth login` でサインインしたマシンで実行します。オーナーロールを保持するアカウントを使用します。API キーまたはサードパーティモデルプロバイダーでは利用できません。インタラクティブセッションが不可能なホストでは、代わりに以下の手動ステップを使用してください。[バージョンチェック](#software-on-the-runner-host)が最初に合格したことを確認してください。2.1.224 より古いバージョンでは、このコマンドはガイド付きセットアップの代わりに、単語をプロンプトとして通常の Claude セッションを開始します。ガイド付きセットアップを開始するには、セットアップサブコマンドを実行してプロンプトに従います。60Claude Code には、ガイド付きセットアップが含まれています。これは、管理 UI で環境を作成する手順を案内するインタラクティブな Claude Code セッションで、保存したシークレットファイルを使用してローカルランナーを起動し、ランナーが登録されたことを確認し、`./runner-setup/CHEAT-SHEET.md` にチートシートを書き込みます。`claude auth login` でサインインしたマシンで実行してください。このとき、Owner ロールを持つアカウントを使用する必要があります。API キーまたはサードパーティのモデルプロバイダーでは利用できません。インタラクティブセッションが不可能なホストでは、代わりに以下の手動手順を使用してください。まず、[バージョンチェック](#software-on-the-runner-host)が成功したことを確認してください。2.1.224 より古いバージョンでは、このコマンドはガイド付きセットアップではなく、単語をプロンプトとして使用する通常の Claude セッションを開始します。ガイド付きセットアップを開始するには、setup サブコマンドを実行してプロンプトに従ってください。

61 61 

62```bash theme={null}62```bash theme={null}

63claude self-hosted-runner setup63claude self-hosted-runner setup

64```64```

65 65 

66代わりに手動でセットアップするには。66代わりに手動でセットアップするには、以下の手順に従ってください。

67 67 

68<Steps>68<Steps>

69 <Step title="環境を作成する">69 <Step title="環境を作成する">

70 管理設定の[**Cloud environments** ページ](https://claude.ai/admin-settings/cloud-environments)に移動します。**セルフホストされた環境**の下で、**新規**を選択し、環境に名前を付けて、**作成**を選択します。ウィザードの 2 番目のステップで、**環境キーをコピー**を選択して環境シークレットをコピーします。管理 UI はこれを環境キーとしてラベル付けします。claude.ai はシークレットを 1 回表示し、後で取得することはできません。作成から 365 日後に期限切れになります。環境の `ccpool_...` ID は詳細ダイアログに表示されたままです。[トークン検証](/docs/ja/self-hosted-environments-identity)の `aud` チェックおよび[CI からのテストセッションのディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)に必要になります。70 管理設定の [**Cloud environments** ページ](https://claude.ai/admin-settings/cloud-environments) に移動します。**Self-hosted environments** の下で、**New** を選択し、環境に名前を付けて、**Create** を選択します。ウィザードの 2 番目のステップで、**Copy environment key** を選択して環境シークレットをコピーします。管理 UI はこれを環境キーとしてラベル付けしています。claude.ai はシークレットを 1 回だけ表示し、後で取得することはできません。シークレットは作成から 365 日後に期限切れになります。環境の `ccpool_...` ID は詳細ダイアログに表示されたままになります。これは、[トークン検証](/docs/ja/self-hosted-environments-identity)の `aud` チェックと、[CI からのテストセッションのディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)に必要です。

71 71 

72 シークレットを失った場合またはローテーションが必要な場合は、環境の**設定**タブから新しいシークレットを作成し、新しいシークレットをランナーにロールアウトしてから、古いシークレットを取り消します。取り消されたシークレットを保持するランナーは次の認証済みポーリングに失敗して終了し、`poll auth failed` をログに記録します。オーケストレーターは新しいシークレットで再起動します。72 シークレットを紛失した場合、またはローテーションが必要な場合は、環境の **Configuration** タブから新しいシークレットを作成し、新しいシークレットをランナーにロールアウトしてから、古いシークレットを取り消します。取り消されたシークレットを保持しているランナーは、次の認証済みポーリングに失敗して終了し、`poll auth failed` をログに記録します。オーケストレーターは新しいシークレットでランナーを再起動します。

73 </Step>73 </Step>

74 74 

75 <Step title="ランナーを起動する">75 <Step title="ランナーを起動する">

76 シークレットディレクトリを作成します。このステップと次のステップは `/etc/claude` パスに root が必要です。ランナープロセスが読み取ることができるパスは機能するため、別のパスを使用する場合は両方のコマンドと `--environment-secret-file` 値を一緒に調整してください。76 シークレットディレクトリを作成します。このステップと次のステップは `/etc/claude` パスに root が必要です。ランナープロセスが読み取ることができるパスであれば、どのパスでも機能するため、異なるパスを使用する場合は、両方のコマンドと `--environment-secret-file` 値を一緒に調整してください。

77 77 

78 ```bash theme={null}78 ```bash theme={null}

79 mkdir -p /etc/claude79 mkdir -p /etc/claude

80 ```80 ```

81 81 

82 環境シークレットをファイルに書き込みます。以下のコマンドはターミナルから読み取るため、シークレットはシェル履歴から外れます。コピーした値を貼り付け、Enter キーを押してから Ctrl-D を押します。サブシェルの `umask` はファイルを所有者のみが読み取り可能にします。82 環境シークレットをファイルに書き込みます。以下のコマンドはターミナルから読み取るため、シークレットはシェル履歴から除外されます。コピーした値を貼り付け、Enter キーを押してから Ctrl-D を押します。サブシェルの `umask` により、ファイルは所有者のみが読み取ることができます。

83 83 

84 ```bash theme={null}84 ```bash theme={null}

85 (umask 077 && cat > /etc/claude/environment-secret)85 (umask 077 && cat > /etc/claude/environment-secret)

86 ```86 ```

87 87 

88 ベースディレクトリを選択します。以下のランナーコマンドの `<writable-dir>` を、ランナーが書き込みまたは作成できる絶対パスに置き換えます。ランナーはスタートアップ時にディレクトリを作成し、リポジトリをチェックアウトし、その下にセッションごとのディレクトリを作成します。`--base-dir` がない場合は `/workspace` を使用します。これはそのディレクトリが既に存在し、書き込み可能であるか、ランナーを root として起動する場合にのみ機能します。88 ベースディレクトリを選択し、以下のランナーコマンドの `<writable-dir>` を、ランナーが書き込みまたは作成できる絶対パスに置き換えます。ランナーは起動時にディレクトリを作成し、リポジトリをチェックアウトして、その下にセッションごとのディレクトリを作成します。`--base-dir` がない場合、`/workspace` を使用します。これは、そのディレクトリが既に存在し、書き込み可能であるか、ランナーを root として起動する場合にのみ機能します。

89 89 

90 ランナーがパスを作成または書き込みできない場合、スタートアップ時にディレクトリを名前付けするエラーで終了し、登録されません。[トラブルシューティング](/docs/ja/self-hosted-environments-deploy#troubleshooting)を参照してください。90 ランナーがパスを作成または書き込みできない場合、起動時にディレクトリを名前として指定するエラーで終了し、登録されません。[トラブルシューティング](/docs/ja/self-hosted-environments-deploy#troubleshooting)を参照してください。

91 91 

92 次に、`--environment-secret-file` と `--base-dir` でランナーを起動します。ランナーは環境に登録され、仕事をポーリングし始めます。ランナーが終了した場合、手動で再起動してください。本番環境デプロイメントはランナーをオーケストレーターの下で実行し、通常は再起動ごとに新しいファイルシステムで終了したランナーを再起動します。[事前にウォームアップされたチェックアウトを再利用](/docs/ja/self-hosted-environments-deploy#reuse-a-pre-warmed-checkout)はサポートされている永続ディスクセットアップをカバーしています。92 次に、`--environment-secret-file` と `--base-dir` を使用してランナーを起動します。ランナーは環境に登録され、作業のポーリングを開始します。ランナーが終了した場合は、手動で再起動してください。本番環境のデプロイメントは、終了したランナーを再起動するオーケストレーターの下でランナーを実行します。通常、再起動ごとに新しいファイルシステムを使用します。[事前にウォームアップされたチェックアウトを再利用する](/docs/ja/self-hosted-environments-deploy#reuse-a-pre-warmed-checkout)は、サポートされている永続ディスクセットアップについて説明しています。

93 93 

94 ```bash theme={null}94 ```bash theme={null}

95 claude self-hosted-runner --environment-secret-file '/etc/claude/environment-secret' --base-dir '<writable-dir>'95 claude self-hosted-runner --environment-secret-file '/etc/claude/environment-secret' --base-dir '<writable-dir>'


97 </Step>97 </Step>

98 98 

99 <Step title="ランナーが表示されることを確認する">99 <Step title="ランナーが表示されることを確認する">

100 [**Cloud environments** ページ](https://claude.ai/admin-settings/cloud-environments)に戻ります。環境のステータスはランナーが起動してから数秒以内に**ランナーがデプロイされていません**から**正常**に変わります。環境を開いて**アクティビティ**を選択してランナー自体を確認します。100 [**Cloud environments** ページ](https://claude.ai/admin-settings/cloud-environments)に戻ります。環境のステータスは、ランナーが起動してから数秒以内に **No runners deployed** から **Healthy** に変わります。環境を開いて **Activity** を選択すると、ランナー自体が表示されます。

101 </Step>101 </Step>

102 102 

103 <Step title="セッションを環境にルーティングする">103 <Step title="セッションを環境にルーティングする">

104 claude.ai/code でセッションを開始し、環境ピッカーから環境を選択します。セルフホストされた環境は Anthropic ホストされた環境と並んで表示されます。ランナーはホストが既に持っている git 認証情報でクローンするため、このホストが既にクローンできるリポジトリまたはパブリックリポジトリを選択してください。本番環境のプライベートリポジトリの認証情報オプションは[git を設定](/docs/ja/self-hosted-environments-deploy#configure-git)にあります。次に利用可能なランナーはキューに入ったセッションを取得し、`Picked up session <session-id>` をアクティブカウントと容量と共にログに記録します。ランナー自身の出力からどのホストがセッションを取得したかを確認できます。[claude.ai/code](https://claude.ai/code)でセッションの動作を監視し、Claude の返信を読みます。セッションがキューに入ったままの場合は、[トラブルシューティング](/docs/ja/self-hosted-environments-deploy#troubleshooting)を参照してください。104 claude.ai/code でセッションを開始し、環境ピッカーから環境を選択します。セルフホスト環境は Anthropic ホスト環境と並んで表示されます。ランナーは、ホストが既に持っている git 認証情報を使用してクローンを作成するため、このホストが既にクローンできるリポジトリ、または公開リポジトリを選択してください。本番環境のプライベートリポジトリの認証情報オプションは、[git を設定する](/docs/ja/self-hosted-environments-deploy#configure-git)に記載されています。次に利用可能なランナーがキューに入ったセッションを取得し、`Picked up session <session-id>` をアクティブカウントと容量とともにログに記録します。ランナー自身の出力からどのホストがセッションを取得したかを確認できます。[claude.ai/code](https://claude.ai/code) でセッションの動作を監視し、Claude の返信を読んでください。セッションがキューに入ったままの場合は、[トラブルシューティング](/docs/ja/self-hosted-environments-deploy#troubleshooting)を参照してください。

105 </Step>105 </Step>

106</Steps>106</Steps>

107 107 

108ランナーはアクティブセッションが終了すると設計上終了します。[ランナーのライフサイクル](/docs/ja/self-hosted-environments#runner-lifecycle)を参照してください。本番環境では、終了時に再起動するオーケストレーターの下にデプロイしてください。[本番環境へのデプロイ](/docs/ja/self-hosted-environments-deploy)を参照してください。108ランナーは設計上、アクティブセッションが終了すると終了します。[ランナーのライフサイクル](/docs/ja/self-hosted-environments#runner-lifecycle)を参照してください。本番環境では、終了時にランナーを再起動し、ランナーが起動直後に終了し続ける場合は再起動間の待機時間を長くするオーケストレーターの下にデプロイしてください。[本番環境へのデプロイ](/docs/ja/self-hosted-environments-deploy)と[ランナーが終了する場合](/docs/ja/self-hosted-environments-deploy#when-the-runner-exits)を参照してください。

109 109 

110<h2 id="send-a-follow-up-message-to-a-running-session">110<h2 id="send-a-follow-up-message-to-a-running-session">

111 実行中のセッションにフォローアップメッセージを送信する111 実行中のセッションにフォローアップメッセージを送信する

Details

80 SCM コネクタフラグ80 SCM コネクタフラグ

81</h3>81</h3>

82 82 

83オーケストレーターは Anthropic のコントロールプレーンへのスタンディング WebSocket 接続を保持できます。リポジトリピッカーやブランチまたは ref リゾルバーなどのホスト済みプリセッションフローが、ネットワーク内からのみルーティング可能な GitHub Enterprise Server ホストに到達できるようにします。`--scm-connector-host` を設定しない限り、コネクタはオフのままです。83SCM コネクタは利用できないため、このセクションのフラグは未設定のままにしてください。`--scm-connector-host` を設定した場合、接続は開かず、オーケストレーターは再試行を続けます。ランナーはセッションキューとして開始されます。

84 

85コネクタは、オーケストレーターから Anthropic のコントロールプレーンへのスタンディング WebSocket 接続です。リポジトリピッカーやブランチまたは ref リゾルバーなどのホスト済みプリセッションフローが、ネットワーク内からのみルーティング可能な GitHub Enterprise Server ホストに到達できるようにするために設計されています。GitHub Enterprise Server ページの [ネットワーク要件](/docs/ja/github-enterprise-server#network-requirements) を参照して、これらのフローが必要とするものを確認してください。

84 86 

85| フラグ | デフォルト | 説明 |87| フラグ | デフォルト | 説明 |

86| :- | :- | :- |88| :- | :- | :- |

87| `--scm-connector-host <host[:port]>` | 未設定 | リクエストを転送する GitHub Enterprise Server ホスト名。ポートはデフォルトで `443` です。このフラグを設定するとコネクタが有効になります。 |89| `--scm-connector-host <host[:port]>` | 未設定 | リクエストを転送する GitHub Enterprise Server ホスト名。ポートはデフォルトで `443` です。 |

88| `--scm-connector-id <n>` | `--scm-connector-host` で必須 | 組織の GitHub Enterprise Server 接続の数値 ID。コネクタを有効にするときは、Anthropic アカウントチームに値を問い合わせてください。 |90| `--scm-connector-id <n>` | `--scm-connector-host` で必須 | 組織の GitHub Enterprise Server 接続の数値 ID。 |

89| `--scm-connector-provider <slug>` | `ghe` | プロバイダーを識別するパスセグメント。`^[a-z0-9-]{1,32}$` と一致します。 |91| `--scm-connector-provider <slug>` | `ghe` | プロバイダーを識別するパスセグメント。`^[a-z0-9-]{1,32}$` と一致します。 |

90| `--scm-connector-ca-file <path>` | 未設定 | GitHub Enterprise Server ホストへの TLS 接続用の追加 CA バンドル(PEM 形式)。 |92| `--scm-connector-ca-file <path>` | 未設定 | GitHub Enterprise Server ホストへの TLS 接続用の追加 CA バンドル(PEM 形式)。 |

91| `--scm-connector-host-rewrite <from>=<to_host:to_port>` | 未設定 | エンドツーエンドテスト専用:ホストヘッダーと TLS SNI を `--scm-connector-host` として保ちながら TCP 接続をリダイレクトします。 |93| `--scm-connector-host-rewrite <from>=<to_host:to_port>` | 未設定 | エンドツーエンドテスト専用:ホストヘッダーと TLS SNI を `--scm-connector-host` として保ちながら TCP 接続をリダイレクトします。 |

92 94 

93コネクタはオーケストレーターの既存の環境シークレットで認証し、自動的に再接続します。ドロップされた接続で指数バックオフするか、別のオーケストレーターレプリカが既に保持しているため、コントロールプレーンが接続を閉じるときに固定 30 秒の遅延があります。95各接続試行時に、オーケストレーターは既存の環境シークレットを送信し、指数バックオフで自動的に再試行します。30 秒とジッターでキャップされます。

94 96 

95<h2 id="environment-variable-only-settings">97<h2 id="environment-variable-only-settings">

96 環境変数のみの設定98 環境変数のみの設定

Details

577 設定インデックス577 設定インデックス

578</h2>578</h2>

579 579 

580以下のすべてのキーはそのエントリにリンクしています。スコープは、それが入ることができる[ファイル](/docs/ja/settings#settings-files-and-who-they-affect)をリストしています。`User` は `~/.claude/settings.json`、`Project` は `.claude/settings.json`、`Local` は `.claude/settings.local.json`、`Managed` は[組織がデプロイするもの](/docs/ja/managed-settings)です。`Any file` は 4 つすべてを意味し、`Global config` は [`~/.claude.json`](#global-config-settings) を意味します。580以下のすべてのキーはそのエントリにリンクしています。スコープは、それが入ることができる[ファイル](/docs/ja/settings#settings-files-and-who-they-affect)をリストしています。`User` は `~/.claude/settings.json`、`Project` は `.claude/settings.json`、`Local` は `.claude/settings.local.json`、`Managed` は[組織がデプロイするもの](/docs/ja/managed-settings)です。`Any file` は 4 つすべてを意味し、`Global config` は [`~/.claude.json`](#global-config-settings)を意味します。

581 581 

582<ReferenceFilter582<ReferenceFilter

583 noun="settings"583 noun="settings"


595| [`agent`](#agent) | すべてのセッションを、プロンプト、ツール、モデルを持つ名前付き[サブエージェント](/docs/ja/sub-agents)として開始します | Agents, sessions, and worktrees | Any file |595| [`agent`](#agent) | すべてのセッションを、プロンプト、ツール、モデルを持つ名前付き[サブエージェント](/docs/ja/sub-agents)として開始します | Agents, sessions, and worktrees | Any file |

596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Claude が決定したときに[プッシュ通知をスマートフォンに送信](/docs/ja/remote-control#mobile-push-notifications)することを許可します | Remote, desktop, and notifications | Any file |596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Claude が決定したときに[プッシュ通知をスマートフォンに送信](/docs/ja/remote-control#mobile-push-notifications)することを許可します | Remote, desktop, and notifications | Any file |

597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | デプロイされた[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)と一緒に Claude Code が自身で取得する[claude.ai コネクタ](/docs/ja/mcp)をロードします | MCP | Managed |597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | デプロイされた[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)と一緒に Claude Code が自身で取得する[claude.ai コネクタ](/docs/ja/mcp)をロードします | MCP | Managed |

598| [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | デプロイされた[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)と一緒に組み込み[Claude in Chrome](/docs/ja/chrome)サーバーを実行することを許可します | MCP | Managed |

598| [`allowedChannelPlugins`](#allowedchannelplugins) | メッセージをプッシュできる[チャネルプラグイン](/docs/ja/channels#restrict-which-channel-plugins-can-run)のデフォルト許可リストを置き換えます | Plugins and skills | Managed |599| [`allowedChannelPlugins`](#allowedchannelplugins) | メッセージをプッシュできる[チャネルプラグイン](/docs/ja/channels#restrict-which-channel-plugins-can-run)のデフォルト許可リストを置き換えます | Plugins and skills | Managed |

599| [`allowedHttpHookUrls`](#allowedhttphookurls) | [HTTP フック](/docs/ja/hooks)がターゲットできる URL を制限します | Hooks and automation | Any file |600| [`allowedHttpHookUrls`](#allowedhttphookurls) | [HTTP フック](/docs/ja/hooks)がターゲットできる URL を制限します | Hooks and automation | Any file |

600| [`allowedMcpServers`](#allowedmcpservers) | ユーザーが追加できる[MCP サーバー](/docs/ja/mcp)を許可リストに登録します | MCP | Any file |601| [`allowedMcpServers`](#allowedmcpservers) | ユーザーが追加できる[MCP サーバー](/docs/ja/mcp)を許可リストに登録します | MCP | Any file |


3062</h4>3063</h4>

3063 3064 

3064* ここの値はシェルでエクスポートされた同じ変数を上書きします。複数の設定ファイルが変数を設定する場合、[最も優先度の高い](/docs/ja/settings#settings-precedence)ものが適用されます。[Claude Code が `env` で無視する変数](#variables-claude-code-ignores-in-env)はプロジェクトおよびローカル設定の例外をリストします。3065* ここの値はシェルでエクスポートされた同じ変数を上書きします。複数の設定ファイルが変数を設定する場合、[最も優先度の高い](/docs/ja/settings#settings-precedence)ものが適用されます。[Claude Code が `env` で無視する変数](#variables-claude-code-ignores-in-env)はプロジェクトおよびローカル設定の例外をリストします。

3066* Claude Desktop アプリまたは[自己ホスト環境](/docs/ja/self-hosted-environments)ランナーがセッションを開始する場合、それが構築する起動環境が代わりに優先されます。Claude Code は、起動環境がすでに設定している変数について、設定ファイルからの `env` 値を無視します。[デバッグログ](/docs/ja/debug-your-config)は無視された各変数の名前を付けます。

3065* シェルエクスポートをキャンセルするには、変数を `""` に設定します。Claude Code は空の値をプロバイダー選択の未設定として扱い、サブプロセスは空の値を継承します。3067* シェルエクスポートをキャンセルするには、変数を `""` に設定します。Claude Code は空の値をプロバイダー選択の未設定として扱い、サブプロセスは空の値を継承します。

3066* `NO_COLOR` と `FORCE_COLOR` をここで設定すると、サブプロセスにのみ到達します。Claude Code 自体のインターフェースカラーを変更するには、`claude` を起動する前にシェルで設定します。3068* `NO_COLOR` と `FORCE_COLOR` をここで設定すると、サブプロセスにのみ到達します。Claude Code 自体のインターフェースカラーを変更するには、`claude` を起動する前にシェルで設定します。

3067* ここの値は設定ファイルのプレーンテキストであり、Claude Code が開始するすべてのサブプロセスに到達します。ローテーションする OTLP ベアラートークンの場合は[`otelHeadersHelper`](#otelheadershelper)を使用します。API 認証情報の場合は[`apiKeyHelper`](#apikeyhelper)を使用します。3069* ここの値は設定ファイルのプレーンテキストであり、Claude Code が開始するすべてのサブプロセスに到達します。ローテーションする OTLP ベアラートークンの場合は[`otelHeadersHelper`](#otelheadershelper)を使用します。API 認証情報の場合は[`apiKeyHelper`](#apikeyhelper)を使用します。


5154 5156 

5155[`allowedMcpServers`](#allowedmcpservers)と[`deniedMcpServers`](#deniedmcpservers)は、このキーが読み込むコネクタにも適用されます。`managed-mcp.json` を持つホスト(自己ホスト型ランナーなど)の[クラウドセッション](/docs/ja/claude-code-on-the-web)に配信されるコネクタは、抑制されたままです。[管理対象セットと一緒に claude.ai コネクタを許可する](/docs/ja/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set)を参照してください。5157[`allowedMcpServers`](#allowedmcpservers)と[`deniedMcpServers`](#deniedmcpservers)は、このキーが読み込むコネクタにも適用されます。`managed-mcp.json` を持つホスト(自己ホスト型ランナーなど)の[クラウドセッション](/docs/ja/claude-code-on-the-web)に配信されるコネクタは、抑制されたままです。[管理対象セットと一緒に claude.ai コネクタを許可する](/docs/ja/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set)を参照してください。

5156 5158 

5159<h3 id="allowclaudeinchromewithmanagedmcp">

5160 `allowClaudeInChromeWithManagedMcp`

5161</h3>

5162 

5163デプロイされた `managed-mcp.json` と一緒に、組み込みの[Claude in Chrome](/docs/ja/chrome)サーバーを実行できるようにします。このキーがない場合、デプロイされた `managed-mcp.json` はターミナルセッションで Claude in Chrome をブロックします。Claude Code v2.1.282 以降が必要です。

5164 

5165* **スコープ**: [`Managed`](#scopes)。デバイス自身の管理設定からのみ。MDM でデプロイされた plist または HKLM レジストリキー、またはシステム `managed-settings.json` ファイル。Claude Code はサーバー管理設定、ユーザー書き込み可能な HKCU レジストリ、およびユーザーまたはプロジェクト設定では無視します。

5166* **タイプ**: ブール値

5167 * `true`: 組み込みの Claude in Chrome サーバーは、デプロイされた `managed-mcp.json` と一緒に実行できます

5168 * `false`: デプロイされた `managed-mcp.json` はターミナルセッションで Claude in Chrome をブロックします

5169* **デフォルト**: `false`。デプロイされた `managed-mcp.json` はターミナルセッションで Claude in Chrome をブロックします

5170 

5171```json managed-settings.json theme={null}

5172{

5173 "allowClaudeInChromeWithManagedMcp": true

5174}

5175```

5176 

5177`claude-in-chrome` の[`deniedMcpServers`](#deniedmcpservers)エントリは、このキーがオンの場合でもサーバーをブロックします。[管理対象セットと一緒に Claude in Chrome を許可する](/docs/ja/managed-mcp#allow-claude-in-chrome-alongside-the-managed-set)を参照してください。

5178 

5157<h3 id="allowedmcpservers">5179<h3 id="allowedmcpservers">

5158 `allowedMcpServers`5180 `allowedMcpServers`

5159</h3>5181</h3>

5160 5182 

5161ユーザーが追加できる MCP サーバーをホワイトリストに登録します。Claude Code は、プラグインサーバー、`--mcp-config` で渡されたサーバー、claude.ai からのサーバーを含め、どこで定義されていても、エントリに一致しないサーバーをブロックします。5183ユーザーが追加できる MCP サーバーをホワイトリストに登録します。Claude Code は、プラグインサーバー、`--mcp-config` で渡されたサーバー、claude.ai からのサーバーを含め、どこで定義されていても、エントリに一致しないサーバーをブロックします。

5162 5184 

5163Claude in Chrome、実行中の[VS Code](/docs/ja/vs-code#the-built-in-ide-mcp-server)または[JetBrains](/docs/ja/jetbrains#the-built-in-ide-mcp-server) IDE に Claude Code が接続する `ide` サーバー、CLI 自体が設定するサーバーなどの組み込みサーバーは、ホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。インプロセス `type: "sdk"` サーバーは両方のリストから除外されます。[セッションを開始したアプリ](/docs/ja/mcp#how-connectors-reach-claude-code)がこれらを登録します。5185Claude in Chrome、実行中の[VS Code](/docs/ja/vs-code#the-built-in-ide-mcp-server)または[JetBrains](/docs/ja/jetbrains#the-built-in-ide-mcp-server) IDE に Claude Code が接続する `ide` サーバー、CLI 自体が設定するサーバーなどの組み込みサーバーは、ホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。Claude Code v2.1.268 以降では、[Claude Tag](/docs/ja/claude-tag)セッションの Slack ツールもホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。インプロセス `type: "sdk"` サーバーは両方のリストから除外されます。[セッションを開始したアプリ](/docs/ja/mcp#how-connectors-reach-claude-code)がこれらを登録します。

5164 5186 

5165組織が配信するサーバーもホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。この除外は、すべての[`managedMcpServers`](#managedmcpservers)エントリと、`${VAR}` 展開を使用しない値を持つ[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)エントリをカバーします。完全なチェック順序については、[サーバーの評価方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)を参照してください。v2.1.259 より前では、`managed-mcp.json` からのサーバーも一致する必要がありました。5187組織が配信するサーバーもホワイトリストから除外され、デニーリストは引き続きこれらに適用されます。この除外は、すべての[`managedMcpServers`](#managedmcpservers)エントリと、`${VAR}` 展開を使用しない値を持つ[`managed-mcp.json`](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)エントリをカバーします。完全なチェック順序については、[サーバーの評価方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)を参照してください。v2.1.259 より前では、`managed-mcp.json` からのサーバーも一致する必要がありました。

5166 5188 


6301 `disableSideloadFlags`6323 `disableSideloadFlags`

6302</h3>6324</h3>

6303 6325 

6304起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` CLI フラグを拒否します。これらのフラグは、ユーザーが [`strictKnownMarketplaces`](#strictknownmarketplaces) を単一実行でバイパスするために渡す可能性があります。Claude Code はエラーで終了し、拒否されたフラグを名前で指定します。また、これらのフラグで CLI を内部的に開始するサーフェスに同じチェックを適用します。現在、デスクトップアプリの [Cowork](/docs/ja/desktop) ローカルセッションです。[クラウドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code は `--mcp-config` を通じてサーバーが配信した MCP サーバーをドロップします。ただし、プロセス内 `type: "sdk"` エントリは除きます。セッションを開始します。Claude Code v2.1.193 以降が必要です。6326起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` CLI フラグを拒否します。これらのフラグは、ユーザーが [`strictKnownMarketplaces`](#strictknownmarketplaces) を単一実行でバイパスするために渡す可能性があります。Claude Code はエラーで終了し、拒否されたフラグを名前で指定します。また、これらのフラグで CLI を内部的に開始するサーフェスに同じチェックを適用します。現在、デスクトップアプリの [Cowork](/docs/ja/desktop) ローカルセッションです。[クラウドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はセッションを開始し、サーバーが配信した `--mcp-config` エントリをドロップします。ただし、プロセス内 `type: "sdk"` エントリと [Claude Tag](/docs/ja/claude-tag) セッションの Slack ツールは除きます。Claude Code v2.1.193 以降が必要です。

6305 6327 

6306* **スコープ**: [`Managed`](#scopes)6328* **スコープ**: [`Managed`](#scopes)

6307* **タイプ**: ブール値6329* **タイプ**: ブール値

6308 * `true`: Claude Code は起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` を拒否し、エラーで終了して名前を指定します。ただし、クラウドセッションでは、サーバーが `--mcp-config` を通じて配信した MCP サーバーをドロップします。プロセス内 `type: "sdk"` エントリは除きます。セッションを開始します6330 * `true`: Claude Code は起動時に `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` を拒否し、エラーで終了して名前を指定します。クラウドセッションでは、セッションを開始し、サーバーが配信した `--mcp-config` エントリをドロップします。ただし、プロセス内 `type: "sdk"` エントリと Claude Tag セッションの Slack ツールは除きます

6309 * `false`: Claude Code はこれらのフラグを受け入れます6331 * `false`: Claude Code はこれらのフラグを受け入れます

6310* **デフォルト**: `false`6332* **デフォルト**: `false`

6311 6333 


6319 6341 

6320同じチェックは、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 環境変数で名前が付けられたプラグインフォルダをカバーします。これには Claude Code v2.1.280 以降が必要です。変数がフォルダを名前で指定する場合、Claude Code は同じエラーで終了し、エラーは変数をアンセットするように指示します。6342同じチェックは、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 環境変数で名前が付けられたプラグインフォルダをカバーします。これには Claude Code v2.1.280 以降が必要です。変数がフォルダを名前で指定する場合、Claude Code は同じエラーで終了し、エラーは変数をアンセットするように指示します。

6321 6343 

6322クラウドセッションでは、Claude Code はセッション中の MCP 更新も無視します。これは、クラウドセッション構成と SDK `setMcpServers()` 呼び出しの背後にあるパスです。プロセス内 `type: "sdk"` エントリはそこでも除外されたままです。v2.1.239 より前では、サーバーが配信した `--mcp-config` はクラウドセッションの開始をブロックしていました。6344クラウドセッションでは、Claude Code はセッション中の MCP 更新も無視します。これは、クラウドセッション構成と SDK `setMcpServers()` 呼び出しの背後にあるパスです。プロセス内 `type: "sdk"` エントリと Claude Tag セッションの Slack ツールはそこでも除外されたままです。v2.1.268 より前では、このドロップと起動ドロップの両方も Claude Tag セッションの Slack ツールを削除していました。v2.1.239 より前では、サーバーが配信した `--mcp-config` はクラウドセッションの開始をブロックしていました。

6323 6345 

6324<h3 id="forceremotesettingsrefresh">6346<h3 id="forceremotesettingsrefresh">

6325 `forceRemoteSettingsRefresh`6347 `forceRemoteSettingsRefresh`

skills.md +26 −2

Details

56 56 

57Claude は、失敗したコマンドや欠落したステップなど、実行を誤った場合にのみ記録されたファイルを編集するため、セッションごとの差分なしでファイルをコミットできます。v2.1.205 より前では、バンドルされたスキルは Claude に実行から学んだことをすべて折り込むよう指示し、頻繁なマージコンフリクトを引き起こしていました。57Claude は、失敗したコマンドや欠落したステップなど、実行を誤った場合にのみ記録されたファイルを編集するため、セッションごとの差分なしでファイルをコミットできます。v2.1.205 より前では、バンドルされたスキルは Claude に実行から学んだことをすべて折り込むよう指示し、頻繁なマージコンフリクトを引き起こしていました。

58 58 

59<h3 id="work-on-claude-api-projects">

60 Claude API プロジェクトで作業する

61</h3>

62 

63バンドルされた `/claude-api` スキルは、プロジェクトの言語に対して [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートする場合、Claude はこれを自動的にアクティベートします。

64 

65スキルのワークフローの 1 つを開始するには、Claude Code プロンプトでスキル名の後にサブコマンドを入力します。たとえば `/claude-api migrate` です。表は各サブコマンドが何をするか、およびそれを含む最も古い Claude Code バージョンをリストしています。`migrate` と `managed-agents-onboard` は v2.1.221 より前のバージョンです。これは表が追跡する最も古いバージョンです。

66 

67| サブコマンド | 実行内容 | 最小バージョン |

68| :- | :- | :- |

69| `migrate` | 既存の Claude API コードを新しいモデルに更新する | v2.1.221 より前 |

70| `upgrade` | プロジェクトの Anthropic SDK 依存関係をメジャーバージョン間で移動します。現在は Python `anthropic` パッケージを 0.x から 1.x に移動します | v2.1.236 以降 |

71| `managed-agents-onboard` | 新しい Managed Agent の作成をウォークスルーする | v2.1.221 より前 |

72| `prompt-audit` | プロンプト、スキル、ツール説明に書かれた古いモデル向けの指示にフラグを立て、差分として修正を提案する | v2.1.221 以降 |

73| `cost-optimize` | プロジェクトの Claude API 支出がどこに行くかをプロファイルし、プロンプトキャッシング、不要な入出力トークンの削減、バッチ処理、努力、モデル選択などのオプションから節約を提案します。一度に 1 つの変更 | v2.1.247 以降 |

74| `build-eval` | Claude を搭載したアプリ用の eval セットをビルドする | v2.1.259 以降 |

75| `hillclimb` | 既存の eval に対してアプリを反復的に改善する | v2.1.259 以降 |

76| `preserved-thinking-migration` | 統合が以前のターン、システムプロンプト、またはツールリストに対して行う編集を見つけます。これは [preserved thinking](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) ブロックを無効にし、各ブロックがどの程度の推論を削除するかを測定し、一度に 1 つずつ修正を提案します。各変更後に再測定します | v2.1.282 以降 |

77 

59<h2 id="getting-started">78<h2 id="getting-started">

60 はじめに79 はじめに

61</h2>80</h2>


909 928 

910スキルがトリガーされたことを確認することは、Claude がそれを見つけたことを意味しますが、意図した動作をしたことを意味しません。スキルが機能していることを知るには、Claude がそれを呼び出すべきプロンプトで実際に呼び出すかどうか、および呼び出す場合に出力が期待と一致するかどうかを個別に測定する必要があります。929スキルがトリガーされたことを確認することは、Claude がそれを見つけたことを意味しますが、意図した動作をしたことを意味しません。スキルが機能していることを知るには、Claude がそれを呼び出すべきプロンプトで実際に呼び出すかどうか、および呼び出す場合に出力が期待と一致するかどうかを個別に測定する必要があります。

911 930 

912両方をチェックするには、ベースライン比較を行います。現実的なプロンプトをいくつか収集し、スキルが利用可能な新しいセッションで各プロンプトを実行し、[無効化](#override-skill-visibility-from-settings)した状態でも実行して、結果を比較します。新しいセッションが重要なのは、スキルの作成時に残されたコンテキストが、書かれた指示のギャップをマスクするためです。931両方をチェックするには、ベースライン比較を行います。現実的なプロンプトをいくつか収集し、スキルが利用可能な新しいセッションで各プロンプトを実行し、スキルをオフにした状態でも実行して、結果を比較します。新しいセッションが重要なのは、スキルの作成時に残されたコンテキストが、書かれた指示のギャップをマスクするためです。

932 

9332 番目の実行でスキルをオフにする方法は、スキルの出所によって異なります。

934 

935* **個人用またはプロジェクトスキル**:[`skillOverrides`](#override-skill-visibility-from-settings) で `"off"` に設定します。

936* **プラグインが提供するスキル**:`skillOverrides` はプラグインスキルには適用されません。代わりに [`claude plugin eval`](/docs/ja/plugin-evals#the-no-plugin-baseline) を使用します。これはプラグインが読み込まれていない状態で各実行を繰り返します。

913 937 

914その比較を自動化する 2 つのツールがあります。[プラグイン](/docs/ja/plugins/overview)で配布されるスキルの場合、[`claude plugin eval`](/docs/ja/plugin-evals) は各プロンプトを分離されたセッションでプラグインの有無で実行し、定義したグレーダーまたはそれが作成したグレーダーでスコアリングし、閾値以下の場合はゼロ以外で終了するため、CI でそれをゲートできます。Claude Code 会話内の単一スキルを反復する場合、以下のスキル作成者プラグインは独自の `evals/evals.json` 形式で同様のループを実行します。2 つの形式は相互交換可能ではありません。938ベースライン比較を自動化する 2 つのツールがあります。[プラグイン](/docs/ja/plugins/overview) で配布されるスキルの場合、[`claude plugin eval`](/docs/ja/plugin-evals) は各プロンプトを分離されたセッションでプラグインの有無で実行し、定義したグレーダーまたはそれが作成したグレーダーでスコアリングし、閾値以下の場合はゼロ以外で終了するため、CI でそれをゲートできます。Claude Code 会話内の単一スキルを反復する場合、以下のスキル作成者プラグインは独自の `evals/evals.json` 形式で同様のループを実行します。2 つの形式は相互交換可能ではありません。

915 939 

916<h3 id="run-evals-with-skill-creator">940<h3 id="run-evals-with-skill-creator">

917 skill-creator でエバルを実行する941 skill-creator でエバルを実行する

statusline.md +1 −1

Details

1176**コンテキスト割合が予期しない値を表示する**1176**コンテキスト割合が予期しない値を表示する**

1177 1177 

1178* 最も単純で正確なコンテキスト状態には `used_percentage` を使用します1178* 最も単純で正確なコンテキスト状態には `used_percentage` を使用します

1179* コンテキスト割合は `/context` 出力と異なる場合があります。これは各が計算されるタイミングが異なるためです1179* ステータスラインは最後の API レスポンスからのカウントを報告し、`/context` はそのレスポンス以降に追加されたメッセージの推定値を追加するため、次のレスポンスまで `/context` はより高く読むことができます

1180 1180 

1181**OSC 8 リンクがクリック可能でない**1181**OSC 8 リンクがクリック可能でない**

1182 1182 

sub-agents.md +1 −3

Details

802 - matcher: "Bash"802 - matcher: "Bash"

803 hooks:803 hooks:

804 - type: command804 - type: command

805 command: "./scripts/validate-command.sh $TOOL_INPUT"805 command: "./scripts/validate-command.sh"

806 PostToolUse:806 PostToolUse:

807 - matcher: "Edit|Write"807 - matcher: "Edit|Write"

808 hooks:808 hooks:


850}850}

851```851```

852 852 

853ハイフン付きマッチャー(`db-agent`)は Claude Code v2.1.195 以降で正確にマッチします。以前のバージョンではアンカーなし正規表現として評価され、`prod-db-agent` などそれを含むエージェントタイプについても発火します。これらのバージョンでは `^db-agent$` としてアンカーします。

854 

855完全なフック設定形式については[フック](/docs/ja/hooks)を参照してください。853完全なフック設定形式については[フック](/docs/ja/hooks)を参照してください。

856 854 

857<h2 id="work-with-subagents">855<h2 id="work-with-subagents">

Details

122 122 

123 <tr>123 <tr>

124 <td>請求</td>124 <td>請求</td>

125 <td><strong>Teams:</strong> \$150/シート(Premium)PAYG 利用可能<br /><strong>Enterprise:</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">営業に連絡</a></td>125 <td><strong>Teams:</strong> シートあたりのサブスクリプション(PAYG 利用可能)、<a href="https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=third_party_pricing#team-&-enterprise">価格</a>を参照<br /><strong>Enterprise:</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">営業に連絡</a></td>

126 <td>PAYG</td>126 <td>PAYG</td>

127 <td>AWS 経由の PAYG</td>127 <td>AWS 経由の PAYG</td>

128 <td>AWS Marketplace 経由の PAYG</td>128 <td>AWS Marketplace 経由の PAYG</td>

Details

382 WebSocket ソース382 WebSocket ソース

383</h3>383</h3>

384 384 

385<Note>

386 WebSocket ソースには Claude Code v2.1.195 以降が必要です。

387</Note>

388 

389サーバーが既に WebSocket 経由でイベントをプッシュしている場合、Claude はポーリング スクリプトを作成する代わりに直接接続できます。各種のソケット アクティビティはイベントになるか、監視を終了します。385サーバーが既に WebSocket 経由でイベントをプッシュしている場合、Claude はポーリング スクリプトを作成する代わりに直接接続できます。各種のソケット アクティビティはイベントになるか、監視を終了します。

390 386 

391* **テキスト メッセージ**: メッセージが複数行にまたがる場合でも、各メッセージが 1 つのイベントになります。387* **テキスト メッセージ**: メッセージが複数行にまたがる場合でも、各メッセージが 1 つのイベントになります。

Details

346```346```

347 347 

348<h2 id="common-installation-issues">348<h2 id="common-installation-issues">

349 インストールの一般的な問題349 よくあるインストールの問題

350</h2>350</h2>

351 351 

352これらは最も頻繁に遭遇するインストール問題とその解決策です。352これらは最も頻繁に遭遇するインストール問題とその解決策です。

353 353 

354<h3 id="install-script-returns-html-instead-of-a-shell-script">354<h3 id="install-script-returns-html-instead-of-a-shell-script">

355 インストールスクリプトがシェルスクリプトではなく HTML を返す355 インストールスクリプトが shell スクリプトではなく HTML を返す

356</h3>356</h3>

357 357 

358インストールコマンドを実行すると、次のいずれかのエラーが表示される場合があります。358インストールコマンドを実行すると、次のようなエラーが表示される場合があります。

359 359 

360```text theme={null}360```text theme={null}

361bash: line 1: syntax error near unexpected token `<'361bash: line 1: syntax error near unexpected token `<'


371...371...

372```372```

373 373 

374表現は PowerShell のバージョンとシステム言語によって異なります。`Missing expression after unary operator '--'` または `ParserError` と `ParseException` が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS はこの失敗を示します。代わりに `-OutFile install.ps1` でダウンロードしても、保存されたファイルは同じウェブページなので、それは役に立ちません。374表現は PowerShell のバージョンとシステム言語によって異なります。`Missing expression after unary operator '--'` または `ParserError` と `ParseException` が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS がこの失敗を示します。代わりに `-OutFile install.ps1` でダウンロードしても、保存されたファイルは同じウェブページなので、それも役に立ちません。

375 375 

376リクエストのルーティング方法によっては、HTML ボディなしで 403 が表示される場合があります。376リクエストのルーティング方法によっては、HTML ボディなしで 403 が表示される場合があります。

377 377 


424 `curl: (56) Failure writing output to destination`424 `curl: (56) Failure writing output to destination`

425</h3>425</h3>

426 426 

427`curl ... | bash` コマンドはスクリプトをダウンロードして Bash にパイプして実行します。このエラーと関連する `curl: (23) Failure writing output to destination` は、Bash がスクリプト全体を受け取らなかったことを意味します。終了コード 56 はダウンロード自体が中断されたことを示し、終了コード 23 は curl がパイプに受け取ったものを書き込めなかったことを示します。通常は Bash が早期に終了したためです。427`curl ... | bash` コマンドはスクリプトをダウンロードして Bash にパイプして実行します。このエラーと関連する `curl: (23) Failure writing output to destination` は、Bash が完全なスクリプトを受け取らなかったことを意味します。終了コード 56 はダウンロード自体が中断されたことを示し、終了コード 23 は curl が受け取ったものをパイプに書き込めなかったことを示します。通常は Bash が早期に終了したためです。

428 428 

429[ネットワーク接続を確認](#check-network-connectivity)のチェックで `downloads.claude.ai` に到達できることをテストしてください。サーバーに到達した場合、元の失敗は一時的である可能性があります。インストールコマンドを再試行してください。[別のインストール方法を試す](/docs/ja/setup#install-claude-code)こともできます。429[ネットワーク接続を確認](#check-network-connectivity)のチェックで `downloads.claude.ai` に到達できるかテストしてください。サーバーに到達した場合、元の失敗は一時的だった可能性があります。インストールコマンドを再試行してください。[別のインストール方法を試す](/docs/ja/setup#install-claude-code)こともできます。

430 430 

431<h3 id="homebrew-cask-unavailable-or-outdated">431<h3 id="homebrew-cask-unavailable-or-outdated">

432 Homebrew cask が利用できないか古い432 Homebrew cask が利用できないか古い

433</h3>433</h3>

434 434 

435Homebrew は、Homebrew cask インデックスのローカルコピーが cask の公開前の場合、`Error: Cask 'claude-code' is unavailable: No Cask with this name exists` を報告します。インデックスを更新して再試行してください。435Homebrew が `Error: Cask 'claude-code' is unavailable: No Cask with this name exists` を報告する場合、Homebrew cask インデックスのローカルコピーが cask の公開より前のものです。インデックスを更新して再試行してください。

436 436 

437```bash theme={null}437```bash theme={null}

438brew update438brew update

439brew install --cask claude-code439brew install --cask claude-code

440```440```

441 441 

442Homebrew が予想より古い Claude Code バージョンをインストールする場合、通常は同じ古いインデックスが原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースの約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定](/docs/ja/setup#configure-release-channel)を参照してください。442Homebrew が予想より古い Claude Code バージョンをインストールする場合、同じ古いインデックスが通常の原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定](/docs/ja/setup#configure-release-channel)を参照してください。

443 443 

444<h3 id="tls-or-ssl-connection-errors">444<h3 id="tls-or-ssl-connection-errors">

445 TLS または SSL 接続エラー445 TLS または SSL 接続エラー

446</h3>446</h3>

447 447 

448`curl: (35) TLS connect error`、`schannel: next InitializeSecurityContext failed`、または PowerShell の `Could not establish trust relationship for the SSL/TLS secure channel` などのエラーは、TLS ハンドシェイク失敗を示します。448これらのようなエラーは TLS ハンドシェイクが失敗したことを意味します。

449 

450* `curl: (35) TLS connect error`

451* `schannel: next InitializeSecurityContext failed`

452* PowerShell の `Could not create SSL/TLS secure channel`

453* PowerShell の `Could not establish trust relationship for the SSL/TLS secure channel`

449 454 

450**解決策:**455**解決策:**

451 456 


465 irm https://claude.ai/install.ps1 | iex470 irm https://claude.ai/install.ps1 | iex

466 ```471 ```

467 472 

4683. **プロキシまたはファイアウォールの干渉を確認する**:TLS 検査を実行する企業プロキシはこれらのエラーを引き起こす可能性があります。`unable to get local issuer certificate` と `SELF_SIGNED_CERT_IN_CHAIN` を含みます。インストールステップでは、インストールダウンロードが企業プロキシの CA を信頼するようにします。4733. **プロキシまたはファイアウォールの干渉を確認する**:TLS 検査を実行する企業プロキシはこれらのエラーを引き起こす可能性があります。`unable to get local issuer certificate` と `SELF_SIGNED_CERT_IN_CHAIN` を含みます。インストール手順では、インストールダウンロードが企業プロキシの CA を信頼するようにします。

469 474 

470 <Tabs>475 <Tabs>

471 <Tab title="macOS/Linux">476 <Tab title="macOS/Linux">


501 506 

502 証明書ファイルがない場合は IT チームに依頼してください。直接接続で試して、プロキシが原因であることを確認することもできます。507 証明書ファイルがない場合は IT チームに依頼してください。直接接続で試して、プロキシが原因であることを確認することもできます。

503 508 

5044. **Windows では、ブロックされた失効確認を回避する**。エラー `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` と `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` は curl がサーバーに到達したが、ネットワークが証明書失効ルックアップをブロックしていることを意味します。これは企業ファイアウォールの背後で一般的です。失敗しているコマンドが `install.cmd` をダウンロードする `curl` の場合、`--ssl-revoke-best-effort` を追加してコマンドプロンプトから再実行してください。5094. **Windows では、ブロックされた失効確認を回避する**。エラー `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` と `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` は curl がサーバーに到達したが、ネットワークが証明書失効確認をブロックしていることを意味します。これは企業ファイアウォールの背後では一般的です。失敗しているコマンドが `install.cmd` をダウンロードする `curl` の場合、`--ssl-revoke-best-effort` を追加してコマンドプロンプトから再実行してください。

505 ```batch theme={null}510 ```batch theme={null}

506 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd511 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

507 ```512 ```

508 スクリプト自体のダウンロードが同じエラーに遭遇すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、失効していることが判明している証明書は引き続き拒否します。これはブラウザが失効を処理する方法と一致します。PowerShell から PowerShell インストーラーを実行することで curl の失効確認を完全に回避することもできます。これは .NET 経由でダウンロードされ、失効サーバーが到達不可能な場合は失敗しません。513 スクリプト自体のダウンロードが同じエラーに遭遇すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、既知の失効証明書は拒否します。ブラウザが失効を処理する方法と一致します。curl の失効確認を完全に回避することもできます。PowerShell から PowerShell インストーラーを実行してください。これは .NET 経由でダウンロードされ、失効サーバーが到達不可能な場合は失敗しません。

509 ```powershell theme={null}514 ```powershell theme={null}

510 irm https://claude.ai/install.ps1 | iex515 irm https://claude.ai/install.ps1 | iex

511 ```516 ```


521 Windows での間違ったインストールコマンド526 Windows での間違ったインストールコマンド

522</h3>527</h3>

523 528 

524`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、または `'bash' is not recognized as the name of a cmdlet` が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドがスクリプトのテキストを出力する場合、インストールの一部のみを実行しました。529`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、または `'bash' is not recognized as the name of a cmdlet` が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドがスクリプトのテキストを出力する場合、その一部のみを実行しました。

525 530 

526* **`irm` が認識されない**:CMD にいます。PowerShell ではありません。2 つのオプションがあります。531* **`irm` が認識されない**:CMD にいます。PowerShell ではありません。2 つのオプションがあります。

527 532 


531 irm https://claude.ai/install.ps1 | iex536 irm https://claude.ai/install.ps1 | iex

532 ```537 ```

533 538 

534 または CMD にとどまり、CMD インストーラーを代わりに使用します。539 または CMD にとどまり、代わりに CMD インストーラーを使用します。

535 540 

536 ```batch theme={null}541 ```batch theme={null}

537 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd542 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd


542 irm https://claude.ai/install.ps1 | iex547 irm https://claude.ai/install.ps1 | iex

543 ```548 ```

544 549 

545* **`A parameter cannot be found that matches parameter name 'fsSL'`**:Windows PowerShell で macOS/Linux `curl -fsSL ... | bash` インストーラーを実行しました。`curl` は `Invoke-WebRequest` のエイリアスであり、`-fsSL` フラグを拒否します。代わりに PowerShell インストーラーを使用してください。550* **`A parameter cannot be found that matches parameter name 'fsSL'`**:macOS/Linux の `curl -fsSL ... | bash` インストーラーを Windows PowerShell で実行しました。ここで `curl` は `Invoke-WebRequest` のエイリアスであり、`-fsSL` フラグを拒否します。代わりに PowerShell インストーラーを使用してください。

546 ```powershell theme={null}551 ```powershell theme={null}

547 irm https://claude.ai/install.ps1 | iex552 irm https://claude.ai/install.ps1 | iex

548 ```553 ```

549 554 

550* **`bash` が認識されない**:Windows で macOS/Linux インストーラーを実行しました。代わりに PowerShell インストーラーを使用してください。555* **`bash` が認識されない**:macOS/Linux インストーラーを Windows で実行しました。代わりに PowerShell インストーラーを使用してください。

551 ```powershell theme={null}556 ```powershell theme={null}

552 irm https://claude.ai/install.ps1 | iex557 irm https://claude.ai/install.ps1 | iex

553 ```558 ```

554 559 

555* **コマンドがスクリプトテキストを出力する**:ダウンロード部分を実行せずに、それを実行する部分なしでコマンドを実行しました。`irm https://claude.ai/install.ps1` 単独でダウンロードされたスクリプトをターミナルに出力します。`iex` にパイプして実行します。560* **コマンドがスクリプトテキストを出力する代わりにインストールする**:ダウンロード部分を実行部分なしで実行しました。`irm https://claude.ai/install.ps1` 単独でダウンロードされたスクリプトをターミナルに出力します。`iex` にパイプして実行してください。

556 561 

557 ```powershell theme={null}562 ```powershell theme={null}

558 irm https://claude.ai/install.ps1 | iex563 irm https://claude.ai/install.ps1 | iex

559 ```564 ```

560 565 

561 CMD では、`-o` なしの `curl -fsSL https://claude.ai/install.cmd` はバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行します。566 CMD では、`-o` なしの `curl -fsSL https://claude.ai/install.cmd` はバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行してください。

562 567 

563 ```batch theme={null}568 ```batch theme={null}

564 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd569 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

565 ```570 ```

566 571 

567どのインストーラーを使用するにしても、それが機能したことを確認します。新しいターミナルを開いて `claude --version` を実行します。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。572どのインストーラーを使用するにしても、それが機能したことを確認してください。新しいターミナルを開いて `claude --version` を実行します。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。

568 573 

569<h3 id="running-scripts-is-disabled-on-this-system">574<h3 id="running-scripts-is-disabled-on-this-system">

570 `running scripts is disabled on this system`575 `running scripts is disabled on this system`


578 + CategoryInfo : SecurityError: (:) [], PSSecurityException583 + CategoryInfo : SecurityError: (:) [], PSSecurityException

579```584```

580 585 

581npm インストール後に `claude` を実行すると、同じエラーが `claude.ps1` に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する `.ps1` ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、PowerShell インストーラー `irm https://claude.ai/install.ps1 | iex` には影響しません。これはダウンロードされたテキストを直接実行します。586npm インストール後に `claude` を実行すると、同じエラーが `claude.ps1` に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する `.ps1` ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、ダウンロードされたテキストを直接実行する PowerShell インストーラー `irm https://claude.ai/install.ps1 | iex` には影響しません。

582 587 

583**解決策:**588**解決策:**

584 589 

5851. **ユーザーのローカルで作成されたスクリプトを許可してから再試行します**。5901. **ユーザーのローカルで作成されたスクリプトを許可**してから再試行してください。

586 ```powershell theme={null}591 ```powershell theme={null}

587 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser592 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

588 ```593 ```

5892. **`.cmd` ランチャーを呼び出す**:`npm.cmd` と `claude.cmd` は同じ仕事をし、ポリシーはそれらをカバーしません。5942. **`.cmd` ランチャーを呼び出す**:`npm.cmd` と `claude.cmd` は同じ仕事をし、ポリシーはそれらをカバーしません。

5903. **npm の代わりに [PowerShell インストーラー](/docs/ja/setup#install-claude-code)を使用する**。バイナリではなく `.ps1` スクリプトをインストールします。5953. **npm の代わりに [PowerShell インストーラー](/docs/ja/setup#install-claude-code)を使用する**。これは `.ps1` スクリプトではなくバイナリをインストールします。

591 596 

592<h3 id="the-process-cannot-access-the-file-during-windows-install">597<h3 id="the-process-cannot-access-the-file-during-windows-install">

593 Windows インストール中の `The process cannot access the file`598 Windows インストール中の `The process cannot access the file`


595 600 

596PowerShell インストーラーが `Failed to download binary: The process cannot access the file ... because it is being used by another process` で失敗する場合、インストーラーは `%USERPROFILE%\.claude\downloads` に書き込めませんでした。これは通常、前のインストール試行がまだ実行中であるか、アンチウイルスソフトウェアがそのフォルダー内の部分的にダウンロードされたバイナリをスキャンしていることを意味します。601PowerShell インストーラーが `Failed to download binary: The process cannot access the file ... because it is being used by another process` で失敗する場合、インストーラーは `%USERPROFILE%\.claude\downloads` に書き込めませんでした。これは通常、前のインストール試行がまだ実行中であるか、アンチウイルスソフトウェアがそのフォルダー内の部分的にダウンロードされたバイナリをスキャンしていることを意味します。

597 602 

598インストーラーを実行している他の PowerShell ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するまで待機します。次にダウンロードフォルダーを削除してインストーラーを再度実行します。603インストーラーを実行している他の PowerShell ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するまで待機してください。次に downloads フォルダーを削除してインストーラーを再度実行してください。

599 604 

600```powershell theme={null}605```powershell theme={null}

601Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"606Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"


606 Windows での更新後に `claude.exe` が見つからない611 Windows での更新後に `claude.exe` が見つからない

607</h3>612</h3>

608 613 

609ターミナルが Windows で Claude Code を更新した直後に `'claude' is not recognized` を報告する場合は、`%USERPROFILE%\.local\bin` に `claude.exe` が含まれているかどうかを確認してください。そのディレクトリが PATH にまったくない場合は、代わりに[PATH を修正](#command-not-found-claude-after-installation)を参照してください。Windows で更新するために、Claude Code は既存の `claude.exe` を別にバックアップに名前変更し、新しいバージョンをその場所に移動します。新しいバージョンをその場所に移動できず、Claude Code がバックアップを名前変更して戻すこともできない場合、ディレクトリはバックアップを保持しますが `claude.exe` がありません。614ターミナルが Windows で Claude Code が更新された直後に `'claude' is not recognized` を報告する場合、`%USERPROFILE%\.local\bin` に `claude.exe` が含まれているかどうかを確認してください。そのディレクトリが PATH にまったくない場合は、代わりに [PATH を修正](#command-not-found-claude-after-installation)を参照してください。Windows で更新するために、Claude Code は既存の `claude.exe` をバックアップに名前変更し、新しいバージョンをその場所に移動します。新しいバージョンをその場所に移動できず、Claude Code がバックアップを名前変更できない場合、ディレクトリはバックアップを保持しますが `claude.exe` はありません。

610 615 

611バックアップは、`claude.exe.old.` で始まり、その後に数値タイムスタンプが続く名前を持つ同じディレクトリ内のファイルです。PowerShell で次を実行して、最新のバックアップを `claude.exe` に名前変更します。616バックアップは、`claude.exe.old.` で始まり、その後に数値タイムスタンプが続く名前を持つ同じディレクトリ内のファイルです。PowerShell で以下を実行して、最新のバックアップを `claude.exe` に名前変更してください。

612 617 

613```powershell theme={null}618```powershell theme={null}

614Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe619Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

615```620```

616 621 

617次に `claude --version` を実行して修正を確認します。復元された `claude.exe` はバージョン番号を出力します。622次に `claude --version` を実行して修正を確認してください。復元された `claude.exe` はバージョン番号を出力します。

618 623 

619`claude.exe.old.*` ファイルがない場合、または名前変更後も `claude` が失敗する場合は、代わりに再インストールしてください。624`claude.exe.old.*` ファイルがない場合、または名前変更後も `claude` が失敗する場合は、代わりに再インストールしてください。

620 625 


625v2.1.281 より前では、Claude Code は `claude.exe` がまだ見つからない間にバックアップを削除する可能性がありました。630v2.1.281 より前では、Claude Code は `claude.exe` がまだ見つからない間にバックアップを削除する可能性がありました。

626 631 

627<h3 id="install-killed-on-low-memory-linux-servers">632<h3 id="install-killed-on-low-memory-linux-servers">

628 メモリ不足の Linux サーバーでインストールが強制終了される633 低メモリ Linux サーバーでインストールが強制終了される

629</h3>634</h3>

630 635 

631インストール中の `Killed` メッセージは通常、Linux メモリ不足(OOM)キラーがシステムのメモリ不足のため `claude install` ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります。636インストール中の `Killed` メッセージは通常、Linux メモリ不足(OOM)キラーがシステムのメモリが不足したため `claude install` ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります。

632 637 

633```text theme={null}638```text theme={null}

634Setting up Claude Code...639Setting up Claude Code...


637Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.642Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

638```643```

639 644 

640インストールには約 512 MB の空きメモリが必要で、Claude Code を実行するにはさらに多くが必要です。[システム要件](/docs/ja/setup#system-requirements)を参照してください。645インストールには約 512 MB の空きメモリが必要であり、Claude Code を実行するにはさらに多くが必要です。[システム要件](/docs/ja/setup#system-requirements)を参照してください。

641 646 

642**解決策:**647**解決策:**

643 648 

6441. **サーバーの RAM が限られている場合はスワップスペースを追加する**。スワップはディスク領域をオーバーフロー メモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。6491. **スワップスペースを追加する**(サーバーの RAM が限定されている場合)。スワップはディスク領域をオーバーフロー メモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。

645 650 

646 2 GB スワップファイルを作成して有効にします。651 2 GB スワップファイルを作成して有効にします。

647 652 


652 sudo swapon /swapfile657 sudo swapon /swapfile

653 ```658 ```

654 659 

655 次にインストールを再試行します。660 次にインストールを再試行してください。

656 661 

657 ```bash theme={null}662 ```bash theme={null}

658 curl -fsSL https://claude.ai/install.sh | bash663 curl -fsSL https://claude.ai/install.sh | bash

659 ```664 ```

660 665 

6612. **インストール前に他のプロセスを閉じてメモリを解放する**。6662. **他のプロセスを閉じて**インストール前にメモリを解放します。

662 667 

6633. **可能であれば、より大きなインスタンスを使用する**。Claude Code には最低 4 GB の RAM が必要です。6683. **可能であれば、より大きなインスタンスを使用する**。Claude Code には最低 4 GB の RAM が必要です。

664 669 

665<h3 id="install-hangs-in-docker">670<h3 id="install-hangs-in-docker">

666 Docker でインストールがハングする671 Docker でのインストールハング

667</h3>672</h3>

668 673 

669Docker コンテナーで Claude Code をインストールする場合、root として `/` にインストールするとハングが発生する可能性があります。674Docker コンテナーに Claude Code をインストールする場合、root として `/` にインストールするとハングが発生する可能性があります。

670 675 

671**解決策:**676**解決策:**

672 677 

6731. **インストーラーを実行する前に作業ディレクトリを設定する**。`/` から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用が発生します。`WORKDIR` を設定すると、スキャンが小さなディレクトリに制限されます。6781. **インストーラーを実行する前に作業ディレクトリを設定する**。`/` から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用を引き起こします。`WORKDIR` を設定すると、スキャンが小さなディレクトリに制限されます。

674 ```dockerfile theme={null}679 ```dockerfile theme={null}

675 WORKDIR /tmp680 WORKDIR /tmp

676 RUN curl -fsSL https://claude.ai/install.sh | bash681 RUN curl -fsSL https://claude.ai/install.sh | bash

677 ```682 ```

678 683 

6792. **Docker Desktop を使用している場合は Docker にメモリを追加する**。ビルドコンテナーは Docker Desktop 仮想マシンに割り当てられたメモリを共有するため、Docker Desktop で **Settings > Resources** を開き、メモリ制限を上げて、ビルドを再実行します。6842. **Docker Desktop を使用している場合、Docker にさらにメモリを与える**。ビルドコンテナーは Docker Desktop 仮想マシンに割り当てられたメモリを共有するため、Docker Desktop で **Settings > Resources** を開き、メモリ制限を上げて、ビルドを再実行してください。

680 685 

681<h3 id="raw-mode-is-not-supported-during-install">686<h3 id="raw-mode-is-not-supported-during-install">

682 インストール中の `Raw mode is not supported`687 インストール中の `Raw mode is not supported`

683</h3>688</h3>

684 689 

685組織の[サーバー管理設定](/docs/ja/server-managed-settings)に[セキュリティ承認](/docs/ja/server-managed-settings#security-approval-dialogs)が必要な変更が含まれている場合、Claude Code バージョン 2.1.246 より前は `claude install` 中に承認ダイアログを表示しようとします。ダイアログは stdin のターミナルが必要です。インストーラーが `curl -fsSL https://claude.ai/install.sh | bash` のようにパイプから `claude install` を実行する場合、stdin はターミナルではなくパイプであるため、インストールは `Raw mode is not supported` を含むエラーで失敗します。690組織の [サーバー管理設定](/docs/ja/server-managed-settings)に [セキュリティ承認](/docs/ja/server-managed-settings#security-approval-dialogs)が必要な変更が含まれている場合、v2.1.246 より前の Claude Code バージョンは `claude install` 中に承認ダイアログを表示しようとします。ダイアログは stdin のターミナルが必要です。インストーラーが `curl -fsSL https://claude.ai/install.sh | bash` のようにパイプから `claude install` を実行する場合、stdin はターミナルではなくパイプであるため、インストールは `Raw mode is not supported` を含むエラーで失敗します。

686 691 

687Claude Code v2.1.246 以降は、`claude install` または `claude update` 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ構成が[設定フェッチを待つ](/docs/ja/server-managed-settings#enforce-fail-closed-startup)場合(`forceRemoteSettingsRefresh` を設定する場合など)、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは引き続き失敗します。692Claude Code v2.1.246 以降は、`claude install` または `claude update` 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ構成が [設定フェッチを待つ](/docs/ja/server-managed-settings#enforce-fail-closed-startup)場合(`forceRemoteSettingsRefresh` を設定する場合など)、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは失敗します。

688 693 

689他のすべての構成では、インストーラーを再実行すると、古いバージョンをインストールするよう求めた場合でも、スクリプトは最新リリースの `install` コマンドを実行するため、このエラーを回避できます。プラットフォームのコマンドを再実行してください。694他のすべての構成では、インストーラーを再実行するとこのエラーを回避できます。スクリプトは古いバージョンのインストールを要求した場合でも、最新リリースの `install` コマンドを実行するためです。プラットフォームのコマンドを再実行してください。

690 695 

691<Tabs>696<Tabs>

692 <Tab title="macOS/Linux">697 <Tab title="macOS/Linux">


708 `claude update` または `claude doctor` がハングする713 `claude update` または `claude doctor` がハングする

709</h3>714</h3>

710 715 

711`claude update` と `claude doctor` は、古い `claude` エイリアス `~/.zshrc`、`~/.bashrc`、`~/.config/fish/config.fish` のシェル構成ファイルをスキャンします。macOS では、存在する `~/.bash_profile`、`~/.bash_login`、`~/.profile` の最初のものです。`ZDOTDIR` を設定する場合、Zsh ファイルは代わりに `$ZDOTDIR/.zshrc` です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、`/status` のシステム診断セクションを空白のままにしました。`claude doctor` は出力なしでハングしました。`claude update` は `Checking for updates` を出力した直後にハングしました。716`claude update` と `claude doctor` は古い `claude` エイリアス `~/.zshrc`、`~/.bashrc`、`~/.config/fish/config.fish` のシェル構成ファイルをスキャンします。macOS では、存在する `~/.bash_profile`、`~/.bash_login`、または `~/.profile` の最初のものです。`ZDOTDIR` を設定する場合、Zsh ファイルは代わりに `$ZDOTDIR/.zshrc` です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、`/status` のシステム診断セクションを空白のままにしました。`claude doctor` はハングして出力がありません。`claude update` は `Checking for updates` を出力した直後にハングしました。

712 717 

713以前のバージョンでハングに遭遇した場合は、ディレクトリを見つけてください。このコマンドの出力では、`d` で始まる行がそのパスをディレクトリとしてマークします。`No such file or directory` 行は、そのパスに何も存在せず、原因ではないことを意味します。718影響を受けたバージョンでハングが発生した場合は、ディレクトリを見つけてください。このコマンドの出力では、`d` で始まる行がそのパスをディレクトリとしてマークします。`No such file or directory` 行は、そのパスに何も存在せず、原因ではないことを意味します。

714 719 

715```bash theme={null}720```bash theme={null}

716ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish721ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

717```722```

718 723 

719ディレクトリを移動するか、v2.1.214 以降に更新してください。`claude update` は影響を受けるバージョンでハングするため、代わりに[インストールスクリプト](/docs/ja/setup#install-claude-code)を再実行して更新してください。724ディレクトリを移動するか、v2.1.214 以降に更新してください。影響を受けたバージョンでは `claude update` がハングするため、代わりに [インストールスクリプト](/docs/ja/setup#install-claude-code)を再実行して更新してください。

720 725 

721<h3 id="claude-desktop-overrides-the-claude-command-on-windows">726<h3 id="claude-desktop-overrides-the-claude-command-on-windows">

722 Claude Desktop が Windows で `claude` コマンドをオーバーライドする727 Claude Desktop が Windows で `claude` コマンドをオーバーライドする


727Claude Desktop を最新バージョンに更新して、この問題を修正してください。732Claude Desktop を最新バージョンに更新して、この問題を修正してください。

728 733 

729<h3 id="claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell">734<h3 id="claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell">

730 Windows の Claude Code には Git for Windows(bash 用)または PowerShell のいずれかが必要です735 Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

731</h3>736</h3>

732 737 

733Git for Windows はオプションです。Claude Code は Git Bash がない場合、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)を使用するため、このエラーはどちらのシェルも見つからなかったことを意味します。738Git for Windows はオプションです。Claude Code は Git Bash がない場合、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)を使用するため、このエラーはどちらのシェルも見つからなかったことを意味します。

734 739 

735**PowerShell が PATH にない場合**、デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。そのディレクトリを `PATH` に追加するか、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールしてください。740**PowerShell が PATH にない場合**、デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。そのディレクトリを `PATH` に追加するか、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールしてください。

736 741 

737**Git for Windows をインストールする代わりに**、[git-scm.com/downloads/win](https://git-scm.com/downloads/win) からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後にターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作する場合に便利です。742**Git for Windows をインストールする代わりに**、[git-scm.com/downloads/win](https://git-scm.com/downloads/win) からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後にターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作するときに便利です。

738 743 

739**Git が既にインストールされている**が Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。`CLAUDE_CODE_GIT_BASH_PATH` が設定されていない場合、Claude Code は次の順序で `bash.exe` を探します。744**Git が既にインストールされている**が Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。`CLAUDE_CODE_GIT_BASH_PATH` が設定されていない場合、Claude Code は次の順序で `bash.exe` を探します。

740 745 

7411. デフォルトのインストール場所 `C:\Program Files\Git` と `C:\Program Files (x86)\Git`。7461. デフォルトのインストール場所 `C:\Program Files\Git` と `C:\Program Files (x86)\Git`。

7422. `PATH` 上の `git`。その Git インストールから `bin\bash.exe` を使用します。7472. `PATH` 上の `git`。その Git インストールから `bin\bash.exe` を使用します。

743 748 

744ステップ 2 では、Claude Code は Claude Code を起動したフォルダーに存在する `git`、またはそのフォルダーの下のパスで `node_modules` または `.venv` や `env` などの仮想環境フォルダーを含むパスをスキップします。例えば、`C:\dev\env\myproject` から起動した場合の `C:\dev\env\myproject\Git`。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行することを防ぎます。Git がそのような場所にある場合は、`CLAUDE_CODE_GIT_BASH_PATH` をそれに指します。749ステップ 2 では、Claude Code は Claude Code を起動したフォルダーに存在する `git`、またはそのパスの下で `node_modules` または `.venv` や `env` などの仮想環境フォルダーを含むパスをスキップします。例えば、`C:\dev\env\myproject` から起動した場合の `C:\dev\env\myproject\Git`。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行することを防ぎます。Git がそのような場所にある場合は、`CLAUDE_CODE_GIT_BASH_PATH` をそれに指します。

745 750 

746**Claude Code を特定の Git インストールに指す**には、PowerShell で `where.exe git` を実行して見つけ、そのインストールから `bin\bash.exe` パスを [settings.json ファイル](/docs/ja/settings)の `CLAUDE_CODE_GIT_BASH_PATH` として設定します。751**Claude Code を特定の Git インストールに指す**には、PowerShell で `where.exe git` を実行してそれを見つけ、そのインストールから `bin\bash.exe` パスを [settings.json ファイル](/docs/ja/settings)の `CLAUDE_CODE_GIT_BASH_PATH` として設定してください。

747 752 

748```json theme={null}753```json theme={null}

749{754{


753}758}

754```759```

755 760 

756**`CLAUDE_CODE_GIT_BASH_PATH` が正しいパスに設定されており、ファイルが存在する**が Claude Code がそれを使用しない場合は、まずファイルの名前を確認してください。Claude Code は `bash.exe`、`sh.exe`、`bash`、または `sh` という名前のファイルのみを受け入れます。Git for Windows の `git-bash.exe` ランチャーなど、他の名前では、変数を無視して Git Bash を自動検出し、`--debug` で表示される警告をログに記録します。存在しないパスは同じフォールバックと警告を取得します。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルを使用し、パスが存在しない場合は `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` で起動時に終了しました。761**`CLAUDE_CODE_GIT_BASH_PATH` が正しいパスに設定されており、ファイルが存在する**が Claude Code がそれを使用しない場合は、ファイルの名前を最初に確認してください。Claude Code は `bash.exe`、`sh.exe`、`bash`、または `sh` という名前のファイルのみを受け入れます。Git for Windows の `git-bash.exe` ランチャーなど、他の名前では、変数を無視して Git Bash を自動検出し、`--debug` で表示される警告をログに記録します。存在しないパスは同じフォールバックと警告を取得します。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルを使用し、パスが存在しない場合は `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` で起動時に終了しました。

757 762 

758ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに `claude.exe` と、`cmd.exe` や `bash.exe` を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。763ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに `claude.exe` と `cmd.exe` や `bash.exe` を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。

759 764 

760<h3 id="claude-code-does-not-support-32-bit-windows">765<h3 id="claude-code-does-not-support-32-bit-windows">

761 Claude Code は 32 ビット Windows をサポートしていません766 Claude Code は 32 ビット Windows をサポートしていません

762</h3>767</h3>

763 768 

764Windows のスタートメニューには 2 つの PowerShell エントリがあります。`Windows PowerShell` と `Windows PowerShell (x86)`。x86 エントリは 32 ビットプロセスとして実行され、64 ビットマシンでもこのエラーをトリガーします。どちらの場合かを確認するには、エラーを生成した同じウィンドウで次を実行します。769Windows には、スタートメニューに 2 つの PowerShell エントリがあります。`Windows PowerShell` と `Windows PowerShell (x86)`。x86 エントリは 32 ビットプロセスとして実行され、64 ビットマシンでもこのエラーをトリガーします。どちらの場合かを確認するには、エラーを生成した同じウィンドウで以下を実行してください。

765 770 

766```powershell theme={null}771```powershell theme={null}

767[Environment]::Is64BitOperatingSystem772[Environment]::Is64BitOperatingSystem

768```773```

769 774 

770これが `True` を出力する場合、オペレーティングシステムは問題ありません。ウィンドウを閉じ、x86 サフィックスなしで `Windows PowerShell` を開き、インストールコマンドを再度実行します。775これが `True` を出力する場合、オペレーティングシステムは問題ありません。ウィンドウを閉じ、x86 サフィックスなしで `Windows PowerShell` を開き、インストールコマンドを再度実行してください。

771 776 

772これが `False` を出力する場合、32 ビット版の Windows を使用しています。Claude Code には 64 ビットオペレーティングシステムが必要です。[システム要件](/docs/ja/setup#system-requirements)を参照してください。777これが `False` を出力する場合、32 ビット版の Windows にいます。Claude Code には 64 ビットオペレーティングシステムが必要です。[システム要件](/docs/ja/setup#system-requirements)を参照してください。

773 778 

774<h3 id="linux-musl-or-glibc-binary-mismatch">779<h3 id="linux-musl-or-glibc-binary-mismatch">

775 Linux musl または glibc バイナリの不一致780 Linux musl または glibc バイナリの不一致


807 812 

808**アーキテクチャの不一致。** インストーラーは間違ったバイナリをダウンロードしました。例えば ARM サーバーで x86。macOS または Linux で `uname -m` を使用して確認するか、PowerShell で `$env:PROCESSOR_ARCHITECTURE` を使用してください。結果が受け取ったバイナリと一致しない場合は、出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。813**アーキテクチャの不一致。** インストーラーは間違ったバイナリをダウンロードしました。例えば ARM サーバーで x86。macOS または Linux で `uname -m` を使用して確認するか、PowerShell で `$env:PROCESSOR_ARCHITECTURE` を使用してください。結果が受け取ったバイナリと一致しない場合は、出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。

809 814 

810**AVX 命令セットが見つかりません。** アーキテクチャは正しいが `Illegal instruction` が表示される場合、CPU はおそらく AVX またはバイナリが必要とする別の命令がありません。これは約 2013 年以前の Intel および AMD プロセッサー、および ハイパーバイザーが AVX をゲストに渡さない仮想マシンに影響します。815**AVX 命令セットが見つかりません。** アーキテクチャが正しいが、それでも `Illegal instruction` が表示される場合、CPU はおそらく AVX またはバイナリが必要とする別の命令がありません。これは約 2013 年以前の Intel および AMD プロセッサー、およびハイパーバイザーが AVX をゲストに渡さない仮想マシンに影響します。

811 816 

812VPS または VM では、`grep -m1 -ow avx /proc/cpuinfo` を実行します。空の結果は AVX がゲストで利用できないことを意味します。817VPS または VM では、`grep -m1 -ow avx /proc/cpuinfo` を実行してください。空の結果は AVX がゲストで利用できないことを意味します。

813 818 

814ネイティブバイナリの回避策はありません。ステータスについては [issue #50384](https://github.com/anthropics/claude-code/issues/50384) を追跡し、報告する際に Linux で `grep -m1 "model name" /proc/cpuinfo` または macOS で `sysctl -n machdep.cpu.brand_string` から CPU モデルを含めてください。819ネイティブバイナリの回避策はありません。ステータスについては [issue #50384](https://github.com/anthropics/claude-code/issues/50384) を追跡し、Linux で `grep -m1 "model name" /proc/cpuinfo` または macOS で `sysctl -n machdep.cpu.brand_string` から CPU モデルを報告する際に含めてください。

815 820 

816代替インストール方法は同じネイティブバイナリをダウンロードし、どちらの原因も解決しません。821代替インストール方法は同じネイティブバイナリをダウンロードし、どちらの原因も解決しません。

817 822 


840 845 

8411. **macOS バージョンを確認する**:Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。8461. **macOS バージョンを確認する**:Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。

842 847 

8432. **古いバージョンを使用している場合は macOS を更新する**。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの代替インストール方法は同じバイナリをダウンロードし、このエラーを解決しません。8482. **macOS を更新する**(古いバージョンにいる場合)。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの代替インストール方法は同じバイナリをダウンロードし、このエラーを解決しません。

844 849 

845<h3 id="exec-format-error-on-wsl1">850<h3 id="exec-format-error-on-wsl1">

846 WSL1 での `Exec format error`851 WSL1 での `Exec format error`


854wsl --set-version <DistroName> 2859wsl --set-version <DistroName> 2

855```860```

856 861 

857WSL1 にとどまる必要がある場合は、動的リンカーを通じてバイナリを呼び出します。ホームディレクトリが異なる場合はパスを置き換えて、WSL 内の `~/.bashrc` にこの関数を追加します。862WSL1 にとどまる必要がある場合は、動的リンカーを通じてバイナリを呼び出してください。ホームディレクトリが異なる場合はパスを置き換えて、WSL 内の `~/.bashrc` にこの関数を追加してください。

858 863 

859```bash theme={null}864```bash theme={null}

860claude() {865claude() {


862}867}

863```868```

864 869 

865次に `source ~/.bashrc` を実行して `claude` を再試行します。870次に `source ~/.bashrc` を実行して `claude` を再試行してください。

866 871 

867<h3 id="npm-install-errors-in-wsl">872<h3 id="npm-install-errors-in-wsl">

868 WSL での npm インストールエラー873 WSL での npm インストールエラー


870 875 

871これらの問題は、WSL 内で `npm install -g` を使用して Claude Code をインストールした場合に適用されます。[ネイティブインストーラー](/docs/ja/setup)を使用した場合は、このセクションをスキップしてください。876これらの問題は、WSL 内で `npm install -g` を使用して Claude Code をインストールした場合に適用されます。[ネイティブインストーラー](/docs/ja/setup)を使用した場合は、このセクションをスキップしてください。

872 877 

873**OS またはプラットフォーム検出の問題。** npm がインストール中にプラットフォームの不一致を報告する場合、WSL はおそらく Windows `npm` を選択しています。最初に `npm config set os linux` を実行してから、`npm install -g @anthropic-ai/claude-code --force` でインストールしてください。`sudo` を使用しないでください。878**OS またはプラットフォーム検出の問題。** npm がインストール中にプラットフォームの不一致を報告する場合、WSL は Windows `npm` を選択している可能性があります。最初に `npm config set os linux` を実行してから、`npm install -g @anthropic-ai/claude-code --force` でインストールしてください。`sudo` を使用しないでください。

874 879 

875**`claude` を実行するときの `exec: node: not found`。** WSL 環境はおそらく Node.js の Windows インストールを使用しています。`which npm` と `which node` で確認してください。`/mnt/c/` で始まるパスは Windows バイナリで、Linux パスは `/usr/` で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは [`nvm`](https://github.com/nvm-sh/nvm) 経由で Node をインストールしてください。880**`claude` を実行するときの `exec: node: not found`。** WSL 環境は Node.js の Windows インストールを使用している可能性があります。`which npm` と `which node` で確認してください。`/mnt/c/` で始まるパスは Windows バイナリであり、Linux パスは `/usr/` で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは [`nvm`](https://github.com/nvm-sh/nvm) 経由で Node をインストールしてください。

876 881 

877**nvm バージョンの競合。** WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL がデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを `~/.bashrc` または `~/.zshrc` に追加します。882**nvm バージョンの競合。** WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL がデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを `~/.bashrc` または `~/.zshrc` に追加してください。

878 883 

879```bash theme={null}884```bash theme={null}

880export NVM_DIR="$HOME/.nvm"885export NVM_DIR="$HOME/.nvm"


882[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"887[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

883```888```

884 889 

885または現在のセッションで読み込みます。890または現在のセッションに読み込んでください。

886 891 

887```bash theme={null}892```bash theme={null}

888source ~/.nvm/nvm.sh893source ~/.nvm/nvm.sh

889```894```

890 895 

891nvm が読み込まれているが Windows パスが引き続き優先される場合は、Linux ノードパスを明示的に先頭に追加します。896nvm が読み込まれているが Windows パスがまだ優先される場合は、Linux Node パスを明示的に先頭に追加してください。

892 897 

893```bash theme={null}898```bash theme={null}

894export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"899export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

895```900```

896 901 

897<Warning>902<Warning>

898 `appendWindowsPath = false` 経由で Windows PATH インポートを無効にすることは避けてください。これは WSL から Windows 実行可能ファイルを呼び出す機能を破壊します。同様に、Windows 開発に使用する場合は Windows から Node.js をアンインストールすることは避けてください。903 `appendWindowsPath = false` 経由で Windows PATH インポートを無効にすることは避けてください。これは WSL から Windows 実行可能ファイルを呼び出す機能を破壊します。同様に、Windows 開発に使用する場合は Windows から Node.js をアンインストールすることを避けてください。

899</Warning>904</Warning>

900 905 

901<h3 id="permission-errors-during-installation">906<h3 id="permission-errors-during-installation">


914 npm インストール後にネイティブバイナリが見つからない919 npm インストール後にネイティブバイナリが見つからない

915</h3>920</h3>

916 921 

917`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとしてコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーは残り、macOS と Linux で `claude` を実行すると出力されます。922`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとしてその場所にコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーはその場所に残り、macOS と Linux で `claude` を実行すると出力されます。

918 923 

919```text theme={null}924```text theme={null}

920Error: claude native binary not installed.925Error: claude native binary not installed.


933 938 

934次の原因を確認してください。939次の原因を確認してください。

935 940 

936* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してから、再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。941* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してください。次に再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。

937* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 構成は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境で実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけてそれを起動します。各起動時に余分なノードプロセスのコストで。ラッパーが `Could not find native binary package` を出力する代わりに、プラットフォームパッケージはダウンロードされなかったため、上記のオプション依存関係の原因を最初に修正してください。942* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 構成は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境でまったく実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけて起動します。各開始時に追加の Node プロセスのコストで。ラッパーが代わりに `Could not find native binary package` を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。

938* **サポートされていないプラットフォーム。** プリビルドバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/docs/ja/setup#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。943* **サポートされていないプラットフォーム。** プリビルトバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/docs/ja/setup#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。

939* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つの `@anthropic-ai/claude-code-*` プラットフォームパッケージすべてをミラーしていることを確認してください。944* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。

940 945 

941<h3 id="npm-enotempty-during-update-or-reinstall">946<h3 id="npm-enotempty-during-update-or-reinstall">

942 npm `ENOTEMPTY` エラー(更新または再インストール中)947 npm `ENOTEMPTY` エラー(更新または再インストール中)

943</h3>948</h3>

944 949 

945既存のインストール上で `npm install -g @anthropic-ai/claude-code` を実行すると、npm は古いパッケージディレクトリを移動しようとしている間に失敗する可能性があります。950既存のインストールに対して `npm install -g @anthropic-ai/claude-code` を実行すると、npm は古いパッケージディレクトリを移動しようとしている間に失敗する可能性があります。

946 951 

947```text theme={null}952```text theme={null}

948npm error code ENOTEMPTY953npm error code ENOTEMPTY


953npm error ENOTEMPTY: directory not empty, rename '...'958npm error ENOTEMPTY: directory not empty, rename '...'

954```959```

955 960 

956`npm error path` 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する `.claude-code-*` ディレクトリを削除してください。以下のコマンドは `npm root -g` でグローバルパッケージディレクトリを見つけます。`npm error path` 行が名前を付けるディレクトリが `npm root -g` が出力するディレクトリの下にない場合(例えば nvm でノードバージョンを切り替えた場合)、エラーが名前を付けるディレクトリを削除してください。961`npm error path` 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する `.claude-code-*` ディレクトリを削除してください。以下のコマンドは `npm root -g` でグローバルパッケージディレクトリを見つけます。`npm error path` 行が名前を付けるディレクトリが `npm root -g` が出力するディレクトリの下にない場合(例えば nvm でノードバージョンを切り替えたため)、エラーが名前を付けるディレクトリを削除してください。

957 962 

958<Tabs>963<Tabs>

959 <Tab title="macOS/Linux">964 <Tab title="macOS/Linux">


961 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"966 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

962 ```967 ```

963 968 

964 次に、残っているテンポラリディレクトリを削除します。Zsh が `no matches found` を出力する場合、削除するものはありませんでした。969 次に残りのテンポディレクトリを削除してください。Zsh が `no matches found` を出力する場合、削除するものはありませんでした。

965 970 

966 ```bash theme={null}971 ```bash theme={null}

967 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*972 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*


975 </Tab>980 </Tab>

976</Tabs>981</Tabs>

977 982 

978次に再インストールします。983次に再インストールしてください。

979 984 

980```bash theme={null}985```bash theme={null}

981npm install -g @anthropic-ai/claude-code986npm install -g @anthropic-ai/claude-code

982```987```

983 988 

984`claude --version` で確認します。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。989`claude --version` で確認してください。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。

985 990 

986<h2 id="login-and-authentication">991<h2 id="login-and-authentication">

987 ログインと認証992 ログインと認証


1017 ログイン後の 403 Forbidden1022 ログイン後の 403 Forbidden

1018</h3>1023</h3>

1019 1024 

1020ログイン後に `API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}` が表示される場合:1025ログイン後に `API Error: 403 Request not allowed` が表示される場合:

1021 1026 

1022* **Claude Pro/Max ユーザー**:[claude.ai/settings](https://claude.ai/settings) でサブスクリプションがアクティブであることを確認してください1027* **Claude Pro/Max ユーザー**:[claude.ai/settings](https://claude.ai/settings) でサブスクリプションがアクティブであることを確認してください

1023* **Anthropic Console ユーザー**:アカウントに「Claude Code」または「Developer」ロールがあることを確認してください。管理者は Anthropic Console の設定 → メンバーで割り当てます。1028* **Anthropic Console ユーザー**:アカウントに「Claude Code」または「Developer」ロールがあることを確認してください。管理者は Anthropic Console の設定 → メンバーで割り当てます。

Details

52 `.heapsnapshot` ファイルには、プロセス内のすべての文字列が含まれています。これには、完全なカンバセーションと認証情報が含まれます。公開の issue に添付したり、共有したりしないでください。52 `.heapsnapshot` ファイルには、プロセス内のすべての文字列が含まれています。これには、完全なカンバセーションと認証情報が含まれます。公開の issue に添付したり、共有したりしないでください。

53</Warning>53</Warning>

54 54 

55コマンドはカンバセーションに要約も出力します。resident set size、JS ヒープ、array buffers、および説明されていないネイティブメモリを表示します。また、高いメモリ増加率や異常に多くのオープンハンドルなど、検出されたリーク指標も表示します。要約は、ほとんどのメモリが JS ヒープ(スナップショットがキャプチャする)にあるか、ネイティブメモリ(キャプチャしない)にあるかを示します。55コマンドはカンバセーションに要約も出力します。プロセスの合計メモリ、JS ヒープ内のメモリ量、ヒープ外のメモリ量を表示します。また、高いメモリ増加率や異常に多くのオープンハンドルなど、検出されたリーク指標も表示します。要約は、ほとんどのメモリが JS ヒープ(スナップショットがキャプチャする)にあるか、ネイティブメモリ(キャプチャしない)にあるかを示します。

56 56 

57出力に対して次の 2 つのいずれかを実行します:57出力に対して次の 2 つのいずれかを実行します:

58 58 

workflows.md +1 −1

Details

91 実行を監視する91 実行を監視する

92</h3>92</h3>

93 93 

94ワークフローはバックグラウンドで実行されるため、エージェントが作業している間、セッションは応答性を保ちます。任意の時点で `/workflows` を実行して、実行中および完了したワークフローをリストアップし、1 つを選択してその進捗ビューを開きます。94ワークフローはバックグラウンドで実行されるため、エージェントが作業している間、セッションは応答性を保ちます。任意の時点で `/workflows` を実行して、実行中および完了したワークフローをリストアップし、1 つを選択してその進捗ビューを開きます。実行中のワークフローを開かずに停止するには、リストで選択して `x` を押します。

95 95 

96進捗ビューには、各フェーズがエージェント数、トークン合計、経過時間とともに表示されます。フッターには各アクションのキーが表示されます。96進捗ビューには、各フェーズがエージェント数、トークン合計、経過時間とともに表示されます。フッターには各アクションのキーが表示されます。

97 97