Claude Code CLIガイド：インストール、設定、コマンド、環境変数

要約： Claude Code は、権限、hooks、MCP 連携、subagentsからなる多層システムを通じてコードベースを読み取り、コマンドを実行し、ファイルを変更するエージェント型の CLI です。5つの中核システム（設定、権限、hooks、MCP、subagents）を習得すれば、生産性を飛躍的に高められます。複雑な推論には Opus、一般的な作業には Sonnet、迅速な調査には Haiku というように、タスクに合ったモデル階層を選びましょう。品質だけを重視するなら、Opus に統一する方法もあります。必ず実行すべき処理には、プロンプトではなく hooks を使用してください。2026年8月14日以降、Pro、Max、Team の新規セッションでは Auto mode がデフォルトの権限モードです（8月7日に発表され、切り替え日に実環境で確認済みです。自律動作は分類器によって審査されます。自分で設定した defaultMode は、1回限りの切り替え案内を承認しない限り維持されます。Shift+Tab でどのセッションからでも切り替えられ、disableAutoMode を使えば組織全体で無効化できます）。²⁰³ デフォルトモデルはプランによって異なります。Max、Team Premium、Enterprise（v2.1.251以降のシート制）、および Anthropic API では Claude Opus 5 がデフォルトとなり、Pro と Team Standard では Sonnet 5 がデフォルトです。標準定価はネイティブの1Mコンテキストで、MTokあたり$2/$10です（当初はリリース記念価格でしたが、現在は恒久化され、予定されていた9月1日の値上げは実施されません）²²⁸²⁰⁷。v2.1.197で導入された全環境共通の Sonnet 5 デフォルト（2026年6月30日）は過去のものとなり、opus エイリアスは Claude Opus 5 を指します（v2.1.219以降）。v2.1.198（7月1日）では、subagentsがデフォルトでバックグラウンド実行されるようになり、Chrome版 Claude が一般提供となりました。また、バックグラウンドエージェントは worktree 上のコード作業を終えると、commit、push、ドラフトPRの作成まで実行でき、バックグラウンドセッションでは Notification hook（agent_needs_input／agent_completed）が発火します。v2.1.199（7月2日）では、最大5つの積み重ねられた slash-skill 呼び出しを読み込めるようになり、サブスクライバー向けに一時的な429エラーの自動再試行が追加されました。v2.1.200（7月3日）では、CLI、--help、VS Code、JetBrains の全体で default 権限モードの表示名が「Manual」に変更されました（設定値は変わらず、manual もエイリアスとして利用できます）。さらに、AskUserQuestion ダイアログがデフォルトで自動続行しなくなりました。v2.1.202（7月6日）では、「Dynamic workflow size」を調整する /config 項目が追加され、/review <pr>（高速な単一パス）と /code-review <level> <pr#> が分離されました。しかし、v2.1.223でこの分離は元に戻され、/review は再び /code-review のエイリアスとなり、引数なしの /code-review は前回の effort レベルを再利用します。v2.1.203～205（7月7～9日）では auto mode の安全性が強化され、トランスクリプトファイルの改ざんが防止されるようになりました。解決不能な変数に対する rm -rf は事前確認が必要となり、バックグラウンドタスクの通知には人間の入力がなかったことが明記されます（そのため、トランスクリプト内で捏造された承認に基づく操作は実行されません）。また、/doctor は診断と修正を一括で行う総合チェック機能となりました（/checkup はそのエイリアスです）。^181182183 v2.1.217（7月21日）では、ネストした subagents に関する方針が反転し、subagentsはデフォルトで自身の subagents を起動しなくなりました。ただし、このデフォルトは3日後のv2.1.219で再び反転し、深さ3まで起動可能になっています（後述）。同時実行できる subagents はデフォルトで最大20体（CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS）となり、--max-budget-usd は上限到達時にバックグラウンドの subagents を実際に停止するようになりました。¹⁹⁴ v2.1.218（7月22日）では、/code-review がバックグラウンドの subagent に移行し、レビュー作業が会話のコンテキストを圧迫しなくなりました。context: fork を指定した skills もデフォルトでバックグラウンド実行されます（skillごとに background: false で無効化できます）。/deep-research は明示的に呼び出した場合のみ開始されるようになりました。また、危険な rm、バックグラウンド実行の &、疑わしい Windows パスの検査は、権限ダイアログではなく auto mode の分類器が担当します。信頼されていないフォルダからは、エージェントのフロントマターで定義された hooks が実行されなくなりました。¹⁹⁵ v2.1.219（7月24日）では、Claude Opus 5（claude-opus-5）がデフォルトの Opus モデルとなりました。1Mコンテキスト、最大128K出力、MTokあたり$5/$25（Opus 4.8と同額）で、thinking はデフォルトで有効、effort のデフォルトは high、知識カットオフは2026年5月です。また、以前のリリースで導入されていた2点が修正されました。fast mode は Opus 5 と Opus 4.8 に適用され、料金はMTokあたり$10/$50（基本料金の2倍）となり、Opus 4.7 は fast mode の対象から完全に除外されました。さらに、ネストした subagents が再びデフォルトで有効になり、深さ3まで起動できます（CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 でネストを無効化できます）。同じリリースでは、DirectoryAdded hook イベント、sandbox.network.strictAllowlist 設定、workflowSizeGuideline 設定キーが追加されました。dynamic workflows のデフォルトは中規模のガイドライン（15体未満のエージェントを目安）となり、stream-json ではネストした subagents の転送もサポートされます。v2.1.220（7月25日）は、バグ修正と信頼性向上のみのリリースです。 v2.1.221～226（8月4～7日）では、セッション間メッセージング（macOS／Linuxで、自分のセッション間における SendMessage／ListAgents）、クラウドセッション向けセルフホストランナー（Team／Enterprise）、SHA-256固定に対応した archive plugin ソース、JWT／SigV4対応のサンドボックス認証情報マスキング、VSCode Focus ビュー、個別の worktree を持つ /fork のコピーが追加されました。また、1セッションあたり200体という subagents の上限と ultraplan が削除されました。^{199200201202196197198} v2.1.227～229（8月10～12日）は修正中心のリリースですが、使い勝手の改善も含まれます。plugin マーケットプレイスで command ソースが利用可能になりました（ローカルプログラムが plugin ディレクトリを出力し、セッションごとに再解決されます。mode: "link" を指定すると、その場所を直接使用します）。claude remote-control --continue で直近の Remote Control セッションを再開できます。ListAgents は切断された Remote Control の接続先を offline、クラウドセッションを cloud と表示します。/commit-push-pr は危険な git フラグ（--force、--amend、--no-verify）を自動承認しなくなりました。また、新しいモデルでは Write ツールの規則が Edit と統一され、未読ファイルを上書きする際に、そのセッションで事前に読み込む必要がなくなりました。^235233234 v2.1.232（8月13日）では、subagent のforkがデフォルトになりました（subagent_type: "fork" は会話全体とプロンプトキャッシュを継承し、対話型セッションで起動したチームメイト以外のエージェントはバックグラウンドで動作します）。また、プロンプト内で別の稼働中セッションを名前によって @メンションできるようになりました（Claude が SendMessage を介して転送します。稼働中のセッション1件だけと完全一致する名前なら、参照確認なしで名前のみでも送信されます）。対話型セッションの名前はマシンごとに一意な name-word-word 形式となり、セッション間の受信制御が /config の項目として表示されます。さらに GitLab と同等の機能が追加され、9種類の GitLab トークンがサンドボックスで秘匿され、glab CLI の認証情報が保護されるようになりました。ネストしたサブグループを含む素の gitlab.com マーケットプレイスURLも、GitHub のURLと同様にクローンされます。²³² v2.1.233（8月14日）では、GitLab 対応が --worktree にも拡張されました（MRのURLを利用でき、claude agents では !N と表示されます）。Bash コマンドに対する Linux のメモリ制限（CLAUDE_CODE_TOOL_MEMORY_LIMIT）と、WebFetch キャッシュのTTL設定も追加されています。また、Opus 4.8、Sonnet 5、Fable 5、およびそれ以降のモデルでは、todo／タスク追跡ツールがデフォルトで無効になりました（CLAUDE_CODE_ENABLE_TODO_TOOLS=1 で復元できます）。auto mode の不具合を受け、v2.1.232で行われた Windows の Bash 権限変更の一部も元に戻されています。²³¹ v2.1.234（8月17日）では、claude.ai の利用上限がリセットされた際に、Claude Code がセッションを自動的に続行するようになりました（/config の「Continue automatically at usage limit」で無効化できます）。ターンの途中でも /permissions と /add-dir を開けるようになり、CLAUDE_CODE_PROJECT_DIR_NAME と、バックグラウンドタスクを定期確認する /goal（CLAUDE_CODE_GOAL_CHECKIN_MINUTES）が追加されました。認証済みの glab CLI があるリポジトリでは、フッターに GitLab MR バッジ（!N）が表示されます。また、組み込みの claude-api skill は参照ドキュメントを必要に応じて読み込む方式となり、コンテキスト消費量が約200kトークンから約25kトークンへ削減されました。²³⁰ v2.1.235～238（8月18～20日）では、組み込みの「Concise」出力スタイル（前置きや作業実況を省き、結果を先に提示。/config の Output style から選択可能）、ANTHROPIC_DEFAULT_MODEL 環境変数（新規セッションの開始モデルを指定。ANTHROPIC_MODEL とは異なり、/model で選んだモデルが優先され、その選択は保存されます）、任意の spellcheck 設定（インストール済みの aspell、hunspell、ispell を使ってプロンプト内のスペルミスに下線を表示）、keybindingFlavor 設定（"readline" にすると、Bash と同様に Ctrl+W で直前の空白まで削除。この設定はv2.1.261で廃止され、readline の動作のみになりました）が追加されました。さらに、plugin マーケットプレイスとプロジェクトの .mcp.json で headersHelper を利用できるようになりました（コマンドで有効期間の短いHTTPヘッダーを生成します。カタログ項目のヘルパーはコマンドを表示したうえでインストール／更新時にのみ実行されます。プロジェクト、plugin、エージェントスコープのヘルパーは、フォルダ信頼ダイアログを経たうえで、継承された認証情報の環境変数なしに実行されます）。セッション間の SendMessage には notify_when_idle が追加され、別のローカルセッションが次にアイドル状態になった際に1回だけ通知できます。権限の動作も2点変わりました。auto mode では Monitor のallowルールが別扱いとなり、Monitor コマンドは Bash と同じ分類器審査を受けます。また、macOSサンドボックスでは、許可された読み取り範囲内でもワイルドカードの読み取り拒否ルール（**/.env）が優先され、拒否対象のファイル名を変更しても回避できません。Bedrock、Vertex AI、Foundry、およびテレメトリ無効時の auto mode 分類器では、Claude API のデフォルトが使用されます²²³（v2.1.273時点では、これらのゲートウェイは「当面の間」ローカル分類器をデフォルトで使用し、CLAUDE_CODE_AUTO_MODE_SERVER=1 で各プラットフォームのサーバー側分類器を有効化できます²¹⁷）。v2.1.239（8月21日）では、/claude-api upgrade（Python プロジェクトを anthropic 0.xから1.xへ移行）が追加されました。データレジデンシーを利用するワークスペースでは、米国内推論限定の1.1倍の追加料金がコスト見積もり（/cost、ステータス行、--max-budget-usd）に反映されます。セッション間メッセージングが Windows にも導入され、claude.aiと同期したpluginsは name@synced と表示されます（claude plugin enable/disable で管理でき、同名のローカルインストールを上書きすることはありません）。ListAgents ではセッション自身の名前と稼働中のチームメイトも確認でき、Bash の単語単位のキー操作に "readline" が適用されました。/goal の確認間隔は30分から1時間、さらに2時間へ延長され、Bedrock／Vertex／Foundry でもフルスクリーンレンダラーを利用できます。v2.1.240～241（8月22～23日）はバグ修正版です。同じ週のドキュメント更新では、2つのステータス変更が示されました。/design は、artifacts を通じて編集可能なUIアートボードのキャンバスを公開するリサーチプレビューのskillです（Pro／Max／Team／Enterprise向け、v2.1.233以降が必要）。また、Remote Control はリサーチプレビューを終了し、claude remote-control を実行しているマシンが Claude アプリにデバイスカードとして表示されるようになりました。²⁰⁵ v2.1.174～176（2026年6月12日）以降、availableModels のallowlistで Default モデルを制限できる新しい管理設定 enforceAvailableModels が追加されました（ユーザー／プロジェクト設定から管理対象リストを拡張することはできません）。セッションタイトルは会話で使用している言語で生成されます（language 設定で言語を固定できます）。さらに、footerLinksRegexes と wheelScrollAccelerationEnabled の設定、VSCode の /usage 帰属ダイアログ、hook の if 条件で Read／Edit／Write のパスパターンを正しく照合する修正が追加されています。¹⁷² v2.1.173（2026年6月11日）以降、末尾に [1m] が付いた Fable 5 のモデル名は自動的に正規化され、その接尾辞が削除されます。Fable 5 は最初から1Mコンテキストを備えているため、この接尾辞は不要です（Opus／Sonnet でのみ意味がありました）。v2.1.172（2026年6月10日）以降、sub-agentsは自身の sub-agents を最大5階層まで再帰的に起動できました。このデフォルトはv2.1.216まで維持され、v2.1.217で無効化されています（前述）。また、AWS_REGION が未設定の場合、Bedrock は ~/.aws からリージョンを読み込み（/status に取得元を表示）、/plugin にはマーケットプレイスの検索バーが追加され、claude_code.lines_of_code.count OTELメトリクスには model 属性が加わりました。v2.1.170（2026年6月9日）以降、Opus より上位の新しいモデル階層である Claude Fable 5 を、claude update の実行後に /model fable を使って Claude Code から選択できます。low～max の全 effort 範囲をサポートしますが、thinking は無効化できません。エージェント処理のデフォルトは引き続き Opus 4.8です。v2.1.169（2026年6月8日）以降、--safe-mode（および CLAUDE_CODE_SAFE_MODE）を使うと、トラブルシューティングのため、すべてのカスタマイズを無効化したクリーンなセッションを開始できます。/cd はプロンプトキャッシュを壊さずにセッションを新しい作業ディレクトリへ移動し、disableBundledSkills は組み込みの skills と slash commands をモデルから隠します。v2.1.166（2026年6月6日）以降、fallbackModel 設定でプライマリモデルが混雑している場合に最大3つの代替モデルを連鎖指定でき、MCP のdenyルールではglobの "*" が利用可能になりました。MAX_THINKING_TOKENS=0／--thinking disabled を使えば、thinking がデフォルトで有効なモデルでも完全に無効化できます。v2.1.154（2026年5月28日）以降、Opus 4.8が新しいデフォルトとなり、デフォルトのeffortはhigh、/effort xhigh レベルも追加されました。dynamic workflows は /workflows を通じて数十から数百のエージェントをバックグラウンドで統括します。Opus 4.8のFast modeは、標準料金の2倍で2.5倍の速度を提供します。簡潔なシステムプロンプトは、Haiku／Sonnet／Opus 4.7以前を除くすべてのモデルでデフォルトになりました。/simplify は再びクリーンアップ専用のレビューとなり、/code-review --fix とは分離されています。claude agents では ! <command> を使ってバックグラウンドのシェルセッションを起動できます。pluginsは defaultEnabled: false を宣言でき、ストリーミングでのツール実行は常時有効です。stdio の MCP サーバーには、環境変数として CLAUDE_CODE_SESSION_ID と CLAUDECODE=1 が渡されます。v2.1.153ではpluginマーケットプレイスに skipLfs が追加され、/model の選択がデフォルトとして保存されるようになりました（s を押すとセッション限定になります）。ステータス行の環境変数には COLUMNS／LINES が追加されています。v2.1.152では、/code-review --fix（指摘内容を作業ツリーに適用）、skillのフロントマターにおける disallowed-tools、/reload-skills、新しい MessageDisplay hookイベント、SessionStart hookの reloadSkills／sessionTitle 出力、pluginSuggestionMarketplaces 管理設定、セッション途中での --fallback-model 切り替えが導入され、auto modeへのオプトインが廃止されました。^{162 163 164 165 166 167 168 169 170 244 171}

Claude Code は、プログラミング知識を備えたチャットインターフェースではなく、エージェント型システムとして動作します。 CLI はコードベースを読み取り、コマンドを実行し、ファイルを変更し、gitワークフローを管理します。さらに、MCP を介して外部サービスに接続し、複雑なタスクを専門の subagents に委任します。すべての処理は、開発者の実際の作業方法に組み込まれるコマンドラインインターフェースを通じて行われます。2026年2月時点で、公開されている GitHub commitの4%（1日あたり約135,000件）は Claude Code によって作成されています。リサーチプレビューから13か月で42,896倍に増加し、Anthropic 自身のコードも90%がAIによって記述されています。¹⁰³

Claude Code を気軽に使う場合と効果的に使う場合の違いは、5つの中核システムを理解しているかどうかです。 これらを習得すれば、Claude Code は生産性を飛躍的に高める存在になります。

1. 設定の階層構造：動作を制御します
2. 権限システム：操作の実行可否を管理します
3. Hookシステム：確実に再現できる自動化を実現します
4. MCP プロトコル：機能を拡張します
5. Subagentシステム：複雑な複数ステップのタスクを処理します

重要なポイント

• 効果を左右するのは5つのシステムです：設定の階層構造、権限、hooks、MCP、subagentsが、動作から自動化までのすべてを制御します。
• 作業はDelegation Layerへ移しましょう：subagentsは、調査を独立したクリーンなコンテキストウィンドウに隔離し、要約だけを返すことでコンテキストの肥大化を防ぎます。
• Hooksは実行を保証しますが、プロンプトは保証しません：モデルの動作に左右されず毎回実行しなければならないlint、フォーマット、セキュリティチェックには hooks を使います。
• モデルの使い分けにより、品質を損なわずにコストを削減できます：subagentによる調査は低価格のモデルに任せ、本格的なアーキテクチャ上の推論にのみ Opus を使いましょう。品質だけを重視するなら、Opus に統一する方法もあります。
• MCP は Claude をツールチェーンへ接続します：データベース、GitHub、Sentry、3,000以上の連携により、Claude の機能はファイルの読み取りやbashコマンドを超えて拡張されます。

私は数か月にわたり、本番環境のコードベース、CI/CDパイプライン、エンタープライズ環境への導入を通じて、Claude Code の限界を試してきました。このガイドでは、その経験を凝縮し、使い始めた頃に欲しかった完全な参照資料としてまとめています。すべての機能について、実際の構文、現実的な設定例、経験豊富なユーザーでも陥りやすいエッジケースを紹介します。

目的別の読み進め方

このガイドの使い方

これは5,000行を超える参照資料です。最初から最後まで通読する必要はありません。経験に合った場所から始めてください。

特定のフラグ、コマンド、設定キーを探すには、ブラウザの Ctrl+F／Cmd+F を使用してください。末尾のクイックリファレンスカードには、主要なコマンドを見やすくまとめています。

関連する詳細解説

以下のブログ記事では、Claude Code の各側面を詳しく解説しています。

60秒クイックスタート

まずは Claude Code を実行して出力を確認したいだけなら、次の手順を順番に進めてください。

# 1. Install (pick one)
npm install -g @anthropic-ai/claude-code          # npm users
brew install anthropic/claude/claude              # macOS + Homebrew
curl -sL claude.ai/install.sh | sh                # native installer

# 2. Launch in any project directory
cd ~/your-project && claude

# 3. Authenticate (browser opens automatically on first run)
/login

# 4. Ask your first question
> What does this repo do? Read the key files and summarize.

以上です。このセクション以降では、インストール方法の詳細、権限と hooks の設定、MCP サーバーとの接続、エンタープライズ環境へのデプロイについて解説します。ただし、利用を始めるだけなら、いずれも必須ではありません。

前提条件： Node 22以降が必要なのは、従来の npm を使用する場合のみです（v2.1.198で18から引き上げられました。公開中のインストールドキュメントには「Node.js 22 or later」と記載されており、2026年8月7日に確認済みです）。推奨されるネイティブインストーラーは Node に依存しません。macOS / Linux / Windows 10以降に対応しています。Claude の Pro、Max、Team、Enterprise のいずれかのサブスクリプション、またはトークン従量課金制の Anthropic API キーで利用できます。プラットフォーム固有の手順、トラブルシューティング、ネイティブバイナリを使用する方法（v2.1.113以降のデフォルト）については、Claude Code をインストールするには？をご覧ください。このガイドに掲載する最新リリースの根拠は、リリースごとに更新しています。現在の確認日については、変更履歴の最新行をご覧ください。²⁴⁴

Claude Code の仕組み：メンタルモデル

機能の詳細に入る前に、Claude Code のアーキテクチャが操作全体にどのような影響を与えるかを理解しておきましょう。このシステムは、次の3つのレイヤーで動作します。

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │           Subagents (20 concurrent default)      │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Isolated contexts for focused work, returns summaries  │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Main Conversation Context                │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, etc.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Your primary interaction; limited context; costs money │
└─────────────────────────────────────────────────────────┘

コアレイヤー：メインの会話です。すべてのメッセージ、ファイルの読み取り、ツールの出力が、共有ウィンドウのコンテキストを消費します（標準では200Kトークン⁹¹、Opus 4.6または拡張コンテキストモデルでは1Mトークン）。コンテキストが埋まると、Claude は以前の判断を把握できなくなり、品質が低下します。このレイヤーでは、トークン単位で料金が発生します。

委任レイヤー：subagents は空のコンテキストで起動し、対象を絞った作業を行って、要約を返します。調査結果のすべてがメインの会話を膨らませることはなく、結論だけが返されます。調査には低コストのモデル階層を割り当てられますが、コストより品質を重視する場合は、一貫してプライマリモデルを使用してもかまいません。

拡張レイヤー：MCP は外部サービス（データベース、GitHub、Sentry）と接続します。hooks は、モデルの動作にかかわらずシェルコマンドの実行を保証します。skills には、Claude が自動的に適用する専門知識を組み込めます。plugins は、これらすべてを配布可能な形にまとめます。

