SpyBara
Go Premium

web-quickstart.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

This page contains 58 additions and 33 deletions.

2026
Thu 10 23:00 Sat 12 03:02 Fri 18 23:58 Sat 19 23:57 Wed 23 23:57

在網頁上開始使用 Claude Code

在雲端從瀏覽器或手機執行 Claude Code。連接 GitHub 儲存庫、提交任務，並在無需本地設定的情況下檢查 PR。

Claude Code on the web 在 Anthropic 管理的雲端基礎設施上執行，而不是在您的機器上。從瀏覽器或 Claude 行動應用程式的 claude.ai/code 提交任務。

您需要一個 GitHub 儲存庫來開始使用。Claude 將其複製到隔離的虛擬機器中、進行更改，並為您推送一個分支以供檢查。會話在設備間持續存在，因此您在筆記型電腦上開始的任務可以稍後從手機上檢查。

Claude Code on the web 適用於：

  • 並行任務：同時執行多個獨立任務，每個任務在自己的會話和分支中，無需管理多個 worktrees
  • 您本地沒有的儲存庫：Claude 在每個會話中新鮮複製儲存庫，因此您無需簽出它
  • 不需要頻繁引導的任務：提交一個定義明確的任務，做其他事情，並在 Claude 完成時檢查結果
  • 代碼問題和探索：理解代碼庫或追蹤功能如何實現，無需本地簽出

對於需要您本地配置、工具或環境的工作，在本地執行 Claude Code 或使用 Remote Control 更合適。

會話如何執行

以下步驟描述 Anthropic 託管的會話。在自託管環境中，複製和之後的所有操作都在您組織自己的執行器上執行，其中網路邊界、設定和推送行為由操作員配置。當您提交任務時：

  1. 複製和準備：您的儲存庫被複製到 Anthropic 管理的 VM，並且您的設定指令碼會在配置時執行。
  2. 配置網路：根據您環境的存取級別設定網際網路存取。
  3. 工作：Claude 分析代碼、進行更改、執行測試並檢查其工作。您可以全程觀看和引導，或者離開並在完成時返回。
  4. 推送分支：當 Claude 達到停止點時，它會將其分支推送到 GitHub。您檢查差異、留下內聯評論、建立 PR 或發送另一條訊息以繼續。

推送分支時會話不會關閉。PR 建立和進一步編輯都在同一對話中進行。

比較執行 Claude Code 的方式

Claude Code 在任何地方的行為都相同。改變的是代碼執行的位置以及您的本地配置是否可用。Desktop 應用程式提供本地和雲端會話，因此其下面的答案取決於您選擇的是哪一個：

在網頁上 Remote Control Terminal CLI Desktop 應用程式
代碼執行於 雲端 VM，預設由 Anthropic 管理 您的機器 您的機器 您的機器或雲端 VM
您從以下位置聊天 claude.ai 或行動應用程式 claude.ai 或行動應用程式 您的終端 Desktop UI
使用您的本地配置 否，僅儲存庫 是 是 本地為是，雲端為否
需要 GitHub 是，或透過 --cloud 捆綁本地儲存庫 否 否 僅限雲端會話
如果您斷開連接，保持執行 是 終端保持開啟時 否 取決於會話類型
權限模式 接受編輯、Plan、Auto 詢問、自動接受編輯、Plan 所有模式 取決於會話類型
網路存取 每個環境可配置 您機器的網路 您機器的網路 取決於會話類型

請參閱 terminal quickstart、Desktop 應用程式 或 Remote Control 文件以設定這些。

連接 GitHub

連接 GitHub 是一次性步驟。如果您已經使用 GitHub CLI，您可以從您的終端執行此操作，而不是使用瀏覽器。

1

訪問 claude.ai/code

前往 claude.ai/code 並使用您的 claude.ai 帳戶登入。在 macOS 或 Windows 上，第一個畫面提供 Claude Code 桌面應用程式和其他安裝 Claude Code 的方式。若要留在瀏覽器中，請點擊頁面底部的Continue on web。

2

Sign in with GitHub

