Claude Codeのモデル制御：4日間の混乱とFORCE変数の真実

開発現場において、ツールが突如として「言うことを聞かなくなる」瞬間ほど、エンジニアの精神を削るものはない。8月28日、Claude Code 2.1.251へのアップデートにより、我々が長年頼りにしてきたサブエージェントのモデル固定挙動が、まるでサイレント修正のように書き換えられた。これまでエージェント定義の『model:』指定が優先されていたはずの環境変数が、突如としてすべてを上書きする仕様へと変貌を遂げたのだ。この変更は、特定のタスクに対してコスト効率の良いモデルを割り当て、レビューや探索を最適化していた我々のワークフローに、一種のデッドロックのような停滞をもたらした。

しかし、この混乱は長くは続かなかった。9月1日、2.1.257のリリースとともに、事態は急転する。公式が提示した解は『CLAUDE_CODE_SUBAGENT_MODEL_FORCE』という新たな環境変数だった。わずか4日間という短い期間で、開発チームはフィードバックを汲み取り、強制的なモデル指定という新たなレイヤーを実装したのである。これは単なる巻き戻しではない。既存の優先順位を維持しつつ、それを物理的に飛び越える『オーバーライド権限』を我々に与えたという点で、極めてエンジニアライクな解決策だと言える。我々が直面したのは、単なるバグ修正ではなく、AIエージェントの自律性と、それを制御する人間のガバナンスの間の、非常に繊細な綱引きであった。

今回のアップデートで最も重要なのは、この『FORCE』変数が万能ではないという点だ。実測データに基づけば、この変数は『定義や起動時の指定を無視して強制的にモデルを適用する』という強力な権限を持つ一方で、特定の例外条件を抱えている。特に興味深いのは、サブエージェントの『fork』挙動だ。検証の結果、FORCE=1を立てても、forkはメイン会話のモデルを継承し続ける。これは、forkが会話履歴のキャッシュを共有するというアーキテクチャ上の制約を考えれば、極めて論理的な挙動である。別のモデルに切り替えてしまえば、キャッシュの不整合が発生し、エージェントの文脈理解が崩壊するからだ。

また、model: inheritの扱いについても注意が必要だ。公式ドキュメントの記述を鵜呑みにすると、『スキル側のinherit』と『エージェント定義のinherit』を混同し、痛い目を見る。実測値が示す通り、エージェント定義でinheritを指定していても、FORCE変数が適用されると、その継承関係は容赦なく潰される。以下に、今回の検証で明らかになった8つの条件別挙動を整理する。

この表から読み取れるのは、我々が『固定したい』という意図で記述した設定が、FORCEという強力な力によっていかに容易に上書きされ得るかという現実である。286本中21本のエージェントがこの影響を受けるという事実は、大規模なエージェント構成を組んでいるエンジニアにとって、無視できないメンテナンスコストの増大を意味している。

今回の騒動は、単なるClaude Codeの仕様変更という枠を超え、我々がAIエージェントを『どのように管理すべきか』という本質的な問いを突きつけている。未文書化の環境変数『CLAUDE_CODE_FORK_SUBAGENT』の存在や、モデルの自己申告による検証など、現在のAI開発環境は、まるで黎明期のオープンソースプロジェクトのように、手探りと実測の積み重ねで成り立っている。我々シニアエンジニアは、公式ドキュメントの行間を読み、自らの環境でパケットを追い、挙動をプロファイリングすることでしか、真の制御権を手にすることができない。

明日から我々が取るべき対策は明確だ。まず、現在運用しているエージェント定義の棚卸しを行い、FORCE変数の導入によって意図しないモデルで実行されるリスクがないかを再確認すること。そして、モデルの固定を『定義ファイル』に委ねるのか、それとも『実行環境の変数』で制御するのか、その設計思想をチーム内で統一することだ。AIエージェントが複雑化するほど、設定の優先順位はスパゲッティコードのように絡み合う。あなたは、AIが勝手にモデルを切り替えてコストを浪費するのを許容するのか、それとも、泥臭い環境変数の管理によって、一糸乱れぬ制御を貫くのか。この問いに対する答えこそが、これからのAIネイティブな開発現場における、エンジニアの真の価値となるのではないだろうか。