Anthropic
Claude Code ベストプラクティス
設定ファイル、CLAUDE.md、Hooks、サブエージェント、Skills、Managed Agents、Scheduled tasks の使い方を、公式ドキュメントに沿って整理しています。
2026-11-02 に公式ドキュメント(code.claude.com / platform.claude.com)と照合済み
最新アップデート
ニュースに収録済みの直近3件です。全件はニュースから確認できます。
2026-11-04v2.1.318 — deniedMcpServers の URL 指定がコネクタにも適用、保存済みサインインの期限を表示
セキュリティ: deniedMcpServers の URL エントリが、上流 URL の一致する Anthropic 提供サーバーや、クラウドセッション・セルフホストランナーのコネクタもブロックするように。再起動後に承認したシェルコマンドがセッションの開始フォルダで実行されていた不具合を修正。
挙動変更: IDE のターミナルで起動しても IDE 拡張をインストール・更新しなくなった(/ide か拡張機能ビューから入れる)。claude auth status に loginExpiresAt、claude -p の JSON に credential_expires_at を追加。ニュースを読む
2026-10-31v2.1.314〜v2.1.316 — 作業ディレクトリ外への書き込みを全モードで拒否する設定を追加、Opus 4.8 の fast mode を非推奨化
セキュリティ: Write / Edit / NotebookEdit が作業ディレクトリ外のパスをどの権限モードでも拒否する permissions.blockWritesOutsideWorkingDirectories を追加。claude -p --resume / --continue で入った worktree にサンドボックスが効かない不具合、--restricted セッションが作業ディレクトリ外のファイルをアップロードできた不具合を修正。
挙動変更: Opus 4.8 の fast mode は 10/30 付で非推奨、11/30 に削除予定。CLAUDE_CODE_SUBAGENT_EFFORT・CLAUDE_CODE_DISABLE_ULTRATHINK を追加。ニュースを読む
2026-10-27v2.1.311〜v2.1.312 — ultrathink が新モデルで xhigh effort に、prompt / agent hook の同時実行数に上限
挙動変更: 対話ターミナルの ultrathink が、Anthropic API 経由の Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable 5.1 でそのターンを xhigh effort で実行するように。prompt / agent hook の同時実行はセッションあたり24件までに制限。
サブディレクトリの巨大な CLAUDE.md などを冒頭だけ見て上書きしないよう、Write が全文の読み込みを求めるように。ニュースを読む
概要
- Anthropic 製。ターミナル(CLI)、VS Code / JetBrains 拡張、デスクトップアプリ、Web で動作
- 設定は User / Project / Local / Managed の4スコープ
- CLAUDE.md(または AGENTS.md)でプロジェクトの指示を渡す
- Hooks はライフサイクルの各時点で実行するコマンド。公式一覧で33種類のイベント
- サブエージェントは独立したコンテキストで動作し、
isolation: worktreeで git worktree に隔離可能 - Skills(SKILL.md)で手順を再利用
- Scheduled tasks(旧 Routines)でクラウド上の定期実行(研究プレビュー)
ベストプラクティス 10
- 計画と実装を分ける(Plan mode や「まだ実装しないで」で先に方針を確認する)
- CLAUDE.md は1ファイル200行未満を目安に、どこを読むべきかを示す目次として書く
- 必ず守らせたいルールは CLAUDE.md ではなく PreToolUse hook や permissions の deny で強制する
- PostToolUse hook で編集後の lint / format を自動実行する
- サブエージェントは1つに1つの専門領域を担当させる
- 調査やログ解析など出力が大きい作業はサブエージェントに任せ、メインのコンテキストを汚さない
- 繰り返す手順は CLAUDE.md に書き足さず Skill に切り出す
- 副作用のある Skill には
disable-model-invocation: trueを付けて手動起動にする - 信頼できないリポジトリでは
.claude/settings.jsonの hooks を開く前に確認する - 定期実行させたい作業は、先に Skill として手動で安定させてから Scheduled tasks に載せる
設定(settings.json)
同じキーが複数の場所にあるときは、上位のスコープの値が使われます。
014つのスコープと優先順位
| スコープ | ファイル | 対象 | Git 管理 |
|---|---|---|---|
| Managed | managed-settings.json・MDM・claude.ai 管理コンソール | 組織が配布した全員 | IT 部門が配布 |
| User | ~/.claude/settings.json | 自分・全プロジェクト | しない |
| Project | .claude/settings.json | リポジトリの全員 | する |
| Local | .claude/settings.local.json | 自分・このプロジェクトのみ | しない(Claude Code が作成時に除外) |
優先順位(高い順): Managed → コマンドライン(--settings)→ Local → Project → User。permissions.allow のような配列は上書きではなく結合されます。
02スコープ別のファイル配置
| 機能 | User | Project | Local |
|---|---|---|---|
| Settings | ~/.claude/settings.json | .claude/settings.json | .claude/settings.local.json |
| サブエージェント | ~/.claude/agents/ | .claude/agents/ | — |
| Skills | ~/.claude/skills/ | .claude/skills/ | — |
| MCP サーバー | ~/.claude.json | .mcp.json | — |
| CLAUDE.md | ~/.claude/CLAUDE.md | CLAUDE.md または .claude/CLAUDE.md | CLAUDE.local.md |
03settings.json の例(permissions + hooks)
settings.json は厳密な JSON です。// コメントや末尾のカンマは構文エラーになります。下の例は .claude/settings.json です。
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"model": "claude-sonnet-5-5",
"permissions": {
"allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
"deny": ["Read(./.env)", "Read(./.env.*)"]
},
"hooks": {
"PreToolUse": [{
"matcher": "Bash",
"hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-rm.sh" }]
}],
"PostToolUse": [{
"matcher": "Write|Edit",
"hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx eslint --fix" }]
}]
}
}
設定を変えたら、セッション内で /status を実行すると読み込まれたファイルを確認できます。
CLAUDE.md
毎セッションの開始時に読み込まれる指示ファイルです。指示として扱われるだけで、強制力はありません。
01目次として設計する(200行未満)
公式ドキュメントは1ファイル200行未満を目安にしています。長いほどコンテキストを消費し、指示が守られにくくなります。詳しい内容はほかのファイルに置き、CLAUDE.md にはどこを読めばよいかを書きます。
- コマンド(build / test / lint)と構成の概要だけを書く
- 繰り返す手順は Skills に切り出す
- 特定のファイル種別だけに効くルールは
.claude/rules/に置く(パス指定で必要なときだけ読み込まれる) - 終わったタスクは消し、現在の状況を更新する
# CLAUDE.md の例
## Commands
build: npm run build
test: npm test
lint: npx eslint .
## Architecture
- API: src/api/ (Express + Zod)
- DB: Prisma (PostgreSQL)
- 詳細: docs/architecture.md
## Knowledge Index
- docs/api-spec.md — API 仕様
- .claude/skills/ — 繰り返し手順
- tasks/current.md — 現在のタスク
/doctor prompt-audit を実行すると、CLAUDE.md・rules・skills などの矛盾や古い指示を点検できます。
02読み込まれる場所と順序
/Library/Application Support/ClaudeCode/CLAUDE.md # 組織(macOS の例)
~/.claude/CLAUDE.md # 個人・全プロジェクト
./CLAUDE.md または ./.claude/CLAUDE.md # プロジェクト(Git 管理)
./CLAUDE.local.md # 個人・このプロジェクト(.gitignore に追加)
- 作業ディレクトリとその上位にあるファイルは起動時に読み込まれ、上書きではなく連結されます
- サブディレクトリの CLAUDE.md は、Claude がそのディレクトリのファイルを読み書きしたときに読み込まれます
- CLAUDE.md がなく AGENTS.md だけがあるプロジェクトでは、AGENTS.md が代わりに読み込まれます
Hooks
ライフサイクルの決まった時点で処理を実行する仕組みです。種類は command(シェルコマンド)・http・mcp_tool・prompt・agent の5つです。CLAUDE.md と違い、モデルの判断に関係なく必ず実行されます。
01主なイベント(全33種類のうち)
| イベント | タイミング | 使い方の例 |
|---|---|---|
SessionStart / SessionEnd | セッションの開始・終了 | 環境情報の注入、後片付け |
UserPromptSubmit | プロンプト送信時 | 入力の検査・補足情報の追加 |
PreToolUse | ツール実行前(権限の要否に関係なく毎回) | 危険なコマンドの拒否、入力の書き換え |
PermissionRequest | 権限の確認を出す直前 | 承認・拒否の自動化 |
PostToolUse | ツール実行後 | lint / format、結果の置き換え |
Notification | 通知の発生時 | デスクトップ通知・チャットへの転送 |
Stop / SubagentStop | メイン / サブエージェントの応答終了時 | 完了条件の確認、続行の指示 |
PreCompact / PostCompact | コンテキスト圧縮の前後 | 重要情報の退避・再注入 |
MessageDisplay | 応答テキストの表示時 | 表示内容だけを変換(Claude が見る内容は変わらない) |
PreModelSwitch / PostModelSwitch | モデル切り替えの前後 | 切り替えの記録・制限 |
ほかに SubagentStart・PostToolUseFailure・ConfigChange・FileChanged・WorktreeCreate などがあります。全一覧は公式ドキュメントを参照してください。Hooks は settings.json のほか、Skill やサブエージェントのフロントマターにも書けます。
02実装例: PreToolUse で危険なコマンドを拒否する
hook への入力は環境変数ではなく、標準入力の JSON で渡されます(tool_name・tool_input など)。拒否するときは hookSpecificOutput.permissionDecision に "deny" を返します。
# .claude/hooks/block-rm.sh
#!/bin/bash
CMD=$(jq -r '.tool_input.command')
if echo "$CMD" | grep -qE 'rm\s+-rf|DROP TABLE'; then
jq -n '{hookSpecificOutput: {
hookEventName: "PreToolUse",
permissionDecision: "deny",
permissionDecisionReason: "危険なコマンドのためブロックしました"
}}'
fi
exit 0
permissionDecisionはallow・deny・ask・deferのいずれか- 終了コード 2 で終わると、標準エラーの内容を理由としてブロックします。JSON を出力していても終了コード 2 ならブロックされ、
permissionDecision: "allow"でも上書きできません - スクリプトの場所は環境変数
CLAUDE_PROJECT_DIR(プロジェクトのルート)を基準に書くと確実です
03PostToolUse でツールの出力を置き換える
hookSpecificOutput.updatedToolOutput を返すと、Claude に渡るツールの出力を置き換えられます。組み込みツールの出力は構造化されたオブジェクトなので、同じ形で返す必要があります(形が合わない値は無視され、元の出力が使われます)。MCP ツールの出力は形の検証なしにそのまま渡されます。ツールはすでに実行済みなので、実行そのものは取り消せません。下の例は MCP ツールの出力を文字列で置き換える場合です。
{
"hookSpecificOutput": {
"hookEventName": "PostToolUse",
"updatedToolOutput": "(機密情報を伏せた MCP ツールの出力)"
}
}
04MessageDisplay — 表示だけを変える v2.1.152
応答テキストを画面に表示する前に変換できる hook です。displayContent を返すとその文字列が表示され、省略すると元のテキストが表示されます。変わるのは表示だけで、会話履歴と Claude が見る内容は元のままです。
05Stop hook の無限ループ防止
Stop hook がターンの続行を8回連続で指示すると、Claude Code は次のブロックを無視してターンを終了します。回数は Claude がツールを呼ぶたびにリセットされます。上限は環境変数 CLAUDE_CODE_STOP_HOOK_BLOCK_CAP で引き上げられます。
06terminalSequence — ターミナル通知
hook の JSON 出力に terminalSequence を含めると、デスクトップ通知やウィンドウタイトルの変更などのターミナル制御シーケンスを出力できます。Notification や StopFailure のように出力の大半が無視されるイベントでも、このフィールドは使われます。-p(非対話)モードと Agent SDK では無視され、使えるのは OSC 0/1/2/9/99/777 と BEL だけです。書式は公式ドキュメントの「Emit terminal notifications」を参照してください。
claude -p と Agent SDK のセッションでは信頼ダイアログが出ないため、リポジトリの .claude/settings.json に書かれた hook が開いた時点で実行されます。信頼できないリポジトリを claude -p で処理する前には中身を確認してください(--settings '{"disableAllHooks": true}' で無効化できます)。出典: Hooks reference
サブエージェントと worktree
サブエージェントは独立したコンテキストで動く専門エージェントです。Markdown ファイルに YAML フロントマターで定義します。
01カスタムサブエージェントの定義
# .claude/agents/security-reviewer.md
---
name: security-reviewer
description: Reviews code for security issues. Use after code changes.
model: opus
tools: Read, Glob, Grep
color: red
---
You are a senior security reviewer.
Focus on: injection attacks, auth bypasses, secrets exposure.
Provide specific, actionable findings only.
- 必須は
nameとdescriptionだけ。フィールド名は camelCase(disallowedTools・maxTurnsなど)で、綴りを間違えるとエラーなしに無視されます - 保存先: 個人用
~/.claude/agents/、プロジェクト共有用.claude/agents/ isolation: worktreeを付けると一時的な git worktree で動き、変更がなければ自動で削除されます。worktree は既定で親セッションの HEAD ではなくデフォルトブランチから作られるため、未コミットの変更や作業ブランチの内容は見えません。上の例のような読み取り専用のレビュー役には付けない方が安全です- ほかに
permissionMode・skills・mcpServers・hooks・memory・background・effort・omitClaudeMdなどを指定できます
02組み込みのサブエージェント
| 名前 | モデル | 用途 |
|---|---|---|
| Explore | メインの会話と同じモデル(メインが Fable で、Claude サブスクリプション・Console・LLM ゲートウェイ経由の場合は Opus。Bedrock・Vertex・Foundry では常にメインと同じ) | 読み取り専用のファイル探索・コード検索 |
| Plan | メインの会話と同じ | Plan mode 中の調査(読み取り専用) |
| general-purpose | メインの会話と同じ(CLAUDE_CODE_SUBAGENT_MODEL で変更可) | 複数ステップの複雑な作業 |
Explore を Haiku で動かしたい場合は、model: haiku を指定した同名のサブエージェント Explore を定義すると組み込み版を上書きできます。
03worktree で並列に作業する
複数のセッションをそれぞれ別の git worktree で動かすと、同じリポジトリを競合なく並行して編集できます。
# worktree を作成
git worktree add ../project-feature-a feature-a
git worktree add ../project-feature-b feature-b
# 大規模な一括変更を頼むプロンプトの例
"Migrate all sync IO to async.
Use parallel subagents with worktree isolation.
Each agent tests its changes, then opens a PR."
04CLAUDE.md・Skills・サブエージェントの使い分け
| 要素 | 読み込まれる場所 | 使う場面 |
|---|---|---|
| CLAUDE.md | 毎セッション、メインのコンテキスト | 変わらないプロジェクト情報 |
| Skills | 呼び出したときだけ、現在のコンテキスト(context: fork ならサブエージェント) | 繰り返す手順 |
| サブエージェント | 独立したコンテキスト | 出力が大きい調査や並列作業 |
CLAUDE.md が手順書のように長くなってきたら、その手順は Skill に切り出すタイミングです。
Skills
SKILL.md に手順を書いておくと、必要なときだけ読み込まれます。
01SKILL.md の構造とフロントマター
.claude/skills/
commit-helper/
SKILL.md # 必須
examples.md # 任意の補足ファイル
---
name: commit-helper
description: Stage and commit changes in logical groups. Run with /commit-helper.
disable-model-invocation: true # 自動では読み込ませない(副作用のある Skill に推奨)
context: fork # サブエージェントとして実行
allowed-tools: Bash(git add *) Bash(git commit *)
disallowed-tools: WebFetch WebSearch
hooks:
PreToolUse:
- matcher: "Bash"
hooks:
- type: command
command: "./scripts/security-check.sh"
---
- フィールド名は小文字のハイフン区切り(
when_to_useだけ例外)。綴りを間違えるとエラーなしに無視されます allowed-toolsは確認なしで使えるツール、disallowed-toolsはその Skill の実行中に使えなくなるツールcontext: forkとagentを組み合わせると、指定したサブエージェントで実行できます
02保存場所と再読み込み
- 個人用:
~/.claude/skills/<name>/SKILL.md、プロジェクト共有用:.claude/skills/<name>/SKILL.md - 既存の skills ディレクトリ内の追加・編集・削除は、再起動なしに同じセッションへ反映されます
- セッション開始時に存在しなかった skills ディレクトリを新しく作った場合だけ
/reload-skillsが必要です
Managed Agents ベータ
Claude API の機能で、Anthropic が管理するクラウドのサンドボックス、または自社インフラ上のセルフホストサンドボックスでエージェントを長時間動かせます。Claude Platform on AWS と Google Cloud(Anthropic 管理)でもベータ提供されています。Claude Code CLI そのものの機能ではありません。
managed-agents-2026-04-01 ベータヘッダーが必要です(SDK は自動で付与)。Dreams と MCP tunnels だけは研究プレビューで、利用申請が必要です。01Outcomes — 完了条件を定義して反復させる ベータ
完成形と評価基準(ルーブリック、必須)を渡すと、別のコンテキストで動く評価役(grader)が成果物を採点し、不合格の項目をエージェントに返して作り直させます。
- 評価役はメインのエージェントの判断に影響されないよう、別のコンテキストウィンドウで評価します
- 反復回数は
max_iterationsで指定(既定3回、最大20回) - 同時に扱える Outcome は1つ。終わったら次の Outcome を続けて定義できます
02マルチエージェント — 他のエージェントに作業を任せる ベータ
セッションのエージェントが、サブエージェントへの委任や、多数のエージェントを動かすワークフローの実行で作業を分担します。
- あらかじめ登録できるエージェントは、サブエージェント用・ワークフロー用のリストそれぞれ最大20種類
- サブエージェントへの委任は1階層のみ。子スレッドは1セッションあたり、アイドル中のものも含めて最大25個(アドバイザーやワークフロー実行のスレッドは数えない)
- 各エージェントの動作はセッションのスレッドとして一覧・ストリーミングで確認できます
03Dreams — 記憶の整理 研究プレビュー・要申請
既存のメモリストアと過去のセッション(1〜100件)を読み込み、重複の統合・古い情報の更新・新しい知見の追加をした新しいメモリストアを作る非同期ジョブです。
- 入力のメモリストアは変更されないので、結果を確認してから採用・破棄を選べます
- 処理には数分から数時間かかります。料金は選んだモデルの通常のトークン単価です
dreaming-2026-04-21ベータヘッダーが追加で必要です
出典: Managed Agents overview · Define outcomes · Multiagent orchestration · Dreams
Scheduled tasks(旧 Routines) 研究プレビュー
プロンプト・リポジトリ・コネクタをまとめて保存し、Anthropic のクラウド(または組織のセルフホスト環境)で自動実行する機能です。ノート PC を閉じていても動きます。
routines 配列で設定できる GA 機能と説明していましたが、誤りでした。現在は研究プレビューで、settings.json ではなく下記の方法で作成します。01作成方法とトリガー
- 作成・管理: claude.ai/code/routines、または CLI の
/schedule - トリガーは3種類で、組み合わせ可能: スケジュール(毎時・毎晩・毎週、または指定日時に1回)、API(専用エンドポイントへの HTTP POST)、GitHub(PR やリリースなどのイベント)
- 独自の間隔は cron 式(5フィールド)で指定。
CRON_TZ=を付けない場合は UTC で書きます。1時間より短い間隔は指定できません - 対象プラン: Pro・Max・Ultra・Team・Enterprise。
/scheduleは claude.ai のサブスクリプションでログインしている必要があります(API キーや Bedrock / Vertex 経由では使えません)
02運用のコツ
- まず手動で Skill として動かし、結果が安定してからスケジュールに載せる
- クラウドで動くため、ローカルの
~/.claude/settings.jsonや.claude/settings.local.jsonは読まれません。リポジトリ1つのセッションならリポジトリの.claude/settings.jsonが読まれますが、複数リポジトリのセッションではenabledPluginsとextraKnownMarketplacesしか読まれず、プロジェクト内のクラウドスレッドでは permissions・hooks・env は適用されません。確実に効かせたい値はクラウド環境の環境変数に設定します - 個人用
~/.claude/skills/の Skill はクラウドでは読み込まれません。定期実行で使う Skill はプロジェクトの.claude/skills/に置いてコミットします - ほかのツールの定期実行機能との比較は比較表を参照してください
出典: Automate work with scheduled tasks · Settings in cloud sessions
更新ログ
sandbox.filesystem.allowWriteで許可可)、ファイルツールは.credentials.jsonなどサインインファイルへの書き込みを拒否。hookの"decision": "block"がより多くのケースで有効に⚠️。claude mcp add-json <name> -で標準入力からMCP設定を渡せるように。詳細はニュース参照。sandbox.autoAllowBashIfSandboxed: true。スケジュールタスク//loopはallowed-toolsやhooksを宣言したスキルの実行前に確認(Skill(name)をallowで無人実行)。zstd応答デコードのセキュリティ問題や複合コマンドの権限チェック漏れを修正🔒。詳細はニュース参照。plugin.jsonのengines["claude-code"]を追加。Bash(ls*)型のallowルール・sandbox.excludedCommands・Read deny対象へのWrite/Editなどのバイパスを修正。未知のモデルIDの想定コンテキストを1Mに⚠️(CLAUDE_CODE_DISABLE_1M_CONTEXT=1で200K)。詳細はニュース参照。claude-fable-5-2、$8/$40 per Mtok)が既定のFableモデルに。MCP OAuthがリダイレクト先の別ホストへリフレッシュトークン等を送っていた不具合、読み取り専用Bashがサンドボックス外で確認なしに実行されたケース、cp/mvでディレクトリ内に書き込むファイルにdenyルールが効かない不具合を修正。claude remote-control --settings <file>追加、Vertexでfast mode対応permissions.denyInsteadOfPrompting、MCP tasksのバックグラウンド実行、/claude-api latency-optimizeを追加。テレメトリ/フィーチャーフラグ無効時やLLMゲートウェイ経由のauto modeは組み込みClassifierへフォールバックしなくなった⚠️(CLAUDE_CODE_AUTO_MODE_SERVER=0で従来どおり)。クォート付きの語を含むコマンドでBashのdeny/askルールが漏れる不具合を修正。詳細はニュース参照。deniedMcpServersのURLエントリがAnthropic提供サーバーやクラウドセッション/セルフホストランナーのコネクタにも適用。再起動後の承認済みシェルコマンドが開始フォルダで実行される不具合を修正。claude auth statusのloginExpiresAt・claude -pのcredential_expires_atを追加。IDEターミナル起動時のIDE拡張自動インストールを廃止⚠️。詳細はニュース参照。
onFailure: "block"、/scheduleで頼んでいないコネクタが付いた際の警告を追加。リードがmanualモードなのにtmux/iTerm2のチームメイトがauto modeで起動する不具合を修正。Readの「file unchanged」スタブ廃止、別モデルのサブエージェントはそのモデルの保存済み/既定effortを使用⚠️。詳細はニュース参照。
permissions.blockWritesOutsideWorkingDirectories(Write/Edit/NotebookEditが作業ディレクトリ外を全モードで拒否)を追加。--restrictedセッションの作業ディレクトリ外ファイルのアップロード、claude -p --resume/--continueで入ったworktreeへのサンドボックス未適用、Monitor起動コマンドにBash hookが走らない不具合などを修正。Opus 4.8のfast modeは11/30削除予定⚠️。CLAUDE_CODE_SUBAGENT_EFFORT・CLAUDE_CODE_DISABLE_ULTRATHINK追加。詳細はニュース参照。
ultrathinkがOpus 5.5/Sonnet 5.5/Haiku 5.5/Fable 5.1でxhigh effortに。prompt/agent hookの同時実行をセッションあたり24件までに制限、DISABLE_COMPACTは設定/modからはオフ方向のみ、OTel claude_code.safety_eventの送信停止。巨大なCLAUDE.mdを一部だけ見て上書きする問題を修正。詳細はニュース参照。
--mcp-configのMCP設定ファイルをサンドボックス内コマンド/自動承認編集が変更できた不具合、サブシェルを含むコマンドでEdit(path) denyがBashリダイレクトを止めない不具合などを修正。sed -iは通常のBash確認で実行されるように⚠️。/auto-mode-setup・sandbox.allowNestedUserNamespaces・OTelイベントclaude_code.safety_eventを追加。詳細はニュース参照。
updatedInputをClaude自身の入力と同様に検証(未知キー除去・不正入力は拒否)。forkサブエージェントがclaude -p・Agent SDK・デスクトップ・VS Codeでも既定オンに(CLAUDE_CODE_FORK_SUBAGENT=0で無効化)。CLAUDE_CODE_AUTO_MODE_MODEL追加。単体版Claude Designは2026-12-14までに終了予定。詳細はニュース参照。
--plugin-dirへの書き込み・ダブルアンダースコアを含むMCPサーバー名へのdeny/ask未適用などを修正。MCP allowルールは指定サーバーのみに適用(mcp__aはa__bを許可しない、mcp__<server>__*で書く)。UserPromptSubmit hookがskill展開前に実行されるように。アイドル時compaction追加。詳細はニュース参照。
onFailure: "block"を追加し、hookの起動失敗・タイムアウト時に操作をブロック可能に。BASH_ARGV0経由のコマンドが自動承認されていた不具合を修正。subagent frontmatterにautoCompactWindow追加。詳細はニュース参照。
prompt/agent hookがブロックすべき操作を許可してしまう不具合を修正。Bashのcat/head/grep等でファイルを見た場合にもpath-scoped rules・ネストしたCLAUDE.mdが読み込まれるよう修正。詳細はニュース参照。
claude-haiku-5-5)リリース。$0.10/$0.50 per Mtok(100K超は$0.50/$2.50)、v2.1.293でAnthropic API上の既定Haikuモデルに。詳細はニュース参照。
claude plugin install --marketplace・Agentツールのeffortパラメータを追加、stdio MCP接続は既定でプロトコル2026-07-28をネゴシエート(⚠️、MCP_PROTOCOL_NEGOTIATION=legacyで従来動作)。詳細はニュース参照。
ceiling・Modsに$.ui.selection()・/claude-api managed-agents-onboardコマンドを追加。詳細はニュース参照。
/plugin enable cc-plugin-you-should-know@builtin)・Agents Viewのn:<text>セッション名フィルターも追加。v2.1.286は権限プロンプトの件数表示・認証情報期限切れ時の多重ログインブラウザ起動などを修正。詳細はニュース参照。
claude-sonnet-4-5-20250929(Claude Sonnet 4.5)の廃止を通知。retirement日は2026-11-30、推奨移行先はclaude-sonnet-5-5。詳細はニュース参照。
claude --desktop・claude plugin configure <plugin>・CLAUDE_CODE_DISABLE_WEB_FETCH環境変数・利用可能なAPIプロバイダーを制限するallowedProviders管理設定を追加。SSHパスフレーズ入力がfetch処理を妨げる不具合・Remote Controlのメッセージ処理/クラウドセッション作成の不具合を修正。詳細はニュース参照。
/rate-limit-options・/mcp reconnect allも追加。詳細はニュース参照。
/doctor prompt-auditを追加。モデルの完全一致を要求するavailableModelsMatch・特定モデルを禁止するdeniedModels管理設定、Bedrock向けSTS assume_role・guardrails対応、"attribution": false設定を追加。詳細はニュース参照。
CLAUDE.mdが無いプロジェクトではAGENTS.mdを代わりに読み込むように対応。Claude API/Enterprise/Bedrock/Vertex/ゲートウェイ利用者のAuto Modeが既定でサーバーサイドClassifierを使うように変更(CLAUDE_CODE_AUTO_MODE_SERVER=0でオプトアウト可)。詳細はニュース参照。
allowManagedMcpServersOnly/deniedMcpServers設定が無視される不具合・組織がSkillsを無効化しても同期済みスキルが使い続けられる不具合をまとめて修正(🔒)。メモリ使用量が危険域に達した際の警告表示・MCP起動待機時間を設定するCLAUDE_CODE_MCP_STARTUP_WAIT_MS・LLMゲートウェイ向けリクエストヘッダーを追加。詳細はニュース参照。
allowed_domainsを追加(🔒)。クラウド/セルフホストランナーのRemoteセッションでfast mode対応。エージェントfrontmatterにomitClaudeMd(CLAUDE.md読み込み無効化)を追加。claude plugin install/updateに--accept-command <sha256>を追加。詳細はニュース参照。
claude plugin eval(JSON+HTMLレポート)を追加。出力スタイルの一覧・切替/output-style [name]を追加(Remote Control・ヘッドレスセッションでも利用可)。Bashツール結果にコマンドが変更したファイルのdiffを追加。並行サブエージェント数を制限するCLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS(1〜256)を追加。ゲートウェイにpricing:設定・claude self-hosted-runner --remove-session-stateを追加。WebFetchが無期限にハングする不具合(300秒でタイムアウトするよう修正)・長時間セッションでの高CPU使用率・MCPサーバーのOAuthサインイン失敗を修正。詳細はニュース参照。
maxEffortLevel設定(全プロバイダー共通でeffort上限を指定)・--plugin-dirのフォルダ一括ロード対応・--system-prompt-snapshot offを追加。v2.1.266は、v2.1.265で混入したCLAUDE_CODE_USE_GATEWAY回帰(APIキー併用構成でゲートウェイサインインを強制し全リクエスト失敗)を即日緊急修正。詳細はニュース参照。
/diffで切り替え可能なdiffパネルを追加。未使用スキル・コンテキストコストを診断する新コマンド/skill-doctor、bashOutputMaxChars/taskOutputMaxChars設定(最大128K文字)を追加。括弧を含むファイル権限ルールが無視される不具合・Bashがzshのコマンド置換を代入文の中で誤って自動承認していた不具合を修正(🔒)。v2.1.263(9/6)は安定性改善のみ。詳細はニュース参照。
managedMcpServersを追加。無人ヘッドレスホスト向けに全確認プロンプトを抑制する--permission-prompts noneを追加。GitLabマージリクエスト(glab mr)を認識。BashのRead() denyルールがファイルオプション値(--file=等)をカバーしていなかった不具合を修正(🔒)。同時実行セッションが互いの~/.claude.jsonを上書きし合う不具合・OAuthリフレッシュ時のprompt cache無効化も修正。詳細はニュース参照。
.git/configのcore.fsmonitorを悪用し、git status等のコンテキスト収集コマンド実行だけで任意コード実行を許してしまう脆弱性がgoose・Claude Code・Codex等7ツールで公表(Manifold Security)。goose・Claude Code・Cursorは修正済みだが、Claude Codeの別経路(2つ目の攻撃パス)は2026-09-01時点で未修正。.git付きでzip等から受け取ったリポジトリの.git/configは開く前に確認を推奨。詳細はニュース参照。
/effortのsオプション(セッション限定変更)・CLAUDE_CODE_SUBAGENT_MODEL_FORCE環境変数を追加。プラグインマーケットプレイスのハードニング。v2.1.258でmacOS 12起動失敗の回帰・remote/scheduledセッションの権限承認エラーを修正。詳細はニュース参照。
PreModelSwitch/PostModelSwitchhookイベントを追加。foregroundサブエージェントのツール呼び出しをRemote Controlへライブストリーミング。/usageにspend limitバー・/costにセッション単位のprompt cache行を追加。ファイルツール(Read/Write/Edit)がsymlinkを辿り承認範囲外を読み書きできる不具合・plugin commandsのpath-traversal・Grep/Globがsymlink経由でRead denyルールを適用しない不具合をまとめて修正(🔒)。seat-based Enterpriseの既定モデルをOpus 5に変更。v2.1.250は安定性改善のみ。詳細はニュース参照。
--restrictedフラグ(コマンド/コード実行ツールとWebFetchを除去、user/project/local設定を無視、bypassPermissions拒否)を追加。agent frontmatterにexperimental.cacheTtl("5m"/"1h")でサブエージェント単位のprompt cache TTLを設定可能に。SendFeedbackツール・/claude-api cost-optimize・/permissionsのAuto modeタブを追加。長時間セッションでの約1時間ごとのprompt cacheミスを修正。詳細はニュース参照。
headersHelperがプロジェクト.mcp.json/plugin/agentファイル経由の場合はフォルダのtrust dialog承認を必須化し、資格情報env varを継承せず実行されるように変更(🔒)。keybindingFlavor設定・self-hosted-runnerの--defer-shutdown-max-min/--proxy-authorization-commandを追加。data residencyワークスペースの推論コストに1.1倍プレミアムを反映、Python版anthropicライブラリ移行用/claude-api upgrade追加。詳細はニュース参照。
ANTHROPIC_DEFAULT_MODEL環境変数を追加。SendMessageにnotify_when_idleを追加し、別セッションがアイドルになった際に1回だけ通知可能に。macOSサンドボックスのワイルドカードread-denyルールが許可済みread領域内でも優先されリネームでも回避不可に(🔒)。前置きを省き結果を先に示す組み込み出力スタイル「Concise」を追加(/config > Output style)。詳細はニュース参照。
TaskCreate/TaskGet/TaskUpdate/TaskList・TodoWriteツールを非推奨化。WindowsのNT-namespace(\??\)パスをファイル操作から拒否するセキュリティ強化(🔒)。組み込みclaude-apiスキルのコンテキストコストを約200k→25kトークンに削減。プロンプト入力にspellcheck設定を追加。詳細はニュース参照。
fork(会話全体とプロンプトキャッシュ引き継ぎ)が既定オンに、対話セッションでの非teammateエージェント起動は既定でバックグラウンド実行に(⚠️挙動変化)。PowerShellの$PSDefaultParameterValues上書きバイパス・Windows Git BashのCygwin symlink権限バイパス・ネストgitリポジトリの信頼継承不具合を修正。GitLabトークンのシークレットマスキングとプラグインマーケットプレイスのGitLab対応を追加。詳細はニュース参照。
/commit-push-prが実行するgit/ghコマンドのうち--force・--amend・--no-verify等の危険なフラグを含むものを自動承認しなくなった。プラグインマーケットプレイスにローカルcommandソースを追加(IDE等が出力したプラグインディレクトリをセッションごとに再解決)。セルフホステッドランナーがマネージド環境同様のサーバー提供Hookに対応。詳細はニュース参照。
!コマンド実行/@ファイル展開を無効化。v2.1.226は安定性改善のみ。詳細はニュース参照。
claude agents実行に信頼していないディレクトリへのワークスペース信頼プロンプトを追加(claude本体と同挙動に統一)。長期間有効なCLAUDE_CODE_OAUTH_TOKENが短命トークンに置き換わりヘッドレスセッションが401で壊れる不具合・macOS keychainタイムアウト後のMCP OAuth断続401エラーを修正。v2.1.226は安定性改善のみ。詳細はニュース参照。
claude self-hosted-runnerコマンド追加(自前マシン/コンテナでセッション実行、Team/Enterprise向け)。zipアーカイブからHTTPS経由でプラグインをインストールできるArchive plugin sourceを追加(SHA-256ピン留め対応)。SendMessage/ListAgentsでセッション間メッセージングに対応(macOS/Linux)。長時間セッションのサブエージェント生成数200件の上限を撤廃。サンドボックス認証情報マスキングにJWT対応decode:"jwt"・AWS SigV4再署名を追加。詳細はニュース参照。
.claude/settings.jsonにHookを仕込み、開発者が新セッションを開始した瞬間に悪性スクリプトを実行。AIツール関連認証情報のほかクラウド・GitHub・SSH等の認証情報も標的。信頼できないリポジトリを開く際はSessionStart Hookの定義を確認すること。詳細はニュース参照。
import()によるサンドボックス脱出・エージェントbypassPermissionsが組織ポリシーを無視する問題をまとめて修正。/reviewが/code-reviewのエイリアスに変更(/code-review ultraで深いレビュー)。CLAUDE_CODE_DISABLE_1M_CONTEXT・auto-compactの挙動も変更(⚠️挙動変化)。詳細はニュース参照。
/configから)。ultraplan機能を廃止。詳細はニュース参照。
[[ ]]内で隠しコマンドが権限チェックを回避して実行できる脆弱性を修正。VSCode拡張にFocus view(Ctrl+Alt+F)を追加(ツール実行ログを折りたたみ要約表示)。Linux/WSLサンドボックス認証情報ファイルにmode: "mask"を追加。バックグラウンドセッションがCLAUDE.mdのgit方針に従いcommit/pushするよう変更。/forkが新しいworktreeを作成するように変更。詳細はニュース参照。
sandbox.network.strictAllowlist設定追加。サブエージェントのネスト生成が最大深さ3まで既定で可能に(CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1で無効化可)。workflowSizeGuideline設定でDynamic Workflowのサイズ目安を指定可能に。詳細はニュース参照。
/code-reviewがバックグラウンドサブエージェント実行に変更(会話を占有しない)。信頼されていないフォルダのagent frontmatter hookが実行される不具合を修正(エージェントファイルのフォルダのworkspace trustを要求)。skillのcontext: fork指定はデフォルトでバックグラウンド実行に(background: falseでオプトアウト可)。詳細はニュース参照。
sandbox.filesystem.disabled設定を追加(ネットワーク制御は維持しファイルシステム隔離だけ無効化可能)。worktree分離サブエージェントがgit -C等で共有チェックアウトを操作できる不具合、.claudeへのsymlink経由でworkflow保存が対象外に書き込める不具合、/rewindがsymlink/hard link経由で意図しないパスを操作する不具合などを修正。詳細はニュース参照。
/verify・/code-reviewを自動実行する挙動を廃止。以後は明示的にコマンドを呼び出したときだけ実行される(⚠️挙動変化)。詳細はニュース参照。
dir/** allowルール(例:Edit(src/**))がツリー内どこでも同名ディレクトリに誤適用される不具合、Windows PowerShell 5.1での権限チェックバイパス、10,000文字超コマンドの誤判定など権限チェック関連の修正多数(⚠️挙動変化)。虐待的入力に対しClaude自身がセッションを終了できるEndConversationツールを追加。詳細はニュース参照。
/forkはバックグラウンドセッションへのコピーに変更(旧来のインセッションsubagent起動は/subtaskに分離、⚠️挙動変化)。WebSearch呼び出し数・subagent生成数にセッション単位の上限を追加。詳細はニュース参照。
ask 判定を上書きしてしまうバグを修正。「常に許可」の保存先が worktree 単位からリポジトリルート単位に変更(⚠️挙動変化)。詳細はニュース参照。
isolation: 'worktree' サブエージェントがメインリポジトリに git 変更コマンドを実行できてしまうバグを修正。