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

要約： Claude Code は、コードベースを読み取り、コマンドを実行し、権限、hooks、MCP 連携、subagentsからなる多層システムを通じてファイルを変更するエージェント型CLIです。5つの中核システム（設定、権限、hooks、MCP、subagents）を習得すれば、生産性を飛躍的に高められます。複雑な推論には Opus、一般的な作業には Sonnet、素早い調査には Haiku と、タスクに合ったモデル階層を選びましょう。品質だけを重視するなら、Opus に統一する方法もあります。必ず実行しなければならない処理には、プロンプトではなく hooks を使用してください。v2.1.197（2026年6月30日）以降、Claude Sonnet 5 が Claude Code のデフォルトモデルです。ネイティブの1Mコンテキストを備え、8月31日までプロモーション価格の$2/$10で利用できます。Opusへは /model opus ひとつで切り替えられ、v2.1.219以降、このエイリアスは Claude Opus 5 を選択します。v2.1.198（7月1日）では、subagentsがデフォルトでバックグラウンド実行されるようになり、Chrome版Claudeが一般提供に移行しました。また、バックグラウンドエージェントがworktreeのコード作業を完了すると、commit、push、ドラフトPRの作成が可能になり、バックグラウンドセッションでは Notification hook（agent_needs_input/agent_completed）が発火します。v2.1.199（7月2日）では、積み重ねたslash-skill呼び出しを最大5件読み込めるようになり、サブスクライバーに対して一時的な429エラーを自動再試行します。v2.1.200（7月3日）では、default 権限モードの名称が「Manual」に変更されました。対象はCLI、--help、VS Code、JetBrainsで、設定値は変わらず、manual もエイリアスとして使用できます。また、AskUserQuestion ダイアログがデフォルトで自動続行しなくなりました。v2.1.202（7月6日）では、「Dynamic workflow size」を制御する /config 項目が追加され、/review <pr> は高速なシングルパスレビューに戻りました。マルチエージェントによるレビューは /code-review <level> <pr#> に移されています。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分類器が担当します。また、信頼されていないフォルダーからエージェントのfrontmatter 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日）は、バグ修正と信頼性向上のみのリリースです。^196197198 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つのバックアップモデルへ順次切り替えられます。globの "*" はMCPのdenyルールで機能し、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倍です。lean system promptは、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のfrontmatterに指定できる disallowed-tools、/reload-skills、新しい MessageDisplay hookイベント、SessionStart hookの reloadSkills/sessionTitle 出力、pluginSuggestionMarketplaces 管理設定、セッション途中での --fallback-model 切り替えが導入され、auto-modeのオプトインは廃止されました。^{162 163 164 165 166 167 168 169 170 206 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が、動作から自動化まですべてを制御します。
• 作業を委任レイヤーへ移しましょう：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サーバーの接続、Enterpriseデプロイまで詳しく扱います。ただし、始めるために必須のものはありません。

前提条件: Node 18+ が必要なのは従来のnpm経由の場合だけです。推奨されるネイティブインストーラーにはNode依存はありません。macOS / Linux / Windows 10+ がサポートされています。Claude Pro、Max、Team、Enterpriseのサブスクリプション、または従量課金のAnthropic APIキーで利用できます。プラットフォーム別の詳細、トラブルシューティング、ネイティブバイナリのパス（v2.1.113以降のデフォルト）については、Claude Codeをインストールするには？をご覧ください。このガイドの最新リリース根拠は、v2.1.154に照らして確認済みです。²⁰⁶

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 (up to 10 parallel)       │    │
│  │   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 │
└─────────────────────────────────────────────────────────┘

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

Delegation Layer: Subagentsはクリーンなコンテキストで起動し、焦点を絞った作業を行い、要約を返します。探索結果でメインの会話が膨らむことはなく、結論だけが戻ります。探索にはより安価なモデル層へsubagentsを振り分けることもできますし、品質をコストより重視するなら最初から最後まで主要モデルを使うこともできます。

Extension Layer: MCPは外部サービス（データベース、GitHub、Sentry）に接続します。Hooksは、モデルの挙動に関係なくシェルコマンドの実行を保証します。Skillsは、Claudeが自動的に適用するドメイン知識をエンコードします。Pluginsは、これらすべてを配布用にパッケージ化します。

重要なポイント: 多くのユーザーはCore Layerだけで作業し、コンテキストが膨らみコストが増えていく様子を見ることになります。上級ユーザーは、探索や専門的な作業をDelegation Layerに任せ、Extension Layerを自分のワークフロー向けに設定し、Core Layerはオーケストレーションと最終判断にだけ使います。

目次

