配置云环境

​

Default 环境

• Trusted 网络访问：会话可以访问包注册表和其他允许列表中的域，但无法通过会话的网络访问其他任何内容。
• 无其他配置：Default 不定义任何环境变量或设置脚本，因此会话只以预安装的工具开始。

• 在网页、Desktop 应用和移动应用上，会话使用选择器中显示的环境。当您尚未选择时，管理员设置的组织默认值会填入选择。
• 从 CLI，会话使用您的 /remote-env 选择，或回退到您第一个可用的云环境。

​

配置您的环境

1

打开环境选择器

在 claude.ai/code 上，选择显示当前环境名称的云图标，位于消息框上方的栏中。选择器没有设置页面或直接 URL。

2

添加或编辑环境

选择 Add cloud environment，或悬停在现有环境上并选择右侧出现的设置图标。对话框包括名称、网络访问级别、环境变量和设置脚本。

​

设置环境变量

NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

​

从 CLI 选择环境

​

归档环境

• 已在该环境中运行的会话会继续工作。
• 环境从选择器和 /remote-env 中消失，因此您无法为新会话选择它。
• 任何界面上都无法在已归档的环境中启动新会话。如果该环境是您保存的 CLI 默认值，CLI 云会话会回退到您第一个可用的云环境。任何显式使用该环境配置的内容，例如例程，无法在其中启动新会话；请将其指向另一个环境。

​

组织共享环境

• 在 claude.ai/admin-settings/claude-code 将共享环境设置为组织的默认环境。
• 在 Claude Tag 管理员设置中将一个固定到频道。

​

网络访问

​

访问级别

​

允许特定域

api.example.com
*.internal.example.com
registry.example.com

​

GitHub 代理

• Git 凭证：VM 内的 git 客户端使用范围受限的凭证，代理验证并将其交换为您的实际 GitHub 令牌。
• API 请求：来自内置 GitHub 工具的请求，以及来自 proxy-injected 占位符下的 gh 的请求，会在替换为您的真实凭证后发出。
• 推送保护：git push 仅适用于会话的当前工作分支；克隆、获取和 PR 操作正常工作。
• 存储库范围：GitHub API 和发布资产请求仅能到达附加到会话的存储库，因此从未附加的存储库下载发布资产的设置脚本会收到 403。

​

安全代理

• 防范恶意请求
• 速率限制和滥用防范
• 增强安全性的内容过滤
• 所请求主机名的 DNS 级审计踪迹

​

云会话中可用的内容

​

您的设置中会保留的内容

​

已安装的工具

​

使用 GitHub 问题和拉取请求

• 如果您设置了令牌，它会原封不动地传递到容器中，因此您的脚本和 GitHub 的 gh CLI（如果您安装它）会直接使用它。
• 如果您都不设置，则由 GitHub 代理为您的会话处理身份验证，这两个变量在 Claude 运行的命令中读取为占位符字符串 proxy-injected，代理在出站 GitHub 请求上替换为您的真实凭证。gh 无需您自己的令牌即可工作，但直接读取 GITHUB_TOKEN 的脚本会得到占位符，而不是可用的令牌。

​

将输出链接回会话

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

​

运行测试、启动服务和添加包

​

运行测试

​

启动服务

service postgresql start

service redis-server start

​

添加包

​

资源限制

• 4 vCPU
• 16 GB RAM
• 30 GB 磁盘

​

设置脚本

#!/bin/bash
apt update && apt install -y gh

​

脚本要求

• 以零退出：如果脚本以非零状态结束，会话将无法启动。在非关键命令后附加 || true，以便间歇性安装失败不会阻止会话。
• 在五分钟内完成：将脚本的总运行时间保持在大约五分钟以内，以便环境缓存可以建立。使用 & 和 wait 并行运行独立的安装，并将任何无法容纳的单个下载移至 SessionStart hook，在后台启动它。
• 安装需要网络访问：包安装需要连接到注册表。默认的 Trusted 级别涵盖常见包注册表，包括 npm、PyPI、RubyGems 和 crates.io；使用 None 网络访问时，安装会失败。

​

环境缓存

​

设置脚本与 SessionStart hooks

1. 设置脚本首先运行，在 Claude Code 启动之前，且仅当不存在缓存环境时。
2. Claude Code 启动并运行您的 SessionStart hooks，就像在每个会话（本地或云端）开始时一样。

​

使用 SessionStart hook 安装依赖项

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

npm install
pip install -r requirements.txt
exit 0

​

云会话中的限制

• 没有仅云端的范围：hooks 在本地和云会话中都运行。要跳过本地运行，请检查 CLAUDE_CODE_REMOTE 环境变量，如上所示。
• 需要网络访问：安装命令需要连接到包注册表。如果您的环境使用 None 网络访问，这些 hooks 会失败。Trusted 下的默认允许列表涵盖 npm、PyPI、RubyGems 和 crates.io。
• 代理兼容性：所有出站流量都经过安全代理。某些包管理器无法与此代理正确配合工作。Bun 是一个已知的例子。
• 增加启动延迟：hooks 在每次会话启动或恢复时运行，不同于受益于环境缓存的设置脚本。请通过在重新安装之前检查依赖项是否已存在来保持安装脚本快速。

​

默认允许的域

​

相关资源

• Claude Code on the web：启动、管理和共享云会话
• Web quickstart：连接 GitHub 并启动您的第一个云会话
• Claude Tag：Claude 从 Slack 启动的会话在相同的环境中运行
• Routines：计划运行使用相同的环境和网络访问级别
• Remote Control：改为在您自己的机器的网络和文件上运行会话
• SessionStart hooks：存储库提交的设置，在本地和云会话中运行
• Server-managed settings：到达云会话的组织策略