跳到正文
Anthropic:Claude.dev 開發者博客· Addy Osmani·· 2026-10-06精選AI 評分80

Claude Code 雲端工作階段實用指南

Claude Code in the cloud: a field guide to cloud sessions

AI 導讀

Claude Code 雲端工作階段為每項任務建立獨立虛擬機和分支,讓多項工作並行,完成後可供檢視或建立 pull request。作者以示例倉庫測試三項並行工作,首項啟動後 87 秒全部完成,其中一項修正後連續執行 npm test 40 次且零失敗。雲端運算不另收費,但工作階段沿用方案用量額度。

推薦理由

實測展示獨立虛擬機如何減少並行任務互相干擾,並整理任務拆分、驗證指令與分支合併的實用做法。

正文 · 繁體中文

你大概是在自己的手提電腦上透過終端機執行 Claude Code。該工作階段在三方面依賴這部手提電腦:

  • 它會共用你的工作樹,因此同一個存放庫上的兩個工作階段可能會編輯同一批檔案,並爭用同一個連接埠。
  • 它會使用你的憑證執行。
  • 電腦進入睡眠或 Wi-Fi 斷線時,工作階段便會停止。

雲端工作階段會在獨立的機器上執行 Claude Code。每項任務都會獲配一部全新的虛擬機器,將你的存放庫複製到新分支,並預先完成環境設定。

你可以在 claude.ai/code、Claude 手機應用程式、Desktop 應用程式、你的終端機和 Slack 啟動雲端工作階段,然後透過瀏覽器、手機應用程式和 Desktop 追蹤進度。工作完成後,成果會留在一個分支上,你可以將它轉為 pull request。

Pro、Max、Team 或 Enterprise 方案均包含雲端工作階段,無須額外付費:雲端機器不會另行收費,工作階段也會使用與 Claude Code 其他部分相同的使用量上限。視乎你的方案,組織擁有人或需先啟用雲端工作階段。

雲端工作階段額外額度。現有個人 Pro 和 Max 訂戶可領取一次性的雲端工作階段額外額度,金額不計入方案使用上限:Pro 為 $100,Max 為 $250。請於 10 月 7 日前前往 claude.ai/code/claim-credit,或在 Claude Code 中使用 /claim-credit 領取。額度將於 11 月 4 日到期。額度用完或到期後,將按方案的正常使用規則計算。此額度不適用於 Projects 或 Routines。詳情請參閲促銷額度優惠條款。

為了撰寫本指南,我使用一個小型示例存放庫執行了四個實際的雲端工作階段。下文會展示各工作階段的對話紀錄、差異和執行時間。截圖中的存放庫和用戶均為虛構。工作內容、輸出和數據均來自這些工作階段。

雲端工作階段的一大優點,是可以同時執行多項任務,而不會互相干擾。以下是我在 16 秒內陸續啟動的三個工作階段,每個都在自己的機器上執行。在手提電腦上,我只能逐一執行這些任務,或花時間避免它們互相干擾。

Timeline of three cloud sessions in three VMs, started within 16 seconds of each other. After a hatched setup bar, the flaky-test fix finishes at 65 seconds with the suite run 40 times and 0 failures, the docs rewrite at 62 seconds with 5 doc errors fixed, and the structured-logging change at 87 seconds with JSON logs and 5 new tests.

圖 A同一個存放庫中三個雲端工作階段的實際時間軸,以首個工作階段開始後的秒數計算。斜線條代表重新建立示例存放庫的設定步驟(正常使用時會改為從 GitHub 複製存放庫);每個圓點代表一次工具呼叫。

三項任務、一個存放庫、三部機器

示例存放庫 tidepool 是一個小型 Node API,用來預測三個虛構港口的潮汐。它有三個常見問題:有一項測試約每四次執行便失敗一次;API 文件描述了程式碼已不再讀取的參數;記錄器則透過串接字串來組成日誌行。

我在 16 秒內陸續啟動了三個雲端工作階段,分別處理一個問題。我透過程式啟動它們;由於 tidepool 並不在 GitHub 上,每個工作階段都先根據提示詞中的檔案重新建立存放庫。使用真實存放庫時便可略過這個步驟;在終端機中,每個工作階段只需執行一個 claude --cloud 指令。以下是三個提示詞的精簡版本:

