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）。さらにv2.1.285以降、サードパーティープロバイダーを利用する場合やテレメトリを無効にしている場合は、claude -pとPython Agent SDKセッションでも初期モードとなります。それ以外の-pおよびSDKセッションはManualで開始します。安全性チェックは、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を使用してください。
• モデルの使い分けにより、品質を損なわずコストを削減できます：subagentによる探索には安価なモデルを割り当て、本格的なアーキテクチャ設計の推論にはOpusを使用します。品質だけを重視するなら、Opusに統一する方法もあります。
• MCPはClaudeをツールチェーンへ接続します：データベース、GitHub、Sentryをはじめとする3,000以上の連携機能により、Claudeはファイルの読み取りやbashコマンドの実行を超えた能力を発揮します。

私は数か月にわたり、本番環境のコードベース、CI/CDパイプライン、エンタープライズ導入環境でClaude Codeを限界まで使い込みました。このガイドには、その経験を凝縮し、使い始めた当時に欲しかった完全なリファレンスとしてまとめています。すべての機能について、実際の構文、実用的な設定例、経験豊富なユーザーでもつまずきやすいエッジケースを掲載しています。

目的に合った進み方

このガイドの使い方

これは5,000行を超えるリファレンスです。最初から最後まで通読する必要はありません。経験レベルに合った箇所から始めてください。

ブラウザーのCtrl+F／Cmd+Fを使えば、特定のフラグ、コマンド、設定キーを検索できます。末尾のクイックリファレンスカードでは、主要なコマンドを一覧しやすくまとめています。

関連する詳細解説

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

60秒クイックスタート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

目次

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

Claude Code のインストール方法

システム要件

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

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

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

プラットフォーム対応表

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

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

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

インストール方法

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

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

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

# Homebrew alternative
brew install --cask claude-code

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

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

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

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

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

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

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

settings.json の完全な参照

主要なオプションをすべて含む設定例です。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "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（managed、v2.1.175以降）： availableModels の許可リストは、セッションで選択できるモデルを制限します。enforceAvailableModels: true を指定すると、許可リストは Default モデルにも適用されます。Default の解決先が許可されていないモデルの場合は、最初に許可されたモデルへフォールバックします。また、ユーザー設定やプロジェクト設定から、managed の availableModels リストにモデルを追加することもできなくなります。関連する修正（v2.1.176）では、エイリアスによる選択が ANTHROPIC_DEFAULT_*_MODEL を介してブロック対象のモデルへリダイレクトされる抜け道も塞がれ、/fast も許可リスト外のモデルへの切り替えを拒否するようになりました。¹⁷² v2.1.187以降では、組織が /model ピッカー、--model、/model、ANTHROPIC_MODEL のすべてにモデル制限を直接適用できます。制限されたモデルを選択すると、「組織の設定により制限されています」というメッセージが表示されます。¹⁷⁶
• language（v2.1.176で改善）： 応答言語の設定に加え、セッションタイトルもデフォルトでは会話の言語で生成されるようになりました。タイトルの言語を固定するには、language に特定の言語を設定します。¹⁷²
• footerLinksRegexes（v2.1.176）： フッター行に、正規表現に一致したリンクバッジを表示します。ユーザー設定または managed 設定から構成できます。¹⁷²
• wheelScrollAccelerationEnabled（v2.1.174）： フルスクリーンモードでマウスホイールのスクロール加速を無効にするには、false に設定します。¹⁷²

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

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

新しい設定（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 だけでなく、ユーザー、プロジェクト、managed のどの設定ファイルからでも、参考値として使われる Dynamic workflow の規模ガイドラインを設定できます。Dynamic workflows のデフォルトは medium ガイドライン（「エージェント数を15未満に抑えることを目指す」）です。設定ファイルから値が指定されている間、/config の該当行は表示されません。これは参考値であり、強制的な上限ではありません。Subagentsを参照してください。¹⁹⁶

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

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

新しい設定（v2.1.247）： - feedbackDrafts（v2.1.247）： 新しい SendFeedback ツールを制御します。セッションで問題が発生した場合、Claude がフィードバックレポートの下書きを作成し、内容を確認してから /feedback で送信できます。この下書き作成を無効にするには、この設定を使用します。Slash Commandsの /feedback の行をご覧ください。²⁴⁵ - spinnerTipsOverride の形式拡張（v2.1.247）： ヒントの項目として、従来の単純な文字列に加えて {id, text, cooldownSessions, priority} オブジェクトも指定できるようになりました。また、オブジェクトに tipsFile キーと label キーが追加され、組織独自のヒントを組み込みのヒントとともにローテーション表示できます（上の例は拡張された形式を示しています）。設定リファレンスにも新しいキーが記載されています。²⁴⁵²²⁷

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

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

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

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

新しい設定（v2.1.261）：

• bashOutputMaxChars / taskOutputMaxChars（v2.1.261）： コマンド出力（後者はバックグラウンドタスクの出力）について、残りをファイルに保存する前に Claude がインラインで受け取れる量を、最大128K文字まで増やします。これは BASH_MAX_OUTPUT_LENGTH 環境変数とは異なる仕組みです。この環境変数は、コマンドの作業用出力ファイルから読み戻す範囲を設定します（デフォルトは30,000文字、上限は150,000文字）。一方、これらのキーはインライン表示とファイルへの永続化を分けるしきい値を制御します。しきい値を超えた出力は途中で切り捨てられず、Claude が必要に応じて読み取れるファイルに保存されます。²¹⁴ v2.1.265以降は、永続化されるデータにも上限があります。ディスクに保存されるツールの結果は 1 GB が上限で、保存ファイルが切り詰められた場合は会話内のプレビューにその旨が表示されます。²¹⁵ タスク側の設定はv2.1.277で廃止されました： 非推奨だった TaskOutput ツールが削除され、Claude はバックグラウンドタスクの出力ファイルを Read で読み取るようになりました。そのため、taskOutputMaxChars と TASK_MAX_OUTPUT_LENGTH は機能しません。bashOutputMaxChars には影響ありません。²¹⁹

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

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

新しい設定（v2.1.275）：

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

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

• maxProseWidth（v2.1.282）： 幅の広いターミナルで、Claude の文章が表示される最大幅を設定します。段落、見出し、リスト、引用は指定した列数の範囲内で折り返されますが、表とコードブロックは幅全体を使用します。値には40以上の整数の列数を指定します。²²⁵²²⁷
• deniedModels / availableModelsMatch（管理対象、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 は、どちらのキーも管理対象の設定からのみ読み取ります。²²⁶²²⁷
• allowClaudeInChromeWithManagedMcp（管理対象、v2.1.282）： 排他的な managed-mcp.json と併用して claude --chrome を実行できるようにします。Chrome がブロックされた際に表示されるエラーにも、このキーの名前が示されるようになりました。²²⁵ 設定リファレンスにも記載されています。このキーはデバイス自身の管理対象設定からのみ読み取られ、deniedMcpServers に claude-in-chrome が含まれている場合は、引き続きサーバーがブロックされます。²³³

