claude --model はチーム共有のsettings.jsonに勝つか？ v2.1.248で検証

チーム共有の.claude/settings.jsonに「model: sonnet」と固定コミットされているリポジトリで、一時的に別のモデルを試したいとき、claude --model opusコマンドだけで本当に切り替わるのか。それとも設定ファイルの値が静かに優先されて、気づかないままsonnetで作業し続けるのか。Claude Code 2.1.248で検証した結果、--model opusフラグが.claude/settings.jsonの「model: sonnet」に勝ち、実際にopusでセッションが開始した。これは公式ドキュメントが示す優先順位通りの挙動だ。ただし過去バージョンでは逆の現象が報告されており、バージョン依存で挙動が変わる可能性はある。

チーム設定ファイルとCLIフラグの優先順位問題は、通常のソフトウェアツールではあまり深刻ではない。だがAIツールのような「人によって使い方や試し方が大きく異なるツール」では、この問題は実務的に重要だ。ドキュメントには「こうなるはず」と書かれているが、実装がそれに従っているか確認していない開発者は多い。自分の手元で確認してから本番環境で試すという態度が大事である。

中小企業が生成AIを導入するときも同じだ。ツールベンダーのドキュメントや使用例を信頼しすぎず、自分たちの環境で実際に動くか確認してから本運用に移す必要がある。特にチーム設定が何かに固定されているなら、自分が試したいことができるか、設定ファイルが邪魔にならないか、事前に検証する習慣をつけておく。ドキュメントと実装のズレは、思わぬところで作業を阻害する。