在雲端使用 Claude Code

從您的瀏覽器、手機、桌面應用程式或終端機在雲端執行 Claude Code 工作階段，使用 --cloud 和 --teleport 移動工作階段，以及自動修復 pull request。

雲端工作階段適用於 Pro、Max 和 Team 方案，以及具有高級席位或 Chat + Claude Code 席位的 Enterprise 使用者。

雲端工作階段是在雲端基礎設施上執行的 Claude Code 工作階段，而不是在您的機器上執行。預設情況下，它在 Anthropic 管理的基礎設施上執行，或在您的組織的自託管環境上執行（如果路由到那裡）。工作階段在您關閉筆記型電腦後仍會繼續執行，您可以從任何裝置檢查或控制它。它會與您其餘的 Claude 和 Claude Code 使用量一起計入您方案的用量上限，雲端 VM 不另外收費。

若要讓雲端工作階段從 GitHub 複製您的程式碼並推送分支，請使用其中一種 GitHub 連接方式連接 GitHub。如果您的儲存庫位於 GitLab、Bitbucket 或其他主機上，請參閱平台限制以了解可用的功能。

您可以從以下任何介面啟動雲端工作階段：

• 瀏覽器：claude.ai/code，也稱為網頁版 Claude Code
• 行動裝置：Claude 應用程式中的 Code 標籤
• 桌面應用程式：當您啟動工作階段時，選擇 Cloud 而不是 Local
• 終端：claude --cloud
• 例行工作：排程和觸發的執行每次都作為雲端工作階段執行

完成設定後，請使用本頁在終端機和雲端之間移動工作、管理和共享工作階段、為 pull request 開啟自動修復，以及進行疑難排解。

以下情況在其他頁面中說明：

• 啟動您的第一個雲端工作階段：開始使用雲端工作階段會連接 GitHub，並引導您在瀏覽器中完成一項任務
• 為一項工作使用多個雲端工作階段：專案會讓 Claude 為您啟動並追蹤這些工作階段
• 從另一部裝置控制本機工作階段：在您的終端機、IDE 或選擇了 Local 的 Desktop 應用程式中的工作階段會在您的機器上執行，而 Remote Control 可讓您從手機或瀏覽器存取這些工作階段

​

雲端環境

每個雲端工作階段都在一個雲端環境中執行，這是一個已保存的設定，控制網路存取、環境變數和設定指令碼。

• 您的第一個環境：如果您還沒有環境，上線會設定一個預設環境，具有信任網路存取，要麼為您建立它，要麼要求您建立它。請參閱預設環境，了解在您的計畫上會發生哪種情況
• 工作階段使用哪個環境：請參閱預設環境，了解當您有多個環境時工作階段如何選擇環境
• 變更工作階段在啟動時可以存取或執行的內容：請參閱設定雲端環境
• 在沒有任何設定的情況下已安裝的內容：請參閱已安裝的工具

​

GitHub 驗證選項

雲端工作階段需要存取您的 GitHub 儲存庫以複製程式碼和推送分支。您可以通過兩種方式授予存取權限：

方法	運作方式	工作階段可以存取的儲存庫	最適合
GitHub App	在網頁上線期間授權 Claude GitHub App	任何公開儲存庫，以及安裝了 Claude GitHub App 的私人儲存庫	瀏覽器上線；想要自動修復的團隊
/web-setup	在您的終端中執行 /web-setup 以將您的本機 gh CLI 令牌傳送到您的 Claude 帳戶	您的 gh 令牌可以存取的任何儲存庫，無論是否安裝了 Claude GitHub App	已經使用 gh 的個人開發者

以下功能取決於儲存庫上是否已安裝 Claude GitHub App：

• 自動修復：在儲存庫上安裝 Claude GitHub App 也會為其中的 pull request 啟用自動修復
• 專案：專案中的執行緒需要在它們複製的每個儲存庫上安裝 Claude GitHub App，無論您使用哪種方法連接。請參閱設定 GitHub 存取