新しい設定（v2.1.285）：

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

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

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

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_SUBAGENT_MODEL_FORCE=1              # Force every subagent onto CLAUDE_CODE_SUBAGENT_MODEL (or the main model), ignoring agent-definition and per-spawn overrides -- the pre-v2.1.251 behavior, opt-in (v2.1.257)[^243]
CLAUDE_CODE_WORKFLOWS=1                         # Enable Workflow tool for deterministic multi-agent orchestration (v2.1.147+)
MAX_THINKING_TOKENS=10000                       # (Opus 4.6 and Sonnet 4.6 only — removed in Opus 4.7)
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

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

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
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]

動作制御：

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_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_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=1                     # Enable forked subagents on external builds (v2.1.117+)[^160]
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                 # Force synchronized terminal output when auto-detection misses it, such as Emacs eat (v2.1.129+)[^164]
CLAUDE_CODE_SESSION_ID=...                      # Read-only: present in the Bash tool subprocess; matches the session_id passed to hooks (v2.1.132+)[^168]
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1          # Skip the fullscreen alternate-screen renderer; keep the conversation in the terminal's native scrollback (v2.1.132+)[^168]
CLAUDE_EFFORT=...                               # Read-only: current effort level inside hooks and Bash tool subprocess (v2.1.133+)[^169]
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1             # Include subagent text + thinking in stream-json output; pairs with --forward-subagent-text (v2.1.211+). Covers depth-2+ nested subagents as of v2.1.219[^205][^213]
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200    # Per-session WebSearch cap (default 200; v2.1.212+). 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
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_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 リクエストspan属性： stop_reason、gen_ai.response.finish_reasons、user_system_prompt が、LLM リクエストspanで出力されるようになりました。user_system_prompt には PII が含まれる可能性があるため、OTEL_LOG_USER_PROMPTS=1 を設定した場合にのみ出力されます。¹⁵⁴ v2.1.122以降のイベントレベルの変更： api_request および api_error ログイベントの数値属性が、文字列ではなく数値として出力されるようになりました。これにより、スキーマを厳密に型指定していた後段の OTel コレクターで発生する問題が解消されます。また、Claude Code が @メンションを解決すると、新しい claude_code.at_mention ログイベントが発生します。¹⁵⁴

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

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

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

v2.1.280の hooks テレメトリ： 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 呼び出し元ID（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と同率。以前$0.20としていたClaude Code 自体のコスト表示はv2.1.296で修正されています）。1Mトークンのコンテキストウィンドウ、最大出力128K（output-300k-2026-03-24 ベータヘッダーを使用するBatches API では最大300K）。信頼できる知識のカットオフは、Opus 5.5およびFable 5.1と同じ2026年6月です。廃止は早くても2027年9月28日となります。Claude Code ではSonnet 5.5の effort のデフォルトは medium ですが、Claude API 自体のデフォルトは high です。また、thinkingをオフにはできません。コンテンツに基づくフォールバックもあります。サイバーセキュリティ関連としてフラグが付いたリクエストは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 では事前のthinkingが無効になり、ツールの強制使用はエラーを返します。thinkingブロックはモデルおよび会話に紐づき、computer_20251124 はClaude API とGoogle Cloudでは受け付けられません。また、advisorツールでは、Opus 4.8、Opus 4.7、Sonnet 5をadvisorとして指定できません。ツール呼び出し間のテキストも thinking ブロックとして返されるため、ストリーミング表示するインターフェースでは、テキストを返す display 値を設定するまで何も表示されません。²³⁰

Claude Opus 5.5（2026年9月22日）： v2.1.280以降、Claude Code における新しいデフォルトOpusモデルです。さらに、モデル設定ドキュメントのプラン別表によれば、すべてのプランとファーストパーティープロバイダーにおけるデフォルトモデルでもあります。対象はPro、Max、Team、Enterprise、Anthropic API、AWS上のClaude Platform、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%の半額となります（さらに低いのはFable 5.1とMythos 5.1のみで、2.5%です）。1Mトークンのコンテキストウィンドウ、最大出力128K（output-300k-2026-03-24 ベータヘッダーを使用するBatches API では最大300K）。常時有効の適応型thinkingを採用しています。モデル概要表では、デフォルトで有効ながら無効化できるOpus 5の形式ではなく、Fableと同じ「Adaptive (always on)」に分類されています。effort のデフォルトは mediumです（Opus 5のデフォルトは high）。v2.1.280では引き継ぎルールもこれに合わせて変更されました。/effort がモデルごとの設定になる前に保存された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は無効にできません。 thinking: {type: "disabled"} と thinking: {type: "enabled", budget_tokens: N} は、どちらも400を返します。thinking フィールドを削除し、代わりにeffortレベルを選択してください。
2. ツールの強制使用はエラーを返します。 tool_choice で使用できるのは auto と none のみです。any と tool は、トークン計数エンドポイントを含めて400を返します。厳密なツール使用または構造化出力とともに auto を使用してください。
3. Thinkingブロックはモデルに紐づきます。 ルーターやフォールバックによって会話をOpus 5.5から別のモデルへ移すと、そのターンではOpus 5.5のthinkingブロックなしで処理されます（Claude API 上のFable 5.1とMythos 5.1は例外です）。
4. computer_20251124 はClaude API とGoogle Cloudで拒否されます。 代わりに computer_toolset_20260801 ツールセットを宣言してください。Bedrockでは従来のツールを引き続き使用します。 さらに、リクエスト自体は失敗しないものの、レスポンスの形式が変わる変更があります。ツール呼び出しの合間にモデルが書くテキストは thinking ブロックとして返され、デフォルトの display 設定では空になります。このナレーションをストリーミングするインターフェースは、display: "updates"（ベータ）または "summarized" を設定するまで何も表示しません。²²²

Claude Code におけるコンテンツベースのフォールバック。 Opus 5.5 には、主に生物学とサイバーセキュリティのコンテンツを検出する安全性分類器が搭載されています。リクエストが検出されると、Claude Code は別のモデルで再実行し、通知を表示します。生物学関連として検出されたリクエストは Opus 5、サイバーセキュリティ関連は Opus 4.8 に送られ、/model で切り替え直すまで、そのセッションではフォールバック先のモデルが使われます。毎回確認するようにするには、/config で Switch models when a message is flagged をオフにしてください（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 で同一ながら、「同じコストでパフォーマンスが大幅に向上」し、最大 reasoning 時の平均トークン数は Opus 4.8 より約 26% 少なくなっています。Claude Max のデフォルトモデルであり、Claude Pro で最も強力なモデルでした。モデル ID は claude-opus-5 です。これは日付を含まない固定済みの pinned スナップショットで、claude-opus-4-8 や claude-sonnet-5 と同じ方式であり、常に最新版を指すポインターではありません。1M トークンのコンテキストウィンドウ（ベータヘッダーは不要で、Opus 4.8 から変更なし）、最大出力 128K（Batches API では output-300k-2026-03-24 ベータヘッダーにより最大 300K）です。adaptive thinking のみに対応し、thinking.type: "enabled" による extended thinking はサポートされません。信頼できる知識のカットオフは2026年5月（トレーニングデータのカットオフも2026年5月）です。リリース時から、知識のカットオフが2026年6月の Fable 5.1 が2026年9月1日に登場するまで、現行の Claude モデルのなかで最も新しいものでした。²⁴¹ Opus 5 の登場に伴い、Opus 4.8 は 4.7 および 4.6 とともにドキュメントの Legacy models テーブルへ移動しました。引き続き利用できますが、推奨されるデフォルトではなくなりました。¹⁹⁷

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

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

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