登入後，claude.ai/code 會提示您連接 GitHub。按照提示，claude.ai/code 會將您送到 GitHub 的授權頁面。批准授權請求，GitHub 會將您返回到 claude.ai/code。雲端會話適用於現有的 GitHub 儲存庫，並可以存取您的 GitHub 帳戶可以看到的任何儲存庫。若要啟動新項目，請先在 GitHub 上建立空儲存庫。

當 Quick web setup 關閉時（在 Team 和 Enterprise 方案上預設為關閉），claude.ai/code 會要求您在儲存庫上安裝 Claude GitHub App，除非已安裝。如果您想要Auto-fix（允許 Claude 回應 CI 失敗並審查這些儲存庫中的提取請求上的評論），請安裝它；否則點擊Skip。無論哪種方式，會話都可以存取相同的儲存庫。

3

設定您的預設環境

雲端環境是已儲存的設定，控制 Claude 在會話期間可以存取的網路以及會話啟動時執行的內容。連接 GitHub 後發生的情況取決於您的方案：

  • Pro 和 Max：上線流程為您建立名為Default的環境。
  • Team 和 Enterprise：上線流程顯示Create your first cloud environment表單。保持預填的名稱和網路存取不變，並點擊Create & finish以建立Default環境。如果擁有者已開啟Quick web setup，上線流程會改為為您建立Default。

Default 使用Trusted 網路存取：會話可以存取常見套件登錄和其他允許清單中的網域，以及透過會話網路的其他任何內容。請參閱已安裝的工具以了解無需任何設定即可使用的內容。

對於第一個項目，Default 環境可以按原樣使用。若要變更其網路存取、新增環境變數或在會話啟動前執行設定指令碼，請編輯它或建立其他環境。

從您的終端連接

如果您已經使用 GitHub CLI (gh)，您可以在不打開瀏覽器的情況下設定 Claude Code on the web。這需要 Claude Code CLI。當您執行 /web-setup 時，Claude Code 會讀取您的本地 gh 令牌，將其連結到您的 claude.ai 帳戶，並在您沒有雲端環境時建立Default雲端環境。在 Team 和 Enterprise 方案上，/web-setup 僅在擁有者開啟Quick web setup後才可用。

1

使用 GitHub CLI 進行驗證

在您的 shell 中，如果您還沒有驗證 GitHub CLI，請進行驗證：

gh auth login
2

登入 Claude

在 Claude Code CLI 中，執行 /login 以使用您的 claude.ai 帳戶登入。如果您已經登入 claude.ai 帳戶，請跳過此步驟。使用 API 金鑰進行驗證不計算在內。若要檢查，請執行 /status 並確認Login method列顯示 claude.ai 帳戶。

3

執行 /web-setup

在 Claude Code CLI 中，執行：

/web-setup

這會將您的 gh 令牌同步到您的 Claude 帳戶。成功時，Claude Code 會列印 Connected as <your-github-username> 並在您的瀏覽器中開啟 claude.ai/code。如果您還沒有雲端環境，/web-setup 會建立一個具有 Trusted 網路存取且沒有設定指令碼的環境。您可以稍後編輯環境或新增變數。一旦 /web-setup 完成，您可以使用 --cloud 從您的終端啟動雲端會話，或使用 /schedule 設定定期任務。

啟動任務

連接 GitHub 並建立環境後，您就可以提交任務了。

1

選擇儲存庫和分支

從 claude.ai/code 或 Claude 行動應用程式中的 Code 標籤，點擊輸入框下方的儲存庫選擇器，並為 Claude 選擇要在其中工作的儲存庫。每個儲存庫都顯示一個分支選擇器。將其更改為從功能分支而不是預設分支啟動 Claude。您可以新增多個儲存庫以在一個會話中跨它們工作。

2

選擇權限模式

輸入框旁邊的模式下拉菜單顯示會話將在其中執行的模式：

  • Auto：分類器會檢查 Claude 的操作，而不是詢問您。當您的組織允許自動模式且選定的模型支援時出現
  • Accept edits：Claude 進行更改並推送分支，無需停止以獲得批准
  • Plan：Claude 提出方法並等待您批准後再編輯文件

