Anthropic Claude Managed Agents 公測上線：5 分鐘跑通全託管 AI 代理

2026 年 4 月 8 日，Anthropic 在 Claude Platform 正式開放了 Claude Managed Agents 的 Public Beta。這套全新的全託管代理框架（Managed Agent Harness）把"Agent 循環 + 工具執行 + 沙箱容器 + 狀態持久化"打包成一組 REST API，開發者不再需要自己搭建 agent loop、工具調用層或運行時，只要調用 /v1/agents、/v1/environments、/v1/sessions 三個端點，就能讓 Claude 以自主代理的方式在安全沙箱中完成長耗時任務。

本次公測同時發佈了 managed-agents-2026-04-01 Beta 請求頭、新的 agent_toolset_20260401 工具集，以及基於 Server-Sent Events 的事件流協議。本文結合官方文檔與最新 Release Notes，系統梳理 Claude Managed Agents 的核心概念、API 接入方式、事件模型與計費規則，並給出一份可直接複用的 Python / curl 快速上手代碼，幫助你在 5 分鐘內跑通一次真實的 Managed Agent 會話。

Claude Managed Agents 是什麼：託管代理的核心定位

在理解 Managed Agents 之前，需要先釐清它與傳統 Messages API 的關係。Anthropic 現在提供兩條構建路徑：Messages API 負責直接調用模型，適合需要完全控制 agent loop 的場景；Managed Agents 則提供預構建、可配置的代理運行環境，適合長耗時、異步化、需要沙箱隔離的工作負載。

與 Messages API 的定位差異

🎯 選型建議：如果你正在構建一個需要"AI 自主寫代碼、跑腳本、瀏覽網頁再彙總結果"的後臺任務，Managed Agents 會比手工串聯 Messages API + 自建沙箱更省事。建議在 API易 apiyi.com 平臺上做一次兩者的對比測試，快速判斷自己的業務更適合哪種形態。

四大核心概念

Claude Managed Agents 圍繞四個基礎概念構建：

• Agent（代理）：模型、系統提示詞、工具、MCP Servers 與 Skills 的靜態定義，創建一次後可被多個會話複用，支持版本化。
• Environment（環境）：雲端容器模板，描述預裝軟件包、網絡訪問策略以及掛載文件。
• Session（會話）：指定 Agent + Environment 的具體運行實例，負責執行一次性或長耗時任務。
• Events（事件）：Session 與客戶端之間交換的消息，包括用戶消息、工具調用、工具結果、狀態變更等。

Managed Agents 核心能力盤點：沙箱、工具集與 SSE 流

理解四大概念之後，我們來逐個看它們在 Beta 版本中提供了哪些實際能力。

安全沙箱與容器配置

每個 Session 運行在一個隔離的雲端容器中，具備以下特性：

• 預裝運行時：Python、Node.js、Go 等主流語言環境開箱即用。
• 網絡策略：支持 unrestricted（無限制）和更嚴格的受限網絡模式，避免沙箱成爲數據外傳通道。
• 文件系統：容器內的文件在會話生命週期中持久化，Agent 可以跨輪次讀寫。
• 可掛載資源：可在 Environment 中預先掛載數據文件或腳本。

內置工具集 agent_toolset_20260401

公測版本提供了一個統一的工具集標識 agent_toolset_20260401，一次性啓用所有預構建工具：

🎯 開發者提示：agent_toolset_20260401 是一個"組合開關"，方便快速原型驗證。生產環境建議根據最小權限原則按需啓用子集。如果想在 API易 apiyi.com 對比不同工具子集的 token 成本，可直接切換 base_url 後複用同一段代碼。

Server-Sent Events 流式事件模型

與傳統 Messages API 的"一次請求 → 一次響應"不同，Managed Agents 採用事件驅動 + SSE 推送模型。關鍵事件類型如下：

快速上手 Claude Managed Agents：API 接入完整流程

下面用最短的代碼演示一次完整的 Managed Agent 會話。核心步驟包括：創建 Agent → 創建 Environment → 創建 Session → 發送消息並訂閱 SSE 流。

前置條件

1. 一個 Claude API Key（或 API易 apiyi.com 的兼容 Key）。
2. 每次請求攜帶 anthropic-beta: managed-agents-2026-04-01 頭；官方 SDK 會自動附加，手工 curl 需顯式聲明。
3. Python SDK 升級到最新版本：pip install -U anthropic。

