4 4
5# 在網頁上使用 Claude Code5# 在網頁上使用 Claude Code
6 6
7> 配置雲端環境、設定指令碼、網路存取和 Docker 在 Anthropic 的沙箱中。使用 `--cloud` 和 `--teleport` 在網頁和終端之間移動工作階段。7> 使用 `--cloud` 和 `--teleport` 在網頁和終端之間移動工作階段、管理和共享工作階段,以及從雲端自動修復拉取請求。
8 8
9<Note>9<Note>
10 Claude Code 網頁版目前處於研究預覽階段,適用於 Pro、Max 和 Team 使用者,以及具有高級席位或 Chat + Claude Code 席位的 Enterprise 使用者。10 Claude Code 網頁版目前處於研究預覽階段,適用於 Pro、Max 和 Team 使用者,以及具有高級席位或 Chat + Claude Code 席位的 Enterprise 使用者。
11</Note>11</Note>
12 12
13Claude Code 網頁版在 [claude.ai/code](https://claude.ai/code) 上的 Anthropic 管理的雲端基礎設施上執行任務。工作階段即使在您關閉瀏覽器後仍會保留,您可以從 Claude 行動應用程式監控它們。13Claude Code 網頁版在 [claude.ai/code](https://claude.ai/code) 上的 Anthropic 管理的雲端基礎設施上執行任務,或在您的組織的[自託管環境](/docs/zh-TW/self-hosted-environments)上執行(如果路由到那裡)。工作階段即使在您關閉瀏覽器後仍會保留,您可以從 Claude 行動應用程式監控它們。
14 14
15<Tip>15<Tip>
16 初次使用 Claude Code 網頁版?從[開始使用](/docs/zh-TW/web-quickstart)開始,連接您的 GitHub 帳戶並提交您的第一個任務。16 初次使用 Claude Code 網頁版?從[開始使用](/docs/zh-TW/web-quickstart)開始,連接您的 GitHub 帳戶並提交您的第一個任務。
17</Tip>17</Tip>
18 18
19本頁涵蓋:19本頁涵蓋網頁產品本身:
20 20
21* [雲端環境](#cloud-environments):工作階段執行的位置,以及如何配置該位置
21* [GitHub 驗證選項](#github-authentication-options):連接 GitHub 的兩種方式22* [GitHub 驗證選項](#github-authentication-options):連接 GitHub 的兩種方式
22* [雲端環境](#the-cloud-environment):哪些配置會保留、安裝了哪些工具以及如何配置環境
23* [設定指令碼](#setup-scripts)和依賴管理
24* [網路存取](#network-access):級別、代理和預設允許清單
25* [在網頁和終端之間移動任務](#move-tasks-between-web-and-terminal),使用 `--cloud` 和 `--teleport`23* [在網頁和終端之間移動任務](#move-tasks-between-web-and-terminal),使用 `--cloud` 和 `--teleport`
26* [使用工作階段](#work-with-sessions):檢查、共享、封存、刪除24* [使用工作階段](#work-with-sessions):權限模式、檢查、共享、封存、刪除
27* [自動修復拉取請求](#auto-fix-pull-requests):自動回應 CI 失敗和審查評論25* [自動修復拉取請求](#auto-fix-pull-requests):自動回應 CI 失敗和審查評論
28* [安全性和隔離](#security-and-isolation):工作階段如何隔離26* [安全性和隔離](#security-and-isolation):工作階段如何隔離
29* [限制](#limitations):速率限制和平台限制27* [限制](#limitations):速率限制和平台限制
30 28
29<h2 id="cloud-environments">
30 雲端環境
31</h2>
32
33每個雲端工作階段都在一個[雲端環境](/docs/zh-TW/cloud-environments)中執行,這是一個已保存的配置,控制網路存取、環境變數和設定指令碼。如果您還沒有環境,上線會設定一個**預設**環境,具有[**信任**網路存取](/docs/zh-TW/cloud-environments#access-levels),要麼為您建立它,要麼要求您建立它。請參閱[預設環境](/docs/zh-TW/cloud-environments#the-default-environment),了解在您的計畫上會發生哪種情況,以及當您有多個環境時工作階段如何選擇環境。
34
35相同的環境適用於您啟動雲端工作階段的任何地方:網頁、終端、[Claude Tag](https://claude.com/docs/claude-tag/overview)、[例行工作](/docs/zh-TW/routines),以及行動和 Desktop 應用程式。Claude Tag 頻道工作階段僅使用組織級別環境,要麼是[共享環境](/docs/zh-TW/cloud-environments#organization-shared-environments),要麼是[自託管環境](/docs/zh-TW/self-hosted-environments)。
36
37請參閱[配置雲端環境](/docs/zh-TW/cloud-environments)以變更環境允許的內容、設定變數或新增設定指令碼,以及[已安裝的工具](/docs/zh-TW/cloud-environments#installed-tools)以了解工作階段在沒有任何配置的情況下包含的內容。
38
31<h2 id="github-authentication-options">39<h2 id="github-authentication-options">
32 GitHub 驗證選項40 GitHub 驗證選項
33</h2>41</h2>
43 使用任一方法,雲端工作階段都可以存取連接的 GitHub 帳戶可以看到的任何儲存庫,而不僅僅是安裝了 Claude GitHub App 的儲存庫。App 安裝啟用 PR webhooks 以進行[自動修復](#auto-fix-pull-requests);它不是工作階段級別的存取控制。若要限制您的團隊可以從雲端工作階段存取的儲存庫,請在 GitHub 本身上限制存取,例如通過限制連接的 GitHub 帳戶的團隊或儲存庫成員資格。51 使用任一方法,雲端工作階段都可以存取連接的 GitHub 帳戶可以看到的任何儲存庫,而不僅僅是安裝了 Claude GitHub App 的儲存庫。App 安裝啟用 PR webhooks 以進行[自動修復](#auto-fix-pull-requests);它不是工作階段級別的存取控制。若要限制您的團隊可以從雲端工作階段存取的儲存庫,請在 GitHub 本身上限制存取,例如通過限制連接的 GitHub 帳戶的團隊或儲存庫成員資格。
44</Note>52</Note>
45 53
46任一方法都可以。[`/schedule`](/docs/zh-TW/routines)檢查任一形式的存取,如果都未配置,會提示您執行 `/web-setup`。有關 `/web-setup` 的逐步說明,請參閱[從您的終端連接](/docs/zh-TW/web-quickstart#connect-from-your-terminal)。54任一方法都可以。有關 `/schedule` 如何在建立例行工作之前檢查該存取,請參閱[儲存庫和分支權限](/docs/zh-TW/routines#repositories-and-branch-permissions)。有關 `/web-setup` 的逐步說明,請參閱[從您的終端連接](/docs/zh-TW/web-quickstart#connect-from-your-terminal)。
47 55
48GitHub App 是[自動修復](#auto-fix-pull-requests)所必需的,它使用該應用程式接收 PR webhooks。如果您使用 `/web-setup` 連接,稍後想要自動修復,請在這些儲存庫上安裝該應用程式。56快速網頁設定是一個組織設定,讓成員使用 `/web-setup` 連接 GitHub,在瀏覽器上線期間跳過 Claude GitHub App 安裝提示,並讓瀏覽器上線為他們建立[**預設**環境](/docs/zh-TW/cloud-environments#the-default-environment),而不是顯示環境表單。在 Team 和 Enterprise 計畫上,預設情況下它是關閉的,這會隱藏 `/web-setup`。[擁有者](/docs/zh-TW/server-managed-settings#access-control)可以在 [**管理設定 > Claude Code**](https://claude.ai/admin-settings/claude-code) 使用**快速網頁設定**切換來開啟它。
49
50Team 和 Enterprise 管理員可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 使用快速網頁設定切換來禁用 `/web-setup`。
51 57
52<Note>58<Note>
53 啟用[零資料保留](/docs/zh-TW/zero-data-retention)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。59 啟用[零資料保留](/docs/zh-TW/zero-data-retention)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。
54</Note>60</Note>
55 61
56<h2 id="the-cloud-environment">
57 雲端環境
58</h2>
59
60每個工作階段在一個新的 Anthropic 管理的 VM 中執行,其中您的儲存庫已複製。本節涵蓋工作階段啟動時可用的內容以及如何自訂它。
61
62<h3 id="what’s-available-in-cloud-sessions">
63 雲端工作階段中可用的內容
64</h3>
65
66雲端工作階段從您的儲存庫的新複製開始。任何提交到儲存庫的內容都可用。您只在自己的機器上安裝或配置的任何內容都不可用。您的組織的政策通過[伺服器管理的設定](/docs/zh-TW/server-managed-settings)單獨到達。
67
68| | 在雲端工作階段中可用 | 原因 |
69| :------------------------------------------------------------------ | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
70| 您的儲存庫的 `CLAUDE.md` | 是 | 複製的一部分 |
71| 您的儲存庫的 `.claude/settings.json` hooks | 是 | 複製的一部分 |
72| 您的儲存庫的 `.mcp.json` MCP 伺服器 | 是 | 複製的一部分 |
73| 您的儲存庫的 `.claude/rules/` | 是 | 複製的一部分 |
74| 您的儲存庫的 `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | 是 | 複製的一部分 |
75| 在 `.claude/settings.json` 中聲明的 Plugins | 是 | 在工作階段啟動時從您聲明的[市場](/docs/zh-TW/plugin-marketplaces)安裝。需要網路存取才能到達市場來源 |
76| 您的組織的[伺服器管理的設定](/docs/zh-TW/server-managed-settings) | 是 | 在工作階段啟動時從 Anthropic 的伺服器取得。請參閱[表面涵蓋範圍](/docs/zh-TW/model-config#surface-coverage)以了解 `availableModels` 如何在雲端工作階段中強制執行。通過 MDM 或管理設定檔案部署到您的裝置的設定不適用,因為工作階段在 Anthropic 管理的 VM 上執行 |
77| 您的使用者 `~/.claude/CLAUDE.md` | 否 | 位於您的機器上,不在儲存庫中 |
78| 您的使用者 `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | 否 | 位於您的機器上,不在儲存庫中。改為將它們提交到儲存庫的 `.claude/` 目錄。您在 claude.ai 上啟用的技能會自動載入到雲端工作階段中 |
79| 僅在您的使用者設定中啟用的 Plugins | 否 | 使用者範圍的 `enabledPlugins` 位於 `~/.claude/settings.json`。改為在儲存庫的 `.claude/settings.json` 中聲明它們 |
80| 您使用 `claude mcp add` 新增的 MCP 伺服器 | 否 | 這些寫入您的本機使用者配置,不是儲存庫。改為在[`.mcp.json`](/docs/zh-TW/mcp#project-scope)中聲明伺服器 |
81| 靜態 API 令牌和認證 | 否 | 尚不存在專用的秘密存儲。請參閱下文 |
82| 互動式驗證,如 AWS SSO | 否 | 不支援。SSO 需要無法在雲端工作階段中執行的基於瀏覽器的登入 |
83
84若要在雲端工作階段中提供您自己的配置,請將其提交到儲存庫;組織政策通過[伺服器管理的設定](/docs/zh-TW/server-managed-settings)單獨到達。
85
86尚不可用專用的秘密存儲。環境變數和設定指令碼都存儲在環境配置中,對任何可以編輯該環境的人可見。如果您需要雲端工作階段中的秘密,請將它們新增為環境變數,並考慮該可見性。
87
88<h3 id="installed-tools">
89 已安裝的工具
90</h3>
91
92雲端工作階段預先安裝了常見的語言執行時、建置工具和資料庫。下表按類別總結了包含的內容。
93
94| 類別 | 包含 |
95| :------------ | :-------------------------------------------------------------------- |
96| **Python** | Python 3.x,包含 pip、poetry、uv、black、mypy、pytest、ruff |
97| **Node.js** | 20、21 和 22(通過 nvm),包含 npm、yarn、pnpm、bun¹、eslint、prettier、chromedriver |
98| **Ruby** | 3.1、3.2、3.3,包含 gem、bundler、rbenv |
99| **PHP** | 8.4,包含 Composer |
100| **Java** | OpenJDK 21,包含 Maven 和 Gradle |
101| **Go** | 最新穩定版本,包含模組支援 |
102| **Rust** | rustc 和 cargo |
103| **C/C++** | GCC、Clang、cmake、ninja、conan |
104| **Docker** | docker、dockerd、docker compose |
105| **Databases** | PostgreSQL 16、Redis 7.0 |
106| **Utilities** | git、jq、yq、ripgrep、tmux、vim、nano |
107
108¹ Bun 已安裝,但在套件取得時有已知的[代理相容性問題](#install-dependencies-with-a-sessionstart-hook)。
109
110如需確切版本,請要求 Claude 在雲端工作階段中執行 `check-tools`。此命令僅存在於雲端工作階段中。
111
112<h3 id="work-with-github-issues-and-pull-requests">
113 使用 GitHub 問題和拉取請求
114</h3>
115
116雲端工作階段包含內建的 GitHub 工具,讓 Claude 可以讀取問題、列出拉取請求、取得差異和發佈評論,無需任何設定。這些工具通過 [GitHub 代理](#github-proxy)進行驗證,使用您在 [GitHub 驗證選項](#github-authentication-options)下配置的任何方法,因此您的令牌永遠不會進入容器。
117
118您可以在[環境設定](#configure-your-environment)中自行設定 `GH_TOKEN` 或 `GITHUB_TOKEN`,或者兩者都不設定,讓 [GitHub 代理](#github-proxy)為您驗證:
119
120* 如果您設定了令牌,它會原封不動地傳遞到容器,因此 `gh` 和您的指令碼直接使用它。
121* 如果您都不設定,容器會將兩個變數都設定為佔位符字串 `proxy-injected`,代理會在出站 GitHub 請求上替換您的真實認證。`gh` 無需您自己的令牌即可工作,但直接讀取 `GITHUB_TOKEN` 的指令碼會獲得佔位符,而不是可用的令牌。
122
123若要檢查哪種情況適用於您的工作階段,請要求 Claude 執行 `echo $GH_TOKEN`。
124
125`gh` CLI 未預先安裝。如果您需要內建工具不涵蓋的 `gh` 命令,例如 `gh release` 或 `gh workflow run`,請自行安裝和驗證:
126
127<Steps>
128 <Step title="在您的設定指令碼中安裝 gh">
129 將 `apt update && apt install -y gh` 新增到您的[設定指令碼](#setup-scripts)。
130 </Step>
131
132 <Step title="如果代理未處理驗證,請提供令牌">
133 如果 `echo $GH_TOKEN` 列印 `proxy-injected`,[GitHub 代理](#github-proxy)為您驗證 `gh`,此步驟不必要。否則,將 `GH_TOKEN` 環境變數新增到您的[環境設定](#configure-your-environment),其中包含 GitHub 個人存取令牌。`gh` 會自動讀取 `GH_TOKEN`,因此不需要 `gh auth login` 步驟。
134 </Step>
135</Steps>
136
137<h3 id="link-output-back-to-the-session">
138 將輸出連結回工作階段
139</h3>
140
141每個雲端工作階段在 claude.ai 上都有一個成績單 URL,工作階段可以從 `CLAUDE_CODE_REMOTE_SESSION_ID` 環境變數讀取自己的 ID。使用此在 PR 正文、提交訊息、Slack 貼文或生成的報告中放置可追蹤的連結,以便審查者可以開啟產生它們的執行。
142
143自 v2.1.179 起,Claude 在網頁工作階段中建立的提交包括 `Claude-Session: <url>` git 預告片,PR 正文包括工作階段 URL 在其自己的行上。從 v2.1.182 起,設定 [`attribution.sessionUrl`](/docs/zh-TW/settings#attribution-settings) 為 `false` 以省略預告片和 PR 正文連結。
144
145若要在提交或 PR 以外的其他內容中包括工作階段連結,例如 Claude 發佈的 Slack 訊息或它寫入的報告檔案,請讓 Claude 執行以下命令並使用其輸出。該命令將環境變數值中的 `cse_` 前綴轉換為成績單 URL 期望的 `session_` 前綴:
146
147```bash theme={null}
148echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
149```
150
151<h3 id="run-tests-start-services-and-add-packages">
152 執行測試、啟動服務和新增套件
153</h3>
154
155Claude 執行測試作為處理任務的一部分。在您的提示中要求它,例如「修復 `tests/` 中的失敗測試」或「在每次變更後執行 pytest」。測試執行器(如 pytest、jest 和 cargo test)開箱即用,因為它們已預先安裝。
156
157PostgreSQL 和 Redis 已預先安裝,但預設不執行。在工作階段期間要求 Claude 啟動每一個:
158
159```bash theme={null}
160service postgresql start
161```
162
163```bash theme={null}
164service redis-server start
165```
166
167Docker 可用於執行容器化服務。要求 Claude 執行 `docker compose up` 以啟動您的專案服務。拉取映像的網路存取遵循您的環境的[存取級別](#access-levels),[信任預設值](#default-allowed-domains)包括 Docker Hub 和其他常見登錄。
168
169如果您的映像很大或拉取速度很慢,請將 `docker compose pull` 或 `docker compose build` 新增到您的[設定指令碼](#setup-scripts)。拉取的映像會保存在[快取環境](#environment-caching)中,因此每個新工作階段都已在磁碟上有它們。快取僅存儲檔案,不存儲執行中的程序,因此 Claude 仍然在每個工作階段啟動容器。
170
171若要新增未預先安裝的套件,請使用[設定指令碼](#setup-scripts)。指令碼的輸出會被[快取](#environment-caching),因此您在那裡安裝的套件在每個工作階段開始時都可用,無需每次重新安裝。您也可以要求 Claude 在工作階段期間安裝套件,但這些安裝不會在工作階段之間保留。
172
173<h3 id="resource-limits">
174 資源限制
175</h3>
176
177雲端工作階段執行時具有可能隨時間變化的近似資源上限:
178
179* 4 vCPU
180* 16 GB RAM
181* 30 GB 磁碟
182
183需要明顯更多記憶體的任務,例如大型建置工作或記憶體密集型測試,可能會失敗或被終止。對於超出這些限制的工作負載,請使用[遠端控制](/docs/zh-TW/remote-control)在您自己的硬體上執行 Claude Code。
184
185<h3 id="configure-your-environment">
186 配置您的環境
187</h3>
188
189環境控制[網路存取](#network-access)、環境變數和在工作階段啟動前執行的[設定指令碼](#setup-scripts)。有關不需要任何配置即可使用的內容,請參閱[已安裝的工具](#installed-tools)。您可以從網頁介面或終端管理環境:
190
191| 操作 | 方式 |
192| :----------------- | :-------------------------------------------------------------------------------- |
193| 新增環境 | 選擇目前環境以開啟選擇器,然後選擇**新增環境**。對話框包括名稱、網路存取級別、環境變數和設定指令碼。 |
194| 編輯環境 | 選擇顯示目前環境名稱的雲端圖示以開啟選擇器,將滑鼠懸停在環境上,然後按一下右側出現的設定圖示。 |
195| 封存環境 | 開啟環境進行編輯並選擇**封存**。封存的環境隱藏在選擇器中,但現有工作階段繼續執行。 |
196| 為 CLI 雲端工作階段設定預設環境 | 在您的終端中執行 `/remote-env`。如果您有單一環境,此命令顯示您目前的配置。`/remote-env` 僅選擇預設值;從網頁介面新增、編輯和封存環境。 |
197
198環境變數使用 `.env` 格式,每行一個 `KEY=value` 對。不要用引號包裝值,因為引號會存儲為值的一部分。此範例定義三個變數:
199
200```text theme={null}
201NODE_ENV=development
202LOG_LEVEL=debug
203DATABASE_URL=postgres://localhost:5432/myapp
204```
205
206<h3 id="organization-shared-environments">
207 組織共享環境
208</h3>
209
210Team 和 Enterprise 計畫上的擁有者和管理員可以建立與組織的每個成員共享的雲端環境。共享環境在每個成員的環境選擇器中與他們的個人環境一起出現,因此團隊可以標準化一個配置,而不是每個成員重新建立它。
211
212從[管理設定](https://claude.ai/admin-settings)中的**雲端環境**頁面管理共享環境。從那裡您可以:
213
214* 建立、編輯和封存共享環境。每個環境都有與個人環境相同的欄位:名稱、[網路存取級別](#access-levels)、`.env` 格式的[環境變數](#configure-your-environment)和[設定指令碼](#setup-scripts)。
215* 為組織設定預設環境。
216
217共享環境中的值到達該環境中每個成員的工作階段。與個人環境一樣,共享環境沒有專用的秘密存儲,因此不要包括秘密。
218
219<h2 id="setup-scripts">
220 設定指令碼
221</h2>
222
223設定指令碼是一個 Bash 指令碼,在新的雲端工作階段啟動時執行,在 Claude Code 啟動之前。使用設定指令碼來安裝依賴項、配置工具或取得工作階段需要但未預先安裝的任何內容。
224
225指令碼在 Ubuntu 24.04 上以 root 身份執行,因此 `apt install` 和大多數語言套件管理器都可以工作。
226
227若要新增設定指令碼,請開啟環境設定對話框並在**設定指令碼**欄位中輸入您的指令碼。
228
229此範例安裝 `gh` CLI,它未預先安裝:
230
231```bash theme={null}
232#!/bin/bash
233apt update && apt install -y gh
234```
235
236如果指令碼以非零值退出,工作階段將無法啟動。將 `|| true` 附加到非關鍵命令以避免在不穩定的安裝失敗時阻止工作階段。
237
238保持指令碼的總執行時間在大約五分鐘以下,以便[環境快取](#environment-caching)可以建置。使用 `&` 和 `wait` 並行執行獨立安裝。如果單一下載無法在五分鐘限制內完成,請將其移動到在背景啟動它的 [SessionStart hook](#setup-scripts-vs-sessionstart-hooks)。
239
240<Note>
241 安裝套件的設定指令碼需要網路存取才能到達登錄。預設**信任**網路存取允許連接到[常見套件登錄](#default-allowed-domains),包括 npm、PyPI、RubyGems 和 crates.io。如果您的環境使用**無**網路存取,指令碼將無法安裝套件。
242</Note>
243
244<h3 id="environment-caching">
245 環境快取
246</h3>
247
248設定指令碼在您第一次在環境中啟動工作階段時執行。完成後,Anthropic 會快照檔案系統並將該快照重新用作後續工作階段的起點。新工作階段以您的依賴項、工具和 Docker 映像已在磁碟上開始,設定指令碼步驟被跳過。這即使在指令碼安裝大型工具鏈或拉取容器映像時也能保持啟動速度快。
249
250快取捕獲檔案,不捕獲執行中的程序。設定指令碼寫入磁碟的任何內容都會保留。它啟動的服務或容器不會,因此通過要求 Claude 或使用 [SessionStart hook](#setup-scripts-vs-sessionstart-hooks) 按工作階段啟動這些。
251
252當您更改環境的設定指令碼或允許的網路主機時,以及當快取在大約七天後達到其過期時間時,設定指令碼會再次執行以重建快取。恢復現有工作階段永遠不會重新執行設定指令碼。
253
254您不需要自行啟用快取或管理快照。
255
256<h3 id="setup-scripts-vs-sessionstart-hooks">
257 設定指令碼與 SessionStart hooks
258</h3>
259
260使用設定指令碼來安裝雲端需要但您的筆記型電腦已有的東西,例如語言執行時或 CLI 工具。使用 [SessionStart hook](/docs/zh-TW/hooks#sessionstart) 進行應在任何地方執行的專案設定,雲端和本機,例如 `npm install`。
261
262兩者都在工作階段開始時執行,但它們屬於不同的位置:
263
264| | 設定指令碼 | SessionStart hooks |
265| --- | --------------------------------------------------- | ---------------------------------- |
266| 附加到 | 雲端環境 | 您的儲存庫 |
267| 配置在 | 雲端環境 UI | 您的儲存庫中的 `.claude/settings.json` |
268| 執行 | 在 Claude Code 啟動之前,當沒有[快取環境](#environment-caching)時 | 在 Claude Code 啟動之後,在每個工作階段上,包括已恢復的 |
269| 範圍 | 僅雲端環境 | 本機和雲端 |
270
271SessionStart hooks 也可以在本機使用者級別 `~/.claude/settings.json` 中定義,但使用者級別設定不會轉移到雲端工作階段。在雲端中,hooks 來自儲存庫和您組織的[伺服器管理設定](/docs/zh-TW/server-managed-settings)。
272
273<h3 id="install-dependencies-with-a-sessionstart-hook">
274 使用 SessionStart hook 安裝依賴項
275</h3>
276
277若要僅在雲端工作階段中安裝依賴項,請將 SessionStart hook 新增到您的儲存庫的 `.claude/settings.json`:
278
279```json theme={null}
280{
281 "hooks": {
282 "SessionStart": [
283 {
284 "matcher": "startup|resume",
285 "hooks": [
286 {
287 "type": "command",
288 "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
289 }
290 ]
291 }
292 ]
293 }
294}
295```
296
297在 `scripts/install_pkgs.sh` 建立指令碼並使用 `chmod +x` 使其可執行。`CLAUDE_CODE_REMOTE` 環境變數在雲端工作階段中設定為 `true`,因此您可以使用它來跳過本機執行:
298
299```bash theme={null}
300#!/bin/bash
301
302if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
303 exit 0
304fi
305
306npm install
307pip install -r requirements.txt
308exit 0
309```
310
311SessionStart hooks 在雲端工作階段中有一些限制:
312
313* **無雲端專用範圍**:hooks 在本機和雲端工作階段中執行。若要跳過本機執行,請檢查上面所示的 `CLAUDE_CODE_REMOTE` 環境變數。
314* **需要網路存取**:安裝命令需要到達套件登錄。如果您的環境使用**無**網路存取,這些 hooks 會失敗。[**信任**下的預設允許清單](#default-allowed-domains)涵蓋 npm、PyPI、RubyGems 和 crates.io。
315* **代理相容性**:所有出站流量都通過[安全代理](#security-proxy)。某些套件管理器無法與此代理正確配合使用。Bun 是一個已知的例子。
316* **新增啟動延遲**:hooks 在每次工作階段啟動或恢復時執行,不像設定指令碼受益於[環境快取](#environment-caching)。通過在重新安裝之前檢查依賴項是否已存在來保持安裝指令碼快速。
317
318若要為後續 Bash 命令保留環境變數,請寫入 `$CLAUDE_ENV_FILE` 處的檔案。有關詳細資訊,請參閱 [SessionStart hooks](/docs/zh-TW/hooks#sessionstart)。
319
320尚不支援使用您自己的 Docker 映像替換基礎映像。使用設定指令碼在[提供的映像](#installed-tools)上安裝您需要的內容,或使用 `docker compose` 將您的映像作為容器與 Claude 一起執行。
321
322<h2 id="network-access">
323 網路存取
324</h2>
325
326網路存取控制來自雲端環境的出站連接。每個環境指定一個存取級別,您可以使用自訂允許的域擴展它。預設值為**信任**,允許套件登錄和其他[允許清單域](#default-allowed-domains)。
327
328若要更改環境的網路存取,請[開啟它進行編輯](#configure-your-environment)並在對話框中使用**網路存取**選擇器。沒有單獨的環境頁面。雲端圖示出現在您啟動雲端工作階段或配置[例行工作](/docs/zh-TW/routines#environments-and-network-access)的任何地方。
329
330<Note>
331 MCP 連接器流量通過 Anthropic 的伺服器路由,因此您在工作階段或例行工作上啟用的連接器無需將其主機新增到**允許的域**即可工作。連接器按工作階段或按例行工作配置;移除您不需要的任何連接器以限制 Claude 可以到達的工具。這依賴於[安全性和隔離](#security-and-isolation)下提到的相同 Anthropic 綁定通道。
332</Note>
333
334<h3 id="access-levels">
335 存取級別
336</h3>
337
338在建立或編輯環境時選擇存取級別:
339
340| 級別 | 出站連接 |
341| :----- | :---------------------------------------------------- |
342| **無** | 無出站網路存取 |
343| **信任** | [允許清單域](#default-allowed-domains)僅:套件登錄、GitHub、雲端 SDK |
344| **完全** | 任何域 |
345| **自訂** | 您自己的允許清單,可選地包括預設值 |
346
347GitHub 操作使用[單獨的代理](#github-proxy),獨立於此設定。
348
349<h3 id="allow-specific-domains">
350 允許特定域
351</h3>
352
353若要允許不在信任清單中的域,請在環境的網路存取設定中選擇**自訂**。出現**允許的域**欄位。每行輸入一個域:
354
355```text theme={null}
356api.example.com
357*.internal.example.com
358registry.example.com
359```
360
361使用 `*.` 進行萬用字元子域匹配。檢查**也包括常見套件管理器的預設清單**以將[信任域](#default-allowed-domains)與您的自訂項目一起保留,或將其取消選中以僅允許您列出的內容。
362
363允許的域按環境配置。沒有組織級別的允許清單,擁有者可以推送給所有使用者的環境;[伺服器管理的設定](/docs/zh-TW/server-managed-settings)可以限制雲端工作階段,但無法新增允許的域。
364
365<h3 id="github-proxy">
366 GitHub 代理
367</h3>
368
369為了安全起見,所有 GitHub 操作都通過專用代理服務進行,該服務將您的真實 GitHub 認證保留在沙箱外。代理驗證兩種流量:
370
371* Git 互動:沙箱內的 git 用戶端使用自訂建置的限定認證,代理驗證並將其轉換為您的實際 GitHub 驗證令牌
372* GitHub API 請求:代理在來自內建 GitHub 工具的請求上替換您的真實認證,以及來自 `gh` 的請求(當您的工作階段設定[使用 GitHub 問題和提取請求](#work-with-github-issues-and-pull-requests)中描述的 `proxy-injected` 預留位置時)
373
374代理還限制 git push 操作到目前工作分支以確保安全,並啟用複製、取得和 PR 操作,同時維護安全邊界。
375
376代理限制 GitHub API 和發行資產請求到附加到工作階段的儲存庫,無論環境的[存取級別](#access-levels)如何。下載來自未附加儲存庫的發行資產的設定指令碼會傳回 403。來自公開儲存庫的已提交檔案通過 `raw.githubusercontent.com` 取得,[安全代理](#security-proxy)會處理該檔案。該域在預設[信任清單](#default-allowed-domains)中,因此除非環境的[存取級別](#access-levels)排除它,否則檔案保持可達。
377
378<h3 id="security-proxy">
379 安全代理
380</h3>
381
382環境在 HTTP/HTTPS 網路代理後面執行,用於安全和濫用防止目的。所有出站網際網路流量都通過此代理,該代理提供:
383
384* 防止惡意請求
385* 速率限制和濫用防止
386* 增強安全性的內容篩選
387* 所請求主機名稱的 DNS 級別稽核軌跡
388
389<h3 id="default-allowed-domains">
390 預設允許的域
391</h3>
392
393使用**信任**網路存取時,預設允許以下域。標記為 `*` 的域表示萬用字元子域匹配,因此 `*.gcr.io` 允許 `gcr.io` 的任何子域。
394
395<AccordionGroup>
396 <Accordion title="Anthropic 服務">
397 * api.anthropic.com
398 * statsig.anthropic.com
399 * docs.claude.com
400 * platform.claude.com
401 * code.claude.com
402 * claude.ai
403 </Accordion>
404
405 <Accordion title="版本控制">
406 * github.com
407 * [www.github.com](http://www.github.com)
408 * api.github.com
409 * npm.pkg.github.com
410 * raw\.githubusercontent.com
411 * pkg-npm.githubusercontent.com
412 * objects.githubusercontent.com
413 * release-assets.githubusercontent.com
414 * codeload.github.com
415 * avatars.githubusercontent.com
416 * camo.githubusercontent.com
417 * gist.github.com
418 * gitlab.com
419 * [www.gitlab.com](http://www.gitlab.com)
420 * registry.gitlab.com
421 * bitbucket.org
422 * [www.bitbucket.org](http://www.bitbucket.org)
423 * api.bitbucket.org
424 </Accordion>
425
426 <Accordion title="容器登錄">
427 * registry-1.docker.io
428 * auth.docker.io
429 * index.docker.io
430 * hub.docker.com
431 * [www.docker.com](http://www.docker.com)
432 * production.cloudflare.docker.com
433 * download.docker.com
434 * gcr.io
435 * \*.gcr.io
436 * ghcr.io
437 * mcr.microsoft.com
438 * \*.data.mcr.microsoft.com
439 * public.ecr.aws
440 </Accordion>
441
442 <Accordion title="雲端平台">
443 * cloud.google.com
444 * accounts.google.com
445 * gcloud.google.com
446 * \*.googleapis.com
447 * storage.googleapis.com
448 * compute.googleapis.com
449 * container.googleapis.com
450 * azure.com
451 * portal.azure.com
452 * microsoft.com
453 * [www.microsoft.com](http://www.microsoft.com)
454 * \*.microsoftonline.com
455 * packages.microsoft.com
456 * dotnet.microsoft.com
457 * dot.net
458 * visualstudio.com
459 * dev.azure.com
460 * \*.amazonaws.com
461 * \*.api.aws
462 * oracle.com
463 * [www.oracle.com](http://www.oracle.com)
464 * java.com
465 * [www.java.com](http://www.java.com)
466 * java.net
467 * [www.java.net](http://www.java.net)
468 * download.oracle.com
469 * yum.oracle.com
470 </Accordion>
471
472 <Accordion title="JavaScript 和 Node 套件管理器">
473 * registry.npmjs.org
474 * [www.npmjs.com](http://www.npmjs.com)
475 * [www.npmjs.org](http://www.npmjs.org)
476 * npmjs.com
477 * npmjs.org
478 * yarnpkg.com
479 * registry.yarnpkg.com
480 </Accordion>
481
482 <Accordion title="Python 套件管理器">
483 * pypi.org
484 * [www.pypi.org](http://www.pypi.org)
485 * files.pythonhosted.org
486 * pythonhosted.org
487 * test.pypi.org
488 * pypi.python.org
489 * pypa.io
490 * [www.pypa.io](http://www.pypa.io)
491 </Accordion>
492
493 <Accordion title="Ruby 套件管理器">
494 * rubygems.org
495 * [www.rubygems.org](http://www.rubygems.org)
496 * api.rubygems.org
497 * index.rubygems.org
498 * ruby-lang.org
499 * [www.ruby-lang.org](http://www.ruby-lang.org)
500 * rubyforge.org
501 * [www.rubyforge.org](http://www.rubyforge.org)
502 * rubyonrails.org
503 * [www.rubyonrails.org](http://www.rubyonrails.org)
504 * rvm.io
505 * get.rvm.io
506 </Accordion>
507
508 <Accordion title="Rust 套件管理器">
509 * crates.io
510 * [www.crates.io](http://www.crates.io)
511 * index.crates.io
512 * static.crates.io
513 * rustup.rs
514 * static.rust-lang.org
515 * [www.rust-lang.org](http://www.rust-lang.org)
516 </Accordion>
517
518 <Accordion title="Go 套件管理器">
519 * proxy.golang.org
520 * sum.golang.org
521 * index.golang.org
522 * golang.org
523 * [www.golang.org](http://www.golang.org)
524 * goproxy.io
525 * pkg.go.dev
526 </Accordion>
527
528 <Accordion title="JVM 套件管理器">
529 * maven.org
530 * repo.maven.org
531 * central.maven.org
532 * repo1.maven.org
533 * repo.maven.apache.org
534 * jcenter.bintray.com
535 * gradle.org
536 * [www.gradle.org](http://www.gradle.org)
537 * services.gradle.org
538 * plugins.gradle.org
539 * kotlinlang.org
540 * [www.kotlinlang.org](http://www.kotlinlang.org)
541 * spring.io
542 * repo.spring.io
543 </Accordion>
544
545 <Accordion title="其他套件管理器">
546 * packagist.org (PHP Composer)
547 * [www.packagist.org](http://www.packagist.org)
548 * repo.packagist.org
549 * nuget.org (.NET NuGet)
550 * [www.nuget.org](http://www.nuget.org)
551 * api.nuget.org
552 * pub.dev (Dart/Flutter)
553 * api.pub.dev
554 * hex.pm (Elixir/Erlang)
555 * [www.hex.pm](http://www.hex.pm)
556 * cpan.org (Perl CPAN)
557 * [www.cpan.org](http://www.cpan.org)
558 * metacpan.org
559 * [www.metacpan.org](http://www.metacpan.org)
560 * api.metacpan.org
561 * cocoapods.org (iOS/macOS)
562 * [www.cocoapods.org](http://www.cocoapods.org)
563 * cdn.cocoapods.org
564 * haskell.org
565 * [www.haskell.org](http://www.haskell.org)
566 * hackage.haskell.org
567 * swift.org
568 * [www.swift.org](http://www.swift.org)
569 </Accordion>
570
571 <Accordion title="Linux 發行版">
572 * archive.ubuntu.com
573 * security.ubuntu.com
574 * ubuntu.com
575 * [www.ubuntu.com](http://www.ubuntu.com)
576 * \*.ubuntu.com
577 * ppa.launchpad.net
578 * launchpad.net
579 * [www.launchpad.net](http://www.launchpad.net)
580 * \*.nixos.org
581 </Accordion>
582
583 <Accordion title="開發工具和平台">
584 * dl.k8s.io (Kubernetes)
585 * pkgs.k8s.io
586 * k8s.io
587 * [www.k8s.io](http://www.k8s.io)
588 * releases.hashicorp.com (HashiCorp)
589 * apt.releases.hashicorp.com
590 * rpm.releases.hashicorp.com
591 * archive.releases.hashicorp.com
592 * hashicorp.com
593 * [www.hashicorp.com](http://www.hashicorp.com)
594 * repo.anaconda.com (Anaconda/Conda)
595 * conda.anaconda.org
596 * anaconda.org
597 * [www.anaconda.com](http://www.anaconda.com)
598 * anaconda.com
599 * continuum.io
600 * apache.org (Apache)
601 * [www.apache.org](http://www.apache.org)
602 * archive.apache.org
603 * downloads.apache.org
604 * eclipse.org (Eclipse)
605 * [www.eclipse.org](http://www.eclipse.org)
606 * download.eclipse.org
607 * nodejs.org (Node.js)
608 * [www.nodejs.org](http://www.nodejs.org)
609 * developer.apple.com
610 * developer.android.com
611 * pkg.stainless.com
612 * binaries.prisma.sh
613 </Accordion>
614
615 <Accordion title="雲端服務和監控">
616 * statsig.com
617 * [www.statsig.com](http://www.statsig.com)
618 * api.statsig.com
619 * sentry.io
620 * \*.sentry.io
621 * downloads.sentry-cdn.com
622 * http-intake.logs.datadoghq.com
623 * browser-intake-us5-datadoghq.com
624 * \*.datadoghq.com
625 * \*.datadoghq.eu
626 * api.honeycomb.io
627 </Accordion>
628
629 <Accordion title="內容傳遞和鏡像">
630 * sourceforge.net
631 * \*.sourceforge.net
632 * packagecloud.io
633 * \*.packagecloud.io
634 * fonts.googleapis.com
635 * fonts.gstatic.com
636 </Accordion>
637
638 <Accordion title="架構和配置">
639 * json-schema.org
640 * [www.json-schema.org](http://www.json-schema.org)
641 * json.schemastore.org
642 * [www.schemastore.org](http://www.schemastore.org)
643 </Accordion>
644
645 <Accordion title="Model Context Protocol">
646 * \*.modelcontextprotocol.io
647 </Accordion>
648</AccordionGroup>
649
650<h2 id="move-tasks-between-web-and-terminal">62<h2 id="move-tasks-between-web-and-terminal">
651 在網頁和終端之間移動任務63 在網頁和終端之間移動任務
652</h2>64</h2>
654這些工作流程需要[Claude Code CLI](/docs/zh-TW/quickstart)登入到相同的 claude.ai 帳戶。您可以從終端啟動新的雲端工作階段,或將雲端工作階段拉入終端以在本機繼續。雲端工作階段即使在您關閉筆記型電腦後仍會保留,您可以從任何地方(包括 Claude 行動應用程式)監控它們。66這些工作流程需要[Claude Code CLI](/docs/zh-TW/quickstart)登入到相同的 claude.ai 帳戶。您可以從終端啟動新的雲端工作階段,或將雲端工作階段拉入終端以在本機繼續。雲端工作階段即使在您關閉筆記型電腦後仍會保留,您可以從任何地方(包括 Claude 行動應用程式)監控它們。
655 67
656<Note>68<Note>
657 從 CLI,工作階段交接是單向的:您可以使用 `--teleport` 將雲端工作階段拉入終端,但無法將現有終端工作階段推送到網頁。`--cloud` 旗標為您目前的儲存庫建立新的雲端工作階段。[Desktop 應用程式](/docs/zh-TW/desktop#continue-in-another-surface)提供可將本機工作階段發送到網頁的「在另一個表面繼續」功能表。69 從 CLI,工作階段交接是單向的:您可以使用 `--teleport` 將雲端工作階段拉入終端,但無法將現有終端工作階段推送到網頁。`--cloud` 旗標搭配任務描述會為您目前的儲存庫建立新的雲端工作階段;搭配 `-p` 和工作階段 ID 或 claude.ai/code URL 時,它會改為[將訊息排隊到該現有工作階段](/docs/zh-TW/claude-code-on-the-web#send-follow-ups-from-the-cli)。[Desktop 應用程式](/docs/zh-TW/desktop#continue-in-another-surface)提供可將本機工作階段發送到網頁的「在另一個表面繼續」功能表。
658</Note>70</Note>
659 71
660<h3 id="from-terminal-to-web">72<h3 id="from-terminal-to-web">
667claude --cloud "Fix the authentication bug in src/auth/login.ts"79claude --cloud "Fix the authentication bug in src/auth/login.ts"
668```80```
669 81
670這會在 claude.ai 上建立新的雲端工作階段。工作階段複製您目前目錄的 GitHub 遠端,位於您目前的分支,因此如果您有本機提交,請先推送,因為 VM 從 GitHub 而不是您的機器複製。`--cloud` 一次適用於單一儲存庫。任務在雲端執行,而您繼續在本機工作。較舊的 `--remote` 拼寫仍然可作為 `--cloud` 的已棄用別名。82這會在 claude.ai 上建立新的雲端工作階段。雲端 VM 複製您目前目錄的 GitHub 遠端,位於您目前的分支,而不是您的本機簽出,因此如果您有本機提交,請先推送。`--cloud` 一次適用於單一儲存庫。任務在雲端執行,而您繼續在本機工作。較舊的 `--remote` 拼寫仍然可作為 `--cloud` 的已棄用別名。
671 83
672自 v2.1.195 起,CLI 會顯示設定步驟的即時檢查清單,例如複製儲存庫和執行您的[設定指令碼](#setup-scripts),同時雲端容器啟動。您在容器佈建時輸入的訊息會排隊,並在工作階段準備好後發送。84當雲端容器啟動時,CLI 會顯示設定步驟的即時檢查清單,例如複製儲存庫和執行您的[設定指令碼](/docs/zh-TW/cloud-environments#setup-scripts)。它會排隊您在佈建期間輸入的訊息,並在工作階段準備好後發送它們。
673 85
674<Note>86<Note>
675 `--cloud` 建立雲端工作階段。`--remote-control` 無關:它公開本機 CLI 工作階段以從網頁進行監控。請參閱[遠端控制](/docs/zh-TW/remote-control)。87 `--cloud` 建立雲端工作階段。`--remote-control` 無關:它公開本機 CLI 工作階段以從網頁進行監控。請參閱[遠端控制](/docs/zh-TW/remote-control)。
677 89
678在 Claude Code CLI 中使用 `/tasks` 檢查進度,或在 claude.ai 或 Claude 行動應用程式上開啟工作階段以直接互動。從那裡,您可以引導 Claude、提供反饋或回答問題,就像任何其他對話一樣。90在 Claude Code CLI 中使用 `/tasks` 檢查進度,或在 claude.ai 或 Claude 行動應用程式上開啟工作階段以直接互動。從那裡,您可以引導 Claude、提供反饋或回答問題,就像任何其他對話一樣。
679 91
92如果 Claude 提出問題且工作階段閒置,您仍然可以在回來時回答,直到[環境過期](#environment-expired),工作階段會從您的回答繼續。
93
680<h4 id="tips-for-cloud-tasks">94<h4 id="tips-for-cloud-tasks">
681 雲端任務的提示95 雲端任務的提示
682</h4>96</h4>
693claude --cloud "Execute the migration plan in docs/migration-plan.md"107claude --cloud "Execute the migration plan in docs/migration-plan.md"
694```108```
695 109
696此模式讓您可以控制策略,同時讓 Claude 在雲端自主執行。
697
698**使用 ultraplan 在雲端規劃**:若要在網頁工作階段中起草和檢查計畫本身,請使用 [ultraplan](/docs/zh-TW/ultraplan)。Claude 在 Claude Code 網頁版上生成計畫,同時您繼續工作,然後您在瀏覽器中對部分進行評論並選擇遠端執行或將計畫發送回終端。
699
700**並行執行任務**:每個 `--cloud` 命令建立自己的雲端工作階段,獨立執行。您可以啟動多個任務,它們都會在單獨的工作階段中同時執行:110**並行執行任務**:每個 `--cloud` 命令建立自己的雲端工作階段,獨立執行。您可以啟動多個任務,它們都會在單獨的工作階段中同時執行:
701 111
702```bash theme={null}112```bash theme={null}
713 123
714當您從未連接到 GitHub 的儲存庫執行 `claude --cloud` 時,Claude Code 會捆綁您的本機儲存庫並直接上傳到雲端工作階段。捆綁包括您的完整儲存庫歷史記錄,跨所有分支,加上任何未提交的對追蹤檔案的變更。124當您從未連接到 GitHub 的儲存庫執行 `claude --cloud` 時,Claude Code 會捆綁您的本機儲存庫並直接上傳到雲端工作階段。捆綁包括您的完整儲存庫歷史記錄,跨所有分支,加上任何未提交的對追蹤檔案的變更。
715 125
126在 macOS、Linux 和 WSL 上,Claude Code 會將名稱類似認證或金鑰的檔案的未提交變更排除在上傳之外,並列出它排除的檔案名稱。這涵蓋 `.env` 檔案、Terraform `*.tfvars` 檔案和金鑰檔案,例如 `id_rsa` 和 `*.pem`。工作階段會以每個檔案的已提交版本啟動,或如果沒有已提交的檔案,則不使用該檔案。在連結的 worktree、子模組或類似配置中,Claude Code 會上傳這些變更與其餘部分一起,並列出它上傳的檔案名稱。
127
716當 GitHub 存取不可用時,此回退會自動啟動。若要即使在 GitHub 已連接時也強制它,請設定 `CCR_FORCE_BUNDLE=1`:128當 GitHub 存取不可用時,此回退會自動啟動。若要即使在 GitHub 已連接時也強制它,請設定 `CCR_FORCE_BUNDLE=1`:
717 129
718```bash theme={null}130```bash theme={null}
726* 未追蹤的檔案不包括;在您希望雲端工作階段看到的檔案上執行 `git add`138* 未追蹤的檔案不包括;在您希望雲端工作階段看到的檔案上執行 `git add`
727* 從捆綁建立的工作階段無法推送回遠端,除非您也配置了 [GitHub 驗證](#github-authentication-options)139* 從捆綁建立的工作階段無法推送回遠端,除非您也配置了 [GitHub 驗證](#github-authentication-options)
728 140
141<h3 id="send-follow-ups-from-the-cli">
142 從 CLI 發送後續訊息
143</h3>
144
145一旦雲端工作階段執行,無論它在何處執行,都可以從任何您使用 `claude auth login` 登入的機器上的 `claude` CLI 向它發送後續訊息。CLI 使用您的 Anthropic 帳戶認證進行驗證,並且不發送本機工作階段狀態,因此命令不需要從啟動工作階段的機器執行,並且在每個 shell 中都相同,包括 PowerShell。
146
147該命令發佈一條訊息並退出:
148
149```bash theme={null}
150claude -p "your message" --cloud <session-id>
151```
152
153CLI 將訊息排隊到工作階段並退出,不等待回覆。使用它來引導長時間執行的工作階段、在目前工作階段仍在完成時排隊下一步,或從 [CI 指令碼](/docs/zh-TW/self-hosted-environments-testing#run-the-test-loop)發送後續訊息。您也可以在 stdin 上管道訊息,而不是作為引數傳遞:`echo "your message" | claude -p --cloud <session-id>`。
154
155對於 `<session-id>`,傳遞裸 ID,例如 `session_...` 或 `cse_...`,或工作階段的 `claude.ai/code/<id>` URL,帶或不帶方案或查詢字串。在 claude.ai/code 的工作階段清單中找到 ID。
156
157<Note>
158 `--cloud` 需要 Anthropic 帳戶。當 Claude Code 配置為 Amazon Bedrock、Google Cloud 的 Agent Platform 或其他第三方提供者時,它不可用。僅通過 `ANTHROPIC_BASE_URL` 配置的 [LLM 閘道](/docs/zh-TW/llm-gateway)不算作第三方提供者進行此檢查,但您仍然需要使用 `claude auth login` 登入。您的組織的 `allow_remote_sessions` 政策也必須啟用。擁有者可以在 claude.ai/admin-settings/claude-code 的 Claude Code 管理設定中開啟它。
159</Note>
160
161<h4 id="output-and-errors">
162 輸出和錯誤
163</h4>
164
165成功時,命令會列印工作階段 ID 和檢視工作階段的連結:
166
167```
168Sent to cloud session.
169Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
170View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0
171```
172
173傳遞 `--output-format json` 以獲得機器可讀的結果:成功時為 `{ok, session_id, url}`,或當發送失敗時為 `{ok: false, session_id, error}`,例如當工作階段遺失或已封存時。配置錯誤(例如不支援的提供者或禁用的組織政策)會列印到 stderr,不使用 JSON。`--output-format stream-json` 不支援 `--cloud <session-id>`。
174
175CLI 會在錯誤前加上 `Error: `。失敗的傳遞會包裝為 `failed to send message to cloud session <id>: <reason>`。
176
177| 訊息 | 它的意思 |
178| --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
179| `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`)。 |
180| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織政策已關閉。 |
181| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code 無法取得您的組織政策,因此它拒絕發送,而不是假設雲端工作階段被允許。檢查您的網路連接並重試。 |
182| `Attaching to an existing cloud session is not enabled for your account.` | 您執行了 `--cloud <session-id>` 而沒有 `-p`。使用 `claude -p "your message" --cloud <session-id>` 發送訊息。 |
183| `Session not found: <id>` | ID 或 URL 不符合您可以存取的工作階段。根據工作階段的 claude.ai/code URL 檢查它。 |
184| `cloud session <id> is archived and cannot accept new messages` | 工作階段已被封存。改為啟動新工作階段。 |
185
729<h3 id="from-web-to-terminal">186<h3 id="from-web-to-terminal">
730 從網頁到終端187 從網頁到終端
731</h3>188</h3>
735* **使用 `--teleport`**:從命令列,執行 `claude --teleport` 以進行互動式工作階段選擇器,或執行 `claude --teleport <session-id>` 以直接恢復特定工作階段。如果您有未提交的變更,系統會提示您先隱藏它們。192* **使用 `--teleport`**:從命令列,執行 `claude --teleport` 以進行互動式工作階段選擇器,或執行 `claude --teleport <session-id>` 以直接恢復特定工作階段。如果您有未提交的變更,系統會提示您先隱藏它們。
736* **使用 `/teleport`**:在現有 CLI 工作階段內,執行 `/teleport` 或 `/tp` 以開啟相同的工作階段選擇器,而無需重新啟動 Claude Code。193* **使用 `/teleport`**:在現有 CLI 工作階段內,執行 `/teleport` 或 `/tp` 以開啟相同的工作階段選擇器,而無需重新啟動 Claude Code。
737* **從 `/tasks`**:執行 `/tasks` 以查看您的背景工作階段,然後按 `t` 傳送到其中一個。194* **從 `/tasks`**:執行 `/tasks` 以查看您的背景工作階段,然後按 `t` 傳送到其中一個。
738* **從網頁介面**:選擇**在 CLI 中開啟**以複製可貼到終端的命令。195* **從網頁介面**:從工作階段功能表選擇**在終端中開啟**以複製可貼到終端的命令。
196* **從雲端工作階段內**:輸入 `/teleport`,Claude Code 會回覆該工作階段的確切 `claude --teleport <session-id>` 命令,準備好從儲存庫的簽出執行。需要工作階段環境中的 Claude Code v2.1.223 或更新版本。
739 197
740當您傳送工作階段時,Claude 驗證您在正確的儲存庫中,從雲端工作階段取得並簽出分支,並將完整的對話歷史記錄載入到終端。198當您傳送工作階段時,Claude 驗證您在正確的儲存庫中,從雲端工作階段取得並簽出分支,並將完整的對話歷史記錄載入到終端。終端會取得工作階段的自己的副本:那裡的新工作保持本機,不會出現在 claude.ai 上的雲端工作階段或 Claude 行動應用程式中。若要在傳送後繼續從您的電話引導,請在本機工作階段中啟動 [`/remote-control`](/docs/zh-TW/remote-control)。
741 199
742`--teleport` 與 `--resume` 不同。`--resume` 從此機器的本機歷史記錄重新開啟對話,不列出雲端工作階段;`--teleport` 拉取雲端工作階段及其分支。200`--teleport` 與 `--resume` 不同。`--resume` 從此機器的本機歷史記錄重新開啟對話,不列出雲端工作階段;`--teleport` 拉取雲端工作階段及其分支。
743 201
748傳送在恢復工作階段之前檢查這些要求。如果任何要求未滿足,您會看到錯誤或被提示解決問題。206傳送在恢復工作階段之前檢查這些要求。如果任何要求未滿足,您會看到錯誤或被提示解決問題。
749 207
750| 要求 | 詳細資訊 |208| 要求 | 詳細資訊 |
751| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |209| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
752| 乾淨的 git 狀態 | 您的工作目錄必須沒有未提交的變更。如果需要,傳送會提示您隱藏變更。 |210| 乾淨的 git 狀態 | 您的工作目錄必須沒有未提交的變更。如果需要,傳送會提示您隱藏變更。 |
753| 正確的儲存庫 | 您必須從同一儲存庫的簽出執行 `--teleport`,而不是分支。自 v2.1.199 起,Claude Code 接受簽出,即使它無法將遠端解析為主機名稱,例如 SSH 主機別名(如 `git@work:owner/repo.git`)或 `insteadOf` 重寫的短形式。它首先顯示確認提示,並且僅當遠端的擁有者和儲存庫名稱與工作階段的儲存庫相符時。 |211| 正確的儲存庫 | 您必須從同一儲存庫的簽出執行 `--teleport`,而不是從 fork。如果您從不同儲存庫的簽出執行它,Claude Code 會顯示一個錯誤,命名工作階段的儲存庫和您的簽出。如果 Claude Code 無法將您的遠端解析為主機名稱,例如 SSH 主機別名(如 `git@work:owner/repo.git`),它會要求您確認,並在遠端的擁有者和儲存庫名稱符合工作階段的儲存庫時接受簽出。 |
754| 分支可用 | 雲端工作階段中的分支必須已推送到遠端。傳送會自動取得並簽出它。 |212| 分支可用 | 雲端工作階段中的分支必須已推送到遠端。傳送會自動取得並簽出它。 |
755| 相同帳戶 | 您必須驗證到雲端工作階段中使用的相同 claude.ai 帳戶。 |213| 相同帳戶 | 您必須驗證到雲端工作階段中使用的相同 claude.ai 帳戶。 |
756 214
758 `--teleport` 不可用216 `--teleport` 不可用
759</h4>217</h4>
760 218
761傳送需要 claude.ai 訂閱驗證。如果您通過 API 金鑰、Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 進行驗證,請執行 `/login` 以改為使用您的 claude.ai 帳戶登入。如果您已通過 claude.ai 登入,`--teleport` 仍不可用,您的組織可能已禁用雲端工作階段。219傳送需要 claude.ai 訂閱驗證。如果您通過 API 金鑰進行驗證,請執行 `/login` 以改為使用您的 claude.ai 帳戶登入。如果錯誤命名您的提供者,雲端工作階段無法通過第三方提供者使用;請參閱[錯誤表](#output-and-errors)。如果您已通過 claude.ai 登入且 `--teleport` 仍不可用,您的組織可能已禁用雲端工作階段。
762 220
763<h2 id="work-with-sessions">221<h2 id="work-with-sessions">
764 使用工作階段222 使用工作階段
773雲端工作階段支援產生文字輸出的[內建命令](/docs/zh-TW/commands)。只在終端介面中執行的命令,例如 `/plugin` 或 `/resume`,無法使用。在雲端工作階段中開啟選擇器或面板的命令行為不同:231雲端工作階段支援產生文字輸出的[內建命令](/docs/zh-TW/commands)。只在終端介面中執行的命令,例如 `/plugin` 或 `/resume`,無法使用。在雲端工作階段中開啟選擇器或面板的命令行為不同:
774 232
775* **`/model`、`/effort`、`/fast`、`/color` 和 `/rename`**:將值作為引數傳遞,例如 `/model sonnet`,而不是開啟終端選擇器或滑塊。引數形式需要工作階段環境中的 Claude Code v2.1.205 或更新版本,並遵循每個命令的[可用性說明](/docs/zh-TW/commands#all-commands):當模型的[啟動預設努力保持](/docs/zh-TW/model-config#adjust-effort-level)生效時,`/effort` 會報告 `Not applied`,而 `/fast` 僅在以快速模式啟動的工作階段中有效。233* **`/model`、`/effort`、`/fast`、`/color` 和 `/rename`**:將值作為引數傳遞,例如 `/model sonnet`,而不是開啟終端選擇器或滑塊。引數形式需要工作階段環境中的 Claude Code v2.1.205 或更新版本,並遵循每個命令的[可用性說明](/docs/zh-TW/commands#all-commands):當模型的[啟動預設努力保持](/docs/zh-TW/model-config#adjust-effort-level)生效時,`/effort` 會報告 `Not applied`,而 `/fast` 僅在以快速模式啟動的工作階段中有效。
776* **`/config`**:在網路上,開啟您設定的 Claude Code 部分,而不是設定值,命令後的文字(包括 `key=value`)會被忽略。若要變更雲端工作階段的設定,請使用[環境變數](#configure-your-environment)或將[設定檔案](/docs/zh-TW/settings)提交到儲存庫。234* **`/config`**:在網頁上,開啟您設定的 Claude Code 部分,而不是設定值,命令後的文字(包括 `key=value`)會被忽略。若要變更雲端工作階段的設定,請使用[環境變數](/docs/zh-TW/cloud-environments#set-environment-variables)或將[設定檔案](/docs/zh-TW/settings)提交到儲存庫。
777 235
778對於上下文管理特別:236對於上下文管理特別:
779 237
783| `/context` | 是 | 顯示目前在上下文視窗中的內容 |241| `/context` | 是 | 顯示目前在上下文視窗中的內容 |
784| `/clear` | 否 | 改為從側邊欄啟動新工作階段 |242| `/clear` | 否 | 改為從側邊欄啟動新工作階段 |
785 243
786自動壓縮在上下文視窗接近容量時自動執行。若要更早觸發它,請在您的[環境變數](#configure-your-environment)中設定 [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/zh-TW/env-vars)。例如,`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` 在 70% 容量而不是等待視窗幾乎滿時壓縮。若要更改壓縮計算的有效視窗大小,請使用 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/zh-TW/env-vars)。244自動壓縮在上下文視窗接近容量時自動執行。Claude Code 網頁版在雲端工作階段中自行設定 [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/zh-TW/env-vars),因此壓縮會在[自動壓縮視窗](/docs/zh-TW/model-config#set-the-auto-compact-window)的中途觸發,而不是在視窗填滿時。該值會覆蓋您在[環境變數](/docs/zh-TW/cloud-environments#set-environment-variables)中新增的值,因此在那裡新增變數不會變更壓縮觸發的時間。
787 245
788[Subagents](/docs/zh-TW/sub-agents) 的運作方式與本機相同。Claude 可以使用 Task 工具生成它們,以將研究或並行工作卸載到單獨的上下文視窗中,保持主對話更輕。在您的儲存庫的 `.claude/agents/` 中定義的 Subagents 會自動選擇。246若要改為變更自動壓縮視窗,請在您的環境變數中設定 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/zh-TW/env-vars),或在未設定變數的工作階段中執行 [`/autocompact`](/docs/zh-TW/commands#all-commands),搭配令牌計數。
789 247
790[Agent teams](/docs/zh-TW/agent-teams) 預設關閉,但可以通過將 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 新增到您的[環境變數](#configure-your-environment)來啟用。248[Subagents](/docs/zh-TW/sub-agents) 的運作方式與本機相同。Claude 可以使用 Agent 工具生成它們,以將研究或並行工作卸載到單獨的上下文視窗中,保持主對話更輕。在您的儲存庫的 `.claude/agents/` 中定義的 Subagents 會自動選擇。
249
250[Agent teams](/docs/zh-TW/agent-teams) 預設關閉,但可以通過將 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 新增到您的[環境變數](/docs/zh-TW/cloud-environments#set-environment-variables)來啟用。
251
252<h3 id="permission-modes-in-cloud-sessions">
253 雲端工作階段中的權限模式
254</h3>
255
256您可以從[模式下拉式功能表](/docs/zh-TW/permission-modes#switch-permission-modes)選擇雲端工作階段的[權限模式](/docs/zh-TW/permission-modes),無論是在您建立任務時還是在工作階段執行時。當您重新開啟其 Anthropic 託管[環境已過期](#environment-expired)的工作階段,或向工作階段發送訊息時,該工作階段的自託管執行器[在閒置時釋放](/docs/zh-TW/self-hosted-environments-reference#runner-cli-flags),Claude Code 會在它所在的權限模式中恢復工作階段。
791 257
792<h3 id="review-changes">258<h3 id="review-changes">
793 檢查變更259 檢查變更
794</h3>260</h3>
795 261
796每個工作階段顯示一個差異指示器,其中包含新增和移除的行數,例如 `+42 -18`。選擇它以開啟差異檢視,在特定行上留下內聯評論,並使用您的下一條訊息將它們發送給 Claude。有關完整逐步說明(包括 PR 建立),請參閱[檢查和迭代](/docs/zh-TW/web-quickstart#review-and-iterate)。若要讓 Claude 自動監控 PR 以查找 CI 失敗和審查評論,請參閱[自動修復拉取請求](#auto-fix-pull-requests)。262每個工作階段顯示一個差異指示器,其中包含新增和移除的行數,例如 `+42 -18`。選擇它以開啟差異檢視、在特定行上留下內聯評論,並使用您的下一條訊息將它們發送給 Claude。
263
264Claude Code 從原始 git blob 內容計算這些差異,包括 Claude 編輯時顯示的每個檔案差異,因此儲存庫中配置的差異驅動器和 `textconv` 篩選器不適用。對於不是工作階段自己簽出之一的儲存庫中的檔案,例如在工作階段期間在工作區內複製的檔案,每個檔案差異會顯示 Claude 的編輯本身,而不是 git 比較。
265
266請參閱[檢查和迭代](/docs/zh-TW/web-quickstart#review-and-iterate)以了解完整逐步說明,包括 PR 建立。若要讓 Claude 自動監控 PR 以查找 CI 失敗和審查評論,請參閱[自動修復拉取請求](#auto-fix-pull-requests)。
797 267
798<h3 id="share-sessions">268<h3 id="share-sessions">
799 共享工作階段269 共享工作階段
817 287
818在共享之前檢查您的工作階段是否包含敏感內容。工作階段可能包含來自私人 GitHub 儲存庫的程式碼和認證。儲存庫存取驗證預設未啟用。288在共享之前檢查您的工作階段是否包含敏感內容。工作階段可能包含來自私人 GitHub 儲存庫的程式碼和認證。儲存庫存取驗證預設未啟用。
819 289
820若要要求收件者具有儲存庫存取權限,或從共享工作階段中隱藏您的名稱,請前往「設定」>「Claude Code」>「共享設定」。290若要要求收件者具有儲存庫存取權限,或從共享工作階段中隱藏您的名稱,請前往 [**設定 > Claude Code > 共享設定**](https://claude.ai/settings/claude-code)。
821 291
822<h3 id="archive-sessions">292<h3 id="archive-sessions">
823 封存工作階段293 封存工作階段
845Claude 可以監視拉取請求並自動回應 CI 失敗和審查評論。Claude 訂閱 PR 上的 GitHub 活動,當檢查失敗或審查者留下評論時,Claude 會調查並推送修復(如果有明確的修復)。315Claude 可以監視拉取請求並自動回應 CI 失敗和審查評論。Claude 訂閱 PR 上的 GitHub 活動,當檢查失敗或審查者留下評論時,Claude 會調查並推送修復(如果有明確的修復)。
846 316
847<Note>317<Note>
848 自動修復需要在您的儲存庫上安裝 Claude GitHub App。如果您還沒有,請從 [GitHub App 頁面](https://github.com/apps/claude)安裝它,或在[設定](/docs/zh-TW/web-quickstart#connect-github-and-create-an-environment)期間出現提示時安裝。318 自動修復需要在您的儲存庫上安裝 Claude GitHub App。如果您還沒有,請從 [GitHub App 頁面](https://github.com/apps/claude)安裝它。
849</Note>319</Note>
850 320
851根據 PR 來自何處以及您使用的設備,有幾種方式可以開啟自動修復:321根據 PR 來自何處以及您使用的設備,有幾種方式可以開啟自動修復:
881 351
882每個雲端工作階段通過多個層與您的機器和其他工作階段分離:352每個雲端工作階段通過多個層與您的機器和其他工作階段分離:
883 353
884* **隔離的虛擬機器**:每個工作階段在隔離的 Anthropic 管理的 VM 中執行354* **隔離的虛擬機器**:每個工作階段在隔離的 Anthropic 管理的 VM 中執行。您的組織路由到[自託管環境](/docs/zh-TW/self-hosted-environments)的工作階段改為在您自己的基礎設施上執行,其中隔離是您的部署的責任
885* **網路存取控制**:網路存取預設受限,可以禁用。在禁用網路存取的情況下執行時,Claude Code 仍然可以與 Anthropic API 通訊,這可能允許資料離開 VM。355* **網路存取控制**:在 Anthropic 託管的環境中,網路存取預設受限,可以禁用。在自託管環境中,您在自己的網路邊界限制工作階段出口。當以禁用的網路存取執行時,Claude Code 仍然可以與 Anthropic API 通訊,這可能允許資料離開 VM。
886* **認證保護**:敏感認證(如 git 認證或簽署金鑰)永遠不在沙箱內與 Claude Code 一起。驗證通過使用限定認證的安全代理進行處理。356* **認證保護**:在 Anthropic 託管的環境中,git 認證和簽署金鑰保持在沙箱外,代理使用限定認證代表工作階段進行驗證。在自託管環境中,您的部署提供 git 認證;請參閱[配置 git](/docs/zh-TW/self-hosted-environments-deploy#configure-git)
887* **安全分析**:程式碼在隔離的 VM 內進行分析和修改,然後建立 PR357* **API 認證**:在 Pro 和 Max 計畫的 Anthropic 託管環境中,您[新增到雲端環境](/docs/zh-TW/cloud-environments#add-api-credentials)的金鑰保持在沙箱外,以相同的方式附加到匹配的請求,在它們離開工作階段後。自託管環境沒有 API 認證,Team 和 Enterprise 計畫還沒有
358* **安全分析**:程式碼在隔離的工作階段環境內進行分析和修改,然後建立 PR
888 359
889<h2 id="troubleshooting">360<h2 id="troubleshooting">
890 故障排除361 故障排除
896 工作階段建立失敗367 工作階段建立失敗
897</h3>368</h3>
898 369
899如果新工作階段無法啟動,出現 `Session creation failed` 或在佈建時停滯,Claude Code 無法分配雲端環境。370如果新工作階段無法啟動,出現 `Session creation failed` 或在佈建時停滯,Claude Code 無法為工作階段分配 VM。
900 371
901* 檢查 [status.claude.com](https://status.claude.com) 以查找雲端工作階段事件372* 檢查 [status.claude.com](https://status.claude.com) 以查找雲端工作階段事件
902* 一分鐘後重試,因為容量是按需佈建的373* 一分鐘後重試,因為容量是按需佈建的
903* 確認您的儲存庫可到達。連接的 GitHub 帳戶必須能夠存取 GitHub 上的儲存庫,可以透過 Claude GitHub App 授權或透過 `/web-setup` 同步的 `gh` 令牌進行存取。不需要在儲存庫上安裝 App。請參閱 [GitHub 驗證選項](#github-authentication-options)。374* 確認您的儲存庫可到達。連接的 GitHub 帳戶必須能夠存取 GitHub 上的儲存庫,可以通過 Claude GitHub App 授權或通過 `/web-setup` 同步的 `gh` 令牌進行存取。不需要在儲存庫上安裝 App。請參閱 [GitHub 驗證選項](#github-authentication-options)。
375
376<h3 id="unable-to-get-organization-uuid">
377 無法取得組織 UUID
378</h3>
379
380`claude --cloud` 和 `claude --teleport` 需要使用 claude.ai 帳戶登入。如果您使用 API 金鑰進行驗證,或您的儲存帳戶詳細資訊已過期,這些命令會失敗,出現 `Unable to get organization UUID` 或訊息表示 API 金鑰驗證不足。使用 API 金鑰驗證或過期的帳戶詳細資訊,執行 `claude --teleport` 而不使用工作階段 ID 會在工作階段選擇器中顯示 `Error loading Claude Code sessions`,而不是任一訊息,相同的修復適用。
381
382執行 `/login` 以使用您的 claude.ai 帳戶登入,然後重試命令。如果錯誤命名您的提供者,請參閱[錯誤表](#output-and-errors):雲端工作階段無法通過第三方提供者使用。
904 383
905<h3 id="remote-control-session-expired-or-access-denied">384<h3 id="remote-control-session-expired-or-access-denied">
906 遠端控制工作階段已過期或存取被拒絕385 遠端控制工作階段已過期或存取被拒絕
910 389
911* 在本機執行 `/login` 以刷新您的認證,然後重新連接390* 在本機執行 `/login` 以刷新您的認證,然後重新連接
912* 確認您登入到擁有工作階段的相同帳戶391* 確認您登入到擁有工作階段的相同帳戶
913* 如果您看到 `Remote Control may not be available for this organization`,組織的擁有者尚未為您的組織啟用雲端工作階段392* 如果您看到 `Remote Control may not be available for this organization`,擁有者尚未為您的組織啟用雲端工作階段
914 393
915<h3 id="environment-expired">394<h3 id="environment-expired">
916 環境已過期395 環境已過期
917</h3>396</h3>
918 397
919雲端工作階段在不活動一段時間後停止,基礎環境被回收。從本機終端,這會顯示為 `Could not resume session ... its environment has expired. Creating a fresh session instead.` 在網頁上,工作階段在工作階段清單中標記為已過期。398雲端工作階段在不活動一段時間後停止,工作階段的 VM 被回收。工作階段在等待您批准 [MCP 連接器](/docs/zh-TW/cloud-environments#network-access)工具呼叫或登入 MCP 伺服器時計為不活動,並且可以在該等待期間過期。在網頁上,工作階段在工作階段清單中標記為已過期。
920 399
921從 [claude.ai/code](https://claude.ai/code) 重新開啟工作階段以佈建新環境,並恢復您的對話歷史記錄。400從 [claude.ai/code](https://claude.ai/code) 重新開啟工作階段以佈建新 VM,並恢復您的對話歷史記錄。在 VM 被回收時仍在執行的背景工作,例如 subagents 和 shell 命令,不會被恢復。
922 401
923<h2 id="limitations">402<h2 id="limitations">
924 限制403 限制
929* **速率限制**:Claude Code 網頁版與您帳戶內所有其他 Claude 和 Claude Code 使用共享速率限制。並行執行多個任務會按比例消耗更多速率限制。雲端 VM 沒有單獨的計算費用。408* **速率限制**:Claude Code 網頁版與您帳戶內所有其他 Claude 和 Claude Code 使用共享速率限制。並行執行多個任務會按比例消耗更多速率限制。雲端 VM 沒有單獨的計算費用。
930* **儲存庫驗證**:您只能在驗證到相同帳戶時將工作階段從網頁移動到本機409* **儲存庫驗證**:您只能在驗證到相同帳戶時將工作階段從網頁移動到本機
931* **平台限制**:儲存庫複製和拉取請求建立需要 GitHub。自託管[GitHub Enterprise Server](/docs/zh-TW/github-enterprise-server) 執行個體支援 Team 和 Enterprise 計畫。GitLab、Bitbucket 和其他非 GitHub 儲存庫可以作為[本機捆綁](#send-local-repositories-without-github)發送到雲端工作階段,但工作階段無法將結果推送回遠端410* **平台限制**:儲存庫複製和拉取請求建立需要 GitHub。自託管[GitHub Enterprise Server](/docs/zh-TW/github-enterprise-server) 執行個體支援 Team 和 Enterprise 計畫。GitLab、Bitbucket 和其他非 GitHub 儲存庫可以作為[本機捆綁](#send-local-repositories-without-github)發送到雲端工作階段,但工作階段無法將結果推送回遠端
932* **組織 IP 允許清單**:雲端工作階段從 Anthropic 管理的基礎設施而不是您的網路呼叫 Anthropic API。如果您的組織啟用了 [IP 允許清單](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting),每個雲端工作階段都會失敗,出現驗證錯誤。這同樣適用於[程式碼審查](/docs/zh-TW/code-review)和[例行工作](/docs/zh-TW/routines)。聯絡 [Anthropic 支援](https://support.claude.com/)以從您的組織的 IP 允許清單中豁免 Anthropic 託管的服務。411* **組織 IP 允許清單**:雲端工作階段從 Anthropic 管理的基礎設施而不是您的網路呼叫 Anthropic API,而[自託管環境](/docs/zh-TW/self-hosted-environments)中的工作階段從您自己的網路呼叫它。如果您的組織啟用了 [IP 允許清單](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting),每個 Anthropic 託管的雲端工作階段都會失敗,出現驗證錯誤。這同樣適用於[程式碼審查](/docs/zh-TW/code-review)和[例行工作](/docs/zh-TW/routines),在 Anthropic 託管的環境中執行;路由到自託管環境的例行工作從您自己的網路呼叫 API。聯絡 [Anthropic 支援](https://support.claude.com/)以從您的組織的 IP 允許清單中豁免 Anthropic 託管的服務。
933 412
934<h2 id="related-resources">413<h2 id="related-resources">
935 相關資源414 相關資源
936</h2>415</h2>
937 416
938* [Ultraplan](/docs/zh-TW/ultraplan):在雲端工作階段中起草計畫並在瀏覽器中檢查它417* [雲端環境](/docs/zh-TW/cloud-environments):為雲端工作階段配置網路存取、環境變數和設定指令碼
939* [Ultrareview](/docs/zh-TW/ultrareview):在雲端沙箱中執行深度多代理程式碼審查418* [Ultrareview](/docs/zh-TW/ultrareview):在雲端沙箱中執行深度多代理程式碼審查
940* [Routines](/docs/zh-TW/routines):自動化按排程、通過 API 呼叫或回應 GitHub 事件的工作419* [例行工作](/docs/zh-TW/routines):自動化按排程、通過 API 呼叫或回應 GitHub 事件的工作
941* [Hooks 配置](/docs/zh-TW/hooks):在工作階段生命週期事件執行指令碼420* [Hooks 配置](/docs/zh-TW/hooks):在工作階段生命週期事件執行指令碼
942* [設定參考](/docs/zh-TW/settings):所有配置選項421* [所有設定](/docs/zh-TW/settings-reference):所有配置選項
943* [安全性](/docs/zh-TW/security):隔離保證和資料處理422* [安全性](/docs/zh-TW/security):隔離保證和資料處理
944* [資料使用](/docs/zh-TW/data-usage):Anthropic 從雲端工作階段保留的內容423* [資料使用](/docs/zh-TW/data-usage):Anthropic 從雲端工作階段保留的內容
945* [Claude Tag](https://claude.com/docs/claude-tag/overview):在 Slack 中由組織管理的 @Claude,在相同的雲端環境中執行424* [Claude Tag](https://claude.com/docs/claude-tag/overview):在 Slack 中由組織管理的 @Claude,在相同的雲端基礎設施上執行