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

要約： Claude Code は、コードベースを読み取り、コマンドを実行し、ファイルを編集するエージェント型の CLI です。構成、権限、hooks、MCP、subagents という5つのシステムによって制御されます。毎回必ず実行する必要がある処理には、プロンプトではなく hooks を使用してください。

現状（CLI v2.1.292、2026年10月6日。npm の latest と next は 2.1.292、stable は 2.1.285）：²³⁴

• デフォルトモデル：Claude Opus 5.5（claude-opus-5-5）。Pro、Max、Team、Enterprise、Anthropic API のほか、AWS、Amazon Bedrock、Google Cloud の Agent Platform 上の Claude Platform でもデフォルトとなります。Microsoft Foundry は例外で、デフォルトは Sonnet 4.5、opus エイリアスは Opus 4.6 を指します。²²¹
• Opus 5.5 の概要： 100万トークンあたり $4/$20、キャッシュ読み取りは $0.20 です。Anthropic API ではデフォルトで1Mコンテキストに対応し、v2.1.287以降は Bedrock、Agent Platform、Foundry でも利用できます。デフォルトの effort は medium で、thinking は無効化できません。Fast mode では $8/$40 となります。タスクに Opus が必要ない場合は、Sonnet 5.5（$2/$10、v2.1.284以降の Anthropic API では sonnet）のほうが低コストです。^{220222223228232}
• Auto mode は、すべてのプランとプロバイダーにおいて、対話型ターミナルおよび VS Code セッションの初期権限モードです（v2.1.283～284）。一方、claude -p と Agent SDK のセッションは、--permission-mode auto を渡さない限り Manual で開始します（v2.1.302では、サードパーティープロバイダーの利用時とテレメトリー無効時について、v2.1.285で導入された Auto での開始が取り消されました）。²⁷⁵ 安全性チェックは、Enterprise および Claude API アカウント、AWS、Bedrock、Agent Platform、Foundry 上の Claude Platform、ならびにゲートウェイ経由の利用では、サーバー側で無料実行されます。それ以外では、有料のローカルチェックがフォールバックとして使用されます。^{219227228229230}
• AGENTS.md： v2.1.277以降、プロジェクトに CLAUDE.md がない場合は、AGENTS.md がプロジェクト指示として読み込まれます。ただし、機能フラグを取得しない環境（Bedrock など）と、インストールまたはアップグレード後の最初のセッションは除きます。²¹⁹²²³

リリースごとの履歴は、変更履歴をご覧ください。

Claude Code はチャットインターフェースではなく、エージェント型システムとして動作します。 CLI はコードベースを読み取り、コマンドを実行し、ファイルを変更し、git ワークフローを管理します。さらに、MCP を介して外部サービスに接続し、複雑なタスクを専門の subagents に委任します。これらはすべて、開発者が普段使うワークフローに組み込めるコマンドラインインターフェースを通じて行われます。2026年2月時点では、公開されている GitHub コミットの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 を使用してください。
• モデルを階層的に使い分ければ、品質を損なわずにコストを抑えられます： subagents による調査には低コストのモデルを割り当て、本格的なアーキテクチャ上の推論にだけ 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

プロキシまたはゲートウェイ環境では、2.1.275だけは絶対に固定しないでください。 このビルドでは、ANTHROPIC_BASE_URLがプロキシまたはゲートウェイを指していると、すべてのリクエストが400 ... Input tag 'advisor_20260301'で失敗します。この不具合は2.1.276で修正されています。²¹⁸

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は、LLMゲートウェイによるルーティングや監視に利用できるリクエストヘッダーを追加できます。対象は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です。さらにv2.1.283以降では、1つのユーザープロンプトに対応するすべてのリクエストで共有され、subagentのターンも対象となるランダムなUUID、x-claude-code-prompt-idも追加されます。²¹⁷²²⁶ カスタムベースURLやBedrockなどのサードパーティプロバイダーを介する場合、CLAUDE_CODE_GATEWAY_HINT_HEADERS=1を設定するまで、これらのヘッダーは無効です。ゲートウェイプロトコルのドキュメントでは、Anthropic APIへの直接接続時にはデフォルトで送信され、CLAUDE_CODE_GATEWAY_HINT_HEADERS=0を設定すると、すべての接続で送信を停止できることも説明されています。²²⁷

確認

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へのアクセスも要求されます。²¹⁷

v2.1.286以降、claude auth statusでは、Consoleサインインで保存されたAPIキーがclaude.aiではなくapi_keyとして報告されます。²³¹

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

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）では、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 における 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階層が見えないままになるところでした。¹⁹⁶

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

ハングした -p 実行がエラーで終了するようになりました（v2.1.277）： 内部エラーが発生した claude -p と Agent SDK セッションは、以前は結果を返さずハングする場合がありました。外部タイムアウトでしか実行を終了できない、パイプラインにとって最悪の障害モードです。現在はエラーを報告し、終了コード1で終了するため、後述の終了コード表が再び完全な仕様となりました。同じリリースでは、ヘッドレスセッションの終了時にコストと使用量の合計も保存されるようになりました。ヘッドレスでの再開（claude -p --resume、SDK、VS Code 拡張機能のウィンドウ再読み込み）でセッションの合計値がゼロから始まらなくなり、再開されたヘッドレス実行をまたいだコスト計算の過少集計を防げます。²¹⁹

終了コード：

-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+); only CLI-named MCP servers (v2.1.286)
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）： 無人ホスト向けの関連オプションです。権限確認プロンプトが必要になる操作はすべて自動的に拒否されますが、有効な権限モード（自動モードを含む）は、ユーザーの操作なしで判断できる内容について引き続き処理します。プロンプトを拒否するのではなく MCP ツールへ委任する --permission-prompt-tool と混同しないでください。CLI の参照ページにはまだこの新しいフラグが掲載されていないため、CHANGELOG が情報源となります。²¹¹

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

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

--bare の制限が確実に適用されるようになりました（v2.1.286）： --bare は、コマンドラインで指定された MCP サーバーだけに接続し、モデルへシステムリマインダーを送信せず、バックグラウンドタスクも開始しなくなりました。タイムアウトに達したシェルコマンドは、バックグラウンドへ移動せず停止します。ヘッドレス実行のドキュメントによると、v2.1.286より前はこれらの制限が部分的にしか適用されていませんでした。また、スクリプトや SDK の呼び出しには --bare が推奨されています。²³¹²³³

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"

# Open the Claude desktop app on this directory, or on a session (v2.1.285)
claude --desktop
claude --desktop --continue

実行中のセッションを /cd で移動する（v2.1.169以降、v2.1.246以降は設定を即時反映）： /cd path を実行すると、プロンプトキャッシュを損なわずに作業ディレクトリを変更できます。v2.1.246以降は、移動先ディレクトリのプロジェクト設定、hooks、.mcp.json サーバー（通常どおり承認プロンプトが表示されます）、skills、エージェントが、--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 として "fork" を報告します（以前は "resume"）。そのため、source を照合する hooks で両者を区別できます。¹⁹⁰ v2.1.216では、/fork の確認メッセージが、新しいセッション名と claude attach id を示す1行に簡素化されました。¹⁹² v2.1.221以降、フォークされたセッションは元のセッションのチェックアウトを使わず、独自の worktree を作成します。これにより、別の案を検討するフォークがメインセッションの未コミットファイルと衝突するという、実験用コピーを送り出す際の危険な問題が解消されました。¹⁹⁹ v2.1.232では、subagents でもフォークがデフォルトになりました。subagent_type: "fork" の subagent は会話全体とプロンプトキャッシュを継承し、インタラクティブセッションで生成されるチームメイト以外のエージェントは、デフォルトでバックグラウンド実行されるようになりました。²⁵⁵

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

プランモード

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

プランモードに入る：

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

プランモードで利用できるツール： Read、Glob、Grep、LS、WebSearch、WebFetch、AskUserQuestion。編集ツール（Edit、Write、Bash、NotebookEdit）はブロックされます。

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

承認時のコンテキスト自動クリアが推奨されるワークフローです。プランの実行に新しいコンテキストウィンドウを使用できるため、プランへの忠実度が大幅に向上します。過去の会話に妨げられず、Claude がより長く方針を維持できます。

プランモードを使う場面： - アーキテクチャ上の判断を伴う新機能の実装 - 最初に方針をレビューしたい複数ファイルのリファクタリング - 変更前に調査が必要な、慣れていないコードベース - 複数の有効なアプローチがあり、判断に関与したいタスク

上級者向けヒント： プランモードに十分な時間をかけるほど、Claude が実装に成功する可能性は高まります。プランモードでは、リスクのあるツール呼び出しや無駄な編集を行わずに調査できます。積極的に活用しましょう。

スクリーンリーダーモード（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 の公式ドキュメントには、新しいアクセシビリティページが用意され、このモードと操作方法が説明されています。¹⁸⁶

各行の前で一時停止しなくなりました（v2.1.287）： スクリーンリーダーモードでは、新しい行や変更された行を出力する前に、行頭へカーソルを置いて一時停止しなくなりました。CLAUDE_AX_PREPARK_MS では、その一時停止時間をミリ秒単位で設定できます。デフォルト値は従来の 50 から 0 へ変更されたため、元に戻すには CLAUDE_AX_PREPARK_MS=50 を設定してください。同じリリースでは、検索ボックスでカーソルが入力済みテキストから離れた位置に表示される問題や、編集承認プロンプトに変更行が表示されない問題など、一連のスクリーンリーダー関連の不具合も修正されました。²³²²³³

設定システムの詳細

Claude Code は階層型の設定システムを採用しています。上位の階層は下位の階層を上書きし、エンタープライズ設定はいっさい回避できません。そのため、この階層構造を理解しておくことが欠かせません。

設定の階層

プロンプトから設定を変更する：/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-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"
  },
  "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": {
    "claude-opus-5-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-sonnet-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides は、チームが大規模な skill ライブラリを抱えつつ、実行時に公開する範囲を絞り込みたい場合に役立ちます。off を指定すると、その skill はモデルからもスラッシュピッカーからも見えなくなります。user-invocable-only を指定すると、名前による呼び出しは可能なままモデルの選択対象からは外れます。name-only を指定すると、完全な説明は表示されず skill 名だけが見える状態になります。¹⁵⁶

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

• availableModels / enforceAvailableModels（マネージド、v2.1.175 以降）： availableModels 許可リストは、セッションで選択できるモデルを制限します。enforceAvailableModels: true を指定すると、許可リストは Default モデルにも適用されます。Default が許可されていないモデルに解決される場合は、許可された最初のモデルにフォールバックします。さらに、ユーザー設定やプロジェクト設定でマネージドな availableModels リストを広げることもできなくなります。関連する修正（v2.1.176）では、エイリアスの選択が ANTHROPIC_DEFAULT_*_MODEL 経由でブロック対象のモデルにリダイレクトされうる抜け穴が塞がれました。また /fast は、許可リスト外のモデルへの切り替えを拒否するようになっています。¹⁷² v2.1.187 以降、組織は /model ピッカー、--model、/model、ANTHROPIC_MODEL のすべてにわたってモデル制限を直接適用できます。制限されたモデルを選択すると、「restricted by your organization’s settings」というメッセージが表示されます。¹⁷⁶
• language（v2.1.176 での改良）： 応答言語の設定に加えて、セッションタイトルもデフォルトで会話の言語で生成されるようになりました。タイトルの言語を固定したい場合は language を設定してください。¹⁷²
• footerLinksRegexes（v2.1.176）： 正規表現にマッチしたリンクをフッター行にバッジとして表示します。ユーザー設定またはマネージド設定で構成できます。¹⁷²
• 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 で設定してください。これにより、クローンしたリポジトリに auto モードの設定を仕込まれる経路が塞がれます。¹⁸⁵

新しい設定（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）： 動的ワークフローのサイズに関する推奨ガイドラインを、/config だけでなくユーザー、プロジェクト、マネージドのいずれの設定ファイルからも設定できます。動的ワークフローのデフォルトは medium のガイドライン（「エージェント数は 15 未満を目安に」）です。設定ファイルで値が指定されている間は、/config の該当行は表示されません。あくまで推奨値であり、強制される上限ではありません。Subagentsを参照してください。¹⁹⁶

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

• modelPicker（ユーザーまたはマネージド、v2.1.242 以降）： 順序とラベル付きのモデル一覧で /model ピッカーの内容を整えられます。値はオブジェクトで、options 配列（各行には必須の model と、任意の label および description を指定します。model はそのまま解釈されるため、エイリアス、Anthropic ID、Bedrock/Vertex/Foundry/ゲートウェイの ID のいずれも使えます）と、任意の Boolean 値 replaceBuiltInOptions を持ちます。replaceBuiltInOptions がデフォルトの false なら組み込みのラインナップの後ろに行が追加され、true なら自分で定義した行、Default、そしてセッションですでに使用中のモデルだけが表示されます。Claude Code はこのキーをマネージド設定、--settings、ユーザー設定から読み込み、プロジェクト設定とローカル設定では無視します。そのため、クローンしたリポジトリがピッカーのラベルを書き換えることはできません。ラインナップ全体は、このキーを設定している最上位のソースから提供されます。availableModels 許可リストは引き続きすべての行に適用されます。また、ラベルが変えるのはピッカーの表示だけで、実際に動くモデルは変わりません。²⁵⁰²⁴⁸
• promptCacheTtl / subagentPromptCacheTtl（任意のファイル、v2.1.242 以降）： リクエストの区分ごとに "5m" または "1h" を指定します。これにより、API キーやクラウドプロバイダーを利用するユーザーは、メインの会話では 1 時間のキャッシュを保ちつつ、subagents は 5 分のままにできます。キャッシュ戦略を参照してください。²⁵⁰²⁴⁸
• modelPricing（マネージド、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 キーも追加されたため、組織独自のヒントを組み込みのヒントと並べてローテーション表示できます（上の例は拡張後の形式です）。settings リファレンスにも新しいキーが記載されています。²⁴⁵²²⁷

新しい設定（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 を設定できなくなりました。これらはシェル、ユーザー設定、または managed settings で設定してください。クローンしたリポジトリによって、Claude Code が設定ファイルや一時ファイルを書き込む場所をリダイレクトされないようにするための変更です。²⁰⁶

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

• timeFormat / timeZone（v2.1.257）： Claude Code が時刻をどう表示するかを制御します。対象はターン終了時の完了時刻とトランスクリプトのタイムスタンプです。timeFormat には12時間制、24時間制、24時間制UTC、または明示的な strftime パターンを指定でき、timeZone ではタイムゾーンを指定します。²¹¹ settings リファレンスにも両方のキーが記載されています。²²⁷
• permissions.blockReadsOutsideWorkingDirectories（v2.1.257）： セッションの作業ディレクトリ外にあるファイルの読み取りを一律に拒否します。この設定がない場合、auto mode ではセッションで初めてそうした読み取りを行う前に一度だけ確認が入るようになりました（Auto Mode を参照）。²¹¹ v2.1.273 では2つの抜け穴が塞がれました。チェッカーが完全には解析できない Bash コマンドは、チェックをスキップせず確認を求めるようになりました。また、この設定のもとでは、リポジトリの設定で指定されたメモリディレクトリは読み込み、想起、インデックス化のいずれも行われません。²¹⁷
• managedMcpServers / managedSourcesBehavior： managed スコープのキーで、Enterprise Deployment で解説しています。前者は組織が全ユーザーに MCP サーバーを提供するためのもの（v2.1.259）、後者は複数の managed ソース間でのオプトイン方式のマージです（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.277 で廃止されました。 非推奨だった TaskOutput ツールが削除され、Claude はバックグラウンドタスクの出力ファイルを Read で読むようになりました。そのため taskOutputMaxChars と TASK_MAX_OUTPUT_LENGTH はもう効果がありません。bashOutputMaxChars には影響しません。²¹⁹

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

• maxEffortLevel（v2.1.267）： ユーザーが選べる effort レベルに上限を設けます。トップレベルでも、modelSettings でモデルごとにも指定でき、Bedrock、Vertex、Foundry を含むすべてのプロバイダーに適用されます。上限より低いレベルは引き続き選択できます。/effort に対する管理者側の設定です。²¹⁶
• advisorModel： /advisor がユーザー設定に書き込む、保存済みの advisor モデルです（fable、opus、sonnet、または完全なID）。1セッションだけ変えるなら --advisor で上書きでき、CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 でツール自体をオフにできます。The Advisor Tool をご覧ください。²⁷⁴
• sandbox.allowNestedUserNamespaces（v2.1.305）： Linux と WSL2 で、サンドボックス内のコマンドがユーザー名前空間を作成できるようにします（Chromium、rootless podman など）。これによりサンドボックスのファイル保護を回避できてしまうため、この設定はユーザー設定または managed settings からのみ読み込まれます。Sandbox Mode をご覧ください。²⁷⁸²⁷⁹
• bashEditDiffEnabled（v2.1.269）： Bash ツールがファイルを編集した場合、コマンドが変更したファイルの diff がツール結果に含まれます。sed のような編集が実際に何をしたのかを会話上で確認できます。²¹⁶

新しい設定（v2.1.275）：

• syncClaudeAiSkills / syncClaudeAiPlugins（v2.1.275）： claude.ai アカウントで有効にしている skills と plugins が、同じアカウントでサインインしたターミナルセッションに同期されるようになりました。どちらかのキーを false にすると、ターミナルセッションではローカルの skills と plugins だけを使います。Skills と Plugin System をご覧ください。²¹⁸

新しい設定（v2.1.282-283）：

• maxProseWidth（v2.1.282）： 幅の広いターミナルで、Claude の文章が広がる幅に上限を設けます。段落、見出し、リスト、引用はこのカラム数の範囲で折り返され、テーブルとコードブロックは全幅のまま表示されます。値はカラム数を表す整数で、最小値は40です。²²⁵²²⁷
• deniedModels / availableModelsMatch（managed、v2.1.283）： deniedModels は、availableModels で許可されていても特定のモデルをブロックします。"opus" のようなファミリーエイリアスを指定するとファミリー全体がブロックされ、"claude-opus-5" を指定すると Opus 5.5 もブロックされます（Opus 5 だけをブロックするには "claude-opus-5-0" と書きます）。デフォルトでは、"claude-opus-5" のような availableModels のエントリは、その名前を拡張した後続バージョンも許可します。availableModelsMatch: "exact" にすると各エントリは指定したバージョンだけを許可するため、新しいリリースはリストに追加するまでブロックされたままになります。Claude Code はどちらのキーも managed settings からしか読み込みません。²²⁶²²⁷
• allowClaudeInChromeWithManagedMcp（managed、v2.1.282）： 排他的な managed-mcp.json がある環境でも claude --chrome を実行できるようにします。Chrome がブロックされたときのエラーには、このキー名が表示されるようになりました。²²⁵ settings リファレンスにも記載されています。このキーはデバイス自身の managed settings からのみ読み込まれ、claude-in-chrome を対象とする deniedMcpServers のエントリがあれば、サーバーは引き続きブロックされます。²³³

新しい設定（v2.1.285）：

• allowedProviders（managed、v2.1.285）： マシンが使用できる API プロバイダーを制限します。対象は Anthropic API、カスタムエンドポイント、Bedrock、Mantle、Vertex AI、Foundry、Claude Platform on AWS、Cloud ゲートウェイです。²²⁹ settings リファレンスにこのキーが記載されています。server-managed settings からもリストが配信される場合、マシン自身の管理者ソースのリストも引き続き適用されるため、セッションで使えるのは両方のリストに含まれるプロバイダーだけです。²³³

設定早見表：よく検索される設定

特定の設定を名前で探しているなら、この短い索引をお使いください。各エントリには導入されたリリースを記し、特定のスコープに属する設定ではそのスコープも示しています。

各トピックの公式ドキュメントはどこにありますか？

このガイドは現場向けのマニュアルであり、正式なリファレンスではありません。各サブシステムについて Anthropic の正規ページが必要な場合は、以下の公式ドキュメントをご覧ください（このガイドの各セクションからも、それぞれ対応するページにリンクしています）。

環境変数リファレンス

認証と 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; 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-5         # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5    # What the `opus` alias resolves to (Opus 5.5 since v2.1.280; Opus 5 v2.1.219-278)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001  # pin the haiku alias; on the Anthropic API it resolves to Haiku 5.5 (claude-haiku-5-5) as of v2.1.293[^274][^275]
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_DISABLE_ADVISOR_TOOL=1             # Turn the advisor tool off: /advisor becomes unavailable, advisorModel is ignored, --advisor is accepted but does nothing[^282]
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_DISABLE_WORKFLOWS=1                 # Turn dynamic workflows off for one session; same effect as "disableWorkflows": true, and whichever of the two turned them off, the other cannot turn them back on. Workflows are on by default except on Pro, where "enableWorkflows": true (the Dynamic workflows row in /config) turns them on; the v2.1.147 opt-in CLAUDE_CODE_WORKFLOWS=1 no longer appears in the env-vars reference[^291]
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_MAX_TURNS=10                        # Cap agentic turns when no --max-turns is passed; the flag wins when both are set, and a value that is not a positive integer is rejected at startup[^291]
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
VERTEX_REGION_CLAUDE_HAIKU_5_5=us-east5          # Vertex region for Claude Haiku 5.5 (v2.1.293+)[^276]
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 the x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted, and prompt-id from v2.1.283) through a gateway or third-party provider; a direct Anthropic API connection sends them by default, and =0 stops them everywhere (v2.1.273+)[^253][^262][^263]
CLAUDE_CODE_AUTO_MODE_SERVER=0                  # Opt out of the server-side auto-mode checks, the default since v2.1.278 for Enterprise and Claude API accounts, Claude Platform on AWS, Bedrock, Agent Platform, Foundry, and gateways (not charged when the server performs them; =1 was the v2.1.273-277 opt-in); also applies on a direct Anthropic API connection since v2.1.281, where server-side is the default with telemetry off since v2.1.282; the docs call it temporary[^253][^255][^259][^260][^261]
CLAUDE_CODE_AUTO_MODE_MODEL=claude-sonnet-5-5   # Model the client-side auto mode classifier uses; no effect on server-side auto mode (v2.1.302+)[^283]