在 Anthropic 代管的環境中，您的 GitHub 認證保持在 Anthropic 伺服器上加密，永遠不會進入工作階段的虛擬機器。來自虛擬機器的 GitHub 操作會通過 GitHub proxy，它在伺服器端附加認證。

有關 /web-setup 的逐步說明，請參閱從您的終端機連接，包括 /web-setup 儲存的內容以及如何移除它。

啟用零資料保留或已套用 HIPAA 設定的組織無法使用 /web-setup 或其他雲端工作階段功能。使用客戶管理的加密金鑰（CMEK）的組織也無法啟動雲端工作階段。

​

Team 和 Enterprise 的快速設定

快速設定是一個組織設定，可減少成員在 GitHub 和環境設定上的步驟。在 Team 和 Enterprise 計畫上，預設情況下它是關閉的。

開啟後，成員會有以下變化：

• /web-setup：成員可以使用 /web-setup 連接 GitHub。此設定關閉時，該命令會被隱藏
• GitHub App 提示：瀏覽器上線會跳過 Claude GitHub App 安裝提示
• 第一個環境：瀏覽器上線會為成員建立預設環境，而不是顯示環境表單

擁有者可以在 組織設定 > Claude Code 使用快速設定切換來開啟它。

​

在終端機和雲端之間移動任務

這些工作流程需要 Claude Code CLI 登入到同一個 claude.ai 帳戶。您可以從終端機啟動新的雲端工作階段，或將雲端工作階段拉入您的終端機以在本機繼續。雲端工作階段即使在您關閉筆記型電腦後仍會保留，您可以從任何地方（包括 Claude 行動應用程式）監控它們。

從 CLI，工作階段交接是單向的：您可以使用 --teleport 將雲端工作階段拉入您的終端機，但您無法將現有的終端機工作階段推送到雲端。--cloud 旗標搭配任務描述會為您目前的儲存庫建立新的雲端工作階段；搭配 -p 和工作階段 ID 或 claude.ai/code URL 時，它會改為 將訊息加入該現有工作階段的佇列。桌面應用程式 可以從其 Open in 功能表，將其 Code 分頁中的本機工作階段傳送到雲端。

​

從終端機啟動雲端工作階段

使用 --cloud 旗標從命令列啟動雲端工作階段：

claude --cloud "Fix the authentication bug in src/auth/login.ts"

這會在 claude.ai 上建立新的雲端工作階段。雲端 VM 會在您目前的分支上複製您目前目錄的 GitHub 遠端，而不是您的本機簽出，所以如果您有本機提交，請先推送。請參閱 Send local repositories without GitHub 以了解 Claude Code 上傳您的本機儲存庫而不是複製的情況。

--cloud 一次只能與單一儲存庫搭配使用。任務在雲端執行，而您繼續在本機工作。較舊的 --remote 拼寫仍然可作為 --cloud 的已棄用別名使用。

當雲端容器啟動時，CLI 會顯示設定步驟的即時檢查清單，例如複製儲存庫和執行您的 setup script。它會將您在佈建期間輸入的訊息加入佇列，並在工作階段準備好後傳送它們。

--cloud 會建立雲端工作階段。--remote-control 無關：它可讓您從 claude.ai 或 Claude 應用程式監控和控制本機 CLI 工作階段。請參閱 Remote Control。

在 claude.ai 或 Claude 行動應用程式上開啟工作階段以檢查進度或直接互動。從那裡您可以控制 Claude、提供回饋或回答問題，就像在任何其他對話中一樣。

如果 Claude 提出問題且工作階段閒置，您仍然可以在回來時回答，直到 environment expiry，工作階段會從您的回答繼續。

​

雲端任務的提示

在本機規劃，在雲端執行：對於複雜的任務，先啟動 Claude 進入規劃模式以協作制定方法，然後將工作傳送到雲端：

claude --permission-mode plan

在規劃模式中，Claude 讀取檔案、執行命令以探索，並提出計畫而不編輯原始程式碼。一旦您滿意，將計畫儲存到儲存庫、提交並推送，以便雲端 VM 可以複製它。然後啟動雲端工作階段以進行自主執行：