1. Claude Codeをインストールするには？
2. クイックスタート: 最初のセッション
3. Core Interaction Modes
4. Configuration System詳解
5. どのモデルを選ぶべきですか？
6. Claude Codeのコストは？
7. 判断フレームワーク
8. 権限システムはどのように動作しますか？
9. Hooksはどのように動作しますか？
10. MCP（Model Context Protocol）とは？
11. Subagentsとは？
12. Extended Thinking Modeとは？
13. Output Styles
14. Slash Commands
15. Skillsはどのように動作しますか？
16. Plugin System
17. Memoryはどのように動作しますか？
18. 画像とマルチモーダル入力
19. Voice Mode
20. Git連携はどのように動作しますか？
21. IDEでClaude Codeを使うには？
22. 高度な利用パターン
23. Remote & Background Agents [RESEARCH PREVIEW]
24. ChromeのClaude
25. SlackのClaude Code [RESEARCH PREVIEW]
26. Web上のClaude Code [RESEARCH PREVIEW]
27. パフォーマンス最適化
28. 問題をデバッグするには？
29. Enterpriseデプロイ
30. キーボードショートカット参照
31. ベストプラクティス
32. Workflow Recipes
33. 移行ガイド
34. 読者別ガイダンス
35. クイックリファレンスカード
36. Changelog
37. References

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 billing）

platform.claude.com（旧console.anthropic.com）を通じてAnthropicのAPIに直接接続します。アカウントを作成し、課金を設定してCLIから認証を行います。Consoleでは、APIへのフルアクセスを伴う従量課金が利用できます。「Claude Code」専用ワークスペースが自動的に作成されます。このワークスペース用のAPIキーは作成できませんが、使用状況をモニタリングできます。

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

claude.aiアカウントの認証情報を使用します。サブスクリプションは月額プランで、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

検証

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

アカウントや組織を切り替える際の一般的なワークフローは次のとおりです。

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 で手動実行することも、保持する内容についてカスタム指示を追加することもできます。

非インタラクティブモード

プリントモード（-p）では、単一のクエリを実行して終了します。

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

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

終了コード：

-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-4-5-20250929

# 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

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"

PR にリンクされたセッション（v2.1.27以降、v2.1.119以降で拡張）： 特定のプルリクエストまたはマージリクエストにリンクしたセッションを開始できます。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 のソースが従来の "resume" ではなく "fork" と報告されます。そのため、ソースにマッチする hooks で両者を区別できます。¹⁹⁰ v2.1.216では、/fork の確認表示が、新しいセッション名とその claude attach id を示す1行に簡素化されました。¹⁹²

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 設定は一切回避できないため、この階層を理解することが重要です。

設定の階層

上級者向けのヒント： 共有プロジェクトで個人用の設定を指定するには、.claude/settings.local.json を使用してください（.gitignore に追加します）。バージョン管理にコミットするチーム共通の設定には、.claude/settings.json を使用します。

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

v2.1.181 以降では、/config key=value を使うと、対話型の /config UI を開かずに、プロンプトから任意の設定を直接指定できます。たとえば、/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-4-5-20250929",
  "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": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ]
  },
  "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": {
    "tips": ["Custom tip 1", "Custom tip 2"],
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "bedrock": "us.anthropic.claude-opus-4-6-20260312-v1:0",
    "vertex": "claude-opus-4-6@20260312",
    "foundry": "anthropic.claude-opus-4-6"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides は、大規模な skills ライブラリを持つチームが、ランタイムで公開する範囲をより厳密に制御したい場合に便利です。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 workflows のデフォルトは medium（「エージェント数を15未満に抑えることを目指す」）です。設定ファイルで値が指定されている間、/config 内の該当行は非表示になります。これはあくまで推奨値であり、強制的な上限ではありません。Subagentsを参照してください。¹⁹⁶

環境変数の参照

認証と API：

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers

モデル設定：

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7    # Opus 4.7 (Max/Team Premium default)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Model for subagents
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]

動作制御：

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
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+)
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_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200; /clear resets the budget; v2.1.212+)[^206]
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_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                    # Bash output limit
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]
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
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[^50]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Disable 1M context window (use standard 200K)[^103]
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_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+)
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+)
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 リクエストのスパン属性： stop_reason、gen_ai.response.finish_reasons、user_system_prompt が、LLM リクエストのスパンで出力されるようになりました。user_system_prompt には PII が含まれる可能性があるため、OTEL_LOG_USER_PROMPTS=1 を設定した場合にのみ出力されます。¹⁵⁴

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

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 の推論強度が含まれるようになり、独自のステータス行にモデルと推論強度をまとめて表示できます。また、新しい環境変数 CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH で、OTel のコンテンツ属性に適用される 60 KB の切り捨て上限を設定できます。¹⁹⁰

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+)

Enterprise / 認証：²⁰⁷

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. Thinkingがデフォルトで有効になります。 Opus 4.8ではthinkingフィールドを指定しないリクエストはthinkingなしで実行されましたが、Opus 5では同じリクエストがadaptive thinkingを使用して実行されます。max_tokensは引き続き、thinkingと応答テキストを合わせた総出力に対する厳格な上限です。これまでthinkingなしで実行していたワークロードについては、余裕を再確認してください。以前の動作に戻すにはthinking: {type: "disabled"}を渡しますが、次の項目による制約を受けます。
2. Thinkingを無効にした場合、effortの上限はhighです。 thinking: {type: "disabled"}とeffortのxhighまたはmaxを組み合わせると、400が返されます。このチェックはリクエストごとに適用されます。同じ会話の以前のターンが受け付けられていても、thinkingを無効にしたままeffortをxhighへ引き上げると拒否されます。