雲端會話不提供 Manual 或 Bypass 權限。請參閱權限模式完整列表以了解每個模式允許的操作。

3

描述任務並提交

輸入您想要的內容的描述並按 Enter。要具體：

  • 命名文件或函數："新增帶有設定說明的 README" 或 "修復 tests/test_auth.py 中失敗的驗證測試" 比 "修復測試" 更好
  • 如果您有錯誤輸出，請貼上
  • 描述預期行為，而不僅僅是症狀

Claude 複製儲存庫、執行您配置的設定指令碼（如果已配置）並開始工作。每個任務都有自己的會話和自己的分支，因此您無需等待一個完成就可以啟動另一個。

預填充會話

您可以透過將查詢參數新增到 claude.ai/code URL 來預填充新會話的提示、儲存庫和環境。使用此功能來建立整合，例如問題追蹤器中的按鈕，該按鈕使用問題描述作為提示打開 Claude Code。

參數 描述
prompt 要在輸入框中預填充的提示文本。也接受別名 q。
prompt_url 要從中獲取提示文本的 URL，用於太長而無法嵌入查詢字符串的提示。URL 必須允許跨源請求。設定 prompt 時忽略。
repositories 要預選的 owner/repo 段的逗號分隔列表。也接受別名 repo。
environment 環境的名稱或 ID 以預選。

對每個值進行 URL 編碼。下面的範例使用已選擇的提示和儲存庫打開表單：

https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

檢查和迭代

當 Claude 完成時，檢查更改、在特定行上留下反饋，並繼續進行直到差異看起來正確。

1

打開差異檢視

差異指示器顯示整個會話中新增和移除的行，例如 +42 -18。選擇它以打開差異檢視，左側有文件列表，右側有更改。

2

留下內聯評論

選擇差異中的任何行，輸入您的反饋，然後按 Enter。評論會排隊直到您發送下一條訊息，然後它們會與其捆綁。Claude 看到 "在 src/auth.ts:47，不要在這裡捕捉錯誤" 以及您的主要指令，因此您無需描述問題所在。

3

建立拉取請求

當差異看起來正確時，選擇差異檢視頂部的建立 PR。您可以將其作為完整 PR、草稿打開，或跳轉到 GitHub 的撰寫頁面，其中包含生成的標題和描述。

4

在 PR 後繼續迭代

建立 PR 後會話保持活躍。將 CI 失敗輸出或審查者評論貼上到聊天中，並要求 Claude 解決它們。要讓 Claude 自動監控 PR，請參閱自動修復拉取請求。

設定故障排除

連接 GitHub 後沒有儲存庫出現

雲端會話可以使用連接的 GitHub 帳戶可以看到的任何儲存庫，無論 Claude GitHub App 安裝在哪些儲存庫上。如果儲存庫遺失，請驗證連接的 GitHub 帳戶在 GitHub 上是否有權存取它。如果您還想要儲存庫的自動修復，請在其上安裝應用程式：在 github.com 上，打開設定 → 應用程式 → Claude → 配置並驗證儲存庫是否列在儲存庫存取下。私有儲存庫需要與公開儲存庫相同的授權。

頁面只顯示 GitHub 登入按鈕

雲端會話需要連接的 GitHub 帳戶。透過上面的瀏覽器流程連接，或者如果您使用 GitHub CLI，從您的終端執行 /web-setup。如果您根本不想連接 GitHub，請參閱 Remote Control 以在您自己的機器上執行 Claude Code 並從網頁監控它。

"不適用於選定的組織"

企業組織可能需要管理員啟用 Claude Code on the web。聯繫您的 Anthropic 帳戶團隊。

`/web-setup` 說 "Not signed in to Claude"

如果 /web-setup 回應 "Not signed in to Claude. Run /login first."，CLI 沒有有效的 claude.ai 登入。當先前的登入已過期時，也可能發生這種情況。執行 /login，使用您的 claude.ai 帳戶登入，然後再次執行 /web-setup。

`/web-setup` 警告您的權杖沒有 `workflow` 範圍