程式碼Shell

claude --cloud "npm test fails maybe one run in four. Find the flaky test, fix the root cause in the code (not the test), and prove it by running the suite at least 30 times in a row."
claude --cloud "docs/API.md is out of date with src/server.js. Rewrite it so every endpoint, parameter, default and response shape matches the code. Start the server and run each curl example to check it."
claude --cloud "Make src/logger.js emit one JSON object per line, keep LOG_LEVEL, and log method, path, status and duration_ms as fields. Add a test for the logger."

這些工作階段分別執行了 61、65 和 72 秒;首個工作階段啟動後 87 秒,三個工作階段便全部完成。重新建立存放庫的步驟,約佔每次執行時間的三分之一至略多於一半。以下是執行結果。

  • 偶發失敗的測試。 Claude 在 TtlCache.get 中發現競爭狀況。快取只會在載入器完成後才儲存值,因此在載入期間,若有另一個 get 使用相同的鍵,就會再次呼叫載入器。Claude 修改快取,改為儲存仍在執行的 Promise;載入失敗時則移除該項目,並連續執行 npm test 40 次,零次失敗。
  • 文件。 Claude 啟動伺服器,對每個端點執行 curl,發現舊文件有五處錯誤:列出了 API 從不會回傳的欄位、記錄了一個程式碼會忽略的 days 參數、把以米為單位的高度寫成英尺、漏掉了 /next-high 端點,亦沒有列出錯誤回應。Claude 亦發現,格式錯誤的 from= 值會以 200 回傳空清單,於是把這點記錄為注意事項,而沒有修改未獲要求處理的伺服器程式碼。
  • 記錄器。 Claude 撰寫了 JSON 記錄器,把請求記錄改為結構化欄位,並新增五項測試。提交中有一項測試未能通過,於是 Claude 把快取測試重跑八次,發現其中五次失敗,並追查出問題源於第一個工作階段正在修正的同一個競爭狀況。Claude 提出相同的修正方法,但因為快取不在其任務範圍內而沒有修改,並在摘要中指出測試套件未能全部通過。
圖 E同一個本機建置的 20 秒錄影:在三個工作階段之間切換,然後向下捲動記錄器工作階段的對話記錄

記錄器的結果説明瞭為何雲端工作階段適合並行工作。每個工作階段都有自己的儲存庫副本、程序和分支。文件工作階段和記錄器工作階段各自啟動 API 伺服器進行測試,互不影響。在同一部手提電腦上,若兩個 Agent 在同一個工作目錄中工作,就會編輯相同檔案;除非各自使用不同連接埠,否則亦會爭用同一個連接埠。

由於彼此隔離,記錄器工作階段無法存取第一個工作階段正在進行的快取修正。並行任務應按檔案範圍拆分,按合理次序合併分支,並預期某個工作階段可能會回報另一個工作階段已在修正的問題。

CLAUDE CODE 雲端工作階段的內部運作

雲端工作階段是在 Anthropic 管理的基礎設施上執行的 Claude Code 工作階段;你亦可透過自行託管環境,在組織自己的機器上執行。圖示展示其組成部分。其後列出的四項重點會影響你的工作方式。

You start a session from a browser, phone, Desktop, terminal, Slack or a routine. It runs in a fresh VM with a clone of your repository on a claude branch, Claude Code in auto mode, and your environment's setup. GitHub traffic passes through a proxy that holds your token outside the VM; other traffic passes through a security proxy that applies the network allowlist. The result is a branch and a pull request.
圖 F雲端工作階段的結構。Agent 能接觸的一切都位於 VM 內。你的 GitHub 權杖和網絡政策則位於 VM 之外。
  • 每項任務都有自己的機器。 每項任務都會使用一部全新的 VM,並將儲存庫複製到新的分支上,因此各工作階段無法存取彼此的檔案或連接埠。請參閲已安裝的項目。
  • 你的 GitHub 權杖永遠不會進入 VM。 代理伺服器會保管權杖,而工作階段會取得一個短期憑證,只能推送至自己的工作分支。請參閲GitHub 代理伺服器。
  • 儲存庫中的 Claude 設定會一併帶上,個人設定則不會。 CLAUDE.md、規則、技能、Agent 和指令會隨儲存庫一併帶上,而你的 ~/.claude 會留在手提電腦上。請參閲雲端工作階段中的設定。
  • 閒置的 VM 會被回收。 重新開啟工作階段後,系統會還原對話記錄,並提供一部全新的 VM,因此請提交你重視的工作。請參閲環境到期。