Claude Fable 5.1（2026年9月1日）： Fable ティアの新たな最上位モデルであり、v2.1.257 以降は fable エイリアスの参照先です（ANTHROPIC_DEFAULT_FABLE_MODEL で別のモデルを固定している場合を除きます）。best は現在、「利用可能な最新の Fable モデル」を意味します。必要な最低バージョンには少し説明が必要です。モデル設定ドキュメントでは、v2.1.255 でエイリアスが切り替わったとされ、モデルページには Fable 5.1 が「Claude Code v2.1.255 以降を必要とする」と記載されています。しかし、2.1.253〜256 は npm で一度も公開されていません。そのため、インストール可能で Fable 5.1 を含む最初のリリースは v2.1.257（9月1日）です。モデル ID は claude-fable-5-1（Bedrock：anthropic.claude-fable-5-1）です。ティアとトークン単価は Fable 5 と同じで、入力 $10/MTok、出力 $50/MTok、1M コンテキスト、最大出力 128K、常時有効の adaptive thinking、effort のデフォルトは high です。ただし、長時間のエージェントセッションで重要になる料金変更が1つあります。キャッシュ読み取りは $0.25/MTok、入力価格の 0.025 倍（2.5%）で、標準の 10% より安価です。この料金が適用されるのは Fable 5.1 と Mythos 5.1 のみで、キャッシュ書き込みは標準料金のままです（5分は $12.50、1時間は $20）。信頼できる知識のカットオフは2026年6月（トレーニングデータも2026年6月）です。現行の Claude モデルのなかで最も新しく、2026年9月22日には Opus 5.5、9月28日には Sonnet 5.5 が同じ2026年6月のカットオフで並びました。廃止は早くても2027年9月1日です。

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

リリースノートには、ゲートウェイに関する注意点が1つあります。Claude apps gateway のセッションでは、現時点で fable と best は引き続き Fable 5 を参照します。まだ 5.1 向けに設定されていないゲートウェイでは拒否されるため、そこでは /model から Fable 5.1 を明示的に選択してください。ただし、v2.1.260 より前の /model ピッカーには Fable 5.1 が表示されなかったため、明示的に選択するには完全な /model claude-fable-5-1 を入力する必要がありました（以下のリリース直後の修正を参照）。リリース時点でのプラン別デフォルトは、プレミアムプランが Opus 5、Pro と Team Standard が Sonnet 5 でした。その後、v2.1.280 で全プランのデフォルトが Opus 5.5 に変更されています（2026年9月22日）。^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日以降は legacy）： Opus より上位に新設されたモデルティアです。Anthropic によれば、最も強力かつ知能の高いモデルで、テストされたほぼすべてのベンチマークにおいて最先端の性能を示し、数百万トークンに及ぶコンテキストでも一貫性を保てるよう構築されています。Fable 5 は、一般利用向けに安全性を確保した「Mythos-class」のフロンティアモデルです。サイバー、バイオ化学、モデル蒸留に関するクエリを 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 になります（サフィックスが意味を持つのは Opus/Sonnet のみで、これらでは [1m] によって 1M が有効になります）。最大出力は 128K です。料金は入力 $10/MTok、出力 $50/MTok で、Opus 4.8 の約2倍です。日常的な編集ではなく、本当に難しい reasoning に使うのが適切でしょう。リクエスト仕様は Opus 4.8 と共通です（adaptive thinking のみ、temperature/top_p/top_k と budget_tokens は削除）。ただし、新たな注意点が1つあります。thinking: {type: "disabled"} を明示すると 400 が返されるため、thinking なしで実行するには thinking パラメーター自体を省略してください。²⁶¹ Claude Code に限って言えば、Fable 5 は Opus 5 と同様に、すべての effort レベル（low/medium/high/xhigh/max、デフォルトは high）をサポートしています。Fable 5 では thinking をオフにできません。セッションの thinking トグル、alwaysThinkingEnabled 設定、MAX_THINKING_TOKENS=0 はいずれも効果がなく、常に適応的に推論します。fable ファミリー向けの設定項目は Opus のものと同等です。ANTHROPIC_DEFAULT_FABLE_MODEL では fable エイリアスの解決先モデルを固定でき（Bedrock/Vertex/Foundry で便利です）、DISABLE_PROMPT_CACHING_FABLE では Fable をプロンプトキャッシュの対象外にできます。また、エンタープライズゲートウェイでは、コンテンツに基づく自動フォールバックが適用されます。/model opus で Opus 5.5 が選択されるようになりました（v2.1.280。effort のデフォルトは 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、thinking は adaptive thinking のみです（extended thinking は廃止されました）。新たに xhigh effort レベルが追加され、コーディングやエージェント型ワークロードの出発点として推奨されています。¹⁴⁵ 信頼できる知識のカットオフは2026年1月、トレーニングデータのカットオフも2026年1月です。モデル ID は claude-opus-4-7。料金は Opus 4.6 と同じく、入力/出力が MTok あたり $5/$25、5分間のキャッシュ書き込みが $6.25、1時間のキャッシュ書き込みが $10、キャッシュ読み取りが $0.50 です。¹⁴⁴ SWE-Bench では Opus 4.6 の3倍の本番タスクを解決し、CursorBench では70%（4.6 は58%）を記録しています。また、Anthropic の93タスクからなる社内コーディングベンチマークでは、解決率が13%向上しています。¹⁴⁴ 新しい tokenizer を採用しているため、同じテキストでもトークン数が約1倍〜1.35倍になると見込んでください。max_tokens の余裕と compaction のトリガー値を増やす必要があります。¹⁴⁵ Vision では最大 2,576 px / 3.75 MP の画像をサポートし、ピクセル座標は1:1です。¹⁴⁵

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

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

v2.1.280（2026年9月22日）以降、プラン間の違いはなくなりました。Anthropic が運営するすべてのプランとファーストパーティプロバイダーでは、Opus 5.5 がデフォルトです。唯一残っている例外は Microsoft Foundry です。以前ここで最も重要だった「どのプランを利用しているか」という点は、もはや答えを左右しません。

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

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

