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

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

​

何時使用 project

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

​

何時其他方式更合適

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

​

Project 如何組織

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

​

建立專案

• 從頭開始：當您知道要讓 Claude 執行的工作流程時，開啟 New project 對話方塊並為其命名。從頭開始建立新專案會逐步說明此對話方塊。
• 從已在進行該工作的雲端工作階段開始：在該工作階段的側邊欄選單中，選擇 Continue in project，然後選擇 Continue as new project。Claude 會根據該工作階段正在進行的工作，提出專案的設定建議。請參閱從現有的雲端工作階段開始。

​

檢查先決條件

• 方案：您使用的是 Pro、Max 或 Ultra 方案，且 Projects 會直接顯示在側邊欄中，或顯示在 More 之下。選取 Projects，並確認其提供 New project 或 Get started。
• GitHub（如果專案將處理程式碼）：您的程式碼位於 github.com，而非 GitHub Enterprise Server、GitLab 或 Bitbucket；您連接的 GitHub 帳戶具有推送權限；且已在其上安裝 Claude GitHub App。如果您是透過 /web-setup 連接 GitHub，該 token 可讓您的其他雲端工作階段存取儲存庫，但不足以供專案的雲端執行緒使用，因為這些執行緒需要 Claude GitHub App。設定 GitHub 存取中有相關步驟。
• 網路存取、密鑰和工具：對於雲端執行緒，這些來自專案的雲端環境。預設環境已可存取常見的套件登錄庫，因此只有在工作需要其他網域、密鑰或未預先安裝的工具時，才需要檢查此項目。如果工作需要 MCP 伺服器，請確認它在您的 claude.ai 連接器中顯示為已連接。

​

從頭開始建立新專案

​

從現有的工作階段開始

• 選擇 Continue as new project，從該工作階段建立新專案。專案會開啟，Claude 會讀取該工作階段，並在專案對話中發布 Setup recommendations 供您確認。原始工作階段會保留在您的工作階段清單中。如果它正在進行某個回合，該回合會繼續執行，因此如果您不希望兩者同時運作，請自行停止它。
• 選擇您的某個現有專案，將該工作階段的工作帶入該專案。該專案會開啟，並會代表您傳送一則訊息，請 Claude 讀取該工作階段並從中斷處接續。原始工作階段會保留在您的工作階段清單中，維持不變。

1. 如果工作階段尚未連接，請在其中執行 /remote-control。如果它是在該設定開啟時連接的，請先中斷連接，再重新連接。
2. 在瀏覽器中，於 claude.ai/code 的側邊欄找到該工作階段的列，開啟其選單，並從相同的子選單中選擇。

​

設定 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 中查看需要您的內容

• Library：您新增的檔案和資料夾，以及執行緒產生的檔案
• Pull requests：在執行緒打開任何 pull request 後顯示
• Scheduled tasks：Claude 從此 project 設定的雲端排程任務

​

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

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

​

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

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

​

調整 Claude 執行 project 的方式

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

​

解除等待批准的執行緒

​

在您自己的電腦上執行執行緒

• 與該機器上的檔案、工具、MCP 伺服器和 Claude Code 設定一起工作，包括其 hooks 和權限規則，而不是 project 的雲端環境
• 從 project 的指示開始，但不加載其記憶檔案
• 僅在該電腦清醒且 Remote Control 打開時執行

• 要讓執行緒再次執行：請參閱 失去與您資料夾的聯繫
• 要防止電腦自動睡眠：在桌面應用程式中，於 Settings > Code 或 Settings > Claude Code 中打開 Keep this computer awake for Remote Control

​

為專案提供常設背景

​

寫入專案指示

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

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

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

​

決定要新增哪些儲存庫

• 將其新增到專案，在新專案對話方塊中、在專案設定 > 環境中，或透過在對話中要求 Claude 將其新增到專案。從那時起，每個雲端執行緒都會複製它，並在啟動時載入其 CLAUDE.md，無論任務是否涉及它。
• 不要新增它，讓執行緒在需要時自行新增。 其任務需要專案沒有的儲存庫的雲端執行緒可以將其新增到自己，執行緒中的筆記表示它僅被新增到此執行緒。複製發生在任務進行中途，因此該儲存庫的 CLAUDE.md 在執行緒啟動時不存在。下一個執行緒啟動時沒有它。以這種方式新增的儲存庫需要與專案儲存庫相同的先決條件：在其上安裝的 Claude GitHub App 和來自您的 GitHub 帳戶的推送存取。

​

新增檔案和資料夾

• 程式庫標籤：一次最多 100 個檔案和 2 GB，單個檔案最多 480 MB。
• 新專案對話：超過 30 MB 的檔案會被跳過，因此在建立專案後從程式庫標籤新增較大的檔案。
• 資料夾：當您從任一位置新增資料夾時，專案會收到其前 100 個檔案的副本，最多 200 MB，不包括任何超過 30 MB 的檔案、隱藏檔案或 node_modules。專案最多可以保存 10 個資料夾和 Google Drive 資料夾的組合，單個檔案不計入該限制。
• 上傳後的變更：上傳是副本，因此您之後在電腦上進行的變更不會到達專案，直到您再次上傳檔案並在詢問現有名稱時選擇取代。

​

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

​

為執行緒選擇環境

​

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

