Claude Code

勘で削っていたAPI代を、一手ずつ測って減らす──Claude Code v2.1.247が『コスト最適化』を対話コマンドにし、Adminの蛇口も開けた

Claude Code v2.1.247 が公開。Claude API の支出を測りながら削る対話コマンド /claude-api cost-optimize を追加し、Admin API 対応と、不具合報告を下書きする SendFeedback ツールも同梱した。

Anthropic は 2026年8月26日、Claude Code の v2.1.247 を公開しました。目玉は、Claude API の支出を対話しながら削る新コマンド /claude-api cost-optimize です。あわせて組織管理向けの Admin API 対応と、不具合が起きたときに Claude が報告文の下書きを作る SendFeedback ツールが加わりました。

エージェントを回し続ける現場では、モデル代がそのまま運用コストになります。今回の更新は「いくら使ったか」を見せる段階から、「どこをどう削るか」を手順化する段階へ一歩進めた内容です。

「測ってから削る」を1コマンドに畳んだ

これまでコスト削減は、料金ダッシュボードを眺めて勘で設定をいじる作業になりがちでした。/claude-api cost-optimize は、既存プロジェクトの Claude API 支出をまず計測し、効きそうな打ち手を一つずつ測りながら適用していく進め方を用意します。

コマンドが扱う主なコスト・レバーは次のとおりです。いずれも「まとめて全部変える」のではなく、一手ごとに効果を確かめる前提で並んでいます。

キャッシュ活用：繰り返し送る前提の文脈をプロンプトキャッシュに載せ、再送分の課金を抑える。
トークン衛生：不要に長い文脈や重複した指示を削り、入力トークンそのものを減らす。
バッチ処理：即時性が要らない処理をまとめて流し、割安な経路に寄せる。
推論の強度（effort）：タスクの難度に応じて思考量の目盛りを下げ、過剰な計算を避ける。
モデル選択：軽い作業は下位モデルへ、重い判断だけ上位モデルへと振り分ける。

どれも個別には知られた手ですが、「現状を測る→一つ変える→差分を見る」という順番をコマンド側が主導する点が新しいところです。

組織の「蛇口」も同じスキルから触れる

今回、/claude-api スキルは Admin API までカバー範囲を広げました。個人の使い方だけでなく、組織全体の運用を同じ場所から扱えるようにした形です。対象には次のような管理項目が含まれます。

組織メンバーと招待の管理
ワークスペースと API キーの管理
レート制限のレポート取得
ワークロード ID フェデレーション、CMEK（顧客管理鍵）

チームで多数のエージェントを走らせるほど、誰がどの鍵でどれだけ使うかの把握が難しくなります。支出の可視化と組織管理を一つのスキルに寄せたことで、コスト最適化と統制を地続きに扱えるようになりました。

「AIが下書きし、人が送る」をもう一つ増やした

新しい SendFeedback ツールは、セッション中に不具合が起きたとき、Claude が不具合報告の下書きを作る機能です。あくまで下書きで、内容を確認して /feedback から送るかどうかは利用者が決めます（feedbackDrafts 設定で無効化も可能）。

この「AI が用意し、送信は人が握る」という設計は、Claude Code が承認や自動化まわりで繰り返し採ってきた方針と同じ線上にあります。自動化を進めても、外に出る一手には人の確認を残す考え方です。

無人で回すエージェントの「黙って膨らむ」を塞いだ

コスト最適化と対になるのが、暴走を止める信頼性の修正です。v2.1.247 には、無人運用でコストや安定性に効く不具合修正が含まれます。代表的なものは次の三つです。

サブエージェントが最初のモデル呼び出しで 404 を受けても即死せず、セッションのフォールバックモデル連鎖を使うようになった。
フックやバックグラウンドエージェントが数メガバイト級のエラーを吐いて会話を溢れさせ、「Prompt is too long」でセッションを固める問題を修正。
出力ファイルを書けないフックやタスクでメモリが際限なく増える問題を修正し、どこで出力が失われたかを残すようにした。

いずれも、放っておくと無駄なトークン消費や停止につながる箇所です。支出を削るコマンドと、支出が勝手に膨らむ経路を塞ぐ修正が、同じリリースに同居した形になります。

それでも「測る手間」は残る

便利さの裏で、留意しておきたい点もあります。/claude-api cost-optimize は最適化を自動で完結させる魔法ではなく、計測と一手ずつの検証を前提にした道具です。効果を見極める作業自体は運用側に残ります。

また、Admin API を同じスキルから触れるということは、鍵やメンバー管理といった重い操作にエージェント経由で近づくということでもあります。権限設定を緩めたまま自動化を広げれば、統制のつもりが逆に穴になりかねない、という指摘も成り立ちます。導入時は、便利さと同じ重さで権限の範囲を見直しておくのが無難でしょう。