Claude Code 云会话现支持跑在你自己的服务器上:自托管环境公测上线

Anthropic 为 Claude Code 推出自托管环境公测(Team 和 Enterprise 计划):从 claude.ai、移动/桌面端、日程任务发起的云会话,可以跑在你自己网络内的服务器上,而不是 Anthropic 的托管基础设施。代码检出、构建产物、内网服务访问全部留在你的网络边界内。

阅读时长: 4 分钟
共 1778字
作者: longlikun

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 日。

关于

关注我获取更多资讯

月球基地博客公众号二维码,扫码关注获取更多 AI 与编程资讯
📢 公众号
月球基地博客作者个人微信二维码,扫码交流 AI 与编程话题
💬 个人号
使用 Hugo 构建
主题 StackJimmy 设计