Agent SDK 是长期运行的进程，维护对话状态并在持久环境中执行命令，与无状态 LLM API 不同。生产部署需要在沙箱容器中运行以实现进程隔离、资源限制和网络控制。
核心机制
系统要求：
- Python 3.10+ 或 Node.js 18+（SDK 内置 Claude Code 二进制，无需单独安装）
- 推荐配置：1GiB RAM、5GiB 磁盘、1 CPU
- 网络：需要访问
api.anthropic.com（HTTPS 出站）
四种部署模式：
| 模式 | 描述 | 适用场景 |
|---|---|---|
| 短暂容器（Ephemeral） | 每个任务创建新容器，完成后销毁 | Bug 修复、文档翻译、一次性任务 |
| 长期容器（Long-Running） | 持久容器，可运行多个 Agent 进程 | 邮件 Agent、高频聊天机器人 |
| 混合模式（Hybrid） | 短暂容器 + 会话恢复 | 间歇性交互的项目管理、深度研究 |
| 单容器多进程 | 一个容器运行多个 Agent | 需要协作的 Agent 模拟 |
关键细节
推荐沙箱提供商：
- Modal Sandbox
- Cloudflare Sandboxes
- E2B
- Fly Machines
- Vercel Sandbox
- Daytona
容器通信：通过暴露 HTTP/WebSocket 端口与外部客户端通信，SDK 在容器内部运行。
空闲超时：根据用户响应频率调整，不同提供商有不同的空闲超时配置。
Agent 会话超时：Agent 会话本身不会超时，但应设置 maxTurns 防止循环。
与其他概念的关联
- secure-deployment - 网络控制、凭证管理、隔离加固
- sessions - 混合模式下的会话恢复
- observability - 容器级别的监控和日志
实践要点
- 容器成本主要来自 token 费用，容器本身最低约 5 美分/小时
- 短暂容器适合大多数场景，用户仍可在任务完成前与 Agent 交互
- 长期容器适合需要主动行动（无需用户触发）的 Agent
- 混合模式结合 sessions 的会话恢复功能，实现”暂停-继续”工作流
- 安全加固（网络控制、凭证管理）详见 secure-deployment