跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Code 網頁版目前處於研究預覽階段,適用於 Pro、Max 和 Team 使用者,以及具有高級席位或 Chat + Claude Code 席位的 Enterprise 使用者。
Claude Code 網頁版在 claude.ai/code 上的 Anthropic 管理的雲端基礎設施上執行任務。工作階段即使在您關閉瀏覽器後仍會保留,您可以從 Claude 行動應用程式監控它們。
初次使用 Claude Code 網頁版?從開始使用開始,連接您的 GitHub 帳戶並提交您的第一個任務。
本頁涵蓋:

GitHub 驗證選項

雲端工作階段需要存取您的 GitHub 儲存庫以複製程式碼和推送分支。您可以通過兩種方式授予存取權限:
方法運作方式最適合
GitHub App網頁上線期間授權 Claude GitHub App。瀏覽器上線;想要自動修復的團隊
/web-setup在您的終端中執行 /web-setup 以將您的本機 gh CLI 令牌同步到您的 Claude 帳戶。已經使用 gh 的個人開發者
使用任一方法,雲端工作階段都可以存取連接的 GitHub 帳戶可以看到的任何儲存庫,而不僅僅是安裝了 Claude GitHub App 的儲存庫。App 安裝啟用 PR webhooks 以進行自動修復;它不是工作階段級別的存取控制。若要限制您的團隊可以從雲端工作階段存取的儲存庫,請在 GitHub 本身上限制存取,例如通過限制連接的 GitHub 帳戶的團隊或儲存庫成員資格。
任一方法都可以。/schedule檢查任一形式的存取,如果都未配置,會提示您執行 /web-setup。有關 /web-setup 的逐步說明,請參閱從您的終端連接 GitHub App 是自動修復所必需的,它使用該應用程式接收 PR webhooks。如果您使用 /web-setup 連接,稍後想要自動修復,請在這些儲存庫上安裝該應用程式。 Team 和 Enterprise 管理員可以在 claude.ai/admin-settings/claude-code 使用快速網頁設定切換來禁用 /web-setup
啟用零資料保留的組織無法使用 /web-setup 或其他雲端工作階段功能。

雲端環境

每個工作階段在一個新的 Anthropic 管理的 VM 中執行,其中您的儲存庫已複製。本節涵蓋工作階段啟動時可用的內容以及如何自訂它。

雲端工作階段中可用的內容

雲端工作階段從您的儲存庫的新複製開始。任何提交到儲存庫的內容都可用。您只在自己的機器上安裝或配置的任何內容都不可用。
在雲端工作階段中可用原因
您的儲存庫的 CLAUDE.md複製的一部分
您的儲存庫的 .claude/settings.json hooks複製的一部分
您的儲存庫的 .mcp.json MCP 伺服器複製的一部分
您的儲存庫的 .claude/rules/複製的一部分
您的儲存庫的 .claude/skills/.claude/agents/.claude/commands/複製的一部分
.claude/settings.json 中聲明的 Plugins在工作階段啟動時從您聲明的市場安裝。需要網路存取才能到達市場來源
您的使用者 ~/.claude/CLAUDE.md位於您的機器上,不在儲存庫中
僅在您的使用者設定中啟用的 Plugins使用者範圍的 enabledPlugins 位於 ~/.claude/settings.json。改為在儲存庫的 .claude/settings.json 中聲明它們
您使用 claude mcp add 新增的 MCP 伺服器這些寫入您的本機使用者配置,不是儲存庫。改為在.mcp.json中聲明伺服器
靜態 API 令牌和認證尚不存在專用的秘密存儲。請參閱下文
互動式驗證,如 AWS SSO不支援。SSO 需要無法在雲端工作階段中執行的基於瀏覽器的登入
若要在雲端工作階段中提供配置,請將其提交到儲存庫。尚不可用專用的秘密存儲。環境變數和設定指令碼都存儲在環境配置中,對任何可以編輯該環境的人可見。如果您需要雲端工作階段中的秘密,請將它們新增為環境變數,並考慮該可見性。

已安裝的工具