動作の制御：

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_DISABLE_WEB_FETCH=1                 # Turn off the WebFetch tool; WebSearch stays available (v2.1.285+)[^265][^269]
CLAUDE_CODE_DISABLE_ARTIFACT=1                  # Turn the Artifact tool off for one session; while it is set, no settings file turns artifacts back on[^291]
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0                # Do not open the browser when a new artifact is published[^291]
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES=2      # Cap re-sends of a non-streaming fallback request that timed out (v2.1.285+)[^265]
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS=5000 # Starting delay of the exponential backoff between retries of a 529 overloaded request, default 500; whole milliseconds from 500 to 32000; no effect with CLAUDE_CODE_RETRY_WATCHDOG=1 or in fast mode (v2.1.292+)[^272][^276]
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=60000 # Ceiling of that backoff, default 32000 ms (v2.1.296+; in the env-vars docs since October 14)[^274][^280]
CLAUDE_CODE_RETRY_WATCHDOG=1                     # Unattended sessions: retry 429 and 529 capacity errors indefinitely, backing off up to 5 minutes or until the limit resets (v2.1.186+)[^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=1800000   # Cap, per request, on how long the watchdog waits out 429 and 529 errors; unset means no limit (v2.1.295+)[^274][^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS=3600000 # Under the watchdog, end a request at a usage limit that resets further away than this instead of waiting it out (v2.1.301+)[^283]
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS=60000 # Minimum interval between checks that a usage limit was lifted before its reset, while the watchdog waits on it (v2.1.305+)[^286][^287]
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1      # Keep the dangerous-rm prompt waiting in auto mode and --dangerously-skip-permissions instead of denying after 2 minutes (v2.1.281+)[^260]
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1    # Skip the prompt for a recursive rm whose target is only command-substitution output, such as rm -rf "$(pwd)" (v2.1.281+)[^260]
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1     # Keep prompting for an rm built at run time inside a shell -c script Claude Code cannot read; such scripts no longer prompt by default (v2.1.299+; release-notes only as of 2026-10-14)[^279][^280]
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=0                     # Turn fork subagents off; on by default in the terminal and, since v2.1.302, in claude -p, the Agent SDK, the desktop app, and VS Code (=1 was the external-build opt-in from v2.1.117; claude mcp serve never offers them)[^160][^283]
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+). Since v2.1.290 an interactive session's budget refills instead of ending at 200 (next line); the env-vars docs, fetched Oct 6, still describe the 200 cap[^206][^271][^273]
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR=100     # WebSearch budget refill rate: 100 calls/hour by default in an interactive session, 0 (off) in a non-interactive one (v2.1.290+)[^271][^276]
CLAUDE_CODE_DISABLE_ATTACHMENTS=1               # Send @-mentions as plain text instead of expanding file content; a repo's .claude/settings.json or settings.local.json can no longer set it (v2.1.290)[^271][^273]
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1             # Hand Claude the path of an @ mention to read with its file tools, not the file's contents, so PreToolUse hooks see the read; ignored in project and local settings (v2.1.299+)[^279][^280]
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_WORKFLOW_SUBAGENT_MODEL=sonnet         # Run every workflow agent on one model while other subagents keep theirs (v2.1.296; release-notes only as of 2026-10-14)[^274][^280]
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_MAX_MCP_DESCRIPTION_LENGTH=8192     # Override the cap on MCP tool descriptions and server instructions, every server in the session: 4,096 chars since v2.1.296, 2,048 in v2.1.280-295; Anthropic's first-party servers at api.anthropic.com are uncut since v2.1.299[^279][^256][^274]
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_MCP_STARTUP_WAIT_MS=10000           # Bound how long the FIRST non-interactive turn waits for still-connecting MCP servers; 0 = don't wait (v2.1.274+)[^254]
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

バックグラウンドコマンドの時間制限（v2.1.285、v2.1.288で適用範囲を縮小）: バックグラウンドで実行される Bash および PowerShell コマンドは、時間制限に達すると停止します。この制限は run_in_background で実行した際の timeout で、デフォルトは30分、最大は2時間です。コマンドが停止されると Claude に通知が届きます。²²⁹ v2.1.288以降、この制限が適用されるのは無人セッション（-p、Agent SDK、CI、クラウドセッション）のみとなりました。ターミナル、デスクトップアプリ、VS Code のセッションでは、バックグラウンドコマンドに時間制限はありません。ツールリファレンスにも「v2.1.288より前は、すべてのセッションで適用されていました」と明記されています。²³⁴²³⁷

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

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
CLAUDE_CODE_GZIP_REQUEST_BODIES=0              # Turn off gzip compression of large request bodies sent to api.anthropic.com, on even with telemetry off since v2.1.300[^281][^282]
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); also the opt-out for the v2.1.287 1M default on Bedrock/Vertex/Foundry/Claude apps gateway[^103][^217][^268]
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k           # Auto-compact window, 100000 to 1000000 tokens; k and M suffixes since v2.1.304 (200k had set a 100K window), out-of-range values warn[^286][^287]
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1  # Let claude ultrareview run in a folder you have not trusted where it cannot ask, such as CI; environment only, not a settings env block (v2.1.309+)[^286][^287]
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=150000     # Context size at which idle compaction applies, default 200000; values below 100000 are raised to 100000; "idleCompaction": false in settings.json turns the feature off (v2.1.299; the docs date both to v2.1.290+)[^279][^280]
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]
CLAUDE_AX_PREPARK_MS=50                       # Screen reader mode: pause before writing a changed line; default 0 since v2.1.287 (was 50)[^268][^269]
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.290 also skips the startup connection warm-up[^271]
CLAUDE_CODE_ATTRIBUTION_HEADER=0              # Omit the system-prompt attribution block; behind a Claude apps gateway, set it in the env of the gateway's code or cli policy (v2.1.299+)[^279][^280]

プロジェクト設定ではテレメトリーを有効化できません（v2.1.282）: プロジェクト設定ファイルとローカル設定ファイルは、エクスポートを有効にする、エンドポイントを設定する、またはコンテンツを取得する OpenTelemetry 変数を無視するようになりました。対象は CLAUDE_CODE_ENABLE_TELEMETRY、OTEL_*_EXPORTER セレクター、OTEL_LOG_* などです。一方、何かを無効にする値（エクスポーターセレクターの none、コンテンツフラグの 0）は、これらのファイルからでも引き続き適用されます。それ以外の値は、シェル、ユーザー設定、またはマネージド設定で指定してください。プロジェクトファイルがこれらの変数を設定している場合、インタラクティブセッションでは起動時に通知が表示されます。無視された変数名は /status と claude doctor で一覧表示されます。ただし -p や Agent SDK のセッションでは通知が表示されません。アップグレード後は、コレクターが引き続きデータを受信しているか確認しましょう。²²⁵²²⁷

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.300 の属性: api_request イベントでは、キャッシュ書き込みが cache_creation_5m_tokens と cache_creation_1h_tokens に分けて記録されるようになりました。トレーススパンには GenAI セマンティック規約の属性（gen_ai.provider.name、gen_ai.conversation.id、gen_ai.tool.name、error.type）が付与されます。user_prompt イベントとインタラクションスパンには、mod の prompt.submit hook が書き換えた後のプロンプトが記録されます。さらに、reftable リポジトリで git commit -q を実行すると、tool_result イベントに git_commit_id が付与されます。²⁷³

v2.1.301 と v2.1.302 の属性: tool_decision イベントに classifier_verdict と permission_mode が付与されるようになり、auto モードの分類器による判定とパーミッションルールによる判定を区別できます。OTEL_LOG_TOOL_DETAILS=1 を設定すると、分類器のブロックが一致した組み込みルール名を示す classifier_category も付与されます（v2.1.301）。v2.1.302 では、これまで欠けていた多くの分類器ブロックで classifier_category が埋められるようになりました。また、OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT が低い値でも、tool_use_id、tool_source、tool_parameters がイベントに保持されます。なお、モニタリングのドキュメントにはこの3つの属性がまだ記載されていません。²⁷⁵²⁷⁶

v2.1.307 のイベント: パーミッションルール、auto モード、安全チェック、hook、サンドボックスのいずれかによって停止、確認プロンプト、差し戻しの対象となったツール呼び出しごとに、claude_code.safety_event が発火します。ターン終了時のイベントを除き、tool_use_id が付与されます。モニタリングのドキュメントにはこのイベントが記載されており、classifier_verdict（v2.1.301+）も記載されるようになりました。²⁷⁸²⁷⁹

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 のペイロードにはサブエージェントの推論努力レベルが含まれるため、カスタムのステータスライン行でモデルと努力レベルを並べて表示できます。さらに、新しい環境変数 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 が追加され、ターミナルセッションと揃いました。²¹⁵

v2.1.280 の hook テレメトリー: hook_execution_complete OTel イベントに、hook の出力サイズと、ファイルに保存されたサイズ超過の出力の数が付与されるようになりました。²²⁰

v2.1.287 の prompt_text: user_prompt イベントに、ドット区切りのキーをネストするバックエンド向けに prompt のコピーである prompt_text が付与されるようになりました。パイプラインで prompt を削除またはマスクしている箇所では、prompt_text にも同じ処理を適用してください。²³²

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+); a Read call with allow_large can pass it when the context has room (v2.1.296+)[^274][^276]
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1      # Stop sending structured outputs, for Mantle or gateways that reject them; session titles, memory recall, and prompt hooks failed there before (v2.1.288+)[^270][^273]
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+)
MCP_SDK_GENERATION=v1                         # Opt out of the v2 MCP client; v2.1.274 made v2 the default on the last holdouts (Bedrock/Vertex/Foundry + telemetry-disabled installs)[^254]
MCP_PROTOCOL_NEGOTIATION=legacy               # Opt out of MCP 2026-07-28 protocol negotiation: with direct HTTP servers (default everywhere as of v2.1.274) and, since v2.1.292, with local (stdio) servers on every install, Bedrock, Vertex, and Foundry included and, since v2.1.299, with cloud session and Remote Control connectors[^279][^254][^272]

シェル / 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 では、複数のレベルで柔軟にモデルを切り替えられます。

利用可能なモデル

Claude Sonnet 5.5（2026年9月28日）： v2.1.284 以降、Anthropic API におけるデフォルトの Sonnet モデルとなり、sonnet エイリアスがこのモデルを指します。すべてのプランのデフォルトモデルは、引き続き Opus 5.5 です。モデル ID は claude-sonnet-5-5（Bedrock では anthropic.claude-sonnet-5-5）です。料金は Sonnet 5 と同じく、入力が $2/MTok、出力が $10/MTok で、キャッシュ読み取りは $0.10/MTok です（料金ページによると入力料金の0.05倍で、Opus 5.5 と同じ比率です。v2.1.296 では、それまで $0.20 を使っていた Claude Code 自体のコスト計算が修正されています）。コンテキストウィンドウは100万トークン、最大出力は12万8,000トークンです（Batches API で output-300k-2026-03-24 ベータヘッダーを使用した場合は最大30万トークン）。信頼できる知識のカットオフは、Opus 5.5 および Fable 5.1 と同じ2026年6月です。提供終了は早くても2027年9月28日となります。Claude Code では Sonnet 5.5 の effort のデフォルトは medium です（Claude API 自体のデフォルトは high）。また、思考は無効化できません。内容に応じたフォールバックもあり、サイバーセキュリティ関連と判定されたリクエストは Sonnet 5 で再実行されます。一方、生物学関連と判定されたリクエストは、Sonnet 5.5 に生物学向けのフォールバックモデルがないため、拒否されて終了します。Claude Code v2.1.284 以降が必要です。Sonnet 5 を使い続けるには、ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 で固定してください。²²⁸²³⁰

