部署
Hosting the Agent SDK
Hosting the Agent SDK 这一页讲的，就是 Hosting the Agent SDK 这件事在 Claude Code 里到底怎么用。
页面信息
这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。
如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。
这一页先讲明白
这页主要讲 Hosting the Agent SDK：Deploy and host Claude Agent SDK in production environments
你可以把它当成"Deployment"这块里专门管这一摊事的说明书。
你可以把"Hosting the Agent SDK"理解成 Deployment 这一栏里的一把专门工具。这页不是让你背书，而是教你什么时候该把这把工具拿出来。
原文这页大多会按 Hosting Requirements、Container-Based Sandboxing、System Requirements、Understanding the SDK Architecture 这些环节往下讲。
翻成人话，大概就是：Hosting Requirements
第一，先别一上来全开全配。先按最小一步试通，确认没跑偏，再继续往下加。
第二，命令、配置名、参数名这些硬东西尽量保留原样。人话解释是帮你听懂，不是帮你改关键字。
第三，照着原文这几个环节挨个过：Hosting Requirements -> Container-Based Sandboxing -> System Requirements -> Understanding the SDK Architecture。像下地先看水路、再试机器、再正式开干，一步一步最稳。
Documentation Index
这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。
Hosting Requirements
这一段主要是在把"Hosting Requirements"讲实，不是只摆个标题给你看。
Container-Based Sandboxing
这一段主要是在把"Container-Based Sandboxing"讲实，不是只摆个标题给你看。
System Requirements
这一块主要是在说"System Requirements"真到手上该怎么用，哪里最容易踩坑。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
Understanding the SDK Architecture
这一段主要是在把"Understanding the SDK Architecture"讲实，不是只摆个标题给你看。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
Sandbox Provider Options
这里不是让你背"Sandbox Provider Options"这个词，而是让你看它真干活时怎么使。
Production Deployment Patterns
这一块主要是在说"Production Deployment Patterns"真到手上该怎么用，哪里最容易踩坑。
Pattern 1: Ephemeral Sessions
这一段是在教你把 a new container for each user task, then destroy it when complete. 真正建出来。文件放哪儿、字段怎么写、建完怎么验，都得跟着看。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Pattern 2: Long-Running Sessions
看到这里，就把"Pattern 2: Long-Running Sessions"当成一件真要上手的活来看。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Pattern 3: Hybrid Sessions
这一段主要是在把"Pattern 3: Hybrid Sessions"讲实，不是只摆个标题给你看。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Pattern 4: Single Containers
这一段是在把 multiple Claude Agent SDK processes in one global container. 真跑起来。别只看命令长什么样，还得看跑完该出现什么。
FAQ
这一段主要是在把"FAQ"讲实，不是只摆个标题给你看。
How do I communicate with my sandboxes?
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
What is the cost of hosting a container?
这里主要是在交代"What is the cost of hosting a container?"这一块会碰到哪些事。
When should I shut down idle containers vs. keeping them warm?
这里不是催你全用上，而是在说 When should I shut down idle containers vs. keeping them warm? 什么时候用才划算。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
How often should I update the Claude Code CLI?
这里主要是在交代"How often should I update the Claude Code CLI?"这一块会碰到哪些事。
How do I monitor container health and agent performance?
这里不是让你背"How do I monitor container health and agent performance?"这个词，而是让你看它真干活时怎么使。
How long can an agent session run before timing out?
这一块主要是在说"How long can an agent session run before timing out?"真到手上该怎么用，哪里最容易踩坑。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Next Steps
这里不是让你背"Next Steps"这个词，而是让你看它真干活时怎么使。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
照着做一遍
这页属于“Hosting the Agent SDK”这类活，最稳的办法还是一小步一小步来。
下面这三步不一定华丽，但通常最不容易绕晕。
第 1 步：先起步
第一，先别一上来全开全配。先按最小一步试通，确认没跑偏，再继续往下加。
第 2 步：边做边看
第二，命令、配置名、参数名这些硬东西尽量保留原样。人话解释是帮你听懂，不是帮你改关键字。
第 3 步：收尾防出错
第三，照着原文这几个环节挨个过：Hosting Requirements -> Container-Based Sandboxing -> System Requirements -> Understanding the SDK Architecture。像下地先看水路、再试机器、再正式开干，一步一步最稳。
一眼看懂这一页
先把这页到底在讲什么看明白，再去碰具体命令和配置，最不容易绕晕。
Hosting the Agent SDK
|
v
这是 Deployment 里的一摊要紧活
|
v
先弄懂，再下手文末提醒
这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。
人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。