讓 Claude 使用 Projects 協調進行中的工作

• 將工作發送到一個地方：每當出現時，將錯誤報告、堆疊追蹤或任務清單貼到對話中。Claude 為每個工作片段啟動一個執行緒，或將其傳遞給已在該區域工作的執行緒，並就地回答快速問題。
• 設定一次背景資訊：每個新執行緒都以專案的儲存庫、指示和記憶開始，因此您陳述一次的規則（例如要針對的分支）會到達所有執行緒。
• 離開並返回已完成的工作：當您一小時後或第二天早上回來時，Overview 窗格會顯示哪些執行緒已完成、哪些提取請求已準備好供審查，以及哪個執行緒正在等待您的答案。

​

何時使用 project

• 跨多個儲存庫的一個目標：“將每個服務升級到新的 lint 配置。” Claude 可以為每個儲存庫執行一個執行緒，每個都有自己的提取請求，Overview 窗格 會顯示哪些已準備好供審查。
• 您持續提供的區域：一個服務的錯誤、堆疊追蹤和審查請求，在到達您時貼到對話中。您告訴 Claude 在一個修復後要記住的陷阱在 project 記憶 中供下一個使用。
• 比工作階段更大的構建或遷移：“構建 docs/spec.md 描述的內容”或”將應用程式從已棄用的 ORM 移出。” 工作分成執行緒，每個執行緒處理一部分，您要求 Claude 早期記住的決定會到達後來的執行緒，您在構建期間發現的規格變更和錯誤進入相同的對話。
• 不是程式碼的工作：一個合約資料夾或支援票證匯出，您不斷回來提出新問題，例如”在這些票證中找到十個最常見的整合錯誤。” 上傳文件而不是添加儲存庫，執行緒會在 project 的 Library 標籤 上將每個寫作作為檔案提供。

​

何時其他方式更合適

• 一個適合工作階段的任務：“修復不穩定的登入測試。” 自己啟動 雲端工作階段。
• 需要只有您的機器才能到達的工具或服務的工作：本地資料庫、設備模擬器、您 VPN 後面的 API。使用本地工作階段，或 代理檢視 同時執行多個。如果工作只需要本地檔案，請改為將它們上傳到 project。
• 一個按時間表重複的任務，周圍沒有對話：“每週一發佈依賴報告。” 自己建立 routine。
• 多個人在 Slack 頻道中給 Claude 工作並一起引導它：請參閱 Claude Tag。

​

Project 如何組織

• project 對話：一個長期執行的工作階段，Claude 充當協調者。它接收您發送的內容，決定什麼成為執行緒，並跟蹤它啟動的每個執行緒。它看到執行緒報告回來的內容，而不是它們採取的每一步。
• 執行緒：工作者。每個都是一個單獨的 雲端工作階段，有自己的上下文視窗，在自己的分支上完成一項工作，在工作需要時打開提取請求，並在完成時報告回對話。
• 每個執行緒開始時的內容：
  • project 的儲存庫和檔案，加上其 指示和記憶
  • CLAUDE.md、skills 和 project 每個儲存庫 中的 plugins，以及在有一個儲存庫的 project 中，該儲存庫的權限規則和 hooks
  • 您 claude.ai 帳戶上的 connectors
  • 一個 雲端環境，設定其網路存取、環境變數、API 認證和已安裝的工具
• Overview 窗格：您在其中 一次看到所有執行緒 以及其中哪些需要您。其他標籤是 Library 用於您添加的檔案和執行緒產生的檔案，Pull requests 用於執行緒開啟的提取請求，Routines 用於 project 中的排程工作。

​

建立 project

• 從頭開始，當您知道想要 Claude 執行的工作流時：打開 New project 對話框並命名它。從頭開始啟動新 project 會逐步介紹該對話框。
• 從已在執行工作的雲端工作階段：從該工作階段的功能表中選擇 Continue as a project，Claude 從工作階段正在執行的內容提議 project 的設定。請參閱 從現有雲端工作階段開始。

​

檢查先決條件