タスク予算（ベータヘッダー task-budgets-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 のデフォルト effort が high になりました（以前は medium）。Opus 4.7 は引き続き xhigh です。この変更により、4月23日の事後検証で説明された3月4日から4月7日にかけての effort 引き下げ後、知能水準が元に戻りました。¹⁵²¹⁵³

Sonnet 5（2026年6月30日。旧 Sonnet ティア）： v2.1.197 から、v2.1.284 で Sonnet 5.5 に変更されるまで、Anthropic API で sonnet エイリアスが選択していたモデルです。リリース時、Anthropic は「速度と知能の最良の組み合わせ」と位置づけていました。Anthropic によれば、性能は Opus 4.8 に近い一方で、料金はより低く、エージェント型推論、ツールの使用、コーディング、ナレッジワークの各分野で Sonnet 4.6 から大幅に改善されています。一方、望ましくない挙動の発生率は全体として低く、サイバーセキュリティ能力は Opus モデルよりもはるかに弱くなっています（輸出規制によるブロックなしでリリースできた背景には、この安全性上のトレードオフがあります）。モデル ID は claude-sonnet-5（日付なしの固定スナップショット）。コンテキストウィンドウは 1M トークン、最大出力は 128K です（output-300k-2026-03-24 ベータヘッダーを指定した Batches API では最大 300K）。thinking は adaptive thinking のみに対応しています。信頼できる知識のカットオフは2026年1月です。料金は入力/出力が MTok あたり $2/$10 で、現在は標準の定価となっています。 Anthropic はリリース時、2026年8月31日までの導入価格として $2/$10 を発表しましたが、その後も価格を据え置きました。料金ページには、予定されていた9月1日の $3/$15 への値上げは「実施されない」と記載されています。また、v2.1.243 では /model ピッカーと同梱の claude-api skill が更新され、$2/$10 は期間限定のプロモーションではなく、定価として表示されるようになりました。²⁵¹ これは Opus 5.5 の $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 のデフォルトモデルになりました。その後、v2.1.280 でこれらのプランが Opus に移行した2026年9月22日まで、標準ティア（Pro、Team Standard）で使われていました。現在、Sonnet 5 は Claude Code のどのプランでもデフォルトではありません。また、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 と同じく、MTok あたり $3/$15 です。消費トークンを抑えながら、エージェント型検索の性能が向上しています。extended thinking、adaptive thinking、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消費します。100Kトークン以下のプロンプトに適用されるHaiku 5.5の料金なら、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倍安価で（100Kを超えるプロンプトでは8倍）、応答も高速です。深い推論を必要としないバックグラウンドタスクに最適です。

Sonnet：コストを重視する日常的な開発の主力です。v2.1.284以降、Anthropic APIではSonnet 5.5が提供されており、Sonnet 5と同じ$2/$10です²²⁸。ただし、v2.1.280でProとTeam StandardがOpusへ移行したため、現在はいずれのプランでもデフォルトではありません（ネイティブの1Mコンテキスト、標準の定価は1 MTokあたり$2/$10で、予定されていた9月1日の値上げは撤回されました）。^181251207220 ここで押さえておくべき変更点は、Sonnetが自ら選択するモデルになったことです。選ぶ理由は単純な計算で、同じ1Mコンテキストを利用できるOpus 5.5と比べて、トークン単価が半額だからです。機能の実装、バグ修正、テストの作成、コードレビューなど、ほとんどのコーディングタスクに対応できます。経緯を振り返ると、v2.1.197（2026年6月30日）は、Sonnet 5をあらゆる環境のデフォルトにしたと長らく報じられ、このガイドでもそう記載していました。しかし、モデル設定ドキュメントにおけるプラン別の説明では、premium/APIのデフォルトはv2.1.154以降がOpus 4.8、v2.1.219以降がOpus 5となっていました。つまり「あらゆる環境」とは実際にはstandard tierを指しており、v2.1.280ではその状態さえ終了したことになります。Sonnet 4.6は2026年6月までSonnetの役割を担っていました。^93147207221 より安価なトークン、高速な応答、またはsubagentの費用対効果を求める場合は、Sonnetを使用してください。

Opus：高度な推論を担う層です。v2.1.280以降、opusエイリアスはClaude Opus 5.5（1 MTokあたり$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%（従来は58%）を記録しています。また、93件のタスクからなる社内コーディングベンチマークでは、解決率が13%向上しました。¹⁴⁴ Claude Codeでは、Opus 4.7のeffortがデフォルトでxhighとなり、/effortで調整できます（v2.1.111以降）。¹⁴⁶¹⁴⁷ Max加入者は、--enable-auto-modeを指定しなくても、Anthropic API経由でOpus 4.7のAuto Modeを利用できます。ほかのプランやプロバイダーで利用できるかどうかは、プラン固有の条件と管理者の設定によって決まります。¹⁴⁶ 1Mコンテキストを標準料金で利用でき、ロングコンテキストの追加料金はありません。知っておくべき動作の変更点： Opus 4.7は指示をより文字どおりに解釈し、タスクの複雑さに応じて回答の長さを調整します。また、デフォルトで実行するsubagentsを減らし、相手への肯定を前面に出す表現を抑えた、より率直な語調を採用しています。途中経過の報告や再確認を強制するための足場となる指示がプロンプトに含まれている場合は、取り除いて試してみてください。¹⁴⁵

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

モデルの切り替え

セッション中：

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

起動時：

claude --model opus

環境変数：

export ANTHROPIC_MODEL=opus

settings.json：

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

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

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

subagentsに限定する場合：

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

v2.1.251以降、CLAUDE_CODE_SUBAGENT_MODELはすべてを上書きするのではなく、subagentのデフォルトモデルを設定します。エージェント定義のmodel:と、spawnごとに明示したモデルが優先されます。²⁰⁶ v2.1.257以降は、CLAUDE_CODE_SUBAGENT_MODEL_FORCEを使うと、以前の動作をオプトインで復活させられます。これにより、CLAUDE_CODE_SUBAGENT_MODEL（未設定の場合はメインの会話モデル）がすべてのsubagentへ適用され、spawnごとの選択やエージェント定義の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回再試行します。また、拒否時や--fallback-modelによる再試行でfastを実行できないモデルへ切り替わった場合は、標準速度で実行されます。²³¹

v2.1.178以降、compactionでもフォールバックチェーンが適用されます。compactionの途中でプライマリモデルが過負荷または利用不能になった場合、そのターンを失敗させるのではなく、設定されたfallbackModel/--fallback-modelチェーンへフォールバックします。長時間の自律実行において、一時的なモデルエラーから本来なら回復できるcompactionがセッションを終了させてしまう問題を、これで解消できます。¹⁷³

拡張コンテキスト