有關規格、權限模式和網絡級別,請參閲雲端環境文件。

本機還是雲端?

雲端工作階段不會取代本機工作階段,大多數人兩者都會使用。下表列出兩者的分別,後文則説明各自適用的情況。

本機工作階段雲端工作階段
執行位置你的電腦每項任務使用一部全新的 VM
手提電腦進入睡眠狀態或離線工作階段會停止工作階段會繼續執行
在同一個程式碼庫中處理多項任務需要分開管理工作樹和連接埠,並格外小心每項任務使用一部 VM 和一個分支
Agent 可存取的內容你的用戶帳戶可存取的任何內容,包括 SSH 金鑰、雲端 CLI,以及 ~/.claude程式碼庫、你設定的網絡存取層級、你啟用的連接器,以及僅限該工作階段使用的 GitHub 憑證
啟動或跟進方式在該電腦上,或透過遙距控制在手機上瀏覽器、手機、Desktop、終端機、Slack、API 呼叫或排程
核准方式任何模式,包括逐條指令核准Auto、Accept edits 或 Plan
結束時留下工作樹中的變更一個分支;如有需要,也可建立拉取請求
運算資源你的電腦不另收運算費用;使用你方案的用量上限

如果任務需要只有你的電腦才有的資源,就留在本機執行。這包括存有真實本機資料的資料庫、透過 VPN 存取的服務、GPU、手機模擬器,或你桌上的硬件。若要快速反覆檢視畫面,並希望在幾秒內於自己的瀏覽器看到每項變更,也應留在本機執行;如果你的機構採用 Zero Data Retention,也同樣如此,因為這項設定會停用雲端工作階段。

有兩項功能介乎兩種選項之間。遙距控制會讓工作階段繼續在你的電腦上執行,並讓你透過手機或瀏覽器操控。自行託管環境目前為 Team 和 Enterprise 提供 beta 版,可在機構自己的基礎設施上執行雲端工作階段,讓工作階段存取私人網絡。

如果以上情況都不適用,這項任務就適合在雲端執行。下一節會介紹最能受惠於雲端的工作流程。

七種適合使用雲端工作階段的工作流程

以下工作流程會運用表格列出的差異:每項任務使用一部獨立電腦、你離開時工作階段仍會繼續執行,以及最後提供一個分支供你檢視。

1. 平行清理待辦事項

不妨假設你有五項細小而互不相關的修正。在本機執行時,你要逐項處理,或設定五個工作樹,並分開管理各自的連接埠和安裝項目。在雲端,你可以啟動五個工作階段,然後檢視五個分支。

程式碼Shell

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 --cloud會以你目前的分支複製 GitHub 遠端儲存庫,因此請先推送本機提交。VM 啟動期間,CLI 會即時顯示設定步驟清單,並將你輸入的內容加入佇列。

請把每項任務寫成一張完整獨立的工作單,列明問題、完成標準,以及驗證方法。不穩定測試的提示詞列明瞭驗證方法:連續執行測試套件至少 30 次。工作階段實際執行了 40 次。

若這些任務屬於同一項較大型工作,專案(Pro 和 Max 公開 beta 版)會執行一段協調對話,為你啟動並追蹤雲端工作階段,然後按狀態分類:處理中、等候你處理,以及準備好供你檢視。

2. 讓它驗證修正成效

不穩定測試是最明顯需要反覆驗證的工作:你必須一再執行測試套件,又不想讓這個循環佔用正在使用的電腦。在雲端,Claude 修補了快取,並以一條指令執行整個測試套件 40 次。

The flaky-test session's Bash step: a patch to src/cache.js that caches the in-flight promise, then a loop running the test suite 40 times, with output runs=40 fails=0.
圖 G四十次執行,零次失敗:偶發失敗測試工作階段的實際命令和輸出,在本機執行的 claude.ai/code 介面中重現。Claude 修補了 src/cache.js,並在單一步驟中將整個測試套件執行 40 次。路徑會顯示在 /home/user 下。