claude --cloud "Execute the migration plan in docs/migration-plan.md"

並行執行任務：每個 --cloud 命令都會建立自己的雲端工作階段，獨立執行。您可以啟動多個任務，它們都會在不同的工作階段中同時執行：

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

當工作階段完成時，您可以從 claude.ai/code 建立 PR，或 teleport 工作階段到您的終端機以繼續工作。

​

傳送沒有 GitHub 的本機儲存庫

當您從沒有 git 遠端的儲存庫執行 claude --cloud，或從 Claude GitHub App 未安裝的 github.com 儲存庫執行時，Claude Code 會將您的本機儲存庫打包並直接上傳到雲端工作階段。即使您使用 /web-setup 連接了 GitHub，這也適用。

對於完整複製，該套件包括您在所有分支上的儲存庫歷史記錄，加上對追蹤檔案的未提交變更。

敏感檔案中未提交變更的處理方式取決於您的平台：

• macOS、Linux 和 WSL：Claude Code 會將名稱類似於憑證或金鑰的檔案的未提交變更排除在上傳之外。這涵蓋 .env 檔案、Terraform *.tfvars 檔案和金鑰檔案，例如 id_rsa 和 *.pem。它也會排除由 Git LFS 等 git 篩選器所管理之檔案的未提交變更。Left on this machine: 通知會列出被排除的檔案，工作階段會以每個檔案的已提交版本啟動，或如果未提交任何版本，則不含該檔案。
• 原生 Windows：對追蹤檔案的未提交變更會按原樣上傳，無論檔案名稱為何。在啟動雲端工作階段之前，請先隱藏或還原您不希望出現在其中的編輯。

若要在 Claude Code 會從遠端複製時強制上傳套件，請設定 CCR_FORCE_BUNDLE=1：

CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

打包的儲存庫必須符合這些限制：

• 目錄必須是至少有一個提交的 git 儲存庫
• 打包的儲存庫必須在 100 MB 以下。較大的儲存庫會回退到僅打包目前分支，然後回退到工作樹的單一壓縮快照，如果快照仍然太大則失敗
• 未追蹤的檔案不包括在內；在您希望雲端工作階段看到的檔案上執行 git add
• 在 macOS、Linux 和 WSL 上，當 Claude Code 無法遵循影響您的檔案適用哪些屬性規則的 git 設定時，Claude Code 會拒絕上傳，例如在包含的設定檔中設定的 core.attributesFile。拒絕訊息 會命名該設定和修正方式
• 從套件建立的工作階段只有在您的 GitHub connection 對該儲存庫具有推送存取權時，才能推送回 GitHub 遠端

在 macOS、Linux 和 WSL 上，上傳還需要 git 2.31 或更新版本以及其支援的簽出結構；而在原生 Windows 上，Claude Code 上傳時不會進行這兩項檢查。當簽出不符合這些需求時，Claude Code 不會啟動工作階段。它會列印包含 Not uploading this working tree: 的錯誤，說明原因以及需要變更的內容。以下是常見原因：

• 較舊的 git：已安裝的 git 早於 2.31。請更新 git，然後重試。
• 上傳不支援的簽出結構：您是從子模組內、使用 git clone --separate-git-dir、--shared 或 --reference 建立的複製中、設定了 core.worktree 的簽出中，或以 reftable 格式儲存 refs 的儲存庫中啟動。請改為從使用一般 git clone 建立之複製的主要簽出啟動。
• 使用稀疏簽出的連結 worktree：git sparse-checkout 會將設定寫入 worktree 自己的 config.worktree 檔案，而上傳不接受該檔案，因此具有這些設定的 worktree 不會被上傳，Claude Code 透過 worktree.sparsePaths 建立的 worktree 也不會。請改為從儲存庫的主要簽出啟動。
• 保存在工作樹內的 git 設定：您的 git 設定包含位於簽出內的檔案，例如指向儲存庫內部的 include.path 項目。請將該檔案移到工作樹之外或移除該 include，然後重試。

