claude-quickstarts 是 Anthropic 官方維護的 Claude API 範例庫,2024 年 8 月建立,累積 21,068 顆星標與 3,500 個分支,採 MIT 授權。2026 年 11 月版本收錄十二個代管代理應用,11 月 6 日重建知識維基範例。

Claude Quickstarts 儲存庫的 README 開頭畫面,頂部為專案標題與說明文字,下方列出客戶支援代理、金融數據分析、電腦操作示範、瀏覽器操作示範與自主編碼代理等範例入口,每個條目附有簡短描述與目錄連結

Claude Quickstarts 是什麼?

Claude Quickstarts 是 Anthropic 官方維護的 Claude API 範例庫,2026 年 11 月版本收錄十二個代管代理專案,每個對應一種真實產品介面。

這個儲存庫的定位在 README 第一段寫得很清楚:每個範例都是一個完整、可執行的應用,配上一種真實的產品介面。它並非教學投影片,也不是單檔示範程式,而是可以直接複製、填入憑證、啟動服務的專案骨架。

從提交節奏可以看出專案的重心轉移。2025 年以前的更新集中在電腦操作示範與瀏覽器代理,2026 年 9 月之後的提交幾乎全部落在 managed-agents 目錄,包含 Slack、Linear、Sentry 與自架沙箱四類整合。最後一次提交發生在 11 月 6 日,內容是重建知識維基範例。

21,068星標
3,500分支
12代管代理範例
34貢獻者
118提交數
MIT授權

代管代理與自行部署有什麼分別?

代管代理由 Anthropic 代為執行,提供伺服器端工作階段、沙箱工具與事件串流。使用者不需要維持常駐程序,只需以檔案宣告代理、環境與排程,再讓平台代跑。

差異的核心在於誰持有那個一直開著的程序。自行部署的做法需要一台伺服器維持網路連線、處理重試與保存狀態;代管代理把這三件事搬進平台,應用端改為消費一條事件串流。

這種設計直接改變了部署的形狀。daily-brief 範例把代理、環境、兩個記憶儲存、一個憑證保險庫與一個排程部署全部寫成檔案,以 ant apply 一次套用,主機上沒有任何常駐程序。sentry 範例同樣以 cron 表示式啟動工作階段,沙箱本身不持有任何權杖。

代價是綁定。所有代管代理範例都需要 Managed Agents 的測試資格,SDK 為 2.0 以上版本,並在請求時附上測試標頭。若組織未開通此權限,client.beta.agents.create 會直接回傳權限錯誤,範例無法啟動。

十二個範例各自解決什麼問題?

十二個範例分四類:聊天介面三個、工作流整合兩個、事件處理兩個,其餘為知識維基與自架沙箱,各自對應一種產品介面。

電腦操作與瀏覽器操作兩個範例,與 Playwright MCP 的七十二個瀏覽器工具 屬同一路線,差別在於前者以代管工作階段執行、後者由本機代理驅動。

聊天介面一類重視的是工作階段與畫面的對應關係。assistant-ui 範例把側邊欄直接綁定 sessions.list,舊對話則是同一份事件日誌經過純函式重放;每個內建工具都有自己的卡片,bash 指令以 always_ask 標記,因此每條命令都會停在允許與拒絕的關卡。

工作流整合一類處理的是時序限制。Slack 範例必須在三秒內回應事件,Linear 範例必須在十秒內送出思考訊息,兩者都採用無狀態的 webhook 橋接,把頻道與討論串寫進工作階段的中繼資料,再由 session.status_idled 事件讀回並回覆。

事件處理一類的重點在無人看守時的行為。sentry-autofix 範例以簽章 webhook 為每個問題開啟一個工作階段,代理在掛載的儲存庫中以失敗測試重現錯誤、推送分支,再由主機端開啟拉取請求,因此儲存庫、基礎分支與問題編號都不由模型選擇。

知識維基如何把查詢成本降到十五分之一?

先把語料一次性蒸餾成版本化維基,之後每個問題直接讀維基。實測答案品質與大型模型相差約一分,每次查詢成本約為其十五分之一,維基建置成本約十九美元。

知識維基範例處理的是一個常見的浪費:代理每次回答都從原始文件重新檢索,同一個事實被反覆抽取,而跨文件之間的关系從未在任何單一片段中出現。這個範例改為先做一次蒸餾,把語料轉成純 Markdown 的記憶儲存。

建置流程由一個動態工作流完成。提取器分批處理文件並標記缺口,解析器針對缺口回頭查找,分析器核對每項陳述與原始文件是否相符,整理器最後統一整份維基的結構。整個過程只跑一次,之後所有查詢都以唯讀方式掛載維基。

範例附帶的實測數字值得留意。以小模型讀維基的答案,與大型模型直接搜尋原始文件的答案相差約一分,而比小模型自己搜尋文件好約三分。維基建置成本約十九美元,該次記錄的執行約十六美元,依基準數字約在第二百四十個問題之後開始回本。

若要自行組裝類似介面,CopilotKit 的生成式 UI 平台 提供另一條路徑,把前端元件直接綁定代理狀態。

每個事實都附上來源與時間戳,文件之間的衝突保持為衝突,被取代的數字維持被取代的標記。這個設計對併購盡職調查這類場景特別關鍵,因為兩份文件給出不同口徑的 EBITDA 時,正確做法是並列而非擇一。

