指南

託管 Agent SDK

在生產環境中部署和託管 Claude Agent SDK

Claude Agent SDK 與傳統的無狀態 LLM API 不同，它維護對話狀態並在持久環境中執行命令。本指南涵蓋了在生產環境中部署基於 SDK 的代理的架構、託管考量和最佳實踐。

有關基本沙箱之外的安全強化——包括網路控制、憑證管理和隔離選項——請參閱安全部署。

託管需求

基於容器的沙箱

為了安全性和隔離性，SDK 應在沙箱容器環境中運行。這提供了程序隔離、資源限制、網路控制和臨時檔案系統。

SDK 還支援用於命令執行的程式化沙箱配置。

系統需求

每個 SDK 實例需要：

執行時依賴
- Python 3.10+（用於 Python SDK）或 Node.js 18+（用於 TypeScript SDK）
- Node.js（Claude Code CLI 所需）
- Claude Code CLI：npm install -g @anthropic-ai/claude-code
資源分配
- 建議：1GiB RAM、5GiB 磁碟空間和 1 CPU（根據您的任務需求進行調整）
網路存取
- 對 api.anthropic.com 的出站 HTTPS
- 可選：存取 MCP 伺服器或外部工具

了解 SDK 架構

與無狀態 API 呼叫不同，Claude Agent SDK 作為長時間運行的程序運作，它：

在持久 shell 環境中執行命令
在工作目錄中管理檔案操作
利用先前互動的上下文處理工具執行

沙箱提供商選項

多家提供商專門提供用於 AI 程式碼執行的安全容器環境：

有關自託管選項（Docker、gVisor、Firecracker）和詳細的隔離配置，請參閱隔離技術。

生產部署模式

模式 1：臨時會話

為每個使用者任務建立新容器，完成後銷毀。

最適合一次性任務，使用者仍可在任務完成期間與 AI 互動，但一旦完成，容器即被銷毀。

範例：

錯誤調查與修復：使用相關上下文除錯並解決特定問題
發票處理：從收據/發票中提取和結構化資料，用於會計系統
翻譯任務：在語言之間翻譯文件或內容批次
圖片/影片處理：對媒體檔案套用轉換、最佳化或提取中繼資料

模式 2：長時間運行會話

維護持久容器實例以處理長時間運行的任務。通常根據需求在容器內運行_多個_ Claude Agent 程序。

最適合無需使用者輸入即可主動採取行動的代理、提供內容的代理或處理大量訊息的代理。

範例：

電子郵件代理：監控收到的電子郵件，並根據內容自主分類、回覆或採取行動
網站建構器：為每個使用者託管自訂網站，透過容器連接埠提供即時編輯功能
高頻聊天機器人：處理來自 Slack 等平台的持續訊息流，快速回應時間至關重要

模式 3：混合會話

使用歷史記錄和狀態填充的臨時容器，可能來自資料庫或 SDK 的會話恢復功能。

最適合使用者間歇性互動的容器，啟動工作後在工作完成時關閉，但可以繼續。

範例：

個人專案管理員：透過間歇性檢查幫助管理進行中的專案，維護任務、決策和進度的上下文
深度研究：進行數小時的研究任務，儲存發現並在使用者返回時恢復調查
客戶支援代理：處理跨多次互動的支援工單，載入工單歷史和客戶上下文

模式 4：單一容器

在一個全域容器中運行多個 Claude Agent SDK 程序。

最適合必須緊密協作的代理。這可能是最不常見的模式，因為您必須防止代理互相覆寫。

範例：

模擬：在電子遊戲等模擬中彼此互動的代理。

常見問題

如何與我的沙箱通訊？

在容器中託管時，開放連接埠以與您的 SDK 實例通訊。您的應用程式可以為外部客戶端開放 HTTP/WebSocket 端點，而 SDK 在容器內部運行。

託管容器的成本是多少？

我們發現服務代理的主要成本是 token，容器成本因您配置的內容而異，但最低成本大約為每小時運行 5 美分。

何時應該關閉閒置容器而非保持其運行？

這可能取決於提供商，不同的沙箱提供商會讓您設定不同的閒置超時標準，超時後沙箱可能會關閉。您需要根據您認為使用者回應的頻率來調整此超時時間。

應該多久更新一次 Claude Code CLI？

Claude Code CLI 使用 semver 版本控制，因此任何破壞性變更都會進行版本控制。

如何監控容器健康狀況和代理效能？

由於容器本質上就是伺服器，您用於後端的相同日誌基礎設施也適用於容器。

代理會話在超時前可以運行多長時間？

代理會話不會超時，但我們建議設定 'maxTurns' 屬性以防止 Claude 陷入迴圈。

後續步驟

