メインコンテンツへスキップ
nefs — portfolio

【EvenG2】Terminal ModeがOpus固定だったのはなぜ?直した話

Terminal Modeは、気づかないうちにOpusで固定されたまま動いていた。普段の作業はSonnetで行っているにもかかわらず、なぜかOpusが強制的に呼ばれている状態になっていた。

今回は、気づいた経緯と、当初見誤っていた原因、実機到着後にわかった本当の直し方を振り返る。

この記事でわかること

  • Terminal Modeが気づかないうちにOpusで固定されたまま動いていた実情(2026年9月時点の検証)
  • 実機到着前はハードコードで上書き不可と誤って判断していた経緯
  • 実機到着後に環境変数EVEN_TERMINAL_MODELで上書きできると判明した経緯
  • 同じ状況の人へのコスト面の示唆

実はOpusに固定されたまま動いていた

本来使っていないはずのモデルが、裏側でずっと動いていた。 普段の作業はSonnetで行っているなかで、なぜかOpusが強制的に呼ばれている状態に気づいた。次の章で、その経緯を振り返る。

Opus固定に気づくまでの経緯を示す図解

気づいた直後は原因を見誤っていた

気づいてすぐの段階では、原因の見立てを外していた。見誤った経緯は大きく2つある。

原因を見誤った2つの経緯を示す図解

レビュー中に強制的なOpus起動に気づいた

最初にレビューをしている最中に、強制的なOpus起動に気づいた。普段の作業はSonnetを使っているため、ログを見返すとOpusが直接指定されて呼ばれている状態になっていた。

実機到着前はハードコードで上書き不可と判断していた

この時点では、変更する手立てが無いと考えていた。当時のソースコード確認では、モデル名が直接埋め込まれているように見え、環境変数や設定ファイルからの上書きはできないと判断していた。

実機到着後にわかった本当の直し方

実機を手にしてから、正しい対処法が見つかった。わかったことは2つある。

実機到着後にわかった本当の直し方を示す図解

環境変数EVEN_TERMINAL_MODELで上書きできると判明した

実際には、環境変数EVEN_TERMINAL_MODELでモデルを上書きできることがわかった。 現物のソースコードを改めて確認したところ、指定が無い場合だけ既定のモデルが使われる仕組みになっていた。以前の「上書き不可」という判断は誤りだったと判明した。

launchd plistの設定でSonnet 5に固定した

この環境変数をlaunchd plistの設定に加えて、Sonnet 5に固定した。常駐設定ファイルの環境変数にモデル名を指定することで、以降は毎回Sonnet 5で起動するようになった。

同じ状況の人へのコスト面の示唆

同じ状況になっている人は、コスト面を見直す価値がある。 Opusは利用コストが高いモデルのため、気づかないままOpusで動かし続けていると、想定より費用がかさんでいる可能性がある。

同じように環境変数の存在に気づいていない人は、一度設定を確認しておいたほうがいい。

一度出した結論でも間違いに気づけば訂正する

過去の判断を絶対視せず、新しい事実が分かれば訂正する。 最初に出した結論であっても、根拠が古くなっていないか定期的に確認し、違っていればその場で直す。

判断を見直して直す姿勢をTerminal Modeの設定と業務の仕組みづくりに共通する考え方として示す図解

気づいたときにすぐ見直して直す姿勢は、ビジネスにも活きる。MOCO Worksのサービスでもこの姿勢を大切にしている。

参考・出典情報

(本記事は一次情報(インタビュー・社内技術ドキュメントによる裏取り)起点のため、外部出典なし)