Claude Code コマンド・環境変数リファレンス

Claude Codeステッカーを注文する。

例:/stickers

/ slash

/heapdump

JavaScriptヒープスナップショットとメモリ使用量の内訳を `~/Desktop` に書き出す。Claude Codeのメモリ使用量が高い場合のトラブルシューティングに使用する。

例:/heapdump

/ slash

/recap

現在のセッションの1行サマリーをオンデマンドで生成する。しばらく離席して戻った際に自動表示されるSession Recap機能と同じ内容を手動で取得できる。

例:/recap

関連機能

タスク中の重要な局面で第2のモデルに助言を求めるAdvisorツールを有効化・無効化する（v2.1.98以降）。`opus`・`sonnet`・`fable`（v2.1.170+）またはフルモデルIDを指定。引数なしでピッカーが開く。

例:/advisor opus

関連機能

🎛️ モデル設定

応答言語・出力スタイル

プラグインを管理する。`/plugin install <name>@<marketplace>` でインストール、`/plugin marketplace add <repo>` でマーケットプレースを追加できる。

例:/plugin install fakechat@claude-plugins-official

関連機能

/ slash

/reload-plugins

再起動せずにすべての有効なプラグインをリロードして変更を適用する。各コンポーネントのリロード件数と読み込みエラーを報告する。

例:/reload-plugins

関連機能

/ slash

/plugin list

インストール済みプラグインをインラインで一覧表示する（v2.1.163以降）。`/plugin` メニューを開かずに確認できる。`--enabled` または `--disabled` で絞り込み可能。CLIからは `claude plugin list` でも利用可能。

例:/plugin list --enabled

関連機能

Git連携

/ slash

/worktree

Git worktreeを使って現在のリポジトリの分離コピーを作成し、独立した作業環境を用意する。

例:/worktree create feature-branch

🌿 Git・ワークツリー 🚀 CI/CD統合 ⚙️ スキル・スラッシュコマンド

/ slash

/autofix-pr

現在のブランチのPRを監視し、CIの失敗やレビューコメントに対して自動修正をプッシュするWebセッションを起動する。`gh` CLIとClaude Code on the webへのアクセスが必要。

例:/autofix-pr only fix lint and type errors

関連機能

/ slash

/ultrareview

クラウドサンドボックスで複数エージェントによる深いコードレビューを実行する。ProおよびMaxプランで3回まで無料。それ以降はExtra Usageが必要。PR番号または現在のブランチを指定できる。

例:/ultrareview

関連機能

⏰ ルーティン（クラウド自動実行）🚀 CI/CD統合

/ slash

/web-setup

ローカルの `gh` CLI認証情報を使ってClaude Code on the webにGitHubアカウントを接続する。`/schedule` でGitHubが未接続の場合に自動的に案内される。

例:/web-setup

関連機能

/ slash

/diff

インタラクティブなdiffビューアーを開く。未コミットの変更とターンごとのdiffを表示。左右矢印で現在のgit diffと各Claudeターンを切り替え、上下でファイルを閲覧できる。

例:/diff

関連機能

自動化・CI/CD

/ slash

/hooks

ツール呼び出しの前後や特定イベントに対してシェルコマンドを自動実行するhooks機能を設定・確認する。

例:/hooks

関連機能

Claude Codeのloopとscheduleの違いQiita AI記事 · 今日

/ slash

/install-github-app

Claude Code GitHub Appのセットアップをインタラクティブに案内する。必要なシークレットとワークフローファイルを自動設定する。

例:/install-github-app

関連機能

🚀 CI/CD統合

例:/subtask 失敗テストの原因を別案で調査して

/ slash

/peers

`/list-agents`のエイリアス。クロスセッションメッセージングでClaudeがメッセージを送れる他セッションの一覧を表示する。

例:/peers

関連機能

📡 クロスセッションメッセージング

/ slash

/skill-doctor

各スキルのコンテキストコストと呼び出し頻度をレポートし、未使用スキルの発見に役立てる（v2.1.252以降）。

例:/skill-doctor

関連機能

⚙️ スキル・スラッシュコマンド

セッション中にファイルアクセス用の作業ディレクトリを追加する。`--add-dir` と同様にファイルアクセスを拡張するが、`.claude/` 設定の多くはそのディレクトリからは探索されない。

例:/add-dir ../shared-lib

/ slash

/permissions

ツール権限のallow・ask・denyルールをインタラクティブに管理する。スコープ別のルール一覧・追加・削除・作業ディレクトリ管理・auto modeの最近の拒否履歴確認ができる。`/allowed-tools` でも起動可能。

例:/permissions

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

/ slash

/security-review

現在のブランチの変更をセキュリティ脆弱性の観点でレビューする。git diffを解析しインジェクション・認証問題・データ漏洩リスクを特定する。

例:/security-review

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

/ slash

/auto-mode-setup

プロジェクトと直近のセッション履歴から`autoMode.environment`の設定案を自動生成し、内容を確認したうえでユーザー設定に保存する（Pro/Max/Teamプランとv2.1.228以降が必要。Windows版はv2.1.233以降）。

例:/auto-mode-setup

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

サンドボックス

/ slash

/sandbox

サンドボックスモードのオン/オフを切り替える。対応プラットフォームのみ利用可能。

例:/sandbox

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

リモートAPI（Bedrock / Vertex / プロキシ）

/ slash

/setup-vertex

Google Vertex AIの認証・プロジェクト・リージョン・モデルピンをインタラクティブウィザードで設定する。`CLAUDE_CODE_USE_VERTEX=1` が設定されている場合のみ表示される。

例:/setup-vertex

関連機能

Claude Code v2.1.278リリースClaude Code Releases · 23日前

Claude Codeの更新でEffort上限設定が可能にQiita AI記事 · 2026/09/09

Claude Code v2.1.267リリースClaude Code Releases · 2026/09/09

Claude Code v2.1.248：安全性と速度が向上Qiita AI記事 · 2026/08/28

/ slash

/setup-bedrock

Amazon Bedrockの認証・リージョン・モデルピンをインタラクティブウィザードで設定する。`CLAUDE_CODE_USE_BEDROCK=1` が設定されている場合のみ表示される。

例:/setup-bedrock

関連機能

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

現在のセッションで読み込まれているすべてのCLAUDE.mdとルールファイルを一覧表示する。オートメモリのオン/オフ切り替えやメモリフォルダへのリンクも提供する。

例:/memory

プランの使用量上限とレートリミットの状態を表示する。

マウスホイールのスクロール速度をインタラクティブに調整する。変更をプレビューしながらルーラーをスクロールして設定できる。フルスクリーンレンダリング時のみ利用可能。

例:/scroll-speed

関連機能

/ slash

/focus

フォーカスビューのオン/オフを切り替える。最後のプロンプト・ツール呼び出しサマリー・最終レスポンスのみを表示し、不要な情報を省いて作業に集中できる。選択状態はセッションをまたいで保持される。フルスクリーンレンダリング時のみ利用可能。

例:/focus

関連機能

/ slash

/tui

ターミナルUIレンダラーを切り替えて再起動する。`fullscreen` でちらつきのないaltスクリーンレンダラーに、`default` で通常のメインスクリーンレンダラーに変更。引数なしで現在のレンダラーを表示する。

例:/tui fullscreen

Shift+Enterなどのキーバインドをターミナルに設定する。VS Code・Alacritty・Warpなどネイティブでキーバインドを解釈しないターミナルでのみ表示される。

例:/terminal-setup

/ slash

/theme

例:claude -p --max-budget-usd 5.00 "大規模リファクタリング"

-- cli

--chrome

Chromeブラウザ連携を有効化してWebオートメーションやテストを可能にする。

例:claude --chrome

関連機能

🌐 ブラウザ統合

-- cli

--debug

デバッグモードを有効化する。カテゴリ絞り込みも可能（例: `"api,hooks"` または `"!statsig,!file"`）。

例:claude --debug "api,mcp"

-- cli

--disable-slash-commands

このセッション内のすべてのスキルとスラッシュコマンドを無効化する。

例:claude --disable-slash-commands

このセッションでChromeブラウザ連携を無効化する。デフォルトでChrome連携が有効になっている場合に一時的に無効化するために使用する。

例:claude --no-chrome

関連機能

🌐 ブラウザ統合

-- cli

--prompt-suggestions

各ターン後に次のユーザープロンプト候補を `prompt_suggestion` メッセージとして出力する。`--print`・`--output-format stream-json`・`--verbose` との組み合わせが必要。

例:claude -p --prompt-suggestions --output-format stream-json --verbose "query"

-- cli

--safe-mode

すべてのカスタマイズを無効化してデバッグセッションを開始する（v2.1.169以降）。CLAUDE.md・スキル・プラグイン・フック・MCPサーバー・カスタムコマンドが読み込まれない。設定問題の切り分けに使用する。`CLAUDE_CODE_SAFE_MODE` 環境変数でも設定可能。

例:claude --safe-mode

-- cli

claude doctor

インストール状態・設定ファイル・Remote Control適格性などを診断するCLIサブコマンド。スラッシュコマンド`/doctor`のCLI版。

例:claude doctor

-- cli

--autocompact <auto|tokens>

このセッション限定でauto-compactのウィンドウ幅を設定する（保存済み設定は変更しない）。`/autocompact`と同じ値の形式を受け付ける（v2.1.221以降）。

例:claude --autocompact 500k

-- cli

claude import

他のコーディングエージェント（Codex・Gemini CLI）の設定を取り込む`/import`を実行する対話セッションを開始する。`/import`と同じ`--dry-run`・`--yes`オプションに対応（v2.1.213以降）。

プラグインの評価ケース（プロンプト＋採点器）を隔離セッションで複数回実行し、スコア付きの結果を出力する（v2.1.269以降）。デフォルトでプラグイン無しの場合とも比較し、`--threshold` 未満ならexit 1になるためCIに組み込める。

例:claude plugin eval ./my-plugin --runs 5 --threshold 0.8

関連機能

関連記事なし

-- cli

claude plugin eval init

