# Claude Code Projects：協調器、執行緒與 Beta 版限制

> Claude Code Projects 雲端執行緒的運作方式：GitHub App、指示、記憶、衝突與 Beta 版限制。

Source: https://ailoot.ai/blog/zh-hant-tw/claude-code-projects/
Canonical: https://ailoot.ai/blog/zh-hant-tw/claude-code-projects/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-051
Revision: sha256-327374e73905ba70dae84521b6b641b386ea961b2d6218ed49efffc5b73d1a87


Anthropic 最近重新設計了 Claude Code 的 Projects。現在它是一個單一的協調對話，會啟動平行的雲端工作階段（執行緒）來處理任務，並接收它們的回報。當你的工作有一個會持續超過單一工作階段、並會產生新任務的目標時，建立專案就很值得；例如，花幾週時間開發 GitHub 儲存庫。只有平行工作的需求還不夠。如果你只需要立即快速修正這裡的一個檔案，使用一般工作階段就足夠了。

工作由協調器主導——這是一段長期延續的對話，Claude 會在其中決定要把你訊息中的哪些內容轉成執行緒的任務。執行緒負責編寫程式碼：每個執行緒都是獨立的雲端 Claude Code 工作階段，使用自己的儲存庫分支。多個執行緒可以同時執行，各自擁有自己的上下文和分支。協調器會看到執行緒完成時的回報，但看不到它採取的每個步驟。它會向你回報已完成的提取要求（合併變更的要求），並在你下達指令時，要求執行緒修改或合併它們。以下根據 Anthropic 官方文件，概述需要設定的項目、工作的組織方式，以及 Beta 版的限制。

Beta 版正逐步開放，首先提供給已使用過雲端 Claude Code 工作階段、且尚未在一般聊天或 Cowork 中建立專案的 Pro 和 Max 帳戶。如果你還看不到 Projects 區段，可以加入候補名單。



<div class="aside" data-semantic="ailoot-docs-link" aria-label="Ailoot 文件">