在 macOS、Linux 和 WSL 上，使用 git clone --filter 建立的部分複製會以其工作樹的快照（不含歷史記錄）上傳，前提是該複製在本機保有每個追蹤檔案。

對於 claude --cloud，如果儲存庫位於 GitHub 上，您可以避免上傳及其需求：推送您的分支、在儲存庫上安裝 Claude GitHub App，然後再次啟動工作階段，使其從 GitHub 複製。

​

從 CLI 傳送後續訊息

一旦雲端工作階段執行，無論它在何處執行，都可以從任何您使用 claude auth login 登入的機器上的 claude CLI 傳送後續訊息。CLI 使用您的 Anthropic 帳戶憑證進行身分驗證，不傳送任何本機工作階段狀態，因此命令不需要從啟動工作階段的機器執行。

該命令發佈一條訊息並退出：

claude -p "your message" --cloud <session-id>

CLI 將訊息加入工作階段的佇列並退出，不等待回覆。使用它來控制長時間執行的工作階段、在目前工作階段仍在完成時將下一步加入佇列，或從 CI script 傳送後續訊息。您也可以在 stdin 上管道傳輸訊息，而不是將其作為引數傳遞：echo "your message" | claude -p --cloud <session-id>。

對於 <session-id>，傳遞裸 ID，例如 session_... 或 cse_...，或工作階段的 claude.ai/code/<id> URL，有或沒有配置或查詢字串。在 claude.ai/code 的工作階段清單中找到 ID。

--cloud 需要 Anthropic 帳戶。當 Claude Code 針對 Amazon Bedrock、Google Cloud 的 Agent Platform 或其他第三方提供者進行設定時，它不可用。僅透過 ANTHROPIC_BASE_URL 設定的 LLM gateway 不算作此檢查的第三方提供者，但您仍需要使用 claude auth login 登入。您組織的 allow_remote_sessions 原則也必須啟用。擁有者可以在 claude.ai/admin-settings/claude-code 的 Claude Code 管理設定中開啟它。

​

輸出

成功時，命令會列印工作階段 ID 和檢視工作階段的連結：

Sent to cloud session.
Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0

傳遞 --output-format json 以取得機器可讀的結果：成功時為 {ok, session_id, url}，或當傳送失敗時為 {ok: false, session_id, error}，例如當工作階段遺失或已封存時。設定錯誤（例如不支援的提供者或已停用的組織原則）會列印到 stderr，不含 JSON。--output-format stream-json 不支援 --cloud <session-id>。

如果傳送失敗，請參閱 傳送到雲端工作階段時的錯誤。

​

在終端機中繼續雲端工作階段

使用以下任何方式將雲端工作階段拉入您的終端機：

• 使用 --teleport：從命令列執行 claude --teleport 以取得互動式工作階段選擇器，或 claude --teleport <session-id> 以直接繼續特定工作階段。如果您有未提交的變更，系統會提示您先將它們隱藏。
• 使用 /teleport：在現有 CLI 工作階段內執行 /teleport 或 /tp 以開啟相同的工作階段選擇器，無需重新啟動 Claude Code。
• 從 /tasks：執行 /tasks 以查看您的背景工作階段，然後按 t 以 teleport 進入其中一個。
• 從 claude.ai/code：從工作階段功能表選擇 Open in > Terminal 以複製可以貼到您的終端機的命令。
• 從雲端工作階段內：輸入 /teleport，Claude Code 會回覆確切的 claude --teleport <session-id> 命令，準備從儲存庫的簽出執行。需要工作階段環境中的 Claude Code v2.1.223 或更新版本。

當您 teleport 工作階段時，Claude 會驗證您在正確的儲存庫中，擷取並簽出雲端工作階段的分支，並將完整的對話歷史記錄載入您的終端機。終端機會取得工作階段的自己副本：那裡的新工作保持本機，不會出現在 claude.ai 上的雲端工作階段或 Claude 行動應用程式中。若要在 teleport 後繼續從您的手機控制，請在本機工作階段中啟動 /remote-control。

--teleport 與 --resume 不同。--resume 從此機器的本機歷史記錄重新開啟對話，不列出雲端工作階段；--teleport 拉入雲端工作階段及其分支。

