『黙って壊れる』を、起動時に落とす──Claude Code v2.1.225が無人で回すエージェントのヘッドレス障害と“使いすぎ”に線を引いた
8月8日のClaude Code v2.1.225は、失効トークンによる401やmacOSの認証崩れなど、無人・ヘッドレスで回すと『黙って壊れる』障害を集中的に修正しました。ゲートウェイの支出上限表示も加わった今回の更新を、運用の目線で整理します。
人が張り付いていないエージェントの怖さは、止まることではなく「黙って壊れる」ことにあります。トークンが静かに失効し、認証が通らなくなり、再起動するまで空回りする――画面を見ていれば一目でわかる不具合が、無人だと気づかれないまま時間とお金だけを溶かします。2026年8月8日に公開された Claude Code v2.1.225 は、まさにこの「静かな失敗」に集中して手を入れたリリースでした。同日には追撃の修正版 v2.1.226 も出ています。今回はこの更新を、無人・ヘッドレスで回す運用の目線で整理します。
ヘッドレスで詰まっていた6つの穴
v2.1.225 の修正は、人がいない環境でこそ効くものが並びます。主なものを挙げます。
- 失効トークンによる401障害: 長命の
CLAUDE_CODE_OAUTH_TOKENが、保存済みログインの短命トークンに置き換わり、ヘッドレスセッションが再起動まで壊れていた不具合を修正。 - macOSのMCP認証崩れ: keychain の読み取りがタイムアウトした後、MCP の OAuth サーバが「一度も認証していない」かのように401を連発する問題を解消。
- 自動モードの誤カウント: auto モードが、自分の権限チェックに対する安全フィルタの拒否を「連続ブロック」の上限に数えていた。動作は拒否のまま、モデルには再試行させず「先へ進め」と伝えるよう変更。
- 宙づりのセッション間メッセージ: ヘッドレスや起動時に、セッション間メッセージが通知も期限もなく滞留していたのを修正。
- self-hosted runner の沈黙した失敗:
--base-dirを作成・書き込みできないとき、登録だけ済ませて毎セッション失敗していたのを、起動時に明確なエラーで落とすよう変更。 - Web版セッションの誤報告: Claude Code on the web のセッションが「詰まった」と誤報告され、再接続のたびに膨らんだイベントの山を再送していた問題を解消。
共通しているのは、いずれも「エラーが表に出ず、再起動や人手の介入まで気づけない」種類の障害だという点です。対話で使う分には運が悪ければ一度きりの引っかかりですが、cronやCIで回し続ける運用では、こうした沈黙が積み重なって静かに稼働を止めます。
『使いっぱなし』に上限を見せる
同じリリースには、コストと信頼境界に関わる2つの追加があります。無人運用は速く回る反面、止め忘れると請求だけが伸びる――その歯止めです。
| 追加点 | 内容 |
|---|---|
| ゲートウェイの上限表示 | 使用警告がゲートウェイの支出上限に対応。上限に達したときのメッセージが、上限額・リセット時刻・運用者からのメッセージを明示する（ゲートウェイ側も 2.1.225 が必要）。 |
| 作業場の信頼確認 | claude agents が、信頼されていないディレクトリで作業場の信頼プロンプトを出すようになり、対話版の claude と挙動を揃えた。 |
とりわけ支出上限の表示は、これまで「なぜ止まったのか」が判然としなかった場面を、上限額とリセット時刻という具体で説明できるようにします。組織としてエージェントに予算の網をかけたいとき、止まった理由が運用者に伝わることは監査の観点でも意味を持ちます。
前日の一手を、翌日に締め直す
この修正群は、前日 8月7日の v2.1.224 と地続きです。v2.1.224 は、自分のマシンやコンテナを Claude Code のWeb・モバイル・デスクトップの実行先にできる claude self-hosted-runner（Team/Enterprise向け）を投入した回でした。コードを社内に置いたまま頭脳だけを呼ぶ、という無人運用の土台です。翌日の v2.1.225 が、その self-hosted runner が置き場所を作れないときに沈黙して失敗する穴をふさいだ――新機能を出し、翌日その運用上のほころびを締め直す、という流れが見て取れます。
現場にとっての意味と、留保
チームにとっての含意はシンプルです。無人でエージェントを回す土台が整うほど、勝負どころは「賢さ」より「静かに壊れないこと」に移ります。今回の修正は派手さこそありませんが、ヘッドレス運用の信頼性を一段引き上げる実務的な更新です。cronやCIでClaude Codeを走らせているなら、更新の価値は高いといえます。
一方で、これだけの「沈黙した失敗」が一度に修正されたという事実は、裏を返せば無人エージェントが抱える運用監視の面積の大きさを映してもいます。人の目が届かない実行は速く安く回る半面、失敗が見えにくく、コストも権限も静かに広がりがちです。だからこそ、支出上限や信頼プロンプトのように「止める・確かめる」仕組みを併せて敷くことが欠かせません。便利さの手綱を運用側が握っておく――そうした前提で導入するのが妥当でしょう。なお同日の v2.1.226 は「バグ修正と信頼性向上」とだけ告知された追撃リリースで、この安定化の流れを引き継いでいます。
参照: Claude Code changelog（公式） ／ anthropics/claude-code CHANGELOG.md ／ Claude Code Updates - August 2026（Releasebot） ／ Claude Code Changelog（gradually.ai） ／ Claude Code v2.1.226 — Every Release, Summarized（Havoptic）