• 方案：您在 Pro 或 Max 上，Projects 在您的側邊欄中顯示。
• GitHub，如果 project 將在程式碼上工作：您的程式碼在 github.com 上而不是 GitHub Enterprise Server、GitLab 或 Bitbucket 上，您連接的 GitHub 帳戶對其有推送存取權，Claude GitHub App 已安裝在其上。如果您使用 /web-setup 連接了 GitHub，該令牌讓您的其他雲端工作階段到達儲存庫，但對於需要 Claude GitHub App 的 project 執行緒來說還不夠。設定 GitHub 存取 有步驟。
• 網路、認證和工具：這些來自 project 的 雲端環境。預設環境已經到達 常見套件登錄，因此只有在工作需要其他網域、秘密或未預先安裝的工具時才檢查此項。如果工作需要 MCP 伺服器，檢查它是否在您的 claude.ai connectors 中顯示為已連接。

​

從頭開始啟動新 project

​

從現有雲端工作階段開始

• Continue as a project 建立一個以工作階段命名的新 project 並打開它。Claude 讀取工作階段並在對話中發佈 Setup recommendations 供您確認。原始工作階段保留在您的工作階段清單中，如果它在轉換中途，它會繼續執行，因此如果您不想兩者同時工作，請自己停止它。如果您改為使用可能出現在雲端工作階段訊息框上方的 Set up project 橫幅，結果是相同的，除了工作階段的執行轉換在 project 打開後停止。
• Move to project 將工作階段的工作帶入現有 project。它在該 project 的對話中發佈一條訊息，要求 Claude 讀取工作階段並從它停止的地方繼續，新工作在 project 自己的執行緒中繼續。原始工作階段保留在您的工作階段清單中，未改變。

​

設定 GitHub 存取

​

在 project 中工作

​

您的第一批

1. 寫 project 指示：每個執行緒開始的簡報，例如要針對的分支、執行緒如何檢查其工作，以及什麼需要您的同意。
2. 發送一個真實工作的小片段，或啟動 Claude 建議的其中一個執行緒（如果它提供了任何），並在它完成時打開執行緒，以查看它如何報告回以及它在分支上做了什麼。如果它假設了錯誤的內容或無法到達它需要的內容，執行緒猜測或停滯而不是詢問 涵蓋了在哪裡修復。
3. 檢查 Project settings > General 中的 Thread model 和 Thread effort。新 project 在高努力下在 Opus 上執行每個執行緒，這最快地使用您的方案；選擇模型並讓 Claude 管理上下文 涵蓋了替代方案。
4. 要求 Claude 在啟動執行緒之前提議執行緒並一次執行幾個，並在幾個執行緒以您想要的方式回來後放棄這些限制。

​

發送工作並讀取結果

• 快速問題通常在對話中得到回答。
• 新工作進入新執行緒或已在該區域工作的執行緒，Claude 告訴您哪個。每個新執行緒在您的訊息下顯示為卡片：一個帶有執行緒標題和狀態的框，您點擊打開執行緒。
• 一條訊息中的多個不相關任務成為單獨的執行緒。

​

審查執行緒的提取請求

• Branch：在新分支上工作，從儲存庫的預設分支開始。
• Pull request：當您要求時打開一個，並可以為錯誤修復或另一個具體變更自己打開一個。
• 打開後：使用 auto-fix 打開監視提取請求，無論 auto-fix 是否對您的其他雲端工作階段打開。它在 CI 失敗時推送修復，解決審查評論，並在檢查通過且提取請求準備好供您審查時在執行緒中回覆。

• Resolve conflicts、Fix CI、Address comments 和 Merge it 將該指示作為來自您的訊息發送到執行緒，因此您可以自己提示執行緒而不是等待它對提取請求做出反應。
• Review PR 在 GitHub 上打開提取請求。
• Create PR 出現在閒置執行緒已推送分支但尚未打開提取請求時。點擊它會直接從該分支建立提取請求，而不是向執行緒發送打開提取請求的指示。

​

在 Overview 中查看需要您的內容

​

當您需要控制時打開執行緒