Claude Code では、Opus 5のeffortはデフォルトでhighです（Claude APIでも同様）。low、medium、high、xhigh、maxの全段階を利用できます。Anthropic 自身の移行ガイダンスでは、トークン消費量より能力を重視する場合にmax effortを試すことを推奨しています。Fast modeではOpus 5を$10/$50 per MTokで利用できます（Fast Modeをご覧ください）。¹⁹⁷¹⁹⁸

Claude Fable 5（2026年6月9日）： Opusより上位に位置する新しいモデル階層です。Anthropic で最も強力かつ知能の高いモデルであり、テストされたほぼすべてのベンチマークで最先端の性能を達成し、数百万トークンにわたるコンテキストでも一貫性を維持できるよう設計されています。Fable 5は、一般利用向けに安全対策を施した「Mythos-class」のフロンティアモデルです。サイバー、バイオ・化学、モデル蒸留に関するクエリではOpus 4.8へフォールバックする安全性分類器を搭載しています（Claude Mythos 5は、認可された研究者向けにこれらの安全対策を解除した同一モデルです）。v2.1.170（2026年6月9日）からClaude Code で選択可能になりました。claude updateを実行してから/model fable（短縮エイリアス。/model claude-fable-5およびbestエイリアスでも選択可能）を使用します。サブスクリプションプランには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と同じです（adaptive thinkingのみを使用でき、temperature/top_p/top_kとbudget_tokensは削除）。ただし、新たな注意点として、thinking: {type: "disabled"}を明示すると400が返されます。thinkingなしで実行するには、thinkingパラメーター自体を省略してください。²⁰⁰

Claude Code では、Fable 5もOpus 5と同様に、すべてのeffort段階（low/medium/high/xhigh/max、デフォルトはhigh）に対応します。Fable 5ではthinkingを無効にできません。セッションのthinking切り替え、alwaysThinkingEnabled設定、MAX_THINKING_TOKENS=0はいずれも効果がなく、常にadaptive thinkingを行います。Fableファミリーの設定項目はOpusの設定項目に対応しています。ANTHROPIC_DEFAULT_FABLE_MODELではfableエイリアスが解決されるモデルを固定でき（Bedrock/Vertex/Foundryで便利です）、DISABLE_PROMPT_CACHING_FABLEではFableをプロンプトキャッシュの対象外にできます。また、エンタープライズゲートウェイではコンテンツに基づく自動フォールバックが適用されます。/model opusではOpus 5が選択されるようになりました（デフォルトはhigh effortで、特に難しいタスクには/effort xhighを使用）。Sonnet 5はv2.1.197以降、初期状態のデフォルトモデルです。最高レベルの能力が必要な場合に、/model fableでFable 5を意図的に選択してください。²⁰⁰¹⁹⁷

Opus 4.7（2026年4月16日）： 1世代前のフラッグシップモデルで、現在もすべての機能を利用できます。1Mトークンのコンテキストウィンドウを標準料金で利用でき、長いコンテキストに対する追加料金はありません。最大出力は128Kで、adaptive thinkingのみに対応し（extended thinkingは削除）、新しいxhigh effortレベルが追加されました。コーディングやエージェント型ワークロードでは、これを開始点として推奨しています。¹⁴⁵ 信頼できる知識のカットオフは2026年1月です。トレーニングデータのカットオフも2026年1月です。モデルID：claude-opus-4-7。料金はOpus 4.6と同じ入力$5/MTok、出力$25/MTokで、キャッシュ書き込みは5分が$6.25、1時間が$10、キャッシュ読み取りは$0.50/MTokです。¹⁴⁴ 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の破壊的変更（呼び出し側から確認可能）：¹⁴⁵ - 拡張思考の budget_tokens は削除されました。代わりに thinking: {type: "adaptive"} を使用してください。適応型思考はデフォルトで無効です。thinking フィールドのないリクエストは思考なしで実行されます。 - temperature、top_p、top_k のいずれかをデフォルト以外の値に設定すると、HTTP 400 が返されます。これらのパラメーターは省略し、プロンプトでモデルの動作を調整してください。 - 思考内容はデフォルトでレスポンスから省略されます。推論を再び表示するには、thinking.display: "summarized" を設定してください（製品で思考をユーザーにストリーミングする場合は必須です）。

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

Opus 4.6（旧モデル）： 1Mのコンテキストと最大128Kの出力に対応した claude-opus-4-6 として、引き続き利用できます。エージェント型コーディングの性能を高めるには、Opus 4.7への移行を検討してください。Opus 4.6は当初、2026年2月5日にリリースされました。⁷⁹¹⁴⁴ v2.1.117（2026年4月22日）以降、ProおよびMaxサブスクライバーでは、Opus 4.6とSonnet 4.6のデフォルトのeffortがhighになりました（以前は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 ベータヘッダーを使用したBatches APIでは最大300K）に対応し、思考方式は適応型のみです。信頼できる知識のカットオフは2026年1月です。料金は入力／出力1 MTokあたり$3／$15で、2026年8月31日までは導入価格の$2／$10が適用されます。Opus 4.8の$5／$25より約40%安価です。Claude Codeでは、Sonnet 5の effort パラメーターはデフォルトで high です（変更する場合は明示的に設定してください）。/model sonnet（または /model claude-sonnet-5）で選択できます。¹⁸⁰ v2.1.197（2026年6月30日）以降、新規セッションではSonnet 5がClaude Codeのデフォルトモデルとなり、初期選択肢だったOpus 4.8を置き換えました。Opusも引き続き自由に選択できます。¹⁸¹

