モデルと料金

移行ガイド

以前のClaudeバージョンからClaude 4.6モデルへの移行ガイド

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パラメータを使用してシンキングの深さを制御してください。アダプティブシンキングを参照してください。
```
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=[...],
)
```
この移行ではclient.beta.messages.createからclient.messages.createへの変更も含まれることに注意してください。アダプティブシンキングとeffortはGA機能であり、ベータSDK名前空間やベータヘッダーは不要です。
effortベータヘッダーの削除: effortパラメータがGAになりました。リクエストからbetas=["effort-2025-11-24"]を削除してください。
きめ細かいツールストリーミングベータヘッダーの削除: きめ細かいツールストリーミングがGAになりました。リクエストからbetas=["fine-grained-tool-streaming-2025-05-14"]を削除してください。
インターリーブドシンキングベータヘッダーの削除（Opus 4.6のみ）: アダプティブシンキングはOpus 4.6でインターリーブドシンキングを自動的に有効にします。Opus 4.6のリクエストからbetas=["interleaved-thinking-2025-05-14"]を削除してください。注意：Sonnet 4.6は手動の拡張シンキングでこのベータヘッダーを引き続きサポートします。
output_config.formatへの移行: 構造化出力を使用している場合、output_format={...}をoutput_config={"format": {...}}に更新してください。古いパラメータは引き続き機能しますが、非推奨であり、将来のモデルリリースで削除されます。

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のいずれか一方を使用
    # ...
)

ツールバージョンの更新

