同じリポジトリを、昼はエディタ内のターミナルから、夜は別のシェルから開いています。ある晩、夜のセッションだけが数世代前のモデル名で始まっていることに気づきました。
心当たりを探すと、原因は数か月前の自分でした。モデルを一時的に固定したくて ~/.zshrc に書いた export ANTHROPIC_MODEL=... の一行が、消し忘れたまま残っていたのです。シェル設定に書いたものは画面のどこにも出てきません。開くたびに黙って注入されるので、気づく手がかりが「なんとなく応答の手触りが違う」しかありませんでした。
v2.1.236 で ANTHROPIC_DEFAULT_MODEL が追加されたと知ったとき、最初は「これに置き換えれば解決する」と考えました。実際には違いました。しかも後になって、もう一つの落とし穴——/model で選んだ瞬間に、この新しい変数そのものが使われなくなる仕組み——にも足を取られています。この記事は、その二つを順に書き残したものです。
最初にお伝えしたいこと:ANTHROPIC_DEFAULT_MODEL は五段のいちばん下です
公式の Model configuration(2026年11月時点で確認)には、モデルを決める指定が強い順に五つ並んでいます。
- セッション中の
/model - 起動時の
claude --model - 環境変数
ANTHROPIC_MODEL - 設定ファイルの
model - 環境変数
ANTHROPIC_DEFAULT_MODEL
新しい変数は最下位です。公式の説明では、--model・ANTHROPIC_MODEL・どの設定ファイルの model・組織の既定モデルのいずれも決めていないときにだけ、新規セッションをこの変数のモデルで始めます。
見落としやすいのは4番目です。/model のピッカーで Enter を押すと、その選択は ~/.claude/settings.json の model に書き込まれます。つまり一度でも Enter で選べば、ユーザー設定に model が生まれ、ANTHROPIC_DEFAULT_MODEL は次の起動から参照されなくなるのです。
二つの環境変数は、置き換えの関係にありません
ANTHROPIC_MODEL は「起動のたびにこの値へ戻す」指定です。セッションの途中で /model を使えば切り替えはできますが、次に起動したときには、/model で保存したものに関係なくこの変数の値で始まります。一方の ANTHROPIC_DEFAULT_MODEL は「ほかに何も決まっていないときの初期値」です。
前者は動かしても戻ってくる指定、後者は誰かが決めた瞬間に退く指定——性格が正反対なので、新しい変数を足しても古い変数は何も変わりません。
| 指定の場所 | 公式の順位 | 次に起動したとき | 忘れやすさ |
|---|---|---|---|
/model で Enter | 1(その場) | ユーザー設定の model に保存され、4番目として効き続ける | 中(選んだことを忘れる) |
/model のピッカーで s | 1(その場) | このセッションだけ。保存されない | 低い |
claude --model | 2 | そのコマンドで起動したセッションだけ | 低い |
ANTHROPIC_MODEL | 3 | 毎回この値に戻る | 高い(シェル設定に書くと画面に出ない) |
設定ファイルの env に書いた ANTHROPIC_MODEL | 3 と同じ扱い | そのプロジェクトで毎回この値に戻る | 高い(model 欄だけ見ていると気づけない) |
設定ファイルの model | 4(local > project > user) | より近い設定ファイルの値で始まる | 低い(ファイルとして見える) |
ANTHROPIC_DEFAULT_MODEL | 5 | 上のどれもないときだけ効く | 中 |
厄介なのは、効き方が違うものが同じ「モデル名の文字列」として七つの入口に散らばり、そのうち二つが目に入りにくい場所にあることです。私自身、原因を探すあいだ、/status の表示と設定ファイルを何度も往復しました。
よくある誤解を三つ、公式の記述で訂正します
誤解1:新しい変数を足せば古い変数より優先される、という思い込み。 順位は逆です。ANTHROPIC_MODEL が残っている限り、ANTHROPIC_DEFAULT_MODEL は一度も参照されません。新しい変数を導入するときは、足す前に古い変数を消すのが先です。
誤解2:/model で選んだのだから次もそのモデルで始まる、という期待。 ANTHROPIC_MODEL が設定されていると、/model で保存した選択は残ったまま上書きされます。公式も「保存はされているが、順位で負けている」と書いています。プロジェクト設定や managed settings に model がある場合も同じで、そのときは起動時のヘッダーに、どのファイルが決めたかが表示されます。
誤解3:ANTHROPIC_DEFAULT_MODEL=haiku で軽いモデルを初期値にできる、という読み。 公式によると、値が default・inherit・opusplan・haiku のとき、この変数は無視されます。管理者が enforceAvailableModels を有効にしている場合や、組織の制限で除外されたモデルを指した場合も同じです。設定が効いていると、/model ピッカーの Default の行に「Set by ANTHROPIC_DEFAULT_MODEL」と表示されるので、私はこの表示の有無で確かめています。
付け加えると、補助処理用に昔使われていた ANTHROPIC_SMALL_FAST_MODEL は、環境変数一覧で非推奨(DEPRECATED)と明記されています。いまは ANTHROPIC_DEFAULT_HAIKU_MODEL が haiku の解決先とバックグラウンド処理の両方を担います。
症状から逆に辿るための切り分け表
| 症状 | 原因の候補 | 確かめ方 | 直し方 |
|---|---|---|---|
| 新しいシェルでだけ古いモデルで始まる | シェル設定の export ANTHROPIC_MODEL | 新しいシェルで env | grep ANTHROPIC | シェル設定から行を消し、シェルを開き直す |
ANTHROPIC_DEFAULT_MODEL を書いたのに始まるモデルが変わらない | どこかの設定ファイルに model がある(/model の Enter を含む) | /model の Default の行に「Set by ANTHROPIC_DEFAULT_MODEL」が出るか | 設定ファイルの model を消すか、初期値をそちらに書く |
/model で選んでも、次の起動で戻る | ANTHROPIC_MODEL、またはプロジェクト設定・managed settings の model | 起動時のヘッダーに設定ファイル名が出るか、env に変数が残っているか | 固定を外す。プロジェクト設定なら意図どおりか確かめる |
| 起動はするのに、最初の送信で止まる | 固定した ID が退役済み、または打ち間違い | エラー文 There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. | 固定している場所を探し、エイリアスか現行の ID に替える |
| 再開したセッションだけ別のモデルになる | --resume・--continue は保存時のモデルを引き継ぐ | 新規セッションと比べる | 再開時に --model を付ける |
4行目は、公式のエラー一覧にも「誤ったモデルが何度も戻ってくるなら、どこかに古い ID が設定されている」と書かれています。起動の時点では弾かれず、最初のリクエストで初めて止まるので、原因と症状の距離がいちばん遠い行です。
いま何がモデルを決めているかを一覧する
必要だったのは、どれが勝つかを推測する前に、そもそも何が設定されているかを一画面で見ることでした。環境変数・三つの設定ファイル・シェル設定を横断して拾い、公式の順位に「強さ」の番号を振って並べる小さなスクリプトを書きました。前の版は「固定」と「初期値」の二択でしか分けていなかったため、設定ファイルの model が ANTHROPIC_DEFAULT_MODEL に勝つことを表せていませんでした。そこを直したのがこの版です。
#!/usr/bin/env python3
"""Claude Code の起動時モデルを決めうる指定を一覧し、勝つ指定と退役 ID を報告する。
使い方:
python3 model_sources.py [プロジェクトのルート]
優先順位は公式の Model configuration(2026年11月確認)に合わせている:
/model(セッション中) > --model > ANTHROPIC_MODEL > 設定ファイルの model > ANTHROPIC_DEFAULT_MODEL
--model・組織の既定モデル・managed settings はこのスクリプトからは見えない。
"""
import datetime
import json
import os
import re
import sys
import unicodedata
HOME = os.environ.get("MODEL_SOURCES_HOME") or os.path.expanduser("~")
TODAY = datetime.date.fromisoformat(
os.environ.get("MODEL_SOURCES_TODAY") or datetime.date.today().isoformat()
)
# 公式のモデル退役表のうち、手元の設定に残りやすいもの(2026年11月時点)
RETIREMENTS = {
"claude-sonnet-4-5-20250929": "2026-11-30",
"claude-sonnet-4-5": "2026-11-30",
"claude-opus-4-1-20250805": "2026-08-05",
}
# この値を ANTHROPIC_DEFAULT_MODEL に入れても、Claude Code は無視する
IGNORED_DEFAULTS = {"default", "inherit", "opusplan", "haiku"}
# 数字が小さいほど強い。設定ファイルは local > project > user
RANK = {"pin": 1, "local": 2, "project": 3, "user": 4, "default": 5}
SETTINGS_FILES = [
("user", "ユーザー設定", os.path.join(HOME, ".claude", "settings.json")),
("project", "プロジェクト設定", os.path.join("{root}", ".claude", "settings.json")),
("local", "ローカル設定", os.path.join("{root}", ".claude", "settings.local.json")),
]
PROFILES = [".zshrc", ".zshenv", ".zprofile", ".bashrc", ".bash_profile", ".profile"]
SHELL_LINE = re.compile(r"(ANTHROPIC_(?:DEFAULT_)?MODEL)=[\"']?([^\"'\s#]+)")
JSONC_COMMENT = re.compile(r"^\s*//")
def load_jsonc(path):
"""// 行コメントを許容して読む。壊れていても落とさず、理由を返す。"""
try:
with open(path, encoding="utf-8") as fh:
body = "".join(l for l in fh if not JSONC_COMMENT.match(l))
return json.loads(body), None
except FileNotFoundError:
return None, None
except (json.JSONDecodeError, OSError) as exc:
return None, f"読み取り失敗: {exc}"
def retirement(value):
"""退役日が決まっている ID なら (日付, 残り日数) を返す。"""
day = RETIREMENTS.get(value.replace("[1m]", ""))
if not day:
return None
return day, (datetime.date.fromisoformat(day) - TODAY).days
def collect(root):
rows = [] # (区分, 場所, 値, 強さ or None, 補足)
if os.environ.get("ANTHROPIC_MODEL"):
rows.append(("環境変数", "ANTHROPIC_MODEL", os.environ["ANTHROPIC_MODEL"], RANK["pin"],
"起動のたびにこの値へ戻る"))
if os.environ.get("ANTHROPIC_DEFAULT_MODEL"):
rows.append(("環境変数", "ANTHROPIC_DEFAULT_MODEL", os.environ["ANTHROPIC_DEFAULT_MODEL"],
RANK["default"], "どの設定ファイルにも model がないときだけ効く"))
if os.environ.get("ANTHROPIC_SMALL_FAST_MODEL"):
rows.append(("環境変数", "ANTHROPIC_SMALL_FAST_MODEL", os.environ["ANTHROPIC_SMALL_FAST_MODEL"],
None, "非推奨。ANTHROPIC_DEFAULT_HAIKU_MODEL へ移す"))
for level, label, template in SETTINGS_FILES:
path = template.format(root=root)
data, error = load_jsonc(path)
if error:
# 壊れた JSON を黙って飛ばすと「書いたのに効かない」の原因を見失う
rows.append((label, path, "-", None, error))
continue
if not data:
continue
if data.get("model"):
rows.append((label, path, data["model"], RANK[level], "設定ファイルの model"))
env = data.get("env") or {}
if env.get("ANTHROPIC_MODEL"):
rows.append((label, path, env["ANTHROPIC_MODEL"], RANK["pin"],
"env ブロックが ANTHROPIC_MODEL を注入"))
if env.get("ANTHROPIC_DEFAULT_MODEL"):
rows.append((label, path, env["ANTHROPIC_DEFAULT_MODEL"], RANK["default"],
"env ブロックが ANTHROPIC_DEFAULT_MODEL を注入"))
for name in PROFILES:
path = os.path.join(HOME, name)
try:
with open(path, encoding="utf-8") as fh:
lines = fh.readlines()
except OSError:
continue
for lineno, line in enumerate(lines, 1):
match = SHELL_LINE.search(line)
if match and not line.lstrip().startswith("#"):
rows.append(("シェル設定", f"{path}:{lineno}", match.group(2), None,
f"{match.group(1)} を新しいシェルのたびに書き出す"))
return rows
def width(text):
return sum(2 if unicodedata.east_asian_width(ch) in "WF" else 1 for ch in text)
def pad(text, size):
return text + " " * max(0, size - width(text))
def main():
root = sys.argv[1] if len(sys.argv) > 1 else os.getcwd()
rows = collect(root)
if not rows:
print("モデルを決めている指定は見つかりませんでした(アカウントの既定に従います)")
return 0
size = max(width(r[0]) for r in rows)
for origin, where, value, rank, note in rows:
print(f"{pad(origin, size)} 強さ {rank or '-'} {value}")
print(f"{' ' * size} └ {where} — {note}")
warnings = []
live = [r for r in rows if r[3] is not None]
for r in live:
if r[3] == RANK["default"] and r[2] in IGNORED_DEFAULTS:
warnings.append(f"ANTHROPIC_DEFAULT_MODEL={r[2]} は無視されます")
live = [r for r in live if not (r[3] == RANK["default"] and r[2] in IGNORED_DEFAULTS)]
pins = sorted({r[2] for r in live if r[3] == RANK["pin"]})
if len(pins) > 1:
warnings.append(f"ANTHROPIC_MODEL が {len(pins)} 種類の値で書かれています: {', '.join(pins)}")
for r in rows:
hit = retirement(r[2])
if hit:
day, left = hit
state = "退役済み" if left <= 0 else f"退役まであと {left} 日"
warnings.append(f"{r[2]} は {day} 退役({state}): {r[1]}")
print()
if live:
winner = min(live, key=lambda r: r[3])
tied = sorted({r[2] for r in live if r[3] == winner[3]})
if len(tied) > 1:
# 同じ強さどうしの勝敗は公式に書かれていないので、推測で一つに決めない
print(f"→ 強さ {winner[3]} に {len(tied)} つの値があり、どれが勝つかは /status で確かめてください")
else:
print(f"→ 起動時に勝つ指定: {winner[2]}({winner[1]})")
losers = sorted({r[2] for r in live if r[3] > winner[3]} - set(tied))
if losers:
print(f" 参照されない指定: {', '.join(losers)}")
for w in warnings:
print(f"⚠ {w}")
return 1 if warnings else 0
if __name__ == "__main__":
sys.exit(main())意図してそうした点が四つあります。
一つ目は、設定ファイルの env の中まで見ていることです。model 欄だけを確認して「プロジェクト設定は関係ない」と判断すると、いちばん見つけにくい固定を見落とします。
二つ目は、壊れた JSON を握りつぶさず、行として出していることです。構文エラーで読み飛ばされた設定は「書いたのに効かない」という症状になります。原因と症状が離れているので、ここは沈黙させたくありませんでした。
三つ目は、同じ強さに値が二つあるとき、勝者を一つに決めないことです。シェルで export した ANTHROPIC_MODEL と、設定ファイルの env に書いた ANTHROPIC_MODEL のどちらが勝つのかは、公式の記述から読み取れず、私も確認できていません。推測で一つに決めて表示すると、スクリプト自体が新しい誤解の出どころになります。
四つ目は、退役日の決まった ID を警告することです。表は公式のモデル退役一覧から、手元の設定に残りやすいものだけを写しています。新しい退役が告知されたら、この辞書に一行足して使います。
手元で走らせた結果
私の設定を模した一式に対して、日付を 2026年11月19日に固定して実行した出力です。
環境変数 強さ 1 claude-sonnet-4-5-20250929
└ ANTHROPIC_MODEL — 起動のたびにこの値へ戻る
環境変数 強さ 5 claude-sonnet-5-5
└ ANTHROPIC_DEFAULT_MODEL — どの設定ファイルにも model がないときだけ効く
ユーザー設定 強さ 4 claude-opus-5
└ /home/me/.claude/settings.json — 設定ファイルの model
プロジェクト設定 強さ 3 claude-opus-5
└ /work/proj/.claude/settings.json — 設定ファイルの model
プロジェクト設定 強さ 1 claude-opus-5
└ /work/proj/.claude/settings.json — env ブロックが ANTHROPIC_MODEL を注入
ローカル設定 強さ 2 claude-haiku-4-5-20251001
└ /work/proj/.claude/settings.local.json — 設定ファイルの model
シェル設定 強さ - claude-sonnet-4-5-20250929
└ /home/me/.zshrc:2 — ANTHROPIC_MODEL を新しいシェルのたびに書き出す
シェル設定 強さ - claude-sonnet-5-5
└ /home/me/.bash_profile:1 — ANTHROPIC_DEFAULT_MODEL を新しいシェルのたびに書き出す
→ 強さ 1 に 2 つの値があり、どれが勝つかは /status で確かめてください
参照されない指定: claude-haiku-4-5-20251001, claude-sonnet-5-5
⚠ ANTHROPIC_MODEL が 2 種類の値で書かれています: claude-opus-5, claude-sonnet-4-5-20250929
⚠ claude-sonnet-4-5-20250929 は 2026-11-30 退役(退役まであと 11 日): ANTHROPIC_MODEL
⚠ claude-sonnet-4-5-20250929 は 2026-11-30 退役(退役まであと 11 日): /home/me/.zshrc:2読み方は単純です。始まるモデルを決めうる指定が六つあり、そのうちローカル設定の Haiku と ANTHROPIC_DEFAULT_MODEL の Sonnet 5.5 は、書いた本人が効いているつもりのまま一度も参照されていません。ユーザー設定とプロジェクト設定の model も、たまたま固定と同じ Opus 5 を指しているので目立たないだけで、順位では負けています。しかも勝つ側の一つは、11日後に退役する ID でした。警告が出ているので終了コードは 1 です。
シェル設定から ANTHROPIC_MODEL を消し、プロジェクト設定の env からも外すと、出力はこう変わります。
環境変数 強さ 5 claude-sonnet-5-5
└ ANTHROPIC_DEFAULT_MODEL — どの設定ファイルにも model がないときだけ効く
ユーザー設定 強さ 4 claude-opus-5
└ /home/me/.claude/settings.json — 設定ファイルの model
プロジェクト設定 強さ 3 claude-opus-5
└ /work/proj/.claude/settings.json — 設定ファイルの model
ローカル設定 強さ 2 claude-haiku-4-5-20251001
└ /work/proj/.claude/settings.local.json — 設定ファイルの model
シェル設定 強さ - claude-sonnet-5-5
└ /home/me/.bash_profile:1 — ANTHROPIC_DEFAULT_MODEL を新しいシェルのたびに書き出す
→ 起動時に勝つ指定: claude-haiku-4-5-20251001(/work/proj/.claude/settings.local.json)
参照されない指定: claude-opus-5, claude-sonnet-5-5固定が消えても、ANTHROPIC_DEFAULT_MODEL はまだ使われていません。勝ったのはローカル設定の model でした。ここが冒頭でお伝えした4番目の落とし穴で、私が二度目に足を取られた場所です。三つの設定ファイルから model を外して、ようやく新しい変数が表に出ます。
環境変数 強さ 5 claude-sonnet-5-5
└ ANTHROPIC_DEFAULT_MODEL — どの設定ファイルにも model がないときだけ効く
シェル設定 強さ - claude-sonnet-5-5
└ /home/me/.bash_profile:1 — ANTHROPIC_DEFAULT_MODEL を新しいシェルのたびに書き出す
→ 起動時に勝つ指定: claude-sonnet-5-5(ANTHROPIC_DEFAULT_MODEL)なお、このスクリプトが答えるのは「何が設定されているか」と「公式の順位ならどれが勝つか」までです。--model、組織の既定モデル、managed settings は見えません。最終的には claude を起動して /status で確かめるのが確実で、一覧と実測は分けておいたほうが安全だと考えています。
11月30日の退役と、残っている固定
公式のモデル退役一覧では、claude-sonnet-4-5-20250929 の退役日は 2026年11月30日、置き換え先は claude-sonnet-5-5 です(2026年11月時点で確認)。同じ一覧に、日付のない claude-sonnet-4-5 もこの退役に含まれると書かれています。
この日付を過ぎると、ANTHROPIC_MODEL や設定ファイルにこの ID を固定したままの環境は、起動はしても最初の送信で止まります。公式は、退役日が決まっているモデルを指定したときに起動時の警告を出すとも書いていますが、無人で走らせるジョブでは誰もその警告を読みません。
固定のかわりに sonnet や opus のようなエイリアスを使えば、こうした取り残しは起きにくくなります。日付なしの ID がなぜ同じ期限に含まれるのかは、日付なしで書いた claude-sonnet-4-5 は、11 月 30 日の退役から外れるのでしょうか で詳しく書きました。
私の設定をどこに落ち着かせたか
個人開発で iOS と Android のアプリを並行して触っていると、リポジトリごとに求めるモデルが違ってきます。既存コードの読み解きが中心のプロジェクトと、まっさらな画面をゼロから組むプロジェクトでは、同じモデルが最適とは限りません。
最初のうち、私は ANTHROPIC_DEFAULT_MODEL を常用の初期値にし、その日の作業に合わせて /model で動かすつもりでした。結果は芳しくありませんでした。/model で Enter を押した翌日から、初期値は黙って負け続けていたのです。気づいたのは、スクリプトを直して強さの番号を振った後でした。
いまは、次の線引きにしています。
- シェル設定からは、モデル指定を完全に消します。 見えない場所で効くものを一つも残さないことが最優先でした
- 自分の常用モデルは
/modelの Enter で保存します。 ユーザー設定のmodelに残るので、ファイルとして見えます - プロジェクトごとの違いは
.claude/settings.jsonのmodelに書きます。 半年後の自分にも見える場所です ANTHROPIC_DEFAULT_MODELは、設定ファイルが一つもない環境でだけ使います。 作り直したばかりのコンテナや、ホームを持たない一時的な実行環境が該当します- 固定したい場面は、そのコマンドに閉じ込めます。
claude --model sonnet -p "..."の形にするか、ピッカーでsを押してこのセッションだけ切り替えます
固定はコマンドに、初期値はファイルに。 固定は必要な道具ですが、寿命を長くした瞬間に「忘れられる設定」に変わります。プロファイルに書かずに実行するコマンドへ添えるだけで、後から原因を追う必要はほとんどなくなりました。
変更したあとに確かめる三つのこと
まず、新しいシェルを開いて env | grep ANTHROPIC を実行します。編集中のシェルには古い値が残っているので、必ず開き直してから確認します。
次に、claude を起動して /status で実行中のモデルを見ます。ANTHROPIC_DEFAULT_MODEL を使う環境なら、/model の Default の行に「Set by ANTHROPIC_DEFAULT_MODEL」が出ているかも見ておきます。一覧と実測が一致していれば、その設定は理解どおりに効いています。
最後に、スクリプトを終了コードごと使う場所に置きます。私は無人で走らせるジョブの前処理に入れ、警告が一つでも出たらジョブを止めるようにしました。切り替えそのものを記録に残したい場合は モデル切り替えの記録と歯止めを、フック2本で作る を、設定ファイルのキー名の打ち間違いが心配な場合は settings.json のキー名を1文字間違えても、Claude Code は何も言わずに無視します をあわせてご覧ください。
今日できる最初の一歩としては、grep -rn 'ANTHROPIC_MODEL\|ANTHROPIC_DEFAULT_MODEL\|sonnet-4-5' ~/.zshrc ~/.zprofile ~/.bashrc ~/.bash_profile ~/.profile ~/.claude/settings.json を一度走らせていただければと思います。何も出なければ、少なくとも見えない固定はありません。何か出てきたら、それがいま実際にモデルを決めているかもしれない一行です。