服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 普通环境变量可被使用环境的成员和命令读取;网络密钥则由代理附加到匹配的出站请求。
- 网络密钥仅适用于符合条件的 Anthropic 托管云环境和可从公网访问的 API。
- GitHub、Anthropic API、公共包仓库、setup script 请求和遥测不会收到网络密钥。
- 归档环境会影响新会话,但已有会话仍运行;想停止附加密钥,应先删除密钥。
- setup 完成约五分钟内时,文件系统快照可复用;数据库等仍在运行的进程不会被快照保留。
先确认会话运行在哪种环境
Claude Code 的云环境设置用于 cloud session。当前文档列出 Pro、Max、Ultra、Team,以及拥有 premium seat 或 Chat + Claude Code seat 的 Enterprise 用户。Remote Control 只是把网页或手机连接到你自己的电脑;self-hosted environment 也使用自己的 runner 和网络边界。两者都不能直接套用 Anthropic 托管云环境的网络密钥说明。
网络密钥另有前提:环境必须是已经创建的 Anthropic 托管云环境,API 要能从互联网访问,因为请求从 Anthropic 网络发出;使用 customer-managed encryption keys 的组织不能保存这类密钥。因此不要把“计划支持云会话”推成“每个账号、每个环境都能添加密钥”。先核对账号席位、环境类型和组织设置。
普通环境变量与网络密钥不是同一类保存方式
环境变量以普通变量形式进入云会话,命令以及使用该环境的人通常可以读取它们。OTEL_* 是例外:Claude Code 将它们用于遥测导出,不传给运行的命令。普通变量适合运行模式或日志级别等非敏感配置,不适合 API token。把密钥写进变量、仓库文件或 setup script,不会得到网络密钥的隔离效果。
网络密钥保存在环境配置中,由 Anthropic 的 agent proxy 在请求离开会话 VM 之后,按已列出的主机把凭据加到请求上。文档说明密钥本身不会出现在会话的环境变量或文件里;保存后也不能再查看其值。对需要发送 API 请求的工作流,这能避免把原始 token 放入命令参数或项目文件,但仍须把可访问的主机范围控制得足够窄。
主机匹配会授予请求路径,也有明确例外
代理会在请求主机与密钥允许的主机匹配时附加密钥;同一环境里的每个会话都会使用它,无论会话由谁启动,直到密钥被删除。列入的主机即使不在该环境原先允许的网络访问范围内,也可能通过 agent proxy 可达。添加主机时应按 API 的实际主机填写,只在确有需要时使用子域名通配符;不要为了省事放宽到整片域名。
有几类请求绝不会收到这类密钥:GitHub API 走单独的 GitHub proxy;Anthropic API 和公开包仓库(例如 npm、PyPI、crates.io)被排除;setup script 在 Claude Code 启动并连接 agent proxy 前运行;遥测也不经过该代理。因此不能指望这个 secret 认证私有依赖安装脚本,或让 setup script 读取它。官方还说明环境变量在 setup script 运行时尚未设置。
添加、轮换和归档前的撤销步骤
添加密钥前,先确认目标 API 使用的主机和认证头,再在环境的 Network secrets 中添加一项。若 API 接受 Bearer token,可使用默认类型和 Authorization 头;若要求其他头名,应按 API 文档填写。较短的成员表单一次只支持一个主机且不接受通配符;Team 或 Enterprise 的共享环境密钥由组织 Owner 管理。具体可填写的表单取决于你的角色。
保存的值不能重新显示。要更换密钥值或适用主机,文档要求先删除旧项,再重新添加新项。环境被归档后,新会话不能再选择它,但已有会话仍会继续运行,而且该环境的网络密钥仍附加在运行中的会话里。若归档是为了停止访问,先删除不再需要的密钥,再归档;不要把归档当作密钥撤销。
依赖缓存保存的是文件系统,不是常驻服务
托管云环境的 setup script 若在约五分钟内完成,Anthropic 会把文件系统做成缓存快照,后续新会话可从依赖、工具、容器镜像和写入文件已经落盘的状态开始,并跳过 setup 阶段。超出这一时长的 setup 不会建立该缓存。缓存是环境准备的复用,不是一直运行的开发容器。
数据库、docker compose 服务和其他后台进程不会因快照而持续运行;需要时仍须在每个会话里启动。修改 setup script 或允许的网络主机、或缓存约七天到期时,setup 会再次运行以重建缓存。若你刚改了配置又要立即使用,可在当前会话手动执行所需步骤,或启动新会话;不要假设正在运行的进程已重启或已读入新设置。
用一次无敏感数据的请求检查配置
例如,假设你要让 Claude Code 访问公开可达的 api.example.com。先选 Anthropic 托管云环境,确认这个 API 主机已精确列入网络密钥,核对密钥类型和组织权限,再用不返回个人资料或写入数据的测试端点确认响应。检查结果时只记录请求主机、状态码和脱敏错误,不把 token、完整响应或个人数据放进日志。
这是一份操作前检查清单,不是本篇实际运行过的云会话测试。验证前逐项确认:当前选择的是哪个环境、密钥作用于哪个主机、请求由 Claude 会话还是 setup script 发出、是否命中 GitHub 或公开包仓库等例外;若结果不符,先按请求路径定位,再决定是否删除并重新添加密钥。
资料来源
常见问题
为什么 Admin 看不到共享云环境的管理页?
官方角色区分中,Team 和 Enterprise 的 Owner 拥有这里所需的组织管理权限,Admin 角色不能打开 Cloud environments 管理页。普通成员仍可管理自己环境中的密钥;共享环境应由 Owner 在管理设置中处理。
在会话中途安装的包会进入下一个会话的缓存吗?
不会。文档说明,会话中途安装的包不会带到其他会话。需要复用的依赖应放进 setup script,并满足该脚本的缓存条件。
密钥列表显示 Not sent 时,应该先检查什么?
先阅读该条目下方的官方提示,它会说明未发送的原因和下一步。核对所选环境、目标主机和请求路径;不要仅靠扩大允许主机范围处理错误。