教程

Claude Code 自托管环境快速上手:claude self-hosted-runner setup 引导式部署实战

详解 Claude Code 自托管环境(Self-hosted environments)公测功能的引导式部署流程,通过 claude self-hosted-runner setup 一条命令完成环境创建和 Runner 配置。

2026/8/113分钟 阅读ClaudeEagle

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

bash
# 以 Owner 或 admin 身份运行引导式配置
claude self-hosted-runner setup

这条命令会走一遍完整的引导流程——创建自托管环境、并在当前机器上启动一个 Runner 实例。整个过程被设计成「一条命令走到底」,不需要手动拼接多个配置步骤。

第三步:确认 Runner 状态健康

Runner 注册完成后,管理设置页面会显示该环境状态为:Healthy

官方文档中附带的管理页面截图显示,管理界面会列出各个已注册的自托管环境(比如示例中的 linux-devmacos-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

相关文章推荐

教程Claude Code 企业进程审计实战:corporate launcher 与 processWrapper 配置指南详解 Claude Code 新增的 corporate launcher 企业启动器支持,通过 processWrapper 配置项统一审计和管控所有子进程,适合有严格 IT 合规要求的企业部署场景。2026/8/10教程Claude Code 插件市场搭建教程:创建并分发企业内部 Plugin Marketplace完整教程:如何为团队或社区搭建 Claude Code 插件市场,包括创建 marketplace.json 清单、字段说明、托管到 Git 平台、用户安装流程,以及 allowCrossMarketplaceDependenciesOn 字段如何防止未审查的第三方市场依赖带来的供应链风险。2026/7/12教程Claude Code Settings 完整指南:Managed、User、Project、Local 四级配置优先级Claude Code Settings 官方文档完整中文整理:Managed/User/Project/Local 四级作用域、优先级顺序、settings.json 和 settings.local.json 的区别、Managed settings 的多种部署方式、权限规则为何是合并而非覆盖、MCP/Plugins/CLAUDE.md 对应配置位置、schema 校验、环境变量和团队最佳实践。2026/5/15教程Claude Code 企业级部署指南:团队管理、权限控制、SSO 集成、成本优化Claude Code 企业级部署完整指南:订阅计划选择、管理员控制台、Managed CLAUDE.md 统一配置、分级权限设计、SSO 集成、Token 成本管理和合规审计方案。2026/4/13教程Claude Code 配置完全指南:settings.json 四级作用域与权限管理Claude Code settings.json 四级作用域完整指南:Managed/User/Project/Local 配置范围与优先级规则、权限配置语法(allow/deny/Bash/Read/Write)、三大实际场景配置(个人开发/团队项目/企业安全)、敏感文件保护、环境变量注入与子代理参数配置。2026/3/14教程Claude Code LLM Gateway 配置指南:LiteLLM 统一端点、动态 API Key 与三大提供商直通Claude Code LLM Gateway 配置完整指南:Gateway 五大价值(集中认证/用量追踪/费用控制/审计日志/模型路由)、三种 API 格式兼容要求(Anthropic Messages/Bedrock/Vertex 的 Headers 透传规则)、LiteLLM 静态 API Key 和动态 Key(三步配置:脚本+apiKeyHelper+TTL)、四种端点配置(统一端点推荐/Claude 直通/Bedrock 直通/Vertex 直通)、自定义模型名称设置,以及企业完整配置示例。2026/3/6