大規模なコードベースや長時間のセッションでは、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 以降、Bedrock、Vertex、Foundry、Claude apps ゲートウェイでデフォルトが 1M となった 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-tool のターンを実際の約 2 倍のコンテキストサイズとして計算する問題を修正しました。この問題により、実際のウィンドウの約半分で自動コンパクションが実行されていました。²¹⁷

現在のモデルを確認する

> /status

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

モデルピッカーのラベル（v2.1.51 以降）： /model ピッカーでは、固定されたバージョンについて生のモデル ID ではなく、人が読みやすいラベル（例：「Sonnet 4.6」）が表示されるようになりました。新しいバージョンが利用できる場合は、アップグレードの案内も表示されます。⁹⁸ v2.1.219 では、統合された Opus の行が単なる「Opus」ではなく 「Opus (1M context)」 と表示される問題を修正しました。また、新リリースのハイライト範囲を最新モデルの名前だけに絞り、リストの恣意的な一部分ではなく、実際にリリースされたものが示されるようになりました。¹⁹⁶ v2.1.283 では、Opus がすでに 1M コンテキストウィンドウを持つ場合、Opus の行と Default モデルの名前から「(1M context)」が削除されました。ウィンドウ自体に変更はありません。²²⁶

Fast Mode（v2.1.36 以降）

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

> /fast            # Toggle fast mode on/off

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

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

料金（Fast Mode）：^198222223

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

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

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

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

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

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

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

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

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

モデルごとに保存（v2.1.251 以降）： /effort でデフォルトの effort level がモデルごとに保存されるようになりました。モデルを切り替えても、それぞれが独自の設定を維持します。つまり、Opus でいつも xhigh を使っていても、その設定が Haiku に引き継がれることはありません（CHANGELOG：「/effort を変更し、デフォルトの effort level をモデルごとに保存するようにしました。モデルを切り替えても、それぞれが独自の設定を維持します」）。max がセッション限定となる例外は引き続き適用されます。²⁰⁶ v2.1.284 のスライダーキー： effortSlider:decreaseEffort、increaseEffort、toggleUltracode のキーバインディングアクションを使うと、keybindings.json でスライダーの矢印キーと Tab キーを再割り当てできます。²²⁸ v2.1.257 では両方の調整機能が改善されています： /effort では、/model の規則に合わせ、セッション限定の選択を示す s を指定できます。また、--effort フラグもセッションスコープになりました。新しいモデルのデフォルト effort を固定する仕組みを永続的に解除するのではなく、そのセッションでのみ解除します（CLI の参照では、デフォルトを「このセッションで上書きし、永続化しない」と説明されています）。²¹¹²⁴³

Max の Auto Mode（v2.1.111 以降）

Auto Mode は、すべてのプランとプロバイダーにおいて、対話型ターミナルおよび VS Code セッションに組み込まれた開始時の permission mode です（v2.1.283～284）。さらに v2.1.285 以降は、サードパーティープロバイダー上、またはテレメトリがオフの場合の claude -p と Python Agent SDK セッションにも適用されます。2026年8月14日以降（発表は8月7日）、Pro、Max、Team ではすでにデフォルトになっていました。発表時の調査結果、オプトアウト方法、現在も Manual で開始するセッションについては、Permission Modeをご覧ください。^{203226227228229}

各アクションが実行される前に、別の分類モデル（v2.1.210 以降は Claude Sonnet 5）が、そのアクションが意図に合っているか、安全かを確認します。¹⁸⁷ Auto Mode でセッションを開始するには --permission-mode auto を使用します。v2.1.111 では、以前の --enable-auto-mode フラグが削除されました。

利用範囲の拡大：

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

Auto Mode はセキュリティ境界ではありません。 以下で説明する仕組みの大部分は分類器を強化するものですが、分類器はサンドボックスではありません。2026年8月26日、プロンプトインジェクション研究者の Johann Rehberger は、Auto Mode の Claude Code Opus 5 に対する実際に機能する攻撃チェーンを公開しました。小規模なサンプルでの攻撃成功率は 60～80% と報告されています。隔離された python3 子プロセスを起動する主要チェーンでは5回中3回、ペイロードがヘッドレスの claude -p インスタンスを起動する亜種の2つの構成では、それぞれ5回中3回と5回中4回でした。ただし本人も、これは普遍的な攻撃成功率の測定ではなく、小規模なサンプルにすぎないと注意を促しています。²¹⁰ このチェーンは、個々の手順がすべて妥当に見える点で理解する価値があります。サーバーが WebFetch に HTTP 415 を返すため、エージェントは curl にフォールバックします。ダウンロードしたアーカイブを展開すると、スクラッチディレクトリにマニフェスト、Base85/zlib でエンコードされた7件のデータレコード、ネイティブバイナリ、struct.py が配置されます。Claude は信頼できないバイナリの実行を拒否した後、独自の Python デコーダーを作成し、そのディレクトリ内から実行します。デコーダーが base64 をインポートし、base64 が struct をインポートすると、Python は攻撃者の struct.py を先に解決します。この一連の流れには、明らかに悪意のある命令はありません。インジェクションに必要なのは、侵害された経路をタスク完了のための最も妥当な方法に見せることだけです。Rehberger はさらに、侵害に気づいた Claude がマルウェアプロセスの終了を試みたものの、Auto Mode がクリーンアップコマンドを拒否したケースが数回あったと報告しています。²¹⁰ 彼はこの調査結果全体を、Anthropic が宣伝してきた数値と対比しています。委託された第三者評価では、Auto Mode の Opus 5 を対象に72のシナリオを各10回実行した結果、プロンプトインジェクション攻撃の成功率は 0.00% と報告されていました。彼のチェーンはそのテストセットに含まれていなかったため、ベンチマーク結果が 0.00% であることと、実際に機能するコード実行チェーンが存在することは両立します。彼は、この2つのメッセージは整合していないと捉えています。²¹⁰ 分類にも注意が必要です。Simon Willison は8月30日の更新で、これは古典的なプロンプトインジェクションではないという読者の指摘に同意しています。モデルは攻撃者の命令を読み取って従ったわけではなく、混乱した環境を悪用する攻撃だということです。²¹⁰ Anthropic は、この報告を「Informative（情報提供）」、つまり意図どおりの動作としてクローズしました。そして、Rehberger が伝えている見解こそ、設計上の前提とすべきものです。auto mode はセキュリティ保証ではなく、ベストエフォート型の分類器です。個別には無害なステップを組み合わせて構築された意図的なインジェクションチェーンは、分類器に検出が期待される範囲を超えています。実際の封じ込め境界となるのは、OS レベルの隔離とネットワークの外向き通信制御です。²¹⁰ これは、以下の強化策と矛盾するものではありません。むしろ、それらを正しく捉えるための前提です。auto mode は回答が必要なプロンプトの数を減らし、文書化された破壊的操作の一覧をブロックしますが、信頼できない入力を扱うセッションを安全にするものではありません。取得したページ、ダウンロードしたアーカイブ、issue の本文、サードパーティーの MCP サーバーなど、攻撃者の影響を受けたコンテンツにセッションが触れる場合、実際に被害の範囲を制限するのはモデルの外側にある対策です。具体的には、コンテナまたは VM、制限されたネットワークの外向き通信、エージェントが実際に行う操作の監視、そして失いたくない SSH キーやクラウド認証情報を置かないホームディレクトリです。auto mode が承認したからといって、その操作が安全だった証拠にはなりません。

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

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

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

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

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

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

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

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

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

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

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