重要なポイント：多くのユーザーはコアレイヤーだけで作業し、コンテキストが膨らみ、コストが増えていく状況を見守ることになります。熟練したユーザーは、調査や専門的な作業を委任レイヤーに振り分け、自分のワークフローに合わせて拡張レイヤーを設定し、コアレイヤーはオーケストレーションと最終判断にのみ使用します。

目次

1. Claude Code をインストールするには？
2. クイックスタート：最初のセッション
3. 基本的な操作モード
4. 設定システムの詳細
5. どのモデルを選ぶべきか？
6. Claude Code の料金は？
7. 意思決定フレームワーク
8. 権限システムの仕組みは？
9. hooks の仕組みは？
10. MCP（Model Context Protocol）とは？
11. subagents とは？
12. 拡張思考モードとは？
13. 出力スタイル
14. スラッシュコマンド
15. skills の仕組みは？
16. plugins システム
17. メモリの仕組みは？
18. 画像とマルチモーダル入力
19. 音声モード
20. Git 連携の仕組みは？
21. IDE で Claude Code を使用するには？
22. 高度な活用パターン
23. リモートエージェントとバックグラウンドエージェント［リサーチプレビュー］
24. Chrome の Claude
25. Slack の Claude Code［リサーチプレビュー］
26. Web 版 Claude Code［リサーチプレビュー］
27. Microsoft 365 の Claude（2026年5月）
28. パフォーマンスの最適化
29. 問題をデバッグするには？
30. エンタープライズ環境へのデプロイ
31. キーボードショートカット一覧
32. ベストプラクティス
33. ワークフローレシピ
34. 移行ガイド
35. 対象読者別のガイダンス
36. クイックリファレンスカード
37. 変更履歴
38. 参考資料

Claude Code のインストール方法

システム要件

Claude Code は、macOS 13以降、Ubuntu 20.04以降／Debian 10以降、Windows 10以降（ネイティブまたはWSL）で動作します。最低4 GBのRAMと有効なインターネット接続が必要です。⁹² シェルはBash、Zsh、Fishとの互換性が最も高くなります。

Windowsでは、WSL 1とWSL 2の両方を利用できます。Windowsネイティブ環境を使いたい場合は、Git Bashも利用可能です。Alpine Linuxなど、muslベースのシステムでは追加パッケージが必要です。

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

プラットフォーム対応表

インストール、更新、アンインストールの早見表

すべての方法、コマンド、バージョン確認方法を1画面で見渡せる早見表です。各方法の詳細とトラブルシューティングについては、後続のサブセクションで説明します。

v2.1.113以降、標準のCLIでは、同梱のJavaScriptではなく、プラットフォームごとのオプション依存関係を介してネイティブのClaude Codeバイナリを起動します。テスト済みの配布方法として、ネイティブインストーラーを使用してください。npmによる方法も引き続き利用できますが、v2.1.15で追加された非推奨通知が表示されます。

インストール方法

ネイティブインストール（推奨）

ネイティブバイナリならNode.jsに依存せず、最もシンプルに利用できます。

# macOS and Linux
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew alternative
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

特定のバージョンをインストールする場合：

# Install specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

NPMインストール（非推奨）

注： v2.1.15以降、npmでインストールすると非推奨の通知が表示されます。現在はネイティブバイナリが推奨のインストール方法です。claude installで移行してください。

npmがまだ必要なレガシー環境では、次の方法を使用します。

npm install -g @anthropic-ai/claude-code

npmでインストールする際は、決してsudoを使用しないでください。権限の問題が発生し、その後の作業が複雑になります。

既存のインストールからの移行

以前のnpmベースのインストールを使用している場合は、ネイティブバイナリへ移行します。

claude install

認証オプション

Claude Codeには、トレードオフの異なる3つの認証方法があります。

Claude Console（API課金）

platform.claude.com（旧console.anthropic.com）から、AnthropicのAPIへ直接接続します。アカウントを作成して課金を設定し、CLIから認証してください。Consoleでは、APIをすべて利用できる従量課金制が提供されます。専用の「Claude Code」ワークスペースが自動的に作成されます。このワークスペースではAPIキーを作成できませんが、使用状況は確認できます。v2.1.243以降、/login → Anthropic Consoleでは、APIキーの作成に加えて、キーレスの「Consoleアカウントでサインイン」（推奨）も選択できます。そのため、APIキーを許可していない組織でも、Consoleの認証情報を使ってサインインできます。²²⁷

Claude ProまたはMaxサブスクリプション

claude.aiアカウントの認証情報を使用します。1つの月額プランで、WebインターフェースとCLIの両方を利用できます。予測可能な費用を求める個人ユーザーにとって、課金管理がシンプルになります。

エンタープライズプラットフォーム

AWS Bedrock、Google Vertex AI、Microsoft Foundryでは、既存のクラウド課金契約を利用して、エンタープライズ向けのアクセスを提供します。Bedrockセットアップウィザード（v2.1.92以降）： ログイン画面の対話型ウィザードに従って、AWS認証、リージョン選択、認証情報の検証、モデルの固定を行えます。¹³⁷ Vertex AIセットアップウィザード（v2.1.98以降）： Google Cloud向けの同様のウィザードで、GCP認証、プロジェクトとリージョンの設定、認証情報の検証、モデルの固定を行えます。¹⁴² Vertex AI mTLS Workload Identity Federation（v2.1.121以降）： Vertex AIで、X.509証明書ベースのWorkload Identity Federation（mTLS Application Default Credentials）を利用できるようになりました。クライアント証明書から有効期間の短いGCPトークンが発行されるため、サービスアカウントのJSONは不要です。¹⁵⁴ OS CA証明書の信頼（v2.1.101以降）： エンタープライズTLSプロキシがデフォルトで動作するようになり、Claude CodeはOSの証明書ストアを信頼します。同梱のCAだけを使用する場合は、CLAUDE_CODE_CERT_STORE=bundledを設定してください。¹⁴³

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optional: API key auth (otherwise uses Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

# Amazon Bedrock via Mantle (v2.1.94+)
export CLAUDE_CODE_USE_MANTLE=1

プロキシの背後、またはLLMゲートウェイ経由で運用するエンタープライズ環境では、次のように設定します。

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

ゲートウェイヒントヘッダー（v2.1.273、オプトイン）： CLAUDE_CODE_GATEWAY_HINT_HEADERS=1を設定すると、Claude CodeはLLMゲートウェイでルーティングと監視に利用できる5つのリクエストヘッダー（x-claude-code-request-class、x-claude-code-agent-type、x-claude-code-prev-tool-durations、x-claude-code-compaction、x-claude-code-context-compacted）を追加します。²¹⁷

検証

claude doctor

このコマンドでは、インストール方式、バージョン、システム構成、検出された問題が報告されます。

認証管理（v2.1.41以降）

REPLに入らずに認証を管理できます。⁹⁰

claude auth login          # Log in or switch accounts
claude auth status         # Check current auth state (account, plan, expiry)
claude auth logout         # Clear stored credentials

v2.1.268以降、claude auth status --jsonにはconfigDirectoryが含まれます。これは、CLIが実際に読み込んでいる設定ディレクトリです。CLAUDE_CONFIG_DIRによる間接指定で読み込み元が分かりにくい場合に役立ちます。²¹⁶

v2.1.273以降、Claudeアカウントでサインインすると、claude.ai pluginsへのアクセスも要求されます。²¹⁷

アカウントまたは組織を切り替える際の一般的な手順：

claude auth logout && claude auth login

関連項目：認証エラーのトラブルシューティングについては、問題をデバッグするには？をご覧ください。

更新

Claude Codeはデフォルトで自動更新されます。起動時とセッション中に定期的に更新を確認し、バックグラウンドでダウンロードした更新を次回の起動時に適用します。

自動更新を無効にする場合：

export DISABLE_AUTOUPDATER=1

またはsettings.jsonで設定します。

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

手動で更新する場合：

claude update

アンインストール

ネイティブインストール（macOS/Linux/WSL）：

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

ネイティブインストール（Windows PowerShell）：

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

設定を完全に削除（すべての設定が消去されます）：

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

クイックスタート：最初のセッション

1. インストールして起動します：

claude                           # Launch in current directory

2. プロジェクトに移動します：

cd ~/my-project && claude        # Or launch from any git repo

3. Claude に作業を依頼します：

> "Explain the architecture of this project"
> "Find all TODO comments and create a summary"
> "Add input validation to the signup form"

4. セッション中にキーボードショートカットを使います：

/cost                            # Check token usage and cost
/compact                         # Free up context when it gets large
Alt+T                            # Toggle extended thinking for hard problems
Ctrl+C                           # Cancel current response

5. 後でセッションを再開します：

claude -c                        # Resume your most recent session
claude --resume                  # Pick from session list

エキスパート向けヒント： プロジェクトのルートに CLAUDE.md ファイルを作成し、ビルドコマンド、コーディング規約、アーキテクチャに関するメモを記載しましょう。Claude はセッションごとにこのファイルを読み込みます。品質向上のためにできることの中で、最も大きな効果が得られる方法です。

コア操作モード

対話型 REPL

引数なしで Claude Code を起動すると、対話型の read-eval-print ループに入ります。

cd your-project
claude

REPL では、ターンをまたいで会話のコンテキストが維持されます。クエリを直接入力して応答を受け取り、/exit または Ctrl+D で終了するまで会話を続けられます。

最初にプロンプトを指定すると、セッションの目的を絞り込めます。

claude "explain the authentication flow in this project"

上級者向けのヒント： REPL の状態は、コンパクションが発生しても維持されます。コンテキストが大きくなりすぎると、Claude は重要な決定事項やコードスニペットを残しながら、古い会話を自動的に要約します。/compact で手動実行したり、保持する内容について独自の指示を追加したりすることもできます。

非対話モード

print モード（-p）では、1件のクエリを実行して終了します。

# Direct query
claude -p "list all TODO comments in this project"

# Process piped input
cat error.log | claude -p "identify the root cause of these failures"

# Chain with other tools
claude -p "generate a README" > README.md

スクリプトでの解析に適した構造化出力を得るには、次のようにします。

claude -p "count lines by file type" --output-format json

JSON 出力には、自動化に必要な情報がすべて含まれています。

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.0034,
  "is_error": false,
  "duration_ms": 2847,
  "duration_api_ms": 1923,
  "num_turns": 4,
  "result": "Response text here...",
  "session_id": "abc-123-def"
}

ストリーミング出力をリアルタイムで処理するには、次のようにします。

claude -p "build the application" --output-format stream-json | while read line; do
  echo "$line" | jq -r 'select(.result) | .result'
done

出力形式のオプション：

stream-json における subagent のテキスト（v2.1.211以降）： デフォルトでは、stream-json の出力に含まれるのはメインセッションのイベントのみで、subagents 内で行われた作業は要約として示されます。--forward-subagent-text フラグ（または CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1）を使用すると、subagent のテキストと思考内容もストリームに転送されます。これにより、ハーネスやログパイプラインは最終レポートだけでなく、委任された作業の進行状況も確認できます。¹⁸⁸

ネストされた subagents も転送対象になりました（v2.1.219）。 当初は深さ1の subagents のみが表示されていましたが、現在は深さ2以降で生成された subagents も転送ストリームに含まれます。それぞれに、生成元となった Agent 呼び出しの tool_use id がキーとして付与されるため、パイプライン側ではテキストの平坦な一覧ではなく、委任ツリーを再構築できます。同じリリースで、深さ3までのネスト生成がデフォルトで復元されたこととも直接対応しています。この転送がなければ、3階層のうち2階層は見えないままでした。¹⁹⁶

バックグラウンドに移った subagents の出力も途切れなくなりました（v2.1.273）： subagent が実行途中でバックグラウンドに移された場合（CLAUDE_AUTO_BACKGROUND_TASKS など）でも、SDK と stream-json の出力から、その後のメッセージや最終レポートが欠落しなくなりました。²¹⁷

終了コード：

-p モードでのエージェント動作の制御：

# Limit autonomous turns (prevents runaway loops)
claude -p "refactor the auth module" --max-turns 10

# Allow specific tools without prompting
claude -p "fix lint errors" --allowedTools "Edit,Bash(npm run lint)"

# Use with a specific model
claude -p "explain this code" --model claude-sonnet-5

# Bare mode: skip hooks, LSP, plugin sync, skill walks (v2.1.81+)
claude -p "count files" --bare

# Channel permission relay: send approval prompts to Telegram/Discord (v2.1.81+)
claude --channels

# Restricted mode for eval harnesses and shared machines (v2.1.248+)
claude --restricted -p "query" --tools "Read,Grep,Glob"

# Unattended hosts: deny anything that would prompt (v2.1.259+)
claude -p "run the nightly checks" --permission-prompts none

制限モード（v2.1.248以降）： --restricted（または CLAUDE_CODE_RESTRICTED=1）は、共有マシン上で claude を動かす評価ハーネス向けに設計されています。コマンドやコードを実行する組み込みツールと WebFetch は、--tools で個別に指定しない限り削除されます。default プリセットは個別指定とは見なされません。また、組み込みのファイルツールを作業ディレクトリ内に限定し、管理対象の設定と --settings だけを読み込みます（ユーザー、プロジェクト、ローカルの設定ファイルは無視されます）。さらに、bypassPermissions とクラウドセッションの作成も拒否します。²⁰⁶²⁰⁹

--permission-prompts none（v2.1.259）： 無人ホスト向けの補助機能です。権限プロンプトが必要になる操作はすべて自動的に拒否される一方、auto モードを含む有効な権限モードは、ユーザーの操作なしで判断できる項目について引き続き判断します。プロンプトを拒否する代わりに MCP ツールへ委任する --permission-prompt-tool と混同しないでください。CLI のリファレンスにはまだこの新しいフラグが記載されていないため、情報源は CHANGELOG です。²¹¹

非対話セッションでも、ターンをまたいで cd が維持されます（v2.1.265）： stream-json 入力を受け取る -p セッション、Agent SDK セッション、クラウドセッションでは、ユーザーメッセージが新しく届くたびにシェルの作業ディレクトリがリセットされなくなりました。あるターンで実行した cd は、次のターンにも引き継がれます。²¹⁵

--system-prompt-snapshot off（v2.1.267）： デフォルトでは、会話に記録されたシステムプロンプトがリクエストごとに再利用されます。このフラグを使うと、リクエストのたびにシステムプロンプトが新たにレンダリングされます。プロンプトの文章を調整しているときに、各実行で最新の編集内容を反映するための切り替えです。ただし、スナップショットによって保護されているプロンプトキャッシュの安定性は低下します。²¹⁶

CI/CD 統合パターン：

# In a GitHub Action or CI pipeline
result=$(claude -p "review this diff for security issues" --output-format json 2>/dev/null)
is_error=$(echo "$result" | jq -r '.is_error')
if [ "$is_error" = "true" ]; then
  echo "Review failed"
  exit 1
fi
echo "$result" | jq -r '.result'

セッション管理

セッションには会話履歴が保存され、後から続行できます。複数のセッションにまたがる複雑な作業には、セッションの永続化が欠かせません。

# Continue most recent session
claude -c

# Continue with additional prompt
claude -c -p "now add error handling"

# Resume specific session by ID
claude -r "abc123" "implement the remaining tests"

# Fork a session for parallel exploration
claude -r "base-session" --fork-session "try a different approach"

実行中のセッションを /cd で移動（v2.1.169以降、v2.1.246以降は設定を即時反映）： /cd path を実行すると、プロンプトキャッシュを維持したまま作業ディレクトリを変更できます。v2.1.246以降では、移動先ディレクトリのプロジェクト設定、hooks、.mcp.json サーバー（通常どおり承認プロンプトが表示されます）、skills、agents が、--resume を待たずに移動直後から反映されます。²³⁹²²⁶

PR に紐づくセッション（v2.1.27以降、v2.1.119以降で拡張）： 特定の pull request または merge request に紐づけたセッションを開始できます。v2.1.119以降、--from-pr は github.com に加えて、GitLab MR、Bitbucket PR、GitHub Enterprise PR の URL にも対応しています。⁷⁴¹⁵²

claude --from-pr 123                                                # GitHub PR number (assumes current repo's remote)
claude --from-pr https://github.com/org/repo/pull/123               # GitHub URL
claude --from-pr https://gitlab.com/org/repo/-/merge_requests/45    # GitLab MR (v2.1.119+)
claude --from-pr https://bitbucket.org/org/repo/pull-requests/67    # Bitbucket PR (v2.1.119+)
claude --from-pr https://ghe.example.com/org/repo/pull/89           # GitHub Enterprise (v2.1.119+)

セッション中に gh pr create で PR を作成した場合も、セッションがその PR に自動で紐づけられます。これにより、後から特定の PR に関する作業を簡単に再開できます。フッターの PR バッジには、prUrlTemplate 設定（v2.1.119以降）を使って独自のコードレビュー URL を指定できます。PR から別のレビューツールへリンクするチームに便利です。¹⁵²

/resume が PR の URL に対応（v2.1.122以降）。 /resume の検索ボックスに PR の URL を貼り付けると、その PR を最初に作成したセッションを検索できます。github.com、GitHub Enterprise、gitlab.com（セルフホスト版 GitLab を含む）、bitbucket.org に対応しています。¹⁵⁴

名前付きセッション： 起動時またはセッション中に名前を付けられます。

# Name session at startup (v2.1.76+)
claude -n "auth-refactor"                  # --name flag sets display name[^125]

# Name current session
> /rename auth-refactor

# Resume by name or number
> /resume 1                    # Resume first session
> /resume auth-refactor        # Resume by name
claude --resume auth-refactor  # Resume from terminal
claude -r 3                    # Resume by number from terminal

# Fork for parallel exploration
claude --resume auth-refactor --fork-session

注： --session-id には有効な UUID（例：550e8400-e29b-41d4-a716-446655440000）が必要です。人が読みやすいセッション名を使う場合は、代わりに /rename と --resume を使用してください。

/fork はバックグラウンドセッションを生成し、/subtask はセッション内でフォークします（v2.1.212）。 /fork コマンドは、現在の会話を新しいバックグラウンドセッションへコピーするようになりました。コピー先は claude agents に独立した行として表示されるため、メインセッションを続けながら、別の案を検討させることができます。従来の動作である現在のセッション内でのフォークは、/subtask という新しい名前で利用できます。¹⁸⁹ v2.1.214以降、フォークとして開始されたセッションでは、SessionStart hook の source が従来の "resume" ではなく "fork" として報告されるため、source に一致する hooks で両者を区別できます。¹⁹⁰ v2.1.216では、/fork の確認表示が、新しいセッション名とその claude attach id を示す1行に簡略化されました。¹⁹² v2.1.221以降、フォークされたセッションは元のセッションのチェックアウトを使わず、独自の worktree を作成します。別案を検討するフォークがメインセッションの未コミットファイルと衝突するという、実験用コピーに伴っていた危険が解消されました。¹⁹⁹ v2.1.232では、subagents でもフォークがデフォルトになりました。subagent_type: "fork" の subagent は会話全体とプロンプトキャッシュを継承し、対話型セッションで生成されたチームメイト以外の agents は、デフォルトでバックグラウンド実行されるようになりました。²³²

Claude Code はセッションを JSONL トランスクリプトとして保存します。Agent の実行には一意の agentId 値が割り当てられ、トランスクリプトは agent-{agentId}.jsonl として保存されます。再開時には、以前の会話のコンテキスト全体が保持されます。

Plan モード

Plan モードでは、Claude の操作が読み取り専用の調査に制限され、ファイル編集、bash の実行、破壊的な操作は行えません。Claude は実装方針を設計してプランファイルに書き込み、何かを実行する前に承認を待ちます。

Plan モードへの移行：

# Cycle through modes during a session
Shift+Tab           # Cycles: normal → plan → auto-accept

# Or use the /plan command with an optional description (v2.1.72+)
/plan                                     # Enter plan mode
/plan refactor the auth module            # Enter plan mode with a description

# Or ask Claude directly
"Plan how to refactor the auth module"   # Claude may enter plan mode automatically

仕組み：

1. Claude が Plan モードに入ります（複雑なタスクでは自動的に、または Shift+Tab で移行）
2. 読み取り専用ツールの Read、Glob、Grep、WebSearch、WebFetch を使ってコードベースを調査します
3. .claude/plans/{session-slug}.md にプランを書き込みます
4. ExitPlanMode で Plan モードを終了し、レビュー用のプランを提示します
5. 承認、変更依頼、または却下を選択します

Plan モードで利用できるツール： Read、Glob、Grep、LS、WebSearch、WebFetch、AskUserQuestion。編集ツール（Edit、Write、Bash、NotebookEdit）は使用できません。

プラン承認後（v2.1.32以降）： Claude は3つの選択肢を提示します。 - 「はい、コンテキストをクリアして編集を自動承認する」（Shift+Tab）— プラン用のコンテキストをすべて確保して新たに開始します - 「はい、編集を手動で承認する」— コンテキストを維持し、変更ごとに承認します - 「はい、編集を自動承認する」— コンテキストを維持し、Claude が変更ごとの承認なしで実行します

承認時にコンテキストを自動でクリアする方法が推奨ワークフローです。プラン用に新しいコンテキストウィンドウが用意されるため、プランに従いやすくなります。古い会話に影響されることなく、Claude がより長く方針を維持できます。

Plan モードを使用する場面： - アーキテクチャ上の判断を伴う新機能の実装 - 最初に方針を確認したい、複数ファイルにまたがるリファクタリング - 変更の前に調査すべき不慣れなコードベース - 有効なアプローチが複数あり、意見を反映させたいタスク

上級者向けのヒント： Plan モードに時間をかけるほど、Claude が実装に成功する可能性は高まります。Plan モードでは実質的に自由に調査でき、危険なツール呼び出しも無駄な編集もありません。積極的に活用しましょう。

スクリーンリーダーモード（v2.1.208）

Claude Code には、支援技術向けにターミナル UI を調整する専用のスクリーンリーダーモードが搭載されています。次の3つの方法のいずれかで有効にできます。¹⁸⁶

