Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
有關 Claude 應用程式的版本資訊,請參閱 Claude 說明中心的 Claude 應用程式版本資訊。
有關 Claude Code 的更新,請參閱 claude-code 儲存庫中的完整 CHANGELOG.md。
claude-opus-5),相較於 Claude Opus 4.8 有跨越式的改進。Claude Opus 5 支援 1M token 上下文視窗(預設值和最大值皆是)、128k 最大輸出 token,以及預設開啟的思考功能,價格為每 MTok $5 / $25,與 Claude Opus 4.8 相同。它可在 Claude API、Claude in Amazon Bedrock、Claude on Google Cloud 和 Claude in Microsoft Foundry 上使用。請參閱 Claude Opus 5 的新功能以了解新功能、行為變更和遷移指南,以及模型概覽以了解完整規格。high 或以下時停用思考:thinking: {"type": "disabled"} 搭配 effort xhigh 或 max 會回傳 400 錯誤,這是相對於 Claude Opus 4.8 的重大變更。請參閱 Claude Opus 5 的新功能。low、medium、high、xhigh、max),其中 max 適用於對能力要求極高的工作。mid-conversation-tool-changes-2026-07-01 測試版標頭。fallbacks 參數現在支援 "default" 模式,該模式會依拒絕類別套用 Anthropic 建議的後備模型。伺服器端後備功能處於測試版,且 "default" 模式需要 server-side-fallback-2026-07-01 測試版標頭。請參閱拒絕與後備。effort 等級。在建立代理程式時,於 model 物件內傳入 effort。請參閱 Effort 等級以了解每個等級的作用。environment.* 事件類型和三種 memory_store.* 事件類型。您可以在不輪詢的情況下對環境和記憶體儲存的生命週期變更做出反應。請參閱訂閱 Webhook 中的「環境事件」和「記憶體儲存事件」分頁。POST /v1/sessions 上傳入 initial_events,最多可包含 50 個 user.message 和 user.define_outcome 事件。非空的清單會在同一次呼叫中啟動代理程式迴圈,因此您不需要另外發送事件請求來開始工作。version 欄位現在是選填的。提供它以實現樂觀並行控制(不匹配會回傳 409 錯誤),或省略它以無條件套用更新。請參閱更新語意。GET /v1/sessions/{session_id}/threads/{thread_id}/stream 接受與工作階段層級串流相同的 event_deltas[] 查詢參數,因此您可以在模型生成時預覽子代理程式的文字。一個連線僅預覽其正在讀取的執行緒。請參閱預覽工作階段執行緒事件。/v1/experimental/generate_prompt、/v1/experimental/improve_prompt 和 /v1/experimental/templatize_prompt)將與 Workbench 一起於 2026 年 8 月 17 日停用。移除後,對這些端點的請求將回傳錯誤。anthropic-beta: ce-user-management-2026-07-13 測試版標頭;成員和邀請請求不需要測試版標頭。具有 read:org_audit 範圍的 Admin API 金鑰也可以呼叫每個使用者管理的 GET 端點。請參閱使用者管理。cmek_preserve 事件的文件,新增了篩選範例、事件酬載範例,以及兩個保留原因代碼(policy_violation_investigation、csae_report)。文件現在也闡明,無論保留是由人工審查員還是自動化安全管線發起,都會寫入保留事件。請參閱 CMEK 內容保留。expires_at 欄位中回報每個金鑰的到期時間。請參閱驗證。agent-memory-2026-07-22 測試版標頭,它會改變列出記憶(GET /v1/memory_stores/{memory_store_id}/memories)的行為:結果會以穩定的、由伺服器定義的順序回傳,且 order_by 和 order 參數會被忽略;depth 僅接受 0、1 或省略(其他值會回傳 400 錯誤);且 path_prefix 必須以 / 結尾,並匹配完整的路徑區段而非子字串。未使用該標頭發出的分頁游標與其不相容,因此採用時請從第一頁重新開始。在記憶體儲存端點上,agent-memory-2026-07-22 取代了 managed-agents-2026-04-01;同時發送兩者會回傳 400 錯誤。2026 年 7 月 22 日,managed-agents-2026-04-01 標頭將採用相同的列表行為。請參閱測試版標頭。agent-memory-2026-07-22 而非 managed-agents-2026-04-01。如果您的程式碼在記憶體儲存呼叫上明確傳入 betas,請在那裡將 managed-agents-2026-04-01 替換為 agent-memory-2026-07-22,而不是新增第二個值。claude-sonnet-5),這是我們 Sonnet 模型系列的下一代產品,推廣價為每 MTok $2 / $10,優惠至 2026 年 8 月 31 日(之後為標準價 $3 / $15)。Claude Sonnet 5 支援 1M token 上下文視窗、128k 最大輸出 token,以及與 Claude Sonnet 4.6 相同的工具和平台功能集,但 Priority Tier 除外,Claude Sonnet 5 不提供該功能。遷移時有三項行為變更:自適應思考現在預設開啟;手動擴展思考(thinking: {type: "enabled", budget_tokens: N})已移除並會回傳 400 錯誤(它在 Sonnet 4.6 上已被棄用);將取樣參數(temperature、top_p、top_k)設定為非預設值會回傳 400 錯誤。Claude Sonnet 5 也使用新的分詞器,對於相同的文字會產生約 30% 更多的 token。確切的增幅取決於內容和工作負載的形態。請參閱 Claude Sonnet 5 的新功能以了解詳細資訊和遷移指南。有關行為差異和模型特定的提示模式,請參閱為 Claude Sonnet 5 撰寫提示。GET /v1/sessions/{session_id}/events/stream 上的 event_deltas[] 查詢參數選擇加入。event_start 和 event_delta 事件會在完整的 agent.message 事件到達之前,預覽代理程式訊息生成中的文字。GET /v1/sessions 會在 next_page 旁回傳 prev_page 游標;將其作為 page 參數傳入即可返回上一頁。請參閱分頁。type: "agent_with_overrides" 的 agent,即可為單一工作階段替換模型、系統提示、工具、MCP 伺服器或技能。代理程式本身不會改變。injection_location。它控制憑證的值在出口時是被替換到代理程式的對外請求標頭、請求主體,還是兩者皆是。claude-opus-4-6 使用 speed: "fast" 的請求不再以快速速度或進階定價執行:它們以標準速度執行、按標準費率計費,且不會回傳錯誤。回應的 usage.speed 欄位會回報所使用的速度。若要繼續使用快速模式,請遷移至 Claude Opus 4.8。請在快速模式中閱讀更多資訊。claude-opus-4-7 使用 speed: "fast" 的請求將回傳錯誤。請遷移至 Claude Opus 4.8 的快速模式。請在快速模式中閱讀更多資訊。/v1/organizations/tunnels 移至 Claude API 上的 /v1/tunnels。新的介面使用 anthropic-beta: mcp-tunnels-2026-06-22 標頭和 workspace:manage_tunnels WIF 範圍。先前的介面在遷移期間仍然可用。請參閱通道 API 參考。code_execution_20260120,這是新增 REPL 狀態持久性的程式碼執行工具版本,也是程式化工具呼叫的最低版本。若要採用它,請將工具的 type 設定為 code_execution_20260120;不需要測試版標頭。它可在 Claude Fable 5、Claude Mythos 5、Claude Opus 4.5 及更新版本,以及 Claude Sonnet 4.5 及更新版本上使用;請參閱模型相容性表格。claude-sonnet-4-20250514)和 Claude Opus 4 模型(claude-opus-4-20250514)。對這些模型的所有請求現在都將回傳錯誤。我們建議分別升級至 Claude Sonnet 4.6 和 Claude Opus 4.8。研究人員可以透過外部研究人員存取計畫申請持續存取。code_execution_20260521,它在工具描述中揭露了每個儲存格 90 秒的執行時間限制,讓 Claude 可以為長時間執行的儲存格做好規劃。不需要測試版標頭。web_search_20260318 和 web_fetch_20260318,新增了 response_inclusion 參數,可從 API 回應中移除已使用的結果區塊,以用於代理式工作流程。不需要測試版標頭。GET /v1/environments/{id}/work 端點(用於列出自架沙箱的待處理工作)現已在 Claude Platform on AWS 上提供。請參閱 Claude Platform on AWS 的 IAM 動作以了解授權它的 GetEnvironment 動作。claude-fable-5),這是我們廣泛發布的最強大模型,同時也為 Project Glasswing 參與者推出了 Claude Mythos 5(claude-mythos-5)。兩個模型都預設支援 1M token 上下文視窗、128k 最大輸出 token,以及永遠開啟的自適應思考。請參閱介紹 Claude Fable 5 和 Claude Mythos 5 以了解功能、API 變更和可用性。model: "claude-fable-5" 來測量您的提示在新分詞器下的結果。stop_reason: "refusal"。在生成任何輸出之前被拒絕的請求不會向您收費。選擇加入的 fallbacks 參數(在 Claude API 和 Claude Platform on AWS 上為測試版;Message Batches API 不支援)會在另一個模型上重新執行被拒絕的請求,並按後備模型的費率計費。請參閱處理停止原因。stop_details.category 欄位現在在 Claude Fable 5 上包含 "reasoning_extraction",當請求因 Anthropic 服務條款中關於逆向工程或複製模型輸出的限制而被封鎖時回傳。現有的 "cyber" 和 "bio" 類別保持不變。不需要測試版標頭。thinking: {"type": "disabled"},也不支援手動擴展思考預算和助理預填(兩者都會回傳 400 錯誤)。請參閱從 Claude Mythos Preview 遷移至 Claude Mythos 5。thinking.display 預設為 "omitted",與 Claude Opus 4.8、Claude Opus 4.7 和 Claude Mythos Preview 相同;設定 display: "summarized" 以接收可讀的思考摘要。原始的思維鏈永遠不會回傳;在同一模型的多回合對話中,請原封不動地傳回思考區塊。請參閱 Claude Fable 5 和 Claude Mythos 5 上的思考輸出。session.thread_* Webhook 事件現在包含 session_thread_id 欄位,用於識別觸發該事件的多代理程式執行緒。LanguageModel 加入 Apple 的 Foundation Models 框架。在 iOS 27、macOS 27、visionOS 27 和 watchOS 27(測試版)上,透過與 Apple 裝置端模型相同的 LanguageModelSession API 呼叫 Claude。claude-opus-4-1-20250805),預計於 2026 年 8 月 5 日在 Claude API 上停用。我們建議遷移至 Claude Opus 4.8。請在模型棄用中閱讀更多資訊。max_tokens 參數,以限制顧問模型每次呼叫的輸出,為不需要完整長度顧問回應的工作負載降低延遲和輸出 token 成本。在顧問工具定義上設定 tools[].max_tokens;請參閱限制顧問輸出。stop_reason: "refusal" 且 Claude 未生成任何輸出時,您不再需要為該請求付費。請參閱串流拒絕以了解如何偵測和處理拒絕。AnthropicSelfHostedEnvironmentAccess 受管政策。messages 陣列中的使用者回合之後發送 role: "system" 訊息(受放置規則約束),在長時間執行的工作階段中指令變更時保留提示快取命中。不需要測試版標頭。stop_details 欄位現已公開記錄;它會回傳 category(cyber、bio 或 null)和人類可讀的 explanation,讓您的應用程式可以將不同類別的拒絕導向正確的下一步。不需要測試版標頭。high,包括 Claude Code 和 Messages API。temperature、top_p 或 top_k 設定為非預設值會回傳 400 錯誤,與 Claude Opus 4.7 相同。請參閱遷移指南以了解詳細資訊。usage.output_tokens_details.thinking_tokens,回報計費的輸出 token 中有多少是擴展思考。串流時,此明細僅出現在最後一個 message_delta 事件上。不需要測試版標頭。agent_toolset 和 MCP 工具的超過 100K 字元(約 25K token)的大型輸出現在會自動溢出到沙箱中的檔案。模型會收到帶有檔案路徑的截斷預覽,並可以從那裡讀取完整內容。diagnostics.previous_message_id,API 會回報 cache_miss_reason,解釋提示快取前綴與上一回合的分歧之處。請在您的請求中包含 cache-diagnosis-2026-04-07 測試版標頭。speed: "fast" 搭配 model: "claude-opus-4-7" 和 fast-mode-2026-02-01 測試版標頭,以進階定價獲得顯著更快的輸出 token 生成速度。定價、速率限制和存取權限與 Opus 4.6 快速模式相同;有興趣的客戶應加入等候名單。managed-agents-2026-04-01 測試版標頭下進入公開測試版。mcp_oauth 憑證。請參閱使用保管庫進行驗證。dreaming-2026-04-21 測試版標頭控制。申請存取權限以試用。context-1m-2025-08-07)。該測試版標頭現在對這些模型沒有任何作用,超過標準 200k token 上下文視窗的請求會回傳錯誤。若要使用 1M 上下文視窗,請遷移至 Claude Sonnet 4.6 或 Claude Opus 4.6,在這些模型上它以標準定價正式提供,無需測試版標頭。managed-agents-2026-04-01 標頭下進入公開測試版。請參閱使用代理程式記憶以取得完整的整合指南。claude-3-haiku-20240307)。對此模型的所有請求現在都將回傳錯誤。我們建議升級至 Claude Haiku 4.5。/anthropic/v1/messages 的 Messages API 端點從 Bedrock 主控台自助使用,涵蓋 27 個 AWS 區域,並提供全球和區域端點。task-budgets-2026-03-13 測試版標頭。xhigh effort 等級。xhigh 介於 high 和 max 之間,專為長時間執行的代理式和編碼任務(超過 30 分鐘)以及數百萬 token 預算而調校。不需要測試版標頭。claude-sonnet-4-20250514)和 Claude Opus 4 模型(claude-opus-4-20250514),預計於 2026 年 6 月 15 日在 Claude API 上停用。我們建議分別遷移至 Claude Sonnet 4.6 和 Claude Opus 4.8。請在模型棄用中閱讀更多資訊。advisor-tool-2026-03-01。managed-agents-2026-04-01 測試版標頭。請在 Claude Managed Agents 概覽中了解更多資訊。ant CLI,這是一個 Claude API 的命令列客戶端,可實現與 Claude API 更快速的互動、與 Claude Code 的原生整合,以及以 YAML 檔案對 API 資源進行版本控制。請在 CLI 快速入門中了解更多資訊。/anthropic/v1/messages,使用與第一方 Claude API 相同的請求格式,並在 AWS 管理的基礎設施上執行,操作人員零存取權限。可在 us-east-1 使用;請聯繫您的 Anthropic 客戶主管以申請存取權限。請在 Claude in Amazon Bedrock 中了解更多資訊。max_tokens 上限提高到 300k。包含 output-300k-2026-03-24 測試版標頭即可為長篇內容、結構化資料和大型程式碼生成任務生成更長的單輪輸出。context-1m-2025-08-07 測試版標頭對這些模型將不再有效,超過標準 200k token 上下文視窗的請求將回傳錯誤。若要繼續使用 1M 上下文視窗,請遷移至 Claude Sonnet 4.6 或 Claude Opus 4.6,它們以標準定價支援完整的 1M token 上下文視窗,且不需要測試版標頭。GET /v1/models 和 GET /v1/models/{model_id} 現在會回傳 max_input_tokens、max_tokens 和一個 capabilities 物件。查詢 API 即可了解每個模型支援的功能。display 欄位,讓您可以從回應中省略思考內容以加快串流速度。設定 thinking.display: "omitted" 即可接收 thinking 欄位為空但保留 signature 的思考區塊,以維持多輪對話的連續性。計費方式不變。請在控制思考顯示中了解更多資訊。cache_control 欄位,系統會自動快取最後一個可快取的區塊,並隨著對話增長向前移動快取點。不需要手動管理斷點。可與現有的區塊層級快取控制搭配使用,以進行細粒度最佳化。可在 Claude API 和 Microsoft Foundry(預覽版)上使用。請在提示快取中了解更多資訊。claude-3-7-sonnet-20250219)和 Claude Haiku 3.5 模型(claude-3-5-haiku-20241022)。對這些模型的所有請求現在都會回傳錯誤。我們建議分別升級至 Claude Sonnet 4.6 和 Claude Haiku 4.5。研究人員可透過外部研究人員存取計畫申請持續存取權限。claude-3-haiku-20240307),預計於 2026 年 4 月 20 日停用。我們建議遷移至 Claude Haiku 4.5。請在模型棄用中閱讀更多資訊。speed 參數提供顯著更快的輸出 token 生成。快速模式以進階定價提供最高 2.5 倍的速度。有興趣的客戶請加入候補名單。thinking: {type: "adaptive"});手動思考(type: "enabled" 搭配 budget_tokens)已棄用。Opus 4.6 不支援預填助理訊息。請在 Claude 4.6 的新功能中了解更多資訊。budget_tokens 來控制思考深度。inference_geo 參數指定模型推論的執行位置。對於 2026 年 2 月 1 日之後發布的模型,僅限美國的推論以 1.1 倍定價提供。output_format 參數已移至 output_config.format。現有測試版使用者可在過渡期間繼續使用測試版標頭。結構化輸出在 Amazon Bedrock 和 Microsoft Foundry 上仍為公開測試版。console.anthropic.com 現在會重新導向至 platform.claude.com。作為我們 Claude 品牌整合的一部分,Claude Console 已遷移至新位置。現有的書籤和連結將透過自動重新導向繼續運作。更多詳情請參閱 2025 年 9 月 16 日公告。claude-3-opus-20240229)。對此模型的所有請求現在都會回傳錯誤。我們建議升級至 Claude Opus 4.5,它以三分之一的成本提供顯著提升的智慧。研究人員可透過外部研究人員存取計畫申請在 API 上持續存取 Claude Opus 3。tool_runner 時透過摘要自動管理對話上下文。structured-outputs-2025-11-13。clear_thinking_20251015),可自動管理思考區塊。請在上下文編輯中了解更多資訊。skills-2025-10-02 測試版),這是擴展 Claude 能力的新方式。Skills 是由指令、腳本和資源組成的有組織資料夾,Claude 會動態載入它們以執行專門任務。初始版本包括:
/v1/skills 端點)上傳您自己的 Skills,以封裝領域專業知識和組織工作流程model_context_window_exceeded,讓您可以在不計算輸入大小的情況下請求最大可能的 token 數。請在處理停止原因中了解更多資訊。request-id 標頭並存。請在錯誤中了解更多資訊。claude-3-5-sonnet-20240620 和 claude-3-5-sonnet-20241022)。這些模型將於 2025 年 10 月 28 日停用。我們建議遷移至 Claude Sonnet 4.5(claude-sonnet-4-5-20250929)以獲得更好的效能和能力。請在模型棄用中閱讀更多資訊。rate_limit_error)錯誤。先前在類似情況下會出現 529(overloaded_error)錯誤。search-results-2025-06-09。請在搜尋結果中了解更多資訊。*Opus 4.1 不允許同時指定 temperature 和 top_p 參數。請僅使用其中一個。
text_editor_20250728,這是一個更新的文字編輯器工具,修復了先前版本的一些問題,並新增了一個可選的 max_characters 參數,讓您可以在檢視大型檔案時控制截斷長度。search-results-2025-06-09。fine-grained-tool-streaming-2025-05-14。thinking 區塊輸出的 signature 欄位中回傳。interleaved-thinking-2025-05-14。top_p 核採樣參數的預設值從 0.999 變更為 0.99。若要還原此變更,請將 top_p 設為 0.999。
此外,啟用擴展思考時,您現在可以將 top_p 設為 0.95 到 1 之間的值。tool_result 和 document.source 的父 content 區塊中指定。為了向後相容,如果在 tool_result.content 或 document.source.content 的最後一個區塊上偵測到快取控制,它將自動套用至父區塊。在 tool_result.content 和 document.source.content 內的任何其他區塊上使用快取控制將導致驗證錯誤。tool_choice 參數中新增了對 none 選項的支援,可防止 Claude 呼叫任何工具。此外,在包含 tool_use 和 tool_result 區塊時,您不再需要提供任何 tools。bash_20250124:功能與先前版本相同,但獨立於電腦使用。不需要測試版標頭。text_editor_20250124:功能與先前版本相同,但獨立於電腦使用。不需要測試版標頭。computer_20250124:更新的電腦使用工具,具有新的命令選項,包括「hold_key」、「left_mouse_down」、「left_mouse_up」、「scroll」、「triple_click」和「wait」。此工具需要「computer-use-2025-01-24」anthropic-beta 標頭。
請在使用 Claude 進行工具使用中了解更多資訊。anthropic-organization-id 回應標頭。此標頭提供與請求中使用的 API 金鑰相關聯的組織 ID。以下功能現已在 Claude API 中正式推出:
我們也發布了新的官方 SDK:
user/assistant 輪次順序的限制。連續的 user/assistant 訊息將被合併為單一訊息而不是產生錯誤,而且我們不再要求第一則輸入訊息必須是 user 訊息。tool_choice 欄位中設定 disable_parallel_tool_use: true,以確保 Claude 最多使用一個工具。在平行工具使用中閱讀更多資訊。dangerouslyAllowBrowser: true 以啟用此功能。anthropic-beta: max-tokens-3-5-sonnet-2024-07-15 標頭,從 Claude Sonnet 3.5 生成長度多達 8,192 個 token 的輸出。Was this page helpful?