モデルのページには、Sonnet 5 から API コードを移行する際の破壊的変更が5つ記載されています。between_tools によって最初のツール呼び出し前の思考が無効になります。ツール使用を強制するとエラーになります。思考ブロックはモデルと会話に紐づきます。Claude API と Google Cloud では computer_20251124 が受け付けられません。また、advisor ツールでは Opus 4.8、Opus 4.7、Sonnet 5 をアドバイザーとして指定できません。ツール呼び出しの間のテキストも thinking ブロックで返されるため、そのテキストをストリーミング表示するインターフェースでは、テキストが返されるように display の値を設定するまで、表示が途絶えます。²³⁰

Claude Opus 5.5（2026年9月22日）： v2.1.280 以降、Claude Code の新しいデフォルトの Opus モデルです。また、モデル設定ドキュメントのプラン別一覧によると、すべてのプランとファーストパーティプロバイダーのデフォルトモデルでもあります。対象は Pro、Max、Team、Enterprise、Anthropic API、Claude Platform on AWS、Amazon Bedrock、Google Cloud の Agent Platform です（Microsoft Foundry は Sonnet 4.5 のままで、opus エイリアスは Opus 4.6 を指します）。同じリリースでは、Pro と Team Standard のデフォルトも Sonnet から Opus に変更され、「Max、Team Premium、Enterprise と統一」されました。これにより、上位プランが Opus に移行して以来続いていた、プラン間の違いがなくなりました。モデル ID は claude-opus-5-5（Bedrock では anthropic.claude-opus-5-5）で、claude-opus-5 と同じく日付を含まない固定スナップショットです。料金は Opus 5 より安くなり、入力が $4/MTok、出力が $20/MTok です（Opus 5 は $5/$25）。キャッシュ読み取りは $0.20/MTok で、入力料金の5%と、標準の10%の半分になっています（これより低いのは2.5%の Fable 5.1 と Mythos 5.1 のみです）。コンテキストウィンドウは100万トークン、最大出力は12万8,000トークンです（Batches API で output-300k-2026-03-24 ベータヘッダーを使用した場合は最大30万トークン）。適応型思考は常に有効です。モデル概要の表でも、Fable と同じ「適応型（常時有効）」と記載されています。Opus 5 のようにデフォルトで有効でも無効化できる仕様ではありません。effort のデフォルトは medium です（Opus 5 のデフォルトは high でした）。v2.1.280 では、これに合わせて設定の引き継ぎルールも変わりました。/effort がモデルごとの設定になる前に保存された思考レベルは、Opus 5.5 などの新しくリリースされたモデルには適用されなくなります。レベルを選択するまでは、そのモデル固有のデフォルトで開始します。信頼できる知識のカットオフは2026年6月（学習データも2026年6月）で、現行モデルの中では Fable 5.1 と並んで最も新しくなっています。提供終了は早くても2027年9月22日です。Claude Code v2.1.280 以降が必要です。²²⁰²²¹

API コードを Opus 5 から Opus 5.5 に移行する際の破壊的変更：²²²

1. 思考は無効化できません。 thinking: {type: "disabled"} と thinking: {type: "enabled", budget_tokens: N} は、どちらも400を返します。thinking フィールドを削除し、代わりに思考レベルを選択してください。
2. ツール使用を強制するとエラーになります。 tool_choice が受け付けるのは auto と none のみです。any と tool は、トークンカウント用のエンドポイントも含めて400を返します。厳密なツール使用または構造化出力とともに auto を使用してください。
3. 思考ブロックはモデルに紐づきます。 ルーターやフォールバックによって会話を Opus 5.5 から別のモデルへ移す場合、移行先では Opus 5.5 の思考ブロックを含めずに、それらのターンを処理します（Claude API 上の Fable 5.1 と Mythos 5.1 は例外です）。
4. Claude API と Google Cloud では computer_20251124 が拒否されます。 代わりに computer_toolset_20260801 ツールセットを宣言してください。Bedrock では従来のツールを引き続き使用できます。 もう1つ、リクエストの失敗にはつながらないものの、レスポンスの形式が変わる変更があります。ツール呼び出しの合間にモデルが書くテキストは、thinkingブロックとして返されるようになりました。デフォルトのdisplay設定では、このブロックは空になります。この説明文をストリーミング表示するインターフェースでは、display: "updates"（ベータ）または"summarized"を設定するまで、何も表示されなくなります。²²²

Claude Codeでのコンテンツに基づくフォールバック。 Opus 5.5には安全性分類器が組み込まれており、特に生物学とサイバーセキュリティのコンテンツがフラグの対象になりやすくなっています。リクエストにフラグが付くと、Claude Codeは別のモデルで再実行し、通知を表示します。生物学関連のリクエストはOpus 5へ、サイバーセキュリティ関連のリクエストはOpus 4.8へ切り替わり、/modelで元に戻すまで、そのセッションではフォールバック先のモデルが使われます。毎回確認するようにするには、/configでメッセージにフラグが付いたときにモデルを切り替えるをオフにしてください（switchModelsOnFlag: false）。²²³ v2.1.287以降は、切り替え先のモデルのデフォルト値ではなく、現在のeffortレベルが維持されます。たとえば、Opus 5.5のデフォルトであるmediumで実行しているセッションは、デフォルトがhighのOpus 4.8に切り替わってもmediumのままです。²³²²³³

Claude Opus 5（2026年7月、以前のOpusモデル）： v2.1.219（2026年7月24日）から、v2.1.280でOpus 5.5がデフォルトのOpusモデルになるまで、Opusモデルとして提供され、opusエイリアスの参照先になっていました。以下は、2026年7月のリリース時点の情報です。Anthropicは、Opus 4.8からそのまま置き換えられるアップグレードと説明しています。入力$5/MTok、出力$25/MTokという料金は変わらず、「同じコストで性能が大幅に向上」し、推論レベルをmaxにした場合のトークン使用量は、Opus 4.8より平均で約26%少なくなりました。Claude Maxのデフォルトモデルであり、Claude Proで最も高性能なモデルでした。モデルIDはclaude-opus-5です。これは日付を含まない固定スナップショットで、claude-opus-4-8やclaude-sonnet-5と同じ仕組みです。常に最新版を指すものではありません。コンテキストウィンドウは1Mトークン（ベータヘッダーは不要で、Opus 4.8から変更なし）、最大出力は128Kです（Batches APIでは、output-300k-2026-03-24ベータヘッダーを指定すると最大300K）。適応型思考のみをサポートし、thinking.type: "enabled"による拡張思考は利用できません。信頼できる知識のカットオフは2026年5月です（学習データのカットオフも2026年5月）。リリース時から、Fable 5.1（カットオフは2026年6月）が2026年9月1日に登場するまで、現行のClaudeモデルの中で最も新しいカットオフでした。²⁴¹ Opus 5の登場に伴い、Opus 4.8はドキュメントのLegacy models表に移動し、4.7や4.6と並ぶようになりました。引き続き利用できますが、デフォルトとしては推奨されなくなっています。¹⁹⁷

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

1. 思考がデフォルトで有効になります。 Opus 4.8では、thinkingフィールドのないリクエストは思考なしで実行されていました。Opus 5では、同じリクエストが適応型思考を使って実行されます。max_tokensは引き続き、思考と応答テキストを合わせた総出力の厳密な上限です。これまで思考なしで実行していた処理では、出力枠に余裕があるかを再確認してください。従来の動作に戻すにはthinking: {type: "disabled"}を指定しますが、次の制約が適用されます。
2. 思考を無効にする場合、effortの上限はhighです。 thinking: {type: "disabled"}とeffortのxhighまたはmaxを組み合わせると、400が返されます。この検証はリクエストごとに行われます。同じ会話の以前のターンでリクエストが受け付けられていても、思考を無効にしたままeffortをxhighに上げると拒否されます。

Claude Codeでは、Opus 5のeffortはデフォルトでhighになります（Claude APIでも同様です）。low、medium、high、xhigh、maxの全段階を利用できます。Anthropicの移行ガイダンスでは、トークン消費量よりも能力を重視する場面で、effortのmaxを試すよう勧めています。高速モードはOpus 5に対応し、料金は1MTokあたり入力$10、出力$50です（高速モードを参照）。¹⁹⁷¹⁹⁸

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で、通常の入力料金の10%ではなく、0.025倍（2.5%）です。この料金が適用されるのはFable 5.1とMythos 5.1のみで、キャッシュ書き込みは標準料金のままです（5分間は$12.50、1時間は$20）。信頼できる知識のカットオフは2026年6月です（学習データも2026年6月）。現行のClaudeモデルの中で最も新しく、2026年9月22日にOpus 5.5（カットオフは2026年6月）、9月28日にSonnet 5.5も同じカットオフになりました。提供終了は早くても2027年9月1日です。v2.1.301以降は、組織で最新のFableモデルを利用できない場合、fableとbestはエラーにする代わりに、1世代前のFableモデルで1回再試行します。²⁷⁵

Fable 5からの破壊的変更は3つあります。ツールの使用を強制するとエラーが返されること、以前のモデルではこのモデルの思考ブロックを読み取れないこと、過去のターンを編集すると思考ブロックが無効になることです。追加された変更は5つあります。メッセージ単位のeffort（ベータ）、ターン単位のシステムメッセージ（ベータ）、ツール呼び出し間の進捗更新（display: "updates"、ベータ）、キャッシュ読み取り料金の引き下げ、コンテンツの来歴情報です。Claude Mythos 5.1は仕様も同じ同一モデルで、Project Glasswingを通じた招待制でのみ利用できます。このリリースに伴い、Fable 5はドキュメントのLegacy models表に移動し、Opus 4.8/4.7/4.6/4.5およびSonnet 4.6/4.5と並ぶようになりました。

リリースノートには、ゲートウェイに関する注意点が1つあります。Claudeアプリのゲートウェイ経由のセッションでは、当面の間、fableとbestは引き続きFable 5を参照します。5.1向けにまだ設定されていないゲートウェイは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でした。その後、v2.1.280（2026年9月22日）で全プランのデフォルトがOpus 5.5に変更されています。^211241242221

Fable 5.1リリース直後の修正（v2.1.260、9月3日）： リリース後最初の更新では、4つの問題が修正されました。Fable 5.1を利用できる組織では、/model選択画面にFable 5.1が表示されるようになりました。修正前は、/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日からレガシー扱い）： Opusより上位に位置する新しいモデル階層です。Anthropicで最も強力かつ知的なモデルとして、評価を受けたほぼすべてのベンチマークで最高水準を達成し、数百万トークンにわたるコンテキストでも一貫性を保つように設計されています。Fable 5は、「Mythosクラス」の最先端モデルを一般利用向けに安全性を高めたものです。安全性分類器が組み込まれており、サイバー、生物・化学、モデル蒸留に関する問い合わせではOpus 4.8へフォールバックします（Claude Mythos 5は、認可された研究者向けにこれらの保護措置を解除した同一モデルです）。Claude Codeではv2.1.170（2026年6月9日）から選択できるようになりました。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と同様に、すべての推論強度（low/medium/high/xhigh/max、デフォルトはhigh）に対応しています。Fable 5では思考を無効にできません。セッションの思考切り替え、alwaysThinkingEnabled設定、MAX_THINKING_TOKENS=0はいずれも効果がなく、常に適応的に推論します。fable系にはOpusと同様の設定が一通り用意されています。ANTHROPIC_DEFAULT_FABLE_MODELはfableエイリアスが指すモデルを固定し（Bedrock/Vertex/Foundryで便利です）、DISABLE_PROMPT_CACHING_FABLEはFableのプロンプトキャッシュを無効にします。また、エンタープライズ向けゲートウェイでは、コンテンツに基づく自動フォールバックが適用されます。/model opusは現在、Opus 5.5を選択します（v2.1.280。推論強度のデフォルトはmediumで、最も難しいタスクには/effort xhighを使います）。初期状態のデフォルトモデルは、プランによって変わらなくなりました。Microsoft Foundryを除き、Anthropicが運営するすべてのプランでOpus 5.5がデフォルトです。最高の性能が必要な場合は、/model fableでFableを明示的に選んでください。v2.1.257時点では、Fable 5.1が選択されます。^{261197207242220221}

Opus 4.7（2026年4月16日）： 1世代前のフラッグシップで、現在も引き続き利用できます。1Mトークンのコンテキストウィンドウを標準料金で利用でき、長いコンテキストへの追加料金はありません。最大出力は128Kで、適応型思考のみに対応しています（拡張思考は廃止されました）。新しい推論強度xhighは、コーディングやエージェント処理で最初に試す設定として推奨されています。¹⁴⁵ 信頼できる知識のカットオフは2026年1月、学習データのカットオフも2026年1月です。モデルID：claude-opus-4-7。料金はOpus 4.6と同じで、1Mトークンあたり入力$5／出力$25です。キャッシュ書き込みは5分間が$6.25、1時間が$10、キャッシュ読み取りは1Mトークンあたり$0.50です。¹⁴⁴ Opus 4.7はSWE-BenchでOpus 4.6の3倍の実運用タスクを解決し、CursorBenchでは70%（4.6は58%）を達成しています。また、Anthropicの93タスクからなる社内コーディングベンチマークでは、解決率が13%向上しています。¹⁴⁴ 新しいトークナイザーを使用するため、同じテキストでもトークン数はおよそ1〜1.35倍になります。max_tokensの余裕を増やし、コンパクションの発動しきい値も調整してください。¹⁴⁵ 画像認識は最大2,576 px／3.75 MPの画像に対応し、ピクセル座標を1:1で扱えます。¹⁴⁵

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

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

v2.1.280（2026年9月22日）で、プランによる違いはなくなりました。Anthropicが運営するすべてのプランとファーストパーティプロバイダーで、Opus 5.5がデフォルトになり、唯一の例外はMicrosoft Foundryです。以前は「どのプランを使っているか」が最も重要な判断材料でしたが、現在はそれによって答えが変わることはありません。

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（旧モデル）： 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です（以前はmedium）。Opus 4.7は引き続きxhighです。この変更により、4月23日の事後検証で報告された3月4日〜4月7日の推論強度引き下げで低下した知能水準が回復しました。¹⁵²¹⁵³

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

v2.1.197（2026年6月30日）では、Sonnet 5がClaude Codeのデフォルトモデルになりました。当時の新規セッションに適用され、標準プラン（Pro、Team Standard）では、2026年9月22日のv2.1.280でこれらのプランがOpusに移行するまで使われていました。現在、Claude CodeでSonnet 5をデフォルトとするプランはありません。また、v2.1.284以降、Anthropic APIでは/model sonnetがSonnet 5.5を選択します。Sonnet 5を使い続けるには、/model claude-sonnet-5またはANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5を指定してください。上のプラン表をご覧ください。^{181207220221228}

Sonnet 4.6（2026年2月17日、現在はSonnet 5が後継）： バランスの取れたモデルで、claude.aiとClaude CoworkのデフォルトとしてSonnet 4.5に代わって採用されました。⁹³ 料金はSonnet 4.5と同じです（1Mトークンあたり入力$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 5.5で100Kトークン以下のプロンプト向け料金を適用すると、1セッションあたり約$0.01〜$0.05です。Opus 5.5の$4/$20という料金では、同じセッションが$0.40〜$1.80となり、約40倍かかります（プロンプトキャッシュの割引適用前）。Opusを必要としないタスクには、SonnetやHaikuを使いましょう。¹²²²

各モデルの使いどころ

Haiku：調査を行うsubagents、単純なファイル検索、手短な質問に適しています。100Kトークン以下のプロンプト向け料金ではOpus 5.5の約40分の1（100Kを超えるプロンプトでは8分の1）のコストで、応答も高速です。深い推論を必要としないバックグラウンドタスクに最適です。

