1647 字
8 分鐘

Claude Workbench 舊版 8 月 17 日退場:Prompt、Eval 與檔案怎麼匯出

如果你以前把 Claude Workbench 當成 prompt library 或簡易 eval 工具,現在要先處理資料保存。Anthropic 官方 release notes 說明,Workbench legacy 會在 2026 年 8 月 17 日對所有使用者退場;新版 Workbench 不支援舊版的 saved prompts、prompt history 和 evals。

這不是 Claude Messages API 整體下線。真正需要分流的是三件事:舊 Workbench 資料要不要保存、程式碼是否仍呼叫 experimental prompt tools,以及新 Workbench 能不能承接你的測試流程。先完成匯出,再決定要把 prompt 搬到 repository、測試工具或其他管理方式。

先分清楚 Workbench legacy 與新版#

兩個入口名字相同,但保存模型不同。新版 Workbench 主要是用來試跑 Claude model 和 API 功能;舊版則保存 prompt、版本、completions,並提供 eval 相關工作流。

項目Workbench legacy新版 Workbench
使用狀態既有使用者可用至 2026-08-17可在 Claude Console 試跑模型與 API 功能
Prompt history可存取舊資料不保存 prompt history
Prompt versions可匯出不支援
Eval可匯出相關資料不提供舊版 eval 工作流
Completions、上傳檔案可在匯出時選擇不會自動匯入
程式碼可取得舊版範例可從目前 request 匯出 code snippet

Anthropic Help Center 也說明,新版 Workbench 的目前草稿留在瀏覽器,並直接對應公開的 Messages API request;它不是一個會自動接手舊資料的 prompt database。

8 月 17 日前的匯出流程#

如果你仍看得到 legacy 入口,建議為每個 workspace 執行一次,不要只匯出自己最常用的 prompt。

  1. 登入 Claude Console,開啟 Workbench legacy。
  2. 先查看 prompt list,確認需要保存的 prompt、prompt revisions、completions 和 eval。
  3. 點選頁面上方的 Export data
  4. 在匯出對話框選擇要包含的資料;除了 prompts,也可選 Model completionsUploaded files
  5. 點選 Export,等待 Anthropic 寄送 JSON 匯出下載連結。
  6. 下載後在本機解壓或保存,檢查 prompt 數量、版本與附件是否真的包含在內。

官方說明指出,選擇 completions 或上傳檔案可能讓匯出檔變大;若團隊有多個 workspace,也要分別確認資料歸屬,避免只保存到個人帳號的資料夾。

匯出檔先做敏感資料檢查

Prompt、completion 和上傳檔案可能含有 API response、客戶資料、內部規格或測試金鑰。下載後先移除不應進 Git 的內容,再決定要存到私有 repository、加密儲存或團隊文件系統;不要為了方便把原始 JSON 直接放進公開 repository。

匯出後要保存什麼,不要只保存 JSON#

JSON 是資料備份,不一定是未來可重跑的測試套件。我會把匯出內容再整理成三層:

  1. Prompt source:保留 system prompt、user prompt、模型、temperature、max tokens 和使用的工具定義。
  2. Test cases:從原本的 eval 或人工測試中挑出輸入、預期行為、不可接受的輸出與判定理由。
  3. Reference outputs:保存少量經過審核的 completion,並標記模型、日期和用途,不把它當成永久正解。

如果這些 prompt 會用在 coding agent,還要把「允許讀哪些資料、是否能呼叫外部工具、誰負責審核輸出」一併寫入 README。這比把一整份匯出檔丟進資料夾更容易在半年後重建流程。

檢查程式碼是否仍呼叫 experimental prompt tools#

Workbench legacy 的退場也會影響使用 Claude Platform experimental prompt tools 的程式。官方 release notes 列出的 endpoint 包含:

  • /v1/experimental/generate_prompt
  • /v1/experimental/improve_prompt
  • /v1/experimental/templatize_prompt