• 逐步讀取 Claude 所做的內容。
• 通過在執行緒自己的訊息框中寫入來引導任務。那裡的訊息直接進入該執行緒，而 project 對話中的後續工作只有在 Claude 將後續工作與該執行緒匹配時才會到達它。
• 回答執行緒正在等待的權限提示。
• 使用 Stop 中斷執行緒，它在執行緒工作時替換發送按鈕，或按 Esc。

​

選擇模型並讓 Claude 管理上下文

• Thread model 和 Thread effort 適用於執行緒。要為一個任務使用不同的模型，在任務中要求它；對於已在執行的執行緒，使用該執行緒的模型選擇器。
• Coordinator model 和 Coordinator effort 適用於 project 對話中的 Claude。

​

調整 Claude 執行 project 的方式

• “提議執行緒並在啟動之前等待我的同意”或”立即啟動這些而不要求我確認”
• “一次最多執行兩個執行緒”或”為同一區域的後續工作重用現有執行緒”
• “發佈更短的更新”或”僅在某些完成或被阻止時發佈”
• “給我每個執行緒的狀態更新”
• “用較小的模型執行此任務”
• “在我看到計劃之前不要打開提取請求”
• “告訴我這些儲存庫中的問題，不要修復任何內容”，當您想在任何內容成為執行緒之前查看發現時
• “改為在這裡回答”，當 Claude 為您打算作為快速問題的內容啟動執行緒時

​

解除等待批准的執行緒

​

為專案提供常設背景

​

寫入專案指示

• 專案的用途
• 工作發生的位置：哪些儲存庫、從哪個分支開始、如何命名提取請求
• 執行緒在完成工作前如何檢查自己的工作
• 當它需要的東西遺失時該怎麼辦
• 什麼需要您的事先同意

此專案將付款 API 的 p95 延遲保持在 200 毫秒以下：分析、查詢和快取修復，以及隨之而來的依賴項升級，在 payments-api 儲存庫中。

- 從 main 分支建立分支，每個執行緒開啟一個草稿提取請求。
- 在您完成工作前，執行 `make test` 和 `make lint`，並在最終訊息中貼上摘要行。
- 如果您無法到達所需的東西，例如儲存庫、祕密、API 或連接器，請在第一條訊息中確切說明遺失的內容並停止。不要替代、模擬或猜測。
- 不要在沒有在執行緒中詢問我的情況下合併、強制推送或變更 CI 設定。

​

決定要新增哪些儲存庫

• 將其新增到專案，在新專案對話中、在專案設定 > 環境中，或通過在對話中要求 Claude 將其新增到專案。從那時起，每個執行緒都會複製它並開始使用其 CLAUDE.md 和技能，無論任務是否涉及它。從一個儲存庫轉到多個儲存庫也會改變執行緒從每個儲存庫的 .claude/settings.json 中取得的內容；請參閱執行緒從您的儲存庫中取得什麼。
• 不要新增它，讓執行緒在需要時自行新增。 其任務需要專案沒有的儲存庫的執行緒可以將其新增到自己，執行緒中的筆記表示它僅被新增到此執行緒。複製發生在任務進行中途，因此該儲存庫的 CLAUDE.md 和技能在執行緒啟動時不存在。下一個執行緒再次啟動時沒有它。執行緒新增的儲存庫需要與專案儲存庫相同的先決條件：在其上安裝的 Claude GitHub App 和來自您的 GitHub 帳戶的推送存取。

​

執行緒從您的儲存庫中取得什麼

​

為執行緒選擇環境

​

將技能、外掛程式、連接器和工具引入執行緒

• 技能、子代理和命令：將它們提交到您新增到專案的儲存庫，例如 .claude/skills/<skill-name>/SKILL.md 中的技能。每個執行緒複製專案中的每個儲存庫，並從每個儲存庫載入 .claude/skills/、.claude/agents/ 和 .claude/commands/，因此提交到一個儲存庫的技能在每個新執行緒中可用。執行緒也載入您為 claude.ai 帳戶啟用的技能。
• 外掛程式：在專案設定 > 外掛程式中新增它們；它們載入到每個新執行緒。儲存庫在其 .claude/settings.json 中宣告的外掛程式也載入；請參閱什麼從您的設定中攜帶。
• MCP 伺服器：執行緒從您的 claude.ai 帳戶上的連接器獲取其 MCP 工具，這些是您在 claude.ai/customize/connectors 或通過專案設定 > 環境中的管理連接器連結連接一次的 MCP 伺服器。每個執行緒可以使用所有它們，無需每個專案的設定。專案對話本身沒有連接器，因此將需要連接器的工作作為執行緒的任務傳送。在具有一個儲存庫的專案中，執行緒也從該儲存庫的 .mcp.json 載入 MCP 伺服器。連接器如何到達 Claude Code 列出雲端工作階段的規則和關閉連接器的設定。
• 命令列工具和套件：在環境的設定指令碼中安裝它們。