Sonnet 4.6（2026年2月17日、現在はSonnet 5に置き換え済み）： バランス型のモデルです。claude.aiおよびClaude Cowork全体で、Sonnet 4.5に代わるデフォルトモデルとなりました。⁹³ 料金はSonnet 4.5と同じで、1 MTokあたり$3／$15です。消費トークンを抑えながら、エージェント型検索の性能が向上しています。拡張思考、適応型思考、1Mトークンのコンテキストウィンドウ（ベータ）に対応します。最大出力は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なら、1セッションあたり$0.10～$0.45です。同じセッションでもOpusでは$0.50～$2.25となり、5倍高くなります。Opusは本当に難しい問題のために取っておきましょう。¹

各モデルを使う場面

Haiku：探索、簡単なファイル検索、すぐに答えられる質問を担当するsubagentsに使用します。Opusより約5倍安く、応答も高速です。深い推論を必要としないバックグラウンドタスクに最適です。

Sonnet：コストが重要な日常開発の主力モデルです。機能の実装、バグ修正、テスト作成、コードレビューなど、ほとんどのコーディングタスクに対応できます。Sonnet 4.6は、標準料金のまま適応型思考と1Mコンテキストウィンドウに対応し、Sonnet 4.5と比べてエージェント型検索とトークン効率が向上しています。⁹³ Opus 4.7のリリース時点（2026年4月16日）では、Claude CodeでOpusがデフォルトになるのはMaxおよびTeam Premiumプランのみです。Pro、Team Standard、Enterprise、APIの各アカウントでは、EnterpriseとAPIが2026年4月23日にOpus 4.7へ切り替わるまで、Sonnet 4.6がデフォルトのままです。¹⁴⁷ トークン費用を抑えたい場合、レイテンシーを短縮したい場合、subagentの費用対効果を重視する場合はSonnetを使用してください。

Opus：2026年4月16日時点のフラッグシップティアで、MaxおよびTeam Premiumプランのデフォルトです。¹⁴⁴¹⁴⁷ 高コストな推論は、効果を発揮する場面に絞って使用しましょう。具体的には、アーキテクチャ上の判断、難しいデバッグ、複雑なシステムの理解、セキュリティ分析、長期的なエージェント型作業などです。Opus 4.7は、SWE-BenchでOpus 4.6の3倍の本番タスクを解決し、CursorBenchでは70%（Opus 4.6は58%）を記録しています。また、93件のタスクからなる社内コーディングベンチマークでは、解決率が13%向上しました。¹⁴⁴ Claude Codeでは、Opus 4.7のeffortはデフォルトで xhigh となり、/effort で調整できます（v2.1.111以降）。¹⁴⁶¹⁴⁷ Maxサブスクライバーは、Anthropic APIを通じてOpus 4.7のAuto Modeを利用でき、--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-4-5-20250929"
}

subagents専用の設定：

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

フォールバックモデルチェーン（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 を設定してください。

現在のモデルの確認

> /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、Claude Platform on AWS では利用できません。アクセスは制限されているため、アカウントマネージャーに問い合わせるか、ウェイトリストに登録してください。¹⁹⁶¹⁹⁸

料金（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倍になります） - バックグラウンドでの subagent 作業（出力を待っている人はいません） - 予算を重視するセッション

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

運用上の注意。 Fast mode には標準の Opus とは別のレート制限があり、超過すると retry-after を伴う 429 が返されます（anthropic-fast-*-tokens-* レスポンスヘッダーで残り容量を確認できます）。Fast と標準を切り替えると、プロンプトキャッシュが無効になります。速度の異なるリクエスト間ではキャッシュ済みプレフィックスが共有されないため、セッション途中で /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

Max の Auto Mode（v2.1.111以降）

--dangerously-skip-permissions に代わる、より安全な Auto Mode は、Anthropic API を介して Opus 4.7 を利用する Max 加入者に、--enable-auto-mode なしで提供されます。¹⁴⁶ Sonnet-4.6 の分類器が、実行前に各アクションを確認し、意図との一致と安全性をチェックします。注（v2.1.111以降）： --enable-auto-mode フラグは削除されました。代わりに --permission-mode auto で Auto Mode のセッションを開始してください。Auto Mode は Pro では利用できません。Anthropic の権限モードに関するドキュメントによると、Anthropic API ではデフォルトで直接利用できます。Bedrock/Vertex/Foundry（v2.1.158以降）： これらのゲートウェイでは、Opus 4.7 と Opus 4.8 の Auto Mode が CLAUDE_CODE_ENABLE_AUTO_MODE=1 によるオプトイン方式になりました。²⁰⁵ v2.1.207以降、このオプトインは廃止されています。 Auto Mode は CLAUDE_CODE_ENABLE_AUTO_MODE なしで AWS Bedrock、Google Vertex AI、Microsoft Foundry で動作します。無効化したい管理者は、管理設定の disableAutoMode を使用します。同じリリースで、Bedrock、Vertex AI、Claude Platform on AWS のデフォルトが Claude Opus 4.8 になりました。また、リポジトリの .claude/settings.local.json から autoMode 設定を読み込まなくなったため、auto-mode のルールは代わりに ~/.claude/settings.json で設定してください。¹⁸⁵

