Claude Opus 4.7 是我們迄今為止最強大的通用可用模型。它具有高度自主性,在長期代理工作、知識工作、視覺任務和記憶任務上表現出色。本頁總結了發佈時的所有新功能。
| 模型 | API 模型 ID | 描述 |
|---|---|---|
| Claude Opus 4.7 | claude-opus-4-7 | 我們最強大的通用可用模型,用於複雜推理和代理編碼 |
Claude Opus 4.7 支持 1M 令牌上下文窗口、128k 最大輸出令牌、自適應思考,以及與 Claude Opus 4.6 相同的工具和平台功能集。
有關完整的定價和規格,請參閱 模型概述。
Claude Opus 4.7 是我們第一個支持高分辨率圖像的 Claude 模型。最大圖像分辨率已增加到 2576px / 3.75MP(從之前的 1568px / 1.15MP 限制增加)。此更改應該能在視覺密集型工作負載上解鎖性能提升,對於計算機使用和截圖/工件/文檔理解工作流尤其重要。
此外,映射坐標到圖像等操作現在更簡單了——模型的坐標與實際像素成 1
對應,因此不需要進行縮放因子計算。高分辨率圖像使用更多令牌。如果不需要額外的圖像保真度,請在發送給 Claude 之前對圖像進行下採樣,以避免令牌使用量增加。
除了分辨率外,Claude Opus 4.7 還改進了:
有關詳細信息,請參閱 圖像和視覺。
xhigh 努力級別努力參數 允許您調整 Claude 的智能與令牌支出,以便在能力和更快速度及更低成本之間進行權衡。對於編碼和代理使用案例,從新的 xhigh 努力級別開始,對於大多數對智能敏感的使用案例,至少使用 high 努力級別。有關每個級別的指導,請參閱 Claude Opus 4.7 的推薦努力級別。(僅限 Messages API;Claude Managed Agents 自動處理努力級別。)
Claude Opus 4.7 引入了 任務預算。任務預算為 Claude 提供了一個粗略估計,說明完整代理循環應該針對多少令牌,包括思考、工具調用、工具結果和最終輸出。模型會看到一個運行倒計時,並使用它來優先處理工作,並在預算被消耗時優雅地完成任務。要使用,請設置測試版標頭 task-budgets-2026-03-13 並將以下內容添加到您的輸出配置中:
response = client.beta.messages.create(
model="claude-opus-4-7",
max_tokens=128000,
output_config={
"effort": "high",
"task_budget": {"type": "tokens", "total": 128000},
},
messages=[
{"role": "user", "content": "Review the codebase and propose a refactor plan."}
],
betas=["task-budgets-2026-03-13"],
)您可能需要為您的使用案例嘗試不同的任務預算。如果模型被給予對於給定任務來說過於限制性的任務預算,它可能會不那麼徹底地完成任務或完全拒絕執行任務。
對於質量比速度更重要的開放式代理任務,不要設置任務預算;將任務預算保留用於您需要模型將其工作範圍限制在令牌配額內的工作負載。任務預算的最小值是 20k 令牌。
這不是硬上限;這是模型意識到的建議。這與 max_tokens 不同,max_tokens 是對生成令牌的硬性每請求上限(max_tokens 不傳遞給模型,模型不知道它),而 task_budget 是跨完整代理循環的建議上限。當您希望模型自我調節時使用 task_budget,並使用 max_tokens 作為硬性每請求上限以限制使用量。
這些破壞性變更僅適用於 Messages API。如果您使用 Claude Managed Agents,Claude Opus 4.7 沒有破壞性 API 變更。
擴展思考預算在 Claude Opus 4.7 中被移除。設置 thinking: {"type": "enabled", "budget_tokens": N} 將返回 400 錯誤。自適應思考 是唯一支持的思考開啟模式,在我們的內部評估中,它可靠地優於擴展思考。
# 之前 (Opus 4.6)
thinking = {"type": "enabled", "budget_tokens": 32000}
# 之後 (Opus 4.7)
thinking = {"type": "adaptive"}
output_config = {"effort": "high"}自適應思考在 Claude Opus 4.7 上 默認關閉。沒有 thinking 字段的請求在沒有思考的情況下運行。明確設置 thinking: {type: "adaptive"} 以啟用它。
從 Claude Opus 4.7 開始,將 temperature、top_p 或 top_k 設置為任何非默認值將返回 400 錯誤。最安全的遷移路徑是從請求中完全省略這些參數,並使用提示來指導模型的行為。如果您使用 temperature = 0 來實現確定性,請注意它從未保證相同的輸出。
從 Claude Opus 4.7 開始,思考內容默認從響應中省略。思考塊仍然出現在響應流中,但除非調用者明確選擇加入,否則它們的 thinking 字段將為空。這是一個靜默變更——不會引發錯誤——響應延遲將略有改善。如果需要推理輸出,您可以將 display 設置為 "summarized" 並通過單行更改選擇加入:
thinking = {
"type": "adaptive",
"display": "summarized", # 或 "omitted" (默認)
}如果您的產品向用戶流式傳輸推理,新的默認值將顯示為輸出開始前的長時間暫停。設置 "display": "summarized" 以在思考期間恢復可見進度。
Claude Opus 4.7 使用新的分詞器,有助於其在廣泛任務上的性能改進。與之前的模型相比,此新分詞器在處理文本時可能使用大約 1 倍到 1.35 倍的令牌(最多增加約 35%,因內容而異),/v1/messages/count_tokens 將為 Claude Opus 4.7 返回與 Claude Opus 4.6 不同的令牌數。Claude Opus 4.7 的令牌效率可能因工作負載形狀而異。提示干預、task_budget 和 effort 可以幫助控制成本並確保適當的令牌使用。請記住,這些控制可能會影響模型智能。
我們建議更新您的 max_tokens 參數以提供額外的空間,包括壓縮觸發器。Claude Opus 4.7 在標準 API 定價下提供 1M 上下文窗口,無長上下文溢價。
Claude Opus 4.7 在知識工作者任務上顯示出有意義的進步,特別是在模型需要視覺驗證其自身輸出的地方:
如果現有提示在這些領域有緩解措施(例如"在返回前檢查幻燈片佈局"),請嘗試移除該腳手架並重新建立基線。
Claude Opus 4.7 更擅長編寫和使用基於文件系統的記憶。如果代理在多個回合中維護便簽、筆記文件或結構化記憶存儲,該代理應該改進在記下筆記給自己並在未來任務中利用其筆記方面的能力。要為 Claude 提供託管便簽而無需構建自己的,請使用客戶端 記憶工具。
請參閱上面的 高分辨率圖像支持。
這些不是 API 破壞性變更,但可能需要提示更新。有關完整指導,請參閱 遷移到 Claude Opus 4.7。
有關分步遷移說明和完整遷移檢查清單,請參閱 遷移到 Claude Opus 4.7。如果您使用 Claude Code 或 Agent SDK,Claude API 技能 可以自動將這些遷移步驟應用到您的代碼庫。
在完整代理循環中為 Claude 提供建議的令牌預算。
Claude Opus 4.7 上唯一支持的思考開啟模式。
Claude Opus 4.7 的每個級別努力指導。
高分辨率圖像支持和 1
坐標映射。分步升級說明。
Was this page helpful?