Anthropic 说明 Claude Code 云端会话的网络与环境变量配置机制
来源标题:Why can't Claude agents running in the cloud do everything on GitHub?
Anthropic 披露了 Claude Code 云端会话的环境配置方式,包括网络访问级别、环境变量、初始化脚本和环境缓存。会话会把环境值读入普通环境变量供 Claude 执行的命令使用,但 OTEL_* 变量除外,它们仅用于 Claude Code 自身的遥测上报。在 Anthropic 托管环境中,环境变量在创建会话时读取一次,之后每次 Claude Code 在 VM 中启动时重新读取,包括 VM 从空闲状态恢复和被回收后重建两种情况。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为 Claude Code 云会话配置云环境:网络访问级别、环境变量、初始化脚本和环境缓存。 NODE_ENV=development LOG_LEVEL=debug DATABASE_URL=postgres://localhost:5432/myapp 会话会把环境中的值读取为普通环境变量,Claude 运行的任何命令都能读取这些变量,但 OTEL_* 变量除外。Claude Code 将这些变量用于自身的遥测导出,不会把它们传给所运行的命令。 在 Anthropic 托管的环境中,会话会在你创建它时读取环境中的值,此后每次 Claude Code 在该会话的 VM 中启动时也会再次读取,这种情况发生在两种场景下: VM 在空闲后被恢复:在没有活动几分钟后,会话的 VM 会暂停并保存其文件。你的下一条消息会恢复同一个 VM 并再次启动 Claude Code。 VM 被回收并重建:如果暂停的 VM 在此期间已被回收,重新打开会话会配置一个新的 VM。 在你编辑、添加或删除变量后,Anthropic 托管环境中的现有会话会保留它上次读取的值,直到其 VM 下次被恢复或重建,此后才会使用你的更改。会话空闲后,其 VM 会自行暂停,你无法自行暂停它。要立即使用新值,请让 Claude 在它运行的命令上设置该值,例如 LOG_LEVEL=trace npm test,或启动一个新会话。 云会话在启动时也会自行设置一些变量。对于 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE,会话设置的值会覆盖你在此处添加的值,因此在此处添加该键不会生效。 任何使用该环境的人都可以读取这些值。在 Anthropic 托管的环境中,对于 agent proxy 可以附加到请求的密钥,请改用网络密钥。永远不会获得密钥的请求列在那里。 添加网络密钥 网络密钥是你存储在云环境上的 API key 或 token,使 Claude 可以从该环境中的任何会话调用该 API,而无需看到密钥。Anthropic 的 agent proxy 会在每个请求离开会话的 VM 后,将密钥添加到你所列主机的请求中,因此密钥本身始终位于 VM 之外。 网络密钥在 Pro、Max、Ultra、Team 和 Enterprise 计划中可用。要检查你是否可以自行添加一个,请参阅要求。 要求 以下要求决定你是否可以添加密钥,以及添加后 agent proxy 是否可以使用它: 角色:在所有计划中,无论你的角色如何,你都可以在自己的环境中添加和删除密钥。在 Team 和 Enterprise 中,Owner 在你的 claude.ai 组织中拥有组织管理员角色,而 Admin 没有,这会改变你在以下情况中看到的内容: 你自己的环境:没有组织管理员角色时,Add secret 会打开一个更简短的表单 共享环境:Owner 从管理员设置中添加和删除其密钥。如果没有组织管理员角色,请让 Owner 添加密钥,因为该环境的对话框中没有 Network secrets 部分 环境类型:已存在的 Anthropic 托管云环境。自托管环境没有网络密钥 API 可达性:API 接受来自互联网的连接,因为请求从 Anthropic 的网络发出 加密密钥:如果你的组织使用客户管理的加密密钥,你无法保存网络密钥 添加密钥 你一次添加一个密钥。要更改密钥的主机或值,请删除它并重新添加。 要向共享环境添加密钥,请从管理员设置的 Cloud environments 页面打开它进行编辑,然后从其 Network secrets 部分继续执行第 2 步。如果你使用的是 Team 或 Enterprise 计划且没有组织管理员角色,请在你自己的环境中执行第 1 步,然后填写更简短的表单。 1 打开环境的网络密钥 api.example.com *.internal.example.com registry.example.com 此环境中的会话现在可以通过会话的网络访问 api.example.com、internal.example.com 的任何子域以及 registry.example.com,无法访问其他域。GitHub 流量、MCP connector 流量以及对环境网络密钥主机的请求(除了永远不会获得密钥的主机之外)不经过此允许列表。前导的 *. 匹配每个子域。要同时保留 Trusted domains,请勾选 Also include default list of common package managers;不勾选则仅允许你列出的内容。 如果你的组织使用 artifacts,则无需在列表中包含 *.frame.claudeusercontent.com 即可让会话读取它们。当列表省略该主机时,Claude Code 会通过会话与 Anthropic 的连接读取 artifact 内容。在两种情况下需要将该主机保留在允许列表中: 此环境中的会话会打开另一个组织的公开 artifacts:Claude Code 直接从该主机获取它们,因此请将其添加到此列表。 你正在配置本地 CLI 或自托管 runner:请将该主机保留在该允许列表中。请参阅网络访问要求和自托管网络要求。 每个环境都有自己的允许域列表;没有组织级允许列表可供管理员推送到每个成员的环境。也没有任何服务器管理的设置会将域添加到环境的网络允许列表中。要为团队提供一份标准列表,Owner 可以创建一个具有 Custom 网络访问权限和该列表的组织共享环境。 GitHub proxy 在 Anthropic 托管环境中,所有 GitHub 操作都经过一个专用 proxy,该 proxy 将你真实的 GitHub 凭证保持在会话的 VM 之外,与环境的访问级别无关。自托管环境中的会话使用你的部署提供的凭证来验证 git 操作;Configure git 介绍了各种选项,包括按会话铸造的凭证以及选择启用同一个 proxy。该 proxy 提供: Git 凭证:VM 内的 git 客户端使用一个受限凭证,proxy 会验证该凭证并将其替换为你实际的 GitHub token。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。