​

Teleport 需求

Teleport 在繼續工作階段之前檢查這些需求。如果任何需求未滿足，您會看到錯誤或被提示解決問題。

需求	詳細資訊
乾淨的 git 狀態	您的工作目錄必須沒有未提交的變更。如果需要，Teleport 會提示您隱藏變更。
正確的儲存庫	您必須從同一儲存庫的簽出執行 --teleport，而不是分叉。如果您從不同儲存庫的簽出執行它，Claude Code 會顯示一個錯誤，命名工作階段的儲存庫和您的簽出的儲存庫。如果 Claude Code 無法將您的遠端解析為主機名稱，例如 SSH 主機別名如 git@work:owner/repo.git，它會要求您確認，並在遠端的擁有者和儲存庫名稱與工作階段的儲存庫相符時接受簽出。
分支可用	雲端工作階段的分支必須已推送到遠端。Teleport 會自動擷取並簽出它。
相同帳戶	您必須驗證到雲端工作階段中使用的同一 claude.ai 帳戶。

當 teleport 擷取工作階段的分支時，擷取作業絕不會在您的終端機中等待輸入。如果 git 或 ssh 需要詢問密碼、金鑰密語或新 SSH 主機的確認，擷取就會失敗，而只有在您的本機複製已有該分支時，簽出才能成功。對於這兩種 SSH 情況，請將您的金鑰載入 ssh-agent，並先手動執行一次 git fetch 以記錄主機。

​

--teleport 不可用

Teleport 需要 claude.ai 訂閱身分驗證。請找出符合您情況的項目：

• 您透過 API 金鑰進行身分驗證：執行 /login 以改為使用您的 claude.ai 帳戶登入
• 錯誤命名了您的提供者：雲端工作階段無法透過第三方提供者取得。請參閱 錯誤表
• 您已透過 claude.ai 登入：您的組織可能已停用雲端工作階段

​

使用工作階段

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

​

雲端工作階段中的權限模式

您可以從模式下拉式功能表選擇雲端工作階段的權限模式，無論是在您建立任務時還是在工作階段執行時。

當您執行下列任一操作時，Claude Code 會以工作階段當時所在的權限模式恢復該工作階段：

• 重新開啟其 Anthropic 託管環境已過期的工作階段
• 向自託管執行器在閒置時釋放的工作階段發送訊息

​

檢查變更

每個工作階段顯示一個差異指示器，其中包含新增和移除的行數，例如 +42 -18。選擇它以開啟差異檢視、在特定行上留下內聯評論，並使用您的下一條訊息將它們發送給 Claude。

差異檢視預設會將工作階段的變更與其基礎分支進行比較。若要與儲存庫中的任何其他分支進行比較，請選擇比較對象並選擇一個。

Claude Code 從原始 git blob 內容計算這些差異，因此儲存庫中設定的差異驅動器和 textconv 篩選器不適用。

以下步驟在其他地方有說明：

• 完整逐步說明，包括 PR 建立：請參閱檢查和迭代
• 讓 Claude 自動監控 PR 以查找 CI 失敗和審查評論：請參閱自動修復 pull requests

​

管理上下文

雲端工作階段支援產生文字輸出的內建命令。只在終端介面中執行的命令，例如 /plugin 或 /resume，無法使用。在雲端工作階段中開啟選擇器或面板的命令行為不同：

• /model、/effort、/color 和 /rename：將值作為引數傳遞，例如 /model sonnet，而不是開啟終端機選擇器或滑塊。引數形式遵循每個命令的可用性說明。
• /fast：當快速模式在您的帳戶上可用時，為工作階段切換快速模式。需要工作階段環境中的 Claude Code v2.1.271 或更新版本。
• /config：在您的瀏覽器上的 claude.ai/code，開啟您設定的 Claude Code 部分，而不是設定值，命令後的文字（包括 key=value）會被忽略。若要變更雲端工作階段的設定，請設定環境上的環境變數，或在具有一個儲存庫的工作階段中，將該設定鍵提交到該儲存庫的 .claude/settings.json。雲端工作階段中的設定列出每個工作階段讀取的內容。