封じ込め回避ルール（v2.1.257）。 分類器の自動承認禁止リストに「Containment Escape」ルールが追加されました。クラウドメタデータからの認証情報取得、ネットワークの外向き通信制御の回避、テナントをまたぐアクセスは、環境側で想定された操作として指定されていない限り、自動承認されません。これは、前述の注意事項を前提に捉える必要があります。継続的な分類器の強化であり、文書化された拒否対象が1つ増えたにすぎず、auto mode の性質が変わったわけではありません。²¹¹

作業ディレクトリ外の読み取り時に1回だけ確認（v2.1.257）。 auto mode では、セッション中に初めて作業ディレクトリ外のファイルを読み取る前に、1回だけ確認するようになりました。v2.1.284 以降、このプロンプトには Yes, but ask again next time も表示されます。²²⁸ 関連する permissions.blockReadsOutsideWorkingDirectories 設定を有効にすると、確認ではなく拒否となり、このような読み取りは完全にブロックされます。²¹¹ v2.1.273 では、チェッカーから見えない処理にも両方の動作が拡張されました。完全に解析できない Bash コマンドはチェックを省略せず、プロンプトを表示します。また、ブロック設定が有効な場合、リポジトリの設定で指定されたメモリディレクトリはプロンプトへ読み込まれず、想起、インデックス作成、メモリ抽出にも使用されません。²¹⁷

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

分類器の2つの障害モードに停止条件を追加（v2.1.280）。 このリリース以前の auto mode には、安全性チェックから使用可能な判定が返らなかった場合の対処手段がありませんでした。どちらの問題も、運用者からは同じように見えていました。つまり、承認される見込みのない操作にトークンを消費しながら、ターンが処理を続けてしまう状態です。v2.1.280 では、それぞれに終了状態が設けられました。

サーバーレビューの対象コマンドが拡大（v2.1.281）。 分類器によるレビューがサーバー側で実行される場合、読み取り専用およびサンドボックス化されたシェルコマンドもレビューの完了を待つようになり、問題が検出されるとブロックされます。拒否メッセージも変更され、Claudeは拒否の対象を正確に同じコマンドだけでなく、その結果全体として扱います。新しいプロセスでセッションを再開した場合、分類器はプロンプトを再生成せず、以前のプロンプトキャッシュを再利用できます。また、/insightsには、最近のセッションでauto modeが処理できた可能性のある権限プロンプト数を見積もる、auto modeの推奨機能が追加されます。²²⁴

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

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

v2.1.299の新機能

Claude Code 2.1.299は2026年10月14日にリリースされました（npmでは00:23 UTC、02:49 UTCのGitHubリリースには、正式なCHANGELOGと同じ190項目が含まれています）。2.1.297と2.1.298は公開されなかったため、内容が飛ばされているわけではありません。npmのlatestは2.1.299、stableは引き続き2.1.287です。nextは同日の14:27 UTCに2.1.300へ移行しましたが、対応するCHANGELOGセクションはまだありません。²⁷¹ 2.1.296からアップグレードする場合、このリリースでは同バージョンで生じた2つのリグレッションが修正されます。1つは、UserPromptSubmitまたはmodのprompt.submit hooksの実行中にメッセージが停止された場合、Coworkおよびclaude.aiのクラウドセッションで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が実行されます。この設定は、プロジェクト設定とローカル設定では指定できません（環境変数リファレンスを参照してください）。²⁷¹²⁷²

権限とMCP。 mcp__aのような許可ルールは、名前がaのサーバーだけを対象とし、a__bやa_には適用されなくなりました。サーバーの正規化された完全な名前を使ってmcp__<server>__*と記述してください。名前に__を含むサーバーをagentのtools:リストに追加する場合も、同じ形式で指定します。これにより、そのサーバーのツールだけが追加されます。正規化された名前に二重アンダースコアを含むサーバーへの拒否ルールと確認ルールも、再び適用されるようになりました。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プロンプトが表示されなくなり、スクリプト内で実行時に組み立てられたrmについて、Claude Codeがプロンプトを読み取れない場合に確認を求めるのは、CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1が設定されている場合のみです。²⁷¹

Hooksとmods。 UserPromptSubmit hooksは、skillまたはカスタムスラッシュコマンドが展開される前に実行されます。そのため、hookがプロンプトをブロックすると、埋め込まれたシェルコマンドも停止します。また、skill自身のフロントマターにあるUserPromptSubmit hookは、そのskillを呼び出した次のプロンプトで初めて実行されます。アクションを渡せない、または回答を返せないplugin hookは、アクションをそのまま通すのではなく拒否するようになりました。ツールがすでに実行されている場合は、その結果が返されません。modsでは、turn.start hookがsubagentsおよびteammatesのターンも受け取ります（e.agentIdで区別できます）。skill.promptはskillのfrontmatter、ソース、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またはteammateではresumeが設定された状態でagent.spawnが発火します。リモートで無効にされたmodsはターン間でアンロードされ、/pluginとclaude plugin validateは、組織がClaude Codeを管理しているためにスキップされたhooksを明示します（Modsを参照してください）。²⁷¹²⁷²

