v2.1.224 引入的自托管运行环境(Self-hosted environments)已进入公测阶段,面向 Team 和 Enterprise 计划开放。Week 32 digest 补充了具体的引导式部署流程——通过 claude self-hosted-runner setup 一条命令,就能完成从创建环境到启动 Runner 的完整配置。本文基于官方文档梳理实战部署步骤。
核心能力回顾
Self-hosted environments run Claude Code cloud sessions on your
organization's own infrastructure, in public beta on Team and
Enterprise plans
简单说,就是把原本运行在 Anthropic 云端的 Claude Code 云会话(通过 claude.ai、手机 App、桌面 App,或 claude --cloud 发起的会话),改为运行在你自己组织的基础设施上——这样云会话就能直接访问你的内部服务,不需要把这些资源暴露到公网。
第一步:管理员开启该功能
以 Owner 或 admin 身份登录,在管理设置中开启
Allow self-hosted environments
访问地址:https://claude.ai/admin-settings/cloud-environments
这是一个组织级别的开关,必须先由管理员开启,普通成员无法自行启用。
第二步:引导式创建环境和 Runner
# 以 Owner 或 admin 身份运行引导式配置
claude self-hosted-runner setup这条命令会走一遍完整的引导流程——创建自托管环境、并在当前机器上启动一个 Runner 实例。整个过程被设计成「一条命令走到底」,不需要手动拼接多个配置步骤。
第三步:确认 Runner 状态健康
Runner 注册完成后,管理设置页面会显示该环境状态为:Healthy
官方文档中附带的管理页面截图显示,管理界面会列出各个已注册的自托管环境(比如示例中的 linux-dev、macos-prod),以及每个环境的状态和当前活跃会话数——这为管理多个自托管节点提供了一个集中的可视化视图。
第四步:日常使用——用户如何选择自托管环境
当某个用户从 claude.ai、移动端/桌面端 App,或 claude --cloud 启动一个新的云会话时,可以选择使用你配置好的自托管环境——一旦选中,这个会话就会运行在你的内网中,具备访问内部服务的权限。
部署建议
1. 先在测试环境(如 linux-dev)验证 Runner 能稳定注册并
保持 Healthy 状态,再考虑面向生产环境部署
2. 为不同用途配置独立的环境(比如区分开发环境和生产环境访问权限),
避免所有云会话共用同一套内网访问权限
3. 结合 v2.1.225 的修复——如果 --base-dir 无法创建或写入,
Runner 现在会在启动阶段就直接报错退出,
部署时注意提前确认目录权限配置正确
4. 定期检查管理页面的活跃会话数,评估 Runner 资源是否足够
和跨会话消息的组合使用
自托管环境和同批次上线的跨会话消息能力结合使用,能拼出一个更完整的多设备协作画面——你可以把不同职责的云会话分布在不同的自托管环境上(比如一个专门处理内部数据分析的环境、一个专门用于生产部署审查的环境),再通过跨会话消息让它们按需协调进展。
总结
claude self-hosted-runner setup 这条引导式命令,大幅降低了自托管环境的部署门槛——不需要手动拼凑多个配置步骤,一条命令走完创建环境、启动 Runner 的全流程。对于希望让云端便利性和内网数据安全性兼得的企业团队,现在是这项公测功能比较合适的尝试时机。
来源:Claude Code Week 32 digest — Claude Code 官方文档,Anthropic