對於上下文管理特別：

命令	在雲端工作階段中有效	備註
/compact	是	總結對話以釋放上下文。接受可選的焦點指示，如 /compact keep the test output
/context	是	顯示目前在上下文視窗中的內容
/clear	否	改為從側邊欄啟動新工作階段

自動壓縮在上下文視窗接近容量時自動執行。雲端工作階段自行設定 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE，因此壓縮會在自動壓縮視窗的中途觸發，而不是在視窗填滿時。該值會覆蓋您在環境變數中新增的值，因此在那裡新增變數不會變更壓縮觸發的時間。

若要改為變更自動壓縮視窗，請在您的環境變數中設定 CLAUDE_CODE_AUTO_COMPACT_WINDOW，或在未設定變數的工作階段中執行 /autocompact，搭配令牌計數。

Subagents 的運作方式與本機相同。Claude 可以使用 Agent 工具生成它們，以將研究或並行工作卸載到單獨的上下文視窗中，保持主對話更輕。在您的儲存庫的 .claude/agents/ 中定義的 Subagents 會自動選擇。

Agent teams 預設關閉，但可以通過將 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 新增到您的環境變數來啟用。

​

取回已排隊的訊息

如果您在 Claude 工作時發送訊息，該訊息會排隊，直到 Claude 讀取它。若要取回已排隊的訊息，請點擊它上面的 ✕。文字會返回到訊息框，以便您可以編輯它或發送其他內容。

如果 Claude 已經讀取訊息，它會保留在對話中。

​

共享工作階段

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

​

從 Enterprise 或 Team 帳戶共享

對於 Enterprise 和 Team 帳戶，共享的運作方式如下：

• 可見性選項：私人和Team。Team 可見性使工作階段對您的 claude.ai 組織的其他成員可見
• 儲存庫存取：驗證預設啟用，基於連接到收件者帳戶的 GitHub 帳戶
• 您的名稱：您帳戶的顯示名稱對所有有存取權限的收件者可見
• Slack 工作階段：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：開啟工作階段於 claude.ai/code，開啟 CI 狀態欄，並選擇自動修復
• 從您的終端：在 PR 的分支上執行 /autofix-pr。Claude Code 使用 gh 偵測開啟的 PR，生成網頁工作階段，並在一個步驟中開啟自動修復
• 從行動應用程式：告訴 Claude 自動修復 PR，例如「監視此 PR 並修復任何 CI 失敗或審查評論」
• 任何現有 PR：將 PR URL 貼到工作階段中並告訴 Claude 自動修復它

自動修復是每個 PR 的切換開關。若要停止監視，請在 claude.ai/code 的工作階段中開啟 CI 狀態欄並清除自動修復切換，或告訴 Claude 停止監視 PR。

​

Claude 如何回應 PR 活動

當自動修復處於活動狀態時，Claude 會收到 PR 的 GitHub 事件，包括新的審查評論和 CI 檢查失敗。對於每個事件，Claude 會調查並決定如何進行：

• 明確的修復：如果 Claude 對修復有信心且不與早期指示衝突，Claude 會進行變更、推送它，並在工作階段中解釋所做的工作
• 模糊的請求：如果審查者的評論可以以多種方式解釋或涉及架構上重要的內容，Claude 會在採取行動前詢問您
• 重複或無操作事件：如果事件是重複的或不需要變更，Claude 會在工作階段中記錄它並繼續

GitHub 不會在基礎分支推進並建立合併衝突時發出 webhook，因此自動修復無法自行對衝突做出反應。若要解決衝突，請開啟工作階段並要求 Claude 進行變基。

Claude 可能會在 GitHub 上回覆審查評論執行緒作為解決它們的一部分。這些回覆使用您的 GitHub 帳戶發佈，因此它們會出現在您的使用者名稱下，但每個回覆都標記為來自 Claude Code，以便審查者知道它是由代理編寫的，而不是由您直接編寫的。

