移行ガイド

Claude 4.6への移行

Claude Opus 4.6はClaude 4.5のほぼドロップイン置き換えですが、いくつかの破壊的変更に注意する必要があります。新機能の完全なリストについては、Claude 4.6の新機能をご覧ください。

モデル名を更新する

# Opusの移行
model="claude-opus-4-5"     # 変更前
model="claude-opus-4-6"       # 変更後

破壊的変更

プリフィルの削除: Claude 4.6モデルでは、アシスタントメッセージのプリフィルは400エラーを返します。代わりに構造化出力、システムプロンプトの指示、またはoutput_config.formatを使用してください。
ツールパラメータのクォート: Claude 4.6モデルでは、ツール呼び出し引数のJSON文字列エスケープがわずかに異なる場合があります（例：Unicodeエスケープやフォワードスラッシュのエスケープの処理が異なる）。JSONパーサーを使用せずにツール呼び出しのinputを生の文字列として解析している場合は、解析ロジックを確認してください。標準的なJSONパーサー（json.loads()やJSON.parse()など）はこれらの違いを自動的に処理します。

推奨される変更

これらは必須ではありませんが、エクスペリエンスが向上します：

アダプティブシンキングへの移行: thinking: {type: "enabled", budget_tokens: N}はClaude 4.6モデルで非推奨となり、将来のモデルリリースで削除されます。thinking: {type: "adaptive"}に切り替え、effortパラメータを使用してシンキングの深さを制御してください。アダプティブシンキングを参照してください。

Claude 4.1以前からClaude 4.6への移行

Opus 4.1、Sonnet 4、またはそれ以前のモデルから直接Claude 4.6に移行する場合は、上記のClaude 4.6の破壊的変更に加えて、このセクションの追加変更を適用してください。

# Opus 4.1から
model="claude-opus-4-1-20250805"    # 変更前
model="claude-opus-4-6"               # 変更後

# Sonnet 4から
model="claude-sonnet-4-20250514"    # 変更前
model="claude-opus-4-6"              # 変更後

# Sonnet 3.7から
model="claude-3-7-sonnet-20250219"  # 変更前
model="claude-opus-4-6"              # 変更後

追加の破壊的変更

サンプリングパラメータ

これはClaude 3.xモデルからの破壊的変更です。

temperatureまたはtop_pのいずれか一方のみを使用し、両方は使用しないでください：

# 変更前 - Claude 4+モデルではエラーになります
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # 両方は使用できません
    ...
)

# 変更後
response = client.messages.create(
    model="claude-opus-4-6",
    temperature=0.7,  # temperatureまたはtop_pのいずれか一方を使用
    ...
)

追加の推奨変更

レガシーベータヘッダーの削除: token-efficient-tools-2025-02-19とoutput-128k-2025-02-19を削除してください — すべてのClaude 4+モデルにはトークン効率の良いツール使用が組み込まれており、これらのヘッダーは効果がありません。

Claude 4.6移行チェックリスト

モデルIDをclaude-opus-4-6に更新
破壊的変更: アシスタントメッセージのプリフィルを削除（400エラーを返す）；代わりに構造化出力またはoutput_config.formatを使用
推奨: thinking: {type: "enabled", budget_tokens: N}からthinking: {type: "adaptive"}とeffortパラメータへの移行（budget_tokensは非推奨であり、将来のリリースで削除されます）
ツール呼び出しのJSON解析が標準的なJSONパーサーを使用していることを確認
effort-2025-11-24ベータヘッダーを削除（effortがGAになりました）
fine-grained-tool-streaming-2025-05-14ベータヘッダーを削除
ベータヘッダーを削除

Claude Sonnet 4.5への移行

Claude Sonnet 4.5は高い知能と高速なパフォーマンスを兼ね備えており、日常的なコーディング、分析、コンテンツタスクに最適です。

機能の完全な概要については、モデル概要を参照してください。

Sonnet 4.5の料金は、入力100万トークンあたり$3、出力100万トークンあたり$15です。詳細はClaudeの料金を参照してください。

モデル名を更新する：

# Sonnet 4から
model="claude-sonnet-4-20250514"        # 変更前
model="claude-sonnet-4-5-20250929"      # 変更後

# Sonnet 3.7から
model="claude-3-7-sonnet-20250219"      # 変更前
model="claude-sonnet-4-5-20250929"      # 変更後

拡張シンキングの有効化を検討してください — コーディングや推論タスクで大幅なパフォーマンス向上が得られます（デフォルトでは無効）：

response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)

破壊的変更

これらの破壊的変更は、Claude 3.x Sonnetモデルからの移行時に適用されます。

サンプリングパラメータ

これはClaude 3.xモデルからの破壊的変更です。

temperatureまたはtop_pのいずれか一方のみを使用し、両方は使用しないでください。
ツールバージョン

これはClaude 3.xモデルからの破壊的変更です。