雲端工作階段預先安裝了常見的語言執行時、建置工具和資料庫。下表按類別總結了包含的內容。
類別包含
PythonPython 3.x,包含 pip、poetry、uv、black、mypy、pytest、ruff
Node.js20、21 和 22(通過 nvm),包含 npm、yarn、pnpm、bun¹、eslint、prettier、chromedriver
Ruby3.1、3.2、3.3,包含 gem、bundler、rbenv
PHP8.4,包含 Composer
JavaOpenJDK 21,包含 Maven 和 Gradle
Go最新穩定版本,包含模組支援
Rustrustc 和 cargo
C/C++GCC、Clang、cmake、ninja、conan
Dockerdocker、dockerd、docker compose
DatabasesPostgreSQL 16、Redis 7.0
Utilitiesgit、jq、yq、ripgrep、tmux、vim、nano
¹ Bun 已安裝,但在套件取得時有已知的代理相容性問題 如需確切版本,請要求 Claude 在雲端工作階段中執行 check-tools。此命令僅存在於雲端工作階段中。

使用 GitHub 問題和拉取請求

雲端工作階段包含內建的 GitHub 工具,讓 Claude 可以讀取問題、列出拉取請求、取得差異和發佈評論,無需任何設定。這些工具通過GitHub 代理進行驗證,使用您在 GitHub 驗證選項下配置的任何方法,因此您的令牌永遠不會進入容器。 gh CLI 未預先安裝。如果您需要內建工具不涵蓋的 gh 命令,例如 gh releasegh workflow run,請自行安裝和驗證:
1

在您的設定指令碼中安裝 gh

apt update && apt install -y gh 新增到您的設定指令碼
2

提供令牌

GH_TOKEN 環境變數新增到您的環境設定,其中包含 GitHub 個人存取令牌。gh 會自動讀取 GH_TOKEN,因此不需要 gh auth login 步驟。

將工件連結回工作階段

每個雲端工作階段在 claude.ai 上都有一個成績單 URL,工作階段可以從 CLAUDE_CODE_REMOTE_SESSION_ID 環境變數讀取自己的 ID。使用此在 PR 正文、提交訊息、Slack 貼文或生成的報告中放置可追蹤的連結,以便審查者可以開啟產生它們的執行。 變數的值使用 cse_ 前綴,而成績單 URL 路徑採用相同的 ID,但使用 session_ 前綴。建立連結時替換前綴。以下命令列印 URL:
echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

執行測試、啟動服務和新增套件

Claude 執行測試作為處理任務的一部分。在您的提示中要求它,例如「修復 tests/ 中的失敗測試」或「在每次變更後執行 pytest」。測試執行器(如 pytest、jest 和 cargo test)開箱即用,因為它們已預先安裝。 PostgreSQL 和 Redis 已預先安裝,但預設不執行。在工作階段期間要求 Claude 啟動每一個:
service postgresql start
service redis-server start
Docker 可用於執行容器化服務。要求 Claude 執行 docker compose up 以啟動您的專案服務。拉取映像的網路存取遵循您的環境的存取級別信任預設值包括 Docker Hub 和其他常見登錄。 如果您的映像很大或拉取速度很慢,請將 docker compose pulldocker compose build 新增到您的設定指令碼。拉取的映像會保存在快取環境中,因此每個新工作階段都已在磁碟上有它們。快取僅存儲檔案,不存儲執行中的程序,因此 Claude 仍然在每個工作階段啟動容器。 若要新增未預先安裝的套件,請使用設定指令碼。指令碼的輸出會被快取,因此您在那裡安裝的套件在每個工作階段開始時都可用,無需每次重新安裝。您也可以要求 Claude 在工作階段期間安裝套件,但這些安裝不會在工作階段之間保留。

資源限制

雲端工作階段執行時具有可能隨時間變化的近似資源上限:
  • 4 vCPU
  • 16 GB RAM
  • 30 GB 磁碟
需要明顯更多記憶體的任務,例如大型建置工作或記憶體密集型測試,可能會失敗或被終止。對於超出這些限制的工作負載,請使用遠端控制在您自己的硬體上執行 Claude Code。

配置您的環境

環境控制網路存取、環境變數和在工作階段啟動前執行的設定指令碼。有關不需要任何配置即可使用的內容,請參閱已安裝的工具。您可以從網頁介面或終端管理環境:
操作方式
新增環境選擇目前環境以開啟選擇器,然後選擇新增環境。對話框包括名稱、網路存取級別、環境變數和設定指令碼。
編輯環境選擇顯示目前環境名稱的雲端圖示以開啟選擇器,將滑鼠懸停在環境上,然後按一下右側出現的設定圖示。
封存環境開啟環境進行編輯並選擇封存。封存的環境隱藏在選擇器中,但現有工作階段繼續執行。
--remote 設定預設值在您的終端中執行 /remote-env。如果您有單一環境,此命令顯示您目前的配置。/remote-env 僅選擇預設值;從網頁介面新增、編輯和封存環境。
環境變數使用 .env 格式,每行一個 KEY=value 對。不要用引號包裝值,因為引號會存儲為值的一部分。
NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