如果您的儲存庫使用評論觸發的自動化，例如 Atlantis、Terraform Cloud 或在 issue_comment 事件上執行的自訂 GitHub Actions，請注意 Claude 可以代表您回覆，這可能會觸發這些工作流程。在啟用自動修復之前檢查您的儲存庫自動化，並考慮為 PR 評論可以部署基礎設施或執行特權操作的儲存庫禁用自動修復。

​

安全性和隔離

每個雲端工作階段通過多個層與您的機器和其他工作階段分離：

• 隔離的虛擬機器：每個工作階段在隔離的 Anthropic 管理的 VM 中執行。您的組織路由到自託管環境的工作階段改為在您自己的基礎設施上執行，其中隔離是您的部署的責任
• 網路存取控制：在 Anthropic 託管的環境中，網路存取預設受限，可以禁用。請參閱網路存取以了解存取層級、預設允許的網域，以及不通過允許清單的流量。在自託管環境中，您在自己的網路邊界限制工作階段出口。當以禁用的網路存取執行時，Claude Code 仍然可以與 Anthropic API 通訊，這可能允許資料離開 VM。
• 憑證保護：在 Anthropic 託管的環境中，git 憑證和簽署金鑰保持在沙箱外，代理伺服器使用限定範圍的憑證代表工作階段進行驗證。在自託管環境中，您的部署提供 git 憑證；請參閱設定 git
• 網路機密：在 Anthropic 託管的環境中，您新增到雲端環境的金鑰同樣保持在沙箱外，並在符合的請求離開工作階段後附加到這些請求上。自託管環境沒有網路機密
• 安全分析：程式碼在隔離的工作階段環境內進行分析和修改，然後建立 PR

​

故障排除

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

​

工作階段建立失敗

如果新工作階段無法啟動，出現 Session creation failed 或在佈建時停滯，Claude Code 無法為工作階段分配 VM。

• 檢查 status.claude.com 以查找雲端工作階段事件
• 一分鐘後重試，因為容量是按需佈建的
• 確認您的 GitHub 連線可以到達儲存庫，請遵循連接 GitHub 後沒有儲存庫出現

​

無法取得組織 UUID

claude --cloud 和 claude --teleport 需要使用 claude.ai 帳戶登入。如果您使用 API 金鑰進行身分驗證，或您儲存的帳戶詳細資訊已過期，您會看到以下其中一項：

• Unable to get organization UUID
• Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
• 在不提供工作階段 ID 的情況下執行 claude --teleport 時，工作階段選擇器中出現 Error loading Claude Code sessions

在您的 shell 中執行 claude auth login 以使用您的 claude.ai 帳戶登入，然後重試命令。在執行中的工作階段內，/login 的作用相同。如果錯誤改為指出您的提供者名稱，請參閱錯誤表：雲端工作階段無法透過第三方提供者使用。

從 v2.1.274 到 v2.1.289，登入訊息為 Claude Code cloud sessions require authentication with a Claude.ai account. API key authentication is not sufficient. Please run /login to authenticate, or check your authentication status with /status.

​

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

--teleport 通過與雲端工作階段使用的相同遠端控制工作階段基礎設施連接，因此驗證和工作階段過期錯誤會以遠端控制措辭出現。您可能會看到 Remote Control session expired 或 Access denied。連接令牌是短期的，並限定於您的帳戶。

• 在本機執行 /login 以刷新您的認證，然後重新連接
• 確認您登入到擁有工作階段的相同帳戶
• 如果您看到 Remote Control may not be available for this organization，擁有者尚未為您的組織啟用雲端工作階段

​

傳送至雲端工作階段時的錯誤

這些錯誤來自使用 --cloud <session-id> 執行 claude，無論是否搭配 -p。CLI 會在錯誤前加上 Error: 前綴。傳送失敗會包裝為 failed to send message to cloud session <id>: <reason>。