虛擬機器不會收取運算費用,而且使用的 CPU 也不是你的,因此可以要求更全面的驗證。將測試套件執行 200 次、以二分法在 50 個提交中找出回歸問題、執行較慢的整合測試層級,或啟動應用程式並像文件示範工作階段那樣用 curl 對它發送請求。

Claude 的每次回合仍會計入你的方案用量,但在單一命令中執行長時間測試,消耗的方案用量很少。前景命令預設會在 2 分鐘後逾時(最多 10 分鐘),然後繼續在背景執行,最長再執行 30 分鐘。你可以透過環境變數中的 BASH_DEFAULT_TIMEOUT_MS 和 BASH_MAX_TIMEOUT_MS 調高預設值。

3. 在辦公桌前規劃,在雲端建置,在終端機完成

對於較大型的改動,先在來回溝通成本較低的地方商定做法。以規劃模式啟動 Claude,一起擬定計劃,提交計劃,然後推送。

程式碼Shell

claude --permission-mode plan
# ...agree on the plan, save it to docs/migration-plan.md, commit and push...
claude --cloud "Execute the migration plan in docs/migration-plan.md"

雲端工作階段進行建置時,你的終端機可以用來處理其他工作。完成後,將工作階段拉回本機,手動完成。

程式碼Shell

claude --teleport            # pick a cloud session
claude --teleport <session-id>

Teleport 會確認你位於同一個儲存庫,取得工作階段的分支並切換至該分支,然後將整段對話載入終端機。你需要有乾淨的工作樹(它會提供將變更 stash 的選項),而且分支必須已推送。在 Claude Code 內,/teleport(或 /tp)會開啟同一個選擇器,/tasks 再 t 也可以。桌面應用程式則可反向操作,其開啟方式選單會將本機工作階段傳送至雲端。

4. 用手機查看進度

Claude 應用程式中的程式碼分頁會連接至相同的工作階段。在手機上,你可以開始工作、追蹤進度、調整方向、回答 Claude 提出的問題,或讓 Claude 監察 PR。

手機適合處理那些等你坐到鍵盤前就會忘記的問題。我讓第四個工作階段處理一個你會在手機上輸入的問題:tidepool 如何預測潮汐?在時間窗邊界可能會出現甚麼問題?它執行程式碼核實答案,並發現一個實際錯誤。迴圈從不檢查第一個或最後一個樣本,因此當高潮恰好出現在時間窗起點時,API 會漏報。

5. 將 CI 失敗和審查意見交由 Claude 處理

在儲存庫安裝 Claude GitHub App 後,雲端工作階段便可監察 PR,並根據相關變化採取行動。在 claude.ai/code 工作階段的 CI 狀態列中啟用自動修正。你也可以在終端機的 PR 分支上執行 /autofix-pr、要求手機應用程式監察 PR,或將 PR 網址貼到工作階段中。

Claude 會針對失敗的檢查和審查意見推送明確的修正,並説明所作的更改。遇到不明確或涉及架構的事項時,它會向你提問。審查討論串中的回覆會以你的 GitHub 用戶名稱發佈,並標示為 Claude Code。Claude 不會收到與基礎分支發生合併衝突的通知,因此要要求它執行 rebase。它發佈的評論也可能觸發以評論為依據的自動化流程,例如 Atlantis。

6. 開始工作,無須親自啟動

例行程序(研究預覽版)由多項已儲存資源組成,旨在完成一項任務,例如提示詞、儲存庫、連接器和環境。每次執行都是由觸發條件啟動的雲端工作階段。觸發條件可以是排程(最頻密為每小時一次)、對例行程序專屬端點發出的 HTTP 呼叫,或 GitHub 事件,例如開啟拉取請求或發佈版本。您可以在 claude.ai/code/routines、桌面應用程式,或在 CLI 使用 /schedule 建立例行程序。例行程序執行時不會出現要求核准的提示,預設會推送至以 claude/ 為前綴的分支。

另外有兩項較小的工具可提供協助。您可以從任何已登入的電腦,將後續訊息排入正在執行的工作階段,包括 CI 工作。

CODEShell

claude -p "The integration tier is green now; rebase on main and push" --cloud <session-id>

您也可以為預先填妥內容的工作階段加上書籤。例如,開啟 claude.ai/code?prompt=Triage+the+newest+issues&repositories=acme-labs/tidepool 這類網址時,claude.ai/code 上的提示詞和儲存庫已預先填妥。