デフォルトを維持したままカスタムルールを追加する（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
    ]
  }
}

「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 コマンドが分類器を通ります。すべてのシェル呼び出しを検査したい場合、多少のレイテンシと引き換えに、より厳密な安全網を構築できます。同じリリースでは、auto-mode の拒否理由もトランスクリプト、拒否通知、/permissions の最近の拒否一覧に表示されるようになり、ブロックされたコマンドについて、その理由を確認できます。¹⁷⁹ さらに3つの堅牢化ルール（v2.1.205）。 auto modeでは、セッションのトランスクリプトファイルの改ざんがブロックされるようになりました。監査証跡そのものにはエージェントがアクセスできません。また、文脈から解決できない変数に対してrm -rfを実行する前に確認を求めます。これにより、rm -rf $DIRで$DIRが不明な場合に起きる事故を防ぎます。さらに、バックグラウンドタスクの通知には、人間による入力がなかったことが明記されるようになりました。そのため、トランスクリプト内に偽造された「ユーザーが承認した」という行を、実際の承認として扱わせることはできません。¹⁸³ 3つ目は、ぜひ理解しておきたいプロンプトインジェクション対策です。承認は承認チャネルを通じて届く必要があり、harnessでもこの前提が明示されるようになりました。

コマンド置換で破壊的操作を隠すことはできません（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.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では、段階的な提供期間中、同じ変数でオプトイン／オプトアウトを制御できます。¹⁴⁶

permission modeでの自動承認（v2.1.119以降）。 PowerShellツールのコマンドも、Bashコマンドと同じようにpermission modeで自動承認を受けられるようになりました。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を使用している場合はアップグレードしてください。

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以降）。¹³⁷

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

レート制限（2025年8月）： Anthropic は、有料サブスクライバーを対象に週間レート制限を導入しました。Maxサブスクライバーは、レート制限を超える追加利用枠を標準のAPI料金で購入できます。¹⁴

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

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

API従量課金ユーザー向けの、100万トークンあたりの料金です。

1Mコンテキストの料金（2026年4月）： Opus 4.7、Opus 4.6、Sonnet 4.6、Mythos Previewでは、いずれも標準のMTok単価で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%の節約になります。同じコンテキストを繰り返し使用する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にも適用されます。上限に達すると、新しいsubagentsの起動は拒否され、実行中のバックグラウンドエージェントも停止します（以前は、バックグラウンドエージェントが予算上限の対象外でした）¹⁹⁴
5. 調査にはプランモードを使用する：実行を伴わないため、意図せず高額な処理が走ることを防げます
6. 早めにコンパクト化する：コンテキストが小さければ、トークン数も減ります
7. 出力を制限する：export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. 緊急性の低い作業にはBatch APIを使用する：入力と出力の両方が50%割引になります

使用量の監視

• 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 4.7 (xhigh effort default)
                  │         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

目安：MaxとTeam Premiumでは、Opus 4.7がデフォルトです。Pro/Team Standard/Enterprise/APIではSonnet 4.6がデフォルトです（Enterprise + Anthropic APIは2026年4月23日にOpus 4.7へ切り替わります）。¹⁴⁷ subagentsにはHaikuを使いましょう。Sonnetの回答が浅いと感じたら、Opusへ切り替えます。agent teams（v2.1.32以降）では、Opusが異なるサブタスクに並行して取り組む複数のエージェントを連携させられます。⁷⁹

コマンド、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とプロンプトのどちらを使うべきか？

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を明示的に制御する必要はありません。難しい問題では思考量を増やし、単純な問題では高速に処理します。手動でthinkingを切り替える操作は、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のみで、出力速度が最適化されます。安価なモデルへ切り替わるわけではなく、料金もMTokあたり$10/$50のため、コストが下がるわけではありません。¹⁹⁶¹⁹⁸

権限システムの仕組み

Claude Code の権限システムでは、実行可能な操作をきめ細かく制御できます。セキュリティとワークフロー効率の両面で、この仕組みを理解することが不可欠です。組織全体に権限を適用する管理設定については、Enterprise 環境への導入もご覧ください。

権限レベル

読み取り専用ツール（自動承認）： - Read - ファイルの内容を読み取る - Glob - パターンに基づいてファイルを検索する - Grep - ファイルの内容を検索する - WebSearch - Web を検索する - 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 には、2025年から claude.ai 上の Claude が備えていたものと同じ会話終了機能が追加されました。極めて悪質な入力や執拗な jailbreak の試みに対しては、組み込みの EndConversation ツールを介して Claude がセッションを直ちに終了できる場合があります。これは不正利用への耐性とモデルのウェルビーイングを目的とした措置であり、ワークフロー機能ではありません。通常の開発セッションで作動することはありません。¹⁹⁰¹⁹³

権限モード

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

コード実行に関わる設定ファイルは、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 をより安全に置き換えるモードです。独立した分類モデル（Sonnet 4.6）が、実行前に各操作を審査し、ユーザーの意図に沿っているか、安全かを確認します。¹²⁴

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

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

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