これは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
```
ツールパラメータの処理の確認（末尾の改行）

Claude 4.5+モデルは、以前は除去されていたツール呼び出し文字列パラメータの末尾の改行を保持します。ツールがツール呼び出しパラメータとの完全一致に依存している場合は、末尾の改行を正しく処理するようにロジックを確認してください。
動作変更に合わせたプロンプトの更新

Claude 4+モデルは、より簡潔で直接的なコミュニケーションスタイルを持ち、明示的な指示が必要です。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

追加の推奨される変更

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

Claude 4.6移行チェックリスト

Claude Sonnet 4.6への移行

Claude Sonnet 4.6は高い知能と高速なパフォーマンスを兼ね備え、改善されたエージェント検索機能と、ウェブ検索またはウェブフェッチと併用した場合の無料コード実行を特徴としています。日常的なコーディング、分析、コンテンツタスクに最適です。

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

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

モデル名を更新する：

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

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

破壊的変更

Sonnet 4.5からの移行時

アシスタントメッセージのプリフィルがサポートされなくなりました

これはSonnet 4.5以前からの移行時の破壊的変更です。

Sonnet 4.6では、アシスタントメッセージのプリフィルは400エラーを返します。代わりに構造化出力、システムプロンプトの指示、またはoutput_config.formatを使用してください。

一般的なプリフィルのユースケースと移行方法：
- 出力フォーマットの制御（JSON/YAML出力の強制）：分類タスクには構造化出力またはenum フィールドを持つツールを使用してください。
- 前置きの排除（「Here is...」フレーズの削除）：システムプロンプトに直接的な指示を追加してください：「前置きなしで直接回答してください。'Here is...'、'Based on...'などのフレーズで始めないでください。」
- 不適切な拒否の回避：Claudeは適切な拒否の判断が大幅に改善されました。プリフィルなしでユーザーメッセージに明確なプロンプティングを行えば十分です。
- 継続（中断された応答の再開）：継続をユーザーメッセージに移動してください：「あなたの前回の応答は中断され、[previous_response]で終わりました。中断したところから続けてください。」
- コンテキストハイドレーション / ロールの一貫性（長い会話でのコンテキストのリフレッシュ）：以前プリフィルされたアシスタントのリマインダーを、代わりにユーザーターンに挿入してください。
ツールパラメータのJSONエスケープが異なる場合があります

これはSonnet 4.5以前からの移行時の破壊的変更です。

ツールパラメータのJSON文字列エスケープが以前のモデルと異なる場合があります。標準的なJSONパーサーはこれを自動的に処理しますが、カスタムの文字列ベースの解析は更新が必要な場合があります。

Claude 3.xからの移行時

サンプリングパラメータの更新

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

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

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

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

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

Claude 4モデルは、より簡潔で直接的なコミュニケーションスタイルを持っています。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

推奨される変更

fine-grained-tool-streaming-2025-05-14ベータヘッダーの削除 — きめ細かいツールストリーミングはSonnet 4.6でGAになり、ベータヘッダーは不要になりました。
output_formatからoutput_config.formatへの移行 — output_formatパラメータは非推奨です。代わりにoutput_config.formatを使用してください。

Sonnet 4.5からの移行

Sonnet 4.5からSonnet 4.6への移行を強くお勧めします。同じ価格帯でより高い知能を提供します。

Sonnet 4.6はデフォルトのeffortレベルがhighであり、effortパラメータがなかったSonnet 4.5とは対照的です。Sonnet 4.5からSonnet 4.6に移行する際は、effortパラメータを調整することをお勧めします。明示的に設定しない場合、デフォルトのeffortレベルにより高いレイテンシが発生する可能性があります。

拡張シンキングを使用していない場合

Sonnet 4.5で拡張シンキングを使用していない場合、Sonnet 4.6でも使用せずに続けることができます。ユースケースに適したレベルにeffortを明示的に設定する必要があります。シンキングを無効にしたloweffortでは、拡張シンキングなしのSonnet 4.5と同等以上のパフォーマンスが期待できます。

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    output_config={"effort": "low"},
    messages=[{"role": "user", "content": "Your prompt here"}],
)

拡張シンキングを使用している場合

Sonnet 4.5で拡張シンキングを使用している場合、Sonnet 4.6でもシンキング設定を変更せずに引き続きサポートされます。シンキングバジェットは約16kトークンに保つことをお勧めします。実際にはほとんどのタスクでそれほど使用しませんが、トークン使用量の暴走リスクなしに、より難しい問題に対するヘッドルームを提供します。

コーディングとエージェントのユースケース

エージェントコーディング、フロントエンドデザイン、ツール多用のワークフロー、複雑なエンタープライズワークフローには、mediumeffortから始めることをお勧めします。レイテンシが高すぎる場合は、effortをlowに下げることを検討してください。より高い知能が必要な場合は、effortをhighに上げるか、Opus 4.6への移行を検討してください。

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=16384,
    thinking={"type": "enabled", "budget_tokens": 16384},
    output_config={"effort": "medium"},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

チャットと非コーディングのユースケース

チャット、コンテンツ生成、検索、分類、その他の非コーディングタスクには、拡張シンキング付きのloweffortから始めることをお勧めします。より深い処理が必要な場合は、effortをmediumに上げてください。

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    thinking={"type": "enabled", "budget_tokens": 16384},
    output_config={"effort": "low"},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

アダプティブシンキングを試すタイミング

上記の移行パスでは、予測可能なトークン使用量のためにbudget_tokens付きの拡張シンキングを使用しています。ワークロードが以下のパターンのいずれかに該当する場合は、代わりにアダプティブシンキングを試すことを検討してください：

自律型マルチステップエージェント： 要件を動作するソフトウェアに変換するコーディングエージェント、データ分析パイプライン、モデルが多くのステップにわたって独立して実行するバグ発見。アダプティブシンキングにより、モデルはステップごとに推論を調整し、より長い軌跡にわたって正しい方向を維持できます。これらのワークロードでは、higheffortから始めてください。レイテンシやトークン使用量が懸念される場合は、mediumにスケールダウンしてください。
コンピュータ使用エージェント： Sonnet 4.6はアダプティブモードを使用してコンピュータ使用の評価でクラス最高の精度を達成しました。
バイモーダルワークロード： 簡単なタスクと難しいタスクが混在し、アダプティブが単純なクエリではシンキングをスキップし、複雑なクエリでは深く推論するワークロード。

アダプティブシンキングを使用する場合は、タスクでmediumとhigheffortを評価してください。適切なレベルは、品質、レイテンシ、トークン使用量のトレードオフによって異なります。

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Your prompt here"}],
)

アダプティブシンキングで一貫性のない動作や品質の低下が見られる場合は、budget_tokens付きの拡張シンキングに切り替えてください。これにより、シンキングコストに上限を設けた、より予測可能な結果が得られます。

Sonnet 4.6移行チェックリスト

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"  # 変更後

破壊的変更

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

サンプリングパラメータの更新

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

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

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

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

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

Claude 4モデルは、より簡潔で直接的なコミュニケーションスタイルを持っています。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

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とは別のレート制限があります。詳細はレート制限のドキュメントを参照してください。

コーディングと推論タスクの大幅なパフォーマンス向上のために、thinking: {type: "enabled", budget_tokens: N}で拡張シンキングを有効にすることを検討してください。

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

拡張シンキングはClaude 4.6以降のモデルでは非推奨です。新しいモデルを使用する場合は、代わりにアダプティブシンキングを使用してください。

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

破壊的変更

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

サンプリングパラメータの更新

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

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

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

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

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

Claude 4モデルは、より簡潔で直接的なコミュニケーションスタイルを持っています。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

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リリースノートを確認してください
移行中に問題が発生した場合はサポートにお問い合わせください

Was this page helpful?

モデルと料金

移行ガイド

以前のClaudeバージョンからClaude 4.6モデルへの移行ガイド

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パラメータを使用してシンキングの深さを制御してください。アダプティブシンキングを参照してください。
```
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=[...],
)
```
この移行ではclient.beta.messages.createからclient.messages.createへの変更も含まれることに注意してください。アダプティブシンキングとeffortはGA機能であり、ベータSDK名前空間やベータヘッダーは不要です。
effortベータヘッダーの削除: effortパラメータがGAになりました。リクエストからbetas=["effort-2025-11-24"]を削除してください。
きめ細かいツールストリーミングベータヘッダーの削除: きめ細かいツールストリーミングがGAになりました。リクエストからbetas=["fine-grained-tool-streaming-2025-05-14"]を削除してください。
インターリーブドシンキングベータヘッダーの削除（Opus 4.6のみ）: アダプティブシンキングはOpus 4.6でインターリーブドシンキングを自動的に有効にします。Opus 4.6のリクエストからbetas=["interleaved-thinking-2025-05-14"]を削除してください。注意：Sonnet 4.6は手動の拡張シンキングでこのベータヘッダーを引き続きサポートします。
output_config.formatへの移行: 構造化出力を使用している場合、output_format={...}をoutput_config={"format": {...}}に更新してください。古いパラメータは引き続き機能しますが、非推奨であり、将来のモデルリリースで削除されます。

Claude 4.1以前から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のいずれか一方を使用
    # ...
)

ツールバージョンの更新

これは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
```
ツールパラメータの処理の確認（末尾の改行）

