10/29 の公式ドキュメント更新：バックグラウンド実行の切り替えとプラグイン名の扱い

Posted at 2026-11-03

2026-10-29 に追加文が検知された Claude Code の公式ドキュメントは 25 ページでした。この日の追加は、バックグラウンド実行を環境変数でどこまで止められるかの説明、プラグインのマーケットプレイス名に関する制約、Agent SDK での権限・コスト・使用量計測の前提の明文化に集まっています。追加文は短い注記が中心で、変更の経緯までは書かれていません。

バックグラウンド実行を止める環境変数と、止まらないもの

サブエージェントのページと環境変数一覧のページに、バックグラウンド実行の停止に関する記述が加わりました。サブエージェント側では、フォークモード（fork mode）をオフにする方法とは別に、環境変数 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 にする方法があります。後者の場合は、サブエージェントの完了を待ってから次に進む動作になると書かれています。

If you set the CLAUDE_CODE_DISABLE_BACKGROUND_TASKS environment variable to 1 instead of turning fork mode off, Claude waits for subagents to finish before it continues.

（出典 [3]）

（訳：フォークモードをオフにする代わりに環境変数 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 に設定した場合、Claude は続行する前にサブエージェントの完了を待ちます。）

環境変数のページには、MCP tasks と Monitor tool は引き続きバックグラウンドで動作するという注記があります。バックグラウンドセッションまで止めたい場合は CLAUDE_CODE_DISABLE_AGENT_VIEW を 1 にする、という案内も付いています。追加文だけでは「引き続き」がどの設定の説明に続くのかは判断できず、詳細は不明です。止めたい対象（サブエージェント、MCP tasks と Monitor tool、バックグラウンドセッション）ごとに、どの設定が効くかを分けて確認する必要があります。

マーケットプレイス名は公式名と衝突に注意

プラグイン関連の 2 ページに、マーケットプレイス名の扱いが追加されました。plugins ページには、Claude Code は Anthropic のコミュニティ向けマーケットプレイスを自動では追加しない、と書かれています。公式名とコミュニティ名を受け付けるのは、github.com/anthropics/ のリポジトリを出所とするマーケットプレイスだけです。公式名の例として claude-plugins-official と claude-code-plugins が挙がっています。これらの名前を自分のマーケットプレイスに付けても公式扱いにはならない、と読めます。

公開する側への注意は plugin-marketplaces ページにあります。

give the marketplace a top-level name that other authors are unlikely to pick, because a user can't have two marketplaces with the same name

（出典 [8]）

（訳：マーケットプレイスには、他の作者が選びにくいトップレベルの名前を付けてください。ユーザーは同じ名前のマーケットプレイスを 2 つ持てないためです。）

名前が衝突すると利用者側で併用できなくなります。汎用的な名前は避け、プッシュ前に名前を決め直すのが安全です。

Skills のシェルコマンド注入で実行されなかった場合

skills と slash-commands の 2 ページには、同じ追加文が載っていました。目次には、動的コンテキストの注入（Inject dynamic context）の下に、注入コマンドの実行方法、失敗したとき、シェルコマンドが実行されなかったとき、権限チェックの各見出しが並んでいます。

means one of its shell commands contains a character the tool doesn't accept

（出典 [6]）

（訳：（実行されなかったという表示は）そのスキル内のシェルコマンドのいずれかに、ツールが受け付けない文字が含まれていることを意味します。）

「No shell command in was run」という表示が出たときは、スキル本文中のコマンドに受け付けられない文字がないかを確認する流れです。トラブルシュートの見出しには、スキルの説明文に山括弧を書くと < と > で表示される件や、説明文が途中で切れる件も含まれています。

Agent SDK：権限、フック、コストの前提

Agent SDK のページでは、概念の定義と注意書きが追加されています。

overview：エージェントを、自分で手順を計画し、ファイルの読み取り・コマンド実行・コード編集を行うツールを呼んでタスクを完了するアプリケーションと定義しています。
permissions：ツールが要求されたとき、SDK は決まった順序で権限を確認します。最初の段階はフックの実行です。
hooks：ツール呼び出し前（PreToolUse）、ツール結果の返却後（PostToolUse）、サブエージェントの開始・停止などのイベントで、コールバック関数を実行できます。
subagents：メインエージェントが生成できる別のエージェントインスタンスです。作り方の一つは query() のオプションの agents パラメータで、もう一つは .claude/agents/ のマークダウンファイルです。
structured-outputs：JSON Schema、Zod、Pydantic で検証済みの JSON を返す手順が説明されています。

コスト追跡のページには、数値の信頼度に関する注意が加わりました。

fields are client-side estimates, not authoritative billing data

（出典 [18]）

（訳：（total_cost_usd と costUSD の）各フィールドはクライアント側の見積もりであり、請求の根拠となるデータではありません。）

