Claude Opus 5.5 提示詞指南:思考強度、AI 代理、拒絕與範本
Claude Opus 5.5 的提示詞怎麼寫:依據 Anthropic 官方指南,說明思考強度怎麼選、AI 代理提示詞範本、進度更新、拒絕原因與前端輸出。
以 Markdown 閱讀想為 Claude Opus 5.5 寫好提示詞:保留你在 Claude Opus 5 上用的提示詞,先設定思考強度(effort),再改措辭;接著針對每個想改變的行為,在系統提示詞裡加一句有針對性的指示。Anthropic 的指南說,現有的 Claude Opus 5 提示詞「不需修改也應該表現良好」,而思考強度是「在智慧、延遲與成本之間取捨時首先要調整的設定」。新增的建議大多和 AI 代理有關:讓無人看管的執行不中斷、讓長回合持續輸出進度、為多個代理組成的團隊控制節奏。下文全部來自 Anthropic 的《Prompting Claude Opus 5.5》指南與該模型的 API 參考,查證於 2026 年 10 月 3 日。
與 Claude Fable 5.1 共用的請求規則,例如不能預填助手回覆、不能自訂 temperature,已在 Claude Fable 5.1 提示詞指南中說明。本文只談 Claude Opus 5.5 特有的部分。
Claude Opus 5 的提示詞在 Claude Opus 5.5 上能用嗎?
能。Anthropic 說它們「不需修改也應該表現良好」,Claude Opus 5 的提示詞寫法「仍然是合理的起點」。改變的是模型如何分配它的思考。Claude Opus 5.5 產生輸出 token 的速度比 Claude Opus 5 快 30% 以上,完成同樣的任務往往用更少的 token。
Anthropic 列出了模型進步的四個面向,它們決定了這份指南中哪些部分與你有關:
- AI 代理程式設計與程式碼審查。 在真實程式碼庫中完成多步驟工作、搭配子代理的長時間自主執行,以及能抓出更多 bug、誤報更少的程式碼審查。
- 知識工作。 寫錯數字或引錯來源的可能性大幅降低,也能在大量輸入中發現細微的不一致,例如一個落在錯誤星期幾的日期。
- 溝通。 進度更新與最終報告會直接說清楚它做了什麼、發現了什麼、需要你提供什麼。
- 圖表、示意圖、螢幕截圖與電腦操作。 讀取視覺資料比 Claude Opus 5 更準確,即使在最低思考強度下也是如此。
如果你的提示詞主要用於聊天,讀思考強度與聊天兩節即可。如果你在執行 AI 代理,新的建議都在代理相關的幾節裡。
Claude Opus 5.5 應該用哪個思考強度?
從 medium 開始,這是 Claude Opus 5.5 的預設值(Claude Opus 5 預設是 high)。明確設定它,並用你自己的任務測試幾個等級,不要直接沿用在 Claude Opus 5 上用的值。不同模型的思考強度名稱並不對應相同的思考量:在 Anthropic 的測試中,medium 下的 Claude Opus 5.5「在程式設計與知識工作評測上達到或超過 high 下的 Claude Opus 5」,而在幾項程式設計評測中,low 也接近這個水準,成本卻低得多。
| 思考強度 | 典型用途(依 Anthropic 的 effort 文件) |
|---|---|
low | 需要最快速度與最低成本的簡單任務,例如子代理。如果你在 Claude Opus 5 上關閉過思考,也從這裡開始。 |
medium | Claude Opus 5.5 的預設值。需要在速度、成本與效果之間取得平衡的代理任務。 |
high | 複雜推理、困難的程式設計問題、代理任務。 |
xhigh | 長時間執行的代理與程式設計任務(超過 30 分鐘)。只在測得品質提升時使用。 |
max | 最深入的推理,不限制 token 消耗。只在測得品質提升時使用。 |
明確設定 medium 與不傳 effort 的效果完全相同。
在同一等級下,Claude Opus 5.5 每個回合的思考往往比 Claude Opus 5 多,在 xhigh 和 max 下尤其明顯。注意三點:
- 為
max_tokens留足空間。 即使你看不到思考內容,思考也計入max_tokens,所以依 Claude Opus 5 關閉思考時設定的上限可能會截斷回覆。對於長的代理程式設計回合,Anthropic 發現把max_tokens設為該模型的上限 128,000 效果很好。 - 想讓它少思考,先降思考強度,再考慮寫「少想一點」。 降低思考強度比提示詞指示更可靠地減少思考、成本與延遲。
- 依賴提示詞快取時,保持思考強度不變。 在請求之間更改頂層思考強度會讓提示詞快取失效。
思考強度在 output_config 中設定:
{
"model": "claude-opus-5-5",
"max_tokens": 128000,
"output_config": {"effort": "medium"},
"messages": [{"role": "user", "content": "Review this pull request for bugs and explain each one."}]
}Claude Opus 5.5 可以關閉思考嗎?
不行。Claude Opus 5 在 high 及以下思考強度接受 "thinking": {"type": "disabled"};Claude Opus 5.5 不接受,這樣的請求會回傳 400 錯誤。思考是自適應的,而且一律開啟。如果你的整合以前關閉了思考,Anthropic 建議做四項調整:
- 從
low思考強度開始並測量。 在low下,模型的思考很簡短。如果首個 token 的延遲仍然重要,可以在系統提示詞中加一句「Answer directly without deliberating.」進一步減少思考,但加上後要檢查品質。 - 刪掉替代思考的指示。 如果提示詞要求模型在回覆中寫出推理過程,刪掉這句,改從思考摘要讀取推理。現在,迫使模型在回覆中重述推理過程的提示詞可能會被拒絕(見下文拒絕一節)。
- 重新測試舊的變通做法。 為了避免關閉思考時出現的問題而加的規則可能已經不需要。任何要求模型不要思考的規則都要刪掉。
- 依區塊類型讀取回應。 回應不一定以
thinking區塊開頭,所以要逐一檢查區塊類型,不要假設第一個區塊就是文字。
想看推理過程,就請求思考摘要:
{
"model": "claude-opus-5-5",
"max_tokens": 16000,
"thinking": {"type": "adaptive", "display": "summarized"},
"output_config": {"effort": "low"},
"messages": [{"role": "user", "content": "Which of these three invoices has a total that does not match its line items?"}]
}怎樣讓無人看管的 Claude Opus 5.5 代理不提早停下?
在長任務中,Claude Opus 5.5 會一邊做一邊向使用者回報,其中一些回報會以文字而不是工具呼叫結束回合(stop_reason: "end_turn")。如果代理迴圈把每個這樣的回合都當成「任務完成」,就會在半路停下。Anthropic 的解法分成執行框架(harness)與提示詞兩部分。
在執行框架中,把純文字結束的回合當作一次回報,而不是任務已完成的證明。把任務的各個部分放進一份由模型更新的清單,例如待辦工具或一個檔案。如果某個回合結束時還有未完成的項目、又沒有說明阻塞原因,就送出一則簡短的使用者訊息把它們列出來:
Your task list still has open items: migrate the remaining two endpoints and update their tests. Continue with them. If one is blocked, say what is blocking it.同一個任務自動續跑兩三次後就停止,這樣真正卡住的執行會結束,可以拿來檢查。如果背景指令或子代理還在執行,就等它結束,再把輸出當作下一則使用者訊息傳回。
在系統提示詞中,點名你不希望出現的提早停止方式。Anthropic 的範例是為完全無人看管的代理寫的,要從工作階段的第一個請求起就放在系統提示詞末尾。中途才加會改變系統提示詞,讓對話中先前的思考區塊失效。
A standing instruction from the user, the person you are working for. It is about how your turns end. A message with no tool call in it ends your turn, and the work stops there until you are asked to continue. The user has seen you end turns in four ways while work they asked for was still owed, and does not want any of them. One: a long summary of what was done that closes by announcing the next step and has no tool call, so the next thing never starts. Two: an offer to carry on with something unless the user would prefer otherwise, which stops to wait for an answer the user was not going to give. Three: a list of decisions for the user when, by your own account, none of them blocks the rest of the work. Four: deciding that this is a good place to report, because the turn has been long or a milestone is done. Status notes are welcome, and so are your recommendations on open decisions, but put them in the same message as your next tool call and carry on with whatever does not depend on the user's answer. If you notice yourself inviting the user to redirect you or offering to wait, delete it and do the next thing. The stops the user does want are the ones where nothing can move without them, or where the thing blocking you is deliberately protected from you. This does not override the need for confirmation on risky or destructive actions.在有人參與的應用中不要加這段,因為有人會回答;對有風險或無法復原的操作,保留你自己的確認步驟。預計每個任務的工具呼叫與輸出 token 會多一些。
怎樣在 Claude Opus 5.5 代理長時間執行時取得進度更新?
在兩次工具呼叫之間,Claude Opus 5.5 會寫簡短的進度說明:剛發現了什麼、接下來做什麼。在這個模型上,這些說明以 thinking 區塊而不是 text 區塊回傳,而且預設內容是空的,所以只顯示 text 區塊的用戶端在長回合中看起來像沒有動靜。Anthropic 記載了一種 beta 顯示模式,會回傳每則說明的摘要;Claude Opus 5.5 API 參考列出了該端點文件中的 thinking.display 值。
另有三個提示詞與執行框架層面的手段,不需要任何特殊設定:
- 給模型一個傳送原文內容的工具。 如果它可能需要在回合中途把某樣東西原封不動交給使用者,例如一段程式碼,就給它一個簡單的「傳訊息給使用者」工具,並說明只用於這種情況。從第一個請求起就宣告這個工具;之後才加會讓先前的思考區塊失效。
- 要求在固定節點回報。 例如在第一次工具呼叫前用一句話說明打算做什麼,結束時做個簡短回顧。模型會嚴格遵循這類指示,在有人旁觀時最有用。
- 由執行框架提醒長時間沒有輸出的回合。 計算連續多少個工具呼叫步驟沒有給使用者任何可讀內容。達到若干個之後,例如五個,就在最新的工具結果後附加一則提醒,提醒兩三次後停止。Anthropic 的措辭:
The user hasn't heard from you in a while — say in a few words what you're doing, then continue.在 Anthropic 對代理程式設計任務的測試中,這則提醒讓出現長時間無輸出的任務比例大約減半,成本沒有可測量的變化。
怎樣讓 Claude Opus 5.5 代理先查看脈絡再動手?
Claude Opus 5.5 往往很快就開始動手。在橫跨電子郵件、文件、試算表與 CRM 紀錄的自動化流程中,任務所依賴的資訊常常藏在請求沒提到的地方,例如舊郵件串裡的一條政策,或另一個試算表分頁上的一條規則。在系統提示詞中加一句話,就能讓模型先四處看看:
Before taking any action, explore broadly with tool calls: list and open the emails, documents, spreadsheet tabs and records across the available apps that could be relevant to this task, including ones the task does not explicitly mention, and use what you find.在 Anthropic 對多應用程式任務的測試中,加了這句後模型正確完成的任務明顯更多,medium 和 max 思考強度下都是如此,代價是工具呼叫略多。因為這句話要求模型依據找到的內容行動,所以不要讓不可信的內容出現在它搜尋的紀錄中。
怎樣讓多個 Claude Opus 5.5 代理組成的團隊更快完成?
Claude Opus 5.5 很留意已經過的時間。在由主代理把工作分派給子代理的架構中,給它一個時間預算:讓執行框架在每則傳回給模型的訊息末尾加上一行簡短說明,例如 elapsed 340s / 1200s。模型會調整節奏,在預算內完成,而且通常遠早於預算,所以把預算設得比你真正想花的時間稍長一些。如果無法估算預算,就只顯示已經過的時間,並在系統提示詞中加上這句:
Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better.預算只是建議,到了上限也不會強制停止,需要硬性截止就保留你自己的逾時設定。收緊預算不等於降低思考強度:降低思考強度會減少工作本身,而預算主要讓更多代理並行工作。在時間壓力下,模型的搜尋與查核可能會少一些,所以要用你自己的任務檢查答案品質。
聊天用的系統提示詞應該要 Claude Opus 5.5「仔細思考」嗎?
不應該。Anthropic 建議從聊天用的系統提示詞中刪掉「think carefully before answering」(回答前仔細思考)這類句子:思考多少由模型自己決定,控制手段是思考強度。在 Anthropic 對一款聊天產品的測試中,刪掉這類句子後回覆開始得更快,品質沒有明顯下降。
另外還有兩句聊天情境值得知道。一句讓模型把先前的回答視為定案,讓後續回合更快開始;另一句標記使用者貼上的文字,讓模型不去執行藏在郵件或網頁裡的指示。這兩句的原文都在 Fable 5.1 提示詞指南的 Claude Opus 5.5 一節中。在長篇分析與代理任務中不要加「回答已定案」那句,因為後面的步驟可能會揭露前面的錯誤。
怎樣讓 Claude Opus 5.5 更準確地讀圖表、示意圖與截圖?
先重新測試。不借助額外工具時,Claude Opus 5.5 讀密集圖表、流程圖與行事曆截圖的準確度遠高於 Claude Opus 5;在 Anthropic 的測試中,它即使在最低思考強度下,從密集圖表讀取數值也比最高思考強度下的 Claude Opus 5 更準確。為舊模型搭建的輔助流程可能已經不需要了。
對於最密集的輸入,有兩件事仍然有幫助:
- 更高解析度的圖片,對技術圖紙最有用。
- 影像工具。 讓模型以代理身分執行,並給它一個存放原始圖片、裝有 PIL 或 OpenCV 的容器,讓它能裁切、放大與測量。如果這太重,只給一個裁切工具也有幫助。思考強度越高,模型越能善用這些工具。
不用工具時,提高思考強度能改善它對技術圖紙的判讀,但對圖表幫助不大。圖片以帶 URL 來源的 image 區塊放在使用者回合中,格式見 API 參考。
怎樣讓 Claude Opus 5.5 的前端輸出不再千篇一律?
點名你不想要的樣式。沒有設計方向時,Claude Opus 5.5 會退回幾種預設風格,而「避免 AI 感的通用外觀」這種籠統的話,大多只是把一種預設換成另一種。Anthropic 的範例列出了具體要避免的東西:
Output a vanilla HTML/CSS personal website with placeholder data. Do not use a cream or off-white background, italic accent words in headlines, numbered "01/02/03" section labels, monospace labels, or pill-shaped buttons.反覆調整:看看第一版改用了哪些樣式,再把它們加進清單。
Claude Opus 5.5 為什麼回傳 stop_reason "refusal"?
是安全分類器拒絕了這個請求。Claude Opus 5.5 執行針對生物、資安與推理擷取的分類器,拒絕會以一個正常回應回傳,其中 stop_reason: "refusal",stop_details 物件會寫明類別。
| 類別 | 涵蓋什麼 | 怎麼處理 |
|---|---|---|
| 生物 | 與 Claude Fable 5.1 相同的安全措施;如果你從 Claude Opus 5 遷移過來,這是新的。日常健康與教育類問題不受影響。 | 從事生命科學工作的機構可以申請 Anthropic 的 Life Sciences Verification Program。 |
| 資安 | 高風險的軍民兩用資安活動。 | 在原始碼中尋找漏洞是允許的,不需調整。 |
| 推理擷取 | 迫使模型在回覆中重述其內部推理過程的提示詞。 | 刪掉這些指示,設定 "display": "summarized",從思考區塊讀取。簡短解釋答案仍然可以。 |
關於無害請求被拒絕的一般情況,見 Fable 5.1 指南中的為什麼 Claude 會拒絕一個無害的請求。
常見問題
有官方的 Claude Opus 5.5 提示詞指南嗎?
有。Anthropic 在開發者文件中發布了《Prompting Claude Opus 5.5》,另有一頁適用於所有目前 Claude 模型的通用提示詞最佳做法。本文整理的是截至 2026 年 10 月 3 日的 Opus 5.5 指南,範本為逐字引用。
Claude Opus 5.5 預設的思考強度是什麼?
medium。Claude Opus 5 預設是 high。可選等級為 low、medium、high、xhigh 與 max,在 output_config.effort 中設定。
Claude Opus 5.5 最多能輸出多少 token?
每個請求最多 128,000 個 token,這個上限包含思考。上下文視窗為 1M token。
可以預填 Claude Opus 5.5 的回覆或設定 temperature 嗎?
不行。預填助手回覆與預設值以外的任何 temperature 都會回傳 400 錯誤,也不支援強制呼叫某個工具。請改為在提示詞中描述你想要的格式。Fable 5.1 提示詞指南說明了每種情況該用什麼替代。
Claude Opus 5.5 和 Claude Fable 5.1,哪個更適合做 AI 代理?
取決於任務與預算;Claude 模型比較說明了怎麼選。兩者的提示詞建議主要差在預設值:Claude Opus 5.5 從 medium 思考強度開始,Claude Fable 5.1 從 high 開始。
試試這些提示詞
用一組 SeedRouter 金鑰,透過 Anthropic SDK,或 OpenAI 的 Chat Completions 與 Responses 格式,在 Claude Opus 5.5 上執行這些範本。Claude Opus 5.5 API 參考列出了所有參數,模型頁顯示目前依 token 計的價格。SeedRouter 依用量付費:一次儲值,額度永不過期,失敗的請求不收費。