コマンド、操作画面、運用。 /usageは、最大effort、workflows、常時有効なコンテキスト、大きなツール結果について警告します。agentビューでは、/effortと/fastで新しいセッションの開始時設定を指定でき、引数なしの/model、/effort、/fastを実行すると選択画面が開きます。また、プレビューパネルには--safe-modeで開始したセッションのsafe mode行が表示されます。Plan modeでは、権限のバイパスが利用できるため、ほとんどの編集前に確認しない場合、その旨を示すメモが一度だけ表示されます。claude plugin evalは--disallow-toolsとdisallowed_toolsケースフィールドに対応し、APIエラーで終了した実行はスコアが0となり、スイートも失敗します。claude self-hosted-runner orchestrator --shutdown-drain-secを使用すると、SIGTERMの受信時に、処理中のポーリングとspawn hooksが完了するまでの時間を確保できます。Claude appsゲートウェイの背後では、codeまたはcliポリシーのenvにCLAUDE_CODE_ATTRIBUTION_HEADER=0を設定すると、帰属情報のブロックが削除されます。Coworkのクラウドセッションでは、auto modeのPermissionRequest hookがシェルコマンドやsubagentsを許可できなくなりました。また、許可済みサイト上でClaude in Chromeのアクションが安全性分類器に検出された場合、拒否されるのではなく確認を求められます。終了時に表示される再開コマンドはセッションをIDで指定します。非インタラクティブセッションの/btwは11分後にタイムアウトします。ローカルセッションで監視できる公開済みアーティファクトは10個から25個に増えました。また、サイバーセーフガードの通知でCyber Verification Programへの申請を求められることもなくなりました。²⁷¹ 知っておきたい修正。 カスタム ANTHROPIC_BASE_URL 経由のストリームは、180秒で中断せず、データを300秒待つようになりました。feature flag、起動、fast mode、profile、server-managed settingsに関する Anthropic へのリクエストには、サードパーティ製ゲートウェイの API キーが含まれなくなりました。/usage とステータス行に使用率が100%を超えて表示されることもありません。夏時間の終了時に同じ時刻が繰り返されても、スケジュール済みタスクやループが各ターンの終了後に再実行されなくなりました。--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 を指定した際に選択されるモデルとなりました（利用可能なモデルを参照）。managed settingsから Claude appsゲートウェイへサインインする場合は、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のfrontmatterと --agents の定義で autoCompactWindow を指定できるため、メインの会話より早い段階でsubagentを自動compactできます。CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL を設定すると、すべてのworkflow agentが同一モデルで動作し、それ以外のsubagentsは各自のモデルを維持します。また、CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS では、529のバックオフに設定する最大遅延時間を延長できます。Readツールは allow_large を受け取れるようになり、コンテキストに余裕があれば、通常のサイズ制限を超えるテキストファイルを Claude が1回の呼び出しで読み取れます。managed-settingsの PreToolUse hooksが "continue": false でツール呼び出しを拒否した場合や、managed prompt hooksが呼び出しをブロックした場合は、呼び出しの拒否に加えてターンも終了するようになりました。--debug はカスタムagentファイル内の認識されないfrontmatterフィールド名を示し、各command hookについてコマンド、plugin、結果、所要時間を記録します。Claude appsゲートウェイでは managed.policies[] の下に code キーが追加されました。これは cli と同じ設定で、Claude DesktopのCodeタブにも適用されます。← でセッションをバックグラウンドへ移している最中に開始されたターンや ! コマンドは、見えないところで完了するのではなく停止するようになりました。その後、ドキュメントもこのうち2点に追いついています。hooksの参照資料では、hookごとの --debug 行がv2.1.296の機能として記載され、Claude appsゲートウェイのドキュメントでは code ポリシーキーが説明されています。autoCompactWindow と CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS は10月14日までにsub-agentsおよびenv-varsのドキュメントへ追加されましたが、CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL は2026年10月14日時点でもリリースノートにしか記載されていません。^238240270272

v2.1.295（10月8日）。 Command hooksとHTTP hooksで onFailure: "block" を指定できるようになりました。hookを開始できない場合、タイムアウトした場合、予期しないコードで終了した場合に、そのアクションを通すのではなくブロックします（Hookの入出力プロトコルを参照）。CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS では、無人retry modeが429および529エラーの解消を待つ最長時間を制限できます。subagentsが skills フィールドから事前読み込みするskillsは最大32個となり、tool searchを通じて読み込まれる MCP ツールの説明は、2,048文字ではなく16,384文字で切り詰められるようになりました。managed settingsが存在しないマシンでも、ユーザー自身の設定で forceLoginMethod: "gateway" と forceLoginGatewayUrl が機能するようになり、/login は指定したゲートウェイで開きます。この構成は現在、ゲートウェイのドキュメントにも記載されています。各ゲートウェイupstreamではオプションの models リストを指定でき、* をワイルドカードとして使用できます。cloud upstreamsは timeouts.upstream_ttfb_ms にも従います。Program Status Protocol（OSC 7501）を実装したターミナルでは、Claude Code が作業中、ユーザーの応答待ち、完了のいずれの状態にあるかを表示できます。Claude appsゲートウェイの背後にあるバックグラウンドリクエストでは、ゲートウェイが対応している場合、セッションのモデルではなくHaiku 4.5が使用されます。ゲートウェイ、Bedrock、Vertex、Foundryがcontext-1m betaを拒否した [1m] モデルは、失敗させずにbetaなしで再送信されます。アタッチされたバックグラウンドセッションの待機プロンプトでCtrl+Cを押しても、保留中の /loop のウェイクアップは維持されます。2回押すとデタッチされ、ループは実行を続けます。Escを押すと停止します。claude.ai connectorsでは、フラグを取得できないインストールの場合、デフォルトで MCP protocol 2026-07-28をネゴシエーションします。/copy では引用形式のテキストを選択でき、claude -p は最後のターン後に何を待っているのかをstderrへ表示します。また、modsに $.ui.notify が追加されました。xhigh および max effortでも、Web検索と agent hookの評価に極端な時間がかからなくなりました。²³⁸²⁴⁰

v2.1.294（10月8日）。 命令として記述された prompt hooksと agent hooksに関する2つの問題が修正されました。「Block commands that…」のようなhookが、本来ブロックすべきものを許可することはなくなりました。また、「Carry on if the build is broken」のような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 のpayloadに agentType が追加され、ステータス行のスクリプトでカスタムsubagentの種類を判別できるようになりました。また、modsでは $.tool.register に isDeferred が追加されています。2つの変更も取り消されました。1つ目はv2.1.281のauto mode拒否メッセージで、拒否が正確なコマンドだけでなく結果全体を対象とすることを Claude に伝えるものでした。2つ目は、コンテナ再起動後に /loop のウェイクアップが失われる問題に対するv2.1.290のcloud-session修正です。そのため、このようなセッションは再びスリープ状態のままとなります。そのほか、compact前の最後のアクションを、compact後に Claude が完了済みと見なさなくなりました。HTTP MCP 接続は、終了するまで送信済みの全リクエストを保持し続けることがなくなりました。claude purge は黙って停止せず、削除できなかったものを一覧表示して終了コード1で終了します。セッションが使用されていない間のclaude.ai skill同期は、10分ごとではなく40分ごとに確認されます。TeamとEnterpriseの起動時には、ポリシーとmanaged settingsをより早く取得し、リクエストが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では、終了時にセッションの最後のメッセージが失われるv2.1.288のリグレッションと、cloud sessionsで権限プロンプトへの回答が失われるv2.1.290のリグレッションが修正されています。²³⁵

