Claude Code Projects：コーディネーター、スレッド、ベータ版の制限

Anthropicは最近、Claude CodeのProjectsを再設計しました。現在は、タスク用のクラウドセッション（スレッド）を並行して起動し、そこから報告を受け取る単一の調整用会話です。作業に1回のセッションでは終わらない目標があり、新たなタスクが発生する場合は、プロジェクトを作成する価値があります。たとえば、数週間にわたってGitHubリポジトリを開発する場合です。並行作業が必要というだけでは十分ではありません。今すぐここで1つのファイルをすばやく修正するだけなら、通常のセッションで十分です。

作業を主導するのはコーディネーターです。これは、あなたのメッセージからスレッド向けのタスクに何を変えるかをClaudeが判断する、長期にわたる会話です。コードを書くのはスレッドです。それぞれが独自のリポジトリブランチを持つ、別個のクラウドClaude Codeセッションです。各スレッドはそれぞれのコンテキストとブランチを持ち、複数のスレッドを同時に実行できます。コーディネーターはスレッドが完了時に報告する内容を確認できますが、その過程のすべてを見るわけではありません。完了したプルリクエスト（変更をマージするためのリクエスト）をあなたに報告し、あなたの指示に応じてスレッドに修正やマージを依頼します。以下では、Anthropicの公式ドキュメントに基づき、設定する内容、作業の進め方、ベータ版の制限を概説します。

ベータ版は段階的に利用可能になっています。まず、クラウドClaude Codeセッションをすでに利用したことがあり、通常のチャットやCoworkでプロジェクトを作成していないProおよびMaxアカウントから提供が始まっています。Projectsのセクションがまだ表示されない場合は、ウェイトリストに登録できます。

Claude Code Projectsとは何か：簡単に説明#

プロジェクトとは、リポジトリ、メモリ、指示が付属した、コーディネーターとの単一の長期的な会話です。あなたがコーディネーターにメッセージを送ると、すぐに返答するか、スレッドを起動するかを判断します。タスクごとに新しいセッションを手動で開く必要はありません。

スレッドは、完全なクラウドClaude Codeセッションです。独自のコンテキストとリポジトリブランチがあり、必要に応じてプルリクエストを開きます。コーディネーターは複数のスレッドを同時に開いたままにできます。たとえば、1つはバグを修正し、別の1つはテストを書き、3つ目はドキュメントを更新しながら、メインの会話であなたの質問に答えます。

ローカルのClaude Codeセッションを複数のタブで開き、それぞれがリポジトリの独自の作業コピーを使う状態を想像するとよいでしょう。このコピーはワークツリーと呼ばれ、ローカルセッション同士が干渉しないよう、ブランチごとに別々のフォルダーを用意します。どのセッションに何を割り当てるかを決め、セッションを自分で切り替えます。クラウドスレッドにはワークツリーは必要ありません。各スレッドがリポジトリを独自の隔離されたクラウド環境にクローンするからです。Projectsが調整を担い、新しいスレッドを作成するか、作成しないかを判断します。

プロジェクトには、各新規スレッドが受け取る共有メモリと指示があります。設定のセクションでは、何を保存すべきか、またスレッドにどう渡されるかを説明します。

通常のセッションやエージェントチームとの違い#

単一のClaude Codeセッション内でネストされたサブエージェントをすでに実行している場合は、それらとエージェントチームやプロジェクトスレッドとの違いを整理しておくとよいでしょう。エージェントチームは、作業を委任する別の方法です。1つのセッションが特定のタスクのためにチームメイトのセッションを起動します。自分のマシン上でも、クラウドセッション内でも実行できます。

• エージェントチーム—ローカルまたはクラウドで起動できる、特定の1つのタスクのためのチームメイトセッションです。これらは独立したプロジェクトスレッドではありません。
• プロジェクトとそのスレッド—作業はクラウドで実行されます。各スレッドは独自のブランチを持つ別個のセッションで、ノートパソコンを閉じた後も実行を続けます。ローカルセッションをプロジェクトの一部にすることはできません。
• エージェントビュー—マシン上の複数のローカルセッションを監視する画面です。コーディネーターはなく、各セッションに何を割り当てるかは自分で決めます。

Anthropicの公式ドキュメントでは、並行作業だけを理由にプロジェクトを作成すべきではないと、別途指摘しています。プロジェクトでは、Claude自身がセッションを起動して報告を受け取り、すべてのセッションが共有リポジトリ、指示、メモリを使って開始します。タスクの間、作業はクラウド上で続きます。

