Claude Code on the web 目前處於研究預覽階段,適用於 Pro、Max 和 Team 用戶,以及擁有高級席位或 Chat + Claude Code 席位的企業用戶。
- 並行任務:同時執行多個獨立任務,每個任務在自己的會話和分支中,無需管理多個 worktrees
- 您本地沒有的儲存庫:Claude 在每個會話中新鮮複製儲存庫,因此您無需簽出它
- 不需要頻繁引導的任務:提交一個定義明確的任務,做其他事情,並在 Claude 完成時檢查結果
- 代碼問題和探索:理解代碼庫或追蹤功能如何實現,無需本地簽出
會話如何執行
當您提交任務時:- 複製和準備:您的儲存庫被複製到 Anthropic 管理的 VM,並且您的設定指令碼會在配置時執行。
- 配置網路:根據您環境的存取級別設定網際網路存取。
- 工作:Claude 分析代碼、進行更改、執行測試並檢查其工作。您可以全程觀看和引導,或者離開並在完成時返回。
- 推送分支:當 Claude 達到停止點時,它會將其分支推送到 GitHub。您檢查差異、留下內聯評論、建立 PR 或發送另一條訊息以繼續。
比較執行 Claude Code 的方式
Claude Code 在任何地方的行為都相同。改變的是代碼執行的位置以及您的本地配置是否可用。Desktop 應用程式提供本地和雲端會話,因此其下面的答案取決於您選擇的是哪一個:
請參閱 terminal quickstart、Desktop 應用程式 或 Remote Control 文件以設定這些。
連接 GitHub 並建立環境
設定是一次性過程。如果您已經使用 GitHub CLI,您可以從您的終端執行此操作,而不是使用瀏覽器。訪問 claude.ai/code
前往 claude.ai/code 並使用您的 Anthropic 帳戶登入。
安裝 Claude GitHub App
登入後,claude.ai/code 會提示您連接 GitHub。按照提示安裝 Claude GitHub App 並授予其存取您的儲存庫的權限。雲端會話適用於現有的 GitHub 儲存庫,因此要啟動新項目,請先在 GitHub 上建立空儲存庫。
建立您的環境
連接 GitHub 後,系統會提示您建立雲端環境。環境控制 Claude 在會話期間可以存取的網路以及在建立新會話時執行的內容。請參閱已安裝的工具以了解無需任何配置即可使用的內容。表單具有以下欄位:
- 名稱:顯示標籤。當您為不同的項目或存取級別有多個環境時很有用。
- 網路存取:控制會話可以在網際網路上到達的內容。預設值
Trusted允許連接到常見套件登錄(如 npm、PyPI 和 RubyGems),同時阻止一般網際網路存取。 - 環境變數:可選變數,在每個會話中可用,採用
.env格式。不要用引號包裝值,因為引號會儲存為值的一部分。這些對任何可以編輯此環境的人都可見。 - 設定指令碼:可選的 Bash 指令碼,在 Claude Code 啟動前執行。使用它來安裝雲端 VM 不包含的系統工具,如
apt install -y gh。結果會被快取,因此指令碼不會在每個會話上重新執行。請參閱設定指令碼以了解範例和除錯提示。
從您的終端連接
如果您已經使用 GitHub CLI (gh),您可以在不打開瀏覽器的情況下設定 Claude Code on the web。這需要 Claude Code CLI。/web-setup 讀取您的本地 gh 令牌,將其連結到您的 Claude 帳戶,並在您沒有雲端環境時建立預設雲端環境。
啟用了零資料保留的組織無法使用
/web-setup 或其他雲端會話功能。如果未安裝或驗證 GitHub CLI,/web-setup 會改為開啟瀏覽器上線流程。執行 /web-setup
在 Claude Code CLI 中,執行:這會將您的
gh 令牌同步到您的 Claude 帳戶。如果您還沒有雲端環境,/web-setup 會建立一個具有 Trusted 網路存取且沒有設定指令碼的環境。您可以稍後編輯環境或新增變數。一旦 /web-setup 完成,您可以使用 --remote 從您的終端啟動雲端會話,或使用 /schedule 設定定期任務。啟動任務
連接 GitHub 並建立環境後,您就可以提交任務了。選擇儲存庫和分支
從 claude.ai/code 或 Claude 行動應用程式中的 Code 標籤,點擊輸入框下方的儲存庫選擇器,並為 Claude 選擇要在其中工作的儲存庫。每個儲存庫都顯示一個分支選擇器。將其更改為從功能分支而不是預設分支啟動 Claude。您可以新增多個儲存庫以在一個會話中跨它們工作。
選擇權限模式
輸入框旁邊的模式下拉菜單預設為自動接受編輯,其中 Claude 進行更改並推送分支而無需停止以獲得批准。如果您希望 Claude 提出方法並在編輯文件前等待您的同意,請切換到 Plan mode。雲端會話不提供詢問權限、自動模式或繞過權限。請參閱權限模式以了解完整列表。
預填充會話
您可以透過將查詢參數新增到 claude.ai/code URL 來預填充新會話的提示、儲存庫和環境。使用此功能來建立整合,例如問題追蹤器中的按鈕,該按鈕使用問題描述作為提示打開 Claude Code。| 參數 | 描述 |
|---|---|
prompt | 要在輸入框中預填充的提示文本。也接受別名 q。 |
prompt_url | 要從中獲取提示文本的 URL,用於太長而無法嵌入查詢字符串的提示。URL 必須允許跨源請求。設定 prompt 時忽略。 |
repositories | 要預選的 owner/repo 段的逗號分隔列表。也接受別名 repo。 |
environment | 環境的名稱或 ID 以預選。 |
檢查和迭代
當 Claude 完成時,檢查更改、在特定行上留下反饋,並繼續進行直到差異看起來正確。留下內聯評論
選擇差異中的任何行,輸入您的反饋,然後按 Enter。評論會排隊直到您發送下一條訊息,然後它們會與其捆綁。Claude 看到 “在
src/auth.ts:47,不要在這裡捕捉錯誤” 以及您的主要指令,因此您無需描述問題所在。在 PR 後繼續迭代
建立 PR 後會話保持活躍。將 CI 失敗輸出或審查者評論貼上到聊天中,並要求 Claude 解決它們。要讓 Claude 自動監控 PR,請參閱自動修復拉取請求。
設定故障排除
連接 GitHub 後沒有儲存庫出現
Claude GitHub App 需要對您想要使用的每個儲存庫的明確存取權限。在 github.com 上,打開設定 → 應用程式 → Claude → 配置並驗證您的儲存庫是否列在儲存庫存取下。私有儲存庫需要與公開儲存庫相同的授權。頁面只顯示 GitHub 登入按鈕
雲端會話需要連接的 GitHub 帳戶。透過上面的瀏覽器流程連接,或者如果您使用 GitHub CLI,從您的終端執行/web-setup。如果您根本不想連接 GitHub,請參閱 Remote Control 以在您自己的機器上執行 Claude Code 並從網頁監控它。
“不適用於選定的組織”
企業組織可能需要管理員啟用 Claude Code on the web。聯繫您的 Anthropic 帳戶團隊。/web-setup 返回 “Unknown command”
/web-setup 在 Claude Code CLI 內執行,而不是在您的 shell 中。首先啟動 claude,然後在提示符處輸入 /web-setup。
如果您在 Claude Code 內輸入它並仍然看到錯誤,您的 CLI 版本早於 v2.1.80,或者您使用 API 金鑰或第三方提供商而不是 claude.ai 訂閱進行驗證。執行 claude update,然後執行 /login 以使用您的 claude.ai 帳戶登入。
使用 --remote 或 ultraplan 時出現 “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 以便它們不會阻止會話啟動。
會話在關閉標籤後保持執行
這是設計使然。關閉標籤或導航離開不會停止會話。它在背景中繼續執行,直到 Claude 完成當前任務,然後閒置。從側邊欄,您可以存檔會話以將其從列表中隱藏,或刪除它以永久移除它。後續步驟
現在您可以提交和檢查任務,這些頁面涵蓋接下來的內容:從您的終端啟動雲端會話、安排定期工作以及為 Claude 提供常設指令。- 使用 Claude Code on the web:完整參考,包括將會話傳送到您的終端、設定指令碼、環境變數和網路配置
- Routines:按計劃、透過 API 呼叫或回應 GitHub 事件自動化工作
- CLAUDE.md:為 Claude 提供在每個會話開始時載入的持久指令和上下文
- 安裝 Claude 行動應用程式以用於 iOS 或 Android 以從您的手機監控會話。從 Claude Code CLI,
/mobile顯示 QR 碼。