7. 執行未完全信任的程式碼

貢獻者提交的拉取請求、新依賴項的安裝指令碼,或您五分鐘前複製的儲存庫,都可能執行您尚未閲讀的程式碼。在您的手提電腦上,這些程式碼會與 SSH 金鑰、雲端 CLI 工作階段和瀏覽器設定檔共處。在雲端工作階段中,程式碼則會在一次性虛擬機中執行,不會接觸到上述資料,並使用僅限該工作階段的 GitHub 憑證,以及可收窄範圍的網絡存取。

若要以最嚴格的方式執行,請將環境的網絡存取設定為 無;也可以保留為 受信任,這會允許連線至套件登錄檔、GitHub 和主要雲端 SDK 主機。即使設定為「無」,Claude Code 仍會向 Anthropic API 發送請求,因此資料仍可能透過這種方式離開虛擬機,而工作階段仍可推送至自己的分支。所有外送流量都會經過記錄主機名稱的代理伺服器。

連接 GITHUB,避免卡住

如果第一次雲端工作階段出現問題,最可能是 GitHub 所致。大部分問題都是因為雲端工作階段需要兩項不同的 GitHub 權限。

  • 使用 GitHub 登入,可讓 Claude 確認您的身分。
  • 在帳戶或組織安裝 Claude GitHub App,可設定 Claude 能在該處查看哪些私人儲存庫。

只要使用第一項設定,即可存取公開儲存庫。私人儲存庫則需要第二項設定,並須在擁有該儲存庫的帳戶或組織上安裝 App。如果您已連接 GitHub,但看不到某個私人儲存庫,通常是因為擁有該儲存庫的帳戶或組織尚未安裝 App。

您已連接的項目公開儲存庫您的私人儲存庫組織的私人儲存庫自動修正、GitHub 觸發條件、專案
僅使用 GitHub 登入是否否否
+ 在您的個人帳戶安裝 App是是否您的儲存庫
+ 在組織安裝 App(由擁有者核准)是只有在您的帳戶也安裝了 App 時是組織的儲存庫
/web-setup(您的 gh 權杖)是是您的權杖可存取的所有內容否,需要安裝 App

路徑 A:在瀏覽器中連接(建議)

在 claude.ai/connect-github 連接您的 GitHub 帳戶,然後在擁有您儲存庫的帳戶或組織安裝 Claude GitHub App。若是組織,通常需要由擁有者核准安裝。快速入門指南會逐步説明各項操作。

如果 GitHub 沒有將您帶回 claude.ai/code,您可以在 claude.ai/connect-github 的連接頁面查看常見原因的簡短檢查清單。其中一個原因是單一登入步驟;如果略過這一步,組織的儲存庫便不會顯示。

The Didn't finish connecting screen with five tips: sign in to the right GitHub account, authorize each organization on the single sign-on step, start again if you saw GitHub connection not completed, connect your own account first and let an owner approve organization access later, or run /web-setup from the terminal.
圖 L如果 GitHub 沒有將您帶回:產品內建的 GitHub 連線中斷檢查清單,取自本機執行的 claude.ai/code 介面中的快速設定引導流程

自動修復、由 GitHub 觸發的例行工作和專案也依賴該 App,因此即使透過其他方式連線,也要安裝它。

路徑 B:使用 /web-setup 從終端機連線

如果你已在使用 gh CLI,請在 Claude Code 中執行 /web-setup,將你的 gh 權杖傳送至 Claude 帳戶。之後,工作階段便可存取該權杖可存取的任何儲存庫,不論有沒有安裝 App。操作步驟請參閲從終端機連線。Team 和 Enterprise 方案的帳戶擁有者必須先啟用Quick setup。

路徑 C:單次操作可略過 GitHub

如果在沒有 GitHub 遠端的儲存庫,或尚未安裝 App 的儲存庫中執行 claude --cloud,Claude Code 會上載儲存庫封裝,而非複製儲存庫。只有在你的 GitHub 連線具備該儲存庫的推送權限時,工作階段才能將內容推送回去。文件列出封裝包含和不包含的內容。

如果你使用 Team 或 Enterprise 方案