安全部署 - 網路控制、憑證管理和隔離強化
TypeScript SDK - 沙箱設定 - 以程式化方式配置沙箱
會話指南 - 了解會話管理
權限 - 配置工具權限
成本追蹤 - 監控 API 使用量
MCP 整合 - 使用自訂工具進行擴展

Was this page helpful?

指南

託管 Agent SDK

在生產環境中部署和託管 Claude Agent SDK

有關基本沙箱之外的安全強化——包括網路控制、憑證管理和隔離選項——請參閱安全部署。

託管需求

基於容器的沙箱

為了安全性和隔離性，SDK 應在沙箱容器環境中運行。這提供了程序隔離、資源限制、網路控制和臨時檔案系統。

SDK 還支援用於命令執行的程式化沙箱配置。

系統需求

每個 SDK 實例需要：

執行時依賴
- Python 3.10+（用於 Python SDK）或 Node.js 18+（用於 TypeScript SDK）
- Node.js（Claude Code CLI 所需）
- Claude Code CLI：npm install -g @anthropic-ai/claude-code
資源分配
- 建議：1GiB RAM、5GiB 磁碟空間和 1 CPU（根據您的任務需求進行調整）
網路存取
- 對 api.anthropic.com 的出站 HTTPS
- 可選：存取 MCP 伺服器或外部工具

了解 SDK 架構

與無狀態 API 呼叫不同，Claude Agent SDK 作為長時間運行的程序運作，它：

在持久 shell 環境中執行命令
在工作目錄中管理檔案操作
利用先前互動的上下文處理工具執行

沙箱提供商選項

多家提供商專門提供用於 AI 程式碼執行的安全容器環境：

有關自託管選項（Docker、gVisor、Firecracker）和詳細的隔離配置，請參閱隔離技術。

生產部署模式

模式 1：臨時會話

為每個使用者任務建立新容器，完成後銷毀。

最適合一次性任務，使用者仍可在任務完成期間與 AI 互動，但一旦完成，容器即被銷毀。

範例：

錯誤調查與修復：使用相關上下文除錯並解決特定問題
發票處理：從收據/發票中提取和結構化資料，用於會計系統
翻譯任務：在語言之間翻譯文件或內容批次
圖片/影片處理：對媒體檔案套用轉換、最佳化或提取中繼資料

模式 2：長時間運行會話

維護持久容器實例以處理長時間運行的任務。通常根據需求在容器內運行_多個_ Claude Agent 程序。

最適合無需使用者輸入即可主動採取行動的代理、提供內容的代理或處理大量訊息的代理。

範例：

電子郵件代理：監控收到的電子郵件，並根據內容自主分類、回覆或採取行動
網站建構器：為每個使用者託管自訂網站，透過容器連接埠提供即時編輯功能
高頻聊天機器人：處理來自 Slack 等平台的持續訊息流，快速回應時間至關重要

模式 3：混合會話

使用歷史記錄和狀態填充的臨時容器，可能來自資料庫或 SDK 的會話恢復功能。

最適合使用者間歇性互動的容器，啟動工作後在工作完成時關閉，但可以繼續。

範例：

個人專案管理員：透過間歇性檢查幫助管理進行中的專案，維護任務、決策和進度的上下文
深度研究：進行數小時的研究任務，儲存發現並在使用者返回時恢復調查
客戶支援代理：處理跨多次互動的支援工單，載入工單歷史和客戶上下文

模式 4：單一容器

在一個全域容器中運行多個 Claude Agent SDK 程序。

最適合必須緊密協作的代理。這可能是最不常見的模式，因為您必須防止代理互相覆寫。

範例：

模擬：在電子遊戲等模擬中彼此互動的代理。

常見問題

如何與我的沙箱通訊？

在容器中託管時，開放連接埠以與您的 SDK 實例通訊。您的應用程式可以為外部客戶端開放 HTTP/WebSocket 端點，而 SDK 在容器內部運行。

託管容器的成本是多少？

我們發現服務代理的主要成本是 token，容器成本因您配置的內容而異，但最低成本大約為每小時運行 5 美分。

何時應該關閉閒置容器而非保持其運行？

應該多久更新一次 Claude Code CLI？

Claude Code CLI 使用 semver 版本控制，因此任何破壞性變更都會進行版本控制。

如何監控容器健康狀況和代理效能？

由於容器本質上就是伺服器，您用於後端的相同日誌基礎設施也適用於容器。

代理會話在超時前可以運行多長時間？

代理會話不會超時，但我們建議設定 'maxTurns' 屬性以防止 Claude 陷入迴圈。

後續步驟

安全部署 - 網路控制、憑證管理和隔離強化
TypeScript SDK - 沙箱設定 - 以程式化方式配置沙箱
會話指南 - 了解會話管理
權限 - 配置工具權限
成本追蹤 - 監控 API 使用量
MCP 整合 - 使用自訂工具進行擴展

Was this page helpful?