対象は total_cost_usd と costUSD です。SDK の値を社内の課金按分に使っている場合は、請求データとの突き合わせが前提になります。同じページは、並列のツール使用や複数ステップの会話でのコスト報告の見方も扱っています。

api_request イベントのキャッシュ書き込みと整数コスト

monitoring-usage ページの claude_code.api_request イベントの属性一覧に、コストとキャッシュに関する項目が見えます。

cost_usd_micros : Estimated cost in millionths of a US dollar, emitted as an integer

（出典 [12]）

（訳：cost_usd_micros：推定コストを米ドルの 100 万分の 1 単位で、整数として出力します。）

小数の cost_usd と並んで、整数の cost_usd_micros があります。集計時に浮動小数点の丸めを避けたい場合の選択肢です。キャッシュ書き込みは cache_creation_5m_tokens と cache_creation_1h_tokens で、5 分と 1 時間の保持期間別に報告されます。API レスポンスが報告しない場合はどちらも 0 になり、cache_creation_tokens が 0 より大きくてもこの扱いです。「Requires Claude Code v2.1.300 or later」という条件も載っています（2026-10-29 時点）。記載の位置からはこの 2 項目の条件とみられますが、追加文だけでは断定できません。

状態を保持し、戻す仕組みの説明

セッションをまたぐ状態の扱いに関する追加もありました。

checkpointing ページには、保持件数の記載があります。

Claude Code keeps file snapshots for the 100 most recent checkpoints in a session.

（出典 [22]）

（訳：Claude Code は、セッション内の直近 100 件のチェックポイントについてファイルのスナップショットを保持します。）

2026-10-29 時点では、ターンを開始するプロンプトごとにチェックポイントが 1 件作られ、保持されるのは直近 100 件です。長いセッションで古い時点まで戻したい場合は、この上限を意識する必要があります。

worktrees ページでは、--worktree に渡した名前の worktree がすでにあると、新規作成せずにそれを開くと説明されています。memory ページは、各セッションが新しいコンテキストウィンドウで始まり、セッションをまたぐ仕組みが 2 つあるという整理から始まっています。scheduled-tasks ページは、セッション単位の定期実行が、セッション内で一定間隔でプロンプトを再実行するものだと説明しています。

フックの実行環境と設定の優先順位

hooks ページには、同じフックイベントが、ターミナル、IDE 拡張、Desktop アプリ、クラウドセッションのどこで動かしても発火すると書かれています。フックはシェルコマンド、HTTP エンドポイント、MCP ツール呼び出し、LLM プロンプト、サブエージェントのいずれかで定義できます。

settings ページには、設定の優先順位の図とその説明が追加されています。高い順に、マネージド設定、コマンドライン（claude --settings）、プロジェクトローカル（.claude/settings.local.json）、共有プロジェクト（.claude/settings.json）、ユーザー（~/.claude/settings.json）の 5 段階です。

A key set at a higher level overrides the same key set lower down.

（出典 [2]）

（訳：上位のレベルで設定されたキーは、下位で設定された同じキーを上書きします。）

組織管理の設定が最上位なので、フックの設定も同じ順序で上書きされる点に注意が必要です。

その他の更新

output-styles：組み込みスタイルが標準のほかに 4 つあり（2026-10-29 時点）、自作もできると記載されています。
statusline：ステータスラインは組み込みのフッターバッジの上の独立した行に表示され、バッジを置き換えません。スクリプトは stdin で JSON のセッションデータを受け取ります。
sandboxing：組み込みサンドボックスで、シェルコマンドが到達できるファイルとネットワークホストを制限する手順が説明されています。
permission-modes：モードの切り替えは、CLI では Shift+Tab、VS Code ではモードインジケーター、Desktop ではモードセレクターで行います。
cli-reference：claude -r でセッション ID または名前を指定して再開する例があり、claude gateway は Amazon Bedrock などの前段に SSO とポリシーを置く管理者向けと説明されています。
env-vars：Bedrock のストリーミングレスポンスで Content-Type ヘッダーが欠落または空の場合の扱いを止める環境変数 CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT が載っています。
headless：Agent SDK が Claude Code と同じツール、エージェントループ、コンテキスト管理を提供するという説明です。

この日の更新をまとめると

この日の追加は、Claude Code を自動化やチーム運用に組み込んでいる開発者に影響します。サブエージェントやバックグラウンドセッションを止めたい場合は、環境変数ごとに止まる範囲が異なります。プラグインを配布する人は、マーケットプレイス名の衝突と公式名の扱いを公開前に確認する必要があります。Agent SDK でコストを集計している場合は、SDK の値が請求データではなく見積もりである点を前提に運用を組む必要があります。個々の変更の背景や適用開始時期は追加文からは分からないため、実際の設定を変える際は各ページの本文で確認してください。

出典

本稿の引用はすべて一次資料と逐語照合（verify_article 通過）のうえ掲載しています（2026-11-04 検証）。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up