設定指令碼

設定指令碼是一個 Bash 指令碼,在新的雲端工作階段啟動時執行,在 Claude Code 啟動之前。使用設定指令碼來安裝依賴項、配置工具或取得工作階段需要但未預先安裝的任何內容。 指令碼在 Ubuntu 24.04 上以 root 身份執行,因此 apt install 和大多數語言套件管理器都可以工作。 若要新增設定指令碼,請開啟環境設定對話框並在設定指令碼欄位中輸入您的指令碼。 此範例安裝 gh CLI,它未預先安裝:
#!/bin/bash
apt update && apt install -y gh
如果指令碼以非零值退出,工作階段將無法啟動。將 || true 附加到非關鍵命令以避免在不穩定的安裝失敗時阻止工作階段。 保持指令碼的總執行時間在大約五分鐘以下,以便環境快取可以建置。使用 &wait 並行執行獨立安裝。如果單一下載無法在五分鐘限制內完成,請將其移動到在背景啟動它的 SessionStart hook
安裝套件的設定指令碼需要網路存取才能到達登錄。預設信任網路存取允許連接到常見套件登錄,包括 npm、PyPI、RubyGems 和 crates.io。如果您的環境使用網路存取,指令碼將無法安裝套件。

環境快取

設定指令碼在您第一次在環境中啟動工作階段時執行。完成後,Anthropic 會快照檔案系統並將該快照重新用作後續工作階段的起點。新工作階段以您的依賴項、工具和 Docker 映像已在磁碟上開始,設定指令碼步驟被跳過。這即使在指令碼安裝大型工具鏈或拉取容器映像時也能保持啟動速度快。 快取捕獲檔案,不捕獲執行中的程序。設定指令碼寫入磁碟的任何內容都會保留。它啟動的服務或容器不會,因此通過要求 Claude 或使用 SessionStart hook 按工作階段啟動這些。 當您更改環境的設定指令碼或允許的網路主機時,以及當快取在大約七天後達到其過期時間時,設定指令碼會再次執行以重建快取。恢復現有工作階段永遠不會重新執行設定指令碼。 您不需要自行啟用快取或管理快照。

設定指令碼與 SessionStart hooks

使用設定指令碼來安裝雲端需要但您的筆記型電腦已有的東西,例如語言執行時或 CLI 工具。使用 SessionStart hook 進行應在任何地方執行的專案設定,雲端和本機,例如 npm install 兩者都在工作階段開始時執行,但它們屬於不同的位置:
設定指令碼SessionStart hooks
附加到雲端環境您的儲存庫
配置在雲端環境 UI您的儲存庫中的 .claude/settings.json
執行在 Claude Code 啟動之前,當沒有快取環境在 Claude Code 啟動之後,在每個工作階段上,包括已恢復的
範圍僅雲端環境本機和雲端
SessionStart hooks 也可以在本機使用者級別 ~/.claude/settings.json 中定義,但使用者級別設定不會轉移到雲端工作階段。在雲端中,只有提交到儲存庫的 hooks 執行。

使用 SessionStart hook 安裝依賴項

若要僅在雲端工作階段中安裝依賴項,請將 SessionStart hook 新增到您的儲存庫的 .claude/settings.json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}
scripts/install_pkgs.sh 建立指令碼並使用 chmod +x 使其可執行。CLAUDE_CODE_REMOTE 環境變數在雲端工作階段中設定為 true,因此您可以使用它來跳過本機執行:
#!/bin/bash

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

npm install
pip install -r requirements.txt
exit 0
SessionStart hooks 在雲端工作階段中有一些限制:
  • 無雲端專用範圍:hooks 在本機和雲端工作階段中執行。若要跳過本機執行,請檢查上面所示的 CLAUDE_CODE_REMOTE 環境變數。
  • 需要網路存取:安裝命令需要到達套件登錄。如果您的環境使用網路存取,這些 hooks 會失敗。信任下的預設允許清單涵蓋 npm、PyPI、RubyGems 和 crates.io。
  • 代理相容性:所有出站流量都通過安全代理。某些套件管理器無法與此代理正確配合使用。Bun 是一個已知的例子。
  • 新增啟動延遲:hooks 在每次工作階段啟動或恢復時執行,不像設定指令碼受益於環境快取。通過在重新安裝之前檢查依賴項是否已存在來保持安裝指令碼快速。