Claude 4.5+モデルは、以前は除去されていたツール呼び出し文字列パラメータの末尾の改行を保持します。ツールがツール呼び出しパラメータとの完全一致に依存している場合は、末尾の改行を正しく処理するようにロジックを確認してください。
動作変更に合わせたプロンプトの更新

Claude 4+モデルは、より簡潔で直接的なコミュニケーションスタイルを持ち、明示的な指示が必要です。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

追加の推奨される変更

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

Claude 4.6移行チェックリスト

Claude Sonnet 4.6への移行

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

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

モデル名を更新する：

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

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

破壊的変更

Sonnet 4.5からの移行時

アシスタントメッセージのプリフィルがサポートされなくなりました

これはSonnet 4.5以前からの移行時の破壊的変更です。

Sonnet 4.6では、アシスタントメッセージのプリフィルは400エラーを返します。代わりに構造化出力、システムプロンプトの指示、またはoutput_config.formatを使用してください。

一般的なプリフィルのユースケースと移行方法：
- 出力フォーマットの制御（JSON/YAML出力の強制）：分類タスクには構造化出力またはenum フィールドを持つツールを使用してください。
- 前置きの排除（「Here is...」フレーズの削除）：システムプロンプトに直接的な指示を追加してください：「前置きなしで直接回答してください。'Here is...'、'Based on...'などのフレーズで始めないでください。」
- 不適切な拒否の回避：Claudeは適切な拒否の判断が大幅に改善されました。プリフィルなしでユーザーメッセージに明確なプロンプティングを行えば十分です。
- 継続（中断された応答の再開）：継続をユーザーメッセージに移動してください：「あなたの前回の応答は中断され、[previous_response]で終わりました。中断したところから続けてください。」
- コンテキストハイドレーション / ロールの一貫性（長い会話でのコンテキストのリフレッシュ）：以前プリフィルされたアシスタントのリマインダーを、代わりにユーザーターンに挿入してください。
ツールパラメータのJSONエスケープが異なる場合があります

