2026 年 8 月 6 日,Anthropic 宣布 Claude Code 的**自托管环境(Self-hosted Environments)**进入公测阶段,面向 Team 和 Enterprise 计划的组织开放。简单说:从 claude.ai、移动端/桌面端应用或日程任务(Routines)发起的 Claude Code 云会话,现在可以跑在你自己网络内的服务器上,而不是默认的 Anthropic 托管基础设施。
什么是云会话,为什么需要自托管
Claude Code 有两种运行方式:一是在开发者本机的终端或 IDE 里直接跑,一是通过 claude.ai 或应用发起的"云会话"——后者让你可以从浏览器、手机,或者在日程任务里调度 Claude Code 去执行某个任务,不需要本机一直开着终端。
默认情况下,云会话跑在 Anthropic 的托管基础设施上。对大多数团队来说这就够用了。但有些场景有特殊需求:
- 网络访问:代码库依赖访问内部数据库、私有 npm/PyPI 镜像或不对外暴露的内部服务,不想把这些东西开放到公网
- 合规控制:代码检出和构建产物需要留在受组织管控的基础设施上
- 自定义工具链:希望 runner 镜像里预装好特定版本的编译器、SDK 或内部 CLI,省去每次会话的安装时间
自托管环境让你把会话执行搬到自己的网络里,同时保留 claude.ai 上的调度界面和 Anthropic 侧的推理能力。
架构:三个概念
理解自托管环境需要掌握三个核心概念:
Environment(环境):在 claude.ai 管理设置里创建的命名目标。开发者发起会话时,会看到一个环境选择器,Anthropic 托管环境和你创建的自托管环境都会列在里面。
Runner(运行器):你在自己基础设施上部署的常驻进程,功能类似 GitHub Actions 的 self-hosted runner。它向环境注册、轮询任务队列,收到会话后在本机克隆代码仓库并启动一个 Claude Code 子进程来执行任务。
Session(会话):开发者在 claude.ai、移动端或其他界面发起的一次 Claude Code 任务。
整体流程:开发者选择自托管环境 → Anthropic 控制平面把会话放入该环境的队列 → 有空闲容量的 runner 认领会话 → runner 克隆仓库、启动 Claude Code 子进程 → 会话开始执行。
网络路径方面,所有连接都是你的网络向外的出站连接,Anthropic 不会主动连入你的网络:runner 轮询 api.anthropic.com 获取任务;每个 Claude Code 子进程向 api.anthropic.com 保持事件流并进行模型推理调用;对内部 git 宿主的克隆和推送由 runner 负责,走的是你提供的认证凭证。
两种 Runner 模式
Fixed 模式:保持固定数量的 runner 常驻运行,会话在它们之间分配。适合流量稳定、对响应延迟敏感的场景。
On-demand 模式:部署一个额外的 autoscaling orchestrator 进程,它监视队列,有会话来了就启动 runner,工作完成后退出。按需伸缩,适合流量不均匀的场景。
用户隔离
一个 runner 在认领第一个会话之后,会锁定到该用户的账户,只为该账户的后续会话服务。这保证了不同用户的代码检出不会混在同一个 runner 上。runner 的默认行为是会话全部完成后立即退出,这样调度层(比如 Kubernetes)可以用干净的磁盘状态重启它,随时接受任何用户的会话。
什么留在你的基础设施,什么还走 Anthropic
理解数据边界很重要:
留在你这里:仓库代码检出内容、构建产物、secret、会话创建或修改的任何文件
仍然走 Anthropic:对话内容(提示词、响应、工具调用结果)会发到 api.anthropic.com 进行模型推理;会话记录由 Anthropic 保存,以便你从其他设备恢复会话
也就是说,自托管环境移动的是"在哪里执行代码和操作文件",而不是"模型推理在哪里发生"。推理仍然走 Anthropic API。
一个重要限制:自托管环境不支持将推理路由到 Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 或 LLM gateway,每次会话推理都走 Anthropic API,且使用 Anthropic 颁发的会话级 OAuth token 认证。
如何开启
自托管环境目前处于公测阶段,默认关闭。组织的 Owner 或 Admin 需要在 claude.ai 的管理设置(Cloud environments 页面)里先开启"Allow self-hosted environments"选项,前提是组织已经启用了 Claude Code on the web。
开启后,按照官方文档的 Quickstart 页面操作,完成"创建环境 → 部署 runner → 发起第一个会话"这三步。对于已有 Kubernetes 或 Docker Compose 的团队,官方文档的 Deploy to production 页面提供了对应的配置示例。
几个当前限制需要注意:
- 只支持 Team 和 Enterprise 计划(不支持 Pro/Max)
- 不支持 Zero Data Retention(ZDR)组织
- 代码仓库目前只支持 GitHub
- Claude Tag、Claude Security 和 Code Review 这几个会话类型暂不支持自托管路由
原文:Run Claude Code sessions on your own compute,发布于 Anthropic 官方博客,2026 年 8 月 6 日。
关于
关注我获取更多资讯