自架沙箱為什麼是這次更新重點?

自架沙箱讓工作階段跑在自己控制的硬體上。環境是一條工作佇列,主機以環境金鑰輪詢並為每個工作階段啟動容器,適合需要在本地處理敏感語料的團隊。

self-hosted-sandboxes 目錄提供七種變體,全部共用同一個代理與環境定義。docker/ 是純命令列基準,docker-memory/ 在容器內執行 Python 工作程序,讓每個工作階段掛載記憶儲存並同步回寫,同時以每次工作階段權杖把環境金鑰留在容器之外。

archil/ 變體把容器換成持久沙箱,全部掛載同一塊七十 GB 的申報文件磁碟,讓多個分析師工作階段同時在原地工作。openshell/ 變體改用 NVIDIA 的沙箱,每個實例以 policy.yaml 限制在檔案系統白名單與六條 API 路由之內。

另外五個變體把啟動方式從輪詢改為 session.status_run_started webhook,分別跑在 Cloudflare 容器、無容器的 Cloudflare Worker、Daytona、Modal 與 Vercel Sandbox。這種排列方式的用意很明顯:同一份代理定義可以在七種基礎設施上執行,遷移成本只落在啟動那一段。

如何開始使用這些範例?

先安裝 ant 命令列工具並登入,複製儲存庫後進入目標範例目錄,依該目錄的 README 設定環境變數與憑證,最後以 ant apply 套用資源定義並啟動應用。

# 取得範例庫
git clone https://github.com/anthropics/claude-quickstarts.git
cd claude-quickstarts

# 安裝命令列工具並登入
# ant 需 2.0 以上版本
ant auth login

# 以每日簡報範例為例
cd managed-agents/daily-brief
cp .env.example .env      # 填入 Slack 與 GitHub 權杖
agents/setup.sh           # 一次套用六個資源定義

前置條件寫得很具體。每日簡報範例需要 ant 命令列工具與 jq,Slack 應用程式以 manifest 一鍵建立後取得機器人權杖,GitHub 則建議使用僅含讀取權限的細粒度權杖。設定腳本會在套用後把兩組憑證寫入保險庫,並先把排程設為暫停。

偏好設定是唯一需要手動補上的檔案。代理每次執行開始時會讀取唯讀儲存中的 /preferences.md,而 ant apply 只建立儲存本身,不會產生該檔案。

Claude Quickstarts 儲存庫首頁,顯示 21.1k 顆星標與 3.5k 個分支,右上為 About 區塊的專案描述與 MIT 授權標示,下方檔案列表可見 agents、autonomous-coding、browser-toolset 與 managed-agents 等目錄

這批範例有哪些限制?

全部範例依賴測試階段的代管代理服務,需組織開通權限。部分變體要求特定雲端平台帳號,自架沙箱亦需自行維護主機與容器執行環境。

最直接的限制是服務狀態。Managed Agents 目前為測試版本,官方說明為 API 組織預設開通,但若權限未生效,範例會在建立代理的第一步中斷。這代表讀者無法在無網路或純本機環境驗證整套流程。

其次是憑證與外部依賴的數量。Sentry 相關範例需要 Sentry 的 MCP 伺服器授權,Linear 範例需要在工作區安裝應用程式,Slack 範例需要把機器人加入每個要讀取的頻道。任何一項未完成,範例只會停在啟動階段。

第三是範例本身明示的邊界。browser-toolset 與 computer-toolset 兩個目錄在 README 中直接標明是介面示範而非生產程式碼,前者以 CDP 驅動單一 Chromium 分頁,後者以 RFB 協定驅動單一桌面。把它們當成可上線的元件會遇到可靠性問題。

出處連結有哪些?

原始碼與各範例說明位於 GitHub 的 anthropics/claude-quickstarts 儲存庫,平台文件另見 platform.claude.com。

  • GitHub 儲存庫:https://github.com/anthropics/claude-quickstarts
  • 代管代理總覽:https://platform.claude.com/docs/en/managed-agents/overview
  • 排程部署說明:https://platform.claude.com/docs/en/managed-agents/scheduled-deployments
  • 命令列工具文件:https://platform.claude.com/docs/en/cli-sdks-libraries/cli

總結:Claude Quickstarts 適合哪些團隊?

適合已使用 Claude API 並需要可執行起點的團隊,特別是打算把代理接上 Slack、Linear 或 Sentry 的情況。未開通代管代理權限者並不適合。

這個範例庫最大的價值不在功能清單,而在每個專案都把「哪些決定權不交給模型」寫成程式碼。Sentry 自動修復範例不讓代理選擇儲存庫與基礎分支,Slack 範例以簽章驗證回覆路由,知識維基範例讓偏好儲存保持唯讀。這些約束比任何提示詞技巧都更難抄錯。

導入的合理順序是先讀 assistant-ui 或 chat-sdk 這類門檻較低的範例,確認工作階段與事件串流的行為符合預期,再評估知識維基與自架沙箱。若團隊真正需要的是離線執行或自建推理後端,這批範例只能當作架構參考,實際落地仍需自行補上執行環境。

Claude Quickstarts 儲存庫的貢獻者與統計頁面,顯示主要貢獻者的提交數量分佈,以及儲存庫的語言組成與近期活動摘要