• Skill：為您的 claude.ai 帳戶啟用它們，雲端執行緒就會載入您在那裡啟用的 skill，但自行託管環境中的部分執行緒除外。提交到儲存庫 .claude/skills/ 的 skill 不會在雲端執行緒中載入。
• 外掛程式：在專案設定 > 外掛程式中新增它們；它們載入到每個新雲端執行緒。儲存庫在其 .claude/settings.json 中宣告的外掛程式不會在雲端執行緒中載入。
• MCP 伺服器：雲端執行緒從您的 claude.ai 帳戶上的連接器獲取其 MCP 工具，這些是您在 claude.ai/customize/connectors 連接一次的 MCP 伺服器。每個雲端執行緒可以使用所有它們，無需每個專案的設定。專案對話本身沒有連接器，因此將需要連接器的工作作為雲端執行緒的任務傳送。連接器如何到達 Claude Code 列出雲端工作階段的規則和關閉連接器的設定。
• 命令列工具和套件：在環境的設定指令碼中安裝它們。

​

Project 設定參考

​

暫停、存檔或刪除 project

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

​

使用和成本

​

什麼使用您的方案

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

​

查看並減少 project 的使用

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

​

Projects 與其他 Claude Code 功能的關係

• Claude Tag：Claude Tag 是您團隊 Slack 頻道中的 Claude，在 Team 和 Enterprise 方案上。頻道中的任何人都可以給它工作，頻道中的每個人都看到並引導它，它使用管理員為該頻道設定的連接。 Projects 適用於 Pro、Max 和 Ultra。project 只屬於您：您是唯一能傳送工作給它或查看其執行緒的人，它使用您自己的 GitHub 存取權限和連接器。Claude Tag 與 Cowork 和 Claude Code 的不同之處 有並排比較。
• 雲端工作階段：每個執行緒是一個 雲端工作階段，除非您要求 Claude 在您的機器上執行它。無論哪種方式，Claude 啟動並追蹤它而不是您。您也可以將自己啟動的雲端工作階段的工作帶入 project：在該工作階段的側邊欄選單中選擇 Continue in project。
• 排程任務：當您在 project 中要求排程工作時，Claude 會建立一個雲端排程任務，在該 project 中作為執行緒執行，並出現在其 Scheduled tasks 標籤上。您在 project 外建立的排程任務會繼續獨立運作。
• Remote Control：Remote Control 連接 claude.ai 到在您機器上執行的 Claude Code 工作階段。當您在 project 中要求 Claude 在您的電腦上執行執行緒時，project 使用 Remote Control 來執行它。
• 本機工作階段和 agent 檢視：您在終端機、IDE 或桌面應用程式的本機環境中自行啟動的工作階段不會屬於您的 projects，不過您可以將其工作帶入某個 project。Agent 檢視 是用於並排追蹤多個本機工作階段的畫面，您仍然自己啟動每個工作階段並給它其任務。
• Worktrees：worktree 給每個本機工作階段其自己的儲存庫工作副本。雲端執行緒不需要它們：每個執行緒將其儲存庫克隆到其自己的雲端沙箱中，並在自己的分支上工作。
• 代理團隊：代理團隊 是一個工作階段，為單個任務啟動隊友工作階段，在您的機器上或在雲端工作階段內，並以該任務結束。
• Subagents：subagent 在一個工作階段內執行，在其自己的內容視窗中執行側面任務，並將摘要返回到該工作階段。project 的執行緒是 Claude 啟動的完整工作階段，並向 project 對話報告，執行緒仍然可以為其自己的側面任務使用 subagents。
• claude.ai 聊天和 Cowork 中的 Projects：早期 Projects 體驗，它對話和參考檔案進行分組，沒有執行緒或協調者。那些 projects 保持今天的工作方式，直到重新設計的體驗到達它們。

​

限制

• Projects 在 claude.ai/code、桌面應用程式和 Claude 行動應用程式中可用，不在終端機 CLI、VS Code 擴充功能或 JetBrains 外掛中，也不通過 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。
• Project 執行緒是 雲端工作階段，或通過 Remote Control 在您自己的機器上的工作階段，兩種情況下 Anthropic 都是模型提供者。安全 和 資料使用 涵蓋了雲端工作階段如何隔離以及保留什麼，連線和安全 涵蓋了您機器上的執行緒如何連線以及儲存什麼。
• 您無法將自己在機器上啟動的工作階段新增到 project，但您可以將其工作帶入 project。Project 通過 Remote Control 在您的機器上執行執行緒到達您的機器，該部分列出了它需要的內容。
• 雲端執行緒的沙箱在回合之間暫停，並在執行緒繼續時恢復。如果沙箱無法恢復，執行緒從新克隆繼續，因此未提交的變更可能會遺失。在長任務上，要求 Claude 提交並推送進行中的工作。
• project 屬於一個使用者。您無法與另一個使用者共享 project 或其執行緒，執行緒記錄沒有其他雲端工作階段具有的共享選項。在測試版期間，projects 沒有組織級控制。
• 執行緒屬於啟動它的一個 project。您無法將執行緒移動或複製到另一個 project，或將其移出以獨立存在。Continue in project 僅以另一種方式進行：它將雲端工作階段的工作帶入 project。您無法將兩個 projects 合併為一個。

​

故障排除

​

執行緒看起來卡住了

​

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

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 以修復它。

​

執行緒達到使用限制

​

需要額外的使用信用

​

與您的資料夾失去聯繫

• 桌面應用程式：重新打開應用程式並確認 Settings > Code 或 Settings > Claude Code 下的 Use this computer from your phone and claude.ai 仍然開啟
• 終端機：在同一資料夾中再次執行 claude remote-control

​

其他訊息

​

相關資源

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