カレントディレクトリのプラグイン用に評価スイートを作成する（v2.1.269以降）。ターミナルではClaudeが対話形式でヒアリングしながら評価ケースを作成する。

例:claude plugin eval init

関連機能

関連記事なし

-- cli

claude plugin tag

プラグインのリリース用に `<name>--v<version>` 形式のannotated gitタグを作成する。タグ付け前に `plugin.json` とマーケットプレースエントリのバージョン一致を検証する。

例:claude plugin tag ./my-plugin

関連機能

MCPサーバー追加時に事前設定済みOAuthクライアントIDを指定する。Dynamic Client Registration非対応サーバーの認証に使用。

例:

claude mcp add --transport http --client-id your-client-id --client-secret --callback-port 8080 my-server https://mcp.example.com/mcp

関連機能

-- cli

--client-secret

MCPサーバー追加時に事前設定済みOAuthクライアントシークレットをマスク入力で指定する。`--client-id`と組み合わせて使用。

例:claude mcp add --transport http --client-id id --client-secret my-server https://mcp.example.com/mcp

関連機能

-- cli

claude plugins

`claude plugin`のエイリアス。プラグインの管理（一覧表示・インストール・有効化・無効化など）を行う。

例:claude plugins list

-- cli

--header / -H

`claude mcp add`で、HTTP/SSEサーバーの認証ヘッダー（例: Authorizationトークン）を指定する。短縮形`-H`も使用可能。

例:claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer TOKEN"

-- cli

--transport / -t

`claude mcp add` でMCPサーバーのトランスポート種別（http・sse・stdio・ws）を指定する。

例:claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

関連記事なし

1つまたは全マーケットプレイスをソースから更新し、新しいプラグインやバージョンを取得する。

例:claude plugin marketplace update your-marketplace

関連機能

関連記事なし

Git連携

-- cli

--from-pr

特定のGitHub PRにリンクされたセッションを再開する。PR番号またはURLを指定する。`gh pr create` 経由で作成されたセッションに自動リンクされる。

例:claude --from-pr 123

関連機能

-- cli

--worktree / -w

エージェントをGit worktreeの隔離コピーで実行する。メインブランチを汚さず実験的な変更を安全に試せる。

例:claude -w feature-auth -p "認証機能を実装して"

関連機能

-- cli

claude ultrareview

非インタラクティブモードでUltraReviewを実行する。結果をstdoutに出力し、成功時は終了コード0、失敗時は1を返す。`--json` で生データ出力、`--timeout <分>` でデフォルト30分のタイムアウトを変更できる。

例:claude ultrareview 1234 --json

関連機能

-- cli

--tmux

worktree用のtmuxセッションを作成する。`--worktree` と組み合わせて使用。iTerm2が利用可能な場合はネイティブペインを使用。従来のtmuxを使うには `--tmux=classic` を指定する。

例:claude -w feature-auth --tmux

関連機能

カスタムサブエージェントをJSON形式で動的に定義する。サブエージェントのフロントマターと同じフィールド名と `prompt` フィールドを使用する。

例:

claude --agents '{"reviewer":{"description":"コードレビュアー","prompt":"あなたはコードレビュアーです"}}'

関連機能

-- cli

--bg

セッションをバックグラウンドエージェントとして開始してすぐに制御を返す。セッションIDと管理コマンドを出力する。`--agent` と組み合わせて特定のサブエージェントをバックグラウンドで実行できる。

全フックライフサイクルイベントを出力ストリームに含める。`--output-format stream-json` と組み合わせて使用する。

例:claude -p --output-format stream-json --include-hook-events "query"

関連機能

-- cli

--exec

Claudeセッションを開始せず、シェルコマンドをPTYバックドのバックグラウンドジョブとして実行する。`--bg` と組み合わせてシェルから起動する。`claude agents` でアタッチ・デタッチできる。

例:claude --bg --exec 'pytest -x'

関連機能

バックグラウンドセッションのスーパーバイザーを現在のターミナルでフォアグラウンド実行し、ログを表示する。

-- cli

--permission-prompt-tool

非インタラクティブモードで権限プロンプトを処理するMCPツールを指定する。

例:claude -p --permission-prompt-tool mcp_auth_tool "query"

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

-- cli

claude auto-mode config

設定を適用した後にclassifierが実際に使用するルールをJSON形式で表示する。`$defaults` を展開して確認できる。設定保存後に有効なルールを確認するために使用する。

例:claude auto-mode config

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

-- cli

claude auto-mode critique

カスタムの `allow`・`soft_deny`・`hard_deny` ルールに対してAIフィードバックを得る。曖昧・冗長・誤検知を起こしやすいエントリを指摘する。

例:claude auto-mode critique

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

-- cli

--enable-auto-mode

**v2.1.111で削除済み。** 代わりに `--permission-mode auto` を使用すること。旧バージョンではShift+TabサイクルにAutoモードを追加するために使用。

例:claude --permission-mode auto

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

-- cli

claude auto-mode reset

auto modeのカスタム設定を組み込みのデフォルト状態にリセットする。

例:claude auto-mode reset

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

-- cli

--restricted

組み込みツールとWebFetchを取り除き、ファイルアクセスを作業ディレクトリ内に制限した制限モードでセッションを開始する（v2.1.248以降）。

例:claude --restricted

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

--permission-prompts

-- cli

claude self-hosted-runner doctor

デプロイ済みのセルフホストランナーを診断する（v2.1.224以降）。

例:claude self-hosted-runner doctor

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

claude self-hosted-runner orchestrator

オンデマンドランナーを起動するオーケストレータープロセスを開始する（v2.1.224以降）。

例:claude self-hosted-runner orchestrator

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

--defer-shutdown-max-min

セルフホストランナーがSIGTERM受信後もセッションの提供を最大N分間継続してからドレインするよう設定する（`claude self-hosted-runner`実行時、v2.1.238以降）。ローリング再起動時のセッション中断を減らせる。

例:claude self-hosted-runner --defer-shutdown-max-min 10

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

--proxy-authorization-command

セルフホストランナーが送信する`Proxy-Authorization`ヘッダーの値を、指定したシェルコマンドの標準出力から取得する（v2.1.238以降）。トークンを都度生成する社内プロキシ経由の通信に使用する。

例:claude self-hosted-runner --proxy-authorization-command "get-proxy-token.sh"

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

--proxy-authorization-file

セルフホストランナーが送信する`Proxy-Authorization`ヘッダーの値を、ファイルの内容から取得する（v2.1.238以降）。別プロセスがトークンをローテーションする構成で使用する。

例:claude self-hosted-runner --proxy-authorization-file /var/run/proxy-token

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

--client-label

セルフホストランナーの表示ラベルを上書きする（`claude self-hosted-runner`実行時、v2.1.248以降）。複数ランナーを運用する際の識別に使用する。

例:claude self-hosted-runner --client-label "runner-tokyo-1"

関連機能

Claude Code v2.1.269リリースClaude Code Releases · 2026/09/11

-- cli

--drain-grace-sec

セルフホストランナーがSIGTERM等を受けた後も、ロック済みオーナーのキューをその秒数だけポーリングし続けてから終了する（デフォルト0＝即終了）。

例:claude self-hosted-runner --drain-grace-sec 120

関連機能

関連記事なし

-- cli

--retire-at <epoch-seconds>

指定したUNIX時刻にセルフホストランナーが新規セッションの受付を停止し、稼働中セッションを解放してから終了する。シグナルなしでホストが破棄されるスポットインスタンス等の環境向け。

例:claude self-hosted-runner --retire-at 1735689600

関連機能

関連記事なし

-- cli

--release-idle-session-min

セルフホストランナーが指定分数アイドル状態のセッションを解放し、次にユーザーがメッセージを送った際に別のランナーへ再開させる。

例:claude self-hosted-runner --release-idle-session-min 30

関連機能

関連記事なし

リモートAPI（Bedrock / Vertex / プロキシ）

-- cli

claude gateway

セルフホスト型のClaude appsゲートウェイサーバーを起動する。managed settingsを自社インフラ経由で配信したい企業向けの機能。

例:claude gateway

関連機能

-- cli

--betas

APIリクエストに含めるベータヘッダーを指定する（APIキーユーザー限定）。`interleaved-thinking` などの実験的機能を有効化できる。

CI/CDやスクリプト用の長期OAuthトークンを生成する。トークンはターミナルに出力されるだけで保存されない。Claudeサブスクリプションが必要。

例:claude setup-token

関連機能

外観・インターフェース

-- cli

--desktop

現在のディレクトリでClaude Desktopアプリを開き、ターミナルではセッションを開始せず終了する。`--continue` や `--resume <ID>` を併用するとそのセッションをDesktopで開く（v2.1.285以降）。

例:claude --desktop

-- cli

--ax-screen-reader

スクリーンリーダー対応のフラット出力モードで起動する（v2.1.181以降）。装飾ボーダーやアニメーションを除いたテキスト表示に切り替える。クラシックレンダラーを強制し、`tui` 設定は無視される。

例:claude --ax-screen-reader

関連機能

設定オプション

config

DISABLE_DOCTOR_COMMAND

`/doctor`（`/checkup`）コマンドをモデルから非表示にする環境変数。`disableBundledSkills` を有効にしても `/doctor` は組み込みコマンドとして入力可能なままのため、非表示にしたい場合はこちらを使用する。

例:export DISABLE_DOCTOR_COMMAND=1

config

CLAUDE_CODE_SAFE_MODE

すべてのカスタマイズを無効化したセーフモードを環境変数で有効化する（v2.1.169以降）。`--safe-mode` フラグと同等の効果。CLAUDE.md・スキル・プラグイン・フック・MCPサーバーが読み込まれない。

例:export CLAUDE_CODE_SAFE_MODE=1

config

enableArtifact

Artifactツール（成果物をclaude.ai上で公開・共有できる機能）を有効化する。未設定の場合はアカウントの機能提供状況に従う。`disableArtifact` の対になる設定。

例:~/.claude/settings.json: {"enableArtifact": true}

config

CLAUDE_CODE_ENABLE_CFC

`1` でChrome連携を有効、`0` で無効にしてCLIセッションを起動する。`claudeInChromeDefaultEnabled` より優先。