若要為後續 Bash 命令保留環境變數,請寫入 $CLAUDE_ENV_FILE 處的檔案。有關詳細資訊,請參閱 SessionStart hooks 尚不支援使用您自己的 Docker 映像替換基礎映像。使用設定指令碼在提供的映像上安裝您需要的內容,或使用 docker compose 將您的映像作為容器與 Claude 一起執行。

網路存取

網路存取控制來自雲端環境的出站連接。每個環境指定一個存取級別,您可以使用自訂允許的域擴展它。預設值為信任,允許套件登錄和其他允許清單域 若要更改環境的網路存取,請開啟它進行編輯並在對話框中使用網路存取選擇器。沒有單獨的環境頁面。雲端圖示出現在您啟動雲端工作階段或配置例行工作的任何地方。
MCP 連接器流量通過 Anthropic 的伺服器路由,因此您在工作階段或例行工作上啟用的連接器無需將其主機新增到允許的域即可工作。連接器按工作階段或按例行工作配置;移除您不需要的任何連接器以限制 Claude 可以到達的工具。這依賴於安全性和隔離下提到的相同 Anthropic 綁定通道。

存取級別

在建立或編輯環境時選擇存取級別:
級別出站連接
無出站網路存取
信任允許清單域僅:套件登錄、GitHub、雲端 SDK
完全任何域
自訂您自己的允許清單,可選地包括預設值
GitHub 操作使用單獨的代理,獨立於此設定。

允許特定域

若要允許不在信任清單中的域,請在環境的網路存取設定中選擇自訂。出現允許的域欄位。每行輸入一個域:
api.example.com
*.internal.example.com
registry.example.com
使用 *. 進行萬用字元子域匹配。檢查也包括常見套件管理器的預設清單以將信任域與您的自訂項目一起保留,或將其取消選中以僅允許您列出的內容。

GitHub 代理

為了安全起見,所有 GitHub 操作都通過專用代理服務進行,該服務透明地處理所有 git 互動。在沙箱內,git 用戶端使用自訂建置的限定認證進行驗證。此代理:
  • 安全地管理 GitHub 驗證:git 用戶端在沙箱內使用限定認證,代理驗證並將其轉換為您的實際 GitHub 驗證令牌
  • 限制 git push 操作到目前工作分支以確保安全
  • 啟用複製、取得和 PR 操作,同時維護安全邊界

安全代理

環境在 HTTP/HTTPS 網路代理後面執行,用於安全和濫用防止目的。所有出站網際網路流量都通過此代理,該代理提供:
  • 防止惡意請求
  • 速率限制和濫用防止
  • 增強安全性的內容篩選

預設允許的域

使用信任網路存取時,預設允許以下域。標記為 * 的域表示萬用字元子域匹配,因此 *.gcr.io 允許 gcr.io 的任何子域。
  • api.anthropic.com
  • statsig.anthropic.com
  • docs.claude.com
  • platform.claude.com
  • code.claude.com
  • claude.ai
  • github.com
  • www.github.com
  • api.github.com
  • npm.pkg.github.com
  • raw.githubusercontent.com
  • pkg-npm.githubusercontent.com
  • objects.githubusercontent.com
  • release-assets.githubusercontent.com
  • codeload.github.com
  • avatars.githubusercontent.com
  • camo.githubusercontent.com
  • gist.github.com
  • gitlab.com
  • www.gitlab.com
  • registry.gitlab.com
  • bitbucket.org
  • www.bitbucket.org
  • api.bitbucket.org
  • registry-1.docker.io
  • auth.docker.io
  • index.docker.io
  • hub.docker.com
  • www.docker.com
  • production.cloudflare.docker.com
  • download.docker.com
  • gcr.io
  • *.gcr.io
  • ghcr.io
  • mcr.microsoft.com
  • *.data.mcr.microsoft.com
  • public.ecr.aws
  • cloud.google.com
  • accounts.google.com
  • gcloud.google.com
  • *.googleapis.com
  • storage.googleapis.com
  • compute.googleapis.com
  • container.googleapis.com
  • azure.com
  • portal.azure.com
  • microsoft.com
  • www.microsoft.com
  • *.microsoftonline.com
  • packages.microsoft.com
  • dotnet.microsoft.com
  • dot.net
  • visualstudio.com
  • dev.azure.com
  • *.amazonaws.com
  • *.api.aws
  • oracle.com
  • www.oracle.com
  • java.com
  • www.java.com
  • java.net
  • www.java.net
  • download.oracle.com
  • yum.oracle.com
  • proxy.golang.org
  • sum.golang.org
  • index.golang.org
  • golang.org
  • www.golang.org
  • goproxy.io
  • pkg.go.dev
  • maven.org
  • repo.maven.org
  • central.maven.org
  • repo1.maven.org
  • repo.maven.apache.org
  • jcenter.bintray.com
  • gradle.org
  • www.gradle.org
  • services.gradle.org
  • plugins.gradle.org
  • kotlinlang.org
  • www.kotlinlang.org
  • spring.io
  • repo.spring.io
  • dl.k8s.io (Kubernetes)
  • pkgs.k8s.io
  • k8s.io
  • www.k8s.io
  • releases.hashicorp.com (HashiCorp)
  • apt.releases.hashicorp.com
  • rpm.releases.hashicorp.com
  • archive.releases.hashicorp.com
  • hashicorp.com
  • www.hashicorp.com
  • repo.anaconda.com (Anaconda/Conda)
  • conda.anaconda.org
  • anaconda.org
  • www.anaconda.com
  • anaconda.com
  • continuum.io
  • apache.org (Apache)
  • www.apache.org
  • archive.apache.org
  • downloads.apache.org
  • eclipse.org (Eclipse)
  • www.eclipse.org
  • download.eclipse.org
  • nodejs.org (Node.js)
  • www.nodejs.org
  • developer.apple.com
  • developer.android.com
  • pkg.stainless.com
  • binaries.prisma.sh
  • statsig.com
  • www.statsig.com
  • api.statsig.com
  • sentry.io
  • *.sentry.io
  • downloads.sentry-cdn.com
  • http-intake.logs.datadoghq.com
  • *.datadoghq.com
  • *.datadoghq.eu
  • api.honeycomb.io
  • sourceforge.net
  • *.sourceforge.net
  • packagecloud.io
  • *.packagecloud.io
  • fonts.googleapis.com
  • fonts.gstatic.com
  • *.modelcontextprotocol.io