これはSonnet 4.5以前からの移行時の破壊的変更です。

ツールパラメータのJSON文字列エスケープが以前のモデルと異なる場合があります。標準的なJSONパーサーはこれを自動的に処理しますが、カスタムの文字列ベースの解析は更新が必要な場合があります。

Claude 3.xからの移行時

サンプリングパラメータの更新

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

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

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

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

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

Claude 4モデルは、より簡潔で直接的なコミュニケーションスタイルを持っています。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

推奨される変更

fine-grained-tool-streaming-2025-05-14ベータヘッダーの削除 — きめ細かいツールストリーミングはSonnet 4.6でGAになり、ベータヘッダーは不要になりました。
output_formatからoutput_config.formatへの移行 — output_formatパラメータは非推奨です。代わりにoutput_config.formatを使用してください。

Sonnet 4.5からの移行

Sonnet 4.5からSonnet 4.6への移行を強くお勧めします。同じ価格帯でより高い知能を提供します。

拡張シンキングを使用していない場合

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    output_config={"effort": "low"},
    messages=[{"role": "user", "content": "Your prompt here"}],
)

拡張シンキングを使用している場合

コーディングとエージェントのユースケース

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=16384,
    thinking={"type": "enabled", "budget_tokens": 16384},
    output_config={"effort": "medium"},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

チャットと非コーディングのユースケース

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    thinking={"type": "enabled", "budget_tokens": 16384},
    output_config={"effort": "low"},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

アダプティブシンキングを試すタイミング

自律型マルチステップエージェント： 要件を動作するソフトウェアに変換するコーディングエージェント、データ分析パイプライン、モデルが多くのステップにわたって独立して実行するバグ発見。アダプティブシンキングにより、モデルはステップごとに推論を調整し、より長い軌跡にわたって正しい方向を維持できます。これらのワークロードでは、higheffortから始めてください。レイテンシやトークン使用量が懸念される場合は、mediumにスケールダウンしてください。
コンピュータ使用エージェント： Sonnet 4.6はアダプティブモードを使用してコンピュータ使用の評価でクラス最高の精度を達成しました。
バイモーダルワークロード： 簡単なタスクと難しいタスクが混在し、アダプティブが単純なクエリではシンキングをスキップし、複雑なクエリでは深く推論するワークロード。

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Your prompt here"}],
)

Sonnet 4.6移行チェックリスト

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"  # 変更後

破壊的変更

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

サンプリングパラメータの更新

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

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

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

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

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

Claude 4モデルは、より簡潔で直接的なコミュニケーションスタイルを持っています。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

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への移行

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

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とは別のレート制限があります。詳細はレート制限のドキュメントを参照してください。

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

拡張シンキングはClaude 4.6以降のモデルでは非推奨です。新しいモデルを使用する場合は、代わりにアダプティブシンキングを使用してください。

破壊的変更

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

サンプリングパラメータの更新

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

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

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

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

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

Claude 4モデルは、より簡潔で直接的なコミュニケーションスタイルを持っています。最適化のガイダンスについてはプロンプティングのベストプラクティスを確認してください。

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リリースノートを確認してください
移行中に問題が発生した場合はサポートにお問い合わせください

Was this page helpful?