Ailoot 的實用操作說明請參閱[文件](https://ailoot.ai/docs/)。

</div>

## 簡單來說，Claude Code Projects 是什麼

專案是一段與協調器進行的單一長期對話，並附有儲存庫、記憶和指示。你向協調器傳送訊息，由它決定要立即回覆，還是啟動執行緒。你不必為每個任務手動開啟新的工作階段。

執行緒是一個完整的雲端 Claude Code 工作階段：它有自己的上下文和儲存庫分支，並會在需要時開啟提取要求。協調器可以同時保持多個執行緒開啟——例如，一個修正錯誤，另一個撰寫測試，第三個更新文件，同時在主要對話中回答你的問題。

作為比較，可以想像你開啟了多個分頁，分別執行本機 Claude Code 工作階段，每個工作階段都使用儲存庫的一份獨立工作副本。這種副本稱為 worktree（工作樹）——每個分支各有一個資料夾，讓本機工作階段不會互相干擾。你要自行切換工作階段，並決定分派給每個工作階段的任務。雲端執行緒不需要 worktree：每個執行緒都會將儲存庫複製到自己的隔離雲端環境。Projects 負責協調，決定何時建立新執行緒，以及何時不需要建立。

專案有共用的記憶和指示，每個新執行緒都會收到。設定一節會說明應將哪些內容存入其中，以及如何傳遞給執行緒。



## 這與一般工作階段和代理團隊有何不同

如果你已在單一 Claude Code 工作階段中執行[巢狀子代理](https://ailoot.ai/blog/zh-hant-tw/claude-code-nested-subagents/)，就值得分清它們與代理團隊及專案執行緒的差異。代理團隊是另一種委派工作的方式：一個工作階段會為特定任務啟動隊友工作階段。你可以在自己的電腦上執行，也可以在雲端工作階段中執行。

- **代理團隊**——為單一特定任務啟動的隊友工作階段，可在本機或雲端執行。這些不是獨立的專案執行緒。
- **專案及其執行緒**——工作在雲端執行。每個執行緒都是使用自己分支的獨立工作階段，即使你關上筆電也會繼續執行。本機工作階段不能成為專案的一部分。
- **Agent view**——用來觀察電腦上多個本機工作階段的畫面。它沒有協調器：由你決定分派給每個工作階段的任務。

Anthropic 的官方文件另有指出，只有平行工作並不足以成為建立專案的理由。在專案中，Claude 會自行啟動工作階段並接收回報，而所有工作階段一開始都會使用共用的儲存庫、指示和記憶。整個任務期間，工作都會在雲端進行。

另一個工具也採用了類似做法，由協調器將任務分派給代理，相關內容請見[Cursor Projects](https://ailoot.ai/blog/zh-hant-tw/cursor-projects-coordinator-agents/)一文。機制有所不同，但協調器同樣會決定要把什麼任務交給誰。

## 建立第一個專案前要設定什麼

建立專案前，請確認以下三件事。

**1. GitHub 帳戶和 Claude GitHub App。** 如果你已透過 `/web-setup` 連結 GitHub，該權杖會讓一般雲端工作階段存取儲存庫。但這對專案執行緒並不足夠：你需要連結一個具有該儲存庫推送權限的 GitHub 帳戶，並在該儲存庫安裝 Claude GitHub App。沒有這些設定，執行緒就無法複製儲存庫，也無法開啟提取要求。

**2. 專案指示。** 專案指示是最多 16 000 個字元的文字，會傳送給每個新執行緒及協調器本身。請在此處放入你原本必須在每個工作階段重新說明的資訊：儲存庫結構、程式碼慣例，以及開啟提取要求前必須執行的檢查。

**3. 模型和努力程度。** 預設情況下，新專案會讓每個執行緒以高努力程度使用 Opus 模型，協調器則以低努力程度執行。文件指出此設定「最迅速地消耗你的方案額度」（翻譯；原文：draws on your plan fastest）。如果任務較簡單，你可以選擇成本較低的模型，或在 **Project settings \> General** 降低努力程度。執行緒和協調器的設定要分開變更；文件有說明較節省的選項。

專案記憶以一般檔案形式儲存，並包含一個名為 `MEMORY.md` 的索引檔。每個新執行緒會在啟動時讀取該檔，並視需要存取其他檔案。某個執行緒將發現事項存入記憶後，下一個執行緒便能取得，不必重新口頭說明。

## 如果執行緒修改了相同程式碼，該怎麼辦

每個執行緒都在自己的分支上工作，並會在需要時自行開啟提取要求。但協調器不會保證任務永遠不會重疊：如果多個執行緒最後都涉及相同的程式碼區域，你可以透過介面要求相關執行緒解決衝突。提取要求旁的 Resolve conflicts 按鈕會將你的指示以訊息形式傳送給該執行緒。

官方文件建議在專案指示中說明你對執行緒數量的偏好：例如，請協調器一次最多啟動兩個執行緒，或在相同區域的新任務中重用現有執行緒。這是協調器會盡量遵循的偏好，而非硬性上限。光是這樣無法保證執行緒不會在同一個檔案中衝突——現有衝突仍須另外解決。對於同一區域的相關任務，你可以重用正在執行或閒置的執行緒。如果執行緒閒置超過一小時，收到新訊息時就會重新讀取完整歷史紀錄，這會影響訂閱額度的使用量。

任務依檔案或模組分得越清楚，就越容易平行處理。另一篇文章介紹如何將大型任務拆分成獨立部分：如何將程式碼工作委派給數千個代理。規模不同，但拆分工作的原則相同。

只要對話快取仍有效（Pro 和 Max 方案中，在一小時內且方案限制允許時），執行緒重新處理歷史紀錄所需的訂閱額度就會較少。快取到期後，執行緒收到新訊息時，會在開始工作前重新讀取完整歷史紀錄。對於新的獨立任務，請協調器建立新的執行緒可能更省額度：與繼續使用快取已過期且歷史紀錄龐大的舊工作階段相比，這可能會消耗較少的同一訂閱額度。

## 事先應了解的 Beta 版限制

為重要任務建立專案前，請先確認 Beta 版的限制：

- **僅適用於 Pro 和 Max。** Team 和 Enterprise 尚未支援。
- <strong>每個帳戶每天最多建立 200 個新執行緒，</strong>所有專案合計計算。
- **專案僅屬於一位使用者。** 你無法讓其他人共用專案或個別執行緒的存取權，Beta 版也沒有團隊的組織設定。
- **只能透過 claude.ai/code、桌面應用程式和行動應用程式存取。** Projects 無法在終端機 CLI、Amazon Bedrock、Google Cloud Agent Platform 或 Microsoft Foundry 中使用。
- **專案無法查看本機檔案和工具。** 執行緒可以使用 GitHub 儲存庫、上傳的檔案和 Google Drive 資料夾，但無法使用只存在於你電腦上的內容。

如果你需要終端機存取權，或需要使用只在自己電腦上提供的工具，請使用本機工作階段，或用 agent view 管理多個這類工作階段。如果多人需要在同一個工作區協作，Anthropic 為 Team 和 Enterprise 提供另一項團隊產品：Claude Tag。它在 Slack 頻道中運作；任何成員都能交付任務給 Claude，而頻道中的所有人都能查看並指揮工作。專案的運作方式不同：它只屬於你。如果你只需要特定的本機檔案，可以將它們上傳到專案，這樣每個執行緒都能存取。這不會提供本機工具的存取權。

## 接下來

將工作流程移至 Projects 前，請先在非關鍵的儲存庫上建立一個測試專案：連結 GitHub App、撰寫簡短指示、交給協調器一項獨立任務，再看看它如何處理。這次初步執行會讓你了解自己是否熟悉協調器和執行緒介面。但它無法測試多項任務間的平行工作、衝突或額度使用情況——這些需要另外測試。

<div class="section" role="doc-bibliography" aria-label="來源">

### 來源

- [Claude Code Projects - Anthropic 官方文件](https://code.claude.com/docs/en/claude-projects)

</div>





<div class="aside" data-semantic="ailoot-link" aria-label="Ailoot">

你可以繼續探索 [Ailoot](https://ailoot.ai/)。

</div>

## 常見問題：Claude Code Projects：協調器、執行緒與 Beta 版限制

### 只為平行工作就要建立 Project 嗎？

跨工作階段持續、受益於共用儲存庫、指示與記憶的目標才適合 Project。快速本機修改可用一般工作階段；Projects threads 在隔離雲端環境執行。

### 執行緒不能 clone 儲存庫時，查什麼？

查連接 GitHub 帳戶有無 push 權及 Claude GitHub App 是否安裝於該儲存庫。一般雲端工作階段 token 不足以支援 Project threads。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。