帳戶擁有者有一份簡短檢查清單:在claude.ai/admin-settings/connectors啟用 GitHub 連接器,在Claude Code 管理員設定中允許雲端工作階段,在組織的儲存庫中安裝 Claude GitHub App(或核准成員提出的申請),並決定是否啟用Quick setup。設有 IP 允許清單或使用 GitHub Enterprise Server 的組織,還需要完成額外步驟。請參閲有關IP 允許清單和GitHub Enterprise Server的文件。

仍然無法正常運作時

看到的情況原因解決方法
私人儲存庫沒有出現在選擇器中擁有該儲存庫的帳戶或組織未安裝 App,或 App 的儲存庫存取範圍不包括該儲存庫在該帳戶或組織安裝 App,或在 GitHub 設定中將該儲存庫加入 App 的「Repository access」範圍
連結組織時,系統顯示你必須是該組織的擁有者組織阻止了成員資格檢查,通常是因為有待處理的 App 權限要求、IP 允許清單,或 SAML 單一登入設定所致組織擁有者可在組織的 GitHub App 設定中接受待處理的權限要求、為已安裝的 GitHub Apps 開啟 IP 允許清單繼承,或(使用 SAML 時)授權 Claude 存取該組織
連接後,組織的儲存庫沒有顯示組織使用 SAML 單一登入,但略過了授權步驟在 GitHub 的「對組織進行單一登入」步驟中,繼續之前,請按一下每個組織旁的 授權。如果你已略過此步驟,請在 GitHub 設定中授權 Claude 存取該組織,然後重新連接
每個雲端工作階段都因驗證錯誤而失敗你的 Claude 組織使用 IP 允許清單請聯絡支援團隊,要求豁免 Anthropic 託管的服務

如有其他問題,請參閲文件中的疑難排解,包括連接 GitHub 後沒有顯示任何儲存庫。若要完全中斷 GitHub 連線,請前往 claude.ai/customize/connectors。

讓工作階段具備自行檢查成果所需的一切

能執行你的測試的工作階段,會在交還工作前先檢查自己的成果。否則,你只能審閲從未有人執行過的變更。本指南示範中的大部分價值,都來自 Claude 執行各項操作:測試套件跑了 40 次、伺服器及其 curl 指令,以及視窗邊緣的潮汐計算。只需花十分鐘設定環境,Claude 就能執行這些檢查。

The Add cloud environment dialog with the name tidepool, Trusted network access, LOG_LEVEL=debug, and a setup script that installs shellcheck with apt-get.
圖 M在 claude.ai/code 介面中新增雲端環境,並以範例值在本機執行:名稱、網絡存取層級、.env 格式的變數,以及設定指令碼
  • 從預設環境開始。它使用受信任的網絡存取,不設環境變數或設定指令碼,足以應付大部分 JavaScript、Python、Go 和 Rust 儲存庫。
  • 為機器使用設定指令碼。指令碼會在 Claude Code 啟動前以 root 身分執行,因此 apt install 可正常運作。指令碼必須以 0 結束,否則工作階段不會啟動;而且應在約五分鐘內完成,讓環境可以快取。之後,新工作階段會以工具已儲存在磁碟上的快照啟動。修改指令碼或允許的主機時,快取會重建;此外,快取大約每七日也會重建一次。
  • 為專案使用 SessionStart hook。在儲存庫的 .claude/settings.json 中設定 hook,執行 npm install 等步驟,確保本機和雲端的執行方式一致。如果某個步驟只應在雲端執行,請檢查 CLAUDE_CODE_REMOTE。儲存庫中的 hook 會在單一儲存庫工作階段載入。
  • 每個工作階段都要啟動服務。快取會儲存檔案,但不會保留正在執行的程序。請 Claude 執行 service postgresql start,或在 SessionStart hook 中執行。
  • 選擇足以應付需要的最低網絡存取層級。受信任層級涵蓋常見的套件登錄服務。使用「自訂」加入私有套件登錄服務,只有任務需要開放互聯網時才使用「完整」。變更約需一分鐘便會套用至正在執行的工作階段。
  • 不要在共用變數中存放機密資料。所有使用該環境的人都看得到環境變數。在 Pro 和 Max 方案中,環境的 API 憑證會在 VM 外部,為發往你指定主機的請求附加金鑰,因此金鑰不會存放在變數中。
  • 將指令寫入 CLAUDE.md。你的個人 ~/.claude 不會傳到雲端 VM。如果 Claude 需要知道如何執行整合測試,儲存庫就必須説明。