最新のツールバージョン（text_editor_20250728、code_execution_20250825）に更新してください。undo_editコマンドを使用しているコードを削除してください。
refusal停止理由の処理

アプリケーションを更新してrefusal停止理由を処理してください。
動作変更に合わせてプロンプトを更新する

Sonnet 4.5移行チェックリスト

モデルIDをclaude-sonnet-4-5-20250929に更新
破壊的変更: ツールバージョンを最新に更新（text_editor_20250728、code_execution_20250825）— レガシーバージョンはサポートされません（3.xから移行する場合）
破壊的変更: undo_editコマンドを使用しているコードを削除（該当する場合）
破壊的変更: サンプリングパラメータをtemperatureまたはtop_pのいずれか一方のみに更新（3.xから移行する場合）
アプリケーションで新しいrefusal停止理由を処理
プロンプティングのベストプラクティスに従ってプロンプトを確認・更新
複雑な推論タスクに対して拡張シンキングの有効化を検討

Claude Haiku 4.5への移行

Claude Haiku 4.5は、最速かつ最もインテリジェントなHaikuモデルであり、フロンティアに近いパフォーマンスを備え、インタラクティブなアプリケーションや大量処理にプレミアムモデルの品質を提供します。

機能の完全な概要については、モデル概要を参照してください。

Haiku 4.5の料金は、入力100万トークンあたり$1、出力100万トークンあたり$5です。詳細はClaudeの料金を参照してください。

モデル名を更新する：

# Haiku 3.5から
model="claude-3-5-haiku-20241022"      # 変更前
model="claude-haiku-4-5-20251001"      # 変更後

新しいレート制限を確認してください： Haiku 4.5にはHaiku 3.5とは別のレート制限があります。詳細はレート制限のドキュメントを参照してください。

拡張シンキングの有効化を検討してください — コーディングや推論タスクで大幅なパフォーマンス向上が得られます（デフォルトでは無効）：

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)

拡張シンキングはプロンプトキャッシングの効率に影響します。

新しい機能を探索してください： コンテキスト認識、出力容量の増加（64Kトークン）、より高い知能、改善された速度の詳細については、モデル概要を参照してください。

破壊的変更

これらの破壊的変更は、Claude 3.x Haikuモデルからの移行時に適用されます。

サンプリングパラメータ

これはClaude 3.xモデルからの破壊的変更です。

temperatureまたはtop_pのいずれか一方のみを使用し、両方は使用しないでください。
ツールバージョン

これはClaude 3.xモデルからの破壊的変更です。

最新のツールバージョン（text_editor_20250728、code_execution_20250825）に更新してください。undo_editコマンドを使用しているコードを削除してください。
refusal停止理由の処理

アプリケーションを更新してrefusal停止理由を処理してください。
動作変更に合わせてプロンプトを更新する

Haiku 4.5移行チェックリスト

モデルIDをclaude-haiku-4-5-20251001に更新
破壊的変更: ツールバージョンを最新に更新（text_editor_20250728、code_execution_20250825）— レガシーバージョンはサポートされません
破壊的変更: undo_editコマンドを使用しているコードを削除（該当する場合）
破壊的変更: サンプリングパラメータをtemperatureまたはtop_pのいずれか一方のみに更新
アプリケーションで新しいrefusal停止理由を処理
新しいレート制限を確認・調整（Haiku 3.5とは別）
プロンプティングのベストプラクティスに従ってプロンプトを確認・更新

サポートが必要ですか？

詳細な仕様についてはAPIドキュメントを確認してください
パフォーマンス比較についてはモデルの機能を確認してください
APIの更新についてはAPIリリースノートを確認してください
移行中に問題が発生した場合はサポートにお問い合わせください

response = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 32000
    },
    betas=["interleaved-thinking-2025-05-14"],
    messages=[...]
)

ツールバージョン

これはClaude 3.xモデルからの破壊的変更です。

最新のツールバージョンに更新してください。undo_editコマンドを使用しているコードを削除してください。

# 変更前
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# 変更後
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

テキストエディタ: text_editor_20250728とstr_replace_based_edit_toolを使用してください。詳細はテキストエディタツールのドキュメントを参照してください。
コード実行: code_execution_20250825にアップグレードしてください。移行手順についてはコード実行ツールのドキュメントを参照してください。

refusal停止理由の処理

アプリケーションを更新してrefusal停止理由を処理してください：

response = client.messages.create(...)

if response.stop_reason == "refusal":
    # 拒否を適切に処理
    pass

model_context_window_exceeded停止理由の処理

Claude 4.5+モデルでは、要求されたmax_tokens制限ではなく、コンテキストウィンドウの制限に達して生成が停止した場合にmodel_context_window_exceeded停止理由を返します。この新しい停止理由を処理するようにアプリケーションを更新してください：

response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # コンテキストウィンドウの制限を適切に処理
    pass

interleaved-thinking-2025-05-14