コーディネーターがエージェントにタスクを配分する同様の方法は、別のツールにも実装されています。Cursor Projectsの記事で取り上げています。仕組みは異なりますが、コーディネーターが誰に何を割り当てるかを判断する点は共通しています。

最初のプロジェクトを作成する前に設定すること#

プロジェクトを作成する前に、次の3点を確認してください。

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ボタンを押すと、あなたからのメッセージとしてスレッドに指示が送られます。

公式ドキュメントでは、プロジェクトの指示にスレッド数の希望を記載することを勧めています。たとえば、一度に起動するスレッドは最大2つにするようコーディネーターに依頼したり、同じ領域の新しいタスクには既存のスレッドを再利用するよう依頼したりできます。これはコーディネーターが従おうとする希望であり、厳密な上限ではありません。それだけでは、スレッドが同じファイルで競合しないことを保証できません。すでにある競合は個別に解決する必要があります。同じ領域の関連タスクでは、アクティブなスレッドでもアイドル状態のスレッドでも再利用できます。1時間を超えてアイドル状態だった場合、新しいメッセージを受け取ると履歴全体を再読するため、サブスクリプションの利用枠に影響します。

タスクがファイルやモジュールごとに明確に分かれているほど、並行して進めやすくなります。大きなタスクを独立した部分に分ける方法については、何千ものエージェントにコーディングを委任する方法の記事で取り上げています。規模は異なりますが、作業を分割する原則は同じです。

会話キャッシュが有効な間（ProおよびMaxプランでは1時間以内で、プランの上限が許す場合）、スレッドは履歴を再処理する際にサブスクリプションの利用枠から消費するトークンを減らせます。キャッシュの有効期限が切れると、新しいメッセージを受け取ったスレッドは、作業を始める前に履歴全体を再読します。新しい独立したタスクでは、コーディネーターに新しいスレッドを作成するよう依頼したほうが経済的な場合があります。キャッシュの有効期限が切れた後、大量の履歴がある古いセッションを続けるより、同じサブスクリプションの利用枠から消費するトークンが少なくなる可能性があります。

事前に知っておくべきベータ版の制限#

重要なタスクのためにプロジェクトを作成する前に、ベータ版の制限を確認してください。

• 利用できるのはProとMaxのみ。 TeamとEnterpriseはまだサポートされていません。
• 1アカウントにつき1日あたり最大200件の新規スレッド。 すべてのプロジェクトを合算した上限です。
• プロジェクトは1人のユーザーに属します。 他の人にプロジェクトや個別のスレッドへの共有アクセスを付与することはできず、ベータ版にはチーム向けの組織設定もありません。
• アクセスできるのはclaude.ai/code、デスクトップアプリ、モバイルアプリのみ。 ProjectsはターミナルCLI、Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundryでは動作しません。
• プロジェクトからローカルファイルやツールにはアクセスできません。 スレッドはGitHubリポジトリ、アップロードされたファイル、Google Driveフォルダーを扱えますが、自分のマシン上にしかないものは扱えません。

ターミナルや自分のマシン上でのみ使えるツールにアクセスする必要がある場合は、ローカルセッションか、そうしたセッションを複数表示できるエージェントビューを使ってください。複数人で1つのワークスペースを使う必要がある場合、AnthropicはTeamおよびEnterprise向けの別製品であるClaude Tagを提供しています。これはSlackチャンネル内で動作し、メンバーなら誰でもClaudeにタスクを与えられ、チャンネル内の全員が作業を確認して指示できます。プロジェクトはこれとは異なり、あなた1人だけに属します。特定のローカルファイルだけが必要な場合は、それらをプロジェクトにアップロードすると、各スレッドからアクセスできるようになります。ただし、ローカルツールへのアクセスは提供されません。

次のステップ#

ワークフローをProjectsに移す前に、重要ではないリポジトリでテスト用プロジェクトを1つ作成してみてください。GitHub Appを接続し、短い指示を書き、コーディネーターに独立したタスクを1つ与えて、その処理を確認します。この最初の実行で、コーディネーターとスレッドのインターフェースを理解できているかがわかります。ただし、複数のタスクにわたる並行作業、競合、利用枠の消費状況はこの方法では確認できず、別途テストする必要があります。