Sonnet：コストを重視する日々の開発で主力になるモデルです。v2.1.284以降、Anthropic APIではSonnet 5.5がSonnet 5と同じ$2/$10で提供されています。²²⁸ ただし、v2.1.280でProとTeam Standardの既定モデルがOpusに移行したため、現在はどのプランでも既定モデルではありません（標準で1Mコンテキストに対応し、標準の定価は100万トークンあたり$2/$10です。予定されていた9月1日の値上げは中止されました）。^181251207220 ここで押さえておきたい変化は、Sonnetが自ら選ぶモデルになったことです。選ぶ理由は料金から明確にわかります。同じ1Mコンテキストを使えて、トークン単価はOpus 5.5の半額です。機能の実装、バグ修正、テストの作成、コードレビューなど、ほとんどのコーディングタスクに対応できます。過去の経緯として、v2.1.197（2026年6月30日）でSonnet 5がすべての環境の既定モデルになったと、本ガイドを含めて長らく伝えられていました。しかし、モデル設定ドキュメントのプラン別の説明によると、プレミアムプランおよびAPIの既定モデルはv2.1.154からOpus 4.8、v2.1.219からOpus 5に解決されていました。つまり、「すべての環境」とされていたのは実際には標準プランに限られ、その状況もv2.1.280で終わりました。2026年6月までは、Sonnet 4.6がSonnetの役割を担っていました。^93147207221 トークンコストの削減、応答時間の短縮、subagentsの運用コストを重視する場合は、Sonnetを選びましょう。

Opus：深い推論を担うモデルです。v2.1.280以降、opusエイリアスはClaude Opus 5.5を選択します（100万トークンあたり$4/$20、1Mコンテキスト、effortの既定値はmedium）。同じリリース以降、すべてのプランがOpusで開始されるようになりました。そのため、選択のポイントは、どのタイミングで別のモデルに切り替えるかです。アーキテクチャの判断、難しいデバッグ、複雑なシステムの理解、セキュリティ分析、長期にわたるエージェント作業にはOpusを使い続けましょう。定型的なタスクで、追加の推論能力よりもトークン単価が半額になるメリットを重視する場合は、/model sonnetで切り替えます。²²⁰²²¹ （v2.1.219からv2.1.278までは、opusエイリアスは$5/$25のOpus 5に解決されていました。）¹⁹⁷ この段落の残りは、履歴として残している2026年4月16日のリリース時点のOpus 4.7の説明です。¹⁴⁴¹⁴⁷ Opus 4.7は、SWE-BenchでOpus 4.6の3倍の実運用タスクを解決し、CursorBenchでは70%を記録しました（Opus 4.6は58%）。また、93タスクからなる社内コーディングベンチマークでは、解決率が13%向上しています。¹⁴⁴ Claude Codeでは、Opus 4.7の推論の強度は既定でxhighとなり、/effortで調整できます（v2.1.111以降）。¹⁴⁶ Maxの契約者は、Anthropic API経由のOpus 4.7で、--enable-auto-modeを指定せずに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はすべての指定を上書きするのではなく、subagentsの既定モデルを設定します。エージェント定義のmodel:や起動ごとの明示的なモデル指定が優先されます。²⁰⁶ v2.1.257以降では、CLAUDE_CODE_SUBAGENT_MODEL_FORCEを有効にすると従来の動作に戻せます。起動ごとの指定やエージェント定義のmodel:を無視し、すべてのsubagentsにCLAUDE_CODE_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.286以降では、既定の指定やエイリアスが解決された先のモデルをAnthropic APIが拒否した場合、Claude Codeは毎ターン失敗するのではなく、同じティアの1つ前のモデルで1回再試行します。また、拒否に伴う再試行や--fallback-modelによる再試行で、切り替え先のモデルが高速実行に対応していない場合は、標準速度で実行します。²³¹

v2.1.178以降、コンパクションでもフォールバックチェーンが適用されます。コンパクションの途中でメインモデルが過負荷または利用不可になった場合、ターンを失敗させるのではなく、設定済みのfallbackModel/--fallback-modelチェーンに沿って代替モデルに切り替えます。これにより、長時間の自律実行中に、本来なら復旧可能なコンパクション処理が一時的なモデルエラーでセッションを中断させてしまう問題を防げます。¹⁷³

コンテキストの拡張

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

claude --model sonnet[1m]
claude --model opus[1m]           # 1M for a model that reaches it only through [1m], such as Opus 4.6

セッション中に有効にすることもできます。

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

サフィックスが必要になる場合（2026年10月）： Anthropic APIでは、Fable 5.1、Fable 5、Sonnet 5.5、Sonnet 5、およびOpus 4.7以降（Opus 5.5を含む）がすべてのプランで1Mのコンテキストウィンドウを使うため、[1m]を付けても何も変わりません。v2.1.287以降、Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundry、Claude apps gatewayでも同様です。Opus 4.7以降とFableは、[1m]サフィックスなしで既定で1Mのコンテキストウィンドウを使い、CLAUDE_CODE_DISABLE_1M_CONTEXT=1を設定すると200Kに制限されます。v2.1.287より前は、これらのプロバイダーでOpus 4.8以降を使う場合、ANTHROPIC_DEFAULT_OPUS_MODELに固定したモデルIDに[1m]が付いていなければ、200Kで動作していました。10月1日に取得したBedrockとAgent Platformのドキュメントページには、1Mを使うにはサフィックスが必要だと引き続き記載されています。Sonnet 5は、すべてのプロバイダーで1Mに対応しています。Opus 4.6とSonnet 4.6では、現在もサフィックスが必要です。1Mを使えるのは、それぞれの[1m]バリアントだけです。^223232233

Opus 4.7、Opus 4.6、Sonnet 4.6はいずれも、1Mトークンのコンテキストウィンドウ全体を標準料金で利用でき、長いコンテキストに対する追加料金はありません。¹⁴⁸ 900Kトークンのリクエストにも、9Kトークンのリクエストと同じトークン単価が適用されます。プロンプトキャッシュとバッチ処理の割引も、コンテキストウィンドウ全体に通常の割引率で適用されます。 [1m] バリアントの利用可否はプランによって異なります。1MコンテキストのOpus 4.6はMax、Team、Enterpriseに含まれますが、1MコンテキストのSonnet 4.6を利用するには、Maxを含むすべてのサブスクリプションプランで使用量クレジットが必要です。²³³（2026年3月13日のv2.1.75で、Max、Team、Enterpriseでは1MコンテキストのOpusがデフォルトになりました。）¹¹⁷¹⁴⁷ 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.287からは、1MがデフォルトになったBedrock、Vertex、Foundry、Claude appsゲートウェイで、Opus 4.7以降およびFableを200Kに維持する場合にも、この変数を使用します。²³²

v2.1.247から、Sonnet 5のデフォルトの自動圧縮ウィンドウは、1Mコンテキスト全体になりました。1Mウィンドウのセッションでは、約934Kトークンではなく約967Kトークンで自動圧縮されます。²⁴⁵ v2.1.260では、上限付近での自動圧縮がほかの1Mモデルにも拡張されました。OpusとFableのセッションも1Mトークンの上限直前で圧縮されるようになり、非常に大きなコンテキストでの復旧用圧縮が10分でタイムアウトする問題も解消されています。²¹²

カスタムベースURLでも1Mウィンドウを利用できます（v2.1.285）。 カスタムのANTHROPIC_BASE_URL経由のセッションでも、1Mコンテキストウィンドウを持つモデル（Opus 4.7以降、Sonnet 5以降、Fable）では、そのウィンドウを使用するようになりました。ゲートウェイの上限が200Kの場合は、/autocompact 200kを実行してください。²²⁹²³³

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

v2.1.273では、コンテキストメーターと自動圧縮が、advisorツールを使ったターンを実際のコンテキストサイズの約2倍として計算していた問題が修正されました。この問題により、実際のウィンドウの約半分で自動圧縮が実行されていました。²¹⁷

現在のモデルの確認

> /status

このコマンドは、現在のモデル、アカウント情報、適用されている設定、そのほかのセッション状態を表示します。

モデル選択画面のラベル（v2.1.51以降）： /modelの選択画面では、バージョンを固定したモデルについて、生のモデルIDではなく「Sonnet 4.6」などの読みやすいラベルが表示されるようになりました。新しいバージョンがある場合は、アップグレードの案内も表示されます。⁹⁸ v2.1.219では、統合されたOpusの行が「Opus（1Mコンテキスト）」ではなく単に「Opus」と表示される問題が修正されました。また、新リリースの強調表示は最新モデルの名前だけに限定され、リストの任意の部分ではなく、実際にリリースされたモデルを示すようになっています。¹⁹⁶ v2.1.283では、Opusがすでに1Mコンテキストウィンドウを持つ場合、Opusの行とデフォルトモデルの名前から「（1Mコンテキスト）」が削除されました。ウィンドウ自体に変更はありません。²²⁶

高速モード（v2.1.36以降）

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

> /fast            # Toggle fast mode on/off

対象モデル（v2.1.280時点）： 高速モードはClaude Opus 5.5、Opus 5、Opus 4.8で利用でき、v2.1.280からはOpus 5.5が高速モードのデフォルトになっています（v2.1.219からはOpus 5がデフォルトでした）。v2.1.219でOpus 4.7は高速モードの対象から外れました。Sonnet、Haiku、Fableでは、これまで一度も提供されていません。引き続きClaude API（Claude Managed Agentsを含みます）のみで提供されるリサーチプレビューであり、Amazon Bedrock、Google Cloud、Microsoft Foundry、Claude Platform on AWSでは利用できません。利用には承認が必要です。アカウント担当者に連絡するか、ウェイトリストに登録してください。^196198223

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

料金（高速モード）：^198222223

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を固定し、高速モードのリクエストが暗黙に標準速度へ切り替わることを前提にしていた場合、現在はリクエストが失敗します。固定先をOpus 5.5、Opus 5、またはOpus 4.8に変更してください。¹⁹⁸

高速モードが適している場面： - 待ち時間がボトルネックとなる、小さな変更を素早く繰り返す作業 - コストよりも速度を重視する、テスト、ボイラープレート、反復的なコードの生成 - 類似したタスクのリストを順番に処理する作業

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

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

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

活用のヒント： 高速モードはopusplanとの併用には向きません（opusplanはすでにOpusとSonnetを組み合わせており、高速モードが作用するのはOpusの部分だけです）。コストよりも待ち時間を重視する場合に使い、自律実行やバッチ処理では無効にしましょう。/fastには追加使用量の利用が必要です。Team/Enterpriseでは、管理者による事前の有効化が必要な場合があります（v2.1.37で修正）。完全に無効にするには、CLAUDE_CODE_DISABLE_FAST_MODE=1を設定します。v2.1.218から、/config model=<x>またはRemote Controlによるモデル切り替えで高速モードの状態が変わると、Claude Codeが通知するようになりました。さらにv2.1.219では、切り替え、再接続、組織の確認失敗の後に、Remote Controlクライアントに古い高速モードの状態が残る問題が修正されています。^86149195196

Advisorツール（実験的機能）

advisorツールを使うと、Claudeはタスクの重要な局面で、通常はより高性能な別のモデルに相談できます。たとえば、方針を決める前、同じエラーが繰り返されるとき、作業の完了を宣言する前などです。advisorはAnthropicのインフラ上でサーバーツールとして動作し、すべてのツール呼び出しとその結果を含む会話全体を受け取ります。返された助言をClaudeが反映してから、作業を続けます。呼び出すタイミングはClaudeが判断します。プロンプトで相談を依頼することはできますが、呼び出し回数を制限したり、呼び出しを強制したりする設定はありません。実験的機能として、サブスクリプションアカウントおよびAPI課金のアカウントがAnthropic APIで利用できます。また、v2.1.300でClaude Platform on AWSにも対応しました（ドキュメントのページでは、引き続き同プラットフォームは非対応と記載されています）。ゲートウェイ経由で利用するには、リクエストが変更されずにAnthropic APIへ届く必要があります。また、機能フラグの取得が必要なため、DISABLE_TELEMETRYのような変数を設定すると、この機能は無効のままになります。²⁷³²⁷⁴ 有効にする方法。 3つの方法があります。セッション中に /advisor <model> を実行すると、選択したモデルがユーザー設定の advisorModel に保存されます（/advisor だけを実行すると、ターミナルでは選択画面が開き、-p、SDK、デスクトップ、Remote Controlのセッションでは現在のアドバイザーが表示されます。これらのセッションでは、v2.1.260以降、テキスト形式のコマンドが使えます。/advisor off で無効になります）。設定ファイルに "advisorModel": "opus" を記述する方法もあります。また、claude --advisor <model> を使うと、1つのセッションに限って指定できます。このフラグは --help に表示されず、設定ファイルの指定より優先されます。組み合わせが無効な場合は起動時に終了します。指定できるエイリアスは fable、opus、sonnet で、完全なモデルIDも使えます。CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 を設定すると、コマンドが削除され、設定は無視され、フラグも何も行わなくなります。²⁷⁴

組み合わせ、料金、表示内容。 アドバイザーには、メインモデルと同等以上のランクのモデルが必要です。Opus 4.7と4.8では、Fable、Opus 4.7以降、Sonnet 5.5（v2.1.287以降）を指定できます。Sonnet 5.5ではFable、Opus 5以降、Sonnet 5.5を、Opus 5と5.5ではFableとOpus 5以降を指定できます。Fable 5.1で指定できるのはFable 5.1のみです。Haiku 4.5はアドバイザーを呼び出せますが、アドバイザーにはなれません。メインモデルよりランクが低いアドバイザーは接続されず、その旨が通知されます。API に拒否されたアドバイザーは、通知なく、その会話の残りの間は使用されなくなります。subagentsも同じ組み合わせチェックを受けたうえでアドバイザーを継承し、availableModels の許可リストにも従います。呼び出しごとにアドバイザーモデルの入力・出力料金が課金されるか、プランの利用上限に計上されます。ただし、Fableの利用が利用クレジットに課金されるプランでは、/model fable で1度同意した後、Fableアドバイザーの利用も利用クレジットに課金されます。アドバイザーの有効・無効を切り替えても、メインモデルのプロンプトキャッシュは維持されます。一方、アドバイザー自身による会話の読み取りはキャッシュされません。会話記録では、Advising 行にReviewed（レビュー済み）、Declined（辞退）、Unavailable（利用不可）のいずれかが表示され、Ctrl+O で助言を確認できます。Modsでは、アドバイザーの呼び出しが turn.step の serverToolUses として表示されます（v2.1.290）。²⁷⁴

effortの調整（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.284のスライダーキー： effortSlider:decreaseEffort、increaseEffort、toggleUltracode のキーバインドアクションにより、スライダーの矢印キーと Tab キーを keybindings.json で再割り当てできます。²²⁸ v2.1.257では両方の調整機能を改善： /effort で、/model と同じように s を指定してセッション限定の設定を選べるようになりました。また、--effort フラグもセッション単位になり、新しいモデルのデフォルトeffortを維持する制約を、恒久的ではなく、そのセッションに限って解除します（CLI のリファレンスでは、デフォルトを「このセッションに限って上書きし、永続化しない」とされています）。²¹¹²⁴³

Maxでの自動モード（v2.1.111以降）

自動モードは、すべてのプランとプロバイダーで、対話型ターミナルとVS Codeのセッション開始時に使われる組み込みの権限モードです（v2.1.283〜284）。また、v2.1.285から、その変更が撤回されたv2.1.302までは、サードパーティープロバイダーを利用している場合やテレメトリーが無効な場合の claude -p と Python Agent SDK のセッションでも、開始時のモードになっていました。Pro、Max、Teamでは、2026年8月14日からデフォルトになっています（発表は8月7日）。発表で示された調査の数値、オプトアウトの方法、引き続き手動モードで開始するセッションについては、権限モードをご覧ください。^{203226227228229}

各アクションは実行前に別の分類モデルによってレビューされ、意図に合っているか、安全かが確認されます。このモデルには、v2.1.210以降、Claude Sonnet 5 が使われています。¹⁸⁷ 自動モードでセッションを開始するには、--permission-mode auto を指定します。古い --enable-auto-mode フラグはv2.1.111で削除されました。

利用範囲の拡大：

• オプトアウト： CLAUDE_CODE_AUTO_MODE_SERVER=0 にするとローカルの分類器を引き続き使用し、そのリクエストは使用量に計上されます。1 にするとオプトインします。v2.1.281より前は、Anthropic API への直接接続ではこの変数が読み取られませんでした。v2.1.281では直接接続にも適用され、自動モードの課金ドキュメントにも、直接接続での利用にはv2.1.281以降が必要と明記されています。²²⁴²²⁷ ドキュメントでは、この変数は一時的なものとされています。この変数が未設定の状態で CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を設定した場合も、サーバー側のチェックが停止します。
• サーバー側のチェックがセッションに届かない場合： 最もよくある原因は、ゲートウェイやプロキシがリクエストの safeguards フィールドを除去する、レスポンスから safeguard_results を削除する、またはツール使用IDを書き換えることです。Claude Code は「このセッションは対象外です」という通知を1度だけ表示し、ゲートウェイを特定できる場合はその名前も示します。その後、セッションの残りの処理には、課金対象となる独自の分類器リクエストを使用します。-p モードでは通知がstderrに送られ、stream-json 出力では system 警告が出力されます。Pro、Max、Teamのセッションには、この通知は表示されません。ゲートウェイ側での対処方法は、リクエストのフィールドとレスポンスのキーを変更せずに通過させることです。
• セッションの確認： /status には Auto mode server の行が表示されます。サーバー側のチェックがセッションのアクションを判断している間は Enabled、フォールバック後は Disabled と表示されます。²¹⁹

