在雲端使用 Claude Code

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

​

雲端環境

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

​

GitHub 驗證選項

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

​

Team 和 Enterprise 的快速設定

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

​

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

​

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

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

​

雲端任務的提示

claude --permission-mode plan

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

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"

​

傳送沒有 GitHub 的本機儲存庫

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

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 遠端

• 較舊的 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，然後重試。

​

從 CLI 傳送後續訊息

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

​

輸出

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

​

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

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

​

Teleport 需求

​

--teleport 不可用

• 您使用 API 金鑰或 Console 帳戶登入：在您的 shell 中執行 claude auth login，然後使用 claude.ai 登入
• 錯誤命名了您的提供者：雲端工作階段無法透過第三方提供者取得。請參閱 錯誤表
• 您已透過 claude.ai 登入：您的組織可能已停用雲端工作階段

​

使用工作階段

​

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

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

​

檢查變更

• 您也可以點擊工作階段標題列中的變更，或標題列 ⋮ 功能表中的變更。
• 若要在面板隱藏時顯示它，請點擊工作階段標題列中的顯示工作階段側欄圖示，或使用標題列的 ⋮ 功能表。

• 留言：在特定行上留下內聯評論，然後使用您的下一條訊息將評論發送給 Claude
• 比較：差異檢視預設會將工作階段的變更與其基礎分支進行比較。若要與儲存庫中的任何其他分支進行比較，請選擇比較對象並選擇一個

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

​

疑難排解差異檢視中缺少的檔案

• 尚未推送變更：清單包含 Claude 本身所做的編輯，但不包含 Claude 執行的命令（例如格式化工具）所做的變更
• 已推送變更：清單包含已推送的提交，但不包含最後一次推送之後所做的變更

​

管理上下文

• /model、/effort、/color 和 /rename：將值作為引數傳遞，例如 /model sonnet，而不是開啟終端機選擇器或滑塊。引數形式遵循每個命令的可用性說明。
• /fast：當快速模式在您的帳戶上可用時，為工作階段切換快速模式。需要工作階段環境中的 Claude Code v2.1.271 或更新版本。
• /config：在瀏覽器中的 claude.ai/code 上，此命令會開啟 設定 > Code 或 設定 > Claude Code，而不是設定某個值。若要變更雲端工作階段的設定，請在環境上設定環境變數。在專案執行緒之外、只有一個儲存庫的工作階段中，請改為將該設定鍵提交至該儲存庫的 .claude/settings.json。雲端工作階段中的設定列出了每個工作階段會讀取的內容。

​

對話中的外掛建議

​

新增或移除建議的外掛

​

關閉外掛建議

{
  "permissions": {
    "deny": ["SearchPlugins", "SuggestPluginInstall"]
  }
}

​

取回已排隊的訊息

​

共享工作階段

​

從 Enterprise 或 Team 帳戶共享

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

​

從 Max、Ultra 或 Pro 帳戶共享

• 可見性選項：私人和公開。公開可見性使工作階段對任何登入 claude.ai 的使用者可見
• 儲存庫存取：驗證預設未啟用
• 敏感內容：在共享之前檢查您的工作階段。工作階段可能包含來自私人 GitHub 儲存庫的程式碼和憑證

• 如果設定功能表顯示 Code 而非 Claude Code：前往 隱私，其中包含這些設定
• 否則：前往 Claude Code > 共享設定

​

封存工作階段

​

尋找已封存的工作階段

​

刪除工作階段

• 從側邊欄：將滑鼠懸停在工作階段上，開啟其 ⋯ 功能表，然後選擇刪除
• 從工作階段功能表：開啟工作階段，選擇工作階段標題旁的下拉式功能表，然後選擇刪除
• 從已封存分頁：在已封存分頁上將滑鼠懸停在工作階段上，開啟其 ⋮ 功能表，然後選擇刪除

​

自動修復拉取請求

• 在雲端工作階段中建立的 PR：在 claude.ai/code 開啟工作階段，並在 Changes 卡片中找到該 pull request。開啟 pull request 標題旁的 ⋮ 選單，並開啟自動修復
• 從您的終端：在 PR 的分支上執行 /autofix-pr。Claude Code 使用 gh 偵測開啟的 PR，生成雲端工作階段，並在一個步驟中開啟自動修復
• 從行動應用程式：告訴 Claude 自動修復 PR，例如「監視此 PR 並修復任何 CI 失敗或審查評論」
• 任何現有 PR：將 PR URL 貼到工作階段中並告訴 Claude 自動修復它

​

Claude 如何回應 PR 活動

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

​

安全性和隔離

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

​

故障排除

​

工作階段建立失敗

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

​

Your new session couldn’t start

• 連線中斷：請檢查您的網際網路連線以及您使用的任何 VPN 或代理伺服器，然後再次傳送您的提示詞
• 伺服器錯誤：請稍候片刻，然後再次傳送您的提示詞。如果通知再次出現，請檢查 status.claude.com

​

Can’t rewind to this message

​

無法取得組織 UUID

• 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.
• Cloud sessions aren't available with this Console sign-in. They 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

​

分支不在 GitHub 上

​

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

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

​

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

​

環境已過期

• 會恢復：您的對話歷史記錄
• 不會恢復：在 VM 被回收時仍在執行或尚待執行的背景工作，包括：
  • Shell 命令：Claude Code 會告知 Claude 哪些命令已停止。請要求 Claude 重新執行您仍需要的命令。
  • Subagents：Claude Code 會告知 Claude 哪些 subagents 已停止，以及其中哪些可以繼續執行而不必從頭開始。請要求 Claude 繼續它們的工作。
  • 工作階段範圍的排程任務：您在工作階段中排程的任務，以及正在等待下一次迭代的 /loop，都不會延續到重新開啟的工作階段。請要求 Claude 再次排程這些任務，或再次執行 /loop 以重新啟動迴圈。

​

限制

• 速率限制：雲端工作階段與您帳戶內所有其他 Claude 和 Claude Code 使用共享速率限制。並行執行多個任務會按比例消耗更多速率限制。
• 時間限制：Claude 執行的命令和 SessionStart hooks 有您可以變更的預設逾時，且設定指令碼只有在大約五分鐘內完成時才會被快取。請參閱時間限制
• 儲存庫驗證：您只能在驗證到相同帳戶時將雲端工作階段拉入您的終端機
• 平台限制：在 Anthropic 託管環境中複製儲存庫以及建立 pull request 需要 GitHub。自託管 GitHub Enterprise Server 執行個體支援 Team 和 Enterprise 計畫。您可以透過設定 CCR_FORCE_BUNDLE=1，將 GitLab、Bitbucket 或其他非 GitHub 儲存庫作為本機捆綁發送到雲端工作階段，但工作階段無法將結果推送回該遠端
  • 自託管環境：若儲存庫位於其他 git 主機上，請參閱使用 --environment 啟動工作階段的需求。

​

相關資源

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