如果 /web-setup 說您的 GitHub CLI 權杖沒有 workflow 範圍，您可以繼續，但 GitHub 可能會拒絕使用該權杖進行的某些推送，例如更改 GitHub Actions 工作流程檔案的推送。要新增範圍，在您的 shell 中執行 gh auth refresh -s workflow，然後再次執行 /web-setup。

`/web-setup` 顯示 "No commands match" 或 "Unknown command"

/web-setup 在 Claude Code CLI 內執行，而不是在您的 shell 中。首先啟動 claude，然後在提示符處輸入 /web-setup。

如果您在 Claude Code 內輸入它並且命令菜單顯示 No commands match "/web-setup"，或提交它返回 Unknown command: /web-setup，該命令被隱藏是因為未滿足要求。原因通常是您使用 API 金鑰或第三方提供商而不是 claude.ai 訂閱進行驗證。執行 /login 以使用您的 claude.ai 帳戶登入。

在 Team 和 Enterprise 方案上，該命令預設是隱藏的：快速網頁設定切換在擁有者開啟之前是關閉的。當它關閉時，從瀏覽器連接 GitHub 代替。當管理員為您的組織停用 Claude Code on the web 時，或當您的 Enterprise 組織啟用了零資料保留（使 Claude Code on the web 不可用）時，該命令也被隱藏。

使用 `--cloud` 時出現 "Could not create a cloud environment" 或 "No cloud environment available"

遠端會話功能會在您沒有雲端環境時自動建立預設雲端環境。如果您看到 "Could not create a cloud environment"，自動建立失敗。如果您看到 "No cloud environment available"，您的 CLI 早於自動建立。在任何一種情況下，在 Claude Code CLI 中執行 /web-setup，或從 claude.ai/code 的環境選擇器新增環境。

設定指令碼失敗

設定指令碼以非零狀態退出，這會阻止會話啟動。常見原因：

  • 套件安裝失敗，因為登錄不在您的網路存取級別中。Trusted 涵蓋大多數套件管理器；None 阻止它們全部。
  • 指令碼引用在新鮮複製中不存在的文件或路徑。
  • 在本地工作的命令在 Ubuntu 上需要不同的調用。

要除錯，在指令碼頂部新增 set -x 以查看哪個命令失敗。對於非關鍵命令，附加 || true 以便它們不會阻止會話啟動。

新會話在設定期間掛起或逾時

如果新會話在設定指令碼步驟上停滯或在指令碼完成前因通用容器錯誤而失敗，指令碼可能超過了大約五分鐘的時間預算來建立環境快取。繁重的步驟，例如拉取大型 Docker 映像、同步完整依賴樹或下載模型權重，通常會將總數推過限制，特別是當它們一個接一個執行時。

要修復此問題，修剪指令碼以便它可靠地在五分鐘內完成：

  • 使用 & 和最終 wait 並行執行獨立安裝，而不是按順序執行。
  • 將最大的下載移出設定指令碼，進入 SessionStart hook，在背景中啟動它們，以便會話在它們完成時變得可用。
  • 從設定指令碼中移除長重試睡眠，因為停滯的重試迴圈會計入預算。

會話在關閉標籤後保持執行

這是設計使然。關閉標籤或導航離開不會停止會話。它在背景中繼續執行，直到 Claude 完成當前任務，然後閒置。從側邊欄，您可以存檔會話以將其從列表中隱藏，或刪除它以永久移除它。

後續步驟

現在您可以提交和檢查任務，這些頁面涵蓋接下來的內容：從您的終端啟動雲端會話、安排定期工作以及為 Claude 提供常設指令。

  • 使用 Claude Code on the web：完整參考，包括將會話傳送到您的終端、會話共享和自動修復提取請求
  • 設定雲端環境：網路存取層級、環境變數和雲端會話的設定指令碼
  • Routines：按計劃、透過 API 呼叫或回應 GitHub 事件自動化工作
  • CLAUDE.md：為 Claude 提供在每個會話開始時載入的持久指令和上下文
  • 安裝 Claude 行動應用程式以用於 iOS 或 Android 以從您的手機監控會話。從 Claude Code CLI，/mobile 顯示 QR 碼。