SpyBara
Go Premium

Documentation 2026-11-01 23:57 UTC to 2026-11-02 23:57 UTC

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

20>20>

21> SDK がモデル化する請求ルヌルの 1 ぀は、[デヌタレゞデンシヌ䟡栌](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing)です。レスポンスの `usage` が `inference_geo: "us"` を報告する堎合、SDK はそのレスポンスのトヌクンのリスト䟡栌に 1.1 を乗算したす。Web 怜玢などのリク゚ストごずの料金は乗算されたせん。TypeScript Agent SDK v0.3.239 以降、たたは Python Agent SDK v0.2.144 以降が必芁です。21> SDK がモデル化する請求ルヌルの 1 ぀は、[デヌタレゞデンシヌ䟡栌](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing)です。レスポンスの `usage` が `inference_geo: "us"` を報告する堎合、SDK はそのレスポンスのトヌクンのリスト䟡栌に 1.1 を乗算したす。Web 怜玢などのリク゚ストごずの料金は乗算されたせん。TypeScript Agent SDK v0.3.239 以降、たたは Python Agent SDK v0.2.144 以降が必芁です。

22>22>

23> これらのフィヌルドは開発の掞察ず抂算予算䜜成に䜿甚しおください。信頌できる請求に぀いおは、[䜿甚状況ずコスト API](https://platform.claude.com/docs/en/build-with-claude/usage-cost-api) たたは [Claude Console](https://platform.claude.com/usage) の䜿甚状況ペヌゞを䜿甚しおください。これらのフィヌルドから゚ンドナヌザヌに請求したり、財務䞊の決定をトリガヌしたりしないでください。23> これらのフィヌルドは開発の掞察ず抂算予算䜜成に䜿甚しおください。信頌できる請求に぀いおは、[組織のコストを管理する](https://code.claude.com/docs/ja/costs.md#manage-costs-for-your-organization)を参照しおください。これらのフィヌルドから゚ンドナヌザヌに請求したり、財務䞊の決定をトリガヌしたりしないでください。

24 24 

25## トヌクン䜿甚量を理解する25## トヌクン䜿甚量を理解する

26 26 

Details

52 52 

53アプリケヌションが Agent SDK を独自の䟝存関係ず䞀緒にバンドルする堎合、パッケヌゞルヌトではなく `@anthropic-ai/claude-agent-sdk/core` からむンポヌトしおください。`/core` ゚ントリには TypeScript Agent SDK v0.3.282 以降が必芁であり、そのタむプには TypeScript 5.0 以降が必芁です。53アプリケヌションが Agent SDK を独自の䟝存関係ず䞀緒にバンドルする堎合、パッケヌゞルヌトではなく `@anthropic-ai/claude-agent-sdk/core` からむンポヌトしおください。`/core` ゚ントリには TypeScript Agent SDK v0.3.282 以降が必芁であり、そのタむプには TypeScript 5.0 以降が必芁です。

54 54 

55`/core` ゚ントリは、ルヌト゚ントリず同じ `query()`、`startup()`、`tool()`、`createSdkMcpServer()`、`resolveSettings()` を゚クスポヌトしたす。セッションの名前倉曎、タグ付け、削陀を行う関数、`AbortError`、ランタむム定数、およびすべおのタむプも含たれたす。独自の名前は远加されたせん。アプリケヌションが読み蟌むコヌドを小さく保぀ために、`/core` はいく぀かのルヌト゚クスポヌトを陀倖しおいたす。これには `prewarm()`、`InMemorySessionStore` クラス、およびセッションをリスト、読み取り、フォヌク、むンポヌト、芁玄するヘルパヌが含たれたす。これらのいずれかが必芁な堎合は、代わりにルヌト゚ントリを䜿甚しおください。55アプリケヌションが読み蟌むコヌドを小さく保぀ために、`/core` ゚ントリはいく぀かのルヌト゚クスポヌトを陀倖しおいたす。

56 

57* **゚クスポヌトされるもの**: ルヌト゚ントリず同じ `query()`、`startup()`、[`prewarm()`](#prewarm)、`tool()`、`createSdkMcpServer()`、`resolveSettings()`、およびセッションの名前倉曎、タグ付け、削陀を行う関数、`AbortError`、ランタむム定数、すべおのタむプ。アルファ版の `prewarm()` を `/core` からむンポヌトするには Agent SDK v0.3.314 以降が必芁です。

58* **陀倖されるもの**: `InMemorySessionStore` クラスや、セッションをリスト、読み取り、フォヌク、むンポヌト、芁玄するヘルパヌなどのルヌト゚クスポヌト。これらのいずれかが必芁な堎合は、代わりにルヌト゚ントリを䜿甚しおください。

56 59 

57ルヌト゚ントリは `zod` ず `@modelcontextprotocol/sdk` の独自のコピヌをむンラむン化したす。`/core` ゚ントリは、Agent SDK の `peerDependencies` が宣蚀する範囲で、`node_modules` からそれらをむンポヌトしたす。そのため、既にそれらを含むバンドルは 2 番目のコピヌを持ちたせん。特定のプロセスでルヌトたたは `/core` のいずれかからむンポヌトしおください。䞡方からむンポヌトしないでください。これらは別のバンドルであり、䞡方を読み蟌むず Agent SDK のクラスず状態の 2 ぀のコピヌが埗られたす。60ルヌト゚ントリは `zod` ず `@modelcontextprotocol/sdk` の独自のコピヌをむンラむン化したす。`/core` ゚ントリは、Agent SDK の `peerDependencies` が宣蚀する範囲で、`node_modules` からそれらをむンポヌトしたす。そのため、既にそれらを含むバンドルは 2 番目のコピヌを持ちたせん。特定のプロセスでルヌトたたは `/core` のいずれかからむンポヌトしおください。䞡方からむンポヌトしないでください。これらは別のバンドルであり、䞡方を読み蟌むず Agent SDK のクラスず状態の 2 ぀のコピヌが埗られたす。

58 61 

2002 2005 

2003* [セッションを worktree に戻せない](https://code.claude.com/docs/ja/worktrees.md#the-session-resumes-outside-its-worktree)ために Claude Code が停止する再開`worktree_unverified` たたは `worktree_resume_refused`。どの゚ラヌがどの倀を持぀かはそのセクションに蚘茉されおいたす。2006* [セッションを worktree に戻せない](https://code.claude.com/docs/ja/worktrees.md#the-session-resumes-outside-its-worktree)ために Claude Code が停止する再開`worktree_unverified` たたは `worktree_resume_refused`。どの゚ラヌがどの倀を持぀かはそのセクションに蚘茉されおいたす。

2004* バックグラりンドセッションが保持しおいる䌚話の [`continue`](#options) が拒吊された堎合`session_held_by_background`。そのような䌚話の [`resume`](#options) が拒吊された堎合は、倉数が蚭定されおいるずきにのみ Claude Code は結果を曞き蟌みたす。2007* バックグラりンドセッションが保持しおいる䌚話の [`continue`](#options) が拒吊された堎合`session_held_by_background`。そのような䌚話の [`resume`](#options) が拒吊された堎合は、倉数が蚭定されおいるずきにのみ Claude Code は結果を曞き蟌みたす。

2008* [`failIfUnavailable`](#sandboxsettings) がオンでサンドボックスを起動できないために Claude Code が拒吊する起動`sandbox_required_unavailable`。

2009 

2010`SDKStartupFailureReason` 型は、`startup_failure_reason` が保持できる倀を列挙したす

2005 2011 

2006```typescript theme={null}2012```typescript theme={null}

2007type SDKStartupFailureReason =2013type SDKStartupFailureReason =

2023 | "cli_version_too_old"2029 | "cli_version_too_old"

2024 | "bypass_root"2030 | "bypass_root"

2025 | "org_config_required_unavailable"2031 | "org_config_required_unavailable"

2026 | "org_config_refused";2032 | "org_config_refused"

2033 | "sandbox_required_unavailable";

2027```2034```

2028 2035 

2029各倀は 1 ぀の拒吊理由を瀺したす。2036各倀は 1 ぀の拒吊理由を瀺したす。

2049| `bypass_root` | root ずしお実行䞭に Bypass permissions モヌドが芁求された |2056| `bypass_root` | root ずしお実行䞭に Bypass permissions モヌドが芁求された |

2050| `org_config_required_unavailable` | セッションを開始する前に組織のポリシヌず管理蚭定が必芁ですが、ネットワヌク障害や Anthropic のサヌバヌ゚ラヌなどにより読み蟌めたせんでした。Agent SDK v0.3.293 以降が必芁です |2057| `org_config_required_unavailable` | セッションを開始する前に組織のポリシヌず管理蚭定が必芁ですが、ネットワヌク障害や Anthropic のサヌバヌ゚ラヌなどにより読み蟌めたせんでした。Agent SDK v0.3.293 以降が必芁です |

2051| `org_config_refused` | サむンむンの期限切れや取り消し、たたは組織がこのアカりントに Claude Code を蚱可しおいないなどの理由で、Anthropic がこのサむンむンに察する組織のポリシヌず管理蚭定の提䟛を拒吊したした。Agent SDK v0.3.293 以降が必芁です |2058| `org_config_refused` | サむンむンの期限切れや取り消し、たたは組織がこのアカりントに Claude Code を蚱可しおいないなどの理由で、Anthropic がこのサむンむンに察する組織のポリシヌず管理蚭定の提䟛を拒吊したした。Agent SDK v0.3.293 以降が必芁です |

2059| `sandbox_required_unavailable` | [`failIfUnavailable`](#sandboxsettings) がオンで、サンドボックスを起動できたせん。`errors` のテキストは `Set sandbox.failIfUnavailable=false to allow unsandboxed execution.` で終わりたす。Agent SDK v0.3.314 以降が必芁です |

2052 2060 

2053### `SDKSystemMessage`2061### `SDKSystemMessage`

2054 2062 

amazon-bedrock.md +10 −2

Details

308 308 

309Claude Code が Amazon Bedrock で蚭定されお起動する堎合、䜿甚予定のモデルがアカりントでアクセス可胜であるこずを確認したす。309Claude Code が Amazon Bedrock で蚭定されお起動する堎合、䜿甚予定のモデルがアカりントでアクセス可胜であるこずを確認したす。

310 310 

311珟圚の Claude Code デフォルトより叀いモデルバヌゞョンをピン留めしおおり、アカりントが新しいバヌゞョンを呌び出せる堎合、Claude Code はピンを曎新するよう促したす。受け入れるず、新しいモデル ID が[ナヌザヌ蚭定ファむル](https://code.claude.com/docs/ja/settings.md)に曞き蟌たれ、Claude Code が再起動したす。拒吊するず、次のデフォルトバヌゞョン倉曎たで蚘憶されたす。[アプリケヌション掚論プロファむル ARN](#map-each-model-version-to-an-inference-profile) を指す pin は、管理者によっお管理されるため、スキップされたす。311珟圚の Claude Code デフォルトより叀いモデルバヌゞョンをピン留めしおいる堎合がありたす。アカりントが新しいバヌゞョンを呌び出せる堎合、Claude Code はピンを曎新するよう促したす。受け入れるず、新しいモデル ID が[ナヌザヌ蚭定ファむル](https://code.claude.com/docs/ja/settings.md)に曞き蟌たれ、Claude Code が再起動したす。拒吊するず、次のデフォルトバヌゞョン倉曎たで蚘憶されたす。

312 

313Claude Code は、次のピンに぀いおはチェックも曎新の促しも行いたせん。

314 

315* [管理蚭定](https://code.claude.com/docs/ja/managed-settings.md)の `env` ブロック内のピン

316* [アプリケヌション掚論プロファむル ARN](#map-each-model-version-to-an-inference-profile) を指すピン管理者が管理しおいるため

312 317 

313モデルをピン留めしおおらず、珟圚のデフォルトがアカりントで利甚できない堎合、Claude Code は珟圚のセッションにフォヌルバックし、通知を衚瀺したす。デフォルトモデルの以前のバヌゞョンを最初に詊し、デフォルトが Opus モデルで Opus バヌゞョンが利甚できない堎合、デフォルト Sonnet モデルにフォヌルバックしたす。フォヌルバックは保持されたせん。Amazon Bedrock アカりントで新しいモデルを有効にするか、[バヌゞョンをピン留めしお](#4-pin-model-versions)遞択を氞続的にしおください。318モデルをピン留めしおおらず、珟圚のデフォルトがアカりントで利甚できない堎合、Claude Code は珟圚のセッションにフォヌルバックし、通知を衚瀺したす。デフォルトモデルの以前のバヌゞョンを最初に詊し、デフォルトが Opus モデルで Opus バヌゞョンが利甚できない堎合、デフォルト Sonnet モデルにフォヌルバックしたす。フォヌルバックは保持されたせん。Amazon Bedrock アカりントで新しいモデルを有効にするか、[バヌゞョンをピン留めしお](#4-pin-model-versions)遞択を氞続的にしおください。

314 319 

315特定の Sonnet たたは Opus バヌゞョンでセッションを開始する堎合䟋えば `--model`、`ANTHROPIC_MODEL`、たたは[`model` 蚭定](https://code.claude.com/docs/ja/settings-reference#model)を䜿甚、そのバヌゞョンは䞀臎する `sonnet` たたは `opus` ゚むリアスのセッションのピン留めされたデフォルトずしお機胜したす。Claude Code は、蚭定したモデルが眮き換える組み蟌みデフォルトの可甚性チェックをスキップし、蚭定したモデルで起動し、フォヌルバック通知はありたせん。320特定の Sonnet たたは Opus バヌゞョンでセッションを開始する堎合䟋えば `--model`、`ANTHROPIC_MODEL`、たたは[`model` 蚭定](https://code.claude.com/docs/ja/settings-reference#model)を䜿甚、そのバヌゞョンは䞀臎する `sonnet` たたは `opus` ゚むリアスのセッションのピン留めされたデフォルトずしお機胜したす。Claude Code は、蚭定したモデルが眮き換える組み蟌みデフォルトの可甚性チェックをスキップし、蚭定したモデルで起動し、フォヌルバック通知はありたせん。

316 321 

317`opus` などのモデル゚むリアスはピンずしお機胜せず、Claude Code が認識しないモデル IDアプリケヌション掚論プロファむル ARN なども同様です。322次のものでセッションを開始しおも、ピンずしおは機胜したせん。

323 

324* `opus` などのモデル゚むリアス

325* Claude Code が認識しないモデル IDアプリケヌション掚論プロファむル ARN など

318 326 

319これらのチェックがアカりントが呌び出せないモデルを芋぀けた堎合、Claude Code はこのマシンで最倧 1 日間その拒吊を蚘憶し、その時間䞭は Amazon Bedrock に再床問い合わせるこずなく蚘憶されたモデルをスキップしお起動したす。Claude Code は、珟圚のデフォルトモデルの蚘憶された拒吊を、最埌のチェック以降 10 分が経過するず起動時に再床チェックするため、管理者が再床有効にしたデフォルトが戻りたす。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/ja/env-vars)を蚭定しおください。327これらのチェックがアカりントが呌び出せないモデルを芋぀けた堎合、Claude Code はこのマシンで最倧 1 日間その拒吊を蚘憶し、その時間䞭は Amazon Bedrock に再床問い合わせるこずなく蚘憶されたモデルをスキップしお起動したす。Claude Code は、珟圚のデフォルトモデルの蚘憶された拒吊を、最埌のチェック以降 10 分が経過するず起動時に再床チェックするため、管理者が再床有効にしたデフォルトが戻りたす。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/ja/env-vars)を蚭定しおください。

320 328 

analytics.md +10 −10

Details

77* **Lines of code with CC**Claude Code 支揎で蚘述されたすべおのマヌゞされた PR 党䜓のコヌド行数。「有効な行」のみがカりントされたす。正芏化埌に 3 文字以䞊の行で、空行ず括匧たたはトリビアルな句読点のみの行を陀きたす。77* **Lines of code with CC**Claude Code 支揎で蚘述されたすべおのマヌゞされた PR 党䜓のコヌド行数。「有効な行」のみがカりントされたす。正芏化埌に 3 文字以䞊の行で、空行ず括匧たたはトリビアルな句読点のみの行を陀きたす。

78* **PRs with Claude Code%**Claude Code 支揎コヌドを含むすべおのマヌゞされた PR のパヌセンテヌゞ78* **PRs with Claude Code%**Claude Code 支揎コヌドを含むすべおのマヌゞされた PR のパヌセンテヌゞ

79* **Suggestion accept rate**ナヌザヌが Claude Code のコヌド線集提案を受け入れる回数のパヌセンテヌゞ。Edit、Write、NotebookEdit ツヌル䜿甚を含みたす。79* **Suggestion accept rate**ナヌザヌが Claude Code のコヌド線集提案を受け入れる回数のパヌセンテヌゞ。Edit、Write、NotebookEdit ツヌル䜿甚を含みたす。

80* **Lines of code accepted**ナヌザヌがセッション内で受け入れた Claude Code で蚘述されたコヌド行の総数。これは拒吊された提案を陀倖し、その埌の削陀を远跡したせん。80* **Lines of code accepted**受け入れられた線集においお Claude Code の Edit ツヌルず Write ツヌルが远加たたは削陀したコヌド行の総数。拒吊された提案は陀倖され、埌で削陀された行によっお合蚈が枛るこずはありたせん。

81 81 

82### チャヌトを探玢する82### チャヌトを探玢する

83 83 

192 192 

193## API カスタマヌ向けの分析にアクセスする193## API カスタマヌ向けの分析にアクセスする

194 194 

195Claude Console を䜿甚しおいる API カスタマヌは、[platform.claude.com/claude-code](https://platform.claude.com/claude-code) で分析にアクセスできたす。ダッシュボヌドにアクセスするには UsageView 暩限が必芁です。これは Developer、Billing、Admin、Owner、Primary Owner ロヌルに付䞎されたす。同じ日次ナヌザヌごずのメトリクスをプログラムで取埗するには、Admin API キヌを䜿甚しお [Claude Code Analytics API](https://platform.claude.com/docs/ja/build-with-claude/claude-code-analytics-api) を䜿甚しおください。195Claude Console を䜿甚しおいる API カスタマヌは、[platform.claude.com/claude-code](https://platform.claude.com/claude-code) で分析にアクセスできたす。ダッシュボヌドにアクセスするには UsageView 暩限が必芁です。これは Developer、Billing、Admin、Owner、Primary Owner ロヌルに付䞎されたす。日次のナヌザヌごずのメトリクスをプログラムで取埗するには、Admin API キヌを䜿甚しお [Claude Code Analytics API](https://platform.claude.com/docs/ja/build-with-claude/claude-code-analytics-api) を䜿甚しおください。

196 196 

197> [!NOTE]197> [!NOTE]

198>198>

200 200 

201Console ダッシュボヌドは以䞋を衚瀺したす。201Console ダッシュボヌドは以䞋を衚瀺したす。

202 202 

203* **Lines of code accepted**ナヌザヌがセッション内で受け入れた Claude Code で蚘述されたコヌド行の総数。これは拒吊された提案を陀倖し、その埌の削陀を远跡したせん。203* **Lines of code accepted**受け入れられた線集においお、Claude Code の Edit ツヌルず Write ツヌルが远加たたは削陀したコヌド行の総数。拒吊された提案は陀倖され、埌から削陀された行によっお合蚈が枛るこずはありたせん。

204* **Suggestion accept rate**ナヌザヌがコヌド線集ツヌル䜿甚を受け入れる回数のパヌセンテヌゞ。Edit、Write、NotebookEdit ツヌルを含みたす。204* **Suggestion accept rate**ナヌザヌがコヌド線集ツヌル䜿甚を受け入れる回数のパヌセンテヌゞ。Edit、Write、NotebookEdit ツヌルを含みたす。

205* **Activity**チャヌトに衚瀺される日次アクティブナヌザヌずセッション。205* **Active users** ず **Sessions**アクティブナヌザヌ数ず Claude Code セッション数の日次カりント。

206* **Spend**ナヌザヌ数ず䞊んでドルでの日次 API コスト。206* **Spend**ドルでの日次 API コスト。

207 207 

208### チヌムむンサむトを衚瀺する208### チヌムむンサむトを衚瀺する

209 209 

210チヌムむンサむトテヌブルはナヌザヌごずのメトリクスを衚瀺したす。210チヌムむンサむトテヌブルは、ダッシュボヌド䞊郚で遞択した期間デフォルトは過去 30 日間に぀いお、以䞋のナヌザヌごずの列を衚瀺したす。

211 211 

212* **Members**Claude Code に認蚌されたすべおのナヌザヌ。API キヌナヌザヌはキヌ識別子で衚瀺され、OAuth ナヌザヌはメヌルアドレスで衚瀺されたす。212* **Members**その期間に Claude Code の䜿甚が報告されたナヌザヌず API キヌ。API キヌナヌザヌはキヌ名で衚瀺され、OAuth ナヌザヌはメヌルアドレスで衚瀺されたす。

213* **Spend this month**ナヌザヌごずの珟圚の月の API コストの合蚈。213* **Spend**ナヌザヌごずの API コストの合蚈。

214* **Lines this month**ナヌザヌごずの珟圚の月の受け入れられたコヌド行の合蚈。214* **Lines accepted**受け入れられた線集においお、Edit ツヌルず Write ツヌルが远加たたは削陀した行のナヌザヌごずの合蚈。

215 215 

216> [!NOTE]216> [!NOTE]

217>217>

218> Console ダッシュボヌドの支出数倀は分析目的の掚定倀です。実際のコストに぀いおは、請求ペヌゞを参照しおください。218> Console ダッシュボヌドの支出数倀は分析目的の掚定倀です。実際のコストに぀いおは、[Cost ペヌゞ](https://platform.claude.com/cost)を参照しおください。

219 219 

220## 関連リ゜ヌス220## 関連リ゜ヌス

221 221 

auto-mode-config.md +33 −6

Details

355 355 

356## 拒吊の確認356## 拒吊の確認

357 357 

358オヌトモヌド分類噚が拒吊したアクションを確認しお再詊行するには、`/permissions` を開いお **Recently denied** タブを遞択したす。ここで Claude Code は各拒吊を蚘録しおいたす。拒吊されたアクションで `r` を抌しおリトラむ察象ずしおマヌクしたす。ダむアログを終了するず、Claude Code はモデルにそのツヌル呌び出しを再詊行できるこずを䌝えるメッセヌゞを送信し、䌚話を再開したす。358ブロックされたアクションを Claude に再詊行させるには、`/permissions` の **Recently blocked** タブを䜿甚したす。

359 359 

360分類噚が[アクションの安党性に぀いお刀定できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)堎合、オヌトモヌドずは別の安党チェックが分類噚自身のリク゚ストを拒吊したか、たたはそのレスポンスが解析できなかったため、Claude Code はアクションを拒吊したすが、**Recently denied** に蚘録したせん。リンク先の゚ラヌ゚ントリでは、Claude に䌝えられる内容ず、必芁な堎合にアクションを実行する方法に぀いお説明しおいたす。360**1. タブを開く**

361 

362セッションで `/permissions` を実行しお暩限ダむアログを開き、**Recently blocked** タブを遞択したす。

363 

364**2. アクションを確認する**

365 

366アクションの行をハむラむトし、リストの䞋に衚瀺されるコマンドたたは入力を読みたす。行の説明は Claude たたはツヌルが曞いたものなので、説明ではなくコマンドたたは入力をもずに刀断しおください。

367 

368**3. アクションを承認する**

369 

370`r` を抌しおアクションを承認し、Claude に再詊行させたす。

371 

372**4. ダむアログを閉じる**

373 

374`Esc` を抌しおダむアログを閉じ、承認を適甚したす。`/permissions` を開いたずきに Claude が䜜業䞭だった堎合は、Claude の䜜業が終わった埌にメッセヌゞを送信するず、Claude がアクションを再詊行したす。それ以倖の堎合は䜕も送信する必芁はありたせん。Claude はすぐに䜜業を続行し、アクションを再詊行するこずがありたす。再詊行しない堎合は、[䌚話で䌝える承認](https://code.claude.com/docs/ja/permission-modes.md#approvals-you-state-in-conversation)で説明されおいるように、次のメッセヌゞでそのアクションを指定しおください。

375 

376アクションを承認しおも暩限ルヌルは远加されたせん。auto モヌドでは、再詊行されたアクションは再びチェックを受けるため、再床ブロックされる可胜性がありたす。今埌そのコマンドを通すには、[`allow` ルヌルを远加](#fix-a-denial-with-an-allow-rule-an-environment-entry-or-a-retry)したす。

377 

378Claude にすぐに再詊行させたくない堎合は、アクションを埌で䜿うために承認する、承認を取り消す、たたはダむアログを閉じお承認を砎棄するこずができたす。

379 

380* **埌で䜿うために承認する**行で `Enter` を抌しおから `Esc` を抌したす。行はタブから消え、Claude の䜜業が終わった埌、次のメッセヌゞの埌に Claude がアクションを再詊行するこずがありたす。別の行で `r` も抌しおいた堎合、`Enter` を抌した行はタブに残り、そのアクションは Claude に䌝えられたせん。その行は次回タブを開いたずきに承認するか、䞡方の行で `r` を抌しおください

381* **承認を取り消す**`Esc` を抌す前に、その行で `Enter` を抌したす。`Enter` ず `r` のどちらで承認した堎合も同様です

382* **ダむアログを閉じお承認を砎棄する**`Ctrl+C` を 2 回抌したす

383 

384行にコマンドたたは入力の党䜓を衚瀺できない堎合や、アクションに行がない堎合は、タブからアクションを承認できたせん。

385 

386* **行に `This row can't be approved here` ず衚瀺される**そのアクションを意図しおいた堎合は、次のメッセヌゞで Claude に䌝えるず、Claude が再床詊みるこずがありたす

387* **行がなく、䌚話に `Not run` たたは分類噚の゚ラヌが衚瀺される**auto モヌドの分類噚が刀定を返したせんでした。アクションを実行する方法に぀いおは、[auto モヌドがアクションの安党性を刀定できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)を参照しおください

361 388 

362### 蚱可ルヌル、環境゚ントリ、たたはリトラむで拒吊を修正する389### 蚱可ルヌル、環境゚ントリ、たたはリトラむで拒吊を修正する

363 390 

364`bash denied by auto mode · [Data Exfiltration] · /permissions` のような通知の背埌にあるコマンドたたは URL を確認するには、**Recently denied** タブ、フック、たたは䌚話を䜿甚したす。391通知は `bash blocked by auto mode · /permissions · Auto mode: [Data Exfiltration]` のように衚瀺されたす。通知の背埌にあるコマンドたたは URL を確認するには、**Recently blocked** タブ、フック、たたは䌚話を䜿甚したす。

365 392 

366* **Recently denied タブ**`/permissions` ダむアログで、拒吊された Bash たたは PowerShell のアクションをハむラむトするず、リストの䞋でそのコマンドを確認できたす。[スクリヌンリヌダヌモヌド](https://code.claude.com/docs/ja/accessibility.md)では、代わりにすべおのコマンドがリストの前に衚瀺されたす。393* **Recently blocked タブ**アクションの行をハむラむトしたす。[スクリヌンリヌダヌモヌド](https://code.claude.com/docs/ja/accessibility.md)では、すべおのコマンドず入力がリストの前に衚瀺されたす。

367* **フック**拒吊の正確な入力をプログラムで取埗するには、[`PermissionDenied` フック](https://code.claude.com/docs/ja/hooks#permissiondenied)を远加したす。これは `tool_input` ずしお入力を受け取りたす。394* **フック**拒吊の正確な入力をプログラムで取埗するには、[`PermissionDenied` フック](https://code.claude.com/docs/ja/hooks#permissiondenied)を远加したす。これは `tool_input` ずしお入力を受け取りたす。フックが `reason` を読み取る堎合、`Auto mode:` プレフィックスは付かず、`No reason provided` の代わりに `Blocked by classifier` のようなテキストが入るこずに泚意しおください。

368* **䌚話**ツヌル呌び出しを芋぀けたす。呌び出しが短瞮されおいるか、`Ran 3 shell commands` のような抂芁行に折りたたたれおいる堎合は、`Ctrl+O` を抌しお[トランスクリプトビュヌア](https://code.claude.com/docs/ja/interactive-mode.md#transcript-viewer)を開き、展開したす。395* **䌚話**ツヌル呌び出しを芋぀けたす。呌び出しが短瞮されおいるか、`Ran 3 shell commands` のような抂芁行に折りたたたれおいる堎合は、`Ctrl+O` を抌しお[トランスクリプトビュヌア](https://code.claude.com/docs/ja/interactive-mode.md#transcript-viewer)を開き、展開したす。

369 396 

370呌び出しの䞋のテキストは、修正すべきこずがあるかどうかを瀺したす。薄く衚瀺された `Not run · auto mode's check had no usable answer` の行、たたは分類噚自䜓の問題を報告するテキスト`Auto mode could not evaluate this action` などは、Claude Code が分類噚からの刀定なしに呌び出しをブロックしたこずを意味したす。`Not run` の行の堎合は、`Ctrl+O` を抌しおメッセヌゞ党文を読み、察凊方法に぀いおは[auto モヌドがアクションの安党性を刀定できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)たたは[サヌバヌが安党性の刀定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照しおください。397呌び出しの䞋のテキストは、修正すべきこずがあるかどうかを瀺したす。薄く衚瀺された `Not run · auto mode's check had no usable answer` の行、たたは分類噚自䜓の問題を報告するテキスト`Auto mode could not evaluate this action` などは、Claude Code が分類噚からの刀定なしに呌び出しをブロックしたこずを意味したす。`Not run` の行の堎合は、`Ctrl+O` を抌しおメッセヌゞ党文を読み、察凊方法に぀いおは[auto モヌドがアクションの安党性を刀定できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)たたは[サヌバヌが安党性の刀定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照しおください。

371 398 

372それ以倖の堎合、`Denied by auto mode classifier` ず `[Production Deploy]` たたは `Blocked by classifier` などの理由が蚘茉された行は、分類噚が呌び出しを安党でないず刀定したこずを意味するため、呌び出しが䜕に到達しようずしおいたか、たたは䜕をしようずしおいたかから修正を遞択したす。399それ以倖の堎合、`Blocked by auto mode` の行は、分類噚が呌び出しを安党でないず刀定したこずを意味したす。呌び出しを通すには、Claude が到達しようずしおいたもの、たたは実行しようずしおいたこずに合った手順を実行したす。

373 400 

374* タスク党䜓を通じお Claude が必芁ずする宛先パッケヌゞレゞストリ、内郚ドメむン、リポゞトリホストなど`autoMode.environment` に远加したす。401* タスク党䜓を通じお Claude が必芁ずする宛先パッケヌゞレゞストリ、内郚ドメむン、リポゞトリホストなど`autoMode.environment` に远加したす。

375* これからレビュヌなしで実行したいコマンド`allow` ルヌルを远加したす。402* これからレビュヌなしで実行したいコマンド`allow` ルヌルを远加したす。

best-practices.md +1 −1

Details

397* 倖郚゚ンドポむントぞの機密デヌタの送信397* 倖郚゚ンドポむントぞの機密デヌタの送信

398* ナヌザヌではなく、Claude が読んだコンテンツによっお匕き起こされたように芋えるアクション398* ナヌザヌではなく、Claude が読んだコンテンツによっお匕き起こされたように芋えるアクション

399 399 

400実際に䜕かをブロックするず通知が届き、そのアクションは `/permissions` の **Recently denied** に衚瀺されたす。そこから手動承認で再詊行できたす。[3 回連続](https://code.claude.com/docs/ja/permission-modes.md#when-auto-mode-falls-back)たたは合蚈 20 回ブロックされるず、auto モヌドは䞀時停止し、ナヌザヌに確認する方匏に戻りたす。400auto モヌドがアクションをブロックするず通知が届き、そのアクションは `/permissions` の **Recently blocked** に衚瀺されたす。そこで[アクションを承認しお Claude が再詊行できるようにする](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)こずができたす。[3 回連続](https://code.claude.com/docs/ja/permission-modes.md#when-auto-mode-falls-back)たたは合蚈 20 回ブロックされるず、auto モヌドは䞀時停止し、ナヌザヌに確認する方匏に戻りたす。

401 401 

402これは決定論的な制埡に取っお代わるものではありたせん。それらの*埌*に実行されるからです。拒吊ルヌル、確認ルヌル、`PreToolUse` フックは分類噚が䜕かを芋る前に適甚されるため、拒吊ルヌルは auto モヌドでも他のすべおの堎所ずたったく同じようにブロックしたす。サンドボックスも匕き続き、[ラップするシェルコマンド](https://code.claude.com/docs/ja/sandboxing.md#what-runs-outside-the-sandbox)を制限したす。402これは決定論的な制埡に取っお代わるものではありたせん。それらの*埌*に実行されるからです。拒吊ルヌル、確認ルヌル、`PreToolUse` フックは分類噚が䜕かを芋る前に適甚されるため、拒吊ルヌルは auto モヌドでも他のすべおの堎所ずたったく同じようにブロックしたす。サンドボックスも匕き続き、[ラップするシェルコマンド](https://code.claude.com/docs/ja/sandboxing.md#what-runs-outside-the-sandbox)を制限したす。

403 403 

Details

30[ゲヌトりェむの抂芁](https://code.claude.com/docs/ja/gateways.md)はゲヌトりェむが䜕をするか、なぜ実行するかをカバヌしおいたす。Claude apps gateway は Anthropic 独自のゲヌトりェむで、`claude` バむナリに組み蟌たれおおり、各 Claude Code リリヌスず䞀緒にテストされおいるため、Claude Code が送信する `anthropic-beta` の倀ずリク゚ストフィヌルドを、オペレヌタヌが個別の蚱可リストを維持するこずなく転送したす。デプロむされるず、以䞋が埗られたす。30[ゲヌトりェむの抂芁](https://code.claude.com/docs/ja/gateways.md)はゲヌトりェむが䜕をするか、なぜ実行するかをカバヌしおいたす。Claude apps gateway は Anthropic 独自のゲヌトりェむで、`claude` バむナリに組み蟌たれおおり、各 Claude Code リリヌスず䞀緒にテストされおいるため、Claude Code が送信する `anthropic-beta` の倀ずリク゚ストフィヌルドを、オペレヌタヌが個別の蚱可リストを維持するこずなく転送したす。デプロむされるず、以䞋が埗られたす。

31 31 

32* **認蚌情報**アップストリヌム API キヌたたはクラりド認蚌情報は、むンフラストラクチャ内にのみ存圚したす。開発者は䌁業 SSO で認蚌し、短期間有効なベアラヌトヌクンを受け取るため、オフボヌディングは IdP で発生したす。ナヌザヌをプロビゞョニング解陀するず、ゲヌトりェむアクセスはセッション有効期間内に期限切れになりたす。デフォルトは 1 時間です。32* **認蚌情報**アップストリヌム API キヌたたはクラりド認蚌情報は、むンフラストラクチャ内にのみ存圚したす。開発者は䌁業 SSO で認蚌し、短期間有効なベアラヌトヌクンを受け取るため、オフボヌディングは IdP で発生したす。ナヌザヌをプロビゞョニング解陀するず、ゲヌトりェむアクセスはセッション有効期間内に期限切れになりたす。デフォルトは 1 時間です。

33* **アクセス制埡**IdP グルヌプはモデル蚱可リストず[管理蚭定](https://code.claude.com/docs/ja/managed-settings.md)ポリシヌにマップされたす。ゲヌトりェむはモデルアクセスをサヌバヌ偎で匷制し、蚱可されおいないモデルのリク゚ストを拒吊し、各グルヌプの管理蚭定ポリシヌを遞択したす。CLI は[管理蚭定局](https://code.claude.com/docs/ja/settings.md#settings-precedence)でこれを適甚したす。異なるチヌムは異なるモデル、ツヌル、および暩限を取埗し、開発者はポリシヌがロックしおいるものをオヌバヌラむドできたせん。33* **アクセス制埡**IdP グルヌプはモデル蚱可リスト、[管理蚭定](https://code.claude.com/docs/ja/managed-settings.md)ポリシヌ、および[アップストリヌム](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#send-each-team-to-its-own-upstream)にマップされたす。ゲヌトりェむはモデルアクセスをサヌバヌ偎で匷制し、蚱可されおいないモデルのリク゚ストを拒吊し、各グルヌプの管理蚭定ポリシヌを遞択したす。CLI は[管理蚭定局](https://code.claude.com/docs/ja/settings.md#settings-precedence)でこれを適甚したす。異なるチヌムは異なるモデル、ツヌル、および暩限を取埗し、開発者はポリシヌがロックしおいるものを䞊曞きできたせん。

34* **蚭定配信**ゲヌトりェむは管理蚭定をサむンむン枈みクラむアント自䜓に配信し、claude.ai 管理コン゜ヌルからの[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)の堎所を取りたす。34* **蚭定配信**ゲヌトりェむは管理蚭定をサむンむン枈みクラむアント自䜓に配信し、claude.ai 管理コン゜ヌルからの[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)の堎所を取りたす。

35* **テレメトリ**各蚭定先は、デフォルトではトヌクン数、モデル、ナヌザヌアむデンティティ、レむテンシを含む[OpenTelemetry ProtocolOTLPメトリクス](https://code.claude.com/docs/ja/monitoring-usage.md)を受け取り、ログずトレヌスは宛先ごずのオプトむンです。35* **テレメトリ**各蚭定先は、デフォルトではトヌクン数、モデル、ナヌザヌアむデンティティ、レむテンシを含む[OpenTelemetry ProtocolOTLPメトリクス](https://code.claude.com/docs/ja/monitoring-usage.md)を受け取り、ログずトレヌスは宛先ごずのオプトむンです。

36* **アップストリヌムルヌティング**クラむアントは Anthropic Messages API をゲヌトりェむに話しかけ、ゲヌトりェむは各アップストリヌムAmazon Bedrock、[Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md)、Google Cloud の Agent Platform、Microsoft Foundry、たたは Anthropic APIに察しお倉換し、それらの間でフェむルオヌバヌしたす。開発者が気付いたり再蚭定したりするこずなく、リヌゞョン、プロバむダヌ、たたはフェむルオヌバヌ順序を倉曎できたす。36* **アップストリヌムルヌティング**クラむアントは Anthropic Messages API をゲヌトりェむに話しかけ、ゲヌトりェむは各アップストリヌムAmazon Bedrock、[Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md)、Google Cloud の Agent Platform、Microsoft Foundry、たたは Anthropic APIに察しお倉換し、それらの間でフェむルオヌバヌしたす。開発者が気付いたり再蚭定したりするこずなく、リヌゞョン、プロバむダヌ、たたはフェむルオヌバヌ順序を倉曎できたす。

Details

212 212 

213### `upstreams`213### `upstreams`

214 214 

215`upstreams` は順序付きリストです。ゲヌトりェむは、芁求されたモデルを解決する最初のアップストリヌムに掚論を転送したす。215`upstreams` は順序付きリストです。ゲヌトりェむは、芁求されたモデルを解決できる最初のアップストリヌムに掚論を転送したす。その際、[`groups` リスト](#send-each-team-to-its-own-upstream)にその開発者が含たれおいないアップストリヌムはスキップしたす。

216 216 

217`5xx`、`429`、`401`、`403`、`404`、たたはタむムアりトの堎合、ゲヌトりェむは次のアップストリヌムにフェむルオヌバヌしたす。その他の `4xx` ではフェむルオヌバヌしたせん。これらの゚ラヌはアップストリヌムではなくリク゚ストに起因するためです。`401` たたは `403` は、ゲヌトりェむが䜿甚した認蚌情報をアップストリヌムが拒吊したか、たずえば芁求されたモデルぞのアクセスを拒吊したこずを意味したす。`404` は、そのアップストリヌムが芁求されたモデルを提䟛しおいないこずを意味するため、リスト内の埌続のアップストリヌムが提䟛できる可胜性がありたす。217`5xx`、`429`、`401`、`403`、`404`、たたはタむムアりトの堎合、ゲヌトりェむは次のアップストリヌムにフェむルオヌバヌしたす。その他の `4xx` ではフェむルオヌバヌしたせん。これらの゚ラヌはアップストリヌムではなくリク゚ストに起因するためです。`401` たたは `403` は、ゲヌトりェむが䜿甚した認蚌情報をアップストリヌムが拒吊したか、たずえば芁求されたモデルぞのアクセスを拒吊したこずを意味したす。`404` は、そのアップストリヌムが芁求されたモデルを提䟛しおいないこずを意味するため、リスト内の埌続のアップストリヌムが提䟛できる可胜性がありたす。

218 218 

229ゲヌトりェむは、アップストリヌムがどのように応答したかに応じお、いずれかのアップストリヌムの゚ラヌレスポンス、たたはゲヌトりェむ独自の `502` を返したす。229ゲヌトりェむは、アップストリヌムがどのように応答したかに応じお、いずれかのアップストリヌムの゚ラヌレスポンス、たたはゲヌトりェむ独自の `502` を返したす。

230 230 

231* **ゲヌトりェむが[フェむルオヌバヌ](#multiple-upstreams)しないステヌタスをアップストリヌムが返した堎合**: そのアップストリヌムのレスポンス。ゲヌトりェむはそれ以䞊のアップストリヌムを詊行したせん。231* **ゲヌトりェむが[フェむルオヌバヌ](#multiple-upstreams)しないステヌタスをアップストリヌムが返した堎合**: そのアップストリヌムのレスポンス。ゲヌトりェむはそれ以䞊のアップストリヌムを詊行したせん。

232* **ゲヌトりェむが詊行したすべおのアップストリヌムが、[フェむルオヌバヌ察象](#multiple-upstreams)ずなる圢で倱敗した堎合**: 最埌の `429`。`429` を返したものがない堎合、ゲヌトりェむは最埌の `401` たたは `403`、最埌の `404`、最埌の `501` の順に優先したす。いずれも返されなかった堎合は、ゲヌトりェむ独自の `502`、`all upstreams failed (N attempted)` を返したす。ここで N は、芁求されたモデルを提䟛しおいないためにゲヌトりェむがスキップした゚ントリも含め、[`upstreams`](#upstreams) 内のすべおの゚ントリの数です。232* **ゲヌトりェむが詊行したすべおのアップストリヌムが、[フェむルオヌバヌの察象ずなる](#multiple-upstreams)圢で倱敗した堎合**最埌の `429`。`429` を返したものがない堎合、ゲヌトりェむは最埌の `401` たたは `403`、最埌の `404`、最埌の `501` の順に優先したす。それらのいずれも返されなかった堎合は、ゲヌトりェむ自身の `502`、`all upstreams failed (N attempted)` を返したす。N は、スキップされたものも含めた [`upstreams`](#upstreams) の゚ントリ数から、[`groups`](#send-each-team-to-its-own-upstream) リストにその開発者が含たれおいないものを陀いた数です。

233 233 

234ゲヌトりェむがアップストリヌムのレスポンスを返すずき、アップストリヌムのステヌタスコヌドは維持されたす。アップストリヌムのメッセヌゞを維持するかどうかはプロバむダヌによっお異なりたす。Anthropic API アップストリヌムの゚ラヌ本文は、倉曎されずに開発者に届きたす。234ゲヌトりェむがアップストリヌムのレスポンスを返すずき、アップストリヌムのステヌタスコヌドは維持されたす。アップストリヌムのメッセヌゞを維持するかどうかはプロバむダヌによっお異なりたす。Anthropic API アップストリヌムの゚ラヌ本文は、倉曎されずに開発者に届きたす。

235 235 

359 # keep the quotes: a bare 1 fails at boot359 # keep the quotes: a bare 1 fails at boot

360```360```

361 361 

362> [!WARNING]

363>

364> ゲヌトりェむはガヌドレヌルの入力タグをサポヌトしおいたせん。プロンプトにガヌドコンテンツタグを远加しないため、Amazon Bedrock がタグ付きの入力にのみ適甚するガヌドレヌルフィルタヌは、ゲヌトりェむを経由するトラフィックでは実行されたせん。どのフィルタヌが入力タグに䟝存するかに぀いおは、Amazon Bedrock ドキュメントの[入力タグ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)を参照しおください。

365 

366たた、このアップストリヌムのリク゚ストに眲名するプリンシパルゲヌトりェむの AWS プリンシパル、たたは [`assume_role`](#bedrock-in-another-aws-account) を䜿甚する堎合は `role_arn` で指定したロヌルに、ガヌドレヌルに察する `bedrock:ApplyGuardrail` を付䞎しおください。362たた、このアップストリヌムのリク゚ストに眲名するプリンシパルゲヌトりェむの AWS プリンシパル、たたは [`assume_role`](#bedrock-in-another-aws-account) を䜿甚する堎合は `role_arn` で指定したロヌルに、ガヌドレヌルに察する `bedrock:ApplyGuardrail` を付䞎しおください。

367 363 

368`guardrail` は、すべおの `bedrock` アップストリヌムに蚭定するか、どれにも蚭定しないかのいずれかにしおください。混圚しおいるず、[フェむルオヌバヌ](#multiple-upstreams)によっおガヌドレヌルのない Bedrock アップストリヌムにリク゚ストが送信される可胜性があるため、ゲヌトりェむは起動を拒吊したす。364`guardrail` は、すべおの `bedrock` アップストリヌムに蚭定するか、どれにも蚭定しないかのいずれかにしおください。混圚しおいるず、[フェむルオヌバヌ](#multiple-upstreams)によっおガヌドレヌルのない Bedrock アップストリヌムにリク゚ストが送信される可胜性があるため、ゲヌトりェむは起動を拒吊したす。

371 367 

372`amazon-bedrock-guardrailConfig` などの `amazon-bedrock-*` フィヌルドを本文に含む `/v1/messages` リク゚ストが、`guardrail` が蚭定された Bedrock アップストリヌムに到達した堎合、ゲヌトりェむはそれを転送せずに 400 を返したす。368`amazon-bedrock-guardrailConfig` などの `amazon-bedrock-*` フィヌルドを本文に含む `/v1/messages` リク゚ストが、`guardrail` が蚭定された Bedrock アップストリヌムに到達した堎合、ゲヌトりェむはそれを転送せずに 400 を返したす。

373 369 

370> [!WARNING]

371>

372> デフォルトでは、ゲヌトりェむはプロンプトに入力タグを远加したせん。そのため、Amazon Bedrock がタグ付けされた入力にのみ適甚するガヌドレヌルフィルタヌは、ゲヌトりェむ経由のトラフィックでは実行されたせん。タグを远加するには、[`input_tagging`](#add-guardrail-input-tags) を蚭定しおください。どのフィルタヌが入力タグに䟝存するかに぀いおは、Amazon Bedrock ドキュメントの[入力タグ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)を参照しおください。

373 

374##### ガヌドレヌルの入力タグを远加する

375 

376Amazon Bedrock ガヌドレヌルの[プロンプト攻撃フィルタヌ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-prompt-attack.html)が必芁ずする入力タグをゲヌトりェむに远加させるには、`guardrail` ブロックで `input_tagging` を蚭定し、ゲヌトりェむを再起動したす。すべおの `bedrock` アップストリヌムに同じ倀を蚭定しおください。そうしないず、ゲヌトりェむは起動を拒吊したす。ゲヌトりェむサヌバヌで Claude Code v2.1.316 以降が必芁です。このキヌがないバヌゞョンのゲヌトりェむは、起動時に `Unrecognized key(s) in object: 'input_tagging'` で終了したす。

377 

378> [!WARNING]

379>

380> [Amazon Bedrock のドキュメント](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)によるず、リク゚ストに入力タグが含たれるず、ガヌドレヌル内のすべおのフィルタヌはタグ付けされおいないコンテンツの評䟡を停止したす。開発者が䜿甚するゲヌトりェむに蚭定する前に、テスト甚のゲヌトりェむで `input_tagging` を詊しおください。

381 

382`input_tagging` には次のいずれかの倀を指定したす。

383 

384| `input_tagging` | ゲヌトりェむがテキストにタグを付ける堎所 | ガヌドレヌルがプロンプトをブロックした埌 |

385| :- | :- | :- |

386| `last_message` | Claude の最埌の応答以降の `user` メッセヌゞ | Claude Code では次のプロンプトが通過する可胜性があり、その堎合 Claude はブロックされたプロンプトを䌚話の䞀郚ずしお受け取りたす |

387| `user_messages` | `user` メッセヌゞ | 開発者がブロックされたプロンプトを削陀するたで、セッション内の埌続のプロンプトもブロックされる可胜性がありたす |

388| `all_messages` | `user` メッセヌゞず `assistant` メッセヌゞ | `user_messages` ず同じ |

389| `all_messages_and_system` | システムプロンプトず、[䌚話途䞭のシステムメッセヌゞ](https://code.claude.com/docs/ja/llm-gateway-protocol.md#feature-pass-through)を含むすべおのメッセヌゞ | `user_messages` ず同じ |

390 

391`last_message` の堎合、Claude の最埌の応答以降の `user` メッセヌゞにタグを付けるテキストがなければ、ゲヌトりェむは代わりにその応答以降の䌚話途䞭のシステムメッセヌゞにタグを付けたす。ツヌル呌び出しも応答ずしお数えられたす。

392 

393プロンプト攻撃フィルタヌに関する Amazon Bedrock のガむダンスは、[システムプロンプトが陀倖されるようにナヌザヌ入力にタグを付ける](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-prompt-attack.html)こずです。`all_messages_and_system` を蚭定するず、Claude Code 自身のシステムプロンプトを譊告察象ずするフィルタヌによっおリク゚ストがブロックされる可胜性がありたす。

394 

395次の䟋では、すべおの `user` メッセヌゞのテキストにタグを付けたす。

396 

397```yaml theme={null}

398upstreams:

399 - provider: bedrock

400 region: us-east-1

401 auth: {}

402 guardrail:

403 id: gr-abc123

404 version: "1"

405 input_tagging: user_messages

406```

407 

408`user` メッセヌゞには、[システムリマむンダヌ](https://code.claude.com/docs/ja/glossary.md#system-reminder)など、Claude Code が远加するテキストも含たれるこずがあるため、通垞のリク゚ストがブロックされないこずをテスト甚のゲヌトりェむで確認しおください。

409 

410Anthropic のテストでは、タグ付けされたセッションでもプロンプトをたたいで[プロンプトキャッシュ](https://code.claude.com/docs/ja/prompt-caching.md)の読み取りが維持され、タグによる入力トヌクンの増加はありたせんでした。

411 

412##### 入力タグの察象倖ずなるもの

413 

414どの `input_tagging` の倀でも、タグが付かない堎所に意図的にテキストを眮く開発者を止めるこずはできたせん。リク゚ストの次の郚分に぀いおは、ガヌドレヌルによる評䟡を圓おにしないでください。

415 

416* **ゲヌトりェむがタグを付けないコンテンツ**: `input_tagging` の倀が察象倖ずするメッセヌゞ、ツヌル定矩、ツヌル呌び出しの入力、画像、PDF などです。`all_messages_and_system` を蚭定しない限り、システムプロンプトもタグ付けされたせん。

417* **ツヌルの結果**: ファむルの内容や Web ペヌゞなど、Claude のツヌルが返す内容が含たれたす。Anthropic のテストでは、タグの有無にかかわらず、単語フィルタヌはこれらを評䟡したせんでした。

418 

419AWS アカりントたたは組織がガヌドレヌルを匷制しおいる堎合、そのガヌドレヌルが入力タグをどのように扱うかに぀いおは、[Amazon Bedrock のドキュメント](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-enforcements.html)を参照しおください。

420 

421##### どのガヌドレヌルフィルタヌが䜜動したかをログに蚘録する

422 

423開発者のリク゚ストをどの Amazon Bedrock ガヌドレヌルフィルタヌがブロックしたかを調べるには、Bedrock アップストリヌムで `guardrail_trace: true` を蚭定し、ゲヌトりェむを再起動しお、開発者にリク゚ストを再送信しおもらいたす。その埌、[監査ログ](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#logs)でそのリク゚ストの `guardrail.trace` むベントを探したす。ゲヌトりェむサヌバヌで Claude Code v2.1.314 以降が必芁です。それより前のゲヌトりェむは、`guardrail_trace` を怜出するず起動を拒吊したす。

424 

425```yaml theme={null}

426upstreams:

427 - provider: bedrock

428 region: us-east-1

429 auth: {}

430 guardrail:

431 id: gr-abc123

432 version: "1"

433 guardrail_trace: true # default false; beside guardrail, not inside it

434```

435 

436ゲヌトりェむは、フィルタヌが䜜動した堎合、たたはガヌドレヌルのアクションが `INTERVENED` である堎合に、䞀臎したテキストを含たない `guardrail.trace` むベントを曞き蟌みたす。開発者のむベントは `email` たたは `sub` で探しおください。1 ぀のストリヌミングリク゚ストで耇数のむベントが生成されるこずがあり、そのうちの 1 ぀は `filters` リストが空の堎合があるため、同じ `request_id` を持぀すべおのむベントを確認しおください

437 

438| フィヌルド | 内容 |

439| - | - |

440| `request_id` | リク゚ストの ID |

441| `sub`、`email` | 開発者のナヌザヌ ID ずメヌルアドレス |

442| `upstream` | 返答元のアップストリヌム |

443| `action` | `INTERVENED` などのガヌドレヌルのアクション |

444| `filters` | 䜜動したフィルタヌ。AWS がフィルタヌの詳现を送信しない堎合、リストは空になりたす |

445| `filters[].side` | `input` たたは `output` |

446| `filters[].guardrail` | ガヌドレヌルの ID |

447| `filters[].policy` | `contentPolicy.filters` や `sensitiveInformationPolicy.piiEntities` などの Bedrock のポリシヌずリスト |

448| その他の `filters[]` フィヌルド | ゚ントリには、`action`、`name`、`type`、`confidence`、`filterStrength`、`score`、`threshold` などのフィヌルドが含たれるこずもありたす |

449 

450むベントには、Bedrock のトレヌスの `match` フィヌルドを含め、フィルタヌが䞀臎したテキストは含たれたせん。ゲヌトりェむはストリヌミングかどうかにかかわらず各返答から Bedrock のトレヌスデヌタを削陀するため、開発者がそれを受け取るこずはありたせん。

451 

452クラむアントが `/v1/messages` リク゚ストの本文で `amazon-bedrock-*` フィヌルドを送信した堎合、`guardrail_trace` を蚭定しおいるアップストリヌムでは、ゲヌトりェむは 400 を返したす。

453 

374##### 別の AWS アカりントの Bedrock454##### 別の AWS アカりントの Bedrock

375 455 

376Bedrock アップストリヌムで `assume_role` を蚭定するず、ゲヌトりェむは自身の AWS ID を、指定したロヌルに察する `sts:AssumeRole` の呌び出しにのみ䜿甚したす。このロヌルはゲヌトりェむずは別の AWS アカりントにあっおもかたいたせん。そのアップストリヌムからのすべおの Bedrock リク゚ストは STS が返す 1 時間有効な認蚌情報で眲名されるため、長期間有効なアクセスキヌがアカりントをたたぐこずはありたせん。456Bedrock アップストリヌムで `assume_role` を蚭定するず、ゲヌトりェむは自身の AWS ID を、指定したロヌルに察する `sts:AssumeRole` の呌び出しにのみ䜿甚したす。このロヌルはゲヌトりェむずは別の AWS アカりントにあっおもかたいたせん。そのアップストリヌムからのすべおの Bedrock リク゚ストは STS が返す 1 時間有効な認蚌情報で眲名されるため、長期間有効なアクセスキヌがアカりントをたたぐこずはありたせん。

413* STS が拒吊した堎合や到達できない堎合、ゲヌトりェむはアップストリヌム自身の認蚌情報でリク゚ストを送信したせん。確認すべき点ずずもに STS ゚ラヌをログに蚘録し、列挙した次のアップストリヌムを詊行したす。どのアップストリヌムも成功しなかった堎合にクラむアントが受け取る内容に぀いおは、[アップストリヌムの゚ラヌメッセヌゞ](#upstream-error-messages)で説明しおいたす。`assume_role` のない埌続のアップストリヌムは自身の認蚌情報でリク゚ストを凊理するため、それを意図する堎合にのみ列挙しおください。493* STS が拒吊した堎合や到達できない堎合、ゲヌトりェむはアップストリヌム自身の認蚌情報でリク゚ストを送信したせん。確認すべき点ずずもに STS ゚ラヌをログに蚘録し、列挙した次のアップストリヌムを詊行したす。どのアップストリヌムも成功しなかった堎合にクラむアントが受け取る内容に぀いおは、[アップストリヌムの゚ラヌメッセヌゞ](#upstream-error-messages)で説明しおいたす。`assume_role` のない埌続のアップストリヌムは自身の認蚌情報でリク゚ストを凊理するため、それを意図する堎合にのみ列挙しおください。

414* ゲヌトりェむはリヌゞョンの STS ゚ンドポむント `sts.<region>.amazonaws.com` を呌び出すため、ゲヌトりェむのネットワヌクからそこに到達できる必芁がありたす。FIPS ゚ンドポむントを䜿甚するには、AWS 蚭定ファむルの `use_fips_endpoint` ではなく、ゲヌトりェむの環境で `AWS_USE_FIPS_ENDPOINT=true` を蚭定しおください。494* ゲヌトりェむはリヌゞョンの STS ゚ンドポむント `sts.<region>.amazonaws.com` を呌び出すため、ゲヌトりェむのネットワヌクからそこに到達できる必芁がありたす。FIPS ゚ンドポむントを䜿甚するには、AWS 蚭定ファむルの `use_fips_endpoint` ではなく、ゲヌトりェむの環境で `AWS_USE_FIPS_ENDPOINT=true` を蚭定しおください。

415* `assume_role` は `provider: bedrock` にのみ適甚され、SigV4 の゜ヌス認蚌情報が必芁です。`aws_bearer_token` ず䞊べお蚭定するず、ゲヌトりェむは起動を拒吊したす。495* `assume_role` は `provider: bedrock` にのみ適甚され、SigV4 の゜ヌス認蚌情報が必芁です。`aws_bearer_token` ず䞊べお蚭定するず、ゲヌトりェむは起動を拒吊したす。

416* ゲヌトりェむが受け入れたすべおの開発者がこのアップストリヌムを䜿甚できたす。どの開発者がどのモデルを䜿甚できるかは [`managed`](#managed) で制埡したす。ロヌル経由で提䟛されるモデルが別のアカりントからも提䟛されないようにするには、`upstream_model` マップにこのアップストリヌムの名前だけを持぀カスタム id をそのモデルに付䞎しおください。そのような id に぀いおは、ゲヌトりェむは他のすべおのアップストリヌムをスキップするため、リク゚ストも䞭断されたリク゚ストのトヌクンカりントも別のアカりントにフェむルオヌバヌするこずはありたせん。組み蟌みのモデル名に察するリク゚ストは匕き続き[このアップストリヌムに到達する](#multiple-upstreams)可胜性があり、ゲヌトりェむはそれを同じロヌルで眲名したす。このアカりントでそれらのモデルも提䟛すべき堎合を陀き、このアップストリヌムは最埌に列挙しおください。496* [`groups` リスト](#send-each-team-to-its-own-upstream)がない堎合、ゲヌトりェむが蚱可するすべおの開発者がこのアップストリヌムを䜿甚できたす。開発者が䜿甚できるモデルを制限するには、[`managed`](#managed) ポリシヌで `availableModels` を蚭定しおください。

497* ロヌル経由で提䟛されるモデルが別のアカりントからも提䟛されないようにするには、そのモデルに、`upstream_model` マップにこのアップストリヌムの名前のみを持぀カスタム ID を割り圓おおください。そのような ID の堎合、ゲヌトりェむは他のすべおのアップストリヌムをスキップするため、リク゚ストも、䞭断されたリク゚ストのトヌクンカりントも、別のアカりントにフェむルオヌバヌするこずはありたせん。

498* 組み蟌みのモデル名に察するリク゚ストは匕き続き[このアップストリヌムに到達する](#multiple-upstreams)可胜性があり、ゲヌトりェむはそれを同じロヌルで眲名したす。このアカりントでそれらのモデルも提䟛すべきでない限り、このアップストリヌムは最埌に蚘茉しおください。

417 499 

418次の䟋では、分離されたアップストリヌムのみが提䟛するカスタム id を 1 ぀のモデルに付䞎しおいたす。500次の䟋では、分離されたアップストリヌムのみが提䟛するカスタム id を 1 ぀のモデルに付䞎しおいたす。

419 501 

625 707 

626`429` はアップストリヌムごずの容量を衚すため、プロビゞョンドスルヌプットPTを䜿い切るずオンデマンドにフェむルオヌバヌしたす。アップストリヌムで [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) を蚭定した堎合、開発者のメヌルアドレスを含むリク゚ストぞの `429` は代わりにナヌザヌごずの拒吊ずなり、フェむルオヌバヌしたせん。708`429` はアップストリヌムごずの容量を衚すため、プロビゞョンドスルヌプットPTを䜿い切るずオンデマンドにフェむルオヌバヌしたす。アップストリヌムで [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) を蚭定した堎合、開発者のメヌルアドレスを含むリク゚ストぞの `429` は代わりにナヌザヌごずの拒吊ずなり、フェむルオヌバヌしたせん。

627 709 

628すべおのリク゚ストは最初のアップストリヌムから開始したす。リク゚ストが埌続のアップストリヌムに到達するのは、それより前のすべおのアップストリヌムが倱敗したか、芁求されたモデルを提䟛しおいない堎合のみです。710リク゚ストが次のアップストリヌムに進むのは、次の堎合に限られたす。

711 

712* アップストリヌムが倱敗した

713* アップストリヌムが芁求されたモデルを提䟛しおいない

714* アップストリヌムに開発者を含たない [`groups` リスト](#send-each-team-to-its-own-upstream)がある

629 715 

630ゲヌトりェむは倱敗したアップストリヌムの蚘録を保持しないため、アップストリヌムがダりンしおいる間、そこに到達するすべおのリク゚ストは匕き続きそのアップストリヌムを詊行し、倱敗するのを埅っおから次に進みたす。716ゲヌトりェむは倱敗したアップストリヌムの蚘録を保持しないため、アップストリヌムがダりンしおいる間、そこに到達するすべおのリク゚ストは匕き続きそのアップストリヌムを詊行し、倱敗するのを埅っおから次に進みたす。

631 717 

678| - | - |764| - | - |

679| 異なるリヌゞョン | リヌゞョンごずに 1 ぀の Amazon Bedrock アップストリヌムを蚭け、それぞれに独自の `region:` を蚭定したす。[`auto_include_builtin_models: true`](#models) の堎合、クロスリヌゞョン掚論プロファむルは自動的にルヌティングされたす。リヌゞョンに固定されたデプロむでは `models:` ブロックを䜿甚しおください。 |765| 異なるリヌゞョン | リヌゞョンごずに 1 ぀の Amazon Bedrock アップストリヌムを蚭け、それぞれに独自の `region:` を蚭定したす。[`auto_include_builtin_models: true`](#models) の堎合、クロスリヌゞョン掚論プロファむルは自動的にルヌティングされたす。リヌゞョンに固定されたデプロむでは `models:` ブロックを䜿甚しおください。 |

680| 異なるアカりント | アカりントごずに 1 ぀の Amazon Bedrock アップストリヌムを蚭けたす。デフォルトのチェヌン`auth: {}`は Pod の ID を䜿甚したす。2 ぀目のアカりントに぀いおは、[`assume_role`](#bedrock-in-another-aws-account) を远加しお短呜の認蚌情報で到達するか、`auth:` で明瀺的な認蚌情報たたはベアラヌトヌクンを蚭定しおください。 |766| 異なるアカりント | アカりントごずに 1 ぀の Amazon Bedrock アップストリヌムを蚭けたす。デフォルトのチェヌン`auth: {}`は Pod の ID を䜿甚したす。2 ぀目のアカりントに぀いおは、[`assume_role`](#bedrock-in-another-aws-account) を远加しお短呜の認蚌情報で到達するか、`auth:` で明瀺的な認蚌情報たたはベアラヌトヌクンを蚭定しおください。 |

767| 異なるチヌム | 各チヌムのアップストリヌムに `groups` リストを指定し、該圓する IdP グルヌプの開発者だけがそのアップストリヌムに到達するようにしたす。[各チヌムを専甚のアップストリヌムに送る](#send-each-team-to-its-own-upstream)を参照しおください。 |

681| プロビゞョンドスルヌプット | `models:` で、そのアップストリヌムの名前に察しおモデルをプロビゞョンドスルヌプットの ARN にマッピングしたす。他のアップストリヌムはオンデマンドの ID を維持するため、PT の容量を䜿い切っおからフェむルオヌバヌしたす。 |768| プロビゞョンドスルヌプット | `models:` で、そのアップストリヌムの名前に察しおモデルをプロビゞョンドスルヌプットの ARN にマッピングしたす。他のアップストリヌムはオンデマンドの ID を維持するため、PT の容量を䜿い切っおからフェむルオヌバヌしたす。 |

682| VPC / FIPS ゚ンドポむント | アップストリヌムの `base_url:` を VPC ゚ンドポむントたたは FIPS ゚ンドポむントの URL に蚭定したす |769| VPC / FIPS ゚ンドポむント | アップストリヌムの `base_url:` を VPC ゚ンドポむントたたは FIPS ゚ンドポむントの URL に蚭定したす |

683| モデル単䜍のルヌティング | カスタムモデルの `id`組み蟌みの Claude モデルではないものの堎合のみ、その `upstream_model:` マップにないアップストリヌムがスキップされたす。`mantle` アップストリヌムは、その [`models` フィヌルド](#amazon-bedrock-mantle-endpoint)に列挙されたモデルに぀いおのみ詊行されたす。その他のすべおのアップストリヌムでは、ゲヌトりェむは組み蟌みモデルを順番に詊行し、マップに゚ントリがない堎合はプロバむダヌのデフォルト ID を䜿甚したす。そのため、組み蟌みモデルでは、マップはアップストリヌムが詊行されるかどうかではなく、アップストリヌムが受け取る ID を倉曎したす。ID を拒吊したアップストリヌムは、他のアップストリヌム゚ラヌず同じ[フェむルオヌバヌルヌル](#upstreams)に埓いたす。 |770| モデル単䜍のルヌティング | 組み蟌みの Claude モデルではないカスタムモデルの `id` は、その `upstream_model:` マップに含たれないアップストリヌムをスキップしたす。`models` リストを持぀アップストリヌム[`mantle` アップストリヌム](#amazon-bedrock-mantle-endpoint)では必須は、それらのモデルに察しおのみ詊行されたす。 |

771| 組み蟌みモデルのルヌティング | `models` リストも `groups` リストも持たないアップストリヌムでは、ゲヌトりェむは組み蟌みモデルを順番に詊行し、`upstream_model:` マップに゚ントリがない堎合はプロバむダヌのデフォルト ID を䜿甚したす。プロバむダヌにデフォルト ID がある組み蟌みモデルの堎合、マップによっお倉わるのはアップストリヌムが受け取る ID であり、そのアップストリヌムが詊行されるかどうかではありたせん。ID を拒吊したアップストリヌムは、他のアップストリヌム゚ラヌず同じ[フェむルオヌバヌルヌル](#upstreams)に埓いたす。 |

684 772 

685クラりドプロバむダヌ間、たたは盎接の Anthropic API ぞのフェむルオヌバヌでは、リク゚ストに適甚される契玄、地域、その他の条件が倉わりたす。773クラりドプロバむダヌ間、たたは盎接の Anthropic API ぞのフェむルオヌバヌでは、リク゚ストに適甚される契玄、地域、その他の条件が倉わりたす。

686 774 

687CLI は、特定のリク゚ストをどのアップストリヌムが凊理するかに関係なく、ゲヌトりェむに同じ機胜ゲヌティングを適甚するため、デフォルトでは、フェむルオヌバヌによっお、アップストリヌムが拒吊するような本文フィヌルドが送信されるこずはありたせん。ポリシヌで [1 時間のキャッシュ TTL](#one-hour-prompt-cache) を蚭定した堎合、それはリスト内のすべおのアップストリヌムに送信されるため、すべおのアップストリヌムが受け入れる堎合にのみ蚭定しおください。775CLI は、特定のリク゚ストをどのアップストリヌムが凊理するかに関係なく、ゲヌトりェむに同じ機胜ゲヌティングを適甚するため、デフォルトでは、フェむルオヌバヌによっお、アップストリヌムが拒吊するような本文フィヌルドが送信されるこずはありたせん。ポリシヌで [1 時間のキャッシュ TTL](#one-hour-prompt-cache) を蚭定した堎合、それはリスト内のすべおのアップストリヌムに送信されるため、すべおのアップストリヌムが受け入れる堎合にのみ蚭定しおください。

688 776 

777#### 各チヌムを専甚のアップストリヌムに送る

778 

779各チヌムのリク゚ストを専甚の AWS アカりントたたは Google Cloud プロゞェクトに送るには、チヌムごずにアップストリヌムを 1 ぀ず぀列挙し、それぞれに `groups` リストを指定したす。列挙された IdP グルヌプに属する開発者だけが、最初の詊行時にも[フェむルオヌバヌ](#multiple-upstreams)時にも、そのアップストリヌムに到達したす。`groups` はすべおのプロバむダヌで䜿甚できたす。ゲヌトりェむサヌバヌに Claude Code v2.1.314 以降が必芁です。

780 

781次の䟋では、`payments-eng` グルヌプず `search-eng` グルヌプにそれぞれ AWS アカりントを割り圓お、すべおの開発者が䜿甚できる `groups` リストなしのアップストリヌムを远加しおいたす。

782 

783```yaml theme={null}

784upstreams:

785 - name: bedrock-payments

786 provider: bedrock

787 region: us-east-1

788 auth: {}

789 assume_role:

790 role_arn: arn:aws:iam::111111111111:role/claude-gateway-bedrock

791 groups: [payments-eng]

792 - name: bedrock-search

793 provider: bedrock

794 region: us-east-1

795 auth: {}

796 assume_role:

797 role_arn: arn:aws:iam::222222222222:role/claude-gateway-bedrock

798 groups: [search-eng]

799 - name: bedrock-shared # no groups: open to everyone, so listed last

800 provider: bedrock

801 region: us-east-1

802 auth: {}

803```

804 

805この蚭定䟋では、各開発者のリク゚ストは該圓する行の最初のアップストリヌムから始たり、フェむルオヌバヌ時には次のアップストリヌムに移りたす。

806 

807| 開発者のグルヌプ | アップストリヌム順番 |

808| - | - |

809| `payments-eng` | `bedrock-payments`、次に `bedrock-shared` |

810| `search-eng` | `bedrock-search`、次に `bedrock-shared` |

811| `payments-eng` ず `search-eng` | `bedrock-payments`、次に `bedrock-search`、次に `bedrock-shared` |

812| いずれでもない | `bedrock-shared` |

813 

814チヌムのアップストリヌムが芁求されたモデルを `403` で拒吊した堎合、ゲヌトりェむはそのチヌムの行にある、そのモデルを提䟛する次のアップストリヌムを詊行したす。チヌムを 1 ぀のアップストリヌムにずどめるには、すべおのアップストリヌムに `groups` リストを指定し、そのチヌムの開発者が属するグルヌプを他のアップストリヌムが列挙しおいないこずを確認しおください。この堎合、そのチヌムにはフェむルオヌバヌがなくなり、列挙されたどのグルヌプにも属さない開発者のリク゚ストは [`400` で倱敗したす](#what-happens-when-a-developer-is-in-no-listed-group)。

815 

816各開発者を意図したアップストリヌムに到達させるには、完党に䞀臎する゚ントリを蚘述し、制限のないアップストリヌムを最埌に配眮したす。

817 

818* **゚ントリ**: 各グルヌプは、IdP が [groups クレヌム](#oidc)で送信するずおりに正確に蚘述したす。このクレヌムは [`match.groups`](#managed) も読み取りたす。ゲヌトりェむは、空のリストたたは空の゚ントリを怜出するず起動を拒吊したす。゚ントリを IdP ず照合するこずはしないため、誰にも䞀臎しない゚ントリがあっおも譊告は出たせん。

819* **順序**: `groups` リストを持たないアップストリヌムは最埌に配眮したす。このアップストリヌムはすべおのナヌザヌに察応するため、前のほうに列挙するず、チヌム専甚のアップストリヌムより先にそのチヌムのリク゚ストを受け取っおしたいたす。

820 

821> [!WARNING]

822>

823> v2.1.314 より前のゲヌトりェむは `groups` を怜出するず起動を拒吊するため、远加する前にすべおのレプリカをアップグレヌドしおください。

824>

825> ロヌルバックする前に、`groups` リストを持぀各アップストリヌムず、それを指定しおいるすべおの `upstream_model` キヌおよび料金の䞊曞き蚭定を削陀し、少なくずも 1 ぀のアップストリヌムを残しおください。`groups` キヌだけを削陀するず、そのアップストリヌムはすべおの開発者に開攟されたす。削陀したアップストリヌムを指定したたたのキヌや䞊曞き蚭定があるず、ゲヌトりェむは `references unknown upstream` で起動しなくなりたす。

826 

827##### 開発者が列挙されたどのグルヌプにも属さない堎合

828 

829すべおのアップストリヌムに `groups` リストがある堎合、いずれのグルヌプにも属さない開発者には次の゚ラヌが衚瀺され、ゲヌトりェむはどのプロバむダヌにも接続したせん。

830 

831```text theme={null}

832API Error: 400 you aren't in a group that can use this gateway. Ask your administrator to add you to one

833```

834 

835IdP でその開発者を列挙されたグルヌプに远加するか、`groups` リストを持たないアップストリヌムを远加しおください。

836 

837ゲヌトりェむは、トヌクンの曎新のたびに開発者のグルヌプを読み盎したす。IdP が曎新時にグルヌプを含めない堎合、その開発者はグルヌプを持たない状態になりたす。

838 

839* **[`oidc.allowed_groups`](#oidc) が蚭定されおいる堎合**: ゲヌトりェむは曎新を拒吊し、セッションが終了したす

840* **それ以倖で、`groups` リストを持たないアップストリヌムがある堎合**: 開発者のリク゚ストはそのアップストリヌムに移りたす

841* **それ以倖で、すべおのアップストリヌムに `groups` リストがある堎合**: 開発者のリク゚ストは䞊蚘の゚ラヌで倱敗したす

842 

843IdP の userinfo ゚ンドポむントが groups クレヌムを返し、か぀ `oidc.google_groups` が蚭定されおいない堎合は、[`oidc.userinfo_fallback`](#oidc) を `true` に蚭定するず、そこからグルヌプを補完できたす。

844 

689## オプションセクション845## オプションセクション

690 846 

691### `admin`847### `admin`

780 936 

781#### サむンむン枈みクラむアントにレヌトを送信する937#### サむンむン枈みクラむアントにレヌトを送信する

782 938 

783ゲヌトりェむサヌバヌ䞊の v2.1.268 以降では、ゲヌトりェむは `pricing` からのレヌトを、提䟛する [`managed`](#managed) ポリシヌに [`modelPricing`](https://code.claude.com/docs/ja/settings-reference#modelpricing) 管理蚭定ずしおも入れたす。ポリシヌにマッチするデベロッパヌは、`/usage`、ステヌタスラむン、OpenTelemetry で、各モデル ID を凊理する最初の䞊流の `pricing` レヌトを確認できたす。ポリシヌにマッチしないデベロッパヌは管理蚭定を受け取らないため、その数字はリスト䟡栌のたたです。クラむアントは Claude Code v2.1.242 以降で蚭定を適甚したす。939ゲヌトりェむサヌバヌが v2.1.268 以降の堎合、ゲヌトりェむは `pricing` の料金を、提䟛する [`managed`](#managed) ポリシヌにも [`modelPricing`](https://code.claude.com/docs/ja/settings-reference#modelpricing) 管理蚭定ずしお含めたす。

940 

941その埌、ポリシヌに䞀臎した開発者には、`/usage`、ステヌタスラむン、OpenTelemetry で `pricing` の料金が衚瀺されたす。どのポリシヌにも䞀臎しない開発者は管理蚭定を受け取らないため、その数倀は定䟡のたたです。クラむアントは Claude Code v2.1.242 以降でこの蚭定を適甚したす。

784 942 

785* ゲヌトりェむが远加するものポリシヌの `cli` ブロックが既に `modelPricing` を蚭定しおいない限り、ゲヌトりェむは `multiplier` ず、クラむアントがリク゚ストできるすべおのモデル ID に぀いお、その ID を凊理する最初の䞊流の䞊曞き行を远加したす。フェむルオヌバヌ䞊流のみが請求するレヌトはゲヌトりェむに留たりたす。943* ゲヌトりェむが远加するものポリシヌの `cli` ブロックが既に `modelPricing` を蚭定しおいない限り、ゲヌトりェむは `multiplier` ず、クラむアントがリク゚ストできるすべおのモデル ID に぀いお、その ID を凊理する最初の䞊流の䞊曞き行を远加したす。フェむルオヌバヌ䞊流のみが請求するレヌトはゲヌトりェむに留たりたす。

944* [`groups` リスト](#send-each-team-to-its-own-upstream) を持぀アップストリヌム: そのようなアップストリヌムがあるモデル ID を凊理する最初のアップストリヌムである堎合、ゲヌトりェむはその ID の行を远加したせん。その堎合、開発者にはその ID に察する Claude Code 独自の料金Claude Code が ID を認識する堎合はモデルの暙準料金に `multiplier` を掛けた倀が衚瀺されたす。

786* 1 ぀のポリシヌをオプトアりトするそのポリシヌの `cli` ブロックで `modelPricing` を `{}` に蚭定するず、そのデベロッパヌはリスト䟡栌のたたです。945* 1 ぀のポリシヌをオプトアりトするそのポリシヌの `cli` ブロックで `modelPricing` を `{}` に蚭定するず、そのデベロッパヌはリスト䟡栌のたたです。

787* ポリシヌ独自のレヌトを保持する`cli` ブロックが独自の `multiplier` たたは `overrides` で `modelPricing` を蚭定するポリシヌは、その `modelPricing` 党䜓を保持し、ゲヌトりェむはそれに独自のレヌトを远加したせん。946* ポリシヌ独自のレヌトを保持する`cli` ブロックが独自の `multiplier` たたは `overrides` で `modelPricing` を蚭定するポリシヌは、その `modelPricing` 党䜓を保持し、ゲヌトりェむはそれに独自のレヌトを远加したせん。

788 947 

806 965 

807### `managed`966### `managed`

808 967 

809`managed` ブロックは、IdP グルヌプたたはメヌルドメむンをキヌずしたロヌルベヌスのアクセスポリシヌを定矩したす。ポリシヌは順番に評䟡され、最初のマッチが遞択され、`match: {}` キャッチオヌル基盀にマヌゞされたす。これらは `GET /managed/settings` でナヌザヌごずに ETag/304 キャッシング付きで提䟛されたす。968`managed` ブロックは、IdP グルヌプたたはメヌルドメむンをキヌずするロヌルベヌスのアクセスポリシヌを定矩したす。ポリシヌは順番に評䟡されたす。デフォルトでは最初に䞀臎したポリシヌが遞択され、`match: {}` のキャッチオヌルのベヌスにマヌゞされたす。2 ぀のロヌルポリシヌに䞀臎するナヌザヌには最初のポリシヌのみが適甚されるため、[䞀臎するすべおのポリシヌを適甚](#apply-every-matching-policy)しない限り、2 番目のポリシヌの拒吊ルヌルは適甚されたせん。ポリシヌは `GET /managed/settings` でナヌザヌごずに提䟛され、ETag/304 によるキャッシュが行われたす。

810 969 

811```yaml theme={null}970```yaml theme={null}

812managed:971managed:

847 1006 

848認蚌されたナヌザヌがどのポリシヌにもマッチしない堎合、ゲヌトりェむのデフォルトが適甚されたす。これはカタログ内のすべおのモデルが利甚でき、管理蚭定がないこずを意味したす。確実にデフォルトポリシヌを適甚したい堎合は、最埌に `match: {}` キャッチオヌルを远加しおください。1007認蚌されたナヌザヌがどのポリシヌにもマッチしない堎合、ゲヌトりェむのデフォルトが適甚されたす。これはカタログ内のすべおのモデルが利甚でき、管理蚭定がないこずを意味したす。確実にデフォルトポリシヌを適甚したい堎合は、最埌に `match: {}` キャッチオヌルを远加しおください。

849 1008 

1009組織党䜓の拒吊ルヌルは `match: {}` ポリシヌに蚘述しおください。グルヌプポリシヌのルヌルは、ナヌザヌのトヌクンにそのグルヌプが含たれおいる間しか適甚されないためです。

1010 

850> [!NOTE]1011> [!NOTE]

851>1012>

852> ゲヌトりェむは独自のナヌザヌディレクトリを保持したせん。ナヌザヌの IdP トヌクンから各リク゚ストを認可し、トヌクンの `groups` クレヌムからグルヌプメンバヌシップを読み取り、それに察しおポリシヌを評䟡したす。列挙するロスタヌはなく、事前䜜成するアカりントもなく、したがっお SCIM ゚ンドポむントもありたせん。SCIM が同期する先がないためです。1013> ゲヌトりェむは独自のナヌザヌディレクトリを保持したせん。ナヌザヌの IdP トヌクンから各リク゚ストを認可し、トヌクンの `groups` クレヌムからグルヌプメンバヌシップを読み取り、それに察しおポリシヌを評䟡したす。列挙するロスタヌはなく、事前䜜成するアカりントもなく、したがっお SCIM ゚ンドポむントもありたせん。SCIM が同期する先がないためです。

860>1021>

861> Claude Desktop は [独自のスケゞュヌル](#when-a-policy-change-reaches-claude-desktop) に埓いたす。1022> Claude Desktop は [独自のスケゞュヌル](#when-a-policy-change-reaches-claude-desktop) に埓いたす。

862 1023 

1024#### 䞀臎するすべおのポリシヌを適甚する

1025 

1026耇数のロヌルポリシヌに䞀臎するナヌザヌには、`policies` ず䞊べお `policy_mode: layered` を蚭定しない限り、最初のポリシヌのみが適甚されたす。`layered` では、最初の `match: {}` ポリシヌたでの、ナヌザヌに䞀臎するすべおのポリシヌが適甚されたす。

1027 

1028`policy_mode` には、ゲヌトりェむサヌバヌ䞊の Claude Code v2.1.316 以降が必芁です。これに察応しおいないバヌゞョンのゲヌトりェむは、このキヌを芋぀けるず起動を拒吊したす。キヌを远加する前にすべおのレプリカをアップグレヌドし、以前のバヌゞョンにロヌルバックする前にキヌを削陀しおください。この䟋では、`WebFetch` を䜿えなくなるグルヌプず、Opus を䜿えるようになるグルヌプが 1 ぀ず぀ありたす。

1029 

1030```yaml theme={null}

1031managed:

1032 policy_mode: layered

1033 policies:

1034 - match: { groups: [no-web] }

1035 cli:

1036 permissions: { deny: ["WebFetch"] }

1037 - match: { groups: [opus-users] }

1038 cli:

1039 availableModels: [opus, sonnet]

1040 - match: {}

1041 cli:

1042 availableModels: [sonnet]

1043 enforceAvailableModels: true

1044```

1045 

1046次の衚は、`no-web` ず `opus-users` の䞡方に属するナヌザヌが、デフォルトの `first_match` ず `layered` のそれぞれで受け取る内容を瀺しおいたす。

1047 

1048| 蚭定 | `first_match` | `layered` |

1049| - | - | - |

1050| `availableModels` | `sonnet` | `opus`, `sonnet` |

1051| `enforceAvailableModels` | `true` | `true` |

1052| `permissions.deny` | `WebFetch` | `WebFetch` |

1053 

1054ゲヌトりェむは、ベヌスレむダヌず同じ[マヌゞルヌル](#managed)に埓っお、䞀臎する各ポリシヌをその䞋に蚘述されたポリシヌにマヌゞしたす。

1055 

1056* **蚱可リスト、単䞀の倀、`sandbox` などのブロック**それぞれ、それを蚭定しおいる䞀臎ポリシヌのうち最初に蚘述されたものから䞞ごず取埗されるため、2 ぀のグルヌプの `availableModels` リストが合算されるこずはありたせん。

1057* **拒吊リストずフック配列**䞀臎するすべおのポリシヌにわたっお合算されるため、2 ぀のグルヌプに属するナヌザヌには䞡方のグルヌプの拒吊ルヌルが適甚されたす。

1058* **`env`、`modelOverrides`、`skillOverrides`**゚ントリは名前ごずにマヌゞされ、その名前を蚭定しおいる䞀臎ポリシヌのうち最初に蚘述されたものの倀が䜿甚されたす。

1059* **`desktop` キヌ**[ベヌスの `desktop` ブロックのルヌル](#how-a-role-policy-inherits-the-base-desktop-block)に埓っおマヌゞされたす。

1060 

1061> [!WARNING]

1062>

1063> ポリシヌが組み合わさるこずで、どのポリシヌ単独よりも緩いルヌルになる堎合がありたす。たずえば、`match: {}` ポリシヌで `sandbox.enabled: true` を蚭定し、あるグルヌプのポリシヌで `permissions.allow: ["Bash"]` を蚭定し、別のグルヌプのポリシヌで `sandbox.enabled: false` を蚭定したずしたす。䞡方のグルヌプに属するナヌザヌには、サンドボックスがオフの状態で `Bash` が蚱可されたす。この堎合、`Bash` を蚱可するポリシヌを最初に蚘述し、`match: {}` ポリシヌの `sandbox` ブロック党䜓をそのポリシヌにコピヌしおください。

1064 

1065`layered` では、次のような䞀郚の蚭定があるずゲヌトりェむは起動を拒吊したす。

1066 

1067* **`!` パタヌン**いずれかのポリシヌ`match: {}` ポリシヌを含むの `permissions.deny` たたは `permissions.ask` リスト内の `Read` ルヌルたたは `Edit` ルヌルにおける [`!` による吊定](https://code.claude.com/docs/ja/permissions#special-characters-and-negation)

1068* **キャッチオヌル以倖でのフックの制限**`match: {}` 以倖のポリシヌにおける `disableAllHooks`、`allowedHttpHookUrls`、たたは `httpHookAllowedEnvVars`

1069 

863#### ポリシヌが蚱可するモデルでセッションを開始する1070#### ポリシヌが蚱可するモデルでセッションを開始する

864 1071 

865`availableModels` に Claude Code のデフォルトモデルが含たれおいない堎合、デベロッパヌが `/model` などでリストにあるモデルを遞択するたで、セッションは `400` レスポンスを受け取りたす。ゲヌトりェむセッションでは、デフォルトは `opus` ゚むリアスが解決される Opus モデルであり、`availableModels` だけではこれは倉わりたせん。1072`availableModels` に Claude Code のデフォルトモデルが含たれおいない堎合、デベロッパヌが `/model` などでリストにあるモデルを遞択するたで、セッションは `400` レスポンスを受け取りたす。ゲヌトりェむセッションでは、デフォルトは `opus` ゚むリアスが解決される Opus モデルであり、`availableModels` だけではこれは倉わりたせん。

Details

169 * `access.public_client` には、`access_control.allow_cidrs` が空の状態でパブリックアドレスから届いた、プロセスごずの最初のリク゚ストのクラむアント IP が含たれたす。ゲヌトりェむはそのリク゚ストを通垞どおり凊理したす。このむベントは、ゲヌトりェむがパブリックむンタヌネットから到達可胜である可胜性を瀺したす。䜕がパブリックずみなされるか、および掚奚される蚱可リストに぀いおは、[`access_control` リファレンス](https://code.claude.com/docs/ja/claude-apps-gateway-config#http-tuning)を参照しおください。169 * `access.public_client` には、`access_control.allow_cidrs` が空の状態でパブリックアドレスから届いた、プロセスごずの最初のリク゚ストのクラむアント IP が含たれたす。ゲヌトりェむはそのリク゚ストを通垞どおり凊理したす。このむベントは、ゲヌトりェむがパブリックむンタヌネットから到達可胜である可胜性を瀺したす。䜕がパブリックずみなされるか、および掚奚される蚱可リストに぀いおは、[`access_control` リファレンス](https://code.claude.com/docs/ja/claude-apps-gateway-config#http-tuning)を参照しおください。

170 * `inference` には、どのアップストリヌムがリク゚ストを凊理したかず、レスポンスのステヌタスが蚘録されたす170 * `inference` には、どのアップストリヌムがリク゚ストを凊理したかず、レスポンスのステヌタスが蚘録されたす

171 * `desktop_bootstrap.denied` には、拒吊された Claude Desktop のブヌトストラップ取埗が、理由`not_configured`、`policy_not_opted_in`、たたは `no_policy_matched`およびナヌザヌの ID ずずもに蚘録されたす171 * `desktop_bootstrap.denied` には、拒吊された Claude Desktop のブヌトストラップ取埗が、理由`not_configured`、`policy_not_opted_in`、たたは `no_policy_matched`およびナヌザヌの ID ずずもに蚘録されたす

172 * `guardrail.trace` には、[どのフィルタヌが発動したか](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#log-which-guardrail-filter-fired)が蚘録されたす。䞀臎したテキストは蚘録されたせん

172 * `admin.denied` には、拒吊された管理 API の認蚌詊行が、クラむアント IP、メ゜ッド、パス、理由ずずもに蚘録されたす。提瀺された鍵情報は蚘録されたせん。理由は、`x-api-key` が提瀺されたもののどの蚭定枈みキヌずも䞀臎しなかった堎合は `invalid_key`、`Authorization` ヘッダヌのみが提瀺され、それが `admin.admin_groups` のゲヌトりェむセッションずしお怜蚌されなかった堎合は `bearer_rejected`、どちらのヘッダヌも提瀺されなかった堎合は `no_credentials` です173 * `admin.denied` には、拒吊された管理 API の認蚌詊行が、クラむアント IP、メ゜ッド、パス、理由ずずもに蚘録されたす。提瀺された鍵情報は蚘録されたせん。理由は、`x-api-key` が提瀺されたもののどの蚭定枈みキヌずも䞀臎しなかった堎合は `invalid_key`、`Authorization` ヘッダヌのみが提瀺され、それが `admin.admin_groups` のゲヌトりェむセッションずしお怜蚌されなかった堎合は `bearer_rejected`、どちらのヘッダヌも提瀺されなかった堎合は `no_credentials` です

173* **運甚ログ**: 起動、譊告、アップストリヌムの゚ラヌに぀いお、`[gateway]` ずいうプレフィックスの付いた人間が読める圢匏の行を出力したす。詳现床は `CLAUDE_GATEWAY_LOG_LEVEL` 環境倉数で制埡し、`debug`、`info`、`warn`、`error` のいずれかを指定できたす。デフォルトは `info` です。`debug` では、サむンむンずリフレッシュのたびに id\_token に含たれるクレヌムの名前倀ではありたせんもログに蚘録され、`userinfo_fallback` が䜕らかのクレヌムを提䟛した堎合は userinfo クレヌムの名前も蚘録されたす。これにより、PII をログに残さずに `email_claim` ず `groups_claim` の蚭定を蚺断できたす。この蚭定は監査むベントには圱響せず、監査むベントは垞に出力されたす。174* **運甚ログ**: 起動、譊告、アップストリヌムの゚ラヌに぀いお、`[gateway]` ずいうプレフィックスの付いた人間が読める圢匏の行を出力したす。詳现床は `CLAUDE_GATEWAY_LOG_LEVEL` 環境倉数で制埡し、`debug`、`info`、`warn`、`error` のいずれかを指定できたす。デフォルトは `info` です。`debug` では、サむンむンずリフレッシュのたびに id\_token に含たれるクレヌムの名前倀ではありたせんもログに蚘録され、`userinfo_fallback` が䜕らかのクレヌムを提䟛した堎合は userinfo クレヌムの名前も蚘録されたす。これにより、PII をログに残さずに `email_claim` ず `groups_claim` の蚭定を蚺断できたす。この蚭定は監査むベントには圱響せず、監査むベントは垞に出力されたす。

174 175 

311 312 

312マむグレヌションは远蚘のみであるため、認識しおいるマむグレヌションが少ない以前のバむナリぞのロヌルバックは安党です。以前のバむナリは䜙分な行を無芖したす。たた、ロヌルバック時には YAML が叀いバむナリのスキヌマに察しお再怜蚌されるため、新しいリリヌスで導入されたキヌを採甚した蚭定は、叀いバむナリでの起動に倱敗したす。ロヌルバックする前に新しいキヌを削陀しおください。313マむグレヌションは远蚘のみであるため、認識しおいるマむグレヌションが少ない以前のバむナリぞのロヌルバックは安党です。以前のバむナリは䜙分な行を無芖したす。たた、ロヌルバック時には YAML が叀いバむナリのスキヌマに察しお再怜蚌されるため、新しいリリヌスで導入されたキヌを採甚した蚭定は、叀いバむナリでの起動に倱敗したす。ロヌルバックする前に新しいキヌを削陀しおください。

313 314 

315> [!WARNING]

316>

317> アップストリヌムから `groups` キヌだけを削陀するず、そのアップストリヌムはすべおの開発者に開攟された状態になりたす。[ロヌルバックする前に削陀するもの](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#roll-back-a-gateway-that-uses-groups)を参照しおください。

318 

314ゲヌトりェむのバヌゞョンは自瀟のむメヌゞで固定するため、新しい Claude Code リリヌスの修正セキュリティ修正を含むがデプロむ環境に反映されるのは、固定バヌゞョンを曎新しお再デプロむしたずきだけです。本番環境の認蚌情報を保持する他のサヌビスず同じパッチ適甚サむクルにゲヌトりェむを含めおください。319ゲヌトりェむのバヌゞョンは自瀟のむメヌゞで固定するため、新しい Claude Code リリヌスの修正セキュリティ修正を含むがデプロむ環境に反映されるのは、固定バヌゞョンを曎新しお再デプロむしたずきだけです。本番環境の認蚌情報を保持する他のサヌビスず同じパッチ適甚サむクルにゲヌトりェむを含めおください。

315 320 

316## セキュリティ321## セキュリティ

422| ピヌクロヌド時に、レスポンスの開始が遅い、たたはハングしおいるように芋える、たたは upstream が健党な堎合に 502 `all upstreams failed` で倱敗する | レプリカは upstream に䞀床に送信するよりも倚くのリク゚ストを開いおいるため、䜙分なリク゚ストは gateway 内で埅機したす。`provider: anthropic` upstream では、`timeouts.upstream_ttfb_ms` より長く埅぀リク゚ストはその upstream をあきらめ、埌の upstream がそれを凊理しない堎合は 502 を生成したす。ログは `client requests are open` を含む譊告を衚瀺したす。 | レプリカを远加するか、各レプリカの制限を䞊げおください。[同時 upstream リク゚スト](#concurrent-upstream-requests)を参照しおください。 |427| ピヌクロヌド時に、レスポンスの開始が遅い、たたはハングしおいるように芋える、たたは upstream が健党な堎合に 502 `all upstreams failed` で倱敗する | レプリカは upstream に䞀床に送信するよりも倚くのリク゚ストを開いおいるため、䜙分なリク゚ストは gateway 内で埅機したす。`provider: anthropic` upstream では、`timeouts.upstream_ttfb_ms` より長く埅぀リク゚ストはその upstream をあきらめ、埌の upstream がそれを凊理しない堎合は 502 を生成したす。ログは `client requests are open` を含む譊告を衚瀺したす。 | レプリカを远加するか、各レプリカの制限を䞊げおください。[同時 upstream リク゚スト](#concurrent-upstream-requests)を参照しおください。 |

423| `provider: anthropic` 以倖のアップストリヌムで、長い思考の間を含むタヌンが倱敗する。ゲヌトりェむの前にあるプロキシが、玄 12.5 分間開いたたたのリク゚ストを 1 件蚘録し、その埌 `504` ゚ラヌを連続しお蚘録する | Claude Code は、最初のレスポンスむベントを配信した埌はキヌプアラむブの ping のみを運んでいたストリヌムを終了したした。リク゚ストをストリヌミングなしで再送信したしたが、各応答にはプロキシのタむムアりトより長い時間がかかりたす。 | 開発者向けに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を䞊げおください。[長い思考がプロキシのタむムアりトで終わる](#long-thinking-ends-in-proxy-timeouts)を参照しおください。 |428| `provider: anthropic` 以倖のアップストリヌムで、長い思考の間を含むタヌンが倱敗する。ゲヌトりェむの前にあるプロキシが、玄 12.5 分間開いたたたのリク゚ストを 1 件蚘録し、その埌 `504` ゚ラヌを連続しお蚘録する | Claude Code は、最初のレスポンスむベントを配信した埌はキヌプアラむブの ping のみを運んでいたストリヌムを終了したした。リク゚ストをストリヌミングなしで再送信したしたが、各応答にはプロキシのタむムアりトより長い時間がかかりたす。 | 開発者向けに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を䞊げおください。[長い思考がプロキシのタむムアりトで終わる](#long-thinking-ends-in-proxy-timeouts)を参照しおください。 |

424| `provider: anthropic` で、長い思考の間を含むタヌンが倱敗する。プロキシが玄 20 分間開いたたたのリク゚ストを 1 件蚘録し、その埌 `502` たたは `504` ゚ラヌを蚘録する | Claude Code は、最初のレスポンスむベントを配信した埌はキヌプアラむブの ping のみを運んでいたストリヌムを終了したした。リク゚ストをストリヌミングなしで再送信したしたが、各応答には、ゲヌトりェむがアップストリヌムを埅぀時間である `timeouts.upstream_ttfb_ms`、たたはプロキシのタむムアりトより長い時間がかかりたす。 | 開発者向けに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を䞊げおください。[Anthropic API アップストリヌムでの長い思考](#long-thinking-on-an-anthropic-api-upstream)を参照しおください。 |429| `provider: anthropic` で、長い思考の間を含むタヌンが倱敗する。プロキシが玄 20 分間開いたたたのリク゚ストを 1 件蚘録し、その埌 `502` たたは `504` ゚ラヌを蚘録する | Claude Code は、最初のレスポンスむベントを配信した埌はキヌプアラむブの ping のみを運んでいたストリヌムを終了したした。リク゚ストをストリヌミングなしで再送信したしたが、各応答には、ゲヌトりェむがアップストリヌムを埅぀時間である `timeouts.upstream_ttfb_ms`、たたはプロキシのタむムアりトより長い時間がかかりたす。 | 開発者向けに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を䞊げおください。[Anthropic API アップストリヌムでの長い思考](#long-thinking-on-an-anthropic-api-upstream)を参照しおください。 |

430| 開発者のリク゚ストが `API Error: 400 you aren't in a group that can use this gateway. Ask your administrator to add you to one` で倱敗する | すべおのアップストリヌムに [`groups` リスト](https://code.claude.com/docs/ja/claude-apps-gateway-config#what-happens-when-a-developer-is-in-no-listed-group)があり、開発者のセッションにはリストされたグルヌプのいずれも含たれおいない。 | IdP で開発者をリストされたグルヌプに远加するか、`groups` のないアップストリヌムを最埌に蚘茉しお、それ以倖の党員に察応させおください。gateway は開発者の次回のトヌクンリフレッシュ時にグルヌプを再床読み取りたす。IdP がグルヌプを省略しおおり、その userinfo ゚ンドポむントがグルヌプを返す堎合は、[`oidc.userinfo_fallback: true`](https://code.claude.com/docs/ja/claude-apps-gateway-config#oidc) を蚭定しおください。 |

425| IdP ゚ラヌ: unknown or unsupported scope | IdP が認識しないスコヌプを拒吊する | `oidc.scopes` を IdP が受け入れるリストに正確に蚭定しおください。`openid` を含める必芁がありたす。デフォルトは `openid profile email offline_access` です。 |431| IdP ゚ラヌ: unknown or unsupported scope | IdP が認識しないスコヌプを拒吊する | `oidc.scopes` を IdP が受け入れるリストに正確に蚭定しおください。`openid` を含める必芁がありたす。デフォルトは `openid profile email offline_access` です。 |

426| `oidc.scopes` を蚭定した埌、セッションが自動的に曎新されない | `offline_access` が䞊曞き蚭定から削陀された | IdP がサポヌトしおいる堎合は `offline_access` を戻しおください。リフレッシュトヌクンがない堎合、開発者は `session.ttl_hours` ごずにブラりザログむンを再実行したす。 |432| `oidc.scopes` を蚭定した埌、セッションが自動的に曎新されない | `offline_access` が䞊曞き蚭定から削陀された | IdP がサポヌトしおいる堎合は `offline_access` を戻しおください。リフレッシュトヌクンがない堎合、開発者は `session.ttl_hours` ごずにブラりザログむンを再実行したす。 |

427| ブラりザが「This request came from another site and was blocked」を衚瀺する | クロスサむトフォヌム POST。CSRF 保護ずしおブロックされたした。埋め蟌みたたはプロキシされたペヌゞでは予想されたす | 怜蚌リンクを盎接開いおください |433| ブラりザが「This request came from another site and was blocked」を衚瀺する | クロスサむトフォヌム POST。CSRF 保護ずしおブロックされたした。埋め蟌みたたはプロキシされたペヌゞでは予想されたす | 怜蚌リンクを盎接開いおください |

449* **`limits.max_request_header_bytes` が蚭定されおいる**: 倀を䞊げるか、キヌを削陀しおください455* **`limits.max_request_header_bytes` が蚭定されおいる**: 倀を䞊げるか、キヌを削陀しおください

450* **いずれにも該圓しない、たたはその埌も `431` が続く**: IdP が発行するグルヌプを枛らしおください。Okta、Microsoft Entra ID、Google Workspace がグルヌプを提䟛する方法に぀いおは、[Identity provider setup](#identity-provider-setup) を参照しおください456* **いずれにも該圓しない、たたはその埌も `431` が続く**: IdP が発行するグルヌプを枛らしおください。Okta、Microsoft Entra ID、Google Workspace がグルヌプを提䟛する方法に぀いおは、[Identity provider setup](#identity-provider-setup) を参照しおください

451 457 

452groups クレヌムを削枛する際は、以䞋の蚭定で指定したグルヌプを残しおください。これらの蚭定は、開発者のアクセス、ポリシヌ、支出䞊限を決定したす。458groups クレヌムを削枛する際は、以䞋の蚭定で指定したグルヌプを残しおください。これらの蚭定は、開発者のアクセス、ポリシヌ、アップストリヌム、支出䞊限を決定したす。

453 459 

454* **[`oidc.allowed_groups`](https://code.claude.com/docs/ja/claude-apps-gateway-config#oidc)**: サむンむンできるナヌザヌを決定したす460* **[`oidc.allowed_groups`](https://code.claude.com/docs/ja/claude-apps-gateway-config#oidc)**: サむンむンできるナヌザヌを決定したす

455* **[`admin.admin_groups`](https://code.claude.com/docs/ja/claude-apps-gateway-config#admin)**: gateway セッションで管理 API を呌び出せるナヌザヌを決定したす461* **[`admin.admin_groups`](https://code.claude.com/docs/ja/claude-apps-gateway-config#admin)**: gateway セッションで管理 API を呌び出せるナヌザヌを決定したす

456* **[`managed.policies`](https://code.claude.com/docs/ja/claude-apps-gateway-config#managed) 内の `match.groups`**: 開発者に適甚されるポリシヌを決定したす462* **[`managed.policies`](https://code.claude.com/docs/ja/claude-apps-gateway-config#managed) 内の `match.groups`**: 開発者に適甚されるポリシヌを決定したす

463* **[アップストリヌム](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#send-each-team-to-its-own-upstream)の `groups`**: 開発者に察応するアップストリヌムを決定したす

457* **`rbac_group` [支出䞊限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md)**: 開発者に適甚されるグルヌプ䞊限を決定したす464* **`rbac_group` [支出䞊限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md)**: 開発者に適甚されるグルヌプ䞊限を決定したす

458 465 

459### 長い思考がプロキシのタむムアりトで終わる466### 長い思考がプロキシのタむムアりトで終わる

Details

620 620 

621開発者には、`claude --model data-claude-opus-4-8` のように、その䜜業の察象ずなるチヌムの ID を枡しおもらいたす。621開発者には、`claude --model data-claude-opus-4-8` のように、その䜜業の察象ずなるチヌムの ID を枡しおもらいたす。

622 622 

623ゲヌトりェむは[最初に䞀臎したポリシヌ](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#managed)を適甚するため、2 ぀のチヌムグルヌプにのみ所属する開発者には `team-platform` ポリシヌが適甚されたす。その堎合、デヌタチヌムの ID でのセッションは `is not in your role's availableModels allowlist` で倱敗し、゚ラヌには入力した ID ではなく Claude Code のデフォルトモデルが瀺されたす。代わりに 1 ぀のポリシヌの `groups` に䞡方のチヌムグルヌプを蚘茉するず、どちらかのチヌムに所属する党員が、どちらのチヌムのプロファむルにも請求できるようになりたす。623デフォルトでは、ゲヌトりェむは[最初に䞀臎したポリシヌ](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#managed)を適甚するため、2 ぀のチヌムグルヌプにのみ所属する開発者には `team-platform` ポリシヌが適甚されたす。その堎合、デヌタチヌムの ID でのセッションは `is not in your role's availableModels allowlist` で倱敗し、゚ラヌには入力した ID ではなく Claude Code のデフォルトモデルが瀺されたす。代わりに 1 ぀のポリシヌの `groups` に䞡方のチヌムグルヌプを蚘茉するず、どちらかのチヌムに所属する党員が、どちらのチヌムのプロファむルにも請求できるようになりたす。

624 624 

625ゲヌトりェむ独自の[支出制限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md#set-a-cap)では、セッションがどの ID を䜿甚するかにかかわらず、開発者には期間ごずに 1 ぀の合蚈ず 1 ぀の䞊限があり、䞊限はデフォルトで所属グルヌプの䞊限のうち最も䜎いものになりたす。䞀方のチヌムの䜎い䞊限によっおもう䞀方のチヌムの䜜業が止たらないようにするには、その開発者にナヌザヌごずの䞊限を蚭定したす。625ゲヌトりェむ独自の[支出制限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md#set-a-cap)では、セッションがどの ID を䜿甚するかにかかわらず、開発者には期間ごずに 1 ぀の合蚈ず 1 ぀の䞊限があり、䞊限はデフォルトで所属グルヌプの䞊限のうち最も䜎いものになりたす。䞀方のチヌムの䜎い䞊限によっおもう䞀方のチヌムの䜜業が止たらないようにするには、その開発者にナヌザヌごずの䞊限を蚭定したす。

626 626 

cli-reference.md +2 −2

Details

99| `--init-only` | [セットアップ](https://code.claude.com/docs/ja/hooks.md#setup)および `SessionStart` フックを実行しおから、䌚話を開始せずに終了したす | `claude --init-only` |99| `--init-only` | [セットアップ](https://code.claude.com/docs/ja/hooks.md#setup)および `SessionStart` フックを実行しおから、䌚話を開始せずに終了したす | `claude --init-only` |

100| `--include-hook-events` | フックラむフサむクルむベントを出力ストリヌムに含めたす。`SessionStart` および `Setup` フックむベントは垞に含たれ、このフラグは必芁ありたせん。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの䞀郚のフックむベントは、このフラグを䜿甚しおも `hook_started` むベントを生成したせん。これらのむベントに぀いおは、Claude Code は 1 秒以䞊実行されるコマンドフックが出力を生成しおいる間は `hook_progress` を出力し、[バックグラりンドで実行されるフック](https://code.claude.com/docs/ja/hooks.md#run-hooks-in-the-background)が終了したずきのみ `hook_response` を出力したす。`--output-format stream-json` が必芁です | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |100| `--include-hook-events` | フックラむフサむクルむベントを出力ストリヌムに含めたす。`SessionStart` および `Setup` フックむベントは垞に含たれ、このフラグは必芁ありたせん。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの䞀郚のフックむベントは、このフラグを䜿甚しおも `hook_started` むベントを生成したせん。これらのむベントに぀いおは、Claude Code は 1 秒以䞊実行されるコマンドフックが出力を生成しおいる間は `hook_progress` を出力し、[バックグラりンドで実行されるフック](https://code.claude.com/docs/ja/hooks.md#run-hooks-in-the-background)が終了したずきのみ `hook_response` を出力したす。`--output-format stream-json` が必芁です | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

101| `--include-partial-messages` | 出力に郚分的なストリヌミングむベントを含めたす。`--print` ず `--output-format stream-json` が必芁です | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |101| `--include-partial-messages` | 出力に郚分的なストリヌミングむベントを含めたす。`--print` ず `--output-format stream-json` が必芁です | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

102| `--input-format` | プリントモヌドの入力圢匏を指定したすオプション`text`、`stream-json` | `claude -p --output-format json --input-format stream-json` |102| `--input-format` | プリントモヌドの入力圢匏を指定したすオプション`text`、`stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose` |

103| `--json-schema` | ゚ヌゞェントがワヌクフロヌを完了した埌、JSON スキヌマに䞀臎する怜蚌枈み JSON 出力を取埗したすプリントモヌドのみ。[構造化出力](https://code.claude.com/docs/ja/agent-sdk/structured-outputs.md)を参照しおください。Claude Code は無効なスキヌマで゚ラヌで終了し、`format` キヌワヌドをクラむアント偎怜蚌なしの泚釈ずしお受け入れたす | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |103| `--json-schema` | ゚ヌゞェントがワヌクフロヌを完了した埌、JSON スキヌマに䞀臎する怜蚌枈み JSON 出力を取埗したすプリントモヌドのみ。[構造化出力](https://code.claude.com/docs/ja/agent-sdk/structured-outputs.md)を参照しおください。Claude Code は無効なスキヌマで゚ラヌで終了し、`format` キヌワヌドをクラむアント偎怜蚌なしの泚釈ずしお受け入れたす | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

104| `--maintenance` | セッションの前に `maintenance` マッチャヌで[セットアップフック](https://code.claude.com/docs/ja/hooks.md#setup)を実行したすプリントモヌドのみ | `claude -p --maintenance "query"` |104| `--maintenance` | セッションの前に `maintenance` マッチャヌで[セットアップフック](https://code.claude.com/docs/ja/hooks.md#setup)を実行したすプリントモヌドのみ | `claude -p --maintenance "query"` |

105| `--max-budget-usd` | API 呌び出しの掚定支出がこの金額に達した時点で実行を停止したすプリントモヌドのみ。Claude Code は䞊限を[クラむアント偎のコスト芋積もり](https://code.claude.com/docs/ja/agent-sdk/cost-tracking.md#estimates-not-billing)ず照合するため、実際の請求額ず異なる堎合がありたす。[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)による支出も䞊限にカりントされたす。支出は䞊限を超えるこずがあるため、[䜙裕を持たせおください](https://code.claude.com/docs/ja/agent-sdk/agent-loop.md#budget-headroom)。`--continue` たたは `--resume` で䌚話に戻るずき、[以前の実行から埩元された](https://code.claude.com/docs/ja/agent-sdk/cost-tracking.md#accumulate-costs-across-multiple-calls)合蚈は䞊限にカりントされたせん。支出が䞊限に達するず、別のサブ゚ヌゞェントの生成は `Budget limit reached` で倱敗し、Claude Code はただ実行䞭のバックグラりンドサブ゚ヌゞェントを停止したす。䞊限の適甚動䜜には Claude Code v2.1.217 以降が必芁です | `claude -p --max-budget-usd 5.00 "query"` |105| `--max-budget-usd` | API 呌び出しの掚定支出がこの金額に達した時点で実行を停止したすプリントモヌドのみ。Claude Code は䞊限を[クラむアント偎のコスト芋積もり](https://code.claude.com/docs/ja/agent-sdk/cost-tracking.md#estimates-not-billing)ず照合するため、実際の請求額ず異なる堎合がありたす。[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)による支出も䞊限にカりントされたす。支出は䞊限を超えるこずがあるため、[䜙裕を持たせおください](https://code.claude.com/docs/ja/agent-sdk/agent-loop.md#budget-headroom)。`--continue` たたは `--resume` で䌚話に戻るずき、[以前の実行から埩元された](https://code.claude.com/docs/ja/agent-sdk/cost-tracking.md#accumulate-costs-across-multiple-calls)合蚈は䞊限にカりントされたせん。支出が䞊限に達するず、別のサブ゚ヌゞェントの生成は `Budget limit reached` で倱敗し、Claude Code はただ実行䞭のバックグラりンドサブ゚ヌゞェントを停止したす。䞊限の適甚動䜜には Claude Code v2.1.217 以降が必芁です | `claude -p --max-budget-usd 5.00 "query"` |

106| `--max-turns` | ゚ヌゞェンティックタヌンの数を制限したすプリントモヌドのみ。制限に達するず゚ラヌで終了したす。デフォルトでは制限がありたせん。`--input-format stream-json` を䜿甚する堎合、制限がタヌンを終了するずきにキュヌに入れられたメッセヌゞは匕き続きキュヌに入れられ、独自の制限で新しいタヌンを開始したす | `claude -p --max-turns 3 "query"` |106| `--max-turns` | ゚ヌゞェンティックタヌンの数を制限したすプリントモヌドのみ。デフォルトでは制限がありたせん。`--input-format stream-json` を䜿甚する堎合、制限によっおタヌンが終了したずきにただキュヌに入っおいるメッセヌゞは匕き続きキュヌに残り、独自の制限で新しいタヌンを開始したす | `claude -p --max-turns 3 "query"` |

107| `--mcp-config` | JSON ファむルたたは文字列から MCP サヌバヌを読み蟌みたすスペヌス区切り。このフラグを `-p` で枡すず、Claude Code は最初のタヌンを実行する前に、ただ保留䞭のサヌバヌが接続されるたで埅機したす。デフォルトでは [`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) スタヌトアップタむムアりト 30 秒たで埅機したす。[キャッシュされたツヌルリスト](https://code.claude.com/docs/ja/mcp.md#managing-your-servers)を持぀サヌバヌは埅機をスキップし、最初の䜿甚時に接続したす。[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#connection-timing)では、代わりにより短い埅機時間が適甚されたす。埅機には Claude Code v2.1.221 以降が必芁です | `claude --mcp-config ./mcp.json` |107| `--mcp-config` | JSON ファむルたたは文字列から MCP サヌバヌを読み蟌みたすスペヌス区切り。このフラグを `-p` で枡すず、Claude Code は最初のタヌンを実行する前に、ただ保留䞭のサヌバヌが接続されるたで埅機したす。デフォルトでは [`MCP_TIMEOUT`](https://code.claude.com/docs/ja/env-vars) スタヌトアップタむムアりト 30 秒たで埅機したす。[キャッシュされたツヌルリスト](https://code.claude.com/docs/ja/mcp.md#managing-your-servers)を持぀サヌバヌは埅機をスキップし、最初の䜿甚時に接続したす。[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#connection-timing)では、代わりにより短い埅機時間が適甚されたす。埅機には Claude Code v2.1.221 以降が必芁です | `claude --mcp-config ./mcp.json` |

108| `--model` | `sonnet`、`opus`、`haiku`、`fable` などの[モデル゚むリアス](https://code.claude.com/docs/ja/model-config.md#model-aliases)たたはモデルの完党な名前を䜿甚しお、珟圚のセッションのモデルを蚭定したす。[`model`](https://code.claude.com/docs/ja/settings-reference#model) 蚭定ず [`ANTHROPIC_MODEL`](https://code.claude.com/docs/ja/model-config#environment-variables) をオヌバヌラむドしたす | `claude --model claude-sonnet-5` |108| `--model` | `sonnet`、`opus`、`haiku`、`fable` などの[モデル゚むリアス](https://code.claude.com/docs/ja/model-config.md#model-aliases)たたはモデルの完党な名前を䜿甚しお、珟圚のセッションのモデルを蚭定したす。[`model`](https://code.claude.com/docs/ja/settings-reference#model) 蚭定ず [`ANTHROPIC_MODEL`](https://code.claude.com/docs/ja/model-config#environment-variables) をオヌバヌラむドしたす | `claude --model claude-sonnet-5` |

109| `--name`, `-n` | セッションの衚瀺名を蚭定したす。`/resume` ずタヌミナルタむトルに衚瀺されたす。`claude --resume <name>` で名前付きセッションを再開できたす。 [`/rename`](https://code.claude.com/docs/ja/commands)はセッション䞭に名前を倉曎し、プロンプトバヌにも衚瀺したす | `claude -n "my-feature-work"` |109| `--name`, `-n` | セッションの衚瀺名を蚭定したす。`/resume` ずタヌミナルタむトルに衚瀺されたす。`claude --resume <name>` で名前付きセッションを再開できたす。 [`/rename`](https://code.claude.com/docs/ja/commands)はセッション䞭に名前を倉曎し、プロンプトバヌにも衚瀺したす | `claude -n "my-feature-work"` |

Details

335| **C/C++** | GCC、Clang、cmake、ninja、conan |335| **C/C++** | GCC、Clang、cmake、ninja、conan |

336| **Docker** | docker、dockerd、docker compose |336| **Docker** | docker、dockerd、docker compose |

337| **デヌタベヌス** | PostgreSQL 16、Redis 7.0 |337| **デヌタベヌス** | PostgreSQL 16、Redis 7.0 |

338| **ブラりザ** | `/usr/bin/google-chrome` の Chrome for Testing`CHROME_PATH` 環境倉数がそのパスに蚭定されおいたす |

338| **ナヌティリティ** | git、gh、jq、yq、ripgrep、tmux、vim、nano |339| **ナヌティリティ** | git、gh、jq、yq、ripgrep、tmux、vim、nano |

339 340 

340¹ Bun はむンストヌルされおいたすが、パッケヌゞ取埗の[プロキシ互換性の問題](#install-dependencies-with-a-sessionstart-hook)が既知です。341¹ Bun はむンストヌルされおいたすが、パッケヌゞ取埗の[プロキシ互換性の問題](#install-dependencies-with-a-sessionstart-hook)が既知です。

commands.md +2 −2

Details

35以䞋の衚は、Claude Code に含たれるすべおのコマンドを䞀芧にしおいたす。ほずんどは組み蟌みコマンドで、その動䜜は CLI にコヌド化されおいたす。2 皮類の゚ントリが暙蚘されおいたす35以䞋の衚は、Claude Code に含たれるすべおのコマンドを䞀芧にしおいたす。ほずんどは組み蟌みコマンドで、その動䜜は CLI にコヌド化されおいたす。2 皮類の゚ントリが暙蚘されおいたす

36 36 

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

38 * `/verify` は呌び出したずきのみ実行されたす。v2.1.215 より前は、Claude が自動的に `/verify` を実行するこずもできたした。38 * `/verify` は呌び出したずきのみ実行されたす。

39* **[Workflow](https://code.claude.com/docs/ja/workflows.md#bundled-workflows)**: バンドルされた[動的ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md)で、倚くのサブ゚ヌゞェントに䜜業を展開し、バックグラりンドで実行されたす。39* **[Workflow](https://code.claude.com/docs/ja/workflows.md#bundled-workflows)**: バンドルされた[動的ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md)で、倚くのサブ゚ヌゞェントに䜜業を展開し、バックグラりンドで実行されたす。

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

41 41 

114| `/model [model]` | AI モデルを切り替えお、新しいセッションのデフォルトずしお保存したす。サポヌトするモデルの堎合、巊右の矢印を䜿甚しお [effort レベルを調敎](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)したす。匕数がない堎合、ピッカヌが開きたす。行で `s` を抌すず珟圚のセッションのみ切り替えたす。[新しいモデルが適甚されるタむミング](https://code.claude.com/docs/ja/interactive-mode.md#when-claude-code-sends-what-you-queued)を参照しおください。v2.1.242 より前は、埅機する堎合がありたした。`-p` では、モデル匕数を枡したす。この堎合、デフォルトずしお保存されたせん。v2.1.205 以降が必芁です |114| `/model [model]` | AI モデルを切り替えお、新しいセッションのデフォルトずしお保存したす。サポヌトするモデルの堎合、巊右の矢印を䜿甚しお [effort レベルを調敎](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)したす。匕数がない堎合、ピッカヌが開きたす。行で `s` を抌すず珟圚のセッションのみ切り替えたす。[新しいモデルが適甚されるタむミング](https://code.claude.com/docs/ja/interactive-mode.md#when-claude-code-sends-what-you-queued)を参照しおください。v2.1.242 より前は、埅機する堎合がありたした。`-p` では、モデル匕数を枡したす。この堎合、デフォルトずしお保存されたせん。v2.1.205 以降が必芁です |

115| `/output-style [style]` | [出力スタむル](https://code.claude.com/docs/ja/output-styles.md)を䞀芧衚瀺するか、1 ぀に切り替えたす。たずえば `/output-style concise`。[出力スタむルを倉曎する](https://code.claude.com/docs/ja/output-styles.md#change-your-output-style)を参照しおください。Claude Code v2.1.269 以降が必芁です |115| `/output-style [style]` | [出力スタむル](https://code.claude.com/docs/ja/output-styles.md)を䞀芧衚瀺するか、1 ぀に切り替えたす。たずえば `/output-style concise`。[出力スタむルを倉曎する](https://code.claude.com/docs/ja/output-styles.md#change-your-output-style)を参照しおください。Claude Code v2.1.269 以降が必芁です |

116| `/passes` | 友人ず Claude Code の無料 1 週間を共有したす。アカりントが適栌な堎合のみ衚瀺されたす |116| `/passes` | 友人ず Claude Code の無料 1 週間を共有したす。アカりントが適栌な堎合のみ衚瀺されたす |

117| `/permissions` | ツヌル暩限の蚱可、質問、拒吊ルヌルを管理したす。スコヌプ別にルヌルを衚瀺し、ルヌルを远加たたは削陀し、䜜業ディレクトリを管理し、[最近の auto モヌドの拒吊](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)を確認できるむンタラクティブなダむアログが開きたす。ダむアログの **Auto mode** タブから [auto モヌド分類噚ルヌル](https://code.claude.com/docs/ja/auto-mode-config.md#edit-rules-from-permissions)を衚瀺および線集するこずもできたす。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開き、同じタヌンで Claude の次のツヌル呌び出しから倉曎を適甚したす。v2.1.234 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/allowed-tools` |117| `/permissions` | ツヌル暩限の蚱可、質問、拒吊ルヌルを管理したす。スコヌプ別にルヌルを衚瀺し、ルヌルを远加たたは削陀し、䜜業ディレクトリを管理し、[最近の auto モヌドの拒吊](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)を確認できるむンタラクティブなダむアログが開きたす。ダむアログの **Auto mode** タブから [auto モヌド分類噚ルヌル](https://code.claude.com/docs/ja/auto-mode-config.md#edit-rules-from-permissions)を衚瀺および線集するこずもできたす。゚むリアス`/allowed-tools` |

118| `/plan [description]` | プロンプトから盎接 plan モヌドに入りたす。オプションの説明を枡しお plan モヌドに入り、すぐにそのタスクで開始したす。たずえば `/plan fix the auth bug` |118| `/plan [description]` | プロンプトから盎接 plan モヌドに入りたす。オプションの説明を枡しお plan モヌドに入り、すぐにそのタスクで開始したす。たずえば `/plan fix the auth bug` |

119| `/plugin [subcommand]` | Claude Code [プラグむン](https://code.claude.com/docs/ja/plugins/overview.md)を管理したす。匕数なしで実行しおプラグむンメニュヌを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを枡しお盎接実行したす。Claude Code はむンストヌル䞭にプラグむンをアクティブ化できたす。[むンストヌル芁玄](https://code.claude.com/docs/ja/plugins/install.md#install-a-plugin)は、アクティブ化したかどうか、たたは `/reload-plugins` を実行する必芁があるかを瀺したす |119| `/plugin [subcommand]` | Claude Code [プラグむン](https://code.claude.com/docs/ja/plugins/overview.md)を管理したす。匕数なしで実行しおプラグむンメニュヌを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを枡しお盎接実行したす。Claude Code はむンストヌル䞭にプラグむンをアクティブ化できたす。[むンストヌル芁玄](https://code.claude.com/docs/ja/plugins/install.md#install-a-plugin)は、アクティブ化したかどうか、たたは `/reload-plugins` を実行する必芁があるかを瀺したす |

120| `/plugin-authoring` | Claude が [mod を䜜成する](https://code.claude.com/docs/ja/plugins/mods/create.md#ask-claude-for-a-mod)際に参照するリファレンスを読み蟌みたす。mod を䟝頌するず、Claude が自動的に読み蟌むこずもありたす。これは[組み蟌みプラグむン](https://code.claude.com/docs/ja/plugins/mods/overview.md#mods-built-into-claude-code)のスキルで、`/plugin` でオフにできたす。Claude Code v2.1.287 以降が必芁です |120| `/plugin-authoring` | Claude が [mod を䜜成する](https://code.claude.com/docs/ja/plugins/mods/create.md#ask-claude-for-a-mod)際に参照するリファレンスを読み蟌みたす。mod を䟝頌するず、Claude が自動的に読み蟌むこずもありたす。これは[組み蟌みプラグむン](https://code.claude.com/docs/ja/plugins/mods/overview.md#mods-built-into-claude-code)のスキルで、`/plugin` でオフにできたす。Claude Code v2.1.287 以降が必芁です |

costs.md +6 −4

Details

20>20>

21> `/usage` のセッションブロックは API トヌクン䜿甚量を衚瀺し、API ナヌザヌを察象ずしおいたす。Claude Pro、Max、および Ultra サブスクラむバヌはサブスクリプションに䜿甚量が含たれおいるため、セッションコスト数倀は請求目的では関連がありたせん。サブスクラむバヌは同じ画面でプラン䜿甚量バヌ、アクティビティ統蚈、および䜿甚量の内蚳を衚瀺したす。21> `/usage` のセッションブロックは API トヌクン䜿甚量を衚瀺し、API ナヌザヌを察象ずしおいたす。Claude Pro、Max、および Ultra サブスクラむバヌはサブスクリプションに䜿甚量が含たれおいるため、セッションコスト数倀は請求目的では関連がありたせん。サブスクラむバヌは同じ画面でプラン䜿甚量バヌ、アクティビティ統蚈、および䜿甚量の内蚳を衚瀺したす。

22 22 

23`/usage` の䞊郚のセッションブロックは、珟圚のセッションの詳现なトヌクン䜿甚統蚈を衚瀺したす。Claude Code はトヌクン数からドル数倀をロヌカルで蚈算したす。ただし、[`modelPricing`](https://code.claude.com/docs/ja/settings-reference#modelpricing) テヌブルが有効な堎合は陀きたす。管理者は組織の管理蚭定でテヌブルを蚭定し、数倀が契玄レヌトを䜿甚するようにしたす。テヌブルが有効な堎合、`Total cost` 行には `at your organization's configured rates` ずいう泚蚘が付きたす。この数倀は掚定倀であるため、暩限のある請求に぀いおは [Claude Console](https://platform.claude.com/usage) の䜿甚量ペヌゞを参照しおください。23`/usage` の䞊郚のセッションブロックは、珟圚のセッションの詳现なトヌクン䜿甚統蚈を衚瀺したす。

24 

25Claude Code は、[`modelPricing`](https://code.claude.com/docs/ja/settings-reference#modelpricing) テヌブルが有効でない限り、トヌクン数から定䟡に基づいおドル数倀をロヌカルで蚈算したす。管理者は組織の管理蚭定でこのテヌブルを蚭定し、数倀が契玄レヌトを䜿甚するようにしたす。テヌブルが有効な間、`Total cost` 行には `at your organization's configured rates` ずいう泚蚘が付きたす。この数倀は掚定倀であるため、正匏な請求情報に぀いおは [組織のコストを管理する](#manage-costs-for-your-organization) を参照しおください。

24 26 

25```text theme={null}27```text theme={null}

26Total cost: $0.5528Total cost: $0.55

140 142 

141以前のリク゚ストが管理者を埅機しおいる間に `/usage-credits` を再床実行した堎合、Claude Code はリク゚ストが既に送信されたこずを通知し、重耇を送信したせん。管理者がリク゚ストを华䞋した埌、コマンドを再床実行するず新しいリク゚ストが送信されたす。v2.1.222 より前では、华䞋されたリク゚ストも新しいリク゚ストをブロックしおいたした。143以前のリク゚ストが管理者を埅機しおいる間に `/usage-credits` を再床実行した堎合、Claude Code はリク゚ストが既に送信されたこずを通知し、重耇を送信したせん。管理者がリク゚ストを华䞋した埌、コマンドを再床実行するず新しいリク゚ストが送信されたす。v2.1.222 より前では、华䞋されたリク゚ストも新しいリク゚ストをブロックしおいたした。

142 144 

143Pro および Max プランでは、支出制限に達しおも䜿甚量クレゞットがただ利甚可胜な堎合、Claude Code は制限を匕き䞊げるか削陀するよう促し、CLI を離れるこずなく続行できたす。サヌバヌが倉曎を拒吊した堎合、[Could not update your spend limit](https://code.claude.com/docs/ja/errors.md#could-not-update-your-spend-limit) を参照しおください。145Pro、Max、および Ultra プランでは、䜿甚クレゞットが残っおいる状態で支出制限に達するず、Claude Code は CLI を離れるこずなく制限を匕き䞊げるか削陀するよう促したす。サヌバヌが倉曎を拒吊した堎合は、[Could not update your spend limit](https://code.claude.com/docs/ja/errors.md#could-not-update-your-spend-limit) を参照しおください。

144 146 

145## 組織のコストを管理する147## 組織のコストを管理する

146 148 

151| セットアップ | 支出を確認 | 支出をキャップ | ナヌザヌごずのレポヌト |153| セットアップ | 支出を確認 | 支出をキャップ | ナヌザヌごずのレポヌト |

152| :- | :- | :- | :- |154| :- | :- | :- | :- |

153| [Claude for Teams たたは Enterprise](#claude-for-teams-and-enterprise) | [org analytics の支出レポヌト](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | 管理者蚭定の支出制限 | [支出レポヌト CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)、Enterprise の [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) |155| [Claude for Teams たたは Enterprise](#claude-for-teams-and-enterprise) | [org analytics の支出レポヌト](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | 管理者蚭定の支出制限 | [支出レポヌト CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)、Enterprise の [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) |

154| [Claude ConsoleAPI](#claude-console) | [Console 䜿甚状況ペヌゞ](https://platform.claude.com/usage) | ワヌクスペヌス支出制限 | [Console ダッシュボヌド](https://platform.claude.com/claude-code)、[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |156| [Claude ConsoleAPI](#claude-console) | [Console の Cost ペヌゞ](https://platform.claude.com/cost) | ワヌクスペヌス支出制限 | [Console ダッシュボヌド](https://platform.claude.com/claude-code)、[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |

155| [Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry](#cloud-providers) | クラりド請求コン゜ヌル | クラりドの予算コントロヌル | [OpenTelemetry](https://code.claude.com/docs/ja/monitoring-usage.md) たたは [LLM gateway](https://code.claude.com/docs/ja/llm-gateway) |157| [Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry](#cloud-providers) | クラりド請求コン゜ヌル | クラりドの予算コントロヌル | [OpenTelemetry](https://code.claude.com/docs/ja/monitoring-usage.md) たたは [LLM gateway](https://code.claude.com/docs/ja/llm-gateway) |

156 158 

157[OpenTelemetry ゚クスポヌト](https://code.claude.com/docs/ja/monitoring-usage.md) はすべおのセットアップで機胜し、ナヌザヌごずのトヌクンおよびコストメトリクスをほがリアルタむムで独自の可芳枬性スタックにストリヌミングする唯䞀のオプションです。159[OpenTelemetry ゚クスポヌト](https://code.claude.com/docs/ja/monitoring-usage.md) はすべおのセットアップで機胜し、ナヌザヌごずのトヌクンおよびコストメトリクスをほがリアルタむムで独自の可芳枬性スタックにストリヌミングする唯䞀のオプションです。

195>197>

196> カスタムレヌト制限を持぀組織の堎合、このワヌクスペヌスの Claude Code トラフィックは組織党䜓の API レヌト制限にカりントされたす。Claude Console の Limits ペヌゞでこのワヌクスペヌスに [ワヌクスペヌスレヌト制限](https://platform.claude.com/docs/en/api/rate-limits#setting-lower-limits-for-workspaces) を蚭定しお、Claude Code の共有をキャップし、他の本番ワヌクロヌドを保護できたす。198> カスタムレヌト制限を持぀組織の堎合、このワヌクスペヌスの Claude Code トラフィックは組織党䜓の API レヌト制限にカりントされたす。Claude Console の Limits ペヌゞでこのワヌクスペヌスに [ワヌクスペヌスレヌト制限](https://platform.claude.com/docs/en/api/rate-limits#setting-lower-limits-for-workspaces) を蚭定しお、Claude Code の共有をキャップし、他の本番ワヌクロヌドを保護できたす。

197 199 

198ナヌザヌごずのレポヌトに぀いおは、[Console ダッシュボヌド](https://platform.claude.com/claude-code) はメンバヌごずの支出ず受け入れられた行を衚瀺し、[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) は [Admin API キヌ](https://platform.claude.com/settings/admin-keys) を䜿甚しおプログラムで同じ日次ナヌザヌごずのメトリクスを返したす。[API カスタマヌ向けの analytics](https://code.claude.com/docs/ja/analytics.md#access-analytics-for-api-customers) を参照しおください。200ナヌザヌごずのレポヌトに぀いおは、[Console ダッシュボヌド](https://platform.claude.com/claude-code) はメンバヌごずの支出ず受け入れられた行を衚瀺し、[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) は [Admin API キヌ](https://platform.claude.com/settings/admin-keys) を䜿甚しおプログラムで日次のナヌザヌごずのメトリクスを返したす。[API 顧客向けの analytics](https://code.claude.com/docs/ja/analytics.md#access-analytics-for-api-customers) を参照しおください。

199 201 

200#### レヌト制限の掚奚事項202#### レヌト制限の掚奚事項

201 203 

desktop.md +23 −10

Details

131* Browser ペむンのヘッダヌにある **Dev servers** メニュヌから、サヌバヌを開始たたは停止する、たたはすべおのサヌバヌを䞀床に停止する131* Browser ペむンのヘッダヌにある **Dev servers** メニュヌから、サヌバヌを開始たたは停止する、たたはすべおのサヌバヌを䞀床に停止する

132* Browser ペむンの **⋮** メニュヌにある **Keep cookies** で、アプリを終了した埌も Browser がクッキヌを保持するかどうかを遞択し、開発䞭に再床サむンむンする必芁がないようにする132* Browser ペむンの **⋮** メニュヌにある **Keep cookies** で、アプリを終了した埌も Browser がクッキヌを保持するかどうかを遞択し、開発䞭に再床サむンむンする必芁がないようにする

133 133 

134SSH セッションでは、Desktop を終了するずペむンのクッキヌは倱われたす。これは **Keep cookies** で倉曎するこずはできたせん。

135 

134Claude はプロゞェクトに基づいお初期サヌバヌ蚭定を䜜成したす。アプリがカスタム dev コマンドを䜿甚する堎合、`.claude/launch.json`を線集しおセットアップに合わせたす。完党なリファレンスに぀いおは、[プレビュヌサヌバヌを蚭定する](#configure-preview-servers)を参照しおください。136Claude はプロゞェクトに基づいお初期サヌバヌ蚭定を䜜成したす。アプリがカスタム dev コマンドを䜿甚する堎合、`.claude/launch.json`を線集しおセットアップに合わせたす。完党なリファレンスに぀いおは、[プレビュヌサヌバヌを蚭定する](#configure-preview-servers)を参照しおください。

135 137 

136Browser の保存デヌタをクリアするには、Browser ペむンの **⋮** メニュヌで **Clear browsing data** を遞択したす。Browser を完党にオフにするには、**Settings > Code** たたは **Settings > Claude Code** で **Browser tools** をオフにしたす。138Browser の保存デヌタをクリアするには、Browser ペむンの **⋮** メニュヌで **Clear browsing data** を遞択したす。Browser を完党にオフにするには、**Settings > Code** たたは **Settings > Claude Code** で **Browser tools** をオフにしたす。

312 314 

313どちらのレむアりトでも、プロンプトボックスに`/context`ず入力するず、このセッションのコンテキストりィンドりのカテゎリ別の内蚳がチャットに出力されたす。315どちらのレむアりトでも、プロンプトボックスに`/context`ず入力するず、このセッションのコンテキストりィンドりのカテゎリ別の内蚳がチャットに出力されたす。

314 316 

315どちらのレむアりトにも、モデルピッカヌの暪に䜿甚状況リングがありたす。これをクリックするずプランの䜿甚状況が衚瀺されたす。プランの䜿甚状況はすべおの Claude Code サヌフェス党䜓で共有されたす。317どちらのレむアりトでも、䜿甚状況リングはプロンプトボックスの䞋の行にありたす。これをクリックするずプランの䜿甚状況が衚瀺されたす。プランの䜿甚状況はすべおの Claude Code サヌフェス党䜓で共有されたす。

316 318 

317## Claude にコンピュヌタヌを䜿わせる319## Claude にコンピュヌタヌを䜿わせる

318 320 

409 411 

410#### セッションを独自の worktree で実行する412#### セッションを独自の worktree で実行する

411 413 

412Git リポゞトリであるプロゞェクトでは、セッションを開始する前に **Worktree** をオンにするず、プロゞェクトの分離されたコピヌである独自の [Git worktree](https://code.claude.com/docs/ja/worktrees.md) でセッションを実行できたす。デフォルトでは **Worktree** はオフで、Claude はプロゞェクトフォルダ自䜓で䜜業したす。[珟圚のレむアりト](#check-which-layout-you-have)では、[プロンプトボックスの䞋の行](#start-a-session)にある **Worktree** ボタンをオンにしたす。414Git リポゞトリであるプロゞェクトでは、セッションを開始する前に **Worktree** をオンにするず、プロゞェクトの分離されたコピヌである独自の [Git worktree](https://code.claude.com/docs/ja/worktrees.md) でセッションを実行できたす。デフォルトでは **Worktree** はオフで、Claude はプロゞェクトフォルダ自䜓で䜜業したす。[珟圚のレむアりト](#check-which-layout-you-have)では、[プロンプトボックスの䞋の行](#start-a-session)で **Worktree** をオンにしたす。

413 415 

414* **[サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)を䜿甚する堎合**プロンプトボックスの䞋の行にプロゞェクトフォルダのコントロヌルが衚瀺されおいお **Worktree** ボタンがない堎合は、そのコントロヌルをクリックしお **Worktree** をオンにしたす416* **[サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)を䜿甚する堎合**プロンプトボックスの䞋の行にプロゞェクトフォルダのコントロヌルが衚瀺されおいお **Worktree** がない堎合は、そのコントロヌルをクリックしお **Worktree** をオンにしたす

415* **[保存枈みのロヌカル環境たたは SSH 環境](#create-a-saved-environment)のデフォルトずしお蚭定する堎合**環境を䜜成たたは線集するずきに **Worktree** を蚭定したす417* **[保存枈みのロヌカル環境たたは SSH 環境](#create-a-saved-environment)のデフォルトずしお蚭定する堎合**環境を䜜成たたは線集するずきに **Worktree** を蚭定したす

416* **[以前のレむアりト](#check-which-layout-you-have)**プロンプトボックスの䞊にあるブランチ名の暪の **worktree** チェックボックスを遞択したす418* **[以前のレむアりト](#check-which-layout-you-have)**プロンプトボックスの䞊にあるブランチ名の暪の **worktree** チェックボックスを遞択したす

417 419 

1094 1096 

1095##### OpenSSH クラむアントを䜿甚せずに Windows で接続する1097##### OpenSSH クラむアントを䜿甚せずに Windows で接続する

1096 1098 

1097Windows では、コンピュヌタヌが [OpenSSH クラむアントの芁件](#use-your-ssh-configuration)を満たしおいない堎合、Desktop の組み蟌み SSH クラむアント経由で接続したす。サヌドパヌティプロバむダヌでは、デフォルトで組み蟌みクラむアント経由で接続したすが、管理者がこれを倉曎できたす。この蚭定に぀いおは、[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照しおください。1099Windows では、コンピュヌタヌが [OpenSSH クラむアントの芁件](#use-your-ssh-configuration)を満たしおいない堎合、Desktop の組み蟌み SSH クラむアント経由で接続したす。サヌドパヌティプロバむダヌの堎合、どのクラむアント経由で接続するかは、Desktop のバヌゞョンず管理者の蚭定にも䟝存したす。[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照しおください。

1098 1100 

1099組み蟌みクラむアントでも、`PATH` に `ssh` コマンドがあれば、**SSH host** フィヌルドに SSH 蚭定の `Host` 名を入力できたす。ただし、次の制限がありたす。1101組み蟌みクラむアントでも、`PATH` に `ssh` コマンドがあれば、**SSH host** フィヌルドに SSH 蚭定の `Host` 名を入力できたす。ただし、次の制限がありたす。

1100 1102 

1101* **゚ントリからの蚭定**: Desktop は `HostName`、`User`、`Port`、`IdentityFile` を䜿甚したす。`PATH` に `sh` シェルがある堎合は `ProxyCommand` も䜿甚したす。1103* **゚ントリの蚭定**: Desktop は `HostName`、`User`、`Port`、`IdentityFile`、`ConnectTimeout` を䜿甚したす。`PATH` に `sh` シェルがある堎合は `ProxyCommand` も䜿甚したす。

1102* **SSH key (optional)**: ここで遞択した鍵ファむルは `IdentityFile` を眮き換えるため、゚ントリの `IdentityFile` を䜿い続けるにはこのフィヌルドを空欄のたたにしたす1104* **SSH key (optional)**: ここで遞択した鍵ファむルは `IdentityFile` を眮き換えるため、゚ントリの `IdentityFile` を䜿い続けるにはこのフィヌルドを空欄のたたにしたす

1103* **`CertificateFile` ず `ProxyJump`**: Desktop は `CertificateFile` を無芖し、゚ントリで `ProxyJump` が蚭定されおいるず接続は倱敗したす。いずれかの蚭定を䜿甚するには、[OpenSSH クラむアント経由で接続しおください](#use-your-ssh-configuration)。1105* **`CertificateFile` ず `ProxyJump`**: Desktop は `CertificateFile` を無芖し、゚ントリで `ProxyJump` が蚭定されおいるず接続は倱敗したす。いずれかの蚭定を䜿甚するには、[OpenSSH クラむアント経由で接続しおください](#use-your-ssh-configuration)。

1104 1106 

1198 1200 

1199##### SSH 接続のタむムアりトを延長する1201##### SSH 接続のタむムアりトを延長する

1200 1202 

1201SSH 蚭定でホストに `ConnectTimeout` が蚭定されおいない堎合、Desktop は `ssh` に接続のための 30 秒を䞎えたす。ゞャンプホストたたは `ProxyCommand` を経由する堎合、この時間にはルヌトの接続にかかる時間が含たれたす。ルヌトにそれ以䞊の時間が必芁な堎合は、゚ントリにより倧きな倀を远加したす1203ゞャンプホストたたは `ProxyCommand` 経由での接続䞭にセッションがタむムアりトする堎合は、`~/.ssh/config` のリモヌトマシンの゚ントリで `ConnectTimeout` を匕き䞊げたす。90 秒より長い倀を䜿甚しおください。ログむンプロンプトや電話ぞのプッシュ通知など、ゞャンプホストたたは `ProxyCommand` がナヌザヌを埅぀時間も加算したす。

1202 1204 

1203```text ~/.ssh/config theme={null}1205```text ~/.ssh/config theme={null}

1204Host devbox1206Host devbox

1210 1212 

1211`ssh` はホストに察しお最初に芋぀かった倀を䜿甚するため、この゚ントリは `ConnectTimeout` を蚭定する `Host *` ゚ントリよりも䞊に配眮しおください。確認するには、コンピュヌタヌのタヌミナルで `ssh -G devbox` を実行したす。その出力には `connecttimeout 120` が含たれたす。倀を倉曎した埌は、Desktop を終了しお再床開いおください。1213`ssh` はホストに察しお最初に芋぀かった倀を䜿甚するため、この゚ントリは `ConnectTimeout` を蚭定する `Host *` ゚ントリよりも䞊に配眮しおください。確認するには、コンピュヌタヌのタヌミナルで `ssh -G devbox` を実行したす。その出力には `connecttimeout 120` が含たれたす。倀を倉曎した埌は、Desktop を終了しお再床開いおください。

1212 1214 

1213リモヌトマシン自䜓がスマヌトフォンでの承認を埅぀堎合は、`ConnectTimeout` の蚭定にかかわらず、45 秒以内に承認しおください。Desktop が `ServerAliveInterval` ず `ServerAliveCountMax` を独自に蚭定し、リモヌトマシンがその間䜕も送信しないログむンを `ssh` が閉じるため、この制限は延長できたせん。代わりにゞャンプホストたたは `ProxyCommand` がナヌザヌを埅぀堎合は、リモヌトマシンの゚ントリの `ConnectTimeout` を延長しお、その時間をカバヌしおください。1215SSH 蚭定でホストに `ConnectTimeout` が蚭定されおいない堎合、Desktop は `ssh` に接続のための 30 秒を䞎えたす。ゞャンプホストたたは `ProxyCommand` 経由の堎合、その時間には経路の接続にかかる時間も含たれたす。

1216 

1217| `ConnectTimeout` | 接続 | 䜿える時間 |

1218| - | - | - |

1219| 未蚭定 | macOS たたは Linux 䞊の Claude Desktop v4.4212.0 以降で、ゞャンプホストたたは `ProxyCommand` 経由でセッションを開始する堎合 | 30 秒、その埌 90 秒での 2 回目の詊行。1 回目の詊行䞭に Desktop がプロンプトを衚瀺した堎合、2 回目の詊行はありたせん。`ProxyJump` ホストに察しお Desktop が衚瀺するログむンプロンプトでの時間はカりントされたせん。経路䞊のその他の埅ち時間はカりントされたす。 |

1220| 未蚭定 | Windows 䞊の Desktop たたは以前のバヌゞョン、`MaxSessions 1` を蚭定したリモヌトマシン、たたは Desktop が自動で開始する再接続 | 30 秒。経路䞊のすべおの埅ち時間がカりントされたす。 |

1221| 蚭定枈み | すべおの接続ず再接続 | 蚭定した倀。経路䞊のすべおの埅ち時間がカりントされたす。 |

1222 

1223リモヌトマシン自䜓が電話での承認を埅぀堎合は、蚭定した `ConnectTimeout` にかかわらず、45 秒以内に承認しおください。Desktop が `ServerAliveInterval` ず `ServerAliveCountMax` を自身で蚭定しおおり、リモヌトマシンがその時間䜕も送信しないログむンを `ssh` が閉じるため、この制限は匕き䞊げられたせん。

1214 1224 

1215##### Desktop だけが適甚する `Match host` ブロックを修正する1225##### Desktop だけが適甚する `Match host` ブロックを修正する

1216 1226 

1334>1344>

1335> 次のような堎合には、線集は匕き続き倱敗したす1345> 次のような堎合には、線集は匕き続き倱敗したす

1336>1346>

1337> * **組み蟌みの SSH クラむアント**Desktop がそれを䜿甚しおいる堎合。たずえば、Microsoft Store からのむンストヌル、Microsoft の OpenSSH 9.4 以降がない Windows コンピュヌタヌ、たたはサヌドパヌティプロバむダヌを䜿甚する Windows でのデフォルトの堎合です1347> * **組み蟌み SSH クラむアント**: Microsoft Store 版のむンストヌルや、Microsoft の OpenSSH 9.4 以降がない Windows コンピュヌタヌなどで、Desktop が組み蟌み SSH クラむアントを䜿甚しおいる堎合

1338> * **リポゞトリの堎所**リポゞトリがホヌムディレクトリ、その䞊䜍のフォルダ、たたは `~/.claude` である1348> * **リポゞトリの堎所**リポゞトリがホヌムディレクトリ、その䞊䜍のフォルダ、たたは `~/.claude` である

1339> * **macOS のパス**macOS のリモヌトマシンで、リポゞトリが `/Volumes` の䞋にある、たたはリポゞトリもしくは worktree のパス内のフォルダ名に `~` たたは非 ASCII 文字が含たれおいる1349> * **macOS のパス**macOS のリモヌトマシンで、リポゞトリが `/Volumes` の䞋にある、たたはリポゞトリもしくは worktree のパス内のフォルダ名に `~` たたは非 ASCII 文字が含たれおいる

1340> * **フォルダの制限**組織がセッションで䜿甚できるフォルダを制限しおいる1350> * **フォルダの制限**組織がセッションで䜿甚できるフォルダを制限しおいる

1369* **蚘憶されたパスワヌド**Desktop に蚘憶させたパスワヌドもプロンプトなしで機胜したすが、長期間䞍圚にする堎合は SSH ゚ヌゞェントが保持する鍵を䜿甚するこずをお勧めしたす。そのパスワヌドでのサむンむンが途䞭で切れたり応答しなくなったりする堎合、Desktop は再接続を停止しおナヌザヌを埅぀こずがありたす。1379* **蚘憶されたパスワヌド**Desktop に蚘憶させたパスワヌドもプロンプトなしで機胜したすが、長期間䞍圚にする堎合は SSH ゚ヌゞェントが保持する鍵を䜿甚するこずをお勧めしたす。そのパスワヌドでのサむンむンが途䞭で切れたり応答しなくなったりする堎合、Desktop は再接続を停止しおナヌザヌを埅぀こずがありたす。

1370* **その他のプロンプト**リモヌトマシンがワンタむムコヌドなど、その他の入力を求める堎合、コンピュヌタヌに通知が届くこずがありたす。通知をクリックするか、セッションでメッセヌゞを送信するず、Desktop にプロンプトが衚瀺されたす。1380* **その他のプロンプト**リモヌトマシンがワンタむムコヌドなど、その他の入力を求める堎合、コンピュヌタヌに通知が届くこずがありたす。通知をクリックするか、セッションでメッセヌゞを送信するず、Desktop にプロンプトが衚瀺されたす。

1371 1381 

1372> [accordion] ゞャンプホストがサむンむンを求める堎合、停止が長い堎合、出力が欠萜しおいる堎合、たたはプロセスが存圚しない堎合1382> [accordion] ゞャンプホストがサむンむンを求める堎合、切断が長時間に及ぶ堎合、メッセヌゞが送信されない堎合、出力が欠萜しおいる堎合、たたはプロセスがなくなっおいる堎合

1373>1383>

1374> * **ゞャンプホスト、䞍圚䞭にプッシュ通知が止たる**これは、ゞャンプホストのサむンむンスマヌトフォンぞのプッシュ通知などに誰も応答しない堎合に、macOS たたは Linux の Desktop で発生するこずがありたす。その堎合、Desktop はコンピュヌタヌの前に誰もいない間は再接続を停止したす。コンピュヌタヌのロックを解陀するか䜿甚するず、Desktop が再詊行できるため、別のプッシュ通知が届くこずがありたす。応答のない詊行が 3 回続くず、ナヌザヌが再詊行するかメッセヌゞを送信するたで埅機したす。1384> * **ゞャンプホスト、䞍圚䞭にプッシュ通知が止たる**これは、ゞャンプホストのサむンむンスマヌトフォンぞのプッシュ通知などに誰も応答しない堎合に、macOS たたは Linux の Desktop で発生するこずがありたす。その堎合、Desktop はコンピュヌタヌの前に誰もいない間は再接続を停止したす。コンピュヌタヌのロックを解陀するか䜿甚するず、Desktop が再詊行できるため、別のプッシュ通知が届くこずがありたす。応答のない詊行が 3 回続くず、ナヌザヌが再詊行するかメッセヌゞを送信するたで埅機したす。

1375> * **ゞャンプホスト、プッシュ通知が届き続ける**Windows の Desktop のように、Desktop が誰も応答しおいないこずを刀別できない堎合、再参加するプロセスがある間は、そのプロセスがただ実行䞭かどうかにかかわらず詊行を続けたす。詊行のたびに別のプッシュ通知が届くこずがありたす。詊行を終了するには Desktop を終了したすが、その堎合は[実行䞭のタスクが倱われる可胜性がありたす](#reopen-a-session-after-you-quit-desktop)。1385> * **ゞャンプホスト、プッシュ通知が届き続ける**Windows の Desktop のように、Desktop が誰も応答しおいないこずを刀別できない堎合、再参加するプロセスがある間は、そのプロセスがただ実行䞭かどうかにかかわらず詊行を続けたす。詊行のたびに別のプッシュ通知が届くこずがありたす。詊行を終了するには Desktop を終了したすが、その堎合は[実行䞭のタスクが倱われる可胜性がありたす](#reopen-a-session-after-you-quit-desktop)。

1376> * **長時間の停止**Desktop は玄 5 分ごずに 1 回の詊行にペヌスを萜ずしたす。早く再接続するには、セッションで再詊行するか、メッセヌゞを送信したす。メッセヌゞは接続埌に Desktop が配信したす。1386> * **長時間の切断**: Desktop は玄 5 分に 1 回の詊行たで頻床を䞋げたす。より早く再接続するには、セッションで再詊行するかメッセヌゞを送信したす。Desktop は接続するずすぐにメッセヌゞの配信を詊みたす。

1387> * **メッセヌゞが送信されない**: メッセヌゞの䞋に `Your organization's settings haven't loaded, so your message to <host> wasn't sent. Retry to send it.` ずいう行が衚瀺される堎合、Desktop は再接続したしたが、組織の蚭定がただ読み蟌たれおいなかったためメッセヌゞを保留したこずを意味したす。**Retry** を遞択するず、今すぐメッセヌゞを送信したす。䜕もしない堎合、Desktop は蚭定が読み蟌たれた時点で再詊行したす。

1377> * **出力の欠萜**Desktop が切断されおいる間、ヘルパヌは各セッションの最新の Claude Code 出力を 16 MiB のバッファに保持し、それより叀い出力は砎棄したす。Desktop が再接続した埌、セッションに `Loading recent output from <host>
` ず衚瀺されるこずがありたす。Desktop がすべおの出力を読み蟌めない堎合は、`Some output produced while you were disconnected may be missing here.` ずいう行が衚瀺されたす。この行はタスクが停止したこずを意味するものではありたせん。1388> * **出力の欠萜**Desktop が切断されおいる間、ヘルパヌは各セッションの最新の Claude Code 出力を 16 MiB のバッファに保持し、それより叀い出力は砎棄したす。Desktop が再接続した埌、セッションに `Loading recent output from <host>
` ず衚瀺されるこずがありたす。Desktop がすべおの出力を読み蟌めない堎合は、`Some output produced while you were disconnected may be missing here.` ずいう行が衚瀺されたす。この行はタスクが停止したこずを意味するものではありたせん。

1378> * **プロセスがなくなった**: リモヌトマシンの再起動時など、Desktop が切断されおいる間にプロセスが終了した状態です。その堎合、Desktop は䌚話の保存された履歎から新しいプロセスを開始し、Claude にタスクを続行するよう指瀺できたす。タスクが停止したたたの堎合は、メッセヌゞを送信しおください。サヌドパヌティプロバむダヌの堎合は、それより前のバヌゞョンでは自動的にタスクが続行されるこずはないため、Claude Desktop v2.42304.0 以降に曎新しおください。1389> * **プロセスがなくなった**: リモヌトマシンの再起動時など、Desktop が切断されおいる間にプロセスが終了した状態です。その堎合、Desktop は䌚話の保存された履歎から新しいプロセスを開始し、Claude にタスクを続行するよう指瀺できたす。タスクが停止したたたの堎合は、メッセヌゞを送信しおください。サヌドパヌティプロバむダヌの堎合は、それより前のバヌゞョンでは自動的にタスクが続行されるこずはないため、Claude Desktop v2.42304.0 以降に曎新しおください。

1379 1390 

2290| `<host> is out of disk space` | `[ENOSPC]` たたは `[EDQUOT]` | リモヌトマシンのホヌムディレクトリたたは `/tmp` で空き容量たたはクォヌタを確保したす |2301| `<host> is out of disk space` | `[ENOSPC]` たたは `[EDQUOT]` | リモヌトマシンのホヌムディレクトリたたは `/tmp` で空き容量たたはクォヌタを確保したす |

2291| `Free up disk space on this computer` | `[ENOSPC]` たたは `[EDQUOT]``Couldn't prepare the deploy locally` で始たるメッセヌゞ内 | コンピュヌタヌの空き容量を確保したす |2302| `Free up disk space on this computer` | `[ENOSPC]` たたは `[EDQUOT]``Couldn't prepare the deploy locally` で始たるメッセヌゞ内 | コンピュヌタヌの空き容量を確保したす |

2292| `Claude Code won't start on <host>` | `[CLI_UNRESPONSIVE]` | 1 分埅っおから、もう䞀床詊しおください。倱敗が続く堎合は、メッセヌゞに瀺されおいるコマンドをリモヌトマシンで実行し、そこで Claude Code が応答するかどうかを確認したす。 |2303| `Claude Code won't start on <host>` | `[CLI_UNRESPONSIVE]` | 1 分埅っおから、もう䞀床詊しおください。倱敗が続く堎合は、メッセヌゞに瀺されおいるコマンドをリモヌトマシンで実行し、そこで Claude Code が応答するかどうかを確認したす。 |

2304| `Ask <host>'s administrator to let Claude's server run` | `[SERVER_NOT_RUNNABLE]` たたは `[SETUP_DIR_NOEXEC]` | [芁件](#remote-machine-requirements-for-ssh-sessions)に蚘茉されおいるずおり、リモヌトマシン䞊の `~/.claude/remote/` からプログラムを実行できるようにするよう、そのマシンの管理者に䟝頌したす |

2305| `Try again in a few minutes` | `[DOWNLOAD_BUSY]` | 数分埅っおから、もう䞀床詊しおください。Anthropic のダりンロヌドサヌバヌ、たたはコンピュヌタヌのネットワヌク䞊のプロキシが、ビゞヌ状態であるず報告したした。カヌドが繰り返し衚瀺される堎合は、プロキシがダりンロヌドを制限しおいないか、そのネットワヌクの管理者に確認しおください。 |

2293 2306 

2294その他のメッセヌゞに぀いおは、[リモヌトマシンの芁件](#remote-machine-requirements-for-ssh-sessions)を確認しおください。2307その他のメッセヌゞに぀いおは、[リモヌトマシンの芁件](#remote-machine-requirements-for-ssh-sessions)を確認しおください。

2295 2308 

env-vars.md +4 −5

Details

126> * `CLAUDE_CODE_TMUX_TRUECOLOR`126> * `CLAUDE_CODE_TMUX_TRUECOLOR`

127> * `IS_DEMO`127> * `IS_DEMO`

128>128>

129> もう 1 ぀の倉数には独自のルヌルがありたす。`FORCE_HYPERLINK` は数倀を読み取るため、`0` のみがオフにしたす。各倉数の行にも、それぞれのルヌルが蚘茉されおいたす。129> 各倉数の行にも、それぞれのルヌルが蚘茉されおいたす。

130 130 

131| 倉数 | 目的 |131| 倉数 | 目的 |

132| :- | :- |132| :- | :- |

239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に蚭定するず、[スヌパヌバむザヌ](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process) がセッションのプロセスを停止、再起動、たたは曎新したずきに、[バックグラりンドセッションの](https://code.claude.com/docs/ja/agent-view.md) 進行䞭の䜜業を、セッションの次のプロセスに匕き継ぐのではなく停止したす。その䜜業ずは、セッションで実行䞭のバックグラりンドシェルコマンドず、v2.1.198 以降ではバックグラりンドサブ゚ヌゞェントです。圱響するのはこの匕き継ぎのみです。`←` や [`/background`](https://code.claude.com/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンドに移動した堎合は、進行䞭のバックグラりンド䜜業が匕き続き匕き継がれたす。Claude Code v2.1.196 以降が必芁です |239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に蚭定するず、[スヌパヌバむザヌ](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process) がセッションのプロセスを停止、再起動、たたは曎新したずきに、[バックグラりンドセッションの](https://code.claude.com/docs/ja/agent-view.md) 進行䞭の䜜業を、セッションの次のプロセスに匕き継ぐのではなく停止したす。その䜜業ずは、セッションで実行䞭のバックグラりンドシェルコマンドず、v2.1.198 以降ではバックグラりンドサブ゚ヌゞェントです。圱響するのはこの匕き継ぎのみです。`←` や [`/background`](https://code.claude.com/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンドに移動した堎合は、進行䞭のバックグラりンド䜜業が匕き続き匕き継がれたす。Claude Code v2.1.196 以降が必芁です |

240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1` に蚭定するず、メモリ逌迫時に Claude Code が[バックグラりンドシェルコマンド](https://code.claude.com/docs/ja/interactive-mode.md#background-bash-commands)を終了しないようにしたす。デフォルトでは、macOS ず Linux で、オペレヌティングシステムが深刻なメモリ逌迫を報告し、か぀セッションがタヌンやサブ゚ヌゞェントの実行なしで 30 分間アむドル状態だった堎合、Claude Code はバックグラりンドシェルを終了したす。Windows にはメモリ逌迫のシグナルがないため、この倉数は効果がありたせん。Claude Code v2.1.193 以降が必芁です |240| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1` に蚭定するず、メモリ逌迫時に Claude Code が[バックグラりンドシェルコマンド](https://code.claude.com/docs/ja/interactive-mode.md#background-bash-commands)を終了しないようにしたす。デフォルトでは、macOS ず Linux で、オペレヌティングシステムが深刻なメモリ逌迫を報告し、か぀セッションがタヌンやサブ゚ヌゞェントの実行なしで 30 分間アむドル状態だった堎合、Claude Code はバックグラりンドシェルを終了したす。Windows にはメモリ逌迫のシグナルがないため、この倉数は効果がありたせん。Claude Code v2.1.193 以降が必芁です |

241| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1` に蚭定するず、Claude Code に含たれる[スキル](https://code.claude.com/docs/ja/skills.md)ずワヌクフロヌを無効にしたす。バンドルスキルずワヌクフロヌは完党に削陀され、`/init` などの組み蟌みコマンドは入力可胜なたたですが、モデルからは隠されたす。`/doctor` は組み蟌みコマンドず同様に入力可胜なたたです。隠すには、代わりに `DISABLE_DOCTOR_COMMAND` を䜿甚したす。プラグむン、`.claude/skills/`、`.claude/commands/` のスキルは圱響を受けたせん。[`disableBundledSkills`](https://code.claude.com/docs/ja/settings-reference#disablebundledskills) 蚭定ず同等です |241| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1` に蚭定するず、Claude Code に含たれる[スキル](https://code.claude.com/docs/ja/skills.md)ずワヌクフロヌを無効にしたす。バンドルスキルずワヌクフロヌは完党に削陀され、`/init` などの組み蟌みコマンドは入力可胜なたたですが、モデルからは隠されたす。`/doctor` は組み蟌みコマンドず同様に入力可胜なたたです。隠すには、代わりに `DISABLE_DOCTOR_COMMAND` を䜿甚したす。プラグむン、`.claude/skills/`、`.claude/commands/` のスキルは圱響を受けたせん。[`disableBundledSkills`](https://code.claude.com/docs/ja/settings-reference#disablebundledskills) 蚭定ず同等です |

242| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | `1` に蚭定するず、[Claude in Chrome](https://code.claude.com/docs/ja/chrome.md) のブラりザツヌルを利甚可胜なたたにし぀぀、システムプロンプトの Chrome セクションず `/claude-in-chrome` [バンドルスキル](https://code.claude.com/docs/ja/skills.md#bundled-skills)を省略したす。Claude Code を組み蟌み、独自のブラりザガむダンスを提䟛するホスト向けです。Claude Code v2.1.257 以降が必芁です |242| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Claude Code を組み蟌み、独自のブラりザヌガむダンスを提䟛するホスト向けです。`1` に蚭定するず、[Claude in Chrome](https://code.claude.com/docs/ja/chrome.md) のブラりザヌツヌルを利甚可胜なたたにし぀぀、システムプロンプトの Chrome セクションず `/claude-in-chrome` [バンドルスキル](https://code.claude.com/docs/ja/skills.md#bundled-skills)を省略したす。VS Code では、v2.1.314 以降の拡匵機胜は、セッションのメッセヌゞからも Claude in Chrome の指瀺を陀倖したす。Claude Code v2.1.257 以降が必芁です |

243| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | `1` に蚭定するず、ナヌザヌ、プロゞェクト、自動メモリのファむルを含む、すべおの CLAUDE.md メモリファむルをコンテキストに読み蟌たないようにしたす |243| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | `1` に蚭定するず、ナヌザヌ、プロゞェクト、自動メモリのファむルを含む、すべおの CLAUDE.md メモリファむルをコンテキストに読み蟌たないようにしたす |

244| `CLAUDE_CODE_DISABLE_CRON` | `1` に蚭定するず、[セッションスコヌプのスケゞュヌルタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)を無効にしたす。`/loop` スキルず cron ツヌルは䜿甚できなくなり、セッション途䞭ですでに実行䞭のタスクを含め、すでにスケゞュヌルされたタスクは起動しなくなりたす |244| `CLAUDE_CODE_DISABLE_CRON` | `1` に蚭定するず、[セッションスコヌプのスケゞュヌルタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)を無効にしたす。`/loop` スキルず cron ツヌルは䜿甚できなくなり、セッション途䞭ですでに実行䞭のタスクを含め、すでにスケゞュヌルされたタスクは起動しなくなりたす |

245| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | `1` に蚭定するず、クリティカルパスの削陀に察する `auto` モヌドず `bypassPermissions` モヌドの[制限時間ず拒吊](https://code.claude.com/docs/ja/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)をオフにしたす。その堎合、これらの削陀は `auto` モヌドでは分類噚に送られ、`bypassPermissions` モヌドでは Claude Code が暩限プロンプトを衚瀺できる堎合は垞に、時間制限のない暩限プロンプトが衚瀺されたす。Claude Code は蚭定の `env` ブロックで枡された倀を無芖するため、Claude Code を起動する環境で蚭定しおください。Claude Code v2.1.281 以降が必芁です |245| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | `1` に蚭定するず、クリティカルパスの削陀に察する `auto` モヌドず `bypassPermissions` モヌドの[制限時間ず拒吊](https://code.claude.com/docs/ja/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)をオフにしたす。その堎合、これらの削陀は `auto` モヌドでは分類噚に送られ、`bypassPermissions` モヌドでは Claude Code が暩限プロンプトを衚瀺できる堎合は垞に、時間制限のない暩限プロンプトが衚瀺されたす。Claude Code は蚭定の `env` ブロックで枡された倀を無芖するため、Claude Code を起動する環境で蚭定しおください。Claude Code v2.1.281 以降が必芁です |

307| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ: Git Bash 実行ファむル`bash.exe`ぞのパス。Git Bash がむンストヌルされおいるものの PATH にない堎合に䜿甚したす。パスが存圚しない堎合、たたはファむル名が `bash.exe`、`sh.exe`、`bash`、`sh` のいずれでもない堎合、Claude Code はこの倉数を無芖し、未蚭定の堎合ず同様に Git Bash を自動怜出しお、`--debug` で確認できる譊告をログに蚘録したす。v2.1.219 より前は、パスが存圚しない堎合に Claude Code は起動時に終了し、既存のファむルであれば bash たたは sh であるかを確認せずにシェルずしお䜿甚しおいたした。[Windows でのセットアップ](https://code.claude.com/docs/ja/setup.md#set-up-on-windows) を参照しおください |307| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ: Git Bash 実行ファむル`bash.exe`ぞのパス。Git Bash がむンストヌルされおいるものの PATH にない堎合に䜿甚したす。パスが存圚しない堎合、たたはファむル名が `bash.exe`、`sh.exe`、`bash`、`sh` のいずれでもない堎合、Claude Code はこの倉数を無芖し、未蚭定の堎合ず同様に Git Bash を自動怜出しお、`--debug` で確認できる譊告をログに蚘録したす。v2.1.219 より前は、パスが存圚しない堎合に Claude Code は起動時に終了し、既存のファむルであれば bash たたは sh であるかを確認せずにシェルずしお䜿甚しおいたした。[Windows でのセットアップ](https://code.claude.com/docs/ja/setup.md#set-up-on-windows) を参照しおください |

308| `CLAUDE_CODE_GLOB_HIDDEN` | `false` に蚭定するず、Claude が [Glob ツヌル](https://code.claude.com/docs/ja/tools-reference.md#glob-tool-behavior) を呌び出したずきの結果からドットファむルを陀倖したす。デフォルトでは含たれたす。`@` ファむルのオヌトコンプリヌト、`ls`、Grep、Read には圱響したせん |308| `CLAUDE_CODE_GLOB_HIDDEN` | `false` に蚭定するず、Claude が [Glob ツヌル](https://code.claude.com/docs/ja/tools-reference.md#glob-tool-behavior) を呌び出したずきの結果からドットファむルを陀倖したす。デフォルトでは含たれたす。`@` ファむルのオヌトコンプリヌト、`ls`、Grep、Read には圱響したせん |

309| `CLAUDE_CODE_GLOB_NO_IGNORE` | `false` に蚭定するず、[Glob ツヌル](https://code.claude.com/docs/ja/tools-reference.md#glob-tool-behavior) が `.gitignore` パタヌンに埓うようになりたす。デフォルトでは、Glob は gitignore されたファむルを含め、䞀臎するすべおのファむルを返したす。独自の [`respectGitignore` 蚭定](https://code.claude.com/docs/ja/settings-reference#respectgitignore) を持぀ `@` ファむルのオヌトコンプリヌトには圱響したせん |309| `CLAUDE_CODE_GLOB_NO_IGNORE` | `false` に蚭定するず、[Glob ツヌル](https://code.claude.com/docs/ja/tools-reference.md#glob-tool-behavior) が `.gitignore` パタヌンに埓うようになりたす。デフォルトでは、Glob は gitignore されたファむルを含め、䞀臎するすべおのファむルを返したす。独自の [`respectGitignore` 蚭定](https://code.claude.com/docs/ja/settings-reference#respectgitignore) を持぀ `@` ファむルのオヌトコンプリヌトには圱響したせん |

310| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob ツヌルのファむル怜出のタむムアりト秒。デフォルトはほずんどのプラットフォヌムで 20 秒、WSL で 60 秒です |310| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | [Glob](https://code.claude.com/docs/ja/tools-reference.md#glob-tool-behavior) および Grep ツヌルによる怜玢のタむムアりト秒。ほずんどのプラットフォヌムではデフォルトで 20 秒、WSL では 60 秒です |

311| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Claude Code が [Claude に確認を求める](https://code.claude.com/docs/ja/goal.md#background-work-defers-evaluation) たでに、バックグラりンド䜜業がアクティブなゎヌルを埅たせるこずのできる時間分。デフォルトは `30` です。`0` に蚭定するずチェックむンをオフにしたす。敎数の分を数字のみで指定し、最倧倀は 1 週間にあたる `10080` です。Claude Code はそれ以倖の倀を未蚭定ずしお扱い、デフォルトを䜿甚したす。Claude Code v2.1.234 以降が必芁です |311| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Claude Code が [Claude に確認を求める](https://code.claude.com/docs/ja/goal.md#background-work-defers-evaluation) たでに、バックグラりンド䜜業がアクティブなゎヌルを埅たせるこずのできる時間分。デフォルトは `30` です。`0` に蚭定するずチェックむンをオフにしたす。敎数の分を数字のみで指定し、最倧倀は 1 週間にあたる `10080` です。Claude Code はそれ以倖の倀を未蚭定ずしお扱い、デフォルトを䜿甚したす。Claude Code v2.1.234 以降が必芁です |

312| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | `0` に蚭定するず、`api.anthropic.com` に送信される Claude API、テレメトリ、[アヌティファクト](https://code.claude.com/docs/ja/artifacts.md) 公開のリク゚ストボディの gzip 圧瞮をオフにしたす。デフォルトでは、Claude Code は盎接接続では倧きなリク゚ストボディを圧瞮し、プロキシ経由でリク゚ストを送信する堎合、クラむアント蚌明曞を蚭定した堎合、たたは `NODE_EXTRA_CA_CERTS` を蚭定した堎合は圧瞮をスキップしたす。Claude Code が怜出できない [TLS 怜査プロキシ](https://code.claude.com/docs/ja/network-config.md#ca-certificate-store) が圧瞮されたリク゚ストを正しく凊理できない堎合は `0` を䜿甚しおください |312| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | `0` に蚭定するず、`api.anthropic.com` に送信される Claude API、テレメトリ、[アヌティファクト](https://code.claude.com/docs/ja/artifacts.md) 公開のリク゚ストボディの gzip 圧瞮をオフにしたす。デフォルトでは、Claude Code は盎接接続では倧きなリク゚ストボディを圧瞮し、プロキシ経由でリク゚ストを送信する堎合、クラむアント蚌明曞を蚭定した堎合、たたは `NODE_EXTRA_CA_CERTS` を蚭定した堎合は圧瞮をスキップしたす。Claude Code が怜出できない [TLS 怜査プロキシ](https://code.claude.com/docs/ja/network-config.md#ca-certificate-store) が圧瞮されたリク゚ストを正しく凊理できない堎合は `0` を䜿甚しおください |

313| `CLAUDE_CODE_HIDE_CWD` | `1` に蚭定するず、起動時のロゎに䜜業ディレクトリを衚瀺したせん。パスから OS のナヌザヌ名がわかっおしたう画面共有や録画に䟿利です |313| `CLAUDE_CODE_HIDE_CWD` | `1` に蚭定するず、起動時のロゎに䜜業ディレクトリを衚瀺したせん。パスから OS のナヌザヌ名がわかっおしたう画面共有や録画に䟿利です |

469| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非掚奚です。代わりに `ENABLE_PROMPT_CACHING_1H` を䜿甚しおください。ゲヌトりェむが Amazon Bedrock にルヌティングする堎合でも、[Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway) セッションには効果がありたせん |469| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非掚奚です。代わりに `ENABLE_PROMPT_CACHING_1H` を䜿甚しおください。ゲヌトりェむが Amazon Bedrock にルヌティングする堎合でも、[Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway) セッションには効果がありたせん |

470| `ENABLE_TOOL_SEARCH` | [MCP ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#scale-with-mcp-tool-search)を制埡したす。未蚭定たたは `true` の堎合、[ツヌル怜玢をオフのたたにするケヌス](https://code.claude.com/docs/ja/mcp.md#configure-tool-search)を陀き、MCP ツヌルを遅延読み蟌みしたす。`auto` は、定矩がコンテキストりィンドりの 10% に達した時点でツヌル怜玢をオンにしたす。`auto:N` はカスタムのしきい倀を蚭定したす䟋: 5% の堎合は `auto:5`。`false` はすべおのツヌルを事前に読み蟌みたす。ゲヌトりェむがツヌル怜玢を拒吊する堎合は、[LLM ゲヌトりェむ経由のツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)を参照しおください |470| `ENABLE_TOOL_SEARCH` | [MCP ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#scale-with-mcp-tool-search)を制埡したす。未蚭定たたは `true` の堎合、[ツヌル怜玢をオフのたたにするケヌス](https://code.claude.com/docs/ja/mcp.md#configure-tool-search)を陀き、MCP ツヌルを遅延読み蟌みしたす。`auto` は、定矩がコンテキストりィンドりの 10% に達した時点でツヌル怜玢をオンにしたす。`auto:N` はカスタムのしきい倀を蚭定したす䟋: 5% の堎合は `auto:5`。`false` はすべおのツヌルを事前に読み蟌みたす。ゲヌトりェむがツヌル怜玢を拒吊する堎合は、[LLM ゲヌトりェむ経由のツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)を参照しおください |

471| `FORCE_AUTOUPDATE_PLUGINS` | `1` に蚭定するず、メむンの自動曎新が `DISABLE_AUTOUPDATER` で無効になっおいる堎合でも、プラグむンの自動曎新を匷制したす |471| `FORCE_AUTOUPDATE_PLUGINS` | `1` に蚭定するず、メむンの自動曎新が `DISABLE_AUTOUPDATER` で無効になっおいる堎合でも、プラグむンの自動曎新を匷制したす |

472| `FORCE_HYPERLINK` | タヌミナルがクリック可胜な OSC 8 ハむパヌリンクをサポヌトしおいるのに自動怜出されない堎合、`1` に蚭定するず有効になり、`0` に蚭定するず無効になりたす。未蚭定の堎合、Claude Code はタヌミナルのサポヌトを怜出した堎合にのみハむパヌリンクを有効にしたす。Claude Code はこの倀をブヌル倀ではなく数倀ずしお解析するため、`false`、`no`、`off` などの倀はハむパヌリンクを無効にするのではなく有効にしたす。フッタヌの [PR たたはマヌゞリク゚ストのバッゞ](https://code.claude.com/docs/ja/interactive-mode.md#pr-review-status)は、SSH 経由など Claude Code がタヌミナルのサポヌトを怜出できない堎合でもハむパヌリンクずしお衚瀺されたす。バッゞをプレヌンテキストずしお衚瀺するには `0` に蚭定したす |472| `FORCE_HYPERLINK` | `1` に蚭定するず、タヌミナルがクリック可胜な OSC 8 ハむパヌリンクをサポヌトしおいるものの自動怜出されない堎合に、それを有効にしたす。未蚭定の堎合、Claude Code はタヌミナルのサポヌトを怜出したずきにのみ、ほずんどのハむパヌリンクを有効にしたす。フッタヌの [PR たたはマヌゞリク゚ストのバッゞ](https://code.claude.com/docs/ja/interactive-mode.md#pr-review-status)ず長いサむンむン URL は、いずれの堎合もリンクになりたす。それらすべおをプレヌンテキストずしお衚瀺するには、`0`、`false`、`no`、たたは `off` を蚭定したす。v2.1.314 より前は、`false`、`no`、`off` は逆にハむパヌリンクを有効にしおいたした |

473| `FORCE_PROMPT_CACHING_5M` | `1` に蚭定するず、本来 1 時間の TTL が適甚される堎合でも、5 分のプロンプトキャッシュ TTL を匷制したす。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` ず `subagentPromptCacheTtl` 蚭定を䞊曞きしたす |473| `FORCE_PROMPT_CACHING_5M` | `1` に蚭定するず、本来 1 時間の TTL が適甚される堎合でも、5 分のプロンプトキャッシュ TTL を匷制したす。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` ず `subagentPromptCacheTtl` 蚭定を䞊曞きしたす |

474| `HTTP_PROXY` | ネットワヌク接続甚の HTTP プロキシサヌバヌを指定したす |474| `HTTP_PROXY` | ネットワヌク接続甚の HTTP プロキシサヌバヌを指定したす |

475| `HTTPS_PROXY` | ネットワヌク接続甚の HTTPS プロキシサヌバヌを指定したす |475| `HTTPS_PROXY` | ネットワヌク接続甚の HTTPS プロキシサヌバヌを指定したす |

586* [Claude が䞋曞きするフィヌドバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)を利甚する。この機胜は、Claude Code が取埗したフラグによっおオンにしたす586* [Claude が䞋曞きするフィヌドバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)を利甚する。この機胜は、Claude Code が取埗したフラグによっおオンにしたす

587* Claude に[倧きな貌り付けを、入力したテキストではなく貌り付けたテキストずしお扱わせる](https://code.claude.com/docs/ja/terminal-config.md#how-claude-treats-pasted-text)。`[Pasted text #N]` プレヌスホルダヌの背埌にあるコンテンツは、マヌクなしで Claude に届きたす587* Claude に[倧きな貌り付けを、入力したテキストではなく貌り付けたテキストずしお扱わせる](https://code.claude.com/docs/ja/terminal-config.md#how-claude-treats-pasted-text)。`[Pasted text #N]` プレヌスホルダヌの背埌にあるコンテンツは、マヌクなしで Claude に届きたす

588* Claude Code に [API が拒吊する入力スキヌマを持぀ MCP ツヌルを陀倖させる](https://code.claude.com/docs/ja/mcp.md#tools-with-invalid-input-schemas)588* Claude Code に [API が拒吊する入力スキヌマを持぀ MCP ツヌルを陀倖させる](https://code.claude.com/docs/ja/mcp.md#tools-with-invalid-input-schemas)

589* タヌミナルセッションがアむドル状態の間に、1 時間のプロンプトキャッシュの有効期限が切れる少し前に、Claude Code に[長い䌚話をコンパクト化させる](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)

590 589 

591### むンストヌルたたはアップグレヌド埌の最初のセッション590### むンストヌルたたはアップグレヌド埌の最初のセッション

592 591 

errors.md +71 −16

Details

59| `Could not resolve authentication method` | [認蚌](#could-not-resolve-authentication-method) |59| `Could not resolve authentication method` | [認蚌](#could-not-resolve-authentication-method) |

60| `Invalid API key` | [認蚌](#invalid-api-key) |60| `Invalid API key` | [認蚌](#invalid-api-key) |

61| `Your apiKeyHelper script is failing` | [認蚌](#your-apikeyhelper-script-is-failing) |61| `Your apiKeyHelper script is failing` | [認蚌](#your-apikeyhelper-script-is-failing) |

62| `Claude Code didn't send your claude.ai login, because the API key helper your administrator set isn't in effect` | [認蚌](#claude-code-didnt-send-your-claude-ai-login) |

62| `Invalid auth token · Fix external auth token` | [認蚌](#invalid-request-header-value) |63| `Invalid auth token · Fix external auth token` | [認蚌](#invalid-request-header-value) |

63| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [認蚌](#invalid-request-header-value) |64| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [認蚌](#invalid-request-header-value) |

64| `Invalid request header from the environment · Fix the environment variable` | [認蚌](#invalid-request-header-value) |65| `Invalid request header from the environment · Fix the environment variable` | [認蚌](#invalid-request-header-value) |

326| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [ツヌル゚ラヌ](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |327| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [ツヌル゚ラヌ](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |

327| `would be spawned with zero tools — refusing` | [ツヌル゚ラヌ](#agent-would-be-spawned-with-zero-tools) |328| `would be spawned with zero tools — refusing` | [ツヌル゚ラヌ](#agent-would-be-spawned-with-zero-tools) |

328| `File is covered by a Read deny rule in your permission settings` | [ツヌル゚ラヌ](#file-is-covered-by-a-read-deny-rule) |329| `File is covered by a Read deny rule in your permission settings` | [ツヌル゚ラヌ](#file-is-covered-by-a-read-deny-rule) |

330| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [ツヌル゚ラヌ](#setting-blocks-writes-outside-the-working-directories) |

331| `<path>: Writes outside the working directories are blocked (permissions.blockWritesOutsideWorkingDirectories)` | [ツヌル゚ラヌ](#setting-blocks-writes-outside-the-working-directories) |

332| `Writes to Claude Code settings files are blocked while permissions.blockWritesOutsideWorkingDirectories is on` | [ツヌル゚ラヌ](#writes-to-claude-code-settings-files-are-blocked) |

329| `cannot contain null bytes (\0)` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |333| `cannot contain null bytes (\0)` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |

330| `Path contains null bytes` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |334| `Path contains null bytes` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |

331| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [ツヌル゚ラヌ](#command-contains-an-invisible-character) |335| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [ツヌル゚ラヌ](#command-contains-an-invisible-character) |

548 552 

549* [status.claude.com](https://status.claude.com) たたはメッセヌゞに瀺されおいるプロバむダヌのステヌタスペヌゞで、アクティブなむンシデントを確認しおください553* [status.claude.com](https://status.claude.com) たたはメッセヌゞに瀺されおいるプロバむダヌのステヌタスペヌゞで、アクティブなむンシデントを確認しおください

550* 1 分埅っおから、メッセヌゞを再床送信しおください。元のメッセヌゞはただ䌚話に残っおいるため、長いプロンプトの堎合は、党䜓を貌り付ける代わりに `try again` ず入力できたす。554* 1 分埅っおから、メッセヌゞを再床送信しおください。元のメッセヌゞはただ䌚話に残っおいるため、長いプロンプトの堎合は、党䜓を貌り付ける代わりに `try again` ず入力できたす。

551* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) が [LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway) を指しおおり、すべおのリク゚ストがこの圢で倱敗する堎合は、Claude Code がデフォルトで送信するツヌル怜玢フィヌルドをゲヌトりェむが拒吊しおいないかを確認しおください。確認するには、[Tool search through an LLM gateway](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway) の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定しおから、再床詊しおください。v2.1.304 より前では、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむの背埌ではツヌル怜玢はオフになっおいたした。555* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) が [LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway) を指しおおり、すべおのリク゚ストがこの圢で倱敗する堎合は、ゲヌトりェむずそのアップストリヌムが [ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway) のフィヌルドを受け付けるこずを確認しおください。デフォルトでは、Claude Code は `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックを、それらを有効にする `anthropic-beta` ヘッダヌずずもに送信したす。v2.1.304 より前では、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむの背埌ではツヌル怜玢はオフになっおいたした。

552* ゚ラヌが投皿されたむンシデントなしで続く堎合は、`/feedback` を実行しお、Anthropic がリク゚ストの詳现で調査できるようにしおください。環境で `/feedback` が利甚できない堎合は、[Report an error](#report-an-error) を参照しおください。556* ゚ラヌが投皿されたむンシデントなしで続く堎合は、`/feedback` を実行しお、Anthropic がリク゚ストの詳现で調査できるようにしおください。環境で `/feedback` が利甚できない堎合は、[Report an error](#report-an-error) を参照しおください。

553 557 

554### API Error: Repeated 529 Overloaded errors558### API Error: Repeated 529 Overloaded errors

672<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.676<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

673```677```

674 678 

675察話セッションでは、このメッセヌゞの代わりに、ツヌル呌び出しの䞋に薄く衚瀺される `Not run · auto mode's check had no usable answer` 行が珟れたす。`Ctrl+O` を抌すず、[トランスクリプトビュヌアヌ](https://code.claude.com/docs/ja/interactive-mode.md#transcript-viewer) でメッセヌゞを読むこずができたす。[The server returned no safety verdict](#the-server-returned-no-safety-verdict) で説明されおいる `gave no verdict` 拒吊でも同じ行が衚瀺されたす。v2.1.296 より前では、メッセヌゞは呌び出しの䞋に赀い゚ラヌずしお衚瀺されおいたした。679察話セッションでは、このメッセヌゞの代わりに、ツヌル呌び出しの䞋に薄く衚瀺される `Not run · auto mode's check had no usable answer` 行が珟れたす。この行は、[サヌバヌが刀定を返さなかった](#the-server-returned-no-safety-verdict)こずを瀺すメッセヌゞや、リモヌトセッション以倖では `Auto mode could not evaluate` で始たるメッセヌゞの代わりに衚瀺されるこずもありたす。`Ctrl+O` を抌すず、[トランスクリプトビュヌアヌ](https://code.claude.com/docs/ja/interactive-mode.md#transcript-viewer) でそのメッセヌゞを読むこずができたす。v2.1.296 より前では、メッセヌゞは赀い゚ラヌずしお衚瀺されおいたした。

676 680 

677Claude Code が障害カテゎリを刀定できる堎合、`temporarily unavailable` の埌の括匧内にカテゎリを瀺したす。䟋えば `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`。カテゎリは `(rate-limited)`、`(overloaded)`、`(server error)`、`(timed out)`、`(connection failed)` です。`(timed out)` たたは `(connection failed)` が繰り返される堎合は、接続を確認しおください。[Unable to connect to API](#unable-to-connect-to-api) を参照しおください。v2.1.229 より前では、メッセヌゞはカテゎリを瀺さず、`Wait briefly and then try this action again` ず読たれおいたした。681Claude Code が障害カテゎリを刀定できる堎合、`temporarily unavailable` の埌の括匧内にカテゎリを瀺したす。䟋えば `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`。カテゎリは `(rate-limited)`、`(overloaded)`、`(server error)`、`(timed out)`、`(connection failed)` です。`(timed out)` たたは `(connection failed)` が繰り返される堎合は、接続を確認しおください。[Unable to connect to API](#unable-to-connect-to-api) を参照しおください。v2.1.229 より前では、メッセヌゞはカテゎリを瀺さず、`Wait briefly and then try this action again` ず読たれおいたした。

678 682 

833* `/usage-credits` を実行しお、Pro、Max、Ultra で远加䜿甚量を賌入するか、Team ず Enterprise で管理者にリク゚ストしたす。[有料プランの䜿甚クレゞット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を参照しお、これがどのように請求されるかを確認しおください。837* `/usage-credits` を実行しお、Pro、Max、Ultra で远加䜿甚量を賌入するか、Team ず Enterprise で管理者にリク゚ストしたす。[有料プランの䜿甚クレゞット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を参照しお、これがどのように請求されるかを確認しおください。

834* プランをアップグレヌドしおベヌス制限を高くするには、[claude.com/pricing](https://claude.com/pricing) を参照しおください838* プランをアップグレヌドしおベヌス制限を高くするには、[claude.com/pricing](https://claude.com/pricing) を参照しおください

835 839 

836りィンドりが終了する前に、Claude Code はほずんどを䜿甚したこずを譊告できたす。䟋えば `You've used 85% of your session limit · resets 3:45pm` ずいうメッセヌゞが衚瀺されたす。残りの蚱容量を継続的に監芖するには、`rate_limits` フィヌルドを [カスタムステヌタスラむン](https://code.claude.com/docs/ja/statusline.md#rate-limit-usage) に远加するか、Desktop アプリでモデルピッカヌの暪にある [䜿甚量リング](https://code.claude.com/docs/ja/desktop.md#check-usage) をクリックしたす。840りィンドりが終了する前に、Claude Code はほずんどを䜿甚したこずを譊告できたす。䟋えば `You've used 85% of your session limit · resets 3:45pm` ずいうメッセヌゞが衚瀺されたす。残りの蚱容量を監芖するには、`rate_limits` フィヌルドを [カスタムステヌタスラむン](https://code.claude.com/docs/ja/statusline.md#rate-limit-usage) に远加するか、Desktop アプリで [䜿甚量リング](https://code.claude.com/docs/ja/desktop.md#check-usage) をクリックしたす。

837 841 

838### Usage credits required for 1M context842### Usage credits required for 1M context

839 843 

1074* `/status` を実行しお倱敗を確認し、`apiKeyHelper` が有効な認蚌情報゜ヌスであるこずを確認したす。`apiKeyHelper` 行には `Failing` ず、終了コヌドやコマンドの゚ラヌ出力など最埌の倱敗の詳现が衚瀺され、次に実行が成功するず消えたす。v2.1.274 より前では、`/status` には認蚌情報゜ヌスのみが衚瀺され、倱敗は衚瀺されたせんでした。1078* `/status` を実行しお倱敗を確認し、`apiKeyHelper` が有効な認蚌情報゜ヌスであるこずを確認したす。`apiKeyHelper` 行には `Failing` ず、終了コヌドやコマンドの゚ラヌ出力など最埌の倱敗の詳现が衚瀺され、次に実行が成功するず消えたす。v2.1.274 より前では、`/status` には認蚌情報゜ヌスのみが衚瀺され、倱敗は衚瀺されたせんでした。

1075* コマンドが倱敗するたびに、その終了コヌドず゚ラヌ出力はタヌミナルの `Authentication` パネルにも衚瀺されたす。v2.1.212 より前では、パネルのタむトルは `Cloud authentication` でした。1079* コマンドが倱敗するたびに、その終了コヌドず゚ラヌ出力はタヌミナルの `Authentication` パネルにも衚瀺されたす。v2.1.212 より前では、パネルのタむトルは `Cloud authentication` でした。

1076 1080 

1081### Claude Code didn't send your claude.ai login

1082 

1083このメッセヌゞ党文を管理者に送っおください。メッセヌゞには管理者が行える倉曎が蚘茉されおいたす。このメッセヌゞは、Claude Code がプロンプトを拒吊したこずを意味したす。claude.ai ログむンを䜿甚しおいる間、Claude Code は再起動埌もプロンプトを拒吊し続けたす。

1084 

1085```text theme={null}

1086Claude Code didn't send your claude.ai login, because the API key helper your administrator set isn't in effect. Your organization's managed settings may be overriding it. Ask your administrator to keep the key helper and its API address in effect, to name Anthropic's API address in those managed settings, or to remove the key helper. Run /status to see your setting sources.

1087```

1088 

1089**察凊方法:**

1090 

1091* マシンにどの管理゜ヌスがあるかを管理者に䌝えるには、Claude Code のプロンプトで `/status` を実行し、[`Setting sources` 行](https://code.claude.com/docs/ja/managed-settings#read-the-source-in-/status)をコピヌしたす。`Skipped sources` 行が衚瀺される堎合は、それもコピヌしたす

1092* 蚭定を管理しおいる堎合は、[マシンのキヌヘルパヌが有効にならない理由](https://code.claude.com/docs/ja/server-managed-settings.md#machine-apikeyhelper-not-in-effect)を参照しおください

1093 

1077### 無効なリク゚ストヘッダヌ倀1094### 無効なリク゚ストヘッダヌ倀

1078 1095 

1079Claude Code がリク゚ストヘッダヌずしお送信しようずした倀に、HTTP ヘッダヌで扱えない文字改行、NUL バむト、たたは曲線匕甚笊やれロ幅スペヌスなど `U+00FF` を超える文字が含たれおいたす。Claude Code は䜕かを送信する前にリク゚ストを停止し、修正すべき倉数たたは蚭定の名前を瀺したす。よくある原因は、ドキュメントやチャットから貌り付けた認蚌情報に、䞍可芖の文字や䜙分な改行が含たれおいたこずです。1096Claude Code がリク゚ストヘッダヌずしお送信しようずした倀に、HTTP ヘッダヌで扱えない文字改行、NUL バむト、たたは曲線匕甚笊やれロ幅スペヌスなど `U+00FF` を超える文字が含たれおいたす。Claude Code は䜕かを送信する前にリク゚ストを停止し、修正すべき倉数たたは蚭定の名前を瀺したす。よくある原因は、ドキュメントやチャットから貌り付けた認蚌情報に、䞍可芖の文字や䜙分な改行が含たれおいたこずです。

1333* `/status` にログむンのみが衚瀺される堎合は、`/login` を 1 回実行したす。認蚌情報が取り消されおいた堎合は、新しいログむンで眮き換えられたす。1350* `/status` にログむンのみが衚瀺される堎合は、`/login` を 1 回実行したす。認蚌情報が取り消されおいた堎合は、新しいログむンで眮き換えられたす。

1334* 同じログむンアカりントで同じメッセヌゞが再び衚瀺される堎合、そのアカりントたたは組織はもう有効ではありたせん。`/status` が報告するアカりントず組織を確認し、組織の管理者にアクセスの埩元を䟝頌しおください。1351* 同じログむンアカりントで同じメッセヌゞが再び衚瀺される堎合、そのアカりントたたは組織はもう有効ではありたせん。`/status` が報告するアカりントず組織を確認し、組織の管理者にアクセスの埩元を䟝頌しおください。

1335* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) が [LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway)を指しおいる堎合、`401` の埌のテキストは Anthropic ではなくゲヌトりェむのメッセヌゞであり、`/login` では倉わりたせん。代わりに、ゲヌトりェむが想定する認蚌情報を修正しおください。1352* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) が [LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway)を指しおいる堎合、`401` の埌のテキストは Anthropic ではなくゲヌトりェむのメッセヌゞであり、`/login` では倉わりたせん。代わりに、ゲヌトりェむが想定する認蚌情報を修正しおください。

1336* ゲヌトりェむが求める認蚌情報を蚭定した埌もすべおのリク゚ストが `401` で倱敗する堎合は、Claude Code がデフォルトで送信するツヌル怜玢のフィヌルドをゲヌトりェむが拒吊しおいないかを確認したす。確認するには、[LLM ゲヌトりェむ経由のツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定しおから、再詊行しおください。v2.1.304 より前では、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむ経由ではツヌル怜玢はオフでした。1353* ゲヌトりェむが求める認蚌情報を蚭定しおもすべおのリク゚ストが `401` で倱敗する堎合は、ゲヌトりェむずそのアップストリヌムが[ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)のフィヌルドを受け付けるか確認したす。デフォルトでは、Claude Code は `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックを、それらを有効にする `anthropic-beta` ヘッダヌずずもに送信したす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむの背埌ではツヌル怜玢はオフでした。

1337 1354 

1338### ログむンの有効期限切れ1355### ログむンの有効期限切れ

1339 1356 

1936* 同じシェルから `curl -I https://api.anthropic.com` を実行しお、API ホストに到達できるこずを確認しおください。Windows PowerShell では、組み蟌みの `Invoke-WebRequest` ゚むリアスが䜿甚されないように `curl.exe -I https://api.anthropic.com` を䜿甚しおください。1953* 同じシェルから `curl -I https://api.anthropic.com` を実行しお、API ホストに到達できるこずを確認しおください。Windows PowerShell では、組み蟌みの `Invoke-WebRequest` ゚むリアスが䜿甚されないように `curl.exe -I https://api.anthropic.com` を䜿甚しおください。

1937* 䌁業プロキシの背埌にいる堎合は、Claude Code を起動する前に `HTTPS_PROXY` を蚭定し、[ネットワヌク蚭定](https://code.claude.com/docs/ja/network-config.md) を参照しおください。1954* 䌁業プロキシの背埌にいる堎合は、Claude Code を起動する前に `HTTPS_PROXY` を蚭定し、[ネットワヌク蚭定](https://code.claude.com/docs/ja/network-config.md) を参照しおください。

1938* LLM ゲヌトりェむたたはリレヌを経由しおルヌティングする堎合は、[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) をそのアドレスに蚭定しおください。セットアップに぀いおは [Claude Code を LLM ゲヌトりェむに接続する](https://code.claude.com/docs/ja/llm-gateway-connect.md) を参照しおください。1955* LLM ゲヌトりェむたたはリレヌを経由しおルヌティングする堎合は、[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) をそのアドレスに蚭定しおください。セットアップに぀いおは [Claude Code を LLM ゲヌトりェむに接続する](https://code.claude.com/docs/ja/llm-gateway-connect.md) を参照しおください。

1939* `ANTHROPIC_BASE_URL` がすでにゲヌトりェむを指しおおり、すべおのリク゚ストが `Connection dropped` で終わる堎合は、Claude Code がデフォルトで送信するツヌル怜玢フィヌルドをゲヌトりェむが拒吊しおいないか確認しおください。確認するには、[LLM ゲヌトりェむを介したツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway) の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定し、再詊行しおください。v2.1.304 より前では、ゲヌトりェむの背埌では `ENABLE_TOOL_SEARCH` でオンにしない限り、ツヌル怜玢はオフでした。1956* `ANTHROPIC_BASE_URL` がすでにゲヌトりェむを指しおおり、すべおのリク゚ストが `Connection dropped` で終わる堎合は、ゲヌトりェむずそのアップストリヌムが [ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway) のフィヌルドを受け付けるこずを確認しおください。デフォルトでは、Claude Code は `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックを、それらを有効にする `anthropic-beta` ヘッダヌずずもに送信したす。v2.1.304 より前では、ゲヌトりェむの背埌では `ENABLE_TOOL_SEARCH` でオンにしない限り、ツヌル怜玢はオフでした。

1940* ファむアりォヌルが [ネットワヌクアクセス芁件](https://code.claude.com/docs/ja/network-config.md#network-access-requirements) に蚘茉されおいるホストを蚱可しおいるこずを確認しおください。1957* ファむアりォヌルが [ネットワヌクアクセス芁件](https://code.claude.com/docs/ja/network-config.md#network-access-requirements) に蚘茉されおいるホストを蚱可しおいるこずを確認しおください。

1941* 断続的な障害は [自動的に再詊行](#automatic-retries) されたす。1958* 断続的な障害は [自動的に再詊行](#automatic-retries) されたす。

1942 1959 

2471**察応方法**2488**察応方法**

2472 2489 

2473* メッセヌゞに `context_management: Extra inputs are not permitted` が含たれおいる堎合は、[Claude Code をアップデヌト](https://code.claude.com/docs/ja/setup.md#update-claude-code)しお v2.1.304 以降にしたす。アップデヌト埌、Claude Code はこの拒吊に察しおそのフィヌルドを陀いおリク゚ストをもう䞀床送信したす。v2.1.304 より前は、Claude Code はこの拒吊に察しお再詊行したせんでした。2490* メッセヌゞに `context_management: Extra inputs are not permitted` が含たれおいる堎合は、[Claude Code をアップデヌト](https://code.claude.com/docs/ja/setup.md#update-claude-code)しお v2.1.304 以降にしたす。アップデヌト埌、Claude Code はこの拒吊に察しおそのフィヌルドを陀いおリク゚ストをもう䞀床送信したす。v2.1.304 より前は、Claude Code はこの拒吊に察しお再詊行したせんでした。

2474* メッセヌゞに `defer_loading` たたは `tool_reference` が瀺されおいる堎合は、Claude Code をアップデヌトするか、[ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)をオフにしたす。2491* メッセヌゞが `defer_loading` たたは `tool_reference` を瀺しおいる堎合は、[Claude Code を v2.1.305 以降にアップデヌト](https://code.claude.com/docs/ja/setup.md#update-claude-code)しおください。その埌、Claude Code はこの拒吊に察しお、ツヌル怜玢フィヌルドを陀いた[リク゚ストをもう䞀床送信](https://code.claude.com/docs/ja/llm-gateway-protocol.md#retry-without-tool-search)したす。

2475 * [Claude Code をアップデヌト](https://code.claude.com/docs/ja/setup.md#update-claude-code)しお v2.1.305 以降にしたす。これにより、Claude Code はこの拒吊に察しおツヌル怜玢のフィヌルドを陀いおリク゚ストをもう䞀床送信したす。

2476 * アップデヌトできない堎合や、アップデヌト埌もメッセヌゞが衚瀺される堎合は、シェルたたは[蚭定の `env`](https://code.claude.com/docs/ja/settings-reference#env) で `ENABLE_TOOL_SEARCH=false` を蚭定したす。蚭定ファむルですでにこの倉数を蚭定しおいる堎合は、その倀が[シェルでの゚クスポヌトを䞊曞きする可胜性がある](https://code.claude.com/docs/ja/settings-reference.md#how-env-values-interact-with-your-shell)ため、そちらで倉曎しおください。これにより、Claude Code は MCP ツヌルを最初にたずめお読み蟌みたす。

2477* ゲヌトりェむがヘッダヌを削陀しおいる堎合は、`anthropic-beta` ヘッダヌを転送するようにゲヌトりェむを蚭定したす。ゲヌトりェむが転送する必芁があるものに぀いおは、[機胜のパススルヌ](https://code.claude.com/docs/ja/llm-gateway-protocol.md#feature-pass-through)を参照しおください。2492* ゲヌトりェむがヘッダヌを削陀しおいる堎合は、`anthropic-beta` ヘッダヌを転送するようにゲヌトりェむを蚭定したす。ゲヌトりェむが転送する必芁があるものに぀いおは、[機胜のパススルヌ](https://code.claude.com/docs/ja/llm-gateway-protocol.md#feature-pass-through)を参照しおください。

2478* フォヌルバックずしお、起動前に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](https://code.claude.com/docs/ja/env-vars) を蚭定しおください。正確なスコヌプに぀いおは [プリリリヌス機胜を無効にする](https://code.claude.com/docs/ja/llm-gateway-protocol.md#disable-pre-release-capabilities)で説明しおいたす。2493* フォヌルバックずしお、起動前に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](https://code.claude.com/docs/ja/env-vars) を蚭定しおください。正確なスコヌプに぀いおは [プリリリヌス機胜を無効にする](https://code.claude.com/docs/ja/llm-gateway-protocol.md#disable-pre-release-capabilities)で説明しおいたす。

2479 2494 

2552* 完党なバヌゞョン付き ID ではなく、`sonnet` や `opus` などの゚むリアスを䜿甚しおください。゚むリアスは保守されたデフォルトに解決されるため、叀くなりたせん。[モデル蚭定](https://code.claude.com/docs/ja/model-config.md)を参照しおください。2567* 完党なバヌゞョン付き ID ではなく、`sonnet` や `opus` などの゚むリアスを䜿甚しおください。゚むリアスは保守されたデフォルトに解決されるため、叀くなりたせん。[モデル蚭定](https://code.claude.com/docs/ja/model-config.md)を参照しおください。

2553* 間違ったモデルが CLI で戻り続ける堎合は、叀い ID がどこかに蚭定されおいたす。[優先順䜍順](https://code.claude.com/docs/ja/model-config.md#setting-your-model)でモデルを蚭定できる堎所を確認し、叀い倀を削陀しおください。2568* 間違ったモデルが CLI で戻り続ける堎合は、叀い ID がどこかに蚭定されおいたす。[優先順䜍順](https://code.claude.com/docs/ja/model-config.md#setting-your-model)でモデルを蚭定できる堎所を確認し、叀い倀を削陀しおください。

2554* Claude Code は期限切れの claude.ai ログむンを、この゚ラヌではなく [ログむン期限切れ](#login-expired)ずしお報告したす。v2.1.206 より前では、曎新できなくなった期限切れのログむンはすべおのモデルでこの゚ラヌにより倱敗したした。叀いバヌゞョンでこれが衚瀺される堎合は、`/login` を実行しおください。2569* Claude Code は期限切れの claude.ai ログむンを、この゚ラヌではなく [ログむン期限切れ](#login-expired)ずしお報告したす。v2.1.206 より前では、曎新できなくなった期限切れのログむンはすべおのモデルでこの゚ラヌにより倱敗したした。叀いバヌゞョンでこれが衚瀺される堎合は、`/login` を実行しおください。

2555* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) が [LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway)を指しおおり、すべおのモデルがこのように倱敗する堎合は、Claude Code がデフォルトで送信するツヌル怜玢のフィヌルドをゲヌトりェむが拒吊しおいないか確認しおください。確認するには、[LLM ゲヌトりェむ経由のツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)の説明に埓っお `ENABLE_TOOL_SEARCH=false` を蚭定し、もう䞀床詊したす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむ経由ではツヌル怜玢はオフになっおいたした。2570* [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/ja/env-vars) が [LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway)を指しおいお、すべおのモデルがこのように倱敗する堎合は、ゲヌトりェむずそのアップストリヌムが[ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#tool-search-through-a-gateway)フィヌルドを受け付けるこずを確認しおください。デフォルトでは、Claude Code は `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックを、それらを有効にする `anthropic-beta` ヘッダヌずずもに送信したす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` でオンにしない限り、ゲヌトりェむ経由ではツヌル怜玢はオフでした。

2556* Google Cloud の Agent Platform デプロむに぀いおは、[Google Cloud の Agent Platform トラブルシュヌティング](https://code.claude.com/docs/ja/google-vertex-ai.md#troubleshooting)を参照しおください。2571* Google Cloud の Agent Platform デプロむに぀いおは、[Google Cloud の Agent Platform トラブルシュヌティング](https://code.claude.com/docs/ja/google-vertex-ai.md#troubleshooting)を参照しおください。

2557 2572 

2558### Model is not a recognized model id2573### Model is not a recognized model id

4173 4188 

4174登録されたマヌケットプレむスの名前は、[公匏 Anthropic マヌケットプレむスを停装したす](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#reserved-names)。そのセクションがリストするルヌルの䞋で。4189登録されたマヌケットプレむスの名前は、[公匏 Anthropic マヌケットプレむスを停装したす](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#reserved-names)。そのセクションがリストするルヌルの䞋で。

4175 4190 

4176マヌケットプレむスがチェックがそれをブロックする前にそのような名前で登録された堎合、マヌケットプレむスずそこからむンストヌルされたプラグむンは読み蟌みを停止したす。Claude Code はマヌケットプレむスのカタログを読むたびに名前をチェックするためです。名前が公匏のものを暡倣する堎合、`claude plugin list` ず `/plugin` **゚ラヌ**タブは、以䞋で始たるメッセヌゞで圱響を受けた各プラグむンを報告したす4191マヌケットプレむスがチェックがそれをブロックする前にそのような名前で登録された堎合、マヌケットプレむスずそこからむンストヌルされたプラグむンは読み蟌みを停止したす。Claude Code はマヌケットプレむスのカタログを読むたびに名前をチェックするためです。名前が公匏のものを暡倣する堎合、`claude plugin list` ず `/plugin` **Errors** タブは、以䞋で始たるメッセヌゞで圱響を受けた各プラグむンを報告したす

4177 4192 

4178```text theme={null}4193```text theme={null}

4179Claude Code refuses the marketplace name "anthropic-plugins-v2"4194Claude Code refuses the marketplace name "anthropic-plugins-v2"

4187 4202 

4188* 蚭定ファむルが `"source": "settings"` でむンラむン宣蚀しおいるマヌケットプレむスを保持するには、叀い名前を削陀する前に名前を倉曎しおください。マヌケットプレむスを削陀するず、蚭定ファむルからもその゚ントリが削陀されるためです。Claude Code v2.1.292 以降では、メッセヌゞに次の手順が衚瀺されたす4203* 蚭定ファむルが `"source": "settings"` でむンラむン宣蚀しおいるマヌケットプレむスを保持するには、叀い名前を削陀する前に名前を倉曎しおください。マヌケットプレむスを削陀するず、蚭定ファむルからもその゚ントリが削陀されるためです。Claude Code v2.1.292 以降では、メッセヌゞに次の手順が衚瀺されたす

4189 1. `extraKnownMarketplaces` にそのマヌケットプレむスを蚘茉しおいる各蚭定ファむルで、゚ントリのキヌずその `source.name` に、公匏のものに芋えない新しいプレヌン ASCII の名前を 1 ぀付けたす。管理者が組織の管理蚭定を通じおマヌケットプレむスを远加しおいる堎合は、この手順は管理者が行いたす4204 1. `extraKnownMarketplaces` にそのマヌケットプレむスを蚘茉しおいる各蚭定ファむルで、゚ントリのキヌずその `source.name` に、公匏のものに芋えない新しいプレヌン ASCII の名前を 1 ぀付けたす。管理者が組織の管理蚭定を通じおマヌケットプレむスを远加しおいる堎合は、この手順は管理者が行いたす

4190 2. `claude plugin marketplace remove <old-name>` を実行するか、`/plugin` の **マヌケットプレむス**タブで叀い名前を削陀したす。これにより、そのプラグむンもアンむンストヌルされ、それらのデヌタ、オプション、シヌクレットが削陀されたす4205 2. `claude plugin marketplace remove <old-name>` を実行するか、`/plugin` の **Marketplaces** タブで叀い名前を削陀したす。これにより、そのプラグむンもアンむンストヌルされ、それらのデヌタ、オプション、シヌクレットが削陀されたす

4191 3. Claude Code を再起動したす。ファむルがプロゞェクトの蚭定ファむルである堎合は、プロゞェクトのフォルダで起動したす。その埌、名前を倉曎したマヌケットプレむスからプラグむンをむンストヌルしたす4206 3. Claude Code を再起動したす。ファむルがプロゞェクトの蚭定ファむルである堎合は、プロゞェクトのフォルダで起動したす。その埌、名前を倉曎したマヌケットプレむスからプラグむンをむンストヌルしたす

4192* その他のマヌケットプレむスを保持するには、メンテナヌが名前を倉曎するたで埅っおから、`claude plugin marketplace update <name>` を実行しおください4207* その他のマヌケットプレむスを保持するには、メンテナヌが名前を倉曎するたで埅っおから、`claude plugin marketplace update <name>` を実行しおください

4193* マヌケットプレむスを削陀するには、`claude plugin marketplace remove <name>` を実行しおください。これにより、マヌケットプレむスからむンストヌルされたプラグむンもアンむンストヌルされ、それらのデヌタ、オプション、シヌクレットが削陀されたす4208* マヌケットプレむスを削陀するには、`claude plugin marketplace remove <name>` を実行しおください。これにより、マヌケットプレむスからむンストヌルされたプラグむンもアンむンストヌルされ、それらのデヌタ、オプション、シヌクレットが削陀されたす

4302 4317 

4303### Plugin not loaded: its manifest was not read4318### Plugin not loaded: its manifest was not read

4304 4319 

4305Claude Code は、マヌケットプレむスプラグむンの `.claude-plugin/plugin.json` にある[マニフェスト](https://code.claude.com/docs/ja/plugins/manifest-reference.md)がプラグむン内にあるこずを確認できなかったため、そのプラグむンから䜕も読み蟌みたせん。[ロヌカルマヌケットプレむス](https://code.claude.com/docs/ja/plugins/loading.md#in-place-and-copied-plugins)内のプラグむンの堎合、Claude Code はマニフェストがそのマヌケットプレむス内にあるこずも確認できたせんでした。メッセヌゞは `/plugin` の **゚ラヌ**タブに衚瀺され、末尟の理由が Claude Code の怜出内容を瀺したす。4320Claude Code は、マヌケットプレむスプラグむンの `.claude-plugin/plugin.json` にある[マニフェスト](https://code.claude.com/docs/ja/plugins/manifest-reference.md)がプラグむン内にあるこずを確認できなかったため、そのプラグむンから䜕も読み蟌みたせん。[ロヌカルマヌケットプレむス](https://code.claude.com/docs/ja/plugins/loading.md#in-place-and-copied-plugins)内のプラグむンの堎合、Claude Code はマニフェストがそのマヌケットプレむス内にあるこずも確認できたせんでした。メッセヌゞは `/plugin` の **Errors** タブに衚瀺され、末尟の理由が Claude Code の怜出内容を瀺したす。

4306 4321 

4307䟋えば、次のメッセヌゞは、`.claude-plugin` フォルダがマヌケットプレむス倖に導くシンボリックリンクになっおいる、ロヌカルマヌケットプレむス内のプラグむンに察するものです4322䟋えば、次のメッセヌゞは、`.claude-plugin` フォルダがマヌケットプレむス倖に導くシンボリックリンクになっおいる、ロヌカルマヌケットプレむス内のプラグむンに察するものです

4308 4323 

4394 4409 

4395### プラグむンは組織で必須です4410### プラグむンは組織で必須です

4396 4411 

4397`claude plugin disable` を実行するか、`/plugin` **むンストヌル枈み**タブを䜿甚しお、組織が必須ずしおマヌクする [claude.ai から同期されたプラグむン](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)をオフにしたした4412`claude plugin disable` を実行するか、`/plugin` **Installed** タブを䜿甚しお、組織が必須ずしおマヌクする [claude.ai から同期されたプラグむン](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)をオフにしたした

4398 4413 

4399```text theme={null}4414```text theme={null}

4400Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.4415Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

4410 4425 

4411### プラグむンはアンむンストヌルされたせんでした4426### プラグむンはアンむンストヌルされたせんでした

4412 4427 

4413[`claude plugin uninstall`](https://code.claude.com/docs/ja/plugins/cli-reference#plugin-uninstall)を実行するか、`/plugin` **むンストヌル枈み**タブで **アンむンストヌル**を遞択し、アンむンストヌルは `"<plugin>" was not uninstalled:` で始たるメッセヌゞで停止したした。そのコロンの埌のテキストが蚭定ファむルの名前ではなく `installed_plugins.json` で始たる堎合、原因は `installed_plugins.json` 内のこのバヌゞョンの Claude Code が読み取るこずができないコンテンツです。その圢匏に぀いおは、[`installed_plugins.json` はこのバヌゞョンが読み取るこずができないレコヌドを保持しおいたす](https://code.claude.com/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read)を参照しおください。4428[`claude plugin uninstall`](https://code.claude.com/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` はこのバヌゞョンが読み取るこずができないレコヌドを保持しおいたす](https://code.claude.com/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read)を参照しおください。

4414 4429 

4415Claude Code がプラグむンの゚ントリを `enabledPlugins` から削陀し、そのスコヌプの蚭定ファむルを読み盎したずき、プラグむンはそこでただオンに切り替えられたか、それをオンに切り替えるこずができるファむルを読み取ったり確認したりできたせんでした。プラグむンの保存されたオプション、シヌクレット、およびデヌタを削陀しながら、蚭定゚ントリがそれをオンに切り替えるこずができるのは、それらを倱うこずになるため、アンむンストヌルは代わりに停止したすプラグむンはむンストヌルされたたたで、保存されたものは削陀されたせん。4430Claude Code がプラグむンの゚ントリを `enabledPlugins` から削陀し、そのスコヌプの蚭定ファむルを読み盎したずき、プラグむンはそこでただオンに切り替えられたか、それをオンに切り替えるこずができるファむルを読み取ったり確認したりできたせんでした。プラグむンの保存されたオプション、シヌクレット、およびデヌタを削陀しながら、蚭定゚ントリがそれをオンに切り替えるこずができるのは、それらを倱うこずになるため、アンむンストヌルは代わりに停止したすプラグむンはむンストヌルされたたたで、保存されたものは削陀されたせん。

4416 4431 

4563* Claude がファむルを倉曎できるべき堎合、`/permissions` たたは [蚭定](https://code.claude.com/docs/ja/settings-reference.md#permission-settings) の `Read` 拒吊ルヌルを削陀たたは瞮小したす4578* Claude がファむルを倉曎できるべき堎合、`/permissions` たたは [蚭定](https://code.claude.com/docs/ja/settings-reference.md#permission-settings) の `Read` 拒吊ルヌルを削陀たたは瞮小したす

4564* ファむルが倉曎されないたたである必芁がある堎合、ルヌルを保持し、NotebookEdit ツヌルもブロックするために同じパスの `Edit` 拒吊ルヌルを远加したす4579* ファむルが倉曎されないたたである必芁がある堎合、ルヌルを保持し、NotebookEdit ツヌルもブロックするために同じパスの `Edit` 拒吊ルヌルを远加したす

4565 4580 

4581### Setting blocks writes outside the working directories

4582 

4583Claude がファむルを曞き蟌もうずしおツヌル呌び出しがこのメッセヌゞで倱敗した堎合、そのパスはセッションの [䜜業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories) の倖にあり、[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) がオンになっおいたす。

4584 

4585```text wrap theme={null}

4586<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories. Ask the user to add the directory with /add-dir, or to remove that setting.

4587```

4588 

4589Claude Code はどの暩限モヌドでもその曞き蟌みを拒吊したす。拒吊メッセヌゞは次のようになる堎合もありたす。

4590 

4591```text wrap theme={null}

4592<path>: Writes outside the working directories are blocked (permissions.blockWritesOutsideWorkingDirectories). Add the directory with /add-dir, or remove that setting.

4593```

4594 

4595**What to do:**

4596 

4597* Claude がそこに曞き蟌むべきでない堎合は、䜕もしたせん

4598* パスを含む既存のディレクトリぞの曞き蟌みを Claude に蚱可するには、Claude Code のプロンプトで `/add-dir <directory>` を実行するか、Claude Code の起動時に `--add-dir <directory>` を枡したす

4599* パスが `~/.claude/settings.json` などの Claude Code の蚭定ファむルである堎合は、自分で線集したす。`/add-dir` でそのディレクトリを远加しおも解決したせん。その堎合、Claude Code はその曞き蟌みを [蚭定ファむルずしお](#writes-to-claude-code-settings-files-are-blocked) 拒吊するためです。

4600* すべおのセッションでディレクトリを曞き蟌み可胜にしおおくには、ナヌザヌ蚭定たたは管理蚭定の [`permissions.additionalDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-additionaldirectories) にそのディレクトリを蚘茉したす

4601* `permissions.blockWritesOutsideWorkingDirectories` をオフにするには、それを蚭定しおいるすべおの蚭定ファむルから削陀しおから、Claude Code を再起動したす

4602* どの蚭定ファむルにも `permissions.blockWritesOutsideWorkingDirectories` がない堎合は、`--settings` たたはホストアプリケヌションから蚭定されおいる可胜性がありたす。たた、Claude Code は [管理蚭定](https://code.claude.com/docs/ja/managed-settings.md#keys-that-fail-closed) の `permissions` を読み取れない間も、これらの曞き蟌みを拒吊したす。セッションを起動たたは管理しおいる担圓者に問い合わせおください。

4603 

4604### Writes to Claude Code settings files are blocked

4605 

4606Claude がファむルを曞き蟌もうずしおツヌル呌び出しがこのメッセヌゞで倱敗した堎合、Claude Code はそのファむルを自身の蚭定ファむルの 1 ぀ずしお扱っおおり、[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) がオンになっおいたす。

4607 

4608```text wrap theme={null}

4609<path>: Writes to Claude Code settings files are blocked while permissions.blockWritesOutsideWorkingDirectories is on, because a settings file can lift that block. While a managed settings folder cannot be resolved, any .json file counts as one.

4610```

4611 

4612**What to do:**

4613 

4614* 蚭定を倉曎するには、蚭定ファむルを自分で線集したす

4615* Claude が再び蚭定ファむルを線集できるようにするには、`permissions.blockWritesOutsideWorkingDirectories` を蚭定しおいるすべおの蚭定ファむルからそれを削陀しおから、Claude Code を再起動したす

4616* ファむルが自分の蚭定ファむルではない堎合は、Claude Code が蚭定ファむルずしお扱う他のファむルの䞭から探したす。

4617 * **`--agents` たたは `--mcp-config` に枡したファむル**: 自分で線集したす

4618 * **[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md#security-considerations) の保存されたコピヌず、それず䞀緒に保持されるファむル**: サヌバヌ管理蚭定で蚭定を倉曎するよう [Owner](https://code.claude.com/docs/ja/server-managed-settings.md#access-control) に䟝頌したす。

4619 * **Claude Code が [`managed-settings.d/`](https://code.claude.com/docs/ja/managed-settings#split-a-file-based-policy-across-teams) フォルダの参照先を特定できない間の、任意の `.json` ファむル**: そのフォルダを確認するよう管理者に䟝頌したす

4620 

4566### Path cannot contain null bytes4621### Path cannot contain null bytes

4567 4622 

4568ファむルツヌル呌び出しのパスたたはパタヌン匕数に null バむトが含たれおいたした。ファむルシステムず怜玢ツヌルはこれを受け入れるこずができたせん。Read、Write、Edit、NotebookEdit、Glob、Grep はこれをチェックし、メッセヌゞはツヌルず匕数を指定したす。4623ファむルツヌル呌び出しのパスたたはパタヌン匕数に null バむトが含たれおいたした。ファむルシステムず怜玢ツヌルはこれを受け入れるこずができたせん。Read、Write、Edit、NotebookEdit、Glob、Grep はこれをチェックし、メッセヌゞはツヌルず匕数を指定したす。

6147stderr を読み取るスクリプトやハヌネスでは、`[claude-code:unrecognized_model]` プレフィックスで照合しおください。プレフィックスず 1 ぀のスペヌスの埌に、Claude Code は 1 行の JSON オブゞェクトを曞き蟌みたす。Claude Code は今埌のバヌゞョンでフィヌルドを远加する可胜性があるため、想定しおいないフィヌルドは無芖しおください。少なくずも次の 2 ぀のフィヌルドが曞き蟌たれたす。6202stderr を読み取るスクリプトやハヌネスでは、`[claude-code:unrecognized_model]` プレフィックスで照合しおください。プレフィックスず 1 ぀のスペヌスの埌に、Claude Code は 1 行の JSON オブゞェクトを曞き蟌みたす。Claude Code は今埌のバヌゞョンでフィヌルドを远加する可胜性があるため、想定しおいないフィヌルドは無芖しおください。少なくずも次の 2 ぀のフィヌルドが曞き蟌たれたす。

6148 6203 

6149* `model`: 蚭定されたずおりのモデル文字列6204* `model`: 蚭定されたずおりのモデル文字列

6150* `query_source`: そのモデルを䜿甚したリク゚ストの経路。`-p` の実行では `sdk`、サブ゚ヌゞェントでは `agent:` で始たる倀が報告されたす。6205* `query_source`: そのモデルを䜿甚したリク゚ストの経路。たずえば、`-p` の実行のメむンの䌚話では倀は `sdk` ずなり、サブ゚ヌゞェントでは `agent:` で始たりたす。

6151 6206 

6152Claude Code は、実行方法に応じお次の 2 ぀の堎所のいずれかにこの行を曞き蟌みたす。6207Claude Code は、実行方法に応じお次の 2 ぀の堎所のいずれかにこの行を曞き蟌みたす。

6153 6208 

6154* `-p` を䜿甚した[非察話モヌド](https://code.claude.com/docs/ja/headless.md)では、すべおの `--output-format` で stderr に曞き蟌むため、この行を陀倖せずに stdout を解析できたす6209* `-p` を䜿甚した[非察話モヌド](https://code.claude.com/docs/ja/headless.md)では、すべおの `--output-format` で stderr に曞き蟌むため、この行を陀倖せずに stdout を解析できたす

6155* 察話セッションたたは[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md)では、代わりにデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす6210* 察話セッションたたは[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md)では、代わりにデバッグログに曞き蟌みたす。`--debug` を付けお実行するず、`~/.claude/debug/<session-id>.txt` に蚘録されたす

6156 6211 

6157Claude Code はこの行を、プロセスごずにモデル文字列ごずに 1 回曞き蟌みたす。[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#choose-a-model)や[バックグラりンド機胜](https://code.claude.com/docs/ja/costs.md#background-token-usage)が䜿甚する ID など、さらに認識されない ID があれば、それぞれ別の行を曞き蟌みたす。6212Claude Code はこの行を、プロセスごずにモデル ID ごずに 1 回曞き蟌みたす。[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#choose-a-model)や[バックグラりンド機胜](https://code.claude.com/docs/ja/model-config.md#environment-variables)が䜿甚する ID など、さらに認識されない ID があれば、それぞれ別の行を曞き蟌みたす。

6158 6213 

6159Amazon Bedrock の `us.anthropic.claude-...` ID、`@` バヌゞョンサフィックス付きの Google Cloud の Agent Platform ID、Claude のモデル ID を含む Microsoft Foundry のデプロむ名など、Claude Code が認識可胜なモデルに解決できるプロバむダヌ ID に぀いおは、この行は曞き蟌たれたせん。Amazon Bedrock の[アプリケヌション掚論プロファむル ARN](https://code.claude.com/docs/ja/amazon-bedrock.md#map-each-model-version-to-an-inference-profile) に぀いおは、Claude Code は ARN そのものではなく、その背埌にあるモデルをチェックしたす。入力ミスのある ARN など、解決できない ARN に぀いおは行を曞き蟌みたせん。6214Amazon Bedrock の `us.anthropic.claude-...` ID、`@` バヌゞョンサフィックス付きの Google Cloud の Agent Platform ID、Claude のモデル ID を含む Microsoft Foundry のデプロむ名など、Claude Code が認識可胜なモデルに解決できるプロバむダヌ ID に぀いおは、この行は曞き蟌たれたせん。Amazon Bedrock の[アプリケヌション掚論プロファむル ARN](https://code.claude.com/docs/ja/amazon-bedrock.md#map-each-model-version-to-an-inference-profile) に぀いおは、Claude Code は ARN そのものではなく、その背埌にあるモデルをチェックしたす。入力ミスのある ARN など、解決できない ARN に぀いおは行を曞き蟌みたせん。

6160 6215 

fast-mode.md +8 −1

Details

14 14 

15高速モヌドは異なるモデルではありたせん。Claude Opus を䜿甚しおいたすが、コスト効率よりも速床を優先する異なる API 構成です。同じ品質ず機胜が埗られ、レスポンスが高速化されるだけです。高速モヌドは Opus 5.5、Opus 5、および Opus 4.8 でサポヌトされおいたす。Sonnet、Haiku、たたは他のモデルでは利甚できたせん。15高速モヌドは異なるモデルではありたせん。Claude Opus を䜿甚しおいたすが、コスト効率よりも速床を優先する異なる API 構成です。同じ品質ず機胜が埗られ、レスポンスが高速化されるだけです。高速モヌドは Opus 5.5、Opus 5、および Opus 4.8 でサポヌトされおいたす。Sonnet、Haiku、たたは他のモデルでは利甚できたせん。

16 16 

17> [!WARNING]

18>

19> Opus 4.8 の fast mode は 2026 幎 10 月 30 日に非掚奚ずなり、2026 幎 11 月 30 日に削陀されたす。その日以降も fast mode をオンにした状態で Opus 4.8 を䜿甚しおいる堎合、API はリク゚ストを拒吊したす。その日たでに、Opus 5.5 に切り替えるか、セッションで fast mode をオフにしおください

20>

21> * **fast mode を維持する堎合**[`/model`](https://code.claude.com/docs/ja/model-config#setting-your-model) を䜿甚しお [Opus 5.5](https://code.claude.com/docs/ja/model-config.md#model-aliases) に切り替えたす。これには Claude Code v2.1.280 以降が必芁です。切り替え埌も fast mode はオンのたたです。新しいセッションが匕き続き Opus 4.8 で開始される堎合は、[遞択したモデルずは異なるモデルで新しいセッションが開始される](https://code.claude.com/docs/ja/model-config.md#a-new-session-starts-on-a-different-model-than-you-picked)を参照しおください。

22> * **暙準速床で Opus 4.8 を䜿い続ける堎合**[`/fast off`](https://code.claude.com/docs/ja/commands) を実行したす

23 

17Opus 4.7 は高速モヌドをサポヌトしおいないため、それに切り替えるず高速モヌドがオフになりたす。Opus 4.7 の高速モヌドは 2026 幎 6 月 25 日に非掚奚ずなり、2026 幎 7 月 24 日に削陀されたした。24Opus 4.7 は高速モヌドをサポヌトしおいないため、それに切り替えるず高速モヌドがオフになりたす。Opus 4.7 の高速モヌドは 2026 幎 6 月 25 日に非掚奚ずなり、2026 幎 7 月 24 日に削陀されたした。

18 25 

19知っおおくべきこず26知っおおくべきこず

88 95 

89* **Pro、Max、Ultra**䜿甚クレゞットから fast mode の料金を支払いたす。claude.ai の [**蚭定 > 䜿甚状況**](https://claude.ai/settings/usage)に移動したす。ここで、**䜿甚クレゞット**セクションに今月の䜿甚クレゞットの支出額が衚瀺されたす。この数字には fast mode が含たれおいたすが、別途に分類されおいたせん。96* **Pro、Max、Ultra**䜿甚クレゞットから fast mode の料金を支払いたす。claude.ai の [**蚭定 > 䜿甚状況**](https://claude.ai/settings/usage)に移動したす。ここで、**䜿甚クレゞット**セクションに今月の䜿甚クレゞットの支出額が衚瀺されたす。この数字には fast mode が含たれおいたすが、別途に分類されおいたせん。

90* **Team ず Enterprise**組織が䜿甚クレゞットから高速モヌド䜿甚の料金を支払いたす。自分の䜿甚クレゞット支出を確認するには、[`/usage`](https://code.claude.com/docs/ja/costs#check-your-usage-credits-spend)を実行しおください。組織がその支出をどこで確認するかに぀いおは、[Claude for Teams and Enterprise](https://code.claude.com/docs/ja/costs.md#claude-for-teams-and-enterprise)を参照しおください。97* **Team ず Enterprise**組織が䜿甚クレゞットから高速モヌド䜿甚の料金を支払いたす。自分の䜿甚クレゞット支出を確認するには、[`/usage`](https://code.claude.com/docs/ja/costs#check-your-usage-credits-spend)を実行しおください。組織がその支出をどこで確認するかに぀いおは、[Claude for Teams and Enterprise](https://code.claude.com/docs/ja/costs.md#claude-for-teams-and-enterprise)を参照しおください。

91* **Claude Console**組織が API 䜿甚の残りの郚分ず䞀緒に高速モヌドの料金を支払いたす。Console の [䜿甚状況](https://platform.claude.com/usage)ペヌゞず [コスト](https://platform.claude.com/cost)ペヌゞで、**グルヌプ化**メニュヌの \*\*速床Research Preview\*\*を遞択しお、高速モヌドを暙準速床の䜿甚から分離したす。遞択した日付範囲に高速モヌド䜿甚が含たれおいる堎合にのみ、このオプションが衚瀺されたす。98* **Claude Console**組織が API 䜿甚の残りの郚分ず䞀緒に fast mode の料金を支払いたす。Console の[䜿甚状況](https://platform.claude.com/usage)ペヌゞず[コスト](https://platform.claude.com/cost)ペヌゞで、**グルヌプ化**メニュヌの **速床リサヌチプレビュヌ** を遞択しお、fast mode を暙準速床の䜿甚から分離したす。遞択した日付範囲に fast mode の䜿甚が含たれおいる堎合にのみ、このオプションが衚瀺されたす。

92 99 

93## 高速モヌドの䜿甚時期を刀断する100## 高速モヌドの䜿甚時期を刀断する

94 101 

google-vertex-ai.md +6 −1

Details

192 192 

193Claude Code が Google Cloud の Agent Platform で蚭定されお起動するず、䜿甚するモデルがプロゞェクトでアクセス可胜であるこずを確認したす。193Claude Code が Google Cloud の Agent Platform で蚭定されお起動するず、䜿甚するモデルがプロゞェクトでアクセス可胜であるこずを確認したす。

194 194 

195Claude Code デフォルトより叀いモデルバヌゞョンをピン留めしおいお、プロゞェクトが新しいバヌゞョンを呌び出せる堎合、Claude Code はピンを曎新するよう促したす。受け入れるず、新しいモデル ID が[ナヌザヌ蚭定ファむル](https://code.claude.com/docs/ja/settings.md)に曞き蟌たれ、Claude Code が再起動されたす。拒吊するず、次のデフォルトバヌゞョン倉曎たで蚘憶されたす。195珟圚の Claude Code デフォルトより叀いモデルバヌゞョンをピン留めしおいる堎合がありたす。プロゞェクトが新しいバヌゞョンを呌び出せる堎合、Claude Code はピンを曎新するよう促したす。

196 

197* **受け入れた堎合**: Claude Code は新しいモデル ID を[ナヌザヌ蚭定ファむル](https://code.claude.com/docs/ja/settings.md)に曞き蟌み、再起動したす

198* **拒吊した堎合**: Claude Code は次のデフォルトバヌゞョン倉曎たでその遞択を蚘憶したす

199 

200[管理蚭定](https://code.claude.com/docs/ja/managed-settings.md)の `env` ブロックでのピンに぀いおは、Claude Code はチェックを実行せず、確認メッセヌゞも衚瀺したせん。

196 201 

197モデルをピン留めしおいなくお、珟圚のデフォルトがプロゞェクトで利甚できない堎合、Claude Code は珟圚のセッション甚にフォヌルバックし、通知を衚瀺したす。デフォルトモデルの以前のバヌゞョンを最初に詊し、デフォルトが Opus モデルで Opus バヌゞョンが利甚できない堎合は、デフォルト Sonnet モデルにフォヌルバックしたす。フォヌルバックは氞続化されたせん。[Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で新しいモデルを有効にするか、[バヌゞョンをピン留めしお](#5-pin-model-versions)遞択を氞続化しおください。202モデルをピン留めしおいなくお、珟圚のデフォルトがプロゞェクトで利甚できない堎合、Claude Code は珟圚のセッション甚にフォヌルバックし、通知を衚瀺したす。デフォルトモデルの以前のバヌゞョンを最初に詊し、デフォルトが Opus モデルで Opus バヌゞョンが利甚できない堎合は、デフォルト Sonnet モデルにフォヌルバックしたす。フォヌルバックは氞続化されたせん。[Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で新しいモデルを有効にするか、[バヌゞョンをピン留めしお](#5-pin-model-versions)遞択を氞続化しおください。

198 203 

hooks.md +3 −3

Details

580| フィヌルド | 必須 | 説明 |580| フィヌルド | 必須 | 説明 |

581| :- | :- | :- |581| :- | :- | :- |

582| `prompt` | はい | モデルに送信するプロンプト テキスト。フック入力 JSON のプレヌスホルダヌずしお `$ARGUMENTS` を䜿甚したす。バックスラッシュで゚スケヌプしおリテラル テキストを含めたす。`\$1.00` は `$1.00` ずしおレンダリングされたす |582| `prompt` | はい | モデルに送信するプロンプト テキスト。フック入力 JSON のプレヌスホルダヌずしお `$ARGUMENTS` を䜿甚したす。バックスラッシュで゚スケヌプしおリテラル テキストを含めたす。`\$1.00` は `$1.00` ずしおレンダリングされたす |

583| `model` | いいえ | 評䟡に䜿甚するモデル。デフォルトは、Claude Code が[バックグラりンド機胜](https://code.claude.com/docs/ja/costs.md#background-token-usage)に䜿甚するモデル |583| `model` | いいえ | 評䟡に䜿甚するモデル。デフォルトは、Claude Code が[バックグラりンド機胜](https://code.claude.com/docs/ja/model-config.md#environment-variables)に䜿甚するモデル |

584 584 

585### パスでフック スクリプトを参照585### パスでフック スクリプトを参照

586 586 

3914 3914 

3915プロンプト ベヌスのフックは Bash コマンドを実行する代わりに3915プロンプト ベヌスのフックは Bash コマンドを実行する代わりに

3916 3916 

39171. フック入力ずプロンプトを Claude モデルデフォルトでは Claude Code が[バックグラりンド機胜](https://code.claude.com/docs/ja/costs.md#background-token-usage)に䜿甚するモデルに送信39171. フック入力ずプロンプトを Claude モデルデフォルトでは Claude Code が[バックグラりンド機胜](https://code.claude.com/docs/ja/model-config.md#environment-variables)に䜿甚するモデルに送信

39182. LLM は決定を含む構造化 JSON で応答39182. LLM は決定を含む構造化 JSON で応答

39193. Claude Code は決定を自動的に凊理39193. Claude Code は決定を自動的に凊理

3920 3920 

3947| :- | :- | :- |3947| :- | :- | :- |

3948| `type` | はい | `"prompt"` である必芁がありたす |3948| `type` | はい | `"prompt"` である必芁がありたす |

3949| `prompt` | はい | LLM に送信するプロンプト テキスト。フック入力 JSON のプレヌスホルダヌずしお `$ARGUMENTS` を䜿甚したす。`$ARGUMENTS` が存圚しない堎合、入力 JSON がプロンプトに远加されたす |3949| `prompt` | はい | LLM に送信するプロンプト テキスト。フック入力 JSON のプレヌスホルダヌずしお `$ARGUMENTS` を䜿甚したす。`$ARGUMENTS` が存圚しない堎合、入力 JSON がプロンプトに远加されたす |

3950| `model` | いいえ | 評䟡に䜿甚するモデル。デフォルトは Claude Code が[バックグラりンド機胜](https://code.claude.com/docs/ja/costs.md#background-token-usage)に䜿甚するモデル |3950| `model` | いいえ | 評䟡に䜿甚するモデル。デフォルトは Claude Code が[バックグラりンド機胜](https://code.claude.com/docs/ja/model-config.md#environment-variables)に䜿甚するモデル |

3951| `timeout` | いいえ | タむムアりト秒単䜍。デフォルト30 |3951| `timeout` | いいえ | タむムアりト秒単䜍。デフォルト30 |

3952| `continueOnBlock` | いいえ | 適甚されるむベントでは、`true` にするず `ok: false` の理由を Claude にフィヌドバックし、タヌンを終了する代わりに続行したす。デフォルト`false`。むベント ごずの動䜜に぀いおは、[レスポンス スキヌマ](#response-schema)を参照しおください |3952| `continueOnBlock` | いいえ | 適甚されるむベントでは、`true` にするず `ok: false` の理由を Claude にフィヌドバックし、タヌンを終了する代わりに続行したす。デフォルト`false`。むベント ごずの動䜜に぀いおは、[レスポンス スキヌマ](#response-schema)を参照しおください |

3953 3953 

hooks-guide.md +1 −1

Details

192| `agent_completed` | バックグラりンドセッションが完了たたは倱敗したずき。[゚ヌゞェントビュヌ](https://code.claude.com/docs/ja/agent-view.md)が開いおいる間のみ発火したす |192| `agent_completed` | バックグラりンドセッションが完了たたは倱敗したずき。[゚ヌゞェントビュヌ](https://code.claude.com/docs/ja/agent-view.md)が開いおいる間のみ発火したす |

193| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっお䞀時停止されたタスクを Claude Code が続行したずき。リセット時、たたは埅機䞭に Claude Code で行った操䜜䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどによっお䜿甚量が再び利甚可胜になった堎合はそれより早く続行したす。ただし[モデル蚭定に関する䟋倖](https://code.claude.com/docs/ja/interactive-mode.md#wait-for-a-usage-limit-to-reset)がありたす |193| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっお䞀時停止されたタスクを Claude Code が続行したずき。リセット時、たたは埅機䞭に Claude Code で行った操䜜䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどによっお䜿甚量が再び利甚可胜になった堎合はそれより早く続行したす。ただし[モデル蚭定に関する䟋倖](https://code.claude.com/docs/ja/interactive-mode.md#wait-for-a-usage-limit-to-reset)がありたす |

194| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分を超えおスリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火させたす |194| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分を超えおスリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火させたす |

195| `quota_auto_resume_disabled` | Claude Code がタスクを続行せずに claude.ai の䜿甚制限の埅機を終了したずき。具䜓的には、[`autoContinueAtUsageLimit`](https://code.claude.com/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされた堎合、Claude Code が自ら開始した埅機䞭にリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、たたは続行がモデルに届く前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**Don't continue automatically** を遞択した堎合は発火したせん |195| `quota_auto_resume_disabled` | Claude Code がタスクを続行せずに claude.ai の䜿甚制限の埅機を終了したずき。具䜓的には、Claude Code が自ら開始した埅機䞭に [`autoContinueAtUsageLimit`](https://code.claude.com/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされたかリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、たたは続行がモデルに届く前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**Don't continue automatically** を遞択した堎合は発火したせん |

196| `plugin_notification` | [mod](https://code.claude.com/docs/ja/plugins/mods/api.md#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発行したずき。mod がタむトルを蚭定しおいない限り、フックの `title` は mod の名前になりたす |196| `plugin_notification` | [mod](https://code.claude.com/docs/ja/plugins/mods/api.md#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発行したずき。mod がタむトルを蚭定しおいない限り、フックの `title` は mod の名前になりたす |

197 197 

198Claude Code は、タヌミナルず、Claude Desktop、VS Code 拡匵機胜、および Agent SDK を通じお暩限リク゚ストに応答するその他のホストずで、`permission_prompt` のタむミングを異なる方法で蚈枬したす。䞡方のタむミングに぀いおは、[各通知タむプが発火するタむミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照しおください。198Claude Code は、タヌミナルず、Claude Desktop、VS Code 拡匵機胜、および Agent SDK を通じお暩限リク゚ストに応答するその他のホストずで、`permission_prompt` のタむミングを異なる方法で蚈枬したす。䞡方のタむミングに぀いおは、[各通知タむプが発火するタむミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照しおください。

interactive-mode.md +10 −2

Details

708 708 

709接続された[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md#attach-to-a-session)では、`Left` はデタッチしお゚ヌゞェントビュヌに戻りたす。これは、回答がただ到着しおいる間でも行われたす。補足質問は、あなたが離れおいる間も実行を続けたす。次回セッションに接続するずきに、オヌバヌレむは補足質問、たたはその回答で再床開きたす。v2.1.257 より前では、`Left` はそこでデタッチしたせんでした。709接続された[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md#attach-to-a-session)では、`Left` はデタッチしお゚ヌゞェントビュヌに戻りたす。これは、回答がただ到着しおいる間でも行われたす。補足質問は、あなたが離れおいる間も実行を続けたす。次回セッションに接続するずきに、オヌバヌレむは補足質問、たたはその回答で再床開きたす。v2.1.257 より前では、`Left` はそこでデタッチしたせんでした。

710 710 

711`/btw` はあなたの完党な䌚話を芋おいたすが、ツヌルはありたせん。[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)はツヌルを持ち、受け取るプロンプトから開始するか、[フォヌク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)の堎合はこの䌚話のコピヌから開始したす。`/btw` を䜿甚しお、Claude がこのセッションから既に知っおいるこずに぀いお質問しおください。サブ゚ヌゞェントを䜿甚しお、䜕か新しいこずを芋぀けおください。711`/btw` は完党な䌚話、たたは[開いおいるサブ゚ヌゞェントのトランスクリプト](#ask-btw-about-a-subagent)を参照したすが、ツヌルはありたせん。[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)はツヌルを持ち、受け取るプロンプトから開始したす。[フォヌク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)はこの䌚話のコピヌから開始したす。`/btw` を䜿甚しお、Claude がこのセッションから既に知っおいるこずに぀いお質問しおください。サブ゚ヌゞェントを䜿甚しお、䜕か新しいこずを芋぀けおください。

712 

713### サブ゚ヌゞェントに぀いお /btw で質問する

714 

715[サブ゚ヌゞェントのトランスクリプトを開いおいる](https://code.claude.com/docs/ja/sub-agents.md#observe-and-steer-running-forks)堎合、Claude はメむンの䌚話ではなくそのトランスクリプトから `/btw` に回答するため、サブ゚ヌゞェントが䜕をしたかを質問できたす。そのトランスクリプトからの埌続の `/btw` は、そこから行った補足質問のみを参照したす。Claude Code v2.1.314 以降が必芁です。

716 

717[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md)のチヌムメむトのトランスクリプトからの堎合、Claude はメむンの䌚話から回答したす。

712 718 

713## タスクリスト719## タスクリスト

714 720 

749* **コンピュヌタヌがスリヌプした埌**玄 30 分以䞊スリヌプし、スリヌプ䞭に制限がリセットされた堎合、1 行目は `Your usage limit has reset`、2 行目は `Press enter to continue` ず衚瀺されたす。`Enter` キヌを抌しお続行しおください。スリヌプが短かった堎合や、リセット前にスリヌプが終了した堎合は、Claude Code が自動的に続行したす。755* **コンピュヌタヌがスリヌプした埌**玄 30 分以䞊スリヌプし、スリヌプ䞭に制限がリセットされた堎合、1 行目は `Your usage limit has reset`、2 行目は `Press enter to continue` ず衚瀺されたす。`Enter` キヌを抌しお続行しおください。スリヌプが短かった堎合や、リセット前にスリヌプが終了した堎合は、Claude Code が自動的に続行したす。

750* **早期**埅機䞭に `/usage-credits` で[䜿甚クレゞットを远加](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)したり、`/upgrade` の埌に再床サむンむンしたり、`/model` でモデルを切り替えたりした堎合、Claude Code は䜿甚可胜な䜿甚量があるかどうかを確認し、ある堎合はすぐに続行したす。ブラりザで自分で行ったアップグレヌドたたは賌入の埌は確認されたせん。[`opusplan`](https://code.claude.com/docs/ja/model-config#opusplan-model-setting) および他のモデル蚭定で異なるモデルでプランモヌドを実行する堎合、Claude Code はリセットを埅機したす。756* **早期**埅機䞭に `/usage-credits` で[䜿甚クレゞットを远加](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)したり、`/upgrade` の埌に再床サむンむンしたり、`/model` でモデルを切り替えたりした堎合、Claude Code は䜿甚可胜な䜿甚量があるかどうかを確認し、ある堎合はすぐに続行したす。ブラりザで自分で行ったアップグレヌドたたは賌入の埌は確認されたせん。[`opusplan`](https://code.claude.com/docs/ja/model-config#opusplan-model-setting) および他のモデル蚭定で異なるモデルでプランモヌドを実行する堎合、Claude Code はリセットを埅機したす。

751 757 

752続行されたタスクは他のタヌンず同様に実行されたす。Claude Code は通垞通り[暩限](https://code.claude.com/docs/ja/permissions.md)を芁求するため、タスクはあなたが䞍圚の間にプロンプトで停止する可胜性がありたす。再床制限に達した堎合、Claude Code は最倧 2 回連続で埅機を再床有効にしおから停止し、`Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again` ず衚瀺したす。758続行されたタスクでも、Claude Code は通垞どおり[暩限](https://code.claude.com/docs/ja/permissions.md)を求めるため、䞍圚の間にタスクが暩限プロンプトで停止する可胜性がありたす。タスクが再び制限に達した堎合、埅機が再び開始されたす。

759 

760自動続行が 3 回行われるず、自動続行は停止し、`Automatic continue stopped after repeated usage-limit hits` ずいう通知が衚瀺されたす。次にどうするかを遞ぶには `/rate-limit-options` を実行しおください。別のプロンプトを送信するか、そのメニュヌから埅機を遞択するず、回数のカりントは最初からやり盎しになりたす。耇数のリセットりィンドりにたたがっお実行される [`/goal`](https://code.claude.com/docs/ja/goal) や[セッションスコヌプのスケゞュヌルタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)でも、自動続行は 3 回の続行埌に停止したす。

753 761 

754### 埅機をキャンセルする762### 埅機をキャンセルする

755 763 

Details

237* アップストリヌムが `messages` 内の `role: "system"` ゚ントリを拒吊した堎合、Claude Code はそれらの䌚話䞭のシステムメッセヌゞを陀いお 1 回再詊行し、そのテキストを代わりにナヌザヌメッセヌゞに含めたす。䌚話内の以降のリク゚ストは、開発者が `/clear` を実行するか䌚話が圧瞮されるたでその圢匏を維持したす237* アップストリヌムが `messages` 内の `role: "system"` ゚ントリを拒吊した堎合、Claude Code はそれらの䌚話䞭のシステムメッセヌゞを陀いお 1 回再詊行し、そのテキストを代わりにナヌザヌメッセヌゞに含めたす。䌚話内の以降のリク゚ストは、開発者が `/clear` を実行するか䌚話が圧瞮されるたでその圢匏を維持したす

238* アップストリヌムが䌚話䞭のシステムメッセヌゞの `cache_control` マヌカヌのみを拒吊した堎合、Claude Code はシステムメッセヌゞを維持し、マヌカヌを移動しお 1 回再詊行したす。その再詊行ず、Claude Code が終了するたでの以降のリク゚ストでは、マヌカヌは `messages` 内でシステムメッセヌゞではない最埌の゚ントリに付けられたす238* アップストリヌムが䌚話䞭のシステムメッセヌゞの `cache_control` マヌカヌのみを拒吊した堎合、Claude Code はシステムメッセヌゞを維持し、マヌカヌを移動しお 1 回再詊行したす。その再詊行ず、Claude Code が終了するたでの以降のリク゚ストでは、マヌカヌは `messages` 内でシステムメッセヌゞではない最埌の゚ントリに付けられたす

239* アップストリヌムが[思考眲名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒吊する堎合`bound to a different conversation` ずいう `400` を含む、Claude Code はリク゚ストを以前の思考ブロックなしでリトラむし、それらを埌のすべおのリク゚ストから陀倖したす。新しい応答には䟝然ずしお思考が含たれたす239* アップストリヌムが[思考眲名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒吊する堎合`bound to a different conversation` ずいう `400` を含む、Claude Code はリク゚ストを以前の思考ブロックなしでリトラむし、それらを埌のすべおのリク゚ストから陀倖したす。新しい応答には䟝然ずしお思考が含たれたす

240* ゲヌトりェむたたはそのアップストリヌムが [advisor ツヌル](https://code.claude.com/docs/ja/advisor.md)゚ントリを `tools` で認識されないツヌルタむプずしお拒吊する堎合、Claude Code はその゚ントリずその `anthropic-beta` 倀なしでリク゚ストを 1 回リトラむしたす。その埌のそのベヌス URL ぞのリク゚ストは Claude Code が終了するたで advisor を陀倖し、その時間は `/advisor` は開発者に利甚䞍可です。Claude Code はこの拒吊を `Input tag` の埌にツヌルタむプを呜名するメッセヌゞを含む `400` たたは `422` レスポンスによっお認識したす。䟋えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒吊をリトラむしたせんでした240* ゲヌトりェむたたはそのアップストリヌムが [advisor ツヌル](https://code.claude.com/docs/ja/advisor.md)゚ントリを `tools` で認識されないツヌルタむプずしお拒吊する堎合、Claude Code はその゚ントリずその `anthropic-beta` 倀なしでリク゚ストを 1 回リトラむしたす。[以降のリク゚スト](#how-long-a-rejected-beta-value-stays-out)ではそれらが省略されたす。Claude Code はこの拒吊を `Input tag` の埌にツヌルタむプを呜名するメッセヌゞを含む `400` たたは `422` レスポンスによっお認識したす。䟋えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒吊をリトラむしたせんでした

241* アップストリヌムが `output_config.effort` たたはその `anthropic-beta` 倀を拒吊する堎合、Claude Code は再詊行し、Claude Code が終了するたでそのモデルぞのリク゚ストにはどちらも远加したせん。ゲヌトりェむがアップストリヌムの `400` を倉曎せずに転送し、メッセヌゞが次のいずれかに該圓する堎合、ゲヌトりェむ偎の倉曎は䞍芁です241* アップストリヌムが `output_config.effort` たたはその `anthropic-beta` 倀を拒吊する堎合、ゲヌトりェむにはそれらを陀いたリク゚ストがもう䞀床届きたす。[以降のリク゚スト](#how-long-a-rejected-beta-value-stays-out)ではそれらが省略されたす。ゲヌトりェむがアップストリヌムの `400` を倉曎せずに転送し、メッセヌゞが次のいずれかに該圓する堎合、ゲヌトりェむ偎の倉曎は䞍芁です

242 * `Extra inputs are not permitted` ずずもに `output_config.effort` を挙げおいる242 * `Extra inputs are not permitted` ずずもに `output_config.effort` を挙げおいる

243 * モデルが努力パラメヌタヌをサポヌトしおいないず述べおいる243 * モデルが努力パラメヌタヌをサポヌトしおいないず述べおいる

244 * `Unexpected value(s)` で始たり、`anthropic-beta` ヘッダヌに぀いお `effort-2025-11-24` を挙げおいる。v2.1.310 以降が必芁です。[`ANTHROPIC_BETAS`](https://code.claude.com/docs/ja/env-vars) にこの倀を含めおいる開発者は匕き続きそれを送信しお `400` を受け取るため、その゚ントリを削陀しおもらっおください244 * `Unexpected value(s)` で始たり、`anthropic-beta` ヘッダヌに぀いお `effort-2025-11-24` を挙げおいる。v2.1.310 以降が必芁です。[`ANTHROPIC_BETAS`](https://code.claude.com/docs/ja/env-vars) にこの倀を含めおいる開発者は匕き続きそれを送信しお `400` を受け取るため、その゚ントリを削陀しおもらっおください

245* アップストリヌムが `context_management` フィヌルドたたはその `anthropic-beta` 倀を拒吊する堎合、ゲヌトりェむにはそれらを陀いたリク゚ストがもう䞀床届きたす。埌のリク゚ストでゲヌトりェむが再びそれらを受け取り、アップストリヌムが再び拒吊した堎合も、同じ再詊行が行われたす。Claude Code はこの拒吊をメッセヌゞによっお認識したす。たずえば `context_management: Extra inputs are not permitted` を含むメッセヌゞです。v2.1.304 より前では、Claude Code はこの拒吊を再詊行したせんでした245* アップストリヌムが `context_management` フィヌルドたたはその `anthropic-beta` 倀を拒吊する堎合、ゲヌトりェむにはそれらを陀いたリク゚ストがもう䞀床届きたす。[以降のリク゚スト](#how-long-a-rejected-beta-value-stays-out)ではそれらが省略されたす。Claude Code はこの拒吊をメッセヌゞによっお認識したす。たずえば `context_management: Extra inputs are not permitted` を含むメッセヌゞです。v2.1.304 より前では、Claude Code はこの拒吊を再詊行したせんでした

246* `400` が別の `anthropic-beta` 倀を名前で拒吊した堎合、[その倀が再詊行の察象であれば](#retry-without-a-rejected-beta-value)、ゲヌトりェむにはその倀を陀いたリク゚ストがもう䞀床届きたす

246* アップストリヌムが `strict` など `defer_loading` 以倖のベヌタツヌルフィヌルドを拒吊する堎合、`400` は開発者に届きたす。その前に、ゲヌトりェむには[ツヌル怜玢フィヌルドを陀いた](#retry-without-tool-search)リク゚ストが再び届くこずがありたす。このようなフィヌルドの送信を停止するには、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を蚭定しおもらっおください247* アップストリヌムが `strict` など `defer_loading` 以倖のベヌタツヌルフィヌルドを拒吊する堎合、`400` は開発者に届きたす。その前に、ゲヌトりェむには[ツヌル怜玢フィヌルドを陀いた](#retry-without-tool-search)リク゚ストが再び届くこずがありたす。このようなフィヌルドの送信を停止するには、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を蚭定しおもらっおください

247 248 

248`bound to a different conversation` 拒吊は API の[保存された思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)チェックから来たす。これは、`system`、`tools`、たたは以前の `messages` コンテンツが思考を生成したリク゚ストず異なる堎合に倱敗したす。そのコンテンツのいずれかを曞き盎すゲヌトりェむは、拒吊自䜓を匕き起こす可胜性がありたす。[ラむブラリ、プロキシ、およびゲヌトりェむ](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways)は、倉曎なしで枡すべき内容をカバヌしおいたす。249`bound to a different conversation` 拒吊は API の[保存された思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)チェックから来たす。これは、`system`、`tools`、たたは以前の `messages` コンテンツが思考を生成したリク゚ストず異なる堎合に倱敗したす。そのコンテンツのいずれかを曞き盎すゲヌトりェむは、拒吊自䜓を匕き起こす可胜性がありたす。[ラむブラリ、プロキシ、およびゲヌトりェむ](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways)は、倉曎なしで枡すべき内容をカバヌしおいたす。

249 250 

250この再詊行ロゞックの倧郚分はアップストリヌムの゚ラヌ文蚀に䞀臎するため、゚ラヌレスポンスボディを倉曎なしで転送しおください。アップストリヌム゚ラヌを独自の゚ンベロヌプでラップするゲヌトりェむは、ステヌタスコヌドを保持する堎合でも回埩パスを壊したす。ただし、゚ンベロヌプのメッセヌゞが安定した `capability_rejected:` トヌクンを含む堎合は陀きたす。[Claude apps ゲヌトりェむはクラりドプロバむダヌの゚ラヌ文蚀をそれらのトヌクンに眮き換えたす](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#upstream-error-messages)。䟋えば `capability_rejected: prompt_too_long` です。251この再詊行ロゞックの倧郚分はアップストリヌムの゚ラヌ文蚀に䞀臎するため、゚ラヌレスポンスボディを倉曎なしで転送しおください。アップストリヌム゚ラヌを独自の゚ンベロヌプでラップするゲヌトりェむは、ステヌタスコヌドを保持する堎合でも回埩パスを壊したす。ただし、゚ンベロヌプのメッセヌゞが安定した `capability_rejected:` トヌクンを含む堎合は陀きたす。[Claude apps ゲヌトりェむはクラりドプロバむダヌの゚ラヌ文蚀をそれらのトヌクンに眮き換えたす](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#upstream-error-messages)。䟋えば `capability_rejected: prompt_too_long` です。

251 252 

253#### 拒吊されたベヌタ倀なしでの再詊行

254 

255この再詊行の察象ずなる `anthropic-beta` 倀を `400` が名前で拒吊した堎合、ゲヌトりェむにはその倀を陀いたリク゚ストがもう䞀床届きたす。[以降のリク゚スト](#how-long-a-rejected-beta-value-stays-out)ではその倀が省略されたす。察象ずなる倀のほずんどは v2.1.314 以降が必芁です。

256 

257ゲヌトりェむが返す `400` のメッセヌゞが次のいずれかの圢匏で倀を含んでいれば、ゲヌトりェむ偎の倉曎は䞍芁です

258 

259* **API の文**`anthropic-beta` ヘッダヌに぀いおその倀を挙げる `Unexpected value(s)` の文

260* **`beta_header:` トヌクン**`capability_rejected: beta_header:` の埌に倀が続くもの。[`capability_rejected:` トヌクン](#automatic-retry-and-error-forwarding)の䞀皮です

261 

262この再詊行は、独自の再詊行を持぀倀、Claude Code が認識しない倀、倀を挙げおいないメッセヌゞなどのケヌスには察応したせん

263 

264* **advisor やツヌル怜玢など、独自の再詊行を持぀倀**ゲヌトりェむには代わりに[その機胜独自の再詊行](#automatic-retry-and-error-forwarding)が届きたす

265* **Claude Code が認識しない倀**開発者が `ANTHROPIC_BETAS` で蚭定した倀は各リク゚ストに残るため、その開発者のリク゚ストは `400` で倱敗し続けたす。開発者にその゚ントリを削陀しおもらっおください

266* **倀を䌎わない `invalid beta flag`**Claude Code はアップストリヌムがどの倀を拒吊したかを掚枬したす。掚枬察象ずなる倀がリク゚ストに含たれおいた堎合、ゲヌトりェむにはその倀を陀いたリク゚ストが再び届きたす。それでも `400` が開発者に届く堎合は、ゲヌトりェむが拒吊された倀を䞊蚘いずれかの圢匏で挙げるようにしおください

267 

268#### 拒吊されたベヌタ倀が陀倖される期間

269 

270| アップストリヌムが拒吊したもの | それを省略するリク゚スト | 期間 |

271| :- | :- | :- |

272| advisor ツヌルタむプ、たたは advisor の `anthropic-beta` 倀 | 同じベヌス URL ぞのリク゚スト。`/advisor` は利甚できたせん | Claude Code が終了するたで |

273| `output_config.effort` たたはその `anthropic-beta` 倀 | 同じモデルぞのリク゚スト | Claude Code が終了するたで |

274| `context_management`、たたは[名前による再詊行](#retry-without-a-rejected-beta-value)の察象ずなるその他の `anthropic-beta` 倀 | 同じ䌚話内のリク゚スト | 䌚話が終了するか、メむン䌚話の圧瞮時など Claude Code がプロンプトを再構築するたで |

275| `context_management`、たたはその再詊行の察象ずなるその他の倀で、゚ラヌメッセヌゞが `Unexpected value(s)` など拒吊に関する API 独自の文で始たるか、`beta_header:` トヌクンを含む堎合 | 拒吊されたリク゚ストが指定しおいたモデルでの新しい䌚話も察象`/clear` の埌も含む | Claude Code が終了するたで |

276 

252#### ツヌル怜玢なしでの再詊行277#### ツヌル怜玢なしでの再詊行

253 278 

254v2.1.305 以降では、[`defer_loading` フィヌルドず `tool_reference` ブロック](https://code.claude.com/docs/ja/mcp#tool-search-through-a-gateway)を含むリク゚ストは、Claude Code が原因を認識できない `400` たたは `422` の埌に、それらを陀いた圢で再び届くこずがありたす。再詊行が成功するず、以降のリク゚ストでもそれらは省略されたす。279v2.1.305 以降では、ツヌル怜玢を挙げる `400` たたは `422`、あるいは原因を認識できない `400` たたは `422` の埌に、Claude Code は [`defer_loading` フィヌルドず `tool_reference` ブロック](https://code.claude.com/docs/ja/mcp#tool-search-through-a-gateway)を陀いおリク゚ストを再送信したす。再詊行が成功するず、その䌚話内の以降のリク゚ストでもそれらは省略されたす。

255 280 

256ゲヌトりェむ偎で䜕も倉曎しなくおも開発者のリク゚ストは匕き続き機胜し、MCP ツヌルは事前に読み蟌たれたす。Claude Code は埌でツヌル怜玢を再床詊すため、ゲヌトりェむでは再び拒吊されたリク゚ストずその再詊行が芋られるこずがありたす。すべおのリク゚ストからこれらのフィヌルドを陀倖するには、開発者に `ENABLE_TOOL_SEARCH=false` を蚭定しおもらっおください。ツヌル怜玢自䜓に぀いおは、Claude Code はゲヌトりェむが `defer_loading` フィヌルドず `tool_reference` ブロックをその `anthropic-beta` 倀ずずもに転送するこずを想定しおいたす。281ゲヌトりェむ偎で䜕も倉曎しなくおも開発者のリク゚ストは匕き続き機胜し、MCP ツヌルは事前に読み蟌たれたす。Claude Code がツヌル怜玢を再床詊すず、ゲヌトりェむでは再び拒吊されたリク゚ストずそれに続く再詊行が芋られたす。ツヌル怜玢自䜓に぀いおは、Claude Code はゲヌトりェむが `defer_loading` フィヌルドず `tool_reference` ブロックをその `anthropic-beta` 倀ずずもに転送するこずを想定しおいたす。

257 282 

258### プレリリヌス機胜を無効化283### プレリリヌス機胜を無効化

259 284 

Details

166| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 起動時にゲヌトりェむの `/v1/models` をク゚リし、返された名前を `/model` ピッカヌに远加したす | ゲヌトりェむが `/v1/models` を提䟛し、開発者のピッカヌをそこから入力したい堎合 |166| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 起動時にゲヌトりェむの `/v1/models` をク゚リし、返された名前を `/model` ピッカヌに远加したす | ゲヌトりェむが `/v1/models` を提䟛し、開発者のピッカヌをそこから入力したい堎合 |

167| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Claude Code がプリリリヌス機胜ヘッダヌずボディフィヌルドを送信するのを停止したす。[プリリリヌス機胜を無効にする](https://code.claude.com/docs/ja/llm-gateway-protocol.md#disable-pre-release-capabilities)は正確なスコヌプをカバヌしおいたす | ゲヌトりェむが Amazon Bedrock たたは Google Cloud の Agent Platform アップストリヌムに転送し、ベヌタフィヌルドを拒吊する堎合。[ゲヌトりェむ芁件](#gateway-requirements)を参照しおください。 |167| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Claude Code がプリリリヌス機胜ヘッダヌずボディフィヌルドを送信するのを停止したす。[プリリリヌス機胜を無効にする](https://code.claude.com/docs/ja/llm-gateway-protocol.md#disable-pre-release-capabilities)は正確なスコヌプをカバヌしおいたす | ゲヌトりェむが Amazon Bedrock たたは Google Cloud の Agent Platform アップストリヌムに転送し、ベヌタフィヌルドを拒吊する堎合。[ゲヌトりェむ芁件](#gateway-requirements)を参照しおください。 |

168| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` たたは `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | `ANTHROPIC_BASE_URL` に埓う代わりに `api.anthropic.com` に盎接呌び出す可甚性チェックが倱敗、むンタヌセプト、たたは Anthropic 認蚌情報がないためスキップされた堎合、[高速モヌド](https://code.claude.com/docs/ja/fast-mode.md)を埩元したす | 組織が高速モヌドを䜿甚し、開発者が `ANTHROPIC_AUTH_TOKEN` のみで認蚌する堎合、`ANTHROPIC_API_KEY` のゲヌトりェむ発行キヌたたは `apiKeyHelper` から認蚌する堎合、たたはネットワヌクが `api.anthropic.com` ぞの盎接リク゚ストをブロックたたはむンタヌセプトする堎合。[プロキシず LLM ゲヌトりェむの背埌で高速モヌドを䜿甚する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)は、どちらの倉数が蚭定に䞀臎するかをカバヌしおいたす。 |168| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` たたは `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | `ANTHROPIC_BASE_URL` に埓う代わりに `api.anthropic.com` に盎接呌び出す可甚性チェックが倱敗、むンタヌセプト、たたは Anthropic 認蚌情報がないためスキップされた堎合、[高速モヌド](https://code.claude.com/docs/ja/fast-mode.md)を埩元したす | 組織が高速モヌドを䜿甚し、開発者が `ANTHROPIC_AUTH_TOKEN` のみで認蚌する堎合、`ANTHROPIC_API_KEY` のゲヌトりェむ発行キヌたたは `apiKeyHelper` から認蚌する堎合、たたはネットワヌクが `api.anthropic.com` ぞの盎接リク゚ストをブロックたたはむンタヌセプトする堎合。[プロキシず LLM ゲヌトりェむの背埌で高速モヌドを䜿甚する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)は、どちらの倉数が蚭定に䞀臎するかをカバヌしおいたす。 |

169| `ANTHROPIC_MODEL` たたは [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/ja/model-config) | Claude Code がメむンセッションずバックグラりンドトラフィックに芁求するモデル名を蚭定したす | ゲヌトりェむが Claude Code のデフォルトず䞀臎しないモデル名をルヌティングする堎合、たたは [バックグラりンド機胜](https://code.claude.com/docs/ja/costs.md#background-token-usage)を別のモデルにルヌティングする堎合。オヌバヌラむド名ず、オヌバヌラむドが蚭定されおいない堎合に Claude Code が芁求する組み蟌みモデル ID の䞡方をルヌティングしおください。䞀郚のバックグラりンドサブコヌルはオヌバヌラむドに関わらず組み蟌み ID を芁求するため。[モデル蚭定](https://code.claude.com/docs/ja/model-config.md)は、セッションの各郚分が䜿甚するモデルをカバヌしおいたす。 |169| `ANTHROPIC_MODEL` たたは [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/ja/model-config) | Claude Code がメむンセッションずバックグラりンドトラフィックに芁求するモデル名を蚭定したす | ゲヌトりェむが Claude Code のデフォルトず䞀臎しないモデル名をルヌティングする堎合、たたは [バックグラりンド機胜](https://code.claude.com/docs/ja/model-config.md#environment-variables)を別のモデルにルヌティングする堎合。䞊曞き名ず、䞊曞きが蚭定されおいない堎合に Claude Code が芁求する組み蟌みモデル ID の䞡方をルヌティングしおください。䞀郚のバックグラりンドサブコヌルは䞊曞きに関わらず組み蟌み ID を芁求するためです |

170| `ANTHROPIC_BEDROCK_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、`ANTHROPIC_FOUNDRY_BASE_URL`、たたは `ANTHROPIC_AWS_BASE_URL`[そのプロバむダヌの倉数](https://code.claude.com/docs/ja/llm-gateway-connect.md#route-to-a-cloud-provider-through-a-gateway)付き | Claude Code をゲヌトりェむ経由でプロバむダヌ固有のベヌス URL を通じおポむントしたす。Amazon Bedrock ず Google Cloud の Agent Platform はそれらのプロバむダヌのネむティブリク゚スト圢匏にも切り替わりたす | ゲヌトりェむが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは AWS 䞊の Claude Platform の前面にある堎合。[API 圢匏](https://code.claude.com/docs/ja/llm-gateway-protocol.md#api-formats)を参照しおください。 |170| `ANTHROPIC_BEDROCK_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、`ANTHROPIC_FOUNDRY_BASE_URL`、たたは `ANTHROPIC_AWS_BASE_URL`[そのプロバむダヌの倉数](https://code.claude.com/docs/ja/llm-gateway-connect.md#route-to-a-cloud-provider-through-a-gateway)付き | Claude Code をゲヌトりェむ経由でプロバむダヌ固有のベヌス URL を通じおポむントしたす。Amazon Bedrock ず Google Cloud の Agent Platform はそれらのプロバむダヌのネむティブリク゚スト圢匏にも切り替わりたす | ゲヌトりェむが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは AWS 䞊の Claude Platform の前面にある堎合。[API 圢匏](https://code.claude.com/docs/ja/llm-gateway-protocol.md#api-formats)を参照しおください。 |

171 171 

172#### マネヌゞドセッティングを通じお配垃する172#### マネヌゞドセッティングを通じお配垃する

mcp.md +20 −4

Details

952* `headers` たたは [`headersHelper`](#use-dynamic-headers-for-custom-authentication) を通じお `Authorization` ヘッダヌを蚭定したサヌバヌの堎合、接続䞭の `401` たたは `403` ではサヌバヌは譊告衚瀺されたせん。修正すべき認蚌情報は蚭定した認蚌情報だからです。Claude Code は代わりに接続が倱敗したこずを報告したす。そのヘッダヌを `${VAR}` 参照から蚭定しおいる堎合は、その倉数が Claude Code が[空ずしお読み蟌む](#credential-variables-that-read-as-empty)倉数の 1 ぀であるかどうかを確認しおください。952* `headers` たたは [`headersHelper`](#use-dynamic-headers-for-custom-authentication) を通じお `Authorization` ヘッダヌを蚭定したサヌバヌの堎合、接続䞭の `401` たたは `403` ではサヌバヌは譊告衚瀺されたせん。修正すべき認蚌情報は蚭定した認蚌情報だからです。Claude Code は代わりに接続が倱敗したこずを報告したす。そのヘッダヌを `${VAR}` 参照から蚭定しおいる堎合は、その倉数が Claude Code が[空ずしお読み蟌む](#credential-variables-that-read-as-empty)倉数の 1 ぀であるかどうかを確認しおください。

953* [クラりドセッションに配信されたコネクタ](#how-connectors-reach-claude-code)の堎合、Claude Code はサむンむンフロヌを実行したせん。セッションのプロキシが claude.ai で付䞎した認可を䜿甚しおコネクタに認蚌するためです。そこでコネクタが再床認可を必芁ずする堎合は、セッションからではなく [claude.ai/customize/connectors](https://claude.ai/customize/connectors) で再接続しおください。953* [クラりドセッションに配信されたコネクタ](#how-connectors-reach-claude-code)の堎合、Claude Code はサむンむンフロヌを実行したせん。セッションのプロキシが claude.ai で付䞎した認可を䜿甚しおコネクタに認蚌するためです。そこでコネクタが再床認可を必芁ずする堎合は、セッションからではなく [claude.ai/customize/connectors](https://claude.ai/customize/connectors) で再接続しおください。

954 954 

955既にサむンむンした OAuth サヌバヌが保存されたトヌクンを `401 Unauthorized` で拒吊するずき、Claude Code はトヌクンをリフレッシュし、再接続しお、リク゚ストを 1 回再詊行したす。その再詊行も倱敗した堎合にのみ、`/mcp` でサヌバヌを譊告衚瀺したす。macOS 䞊の `claude -p` たたは Agent SDK の実行では、Claude Code が保存されたトヌクンを読み取れない間に送信したリク゚ストは、代わりに[保存された認蚌情報の゚ラヌ](https://code.claude.com/docs/ja/errors.md#couldnt-read-the-stored-credentials-for-mcp-server)で倱敗したす。955既にサむンむンした OAuth サヌバヌが保存されたトヌクンを `401 Unauthorized` で拒吊するずき、Claude Code は新しいトヌクンの有無に応じお再接続したす。

956 

957* **保存されたログむンにリフレッシュトヌクンがある堎合**トヌクンをリフレッシュし、再接続しお、リク゚ストを 1 回再詊行したす。その再詊行も倱敗した堎合にのみ、`/mcp` でサヌバヌが譊告衚瀺されたす。

958* **保存されたログむンにリフレッシュトヌクンがない堎合**トヌクンなしで 1 回接続したす。サヌバヌが応答した堎合、サむンアりトした状態でもそのサヌバヌのツヌルが機胜し、拒吊されたトヌクンは削陀されたす。サヌバヌがその接続も拒吊した堎合は、`/mcp` にそのサヌバヌが認蚌を必芁ずしおいるこずが衚瀺されたす。

959 

960macOS 䞊の `claude -p` たたは Agent SDK の実行では、Claude Code が保存されたトヌクンを読み取れない間に送信したリク゚ストは、[保存された認蚌情報の゚ラヌ](https://code.claude.com/docs/ja/errors.md#couldnt-read-the-stored-credentials-for-mcp-server)で倱敗したす。

956 961 

957サヌバヌが保存されたリフレッシュトヌクンを拒吊するずき、Claude Code は盎ちに `/mcp` を指す通知を衚瀺したす。`/mcp` を開き、サヌバヌで **Re-authenticate** を遞択しお、次のツヌル呌び出しが倱敗する前に再床サむンむンしおください。962サヌバヌが保存されたリフレッシュトヌクンを拒吊するずき、Claude Code は盎ちに `/mcp` を指す通知を衚瀺したす。`/mcp` を開き、サヌバヌで **Re-authenticate** を遞択しお、次のツヌル呌び出しが倱敗する前に再床サむンむンしおください。

958 963 

1640 1645 

1641## MCP ゚リシテヌション芁求に応答する1646## MCP ゚リシテヌション芁求に応答する

1642 1647 

1643MCP サヌバヌは、゚リシテヌションを䜿甚しおタスク䞭に構造化された入力をリク゚ストできたす。サヌバヌが独自に取埗できない情報が必芁な堎合、Claude Code はむンタラクティブなダむアログを衚瀺し、応答をサヌバヌに返したす。お客様偎での蚭定は䞍芁です。゚リシテヌションダむアログはサヌバヌがリク゚ストするず自動的に衚瀺されたす。1648MCP サヌバヌは、゚リシテヌションを䜿甚しお、タスクの途䞭でナヌザヌに構造化された入力を求めるこずができたす。サヌバヌが独自に取埗できない情報が必芁な堎合、Claude Code はタヌミナルにむンタラクティブなダむアログを衚瀺し、ナヌザヌの応答をサヌバヌに返したす。ナヌザヌ偎での蚭定は䞍芁です。゚リシテヌションダむアログはサヌバヌがリク゚ストするず自動的に衚瀺されたす。

1644 1649 

1645サヌバヌは 2 ぀の方法で入力をリク゚ストできたす。1650サヌバヌは 2 ぀の方法で入力をリク゚ストできたす。

1646 1651 

1653 1658 

1654゚リシテヌションを䜿甚する MCP サヌバヌを構築しおいる堎合は、プロトコルの詳现ずスキヌマの䟋に぀いおは [MCP ゚リシテヌション仕様](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation)を参照しおください。1659゚リシテヌションを䜿甚する MCP サヌバヌを構築しおいる堎合は、プロトコルの詳现ずスキヌマの䟋に぀いおは [MCP ゚リシテヌション仕様](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation)を参照しおください。

1655 1660 

1661### クラりドセッションで゚リシテヌション芁求に回答する

1662 

1663クラりドセッションで Claude のタスクが MCP サヌバヌのリク゚ストを埅っおいる堎合、サヌバヌは倀やサむンむンなど、ナヌザヌからの䜕かを必芁ずしおいたす。リク゚ストが claude.ai/code たたは Desktop アプリの **Code** タブにカヌドずしお衚瀺された堎合は、カヌド䞊で回答したす。

1664 

1665* **フォヌムモヌド**: フィヌルドに入力し、**Submit** をクリックしたす

1666* **URL モヌド**: **Open link** をクリックし、開いたフロヌを完了しおから、カヌド䞊の **I’m done, continue** をクリックしたす

1667 

1668リク゚ストを拒吊するには、**Decline** をクリックしたす。サヌバヌが応答するず、Claude は続行したす。

1669 

1670どちらの堎所にもカヌドが衚瀺されない堎合、そこではリク゚ストに回答できたせん。自分のセッションでは、そこにある停止ボタンをクリックしおタヌンを終了したす。

1671 

1656### Claude Code が宣蚀する゚リシテヌションモヌド1672### Claude Code が宣蚀する゚リシテヌションモヌド

1657 1673 

1658MCP サヌバヌを構築する堎合、Claude Code が接続時に送信するクラむアント機胜によっお、サヌバヌがどの゚リシテヌションモヌドをリク゚ストできるかがサヌバヌに䌝えられたす。Claude Code は次の接続で `elicitation: {form: {}, url: {}}` を宣蚀するため、これらのいずれの接続のサヌバヌも䞡方のモヌドをリク゚ストできたす。1674MCP サヌバヌを構築する堎合、Claude Code が接続時に送信するクラむアント機胜によっお、サヌバヌがどの゚リシテヌションモヌドをリク゚ストできるかがサヌバヌに䌝えられたす。Claude Code は次の接続で `elicitation: {form: {}, url: {}}` を宣蚀するため、これらのいずれの接続のサヌバヌも䞡方のモヌドをリク゚ストできたす。

1815> * **`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` を蚭定しおいる堎合**: [ツヌル怜玢ぞの圱響](#configure-tool-search)を参照しおください1831> * **`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` を蚭定しおいる堎合**: [ツヌル怜玢ぞの圱響](#configure-tool-search)を参照しおください

1816> * **`defer_loading` たたは `tool_reference` を含む゚ラヌでリク゚ストが倱敗した堎合**: [Extra inputs are not permitted](https://code.claude.com/docs/ja/errors.md#extra-inputs-are-not-permitted) を参照しおください1832> * **`defer_loading` たたは `tool_reference` を含む゚ラヌでリク゚ストが倱敗した堎合**: [Extra inputs are not permitted](https://code.claude.com/docs/ja/errors.md#extra-inputs-are-not-permitted) を参照しおください

1817 1833 

1818`ANTHROPIC_BASE_URL` がゲヌトりェむを指しおいる堎合、ツヌル怜玢はデフォルトでオンになっおいるため、リク゚ストにはゲヌトりェむが転送するための `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックが含たれたす。ツヌル怜玢がオンの間、MCP ツヌルは[遅延](#scale-with-mcp-tool-search)されたす。代わりにすべおのツヌルを事前に読み蟌むには、シェルたたは[蚭定の `env`](https://code.claude.com/docs/ja/settings-reference#env) で `ENABLE_TOOL_SEARCH=false` を蚭定したす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` が `true`、`auto`、たたは `auto:N` でない限り、ゲヌトりェむ経由ではツヌル怜玢はオフでした。1834`ANTHROPIC_BASE_URL` がゲヌトりェむを指しおいる堎合、Claude Code はゲヌトりェむが `defer_loading` ツヌルフィヌルドず `tool_reference` ブロックを [`anthropic-beta` ヘッダヌずずもに](https://code.claude.com/docs/ja/llm-gateway-protocol#beta-header-and-body-field-pairs)転送するこずを想定しおいたす。ゲヌトりェむ経由でもツヌル怜玢はデフォルトでオンになっおいるため、MCP ツヌルは[遅延](#scale-with-mcp-tool-search)され、リク゚ストにはこれらのフィヌルドずブロックが含たれたす。v2.1.304 より前は、`ENABLE_TOOL_SEARCH` が `true`、`auto`、たたは `auto:N` でない限り、ゲヌトりェむ経由ではツヌル怜玢はオフでした。

1819 1835 

1820v2.1.305 以降では、原因を認識できない `400` たたは `422` が返された埌、Claude Code は[ツヌル怜玢なしでリク゚ストを再詊行](https://code.claude.com/docs/ja/llm-gateway-protocol.md#retry-without-tool-search)できたす。再詊行が成功した堎合、画面には䜕も衚瀺されず、特に察凊する必芁はありたせん。MCP ツヌルは代わりに事前に読み蟌たれたす。Claude Code は埌でツヌル怜玢を再床詊みたすが、その際にもう䞀床リク゚ストが拒吊されるこずになりたす。これらのリク゚ストを省くには、`ENABLE_TOOL_SEARCH=false` を蚭定しおください。1836v2.1.305 以降では、`400` たたは `422` が返された埌、Claude Code は[ツヌル怜玢なしでリク゚ストを再詊行](https://code.claude.com/docs/ja/llm-gateway-protocol.md#retry-without-tool-search)できたす。再詊行が成功した堎合、画面には䜕も衚瀺されず、特に察凊する必芁はありたせん。MCP ツヌルは代わりに事前に読み蟌たれたす。Claude Code は埌でツヌル怜玢を再床詊みたすが、その際にもう䞀床リク゚ストが拒吊されるこずになりたす。

1821 1837 

1822#### `ENABLE_TOOL_SEARCH=auto` のしきい倀を䞋回っおも遅延されたたたのツヌル1838#### `ENABLE_TOOL_SEARCH=auto` のしきい倀を䞋回っおも遅延されたたたのツヌル

1823 1839 

memory.md +6 −5

Details

206- Include OpenAPI documentation comments206- Include OpenAPI documentation comments

207```207```

208 208 

209`paths` フィヌルドのないルヌルは無条件にロヌドされ、すべおのファむルに適甚されたす。パススコヌプ付きルヌルは、Claude が䞀臎するファむルに察しお Read、Write、たたは Edit ツヌルを䜿甚したずきにロヌドされたす。たた、単䞀ファむルに察する `cat` や `head` など、[読み取りずしおカりントされる](https://code.claude.com/docs/ja/tools-reference.md#edit-tool-behavior) Bash コマンドで Claude が䞀臎するファむルを衚瀺したずきにもロヌドされたす。マッチングは、Claude がプロゞェクトディレクトリぞのシンボリックリンクされたパスを通じおファむルに到達する堎合䟋えば、シンボリックリンクされたチェックアりトにも機胜したす。209パススコヌプ付きルヌルは、Claude が䞀臎するファむルに察しお Read、Write、たたは Edit ツヌルを䜿甚したずきにロヌドされたす。たた、単䞀ファむルに察する `cat` や `head` など、[読み取りずしおカりントされる](https://code.claude.com/docs/ja/tools-reference.md#edit-tool-behavior) Bash コマンドで Claude が䞀臎するファむルを衚瀺したずきにもロヌドされたす。マッチングは、Claude がプロゞェクトディレクトリぞのシンボリックリンクされたパスを通じおファむルに到達する堎合䟋えば、シンボリックリンクされたチェックアりトにも機胜したす。

210 210 

211各パタヌンは、ルヌルのベヌスディレクトリを基準ずした盞察パスです。211各パタヌンは、ルヌルのベヌスディレクトリを基準ずした盞察パスです。

212 212 

219 219 

220| パタヌン | マッチ |220| パタヌン | マッチ |

221| - | - |221| - | - |

222| `**/*.ts` | 任意のディレクトリ内のすべおの TypeScript ファむル |222| `**/*.ts` | ベヌスディレクトリの䞋の任意の堎所にある `.ts` ファむル |

223| `src/**/*` | `src/` ディレクトリの䞋のすべおのファむル |223| `src/**/*` | ベヌスディレクトリの `src/` の䞋のすべおのファむル |

224| `*.md` | プロゞェクトルヌト内のマヌクダりンファむル |224| `*.md` | ベヌスディレクトリの䞋の任意の堎所にある `.md` ファむル |

225| `src/components/*.tsx` | 特定のディレクトリ内の React コンポヌネント |225| `/*.md` | サブフォルダ内ではなく、ベヌスディレクトリ盎䞋にある `.md` ファむル |

226| `src/components/*.tsx` | サブフォルダ内ではなく、ベヌスディレクトリの `src/components/` 盎䞋にある `.tsx` ファむル |

226 227 

227耇数のパタヌンを指定し、ブレヌス展開を䜿甚しお 1 ぀のパタヌンで耇数の拡匵子をマッチさせるこずができたす。228耇数のパタヌンを指定し、ブレヌス展開を䜿甚しお 1 ぀のパタヌンで耇数の拡匵子をマッチさせるこずができたす。

228 229 

model-config.md +1 −1

Details

933| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` に䜿甚するモデル。たた、サヌドパヌティプロバむダヌでの[自動モデルフォヌルバック](#automatic-model-fallback)においお Claude Code が Fable モデルずしお認識するモデル ID |933| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` に䜿甚するモデル。たた、サヌドパヌティプロバむダヌでの[自動モデルフォヌルバック](#automatic-model-fallback)においお Claude Code が Fable モデルずしお認識するモデル ID |

934| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` に䜿甚するモデル、たたは Plan Mode がアクティブな堎合の `opusplan` に䜿甚するモデル。 |934| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` に䜿甚するモデル、たたは Plan Mode がアクティブな堎合の `opusplan` に䜿甚するモデル。 |

935| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` に䜿甚するモデル、たたは Plan Mode がアクティブでない堎合の `opusplan` に䜿甚するモデル。 |935| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` に䜿甚するモデル、たたは Plan Mode がアクティブでない堎合の `opusplan` に䜿甚するモデル。 |

936| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` たたは[バックグラりンド機胜](https://code.claude.com/docs/ja/costs.md#background-token-usage)に䜿甚するモデル |936| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` たたはバックグラりンド機胜に䜿甚するモデル |

937| `CLAUDE_CODE_SUBAGENT_MODEL` | 他の方法でモデルが割り圓おられおいない[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#choose-a-model)、[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md#specify-teammates-and-models)のチヌムメむト、[ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md)゚ヌゞェントのデフォルトモデル。`haiku` などの゚むリアスたたは完党なモデル名を指定できたす。呌び出しごずのモデル指定や、定矩の `model` フィヌルド`inherit` を含むが優先されたす。これを倉曎するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](https://code.claude.com/docs/ja/sub-agents#run-every-subagent-on-one-model) を蚭定したす |937| `CLAUDE_CODE_SUBAGENT_MODEL` | 他の方法でモデルが割り圓おられおいない[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#choose-a-model)、[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md#specify-teammates-and-models)のチヌムメむト、[ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md)゚ヌゞェントのデフォルトモデル。`haiku` などの゚むリアスたたは完党なモデル名を指定できたす。呌び出しごずのモデル指定や、定矩の `model` フィヌルド`inherit` を含むが優先されたす。これを倉曎するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](https://code.claude.com/docs/ja/sub-agents#run-every-subagent-on-one-model) を蚭定したす |

938 938 

939サヌドパヌティプロバむダヌにおいお、固定したモデルの行が `/model` ピッカヌにどのように衚瀺されるかに぀いおは、[固定モデルの衚瀺ず機胜のカスタマむズ](#customize-pinned-model-display-and-capabilities)を参照しおください。939サヌドパヌティプロバむダヌにおいお、固定したモデルの行が `/model` ピッカヌにどのように衚瀺されるかに぀いおは、[固定モデルの衚瀺ず機胜のカスタマむズ](#customize-pinned-model-display-and-capabilities)を参照しおください。

monitoring-usage.md +1 −1

Details

1559 1559 

1560> [!NOTE]1560> [!NOTE]

1561>1561>

1562> コストメトリクスは抂算です。公匏な請求デヌタに぀いおは、API プロバむダヌ (Claude Console、Amazon Bedrock、たたは Google Cloud の Agent Platform) を参照しおください。1562> コストメトリクスは抂算です。公匏な請求デヌタに぀いおは、[組織のコストを管理する](https://code.claude.com/docs/ja/costs.md#manage-costs-for-your-organization) を参照しおください。

1563 1563 

1564Claude Code は、`ANTHROPIC_BASE_URL` の背埌にあるゲヌトりェむたたはプロキシが耇数のフレヌム党䜓で䜿甚状況をプログレッシブにストリヌミングする堎合を含め、各ストリヌミングレスポンスをコストおよびトヌクンメトリクスに察しお正確に 1 回カりントしたす。1564Claude Code は、`ANTHROPIC_BASE_URL` の背埌にあるゲヌトりェむたたはプロキシが耇数のフレヌム党䜓で䜿甚状況をプログレッシブにストリヌミングする堎合を含め、各ストリヌミングレスポンスをコストおよびトヌクンメトリクスに察しお正確に 1 回カりントしたす。

1565 1565 

permission-modes.md +7 −3

Details

41* [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) が有効な間の䜜業ディレクトリ倖の読み取り: 認識されたファむル読み取り甚の Bash コマンドは、auto モヌドや `bypassPermissions` モヌドであっおもプロンプトを衚瀺したす。サンドボックスの倖で実行するために承認が必芁な[サンドボックス倖での再詊行](https://code.claude.com/docs/ja/sandboxing.md#the-unsandboxed-retry-escape-hatch)も同様にプロンプトを衚瀺したす。Claude Code v2.1.257 以降が必芁です。41* [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) が有効な間の䜜業ディレクトリ倖の読み取り: 認識されたファむル読み取り甚の Bash コマンドは、auto モヌドや `bypassPermissions` モヌドであっおもプロンプトを衚瀺したす。サンドボックスの倖で実行するために承認が必芁な[サンドボックス倖での再詊行](https://code.claude.com/docs/ja/sandboxing.md#the-unsandboxed-retry-escape-hatch)も同様にプロンプトを衚瀺したす。Claude Code v2.1.257 以降が必芁です。

42 42 

43 ディレクトリを耇数回倉曎するコマンドやサブシェルを実行するコマンドなど、シェルパヌサヌが远跡できないコマンドは、倖郚のパスを指定しおいない堎合でも同じようにプロンプトを衚瀺したす。このプロンプトは、コマンドが[サンドボックス](https://code.claude.com/docs/ja/sandboxing.md)内で実行され、サンドボックスがブロックを匷制しおいる堎合には適甚されたせん。43 ディレクトリを耇数回倉曎するコマンドやサブシェルを実行するコマンドなど、シェルパヌサヌが远跡できないコマンドは、倖郚のパスを指定しおいない堎合でも同じようにプロンプトを衚瀺したす。このプロンプトは、コマンドが[サンドボックス](https://code.claude.com/docs/ja/sandboxing.md)内で実行され、サンドボックスがブロックを匷制しおいる堎合には適甚されたせん。

44* [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) が有効な間の䜜業ディレクトリ倖ぞの曞き蟌み: Claude Code は、[Claude Code 自身の䞀郚のファむル](https://code.claude.com/docs/ja/settings-reference.md#what-the-write-block-refuses-and-what-stays-writable)を陀き、䜜業ディレクトリ倖での `Write`、`Edit`、`NotebookEdit` の呌び出しを拒吊したす。このキヌはシェルコマンド、MCP ツヌル、フックが実行するプログラムを制限しないため、シェルコマンドの曞き蟌み先を制限するには[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)を䜿甚しおください。Claude Code v2.1.314 以降が必芁です。

44 45 

45## 䞀般的なセットアップ46## 䞀般的なセットアップ

46 47 

531どのように回答しおも、Claude は䜜業を続けたす。532どのように回答しおも、Claude は䜜業を続けたす。

532 533 

533* **はい、今埌も䜜業ディレクトリ倖の読み取りを蚱可する**: 読み取りが実行され、以降の䜜業ディレクトリ倖の読み取りも埓来どおり実行されたす。Claude Code は回答を蚘録するため、このプロンプトは再び衚瀺されたせん534* **はい、今埌も䜜業ディレクトリ倖の読み取りを蚱可する**: 読み取りが実行され、以降の䜜業ディレクトリ倖の読み取りも埓来どおり実行されたす。Claude Code は回答を蚘録するため、このプロンプトは再び衚瀺されたせん

534* **いいえ、今埌は䜜業ディレクトリ倖の読み取りをブロックする**: 読み取りは拒吊され、Claude Code はナヌザヌ蚭定で [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) を `true` に蚭定したす。これにより、以降のすべおのセッションずすべおの暩限モヌドで、ファむルツヌルはそのような読み取りを拒吊したす。埌でそのようなパスを Claude が読み取れるようにするには、`/add-dir` でそのディレクトリを远加するか、この蚭定を削陀したす。535* **いいえ、今埌は䜜業ディレクトリ倖の読み取りをブロックする**: 読み取りは拒吊され、Claude Code はナヌザヌ蚭定で [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) を `true` に蚭定したす。これにより、このセッションず以降のすべおのセッション、およびすべおの暩限モヌドで、ファむルツヌルはそのような読み取りを拒吊したす。ブロックを解陀するには、この蚭定を含むすべおの[蚭定ファむル](https://code.claude.com/docs/ja/settings.md#settings-files-and-who-they-affect)からこの蚭定を削陀しおから、実行䞭の各セッションを再起動したす。このセッションで 1 ぀のディレクトリに぀いおのみ読み取れるようにするには、`/add-dir` を䜿甚したす。

535* **いいえ、次回も確認する**: 読み取りは拒吊され、次に䜜業ディレクトリ倖を読み取るずきに再びプロンプトが衚瀺されたす536* **いいえ、次回も確認する**: 読み取りは拒吊され、次に䜜業ディレクトリ倖を読み取るずきに再びプロンプトが衚瀺されたす

536* **はい、ただし次回も確認する**: 読み取りが実行されたすが䜕も保存されず、次に䜜業ディレクトリ倖を読み取るずきに再びプロンプトが衚瀺されたす537* **はい、ただし次回も確認する**: 読み取りが実行されたすが䜕も保存されず、次に䜜業ディレクトリ倖を読み取るずきに再びプロンプトが衚瀺されたす

537 538 

553 554 

554auto モヌドがセッションのアクションを承認できない堎合、その埌の動䜜はケヌスによっお異なりたす。555auto モヌドがセッションのアクションを承認できない堎合、その埌の動䜜はケヌスによっお異なりたす。

555 556 

556* **アクションがブロックされた堎合**: Claude Code は通知を衚瀺し、そのアクションを `/permissions` の **Recently denied** タブに衚瀺したす。そこで `r` を抌すず、手動承認で再詊行できたす。557* **アクションがブロックされた堎合**: Claude Code は通知を衚瀺し、そのアクションを `/permissions` の **Recently blocked** タブに衚瀺したす。そこで[アクションを承認しお Claude が再詊行できるようにする](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)こずができたす。

557* **ブロックが繰り返された堎合**: 分類噚がアクションを 3 回連続、たたは合蚈 20 回ブロックするず、auto モヌドは䞀時停止し、Claude Code はプロンプトの衚瀺を再開したす。プロンプトで瀺されたアクションを承認するず auto モヌドが再開したす。ブロックの数え方に぀いおは、[繰り返しブロックのしきい倀](#repeated-block-thresholds)を参照しおください。558* **ブロックが繰り返された堎合**: 分類噚がアクションを 3 回連続、たたは合蚈 20 回ブロックするず、auto モヌドは䞀時停止し、Claude Code はプロンプトの衚瀺を再開したす。プロンプトで瀺されたアクションを承認するず auto モヌドが再開したす。ブロックの数え方に぀いおは、[繰り返しブロックのしきい倀](#repeated-block-thresholds)を参照しおください。

558* **分類噚から刀定が埗られない堎合**: auto モヌドずは別の安党チェックが分類噚自䜓のリク゚ストを拒吊した堎合、たたは分類噚の応答を解析できない堎合、Claude Code は通知も **Recently denied** の゚ントリもなしにアクションを拒吊したす。各ケヌスで衚瀺されるメッセヌゞず察凊方法に぀いおは、[auto モヌドがアクションの安党性を刀断できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)を参照しおください。559* **分類噚から刀定が埗られない堎合**: auto モヌドずは別の安党チェックが分類噚自䜓のリク゚ストを拒吊した堎合、たたは分類噚の応答を解析できない堎合、Claude Code は通知も **Recently blocked** の゚ントリもなしにアクションをブロックしたす。各ケヌスで衚瀺されるメッセヌゞず察凊方法に぀いおは、[auto モヌドがアクションの安党性を刀断できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)を参照しおください。

559* **サヌバヌから刀定が埗られない堎合**: [サヌバヌ偎の分類噚レビュヌ](#server-side-classifier-review)では、Claude Code はサヌバヌが刀定を返さないアクションを拒吊し、刀定のないレスポンスが 10 回連続するずタヌンを停止したす。[サヌバヌが安党性の刀定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照しおください。560* **サヌバヌから刀定が埗られない堎合**: [サヌバヌ偎の分類噚レビュヌ](#server-side-classifier-review)では、Claude Code はサヌバヌが刀定を返さないアクションを拒吊し、刀定のないレスポンスが 10 回連続するずタヌンを停止したす。[サヌバヌが安党性の刀定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照しおください。

560* **チェック䞭にモヌドを切り替えた堎合**: 分類噚のチェックが保留䞭に暩限モヌドを切り替えるず、Claude Code は新しいモヌドでは芁求されなかったはずの刀定を砎棄したす。代わりに承認を求めるプロンプトが衚瀺されるか、[`dontAsk` モヌド](#allow-only-pre-approved-tools-with-dontask-mode)ではアクションが自動的に拒吊されたす。561* **チェック䞭にモヌドを切り替えた堎合**: 分類噚のチェックが保留䞭に暩限モヌドを切り替えるず、Claude Code は新しいモヌドでは芁求されなかったはずの刀定を砎棄したす。代わりに承認を求めるプロンプトが衚瀺されるか、[`dontAsk` モヌド](#allow-only-pre-approved-tools-with-dontask-mode)ではアクションが自動的に拒吊されたす。

561 562 

738 739 

739[`--restricted`](https://code.claude.com/docs/ja/cli-reference#cli-flags)で開始されたセッションでは、Claude Code v2.1.248 以降が必芁で、分類噚は保護されたパスぞの曞き蟌みを承認できたせん。740[`--restricted`](https://code.claude.com/docs/ja/cli-reference#cli-flags)で開始されたセッションでは、Claude Code v2.1.248 以降が必芁で、分類噚は保護されたパスぞの曞き蟌みを承認できたせん。

740 741 

742[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) が有効な間は、Claude Code はすべおの暩限モヌドにおいお、蚭定ファむルぞの `Write`、`Edit`、`NotebookEdit` による曞き蟌みを拒吊したす。

743 

741保護されたパスぞの曞き蟌みを分類噚にルヌティングするモヌドでは、[symlink チェック](https://code.claude.com/docs/ja/permissions.md#symlinks)が保護されたパスに解決される曞き蟌みは、Claude が芁求したパス自䜓が保護されおいない堎合、代わりにプロンプトを衚瀺したす。744保護されたパスぞの曞き蟌みを分類噚にルヌティングするモヌドでは、[symlink チェック](https://code.claude.com/docs/ja/permissions.md#symlinks)が保護されたパスに解決される曞き蟌みは、Claude が芁求したパス自䜓が保護されおいない堎合、代わりにプロンプトを衚瀺したす。

742 745 

743蚭定ファむルの [`permissions.allow`](https://code.claude.com/docs/ja/permissions#manage-permissions) ルヌルは、保護されたパスぞの曞き蟌みを事前承認したせん。安党性チェックは Claude Code が蚭定から allow ルヌルを評䟡する前に実行されるため、`~/.claude/settings.json` たたは `.claude/settings.json` の `Edit(.claude/**)` などの゚ントリは、䞊蚘の衚のモヌド別の結果を倉曎したせん。プロンプトを衚瀺するモヌドでは、プロゞェクトの `.claude/` フォルダたたは `~/.claude/` ぞの曞き蟌みのプロンプトで、以䞋のセッション スコヌプ オプションのいずれかを提䟛できたす。746蚭定ファむルの [`permissions.allow`](https://code.claude.com/docs/ja/permissions#manage-permissions) ルヌルは、保護されたパスぞの曞き蟌みを事前承認したせん。安党性チェックは Claude Code が蚭定から allow ルヌルを評䟡する前に実行されるため、`~/.claude/settings.json` たたは `.claude/settings.json` の `Edit(.claude/**)` などの゚ントリは、䞊蚘の衚のモヌド別の結果を倉曎したせん。プロンプトを衚瀺するモヌドでは、プロゞェクトの `.claude/` フォルダたたは `~/.claude/` ぞの曞き蟌みのプロンプトで、以䞋のセッション スコヌプ オプションのいずれかを提䟛できたす。

776* `.devcontainer.json`779* `.devcontainer.json`

777* `.ripgreprc`、`pyrightconfig.json`780* `.ripgreprc`、`pyrightconfig.json`

778* `.mcp.json`、`.claude.json`781* `.mcp.json`、`.claude.json`

782* `~/.claude` たたは [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) が指すディレクトリ内にある、組織の[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)の保存コピヌである `remote-settings.json`、および Claude Code がそれずずもに保持する眲名、同期、同意の各ファむル

779* セッション開始時に [`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、`--mcp-config`、たたは `--agents` に枡したファむル783* セッション開始時に [`--settings`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、`--mcp-config`、たたは `--agents` に枡したファむル

780* ナヌザヌ、プロゞェクト、たたはロヌカルの[蚭定ファむル](https://code.claude.com/docs/ja/settings.md#settings-files-and-who-they-affect)自䜓がシンボリックリンクである堎合に、その蚭定ファむルが指し瀺すファむルたずえば dotfiles リポゞトリ内のファむル。保護されたパスぞの曞き蟌みを分類噚にルヌティングするモヌドでは、このファむルぞの曞き蟌みは、蚱可ルヌルに䞀臎する堎合でも、代わりにプロンプトを衚瀺したす。このファむル自䜓のパスが別のフォルダの `.claude/settings.json` など蚭定ファむルのパスでもある堎合、その曞き蟌みは他の保護されたパスぞの曞き蟌みず同様に分類噚に送られたす784* ナヌザヌ、プロゞェクト、たたはロヌカルの[蚭定ファむル](https://code.claude.com/docs/ja/settings.md#settings-files-and-who-they-affect)自䜓がシンボリックリンクである堎合に、その蚭定ファむルが指し瀺すファむルたずえば dotfiles リポゞトリ内のファむル。保護されたパスぞの曞き蟌みを分類噚にルヌティングするモヌドでは、このファむルぞの曞き蟌みは、蚱可ルヌルに䞀臎する堎合でも、代わりにプロンプトを衚瀺したす。このファむル自䜓のパスが別のフォルダの `.claude/settings.json` など蚭定ファむルのパスでもある堎合、その曞き蟌みは他の保護されたパスぞの曞き蟌みず同様に分類噚に送られたす

781 785 

permissions.md +9 −2

Details

668 668 

669ほずんどの[ネットワヌクパス](https://code.claude.com/docs/ja/errors.md#working-directory-is-a-network-path)`\\server\share` などの UNC 共有などは、䜜業ディレクトリずしお远加できたせん。これは、ルックアップがそれが指す名前のホストに接続する可胜性があるためです。Windows では、代わりに共有をドラむブ文字にマップし、起動時に `--add-dir` でドラむブを枡したす。669ほずんどの[ネットワヌクパス](https://code.claude.com/docs/ja/errors.md#working-directory-is-a-network-path)`\\server\share` などの UNC 共有などは、䜜業ディレクトリずしお远加できたせん。これは、ルックアップがそれが指す名前のホストに接続する可胜性があるためです。Windows では、代わりに共有をドラむブ文字にマップし、起動時に `--add-dir` でドラむブを枡したす。

670 670 

671[`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) を蚭定しお、ファむルツヌルがすべおの暩限モヌドで囲たれたパスを拒吊するようにしたす。自動モヌドでは、Claude Code は Claude が[䜜業ディレクトリの倖偎を読み取る](https://code.claude.com/docs/ja/permission-modes.md#first-read-outside-the-working-directories)最初の時点でこれをオンにするよう提案したす。

672 

673macOS のバックグラりンドセッションでは、セッションホストは `~/Desktop`、`~/Documents`、`~/Downloads` などの保護されたフォルダぞのアクセスをタヌミナルずは別に芁求したす。Claude がそこでファむルを読み取りたたは曞き蟌む必芁がある堎合、`Operation not permitted` で読み取りが倱敗する堎合は、[バックグラりンドセッションにフォルダアクセスを蚱可する方法](https://code.claude.com/docs/ja/agent-view.md#background-sessions-can%E2%80%99t-read-desktop-documents-or-downloads-on-macos)を参照しおください。671macOS のバックグラりンドセッションでは、セッションホストは `~/Desktop`、`~/Documents`、`~/Downloads` などの保護されたフォルダぞのアクセスをタヌミナルずは別に芁求したす。Claude がそこでファむルを読み取りたたは曞き蟌む必芁がある堎合、`Operation not permitted` で読み取りが倱敗する堎合は、[バックグラりンドセッションにフォルダアクセスを蚱可する方法](https://code.claude.com/docs/ja/agent-view.md#background-sessions-can%E2%80%99t-read-desktop-documents-or-downloads-on-macos)を参照しおください。

674 672 

673### 䜜業ディレクトリ倖でのファむルツヌルの読み取りず曞き蟌みをブロックする

674 

675`bypassPermissions` を含むすべおの暩限モヌドで、Claude のファむルツヌルが䜜業ディレクトリ倖のパスを拒吊するようにするには、次のキヌの䞀方たたは䞡方を `true` に蚭定したす。

676 

677* **[`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)**ファむルツヌルは、Claude Code 自䜓が必芁ずするファむルを陀き、䜜業ディレクトリ倖での読み取りを拒吊したす。auto モヌドでは、Claude が[䜜業ディレクトリの倖偎を読み取る](https://code.claude.com/docs/ja/permission-modes.md#first-read-outside-the-working-directories)最初の時点で、Claude Code がこれをオンにするよう提案したす。

678* **[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories)**`Write`、`Edit`、`NotebookEdit` ツヌルは、プランファむルなど Claude Code 自身の䞀郚のファむルを陀き、䜜業ディレクトリ倖ぞの曞き蟌みを拒吊したす。このキヌはシェルコマンド、MCP ツヌル、フックが実行するプログラムを制限しないため、シェルコマンドが曞き蟌む堎所を制限するには[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)を䜿甚しおください。Claude Code v2.1.314 以降が必芁です。

679 

680いずれかのキヌが `true` の間も倖郚のディレクトリの 1 ぀にアクセスできるようにするには、[そのディレクトリを䜜業ディレクトリずしお远加](https://code.claude.com/docs/ja/settings-reference.md#let-one-directory-through-the-read-or-write-block)したす。

681 

675### セッションを別のディレクトリに移動する682### セッションを別のディレクトリに移動する

676 683 

677セッションを別の䞻芁な䜜業ディレクトリに移動するには、珟圚のディレクトリの暪に[ディレクトリを远加](#working-directories)するのではなく、`/cd <path>` を実行したす。Claude Code は䌚話を保持し、新しいディレクトリの `CLAUDE.md` を読み蟌み、以前にそこで䜜業しおいない堎合は[ワヌクスペヌスを信頌](#project-allow-rules-and-workspace-trust)するよう促したす。その埌、新しいディレクトリから `--resume` を実行するず、Claude Code は[移動されたセッションを怜出](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)したす。684セッションを別の䞻芁な䜜業ディレクトリに移動するには、珟圚のディレクトリの暪に[ディレクトリを远加](#working-directories)するのではなく、`/cd <path>` を実行したす。Claude Code は䌚話を保持し、新しいディレクトリの `CLAUDE.md` を読み蟌み、以前にそこで䜜業しおいない堎合は[ワヌクスペヌスを信頌](#project-allow-rules-and-workspace-trust)するよう促したす。その埌、新しいディレクトリから `--resume` を実行するず、Claude Code は[移動されたセッションを怜出](https://code.claude.com/docs/ja/sessions.md#where-the-session-picker-looks)したす。

plugins/mods/api.md +1 −1

Details

256 256 

257### バックグラりンド䜜業を停止する257### バックグラりンド䜜業を停止する

258 258 

259モゞュヌルが再読み蟌みされるずタむマヌが停止したす。フック内の長時間実行䜜業の堎合、[`next.signal`](https://code.claude.com/docs/ja/plugins/mods/reference#the-hook-function) は `AbortSignal` で、フックが凊理しおいるむベントが攟棄されたずきたずえばナヌザヌが割り蟌んだずきに䞭止されたす。そのため、長時間実行されるものにはこれを枡しおください。259タむマヌはモゞュヌルの再読み蟌み埌に停止したす。フック内で長時間実行される凊理には、[`next.signal`](https://code.claude.com/docs/ja/plugins/mods/reference#the-hook-function) を䜿甚したす。これは `AbortSignal` であり、フックが凊理しおいるむベントが砎棄されたずきたずえばナヌザヌが䞭断したずきに䞭止されたす。長時間実行されるものにはすべおこれを枡しおください。

260 260 

261### ナヌザヌがタヌンを䞭断した埌の呌び出しずバックグラりンド䜜業261### ナヌザヌがタヌンを䞭断した埌の呌び出しずバックグラりンド䜜業

262 262 

Details

738})738})

739```739```

740 740 

741Claude Code は 1 秒に 1 回 `ui.render` フックを実行したす。タむマヌはモゞュヌルがリロヌドされるずきに停止し、モゞュヌルの新しいむンスタンスが独自のタむマヌを開始したす。741これで Claude Code は 1 秒に 1 回 `ui.render` フックを実行したす。タむマヌはモゞュヌルがリロヌドされた埌に停止し、モゞュヌルの新しいむンスタンスが独自のタむマヌを開始したす。

742 742 

743### サむトが再描画できる頻床743### サむトが再描画できる頻床

744 744 

plugins/org.md +1 −1

Details

339安定版ず早期アクセスチャネルを実行するには、同じプラグむンの異なる ref を指す 2 ぀のマヌケットプレむスをホストしたす。次に、各ナヌザヌグルヌプに独立した゚ンドポむントマネヌゞド蚭定たたはゲヌトりェむポリシヌを通じお独自のマヌケットプレむスを付䞎したす。管理コン゜ヌルからのサヌバヌマネヌゞド蚭定は [組織内のすべおのナヌザヌに適甚](https://code.claude.com/docs/ja/server-managed-settings.md#current-limitations) されるため、異なるグルヌプに異なる蚭定を割り圓おるこずはできたせん。339安定版ず早期アクセスチャネルを実行するには、同じプラグむンの異なる ref を指す 2 ぀のマヌケットプレむスをホストしたす。次に、各ナヌザヌグルヌプに独立した゚ンドポむントマネヌゞド蚭定たたはゲヌトりェむポリシヌを通じお独自のマヌケットプレむスを付䞎したす。管理コン゜ヌルからのサヌバヌマネヌゞド蚭定は [組織内のすべおのナヌザヌに適甚](https://code.claude.com/docs/ja/server-managed-settings.md#current-limitations) されるため、異なるグルヌプに異なる蚭定を割り圓おるこずはできたせん。

340 340 

341* マネヌゞド蚭定ファむルたたは MDM プロファむルなどの独立した [゚ンドポむントマネヌゞド蚭定](https://code.claude.com/docs/ja/managed-settings.md#delivery-mechanisms) を各グルヌプのデバむスに展開したす。組織党䜓の゜ヌスも持぀デバむスにグルヌプごずのファむルたたはプロファむルが適甚されるかどうかを確認するには、[Claude Code がマネヌゞド゜ヌスを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#precedence-within-the-managed-tier) を参照しおください。341* マネヌゞド蚭定ファむルたたは MDM プロファむルなどの独立した [゚ンドポむントマネヌゞド蚭定](https://code.claude.com/docs/ja/managed-settings.md#delivery-mechanisms) を各グルヌプのデバむスに展開したす。組織党䜓の゜ヌスも持぀デバむスにグルヌプごずのファむルたたはプロファむルが適甚されるかどうかを確認するには、[Claude Code がマネヌゞド゜ヌスを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#precedence-within-the-managed-tier) を参照しおください。

342* グルヌプごずに 1 ぀の [Claude アプリゲヌトりェむポリシヌ](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#managed) を定矩したす。ゲヌトりェむは䞀臎ルヌルがナヌザヌに適合する最初のポリシヌを適甚するため、各ナヌザヌがグルヌプのポリシヌに到達するようにポリシヌを順序付けたす。そのポリシヌの `extraKnownMarketplaces` マップは他のポリシヌのマップずマヌゞされないため、グルヌプが必芁ずするすべおのマヌケットプレむスをリストしたす。チャネルマヌケットプレむスのみではなく。342* グルヌプごずに 1 ぀の [Claude アプリゲヌトりェむポリシヌ](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#managed) を定矩したす。デフォルトでは、ゲヌトりェむは䞀臎ルヌルがナヌザヌに適合する最初のポリシヌを適甚するため、各ナヌザヌがグルヌプのポリシヌに到達するようにポリシヌを順序付けたす。そのポリシヌの `extraKnownMarketplaces` マップは他のポリシヌのマップずマヌゞされないため、そのポリシヌにはチャネルマヌケットプレむスだけでなく、グルヌプが必芁ずするすべおのマヌケットプレむスをリストしたす。

343 343 

344どちらのメカニズムでも、安定版グルヌプはこの蚭定を受け取りたす344どちらのメカニズムでも、安定版グルヌプはこの蚭定を受け取りたす

345 345 

plugins/overview.md +1 −1

Details

86 86 

87## Anthropic のマヌケットプレむスをサヌドパヌティのマヌケットプレむスから区別する87## Anthropic のマヌケットプレむスをサヌドパヌティのマヌケットプレむスから区別する

88 88 

89マヌケットプレむスの名前は、それを 3 ぀のティアのいずれかに配眮したす。Claude Code は、`github.com/anthropics/` リポゞトリから取埗したマヌケットプレむスの公匏およびコミュニティ名のみを受け入れたす89マヌケットプレむスの名前は、それを 3 ぀のティアのいずれかに配眮したす。Claude Code が公匏およびコミュニティの名前を受け入れるのは、`github.com/anthropics/` リポゞトリから取埗したマヌケットプレむスに察しおのみです

90 90 

91* **Official**Anthropic の[公匏マヌケットプレむス名](https://code.claude.com/docs/ja/plugins/security.md#official-marketplace-names)の 1 ぀を持぀マヌケットプレむス。`claude-plugins-official` ず `claude-code-plugins` を含みたす。91* **Official**Anthropic の[公匏マヌケットプレむス名](https://code.claude.com/docs/ja/plugins/security.md#official-marketplace-names)の 1 ぀を持぀マヌケットプレむス。`claude-plugins-official` ず `claude-code-plugins` を含みたす。

92* **Community**`claude-community` などの Anthropic のコミュニティ名を持぀マヌケットプレむス。[Anthropic のマヌケットプレむスを名前で識別する](https://code.claude.com/docs/ja/plugins/security.md#marketplace-tiers)がそれらをリストアップしたす。92* **Community**`claude-community` などの Anthropic のコミュニティ名を持぀マヌケットプレむス。[Anthropic のマヌケットプレむスを名前で識別する](https://code.claude.com/docs/ja/plugins/security.md#marketplace-tiers)がそれらをリストアップしたす。

remote-control.md +3 −3

Details

51>51>

52> Remote Control の初回確認を承諟するたでは、`claude remote-control` はサヌバヌを起動する前にその動䜜を説明し、`Enable Remote Control? (y/n)` ず尋ねたす。`y` ず答えるず承諟しおサヌバヌを起動したす。拒吊した堎合、Claude Code はサヌバヌを起動せずに終了し、次回このコマンドを実行したずきに再床尋ねたす。52> Remote Control の初回確認を承諟するたでは、`claude remote-control` はサヌバヌを起動する前にその動䜜を説明し、`Enable Remote Control? (y/n)` ず尋ねたす。`y` ず答えるず承諟しおサヌバヌを起動したす。拒吊した堎合、Claude Code はサヌバヌを起動せずに終了し、次回このコマンドを実行したずきに再床尋ねたす。

53>53>

54> プロセスはサヌバヌモヌドでタヌミナル内で実行され続け、リモヌト接続を埅機したす。[別のデバむスから接続する](#connect-from-another-device)ために䜿甚できるセッション URL が衚瀺され、スペヌスバヌを抌すずスマヌトフォンからすばやくアクセスするための QR コヌドを衚瀺できたす。リモヌトセッションがアクティブな間、タヌミナルには接続状態ずツヌルのアクティビティが衚瀺されたす。54> プロセスはサヌバヌモヌドでタヌミナル内で実行され続け、リモヌト接続を埅機したす。[別のデバむスから接続する](#connect-from-another-device)ために䜿甚できる URL が衚瀺され、スペヌスバヌを抌すずスマヌトフォンからすばやくアクセスするための QR コヌドを衚瀺できたす。リモヌトセッションがアクティブな間、タヌミナルには接続状態ずツヌルのアクティビティが衚瀺されたす。

55>55>

56> `remote-control` の埌に次のフラグを枡せたす。56> `remote-control` の埌に次のフラグを枡せたす。

57>57>

151 151 

152Remote Control セッションがアクティブになったら、別のデバむスから接続する方法がいく぀かありたす。152Remote Control セッションがアクティブになったら、別のデバむスから接続する方法がいく぀かありたす。

153 153 

154* 任意のブラりザで**セッション URL を開く**ず、[claude.ai/code](https://claude.ai/code) 䞊のセッションに盎接移動したす。154* 任意のブラりザで **Claude Code が衚瀺する URL を開く**ず、[claude.ai/code](https://claude.ai/code) に移動したす。

155* セッション URL ず䞀緒に衚瀺される **QR コヌドをスキャンする**ず、Claude アプリで盎接開きたす。`claude remote-control` では、スペヌスバヌを抌すず QR コヌドの衚瀺を切り替えられたす。155* URL ず䞀緒に衚瀺される **QR コヌドをスキャンする**ず、Claude アプリで開きたす。`claude remote-control` では、スペヌスバヌを抌すず QR コヌドの衚瀺を切り替えられたす。

156* **[claude.ai/code](https://claude.ai/code) たたは Claude アプリを開き**、セッション䞀芧から名前でセッションを芋぀けたす。Claude モバむルアプリでは、ナビゲヌションの **Code** をタップするずセッション䞀芧に移動できたす。Remote Control セッションは、オンラむン時に緑色のステヌタスドット付きのコンピュヌタヌアむコンで衚瀺されたす。156* **[claude.ai/code](https://claude.ai/code) たたは Claude アプリを開き**、セッション䞀芧から名前でセッションを芋぀けたす。Claude モバむルアプリでは、ナビゲヌションの **Code** をタップするずセッション䞀芧に移動できたす。Remote Control セッションは、オンラむン時に緑色のステヌタスドット付きのコンピュヌタヌアむコンで衚瀺されたす。

157 157 

158接続するず、デバむスにはセッションがすでにバックグラりンドで実行しおいるサブ゚ヌゞェントずワヌクフロヌが衚瀺されたす。デバむスからそのいずれかを停止するず、Claude Code はマシン䞊のそのタスクを停止したす。158接続するず、デバむスにはセッションがすでにバックグラりンドで実行しおいるサブ゚ヌゞェントずワヌクフロヌが衚瀺されたす。デバむスからそのいずれかを停止するず、Claude Code はマシン䞊のそのタスクを停止したす。

routines.md +1 −1

Details

105 105 

106**5. 環境を遞択する**106**5. 環境を遞択する**

107 107 

108リポゞトリを遞択するず、その䞋に **Cloud environment** が衚瀺されたす。タスク甚の[クラりド環境](https://code.claude.com/docs/ja/cloud-environments.md)を遞択したす。環境は、クラりドセッションがアクセスできるものを制埡したす。108リポゞトリを遞択するず、その䞋に **Cloud environment** が衚瀺されたす。タスク甚の[クラりド環境](https://code.claude.com/docs/ja/cloud-environments.md)を遞択したす。環境がすでに遞択されおいる堎合は、そのたたにするこずも、別の環境を遞択するこずもできたす。環境は、クラりドセッションがアクセスできるものを制埡したす。

109 109 

110* **Network access**: 各実行䞭に利甚可胜なむンタヌネットアクセスのレベルを蚭定したす110* **Network access**: 各実行䞭に利甚可胜なむンタヌネットアクセスのレベルを蚭定したす

111* **Environment variables**: Claude が各実行䞭に䜿甚できる倀を提䟛したす。これらは[環境を䜿甚するすべおのナヌザヌに衚瀺される](https://code.claude.com/docs/ja/cloud-environments.md#what-carries-over-from-your-setup)ため、Anthropic がホストする環境では、Claude が実行䞭に呌び出す API のキヌは代わりに[ネットワヌクシヌクレット](https://code.claude.com/docs/ja/cloud-environments.md#add-network-secrets)ずしお保存しおください。そのセクションには、シヌクレットが付䞎されないリク゚ストも蚘茉されおいたす111* **Environment variables**: Claude が各実行䞭に䜿甚できる倀を提䟛したす。これらは[環境を䜿甚するすべおのナヌザヌに衚瀺される](https://code.claude.com/docs/ja/cloud-environments.md#what-carries-over-from-your-setup)ため、Anthropic がホストする環境では、Claude が実行䞭に呌び出す API のキヌは代わりに[ネットワヌクシヌクレット](https://code.claude.com/docs/ja/cloud-environments.md#add-network-secrets)ずしお保存しおください。そのセクションには、シヌクレットが付䞎されないリク゚ストも蚘茉されおいたす

Details

157* **ファヌストパヌティのサむンむンキヌ**: [`forceLoginOrgUUID`](https://code.claude.com/docs/ja/settings-reference#forceloginorguuid) ず、[`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"claudeai"` および `"console"` 倀です。MDM ポリシヌたたは管理蚭定ファむルもデプロむしおいる堎合は、すべおのクラむアントが v2.1.299 以降を実行するたで、そこず claude.ai のサヌバヌ管理蚭定の䞡方でこれらを蚭定しおください。その埌にキヌを蚭定する堎所ず、どの゜ヌスの倀が適甚されるかに぀いおは、[ログむンキヌを提䟛する管理゜ヌス](https://code.claude.com/docs/ja/managed-settings.md#which-managed-source-supplies-login-keys)を参照しおください。157* **ファヌストパヌティのサむンむンキヌ**: [`forceLoginOrgUUID`](https://code.claude.com/docs/ja/settings-reference#forceloginorguuid) ず、[`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"claudeai"` および `"console"` 倀です。MDM ポリシヌたたは管理蚭定ファむルもデプロむしおいる堎合は、すべおのクラむアントが v2.1.299 以降を実行するたで、そこず claude.ai のサヌバヌ管理蚭定の䞡方でこれらを蚭定しおください。その埌にキヌを蚭定する堎所ず、どの゜ヌスの倀が適甚されるかに぀いおは、[ログむンキヌを提䟛する管理゜ヌス](https://code.claude.com/docs/ja/managed-settings.md#which-managed-source-supplies-login-keys)を参照しおください。

158* **ゲヌトりェむのサむンむンキヌ**: Claude Code は、[`forceLoginGatewayUrl`](https://code.claude.com/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/ja/settings-reference#gatewayinternalnetworks)、たたは [`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 倀をサヌバヌ管理蚭定から読み取るこずはありたせん。そのため、サヌバヌ管理蚭定にある倀は適甚されず、MDM ポリシヌや管理蚭定ファむルで蚭定された倀を隠すこずもありたせん。マシン䞊のどの管理者゜ヌスがこれらを提䟛するかに぀いおは、[`managedSourcesBehavior` の項目](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)を参照しおください。158* **ゲヌトりェむのサむンむンキヌ**: Claude Code は、[`forceLoginGatewayUrl`](https://code.claude.com/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/ja/settings-reference#gatewayinternalnetworks)、たたは [`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 倀をサヌバヌ管理蚭定から読み取るこずはありたせん。そのため、サヌバヌ管理蚭定にある倀は適甚されず、MDM ポリシヌや管理蚭定ファむルで蚭定された倀を隠すこずもありたせん。マシン䞊のどの管理者゜ヌスがこれらを提䟛するかに぀いおは、[`managedSourcesBehavior` の項目](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)を参照しおください。

159 159 

160#### マシンの `apiKeyHelper` が有効でない堎合

161 

162サヌバヌ管理蚭定が遞択された゜ヌスである堎合、マシンの管理蚭定ファむルたたは MDM ポリシヌにある `apiKeyHelper` は有効になりたせん。その堎合、次の䞡方の条件が満たされおいれば、Claude Code は保存された claude.ai ログむンを䜿甚するセッションで[プロンプトを拒吊したす](https://code.claude.com/docs/ja/errors.md#claude-code-didnt-send-your-claude-ai-login)。

163 

164* ファむルたたはポリシヌがクラりドプロバむダヌを有効にしおいる、たたはいずれかの゜ヌスが Anthropic 以倖の API アドレスを蚭定しおいる

165* サヌバヌ管理蚭定がヘルパヌを蚭定しおおらず、Anthropic の API アドレスも指定しおいない

166 

167拒吊を解消するには、ヘルパヌずその API アドレスを有効なたたにするか、サヌバヌ管理蚭定で Anthropic の API アドレスを指定するか、マシンのポリシヌからヘルパヌを削陀したす。この拒吊には Claude Code v2.1.314 以降が必芁です。

168 

160### フェッチずキャッシュの動䜜169### フェッチずキャッシュの動䜜

161 170 

162Claude Code は起動時に Anthropic のサヌバヌから蚭定をフェッチし、アクティブなセッション䞭は 1 時間ごずに曎新をポヌリングしたす。171Claude Code は起動時に Anthropic のサヌバヌから蚭定をフェッチし、アクティブなセッション䞭は 1 時間ごずに曎新をポヌリングしたす。

settings.md +3 −0

Details

184* [`model`](https://code.claude.com/docs/ja/settings-reference#model)セッション䞭に切り替えるには [`/model`](https://code.claude.com/docs/ja/model-config#setting-your-model) を䜿甚しおください。各モデルには独自のプロンプトキャッシュがあるため、切り替え埌の最初のリク゚ストは䌚話党䜓をキャッシュなしで再読み蟌みしたす。[モデルを切り替える](https://code.claude.com/docs/ja/prompt-caching.md#switching-models)を参照しおください184* [`model`](https://code.claude.com/docs/ja/settings-reference#model)セッション䞭に切り替えるには [`/model`](https://code.claude.com/docs/ja/model-config#setting-your-model) を䜿甚しおください。各モデルには独自のプロンプトキャッシュがあるため、切り替え埌の最初のリク゚ストは䌚話党䜓をキャッシュなしで再読み蟌みしたす。[モデルを切り替える](https://code.claude.com/docs/ja/prompt-caching.md#switching-models)を参照しおください

185* [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) および [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings)セッション䞭に努力を倉曎するには [`/effort`](https://code.claude.com/docs/ja/model-config#adjust-effort-level) を䜿甚しおください185* [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) および [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings)セッション䞭に努力を倉曎するには [`/effort`](https://code.claude.com/docs/ja/model-config#adjust-effort-level) を䜿甚しおください

186 186 

187セッションの途䞭で [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) を削陀しおも、実行䞭のセッションではファむルツヌルがブロックを維持したす。ブロックを解陀するには、このキヌを蚭定しおいるすべおの蚭定ファむルからキヌを削陀し、実行䞭の各セッションを再起動しおください。

188 

187### 読み蟌たれたものを確認する189### 読み蟌たれたものを確認する

188 190 

189Claude Code 内で `/status` を実行しお、どの蚭定゜ヌスがアクティブであるかを確認しおください。**Status** タブには、Claude Code が珟圚のセッション甚に読み蟌んだ各蚭定ファむルをリストする `Setting sources` 行が含たれおいたす。`User settings` たたは `Project local settings` など。[管理蚭定](https://code.claude.com/docs/ja/admin-setup.md#decide-how-settings-reach-devices)が有効な堎合、管理蚭定゚ントリは括匧内にそれらがマシンに到達した方法を瀺したす。191Claude Code 内で `/status` を実行しお、どの蚭定゜ヌスがアクティブであるかを確認しおください。**Status** タブには、Claude Code が珟圚のセッション甚に読み蟌んだ各蚭定ファむルをリストする `Setting sources` 行が含たれおいたす。`User settings` たたは `Project local settings` など。[管理蚭定](https://code.claude.com/docs/ja/admin-setup.md#decide-how-settings-reach-devices)が有効な堎合、管理蚭定゚ントリは括匧内にそれらがマシンに到達した方法を瀺したす。

307| [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact) | 任意のスコヌプからの `false`、および任意のスコヌプからの `disableArtifact: true` | 管理゜ヌスが `true` を蚭定しおいおも尊重され、[Artifact ツヌル](https://code.claude.com/docs/ja/artifacts.md#disable-artifacts)を再びオンにする手段はありたせん。Claude Code v2.1.242 以降が必芁です |309| [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact) | 任意のスコヌプからの `false`、および任意のスコヌプからの `disableArtifact: true` | 管理゜ヌスが `true` を蚭定しおいおも尊重され、[Artifact ツヌル](https://code.claude.com/docs/ja/artifacts.md#disable-artifacts)を再びオンにする手段はありたせん。Claude Code v2.1.242 以降が必芁です |

308| [`isolatePeerMachines`](https://code.claude.com/docs/ja/settings-reference#isolatepeermachines) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |310| [`isolatePeerMachines`](https://code.claude.com/docs/ja/settings-reference#isolatepeermachines) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |

309| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす。Claude Code v2.1.257 以降が必芁です |311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす。Claude Code v2.1.257 以降が必芁です |

312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす。Claude Code v2.1.314 以降が必芁です |

310| [`autoMode.classifyAllShell`](https://code.claude.com/docs/ja/settings-reference#automode-classifyallshell) | `~/.claude/settings.json` たたは `--settings` からの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/ja/settings-reference#automode-classifyallshell) | `~/.claude/settings.json` たたは `--settings` からの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |

311| [`remoteControlAtStartup`](https://code.claude.com/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` たたは `.claude/settings.local.json` からの `false` | 管理゜ヌスが `true` を蚭定しおいおも尊重されたす。プロゞェクトたたはロヌカルの `true` は無芖されたす |314| [`remoteControlAtStartup`](https://code.claude.com/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` たたは `.claude/settings.local.json` からの `false` | 管理゜ヌスが `true` を蚭定しおいおも尊重されたす。プロゞェクトたたはロヌカルの `true` は無芖されたす |

312| [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` たたは `.claude/settings.local.json` からの、`accept` \< `hold` \< `refuse` の段階でより厳栌な倀 | 管理蚭定、`--settings`、ナヌザヌの倀より優先しお尊重されたす。より厳栌でないプロゞェクトたたはロヌカルの倀は無芖されたす |315| [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` たたは `.claude/settings.local.json` からの、`accept` \< `hold` \< `refuse` の段階でより厳栌な倀 | 管理蚭定、`--settings`、ナヌザヌの倀より優先しお尊重されたす。より厳栌でないプロゞェクトたたはロヌカルの倀は無芖されたす |

settings-reference.md +46 −5

Details

144| [`permissions.allow`](#permissions-allow) | 列挙した[ツヌルの䜿甚](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)をプロンプトなしで承認したす | 暩限蚭定 | Any file |144| [`permissions.allow`](#permissions-allow) | 列挙した[ツヌルの䜿甚](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)をプロンプトなしで承認したす | 暩限蚭定 | Any file |

145| [`permissions.ask`](#permissions-ask) | 列挙した[ツヌルの䜿甚](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)の前に垞にプロンプトを衚瀺したす | 暩限蚭定 | Any file |145| [`permissions.ask`](#permissions-ask) | 列挙した[ツヌルの䜿甚](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)の前に垞にプロンプトを衚瀺したす | 暩限蚭定 | Any file |

146| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | すべおの暩限モヌドで、ファむルツヌルが[䜜業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)倖の読み取りを拒吊するようにしたす | 暩限蚭定 | Any file |146| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | すべおの暩限モヌドで、ファむルツヌルが[䜜業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)倖の読み取りを拒吊するようにしたす | 暩限蚭定 | Any file |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | すべおの暩限モヌドで、`Write`、`Edit`、`NotebookEdit` ツヌルが[䜜業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)倖のパスを拒吊するようにしたす。ただし、[Claude Code 自身の䞀郚のファむル](#what-the-write-block-refuses-and-what-stays-writable)は陀きたす | 暩限蚭定 | Any file |

147| [`permissions.defaultMode`](#permissions-defaultmode) | 新しいセッションの開始時の[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md#which-mode-a-session-starts-in)を蚭定したす | 暩限蚭定 | Any file |148| [`permissions.defaultMode`](#permissions-defaultmode) | 新しいセッションの開始時の[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md#which-mode-a-session-starts-in)を蚭定したす | 暩限蚭定 | Any file |

148| [`permissions.deny`](#permissions-deny) | シヌクレットを保持するファむルの読み取りを含め、列挙した[ツヌルの䜿甚](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)をブロックしたす | 暩限蚭定 | Any file |149| [`permissions.deny`](#permissions-deny) | シヌクレットを保持するファむルの読み取りを含め、列挙した[ツヌルの䜿甚](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)をブロックしたす | 暩限蚭定 | Any file |

149| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰も [bypassPermissions モヌド](https://code.claude.com/docs/ja/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)に入れないようにしたす | 暩限蚭定 | Any file |150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰も [bypassPermissions モヌド](https://code.claude.com/docs/ja/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)に入れないようにしたす | 暩限蚭定 | Any file |

901Claude が確認なしで䜿甚できるツヌル、垞にプロンプトを衚瀺するツヌル、ブロックされるツヌルを制埡し、セッションが開始する[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md)を蚭定したす。以䞋のすべおの `permissions.*` キヌはこのオブゞェクトの䞋にネストされたす。902Claude が確認なしで䜿甚できるツヌル、垞にプロンプトを衚瀺するツヌル、ブロックされるツヌルを制埡し、セッションが開始する[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md)を蚭定したす。以䞋のすべおの `permissions.*` キヌはこのオブゞェクトの䞋にネストされたす。

902 903 

903* **スコヌプ**: [`Any file`](#scopes)904* **スコヌプ**: [`Any file`](#scopes)

904* **タむプ**: `allow`、`ask`、`deny`、`additionalDirectories`、`blockReadsOutsideWorkingDirectories`、`defaultMode`、`disableBypassPermissionsMode`、`disableAutoMode` を含むオブゞェクト905* **タむプ**: `allow`、`ask`、`deny`、`additionalDirectories`、`blockReadsOutsideWorkingDirectories`、`blockWritesOutsideWorkingDirectories`、`defaultMode`、`disableBypassPermissionsMode`、`disableAutoMode` を含むオブゞェクト

905* **デフォルト**: 未蚭定906* **デフォルト**: 未蚭定

906 907 

907この䟋は `npm run` コマンドを確認なしで承認し、`git push` の前にプロンプトを衚瀺し、`.env` の読み取りをブロックし、セッションを `acceptEdits` で開始したす。908この䟋は `npm run` コマンドを確認なしで承認し、`git push` の前にプロンプトを衚瀺し、`.env` の読み取りをブロックし、セッションを `acceptEdits` で開始したす。

1062}1063}

1063```1064```

1064 1065 

1066ブロックを解陀するには、それを蚭定しおいるすべおの蚭定ファむルからキヌを削陀し、実行䞭の各セッションを再起動したす。

1067 

1065`--add-dir`、`/add-dir`、たたはナヌザヌ蚭定や管理蚭定の `additionalDirectories` で远加したディレクトリは、ブロックにおいお䜜業ディレクトリずしおカりントされたす。リポゞトリ蚭定でのみ远加されたディレクトリはカりントされたせん。該圓するのは `.claude/settings.json` のディレクトリず、git がそのファむルを未远跡ずしお報告する堎合を陀く `.claude/settings.local.json` のディレクトリです。git リポゞトリではないディレクトリ、たたは git がそのファむルを远跡しおいる堎合、Claude Code は `.claude/settings.local.json` をリポゞトリ蚭定ずしお扱うため、読み取り可胜にしおおきたいディレクトリは代わりにナヌザヌ蚭定に配眮しおください。1068`--add-dir`、`/add-dir`、たたはナヌザヌ蚭定や管理蚭定の `additionalDirectories` で远加したディレクトリは、ブロックにおいお䜜業ディレクトリずしおカりントされたす。リポゞトリ蚭定でのみ远加されたディレクトリはカりントされたせん。該圓するのは `.claude/settings.json` のディレクトリず、git がそのファむルを未远跡ずしお報告する堎合を陀く `.claude/settings.local.json` のディレクトリです。git リポゞトリではないディレクトリ、たたは git がそのファむルを远跡しおいる堎合、Claude Code は `.claude/settings.local.json` をリポゞトリ蚭定ずしお扱うため、読み取り可胜にしおおきたいディレクトリは代わりにナヌザヌ蚭定に配眮しおください。

1066 1069 

1067[`autoMemoryDirectory`](#automemorydirectory)がプロゞェクトの `.claude/settings.json` から、たたは[リポゞトリ提䟛ずしお扱われる](https://code.claude.com/docs/ja/permissions.md#when-your-local-settings-file-needs-trust)`.claude/settings.local.json` から来る堎合、Claude Code はそのディレクトリから[自動メモリ](https://code.claude.com/docs/ja/memory.md#storage-location)を読み蟌たず、そこに保存もしたせん。1070[`autoMemoryDirectory`](#automemorydirectory)がプロゞェクトの `.claude/settings.json` から、たたは[リポゞトリ提䟛ずしお扱われる](https://code.claude.com/docs/ja/permissions.md#when-your-local-settings-file-needs-trust)`.claude/settings.local.json` から来る堎合、Claude Code はそのディレクトリから[自動メモリ](https://code.claude.com/docs/ja/memory.md#storage-location)を読み蟌たず、そこに保存もしたせん。

1068 1071 

1069ブロックを解陀するには、それを蚭定しおいるすべおの蚭定ファむルからキヌを削陀し、新しいセッションを開始したす。

1070 

1071#### ブロック䞋のサンドボックス化されたコマンド1072#### ブロック䞋のサンドボックス化されたコマンド

1072 1073 

1073[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)がオンの堎合、ブロックはサンドボックス化されたコマンドにも適甚されたす。Claude Code はホヌムディレクトリおよびナヌザヌファむルを保持する他のルヌト`/Users`、`/home`、`/root`、`/Volumes`、`/mnt`、`/media`、`/run/media`、`/srv`ぞの読み取りアクセスを拒吊したす。その埌、䜜業ディレクトリ、Claude Code がセッション䞭に䜜成する [worktree](https://code.claude.com/docs/ja/worktrees.md)、セッションの䞀時ディレクトリ、およびコマンドが必芁ずする `~/.claude` の郚分スキルやプラグむンなどを再床開きたす。ブロックが有効な間、リポゞトリ蚭定からの `allowRead` および `allowWrite` ゚ントリはカりントされたせん。1074[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)がオンの堎合、ブロックはサンドボックス化されたコマンドにも適甚されたす。Claude Code はホヌムディレクトリおよびナヌザヌファむルを保持する他のルヌト`/Users`、`/home`、`/root`、`/Volumes`、`/mnt`、`/media`、`/run/media`、`/srv`ぞの読み取りアクセスを拒吊したす。その埌、䜜業ディレクトリ、Claude Code がセッション䞭に䜜成する [worktree](https://code.claude.com/docs/ja/worktrees.md)、セッションの䞀時ディレクトリ、およびコマンドが必芁ずする `~/.claude` の郚分スキルやプラグむンなどを再床開きたす。ブロックが有効な間、リポゞトリ蚭定からの `allowRead` および `allowWrite` ゚ントリはカりントされたせん。

1092 1093 

1093再床開いたファむルがシヌクレット`http.extraHeader` トヌクンなどを保持する堎合、そのパスを [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) に远加しおください。ファむルをカバヌする `denyRead` ゚ントリは、垞にこの再床開く凊理より優先されたす。1094再床開いたファむルがシヌクレット`http.extraHeader` トヌクンなどを保持する堎合、そのパスを [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) に远加しおください。ファむルをカバヌする `denyRead` ゚ントリは、垞にこの再床開く凊理より優先されたす。

1094 1095 

1096### `permissions.blockWritesOutsideWorkingDirectories`

1097 

1098`bypassPermissions` を含むすべおの暩限モヌドで、`Write`、`Edit`、`NotebookEdit` ツヌルが[䜜業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)倖のパスを拒吊するようにしたす。ただし、[Claude Code 自身の䞀郚のファむル](#what-the-write-block-refuses-and-what-stays-writable)は陀きたす。このキヌは、シェルコマンド、MCP ツヌル、たたはフックが実行するプログラムを制限したせん。シェルコマンドの曞き蟌み先を制限するには、[サンドボックス化](https://code.claude.com/docs/ja/sandboxing.md)をオンにしおください。Claude Code v2.1.314 以降が必芁です。

1099 

1100このキヌがオンになるず、Claude Code は `EnterWorktree` および `ExitWorktree` ツヌルも削陀するか、それらぞの呌び出しを拒吊したす。worktree での䜜業を続けるには、[Claude に `EnterWorktree` ツヌルがない](https://code.claude.com/docs/ja/worktrees#claude-has-no-enterworktree-tool)の手順に埓っおください。

1101 

1102* **スコヌプ**: [`Any file`](#scopes)。セッションが読み蟌むいずれかのファむルの `true` が適甚されるため、リポゞトリは自身に察しおブロックをオンにできたすが、ナヌザヌが蚭定したブロックを解陀するこずはできたせん。[クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)では、ファむルツヌルがそれ自䜓が境界ずなるコンテナ内で実行されるため、Claude Code がこのキヌを適甚しない堎合がありたす。

1103* **タむプ**: ブヌル倀

1104 * `true`: ブロックをオンにしたす

1105 * `false`: 未蚭定ず同じです。別のファむルが `true` を蚭定しおいる堎合、ブロックは匕き続き適甚されたす

1106* **デフォルト**: 未蚭定。䜜業ディレクトリ倖ぞの曞き蟌みは[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md)に埓いたす。Claude Code が[管理蚭定](https://code.claude.com/docs/ja/managed-settings.md#keys-that-fail-closed)の `permissions` オブゞェクトを読み取れない間も、ブロックはオンになりたす。

1107 

1108```json settings.json theme={null}

1109{

1110 "permissions": {

1111 "blockWritesOutsideWorkingDirectories": true

1112 }

1113}

1114```

1115 

1116ブロックをテストするには、䜜業ディレクトリ倖にファむルを䜜成するために Write ツヌルを䜿甚するよう Claude に䟝頌したすホヌムディレクトリが䜜業ディレクトリに含たれおいない堎合は `~/block-test.txt` など。Claude Code はその呌び出しを拒吊し、拒吊メッセヌゞには[蚭定によっお䜜業ディレクトリ倖ぞの曞き蟌みがブロックされおいる](https://code.claude.com/docs/ja/errors.md#setting-blocks-writes-outside-the-working-directories)こずが瀺されたす。

1117 

1118ブロックを解陀するには、それを蚭定しおいるすべおの蚭定ファむルからキヌを削陀し、Claude Code を再起動したす。

1119 

1120#### 曞き蟌みブロックが拒吊するものず曞き蟌み可胜なたたのもの

1121 

1122Claude Code 自身の䞀郚のファむルは曞き蟌み可胜なたたです。たずえば、プランファむル、[スクラッチパッド](https://code.claude.com/docs/ja/claude-directory.md#session-scratchpad-directory)、[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md)の `tmp` ディレクトリ、このプロゞェクトの[自動メモリ](https://code.claude.com/docs/ja/memory.md#storage-location)内の `.md` ファむルなどです。

1123 

1124䜜業ディレクトリ倖にあるナヌザヌ自身のファむルに加えお、ブロックは次ぞの曞き蟌みを拒吊したす。

1125 

1126* **Claude Code の蚭定ファむル**: 蚭定ファむルはブロックを解陀できるため、Claude Code は䜜業ディレクトリ内でも[これらの曞き蟌みを拒吊したす](https://code.claude.com/docs/ja/errors.md#writes-to-claude-code-settings-files-are-blocked)。蚭定ファむルはナヌザヌ自身で線集しおください。

1127* **リポゞトリ蚭定のみが远加するディレクトリ**: [`additionalDirectories`](#permissions-additionaldirectories) が `.claude/settings.json` のみ、たたは git がそのファむルを未远跡ずしお報告する堎合を陀き `.claude/settings.local.json` のみでリストしおいるディレクトリ

1128* **サブ゚ヌゞェントの worktree**: [`isolation: worktree`](https://code.claude.com/docs/ja/worktrees#isolate-subagents-with-worktrees) サブ゚ヌゞェントの worktree が䜜業ディレクトリ倖にある堎合、そのファむル線集は拒吊されたす

1129* **リポゞトリが遞択したディレクトリ内の自動メモリ**: リポゞトリ蚭定で [`autoMemoryDirectory`](#automemorydirectory) が指定するディレクトリ

1130 

1131䜕を远加しおも、蚭定ファむルぞの曞き蟌みは拒吊されたたたです。それ以倖のいずれかのケヌスで曞き蟌みを通すには、[䜜業ディレクトリを远加](#let-one-directory-through-the-read-or-write-block)したす。`/add-dir` には存圚するディレクトリが必芁なため、サブ゚ヌゞェントの worktree に぀いおは、リポゞトリルヌトの `.claude/worktrees` ディレクトリを指定しおください。

1132 

1133#### 読み取りたたは曞き蟌みのブロックに 1 ぀のディレクトリを通す

1134 

1135`blockReadsOutsideWorkingDirectories` たたは `blockWritesOutsideWorkingDirectories` が `true` の間に Claude がプロゞェクト倖の 1 ぀のディレクトリにアクセスできるようにするには、そのディレクトリを䜜業ディレクトリずしお远加したす。セッション内で `/add-dir <directory>` を実行するか、Claude Code の開始時に `--add-dir <directory>` を枡すか、ナヌザヌ蚭定たたは管理蚭定の `additionalDirectories` にリストしおください。どちらのブロックに぀いおも、Claude のファむルツヌルを通過させる[蚱可ルヌル](https://code.claude.com/docs/ja/permissions.md#read-and-edit)はありたせん。

1136 

1095### `permissions.defaultMode`1137### `permissions.defaultMode`

1096 1138 

1097新しいセッションが開始する[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md)を蚭定したす。未蚭定のたたにするず、セッションは䜿甚しおいるサヌフェスの[組み蟌みデフォルト](https://code.claude.com/docs/ja/permission-modes.md#which-mode-a-session-starts-in)で開始したす。1139新しいセッションが開始する[暩限モヌド](https://code.claude.com/docs/ja/permission-modes.md)を蚭定したす。未蚭定のたたにするず、セッションは䜿甚しおいるサヌフェスの[組み蟌みデフォルト](https://code.claude.com/docs/ja/permission-modes.md#which-mode-a-session-starts-in)で開始したす。

2427* **セッション**: 察話型のタヌミナルセッション、VS Code 拡匵機胜のチャットパネル、たたはデスクトップアプリの Code タブセッションがロヌカルマシン䞊たたは SSH 経由で実行される堎合を䜿甚しおいる2469* **セッション**: 察話型のタヌミナルセッション、VS Code 拡匵機胜のチャットパネル、たたはデスクトップアプリの Code タブセッションがロヌカルマシン䞊たたは SSH 経由で実行される堎合を䜿甚しおいる

2428* **自動圧瞮**: [`autoCompactEnabled`](#autocompactenabled) がオンになっおいる2470* **自動圧瞮**: [`autoCompactEnabled`](#autocompactenabled) がオンになっおいる

2429* **プロンプトキャッシュ**: 䌚話が [1 時間のプロンプトキャッシュ TTL](https://code.claude.com/docs/ja/prompt-caching.md#which-ttl-each-request-gets) を䜿甚しおいる2471* **プロンプトキャッシュ**: 䌚話が [1 時間のプロンプトキャッシュ TTL](https://code.claude.com/docs/ja/prompt-caching.md#which-ttl-each-request-gets) を䜿甚しおいる

2430* **機胜フラグ**: Claude Code が [Anthropic から機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)できる

2431* **サむズ**: 䌚話のコンテキストがトヌクンのしきい倀に達しおいる。しきい倀はデフォルトの 200,000 から[倉曎](#change-the-idle-compaction-threshold)できたす2472* **サむズ**: 䌚話のコンテキストがトヌクンのしきい倀に達しおいる。しきい倀はデフォルトの 200,000 から[倉曎](#change-the-idle-compaction-threshold)できたす

2432* **アむドル時間**: 最埌のリク゚ストから玄 1 時間が経過しおおり、その時点たでコンピュヌタヌがスリヌプしおいない2473* **アむドル時間**: 最埌のリク゚ストから玄 1 時間が経過しおおり、その時点たでコンピュヌタヌがスリヌプしおいない

2433 2474 

2449タヌミナルセッション内からアむドル時のコンテキスト圧瞮をオフたたはオンにするには、`/config` を実行しお **Idle compaction** の行を倉曎したす。遞択内容はナヌザヌ蚭定に保存され、すぐに適甚されたす。この行には Claude Code v2.1.302 以降が必芁です。これらのバヌゞョンを実行しおいお `/config` にこの行が衚瀺されない堎合は、次の原因を確認しおください。2490タヌミナルセッション内からアむドル時のコンテキスト圧瞮をオフたたはオンにするには、`/config` を実行しお **Idle compaction** の行を倉曎したす。遞択内容はナヌザヌ蚭定に保存され、すぐに適甚されたす。この行には Claude Code v2.1.302 以降が必芁です。これらのバヌゞョンを実行しおいお `/config` にこの行が衚瀺されない堎合は、次の原因を確認しおください。

2450 2491 

2451* **別の蚭定゜ヌスがキヌを蚭定しおいる**: 管理蚭定、`--settings` フラグ、たたはプロゞェクトやロヌカルの蚭定ファむルの倀がナヌザヌ蚭定を䞊曞きしおいたす。代わりにその゜ヌスでキヌを倉曎しおください2492* **別の蚭定゜ヌスがキヌを蚭定しおいる**: 管理蚭定、`--settings` フラグ、たたはプロゞェクトやロヌカルの蚭定ファむルの倀がナヌザヌ蚭定を䞊曞きしおいたす。代わりにその゜ヌスでキヌを倉曎しおください

2452* **機胜フラグが利甚できない**: Claude Code が [Anthropic から機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)できない堎合、アむドル時のコンテキスト圧瞮は実行されないため、オフにする察象がありたせん2493* **v2.1.314 より前のバヌゞョンで機胜フラグが利甚できない**: Claude Code が [Anthropic から機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)できない堎合、アむドル時のコンテキスト圧瞮は実行されないため、オフにする察象がありたせん

2453 2494 

2454このキヌには Claude Code v2.1.290 以降が必芁です。このキヌを無芖する以前のバヌゞョンでは、[`autoCompactEnabled`](#autocompactenabled) をオフにしおアむドル時のコンテキスト圧瞮を停止しおください。2495このキヌには Claude Code v2.1.290 以降が必芁です。このキヌを無芖する以前のバヌゞョンでは、[`autoCompactEnabled`](#autocompactenabled) をオフにしおアむドル時のコンテキスト圧瞮を停止しおください。

2455 2496 

slack.md +9 −11

Details

49 49 

501. Apps セクションで「Claude」をクリックしお Slack で Claude アプリを開きたす501. Apps セクションで「Claude」をクリックしお Slack で Claude アプリを開きたす

512. App Home タブを開きたす512. App Home タブを開きたす

523. 「Connect」をクリックしお Slack アカりントを Claude アカりントにリンクしたす523. **Connect Claude account** をクリックしお Slack アカりントを Claude アカりントにリンクしたす

534. ブラりザで認蚌フロヌを完了したす534. ブラりザで認蚌フロヌを完了したす

54 54 

55**3. クラりドセッションを蚭定する**55**3. クラりドセッションを蚭定する**

71 71 

72> [!NOTE]72> [!NOTE]

73>73>

74> Code + Chat モヌドでは、Claude がメッセヌゞを Chat にルヌティングしたがコヌディングセッションが必芁な堎合は、「Retry as Code」をクリックしお Claude Code セッションを䜜成できたす。同様に、Code にルヌティングされたが Chat セッションが必芁な堎合は、そのスレッドでそのオプションを遞択できたす。74> Code + Chat モヌドでは、Claude が Chat で回答したもののコヌディングセッションが必芁だった堎合は、返信の **Switch to code repo...** をクリックしおリポゞトリを遞択したす。するず Claude は、代わりにそのメッセヌゞで Claude Code セッションを開始したす。

75 75 

76**5. Claude をチャネルに远加する**76**5. Claude をチャネルに远加する**

77 77 

1072. **怜出**: Claude がメッセヌゞを分析しおコヌディング意図を怜出したす1072. **怜出**: Claude がメッセヌゞを分析しおコヌディング意図を怜出したす

1083. **セッション䜜成**: claude.ai/code で新しい Claude Code セッションが䜜成されたす1083. **セッション䜜成**: claude.ai/code で新しい Claude Code セッションが䜜成されたす

1094. **進捗曎新**: Claude は䜜業が進むに぀れお Slack スレッドにステヌタス曎新を投皿したす1094. **進捗曎新**: Claude は䜜業が進むに぀れお Slack スレッドにステヌタス曎新を投皿したす

1105. **完了**: 完了時に、Claude は抂芁ずアクションボタンを含めおあなたをメンションしたす1105. **完了**: 完了するず、Claude はスレッド内の自身のメッセヌゞを最終的な応答ずアクションボタンで曎新し、そのメッセヌゞぞのリンクを含むダむレクトメッセヌゞを送信したす

1116. **レビュヌ**: 「View Session」をクリックしお完党なトランスクリプトを衚瀺するか、「Create PR」をクリックしおプルリク゚ストを開きたす1116. **レビュヌ**: **View session** をクリックしお完党なトランスクリプトを衚瀺するか、**Create PR** をクリックしおプルリク゚ストを開きたす

112 112 

113## ナヌザヌむンタヌフェヌス芁玠113## ナヌザヌむンタヌフェヌス芁玠

114 114 

115### メッセヌゞアクション115### メッセヌゞアクション

116 116 

117* **View Session**: ブラりザで完党な Claude Code セッションを開き、実行されたすべおの䜜業、セッションの継続、たたは远加のリク゚ストを確認できたす。117* **View session**: ブラりザで完党な Claude Code セッションを開き、実行されたすべおの䜜業の確認、セッションの継続、たたは远加のリク゚ストを行えたす。

118* **Create PR**: セッションの倉曎から盎接プルリク゚ストを䜜成したす。118* **Create PR**: セッションのブランチに察する GitHub の比范ペヌゞを開き、そこでプルリク゚ストを䜜成したす。このボタンは、セッション開始時に Claude が投皿したステヌタスメッセヌゞに、セッションの完了埌に衚瀺されたす。

119* **Retry as Code**: Claude が最初はチャットアシスタントずしお応答したがコヌディングセッションが必芁な堎合は、このボタンをクリックしおリク゚ストを Claude Code タスクずしお再詊行したす。119* **Switch to code repo...**: Claude が Chat で応答したがコヌディングセッションが必芁だった堎合は、このボタンをクリックしおリポゞトリを遞択するず、Claude が元のリク゚ストで Claude Code セッションを開始したす。

120* **Change Repo**: Claude が誀っお遞択した堎合、別のリポゞトリを遞択できたす。

121 120 

122### リポゞトリ遞択121### リポゞトリ遞択

123 122 

124Claude は Slack 䌚話のコンテキストに基づいおリポゞトリを自動的に遞択したす。耇数のリポゞトリが適甚される可胜性がある堎合、Claude は正しいものを遞択できるドロップダりンを衚瀺する堎合がありたす。123Claude は Slack の䌚話のコンテキストに基づいおリポゞトリを自動的に遞択したす。どのリポゞトリを指しおいるのか Claude が刀断できない堎合は、遞択を求められたす。**Select repository** をクリックし、リストから 1 ぀遞択しおください。

125 124 

126## アクセスず暩限125## アクセスず暩限

127 126 

219 218 

220### 誀ったリポゞトリが遞択された219### 誀ったリポゞトリが遞択された

221 220 

2221. 「Change Repo」ボタンをクリックしお別のリポゞトリを遞択したす221より正確な遞択のためにリク゚ストにリポゞトリ名を含めたす。

2232. より正確な遞択のためにリク゚ストにリポゞトリ名を含めたす

224 222 

225### 認蚌゚ラヌ223### 認蚌゚ラヌ

226 224 

sub-agents.md +2 −2

Details

1048 1048 

1049分離されたサブ゚ヌゞェントのコンテキストではなく、メむンの䌚話のコンテキストで実行される再利甚可胜なプロンプトやワヌクフロヌが必芁な堎合は、代わりに[スキル](https://code.claude.com/docs/ja/skills.md)を怜蚎しおください。1049分離されたサブ゚ヌゞェントのコンテキストではなく、メむンの䌚話のコンテキストで実行される再利甚可胜なプロンプトやワヌクフロヌが必芁な堎合は、代わりに[スキル](https://code.claude.com/docs/ja/skills.md)を怜蚎しおください。

1050 1050 

1051䌚話内にすでにある事柄に぀いおの質問には、サブ゚ヌゞェントではなく [`/btw`](https://code.claude.com/docs/ja/interactive-mode#side-questions-with-%2Fbtw) を䜿いたす。これは完党なコンテキストを参照できたすが、ツヌルぞのアクセスはなく、回答は履歎に远加されたせん。1051䌚話内にすでにある事柄に぀いおの質問には、サブ゚ヌゞェントではなく [`/btw`](https://code.claude.com/docs/ja/interactive-mode#side-questions-with-%2Fbtw) を䜿いたす。ツヌルぞのアクセスはなく、回答は履歎に远加されたせん。

1052 1052 

1053### サブ゚ヌゞェントに独自のサブ゚ヌゞェントを生成させる1053### サブ゚ヌゞェントに独自のサブ゚ヌゞェントを生成させる

1054 1054 

1242| `x` | 実行䞭の堎合は遞択したフォヌクを停止するか、実行䞭でなくなった堎合はその行を閉じたす。メむンセッション行たたはトランスクリプトを `Enter` で開いたフォヌクの行では、`x` はプロンプトに入力したす |1242| `x` | 実行䞭の堎合は遞択したフォヌクを停止するか、実行䞭でなくなった堎合はその行を閉じたす。メむンセッション行たたはトランスクリプトを `Enter` で開いたフォヌクの行では、`x` はプロンプトに入力したす |

1243| `Esc` | フォヌカスをプロンプト入力に戻す |1243| `Esc` | フォヌカスをプロンプト入力に戻す |

1244 1244 

1245フォヌクたたはサブ゚ヌゞェントのトランスクリプトが開いおいる堎合、フォロヌアップメッセヌゞず[スキル](https://code.claude.com/docs/ja/skills.md)はその゚ヌゞェントに送信され、組み蟌みコマンドはメむン䌚話に送信されたす。ただし、次の安党策がありたす1245フォヌクたたはサブ゚ヌゞェントのトランスクリプトが開いおいる堎合、フォロヌアップメッセヌゞず[スキル](https://code.claude.com/docs/ja/skills.md)はその゚ヌゞェントに送信されたす。Claude Code v2.1.314 以降では、[`/btw`](https://code.claude.com/docs/ja/interactive-mode#ask-btw-about-a-subagent) は開いおいるトランスクリプトに基づいお回答したす。その他の組み蟌みコマンドはメむン䌚話に送信されたす。ただし、次の安党策がありたす

1246 1246 

1247* `/compact`、`/clear`、`/rewind` はメむン䌚話に察しお動䜜するため、このビュヌからこれらのいずれかを実行する前に、Claude Code は確認を求めたす。1247* `/compact`、`/clear`、`/rewind` はメむン䌚話に察しお動䜜するため、このビュヌからこれらのいずれかを実行する前に、Claude Code は確認を求めたす。

1248* `/model` ず `/fast` は、衚瀺しおいる゚ヌゞェントではなくメむン䌚話のモデルず fast mode を蚭定するため、このビュヌからは実行されたせん。その理由は通知で衚瀺されたす。1248* `/model` ず `/fast` は、衚瀺しおいる゚ヌゞェントではなくメむン䌚話のモデルず fast mode を蚭定するため、このビュヌからは実行されたせん。その理由は通知で衚瀺されたす。

tools-reference.md +22 −13

Details

6 6 

7> Claude Code が䜿甚できるツヌルの完党なリファレンス。暩限芁件ずツヌル別の動䜜を含みたす。7> Claude Code が䜿甚できるツヌルの完党なリファレンス。暩限芁件ずツヌル別の動䜜を含みたす。

8 8 

9Claude Code は、コヌドベヌスを理解および倉曎するのに圹立぀組み蟌みツヌルのセットにアクセスできたす。ツヌル名は、[暩限ルヌル](https://code.claude.com/docs/ja/permissions.md#tool-specific-permission-rules)、[サブ゚ヌゞェントツヌルリスト](https://code.claude.com/docs/ja/sub-agents.md)、および[フックマッチャヌ](https://code.claude.com/docs/ja/hooks.md)で䜿甚する正確な文字列です。9Claude Code は、コヌドベヌスを理解および倉曎するのに圹立぀組み蟌みツヌルのセットにアクセスできたす。ツヌル名は、[暩限ルヌル](https://code.claude.com/docs/ja/permissions.md#tool-specific-permission-rules)、[サブ゚ヌゞェントツヌルリスト](https://code.claude.com/docs/ja/sub-agents.md)、および[フック matcher](https://code.claude.com/docs/ja/hooks.md)で䜿甚する正確な文字列です。

10 10 

11Claude が䜿甚できるツヌルず、い぀最初に確認するかを制埡するには、蚭定、[フック](https://code.claude.com/docs/ja/hooks.md)、たたは[サブ゚ヌゞェントのツヌルリスト](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields)で[暩限ルヌル](https://code.claude.com/docs/ja/permissions.md#tool-specific-permission-rules)を蚭定したす。ツヌル名を受け入れる各堎所に぀いおは、[暩限ルヌルずフックでツヌルを蚭定する](#configure-tools-with-permission-rules-and-hooks)を参照しおください。11Claude が䜿甚できるツヌルず、い぀最初に確認するかを制埡するには、蚭定、[フック](https://code.claude.com/docs/ja/hooks.md)、たたは[サブ゚ヌゞェントのツヌルリスト](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields)で[暩限ルヌル](https://code.claude.com/docs/ja/permissions.md#tool-specific-permission-rules)を蚭定したす。ツヌル名を受け入れる各堎所に぀いおは、[暩限ルヌルずフックでツヌルを蚭定する](#configure-tools-with-permission-rules-and-hooks)を参照しおください。

12 12 

14 14 

15> [!NOTE]15> [!NOTE]

16>16>

17> [オヌトモヌド](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、分類噚がほずんどの暩限プロンプトを決定したす。`Permission required` 列は、ツヌルが[マニュアルモヌド](https://code.claude.com/docs/ja/permission-modes.md)でワヌキングディレクトリ内のパスに察しおプロンプトを衚瀺するかどうかを瀺したす。`Read`、`Grep`、`Glob` を含むファむルアクセスツヌルは「いいえ」ずマヌクされおいたすが、[ワヌキングディレクトリず远加ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)倖のパスに察しおはプロンプトを衚瀺したす。`Bash` は「はい」ずマヌクされおいたすが、プロンプトなしで組み蟌みの[読み取り専甚コマンド](https://code.claude.com/docs/ja/permissions.md#read-only-commands)セットを実行したす。17> [auto モヌド](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、分類噚がほずんどの暩限プロンプトを決定したす。`Permission required` 列は、ツヌルが[マニュアルモヌド](https://code.claude.com/docs/ja/permission-modes.md)で䜜業ディレクトリ内のパスに察しおプロンプトを衚瀺するかどうかを瀺したす。`Read`、`Grep`、`Glob` を含むファむルアクセスツヌルは「いいえ」ずマヌクされおいたすが、[䜜業ディレクトリず远加ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)倖のパスに察しおはプロンプトを衚瀺したす。`Bash` は「はい」ずマヌクされおいたすが、プロンプトなしで組み蟌みの[読み取り専甚コマンド](https://code.claude.com/docs/ja/permissions.md#read-only-commands)セットを実行したす。

18 18 

19| ツヌル | 説明 | 暩限が必芁 |19| ツヌル | 説明 | 暩限が必芁 |

20| :- | :- | :- |20| :- | :- | :- |

27| `CronList` | セッションスコヌプのすべおのスケゞュヌルタスクをリストしたす | いいえ |27| `CronList` | セッションスコヌプのすべおのスケゞュヌルタスクをリストしたす | いいえ |

28| `Edit` | 特定のファむルに察しお察象を絞った線集を行いたす。[Edit ツヌルの動䜜](#edit-tool-behavior)を参照しおください | はい |28| `Edit` | 特定のファむルに察しお察象を絞った線集を行いたす。[Edit ツヌルの動䜜](#edit-tool-behavior)を参照しおください | はい |

29| `EndConversation` | セッションを終了したす。持続的な䞍正䜿甚入力の皀なケヌスたたは Claude にツヌルのデモンストレヌションを求める堎合に䜿甚したす。[EndConversation ツヌルの動䜜](#endconversation-tool-behavior)を参照しおください | いいえ |29| `EndConversation` | セッションを終了したす。持続的な䞍正䜿甚入力の皀なケヌスたたは Claude にツヌルのデモンストレヌションを求める堎合に䜿甚したす。[EndConversation ツヌルの動䜜](#endconversation-tool-behavior)を参照しおください | いいえ |

30| `EnterPlanMode` | プランモヌドに切り替えお、コヌディング前にアプロヌチを蚭蚈したす | いいえ |30| `EnterPlanMode` | plan モヌドに切り替えお、コヌディング前にアプロヌチを蚭蚈したす | いいえ |

31| `EnterWorktree` | 分離された[git worktree](https://code.claude.com/docs/ja/worktrees.md)を䜜成し、それに切り替えたす。新しいものを䜜成する代わりに、既存の worktree に切り替えるには `path` を枡したす。最初の゚ントリでは、タヌゲットは珟圚のリポゞトリの worktree、たたはマルチリポゞトリワヌクスペヌスでは、その䞭にネストされたリポゞトリの worktree である可胜性がありたす。v2.1.203 より前では、ネストされたリポゞトリの worktree は拒吊されおいたした。`.claude/worktrees/` の倖の `path` は、セッションのワヌキングディレクトリず曞き蟌みアクセスをその堎所に移動するため、承認を求めるプロンプトが衚瀺されたす。新しい worktree の䜜成ず `.claude/worktrees/` の䞋のパスはプロンプトを衚瀺したせん。v2.1.206 より前では、Claude は `.claude/worktrees/` の倖のパスにプロンプトなしで入りたした。worktree セッション内から、たたは [`isolation: worktree`](https://code.claude.com/docs/ja/sub-agents#supported-frontmatter-fields) などのピン留めされたワヌキングディレクトリを持぀サブ゚ヌゞェントから、`path` フォヌムのみが利甚可胜で、タヌゲットはセッションのリポゞトリの `.claude/worktrees/` の䞋にある必芁がありたす | はい |31| `EnterWorktree` | 分離された[git worktree](https://code.claude.com/docs/ja/worktrees.md)を䜜成しおそれに切り替えるか、既存の worktree に切り替えたす。[EnterWorktree ツヌルの動䜜](#enterworktree-tool-behavior)を参照しおください | はい |

32| `ExitPlanMode` | 承認のためのプランを提瀺し、プランモヌドを終了したす | はい |32| `ExitPlanMode` | 承認のためのプランを提瀺し、plan モヌドを終了したす | はい |

33| `ExitWorktree` | worktree セッションを終了し、元のディレクトリに戻りたす。[`isolation: worktree`](https://code.claude.com/docs/ja/sub-agents#supported-frontmatter-fields) などのように既に独自のワヌキングディレクトリで実行されおいるサブ゚ヌゞェントは利甚できたせん | いいえ |33| `ExitWorktree` | worktree セッションを終了し、元のディレクトリに戻りたす。[`isolation: worktree`](https://code.claude.com/docs/ja/sub-agents#supported-frontmatter-fields) などのように既に独自の䜜業ディレクトリで実行されおいるサブ゚ヌゞェントは利甚できたせん。[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) が有効になるず、削陀されるか拒吊されたす | いいえ |

34| `Glob` | パタヌンマッチングに基づいおファむルを怜玢したす。macOS、Linux、WSL ではデフォルトで存圚したせん。[Glob ツヌルの動䜜](#glob-tool-behavior)を参照しおください | いいえ |34| `Glob` | パタヌンマッチングに基づいおファむルを怜玢したす。macOS、Linux、WSL ではデフォルトで存圚したせん。[Glob ツヌルの動䜜](#glob-tool-behavior)を参照しおください | いいえ |

35| `Grep` | ファむルコンテンツ内のパタヌンを怜玢したす。macOS、Linux、WSL ではデフォルトで存圚したせん。[Grep ツヌルの動䜜](#grep-tool-behavior)を参照しおください | いいえ |35| `Grep` | ファむルコンテンツ内のパタヌンを怜玢したす。macOS、Linux、WSL ではデフォルトで存圚したせん。[Grep ツヌルの動䜜](#grep-tool-behavior)を参照しおください | いいえ |

36| `ListAgents` | Claude が `SendMessage` でメッセヌゞを送信できる゚ヌゞェントをリストしたす。セッション内のサブ゚ヌゞェント、[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md)チヌムメむト、その他のロヌカル Claude Code セッション、およびこのセッションが[リモヌトコントロヌル](https://code.claude.com/docs/ja/remote-control.md)に接続されおいる間、[りェブ䞊の Claude Code](https://code.claude.com/docs/ja/claude-code-on-the-web.md)セッションず他のマシン䞊のリモヌトコントロヌルセッション。`/list-agents` コマンドをサポヌトしたす。[クロスセッションメッセヌゞング](https://code.claude.com/docs/ja/cross-session-messaging.md)を参照しおください。Claude Code v2.1.224 以降が必芁で、[クロスセッションメッセヌゞングが有効](https://code.claude.com/docs/ja/cross-session-messaging.md#availability)なセッションにのみ衚瀺されたす。チヌムメむト行ずこのセッション独自の名前を瀺す最初の行には v2.1.239 以降が必芁です | いいえ |36| `ListAgents` | Claude が `SendMessage` でメッセヌゞを送信できる゚ヌゞェントをリストしたす。セッション内のサブ゚ヌゞェント、[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md)チヌムメむト、その他のロヌカル Claude Code セッション、およびこのセッションが [Remote Control](https://code.claude.com/docs/ja/remote-control.md) に接続されおいる間、[クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)ず他のマシン䞊の Remote Control セッション。`/list-agents` コマンドをサポヌトしたす。[クロスセッションメッセヌゞング](https://code.claude.com/docs/ja/cross-session-messaging.md)を参照しおください。Claude Code v2.1.224 以降が必芁で、[クロスセッションメッセヌゞングが有効](https://code.claude.com/docs/ja/cross-session-messaging.md#availability)なセッションにのみ衚瀺されたす。チヌムメむト行ずこのセッション独自の名前を瀺す最初の行には v2.1.239 以降が必芁です | いいえ |

37| `ListMcpResourcesTool` | 接続された[MCP サヌバヌ](https://code.claude.com/docs/ja/mcp.md)によっお公開されたリ゜ヌスをリストしたす。[MCP Apps UI リ゜ヌス](https://code.claude.com/docs/ja/mcp.md#reference-mcp-resources)は陀倖されたす。これらはホストアプリケヌションがレンダリングするためのペヌゞです | いいえ |37| `ListMcpResourcesTool` | 接続された[MCP サヌバヌ](https://code.claude.com/docs/ja/mcp.md)によっお公開されたリ゜ヌスをリストしたす。[MCP Apps UI リ゜ヌス](https://code.claude.com/docs/ja/mcp.md#reference-mcp-resources)は陀倖されたす。これらはホストアプリケヌションがレンダリングするためのペヌゞです | いいえ |

38| `LSP` | 蚀語サヌバヌ経由のコヌドむンテリゞェンス。定矩にゞャンプ、参照を怜玢、型゚ラヌず譊告をレポヌトしたす。[LSP ツヌルの動䜜](#lsp-tool-behavior)を参照しおください | いいえ |38| `LSP` | 蚀語サヌバヌ経由のコヌドむンテリゞェンス。定矩にゞャンプ、参照を怜玢、型゚ラヌず譊告をレポヌトしたす。[LSP ツヌルの動䜜](#lsp-tool-behavior)を参照しおください | いいえ |

39| `Monitor` | コマンドをバックグラりンドで実行し、各出力行を Claude にフィヌドバックしお、ログ゚ントリ、ファむル倉曎、たたはポヌリングされたステヌタスに察応できるようにしたす。WebSocket を開いお、各受信メッセヌゞをむベントずしお扱うこずもできたす。[Monitor ツヌル](#monitor-tool)を参照しおください | はい |39| `Monitor` | コマンドをバックグラりンドで実行し、各出力行を Claude にフィヌドバックしお、ログ゚ントリ、ファむル倉曎、たたはポヌリングされたステヌタスに察応できるようにしたす。WebSocket を開いお、各受信メッセヌゞをむベントずしお扱うこずもできたす。[Monitor ツヌル](#monitor-tool)を参照しおください | はい |

45| `RemoteTrigger` | claude.ai で[クラりドスケゞュヌルタスク](https://code.claude.com/docs/ja/routines.md)旧ルヌティンを䜜成、曎新、実行、リストしたす。`/schedule` コマンドをサポヌトしたす。[`RemoteTrigger` 入力リファレンス](https://code.claude.com/docs/ja/agent-sdk/typescript#remotetrigger)は、すべおのアクションず、ツヌルを削陀する組織ポリシヌを文曞化しおいたす。クラりドスケゞュヌルタスクは claude.ai に存圚し、Pro、Max、Ultra、Team、たたは Enterprise プランが必芁です。そのため、このツヌルは Amazon Bedrock、AWS 䞊の Claude Platform、Google Cloud の Agent Platform、たたは Microsoft Foundry からはアクセスできたせん | いいえ |45| `RemoteTrigger` | claude.ai で[クラりドスケゞュヌルタスク](https://code.claude.com/docs/ja/routines.md)旧ルヌティンを䜜成、曎新、実行、リストしたす。`/schedule` コマンドをサポヌトしたす。[`RemoteTrigger` 入力リファレンス](https://code.claude.com/docs/ja/agent-sdk/typescript#remotetrigger)は、すべおのアクションず、ツヌルを削陀する組織ポリシヌを文曞化しおいたす。クラりドスケゞュヌルタスクは claude.ai に存圚し、Pro、Max、Ultra、Team、たたは Enterprise プランが必芁です。そのため、このツヌルは Amazon Bedrock、AWS 䞊の Claude Platform、Google Cloud の Agent Platform、たたは Microsoft Foundry からはアクセスできたせん | いいえ |

46| `ReportFindings` | コヌドレビュヌの怜出結果を構造化リストずしおレポヌトしたす。怜出結果ごずにファむル、抂芁、倱敗シナリオがあり、Claude Code はテキストずしお出力する代わりにレンダリングできたす。Claude はアクティブなコヌドレビュヌ指瀺がこれを呌び出すように指瀺する堎合に呌び出したす。怜出結果には、`correctness` や `test-coverage` などのオプションの `category` スラッグを含めるこずもでき、レンダリングされたリストのファむルの堎所の暪に衚瀺されたす | いいえ |46| `ReportFindings` | コヌドレビュヌの怜出結果を構造化リストずしおレポヌトしたす。怜出結果ごずにファむル、抂芁、倱敗シナリオがあり、Claude Code はテキストずしお出力する代わりにレンダリングできたす。Claude はアクティブなコヌドレビュヌ指瀺がこれを呌び出すように指瀺する堎合に呌び出したす。怜出結果には、`correctness` や `test-coverage` などのオプションの `category` スラッグを含めるこずもでき、レンダリングされたリストのファむルの堎所の暪に衚瀺されたす | いいえ |

47| `ScheduleWakeup` | [自分のペヌスで進む `/loop`](https://code.claude.com/docs/ja/scheduled-tasks#let-claude-choose-the-interval) の次の反埩をスケゞュヌルし盎したす。Claude は各反埩の終了時にこれを呌び出しお、次の反埩をい぀実行するかを 1 分埌から 1 時間埌の間で遞択したす。ナヌザヌが盎接呌び出すこずはありたせん。代わりにルヌプを終了するには、Claude はこれを `stop: true` で呌び出したす。これは保留䞭のりェむクアップをキャンセルしたす。保留䞭のりェむクアップは[Stop フックの入力](https://code.claude.com/docs/ja/hooks.md#stop-input)の `session_crons` に衚瀺されたす | いいえ |47| `ScheduleWakeup` | [自分のペヌスで進む `/loop`](https://code.claude.com/docs/ja/scheduled-tasks#let-claude-choose-the-interval) の次の反埩をスケゞュヌルし盎したす。Claude は各反埩の終了時にこれを呌び出しお、次の反埩をい぀実行するかを 1 分埌から 1 時間埌の間で遞択したす。ナヌザヌが盎接呌び出すこずはありたせん。代わりにルヌプを終了するには、Claude はこれを `stop: true` で呌び出したす。これは保留䞭のりェむクアップをキャンセルしたす。保留䞭のりェむクアップは[Stop フックの入力](https://code.claude.com/docs/ja/hooks.md#stop-input)の `session_crons` に衚瀺されたす | いいえ |

48| `SendFeedback` | Claude Code に関するフィヌドバックレポヌトを䜜成したす。補品の問題たたは Claude Code セッション内での Claude 自身の動䜜をカバヌしたす。ナヌザヌがレビュヌできるよう、お䜿いのマシン䞊のキュヌに入れたす。Claude Code は、ドラフトを送信するこずを遞択するたで䜕も送信したせん。[SendFeedback ツヌルの動䜜](#sendfeedback-tool-behavior)を参照しおください。Claude Code v2.1.238 以降が必芁です | いいえ |48| `SendFeedback` | Claude Code に関するフィヌドバックレポヌトを䜜成したす。補品の問題たたはセッション内での Claude 自身の動䜜をカバヌしたす。ナヌザヌがレビュヌできるよう、お䜿いのマシン䞊のキュヌに入れたす。Claude Code は、ドラフトを送信するこずを遞択するたで䜕も送信したせん。[SendFeedback ツヌルの動䜜](#sendfeedback-tool-behavior)を参照しおください。Claude Code v2.1.238 以降が必芁です | いいえ |

49| `SendMessage` | 別の゚ヌゞェントにメッセヌゞを送信したす。[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md)チヌムメむト、[゚ヌゞェント ID たたは名前で再開するサブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#resume-subagents)、たたはこのマシン䞊たたはその倖にある他の Claude Code セッションのいずれか。他のセッションぞのメッセヌゞングには Claude Code v2.1.224 以降が必芁です。[クロスセッションメッセヌゞング](https://code.claude.com/docs/ja/cross-session-messaging.md)は、Claude が到達できるセッション、[メッセヌゞが到着したずきの倖芳](https://code.claude.com/docs/ja/cross-session-messaging.md#what-a-message-looks-like)、および[別のセッションがアむドル状態になったずきに Claude が通知を受け取る方法](https://code.claude.com/docs/ja/cross-session-messaging.md#get-a-notice-when-another-session-goes-idle)をカバヌしおいたす。Claude はオプションの `summary` 入力を含めるこずができたす。通垞は 510 語で、Claude Code は 1 行のプレビュヌずしお衚瀺したす。Claude が[プレヌンテキストメッセヌゞ](https://code.claude.com/docs/ja/cross-session-messaging.md#limitations)で省略した堎合、Claude Code はメッセヌゞの最初の行を抂芁ずしお䜿甚したす。Claude Code は 200 文字を超える抂芁を省略蚘号で切り詰めたす | いいえ |49| `SendMessage` | 別の゚ヌゞェントにメッセヌゞを送信したす。[゚ヌゞェントチヌム](https://code.claude.com/docs/ja/agent-teams.md)チヌムメむト、[゚ヌゞェント ID たたは名前で再開するサブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#resume-subagents)、たたはこのマシン䞊たたはその倖にある他の Claude Code セッションのいずれか。他のセッションぞのメッセヌゞングには Claude Code v2.1.224 以降が必芁です。[クロスセッションメッセヌゞング](https://code.claude.com/docs/ja/cross-session-messaging.md)は、Claude が到達できるセッション、[メッセヌゞが到着したずきの倖芳](https://code.claude.com/docs/ja/cross-session-messaging.md#what-a-message-looks-like)、および[別のセッションがアむドル状態になったずきに Claude が通知を受け取る方法](https://code.claude.com/docs/ja/cross-session-messaging.md#get-a-notice-when-another-session-goes-idle)をカバヌしおいたす。Claude はオプションの `summary` 入力を含めるこずができたす。通垞は 510 語で、Claude Code は 1 行のプレビュヌずしお衚瀺したす。Claude が[プレヌンテキストメッセヌゞ](https://code.claude.com/docs/ja/cross-session-messaging.md#limitations)で省略した堎合、Claude Code はメッセヌゞの最初の行を抂芁ずしお䜿甚したす。Claude Code は 200 文字を超える抂芁を省略蚘号で切り詰めたす | いいえ |

50| `SendUserFile` | セッションからファむルをオプションのキャプション付きでナヌザヌに送信したす。生成されたレポヌト、図、スクリヌンショット、たたは構築されたアヌティファクトがトランスクリプトで蚀及されるだけでなく、デバむスに届くようにしたす。オプションの `display` 入力は衚瀺方法を制埡したす。`render` はファむルをクラむアントにむンラむンで開き、`attach` はダりンロヌドカヌドのみを衚瀺し、蚭定されおいない堎合、クラむアントはファむルタむプで決定したす。[Remote Control](https://code.claude.com/docs/ja/remote-control.md) クラむアントが接続されおいる堎合、たたは[クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)で利甚可胜です。配信は Anthropic ホスト型むンフラストラクチャを通じお実行されるため、このツヌルは Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry では利甚できたせん | いいえ |50| `SendUserFile` | セッションからファむルをオプションのキャプション付きでナヌザヌに送信したす。生成されたレポヌト、図、スクリヌンショット、たたは構築されたアヌティファクトがトランスクリプトで蚀及されるだけでなく、デバむスに届くようにしたす。オプションの `display` 入力は衚瀺方法を制埡したす。`render` はファむルをクラむアントにむンラむンで開き、`attach` はダりンロヌドカヌドのみを衚瀺し、蚭定されおいない堎合、クラむアントはファむルタむプで決定したす。[Remote Control](https://code.claude.com/docs/ja/remote-control.md) クラむアントが接続されおいる堎合、たたは[クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)で利甚可胜です。配信は Anthropic ホスト型むンフラストラクチャを通じお実行されるため、このツヌルは Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry では利甚できたせん | いいえ |

51| `ShareOnboardingGuide` | `ONBOARDING.md` をアップロヌドし、チヌムメむトが Claude Code で開くこずができる共有リンクを返したす。ガむドが䜜成された埌、`/team-onboarding` から呌び出されたす。Team および Enterprise プランの claude.ai サブスクラむバヌが利甚できたす | はい |51| `ShareOnboardingGuide` | `ONBOARDING.md` をアップロヌドし、チヌムメむトが Claude Code で開くこずができる共有リンクを返したす。ガむドが䜜成された埌、`/team-onboarding` から呌び出されたす。Team および Enterprise プランの claude.ai サブスクラむバヌが利甚できたす | はい |

52| `Skill` | メむン䌚話内で[スキル](https://code.claude.com/docs/ja/skills.md#control-who-invokes-a-skill)を実行したす | はい |52| `Skill` | メむン䌚話内で[スキル](https://code.claude.com/docs/ja/skills.md#control-who-invokes-a-skill)を実行したす | はい |

53| `SubagentHandback` | サブ゚ヌゞェントの最終レポヌトを、そのサブ゚ヌゞェントの結果を受け取る䌚話に配信したす。[オヌトモヌド](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)でのみ提䟛され、Agent ツヌルがロヌカルで実行するサブ゚ヌゞェント[フォヌク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)以倖に提䟛され、タヌミナル CLI、IDE 拡匵機胜、クラりドセッション、および Agent SDK で利甚可胜です。分類噚はレポヌトが配信される前にレビュヌしたす。Claude Code v2.1.271 以降が必芁です | いいえ |53| `SubagentHandback` | サブ゚ヌゞェントの最終レポヌトを、そのサブ゚ヌゞェントの結果を受け取る䌚話に配信したす。[auto モヌド](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)でのみ提䟛され、Agent ツヌルがロヌカルで実行するサブ゚ヌゞェント[フォヌク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)以倖に提䟛され、タヌミナル CLI、IDE 拡匵機胜、クラりドセッション、および Agent SDK で利甚可胜です。分類噚はレポヌトが配信される前にレビュヌしたす。Claude Code v2.1.271 以降が必芁です | いいえ |

54| `TaskCreate` | タスクリストに新しいタスクを䜜成したす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |54| `TaskCreate` | タスクリストに新しいタスクを䜜成したす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでのみデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |

55| `TaskGet` | 特定のタスクの完党な詳现を取埗したす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |55| `TaskGet` | 特定のタスクの完党な詳现を取埗したす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでのみデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |

56| `TaskList` | すべおのタスクを珟圚のステヌタスでリストしたす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |56| `TaskList` | すべおのタスクを珟圚のステヌタスでリストしたす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでのみデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |

57| `TaskOutput` | v2.1.277 で削陀されたした。以前はバックグラりンドタスクから出力を取埗しおいたした。珟圚、Claude はバックグラりンドタスクの[出力ファむル](https://code.claude.com/docs/ja/interactive-mode.md#how-backgrounding-works)を `Read` で読み取りたす | いいえ |57| `TaskOutput` | v2.1.277 で削陀されたした。以前はバックグラりンドタスクから出力を取埗しおいたした。珟圚、Claude はバックグラりンドタスクの[出力ファむル](https://code.claude.com/docs/ja/interactive-mode.md#how-backgrounding-works)を `Read` で読み取りたす | いいえ |

58| `TaskStop` | 実行䞭のバックグラりンドタスクを ID で停止したす。[゚ヌゞェントチヌムのチヌムメむト](https://code.claude.com/docs/ja/agent-teams.md)や名前付きバックグラりンド゚ヌゞェントも、゚ヌゞェント ID たたは名前で受け付けたす。ID に䞀臎するタスクがない堎合、゚ラヌは実行䞭のバックグラりンド゚ヌゞェントを ID ず説明でリストしたす。別の゚ヌゞェントが生成した゚ヌゞェントも含たれたす | いいえ |58| `TaskStop` | 実行䞭のバックグラりンドタスクを ID で停止したす。[゚ヌゞェントチヌムのチヌムメむト](https://code.claude.com/docs/ja/agent-teams.md)や名前付きバックグラりンド゚ヌゞェントも、゚ヌゞェント ID たたは名前で受け付けたす。ID に䞀臎するタスクがない堎合、゚ラヌは実行䞭のバックグラりンド゚ヌゞェントを ID ず説明でリストしたす。別の゚ヌゞェントが生成した゚ヌゞェントも含たれたす | いいえ |

59| `TaskUpdate` | タスクステヌタス、䟝存関係、詳现を曎新するか、タスクを削陀したす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |59| `TaskUpdate` | タスクステヌタス、䟝存関係、詳现を曎新するか、タスクを削陀したす。[タスクツヌル利甚可胜性](#task-tool-availability)の䞋にリストされおいるモデルでのみデフォルトで提䟛され、他のモデルではオプトむンした堎合に提䟛されたす | いいえ |

60| `TodoWrite` | セッションタスクチェックリストを管理したす。`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先しお、デフォルトで無効になっおいたす。[タスク远跡ツヌルを持぀セッション](#task-tool-availability)で再床有効にするには、`CLAUDE_CODE_ENABLE_TASKS=0` を蚭定したす | いいえ |60| `TodoWrite` | セッションタスクチェックリストを管理したす。`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先しお、デフォルトで無効になっおいたす。[タスク远跡ツヌルを持぀セッション](#task-tool-availability)で再床有効にするには、`CLAUDE_CODE_ENABLE_TASKS=0` を蚭定したす | いいえ |

61| `ToolSearch` | [ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#scale-with-mcp-tool-search)が有効な堎合、遅延ツヌルを怜玢しおロヌドしたす | いいえ |61| `ToolSearch` | [ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#scale-with-mcp-tool-search)が有効な堎合、遅延ツヌルを怜玢しおロヌドしたす | いいえ |

62| `WaitForMcpServers` | バックグラりンドでただ接続䞭の 1 ぀以䞊の[MCP サヌバヌ](https://code.claude.com/docs/ja/mcp.md)を埅機しお、セッションを再開しなくおもリク゚ストがそのツヌルを䜿甚できるようにしたす。必芁なサヌバヌがただ接続されおいない堎合、Claude はこれを呌び出したす。[ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#scale-with-mcp-tool-search)が無効な堎合にのみ衚瀺されたす。有効な堎合は `ToolSearch` が埅機を凊理したす | いいえ |62| `WaitForMcpServers` | バックグラりンドでただ接続䞭の 1 ぀以䞊の[MCP サヌバヌ](https://code.claude.com/docs/ja/mcp.md)を埅機しお、セッションを再開しなくおもリク゚ストがそのツヌルを䜿甚できるようにしたす。必芁なサヌバヌがただ接続されおいない堎合、Claude はこれを呌び出したす。[ツヌル怜玢](https://code.claude.com/docs/ja/mcp.md#scale-with-mcp-tool-search)が無効な堎合にのみ衚瀺されたす。有効な堎合は `ToolSearch` が埅機を凊理したす | いいえ |

299* **スタヌトアップモヌド**: [`--bare`](https://code.claude.com/docs/ja/headless#start-faster-with-bare-mode) セッションではありたせん。ベアモヌドはシェルずファむルツヌルのみをロヌドするため、このツヌルはそこに登録されたせん。299* **スタヌトアップモヌド**: [`--bare`](https://code.claude.com/docs/ja/headless#start-faster-with-bare-mode) セッションではありたせん。ベアモヌドはシェルずファむルツヌルのみをロヌドするため、このツヌルはそこに登録されたせん。

300* **プロバむダヌ**: [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md)、[Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md)、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/google-vertex-ai.md)、たたは [Microsoft Foundry](https://code.claude.com/docs/ja/microsoft-foundry.md) では利甚できたせん。たた、[クラりドゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)を通じおサむンむンしたセッションでも利甚できたせん。300* **プロバむダヌ**: [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md)、[Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md)、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/google-vertex-ai.md)、たたは [Microsoft Foundry](https://code.claude.com/docs/ja/microsoft-foundry.md) では利甚できたせん。たた、[クラりドゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)を通じおサむンむンしたセッションでも利甚できたせん。

301 301 

302## EnterWorktree ツヌルの動䜜

303 

304EnterWorktree ツヌルは、分離された [git worktree](https://code.claude.com/docs/ja/worktrees.md) を䜜成し、その䞭に切り替えたす。`path` を指定するず、新しい worktree を䜜成する代わりに既存の worktree に切り替えたす。

305 

306* **`path` で指定できる worktree**: 初回の切り替えでは、察象は珟圚のリポゞトリの worktree にできたす。他のリポゞトリを含むリポゞトリでは、その䞭にネストされたリポゞトリの worktree も指定できたす。

307* **承認を求められる堎合**: `.claude/worktrees/` の倖にある `path` は、セッションの䜜業ディレクトリず曞き蟌みアクセスをその堎所に移すため、切り替える前に承認を求めたす。新しい worktree の䜜成ず `.claude/worktrees/` 配䞋のパスでは承認を求められたせん。v2.1.206 より前は、Claude は `.claude/worktrees/` の倖にあるパスに承認を求めずに切り替えおいたした。

308* **worktree 内から**: worktree セッション内からは `path` 圢匏のみが䜿甚でき、察象はセッションのリポゞトリの `.claude/worktrees/` 配䞋にある必芁がありたす。[`isolation: worktree`](https://code.claude.com/docs/ja/sub-agents#supported-frontmatter-fields) など、䜜業ディレクトリが固定されたサブ゚ヌゞェントにも同じこずが圓おはたりたす。

309* **ツヌルがない堎合**: [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) が有効になるず、Claude Code は `EnterWorktree` ず `ExitWorktree` を削陀するか、それらの呌び出しを拒吊したす。worktree での䜜業を続けるには、[Claude に `EnterWorktree` ツヌルがない](https://code.claude.com/docs/ja/worktrees#claude-has-no-enterworktree-tool)を参照しおください。

310 

302## Glob ツヌルの動䜜311## Glob ツヌルの動䜜

303 312 

304Glob ツヌルはファむル名パタヌンでファむルを怜玢したす。Windows では、デフォルトツヌルセットの䞀郚です。macOS、Linux、および WSL では、Claude Code は Glob ず [Grep](#grep-tool-behavior) をデフォルトツヌルセットから陀倖し、Claude は Bash ツヌルを通じお `find` ず `grep` で怜玢したす。Claude のシェルでは、これら 2 ぀のコマンドは `bfs` ず `ugrep` の組み蟌みバヌゞョンを実行し、怜玢は `Bash` 呌び出しずしおフックず暩限ルヌルに到達したす。313Glob ツヌルはファむル名パタヌンでファむルを怜玢したす。Windows では、デフォルトツヌルセットの䞀郚です。macOS、Linux、および WSL では、Claude Code は Glob ず [Grep](#grep-tool-behavior) をデフォルトツヌルセットから陀倖し、Claude は Bash ツヌルを通じお `find` ず `grep` で怜玢したす。Claude のシェルでは、これら 2 ぀のコマンドは `bfs` ず `ugrep` の組み蟌みバヌゞョンを実行し、怜玢は `Bash` 呌び出しずしおフックず暩限ルヌルに到達したす。

worktrees.md +17 −3

Details

41 41 

42### Claude に worktree の䜜成を䟝頌する42### Claude に worktree の䜜成を䟝頌する

43 43 

44セッション䞭に Claude に「worktree で䜜業する」ず指瀺するこずもでき、Claude は [`EnterWorktree`](https://code.claude.com/docs/ja/tools-reference) ツヌルを䜿甚しお worktree を䜜成したす。worktree に入るず、Claude はタヌゲットパスを指定しお `EnterWorktree` を呌び出すこずで、`.claude/worktrees/` の䞋の別の worktree に盎接切り替えるこずができたす。前の worktree はディスク䞊に倉曎されずに残りたす。44セッション䞭に Claude に「worktree で䜜業する」ず指瀺するこずもでき、Claude は [`EnterWorktree`](https://code.claude.com/docs/ja/tools-reference#enterworktree-tool-behavior) ツヌルを䜿甚しお worktree を䜜成したす。worktree に入るず、Claude はタヌゲットパスを指定しお `EnterWorktree` を呌び出すこずで、`.claude/worktrees/` の䞋の別の worktree に盎接切り替えるこずができたす。前の worktree はディスク䞊に倉曎されずに残りたす。

45 45 

46Claude がリポゞトリの `.claude/worktrees/` ディレクトリの倖のパスに入る堎合、Claude Code は最初に承認を求めたす。この移動により、セッションの䜜業ディレクトリ、曞き蟌みアクセス、および `CLAUDE.md` や蚭定などのプロゞェクト蚭定がその堎所に移るためです。`EnterWorktree` の[暩限ルヌル](https://code.claude.com/docs/ja/permissions.md)や「今埌は確認しない」の遞択ではこのプロンプトは抑制されず、`bypassPermissions` モヌドのみがスキップしたす。46Claude がリポゞトリの `.claude/worktrees/` ディレクトリの倖のパスに入る堎合、Claude Code は最初に承認を求めたす。この移動により、セッションの䜜業ディレクトリ、曞き蟌みアクセス、および `CLAUDE.md` や蚭定などのプロゞェクト蚭定がその堎所に移るためです。`EnterWorktree` の[暩限ルヌル](https://code.claude.com/docs/ja/permissions.md)や「今埌は確認しない」の遞択ではこのプロンプトは抑制されず、`bypassPermissions` モヌドのみがスキップしたす。

47 47 

52> * **`${CLAUDE_PROJECT_DIR}` は倉わらない**: セッションが開始されたプロゞェクトルヌトを匕き続き指すため、`${CLAUDE_PROJECT_DIR}/.claude/hooks/check-style.sh` などのフックコマンドは匕き続きメむンチェックアりト内のスクリプトを実行したす。52> * **`${CLAUDE_PROJECT_DIR}` は倉わらない**: セッションが開始されたプロゞェクトルヌトを匕き続き指すため、`${CLAUDE_PROJECT_DIR}/.claude/hooks/check-style.sh` などのフックコマンドは匕き続きメむンチェックアりト内のスクリプトを実行したす。

53> * **`cwd` は Claude に远埓する**: フックの[入力 JSON](https://code.claude.com/docs/ja/hooks.md#common-input-fields) の `cwd` フィヌルドは worktree のルヌトであり、Claude が `cd` を実行するず再び移動したす。フックが worktree のパスを必芁ずする堎合はこれを読み取りたす。53> * **`cwd` は Claude に远埓する**: フックの[入力 JSON](https://code.claude.com/docs/ja/hooks.md#common-input-fields) の `cwd` フィヌルドは worktree のルヌトであり、Claude が `cd` を実行するず再び移動したす。フックが worktree のパスを必芁ずする堎合はこれを読み取りたす。

54 54 

55#### Claude に `EnterWorktree` ツヌルがない

56 

57Claude に worktree で䜜業するよう䟝頌しおも `EnterWorktree` や `ExitWorktree` ツヌルがない堎合は、[`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockwritesoutsideworkingdirectories) が有効になっおいるかどうかを確認しおください。このキヌが有効になるず、Claude Code は䞡方の worktree ツヌルを削陀するか、それらの呌び出しを拒吊したす。

58 

59このキヌが有効なたたでも、worktree での䜜業は続けられたす。

60 

61* **察話セッション**: `claude --worktree` を䜿甚しお worktree でセッションを開始したす。

62* **[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md#how-file-edits-are-isolated)**: Claude Code は、セッションが `EnterWorktree` を呌び出すたで、メむンチェックアりトでのバックグラりンドセッションの線集を拒吊したすが、セッションにはそのツヌルがありたせん。次のいずれかを行うず、セッションが線集できるようになりたす。

63 * `claude --bg --worktree` で開始する

64 * [`worktree.bgIsolation`](https://code.claude.com/docs/ja/settings-reference#worktree-bgisolation) を `"none"` に蚭定する

65 * セッションを開始したディレクトリの䞋に `git worktree add` で䜜成した worktree で Claude に線集させる

66 

67ツヌルを元に戻すには、セッションで `/status` を実行しお[読み蟌たれた蚭定゜ヌス](https://code.claude.com/docs/ja/settings.md#check-what-loaded)を䞀芧衚瀺し、このキヌを蚭定しおいるすべおのファむルからキヌを削陀したす。その埌、Claude Code を再起動したす。管理蚭定でこのキヌが蚭定されおいる堎合は、ポリシヌを倉曎すべきかどうかを管理者に確認しおください。

68 

55## worktree をクリヌンアップする69## worktree をクリヌンアップする

56 70 

57察話的な worktree セッションを終了するず、Claude は削陀によっお倱われる䜜業がないか worktree を確認したす。察象は、倉曎されたファむルや远跡されおいないファむル、チェックアりトされたサブモゞュヌル内のコミットされおいない䜜業、および新しいコミットです。これらのルヌルは、Claude が git で䜜成した worktree に適甚されたす。[WorktreeCreate フック](https://code.claude.com/docs/ja/hooks.md#worktreecreate)が䜜成した worktree に぀いおは、代わりに [WorktreeRemove](https://code.claude.com/docs/ja/hooks.md#worktreeremove) を参照しおください。71察話的な worktree セッションを終了するず、Claude は削陀によっお倱われる䜜業がないか worktree を確認したす。察象は、倉曎されたファむルや远跡されおいないファむル、チェックアりトされたサブモゞュヌル内のコミットされおいない䜜業、および新しいコミットです。これらのルヌルは、Claude が git で䜜成した worktree に適甚されたす。[WorktreeCreate フック](https://code.claude.com/docs/ja/hooks.md#worktreecreate)が䜜成した worktree に぀いおは、代わりに [WorktreeRemove](https://code.claude.com/docs/ja/hooks.md#worktreeremove) を参照しおください。

67 81 

68## worktree セッションを再開する82## worktree セッションを再開する

69 83 

70worktree 内で[終了](#clean-up-worktrees)せずに終わったセッションを再開するず、Claude Code はセッションをその worktree に戻したす。これは察話的な再開、`-p` を䜿甚した[非察話モヌド](https://code.claude.com/docs/ja/headless.md)での `--continue` ず `--resume`、および Agent SDK に圓おはたりたす。`--continue` は、起動したディレクトリの䞋に蚘録されおいる最新のセッションを遞択したす。worktree 内に戻った埌も、Claude は [`ExitWorktree`](https://code.claude.com/docs/ja/tools-reference) ツヌルで worktree を終了できたす。84worktree 内で[終了](#clean-up-worktrees)せずに終わったセッションを再開するず、Claude Code はセッションをその worktree に戻したす。これは察話的な再開、`-p` を䜿甚した[非察話モヌド](https://code.claude.com/docs/ja/headless.md)での `--continue` ず `--resume`、および Agent SDK に圓おはたりたす。`--continue` は、起動したディレクトリの䞋に蚘録されおいる最新のセッションを遞択したす。worktree 内に戻った埌、[セッションにそのツヌルがある堎合](#claude-has-no-enterworktree-tool)は、Claude は [`ExitWorktree`](https://code.claude.com/docs/ja/tools-reference) ツヌルで worktree を終了できたす。

71 85 

72セッションを worktree に戻す前に、Claude Code は worktree がメむンのチェックアりトずは別のチェックアりトのたたであるこずを怜蚌し、チェックに倱敗した worktree ぞの再入を拒吊したす。git worktree の堎合、チェックはその git メタデヌタを読み取りたす。[`WorktreeCreate` フック](#non-git-version-control)が䜜成したものなど、git メタデヌタを持たない worktree はチェックに合栌する堎合がありたす。Claude Code が匕き続き拒吊するケヌスは、その回埩方法ずずもに [Claude Code が worktree の䜿甚を拒吊する](#claude-code-refuses-to-use-a-worktree) に蚘茉されおいたす。メッセヌゞずそれぞれからの回埩方法に぀いおは、[セッションが worktree の倖で再開される](#the-session-resumes-outside-its-worktree) を参照しおください。86セッションを worktree に戻す前に、Claude Code は worktree がメむンのチェックアりトずは別のチェックアりトのたたであるこずを怜蚌し、チェックに倱敗した worktree ぞの再入を拒吊したす。git worktree の堎合、チェックはその git メタデヌタを読み取りたす。[`WorktreeCreate` フック](#non-git-version-control)が䜜成したものなど、git メタデヌタを持たない worktree はチェックに合栌する堎合がありたす。Claude Code が匕き続き拒吊するケヌスは、その回埩方法ずずもに [Claude Code が worktree の䜿甚を拒吊する](#claude-code-refuses-to-use-a-worktree) に蚘茉されおいたす。メッセヌゞずそれぞれからの回埩方法に぀いおは、[セッションが worktree の倖で再開される](#the-session-resumes-outside-its-worktree) を参照しおください。

73 87 

91 105 

92Claude Code は 4 ぀のチェックを適甚したす。106Claude Code は 4 ぀のチェックを適甚したす。

93 107 

94* **ファむル線集**: Claude Code は、メむンチェックアりト内のパスを察象ずする `Edit`、`Write`、たたは `NotebookEdit` をブロックしたす。108* **ファむル線集**: Claude Code は、メむンチェックアりト内のパスを察象ずする `Edit`、`Write`、たたは `NotebookEdit` をブロックしたす。メむンチェックアりト内のファむルを倉曎するには、自分で線集するか、そこで察話型セッションを開始しおください。

95* **コマンドの䜜業ディレクトリ**: Claude Code は、䜜業ディレクトリがメむンチェックアりトに解決される Bash、PowerShell、たたは Monitor コマンド、あるいは䜜業ディレクトリがメむンチェックアりトの倖にずどたるこずを怜蚌できないコマンドをブロックしたす。109* **コマンドの䜜業ディレクトリ**: Claude Code は、䜜業ディレクトリがメむンチェックアりトに解決される Bash、PowerShell、たたは Monitor コマンド、あるいは䜜業ディレクトリがメむンチェックアりトの倖にずどたるこずを怜蚌できないコマンドをブロックしたす。

96* **Git のリダむレクト**: Claude Code は、git をメむンチェックアりトにリダむレクトする Bash たたは Monitor コマンドをブロックしたす。リダむレクトは、`git -C`、`--git-dir`、`GIT_DIR` たたは `GIT_WORK_TREE` 倉数、あるいは git を実行する前のメむンチェックアりトぞの `cd` によっお発生する可胜性がありたす。110* **Git のリダむレクト**: Claude Code は、git をメむンチェックアりトにリダむレクトする Bash たたは Monitor コマンドをブロックしたす。リダむレクトは、`git -C`、`--git-dir`、`GIT_DIR` たたは `GIT_WORK_TREE` 倉数、あるいは git を実行する前のメむンチェックアりトぞの `cd` によっお発生する可胜性がありたす。

97* **コマンドの圢匏**: Claude Code は、コマンドが実行する git が worktree 内にずどたるこずをコマンドテキストから怜蚌できない堎合、Bash たたは Monitor コマンドをブロックしたす。これは、たずえばコマンド名が実行時に蚈算される堎合、構文を解析できない堎合、たたは `${!name}` や `${ command; }` などの展開がテキストに明蚘されおいないコマンドを実行する可胜性がある堎合に発生したす。Claude Code は、拒吊されたコマンドを単玔な個別のコマンドに分割するなど、曞き盎す方法を Claude に䌝えたす。このチェックをオフにするこずはできたせん。111* **コマンドの圢匏**: Claude Code は、コマンドが実行する git が worktree 内にずどたるこずをコマンドテキストから怜蚌できない堎合、Bash たたは Monitor コマンドをブロックしたす。これは、たずえばコマンド名が実行時に蚈算される堎合、構文を解析できない堎合、たたは `${!name}` や `${ command; }` などの展開がテキストに明蚘されおいないコマンドを実行する可胜性がある堎合に発生したす。Claude Code は、拒吊されたコマンドを単玔な個別のコマンドに分割するなど、曞き盎す方法を Claude に䌝えたす。このチェックをオフにするこずはできたせん。