# Flag at launch
claude --ax-screen-reader

# Environment variable
export CLAUDE_AX_SCREEN_READER=1

# Or persistently in settings.json
{ "axScreenReader": true }

Anthropic の公式ドキュメントには、このモードと操作方法を説明する新しいアクセシビリティページが用意されています。¹⁸⁶

設定システムの詳細

Claude Code は階層型の設定システムを使用します。上位レベルの設定は下位レベルを上書きし、Enterprise 設定は一切回避できないため、この階層の理解が不可欠です。

設定の階層

プロンプトから設定を変更する：/config key=value（v2.1.181）

v2.1.181 以降では、対話型の /config UI を開かなくても、/config key=value を使ってプロンプトから任意の設定を直接変更できます。たとえば、/config thinking=false のように指定します。対話型セッション、-p、Remote Control セッションで利用できます。/config --help（v2.1.183）を実行すると、使用可能な省略キーの一覧が表示されます。v2.1.183 では対話型の /config UI も変更され、Enter と Space のどちらでも選択中の設定を切り替えられるようになり、Esc で保存して閉じるようになりました（以前は変更が元に戻されていました）。¹⁷⁴

settings.json の完全なリファレンス

主要なオプションをすべて示した完全な設定例です。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "label": "Team tips",
    "tips": [
      "Custom tip 1",
      {"id": "tip-2", "text": "Custom tip 2", "cooldownSessions": 5, "priority": 1}
    ],
    "tipsFile": "~/.claude/team-tips.json",
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "bedrock": "us.anthropic.claude-opus-5",
    "vertex": "claude-opus-5",
    "foundry": "claude-opus-4-8"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides は、チームが大規模な skill ライブラリを運用しつつ、実行時に公開する範囲を絞りたい場合に便利です。off を指定するとモデルとスラッシュピッカーの両方で skill が非表示になり、user-invocable-only ではモデルの選択対象から外しつつ名前による呼び出しを維持できます。name-only を指定すると、詳しい説明を表示せず、skill 名だけを公開できます。¹⁵⁶

新しい設定（v2.1.174～176）：

• availableModels / enforceAvailableModels（managed、v2.1.175 以降）： availableModels の許可リストにより、セッションで選択できるモデルを制限します。enforceAvailableModels: true を指定すると、許可リストは Default モデルにも適用されます。Default の解決先が許可されていないモデルの場合は、許可リストの最初のモデルへフォールバックします。また、ユーザー設定やプロジェクト設定から managed の availableModels リストを拡張することもできなくなります。関連する修正（v2.1.176）では、エイリアスで選択したモデルが ANTHROPIC_DEFAULT_*_MODEL を介してブロック対象のモデルへリダイレクトされる抜け道が塞がれました。さらに、許可リスト外のモデルへ切り替わる場合、/fast は切り替えを拒否するようになっています。¹⁷² v2.1.187 以降では、組織が /model ピッカー、--model、/model、ANTHROPIC_MODEL のすべてにモデル制限を直接適用できます。制限対象のモデルを選択すると、「組織の設定により制限されています」というメッセージが表示されます。¹⁷⁶
• language（v2.1.176 で改良）： 応答言語の設定に加えて、セッションタイトルもデフォルトでは会話の言語で生成されるようになりました。タイトルの言語を固定するには、language を設定します。¹⁷²
• footerLinksRegexes（v2.1.176）： フッター行に、正規表現に一致したリンクバッジを表示します。ユーザー設定または managed 設定で構成できます。¹⁷²
• wheelScrollAccelerationEnabled（v2.1.174）： false に設定すると、フルスクリーンモードでのマウスホイールによるスクロール加速を無効にできます。¹⁷²

新しい設定（v2.1.207～v2.1.212）：

• vimInsertModeRemaps（v2.1.208）： vim の挿入モード用にキーを独自に再マッピングできます。代表的な例は、jj を Escape に割り当てる設定です（Vim モードを参照）。¹⁸⁶
• axScreenReader（v2.1.208）： スクリーンリーダーモードを常時有効にします（スクリーンリーダーモードを参照）。¹⁸⁶
• processWrapper（v2.1.208）： Claude Code が自身のために起動するすべてのプロセスを、ラッパー実行ファイル経由で実行します。企業向けランチャーのために設計された機能です（企業向けランチャーを参照）。¹⁸⁶
• autoMode の読み込み元制限（v2.1.207）： autoMode 設定は、リポジトリ内の .claude/settings.local.json から読み込まれなくなりました。代わりに ~/.claude/settings.json で構成してください。これにより、クローンしたリポジトリに自動モードの設定を仕込める経路が塞がれます。¹⁸⁵

新しい設定（v2.1.217）：

• emojiCompletionEnabled（v2.1.217）： プロンプト入力で絵文字のショートコードを自動補完します。:heart: と入力すると ❤️ が挿入され、:hea のように途中まで入力すると候補が表示されます。デフォルトで有効です。無効にするには false を設定してください。¹⁹⁴

新しい設定（v2.1.219）：

• sandbox.network.strictAllowlist（v2.1.219）： sandbox 化されたコマンドによる許可リスト外のホストへのアクセスを、権限ダイアログを表示せずに拒否します。Sandbox モードを参照してください。¹⁹⁶
• workflowSizeGuideline（v2.1.219）： 推奨値である Dynamic workflow の規模ガイドラインを、/config だけでなく、ユーザー、プロジェクト、managed の各設定ファイルから指定できます。Dynamic workflow のデフォルトは medium（「15 未満の agent を目安にする」）です。設定ファイルから値が指定されている間は、/config の該当行が非表示になります。これは推奨値であり、強制的な上限ではありません。Subagentsを参照してください。¹⁹⁶

新しい設定（v2.1.242～243）：

• modelPicker（ユーザーまたは managed、v2.1.242 以降）： 順序とラベルを指定したモデルのリストで、/model ピッカーをカスタマイズできます。options 配列を持つオブジェクトとして指定します。各行には必須の model と、任意の label および description を設定できます。model はそのまま解釈されるため、エイリアス、Anthropic ID、Bedrock/Vertex/Foundry/ゲートウェイ ID のすべてが使用可能です。任意の Boolean 値 replaceBuiltInOptions も指定できます。デフォルトの false では組み込みの選択肢の後に各行が追加され、true では設定した行、Default、およびセッションですでに実行中のモデルだけが表示されます。Claude Code は managed 設定、--settings、ユーザー設定からこのキーを読み込み、プロジェクト設定とローカル設定では無視します。そのため、クローンしたリポジトリからピッカーのラベルを変更することはできません。このキーが設定された最上位の読み込み元が、ラインナップ全体を決定します。availableModels の許可リストは引き続きすべての行に適用されます。また、ラベルで変わるのはピッカー上の表示だけであり、実行されるモデルではありません。²²⁷²²⁵
• promptCacheTtl / subagentPromptCacheTtl（任意のファイル、v2.1.242 以降）： リクエストのバケットごとに "5m" または "1h" を指定できます。これにより、API キーやクラウドプロバイダーを使用する場合、メインの会話では 1 時間のキャッシュを維持しながら、subagents では 5 分に設定できます。キャッシュ戦略を参照してください。²²⁷²²⁵
• modelPricing（managed、v2.1.243 以降）： 組織が契約しているモデル別の料金と割引倍率です。/cost、ステータス行、テレメトリーのコスト値では、定価の代わりにこの料金が使用されます。コストの確認を参照してください。²²⁷

新しい設定（v2.1.247）： - feedbackDrafts（v2.1.247）： 新しい SendFeedback ツールの動作を制御します。セッションで問題が発生した際、Claude がフィードバックレポートの下書きを作成し、/feedback から内容を確認して送信できます。この設定で下書き機能を無効にできます。Slash Commands の /feedback の行をご覧ください。²²² - spinnerTipsOverride の形式拡張（v2.1.247）： ヒントの項目には、プレーンな文字列に加えて {id, text, cooldownSessions, priority} オブジェクトを使用できるようになりました。また、オブジェクトに tipsFile と label キーが追加され、組織独自のヒントを組み込みのヒントと併せてローテーション表示できます（上記の例は拡張後の形式です）。設定ドキュメントには新しいキーがまだ記載されておらず、現時点では CHANGELOG が唯一の情報源です。²²²

新しい設定（v2.1.248–251）：

• desktopSessionCleanupPeriodDays（v2.1.248）： デスクトップから書き込まれたセッションを、トランスクリプトのクリーンアップ対象外として保持する期間の上限を設定します。この設定値よりも、同時に導入された修正のほうが重要です。以前は、Claude Desktop と Cowork のセッションが cleanupPeriodDays（デフォルトは30日）を過ぎると消えていました。現在は、組織のポリシーで保持期間が管理されていない限り、アプリ内に存在するセッションはクリーンアップされません。²⁰⁶
• プロジェクトの env 制限（v2.1.251）： プロジェクトレベルの .claude/settings.json にある env ブロックでは、CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、TMPDIR/TMP/TEMP を設定できなくなりました。代わりに、シェル、ユーザー、または管理対象の設定で指定してください。これにより、クローンしたリポジトリから Claude Code の設定ファイルや一時ファイルの書き込み先を変更されることを防げます。²⁰⁶

新しい設定（v2.1.257-259）：

• timeFormat / timeZone（v2.1.257）： Claude Code による時刻の表示形式を制御します。対象はターン終了時の完了時刻と、トランスクリプトのタイムスタンプです。timeFormat には12時間形式、24時間形式、UTCの24時間形式、または明示的な strftime パターンを指定でき、timeZone にはタイムゾーン名を指定します。設定ドキュメントにはまだ記載されておらず、情報源は CHANGELOG です。²¹¹
• permissions.blockReadsOutsideWorkingDirectories（v2.1.257）： セッションの作業ディレクトリ外にあるファイルの読み取りを一律で拒否します。この設定がない場合、auto mode ではセッション中に初めてそのような読み取りが発生した際に、一度だけ確認を求めるようになりました（Auto Mode を参照）。²¹¹ v2.1.273 では2つの抜け穴が塞がれました。チェッカーが完全には解析できない Bash コマンドについて、チェックを省略せず確認を求めるようになりました。また、この設定が有効な場合、リポジトリの設定で指定されたメモリディレクトリは、読み込み、呼び出し、インデックス作成の対象になりません。²¹⁷
• managedMcpServers / managedSourcesBehavior： 管理対象スコープのキーで、Enterprise Deployment で解説しています。組織がすべてのユーザーに MCP サーバーを提供するための設定（v2.1.259）と、管理対象ソース間で明示的に有効化するマージ機能（v2.1.257 で改良）です。²¹¹²²¹

新しい設定（v2.1.261）：

• bashOutputMaxChars / taskOutputMaxChars（v2.1.261）： コマンド出力（およびバックグラウンドタスクの出力）について、残りがファイルへ保存されるまでに Claude がインラインで受け取る文字数を、最大128K文字まで増やせます。これは、コマンドの作業出力ファイルから読み戻す範囲を設定する BASH_MAX_OUTPUT_LENGTH 環境変数（デフォルトは30,000文字、上限は150,000文字）とは別の仕組みです。これらのキーが制御するのは、インライン表示と永続化ファイルへの保存を切り替えるしきい値です。しきい値を超えた出力は切り捨てられず、必要に応じて Claude が読み取れるファイルに保存されます。²¹⁴ v2.1.265 以降は、永続化される側にも上限があります。ディスクに保存されるツールの結果は 1 GB が上限で、保存ファイルが切り詰められた場合は会話内のプレビューにその旨が表示されます。²¹⁵

新しい設定（v2.1.267-269）：

• maxEffortLevel（v2.1.267）： ユーザーが選択できる effort level の上限を、トップレベルまたは modelSettings 内のモデル単位で設定します。Bedrock、Vertex、Foundry を含むすべてのプロバイダーに適用されます。上限未満のレベルは引き続き選択できます。これは /effort に対応する管理者側の設定です。²¹⁶
• bashEditDiffEnabled（v2.1.269）： Bash ツールがファイルを編集した際、コマンドによって変更されたファイルの diff がツールの結果に含まれます。これにより、sed のような編集コマンドが実際に行った変更を会話上で確認できます。²¹⁶

設定の早見表：よく検索されるフラグ

特定の設定名を探してここへ来た場合は、以下の早見表をご利用ください。各項目には導入されたリリースと、該当する場合はその設定を所有するスコープを記載しています。

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers; credential/org/routing/API-behavior headers set from managed or project settings require approval (v2.1.251)[^238]

モデル設定：

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_MODEL=claude-opus-5           # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5      # What the `opus` alias resolves to (Opus 5 since v2.1.219)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Default model for subagents; an agent's model: field and per-spawn picks win (v2.1.251 demoted it from override to default)[^238]
CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1              # Force every subagent onto CLAUDE_CODE_SUBAGENT_MODEL (or the main model), ignoring agent-definition and per-spawn overrides -- the pre-v2.1.251 behavior, opt-in (v2.1.257)[^243]
CLAUDE_CODE_WORKFLOWS=1                         # Enable Workflow tool for deterministic multi-agent orchestration (v2.1.147+)
MAX_THINKING_TOKENS=10000                       # (Opus 4.6 and Sonnet 4.6 only — removed in Opus 4.7)
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

クラウドプロバイダーの設定：

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1    # Opt in gateway /v1/models discovery for /model picker (v2.1.129+)[^164]
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS=3000  # Extend the LLM gateway /v1/models discovery timeout (default 3s; v2.1.269+)[^252]
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1              # Send five x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted) for LLM gateways (opt-in; v2.1.273+)[^253]
CLAUDE_CODE_AUTO_MODE_SERVER=1                  # Use the platform's server-side auto-mode classifier on Bedrock/Vertex/Foundry; since v2.1.273 the local classifier is the default there "for now"[^253]

動作の制御：

DISABLE_AUTOUPDATER=1                           # Prevent automatic background updates
DISABLE_UPDATES=1                               # Block ALL update paths including manual `claude update` (v2.1.118+, stricter than DISABLE_AUTOUPDATER)[^160]
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1       # Homebrew/WinGet installs run package-manager upgrade in background, then prompt restart (v2.1.129+)[^164]
DISABLE_TELEMETRY=1                             # Opt out of usage telemetry
DISABLE_ERROR_REPORTING=1                       # Disable Sentry
DISABLE_BUG_COMMAND=1                           # Disable /bug command
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
DISABLE_COST_WARNINGS=1                         # Hide cost warnings
DISABLE_PROMPT_CACHING=1                        # Disable prompt caching globally
DISABLE_PROMPT_CACHING_SONNET=1                 # Disable for Sonnet only
DISABLE_PROMPT_CACHING_OPUS=1                   # Disable for Opus only
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1             # Skip non-critical API calls
ENABLE_PROMPT_CACHING_1H=1                      # Opt into 1-hour prompt cache TTL (v2.1.108+, API/Bedrock/Vertex/Foundry)
ENABLE_PROMPT_CACHING_1H_BEDROCK=1              # Deprecated alias for the above; v2.1.108+ still honors it on Bedrock but logs a deprecation notice
FORCE_PROMPT_CACHING_5M=1                       # Force 5-minute cache TTL (v2.1.108+)
CLAUDE_CODE_PROMPT_CACHE_TTL=1h                 # Main-conversation cache TTL, 5m or 1h; beats the promptCacheTtl setting (v2.1.242+)[^234]
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=5m        # TTL for subagents, workflows, forks, compaction, titles; beats subagentPromptCacheTtl (v2.1.242+)[^234]
ENABLE_TOOL_SEARCH=true                         # Re-enable tool search on Vertex AI (disabled by default v2.1.119+ to avoid unsupported beta header). Valid values: true, false, auto, auto:N[^160]
CLAUDE_CODE_HIDE_CWD=1                          # Hide the working directory in the startup logo (v2.1.119+)[^160]
CLAUDE_CODE_FORK_SUBAGENT=1                     # Enable forked subagents on external builds (v2.1.117+)[^160]
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                 # Force synchronized terminal output when auto-detection misses it, such as Emacs eat (v2.1.129+)[^164]
CLAUDE_CODE_SESSION_ID=...                      # Read-only: present in the Bash tool subprocess; matches the session_id passed to hooks (v2.1.132+)[^168]
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1          # Skip the fullscreen alternate-screen renderer; keep the conversation in the terminal's native scrollback (v2.1.132+)[^168]
CLAUDE_EFFORT=...                               # Read-only: current effort level inside hooks and Bash tool subprocess (v2.1.133+)[^169]
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1             # Include subagent text + thinking in stream-json output; pairs with --forward-subagent-text (v2.1.211+). Covers depth-2+ nested subagents as of v2.1.219[^205][^213]
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200    # Per-session WebSearch cap (default 200; v2.1.212+)[^206]
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=900000        # WebFetch per-URL session cache TTL (default 15 min; v2.1.233+)[^226]
CLAUDE_CODE_WEBFETCH_DEADLINE_MS=300000         # WebFetch hard deadline: a server that never finishes its response fails the fetch after 300s by default; 0 disables (v2.1.268+)[^252]
CLAUDE_CODE_PROJECT_DIR_NAME=myproj             # Short name for the per-project transcript directory, for hosts that give each session its own config dir (v2.1.234+)[^227]
CLAUDE_CODE_GOAL_CHECKIN_MINUTES=30             # How long background tasks may keep a /goal waiting before Claude checks in on them; 0 disables (v2.1.234+)[^227]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200 in v2.1.212–223; the default cap was REMOVED in v2.1.224 — set this to reimpose one)[^206][^218]
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20         # Cap on concurrently-RUNNING subagents (default 20; distinct from the per-session total above; v2.1.217+)[^211]
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0        # Disable the v2.1.229 workflow fan-out stagger (same-prefix sibling agents launch staggered so they read the cached prompt prefix instead of re-paying it)[^224]
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=64   # Raise the Workflow tool's per-run concurrent agent limit, 1-256, for inference-bound fan-outs (v2.1.269+)[^252]
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3          # Nested subagent spawn depth. Default 3 as of v2.1.219; set 1 to disable nesting. Default history: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219). Set it explicitly[^211][^213]

ツールの設定：

BASH_DEFAULT_TIMEOUT_MS=30000                   # Bash command timeout (30s)
BASH_MAX_TIMEOUT_MS=600000                      # Maximum bash timeout (10min)
BASH_MAX_OUTPUT_LENGTH=50000                    # Read-back window from the Bash working output file (default 30,000 chars, hard ceiling 150,000)
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1     # Reset CWD after each bash
MCP_TIMEOUT=5000                                # MCP server startup timeout
MCP_TOOL_TIMEOUT=30000                          # MCP tool execution timeout
MAX_MCP_OUTPUT_TOKENS=25000                     # MCP output limit
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=120000       # Threshold before a long MCP tool call moves to the background (default 2 min; v2.1.212+)[^206]
CLAUDE_CODE_TOOL_MEMORY_LIMIT=4096              # Opt-in Linux memory cgroup (MB) for Bash tool commands — a runaway build can't stall the session (v2.1.233+)[^226]
CLAUDE_CODE_ENABLE_TODO_TOOLS=1                 # Offer the TodoWrite/TaskCreate-family tools on models outside v2.1.268's allowlist (Claude 3.x, Opus 4.0-4.7, Sonnet 4.0-4.6, Haiku 4.5); elsewhere they are off unless set (first turned off on newer models in v2.1.233)[^226][^252]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

ネットワークとプロキシ：

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
NO_PROXY=localhost,example.com                  # Bypass proxy for domains
CLAUDE_CODE_CLIENT_CERT=/path/to/cert           # mTLS certificate
CLAUDE_CODE_CLIENT_KEY=/path/to/key             # mTLS private key
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE=pass          # mTLS passphrase

UI とターミナル：

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory; not settable from project-settings env (v2.1.251)[^238]
IS_DEMO=1                                       # Hide sensitive UI elements[^37]
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1          # Disable background tasks and Ctrl+B[^46]
CLAUDE_CODE_TMPDIR=/path/to/tmp                 # Override temp directory; not settable from project-settings env, nor are TMPDIR/TMP/TEMP (v2.1.251)[^50][^238]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Hold ALL native-1M models to 200K via auto-compaction (v2.1.223 widened scope)[^103][^217]
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1  # Let unrecognized model IDs exceed the assumed context window (v2.1.223)[^217]
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=120000       # Plugin marketplace git timeout (default 120s, was 30s)[^105]
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1        # Remove built-in commit/PR instructions[^117]
CLAUDE_CODE_DISABLE_CRON=1                    # Stop scheduled cron jobs mid-session[^121]
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000 # SessionEnd hooks timeout (default varies)[^123]
CLAUDE_CODE_USE_POWERSHELL_TOOL=1             # Enable Windows PowerShell tool on Linux/macOS (requires pwsh on PATH; v2.1.111+)[^153]
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1           # Disable mouse click/drag/hover in fullscreen mode; wheel scroll still works (v2.1.195+)[^196]
CLAUDE_ENABLE_STREAM_WATCHDOG=0              # Disable the streaming idle watchdog (on by default for all providers since v2.1.196: aborts+retries after 5 min of silence)[^198]
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 # Turn off automatic memory-pressure reaping of idle background shell commands (v2.1.193+)[^196]
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1             # Force Session Recap when telemetry disabled (v2.1.108+)[^153]
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0         # Restore pre-v2.1.269 behavior: remote/headless sessions may report "waiting for your input" while background agents still run[^252]
CLAUDE_AX_SCREEN_READER=1                     # Enable screen reader mode; same as --ax-screen-reader or "axScreenReader": true (v2.1.208+)[^203]
OTEL_LOG_RAW_API_BODIES=1                     # Emit full API request/response bodies as OTel log events (v2.1.111+)[^153]
TRACEPARENT=00-...                            # W3C Trace Context parent (v2.1.110+, SDK/headless)[^153]
TRACESTATE=vendor=value                       # W3C Trace Context state (v2.1.110+, SDK/headless)[^153]

OpenTelemetry エクスポーターと機密フィールドの制御：²⁴⁵