自動モードはセキュリティ境界ではありません。 以下で説明する対策の大半は分類器を強化するものであり、分類器はサンドボックスではありません。2026年8月26日、プロンプトインジェクション研究者のJohann Rehbergerは、自動モードの 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 が侵害に気づいてマルウェアのプロセスを終了しようとしたものの、自動モードがその後始末のコマンドを拒否したとも報告しています。²¹⁰ 彼がこの発見全体と対比しているのは、Anthropic が宣伝してきた数値です。委託された第三者評価では、72のシナリオをそれぞれ10回実行し、自動モードのOpus 5に対するプロンプトインジェクションの攻撃成功率は0.00%と報告されていました。彼の攻撃手順はその評価対象に含まれていませんでした。だからこそ、ベンチマークの結果が0.00%であることと、実際にコードを実行できる攻撃手順が存在することは、同時に成り立ちます。ただし彼は、この2つのメッセージには整合性がないと捉えています。²¹⁰ 攻撃の分類にも注目してください。Simon Willisonは8月30日の更新で、これは典型的なプロンプトインジェクションではないという読者の指摘に同意しています。モデルが攻撃者の指示を読んで従うわけではなく、実行環境を取り違えさせる攻撃なのです。²¹⁰

Anthropic はこの報告をInformativeとしてクローズし、挙動は設計どおりと判断しました。Rehbergerが伝えるその見解こそ、設計の前提にすべきものです。自動モードはベストエフォートの分類器であり、セキュリティを保証するものではありません。個別には無害なステップを組み合わせ、執拗に仕掛けられるインジェクション攻撃は、分類器に検出が期待される範囲を超えています。実際に被害を封じ込める境界は、OSレベルの隔離とネットワークの外向き通信の制御です。²¹⁰ この見解は、以下の強化策と矛盾しません。強化策を正しく捉えるための前提です。自動モードは、回答が必要な確認プロンプトを減らし、ドキュメントに列挙された破壊的操作をブロックしますが、信頼できない入力を扱うセッションを安全にするものではありません。取得したページ、ダウンロードしたアーカイブ、issueの本文、第三者の MCP サーバーなど、攻撃者の影響を受けるコンテンツにセッションが触れる場合、実際に被害の範囲を制限するのはモデルの外側にある制御です。コンテナやVM、外向き通信の制限、エージェントが実際に行う操作の監視、そして漏えいすると困る SSH キーやクラウド認証情報を置かないホームディレクトリが該当します。自動モードによる承認は、そのアクションが安全だった証拠にはなりません。

デフォルトを維持したままルールをカスタマイズ（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 タブを開きます。このタブは、そのセッションで自動モードが利用できる場合にのみ表示されます。分類器が読み取るすべてのスコープの allow、soft_deny、hard_deny、environment エントリが一覧表示され、各セクションで組み込みルールが有効かどうかも確認できます。管理対象の設定や --settings からのエントリは読み取り専用で、変更はすべて ~/.claude/settings.json に保存されます。セクションに最初のルールを追加すると "$defaults" も挿入され、組み込みルールが引き続き有効になります。組み込みルールはセクションごとに切り替えられますが、無効にするには、そのセクションに独自のルールが少なくとも1つ必要です。environment は、エディターで1つのドキュメントとして開きます。²⁴⁹²⁴⁷

オプトイン時の「今後確認しない」オプション（v2.1.118以降）。 自動モードのオプトインプロンプトに「今後確認しない」オプションが追加されました。頻繁に利用する場合は、フラグを指定するスクリプトを書かなくても、説明の表示を抑制できます。¹⁵²

破壊的コマンドに対する保護策（v2.1.183）。 自動モードは、セッション内で明示的に依頼されていない限り、特定の取り消し不能なコマンドを強制的にブロックするようになりました。対象は、ローカルの作業を破棄するよう依頼していない場合の破壊的なgit操作（git reset --hard、git checkout -- .、git clean -fd、git stash drop）、そのセッションでエージェントが作成したコミット以外に対する git commit --amend、そして対象のスタックを具体的に指定していない場合のインフラ削除（terraform destroy、pulumi destroy、cdk destroy）です。気づかないうちに作業を失ったり、環境を削除したりする操作に対して、分類器の誤判断による被害の範囲を狭めます。エージェントは引き続きこれらを実行できますが、自発的にではなく、明示的な指示がある場合に限られます。¹⁷⁴

すべてのシェルコマンドを分類（v2.1.193）。 デフォルトでは、自動モードの分類器は、任意コード実行のパターンに一致するシェルコマンドだけを審査し、通常のコマンドは審査を省略します。新しい autoMode.classifyAllShell 設定では、すべての Bash/PowerShellコマンドを分類器に通せます。多少の遅延と引き換えに、シェルの呼び出しを毎回審査したい場合の保護を強化できます。同じリリースでは、自動モードによる拒否理由も、トランスクリプト、拒否を知らせるトースト通知、/permissions の最近の拒否履歴に表示されるようになりました。これにより、コマンドがブロックされた理由を確認できます。¹⁷⁹

さらに3つの強化ルール（v2.1.205）。 自動モードは、セッショントランスクリプトのファイル改ざんをブロックするようになりました。監査証跡そのものをエージェントが変更することはできません。また、文脈から値を特定できない変数に対して rm -rf を実行する前に確認するようになり、$DIR が不明なまま rm -rf $DIR を実行する種類の事故を防ぎます。さらに、バックグラウンドタスクの通知に、人間からの入力は発生していないと明示されるようになりました。これにより、トランスクリプト内に捏造された「ユーザーが承認した」という行が、実際の承認として扱われ、実行につながることを防ぎます。¹⁸³ 3つ目は、覚えておく価値のあるプロンプトインジェクション対策です。承認は承認用の経路を通じて届く必要があり、ハーネスはその前提を明示するようになりました。 コマンド置換でも壊滅的な削除は隠せません（v2.1.208）。 rm -rf ~ のような壊滅的な削除は、$(...)、バッククォート、プロセス置換（<(...)）の中に埋め込まれていても、確認を求めるようになりました。この確認は、--dangerously-skip-permissions と自動モードでも表示されます。破壊的なコマンドを置換で包んでも、安全対策をすり抜けることはできなくなりました。¹⁸⁶

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

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

確認ダイアログは減っても、審査は変わりません（v2.1.218）。 これまで自動モードを権限確認ダイアログで中断していた3つのチェック、危険な rm、バックグラウンド実行の &、不審な Windows パスは、自動モードの分類器が判定するようになりました。検出のたびに操作を求められることなく、安全性の審査は引き続き行われます。同じリリースで、自動モードを併用するプランモードにもこの仕組みが適用されました。静的解析で読み取り専用と証明できない Bash コマンドも、ダイアログで確認する代わりに分類器が判定します。¹⁹⁵

隔離環境からの逸脱を防ぐルール（v2.1.257）。 分類器の自動承認禁止リストに「Containment Escape」ルールが追加されました。クラウドのメタデータからの認証情報取得、外向き通信の制限回避、別テナントへのアクセスは、環境側で想定された操作と明示されない限り、自動承認されなくなりました。上記の注意点を踏まえて捉えてください。これは分類器の継続的な強化の一環として、拒否対象がもう1つ文書化されたものであり、自動モードの性質が変わったわけではありません。²¹¹

作業ディレクトリ外の読み取り時に1度だけ確認（v2.1.257）。 自動モードでは、セッション内で初めて作業ディレクトリ外のファイルを読み取る前に、1度確認するようになりました。v2.1.284以降は、この確認に「はい。ただし次回も確認する」という選択肢も表示されます。²²⁸ 関連する permissions.blockReadsOutsideWorkingDirectories 設定を有効にすると、確認する代わりに、そのような読み取りを全面的に拒否します。²¹¹ v2.1.273では、チェック側で把握できない操作にも両方の動作が拡張されました。完全には解析できない Bash コマンドは、チェックを省略せずに確認を求めます。また、ブロック設定が有効な場合、リポジトリの設定で指定されたメモリディレクトリは、プロンプトへの読み込み、記憶の呼び出し、インデックス作成、メモリ抽出に使われなくなりました。²¹⁷

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

分類器の2つの失敗パターンに停止条件が追加されました（v2.1.280）。 このリリースまでは、安全性チェックから有効な判定が返らない場合に、自動モードが取るべき動作が定まっていませんでした。操作する側から見ると、どちらの不備も同じように現れていました。承認される見込みのない操作を繰り返し、トークンを消費し続けるターンです。v2.1.280では、それぞれに終了条件が設けられました。

サーバー側の審査対象コマンドを拡大（v2.1.281）。 分類器による審査がサーバー側で行われる場合、読み取り専用のシェルコマンドやサンドボックス内のシェルコマンドも審査を待ち、問題があると判定されればブロックされるようになりました。拒否メッセージも変更され、Claude が拒否の対象を、そのコマンドそのものだけでなく、コマンドがもたらす結果にも及ぶものとして扱うようになりました。新しいプロセスでセッションを再開した際には、分類器は以前のプロンプトキャッシュを再作成せずに再利用できます。また、/insights に自動モードの推奨機能が追加され、最近のセッションで表示された権限確認のうち、自動モードで処理できたと推定される件数を示します。²²⁴

無人セッションが rm の確認待ちで止まり続けなくなりました（v2.1.281）。 自動モードと --dangerously-skip-permissions では、危険な rm の確認に対する応答を2分間待ち、その後は書き換えのヒントを添えてコマンドを拒否するようになりました。これにより、無人セッションを続行できます。CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 でタイムアウトを無効にできます。rm -rf "$(pwd)" のように、対象がコマンド置換の出力だけで構成される再帰的な rm は、以前はどちらのモードでも確認なしで実行されていました。現在は、CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1 が設定されていない限り、Bash の許可ルールに一致しても確認を求めます。危険な rm のチェックでは、シェル変数の後ろに最上位ディレクトリ名が続く削除対象、作業ディレクトリに由来する変数を使った削除対象、バックスラッシュだけの削除対象も検出します。²²⁴ v2.1.299以降は、rm を実行しないシェルの -c スクリプトでは確認が表示されなくなりました。また、Claude Code が読み取れないスクリプト内で実行時に組み立てられる rm は、CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 が設定されている場合にのみ確認を求めます。²⁷¹

インラインの ! シェルは分類器の対象外に、subagents の結果返却は対象に（v2.1.271）。 拒否対象の追加ではなく、仕組みに関する2つの変更です。skills やスラッシュコマンド内のインライン ! シェルコマンドは、分類器ではなく、デフォルトモードの権限ルールに従うようになりました。どのルールでも判断がつかないコマンドは、審査を受けるツール呼び出しとして実行されます。また、subagents は専用の結果返却呼び出しを通じて呼び出し元に報告し、その呼び出しを安全性分類器が審査するようになりました。最後のメッセージを事後に審査する方式から、結果を渡すその時点で審査する方式へと、確認のタイミングが移っています。²¹⁶

v2.1.309とv2.1.310の新機能

Claude Code 2.1.309は2026年10月22日（npm は20:34 UTC、GitHub リリースは22:18 UTC、79項目）、2.1.310は10月23日（npm は21:20 UTC、GitHub リリースは23:39 UTC、26項目）に公開されました。どちらも正式な CHANGELOG と内容が一致しています。npm の latest と next は2.1.310です。stable は2.1.292から2.1.308に移りました。2.1.308のリリースノートは「バグ修正と信頼性の向上」の1行だけで、2.1.303（10月18日）にも同じ1行が記載されています。2.1.302から2.1.310までに欠番はありません。²⁷⁸

サンドボックスと権限の修正（v2.1.309）。 macOS と Linux のサンドボックス内の Bash コマンドは、各コマンドの実行前にシェルの起動ファイルをサンドボックス外で実行しなくなりました。macOS の denyWrite の glob パターンは、パターン内のフォルダにシンボリックリンク経由で到達する場合、パスの実際の場所に適用されます。サンドボックス内のコマンドや自動承認された編集は、--mcp-config で渡された MCP 設定ファイルを変更できなくなりました。Linux では、バックグラウンドコマンドがセッション終了後も動作し続けても、書き込み拒否が解除されなくなりました。また、サンドボックスが有効でも実行できない場合、設定によってサンドボックスから除外されたコマンドも、書き込み許可リスト内のパスに書き込む前に確認を求めるようになり、その状況でのサンドボックス外実行へのフォールバックは拒否されます。Bash の権限チェックでは、リダイレクトが失敗し得るコマンドで設定された変数を信頼しなくなりました。git の前に、ラッパーや接頭辞を伴う cd がある場合は確認を求め、サブシェル内の Bash リダイレクトにも Edit(path) の拒否ルールを適用します。worktree の隔離保護では、ロケール指定が前置されたコマンドや zsh の算術コマンドの拒否対象が増えました。プロファイルストアの書き込み保護は、設定ディレクトリがシンボリックリンクの場合にも適用されます。sed -i は、擬似的なファイル編集プレビューの代わりに、標準の Bash 確認プロンプトを表示して記述どおりに実行されるようになりました。また、ほかの Bash による編集と同様、/rewind で元に戻せなくなりました。サンドボックスモードをご覧ください。²⁷⁸ 信頼確認、worktrees、skills（v2.1.309）。 claude ultrareview にはワークスペースの信頼確認が必要です。ターミナルでは確認を求め、それ以外では実行を拒否します。スクリプトでは、値を取らない --trust-workspace を渡すか、CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1 を設定します。デスクトップアプリと VS Code の権限バイパスモードで危険な rm や rmdir を実行した際の確認は、書き換えのヒントを示して即座にコマンドを拒否するようになり、無人実行中のセッションが止まらなくなりました。worktree の作成と再利用では、必要に応じた git オブジェクトの取得を行わなくなりました（Bash サンドボックスを使う部分クローンでは、事前に取得します）。また、worktrees とブランチのチェックアウトでは git replace refs を無視します。サイズ上限を超えるネストされた CLAUDE.md は冒頭部分だけを読み込むようになり、その配下のファイルを読んだ後にセッションが圧縮を繰り返す問題を防ぎます。--add-dir フォルダー内の skill の名前が既存の skill と重複する場合は、<folder>:<name> として提示され、/verify と /code-review はネストされたパッケージ固有の skill を見つけます。分割ペインのエージェントチームメイトは、リーダーのツール拒否ルールと --tools ルールを継承します。また、/rewind には、/code-review --fix、subagent、シェルコマンドを通じてチェックポイント対象のファイルを変更したターンが表示されます。²⁷⁸

v2.1.310。 Monitor ツールと plugin のモニターが、Bedrock、Vertex、Foundry、およびテレメトリーや必須でない通信を無効にした環境でも動作するようになりました。これらの環境では、フォアグラウンドでの長時間のスリープもブロックされます。ゲートウェイや互換サーバーがベータ値 effort-2025-11-24 や会話途中のシステムメッセージを拒否した場合は、それらを除いてリクエストを再試行します。「Prompt is too long」エラー後の圧縮で、base64 や SVG などの高密度なテキストが過剰に残ることがなくなりました。cleanupPeriodDays が非常に大きい場合でも、バックグラウンドのクリーンアップで貼り付けた画像などの最近のファイルが削除されなくなりました。ファイル読み取りの確認には、シンボリックリンクの参照先が表示されます。自動モードで作業ディレクトリ外を初めて読み取る前の確認では、読み取りをブロックするとシェルコマンドで権限確認が必要になる場合、その旨を伝えます。非対話型セッションでは、非常に大きな会話履歴を圧縮する際のメモリ使用量が減りました。Ubuntu では、/sandbox と起動時の警告に、ユーザー名前空間に対する AppArmor の制限とその解除方法が表示されます。mod の Image は、allow-passthrough と focus-events が有効な tmux 内で描画されるほか、全画面描画を使う kitty、Ghostty、iTerm2 3.5+ でも描画されます。また、非対話型セッションで、サーバーからの入力要求が未回答のまま MCP ツール呼び出しがタイムアウトした場合は、繰り返さないよう Claude に伝えます。Enterprise のカスタムロールに、クラウドセッションと Remote Control の権限が追加されました。²⁷⁸

v2.1.307 の新機能