訊息	含義
Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.	Claude Code 已設定為使用第三方提供者。訊息會以您的設定所使用的標籤指出提供者名稱，例如 Amazon Bedrock 或 Google Vertex AI。請移除該提供者的設定，例如取消設定 CLAUDE_CODE_USE_BEDROCK，並使用 Anthropic 帳戶登入（claude auth login）。
Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.	您組織的 allow_remote_sessions 政策已關閉；請參閱Cloud sessions are disabled by your organization’s policy。如果訊息改為指出此工作階段正在使用的某個憑證，請參閱Cloud sessions use your claude.ai login。
Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.	Claude Code 尚未完成載入您組織的政策，因此會拒絕傳送，而不是假設允許雲端工作階段。請檢查您的網路連線並重試。
Cloud sessions aren't available: 後接原因	載入您組織的政策失敗，訊息的其餘部分說明失敗的方式。請針對其指出的原因採取行動；請參閱Couldn’t verify your organization’s policy for cloud sessions。
Attaching to an existing cloud session is not enabled for your account.	您在未使用 -p 的情況下執行了 --cloud <session-id>。請使用 claude -p "your message" --cloud <session-id> 傳送訊息。
Session not found: <id>	該 ID 或 URL 與您可存取的任何工作階段都不相符。請對照工作階段的 claude.ai/code URL 進行檢查。
cloud session <id> is archived and cannot accept new messages	該工作階段已封存。請改為啟動新的工作階段。

​

環境已過期

雲端工作階段在不活動一段時間後停止，工作階段的 VM 被回收。工作階段在等待您批准 MCP 連接器工具呼叫或登入 MCP 伺服器時計為不活動，並且可以在該等待期間過期。

從 claude.ai/code 重新開啟工作階段以佈建新 VM：

• 會恢復：您的對話歷史記錄
• 不會恢復：在 VM 被回收時仍在執行的背景工作，例如 subagents 和 shell 命令，以及自行決定節奏的 /loop 尚待執行的喚醒。若要重新啟動迴圈，請再次執行 /loop。

​

限制

在依賴雲端工作階段進行工作流程之前，請考慮這些限制：

• 速率限制：雲端工作階段與您帳戶內所有其他 Claude 和 Claude Code 使用共享速率限制。並行執行多個任務會按比例消耗更多速率限制。
• 時間限制：Claude 執行的命令和 SessionStart hooks 有您可以變更的預設逾時，且設定指令碼只有在大約五分鐘內完成時才會被快取。請參閱時間限制
• 儲存庫驗證：您只能在驗證到相同帳戶時將雲端工作階段拉入您的終端機
• 平台限制：儲存庫複製和拉取請求建立需要 GitHub。自託管 GitHub Enterprise Server 執行個體支援 Team 和 Enterprise 計畫。您可以透過設定 CCR_FORCE_BUNDLE=1，將 GitLab、Bitbucket 或其他非 GitHub 儲存庫作為本機捆綁發送到雲端工作階段，但工作階段無法將結果推送回該遠端
• 組織 IP 允許清單：雲端工作階段從 Anthropic 管理的基礎設施而不是您的網路呼叫 Anthropic API，而自託管環境中的工作階段從您自己的網路呼叫它。如果您的組織啟用了 IP 允許清單，每個 Anthropic 託管的雲端工作階段都會失敗，出現驗證錯誤。這同樣適用於程式碼審查和例行工作，在 Anthropic 託管的環境中執行；路由到自託管環境的例行工作從您自己的網路呼叫 API。聯絡 Anthropic 支援以從您的組織的 IP 允許清單中豁免 Anthropic 託管的服務。

​

相關資源

• 雲端環境：為雲端工作階段配置網路存取、環境變數和設定指令碼
• 專案：一個對話，Claude 在其中協調您存放庫上的平行雲端工作階段並回報結果
• Ultrareview：在雲端沙箱中執行深度多代理程式碼審查
• 例行工作：自動化按排程、通過 API 呼叫或回應 GitHub 事件的工作
• Hooks 配置：在工作階段生命週期事件執行指令碼
• 所有設定：所有配置選項
• 安全性：隔離保證和資料處理
• 資料使用：Anthropic 從雲端工作階段保留的內容
• Claude Tag：在 Slack 中由組織管理的 @Claude，在相同的雲端基礎設施上執行