# Enable at startup
claude --enable-auto-mode

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

提供対象：まず Team プランのユーザーに提供され、その後 Enterprise と API に展開されます。Sonnet 4.6または Opus 4.6が必要です。¹²⁴

YOLO モード（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"
  }
}

権限ルールの構文

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

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:*) のようにコマンド全体を拒否してください。

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

{
  "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）。 Write(path)、NotebookEdit(path)、または Glob(path) を対象として記述された権限ルールについて、Claude Code が起動時に警告を表示するようになりました。標準形式は、実際にファイルアクセスを制御する2つのルール群です。Edit(path) はすべてのファイル書き込みツール（Write と NotebookEdit を含む）を対象とし、Read(path) はすべてのファイル読み取りツール（Glob を含む）を対象とします。警告を解消し、意図を明確に保つため、従来のルールを移行してください。¹⁸⁷

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

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 形式の起動だけでなく、特定の名前付き agent が起動される場合（workflow、--agents、agent team 経由）にも適用されます。起動時にブロックされるため、制限対象の名前付き agent がルールを回避できていた抜け道が解消されました。¹⁷⁵

WebFetch のパターン：

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

追加ディレクトリ

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

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

monorepo を扱う場合や、Claude が兄弟ディレクトリ内のコードを参照する必要がある場合、追加ディレクトリの設定が不可欠です。

Sandbox モード

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

> /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 設定により、sandbox 化されたコマンドが認証情報ファイルや秘密の環境変数を読み取れないようにできます。sandbox 化されたコマンドによる機密情報の持ち出しを防ぐ、多層防御となります。¹⁷⁶

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

v2.1.219以降、sandbox.network.strictAllowlist 設定では、許可リストにないホストを確認なしで即座に拒否できます。既定では、sandbox 化されたコマンドが allowedDomains にないホストへ接続すると、権限確認が表示されます。strictAllowlist を有効にすると、接続はそのまま拒否されます。CI、バックグラウンド agent、夜間ループなど、誰にも応答されない確認によって処理が停止する無人実行では、この設定が適しています。このような環境では、「想定外の外向き通信について確認する」という方針そのものが不適切です。これでネットワーク制御の3要素が揃います。allowedDomains は許可対象を定め、deniedDomains（後述）は広範な許可から例外を除外し、strictAllowlist はそれ以外を確認するか失敗させるかを決定します。¹⁹⁶

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

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

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

.claude/ の agent 設定に関する例外（v2.1.121以降）： --dangerously-skip-permissions では、.claude/skills/、.claude/agents/、.claude/commands/ への書き込み時に確認が表示されなくなりました。¹⁵⁴

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

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

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

• sandbox.network.deniedDomains は、より広範な allowedDomains のワイルドカードで許可されるホストでも、個別にブロックします。許可ポリシー全体を書き換えることなく、pastebin、ファイル共有サービス、既知の悪意あるホストへのアクセスを遮断できます。許可リスト外へのアクセスを確認せずに拒否したい場合は、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 強化：¹⁹⁰

このリリースでは、権限チェックの複数の抜け道が一括して解消されました。いずれも 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 を扱う「どの Hook タイプを選ぶか？」の決定木については、意思決定フレームワークをご覧ください。

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

利用可能なイベント

SessionStart の source 値。 SessionStart hook の入力には、セッションがどのように開始されたかを示す source フィールドが含まれます。値は "startup"、"resume"、"clear"、"compact" のいずれかです。v2.1.214 以降、fork として新規開始したセッションは "resume" ではなく source: "fork" と報告されます。これは、v2.1.212で /fork がバックグラウンド化された変更に対応する hook 側の仕様です。SessionStart hook が source によって分岐している場合（たとえば、"resume" の場合にのみコンテキストを再注入する場合）は、マッチ対象のリストに "fork" も追加してください。¹⁹⁰

Hook の設定

settings.json または専用の hooks.json で hooks を定義します。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/inject-context.sh"
          }
        ]
      }
    ]
  }
}

マッチャー

matcher フィールドでは、どのツールが hook をトリガーするかを指定します。

{"matcher": "*"}              // Match all tools
{"matcher": "Bash"}           // Match Bash only
{"matcher": "Edit|Write"}     // Match Edit or Write
{"matcher": "mcp__github"}    // Match MCP server tools
{"matcher": ""}               // Match for events without tools (like UserPromptSubmit)

複数のツールをマッチさせるには | を使用します（Edit|Write）。v2.1.191 以降、カンマ区切りのマッチャー（例：Bash,PowerShell）も正しく発火します。それ以前のバージョンでは暗黙に無視されていたため、カンマを含むマッチャーの hook は実行されませんでした。¹⁷⁸ v2.1.195 以降は、ハイフンを含む識別子のマッチャー（例：code-reviewer、mcp__brave-search）が誤って部分一致せず、完全一致するようになりました。そのため、単に同じ文字列を含むだけの意図しないツールでマッチャーが発火することはありません。ハイフンを含む MCP サーバーの全ツールにマッチさせるには、mcp__brave-search__.* のような明示的なパターンを使用してください。¹⁷⁹