Claude Code 2.1.307 は、2026年10月21日にリリースされました（npm は 20:47 UTC、GitHub リリースは 22:17 UTC、43項目で正規の CHANGELOG と同一）。その前の 2.1.306（10月21日、02:28 UTC）には、2つの修正が含まれます。クラウドセッション内の claude -p が、セッションの環境変数がなくても「Not logged in」と報告しなくなったことと、MCP ツールが多いセッションで、API エラーが「prompt is too long」に置き換わって不要な圧縮が行われなくなったことです。2.1.308（10月22日、04:19 UTC）は、変更内容が1行の信頼性改善リリースで、stable になりました。²⁷⁸

テレメトリーと API skill。 OpenTelemetry イベント claude_code.safety_event は、権限ルール、自動モード、安全性チェック、hook、サンドボックスのいずれかによって停止された、確認を求められた、または差し戻されたツール呼び出しごとに発生します（環境変数リファレンスを参照）。/claude-api api-version は Claude の API コードを API バージョン 2026-10-21 に移行します。/claude-api managed-agents-secure（v2.1.304）は、変更を加えることなく、Managed Agents のエージェント設定を Anthropic が公開しているセキュリティガイドと比較します。この skill は、multiagent_20261001 上で Managed Agents の subagent チームを構築し、動的ワークフローをデフォルトで有効にするようになりました（v2.1.309）。²⁷⁸²⁷⁹

修正と動作。 opus[1m] など、[1m] サフィックス付きのエイリアスと CLAUDE_CODE_DISABLE_1M_CONTEXT を併用しても、モデルが見つからないというエラーが出なくなりました。カスタムの ANTHROPIC_BASE_URL ゲートウェイ経由や Foundry 上では、ベータヘッダー prompt-caching-scope を送信しなくなりました。macOS のログインキーチェーンがロックされている間に接続できなかった MCP サーバーは、その理由を表示するようになり、ロック解除後の次回実行では再サインインせずに接続できます。HTTP MCP ツール呼び出しの途中で接続が切れた場合、読み取り専用または冪等なツールだけを再試行するため、呼び出しが二重送信されなくなりました。PDF のページや画像を大量に読み込むターンで発生していた「Autocompact is thrashing」エラーを修正しました。解析できないツール呼び出しは最大2回再試行し、それでも失敗した場合にエラーでターンを終了します。同時に起動した fork subagents には、それぞれどの起動が自分のものかを伝えます。/permissions > 最近拒否された項目には、拒否されたシェルコマンドが表示されます。axScreenReader 設定と、設定の env ブロック内の CLAUDE_AX_SCREEN_READER は、ユーザー設定、管理対象設定、または --settings の設定からのみ適用されます（2.1.305 以降）。セルフホストランナーのチェックアウト hooks は、デフォルトで30分後に停止します（--checkout-hook-timeout-min、0 で無制限）。Code Review には、@claude review always による継続レビューを終了する @claude review stop が追加されました（off と pause も使用できます）。²⁷⁸

v2.1.304 と v2.1.305 の新機能

Claude Code 2.1.304 は2026年10月19日（npm は 19:47 UTC、GitHub リリースは 21:34 UTC、76項目）、2.1.305 は10月20日（npm は 19:29 UTC、GitHub リリースは 20:46 UTC、38項目）にリリースされました。どちらも正規の CHANGELOG と同一です。2.1.303（10月18日）は、変更内容が1行の信頼性改善リリースです。²⁷⁸

自動モードのセットアップと /usage の修正。 /auto-mode-setup（v2.1.304）は、プロジェクトと最近のセッションを読み取り、autoMode.environment エントリの案を作成するガイド付きセットアップです。Bedrock、Vertex、Foundry、Claude アプリのゲートウェイ、テレメトリーを無効にしたセッションでも利用でき、自動モードの設定ドキュメントで説明されています。/usage（v2.1.305）は、各警告を発生元がわかる1行の修正案として表示し、f で修正を適用できます。この修正案は VS Code と /doctor にも表示されます。また、/usage は使用量データに対するレート制限の終了時刻も表示します。Pro と Max では、しばらく使っていなかった会話を再開する際に、5時間の使用量上限を無視できない程度に消費する場合、警告とともに新しい会話を始める選択肢が表示されるようになりました（v2.1.304）。Max の自動モードと、スラッシュコマンドの /usage の行をご覧ください。²⁷⁸²⁷⁹

設定と環境。 sandbox.allowNestedUserNamespaces（v2.1.305）を使うと、Linux 上のサンドボックス内のコマンドでユーザー名前空間を作成できます（Chromium、rootless podman）。ただし、そのコマンドはサンドボックスのファイル保護を回避できるようになります。CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS（v2.1.305）により、無人再試行モードで、リセット前に解除された使用量制限を検知できます。CLAUDE_CODE_AUTO_COMPACT_WINDOW は --autocompact と同様に k と M サフィックスを受け付け、範囲外の値には警告を表示します（以前は 200k を指定すると、通知なく 100K のウィンドウが設定されていました）。allowedMcpServers は、${VAR} を env 内だけで使用する managed-mcp.json の stdio サーバーをフィルタリングしなくなりました。そのため、許可リストに含まれていないサーバーもアップグレード時に読み込まれます（無効のままにするには deniedMcpServers を使用してください）。カスタムの ANTHROPIC_BASE_URL 経由では、ツール検索がデフォルトで有効になりました（v2.1.304）。また、v2.1.305 では、ツール検索を拒否するエンドポイントを持つ Vertex、Bedrock などのプロバイダーですべてのリクエストが失敗する、2.1.304 のリグレッションを修正しました。Claude Code は、ツール検索を使わずに再試行するようになっています。Claude Desktop がパスを指定してマウントする plugins は、allowManagedPermissionRulesOnly が有効な場合、allowed-tools が適用されなくなります。ツール検索のデフォルト設定を除き、これらはすべて10月23日時点でドキュメントに記載されています。²⁷⁸²⁷⁹

Mods、skills、hooks。 mod の tool.check イベントには e.isReadOnly が含まれます。その応答で decider: "person" を設定すると、権限ダイアログまたはホストのコールバックだけが承認できます。settings.read hooks は各設定レイヤーを受け取り、マージ後の設定を書き換えます。会話履歴には、設定した hooks のいずれかをスキップした plugin の名前が記録されます。また、ドッキングされたペインはターミナル幅の45%以内に収まります（v2.1.305）。圧縮後は skills の一覧を Claude に再送し、/reload-skills は新規または変更された skills だけを送信します。同じソースの skills が1セッションに登録できる上限は、1,024個の hooks と、マッチャーの合計16,384文字です。skill の once hook が、別の skill の同一の hook を削除することはなくなりました。ワークフローを再開すると、完了済みの pipeline() と parallel() のエージェントは再実行せず、実行ジャーナルに記録された結果を使います（v2.1.305）。実行間隔を自動調整する /loop では、上限の1時間後に再開する際、プロンプトキャッシュの有効期限が切れた直後になることがなくなりました。claude --worktree は、HEAD が detached 状態または別のブランチ上にある場合でも、終了時に確認なく worktree とそのブランチを削除しなくなりました。マウントされたドライブやその最上位のフォルダーに対して rm -r を実行すると、安全性の確認が表示されます。Code Review にはレビューレベル（Quick、Standard、Deep）と、GitHub 組織内のすべてのリポジトリをレビューするオプションが追加されました。Opus 5.5 では、/fast ダイアログの「(research preview)」ラベルが削除されます。²⁷⁸

v2.1.302 の新機能

Claude Code 2.1.302は2026年10月16日にリリースされました。npmでは16:48 UTCに公開され、20:53 UTCには正式なCHANGELOGと同じ63項目を含むGitHubリリースが続きました。npmのlatestとnextはいずれもこのバージョンを指し、stableは2.1.292のままです。2.1.301（10月15日、51項目）に続くリリースで、飛ばされたバージョンはありません。10月17日に取得したドキュメントには、2.1.301のvimモーションとVS Codeの数式表示は反映されていますが、以下の項目はまだ掲載されていません。そのため、各項目の出典はCHANGELOGです。²⁷⁵²⁷⁶

claude -pとSDKが再びManualで開始します。 権限モードを指定していないclaude -pまたはAgent SDKのセッションは、サードパーティプロバイダーを利用している場合、テレメトリが無効な場合、新規インストールの場合に、default（Manual）で開始するようになりました。--permission-mode autoを指定した場合は引き続きautoです。これは、これらのセッションをautoモードで開始していたv2.1.285のルールを元に戻す変更です。対話型ターミナルとVS Codeのセッションは従来どおり、すべてのプランとプロバイダーでautoモードになります。権限モードのドキュメントには、まだv2.1.285の動作が記載されています。権限モードをご覧ください。²⁷⁵²⁷⁶

fork subagentsとバックグラウンド実行の既定動作。 fork subagents（subagent_type: "fork"）は、すでに有効だったターミナルに加え、claude -p、Agent SDK、デスクトップアプリ、VS Codeでも既定で有効になりました。CLAUDE_CODE_FORK_SUBAGENT=0で無効にできます。claude mcp serveでは提供されません。デスクトップアプリとVS Codeでは、メインの会話のsubagentsをバックグラウンドで実行するかどうかをClaudeに任せる方式から、ターミナルと同様に常にバックグラウンドで実行する方式に変わりました。一方、claude -p、SDK、デスクトップアプリ、VS Codeでsubagent自身が行うAgent呼び出しは、既定でフォアグラウンド実行になります。プロンプト型とエージェント型のhooksでは、同じイベントに対して同時に実行できる数が最大12になり、残りは順番を待ちます。環境変数とsubagentsのドキュメントには、まだforkモードが有効なのは対話型セッションのみと記載されています。subagentsとは？をご覧ください。²⁷⁵²⁷⁶

autoモードとコンパクション。 CLAUDE_CODE_AUTO_MODE_MODELで、クライアント側のautoモード分類器が使用するモデルを選択できます。サーバー側のautoモードのモデルは変更されません。サーバー側の分類器では、会話が長すぎて安全性チェックを行えない場合、チェック対象のツール呼び出しをすべて拒否する代わりに、会話をコンパクションするようになりました。/configにはアイドル時のコンパクションという項目が追加され、アイドル時のコンパクションを無効にしたり、再び有効にしたりできます。実行後の通知にも、無効にする方法が表示されます。コンパクションの途中でターンを停止した際に発生していた「プロンプトが長すぎます」というエラーが修正されました。また、ゲートウェイがOpus 4または4.1をanthropic/claude-opus-4-1のようなプレフィックス付きの名前で扱う場合も、/autocompactと/effortが正しいモデルに設定を保存するようになりました。²⁷⁵

Claude Designは2026年12月14日までに終了します。 /design-syncと/design-loginに、スタンドアロン版のClaude Design（claude.ai/design）がその日までに終了するという通知が表示されるようになりました。また、/design consentと/design revokeは、クラウドセッションの案内先を/design-loginからclaude.ai/design/settingsに変更しました。スラッシュコマンドの/designの行をご覧ください。²⁷⁵

知っておきたい修正。 Readツールが、サイズにかかわらず画像全体をメモリに読み込んだり、画像のような名前のパイプやデバイスを丸ごと読み込んだりすることはなくなりました。128 MBを超える画像ソースは拒否されます。セッションの途中で追加したツールをToolSearch経由、またはコンパクション後に再読み込みしても、プロンプトキャッシュのミスが発生しなくなりました。claude pluginなどのサブコマンドは、待機中の設定の書き込みが完了してから終了するため、変更が失われたり、.tmpファイルとして残ったりすることがなくなりました。gitの既定の参照形式がreftableの場合に、pluginsのマーケットプレイスが更新のたびに再クローンされたり、git pluginsのバージョンが「不明」と表示されたりする問題も解消されています。git 2.56以降では、残存する.gitファイルが存在しないディレクトリを指していても、worktreeによる分離が機能します。プロトコルバージョン2026-07-28をネゴシエートしながらresultType、ttlMs、cacheScopeを省略するMCPサーバーでも、ツールが表示されるようになりました。使用量クレジットに課金される応答の後は、プロンプトの提案が省略されます。セッションの途中でVertexまたはBedrockに切り替えた後に、「diagnostics: 追加の入力は許可されていません」というエラーでリクエストが失敗することもなくなりました。多数のpluginsがある場合の起動が高速化され、特にWindowsで効果があります。また、WindowsのexFATまたはFAT32ドライブへのファイル書き込みが拒否される問題も解消されました。²⁷⁵

クラウドセッションとClaude Tag。 ルーチンのページに、組織のクラウドセッション同時実行数の上限など、前回の実行が開始されなかった理由を示すバナーが表示されます。「ここまで巻き戻す」がすべてのメッセージで機能するようになりました（セルフホスト型ランナーではv2.1.246以降が必要です）。途中で失敗した実行が1時間後に最初から繰り返されることはなくなり、クラウドセッションが新しいプロセスで再開された後も、コストと使用量がゼロに戻らなくなりました。Claude Tagの管理者設定は、バンドル、コネクター、skillsとplugins、チャネルの各タブに再編されました。Slackに添付されたHEIC、SVG、TIFF、BMP画像は、ファイルとしてClaudeに届くようになりました。また、組織がロールで利用を制限している場合、マネージャーロールでもSlackのClaude Tagを利用できるようになりました。²⁷⁵

v2.1.301の新機能

Claude Code 2.1.301は2026年10月15日にリリースされました（npmでは14:34 UTCに公開され、19:22 UTCのGitHubリリースには正式なCHANGELOGと同じ51項目が掲載されています）。翌日にはnpmのlatestが2.1.302に移ったため、ここでは両方のリリースをまとめて取り上げます。²⁷⁵

無人再試行に使用量制限の待機上限が追加されました。 CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MSを設定すると、無人再試行モード（CLAUDE_CODE_RETRY_WATCHDOG）で使用量の上限に達した際、リセットまでの時間が長すぎる場合は待機せずにリクエストを終了します。環境変数リファレンスでは、CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MSと並べて紹介しています。運用に関わる変更はほかにもあります。コンテキストウィンドウが小さいモデルに切り替える際、会話が新しいモデルには長すぎる場合は、確認なしに使用量クレジットを消費して要約する代わりに、切り替え前のモデルが要約するようになりました。fableとbestのエイリアスは、最新のFableモデルを組織で利用できない場合、1つ前のFableモデルで1回再試行します。また、LLMゲートウェイの応答にリクエストと異なるモデル名が含まれていても、会話が何度もコンパクションされることはなくなりました。²⁷⁵

テレメトリ、vim、mods。 OpenTelemetryのtool_decisionイベントにclassifier_verdictとpermission_modeが追加され、autoモード分類器の判断と権限ルールによる判断を区別できるようになりました。OTEL_LOG_TOOL_DETAILS=1の場合は、分類器によるブロックがどの組み込みルールに該当したかを示すclassifier_categoryも追加されます。Vimモードには%モーションが追加され、単独でも、d、c、yと組み合わせても、対応する括弧に移動できます（対話型モードのドキュメントにはすでに掲載されています）。ModsではInputにrowsが追加され、ターミナルで複数行のテキストフィールドを使えるようになりました。Enterで送信し、Shift+Enter、またはバックスラッシュに続けてEnterを押すと改行できます。modのhookの.catchハンドラーは、そのhookが例外をスローするかタイムアウトした場合にのみ実行されるようになりました。$.env.setは、変数の設定または解除が完了すると{}で解決され、拒否された場合は理由を示す{ deny }で解決されます。$.model.forkは、新しいプロセスの最初の応答前にnothing-to-forkを返さなくなりました。また、VS Codeとデスクトップアプリ、モバイルアプリでは、質問ダイアログの上に描画するツリーにMarkdownと最大48行を含められるようになりました。ModsとVimモードをご覧ください。²⁷⁵²⁷⁶

知っておきたい修正。 WorktreeCreateのhookが作成したworktreeに未プッシュのコミットが含まれている可能性がある場合、終了時に確認なく削除されることはなくなりました。GrepとGlobは、検索プログラムが失敗した際に「一致なし」ではなくエラーを報告します。引数名が非常に多い、または非常に長いskillsやコマンドでも、数秒間処理が止まることはなくなりました。補完対象は最初の64個の名前に限られ、それぞれ最大64文字です。Readツールが.xlsm、.parquet、.epub、.heicなどのバイナリファイルをテキストとして読み込むことはなくなりました。/rewindの後に、skillsの一覧が再びモデルに提示されるようになりました。ツール呼び出しの権限確認中に、ターンの途中で送信したメッセージによってその呼び出しが中断されても、ユーザーが拒否したとモデルに報告されなくなりました。vimモードでEscを押しても、入力済みのAskUserQuestionへの回答が破棄されなくなりました。自由入力欄がNORMALモードに対応し、EscによるキャンセルはNORMALモードからのみ行われます。ディスクの空き容量がなくなると、誤解を招く「/loginを実行してください」ではなく、該当ディスクを明示したエラーが表示されます。Slackから起動したセルフホスト型ランナーは、管理対象設定でMCPサーバーが制限されていてもリポジトリを接続できます（それらのツールを無効に保つにはdeniedMcpServersを使用してください）。VS Codeでは、$$や\[ ... \]のブロックを含む応答内のLaTeX数式が表示されるようになり、ProとMaxの使用量上限バナーには「使用量を追加する」リンクが表示されます。²⁷⁵