極簡 Python 示例

from anthropic import Anthropic

client = Anthropic（
    # 使用 API易中轉可複用現有代碼，無需改動 SDK 用法
    base_url="https://api.apiyi.com"，
    api_key="YOUR_API_KEY"，
）

# 1. 創建 Agent
agent = client.beta.agents.create（
    name="Coding Assistant"，
    model="claude-sonnet-4-6"，
    system="You are a helpful coding assistant."，
    tools=[{"type": "agent_toolset_20260401"}]，
）

# 2. 創建 Environment（無限制網絡）
env = client.beta.environments.create（
    name="quickstart-env"，
    config={"type": "cloud"， "networking": {"type": "unrestricted"}}，
）

# 3. 創建 Session
session = client.beta.sessions.create（
    agent=agent.id，
    environment_id=env.id，
    title="Quickstart session"，
）

# 4. 打開 SSE 流併發送用戶消息
with client.beta.sessions.events.stream（session.id） as stream:
    client.beta.sessions.events.send（
        session.id，
        events=[{
            "type": "user.message"，
            "content": [{
                "type": "text"，
                "text": "Generate the first 20 Fibonacci numbers to fibonacci.txt"，
            }]，
        }]，
    ）
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                print（block.text， end=""）
        elif event.type == "agent.tool_use":
            print（f"\n[Using tool: {event.name}]"）
        elif event.type == "session.status_idle":
            print（"\n\nAgent finished."）
            break

# 攜帶 Beta 頭創建 Agent
curl -sS https://api.apiyi.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "Coding Assistant"，
    "model": "claude-sonnet-4-6"，
    "system": "You are a helpful coding assistant."，
    "tools": [{"type": "agent_toolset_20260401"}]
  }'

# 創建 Environment、Session 的請求結構類似，見官方 quickstart 文檔
# 訂閱 SSE 流時使用：
# curl -N -H "Accept: text/event-stream" \
#   https://api.apiyi.com/v1/sessions/$SESSION_ID/stream

🎯 代碼複用建議：上面的 base_url 指向 API易 apiyi.com，即可在中國大陸以低延遲訪問 Managed Agents 公測接口。官方 SDK 的所有參數、Beta 頭、事件類型完全兼容，無需二次封裝。

五步流程圖解

[Client] ──1. create agent──────────▶ [API]
[Client] ──2. create environment────▶ [API]
[Client] ──3. create session────────▶ [API]
[Client] ──4. open SSE stream───────▶ [API]
[Client] ──5. send user.message─────▶ [API]
         ◀─ agent.message / tool_use / tool_result / status_idle ──

整個過程的核心是：事件先行，流式接收。官方建議先打開 SSE 流再發送 user 事件，這樣不會錯過任何中間狀態。

Claude Managed Agents 關鍵規則：限流、計費與品牌合規

公測版本已經給出了明確的生產參數。以下是開發者最關心的三項規則。

限流規則

限流以**組織（Organization）**爲單位統計，與賬號下的 Tier 相互獨立：

除此之外，組織級的消費額度和 Tier 速率上限依然生效。高併發的批量代理任務需要提前做限流規劃，或者通過 API易 apiyi.com 分攤到多賬號資源池。

計費模型

Managed Agents 的計費由兩部分組成：

1. Session 運行時費用：$0.08 / 會話小時。
2. 模型 Token 費用：按所選 Claude 模型（如 Sonnet 4.6 / Opus 4.6）的標準單價計費。

沒有額外訂閱、沒有固定基礎設施成本。這意味着空閒但未關閉的 Session 仍會按小時計費，務必在任務結束後調用結束接口。

品牌合規要點

Anthropic 對合作伙伴使用 Claude 品牌提出了明確約束：

• ✅ 允許：Claude Agent、Claude（菜單語境內）、{YourAgentName} Powered by Claude。
• ❌ 禁止：Claude Code、Claude Code Agent、Claude Cowork 等名稱；禁止模仿 Claude Code 的 ASCII art 或視覺元素。

🎯 合規建議：面向企業交付的託管代理產品，建議保持自身品牌主體地位，僅在技術說明中以"Powered by Claude"的方式致謝。若需要正式的品牌授權或模板化 UI，可通過 API易 apiyi.com 獲取合作渠道的對接指引。