值得養成的習慣

  • 一項任務,一個工作階段。各自獨立的小型工作階段較易檢視,棄用成本亦較低。
  • 要求提供證據。指出用來證明任務已完成的指令,並在檢視差異前閲讀 Claude 的摘要。
  • 在 claude --cloud 前先推送。VM 會從 GitHub 複製儲存庫,因此未推送的提交不會傳到 VM。
  • 執行長時間任務時,記得隨做隨提交。閒置的 VM 可能會被回收。
  • 在差異檢視畫面中檢視變更。行內留言會集中加入下一則訊息;建立 PR 則可開啟完整 PR、草稿 PR,或 GitHub 的撰寫頁面。
  • Claude 工作期間適時引導。你在 Claude 工作期間傳送的訊息會排入佇列,也可以撤回已排入佇列的訊息。
  • 分享工作階段。在 Team 和 Enterprise 方案中,可將工作階段的可見度設為 Team,讓審閲者瞭解變更的製作過程。雲端工作階段建立的提交會附帶 Claude-Session 尾註,連結至對話記錄。
  • 留意使用上限。平行工作階段會同時消耗方案額度,因此五個工作階段消耗額度的速度約為一個的五倍。Routines 有各自的每小時上限,而專案每天最多可開始 200 個新對話串。

常見問題

誰可以使用雲端工作階段?Pro、Max 和 Team 方案用戶,以及持有 premium seat 或 Chat + Claude Code seat 的 Enterprise 用戶,只要使用 claude.ai 帳戶登入即可。使用 Console API key 或第三方供應商時,無法使用雲端工作階段。請參閲雲端工作階段説明文件。

我的資料會存放在哪裏? Anthropic 會儲存工作階段對話記錄,保留時間則視乎你的方案及模型改進設定而定。虛擬機在閒置後會被回收,而刪除工作階段會移除其資料。請參閲 資料使用及安全性。

Claude 會使用我的雲端工作階段資料訓練模型嗎? 雲端工作階段遵循 Claude Code 其餘部分的相同政策。使用 Team、Enterprise 和 API 服務時,除非你的機構選擇加入,否則 Anthropic 不會使用你的程式碼或提示詞訓練模型。使用 Free、Pro 和 Max 方案時,則視乎你的模型改進設定而定。請參閲 資料使用。

它能處理大型儲存庫嗎? 虛擬機配備約 4 個 vCPU、16 GB RAM 和 30 GB 磁碟空間。將耗時的安裝工作放入設定指令碼,讓它們只執行一次,並納入快取快照。

GitLab 或 Bitbucket 怎麼辦? claude --cloud 可以從任何 git 儲存庫上載 bundle,但工作階段無法推送回這些代管平台。Team 和 Enterprise 方案支援 GitHub Enterprise Server。請參閲平台限制。

平行分支發生衝突時會怎樣?工作階段彼此互不知情。合併其中一個分支,然後向下一個工作階段傳送後續訊息,例如 claude -p "rebase on main and fix any conflicts" --cloud <session-id>。

我會失去本機工具嗎? 用戶層級的設定不會隨工作階段一併帶入,因此請將團隊需要的內容移至儲存庫:把技能和命令提交至 .claude/,將專案範圍的 MCP 伺服器加入 .mcp.json,並在 CLAUDE.md 記錄測試命令。雲端工作階段中的設定會列出每個工作階段會讀取的內容。

五分鐘即可開始

設定約需五分鐘。之後,你可以交辦一項工作、合上手提電腦,稍後回來查看已準備好供審閲的分支。

  1. 開啟 claude.ai/code,或使用你的 claude.ai 帳戶在 Claude Code 中執行 /login。
  2. 連接 GitHub,並在儲存庫所在的平台安裝 Claude GitHub App。
  3. 選擇儲存庫和預設環境。
  4. 從待辦清單中交給 Claude 一項工作,並附上一條可驗證任務已完成的命令。
  5. 關閉分頁。稍後用手機查看狀態,再到 claude.ai/code 檢視差異並建立 pull request。

來源:Anthropic:Claude.dev 開發者博客 · claude.dev