v2.1.300の新機能

Claude Code 2.1.300は、2.1.299の数時間後、2026年10月14日にリリースされました。npmでは14:27 UTCにnextとして公開され、18:24 UTCには正式なCHANGELOGと同じ88項目を含むGitHubリリースが続きました。夕方までにはnpmのlatestとnextがどちらも2.1.300になり、stableは2.1.287から2.1.292に移りました。飛ばされたバージョンはありません。²⁷³ advisorツールがAWS上のClaude Platformに対応しました。 AWS上のClaude Platformで/advisorを使えるようになりました。/advisor、advisorModel、--advisorのいずれかで選択するまでadvisorは実行されず、CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1でツールを無効にできます。10月14日時点では、advisorのドキュメントページにはAWS上のClaude Platformが依然として非対応プロバイダーに含まれています。Claudeが判断の節目で別のモデルに相談できるこのツール自体は、今回のリリース以前から存在しており、Advisorツールで説明しています。²⁷³²⁷⁴

Modsとテレメトリ。 Modsに、virtualTextによるプロンプト装飾（プロンプト入力欄に表示されますが、下書きには含まれないテキスト）、メインビューにエージェントの会話記録を表示する$.ui.view({ agentId })（$.ui.view({})で元に戻ります）、右から左に表示する行に対応するTextのdirプロパティ、文字入力以外によるプロンプト入力欄の変更（履歴の呼び出し、クリア、元に戻す操作、pluginsによる入力）を扱うprompt.change hookが加わりました。agent.spawnでは、ワークフローのエージェントを拒否するだけでなく、そのpromptとmodelを書き換えられるようになりました。また、modsリファレンスでは、next.error.causeのrewrittenがv2.1.300で追加されたと記載されています。OpenTelemetryのapi_requestイベントでは、キャッシュへの書き込みがcache_creation_5m_tokensとcache_creation_1h_tokensに分かれます。トレーススパンには、gen_ai.provider.name、gen_ai.conversation.id、gen_ai.tool.name、error.typeなど、GenAIのセマンティック規約に沿った属性が含まれます。また、modのprompt.submit hookによって書き換えられたり破棄されたりしたプロンプトが、入力されたままの内容としてuser_promptイベントに記録されることはなくなりました。ローカルの会話記録にも、各APIリクエストのシステムプロンプト、ツール、パラメーターが記録されるようになったため、共有した会話記録からリクエストを正確に再現できます（Modsとテレメトリを参照してください）。²⁷³²⁷⁴

運用と動作の変更。 api.anthropic.comへの大きなリクエストでは、テレメトリが無効でもgzipを使用します。CLAUDE_CODE_GZIP_REQUEST_BODIES=0で無効にできます。PreToolUseとPermissionRequestのhooksが返すupdatedInputは、Claude自身の入力と同じように検証されます。不明なキーは削除され、ツールが受け付けない入力であれば呼び出しが拒否されます。終了時には、停止を求めてから1.5秒経過しても動作しているバックグラウンドコマンドが強制終了されます。claude remote-controlからは、実際には効果のなかった--sandboxと--no-sandboxフラグが削除されました。どちらかを渡すとエラーで終了します。このようなセッションをサンドボックス化するには、設定のsandbox.enabledを使用します。CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTが適用されるセッションでは、設定内のSSL_CERT_FILEなど、CAバンドル、ツールプロキシ、git TLS、git設定に関する変数が無視されます。Coworkのクラウドセッションでは、PermissionRequest hookのsetModeは無視されますが、それ以外の承認内容は適用されます。Claude DesktopのCodeタブでは、forceLoginGatewayUrlがセッションのホスト名を処理するAnthropic運営のゲートウェイを指定している場合、管理対象設定が適用されます。また、claude gatewayは、使用できないdesktop:ポリシーキーがあると起動時に停止します。/sandboxの選択肢は「コマンドをサンドボックス化」という表記になります。VS Codeには、エディターの選択範囲をメッセージに含めないためのclaudeCode.attachSelectionが加わりました。Slackでは、管理者が許可すると、Claude TagがSlack Connectチャンネルで応答できるようになります。²⁷³

押さえておきたい修正。 バックグラウンドコマンドが実行中でも、終了時にSessionEnd hooksが実行されるようになりました。ENABLE_TOOL_SEARCH=autoが会話の途中で無効になる問題も解消されています。forceLoginOrgUUIDによってログインが拒否された際に、その組織のトークンが保存されたままになることはなくなりました。コンパクション後に再開したヘッドレスセッションとSDKセッションでは、コンパクションによって保持されたメッセージと要約が維持されます。APIがMCPツールの入力スキーマを拒否しても、会話の各ターンが400エラーで失敗し続けることはなくなりました（代わりに、ツールがパラメーターなしで送信されます）。エージェントのhooksでは、指定したmodelが使用されます。--worktreeセッションは、コミットIDと同じような名前のタグやブランチがあっても正しいコミットから開始し、reftableリポジトリでも再び開けるようになりました。claude daemon stop --anyは停止を待ち、応答しないサービスを強制終了し、それでも残っている場合は終了コード1で終了します。Coworkのクラウドセッションで、WriteとEditが手元のコンピューター上のパスへの操作を成功したと報告することはなくなりました。組織のポリシーを読み取れないときに、クラウドセッションが毎ターン5分間停止する問題も解消されています。また、セルフホスト型ランナーは、出力を読み取る相手がいなくてもフリーズしなくなりました。²⁷³

v2.1.299の新機能

Claude Code 2.1.299は2026年10月14日にリリースされました（npmではUTC 00:23。UTC 02:49のGitHubリリースには、正式なCHANGELOGと同じ190項目が掲載されています）。2.1.297と2.1.298は公開されていないため、ここで省略しているバージョンはありません。npmのlatestは、同日中に2.1.300へ切り替わるまで2.1.299でした（v2.1.300の新機能を参照してください）。²⁷¹²⁷³ 2.1.296からはアップグレードをおすすめします。このリリースでは、2.1.296で生じた2つの不具合が修正されています。1つは、Coworkとclaude.aiのクラウドセッションで、UserPromptSubmitまたはmodのprompt.submit hooksの実行中にメッセージを停止すると、EditとRetryが失敗する問題です。もう1つは、再起動後のクラウドセッションまたはヘッドレスセッションが再開するタイミングで新しいメッセージが届くと、承認済みのツール呼び出しが2回実行される問題です。

アイドル時のコンパクション（v2.1.299）。 200Kトークン以上のターミナル上の会話を約54分間操作せずにいると、1時間のプロンプトキャッシュが期限切れになる前にコンパクションが行われるようになりました。これにより、次のメッセージでコンテキスト全体を再処理せずに済みます。CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENSで200Kという下限を変更でき（100,000未満の値は100,000に引き上げられます）、settings.jsonの"idleCompaction": falseで無効にできます。設定リファレンスと環境変数のページには両方が掲載されており、v2.1.290以降の機能とされています。CLAUDE_CODE_DISABLE_FILE_MENTIONS=1を設定すると、@メンションでファイルの内容を渡す代わりに、Claudeがファイルツールで読み取るためのパスを渡すようになります。そのため、読み取り時にPreToolUse hooksが実行されます。プロジェクト設定やローカル設定では、この変数を設定できません（環境変数リファレンスを参照してください）。²⁷¹²⁷² v2.1.302では、/configにアイドル時のコンパクションの行が追加され、無効化や再有効化ができます。アイドル時のコンパクション後に表示される通知にも、その方法が記載されます。²⁷⁵

権限とMCP。 mcp__aのような許可ルールは、aという名前のサーバーだけに適用され、a__bやa_には適用されなくなりました。サーバーの正規化後の名前全体を使い、mcp__<server>__*と記述してください。名前に__を含むサーバーをエージェントのtools:リストに指定する場合も、同じように記述します。この指定で追加されるのは、そのサーバーのツールだけになりました。正規化後の名前にアンダースコアが2つ連続して含まれるサーバーでも、拒否ルールと確認ルールが再び適用されます。api.anthropic.comにあるAnthropicのファーストパーティーMCPサーバーから提供されるツールの説明とサーバーの指示は、4,096文字で切り詰められず、全文がClaudeに渡されます。フラグを取得しないインストール環境では、クラウドセッションとRemote Controlのコネクターが、デフォルトでMCPプロトコル2026-07-28をネゴシエートします（MCP_PROTOCOL_NEGOTIATION=legacyで無効にできます）。claude.aiのコネクタープロキシとAnthropicがホストするMCPサーバーへのリクエストは、HTTPリダイレクトを追従しなくなりました。MCP OAuthは、設定されたheadersとheadersHelperの値を送信するようになりました。空の.mcp.jsonが無効と報告されることはなくなり、constructorやprototypeという名前のサーバーにも接続できます。サンドボックス内のコマンドは、--plugin-dirフォルダーへの書き込みや、シンボリックリンクを経由したアクセス禁止パスへの到達ができなくなりました。rmを実行しないシェルの-cスクリプトでは、rmの確認プロンプトが表示されなくなりました。また、Claude Codeが読み取れないスクリプト内で実行時に組み立てられるrmについては、CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1の場合にのみ確認が表示されます。²⁷¹

Hooksとmods。 UserPromptSubmit hooksは、skillsやカスタムスラッシュコマンドが展開される前に実行されます。そのため、hookがプロンプトをブロックすると、そこに埋め込まれたシェルコマンドも停止します。また、skill自身のフロントマターにあるUserPromptSubmit hookが初めて実行されるのは、そのskillを呼び出した次のプロンプトです。pluginのhookにアクションを渡せない場合や、hookから応答を受け取れない場合は、アクションを通さず拒否するようになりました。すでにツールが実行されている場合は、その結果が渡されません。Modsでは、turn.start hookがsubagentsとチームメイトのターンも受け取るようになりました（e.agentIdで区別できます）。skill.promptはskillのフロントマター、ソース、plugin名、ファイルパスを受け取ります（modsリファレンスでは、これらはv2.1.299で追加されたと記載されています）。$.prompt.mediaを使うと、管理対象設定のmodのprompt.submit hookから、添付された画像や文書を読み取れます。$.session.identity()は、セッションのサインイン方法を返します。Textはsize、weight、mono、tabularを受け取り、Boxは名前付きの余白段階を受け取ります（boldは非推奨となり、代わりにweightを使います）。session.appendにはqueue経由の追加方法が加わり、再開されたsubagentやチームメイトに対しても、resumeを設定した状態でagent.spawnが発火します。リモートで無効にされたmodsは、ターンの合間にアンロードされます。また、組織がClaude Codeを管理している環境では、/pluginとclaude plugin validateがスキップされたhooksの名前を表示します（Modsを参照してください）。²⁷¹²⁷² コマンド、操作画面、運用。 /usage は、maxの推論努力、ワークフロー、常時読み込まれるコンテキスト、大きなツール結果について警告します。エージェントビューでは、/effort と /fast で新しいセッションの開始時の設定を指定できます。引数なしの /model、/effort、/fast は選択画面を開き、プレビューパネルには --safe-mode で開始したセッションのセーフモード表示が出ます。Planモードでは、権限チェックのバイパスを利用できるためにほとんどの編集で事前確認を行わない場合、その旨を1度だけ表示します。claude plugin eval は --disallow-tools とケースの disallowed_tools フィールドを受け付け、API エラーで終了した実行はスコアが0となり、スイート全体が失敗します。claude self-hosted-runner orchestrator --shutdown-drain-sec は、SIGTERM受信時に、実行中のポーリングと起動時のhooksが完了するまでの猶予時間を設けます。Claude apps gateway経由では、code または cli ポリシーの env に CLAUDE_CODE_ATTRIBUTION_HEADER=0 を設定すると、帰属情報のブロックを削除できます。Coworkのクラウドセッションでは、autoモードで PermissionRequest hookがシェルコマンドやsubagentsを承認できなくなりました。また、承認済みサイト上の Claude in Chromeの操作が安全性分類器に検知された場合は、拒否される代わりにユーザーへの確認が行われます。終了時に表示される再開コマンドはセッションをIDで指定します。非対話型セッションの /btw は11分でタイムアウトし、ローカルセッションで監視できる公開済みアーティファクトは10件から25件に増えました。また、サイバー保護の通知でCyber Verification Programへの申請を求められることもなくなりました。²⁷¹

知っておきたい修正。 カスタムの ANTHROPIC_BASE_URL を経由するストリームは、180秒で中断せず、データを300秒待つようになりました。Anthropic への機能フラグ、起動、fastモード、プロファイル、サーバー管理設定のリクエストに、サードパーティーのゲートウェイの API キーが含まれなくなりました。/usage とステータス行で使用率が100%を超えて表示されることもなくなりました。夏時間の終了時に同じ時刻が繰り返される1時間の間、スケジュール済みタスクやループが毎ターン再実行される問題も修正されています。--debug の使用時や、親プロセスがstderrの読み取りを停止した場合に、メモリ使用量が際限なく増えることもなくなりました。SendMessage は再起動後も名前でsubagentを見つけられます。Readはバイトオーダーマーク付きのUTF-16LEファイルに対応し、WriteはWindows-1252、Shift-JIS、GBK、UTF-16BEのファイルを通知なくUTF-8に変換することを拒否します。Windowsでは、シェルを指定していない PreToolUse と PermissionRequest のhooksが、Git for Windowsが見つからない場合に、呼び出しを通過させずにブロックするようになりました。²⁷¹

v2.1.293〜v2.1.296の新機能

2026年10月7日から10月9日にかけて、4つのリリースが公開されました。npmの latest と next は2.1.296、stable は2.1.285から2.1.287に更新されています。²³⁸ 最大の変更は新モデルです。v2.1.293で Claude Haiku 5.5が登場し、Anthropic API では haiku でこのモデルが選択されるようになりました（利用可能なモデルを参照）。管理設定から Claude apps gatewayにサインインしている場合は、v2.1.296にアップグレードしてください。forceLoginMethod が gateway で forceLoginGatewayUrl が未設定の場合に、保存済みのゲートウェイログインが無視される、v2.1.295のリグレッションが修正されています。

v2.1.296（10月9日）。 /cost、ステータス行、--max-budget-usd、SDK のコスト表示で、Sonnet 5.5のキャッシュ読み取り料金が100万トークンあたり$0.10になりました。以前は$0.20で計算されていました。最初に送信される MCP ツールの説明と MCP サーバーの指示のデフォルト上限は、2,048文字から4,096文字に増えました。subagentのフロントマターと --agents 定義で autoCompactWindow を指定できるようになり、メインの会話より早い段階でsubagentを自動圧縮できます。CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL はすべてのワークフローエージェントを1つのモデルで実行し、それ以外のsubagentsはそれぞれのモデルを維持します。CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS では、529エラー時のバックオフの最大待機時間を長く設定できます。Readツールは allow_large を受け付けるようになり、コンテキストに余裕があれば、Claude は通常のサイズ制限を超えるテキストファイルも1回の呼び出しで読み取れます。管理設定の PreToolUse hooksが "continue": false でツール呼び出しを拒否した場合や、管理対象の prompt hooksが呼び出しをブロックした場合は、呼び出しの拒否に加えてターンも終了するようになりました。--debug は、カスタムエージェントファイル内の認識できないフロントマターフィールド名を表示し、各コマンドhookのコマンド、plugin、結果、所要時間を記録します。Claude apps gatewayでは、managed.policies[] の下に code キーが追加されました。cli と同じ設定を持ち、Claude DesktopのCodeタブにも適用されます。← でセッションをバックグラウンドに移す間に開始されたターンや ! コマンドは、見えないところで完了するのではなく、停止するようになりました。その後、これらのうち2点がドキュメントにも反映されています。hooksリファレンスでは、hookごとの --debug 出力がv2.1.296で追加されたと記載され、Claude apps gatewayのドキュメントでは code ポリシーキーが説明されています。autoCompactWindow と CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS は、10月14日までにそれぞれsubagentsと環境変数のドキュメントに追加されました。CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL は、2026年10月14日時点ではリリースノートにのみ記載されています。^238240270272

