模型與定價

遷移指南

從先前 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 跳脫或正斜線跳脫的不同處理方式）。如果您將工具呼叫的 input 作為原始字串解析而非使用 JSON 解析器，請驗證您的解析邏輯。標準 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）功能，不需要 beta SDK 命名空間或任何 beta 標頭。
移除 effort beta 標頭：effort 參數現已正式發布。請從您的請求中移除 betas=["effort-2025-11-24"]。
移除細粒度工具串流 beta 標頭：細粒度工具串流現已正式發布。請從您的請求中移除 betas=["fine-grained-tool-streaming-2025-05-14"]。
移除交錯思考 beta 標頭：自適應思考會自動啟用交錯思考。請從您的請求中移除 betas=["interleaved-thinking-2025-05-14"]。
遷移至 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+ 模型在生成因達到上下文視窗限制而停止時，會返回 model_context_window_exceeded 停止原因，而非請求的 max_tokens 限制。更新您的應用程式以處理此新的停止原因：
```
response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # 適當處理上下文視窗限制
    pass
```
工具參數處理（尾隨換行符）

Claude 4.5+ 模型會保留工具呼叫字串參數中先前被去除的尾隨換行符。如果您的工具依賴於對工具呼叫參數的精確字串匹配，請驗證您的邏輯是否正確處理尾隨換行符。
針對行為變更更新您的提示

Claude 4+ 模型具有更簡潔、直接的溝通風格，需要明確的指示。請查閱提示最佳實踐以獲取最佳化指導。

額外建議變更

移除舊版 beta 標頭：移除 token-efficient-tools-2025-02-19 和 output-128k-2025-02-19 — 所有 Claude 4+ 模型都內建了 token 高效工具使用，這些標頭不會產生任何效果。

Claude 4.6 遷移檢查清單

遷移至 Claude Sonnet 4.5

Claude Sonnet 4.5 結合了強大的智慧與快速的效能，非常適合日常編碼、分析和內容任務。

如需完整的功能概覽，請參閱模型概覽。

Sonnet 4.5 定價為每百萬輸入 token 3 美元，每百萬輸出 token 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 停止原因。
針對行為變更更新您的提示

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 定價為每百萬輸入 token 1 美元，每百萬輸出 token 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 token）、更高的智慧和改進的速度等詳情。

破壞性變更

這些破壞性變更適用於從 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

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 跳脫或正斜線跳脫的不同處理方式）。如果您將工具呼叫的 input 作為原始字串解析而非使用 JSON 解析器，請驗證您的解析邏輯。標準 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）功能，不需要 beta SDK 命名空間或任何 beta 標頭。
移除 effort beta 標頭：effort 參數現已正式發布。請從您的請求中移除 betas=["effort-2025-11-24"]。
移除細粒度工具串流 beta 標頭：細粒度工具串流現已正式發布。請從您的請求中移除 betas=["fine-grained-tool-streaming-2025-05-14"]。
移除交錯思考 beta 標頭：自適應思考會自動啟用交錯思考。請從您的請求中移除 betas=["interleaved-thinking-2025-05-14"]。
遷移至 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+ 模型在生成因達到上下文視窗限制而停止時，會返回 model_context_window_exceeded 停止原因，而非請求的 max_tokens 限制。更新您的應用程式以處理此新的停止原因：
```
response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # 適當處理上下文視窗限制
    pass
```
工具參數處理（尾隨換行符）

Claude 4.5+ 模型會保留工具呼叫字串參數中先前被去除的尾隨換行符。如果您的工具依賴於對工具呼叫參數的精確字串匹配，請驗證您的邏輯是否正確處理尾隨換行符。
針對行為變更更新您的提示

Claude 4+ 模型具有更簡潔、直接的溝通風格，需要明確的指示。請查閱提示最佳實踐以獲取最佳化指導。

額外建議變更

移除舊版 beta 標頭：移除 token-efficient-tools-2025-02-19 和 output-128k-2025-02-19 — 所有 Claude 4+ 模型都內建了 token 高效工具使用，這些標頭不會產生任何效果。

Claude 4.6 遷移檢查清單

遷移至 Claude Sonnet 4.5

Claude Sonnet 4.5 結合了強大的智慧與快速的效能，非常適合日常編碼、分析和內容任務。

如需完整的功能概覽，請參閱模型概覽。

Sonnet 4.5 定價為每百萬輸入 token 3 美元，每百萬輸出 token 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 停止原因。
針對行為變更更新您的提示

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 定價為每百萬輸入 token 1 美元，每百萬輸出 token 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 token）、更高的智慧和改進的速度等詳情。

破壞性變更

這些破壞性變更適用於從 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?