OTEL_LOGS_EXPORTER=none                       # OTel logs exporter (supports 'none' for disable; v2.1.85 fixed crash)
OTEL_METRICS_EXPORTER=none                    # OTel metrics exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_TRACES_EXPORTER=none                     # OTel traces exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_LOG_TOOL_CONTENT=1                       # Opt in to emitting tool content in OTel spans (v2.1.101+, sensitive by default)
OTEL_LOG_TOOL_DETAILS=1                       # Opt in to tool_parameters in OTel tool_result events (v2.1.85+); as of v2.1.273 also puts real agent, skill, plugin, and MCP server names on cost and token metrics[^253]
OTEL_LOG_USER_PROMPTS=1                       # Opt in to emitting user prompts in OTel traces (v2.1.101+, sensitive by default)
OTEL_LOG_ASSISTANT_RESPONSES=0                # Gate the claude_code.assistant_response log event holding the model's response text (v2.1.193+)
OTEL_METRICS_INCLUDE_REPOSITORY=1             # Tag OTel metrics and events with vcs.* repository attributes; with OTEL_LOG_TOOL_DETAILS, commit events carry vcs.ref.head.* (v2.1.269+)[^252]
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH=60000     # Truncation limit for OTel content attributes (default 60 KB; v2.1.214+)[^207]
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1    # Disable release-notes fetch (v2.0.17+); v2.1.110 also stopped the auto-title Haiku request in headless/SDK when set

v2.1.121 以降の LLM リクエスト span 属性： stop_reason、gen_ai.response.finish_reasons、user_system_prompt が LLM リクエスト span に出力されるようになりました。user_system_prompt には PII が含まれる可能性があるため、OTEL_LOG_USER_PROMPTS=1 を設定した場合にのみ出力されます。¹⁵⁴

v2.1.122 以降のイベントレベルの変更： api_request および api_error ログイベントの数値属性が、文字列ではなく数値として出力されるようになりました。これにより、スキーマを厳密に型付けする後段の OTel コレクターで発生していた問題が解消されます。新しい claude_code.at_mention ログイベントは、Claude Code が @ メンションを解決したときに発生します。¹⁵⁴

v2.1.193 以降の claude_code.assistant_response ログイベント： Claude Code は、モデルの完全な応答テキストを OTel ログイベントとして出力できます。出力は OTEL_LOG_ASSISTANT_RESPONSES で制御されます。この制御には、アップグレード時に知っておくべき注意点があります。OTEL_LOG_ASSISTANT_RESPONSES が未設定の場合は OTEL_LOG_USER_PROMPTS の設定に従うため、すでにプロンプト内容を記録している環境では、アップグレード後にアシスタントの応答内容も受信するようになります。テレメトリをプロンプトのみに限定するには、OTEL_LOG_ASSISTANT_RESPONSES=0 を設定してください。¹⁷⁹

v2.1.214 のテレメトリ追加機能： OTel ログイベントに、メッセージ単位の関連付けとツールの出所追跡に使用する message.uuid、client_request_id、tool_source 属性が追加されました。subagentStatusLine ペイロードには subagent の reasoning effort が含まれるため、カスタムステータス行でモデルと effort をまとめて表示できます。また、新しい環境変数 CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH では、OTel コンテンツ属性に適用される 60 KB の切り捨て上限を設定できます。¹⁹⁰

v2.1.265 のゲートウェイテレメトリ： Claude apps ゲートウェイのセッションでは、ゲートウェイの管理対象設定で OTEL_EXPORTER_OTLP_ENDPOINT にコレクターが指定されている場合、ゲートウェイのリレーを経由せず、OpenTelemetry をコレクターへ直接エクスポートするようになりました。コレクターが指定されていないセッションでは、引き続きリレーが使用されます。同じリリースでは、Claude Desktop と Cowork が Claude apps ゲートウェイ経由で送信するテレメトリに user.email と user.groups も追加され、ターミナルセッションと同等になりました。²¹⁵

API / モデル制御：²⁴⁵

CLAUDE_CODE_EXTRA_BODY='{...}'                # Inject extra body fields into API calls; v2.1.113 fixed 400 errors with output_config.effort on Vertex/subagent calls
CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000         # Override max context tokens (pre-existing var; v2.1.98 fixed handling of DISABLE_COMPACT when both are set)
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=25000 # Override default token limit for file read operations (v2.1.0+)
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
ANTHROPIC_BETAS=beta1,beta2                   # Enable beta API headers; v2.1.78 fixed silent ignore on Haiku models
ANTHROPIC_SMALL_FAST_MODEL=arn:...            # Fast model ID (Bedrock ARN supported; v0.2.125 stopped escaping slashes in ARN)

Plugins / MCP：²⁴⁵

CLAUDE_CODE_PLUGIN_CACHE_DIR=~/.claude/plugins # Plugin cache directory (v2.1.72 fixed literal '~' dir on some shells)
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 # Preserve plugin marketplace cache when git pull fails (offline-friendly; v2.1.90+)
CLAUDE_CODE_MCP_SERVER_NAME=server1           # Passed to MCP headersHelper scripts so one helper can serve multiple servers (v2.1.85+)
CLAUDE_CODE_MCP_SERVER_URL=https://...        # Passed to MCP headersHelper scripts alongside the name (v2.1.85+)

シェル / IDE：²⁴⁵

CLAUDE_CODE_SHELL_PREFIX="time "              # Wrap every Claude-invoked shell command with a prefix (v1.0.61+)
CLAUDE_CODE_GIT_BASH_PATH=C:\Program\ Files\Git\bin\bash.exe  # Custom Git Bash path on Windows (v2.1.98+)
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY=60000       # SDK: exit after N ms idle (v2.0.35+)
CLAUDE_CODE_AUTO_CONNECT_IDE=false            # Disable IDE auto-connection (v1.0.61+)

エンタープライズ / 認証：²⁴⁵

CLAUDE_CODE_PROXY_RESOLVES_HOSTS=1            # Opt into proxy-side DNS resolution (v2.0.55 moved this from default-on to opt-in)
CLAUDE_CODE_API_KEY_HELPER_TTL_MS=300000      # TTL for dynamically generated API keys via apiKeyHelper (apiKeyHelper refresh added v0.2.74 with 5-min default; env var added v0.2.117)
CLAUDE_CODE_PROCESS_WRAPPER=/path/to/wrapper  # Route all Claude Code self-spawned processes through a wrapper executable; same as the processWrapper setting (v2.1.208+)[^203]

Skill 変数（v2.1.69以降）：

${CLAUDE_SKILL_DIR}                            # Self-reference for skills to locate their own directory[^117]

SDK 呼び出し元の識別情報（v2.1.51以降）：

CLAUDE_CODE_ACCOUNT_UUID=uuid                  # Provide account UUID synchronously for SDK callers
CLAUDE_CODE_USER_EMAIL=user@example.com        # Provide user email for SDK callers
CLAUDE_CODE_ORGANIZATION_UUID=uuid             # Provide organization UUID for SDK callers

デバッグ：

ANTHROPIC_LOG=debug                             # Enable API request logging

どのモデルを選ぶべきですか？

タスクごとに適切なモデルを選ぶことで、コストと品質の両方が大きく変わります。Claude Code では、複数のレベルでモデルを柔軟に切り替えられます。

利用可能なモデル

ハーネスをOpus 4.8からOpus 5へ移行する際の2つの破壊的変更：¹⁹⁷

1. 思考がデフォルトで有効になります。 Opus 4.8では、thinkingフィールドのないリクエストは思考を使用せずに実行されましたが、Opus 5では同じリクエストが適応型思考を使用して実行されます。max_tokensは、思考と応答テキストを合わせた出力全体の厳格な上限であることに変わりはありません。そのため、以前は思考なしで実行していたワークロードについて、余裕が十分にあるか再確認してください。以前の動作に戻すにはthinking: {type: "disabled"}を渡しますが、次の項目による制約があります。
2. 思考を無効にした場合、effortの上限はhighです。 thinking: {type: "disabled"}とxhighまたはmaxのeffortを組み合わせると、400が返されます。このチェックはリクエストごとに適用されます。同じ会話内の以前のターンが受け付けられていても、思考を無効にしたままeffortをxhighへ引き上げると拒否されます。

Claude Codeでは特に、Opus 5のeffortは（Claude APIと同様に）デフォルトでhighとなり、low、medium、high、xhigh、maxの全段階を利用できます。Anthropicの移行ガイダンスでは、トークン消費量より能力を重視する場面でmax effortをテストするよう推奨しています。Fast modeではOpus 5をMTokあたり$10/$50で利用できます（Fast Modeを参照）。¹⁹⁷¹⁹⁸

Claude Fable 5.1（2026年9月1日）： Fableティアの新たな最上位モデルであり、v2.1.257以降、fableエイリアスが解決されるモデルです（ANTHROPIC_DEFAULT_FABLE_MODELで別のモデルを固定している場合を除きます）。bestは現在、「利用可能な最新のFableモデル」を意味します。対応バージョンの下限には少し説明が必要です。モデル設定ドキュメントではエイリアスがv2.1.255で切り替わったとされ、モデルページではFable 5.1に「Claude Code v2.1.255以降が必要」と記載されています。しかし、2.1.253～256はnpmで公開されていないため、このモデルを含む最初のインストール可能なリリースはv2.1.257（9月1日）です。モデルID：claude-fable-5-1（Bedrock：anthropic.claude-fable-5-1）。ティアとトークン単価はFable 5と同じで、入力$10/MTok、出力$50/MTok、1Mコンテキスト、最大出力128K、常時有効な適応型思考、effortのデフォルトはhighです。ただし、長時間のエージェント型セッションで重要となる価格変更が1つあります。キャッシュ読み取りは$0.25/MTokで、入力価格の0.025倍（2.5%）です。標準の10%から引き下げられています。この料率が適用されるのはFable 5.1とMythos 5.1のみで、キャッシュ書き込みは標準価格（5分は$12.50、1時間は$20）のままです。信頼できる知識のカットオフ：2026年6月（トレーニングデータも2026年6月）– 現行のClaudeモデルで最も新しいものです。廃止時期は早くても2027年9月1日となります。Fable 5からの破壊的変更は3つあります。ツールの強制使用はエラーを返すようになり、以前のモデルではこのモデルの思考ブロックを読み取れず、以前のターンを編集すると思考ブロックが無効になります。追加された変更は5つです。メッセージ単位のeffort（ベータ）、ターン単位のシステムメッセージ（ベータ）、ツール呼び出し間の進捗更新（display: "updates"、ベータ）、低価格のキャッシュ読み取り、コンテンツの来歴情報です。Claude Mythos 5.1は仕様も同じ同一モデルであり、Project Glasswingを通じた招待制です。リリースに伴い、Fable 5はOpus 4.8/4.7/4.6/4.5およびSonnet 4.6/4.5とともに、ドキュメントのLegacy models表へ移動しました。リリースノートにはゲートウェイに関する注意点が1つあります。Claude appsゲートウェイのセッションでは、当面fableとbestが引き続きFable 5に解決されます。まだ5.1向けに設定されていないゲートウェイでは拒否されるため、そこで使用する場合は/modelからFable 5.1を明示的に選択してください。ただし、v2.1.260より前は/modelの選択画面にFable 5.1が表示されなかったため、明示的に選ぶには完全なコマンド/model claude-fable-5-1を入力する必要がありました（以下のリリース直後の修正を参照）。プランのデフォルトに変更はなく、プレミアムプランではOpus 5、ProおよびTeam StandardではSonnet 5です。^211218219

Fable 5.1リリース直後の修正（v2.1.260、9月3日）： リリース後最初のバージョンで、4つの問題が修正されました。Fable 5.1を利用できる組織では、/modelの選択画面に同モデルが表示されるようになりました。この修正以前は、/model claude-fable-5-1と完全に入力した場合にのみ受け付けられていました。Fable 5.1のプロンプトキャッシュでは、ツール結果の後に追加されたコンテキストも対象になりました。それまでは、ツールを呼び出す各ターンでキャッシュされていない入力として再送信されており、0.025倍というキャッシュ読み取りの経済性が、まさにその恩恵を受けるはずの長時間のエージェント型セッションでひそかに損なわれていました。セッション途中で/effortを変更しても、プロンプトキャッシュが無効にならなくなりました。また、model: fableのエージェントは、ANTHROPIC_DEFAULT_FABLE_MODELで固定したモデルの[1m]タグを尊重するようになり、200Kのコンテキストウィンドウで暗黙的に実行されることがなくなりました。²¹²

Claude Fable 5（2026年6月9日。2026年9月1日以降はLegacy）： Opusを上回る新しいモデルティアです。Anthropicで最も強力かつ高知能のモデルであり、テストされたほぼすべてのベンチマークで最先端の性能を発揮し、数百万トークンに及ぶコンテキストでも一貫性を維持できるよう設計されています。Fable 5は、一般利用向けに安全性を確保した「Mythosクラス」のフロンティアモデルです。サイバー、バイオ化学、モデル蒸留に関するクエリではOpus 4.8へフォールバックする安全分類器を搭載しています（Claude Mythos 5は同じモデルですが、認可された研究者向けにこれらの安全措置が解除されています）。v2.1.170（2026年6月9日）からClaude Codeで選択可能になりました。claude updateを実行してから、/model fableを使用します（短縮エイリアスですが、v2.1.257以降はFable 5.1に解決されます。現在Fable 5を選択するには/model claude-fable-5を使用してください）。サブスクリプションプランへの展開は2026年6月22日までに完了しました。モデルID：claude-fable-5。Fable 5はデフォルトで1Mコンテキストウィンドウを備えているため、[1m]サフィックスは不要です。さらに、v2.1.173（2026年6月11日）以降、claude-fable-5[1m]というモデル名は自動的に正規化され、claude-fable-5になります（このサフィックスが意味を持つのは、1Mを[1m]で有効化するOpus/Sonnetのみです）。最大出力は128Kです。価格は入力$10/MTok、出力$50/MTokで、Opus 4.8のおよそ2倍となります。そのため、日常的な編集ではなく、本当に難しい推論に限定して使用してください。リクエスト仕様はOpus 4.8と共通で、適応型思考のみをサポートし、temperature/top_p/top_kおよびbudget_tokensは削除されています。ただし、新たな注意点が1つあります。thinking: {type: "disabled"}を明示的に指定すると400が返されるため、思考なしで実行する場合はthinkingパラメーター自体を省略してください。²³⁸ Claude Code に限って言えば、Fable 5 は Opus 5 と同様に、すべての effort スケール（low/medium/high/xhigh/max、デフォルトは high）をサポートしています。Fable 5 では thinking をオフにできません。セッションの thinking トグル、alwaysThinkingEnabled 設定、MAX_THINKING_TOKENS=0 はいずれも効果がなく、常に適応的に推論します。fable ファミリーの設定項目は Opus の設定と対応しており、ANTHROPIC_DEFAULT_FABLE_MODEL では fable エイリアスが解決されるモデルを固定でき（Bedrock/Vertex/Foundry で有用です）、DISABLE_PROMPT_CACHING_FABLE では Fable をプロンプトキャッシュの対象外にできます。また、エンタープライズゲートウェイでは、コンテンツに基づく自動フォールバックが適用されます。/model opus で Opus 5 が選択されるようになりました（デフォルトは high effort、特に難しいタスクでは /effort xhigh）。初期状態のデフォルトモデルはプランに応じて決まり、プレミアムプランでは Opus 5、Pro/Team Standard では Sonnet 5 です。最高性能が必要な場合は、/model fable で Fable ティアを明示的に選択してください。v2.1.257 時点では Fable 5.1 です。^238197207219

Opus 4.7（2026年4月16日）： 前世代のフラッグシップモデルで、現在も引き続き利用できます。コンテキストウィンドウは 1M トークンで、料金は標準価格です。長いコンテキストに対する追加料金はありません。最大出力は 128K で、adaptive thinking のみに対応し（extended thinking は廃止）、新たに xhigh effort レベルが追加されました。コーディングやエージェント型ワークロードでは、xhigh から始めることが推奨されています。¹⁴⁵ 信頼できる知識のカットオフは2026年1月、学習データのカットオフも2026年1月です。モデル ID は claude-opus-4-7。料金は Opus 4.6 と同じく、入力が MTok あたり $5、出力が $25、5分間のキャッシュ書き込みが $6.25、1時間のキャッシュ書き込みが $10、キャッシュ読み取りが $0.50 です。¹⁴⁴ Opus 4.7 は SWE-Bench で Opus 4.6 の3倍の本番タスクを解決し、CursorBench では 70%（4.6 は 58%）を記録しました。また、Anthropic が実施した93タスクの社内コーディングベンチマークでは、解決率が 13% 向上しています。¹⁴⁴ 新しい tokenizer を使用しているため、同じテキストでもトークン数はおよそ 1～1.35倍になると見込まれます。max_tokens の余裕と compaction のトリガーを引き上げてください。¹⁴⁵ Vision は最大 2,576 px／3.75 MP の画像に対応し、1:1 のピクセル座標を使用できます。¹⁴⁵

Opus 4.7 のコーディングベンチマーク（2026年4月）：¹⁵¹

プラン別のデフォルトモデル（Claude Code）：²⁰⁷

Opus 4.7 における Messages API の破壊的変更（呼び出し元に影響）：¹⁴⁵

• Extended thinking の budget_tokens は廃止されました。代わりに thinking: {type: "adaptive"} を使用してください。Adaptive thinking はデフォルトでオフになっており、thinking フィールドのないリクエストは thinking なしで実行されます。
• temperature、top_p、top_k のいずれかをデフォルト以外の値に設定すると、HTTP 400 が返されます。これらのパラメーターは省略し、プロンプトを通じてモデルの動作を調整してください。
• Thinking の内容は、デフォルトではレスポンスから省略されます。表示可能な推論を復元するには、thinking.display: "summarized" を設定してください（製品で thinking をユーザーにストリーミングする場合は必須です）。

Task budgets（beta header は task-budgets-2026-03-13）を使うと、output_config.task_budget を通じて、エージェント型ループ全体の目標トークン数をモデルに提示できます。最小値は 20K トークンです。¹⁴⁵

Opus 4.6（legacy）： claude-opus-4-6 で引き続き利用でき、1M のコンテキストと最大 128K の出力に対応しています。エージェント型コーディングの性能を高めるには、Opus 4.7 への移行を検討してください。Opus 4.6 は当初、2026年2月5日にリリースされました。⁷⁹¹⁴⁴ v2.1.117（2026年4月22日）以降、Pro および Max のサブスクライバーでは、Opus 4.6 と Sonnet 4.6 のデフォルトが high effort になりました（以前は medium）。Opus 4.7 は引き続き xhigh です。この変更により、4月23日の事後検証で記録された3月4日から4月7日までの effort 引き下げ後、知能レベルが回復しました。¹⁵²¹⁵³

Sonnet 5（2026年6月30日）： 現行の Sonnet ティアで、「速度と知能の最良の組み合わせ」と位置付けられています。Anthropic によれば、その性能は低価格ながら Opus 4.8 に近く、エージェント型推論、ツールの使用、コーディング、知識労働の各分野で Sonnet 4.6 から大幅に向上しています。一方で、望ましくない挙動の全体的な発生率が低く、サイバーセキュリティ能力は Opus モデルより大幅に弱くなっています。この安全性上のトレードオフにより、輸出規制によるブロックなしでリリースできました。モデル ID は claude-sonnet-5（日付なしの固定スナップショット）。コンテキストウィンドウは 1M トークン、最大出力は 128K で、output-300k-2026-03-24 beta header を指定した Batches API では最大 300K です。Adaptive thinking のみに対応しています。信頼できる知識のカットオフは2026年1月です。料金は入力／出力が MTok あたり $2／$10 で、現在は標準の定価となっています。 Anthropic はリリース時に、2026年8月31日までの導入価格として $2／$10 を発表しましたが、その後も価格を維持しました。料金ページには、予定されていた9月1日の $3／$15 への値上げは「実施されない」と記載されています。また、v2.1.243 では /model の選択画面と同梱の claude-api skill が更新され、$2／$10 は期間限定のプロモーションではなく定価として表示されるようになりました。²²⁸ これは Opus 5 の $5／$25 より 60% 安い価格です。Claude Code では、Sonnet 5 の effort パラメーターはデフォルトで high です（変更する場合は明示的に設定してください）。/model sonnet（または /model claude-sonnet-5）で選択できます。¹⁸⁰ v2.1.197（2026年6月30日）では、新しいセッションにおける Claude Code のデフォルトモデルが Sonnet 5 になりました。現在も標準ティア（Pro、Team Standard）では Sonnet 5 がデフォルトですが、プレミアムプランと Anthropic API では Opus 5 がデフォルトです。上記のプラン表をご覧ください。¹⁸¹²⁰⁷

Sonnet 4.6（2026年2月17日、現在は Sonnet 5 に置き換え済み）： バランス型モデルで、claude.ai と Claude Cowork のデフォルトだった Sonnet 4.5 を置き換えました。⁹³ 料金は Sonnet 4.5 と同じく、MTok あたり $3／$15 です。消費トークン数を抑えながら、エージェント型検索の性能を向上させました。Extended thinking、adaptive thinking、1M トークンのコンテキストウィンドウ（beta）に対応しています。最大出力は 64K（v2.1.77 では上限 128K）です。¹¹⁹ 知識のカットオフは2025年8月（信頼できる範囲）、学習データは2026年1月です。モデル ID は claude-sonnet-4-6。

Claude Mythos Preview（2026年4月7日）： Project Glasswing の一環として提供される、防御的サイバーセキュリティ作業向けの研究プレビュー版フロンティアモデルです。¹³⁹ 招待制であり、一般には利用できません。Anthropic は、安全性とのトレードオフとして、Opus 4.7 のサイバー分野の能力を意図的に Mythos より低くしていると説明しています。また、高度なアクセスを必要とする正当なセキュリティ研究者向けに、https://claude.com/form/cyber-use-case で Cyber Verification Program を開始しています。¹⁴⁶