v2.1.295（10月8日）。 コマンドhooksとHTTP hooksが onFailure: "block" に対応しました。hookが起動できない場合、タイムアウトした場合、想定外のコードで終了した場合は、操作を通過させずにブロックします（hookの入出力プロトコルを参照）。CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS は、無人リトライモードで429エラーと529エラーの解消を待つ時間に上限を設定します。subagentsが skills フィールドから事前に読み込むskillsは最大32個となり、ツール検索で読み込まれる MCP ツールの説明は、2,048文字ではなく16,384文字で切り詰められるようになりました。管理設定のないマシンでも、個人のユーザー設定で forceLoginMethod: "gateway" と forceLoginGatewayUrl が使えるようになり、/login が指定したゲートウェイを開きます。この構成はゲートウェイのドキュメントにも記載されました。各ゲートウェイのアップストリームには任意の models リストを指定でき、* をワイルドカードとして使えます。また、クラウドのアップストリームは timeouts.upstream_ttfb_ms に従います。Program Status Protocol（OSC 7501）を実装するターミナルは、Claude Code が作業中か、ユーザーの応答待ちか、完了したかを表示できます。Claude apps gateway経由のバックグラウンドリクエストは、ゲートウェイがHaiku 4.5を提供していれば、セッションのモデルではなくHaiku 4.5を使います。[1m] モデルのcontext-1mベータ指定がゲートウェイ、Bedrock、Vertex、Foundryに拒否された場合は、失敗する代わりに、その指定を外して再送信します。接続中のバックグラウンドセッションで、待機中のプロンプトに対してCtrl+Cを押しても、保留中の /loop の起動予定は取り消されません。2回押すと接続が切れ、ループは実行を継続します。Escを押すと停止します。フラグを取得しないインストール環境では、claude.aiコネクターはデフォルトで MCP プロトコル2026-07-28をネゴシエートします。/copy で引用テキストを選べるようになり、claude -p は最後のターンの後に何を待っているかをstderrに表示します。modsには $.ui.notify が追加されました。推論努力が xhigh や max の場合でも、ウェブ検索や agent hookの評価に大幅に長い時間がかからなくなりました。²³⁸²⁴⁰

v2.1.294（10月8日）。 指示文として記述された prompt hooksと agent hooksに2つの修正が入りました。「〜するコマンドをブロックする」といったhookが、本来ブロックすべき操作を許可しなくなりました。また、「ビルドが壊れている場合は続行する」といったStop hooksとSubagentStop hooksの判定が改善され、Claude が早すぎる段階で停止しにくくなっています。²³⁸

v2.1.293（10月7日）。 Claude Haiku 5.5（claude-haiku-5-5）が、Anthropic API のデフォルトのHaikuモデルになりました。コンテキストは1M、料金は100万トークンあたり$0.10/$0.50で、100Kを超えるプロンプトでは$0.50/$2.50です。subagentStatusLine のペイロードに agentType が追加され、ステータス行のスクリプトでカスタムsubagentの種類を区別できるようになりました。modsでは $.tool.register に isDeferred が追加されています。2つの変更が取り消されました。1つは、拒否が特定のコマンドだけでなく、その結果にも及ぶことを Claude に伝えていたv2.1.281のautoモードの拒否メッセージです。もう1つは、コンテナー再起動後に /loop の起動予定が失われる問題に対するv2.1.290のクラウドセッションの修正で、該当するセッションは再び休止したままになります。このほか、Claude がコンテキスト圧縮直前の自身の最後の操作を、圧縮後に完了済みと見なさなくなりました。HTTP MCP 接続が、閉じるまで送信済みの全リクエストを保持し続けることもなくなりました。claude purge は、何も表示せず停止する代わりに、削除できなかった項目を一覧表示して終了コード1を返します。セッションを使用していない間のclaude.aiのskills同期チェックは、10分ごとから40分ごとになりました。また、TeamとEnterpriseでは、起動時にポリシーと管理設定をより早く取得し、応答が止まったリクエストを3秒後に再試行します。²³⁸²⁴⁰

v2.1.288〜v2.1.292の新機能

2026年10月2日から10月6日にかけて、5つのリリースが公開されました。npmの latest と next は2.1.292で、stable は2.1.285のままです。²³⁴ 2.1.288、2.1.289、2.1.290を使っている場合は、アップグレードしてください。v2.1.291では、終了時にセッションの最後のメッセージが失われる可能性がある2.1.288のリグレッションと、クラウドセッションで権限確認への応答が失われる可能性がある2.1.290のリグレッションが修正されています。²³⁵ v2.1.292（10月6日）。 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS を設定すると、過負荷（529）リクエストを再試行する際のバックオフの基本待機時間を長くできます。環境変数のドキュメントには、デフォルト値の500 msと、指定可能な範囲の500〜32000が記載されました。Agentツールが effort パラメーターに対応し、Claude が指定された推論努力レベルでsubagentを実行できるようになりました。subagentsのドキュメントには、この呼び出しごとのパラメーターがfrontmatterのフィールドを上書きし、subagentの再開後も有効であることが記載されています。CLAUDE_CODE_EFFORT_LEVEL は、その両方よりも優先されます。claude plugin install --marketplace <source> を使うと、1つのシェルコマンドでマーケットプレイスの追加と、そこからのインストールを実行できます。ローカル（stdio）のMCPサーバーでは、Bedrock、Vertex、Foundryを含むすべてのインストール環境で、デフォルトでプロトコル2026-07-28のネゴシエーションを行うようになりました。MCP_PROTOCOL_NEGOTIATION=legacy で無効にできます。MCPのドキュメントにも、stdioサーバーにはデフォルトでこのリビジョンを要求すると記載されました。エージェント名の上限は256文字です。これを超える名前は拒否され、skillやpluginファイル内の長すぎる name は無視されます。subagentsのドキュメントにも name フィールドの上限が明記され、名前が上限を超えるsubagentファイルはスキップされて、デバッグログにエラーが記録されます。セキュリティ修正により、ネットワーク（UNC）パスからファイルを読み取る際の確認プロンプトを、PreToolUse hookの承認や自動モードで回避できなくなりました。Modsには prompt.autocomplete、$.model.complete でのプロンプトキャッシュ、agent.spawn でのワークフローエージェントが追加され、claude plugin test はスタブの回答が拒否応答だった場合に失敗するようになりました。それ以外の項目は、2026年10月6日時点ではリリースノートのみに記載されていました。^236237240

v2.1.290（10月5日）。 対話時のWebSearch利用枠は、200回で使い切る方式から、1時間あたり100回補充される方式に変わりました（CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR。0 で補充を無効にします）。claude attach と claude logs では、セッション名の一部を指定できます。/claude-api managed-agents-onboard <url> はManaged Agentsパターンを説明するページを ant apply 用のファイルに変換し、/claude-api managed-agents-onboard <quickstart-name> は ant CLIを使って deep-researcher などのConsoleクイックスタートテンプレートを構築します。いくつかのデフォルト動作も厳格化されました。プロジェクトの設定からChromeでClaudeを有効にすることはできなくなり、リポジトリの .claude/settings.json や .claude/settings.local.json では CLAUDE_CODE_DISABLE_ATTACHMENTS を設定できなくなりました。pyright や、より多くの形式の ps は実行前に確認を求め、管理対象設定フォルダーの外部にリンクする管理対象設定ファイルには警告が表示されます。WebFetchは、ページが100,000文字を超えた場合に未読部分の量を示し、offset を指定して続きを読むことができるようになりました。以前は、この部分のテキストを通知せずに切り捨てていました。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC は起動時の接続ウォームアップもスキップします。また、CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m が5 msと解釈されることはなくなりました。単位の接尾辞を含む値は、dialogExpiry の設定にフォールバックします。²³⁵²³⁷

v2.1.290、チームとゲートウェイ。 Claude appsゲートウェイのサインイン承認ページに「拒否」ボタンが追加され、サポート対象のPostgreSQLの最低バージョンが14から11に引き下げられました。セルフホスト型ランナーでは、claude --environment <id> が現行のSessions API経由でセッションを作成します。claude --teleport と /teleport は、追跡対象ファイルが同名のフォルダーに置き換えられている場合、そのフォルダー内のファイルを削除することになるstashを拒否します。また、--channels リレーは、重複した返信IDで別のプロンプトを承認するのではなく、そのIDを無視するようになりました。Slackでは、!fast でスレッドを高速モードに切り替え、!fast off で元に戻せます。VS Codeでは、メッセージのタイムスタンプがデフォルトで表示されます（Claude Code: メッセージのタイムスタンプを表示の設定で非表示にできます）。²³⁵

v2.1.289（10月3日）。 Modsに、チームメイト用の agent.spawn、plugin hookイベント間で共通のエージェントID、$.agent.list() のアイドル状態と待機状態が追加されました。claude plugin validate は、フォルダー内にマーケットプレイスのマニフェストも含まれているpluginをスキップしなくなりました。また、サンドボックスの自動許可時にBashの拒否ルールをすり抜ける2つの抜け穴が修正されました。²³⁵²³⁷

v2.1.288（10月2日）。 claude project purge は claude purge に変更されました。旧名も引き続き使えますが、通知が表示されます。バックグラウンドコマンドの制限時間は、無人実行セッション（-p、Agent SDK、CI、クラウド）にのみ適用されます。/code-review --max-findings <n>|all は、--max-findings default を指定するまで指摘件数の上限を変更します。/autocompact はモデルごとにウィンドウを保存します。CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS は、構造化出力を拒否するMantleやゲートウェイ向けに、構造化出力を無効にします。パス単位のルールと入れ子のCLAUDE.mdファイルは、ReadだけでなくWriteとEditでも読み込まれるようになりました。言語サーバーは応答を待ち続けるのではなく、60秒後にタイムアウトします（サーバーごとの requestTimeout）。自動モードでは、会話がクライアント側の分類器で処理できる長さを超えると、ツール呼び出しごとに確認を求める代わりに圧縮されます。また、クライアント側の分類器は、ANTHROPIC_DEFAULT_SONNET_MODEL でClaude Sonnet 5.5またはOpus 5.5に固定されていても、その指定を無視してClaude Sonnet 5を使用します。Modsに $.ui.selection() が追加され、GitHub CLIのないクラウドセッションでも組み込みの gh api を使えるようになりました。空のプロンプトで上矢印キーを押すと、Ctrl+C で消去した下書きが復元されます。²³⁴²³⁷

v2.1.105〜v2.1.114で追加されたコマンド¹⁴⁶¹⁵⁰

セッションの振り返り（v2.1.108以降）

中断したセッションに戻ったときにコンテキストを提示する、セッション単位の新機能です。デフォルトで有効になっており、/config または CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 で無効にできます。モデルはSkillツールを通じて組み込みのスラッシュコマンド（/init、/review、/security-review）も呼び出せるようになり、subagent/skillのパターンが拡張されました。¹⁴⁶

プッシュ通知（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以降）

グロブ引数を使う読み取り専用の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形式のカーソル移動と、全画面表示での表示領域のスクロールが追加されました。

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

ストリーミングの途中で停止したsubagentsは、何も表示せずに固まったままになる代わりに、10分後に明確なエラーを出して終了するようになりました。CLAUDE_STREAM_IDLE_TIMEOUT_MS（v2.1.84以降）と組み合わせると、ストリーミングAPIでプロセスが応答しなくなるケースに、より幅広く対処できます。

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

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

コンテンツへのマーキング：テキストの透かしとファイルのC2PAメタデータ（2026年8月）

Anthropicは、EU AI法第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は「これらのモデルにもマーキング対応を追加するべく取り組んでいる」としています。²⁰⁴

この一覧は8月時点のものです。Fable 5.1（9月1日）、Opus 5.5（9月22日）、Sonnet 5.5（9月28日）は基準日より後に提供を開始したため、このルールでは提供開始時からマーキングに対応する側に該当します。Fable 5.1のリリースノートには追加機能としてコンテンツの来歴情報が挙げられていますが、Opus 5.5のモデルページと移行ガイド、Sonnet 5.5のモデルページと新機能ページには、マーキングへの言及がありません。^241222230 8月より前のモデルの出力には、テキストにもファイルにもマークは付きません。新しいモデルの出力には、Claude Platform（API）、claude.ai、Claude Code、Claude Cowork、Claude Tag、クラウドゲートウェイのすべてでマークが付きます。マーキングはモデルレベルで行われるためです。拡散されたスレッドではこの関係が逆に説明されていたので、そこから導かれる点を明記しておきます。8月より前のモデルで文体や挙動の変化を感じたとしても、その原因が透かしであることはありません。これらのモデルでは、マーキングがまだ有効になっていないからです。

仕組みとしては、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 以降では、社内チームに割増料金を請求する組織向けに、最大10までの1を超える倍率も設定できます。²¹⁶

セッション単位のプロンプトキャッシュ行（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 が会話内の以前の思考内容を破棄していたため、次のリクエストでプロンプトキャッシュ全体の書き換えが必要になっていました。²¹⁷

v2.1.277で、さらに3つのプレフィックス漏れを解消： /clear の後に継続したセッション（再起動、--continue、--resume）では、SessionStart hook が出力を表示すると最初のメッセージの一部が欠落し、プロンプトキャッシュ全体がミスしていました。再開した subagents とチームメイトは、読み込み済みの MCP ツール定義を再レンダリングしていたため、そのエージェントのプロンプトキャッシュが機能しなくなっていました。また、会話の前半で記録された添付ファイルは、再開または再起動後に再レンダリングされ、拡張思考が失われてプロンプトキャッシュもミスしていました。v2.1.265〜267のアップデートと同じく、何らかの処理がプレフィックスを書き換え、それ以降のすべてがキャッシュされていない状態で再送されるという障害パターンです。今回の修正では、SessionStart の出力、再開したエージェントの MCP 定義、記録済みの添付ファイルまで対象が広がりました。²¹⁹

v2.1.280で、さらに2件を追加： Claude の処理中にホストアプリ（Claude Desktop、VS Code、SDK）からモデルを切り替えても、次のプロンプトでプロンプトキャッシュがミスしなくなりました。また、再開したフォーク subagent はツールリストを再構築せず、最初に使用したツールリストを再送するようになり、そのエージェントのプロンプトキャッシュが壊れなくなりました。²²⁰

v2.1.281で、さらに3件を追加： 権限確認の応答待ち中に再起動し、その後再開したセッションでも、再起動前と異なる履歴を送信しなくなりました。これまでは、その時点以降のプロンプトキャッシュが壊れていました。会話途中で切断された MCP サーバーや、再開後も接続中の MCP サーバーについても、ツール検索が無効な場合（プロキシやゲートウェイの背後にある場合など）にキャッシュを失わなくなりました。さらに、再開したセッションが以前のターンを変更された形式で再送しなくなり、API が会話内の過去の推論を失う可能性も解消されています。²²⁴

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

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

レート制限を2倍に引き上げ（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メガワットを超える新たな処理能力（220,000基を超える NVIDIA GPUs）」が提供されます。¹⁵⁷

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

API のトークン料金（2026年10月）^1144222239

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%の節約になります。さらに低い料金が適用される例外が2つあります。Claude Opus 5.5の読み取りは0.05倍（$0.20/MTok、95%の節約）、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に問い合わせ、ご自身の利用形態が認められることを書面で確認してください。

料金を左右する要素

実際の料金例

プロンプトキャッシュの割引を適用する前の定価（100Kトークン以下のプロンプトではHaiku 5.5が$0.10/$0.50、Sonnet 5.5が$2/$10、Opus 5.5が$4/$20、いずれも1MTokあたり）に基づきます。

費用節約のポイント： 探索用の 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. 探索にはプランモードを使用：処理を実行しないため、意図しない高額な操作を防げます
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 支出を分析し、費用削減の手段（キャッシュ、トークンの整理、バッチ、effort、モデルの選択）を、測定しながら1つずつ適用します。対象は API を使って構築するアプリであり、Claude Code セッション自体ではありません²⁴⁵

使用状況の監視

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

バックグラウンドでのトークン使用

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

通常はセッションあたり$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.5 (medium effort default; /effort high or xhigh for harder)
                  │         Cost: ~$1.60/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.50/task
                           Balance: Best overall when cost matters

経験則：v2.1.280以降、デフォルトはプランに連動しなくなり、Microsoft Foundryを除いて、すべてのセッションが Opus 5.5 で開始されます。そのため、以前の「Opusに切り替える」という判断は逆になりました。高度な推論を必要としないタスクでは、/model sonnet でダウンシフトするとトークン料金を半分に抑えられます。^{181197207220221} subagentsにはHaikuを使いましょう。ダウンシフト後の回答が浅く感じられる場合は、Opusを維持します。agent teams（v2.1.32以降）では、Opusが異なるサブタスクに並行して取り組む複数のエージェントを調整できます。⁷⁹

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を明示的に制御する必要はありません。難しい問題では深く考え、単純な問題にはすばやく対応します。手動で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