官方表示這些 endpoint 會在 8 月 17 日隨 Workbench 一起退休,移除後請求會回傳錯誤。可以先在 application 和部署設定中搜尋:

Terminal window
rg -n \
'experimental/(generate_prompt|improve_prompt|templatize_prompt)|generate_prompt|improve_prompt|templatize_prompt' \
. \
--glob '!node_modules/**' \
--glob '!dist/**'

命中後先確認它是文件、測試,還是真的 production code。官方公告沒有承諾這些 endpoint 會自動改寫成另一個 API,因此不要只把 URL 替換成猜測的路徑;先記錄目前輸入、輸出、錯誤處理和 fallback,再依公開的 Messages API 或自有評測流程重新實作。

新版 Workbench 能做什麼#

若你的需求是「試一個模型、看 request/response、確認 token usage,再匯出可執行程式碼」,新版 Workbench 仍然適用。它可以:

  • 選擇模型與調整 temperature、maximum output tokens。
  • 測試 tools 和 structured outputs。
  • 查看 raw request、raw response、stop reason 與 usage。
  • 透過 code toggle 匯出目前 request 的程式碼片段。

但新版不會保存 prompt history、prompt versions、eval 或 prompt sharing,也不能把 legacy 匯出資料直接 import 回去。需要長期追蹤的 prompt 和測試案例,應搬到可版本控制、可審核的儲存方式,而不是繼續把瀏覽器中的當前草稿當成備份。

一份可以在今天完成的遷移清單#

  • 逐一登入仍有 legacy 存取權的 workspace。
  • 匯出 prompts、prompt versions、需要的 completions、eval 和上傳檔案。
  • 下載 JSON 並檢查附件、敏感資訊與資料完整性。
  • 搜尋 codebase 是否使用三個 experimental prompt tools endpoint。
  • 把重要 prompt 和 eval case 整理成可版本控制的格式。
  • 用新版 Workbench 或 Messages API 重跑最小測試,記下輸入、模型、日期和差異。
  • 在 2026-08-17 後再做一次 smoke test,確認正式環境沒有依賴已退休 endpoint。

這次變動最需要把握的不是新版 Workbench 的介面,而是保存期限。先把 legacy 資料拿出來,再決定哪些內容要變成 prompt source、測試案例或程式碼,遷移成本會比事後重新猜測舊設定低很多。

常見問題#

Q: Workbench legacy 退場會讓 Claude Messages API 一起停止嗎?#

A: Anthropic 公告的退場範圍是 Workbench legacy 與三個 experimental prompt tools endpoint;新版 Workbench 本身直接建立在公開 Messages API 上。不要把 Workbench 介面退場解讀成 Messages API 一起下線,但仍要單獨確認 application 使用的 endpoint。

Q: 新版 Workbench 可以匯入舊版 prompt 和 eval 嗎?#

A: 不行。官方 Help Center 說明新版 Workbench 不保存舊版 prompt、prompt history、prompt versions 或 eval,也沒有 legacy data import。請在 8 月 17 日前用 legacy 的 Export data 保存,再由團隊自行整理成版本控制或測試工具可讀的格式。

Q: 只保存 prompts,不匯出 completions 可以嗎?#

A: 如果只需要保留輸入模板,可以;但若你要重建 eval、比較模型輸出或追查歷史決策,就應一併匯出需要的 completions 和上傳檔案。匯出前先檢查敏感資料,避免把原始 response 當成可以公開分享的測試資料。

參考資料:

Claude Platform release notes

Claude Help Center:How do I use the Workbench?

Claude API Docs:Messages API

Claude Workbench 舊版 8 月 17 日退場:Prompt、Eval 與檔案怎麼匯出
https://laplusda.com/posts/claude-workbench-legacy-export-checklist/
作者
Zero
發佈於
2026-08-12
許可協議
CC BY-NC-SA 4.0
這篇文章有幫助嗎?

回報錯字、失效連結,或告訴我你想看的延伸主題。