​

Project 設定參考

​

暫停、存檔或刪除 project

• Pause：立即停止所有內容。每個執行中的執行緒和對話都被中斷，沒有新執行緒啟動，routines 不執行，project 在您恢復它之前不接受訊息。點擊相同位置或 project 訊息框上方的橫幅中的 Resume；暫停的執行緒在您之後發送訊息時繼續。
• Archive：從側邊欄隱藏 project 並存檔其執行緒，這停止任何執行中或監視提取請求的執行緒。project 存檔時，project 中的 routines 不執行。要帶回 project，從 Projects 頁面打開它並點擊 Unarchive。其執行緒保持存檔，直到您從工作階段清單中單獨取消存檔它們。
• Delete：永久移除 project 及其執行緒、其記憶和其檔案，並關閉 project 的 routines。這無法撤銷。執行緒推送到 GitHub 的分支和提取請求不受影響。

​

使用和成本

​

什麼使用您的方案

• 執行中的執行緒：每個都是一個完整的工作階段，多個可以同時執行。沒有固定數字；Claude 啟動工作需要的數量，您 要求 的限制是偏好而不是上限。強制執行的限制是每天跨您的 projects 200 個新執行緒。
• 對話：Claude 使用自己的令牌讀取執行緒報告的內容並決定下一步做什麼。
• 執行緒監視提取請求：空閒執行緒在 CI 失敗或審查評論到達其提取請求時喚醒並再次使用您的方案。要停止它，在執行緒中要求它停止監視提取請求。

​

查看並減少 project 的使用

• 路由到已閒置超過 快取生命週期（Pro 和 Max 在您方案限制內為一小時）的執行緒的後續工作在執行任何操作之前重新讀取該執行緒的整個對話。對於新工作，要求 Claude 啟動新執行緒可以使用比復興大型舊執行緒更少。
• 對於不需要最大模型的工作，為執行緒、對話或兩者選擇較小的模型或較低的努力級別。
• 要求 Claude 在 project 對話中一次執行更少的執行緒，或自己回答小問題而不是啟動執行緒。

​

Projects 與其他 Claude Code 功能的關係

• Claude Tag：Claude Tag 是您團隊 Slack 頻道中的 Claude，在 Team 和 Enterprise 方案上。頻道中的任何人都可以給它工作，頻道中的每個人都看到並引導它，它使用管理員為該頻道設定的連接。project 是您的：您是唯一給它工作或看到其執行緒的人，它使用您自己的 GitHub 存取和 connectors，它在 Pro 和 Max 上。Claude Tag 與 Cowork 和 Claude Code 的不同之處 有並排比較。
• 雲端工作階段：每個執行緒是一個 雲端工作階段，由 Claude 而不是您啟動和跟蹤。您自己啟動的雲端工作階段可以通過 Continue as a project 或 Move to project 成為 project 或提供一個。
• Routines：當您在 project 中要求排程工作時，Claude 建立一個 routine，在該 project 中作為執行緒執行，並出現在其 Routines 標籤上。您在 project 外建立的 Routines 保持自己工作。
• 本地工作階段和代理檢視：您終端、IDE 或桌面應用程式本地環境中的工作階段在您的機器上執行，無法成為 project 的一部分。代理檢視 是用於跟蹤多個那些本地工作階段的螢幕；它沒有協調者。
• Worktrees：worktree 給每個本地工作階段其自己的儲存庫工作副本，因此您機器上的平行工作階段不會相互覆蓋。執行緒不需要它們：每個執行緒將其儲存庫克隆到其自己的雲端沙箱中，並在自己的分支上工作。
• 代理團隊：代理團隊 是一個工作階段，為單個任務啟動隊友工作階段，在您的機器上或在雲端工作階段內，並以該任務結束。
• claude.ai 聊天和 Cowork 中的 Projects：早期 Projects 體驗，它對話和參考檔案進行分組，沒有執行緒或協調者。那些 projects 保持今天的工作方式，直到重新設計的體驗到達它們。