例:export CLAUDE_CODE_ENABLE_CFC=1

関連機能

関連機能

🎛️ モデル設定

例:~/.claude/settings.json: {"showThinkingSummaries": true}

関連機能

🧠 メモリ・コンテキスト管理

MCP連携

config

mcpServers

使用するMCPサーバーの定義を設定する。サーバー名・起動コマンド・引数・環境変数を指定。`~/.claude/mcp.json`（グローバル）または `.mcp.json`（プロジェクト固有）に記述。

例:

~/.claude/mcp.json: {"mcpServers": {"github": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"]}}}

config

enableAllProjectMcpServers

プロジェクトの `.mcp.json` に定義された全MCPサーバーを確認なしで自動承認する。チームで共有する際に毎回承認する手間を省ける。

例:~/.claude/settings.json: {"enableAllProjectMcpServers": true}

config

enabledMcpjsonServers

プロジェクトの `.mcp.json` から承認するMCPサーバー名を個別に指定する。`enableAllProjectMcpServers` より細かく制御できる。

例:~/.claude/settings.json: {"enabledMcpjsonServers": ["memory", "github"]}

config

disabledMcpjsonServers

プロジェクトの `.mcp.json` から拒否するMCPサーバー名を個別に指定する。`enabledMcpjsonServers` より細かく制御できる。

例:~/.claude/settings.json: {"disabledMcpjsonServers": ["filesystem"]}

config

allowedMcpServers

（Managed設定専用）ユーザーが設定できるMCPサーバーの許可リスト。未定義=制限なし、空配列=完全ロックダウン。`deniedMcpServers` が優先される。

例:managed-settings.json: {"allowedMcpServers": [{"serverName": "github"}]}

リポジトリで利用可能な追加マーケットプレースを定義する。チームメンバーがフォルダを信頼した際にマーケットプレースのインストールを促す。`github`・`git`・`directory`・`settings` 形式をサポート。

例:

~/.claude/settings.json: {"extraKnownMarketplaces": {"acme-tools": {"source": {"source": "github", "repo": "acme-corp/claude-plugins"}}}}

関連機能

config

allowManagedMcpServersOnly

（Managed設定専用）`allowedMcpServers` で許可したMCPサーバーのみを適用する。ユーザーはMCPサーバーを追加できるが、管理者定義の許可リストのみが有効になる。`deniedMcpServers` はすべてのソースからマージされる。

例:managed-settings.json: {"allowManagedMcpServersOnly": true}

関連機能

config

blockedMarketplaces

（Managed設定専用）ブロックするプラグインマーケットプレースのリスト。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることなく排除される。

例:managed-settings.json: {"blockedMarketplaces": [{"source": "github", "repo": "untrusted/plugins"}]}

関連機能

config

strictKnownMarketplaces

（Managed設定専用）ユーザーが追加できるプラグインマーケットプレースの許可リスト。未設定=制限なし、空配列=完全ロックダウン。マーケットプレースの追加のみに適用。

例:managed-settings.json: {"strictKnownMarketplaces": [{"source": "github", "repo": "acme-corp/plugins"}]}

関連機能

config

pluginTrustMessage

（Managed設定専用）プラグインインストール前に表示されるトラスト警告に追加するカスタムメッセージ。社内マーケットプレースのプラグインが審査済みであることを確認するなど、組織固有のコンテキストを追加できる。

例:managed-settings.json: {"pluginTrustMessage": "All plugins from our marketplace are approved by IT"}

関連機能

config

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY

`ANTHROPIC_BASE_URL` がAnthropic互換ゲートウェイを指している場合に、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーのモデル一覧を取得する（v2.1.129以降）。`1` に設定してオプトイン。

例:export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

関連機能

config

CLAUDE_AGENT_SDK_MCP_NO_PREFIX

MCPツール名の `mcp__<server>__` プレフィックスを省略する。Agent SDKでMCPツールを使う場合に、プレフィックスなしでツール名を参照したい場合に設定する。

例:export CLAUDE_AGENT_SDK_MCP_NO_PREFIX=1

関連機能

config

allowAllClaudeAiMcps

（Team/Enterprise向けManaged設定）`managed-mcp.json` と並んでclaude.aiクラウドMCPコネクタをすべて読み込む。`true` に設定するとOrganization管理のMCPサーバーをユーザーが利用できる。

例:managed-settings.json: {"allowAllClaudeAiMcps": true}

関連機能

config

pluginSuggestionMarketplaces

セッション中にプラグイン提案として表示するマーケットプレースを指定する。指定したマーケットプレースのプラグインが推奨候補として提示される。

例:~/.claude/settings.json: {"pluginSuggestionMarketplaces": [{"source": "github", "repo": "acme-corp/claude-plugins"}]}

関連機能

config

disableClaudeAiConnectors

claude.aiのMCPコネクタ（クラウド接続）を無効化する（v2.1.182以降）。`allowAllClaudeAiMcps` が有効な場合でもコネクタの読み込みを防ぐ。

例:~/.claude/settings.json: {"disableClaudeAiConnectors": true}

関連機能

config

headersHelper

MCPサーバー接続時にHTTPヘッダーを動的生成するコマンドを指定する。Kerberosや短命トークンなどOAuth以外の認証方式に使用。

例:.mcp.json: {"mcpServers": {"internal-api": {"type": "http", "url": "...", "headersHelper": "/opt/bin/get-headers.sh"}}}

関連機能

config

disabledMcpServers

`/mcp`パネルでオフに切り替えたユーザー設定・プラグイン・claude.aiコネクタ・デフォルト有効の組み込みサーバーを記録するオプトアウトリスト（`~/.claude.json`）。

例:~/.claude.json: {"projects": {"/path": {"disabledMcpServers": ["claude.ai Slack"]}}}

関連機能

config

enabledMcpServers

デフォルトで無効な組み込みMCPサーバー（`computer-use`等）を有効化するオプトインリスト（`~/.claude.json`）。

例:~/.claude.json: {"projects": {"/path": {"enabledMcpServers": ["computer-use"]}}}

関連機能

config

CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT

MCPサーバーが応答も進捗通知も返さない場合にツール呼び出しを中断するアイドルタイムアウト（ミリ秒）を設定する。`0`で無効化。

例:export CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=600000

関連機能

config

CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS

メイン会話中のMCPツール呼び出しがバックグラウンドタスクに切り替わるまでの閾値（ミリ秒、デフォルト2分）を設定する。`0`で自動バックグラウンド化を無効化。

例:export CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=300000

関連機能

config

ENABLE_TOOL_SEARCH

MCPツールをコンテキストへ事前ロードせず必要時に検索するTool Searchの動作を制御する。`true`/`false`/`auto`/`auto:N`（Nは0〜100の割合）から選択。

例:ENABLE_TOOL_SEARCH=auto:5 claude

関連機能

config

MCP_CLIENT_SECRET

MCPサーバー追加時のOAuthクライアントシークレット入力プロンプトをスキップするための環境変数。CI/CDでの非対話的なサーバー登録に使用。

例:

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http --client-id id --client-secret my-server https://mcp.example.com/mcp

関連機能

非インタラクティブセッションの最初のターンが、接続中のMCPサーバーを待つ時間（ミリ秒）を指定する環境変数（v2.1.274以降）。`0` で待機をスキップする。

例:export CLAUDE_CODE_MCP_STARTUP_WAIT_MS=10000

組織が `managed-mcp.json` を配布している場合でも、組み込みのClaude in Chromeサーバーを併せて動作させる。

例:managed-settings.json: {"allowClaudeInChromeWithManagedMcp": true}

関連記事なし

config

appendPlugins

組織のmodを、ユーザーがインストールしたすべてのmodの後に実行する管理者向け設定。

起動時に並列接続するローカルMCPサーバー（stdio）の最大数（既定3）。

例:export MCP_SERVER_CONNECTION_BATCH_SIZE=5

関連機能

worktreeのベースブランチを設定する。`fresh`（デフォルト: リモートのデフォルトブランチから分岐）または `head`（ローカルHEADから分岐）から選択。`fresh` では未プッシュのコミットを新しいworktreeに含めない。

例:~/.claude/settings.json: {"worktree": {"baseRef": "head"}}

関連機能

config

worktree.symlinkDirectories

各Git worktreeにシンボリックリンクするディレクトリを指定する。`node_modules` などをリンクすることでディスク容量を節約できる。

例:~/.claude/settings.json: {"worktree": {"symlinkDirectories": ["node_modules", ".cache"]}}

config

worktree.sparsePaths

git sparse-checkoutで各worktreeにチェックアウトするディレクトリを指定する。モノレポで必要な部分だけチェックアウトして高速化できる。

例:~/.claude/settings.json: {"worktree": {"sparsePaths": ["packages/my-app", "shared/utils"]}}

config

worktree.bgIsolation

バックグラウンドセッションのworktree分離モードを設定する（v2.1.143以降）。`"none"` にするとバックグラウンドセッションがworktreeなしでワーキングコピーを直接編集する。worktreeが実用的でないリポジトリでの利用を想定。

例:~/.claude/settings.json: {"worktree": {"bgIsolation": "none"}}

関連機能

config

prUrlTemplate

PRバッジに表示するURLのテンプレートを設定する。GitHub EnterpriseやGitLabのURLパターンに合わせてカスタマイズできる。`{owner}`・`{repo}`・`{number}` のプレースホルダーを使用できる。

例:~/.claude/settings.json: {"prUrlTemplate": "https://github.example.com/{owner}/{repo}/pull/{number}"}

関連機能

config

attribution.sessionUrl

cloudセッションやRemote Controlから作成されたコミットに付与されるclaude.aiセッションへのリンクを省略する。

例:~/.claude/settings.json: {"attribution": {"sessionUrl": ""}}

config

.worktreeinclude

gitignore構文で書くプロジェクトルートのファイル。新しいworktree作成時に`.env`などgitignore対象のファイルを自動コピーする。

例:.worktreeinclude: .env\n.env.local

関連機能

関連記事なし

config

prStatusFooterEnabled

プロンプトフッターのPRレビュー状況バッジと、その元となるプルリクエストのチェックをオフにする設定。

例:~/.claude.json: {"prStatusFooterEnabled": false}

config

worktree.location

デスクトップアプリのSSHセッションがリモートマシン上でworktreeを作成するフォルダ。`--worktree` やサブエージェントは参照しない。

例:~/.claude/settings.json（リモート側）: {"worktree": {"location": "~/worktrees"}}

関連機能

関連記事なし

自動化・CI/CD

config

hooks

ツール呼び出しの前後（PreToolUse/PostToolUse）・通知（Notification）・セッション終了（Stop）などのイベントに対して実行するシェルコマンドを定義する。lint・フォーマット・通知の自動化に活用できる。

例:

~/.claude/settings.json: {"hooks": {"PostToolUse": [{"matcher": "Write", "hooks": [{"type": "command", "command": "npx eslint --fix"}]}]}}

関連機能

config

includeCoAuthoredBy

例:~/.claude/settings.json: {"bashEditDiffEnabled": true}

関連機能

関連記事なし

config

teammateMode

エージェントチームのチームメイトの表示方法を設定する。`in-process`（デフォルト、v2.1.179以降）・`auto`（tmuxやiTerm2使用時はスプリットペイン）・`tmux`・`iterm2`（v2.1.186以降、iTerm2ネイティブのスプリットペインを明示指定）から選択。

例:~/.claude/settings.json: {"teammateMode": "in-process"}

関連機能

config

agent

メインスレッドをnamed subagentとして実行する。そのサブエージェントのシステムプロンプト・ツール制限・モデルが適用される。

例:~/.claude/settings.json: {"agent": "code-reviewer"}

関連機能

コンテキストの自動コンパクション（圧縮）が発動するしきい値（%）を上書きする。デフォルトは約95%。低い値（例: `50`）を設定するとより早く圧縮が行われる。サブエージェントにも適用される。

例:export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70

config

httpHookAllowedEnvVars

HTTPフックがヘッダー値に展開できる環境変数名を制限する。各フックの実効的な `allowedEnvVars` はフック自身の設定とこの設定の交差集合になる。

例:~/.claude/settings.json: {"httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]}

関連機能

SessionEndフックに割り当てる実行時間の上限（ミリ秒）を設定する。フックが重い処理を行う場合は増やして使用する。

例:export CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000

関連機能

`PostToolUse` フックの設定オプション。`true` に設定するとフックが拒否した際にターンを終了せず拒否理由をClaudeにフィードバックしてターンを継続する。

例:~/.claude/settings.json: {"hooks": {"PostToolUse": [{"matcher": "Write", "continueOnBlock": true, "hooks": [...]}]}}

関連機能

`SessionStart`・`Setup`・`CwdChanged`・`FileChanged` フックが環境変数をセッションに永続化するために書き込むファイルパス。フックからセッション全体で有効な環境変数を設定する際に使用。

例:echo "MY_VAR=value" >> "$CLAUDE_ENV_FILE"

関連機能

config

CLAUDE_EFFORT

フック実行時にツール呼び出しコンテキストとして渡される現在の努力レベル（`low`・`medium`・`high`・`xhigh`・`max`）を保持する環境変数。努力レベルを設定する `CLAUDE_CODE_EFFORT_LEVEL` とは異なり読み取り専用。

例:echo "current effort: $CLAUDE_EFFORT"

関連機能

1つのメッセージから同時に起動できるサブエージェントの最大数を設定する環境変数（デフォルト20）。1つのメッセージが無制限にバックグラウンドエージェントを増やすのを防ぐ（v2.1.217以降）。

例:export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=10

関連機能

config

autoCompactWindow

コンテキストがどの程度埋まった時点でオートコンパクト（自動要約圧縮）を発動させるか、しきい値を設定する。

例:~/.claude/settings.json: {"autoCompactWindow": 0.8}

config

enableWorkflows

ダイナミックワークフロー機能を、契約プランのデフォルト設定に関わらずオン・オフする。

例:~/.claude/settings.json: {"enableWorkflows": true}

config

processWrapper

macOS・Linuxでのバックグラウンドプロセス実行を、コーポレートランチャー経由で行うようにする。

例:~/.claude/settings.json: {"processWrapper": "/usr/local/bin/corp-launcher"}

config

ultracode

ユーザーから指示されなくても、Claudeが主要なタスクごとに自律的にワークフローを計画するようにする。

例:~/.claude/settings.json: {"ultracode": true}

config

hooks.SessionStart

セッション開始・再開時に発火。matcherは startup/resume/clear/compact/fork。開発コンテキストの読み込みや環境変数設定に使う。exit code 2はエラー表示のみでブロック不可。

例:

~/.claude/settings.json: {"hooks": {"SessionStart": [{"matcher": "startup", "hooks": [{"type": "command", "command": "./load-context.sh"}]}]}}

config

hooks.Setup

`claude --init-only`、または `-p` モードの `--init`/`--maintenance` 実行時のみ発火し、通常起動では発火しない。依存関係の一括インストールなど一回限りの処理向け。matcherはinit/maintenance。

例:

~/.claude/settings.json: {"hooks": {"Setup": [{"matcher": "init", "hooks": [{"type": "command", "command": "npm install"}]}]}}

config

hooks.InstructionsLoaded

CLAUDE.mdや`.claude/rules/*.md`がコンテキストに読み込まれるたびに発火（セッション開始時と遅延読み込み時の両方）。ブロックや変更はできず、監査ログ用途に限定される。

例:

~/.claude/settings.json: {"hooks": {"InstructionsLoaded": [{"matcher": "session_start", "hooks": [{"type": "command", "command": "./log-instructions.sh"}]}]}}

config

hooks.UserPromptSubmit

ユーザーがプロンプトを送信し、Claudeが処理する前に発火。exit code 2でプロンプトの処理をブロックし内容を破棄できる。デフォルトタイムアウトは30秒（他の多くのイベントは600秒）。

例:

~/.claude/settings.json: {"hooks": {"UserPromptSubmit": [{"hooks": [{"type": "command", "command": "./validate-prompt.sh"}]}]}}

config

hooks.UserPromptExpansion

ユーザーが入力したスラッシュコマンドがプロンプトへ展開される直前に発火。`PreToolUse`が拾えないSkill直接呼び出しの経路をカバーする。exit code 2で展開自体をブロック可能。

例:

~/.claude/settings.json: {"hooks": {"UserPromptExpansion": [{"matcher": "deploy", "hooks": [{"type": "command", "command": "./check-approval.sh"}]}]}}

config

hooks.MessageDisplay

アシスタントメッセージが画面にストリーミング表示される際、行のバッチ単位で発火。表示専用でトランスクリプトやClaudeが見るテキストには影響しない。デフォルトタイムアウトは10秒。

例:

~/.claude/settings.json: {"hooks": {"MessageDisplay": [{"hooks": [{"type": "command", "command": "./plain-display.sh"}]}]}}

config

hooks.PreToolUse

ツール呼び出しのパラメータ生成後・実行前に発火。`permissionDecision`でallow/deny/ask/deferの4択制御と入力の書き換え(`updatedInput`)が可能。exit code 2は拒否として扱われる。

例:

~/.claude/settings.json: {"hooks": {"PreToolUse": [{"matcher": "Bash", "hooks": [{"type": "command", "command": "./validate.sh"}]}]}}

config

hooks.PermissionRequest

Claude Codeが権限確認ダイアログを出す直前に発火。`Notification`のpermission_promptは約6秒待って発火するのに対し、こちらは即時。`decision.behavior`でallow/denyを返せる。

例:

~/.claude/settings.json: {"hooks": {"PermissionRequest": [{"matcher": "Bash", "hooks": [{"type": "command", "command": "./auto-approve.sh"}]}]}}

config

hooks.PostToolUse

ツール呼び出しが成功した直後に発火。ツールは既に実行済みのためブロック不可だが、`updatedToolOutput`でClaudeに見せる結果を差し替えられる。lint自動修正などに利用。

例:

~/.claude/settings.json: {"hooks": {"PostToolUse": [{"matcher": "Write", "hooks": [{"type": "command", "command": "npx eslint --fix"}]}]}}

config

hooks.PostToolUseFailure

ツール呼び出しがエラーで失敗（またはMCPツールがエラー結果を返した）際に発火。権限拒否やスキーマ検証エラーによる却下では発火しない。失敗ログの記録や是正フィードバックに使う。

例:

~/.claude/settings.json: {"hooks": {"PostToolUseFailure": [{"matcher": "Bash", "hooks": [{"type": "command", "command": "./notify-failure.sh"}]}]}}

config

hooks.PostToolBatch

並列実行されたツール呼び出しのバッチ全体が解決した後、次のモデル呼び出し前に一度だけ発火。個々のツールではなくバッチ単位の文脈をClaudeに注入する用途。matcherは非対応。

例:

~/.claude/settings.json: {"hooks": {"PostToolBatch": [{"hooks": [{"type": "command", "command": "./batch-context.sh"}]}]}}

config

hooks.PermissionDenied

autoモードの分類器がツール呼び出しを拒否した際に発火。手動拒否やdenyルール、PreToolUseのブロックでは発火しない。`retry: true`を返すとClaudeに再試行を促せる。

例:

~/.claude/settings.json: {"hooks": {"PermissionDenied": [{"matcher": "Bash", "hooks": [{"type": "command", "command": "./log-denial.sh"}]}]}}

config

hooks.Notification

許可確認待ち・アイドル通知・認証成功・MCP elicitation等の通知送信時に発火。matcherで通知種別を絞り込める。デスクトップ通知をOFFにしていても発火する。

例:

~/.claude/settings.json: {"hooks": {"Notification": [{"matcher": "permission_prompt", "hooks": [{"type": "command", "command": "./alert.sh"}]}]}}

config

hooks.SubagentStart

Agentツールでサブエージェントが起動された際に発火。matcherはagent_type名。`additionalContext`でサブエージェントの会話冒頭にコンテキストを注入できるが、起動自体はブロックできない。

例:

~/.claude/settings.json: {"hooks": {"SubagentStart": [{"matcher": "Explore", "hooks": [{"type": "command", "command": "./inject-context.sh"}]}]}}

config

hooks.SubagentStop

サブエージェントの応答が完了した際に発火。`Stop`と同じ制御形式で、decision:"block"かつreasonを返すとサブエージェントを継続させ、その内容を次の指示として渡せる。

例:

~/.claude/settings.json: {"hooks": {"SubagentStop": [{"hooks": [{"type": "command", "command": "./verify-output.sh"}]}]}}

config

hooks.TaskCreated

`TaskCreate`ツールでタスクが作成される際に発火。exit code 2または`{"decision":"block"}`でタスク作成を取り消し、理由をエラーとしてClaudeに返せる。matcherは非対応。

例:

~/.claude/settings.json: {"hooks": {"TaskCreated": [{"hooks": [{"type": "command", "command": "./validate-task-name.sh"}]}]}}

config

hooks.TaskCompleted

タスクが完了マークされる際（TaskUpdateでの明示的完了、またはAgent Teamsのチームメイトが未完了タスクを残してターンを終える際）に発火。テスト通過などの完了条件を強制できる。

例:~/.claude/settings.json: {"hooks": {"TaskCompleted": [{"hooks": [{"type": "command", "command": "npm test"}]}]}}

config

hooks.Stop

メインエージェントの応答完了時に発火（ユーザー割り込みでは発火せず、APIエラー起因の終了は`StopFailure`が代わりに発火）。decision:"block"で継続させられるが8回連続で強制的に停止する。

例:~/.claude/settings.json: {"hooks": {"Stop": [{"hooks": [{"type": "command", "command": "./require-tests-pass.sh"}]}]}}

config

hooks.StopFailure

レート制限や認証エラーなどAPIエラーでターンが終了した際、`Stop`の代わりに発火。matcherはrate_limit等のエラー種別。出力・exit codeはterminalSequence以外無視され、決定権はない。

例:

~/.claude/settings.json: {"hooks": {"StopFailure": [{"matcher": "rate_limit", "hooks": [{"type": "command", "command": "./alert-oncall.sh"}]}]}}

config

hooks.TeammateIdle

Agent Teamsのチームメイトがターン終了後アイドル状態に入る直前に発火。exit code 2で作業継続、`{"continue":false}`で完全停止させられる。lintやビルド成果物確認などの品質ゲートに使う。

例:

~/.claude/settings.json: {"hooks": {"TeammateIdle": [{"hooks": [{"type": "command", "command": "./check-build-artifact.sh"}]}]}}

config

hooks.ConfigChange

セッション中に設定ファイル（settings.json・managed-settings・skillファイル）が変更された際に発火。matcherでソース種別を絞り込み。policy_settings以外はexit code 2等で変更をブロックできる。

例:

~/.claude/settings.json: {"hooks": {"ConfigChange": [{"matcher": "project_settings", "hooks": [{"type": "command", "command": "./audit-config-change.sh"}]}]}}

config

hooks.CwdChanged

Bashの`cd`実行など作業ディレクトリが変更された際に発火。`CLAUDE_ENV_FILE`にアクセス可能で環境変数の再読み込みに使える。matcher非対応・ディレクトリ変更自体のブロックは不可。

例:~/.claude/settings.json: {"hooks": {"CwdChanged": [{"hooks": [{"type": "command", "command": "direnv reload"}]}]}}

config

hooks.DirectoryAdded

`/add-dir`コマンドやSDKの`register_repo_root`でセッション中にディレクトリが追加された際に発火（起動時`--add-dir`の追加は`SessionStart`が担当）。追加は完了済みでブロック不可。

例:

~/.claude/settings.json: {"hooks": {"DirectoryAdded": [{"matcher": "slash_command", "hooks": [{"type": "command", "command": "npm install"}]}]}}

config

hooks.FileChanged

matcherで指定した監視対象ファイルがディスク上で変更された際に発火。ツール呼び出しでなくファイルシステム監視ベースのため、Bashコマンドや外部プロセスによる変更も検知できる。

例:

~/.claude/settings.json: {"hooks": {"FileChanged": [{"matcher": ".envrc|.env", "hooks": [{"type": "command", "command": "direnv reload"}]}]}}

config

hooks.WorktreeCreate

`--worktree`やサブエージェントの`isolation:"worktree"`等でworktreeが作成される際、デフォルトのgit worktree動作を置き換えて発火。フックは作成したディレクトリパスを標準出力の最終行で返す必要がある。

例:

~/.claude/settings.json: {"hooks": {"WorktreeCreate": [{"hooks": [{"type": "command", "command": "./svn-checkout.sh"}]}]}}

config

hooks.WorktreeRemove

worktreeセッション終了・サブエージェント終了・バックグラウンドセッション削除等でworktreeが削除される際に発火。`WorktreeCreate`の後始末用で、非gitのバージョン管理を使う場合に必須。

例:

~/.claude/settings.json: {"hooks": {"WorktreeRemove": [{"hooks": [{"type": "command", "command": "./svn-cleanup.sh"}]}]}}

config

hooks.PreCompact

コンテキスト圧縮（`/compact`または自動）の直前に発火。matcherはmanual/auto。exit code 2または`{"decision":"block"}`で圧縮そのものをブロックできる。

例:

~/.claude/settings.json: {"hooks": {"PreCompact": [{"matcher": "manual", "hooks": [{"type": "command", "command": "./save-context.sh"}]}]}}

config

hooks.PostCompact

コンテキスト圧縮の完了直後に発火。`compact_summary`フィールドで生成された会話要約を取得できる。圧縮結果への介入はできず、ログ記録など後続処理専用。

例:~/.claude/settings.json: {"hooks": {"PostCompact": [{"hooks": [{"type": "command", "command": "./log-summary.sh"}]}]}}

config

hooks.SessionEnd

セッション終了時（/clear・ログアウト・プロンプト入力中の終了等）に発火。matcherで終了理由(reason)を絞り込み可能。デフォルトタイムアウトは1.5秒と短く、必要なら`timeout`で延長する。

例:

~/.claude/settings.json: {"hooks": {"SessionEnd": [{"hooks": [{"type": "command", "command": "./save-session-stats.sh"}]}]}}

config

hooks.Elicitation

MCPサーバーがタスク中にユーザー入力を要求（elicitation）した際に発火。matcherはMCPサーバー名。`action:"accept"/"decline"/"cancel"`を返すとダイアログ表示をスキップしプログラム的に応答できる。

例:

~/.claude/settings.json: {"hooks": {"Elicitation": [{"matcher": "my-mcp-server", "hooks": [{"type": "command", "command": "./auto-respond.sh"}]}]}}

config

hooks.ElicitationResult

ユーザーがMCP elicitationに応答した後、その結果がMCPサーバーへ送信される前に発火。`action`や`content`を上書きでき、exit code 2で応答をdeclineに変更できる。

例:

~/.claude/settings.json: {"hooks": {"ElicitationResult": [{"matcher": "my-mcp-server", "hooks": [{"type": "command", "command": "./log-elicitation.sh"}]}]}}

config

CLAUDE_CODE_GOAL_CHECKIN_MINUTES

`/goal`実行中にバックグラウンドタスク待ちで確認（チェックイン）が入るまでの分数を設定する環境変数。デフォルトは30分後から段階的に間隔が延びる。`0`を指定すると確認自体を無効化できる。

例:export CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0

関連機能

config

hooks.PreModelSwitch

モデル切り替え（`/model`実行やフォールバック等）の直前に発火するフック（v2.1.251以降）。exit code 2などを返して切り替えをブロック・確認できる。

例:

~/.claude/settings.json: {"hooks": {"PreModelSwitch": [{"hooks": [{"type": "command", "command": "./confirm-model-switch.sh"}]}]}}

config

hooks.PostModelSwitch

モデル切り替えが完了した直後に発火するフック（v2.1.251以降）。切り替え後のモデル名をログ記録する用途などに使用する。

例:

~/.claude/settings.json: {"hooks": {"PostModelSwitch": [{"hooks": [{"type": "command", "command": "./log-model-switch.sh"}]}]}}

config

CLAUDE_CODE_BG_TASKS_REPORT_RUNNING

`0` にすると、非インタラクティブセッションがバックグラウンド作業（バックグラウンドエージェントやワークフロー）の実行中でも、ターン終了ごとにホストへidle状態を報告する環境変数（v2.1.269以降の既定はrunning維持）。

例:export CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0

関連機能

🔄 ダイナミックワークフロー

config

CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS

1回のワークフロー実行で同時に動かすエージェント数（1〜256）を指定する環境変数（v2.1.269以降）。デフォルトは最大16でCPU数に応じて減る。値を上げるほどメモリ使用量が増える。

例:export CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=8

関連機能

🔄 ダイナミックワークフロー

config

CLAUDE_CODE_BASH_EDIT_DIFF

Bashコマンド実行中に変更されたファイルの差分記録を制御する環境変数（v2.1.269以降）。`0` で無効、`1` で全権限モードで記録。`bashEditDiffEnabled` 設定より優先される。

例:export CLAUDE_CODE_BASH_EDIT_DIFF=0

関連機能

関連記事なし

config

CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF

`1` にすると、スーパーバイザーがバックグラウンドセッションのプロセスを停止・再起動・更新する際に、実行中のコマンドも停止する。

例:export CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1

config

CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP

`1` にすると、メモリ逼迫時にバックグラウンドのシェルコマンドをClaude Codeが強制終了する動作を止める。

例:export CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1

config

CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS

`1` にすると、Agent SDKの `canUseTool` コールバックへ送られる未回答の権限リクエストに対して `Notification` フックを実行しない。ターミナルセッションでは無効（v2.1.233以降）。

`1` にすると、評価ハーネス・CI・リモートワーカーなど無人実行向けに、`429`・`529` の容量エラーを `CLAUDE_CODE_MAX_RETRIES` 回で諦めず無期限にリトライする。

Stop・SubagentStop hookがターン終了を連続でブロックできる上限回数（既定8）。`0` で上限なし。

`-p` で `--json-schema` の検証に失敗した際の試行回数上限（既定5）。ワークフローのサブエージェントの構造化出力にも適用される。

例:export MAX_STRUCTURED_OUTPUT_RETRIES=3

関連機能

`--dangerously-skip-permissions` または `defaultMode: "bypassPermissions"` でbypassPermissionsモードに入る前に表示される確認プロンプトをスキップする。プロジェクト設定（`.claude/settings.json`）での設定は無視される（信頼できないリポジトリからの自動バイパス防止のため）。

例:~/.claude/settings.json: {"permissions": {"skipDangerousModePermissionPrompt": true}}

関連機能

ログインを特定の組織に限定する。単一UUIDで特定組織のみ許可（ログイン時に事前選択）、UUID配列でいずれかの組織のログインを許可。Managed設定で設定した場合、リスト外の組織アカウントはログイン失敗となる。

例:managed-settings.json: {"forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

関連機能

config

forceRemoteSettingsRefresh

（Managed設定専用）CLIの起動をブロックし、サーバーからリモート管理設定を新鮮にフェッチするまで待機する。フェッチに失敗した場合、CLIはキャッシュを使わず終了する。フェールクローズドの起動強制に使用。

例:managed-settings.json: {"forceRemoteSettingsRefresh": true}

関連機能

config

parentSettingsBehavior

（Managed設定専用・v2.1.133以降）SDKの `managedSettings` とadmin tierの設定が相互にどう作用するかを設定する。SDKからadminポリシーのマージをオプトインする場合に使用。

Perforce（P4）との互換性のある書き込み保護を有効化する。Perforceが管理するファイルへの書き込みをClaudeが行う前に、Perforceのチェックアウト操作が必要になる。

例:export CLAUDE_CODE_PERFORCE_MODE=1

関連機能

config

autoMode.hard_deny

autoモードのclassifierで無条件にブロックするルールを設定する。`allow` 例外ルールがあっても例外なく拒否する。絶対に自動実行すべきでないアクションに使用する。

例:~/.claude/settings.json: {"autoMode": {"hard_deny": ["Bash(curl *)"]}}

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

config

CLAUDE_CODE_ENABLE_AUTO_MODE

Bedrock・Vertex・Foundryなどの外部プロバイダーでautoモードを有効化する（v2.1.158以降）。`1` に設定するとShift+Tabサイクルにautoモードが追加される。対象はOpus 4.7以降。

例:export CLAUDE_CODE_ENABLE_AUTO_MODE=1

関連機能

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

config

forceLoginGatewayUrl

（Managed設定専用）`/login` のCloud gateway画面でゲートウェイURLを事前入力しロックする。`forceLoginMethod: "gateway"` と組み合わせて使用する。

マーケットプレイスが宣言したコマンドを実行してインストールするタイプのプラグインをブロックする。Managed設定向け。

例:managed-settings.json: {"disableCommandPluginSources": true}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

config

permissionExplainerEnabled

シェルの権限プロンプトに表示されるCtrl+Eのコマンド説明機能をオフにする。

例:~/.claude.json: {"permissionExplainerEnabled": false}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

config

policyHelper.path

Managed設定を動的に計算するためClaude Codeが起動時に実行するヘルパー実行ファイルのパスを指定する。`policyHelper`オブジェクトのプロパティ。

例:managed-settings.json: {"policyHelper": {"path": "/usr/local/bin/compute-policy"}}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

config

policyHelper.refreshIntervalMs

ポリシーヘルパーをバックグラウンドで再実行する間隔（ミリ秒）を設定する。設定した間隔ごとにManaged設定が再計算される。

例:managed-settings.json: {"policyHelper": {"path": "/usr/local/bin/compute-policy", "refreshIntervalMs": 3600000}}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Anthropicがオープンソース向けAIセキュリティスキャンを提供開始The Verge AI · 4日前

config

policyHelper.timeoutMs

ポリシーヘルパーの実行完了をClaude Codeが待つ最大時間（ミリ秒）を設定する。

例:managed-settings.json: {"policyHelper": {"path": "/usr/local/bin/compute-policy", "timeoutMs": 5000}}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

config

skipAutoPermissionPrompt

自分でauto mode（組み込みデフォルトを介さず）に初めて入った際に表示される一度きりの通知をスキップする。

例:~/.claude/settings.json: {"skipAutoPermissionPrompt": true}

autoモードの操作レビューをサーバー側に依頼するかを制御する環境変数（v2.1.271以降）。`0` にするとClaude Code自身の分類器リクエストを使う。

例:export CLAUDE_CODE_AUTO_MODE_SERVER=0

サンドボックス内からのアウトバウンドアクセスをブロックするドメインのリスト。`allowedDomains` より優先される。ワイルドカード使用可能。全設定ソースからマージされる（`allowManagedDomainsOnly` の影響を受けない）。

例:~/.claude/settings.json: {"sandbox": {"network": {"deniedDomains": ["sensitive.cloud.example.com"]}}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.credentials.mode

（v2.1.224以降・Linux/WSL2限定）認証情報ファイルを `"mask"` にすると、サンドボックス内はダミー値を読み取り、egress時にサンドボックスプロキシが実値へ置換する。`extract`・JWT対応の`decode`・AWS SigV4再署名オプションも利用可能。

例:~/.claude/settings.json: {"sandbox": {"credentials": {"files": [{"path": "~/.aws/credentials", "mode": "mask"}]}}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.autoAllowBashIfSandboxed

サンドボックス有効時にBashコマンドを自動承認する（デフォルト: `true`）。サンドボックスが保護を担うため追加確認が不要になる。

例:~/.claude/settings.json: {"sandbox": {"autoAllowBashIfSandboxed": false}}

config

sandbox.excludedCommands

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.network.httpProxyPort

サンドボックスで使用するHTTPプロキシのポート番号を設定する。独自プロキシを持ち込む場合に指定する。未指定の場合はClaudeが自動でプロキシを起動する。

例:~/.claude/settings.json: {"sandbox": {"network": {"httpProxyPort": 8080}}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.network.socksProxyPort

サンドボックスで使用するSOCKS5プロキシのポート番号を設定する。独自プロキシを持ち込む場合に指定する。未指定の場合はClaudeが自動でプロキシを起動する。

例:~/.claude/settings.json: {"sandbox": {"network": {"socksProxyPort": 8081}}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.enableWeakerNestedSandbox

**セキュリティが低下する。** 権限のないDockerコンテナ（Linux/WSL2のみ）でより弱いサンドボックスを有効化する。デフォルトは `false`。

例:~/.claude/settings.json: {"sandbox": {"enableWeakerNestedSandbox": true}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.enableWeakerNetworkIsolation

**セキュリティが低下する（macOSのみ）。** システムTLS信頼サービスへのアクセスを許可する。MITMプロキシとカスタムCAを使う場合に `gh`・`gcloud`・`terraform` などGoベースツールのTLS証明書検証に必要。デフォルトは `false`。

例:~/.claude/settings.json: {"sandbox": {"enableWeakerNetworkIsolation": true}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.bwrapPath

（Managed設定専用・Linux/WSL2のみ）bubblewrapバイナリのカスタムパスを指定する。デフォルトパスにbubblewrapがない場合や特定バージョンを固定する場合に使用。

例:managed-settings.json: {"sandbox": {"bwrapPath": "/usr/local/bin/bwrap"}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.socatPath

（Managed設定専用・Linux/WSL2のみ）socatバイナリのカスタムパスを指定する。サンドボックス内のネットワークプロキシに使用される。

例:managed-settings.json: {"sandbox": {"socatPath": "/usr/local/bin/socat"}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.filesystem.disabled

サンドボックスのファイルシステムツールを無効化する。`true` にするとサンドボックスモードでのファイル読み書きができなくなる（デフォルトは`false`）。ネットワーク分離のみを使いたい場合に設定する。

例:~/.claude/settings.json: {"sandbox": {"filesystem": {"disabled": true}}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.network.strictAllowlist

`true` にすると、サンドボックスのネットワークツールで許可リストにないドメインへのアクセスを確認なしでブロックする（デフォルトは`false`。v2.1.199以降）。

例:~/.claude/settings.json: {"sandbox": {"network": {"strictAllowlist": true}}}

関連機能

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.allowAppleEvents

macOSでサンドボックス化されたコマンドが、Apple Eventsを送信できるようにする。

例:~/.claude/settings.json: {"sandbox": {"allowAppleEvents": true}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.credentials.allowPlaintextInject

マスクされた認証情報を、平文のHTTPサービスへ到達させることを許可する。信頼できるテストネットワーク向け。

例:~/.claude/settings.json: {"sandbox": {"credentials": {"allowPlaintextInject": true}}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.credentials.awsPairs

カスタム名を付けたAWSキー変数のペアを1つの認証情報として紐付け、AWSリクエストの再署名に使えるようにする。

例:~/.claude/settings.json: {"sandbox": {"credentials": {"awsPairs": {"MY_ACCESS_KEY": "MY_SECRET_KEY"}}}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.credentials.sigv4

ストリーミング・presigned・SigV4A形式のAWSリクエストをサンドボックス経由で通過させるか失敗させるかを選択する。

例:~/.claude/settings.json: {"sandbox": {"credentials": {"sigv4": "allow"}}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.ignoreViolations

想定内のパスへのアクセスなど、既知のプローブパターンに対するサンドボックス違反レポートを抑制する。

例:~/.claude/settings.json: {"sandbox": {"ignoreViolations": ["/proc/**"]}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.network.tlsTerminate

サンドボックスのネットワークプロキシでTLSを終端し、HTTPSリクエストの内容を読み取れるようにする。

例:~/.claude/settings.json: {"sandbox": {"network": {"tlsTerminate": true}}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.ripgrep

サンドボックス内でClaude Code同梱のripgrepではなく、指定した独自のripgrepバイナリを使用する。

例:~/.claude/settings.json: {"sandbox": {"ripgrep": "/usr/local/bin/rg"}}

smolvmを用いた安全なサンドボックス構築Simon Willison's Weblog · 2026/08/19

Claude Codeのサンドボックス設定が無視される不具合Qiita AI記事 · 2026/08/08

Claude Code v2.1.221 リリースClaude Code Releases · 2026/08/04

Claude Code v2.1.219リリースClaude Code Releases · 2026/07/24

config

sandbox.credentials.envVars

サンドボックス内で特定の環境変数をunsetまたはマスクする。

例:~/.claude/settings.json: {"sandbox": {"credentials": {"envVars": [{"name": "AWS_SECRET_ACCESS_KEY", "mode": "mask"}]}}}

関連機能

関連記事なし

config

sandbox.credentials.files

サンドボックス内で特定の認証情報ファイルの読み取りをブロックまたはマスクする。

例:~/.claude/settings.json: {"sandbox": {"credentials": {"files": [{"path": "~/.aws/credentials", "mode": "mask"}]}}}

関連機能

関連記事なし

config

dangerouslyDisableSandbox

関連記事なし

config

CLAUDE_CODE_MESSAGING_SOCKET

クロスセッションメッセージング用インボックスソケットのパスをhooksやBashコマンドへ公開する環境変数（`uds:`プレフィックス付き）。

例:`/status` の Peer address 行、または `$CLAUDE_CODE_MESSAGING_SOCKET` として参照可能。

関連機能

📡 クロスセッションメッセージング

関連記事なし

config

CLAUDE_CODE_MESSAGING_TOKEN

自セッションのインボックスソケットへ認証付きで投稿するための、セッションごとのトークンを公開する環境変数。

例:{"type":"auth","token":"$CLAUDE_CODE_MESSAGING_TOKEN"}

関連機能

📡 クロスセッションメッセージング

関連記事なし

config

CLAUDE_CLIENT_PRESENCE_FILE

Remote Controlの通知要否を判定するため、ユーザーの在席状態を示すファイルのパスを指定する環境変数。

例:export CLAUDE_CLIENT_PRESENCE_FILE=/tmp/user-presence

関連機能

関連記事なし

config

desktopSessionCleanupPeriodDays

デスクトップアプリのローカルセッショントランスクリプトを保持する日数を設定する。

例:~/.claude/settings.json: {"desktopSessionCleanupPeriodDays": 30}

関連機能

関連記事なし

config

CLAUDE_CODE_REMOTE_SESSION_ID

クラウドセッションで自動的に設定される、現在のセッションID。セッションのトランスクリプトへのリンク生成に使える。

例:echo "$CLAUDE_CODE_REMOTE_SESSION_ID"

関連記事なし

config

CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX

名前未指定のRemote Controlセッションに自動付与される名前のプレフィックス。既定はマシンのホスト名。`--remote-control-session-name-prefix` と同じ効果。

例:export CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX=dev-box

関連記事なし

config

DISABLE_GROWTHBOOK

フィーチャーフラグ評価を無効化する環境変数。設定するとRemote Controlが利用できなくなる。`env` ブロックを含め、設定されている場所で解除する必要がある。

例:export DISABLE_GROWTHBOOK=1

関連記事なし

config

CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS

Remote ControlやSDKホストなどのリモートクライアントに転送したダイアログを取り消すまでの期限（ミリ秒）。`dialogExpiry` 設定より優先。

例:export CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=600000

関連機能

関連記事なし

リモートAPI（Bedrock / Vertex / プロキシ）

config

ANTHROPIC_BASE_URL

APIリクエストの送信先エンドポイントを変更する。LiteLLM・LM Studio等のプロキシ経由でClaudeを使う場合に設定。非Anthropicホストでは一部ベータ機能が無効になる。

例:

export ANTHROPIC_BASE_URL="http://0.0.0.0:4000"
export ANTHROPIC_AUTH_TOKEN="your-token"

config

CLAUDE_CODE_USE_BEDROCK

AWS Bedrock経由でClaudeを利用する。`AWS_REGION`・`AWS_PROFILE` などのAWS認証情報と合わせて設定。組織のAWSアカウントでコスト管理する場合に使用。

例:

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=myprofile

関連機能

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

CLAUDE_CODE_USE_VERTEX

Google Cloud Vertex AI経由でClaudeを利用する。`ANTHROPIC_VERTEX_PROJECT_ID`・`CLOUD_ML_REGION` と合わせて設定。GCPプロジェクトのコスト管理や組織ポリシー適用に使用。

例:

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=my-project

関連機能

Claude Code v2.1.278リリースClaude Code Releases · 23日前

Claude Codeの更新でEffort上限設定が可能にQiita AI記事 · 2026/09/09

Claude Code v2.1.267リリースClaude Code Releases · 2026/09/09

Claude Code v2.1.248：安全性と速度が向上Qiita AI記事 · 2026/08/28

config

CLAUDE_CODE_USE_FOUNDRY

Microsoft Azure AI Foundry（旧Azure OpenAI Service）経由でClaudeを利用する。`ANTHROPIC_FOUNDRY_BASE_URL` と合わせて設定。

例:

export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_BASE_URL="https://my-resource.services.ai.azure.com/anthropic"

関連機能

config

modelOverrides（Bedrock ARN）

BedrockのクロスリージョンInference Profile ARNにモデルをマッピングする。特定リージョンのリザーブドキャパシティを使う場合に設定。

例:

~/.claude/settings.json: {"modelOverrides": {"claude-opus-4-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/..."}}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

ANTHROPIC_CUSTOM_HEADERS

APIリクエストに追加のHTTPヘッダーを付与する。AWS Guardrailsのヘッダーや社内プロキシの認証ヘッダーを設定する際に使用。複数ヘッダーは改行区切り。

例:export ANTHROPIC_CUSTOM_HEADERS="X-Amzn-Bedrock-GuardrailIdentifier: id\nX-Amzn-Bedrock-GuardrailVersion: 1"

config

HTTP_PROXY / HTTPS_PROXY

HTTP/HTTPS通信を経由させるプロキシサーバーを設定する。企業ネットワーク内からClaudeを使う場合に設定。`NO_PROXY` で除外ドメインも指定可能。

例:

export HTTPS_PROXY="https://proxy.example.com:8080"
export NO_PROXY="localhost,127.0.0.1"

config

ANTHROPIC_BEDROCK_BASE_URL

Bedrock経由のAPIリクエストをLLMゲートウェイ経由でルーティングする。`CLAUDE_CODE_SKIP_BEDROCK_AUTH=1` と組み合わせてゲートウェイに認証を委ねる。

例:

export ANTHROPIC_BEDROCK_BASE_URL="https://your-llm-gateway.com/bedrock"
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

ANTHROPIC_VERTEX_BASE_URL

Vertex AI経由のAPIリクエストをLLMゲートウェイ経由でルーティングする。`CLAUDE_CODE_SKIP_VERTEX_AUTH=1` と組み合わせてゲートウェイに認証を委ねる。

例:

export ANTHROPIC_VERTEX_BASE_URL="https://your-llm-gateway.com/vertex"
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1

Claude Codeの更新でEffort上限設定が可能にQiita AI記事 · 2026/09/09

Claude Code v2.1.267リリースClaude Code Releases · 2026/09/09

Claude Code v2.1.248：安全性と速度が向上Qiita AI記事 · 2026/08/28

config

awsAuthRefresh

`.aws` ディレクトリを修正するカスタムスクリプト。AWS SSOなど動的認証が必要な場合に使用する（高度な認証設定向け）。

例:~/.claude/settings.json: {"awsAuthRefresh": "aws sso login --profile myprofile"}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

awsCredentialExport

AWS認証情報をJSON形式で出力するカスタムスクリプト。`AccessKeyId`・`SecretAccessKey`・`SessionToken` を含むJSONを返す（高度な認証設定向け）。

例:~/.claude/settings.json: {"awsCredentialExport": "/bin/generate_aws_grant.sh"}

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

ANTHROPIC_BETAS

APIリクエストに追加する `anthropic-beta` ヘッダー値をカンマ区切りで指定する。`--betas` フラグと同等。claude.aiサブスクリプションでも動作する。

例:export ANTHROPIC_BETAS="interleaved-thinking,token-efficient-tools"

関連機能

config

ANTHROPIC_FOUNDRY_API_KEY

Microsoft Azure AI Foundry認証用のAPIキーを設定する。`CLAUDE_CODE_USE_FOUNDRY=1` と合わせて使用する。

例:export ANTHROPIC_FOUNDRY_API_KEY="your-foundry-api-key"

関連機能

config

AWS_BEARER_TOKEN_BEDROCK

Amazon Bedrock APIキー認証用のBearerトークンを設定する。IAMベースの認証の代わりにAPIキーを使用したい場合に設定する。

例:export AWS_BEARER_TOKEN_BEDROCK="your-bedrock-api-key"

関連機能

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

CLAUDE_CODE_USE_MANTLE

Bedrock Mantleエンドポイントを使用する。`ANTHROPIC_BEDROCK_MANTLE_BASE_URL` と合わせて設定する。

例:

export CLAUDE_CODE_USE_MANTLE=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL="https://your-mantle-endpoint"

関連機能

Claude Code v2.1.281 リリースClaude Code Releases · 19日前

Claude Code v2.1.278リリースClaude Code Releases · 23日前

config

CLAUDE_CODE_CLIENT_CERT

mTLS（相互TLS）認証用のクライアント証明書ファイルパスを設定する。`CLAUDE_CODE_CLIENT_KEY` と合わせて設定する。企業ネットワークの認証プロキシ経由でAPIを使う場合に必要。

例:

export CLAUDE_CODE_CLIENT_CERT="/path/to/client.crt"
export CLAUDE_CODE_CLIENT_KEY="/path/to/client.key"

関連機能

config

CLAUDE_CODE_CERT_STORE

CA証明書のソースを設定する。`bundled`（Claudeが同梱するCA）または `system`（OSのCA証明書ストア）から選択。企業の自己署名証明書を使う場合は `system` を指定する。

例:export CLAUDE_CODE_CERT_STORE=system

関連機能

config

ANTHROPIC_VERTEX_PROJECT_ID

Vertex AI用のGCPプロジェクトIDを設定する。`CLAUDE_CODE_USE_VERTEX=1` と合わせて設定する。`CLOUD_ML_REGION` と組み合わせて使用。

例:export ANTHROPIC_VERTEX_PROJECT_ID=my-gcp-project

関連機能

Claude Code v2.1.278リリースClaude Code Releases · 23日前

すべてのAPIリクエストボディにマージするJSONオブジェクトを設定する。カスタムパラメータやプロバイダー固有のフィールドを追加する場合に使用。

例:export CLAUDE_CODE_EXTRA_BODY='{"metadata": {"user": "alice"}}'

関連機能

config

CLAUDE_CODE_SKIP_VERTEX_AUTH

Vertex AI のGoogle認証をスキップする。`ANTHROPIC_VERTEX_BASE_URL` でゲートウェイを使い、認証をゲートウェイに委ねる場合に設定する。`CLAUDE_CODE_SKIP_BEDROCK_AUTH`・`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`・`CLAUDE_CODE_SKIP_MANTLE_AUTH` も同様に使用可能。

例:export CLAUDE_CODE_SKIP_VERTEX_AUTH=1

関連機能

Claude Code v2.1.278リリースClaude Code Releases · 23日前

Claude Codeの更新でEffort上限設定が可能にQiita AI記事 · 2026/09/09

Claude Code v2.1.267リリースClaude Code Releases · 2026/09/09

Claude Code v2.1.248：安全性と速度が向上Qiita AI記事 · 2026/08/28

config

ANTHROPIC_FOUNDRY_BASE_URL

Microsoft Foundry経由のAPIリクエストをLLMゲートウェイ経由でルーティングする。ゲートウェイ鍵は`x-api-key`として`ANTHROPIC_FOUNDRY_API_KEY`で送信される。

例:

export ANTHROPIC_FOUNDRY_BASE_URL="https://your-llm-gateway.com"
export ANTHROPIC_FOUNDRY_API_KEY=your-gateway-key

関連機能

config

ANTHROPIC_AWS_BASE_URL

Claude Platform on AWS（AWS Marketplace課金のClaude API）経由のリクエストをLLMゲートウェイ経由でルーティングする際のエンドポイントを設定する。

例:export ANTHROPIC_AWS_BASE_URL="https://your-llm-gateway.com/aws"

関連機能

ゲートウェイ・プロキシ経由でBedrockの`Content-Type`ヘッダーが失われる場合に、レスポンス本文をSSE（Server-Sent Events）として読み直す環境変数。ストリーミングがターンごとに非ストリーミングへフォールバックする場合に設定する。

例:export CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT=1

関連機能

関連記事なし

config

VERTEX_REGION_CLAUDE_*（モデル別リージョン上書き）

`CLOUD_ML_REGION=global`使用時に、グローバルエンドポイント非対応のモデルだけ個別のリージョンへ振り分ける環境変数群。モデルごとに`VERTEX_REGION_CLAUDE_<モデル名>`の形式で指定する。

例:

export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

関連機能

関連記事なし

config

GOOGLE_APPLICATION_CREDENTIALS

Vertex AI利用時にApplication Default Credentialsとして読み込む認証情報ファイルのパスを指定する環境変数。サービスアカウントキーやX.509証明書ベースのWorkload Identity Federation設定ファイルを指す。

例:export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credential-config.json

関連機能

関連記事なし

config

DISABLE_PROMPT_CACHING

Bedrock・Vertex利用時にプロンプトキャッシュを無効化する環境変数。既定では有効。

例:export DISABLE_PROMPT_CACHING=1

関連機能

関連記事なし

config

ENABLE_PROMPT_CACHING_1H

Bedrock・Vertex・Foundry利用時にプロンプトキャッシュのTTLを既定の5分から1時間に延長する環境変数。1時間TTLのキャッシュ書き込みは高い料金で課金される。

例:export ENABLE_PROMPT_CACHING_1H=1

関連機能

関連記事なし

config

ANTHROPIC_ORGANIZATION_ID

Workload Identity Federation認証で使用するAnthropic組織IDを指定する環境変数。GitHub Actions等でのOIDC連携に使用する。

例:export ANTHROPIC_ORGANIZATION_ID="org_..."

関連機能

config

ANTHROPIC_FEDERATION_RULE_ID

Workload Identity Federation認証で使用するフェデレーションルールIDを指定する環境変数。

例:export ANTHROPIC_FEDERATION_RULE_ID="fdrl_..."

関連機能

config

mTLS認証用のクライアント秘密鍵ファイルのパスを設定する。`CLAUDE_CODE_CLIENT_CERT` と組み合わせて使用する。

例:export CLAUDE_CODE_CLIENT_KEY=~/certs/client.key

config

プロキシを経由せず直接接続するドメイン・IPの一覧。`HTTP_PROXY` / `HTTPS_PROXY` と組み合わせて使う。

例:export NO_PROXY="localhost,127.0.0.1"

関連機能

環境変数・APIキー

config

env

Claude Code の起動時に自動的に設定される環境変数を定義する。`settings.json` の `env` オブジェクトに記述。プロジェクト固有の設定をコマンドなしで読み込める。

例:~/.claude/settings.json: {"env": {"NODE_ENV": "development", "MY_API_KEY": "xxx"}}

config

apiKeyHelper

Anthropic APIキーを動的に取得するシェルコマンドを設定する。AWS Secrets Manager・HashiCorp Vault などのシークレットマネージャーと連携できる。

例:

claude config set apiKeyHelper "aws secretsmanager get-secret-value --secret-id anthropic-key --query SecretString --output text"

config

cleanupPeriodDays

ローカルに保存される会話ログ・チェックポイントの保持期間（日数）を設定する。デフォルトは30日。`0` に設定すると起動時にすべてのトランスクリプトを削除しセッション永続化を無効化する。

例:claude config set cleanupPeriodDays 7

config

autoMemoryDirectory

オートメモリの保存先ディレクトリをカスタマイズする。`~/` 展開パスを使用可能。プロジェクト設定（`.claude/settings.json`）では設定不可（セキュリティ上の理由）。

例:~/.claude/settings.json: {"autoMemoryDirectory": "~/my-memory-dir"}

関連機能

🧠 メモリ・コンテキスト管理

config

companyAnnouncements

起動時にユーザーに表示するアナウンスを設定する。複数設定するとランダムに1件が選ばれて表示される。Managed設定で組織全体に展開できる。

例:managed-settings.json: {"companyAnnouncements": ["コーディングガイドライン: docs.example.com"]}

config

otelHeadersHelper

OpenTelemetryの動的ヘッダーを生成するスクリプトを設定する。起動時と定期的に実行される。使用量監視のカスタム計装に使用。

例:~/.claude/settings.json: {"otelHeadersHelper": "/bin/generate_otel_headers.sh"}

`/init` コマンドの対話型マルチフェーズフローを有効化する。`true` に設定するとCLAUDE.md・スキル・フックのセットアップをインタラクティブに案内し、レビュー可能なプロポーザルを提示してからファイルを生成する。

例:export CLAUDE_CODE_NEW_INIT=true

config

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD

`--add-dir` で追加したディレクトリのCLAUDE.mdファイルも読み込む。デフォルトでは `--add-dir` 対象のCLAUDE.mdは読み込まれないが、この変数を `1` に設定すると読み込まれる。

例:CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

config

claudeMdExcludes

読み込みをスキップするCLAUDE.mdファイルのパスまたはglobパターンのリスト。大規模モノレポで他チームのCLAUDE.mdが取り込まれる場合の除外設定。絶対ファイルパスに対してglobマッチングを行う。管理ポリシーのCLAUDE.mdは除外不可。

例:

~/.claude/settings.json: {"claudeMdExcludes": ["**/monorepo/CLAUDE.md", "/home/user/monorepo/other-team/.claude/rules/**"]}

config

wslInheritsWindowsSettings

（Windows限定）WSL環境でWindowsのManaged設定を継承する。`true` に設定するとWSLセッションがWindowsの管理ポリシーを適用する。デフォルト: `false`。

例:managed-settings.json: {"wslInheritsWindowsSettings": true}

関連機能

config

claudeMd

バイト単位のストリーミングにおけるアイドルウォッチドッグのタイムアウトを設定する環境変数（10秒〜30分の範囲）。

例:export CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS=30000

config

`0` で `api.anthropic.com` 宛てのAPI・テレメトリ・Artifact公開リクエストのgzip圧縮を無効化する。検出できないTLS検査プロキシ対策。

例:export CLAUDE_CODE_GZIP_REQUEST_BODIES=0

`true` でClaude Codeのバージョンをメトリクス属性に含める（既定は除外）。

スピナーTipsをカスタム文字列で上書きする。`excludeDefault: true` でデフォルトTipsを非表示にして独自Tipsのみ表示できる。組織向けメッセージの表示に活用できる。

例:

~/.claude/settings.json: {"spinnerTipsOverride": {"excludeDefault": true, "tips": ["内部ツールXを使ってください"]}}

Windows TerminalやiTerm2などの対応ターミナルでプログレスバーを表示する（デフォルト: `true`）。`~/.claude.json` に保存される。

例:~/.claude.json: {"terminalProgressBarEnabled": false}

config

autoConnectIde

Claude Codeが外部ターミナルから起動した際に、実行中のIDEに自動接続するかを設定する（デフォルト: `false`）。`~/.claude.json` に保存される。

例:~/.claude.json: {"autoConnectIde": true}

セッション開始時にChrome連携を有効にする。対話CLIとVS Code拡張の両方で適用される。`/chrome` の「Enabled by default」と同じ設定。

例:~/.claude.json: {"claudeInChromeDefaultEnabled": true}

関連機能

🌐 ブラウザ統合

config

copyFullResponse

`/copy` がコードブロック選択ピッカーを出さず、応答全体をコピーするようにする。

例:~/.claude.json: {"copyFullResponse": true}

config

defaultToAgentsView

引数なしで `claude` を実行したとき、新規会話ではなくagent viewを開く。

例:~/.claude.json: {"defaultToAgentsView": true}

デモモードを有効化し、ヘッダーと `/status` からメールアドレス・組織名を隠してオンボーディングを省く。配信・録画向け。

例:export IS_DEMO=1

関連機能