在網頁和終端之間移動任務

這些工作流程需要Claude Code CLI登入到相同的 claude.ai 帳戶。您可以從終端啟動新的雲端工作階段,或將雲端工作階段拉入終端以在本機繼續。雲端工作階段即使在您關閉筆記型電腦後仍會保留,您可以從任何地方(包括 Claude 行動應用程式)監控它們。
從 CLI,工作階段交接是單向的:您可以使用 --teleport 將雲端工作階段拉入終端,但無法將現有終端工作階段推送到網頁。--remote 旗標為您目前的儲存庫建立新的雲端工作階段。Desktop 應用程式提供可將本機工作階段發送到網頁的’在另一個表面繼續’功能表。

從終端到網頁

使用 --remote 旗標從命令列啟動雲端工作階段:
claude --remote "Fix the authentication bug in src/auth/login.ts"
這會在 claude.ai 上建立新的雲端工作階段。工作階段複製您目前目錄的 GitHub 遠端,位於您目前的分支,因此如果您有本機提交,請先推送,因為 VM 從 GitHub 而不是您的機器複製。--remote 一次適用於單一儲存庫。任務在雲端執行,而您繼續在本機工作。
--remote 建立雲端工作階段。--remote-control 無關:它公開本機 CLI 工作階段以從網頁進行監控。請參閱遠端控制
在 Claude Code CLI 中使用 /tasks 檢查進度,或在 claude.ai 或 Claude 行動應用程式上開啟工作階段以直接互動。從那裡,您可以引導 Claude、提供反饋或回答問題,就像任何其他對話一樣。

雲端任務的提示

在本機規劃,在遠端執行:對於複雜任務,在規劃模式下啟動 Claude 以協作制定方法,然後將工作發送到雲端:
claude --permission-mode plan
在規劃模式下,Claude 讀取檔案、執行命令以探索並提出計畫,而不編輯原始程式碼。一旦您對計畫感到滿意,將計畫保存到儲存庫、提交和推送,以便雲端 VM 可以複製它。然後為自主執行啟動雲端工作階段:
claude --remote "Execute the migration plan in docs/migration-plan.md"
此模式讓您可以控制策略,同時讓 Claude 在雲端自主執行。 使用 ultraplan 在雲端規劃:若要在網頁工作階段中起草和檢查計畫本身,請使用 ultraplan。Claude 在 Claude Code 網頁版上生成計畫,同時您繼續工作,然後您在瀏覽器中對部分進行評論並選擇遠端執行或將計畫發送回終端。 並行執行任務:每個 --remote 命令建立自己的雲端工作階段,獨立執行。您可以啟動多個任務,它們都會在單獨的工作階段中同時執行:
claude --remote "Fix the flaky test in auth.spec.ts"
claude --remote "Update the API documentation"
claude --remote "Refactor the logger to use structured output"
使用 Claude Code CLI 中的 /tasks 監控所有工作階段。當工作階段完成時,您可以從網頁介面建立 PR,或傳送工作階段到終端以繼續工作。

