設定雲端環境

​

Default 環境

• Trusted 網路存取：工作階段可以到達套件登錄檔和其他允許清單中的網域，但無法透過工作階段的網路到達其他任何內容。
• 無其他設定：Default 不定義任何環境變數或設定指令碼，因此工作階段只會以預先安裝的工具開始。

• 在網頁、桌面應用程式和行動應用程式上，工作階段使用選擇器中顯示的環境。當您尚未選擇時，管理員設定的組織預設會填入選擇。
• 從 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 雲端工作階段會回退到您第一個可用的雲端環境。任何明確使用環境設定的內容，例如 routine，無法在其中啟動新工作階段；將其指向另一個環境。

​

組織共用環境

• 在 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

​

指令碼需求

• Exit zero：如果指令碼以非零狀態結束，工作階段將無法啟動。在非關鍵命令後附加 || 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。
• Proxy 相容性：所有出站流量都通過安全 proxy。某些套件管理員無法與此 proxy 正確搭配運作。Bun 是一個已知的範例。
• 增加啟動延遲：hooks 在每次工作階段啟動或恢復時執行，不同於設定指令碼，設定指令碼受益於環境快取。透過在重新安裝之前檢查相依性是否已存在來保持安裝指令碼快速。

​

預設允許的網域

​

相關資源

• Claude Code on the web：啟動、管理和共用雲端工作階段
• Web quickstart：連接 GitHub 並啟動您的第一個雲端工作階段
• Claude Tag：Claude 從 Slack 啟動的工作階段在相同的環境中執行
• Routines：排程執行使用相同的環境和網路存取層級
• Remote Control：改為在您自己的機器的網路和檔案上執行工作階段
• SessionStart hooks：儲存庫提交的設定，在本機和雲端工作階段中執行
• Server-managed settings：到達雲端工作階段的組織政策