v2.1.292（10月6日）。 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS を設定すると、overloaded（529）リクエストを再試行する際のバックオフに、より長い基本遅延を指定できます。env-varsのドキュメントには、デフォルト値が500 ms、許容範囲が500〜32000であることも記載されました。Agentツールは effort パラメーターを受け取れるようになり、指定したeffortレベルで Claude がsub-agentを実行できます。subagentsのドキュメントにも呼び出しごとのパラメーターとして記載されており、frontmatterのフィールドを上書きし、subagentを再開した場合も有効です。ただし、CLAUDE_CODE_EFFORT_LEVEL はこれらの両方より優先されます。claude plugin install --marketplace <source> を使用すると、1つのシェルコマンドでmarketplaceの追加とそこからのインストールを実行できます。ローカル（stdio）の MCP サーバーは、Bedrock、Vertex、Foundryを含むすべてのインストールで、デフォルトとしてprotocol 2026-07-28をネゴシエーションするようになりました。オプトアウトするには MCP_PROTOCOL_NEGOTIATION=legacy を使用します。MCP のドキュメントにも、stdioサーバーにはデフォルトでこのrevisionを要求すると記載されています。Agent名の上限は256文字になりました。これを超える名前は拒否され、skillまたはpluginファイル内の長すぎる name は無視されます。subagentsのドキュメントにも name フィールドの上限が明記され、名前が上限を超えるsubagentファイルはスキップされ、debug logへエラーが書き込まれます。セキュリティ修正により、PreToolUse hookの承認やauto modeによって、ネットワーク（UNC）パスからファイルを読み取る際のプロンプトを回避できなくなりました。modsには prompt.autocomplete、$.model.complete のprompt caching、agent.spawn のworkflow agentsが追加されました。また、claude plugin test はstubの回答が拒否された場合に失敗するようになりました。残りの項目は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ミリ秒として解釈されることもなくなりました。単位サフィックス付きの値は dialogExpiry 設定にフォールバックします。²³⁵²³⁷

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

v2.1.289（10月3日）。 Mods に、チームメイト用の agent.spawn、plugin hook イベント間で共通する単一の agent id、$.agent.list() の idle および waiting 状態が追加されました。claude plugin validate は、フォルダー内に marketplace マニフェストもある plugin をスキップしなくなりました。また、sandbox の自動許可における Bash 拒否ルールの抜け穴が2件修正されました。²³⁵²³⁷

v2.1.288（10月2日）。 claude project purge は claude purge に変更されました。以前の名前も引き続き機能しますが、通知が表示されます。バックグラウンドコマンドの制限時間は、無人セッション（-p、Agent SDK、CI、cloud）にのみ適用されます。/code-review --max-findings <n>|all では、--max-findings default を渡すまで検出件数の上限を変更できます。/autocompact はモデルごとにウィンドウを保存します。CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS は、構造化出力を拒否する Mantle またはゲートウェイに対して構造化出力を無効にします。パススコープのルールとネストされた CLAUDE.md ファイルは、Read だけでなく Write と Edit でも読み込まれます。Language server はハングする代わりに、60秒後（サーバーごとの requestTimeout）にタイムアウトします。auto mode では、クライアント側の分類器には長すぎる会話について、ツール呼び出しのたびに確認するのではなく compact が実行されます。また、クライアント側の分類器は、Claude Sonnet 5.5 または Opus 5.5 を指定する ANTHROPIC_DEFAULT_SONNET_MODEL の固定設定を無視し、代わりに Claude Sonnet 5 を使用します。Mods には $.ui.selection() が追加され、GitHub CLI のない cloud セッションでは組み込みの gh api を利用できます。また、空のプロンプトで Up キーを押すと、Ctrl+C で消去した下書きが復元されます。²³⁴²³⁷

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

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

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

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

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

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

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

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

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

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

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

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

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

プロンプトエディターでは、複数行入力で readline 形式のナビゲーションが使えるようになり、fullscreen のビューポートスクロールにも対応しました。

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

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

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

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

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

Anthropicは、EU AI Act第50条（新たに提供開始されるAIシステムについては2026年8月2日から施行）の要件に対応するため、Claudeが生成したコンテンツに機械可読マークを付与すると発表しました。この仕組みは2つのコンポーネントで構成されます。1つは生成テキストに埋め込まれる不可視の統計的ウォーターマーク、もう1つはC2PAオープン標準に準拠し、.svg、.png、.jpgなどの生成ファイルに付与される署名付き来歴メタデータです。²⁵²²⁰⁴ 見出しだけでは伝わりにくい重要な点は、どちらのコンポーネントにも同じモデルの導入スケジュールが適用されることです。サポートページによると、「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のリリースノートでは追加機能の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

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

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

/fastを使うタイミング

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

/fastは、現在のセッションでfast modeを切り替えます。モデルは変更されず、Opus 5.5（v2.1.280以降のfast modeのデフォルト）、Opus 5、またはOpus 4.8のまま、出力速度が最適化されます。より安価なモデルへ切り替わるわけではありません。また、Opus 5.5ではMTokあたり$8/$40（Opus 5と4.8では$10/$50）なので、料金が安くなるわけでもありません。^196198223

権限システムはどのように機能しますか？

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

権限レベル

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

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

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

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

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

権限モード

v2.1.285では非対話型セッションにも対象が広がりました。 サードパーティープロバイダーを使用する場合、またはテレメトリが無効な場合、権限モードが未設定のclaude -pおよびPython Agent SDKセッションは、「対話型セッションと同様に」autoモードで開始するようになりました。--permission-modeによる指定は引き続き優先されます。ユーザー設定のデフォルトが別のモードである場合に表示される、autoモードをデフォルトの権限モードにするための1回限りの提案も、サードパーティープロバイダーやテレメトリ無効時に表示されるようになりました。10月1日に取得した権限モードのドキュメントにも、この動作が反映されています。サードパーティープロバイダーの使用時やテレメトリ無効時など、機能フラグを取得しない-pまたはAgent SDKセッションは、v2.1.285以降ではautoで開始します。機能フラグを取得するセッションはdefault（Manual）で開始し、組織のポリシーによってautoのデフォルト適用が保留されている場合も同様です。²²⁹²³³

v2.1.283とv2.1.284では、対話型セッションのデフォルトがすべてのプランとプロバイダーに拡大されました。 Enterprise、Claude API、サードパーティープロバイダーでも、対話型ターミナルおよびVS Codeセッションの組み込み開始モードがautoになりました。Manualを維持するには、~/.claude/settings.json、プロジェクトの.claude/settings.json、または管理設定でpermissions.defaultModeを"default"に設定してください。プロジェクトの設定ファイルに指定した"auto"の値は適用されません。²²⁶²²⁷ v2.1.283のリリースノートにはサードパーティープロバイダーとテレメトリ無効時のセッションが明記され、v2.1.284のノートには「すべてのプランとプロバイダー」でデフォルトになったと記載されています。権限モードのドキュメントでは、このデフォルト変更をv2.1.283からとしています。²²⁷²²⁸ またv2.1.284では、autoモードで作業ディレクトリ外を読み取る前に表示される確認に、Yes, but ask again next timeが追加されました。この選択肢では、その1回の読み取りのみを許可し、以降の読み取りでは引き続き確認が表示されます。²²⁸