v2.1.214 以降、Hook の if: パス条件は cwd を基準にスコープされます。 権限の許可ルールにも適用された単一セグメントのスコープ変更（権限ルールの構文を参照）が、hook の if: 条件にも適用されます。dir/** のような条件は、ツリー内にあるすべての dir/ ではなく、<cwd>/dir のみにマッチするようになりました。任意の深さに再びマッチさせるには、**/dir/** と記述してください。¹⁹⁰

Hook の入出力プロトコル

Hooks は stdin から JSON を受け取ります。

{
  "tool_name": "Bash",
  "tool_input": {
    "command": "npm test",
    "description": "Run test suite"
  },
  "session_id": "abc-123"
}

Hook イベントの拡充（v2.1.69以降）： subagent または --agent セッションからトリガーされた場合、すべての hook イベントに agent_id と agent_type フィールドが含まれるようになりました。また、ステータスラインの hook コマンドには worktree フィールドも追加されています。¹¹⁰

Stop/SubagentStop hooks（v2.1.47以降）は、Claude の最終応答テキストを格納した last_assistant_message フィールドも受け取ります。これにより、トランスクリプトファイルを解析せずに出力を確認できます。

{
  "session_id": "abc-123",
  "last_assistant_message": "I've completed the refactoring. Here's what changed..."
}

ブロックしないソフトフィードバック（v2.1.163以降）： Stop および SubagentStop hooks は、JSON 出力で hookSpecificOutput.additionalContext を返すことにより、応答を hook エラーとして扱わせることなく、Claude にフィードバックを渡してターンを継続できます。従来、Stop hook が実質的に使える手段は終了コード2によるブロックだけでした。これはエラーとして扱われ、連続ブロック回数の上限にも加算されます。additionalContext により、「見落とした点を示して続行させる」ための誘導チャネルが追加され、ループの動作を妨げずに済みます。²⁰³

終了コードによって動作が決まります： - 0：成功：操作を続行します。Stdout は詳細モード（Ctrl+O）で表示されます。UserPromptSubmit と SessionStart では、stdout がコンテキストに追加されます。 - 2：ブロッキングエラー：操作を停止します。Stderr がエラーメッセージとして Claude に返されます。 - 1、3など：非ブロッキングエラー：操作を続行します。Stderr は詳細モードで警告として表示されます。

高度な制御では、hooks から JSON を出力できます。

{
  "decision": "allow",
  "message": "Command validated and modified",
  "modifications": {
    "tool_input": {
      "command": "npm test -- --coverage"
    }
  }
}

PreToolUse の決定制御（推奨形式）： PreToolUse hooks では、hookSpecificOutput を使用すると、3種類の結果（許可／拒否／確認）に加え、ツール入力の変更やコンテキストの注入も行えます。⁸⁹

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "allow",
    "permissionDecisionReason": "Command validated and modified",
    "updatedInput": {
      "command": "npm test -- --coverage --ci"
    },
    "additionalContext": "Note: This database has a 5-second query timeout."
  }
}

注： PreToolUse では、トップレベルの decision および reason フィールドは非推奨です。代わりに hookSpecificOutput.permissionDecision と hookSpecificOutput.permissionDecisionReason を使用してください。その他のイベント（PostToolUse、Stop など）では、引き続きトップレベルの decision を使用します。⁸⁹

UserPromptSubmit のセッションタイトル（v2.1.94以降）： UserPromptSubmit hooks では、hookSpecificOutput.sessionTitle を使用してセッションタイトルを設定できます。¹⁴⁰

非同期 Hooks（2026年1月）

Hooks をバックグラウンドで実行し、Claude Code の処理をブロックしないようにできます。hook の設定に async: true を追加してください。⁸¹

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/notify-slack.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

非同期 hooks が適している場合： - セッションを遅延させるべきではない通知（Slack、メール、Pushover） - バックグラウンドで実行できるログ記録やテレメトリ - 重要度の低い後処理（分析、バックアップ）

非同期 hooks を使用すべきでない場合： - フォーマット処理（次の編集前に完了する必要があります） - 検証（失敗時にブロックする必要があります） - ツールの入出力を変更する必要がある hook

プロンプトベースおよびエージェントベースの Hooks（v2.1.32以降）

シェルコマンド hooks（type: "command"）に加え、Claude Code はスクリプトではなく AI の推論で条件を評価する、LLM を利用した2種類の hook をサポートしています。⁸⁹

Prompt hooks（type: "prompt"）は、高速な Claude モデルに単一ターンのプロンプトを送ります。モデルは許可する場合に { "ok": true }、ブロックする場合に { "ok": false, "reason": "..." } を返します。

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "Evaluate if Claude should stop: $ARGUMENTS. Check if all requested tasks are complete and tests pass.",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

HTTP hooks（type: "http"）は、イベントの JSON 入力を POST リクエストとして URL に送信し、JSON を受け取ります。webhooks、外部通知サービス、API ベースの検証に使用できます（v2.1.63以降）。¹⁰⁴

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "http",
            "url": "https://api.example.com/notify",
            "headers": {
              "Authorization": "Bearer $MY_TOKEN"
            },
            "allowedEnvVars": ["MY_TOKEN"]
          }
        ]
      }
    ]
  }
}

HTTP hooks は、コマンド hooks と同じ決定形式を使用します（decision と reason を含む JSON を返します）。サンドボックスが有効な場合は、サンドボックスのネットワークプロキシ経由でルーティングされます。SessionStart/Setup イベントには対応していません。

Agent hooks（type: "agent"）は、ツール（Read、Grep、Glob）へアクセスできる subagent を起動し、複数ターンの検証を行います。実際のファイルやテスト出力を確認する必要がある場合に使用してください。

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "agent",
            "prompt": "Verify all unit tests pass. Run the test suite and check results. $ARGUMENTS",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

Hook の JSON 入力を表すプレースホルダーとして $ARGUMENTS を使用します。どちらのタイプも model（デフォルトは高速モデル）と timeout フィールドをサポートします。対応イベントは PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、UserPromptSubmit、Stop、SubagentStop、TaskCompleted です。TeammateIdle は prompt/agent hooks に対応していません。

MCP ツール Hooks（v2.1.118以降）

type: "mcp_tool" を使用して、hook から MCP ツールを直接呼び出せるようになりました。サーバーを呼び出す Bash サブプロセスでラップする必要がありません。¹⁵²

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "mcp_tool",
            "server": "linear",
            "tool": "create_comment",
            "input": {"issue_id": "ENG-123", "body": "Auto-updated by Claude Code"}
          }
        ]
      }
    ]
  }
}

ユーザーがすでに設定している MCP サーバーとの相性に優れており、/mcp からアクセスできるすべてのツールを hook から呼び出せます。

PostToolUse Hooks の duration_ms（v2.1.119以降）

PostToolUse および PostToolUseFailure hook の入力に、権限確認と PreToolUse hooks の時間を除いたツールの実行時間 duration_ms が含まれるようになりました。¹⁵² 遅いツールの検出、監査ログ、ツールごとのレイテンシ指標に役立ちます。

# Stderr-flagged warning when an Edit takes more than 10 seconds
DUR=$(jq -r '.duration_ms')
if [ "$DUR" -gt 10000 ]; then
  echo "[slow-edit] ${DUR}ms — investigate $TOOL_INPUT_FILE_PATH" >&2
fi

すべてのツールに対応した updatedToolOutput（v2.1.121以降）

v2.1.118では、MCP ツール Hooks に hookSpecificOutput.updatedToolOutput を使ってツール出力を置き換える機能が追加されました。v2.1.121以降、同じフィールドをあらゆる PostToolUse hook で使用できます。対象には、組み込みツール（Bash、Read、Edit、Glob、Grep など）、subagent ツール、MCP ツールが含まれます。用途としては、あらゆるツール出力からの機密情報の墨消し、後続処理向けの構造の正規化、エージェントが結果を読み取る前のメタデータ注入などがあります。¹⁵⁴

Hook の環境変数

Hooks では、パスの解決に次の環境変数を使用できます。⁸⁹

SessionStart から環境変数を永続化する方法：

#!/bin/bash
if [ -n "$CLAUDE_ENV_FILE" ]; then
  echo 'export NODE_ENV=production' >> "$CLAUDE_ENV_FILE"
fi
exit 0

HTTP hook のセキュリティ（v2.1.51以降）： ヘッダーに環境変数を展開する HTTP hooks では、明示的な allowedEnvVars リストが必要になりました。これにより、ヘッダー値を通じた任意の環境変数の流出を防止します。サンドボックスが有効な場合、HTTP hooks はサンドボックスのネットワークプロキシ経由でもルーティングされ、ドメインの許可リストが適用されます。HTTP hooks は SessionStart/Setup イベントには対応していません。⁹⁸

{
  "hooks": {
    "PostToolUse": [{
      "hooks": [{
        "type": "command",
        "command": "curl -H 'Authorization: Bearer $MY_TOKEN' https://api.example.com/notify",
        "allowedEnvVars": ["MY_TOKEN"]
      }]
    }]
  }
}

Hook とワークスペースの信頼（v2.1.51以降）： statusLine および fileSuggestion の hook コマンドをインタラクティブモードで実行するには、ワークスペースの信頼を承認する必要があります。これにより、潜在的なセキュリティ上の経路が閉じられました。⁹⁸

実践的な Hook の例

編集後に TypeScript ファイルを自動フォーマットする：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c '[[ \"$FILE_PATH\" == *.ts ]] && npx prettier --write \"$FILE_PATH\" || true'"
          }
        ]
      }
    ]
  }
}

すべての bash コマンドを記録する：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' >> ~/.claude/bash-history.log"
          }
        ]
      }
    ]
  }
}

機密ファイルへのアクセスをブロックする：

#!/bin/bash
# .claude/hooks/protect-files.sh
data=$(cat)
path=$(echo "$data" | jq -r '.tool_input.file_path // empty')

if [[ "$path" == *".env"* ]] || [[ "$path" == *"secrets/"* ]] || [[ "$path" == *".pem"* ]]; then
  echo "Blocked: Cannot access sensitive file $path" >&2
  exit 2  # Exit 2 = block the tool call. Exit 1 = non-blocking error (hook failure only).
fi
exit 0