こうした料金差が重要な理由： 一般的なコーディングセッションでは、入力トークンを 50K～200K、出力トークンを 10K～50K 消費します。Haiku なら、セッションあたり $0.10～$0.45 です。同じセッションでも Opus では $0.50～$2.25 となり、5倍の費用がかかります。Opus は、本当に難しい問題のために取っておきましょう。¹

各モデルを使い分ける場面

Haiku：探索、単純なファイル検索、すぐに答えられる質問を担当する subagents に使用します。Opus より約5倍安く、レスポンスも高速です。深い推論を必要としないバックグラウンドタスクに最適です。 Sonnet：コストを重視する日常的な開発の主力であり、標準ティア、Pro、Team Standardのデフォルトモデルです（ネイティブの1Mコンテキスト、標準定価はMTokあたり$2/$10。予定されていた9月1日の値上げは撤回されました）。^181228207 機能の実装、バグ修正、テストの作成、コードレビューなど、ほとんどのコーディングタスクに対応できます。履歴：v2.1.197（2026年6月30日）は、Sonnet 5がすべてのティアでデフォルトになったと長らく報告されており、本ガイドにもそのように記載されていました。しかし、モデル設定ドキュメントのプラン別の説明では、premium/APIのデフォルトはv2.1.154以降でOpus 4.8、v2.1.219以降でOpus 5となっているため、「すべてのティア」が実際に指していたのは標準ティアです。Sonnet 4.6は2026年6月までSonnetの役割を担っていました。^93147207 トークン単価を抑えたい場合、レイテンシを短縮したい場合、またはsubagentsのコスト効率を重視する場合は、Sonnetを使用してください。

Opus：高度な推論向けのティアです。v2.1.219以降、opusエイリアスはClaude Opus 5を選択します（MTokあたり$5/$25、1Mコンテキスト、effortのデフォルトはhigh）。¹⁹⁷ 以下の段落は、2026年4月16日のリリース時点におけるOpus 4.7の説明であり、履歴として残しています。¹⁴⁴¹⁴⁷ 高コストな推論は、アーキテクチャ上の意思決定、難しいデバッグ、複雑なシステムの理解、セキュリティ分析、長期的な自律作業など、効果を見込める場面に絞って使用しましょう。Opus 4.7は、Opus 4.6と比べてSWE-Benchの本番タスクを3倍多く解決し、CursorBenchでは70%（従来は58%）を記録したほか、93件のタスクからなる社内コーディングベンチマークでは解決率が13%向上しています。¹⁴⁴ Claude Codeでは、Opus 4.7のeffortはデフォルトでxhighとなり、/effortで調整できます（v2.1.111以降）。¹⁴⁶¹⁴⁷ Auto Modeは、Anthropic APIを利用するMaxサブスクライバーでOpus 4.7に使用でき、--enable-auto-modeは不要です。その他のプランやプロバイダーでは、プラン固有の条件や管理者による制御に応じて利用できます。¹⁴⁶ 標準料金で1Mコンテキストを利用でき、長大なコンテキストに対する追加料金はありません。把握しておきたい動作変更： Opus 4.7は指示をより文字どおりに解釈し、タスクの複雑さに応じて応答の長さを調整します。また、デフォルトで実行するsubagentsの数が減り、同意や共感を前面に出す表現を抑えた、より直接的な口調になっています。途中経過の報告や再確認の動作を強制するための足場をプロンプトに含めている場合は、削除して試してみてください。¹⁴⁵

Opusplan：推論品質が最も重要な計画にはOpusを、速度が重要な実行にはSonnetを使うハイブリッドモードです。最良の計画は必要でも、個々の編集すべてにOpusレベルの推論を必要としない複雑なリファクタリングに適しています。

モデルの切り替え

セッション中：

> /model opus
> /model sonnet
> /model haiku

起動時：

claude --model opus

環境変数経由：

export ANTHROPIC_MODEL=opus

settings.json内：

{
  "model": "claude-sonnet-5"
}

モデル選択画面自体をカスタマイズする（modelPicker、v2.1.242以降）： 組み込みのラインナップだけをメニューとして使う代わりに、ユーザー設定ファイルまたは管理対象の設定ファイルで、/modelに表示するモデルを任意の順序とラベルで指定できます。各行にはmodel（VertexやBedrockのIDを含め、--modelで受け付ける任意の表記）を指定し、必要に応じてlabelとdescriptionも追加します。replaceBuiltInOptionsをtrueに設定すると、その行に加えてDefaultとセッションの現在のモデルだけが表示されます。このキーではプロジェクト設定とローカル設定は無視され、availableModelsの許可リストによる行の絞り込みも引き続き適用されます。Claude Codeは提供できない行を除外し、まだ選択できない行は理由とともにグレー表示します。有効な行が1つも残らない場合は、組み込みのラインナップにフォールバックします。²²⁷²²⁵

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

subagents専用：

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

v2.1.251以降、CLAUDE_CODE_SUBAGENT_MODELはすべてを上書きするのではなく、subagentのデフォルトモデルを設定します。エージェント定義のmodel:と、生成時に明示的に指定したモデルが優先されます。²⁰⁶ v2.1.257以降、CLAUDE_CODE_SUBAGENT_MODEL_FORCEを使うと、オプトインで以前の動作に戻せます。これはCLAUDE_CODE_SUBAGENT_MODEL（未設定の場合はメイン会話のモデル）をすべてのsubagentに適用し、生成時の選択とエージェント定義のmodel:を無視します。²¹¹

フォールバックモデルチェーン（v2.1.166以降）： fallbackModel設定では、プライマリモデルが過負荷または利用不能な場合に順番に試すフォールバックモデルを、最大3つまで設定できます。以前はセッション中の切り替えにしか使えなかった--fallback-modelフラグも、起動時からインタラクティブセッションに適用されるようになりました。²⁴⁰