發送沒有 GitHub 的本機儲存庫

當您從未連接到 GitHub 的儲存庫執行 claude --remote 時,Claude Code 會捆綁您的本機儲存庫並直接上傳到雲端工作階段。捆綁包括您的完整儲存庫歷史記錄,跨所有分支,加上任何未提交的對追蹤檔案的變更。 當 GitHub 存取不可用時,此回退會自動啟動。若要即使在 GitHub 已連接時也強制它,請設定 CCR_FORCE_BUNDLE=1
CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"
捆綁的儲存庫必須符合這些限制:
  • 目錄必須是至少有一個提交的 git 儲存庫
  • 捆綁的儲存庫必須在 100 MB 以下。較大的儲存庫回退到僅捆綁目前分支,然後回退到工作樹的單一壓縮快照,並且僅在快照仍然太大時失敗
  • 未追蹤的檔案不包括;在您希望雲端工作階段看到的檔案上執行 git add
  • 從捆綁建立的工作階段無法推送回遠端,除非您也配置了 GitHub 驗證

從網頁到終端

使用以下任何方式將雲端工作階段拉入終端:
  • 使用 --teleport:從命令列,執行 claude --teleport 以進行互動式工作階段選擇器,或執行 claude --teleport <session-id> 以直接恢復特定工作階段。如果您有未提交的變更,系統會提示您先隱藏它們。
  • 使用 /teleport:在現有 CLI 工作階段內,執行 /teleport(或 /tp)以開啟相同的工作階段選擇器,而無需重新啟動 Claude Code。
  • /tasks:執行 /tasks 以查看您的背景工作階段,然後按 t 傳送到其中一個
  • 從網頁介面:選擇在 CLI 中開啟以複製可貼到終端的命令
當您傳送工作階段時,Claude 驗證您在正確的儲存庫中,從雲端工作階段取得並簽出分支,並將完整的對話歷史記錄載入到終端。 --teleport--resume 不同。--resume 從此機器的本機歷史記錄重新開啟對話,不列出雲端工作階段;--teleport 拉取雲端工作階段及其分支。

傳送要求

傳送在恢復工作階段之前檢查這些要求。如果任何要求未滿足,您會看到錯誤或被提示解決問題。
要求詳細資訊
乾淨的 git 狀態您的工作目錄必須沒有未提交的變更。如果需要,傳送會提示您隱藏變更。
正確的儲存庫您必須從同一儲存庫的簽出執行 --teleport,而不是分支。
分支可用雲端工作階段中的分支必須已推送到遠端。傳送會自動取得並簽出它。
相同帳戶您必須驗證到雲端工作階段中使用的相同 claude.ai 帳戶。

--teleport 不可用

傳送需要 claude.ai 訂閱驗證。如果您通過 API 金鑰、Bedrock、Vertex AI 或 Microsoft Foundry 進行驗證,請執行 /login 以改為使用您的 claude.ai 帳戶登入。如果您已通過 claude.ai 登入,--teleport 仍不可用,您的組織可能已禁用雲端工作階段。

使用工作階段

工作階段出現在 claude.ai/code 的側邊欄中。從那裡,您可以檢查變更、與隊友共享、封存完成的工作或永久刪除工作階段。

管理上下文

雲端工作階段支援產生文字輸出的內建命令。開啟互動式終端選擇器的命令(如 /model/config)不可用。 對於上下文管理特別:
命令在雲端工作階段中有效備註
/compact總結對話以釋放上下文。接受可選的焦點指示,如 /compact keep the test output
/context顯示目前在上下文視窗中的內容
/clear改為從側邊欄啟動新工作階段
自動壓縮在上下文視窗接近容量時自動執行,與 CLI 中相同。若要更早觸發它,請在您的環境變數中設定 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE。例如,CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70 在 70% 容量而不是預設 ~95% 時壓縮。若要更改壓縮計算的有效視窗大小,請使用 CLAUDE_CODE_AUTO_COMPACT_WINDOW Subagents 的運作方式與本機相同。Claude 可以使用 Task 工具生成它們,以將研究或並行工作卸載到單獨的上下文視窗中,保持主對話更輕。在您的儲存庫的 .claude/agents/ 中定義的 Subagents 會自動選擇。Agent teams 預設關閉,但可以通過將 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 新增到您的環境變數來啟用。

檢查變更

