本文详细介绍了将 Claude Code 从本地 CLI 工具部署到云端、通过魔改 SDK 实现 HTTP 流式调用，并利用沙箱实现多用户隔离的完整技术方案。
📝 详细摘要
文章围绕将 Claude Code 云端化部署的核心挑战展开：离线安装、HTTP 服务化、多用户隔离。作者首先通过 npm pack 打包和 Docker 基础镜像解决了无外网环境下的部署问题。然后，基于 claude-agent-sdk 和 FastAPI + SSE 构建了 HTTP 服务层，将 SDK 的 query() 和 ClaudeSDKClient 两种调用模式封装为 RESTful 接口，支持单次查询、多轮会话、流式输出，并集成了子代理、MCP 服务器、Hooks 等高级特性。最后，针对多用户场景，提出了「一用户一沙箱 + 用户文件版本化存储」的架构，利用容器级隔离解决运行时串扰，并通过文件快照实现用户状态的持久化和版本回溯。文章还分享了开发过程中的踩坑记录和个人感悟，强调工程设计能力是高效利用 AI 的基础。
💡 主要观点
- 通过 npm pack 和 Docker 基础镜像实现 Claude Code 的离线云端部署。 在无外网服务器上，通过 npm pack 打包 Claude Code 为 tgz 离线包，再结合 Docker 打包 Node.js、Python 和 HTTP 服务代码，实现一次构建、处处部署。
💬 文章金句
- 当下最快实现一个 Harness Engineering 工程的路径是：部署现有的产品 → 提供调用能力 → 在应用层和端上做封装及扩展。
- 个人的工程设计能力 始终是借助 ai 高效产出的基础，合理的设计思路才能快速引导 Ai 构建高质量系统
- 整套方案的设计原则是尽量不改造 Claude Code 本身，而是在外围做封装和调度。
📊 文章信息
AI 初评：88
来源：阿里云开发者
作者：阿里云开发者
分类：人工智能
语言：中文
阅读时间：36 分钟
字数：8775
标签： Claude Code, 云端部署, HTTP 流式调用, FastAPI, SSE