Claude Managed Agents 典型應用場景：哪些業務最值得遷移

公測版本雖然仍有部分功能（outcomes、multiagent、memory）處於 Research Preview，但對於以下四類場景已經可以立即落地。

適合立即遷移的四類工作負載

暫不建議使用的場景

• 極低延遲的實時對話：Session 啓動和 SSE 開銷對百毫秒級 UI 不友好。
• 強合規的本地化部署：Managed Agents 是雲服務，不支持 on-prem。
• 需要完全自定義 agent loop 的研究型項目：依然建議走 Messages API 自建循環。

🎯 遷移路徑建議：把現有"Messages API + 自建工具調度"的代理業務先用 Managed Agents 做一個對照實現，用同一份 Prompt 跑兩版，比較 token 成本與完成率。通過 API易 apiyi.com 可以用同一個 Key 同時訪問兩種接口，避免並行評測時切換密鑰。

常見問題 FAQ：Managed Agents 上手避坑

Q1：managed-agents-2026-04-01 是否需要手工附加？

使用官方 SDK（Python / TypeScript / Go / Java / C# / Ruby / PHP）時無需手動附加，SDK 會在 Beta 路徑下自動注入。只有在使用原生 curl 或自建 HTTP 客戶端時，才需要顯式加上 anthropic-beta: managed-agents-2026-04-01。建議通過 API易 apiyi.com 中轉時依然按標準路徑請求，兼容性最佳。

Q2：SSE 流斷開後會話會丟失嗎？

不會。Session 的事件歷史在服務端持久化，斷線後重連 /v1/sessions/{id}/stream 端點即可繼續接收後續事件，API 會從斷點緩衝區中補推。這一點與 Messages API 的"一次請求一次響應"完全不同。

Q3：如何中斷正在運行的 Agent？

Managed Agents 支持 mid-execution steering：向同一個 Session 的 /events 端點再發送一條 user.message，即可打斷當前工具調用循環並改變方向。也可以通過專門的中斷端點強制終止會話。

Q4：Session 費用會在什麼情況下產生？

只要 Session 處於"可運行"狀態就會按 $0.08/小時計費，即使 Agent 處於 status_idle。建議任務完成後顯式關閉 Session，避免空跑費用。結合 API易 apiyi.com 的賬單明細面板可以快速發現異常空閒會話。

Q5：Managed Agents 支持哪些 Claude 模型？

公測當前支持 Claude Sonnet 4.6、Claude Opus 4.6、Claude Haiku 4.5 三款主力模型。長上下文（1M token）在 Opus 4.6 / Sonnet 4.6 上默認可用，不需要額外 Beta 頭。

Q6：能否把現有 Agent Skills / MCP Server 搬過來？

可以。Agent 定義中可直接聲明 MCP Servers 列表和 Skills 引用，Managed Agents 複用了 2025 年 10 月發佈的 Agent Skills Beta 協議，已有的技能包無需改造即可接入。

總結：Managed Agents 帶來的開發範式躍遷

Claude Managed Agents 公測上線標誌着 Anthropic 正式把"Agent 基礎設施"納入官方產品線。對於開發者來說，這次更新的價值不在於某個單點功能，而在於一次性消除了自建 Agent 系統的五大痛點：循環實現、工具執行、沙箱隔離、狀態持久化、事件流協議。只需附加 managed-agents-2026-04-01 Beta 請求頭並調用三個端點，就能把 Claude 變成真正的"自主可執行代理"。

結合最新的 Claude Sonnet 4.6 / Opus 4.6 模型、1M token 上下文、Agent Skills 與自動緩存，Managed Agents 讓長耗時、異步、多工具的後臺代理業務首次具備了企業級可複製的落地路徑。下一步，建議先在低風險場景（如自動化報告、代碼腳手架）中試點，再逐步遷移關鍵業務。

🎯 行動建議：準備開始遷移的團隊，推薦把 base_url 指向 API易 apiyi.com，既能複用官方 SDK 代碼，又能獲得穩定的國內訪問速率，同時支持 Messages API 與 Managed Agents 雙軌並行評測，爲選型決策留足數據。

— APIYI Team（API易 apiyi.com 技術團隊）