每個工作階段顯示一個差異指示器,其中包含新增和移除的行數,例如 +42 -18。選擇它以開啟差異檢視,在特定行上留下內聯評論,並使用您的下一條訊息將它們發送給 Claude。有關完整逐步說明(包括 PR 建立),請參閱檢查和迭代。若要讓 Claude 自動監控 PR 以查找 CI 失敗和審查評論,請參閱自動修復拉取請求

共享工作階段

若要共享工作階段,請根據下面的帳戶類型切換其可見性。之後,按原樣共享工作階段連結。收件者在開啟連結時看到最新狀態,但他們的檢視不會即時更新。

從 Enterprise 或 Team 帳戶共享

對於 Enterprise 和 Team 帳戶,兩個可見性選項是私人Team。Team 可見性使工作階段對您的 claude.ai 組織的其他成員可見。儲存庫存取驗證預設啟用,基於連接到收件者帳戶的 GitHub 帳戶。您帳戶的顯示名稱對所有有存取權限的收件者可見。Slack 中的 Claude工作階段會自動以 Team 可見性共享。

從 Max 或 Pro 帳戶共享

對於 Max 和 Pro 帳戶,兩個可見性選項是私人公開。公開可見性使工作階段對任何登入 claude.ai 的使用者可見。 在共享之前檢查您的工作階段是否包含敏感內容。工作階段可能包含來自私人 GitHub 儲存庫的程式碼和認證。儲存庫存取驗證預設未啟用。 若要要求收件者具有儲存庫存取權限,或從共享工作階段中隱藏您的名稱,請前往「設定」>「Claude Code」>「共享設定」。

封存工作階段

您可以封存工作階段以保持工作階段清單的組織。封存的工作階段隱藏在預設工作階段清單中,但可以通過篩選封存的工作階段來檢視。 若要封存工作階段,請在側邊欄中將滑鼠懸停在工作階段上,然後選擇封存圖示。

刪除工作階段

刪除工作階段會永久移除工作階段及其資料。此操作無法撤銷。您可以通過兩種方式刪除工作階段:
  • 從側邊欄:篩選封存的工作階段,然後將滑鼠懸停在您要刪除的工作階段上,並選擇刪除圖示
  • 從工作階段功能表:開啟工作階段,選擇工作階段標題旁的下拉式功能表,然後選擇刪除
在刪除工作階段之前,系統會要求您確認。

自動修復拉取請求

Claude 可以監視拉取請求並自動回應 CI 失敗和審查評論。Claude 訂閱 PR 上的 GitHub 活動,當檢查失敗或審查者留下評論時,Claude 會調查並推送修復(如果有明確的修復)。
自動修復需要在您的儲存庫上安裝 Claude GitHub App。如果您還沒有,請從 GitHub App 頁面安裝它,或在設定期間出現提示時安裝。
根據 PR 來自何處以及您使用的設備,有幾種方式可以開啟自動修復:
  • 在 Claude Code 網頁版中建立的 PR:開啟 CI 狀態欄並選擇自動修復
  • 從您的終端:在 PR 的分支上執行 /autofix-pr。Claude Code 使用 gh 偵測開啟的 PR,生成網頁工作階段,並在一個步驟中開啟自動修復
  • 從行動應用程式:告訴 Claude 自動修復 PR,例如「監視此 PR 並修復任何 CI 失敗或審查評論」
  • 任何現有 PR:將 PR URL 貼到工作階段中並告訴 Claude 自動修復它
自動修復是每個 PR 的切換開關。若要停止監視,請在網頁工作階段中開啟 CI 狀態欄並清除自動修復切換,或告訴 Claude 停止監視 PR。

Claude 如何回應 PR 活動

當自動修復處於活動狀態時,Claude 會收到 PR 的 GitHub 事件,包括新的審查評論和 CI 檢查失敗。對於每個事件,Claude 會調查並決定如何進行:
  • 明確的修復:如果 Claude 對修復有信心且不與早期指示衝突,Claude 會進行變更、推送它,並在工作階段中解釋所做的工作
  • 模糊的請求:如果審查者的評論可以以多種方式解釋或涉及架構上重要的內容,Claude 會在採取行動前詢問您
  • 重複或無操作事件:如果事件是重複的或不需要變更,Claude 會在工作階段中記錄它並繼續