​

限制

• Projects 在 claude.ai/code、桌面應用程式和 Claude 行動應用程式中可用，不在終端 CLI 或通過 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 中。CLI 的 claude project 命令，它管理目錄的本地 Claude Code 狀態，是無關的。
• Project 執行緒是 雲端工作階段，Anthropic 作為模型提供者。安全 和 資料使用 涵蓋了雲端工作階段如何隔離以及保留什麼。
• 本地工作階段無法成為 project 的一部分。
• 執行緒的沙箱在轉換之間暫停，並在執行緒繼續時恢復。如果沙箱無法恢復，執行緒從新克隆繼續，因此未提交的變更可能會丟失。在長任務上，要求 Claude 提交並推送進行中的工作。
• project 屬於一個使用者。您無法與另一個使用者共享 project 或其執行緒，執行緒記錄沒有其他雲端工作階段具有的共享選項。在測試版期間，projects 沒有組織級控制。
• 執行緒屬於啟動它的一個 project。您無法將執行緒移動或複製到另一個 project，或將其移出以獨立存在。Move to project 僅以另一種方式進行：它將雲端工作階段的工作帶入 project。

​

故障排除

​

執行緒看起來卡住了

​

執行緒猜測或停滯而不是詢問

1. 在對話中要求 Claude：「對於每個打開的執行緒，列出您要求它做什麼、它假設或無法到達的內容，以及它正在等待什麼。」Claude 讀取每個執行緒並在對話中回答。
2. 對於從錯誤假設開始的執行緒，從 Overview 打開執行緒並從其功能表標記為已解決，或在其訊息框中告訴它改為做什麼。其分支和任何提取請求保留在 GitHub 上，直到您刪除它們。
3. 在 project 指示 或 環境 中修復間隙一次，然後在再次發送其餘工作作為新執行緒之前發送一個執行緒。

​

Claude 還沒有回應

​

儲存庫存取錯誤

• 「Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository」，在執行緒啟動之前報告，當 Claude GitHub App 未安裝在該儲存庫上、已暫停或未連結到您連接的 GitHub 帳戶時。
• 「Unable to access your repository」，由執行緒報告，當其克隆失敗時：GitHub 拒絕克隆、在 project 具有的名稱下找不到儲存庫，或執行緒被要求啟動的分支不存在。
• 「Claude can’t access」 儲存庫，在您在 New project 對話框或 Project settings 中保存儲存庫時顯示。訊息繼續帶有安裝連結和重新連接連結。如果 Claude GitHub App 不在該儲存庫上，使用安裝連結，如果它是，使用重新連接連結，因為 GitHub App 可以在 GitHub 上安裝而不連結到您連接到 Claude 的帳戶。如果訊息說 GitHub App 已暫停或不包括此儲存庫，請遵循其連結到 GitHub 以修復它。

​

執行緒達到使用限制

​

需要額外的使用信用

​

其他訊息

​

相關資源

• 在雲端使用 Claude Code：每個執行緒後面的雲端工作階段如何工作，包括 GitHub 存取選項和提取請求上的 auto-fix
• 配置雲端環境：更改執行緒可以在網路上到達的內容、給予它們環境變數和 API 認證，以及使用設定指令碼安裝工具
• 使用 routines 自動化工作：routines 的時間表、觸發器和管理，包括 Claude 從 project 建立的
• 使用代理檢視管理多個代理：當工作需要只有您的機器才能到達的工具或服務時，在您自己的機器上執行和跟蹤多個工作階段
• Projects 重新設計：從資料夾到對話：啟動公告，帶有使 project 成為與 Claude 對話的思考