{
  "model": "claude-opus-4-8",
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

APIから再試行不可の予期しないエラーが返された場合、Claude Codeは失敗を表示する前に、フォールバックモデルでそのターンを1度再試行するようになりました。これにより、プライマリモデルの一時的な問題が発生しても、ターンを失うことなく段階的に対処できます。²⁴⁰

v2.1.178以降、コンパクションでもフォールバックチェーンが適用されます。コンパクション中にプライマリモデルが過負荷または利用不能になった場合、ターンを失敗させるのではなく、設定済みのfallbackModel/--fallback-modelチェーンへフォールバックします。長時間の自律実行では、通常なら復旧可能なコンパクションが一時的なモデルエラーによってセッションを失わせる問題が解消されます。¹⁷³

拡張コンテキスト

大規模なコードベースや長時間のセッションでは、1Mトークンのコンテキストを有効にします。

claude --model sonnet[1m]
claude --model opus[1m]           # Opus 4.7 with 1M context

または、セッション内で次を実行します。

> /model sonnet[1m]
> /model opus[1m]

Opus 4.7、Opus 4.6、Sonnet 4.6はいずれも、標準料金で完全な1Mトークンのコンテキストウィンドウを利用でき、長大なコンテキストに対する追加料金はありません。¹⁴⁸ 900Kトークンのリクエストにも、9Kトークンのリクエストと同じトークン単価が適用されます。プロンプトキャッシュとバッチ処理の割引も、コンテキストウィンドウ全体に標準料金で適用されます。

Max、Team、Enterpriseのサブスクリプションでは、1MコンテキストのOpusが自動的に含まれるため、[1m]サフィックスは不要です（v2.1.75、2026年3月13日以降、デフォルトで有効）。¹¹⁷¹⁴⁷ Proでは、追加使用量を通じて1Mコンテキストを利用できます。APIおよび従量課金制のユーザーは、標準のトークン単価で完全な1Mコンテキストを利用できます。¹⁴⁷

モデル選択画面で1Mコンテキストのバリアントを無効にするには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1を設定します。v2.1.223以降、この変数の適用範囲が変わりました。既知のバリアントを固定リストで制限するだけでなく、ネイティブの1Mウィンドウを持つすべてのモデルを自動コンパクションによって200Kに制限します。また、自動コンパクションが実際にはセッションを200K以内に維持できていない場合、起動時に警告が表示されます。特定のモデルファミリーでコストを予測しやすくするためにこの変数を設定している場合、新しい1Mモデルがリリースされた当日から自動的に制限され、知らないうちに適用対象から外れることはありません。同じリリースでは、認識されていないモデルIDのセッションについても、想定されるコンテキストウィンドウを超えて拡大させず、自動コンパクションで範囲内に維持するようになりました。実際にはより大きなウィンドウを持つカスタムIDを登録するゲートウェイでは、CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1を設定すると以前の動作に戻せます。²⁰⁰

v2.1.247以降、Sonnet 5のデフォルトの自動コンパクションウィンドウは完全な1Mコンテキストになりました。1Mウィンドウを使用するセッションでは、約934Kトークンではなく約967Kトークンで自動コンパクションが実行されます。²²² v2.1.260では、上限直前の自動コンパクションが1Mティアの残りにも拡張されました。OpusとFableのセッションも1Mトークンの上限直前でコンパクションされ、非常に大きなコンテキストの復旧コンパクションが10分でタイムアウトすることもなくなりました。²¹²

v2.1.271以降、--resumeでも[1m]ウィンドウが維持されます。設定されたデフォルトモデルとはモデルファミリーが異なるセッションを再開しても、[1m]サフィックスが失われなくなりました。²¹⁶

v2.1.273では、コンテキストメーターと自動コンパクションがadvisor-toolのターンを実際のコンテキストサイズの約2倍としてカウントする問題が修正されました。この問題により、実際のウィンドウの約半分で自動コンパクションが実行されていました。²¹⁷

現在のモデルの確認

> /status

このコマンドでは、現在のモデル、アカウント情報、適用済みの設定、その他のセッション状態が表示されます。

モデル選択画面のラベル（v2.1.51以降）： /modelの選択画面では、固定バージョンに対して生のモデルIDではなく、人が読みやすいラベル（例：「Sonnet 4.6」）が表示されるようになりました。新しいバージョンが利用可能な場合は、アップグレードの案内も表示されます。⁹⁸ v2.1.219では、統合されたOpusの行が「Opus (1M context)」ではなく、単に「Opus」と表示されるよう修正されました。また、新しいリリースを示すハイライトは最新モデルの名前だけに限定され、リスト内の恣意的な範囲ではなく、実際にリリースされたものを示すようになりました。¹⁹⁶

Fast Mode（v2.1.36以降）

Fast modeでは、同じモデルのまま出力が大幅に高速化されます。より安価なモデルへ切り替わるわけではありません。セッション中に/fastで切り替えられます。⁸⁶

> /fast            # Toggle fast mode on/off

対応モデル（v2.1.219時点）： fast modeは、Claude Opus 5とClaude Opus 4.8に対応しています。v2.1.219ではOpus 4.7がfast modeの対象外となり、Sonnet、Haiku、Fableでは当初から利用できません。この機能は引き続きClaude API（Claude Managed Agentsを含む）限定のリサーチプレビューです。Amazon Bedrock、Google Cloud、Microsoft Foundry、AWS上のClaude Platformでは利用できません。アクセスは制限されているため、アカウントマネージャーに問い合わせるか、ウェイトリストに登録してください。¹⁹⁶¹⁹⁸

Remoteセッション（v2.1.271）： fast modeがClaude Code Remoteセッション（クラウドセッションとセルフホストランナー）にも対応しました。ホスト側のfast mode設定が適用されるほか、セッション内で/fastと入力することもできます。いずれも、組織でfast modeが許可されている場合に限り機能します。同じリリースでは/fast offも修正されました。組織でfast modeが無効な場合に「Fast mode unavailable」と応答するのではなく、fast modeを正しくオフにするようになっています。²¹⁶

料金（Opus 5／Opus 4.8のfast mode）：¹⁹⁸

Opus 4.7の落とし穴（v2.1.219）。 非対応モデルの挙動は一様ではありません。claude-opus-4-7にspeed: "fast"を指定したリクエストは、現在ではエラーを返します。標準速度へ暗黙的にフォールバックすることはありません。これを知っておくべき理由となる例外がOpus 4.6です。Opus 4.6はspeed: "fast"を受け付けますが、実際には標準速度で動作し、標準料金が請求され、usage.speed: "standard"と報告されます。ハーネスで4.7を固定し、fast-modeリクエストが暗黙的に通常モードへ切り替わることを前提としていた場合、現在は完全に失敗します。固定先をOpus 5または4.8へ移行してください。¹⁹⁸

fast modeが適している場面： - レイテンシがボトルネックとなる、小さな変更をすばやく反復するとき - コストより速度を重視して、テスト、ボイラープレート、反復的なコードを生成するとき - 類似したタスクのリストを順番に処理するとき

fast modeが適さない場面： - 長時間実行するエージェント型タスク（実行全体のコストが2倍になります） - バックグラウンドでのsubagents作業（出力を待っている人がいません） - 予算を重視するセッション

fast modeでは、完全な1Mコンテキストウィンドウを利用できます（v2.1.50以降）。料金は、入力トークンが200Kを超えるリクエストも含め、コンテキスト全体に一律の倍率で適用されます。長いコンテキストに対する追加料金はなく、プロンプトキャッシュとデータレジデンシーの料金倍率に重ねて適用されます。⁹⁶¹⁹⁸

運用上の注意事項。 fast modeには、標準のOpus制限とは別のレート制限があります。超過するとretry-afterを伴う429が返されます（anthropic-fast-*-tokens-*レスポンスヘッダーで残り容量を確認できます）。fastとstandardを切り替えると、プロンプトキャッシュが無効になります。速度が異なるリクエスト間ではキャッシュ済みのプレフィックスを共有しないため、セッション途中で/fastを切り替えるとキャッシュミスが発生します。fast modeはBatch APIやPriority Tierコミットメントでは利用できません。¹⁹⁸

エキスパート向けのヒント： fast modeはopusplanと併用できません（opusplanはすでにOpusとSonnetを組み合わせており、fast modeが影響するのはOpus側だけです）。コストよりレイテンシを重視する場合に使用し、自律処理やバッチ処理では無効にしてください。/fastには追加使用枠が必要です。Team／Enterpriseの管理者は、最初に有効化する必要がある場合があります（v2.1.37で修正）。完全に無効化するにはCLAUDE_CODE_DISABLE_FAST_MODE=1を指定します。v2.1.218以降、/config model=<x>またはRemote Controlによるモデル切り替えでfast-modeの状態が変化すると、Claude Codeが通知するようになりました。またv2.1.219では、切り替え、再接続、組織チェックの失敗後もRemote Controlクライアントに古いfast-modeの状態が残る問題が修正されています。^86149195196

Effort Control（v2.1.111以降、Opus 4.7）

Opus 4.7では、速度と知能のバランスを調整する新しいeffortダイヤルが導入されました。セッション中に/effortを使用します。

> /effort              # opens an interactive slider (arrow keys + Enter)
> /effort xhigh        # set directly

モデルごとに保存（v2.1.251以降）： /effortでは、モデルごとにデフォルトのeffortレベルが保存されるようになりました。モデルを切り替えても、それぞれ固有の設定が維持されます。Opusでxhighを常用していても、その設定がHaikuに引き継がれることはありません（CHANGELOG：「/effortでデフォルトのeffortレベルをモデルごとに保存するよう変更。モデルを切り替えても、それぞれ固有の設定が維持されます」）。maxがセッション限定である点は変わりません。²⁰⁶ v2.1.257では、両方のダイヤルがさらに改善されました。 /effortは、/modelの規則と同様に、セッション限定の選択を示すsを受け付けます。また、--effortフラグもセッションスコープになりました。新しいモデルのデフォルトeffort固定を永続的に解除するのではなく、そのセッション内でのみ解除します（CLIのリファレンスでは、デフォルトを「このセッションで上書きし、保持しない」と説明されています）。²¹¹²²⁰

MaxのAuto Mode（v2.1.111以降）

2026年8月14日時点で、Auto ModeはPro、Max、Teamプランのデフォルトの権限モードです（8月7日発表）。発表で示された調査結果、オプトアウト方法、引き続きオプトインとなるプラン／ゲートウェイについては、権限モードをご覧ください。²⁰³ 当初は--dangerously-skip-permissionsのより安全な代替機能として、Anthropic APIを通じてOpus 4.7を利用するMaxサブスクライバー向けに提供されました。¹⁴⁶ 実行前に各アクションを確認し、意図との一致と安全性をチェックする独立した分類モデルが使用されます。v2.1.210時点ではClaude Sonnet 5です。¹⁸⁷ 注意（v2.1.111以降）： --enable-auto-modeフラグは削除されました。Auto Modeでセッションを開始するには、代わりに--permission-mode autoを使用してください。Auto Modeの提供期間の大半においてProは対象外でしたが、8月14日のデフォルト化によってこの制限は終了します。Bedrock／Vertex／Foundry（v2.1.158以降）： これらのゲートウェイでは、CLAUDE_CODE_ENABLE_AUTO_MODE=1を指定することで、Opus 4.7とOpus 4.8のAuto Modeをオプトインで利用できるようになりました。²⁴³ v2.1.207以降、このオプトインは不要です。 AWS Bedrock、Google Vertex AI、Microsoft Foundryでは、CLAUDE_CODE_ENABLE_AUTO_MODEなしでAuto Modeが機能します。無効化したい管理者は、disableAutoMode管理設定を使用します。同じリリースでは、Bedrock、Vertex AI、AWS上のClaude PlatformのデフォルトモデルがClaude Opus 4.8になりました。また、リポジトリの.claude/settings.local.jsonからautoMode設定を読み込まなくなったため、auto-modeルールは代わりに~/.claude/settings.jsonで設定してください。¹⁸⁵ v2.1.247以降、Bashの権限プロンプトにはauto modeを案内するヒントが表示され、キーを1回押すだけで選択できる「Yes, and switch to auto mode」オプションが追加されました。²²² v2.1.273以降、Bedrock、Vertex AI、Foundryのauto modeでは、「当面の間」ローカル分類器がデフォルトで使用されます。プラットフォーム側のサーバー分類器を使用するには、CLAUDE_CODE_AUTO_MODE_SERVER=1を設定してください。これは、v2.1.236の分類器のデフォルトに関する注記とは異なる軸での状態変更です。ローカルかサーバー側かという仕組みの違いは、それ以前のリリースでは明示されていませんでした。²¹⁷ Auto Modeではないもの：セキュリティ境界。 以下で説明する対策の大半は分類器を強化するものですが、分類器はサンドボックスではありません。2026年8月26日、プロンプトインジェクション研究者のJohann Rehbergerは、auto modeのClaude Code Opus 5に対して機能する攻撃チェーンを公開しました。少数のサンプルでは攻撃成功率が60〜80%だったと報告しています。隔離されたpython3子プロセスを起動する主要チェーンでは5回中3回、ペイロードがヘッドレスのclaude -pインスタンスを起動する亜種の2つの構成では、それぞれ5回中3回と5回中4回成功しました。ただし本人も、これは少数のサンプルに基づく結果であり、普遍的な攻撃成功率を測定したものではないと断っています。²¹⁰ このチェーンは、個々の手順だけを見ればどれも妥当に見えるため、理解しておく価値があります。サーバーがWebFetchにHTTP 415を返すため、エージェントはcurlにフォールバックします。ダウンロードしたアーカイブはスクラッチディレクトリに展開され、そこにはマニフェスト、Base85/zlibでエンコードされた7件のデータレコード、ネイティブバイナリ、struct.pyが含まれています。Claudeは信頼できないバイナリの実行を拒否し、代わりに自らPythonデコーダーを作成して、そのディレクトリ内から実行します。デコーダーがbase64をインポートし、base64がstructをインポートすると、Pythonは攻撃者のstruct.pyを先に解決します。この一連の流れには、明らかに悪意のある指示はありません。インジェクションで必要なのは、侵害された経路をタスク完了のための最も妥当な方法に見せることだけです。Rehbergerによると、Claudeが侵害に気づいてマルウェアのプロセスを終了しようとしたケースも数回ありましたが、auto modeがクリーンアップコマンドを拒否しました。²¹⁰ 彼はこの発見を、Anthropicが宣伝してきた数値と対比しています。委託を受けた第三者評価では、Opus 5のauto modeについて、72のシナリオを各10回実行した結果、プロンプトインジェクションの攻撃成功率は0.00%だったと報告されています。彼のチェーンはその評価対象に含まれていませんでした。したがって、ベンチマーク結果が0.00%であることと、実際に動作するコード実行チェーンが存在することは同時に成り立ちますが、彼はこの2つのメッセージを両立しないものと捉えています。²¹⁰ 分類にも注目してください。Simon Willisonは8月30日の更新で、これは典型的なプロンプトインジェクションではないという読者の指摘に同意しています。モデルが攻撃者の指示を読み、それに従ったわけではなく、混乱した環境を利用する攻撃だからです。²¹⁰

Anthropicは、この報告をInformative（設計どおりの動作）としてクローズしました。Rehbergerが回答として伝えている見解こそ、設計時の前提とすべきものです。auto modeはセキュリティを保証するものではなく、ベストエフォートの分類器です。個別には無害な手順を組み合わせた意図的なインジェクションチェーンは、分類器が検出すべき範囲の外にあり、実際の封じ込め境界はOSレベルの隔離とネットワーク送信制御です。²¹⁰ これは以下の強化策と矛盾するものではなく、それらを正しく捉えるための枠組みです。auto modeは、応答しなければならないプロンプトの数を減らし、文書化された破壊的操作の一覧をブロックします。しかし、信頼できない入力を扱うセッションを安全にするものではありません。取得したページ、ダウンロードしたアーカイブ、issueのテキスト、サードパーティーのMCPサーバーなど、攻撃者の影響を受けたコンテンツにセッションが触れる場合、被害を実際に制限するのはモデルの外側にある対策です。具体的には、コンテナまたはVM、制限されたネットワーク送信、エージェントが実際に行う操作の監視、そして失いたくないSSHキーやクラウド認証情報を保存しないホームディレクトリです。auto modeによる承認は、その操作が安全だったことの証拠にはなりません。

デフォルトを維持したままカスタムルールを追加する（v2.1.118以降）。 以前のバージョンでは、autoMode.allow、autoMode.soft_deny、autoMode.environmentは二者択一でした。独自のリストを定義すると、組み込みの安全ルールが失われていました。$defaultsセンチネルはこの問題を解決します。配置した位置で組み込みリストへインライン展開されるため、その前後にカスタムルールを重ねられます。¹⁵²

// .claude/settings.json
{
  "autoMode": {
    "allow": [
      "Bash(npm test:*)",        // your additions, prepended
      "$defaults",                // built-in allow list inserted here
      "Bash(git push:origin/feature/*)"  // appended after
    ]
  }
}

/permissionsから分類器のルールを編集する（v2.1.246）。 /permissionsを実行し、Auto modeタブを開きます。このタブは、セッションでauto modeを利用できる場合にのみ表示されます。分類器が読み取るすべてのスコープからallow、soft_deny、hard_deny、environmentの各エントリが一覧表示され、セクションごとに組み込みルールが有効かどうかも確認できます。管理対象の設定または--settingsから取得されたエントリは読み取り専用で、変更内容はすべて~/.claude/settings.jsonに保存されます。セクションに最初のルールを追加すると、組み込みルールが引き続き有効になるように"$defaults"も挿入されます。組み込みルールはセクション単位で切り替えられますが、無効にするには、そのセクションに独自のルールが少なくとも1つ必要です。environmentは、エディター内で1つのドキュメントとして開きます。²²⁶²²⁴

「Don’t ask again」のオプトイン（v2.1.118以降）。 Auto Modeのオプトインプロンプトに「Don’t ask again」オプションが追加されました。頻繁に利用する場合は、フラグをスクリプト化しなくても説明メッセージを表示しないようにできます。¹⁵²

破壊的コマンドに対するガードレール（v2.1.183）。 auto modeでは、セッション内で明示的に依頼していない限り、一連の不可逆なコマンドがハードブロックされるようになりました。ローカル作業の破棄を依頼していない場合の破壊的なgit操作（git reset --hard、git checkout -- .、git clean -fd、git stash drop）、そのセッションでエージェントが作成したものではないコミットに対するgit commit --amend、特定のスタックを指定していない場合のインフラストラクチャ破棄（terraform destroy、pulumi destroy、cdk destroy）が対象です。これにより、作業内容を気づかないうちに失ったり、環境を破棄したりする操作について、分類器が及ぼし得る被害の範囲が狭まります。エージェントは引き続きこれらのコマンドを実行できますが、自らの判断ではなく、明示的な指示がある場合に限られます。¹⁷⁴

すべてのシェルコマンドを分類する（v2.1.193）。 デフォルトでは、auto modeの分類器は任意コード実行のパターンに一致するシェルコマンドのみを審査し、通常のコマンドは審査を省略します。新しいautoMode.classifyAllShell設定を使うと、代わりにすべてのBash/PowerShellコマンドを分類器へ送れます。シェル呼び出しを一つ残らず審査したい場合、多少のレイテンシーと引き換えに、より厳格な安全網を利用できます。同じリリースでは、トランスクリプト、拒否通知、/permissionsの最近の拒否履歴にauto modeの拒否理由も表示されるようになり、コマンドがブロックされた理由を確認できます。¹⁷⁹

さらに3つの強化ルール（v2.1.205）。 auto modeでは、セッションのトランスクリプトファイルの改ざんがブロックされるようになり、監査証跡そのものにはエージェントが触れられなくなりました。また、コンテキストから解決できない変数に対してrm -rfを実行する前に確認するため、$DIRが不明な状態でrm -rf $DIRを実行する事故を防げます。さらに、バックグラウンドタスクの通知では、人間による入力がなかったことが明示されるようになりました。これにより、トランスクリプト内に偽造された「ユーザーが承認した」という記述を、実際の承認として扱わせることはできません。¹⁸³ 3つ目は、理解しておくべきプロンプトインジェクション対策です。承認は承認チャネルを通じて行う必要があり、ハーネスはその前提を明示するようになりました。

コマンド置換でも壊滅的な操作は隠せない（v2.1.208）。 rm -rf ~のような壊滅的な削除は、$(...)、バッククォート、プロセス置換（<(...)）の中に埋め込まれていても確認プロンプトが表示されるようになりました。しかも、--dangerously-skip-permissionsおよびauto modeでもプロンプトが表示されます。破壊的なコマンドを置換構文で包んでも、安全網をすり抜けることはできません。¹⁸⁶

auto modeの状態をリセットする：claude auto-mode reset（v2.1.212）。 ターミナルからauto modeの状態をリセットする新しいサブコマンドが追加されました。確認プロンプトを省略するには--yesを渡します。¹⁸⁹

claude auto-mode reset          # Confirmation prompt
claude auto-mode reset --yes    # Skip confirmation (scripts)

ダイアログを減らしても、審査の厳格さは維持（v2.1.218）。 以前はauto modeを権限ダイアログで中断していた3つのチェック、すなわち危険なrm、バックグラウンド実行の&、不審なWindowsパスが、ダイアログを表示しなくなりました。代わりにauto modeの分類器が判定するため、該当するたびにユーザーを介在させることなく、安全性の審査は引き続き行われます。同じリリースでは、この仕組みがautoを使用するplan modeにも拡張されました。静的解析で読み取り専用だと証明できないBashコマンドでも確認プロンプトは表示されず、ダイアログへフォールバックする代わりに分類器が判定します。¹⁹⁵

封じ込め回避ルール（v2.1.257）。 分類器の自動承認禁止リストに「Containment Escape」ルールが追加されました。クラウドメタデータからの認証情報取得、ネットワーク送信制限の回避、テナントをまたぐアクセスは、環境で想定済みと指定されていない限り、自動承認されません。前述の注意事項が示す枠組みに沿って理解してください。これは分類器の継続的な強化、つまり文書化された拒否対象がもう1つ増えたものであり、auto modeそのものの性質が変わったわけではありません。²¹¹ 作業ディレクトリ外の読み取り時に1度だけ確認（v2.1.257）。 Auto modeでは、セッション中に初めて作業ディレクトリ外のファイルを読み取る際、確認が1度だけ表示されるようになりました。併用できるpermissions.blockReadsOutsideWorkingDirectories設定を有効にすると、確認ではなく拒否となり、このような読み取りは完全にブロックされます。²¹¹ v2.1.273では、チェッカーから見えない処理にも両方の動作が拡張されました。完全に解析できないBashコマンドでは、チェックを省略せず確認が表示されます。また、ブロック設定が有効な場合、リポジトリの設定で選択されたメモリディレクトリは、プロンプトへの読み込み、呼び出し、インデックス作成、メモリ抽出での使用が行われなくなりました。²¹⁷

ダイアグラムレンダラーのURLをアップロードとして扱う（v2.1.261）。 公開ダイアグラムレンダラーのURL自体にコンテンツを埋め込むリンク（mermaid.live形式など）は、明示的に依頼していない限り、自動承認されなくなりました。分類器はこのようなリンクをアップロードとして扱います。埋め込まれたデータはURL自体を通じて移動し、ページが開かれるとレンダラーサイト側のスクリプトから読み取れるためです。mermaid.live形式のリンクでは、ペイロードがURLフラグメントに格納され、ネットワークリクエストとともに送信されるのではなく、ブラウザからページのJavaScriptへ渡されます。前述の注意点と同じ位置づけであり、強化された分類器によって別のデータ流出経路を閉じたもので、新たな境界を設けたわけではありません。²¹⁴

インライン!シェルは分類器の対象外となり、subagentsの引き継ぎは対象に追加（v2.1.271）。 新たな拒否クラスではなく、2つの仕組みが変更されました。skillまたはスラッシュコマンド内のインライン!シェルコマンドは、分類器ではなくデフォルトモードの権限ルールに従うようになりました。どのルールでも判断されないコマンドは、レビュー対象のツール呼び出しとして実行されます。また、subagentから呼び出し元への報告には、専用の引き継ぎ呼び出しが使われるようになり、安全性分類器がその呼び出しをレビューします。従来は最後のメッセージを事後にレビューしていましたが、チェックポイントが引き継ぎ後から引き継ぎ時点へ移りました。²¹⁶

v2.1.105〜v2.1.114の新しいコマンド¹⁴⁶¹⁵⁰

プッシュ通知（v2.1.110以降）

Remote Controlで「Claudeの判断時にプッシュ」が有効に設定されている場合、Claudeは新しいプッシュ通知ツールを使用し、自らの判断でモバイルプッシュ通知を送信できるようになりました。既存のRemote Controlモバイル／Webインターフェースと組み合わせて利用します。¹⁴⁶ /context、/exit、/reload-pluginsもRemote Controlクライアントから利用できるようになりました。

Windows PowerShellツール（v2.1.111以降、段階的展開）

Claude Codeでは、WindowsネイティブのPowerShellツールを段階的に展開しています。Linux/macOSでは、CLAUDE_CODE_USE_POWERSHELL_TOOL=1を指定して有効にできます（PATHにpwshが必要です）。Windowsでは、展開期間中、同じ変数でオプトイン／オプトアウトを制御します。¹⁴⁶

権限モードでの自動承認（v2.1.119以降）。 PowerShellツールのコマンドも、Bashコマンドと同様に権限モードで自動承認を受けられるようになりました。PowerShell(Get-*:*)のような許可ルールと既存のパターン構文により、読み取り専用操作では確認を省略できます。Linux/macOSですでに利用できる操作性と同等になります。¹⁵²

権限確認の削減：読み取り専用Bash（v2.1.111以降）

glob引数を含む読み取り専用Bashパターン（例：ls *.ts、cat src/*.md）と、cd <project-dir> &&で始まるコマンドでは、権限確認が表示されなくなりました。¹⁴⁶ /less-permission-promptsと組み合わせることで、日常的なワークフローでの中断が大幅に減るでしょう。

分散トレーシング（v2.1.110以降）

SDKとヘッドレスセッションは、環境からTRACEPARENTとTRACESTATEを読み取り、Claude Codeの実行を分散トレースに関連付けるようになりました。OTEL_LOG_RAW_API_BODIES=1（v2.1.111以降）と組み合わせると、デバッグ用にAPIの完全なリクエスト／レスポンス本文をOpenTelemetryログイベントとして出力できます。¹⁴⁶

ネイティブバイナリ配布（v2.1.113以降）¹⁵⁰

v2.1.113では、CLIの起動方法が変更されました。claudeは、バンドルされたJavaScriptを実行するのではなく、プラットフォームごとのオプション依存関係を通じてネイティブのClaude Codeバイナリを起動するようになりました。インストールコマンドと更新コマンドは従来どおりで、チーム側で展開スクリプトを変更する必要はありません。

プロンプトエディターのショートカット（v2.1.113以降）¹⁵⁰

プロンプトエディターでは、複数行入力でreadline形式の移動が可能になり、フルスクリーンのビューポートスクロールにも対応しました。

Subagentの停止タイムアウト（v2.1.113以降）¹⁵⁰

ストリーム処理の途中で停止したsubagentsは、無反応のまま残るのではなく、10分後に明確なエラーを返して失敗するようになりました。ストリーミングAPIで停止したプロセスをより広く検出するには、CLAUDE_STREAM_IDLE_TIMEOUT_MS（v2.1.84以降）と組み合わせてください。

v2.1.114の安定性修正¹⁵⁰

v2.1.114（2026年4月18日）には、1件の修正が含まれています。Agent Teamsのチームメイトがツール権限を要求した際、権限ダイアログがクラッシュする場合がありました。Agent Teamsを使用している場合はアップグレードしてください。

コンテンツのマーキング：テキストウォーターマークとC2PAファイルメタデータ（2026年8月）

Anthropicは、EU AI Act第50条（新たに提供開始されるAIシステムについて、2026年8月2日から適用）の要請を受け、Claudeが生成したコンテンツに機械可読のマーキングを付与すると発表しました。この仕組みには2つの要素があります。生成テキストに埋め込まれる不可視の統計的ウォーターマークと、.svg、.png、.jpgなどの生成ファイルに付与される、C2PAオープン標準に準拠した署名付き来歴メタデータです。²²⁹²⁰⁴ 見出しだけでは分かりにくい重要な点として、どちらの要素も同じモデルの提供時期に従います。 サポートページによると、「2026年8月2日以降に提供開始されるClaudeモデルは、提供開始時から機械可読のマーキングに対応します」。一方、その日より前に提供開始されたモデル、つまり現在の全ラインナップ（Fable 5、Opus 5、Sonnet 5、Haiku 4.5）はEU法の移行期間の対象となり、Anthropicは「これらのモデルにもマーキング対応を追加すべく取り組んでいる」としています。²⁰⁴ 現在Claude Codeを通じて生成するものには、テキストにもファイルにもマーキングは付きません。将来のモデルからの出力には、Claude Platform（API）、claude.ai、Claude Code、Claude Cowork、Claude Tag、クラウドゲートウェイなど、あらゆるインターフェースでマーキングが付与されます。マーキングがモデルレベルで実装されるためです。拡散された投稿では逆に説明されていたため、補足しておく価値があります。現在のモデルで感じられるスタイルや挙動の変化が、ウォーターマークによるものであることはありません。現行モデルでは、まだ一切有効になっていないためです。

仕組みには、Google DeepMindのSynthID-Textの派生方式が使われます。Claudeが意味的に同等な単語候補から選択する際、「単語の選択に使用するランダム性の源」をウォーターマークによって変化させます。文字の追加や後処理は行われません。また、Anthropicの内部テストでは、「ウォーターマークがコンテンツ、創造性の水準、読みやすさに影響することはない」とされています。²²⁹ Claude Code ユーザーが気になる点は、コードには疎なウォーターマークが付与されることです。動作するコードでは任意に選べる余地がほとんどないため、ウォーターマークはコメントや命名など、自由度のある部分に集中します。Anthropic によれば、「実際に生成されるコードへの影響は無視できるほど小さい」とされています。²²⁹ ウォーターマークがどの程度残るかは確率的で、コンポーネントによって異なります。テキストの場合、軽微な編集では「ウォーターマークを完全には除去できない可能性が高い」一方、全面的に書き直せば除去されます。また、Claude が生成した翻訳には、新たなウォーターマークが付与されます。ファイルのメタデータについては、形式変換、再保存、スクリーンショットによってC2PA署名が失われる場合があります。²⁰⁴ 検出用の API も計画されています。陽性結果が示すのは、「ある時点でコンテンツの作成に Claude が関与した可能性が高い」ということです。「Claude がこれを書いた」のか、「Claude がこれを大幅に編集した」のかを明確に区別することはできません。また、サポートページによると、ウォーターマークが存在しない場合も、それだけでは何の証明にもなりません。どの顧客層についても、オプトアウトの提供には言及されていません。²²⁹²⁰⁴

Claude Code の料金はいくらですか？

Claude Code を継続的に利用するには、料金を把握して管理することが重要です。モデルの機能についてはモデルの選択、タスクごとに適切なモデルを選ぶ方法については意思決定フレームワークもご覧ください。

料金の確認

> /cost

出力：

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    247 lines added, 89 lines removed

サブスクリプションユーザーの場合、/cost にモデル別およびキャッシュヒット別の内訳が表示されます。どのモデルがトークンを消費し、どの程度がキャッシュから提供されたかを正確に確認できます（v2.1.92以降）。¹³⁷

定価に代わる契約料金（modelPricing、管理対象、v2.1.243以降）： モデルごとの料金や割引率を個別に契約している組織では、管理対象設定の modelPricing としてそれらをデプロイできます。これにより、/cost、ステータスライン、テレメトリの料金表示には定価ではなく契約料金が使用され、開発者が目にする金額と組織の実際の支払額が一致します。²²⁷ v2.1.271 以降では、社内チームに割増料金を課す組織向けに、倍率を1より大きく、最大10まで設定することもできます。²¹⁶

セッション単位のプロンプトキャッシュ行（v2.1.251以降）： /cost に、そのセッションのプロンプトキャッシュ情報が追加されます。ヒット率、ミス、再キャッシュされたトークン数、キャッシュがウォームかコールドかが表示され、ステータスラインのスクリプトでも同等の prompt_cache オブジェクトを利用できます。このオブジェクトは、メインの会話で最初の API レスポンスを受け取った後に表示されます。subagents のリクエストは集計対象外です。また、API のレスポンスに含まれるキャッシュトークン数から計算されるため、すべてのプロバイダーで機能します。/usage の Prompt cache (main) 行にも同じ統計が表示されます。²⁰⁶²⁰⁹ v2.1.260 以降では、/cost の行とステータスラインの prompt_cache オブジェクトに、キャッシュミスの推定原因も表示されます。たとえば、ツール定義やシステムプロンプトの変更、セッションのアイドル時間がキャッシュの TTL を超えたことなどです。²¹²

エージェントのトラフィックによって自身のキャッシュプレフィックスが壊れなくなりました（v2.1.265）： 委任作業におけるプロンプトキャッシュの漏れを、2つの修正によって解消しています。フォアグラウンドで起動した subagent を再開しても、ツールリストやシステムプロンプトのプレフィックスが変わらなくなりました。また、エージェントのチームメイトや再開した subagents では、後続ターンで SubagentStart hook のコンテキストとプリロード済み skills がプロンプトプレフィックスの外へ移動しなくなりました。どちらのバグも、プレフィックスが変わることで、それ以降のすべてがキャッシュされていない入力として再送信され、プロンプトキャッシュを再利用できなくなるものでした。まさにキャッシュの費用対効果が最も重要となる、長時間のエージェントセッションで発生していました（v2.1.260で Fable 5.1 のツール呼び出しターンについて修正されたものと同じ障害パターンです）。²¹⁵

v2.1.267のキャッシュ安定性に関する一連の修正： 1回のリリースで約10件の修正が行われました。いずれも、会話の途中で何かがプロンプトプレフィックスを書き換え、それ以降のすべてがキャッシュされていない入力として再送信されるという同じ障害パターンです。再開したセッションでは、ツールリストやツールの説明が書き換えられなくなり、コネクターが再接続する前に過去の MCP ツール通知が書き換えられることもなくなりました。/model でモデルを切り替えても、すべてのツール定義は再送信されません（コミットと PR の帰属テキストは、モデルの変更時に更新される会話メモとして届くようになりました）。subagents や、--system-prompt または --append-system-prompt で開始したセッションでは、システムプロンプトとツール定義が一度だけ記録されます。また、セッション途中で追加された MCP と plugin のツールは、ToolSearch のないセッションでもツールリストを書き換えず、遅延定義として渡されます。この一連の修正により、v2.1.260およびv2.1.265で行われた対応が、再開、モデル切り替え、MCP の再接続にも拡張されました。²¹⁶

v2.1.273では会話の流れが維持されます： /login、/upgrade、/extra-usage を実行すると、それ以前の思考内容が会話から破棄され、次のリクエスト時にプロンプトキャッシュ全体の書き換えが必要になっていました。²¹⁷

サブスクリプションプラン

レート制限（2025年8月）： Anthropic は、有料サブスクリプションユーザーを対象に週間レート制限を導入しました。Maxユーザーは、レート制限を超えた追加利用枠を、通常の API 料金で購入できます。¹⁴

レート制限の倍増（2026年5月6日）： Code with Claude SF イベントにおいて、Anthropic は Pro、Max、Team、シート制 Enterprise プランの Claude Code における5時間レート制限を倍増しました。さらに、ProおよびMaxアカウントのピーク時間帯における削減を廃止し、Claude Opusモデルの API レート制限を「大幅に」引き上げました。この容量を支えているのが SpaceX Colossus 1 との契約で、「1か月以内に300メガワットを超える新規容量（NVIDIA GPU 22万基超）」が追加されます。¹⁵⁷

2026年9月14日からの週間制限（8月29日発表）： 5月の引き上げ以降適用されてきた週間制限の一時的な50%増加は、9月14日に終了します。代わって、Pro、Max、Team、シート制 Enterprise プランでは、引き上げ前の基準値から25%増加した制限が恒久的に適用されます。この変更に関する Anthropic 自身の計算では、「現在と比べると、Claude Code の週間制限は17%減少する」とされています。現在の週間上限が150ユニットであれば、9月14日には125ユニットになります。5時間制限は今回の発表の対象ではないため、5月に実施された倍増が維持されます。長時間の無人セッションを実行する場合は、今から上限の引き下げに備えましょう。重要な制御手段は、リセット時に自動で続行するトグル（v2.1.234）と /usage の2つです。²¹³

API のトークン料金（2026年4月）¹¹⁴⁴

API の従量課金ユーザー向けに、100万トークンあたりの料金を示します。

1Mコンテキストの料金（2026年4月）： Opus 4.7、Opus 4.6、Sonnet 4.6、Mythos Previewでは、すべて標準の100万トークン単価で1Mコンテキストを利用でき、長文コンテキストの割増料金はありません。¹⁴⁸ これは最近統一されたものであり、Opus 4.6またはSonnet 4.6で入力が200Kトークンを超えると、入力料金が2倍、出力料金が1.5倍になるという以前の案内は、現在では当てはまりません。旧モデルのOpus 4.5以前では、従来の料金体系が維持されています。

データレジデンシーの料金： inference_geo で米国内のみの推論を指定すると、キャッシュの読み取りと書き込みを含むすべてのトークン料金に1.1倍の係数が適用されます（Opus 4.6以降のモデル）。¹⁴⁸

プロンプトキャッシュを利用すると、繰り返し入力の料金を大幅に削減できます。キャッシュへの書き込みは基本料金の1.25倍（5分キャッシュ）または2倍（1時間キャッシュ）ですが、キャッシュの読み取りはわずか0.1倍で、90%の節約になります。さらに、Claude Fable 5.1およびMythos 5.1に限り、読み取り料金は0.025倍（Fable 5.1では$0.25/MTok）まで下がり、97.5%節約できます。²¹⁸ コンテキストを繰り返し使用する RAG システムやコードアシスタントでは、キャッシュによって料金を88～95%削減できる場合があります。

Batch API では、夜間のテストスイートなど緊急性の低いタスクについて、24時間以内の処理で50%の割引を受けられます。

複数アカウントに関するポリシー⁵²

複数の Claude アカウントを所有できますか？ はい、正当な用途であれば可能です。用途が明確に異なる場合、Anthropic は複数アカウントの所有を明示的に認めています。

許可されているケース：

技術的な制限： - 同じ電話番号で認証できるのは最大3アカウントです - 同じIPアドレスまたはネットワークからの複数の有料サブスクリプションは、明示的にサポートされています - アカウントは完全に独立しており、アカウント間でチャットやプロジェクトを移行することはできません

禁止されている行為（利用ポリシーに基づく）： - アカウント停止後に、停止措置を回避する目的で新しいアカウントを作成すること - 検出を回避するため、複数のアカウントを使って悪意のある活動を連携して行うこと - レート制限や無料枠のクレジットを回避するために複数のアカウントを使用すること

実例： 2026年1月、パワーユーザーのJeffrey Emanuel（@doodlestein）が所有する22個のMaxアカウントが自動検出され、一時的に停止されました。Anthropic の従業員であるThariq（@trq212）は、正当な利用であることを確認した後、4時間以内に問題を解決しました。仕事と個人の両方のプロジェクトで複数のアカウントを使い、Claude Code を広範囲に利用することは、まさに想定されている使い方です。ただし、システムを不正に利用しようとしてはいけません。

判断に迷う場合： 利用環境が認められるかどうか、Anthropic Support に問い合わせて書面で確認してください。

料金に影響する要素

実際の料金例

料金を抑えるヒント： 探索を行うsubagentsにはHaiku、実装にはSonnetを使用すると、すべてにSonnetを使用する場合と比べて、通常は料金を40～50%削減できます。

チームの料金管理

チーム規模別の推奨TPM/RPM：

見落としやすいツール料金

トークン単位の料金とは別に、一部のツールでは追加料金が発生します。⁹

エージェントループでは、こうした料金が積み重なります。Bashを使った100回反復のデバッグサイクルでは、オーバーヘッドだけで約24,500の追加入力トークンが発生します。

料金を抑える方法

1. subagentsにはHaikuを使用する：探索の大半ではSonnetは必要ありません
2. プロンプトキャッシュを有効にする：デフォルトで有効ですが、無効になっていないことを確認してください
3. 最大ターン数を設定する：claude --max-turns 5 により、会話が際限なく続くことを防げます
4. 料金の上限を設定する：claude --max-budget-usd 5 を指定すると、利用額が上限に達した時点でセッションを強制停止できます。v2.1.217以降、この上限はバックグラウンドのsubagentsにも適用されます。上限に達すると、新たな起動は拒否され、実行中のバックグラウンドエージェントも停止します（以前はバックグラウンドエージェントが予算制限の対象外でした）¹⁹⁴
5. 探索にはplan modeを使用する：実行を伴わないため、意図せず高額な処理が行われることはありません
6. 早めにコンパクションする：コンテキストを小さくすれば、トークン数を削減できます
7. 出力を制限する：export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. 緊急性の低い作業にはBatch APIを使用する：入力と出力の両方が50%割引になります
9. プロジェクトの Claude API 利用額を分析する：/claude-api cost-optimize（v2.1.247以降）は、既存プロジェクトの Claude API 利用額を分析し、キャッシュ、トークンの整理、batch、effort、モデル選択といった料金調整手段を、測定可能な変更として1つずつ適用します。対象は Claude Code セッション自体ではなく、API を使って構築するアプリです²²²

使用量の監視

• Claude Console：platform.claude.com（AdminまたはBillingロールが必要）
• ワークスペースの制限：ワークスペースごとに利用額の上限を設定
• Bedrock/Vertex：各クラウドのコスト監視機能を使用
• LiteLLM：サードパーティプロバイダーでユーザー別の詳細な追跡を行う場合に使用

バックグラウンドでのトークン消費

一部の処理では、バックグラウンドでトークンが消費されます。 - /resume 用の会話要約 - /cost および /status コマンド - 自動コンパクション

通常は1セッションあたり$0.04未満です。

Claude Code Analytics API（Team/Enterprise）⁴⁶

Admin API を通じて、組織における Claude Code の利用状況分析や生産性指標へプログラムからアクセスできます。

エンドポイント： GET /v1/organizations/usage_report/claude_code

要件： - Admin API キー（sk-ant-admin...） - TeamまたはEnterpriseプラン - Admin、Billing、Developerのいずれかのロール

利用可能な指標：

リクエスト例：

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-15" \
  -H "x-api-key: sk-ant-admin..." \
  -H "anthropic-version: 2023-06-01"

ユースケース： - 開発者の生産性分析（セッション、コミット、PR） - ツールの利用指標（Edit、Writeなどの承認率と拒否率） - チーム横断での料金の追跡と配分 - AIコーディングツールに対する ROI の正当性の説明

注： データはアクティビティ完了後1時間以内に反映されます。一貫性を保つため、レスポンスには1時間以上経過したデータのみが含まれます。

判断フレームワーク

機能を知っているだけでは不十分です。それぞれをいつ使うべきか判断できなければなりません。以下の判断ツリーを使えば、知識を具体的な行動へつなげられます。

どのモデルを使うべきか？

START → Is the task simple? (file search, quick question, formatting)
         │
         ├── YES → Use Haiku
         │         Cost: ~$0.03/task
         │         Speed: Fastest
         │
         └── NO → Does it require deep reasoning?
                  (architecture, complex debugging, security analysis)
                  │
                  ├── YES → Use Opus 5 (high effort default; /effort xhigh for harder)
                  │         Cost: ~$2.00/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.75/task
                           Balance: Best overall when cost matters

目安：デフォルトは利用中のプランに応じて決まります。プレミアムプランと Anthropic API では Opus 5、Pro と Team Standard では Sonnet 5 です。/model opus を使うと、Sonnet セッションを Opus 5 に切り替えられます。^181197207 subagents には Haiku を使いましょう。Sonnet の回答が浅いと感じたら、Opus に切り替えてください。agent teams（v2.1.32以降）では、Opus が複数の agents を調整し、それぞれ異なるサブタスクを並行して進められます。⁷⁹

Command、Skill、Subagent、Agent Team のどれを使うべきか？

Do you want explicit control over when it runs?
│
├── YES → Use Slash Command
│         Example: /deploy, /test, /security-review
│         You invoke it. You control timing.
│
└── NO → Should the expertise apply automatically based on context?
         │
         ├── YES → Use Skill
         │         Example: Security patterns, domain rules, code standards
         │         Claude recognizes context and applies expertise.
         │
         └── NO → Does the work need isolated context?
                  │
                  ├── YES → Is there one subtask or many parallel subtasks?
                  │         │
                  │         ├── ONE → Use Subagent (Task tool)
                  │         │         Example: Deep exploration, parallel analysis
                  │         │         Prevents context bloat in main conversation.
                  │         │
                  │         └── MANY → Use Agent Team (v2.1.32+)
                  │                   Example: 5 agents reviewing different modules simultaneously
                  │                   Opus coordinates; each agent works independently.
                  │
                  └── NO → Just prompt directly
                           Not everything needs abstraction.

Hook と Prompt のどちらを使うべきか？

Must the action ALWAYS happen, regardless of Claude's judgment?
│
├── YES → Use Hook (deterministic)
│         Examples:
│         - Format code after every edit
│         - Log all bash commands
│         - Block access to .env files
│         Claude cannot skip, forget, or decide otherwise.
│
└── NO → Use Prompt (probabilistic)
         Examples:
         - "Consider adding tests"
         - "Think about edge cases"
         - "Review for security if relevant"
         Claude decides based on context.

Extended Thinking を使うタイミング

Is this a genuinely hard problem?
│
├── Architectural decision with many tradeoffs → YES, use thinking
├── Complex debugging with unclear root cause → YES, use thinking
├── Security analysis requiring careful reasoning → YES, use thinking
├── Understanding unfamiliar codebase → YES, use thinking
│
├── Routine bug fix → NO, skip thinking
├── Simple refactoring → NO, skip thinking
├── Code formatting → NO, skip thinking
└── Quick questions → NO, skip thinking

セッション中に Alt+T で切り替えられます。thinking budget を増やすほどコストも高くなるため、まずは最小値から始め、回答が性急に感じられる場合にのみ増やしてください。

Opus 4.6 の adaptive thinking：Opus 4.6 は、問題の複雑さに応じて思考の深さを自動調整します。ほとんどのタスクでは、thinking budget を明示的に制御する必要はありません。難しい問題では思考を深め、単純な問題にはすばやく対応します。思考を手動で切り替える機能は、Sonnet により深い分析を強制したい場合に最も役立ちます。

どの実行環境を使うべきか？

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools

Agent Teams、Subagents、並行セッションの違い

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL

どの Hook タイプを使うべきか？

What kind of automation do you need?
│
├── Run a shell command at a specific event?
│   │
│   └── Use Command Hook
│       Trigger: PreToolUse, PostToolUse, Notification, Stop, SubagentStop
│       Example: "Run prettier after every file edit"
│       Config: hooks.PostToolUse[].command = "prettier --write $FILE"
│
├── Modify Claude's system prompt based on context?
│   │
│   └── Use Prompt Hook (v2.1.35+)
│       Trigger: Same events
│       Example: "Inject project rules when working in /src/auth/"
│       Config: hooks.PreToolUse[].prompt = "When editing auth files..."
│
└── Have Claude make a judgment call before proceeding?
    │
    └── Use Agent Hook (v2.1.35+)
        Trigger: Same events
        Example: "Evaluate if this bash command is safe before running"
        Config: hooks.PreToolUse[].agent = { prompt: "Is this safe?" }

/fast を使うタイミング

Is response speed more important than depth right now?
│
├── YES → Use /fast   (Opus 5 or Opus 4.8 only, v2.1.219+)
│         Same model, ~2.5× output speed at 2× price
│         Good for: quick questions, simple edits, code explanations,
│                   file searches, formatting tasks
│
└── NO → Stay in normal mode
         Good for: architecture decisions, complex debugging,
                   security reviews, multi-file refactors,
                   anything requiring deep reasoning

/fast は、現在のセッションの fast mode を切り替えます。同じモデルを使用したまま、出力速度を最適化します。v2.1.219時点で fast mode に対応しているモデルは Opus 5 と Opus 4.8 の2つだけです。安価なモデルへ切り替わるわけではなく、料金も MTok あたり10ドル／50ドルなので、コストが安くなるわけでもありません。¹⁹⁶¹⁹⁸

権限システムの仕組み

Claude Codeの権限システムでは、実行できる操作を細かく制御できます。セキュリティとワークフロー効率の両面で、この仕組みを理解することが重要です。組織全体に権限を適用する管理設定については、エンタープライズデプロイもご覧ください。

権限レベル

読み取り専用ツール（自動承認）： - Read - ファイルの内容を読み取る - Glob - パターンでファイルを検索する - Grep - ファイルの内容を検索する - WebSearch - ウェブを検索する - LSP - コードインテリジェンス（定義へ移動、参照を検索、ホバードキュメント）¹⁸

LSPツールの機能（v2.0.74以降）： LSPツールは、IDEのようなコードインテリジェンスを提供します。 - 定義へ移動：シンボルが定義されている場所へ移動します - 参照を検索：コードベース全体でシンボルが使われている箇所を一覧表示します - ホバードキュメント：任意のシンボルの型情報とドキュメントを取得します - TypeScript、Python、Go、Rust、およびLSPをサポートするその他の言語で動作します - 言語サーバーが利用可能である必要があります（通常はツールチェーンとともにインストールされます）

変更ツール（承認が必要）： - Edit - 既存のファイルを変更する - Write - 新しいファイルを作成する - Bash - シェルコマンドを実行する - WebFetch - URLの内容を取得する - NotebookEdit - Jupyterノートブックを変更する

変更ツールを初めて実行すると、Claude Codeが承認を求めます。明示的に別の設定をしない限り、承認はセッション中維持されます。

EndConversationツール（v2.1.214）。 Claude Codeには、Claudeが2025年からclaude.aiで備えているものと同じ会話終了機能が追加されました。極めて悪質な入力や執拗なジェイルブレイク試行があるまれなケースでは、Claudeが組み込みのEndConversationツールを通じてセッションを即座に終了できます。これは不正利用への耐性とモデルの健全性を保つための措置であり、ワークフロー機能ではありません。通常の開発セッションで作動することはありません。¹⁹⁰¹⁹³

権限モード

v2.1.200以降、defaultモードは「Manual」と表示されます。 この名称変更はCLI、--help、VS Code、JetBrainsに適用されていますが、設定値は変更されていません。そのため、"defaultMode": "default"は引き続き機能し、--permission-mode manualと"defaultMode": "manual"もエイリアスとして使用できるようになりました。動作は従来と同じで、各ツールの初回使用時に確認します。実態は手動承認モードであるにもかかわらず、「たまたま初期設定になっているモード」と読めるラベルではなくなっただけです。同じリリースで、AskUserQuestionダイアログはデフォルトで自動続行しなくなりました。質問したsubagentはタイムアウト後に処理を進めず、回答を待つようになりました。アイドルタイムアウトを再び有効にするには、/configで設定します。

2026年8月14日以降、AutoモードはPro、Max、Teamの初期設定になりました。8月7日に発表され、切り替え当日に公式の権限モードドキュメントで提供開始が確認されています。現在の記述では、把握しておくべき適用範囲が2点補足されています。初期設定が適用されるのは新しいセッションであり、「自分で設定したデフォルトは、1回限りの切り替え確認を承認しない限り維持され、組織が管理するデフォルトも変更されない」というものです。対象プランの新しいセッションはautoモードで開始され、「各ツール呼び出しを、元に戻せない操作、破壊的な操作、または環境外を対象とする操作を阻止するための分類モデルに通します」。Anthropicが切り替えの根拠として挙げた1,053人規模のテストでは、autoモードが危険なコマンドの89%を検出したのに対し、人間による審査では13.6%でした。また、ユーザーは権限確認の97%を承認しており、実際には手動審査が弱い理由もここにあります。分類モデルによるトークンのオーバーヘッドは、発表時点からPro/Max/Teamでは課金されなくなりました。Shift+Tabを1回押すか、デスクトップのモードドロップダウンを使えば元に戻せます。別のデフォルトを固定するには、設定のdefaultModeを使用します。組織管理者は、管理設定disableAutoModeでautoモードを完全に無効化できます。Enterprise、Claude API、AWS上のClaude Platform、Bedrock、Google CloudのAgent Platform、Foundryは、現時点ではオプトインのままです。Anthropicは「今後1か月以内に」初期設定の適用範囲をこれらにも広げる予定です。²⁰³ autoモードが何を保証していないのか、また研究者が実証した回避手法を受けてAnthropicが明言した内容については、MaxのAuto Modeをご覧ください。

コードを実行できる設定ファイルは、acceptEditsでも確認されるようになりました（v2.1.160）。 acceptEditsは通常の編集を自動承認しますが、v2.1.160以降、気付かないうちにコマンド実行を許可し得るファイルを書き込む前に停止し、確認を求めます。対象には、シェル起動ファイル（.zshenv、.zlogin、.bash_login）、~/.config/git/、ビルドツールの設定（.npmrc、.yarnrc*、bunfig.toml、.bazelrc、.pre-commit-config.yaml、.devcontainer/など）が含まれます。これらを編集すると、次回のシェル起動、インストール、またはコミットがコード実行経路になり得るためです。そのため、通常は編集をそのまま通す信頼済みプロジェクト用モードでも、明示的な確認を挟みます。これは既存の.claude/、.git/、.vscode/に対する書き込み保護と同じ脅威モデルを、より広範な「編集が実行につながる」ファイルへ拡張したものです。²⁴²

Auto Mode（v2.1.85以降）： --dangerously-skip-permissionsをより安全に置き換えるものです。独立した分類モデル（v2.1.210以降はClaude Sonnet 5、当初はSonnet 4.6）が実行前に各操作を審査し、ユーザーの意図と一致していて安全かどうかを確認します。¹²⁴¹⁸⁷

仕組み： - 読み取り専用操作と作業ディレクトリ内のファイル編集は自動承認されます - カスタムの許可・拒否ルールが先に評価されます - それ以外はすべて分類モデルによる評価に回されます - ブロックされた場合、Claudeが別の方法を自動的に試します

デフォルトで自動ブロックされる操作：curl | bash、mainへのforce-push、本番環境へのデプロイやマイグレーション、クラウド上での一括削除、IAMや権限の変更、機密データの外部送信。¹²⁵

サーキットブレーカー：3回連続、または1セッション中に合計20回ブロックされると、手動確認に戻って一時停止します。¹²⁵

# Enable at startup
claude --permission-mode auto

# Or cycle into it during a session
Shift+Tab  # Cycles through: Manual (aka default) → acceptEdits → auto → plan

autoモードはオプトインが不要になり（v2.1.152）、環境変数フラグなしでBedrock/Vertex/Foundry上でも動作します（v2.1.207）。また、2026年8月14日以降はPro/Max/Teamの初期設定となっています。^244185203

YOLO Mode（v2.0.68以降）： 安全性を確認する分類モデルを介さずに完全自律で動作させるには、--dangerously-skip-permissionsフラグを使用します。このフラグは、ファイル編集、bashコマンド、すべてのツール呼び出しを無条件で承認します。「dangerous」という表現は意図的なものです。ほとんどのユースケースでは、代わりにAuto Modeを使用することを推奨します。⁵⁴

claude --dangerously-skip-permissions

CLIでモードを設定します。

claude --permission-mode auto  # or acceptEdits, plan, bypassPermissions

セッション中に切り替えます。

Shift+Tab  # Cycles through modes

settings.jsonでは次のように設定します。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

defaultModeのスコープ制限（v2.1.257）： プロジェクトの.claude/settings.jsonまたは.claude/settings.local.jsonからdefaultMode: "bypassPermissions"を設定できなくなりました。この値は、すでに制限されていた"auto"と同様に無視されます。ドキュメントにもルールが明記され、permissions.defaultModeの値autoとbypassPermissionsは「プロジェクト設定またはローカル設定からは反映されない」とされています。ユーザー設定か管理設定で指定するか、--permission-modeを使ってセッションごとに設定してください。したがって、クローンしたリポジトリに、権限を迂回した状態でセッションを開始させる設定ファイルを含めることはできません。（上の例では、どのスコープからでも設定できるacceptEditsを使用しています。このガイドでは従来から存在したautoの制限も記載していませんでしたが、今回どちらも明記しました。）²¹¹²²⁰

権限ルールの構文

細かなルールによって特定の操作を制御できます。ルールは順番に評価され、最初に一致したものが適用されます。

Bashコマンドのパターン：

{
  "allow": [
    "Bash(npm run build)",
    "Bash(npm run test:*)",
    "Bash(git commit:*)",
    "Bash(make:*)"
  ],
  "deny": [
    "Bash(rm -rf:*)",
    "Bash(sudo:*)",
    "Bash(curl|wget:*)"
  ]
}

アスタリスクは前方一致に使われます。Bash(npm run test:*)は、npm run test、npm run test:unit、npm run test:integrationを許可します。

重要な制限： Bashパターンは正規表現ではなく、前方一致のみです。Bash(curl http:*)のようなパターンは、URLより前にオプションがあるため、curl -X GET http://...には一致しません。確実にブロックするには、Bash(curl:*)としてコマンド全体を拒否してください。

*はサブコマンドの後に置いてください。 Claude Codeは最初の*より前の部分を記述どおりに照合するため、その単語列がルールの適用範囲を決めます。Bash(git log *)はgit logコマンドだけを許可しますが、Bash(git * main)では*がサブコマンドと、その前にあるすべてのオプションに相当します。そこには、指定したプログラムをgitに実行させる-cも含まれるため、Bash(git * main)はgit -c core.fsmonitor=<script> diff mainも承認します。v2.1.246以降、設定ファイル、管理設定、--allowedToolsや--settingsの値のいずれに記述されていても、サブコマンドより前にワイルドカードがある許可ルールについて、Claude Codeが起動時に警告します。修正するには、Bash(git * main)ではなくBash(git checkout main)のように、意図する値を正確に指定します。²²⁶²²⁴

ファイル拒否ルールはリダイレクトにも適用されますが、引数への拡張はリリース翌日に取り消されました（v2.1.257〜260）。 Bashコマンドに対するRead(...)とEdit(...)の拒否ルールは、入力リダイレクト（< file）とtacやegrepなどの読み取りコマンドにも適用されます（v2.1.257）。これは、v2.1.232の入力リダイレクト検査がv2.1.233で取り消された際に予告された、より限定的な実装であり、この部分は維持されています。v2.1.259では、オプション値やオペランドに隠れたファイルパス（--ignore-revs-file=.env、-f.env、@file引数、git diffとgit grepのオペランド、cd DIR && cat FILEの複合コマンド）にも同じ保護が拡張され、拒否対象ファイルを含むディレクトリに対するgrep -rやcp -rも先に確認するようになりました。しかし、v2.1.260ではその拡張が翌日に取り消されました。Read(./**/build/**)ルールがあると、すべてのモードでnpm run buildが拒否され、autoモードでもcd ... && grepで確認が発生したためです。引数レベルの適用範囲をめぐっては、これが3回目の変更です。v2.1.232で導入され、v2.1.233で取り消され、v2.1.257で現在も維持されているリダイレクトと読み取りコマンドへの限定対応が導入され、v2.1.259で引数に拡張された後、v2.1.260でその拡張が取り消されました。したがってv2.1.260時点では、拒否ルールはリダイレクトと読み取りコマンドを検出しますが、任意のコマンド引数に隠されたパスまでは検出しません。この状態は現在も維持されています。その後の変更は個別の回避手法に対する修正であり、4回目の全面変更ではありません（次の段落を参照）。²¹¹²¹²

取り消し後の個別修正と、2回目の限定的な取り消し（v2.1.268〜273）。 引数への適用を取り消した状態は維持しつつ、特定の回避手法を塞いでいます。ただし、そのうち1つはさらに取り消されました。v2.1.268： シンボリックリンクになっているシステムディレクトリ（macOSの/etc、/tmp、/var、Linuxの/bin）に対する拒否・確認ルールは、実体のパスで指定した場合にも適用されるようになりました。また、シンボリックリンク側のパスで書かれた拒否ルールをBashコマンドが無視することもなくなりました。この2点は維持されています。同じリリースでは、権限チェッカーが同一行で解析できないenv -C、evalなどのコマンドによってReadまたはEditの拒否ルールを回避できないようにもなりましたが、v2.1.273ではこの検査だけが取り消されました。「time -p make buildのようなコマンドは、拒否されず再び確認される」ようになっています。v2.1.269： Edit()拒否ルールと書き込みパス検査が、Bashのteeコマンドによる書き込み先ファイルにも適用されるようになりました。Bash(tee:*)の許可ルールでは作業ディレクトリ外の書き込み先を許可しなくなり、!で始まる拒否・確認ルールは、それを記述した設定ソース内でのみ適用されます（単独の!による否定は無視されます）。v2.1.271ではチェッカー自体が修正されました。fmt、columnなどが読み取るファイルは、チェッカーが認識できないオプションの後にある場合も検査されます。ワイルドカードがパターンやオプション値に含まれる場合（例：grep -v dir/* file）も、展開先のファイルが検査されます。シェルの変数宣言用フラグで実行対象のコマンドを偽装することもできなくなりました。さらに、2回のディレクトリ移動、サブシェル、またはcdとgitの連結を含むコマンドも、bypassおよびautoモードでpermissions.blockReadsOutsideWorkingDirectoriesによる確認を回避できなくなりました。v2.1.273では先述の取り消しと同時に、3つの個別修正も導入されました。解析できないBashコマンドがpermissions.blockReadsOutsideWorkingDirectoriesによる確認を省略しなくなり、危険なrmを隠したサブシェルがbypassモードの確認を回避できなくなりました。また、リポジトリの設定で選択されたメモリディレクトリが、その設定に基づいて読み込み、想起、インデックス化されることもなくなりました。解析できないBash行に対する最終的なルールを端的に言えば、拒否ルールは拒否ではなく確認となり、blockReadsOutsideWorkingDirectoriesは省略ではなく確認となります。²¹⁶²¹⁷

ファイル操作のパターン：

{
  "allow": [
    "Edit(src/**)",
    "Read(docs/**)"
  ],
  "deny": [
    "Read(.env*)",
    "Read(secrets/**)",
    "Edit(.git/**)",
    "Edit(node_modules/**)"
  ]
}

パス構文： - 相対パス：Edit(src/**) - 作業ディレクトリからの相対パス - 設定ファイルを基準とする絶対パス：Edit(/build/**) - 設定ファイルの場所からの相対パス - 真の絶対パス：Edit(//tmp/**) - //で開始 - ホームディレクトリ：Read(~/.zshrc)

単一セグメントのdir/**許可ルールは、<cwd>/dirだけに一致するようになりました（v2.1.214）。既存のルールを監査してください。 v2.1.214より前は、Edit(src/**)のような許可ルールによって、ツリー内のどこにあってもsrcという名前のディレクトリへの書き込みが自動承認されていました。vendor/src/やpackages/foo/src/などもすべて対象でした。現在は、作業ディレクトリ直下のsrcディレクトリだけに一致します。従来の任意の深さでの一致に依存していた場合は、ルールをEdit(**/src/**)に書き換えてください。denyとaskのルールでは、従来どおり任意の深さで一致します。この変更で狭まるのは自動承認の範囲だけであり、ブロックされる範囲が狭まることはありません。一致しなくなったルールはエラーにならず、アップグレード後に新たな権限確認として現れます。そのため、単一セグメント形式で記述した許可ルールを確認してください。このリリースでは、Hookのif:条件にも同じcwdスコープが適用されました（マッチャーを参照）。¹⁹⁰

Write(path)、NotebookEdit(path)、Glob(path)ではなく、Edit(path)またはRead(path)を使用してください（v2.1.210）。 Claude Codeは、Write(path)、NotebookEdit(path)、Glob(path)を対象として記述された権限ルールについて、起動時に警告を表示するようになりました。標準の形式は、実際にファイルアクセスを制御する2つのルール系統です。Edit(path)はWriteとNotebookEditを含むすべてのファイル書き込みツールを対象とし、Read(path)はGlobを含むファイル読み取りツールを対象とします。古いルールを移行して警告を解消し、意図を明確にしてください。¹⁸⁷

「Always allow」はリポジトリルートに保存されます（v2.1.211）。 権限確認の「Always allow」オプションで作成した権限ルールは、現在のworktreeではなくリポジトリルートに書き込まれるようになりました。そのため、あるworktreeで与えた承認はセッションをまたいで、さらにそのリポジトリのすべてのworktreeにわたって維持されます。並列チェックアウトごとに同じコマンドを再承認する必要はありません。¹⁸⁸

括弧を含むパスと不正なパターンは、安全側に倒して処理されます（v2.1.260）。 ファイル権限ルールの解析に関する3つの問題が修正されました。最初の1つはセキュリティ修正です。パスに括弧を含むEdit、Write、Readルール（たとえばNext.jsのルートグループEdit(src/app/(admin)/**)）は、無効として破棄されるかBashサンドボックスに無視されていました。そのため、管理者が読み取り専用だと考えていたフォルダーにも書き込めましたが、現在はルールが適用されます。コンパイルできないパターン（閉じていない[など）を含むファイル拒否ルールは、以前はすべてのファイル編集をInvalid regular expressionで失敗させていましたが、現在は記述されたリテラルパスを保護します。また、Edit(C:\dir\(name)\**)のように、\(がパス区切りではなくエスケープされた括弧として解釈されるルールについて、設定エラーが曖昧さのない表記を提案するようになりました。同じリリースで、閉じ括弧の後にテキストがあるルールも黙って無視されなくなりました（Bash(ls) xは何にも一致していませんでした）。現在は無効な設定として報告されます。²¹²

MCPツールのパターン：

{
  "allow": [
    "mcp__github",
    "mcp__database__query",
    "mcp__myserver__*"
  ],
  "deny": [
    "mcp__dangerous_server",
    "mcp__untrusted__*"
  ]
}

ワイルドカード構文mcp__server__*を使用すると、特定のMCPサーバーから提供されるすべてのツールを許可または拒否できます。³² 信頼できるサーバーのすべてのツールをすばやく有効化したり、信頼できないソースのサーバー全体をブロックしたりする際に便利です。

v2.1.166以降、拒否ルールではツール名の位置にもglobを使用できます。ツール名の位置に単独の"*"を置くと、すべてのツールが拒否されるため、いったんすべてをブロックしてから限定的な範囲だけを再び許可できます。一方、許可ルールではMCP以外のglobが拒否されます。同じ方法で広範囲を一括許可することはできず、制限的なデフォルト姿勢が維持されます。²⁴⁰

パラメータ単位の照合 — Tool(param:value)（v2.1.178）：

ルールはツール名だけでなく、ツールの入力パラメータにも一致させることができます。値には*をワイルドカードとして使用します。

{
  "deny": [
    "Agent(model:opus)"
  ]
}

Agent(model:opus)は、Opusティアで起動されるすべてのsubagentをブロックします。Opusを避けるようプロンプトで依頼するだけではなく、起動そのものが拒否されます。これにより、権限制御は「どのツールか」から「どのように呼び出されるか」まで拡張され、プロンプトレベルの依頼ではなく決定的なルールとして機能します。管理設定enforceAvailableModelsと組み合わせて使用できます。許可リストでセッション中に存在するモデルティアを定義し、Tool(model:...)ルールでsubagentがその中からモデルを選ぶ方法を制限します。¹⁷³

v2.1.186以降、これらのAgent(...)ルールは名前付きsubagentの起動にも適用されます。Agent(agent_type)の拒否ルールとAgent(x,y)の許可タイプ制限は、匿名のTask形式による起動だけでなく、特定の名前付きエージェントを起動する場合（ワークフロー、--agents、またはエージェントチーム経由）にも適用されます。起動時点でブロックされるため、制限対象の名前付きエージェントがルールを迂回できていた隙が解消されました。¹⁷⁵

WebFetchのパターン：

{
  "allow": [
    "WebFetch(domain:github.com)",
    "WebFetch(domain:api.example.com)"
  ]
}

v2.1.268以降、単独のWebFetch拒否・確認ルールは、Artifactツールによる読み取りと更新には適用されません。これらをブロックまたは確認対象にするには、ArtifactルールかWebFetch(domain:claude.ai)を記述してください。²¹⁶

追加ディレクトリ

Claudeのアクセス範囲を現在のプロジェクト外へ拡張します。

{
  "permissions": {
    "additionalDirectories": [
      "../shared-lib",
      "../docs",
      "~/reference-projects/design-system"
    ]
  }
}

追加ディレクトリは、モノレポを扱う場合や、Claudeが兄弟ディレクトリ内のコードを参照する必要がある場合に欠かせません。

サンドボックスモード

ファイルシステムとネットワークの分離を有効にします。

> /sandbox

または、設定内で構成します。

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"],
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"],
      "allowLocalBinding": true,
      "deniedDomains": ["pastebin.com", "transfer.sh", "0x0.st"]
    }
  }
}

v2.1.187以降、sandbox.credentials設定を使用すると、サンドボックス化されたコマンドによる認証情報ファイルと秘密の環境変数の読み取りをブロックできます。サンドボックス化されたコマンドが秘密情報を外部へ持ち出すことに対する多層防御です。¹⁷⁶

v2.1.221以降、認証情報のファイルには許可・拒否に加えて3つ目のモード、mode: "mask"が追加されました（LinuxおよびWSL）。サンドボックス化されたコマンドがファイルを読み取ると、ファイル全体、またはextract正規表現で取得した部分だけをセンチネルに置き換えたコピーが渡され、サンドボックスプロキシが外部送信時に実際の値へ置換します。コマンドはプロキシを通じて認証できるため動作しますが、秘密情報が環境内に現れることはありません。プロンプトインジェクションを受けたコマンドがトークンを探し回る場合に、まさに必要となる性質です。プロキシ置換の仕組みが利用できないmacOSでは、maskがdenyへフォールバックします。そのため、Linux CI用に記述した設定でも、ファイルが気付かないうちに露出するのではなく、安全側に機能が縮退します。¹⁹⁹

v2.1.224では、マスキングが静的なファイル内容以外にも拡張されました。 extractとonExtractNoMatchで構造化された環境変数値を処理できます。decode: "jwt"とmaskClaimsを使用すると、JWT全体ではなく選択したクレームだけをマスクできます。これにより、機密性の高いクレームをセンチネルのまま保ちながら、コマンドがトークンのルーティングメタデータを読み取れます。また、awsPairs/sigv4はプロキシでAWS SigV4リクエストに再署名します。マスクされたキーでは署名検証に失敗するため、AWS CLIでマスキングを利用するにはこの機能が不可欠です。これらはすべてnetwork.tlsTerminateを必要とし、ユーザー設定、管理設定、または--settingsのスコープから指定した場合にのみ適用されます。リポジトリ側から、認証情報を密かに迂回させるマスキング設定を含めることはできません。²⁰¹

v2.1.216以降、sandbox.filesystem.disabled設定を使用すると、ネットワークの外向き通信制御を維持したまま、ファイルシステムの分離を省略できます。ファイルシステムの隔離によってビルドツールが動作しなくなるものの、外向き通信にはドメイン許可リストを適用したい場合に便利です。¹⁹²

v2.1.219以降、sandbox.network.strictAllowlist設定を有効にすると、許可リストにないホストが確認なしで即座に拒否されます。デフォルトでは、サンドボックス化されたコマンドがallowedDomainsにないホストへ接続すると、権限確認が表示されます。strictAllowlistを有効にすると、接続は単純に拒否されます。これは、CI、バックグラウンドエージェント、夜間ループなど、誰も応答しない確認によって処理が停止する無人実行に適した設定です。そのような状況では、「予期しない外向き通信について確認する」という方針自体が不適切です。これでネットワーク制御の3要素が揃います。allowedDomainsは許可対象を指定し、deniedDomains（後述）は広い許可範囲から例外を切り出し、strictAllowlistはそれ以外を確認するか失敗させるかを決めます。¹⁹⁶ v2.1.229ではドメインリストの構文自体も厳格化されました。IPv6リテラルは角括弧で囲む必要があり（[::1]:443）、曖昧な表記はfail-closed方式で適用され、/doctorで指摘されます。²³⁴ v2.1.236では、さらに2つの強化が追加されました。 macOSでは、ワイルドカード形式の読み取り拒否ルール（例：**/.env）が許可された読み取り領域内でも優先されるようになり、一致するディレクトリの内容も対象となり、拒否対象ファイルの名前を変更しても回避できなくなりました。またautoモードの有効中は、Monitorの許可ルールが適用されません。MonitorコマンドはBashコマンドと同様に分類モデルの審査を受けます。autoモードの分類モデル自体も、Bedrock、Vertex AI、Foundry、およびテレメトリ無効時に、Claude APIと同じデフォルト（重大度スコア付き分類を含む）で動作するようになりました。²²³ v2.1.273では、これらのゲートウェイにおける仕組みのデフォルトが変更されました。当面はローカル分類モデルがデフォルトとなり、CLAUDE_CODE_AUTO_MODE_SERVER=1を指定するとプラットフォームのサーバー側分類モデルを使用します。²¹⁷

autoモードのコマンド単位のallowed_domains（v2.1.271）： サンドボックスを有効にすると、autoモードのBash、PowerShell、Monitorコマンドに、それぞれ固有のallowed_domainsを指定できます。コマンドが必要とするホストはコマンドとともに審査され、そのコマンドに限って接続が許可されます。それ以外のホストは拒否されます。これにより、外向き通信はセッション全体に及ぶ許可ではなくなります。各コマンドが接続先を明示し、審査ではその組み合わせだけが評価されます。²¹⁶

厳格サンドボックスモードと!による適用除外（sandbox.allowUnsandboxedCommands、v2.1.260）。 このガイドでこれまで紹介していなかった設定です。デフォルトでは、サンドボックス内で失敗したコマンドを、通常の権限フローに従い、dangerouslyDisableSandboxという脱出口を使ってサンドボックス外で再試行できます。sandbox.allowUnsandboxedCommands: falseは、/sandboxのOverridesタブではStrict sandbox modeと表示され、この脱出口を無効にします。パラメータは無視され、すべてのコマンドをサンドボックス内で実行するか、excludedCommandsに登録しなければなりません。v2.1.260以降、!のbashモードプロンプトへ自分で入力したコマンドは、厳格サンドボックスモードでもサンドボックス外で実行されます。「自分のターミナルに入力するのと同じ」扱いです。この厳格性が制御するのはClaudeが実行する内容であり、自分で入力する内容ではありません。脅威モデル上、!コマンドも隔離環境を継承すると想定していた場合、現在はそのように動作しません。²¹²

サンドボックス化されている場合： - ファイルシステムへのアクセスはプロジェクトディレクトリに制限されます - ネットワークアクセスが制御されます - 一部のコマンドはサンドボックスの制限対象外となります - autoAllowBashIfSandboxedがtrueの場合、Bashコマンドは自動的に許可されます

上級者向けのヒント： サンドボックスモードは、信頼できないコードベースでClaudeを実行する場合に非常に有効です。未知のプロジェクトを調査するときや、保護層を追加したいときに有効化してください。Anthropicの内部テストでは、サンドボックス化によって権限確認が84%減少しました。³⁸ サンドボックスはOSレベルの機能（macOSのseatbelt、Linuxのbubblewrap）を使ってファイルシステムとネットワークを分離するため、プロンプトインジェクションが成功しても完全に封じ込められます。Anthropicは、独自のエージェントを構築するチーム向けにサンドボックスランタイムをオープンソース化しています。⁸²

セキュリティに関する注意事項（v2.1.34以降）： 以前は、autoAllowBashIfSandboxedが有効な場合、sandbox.excludedCommandsまたはdangerouslyDisableSandboxによってサンドボックス対象外となったコマンドが、Bashのask権限ルールを回避できました。この問題はv2.1.34で修正されました。⁸⁷ v2.1.38以降、サンドボックスモードでは.claude/skillsへの書き込みがブロックされ、プロンプトインジェクションによるskill定義の変更を防ぎます。⁸⁸ v2.1.77では、denyRead領域内で読み取りアクセスを再許可するallowReadサンドボックスファイルシステム設定が追加されました。ディレクトリツリーの大部分をブロックしながら、特定のサブディレクトリだけを許可リストに登録したい場合に便利です。¹¹⁹

.claude/のエージェント設定に対する適用除外（v2.1.121以降）： --dangerously-skip-permissionsでは、.claude/skills/、.claude/agents/、.claude/commands/への書き込み時に確認が表示されなくなりました。¹⁵⁴

ネストした.claude/の解決（v2.1.178）： ネストした.claude/skillsディレクトリ内のskillsは、リポジトリルートからだけでなく、そのディレクトリ配下のファイルを操作するときにも自動的に読み込まれるようになりました。名前が衝突した場合、ネストされたskillには<dir>:<name>でアクセスできるため、どちらも利用できます。プロジェクトの他の要素も同様に解決されます。ネストされた.claude/ディレクトリ間でエージェント、ワークフロー、または出力スタイルの名前が衝突した場合は、作業ディレクトリに最も近いものが優先されます。また、プロジェクトスコープのワークフロー保存先は、最も近い既存の.claude/workflows/になります。モノレポやリポジトリを内包するリポジトリでは、単一の平坦なグローバル環境ではなく、コンテキストに応じて有効化されるパッケージ単位のツール環境を構築できます。¹⁷³

bubblewrapとsocatのカスタムパス（v2.1.133以降）： 管理設定sandbox.bwrapPathとsandbox.socatPathを使用すると、管理者はLinux/WSL環境で標準以外の場所にあるbubblewrapとsocatのバイナリを指定できます。ディストリビューションがこれらのツールを$PATH外にインストールする場合や、組織が強化済みビルドを独自に提供する場合に便利です。¹⁶⁰

v2.1.113のセキュリティ強化：¹⁵⁰

• sandbox.network.deniedDomainsは、より広範なallowedDomainsワイルドカードで許可されるホストでも、個別にブロックします。許可ポリシー全体を書き換えることなく、ペーストサービス、ファイル共有サービス、既知の悪意あるホストへの接続を遮断できます。許可リスト外のすべてを確認なしで拒否したい場合は、前述のsandbox.network.strictAllowlist（v2.1.219）と組み合わせてください。
• ラッパーコマンドに対する拒否ルール。 Bashの拒否ルールが、env、sudo、watch、ionice、setsidなどの実行ラッパーに包まれたコマンドにも一致するようになりました。Bash(rm:*)のようなルールで、env rm -rf、sudo rm -rf、および同種の回避パターンも検出できます。
• Bash(find:*)許可ルールで、find -execやfind -deleteが自動承認されなくなりました。 これらのフラグはコマンドの実行やファイルの削除を行うため、Claude Codeは通常の権限フローに回します。
• macOSの削除保護。 Bash(rm:*)許可ルールでは、/private/etc、/private/var、/private/tmp、/private/homeが危険な削除対象として扱われるようになりました。/var、/etc、/tmpは/private/内へのシンボリックリンクであるため、従来のルール形式では実体のパスを検出できませんでした。

v2.1.214での権限のfail-closed強化：¹⁹⁰

1つのリリースで複数の権限検査の抜け穴が修正され、いずれもfail-closedの方向に統一されました。解析機能が確信を持てない場合は確認を求めます。

• Windows PowerShell 5.1の回避手法を修正。 PowerShell 5.1セッションで実行されたコマンドは、以前は権限検査をすり抜けることがありました。
• Bashのファイルディスクリプタリダイレクトをfail-closed化。 bashと権限解析機能で解釈が異なるリダイレクト形式は、そのまま実行されず確認されるようになりました。
• 10,000文字を超えるコマンドは常に確認。 非常に長いコマンドは以前、誤って判定されることがありました。現在は自動実行されません。
• [[ ]]内のzsh添字と修飾子を確認。 [[ ]]による比較内の変数添字と修飾子は以前、動作しないテキストとして扱われていましたが、コードを実行できるため、現在は承認が必要です。
• 安全でないhelp/manのバリエーションは自動承認されません。 一部の呼び出しでは、ドキュメントの読み取りに見せかけて、安全でないオプション、コマンド置換、またはバックスラッシュを含むパスを実行できました。
• リモートセッションの確認順序。 リモートセッションの権限確認が、ローカルの確認ダイアログより先に進むことはなくなりました。
• dockerのデーモン転送フラグを確認。 --url、--connection、--identity、またはPodmanのリモートモードを含むdockerコマンド（Podmanのdocker shimを含む）は、以前は確認なしで実行されていました。これらのフラグは、コマンドの接続先をまったく別のデーモンへ変更します。
• 書き込み先を指定されたfileは、読み取り専用としての自動許可を失います。 file -m/--magic-fileと-f/--files-fromは、読み取り専用として自動承認されず、権限が必要になりました。

Hooks はどのように機能しますか？

Hooks は、Claude Code のワークフロー内の特定の時点で、決定論的なシェルコマンドを実行します。Claude にアクションの実行を指示するプロンプトとは異なり、hooks はモデルの挙動にかかわらず確実に実行されます。チーム標準の適用や反復作業の自動化に欠かせません。command、prompt、agent hooks を対象とした「どの Hook タイプを選ぶべきか？」の判断ツリーについては、判断フレームワークをご覧ください。

プロンプトではなく hooks を使う理由： Claude に「ファイルを編集した後は常に Prettier を実行する」と指示しても、実行されるのは一部の場合だけです。Claude が忘れたり、速度を優先したり、変更が「小さすぎる」と判断したりする可能性があります。hooks なら、例外なく毎回、Edit または Write のたびにフォーマッターが確実に実行されます。コンプライアンス、セキュリティ、チーム標準では、確率的な処理より決定論的な処理が優れています。⁴

利用可能なイベント