Claude 可能會在 GitHub 上回覆審查評論執行緒作為解決它們的一部分。這些回覆使用您的 GitHub 帳戶發佈,因此它們會出現在您的使用者名稱下,但每個回覆都標記為來自 Claude Code,以便審查者知道它是由代理編寫的,而不是由您直接編寫的。
如果您的儲存庫使用評論觸發的自動化,例如 Atlantis、Terraform Cloud 或在 issue_comment 事件上執行的自訂 GitHub Actions,請注意 Claude 可以代表您回覆,這可能會觸發這些工作流程。在啟用自動修復之前檢查您的儲存庫自動化,並考慮為 PR 評論可以部署基礎設施或執行特權操作的儲存庫禁用自動修復。

安全性和隔離

每個雲端工作階段通過多個層與您的機器和其他工作階段分離:
  • 隔離的虛擬機器:每個工作階段在隔離的 Anthropic 管理的 VM 中執行
  • 網路存取控制:網路存取預設受限,可以禁用。在禁用網路存取的情況下執行時,Claude Code 仍然可以與 Anthropic API 通訊,這可能允許資料離開 VM。
  • 認證保護:敏感認證(如 git 認證或簽署金鑰)永遠不在沙箱內與 Claude Code 一起。驗證通過使用限定認證的安全代理進行處理。
  • 安全分析:程式碼在隔離的 VM 內進行分析和修改,然後建立 PR

故障排除

對於出現在對話中的執行時 API 錯誤,例如 API Error: 500529 Overloaded429Prompt is too long,請參閱錯誤參考。這些錯誤及其修復與 CLI 和 Desktop 應用程式共享。下面的部分涵蓋特定於雲端工作階段的問題。

工作階段建立失敗

如果新工作階段無法啟動,出現 Session creation failed 或在佈建時停滯,Claude Code 無法分配雲端環境。
  • 檢查 status.claude.com 以查找雲端工作階段事件
  • 一分鐘後重試,因為容量是按需佈建的
  • 確認您的儲存庫可到達。連接的 GitHub 帳戶必須能夠存取 GitHub 上的儲存庫,可以透過 Claude GitHub App 授權或透過 /web-setup 同步的 gh 令牌進行存取 — 不需要在儲存庫上安裝 App。請參閱 GitHub 驗證選項

遠端控制工作階段已過期或存取被拒絕

--teleport 通過與雲端工作階段使用的相同遠端控制工作階段基礎設施連接,因此驗證和工作階段過期錯誤會以遠端控制措辭出現。您可能會看到 Remote Control session expiredAccess denied。連接令牌是短期的,並限定於您的帳戶。
  • 在本機執行 /login 以刷新您的認證,然後重新連接
  • 確認您登入到擁有工作階段的相同帳戶
  • 如果您看到 Remote Control may not be available for this organization,您的管理員尚未為您的計畫啟用遠端工作階段

環境已過期

雲端工作階段在不活動一段時間後停止,基礎環境被回收。從本機終端,這會顯示為 Could not resume session ... its environment has expired. Creating a fresh session instead. 在網頁上,工作階段在工作階段清單中標記為已過期。 claude.ai/code 重新開啟工作階段以佈建新環境,並恢復您的對話歷史記錄。

限制

在依賴雲端工作階段進行工作流程之前,請考慮這些限制:
  • 速率限制:Claude Code 網頁版與您帳戶內所有其他 Claude 和 Claude Code 使用共享速率限制。並行執行多個任務會按比例消耗更多速率限制。雲端 VM 沒有單獨的計算費用。
  • 儲存庫驗證:您只能在驗證到相同帳戶時將工作階段從網頁移動到本機
  • 平台限制:儲存庫複製和拉取請求建立需要 GitHub。自託管GitHub Enterprise Server 執行個體支援 Team 和 Enterprise 計畫。GitLab、Bitbucket 和其他非 GitHub 儲存庫可以作為本機捆綁發送到雲端工作階段,但工作階段無法將結果推送回遠端
  • 組織 IP 允許清單:雲端工作階段從 Anthropic 管理的基礎設施而不是您的網路呼叫 Anthropic API。如果您的組織啟用了 IP 允許清單,每個雲端工作階段都會失敗,出現驗證錯誤。這同樣適用於程式碼審查例行工作。聯絡 Anthropic 支援以從您的組織的 IP 允許清單中豁免 Anthropic 託管的服務。

相關資源

  • Ultraplan:在雲端工作階段中起草計畫並在瀏覽器中檢查它
  • Ultrareview:在雲端沙箱中執行深度多代理程式碼審查
  • Routines:自動化按排程、通過 API 呼叫或回應 GitHub 事件的工作
  • Hooks 配置:在工作階段生命週期事件執行指令碼
  • 設定參考:所有配置選項
  • 安全性:隔離保證和資料處理
  • 資料使用:Anthropic 從雲端工作階段保留的內容