Claude がプロジェクトで進行中の作業を調整する

関連する作業の本体を 1 つの会話で Claude に提供し、リポジトリ、指示、メモリを共有する並列クラウドセッションを調整させます。

プロジェクトは、Claude が関連する作業のストリームを調整する 1 つの進行中の会話です。実行する必要があることを Claude に伝えると、各タスクのスレッドを開始します。各スレッドは クラウドセッション です。Claude Code がマシンではなくクラウドで実行されます。スレッドは並列実行され、ラップトップを閉じた後も実行を続けます。また、スマートフォンからスレッドをチェックして操舵することができます。

プロジェクトなしで複数のセッションを実行する場合、調整は自分で行う必要があります。各セッションが何に取り組むかを決定し、各セッションの開始時に同じバックグラウンド情報を繰り返し、どのセッションが完了したか、または回答が必要かを確認します。プロジェクトを使用すると、代わりに以下のことができます。

• 作業を 1 つの場所に送信する: バグレポート、スタックトレース、またはタスクのリストが発生するたびに会話に貼り付けます。Claude は各作業のスレッドを開始するか、その領域で既に作業しているスレッドに渡し、その場で簡単な質問に答えます。
• コンテキストを 1 回設定する: すべての新しいスレッドはプロジェクトのリポジトリ、指示、メモリで開始されるため、対象ブランチなどの 1 回述べたルールがすべてのスレッドに到達します。
• 立ち去って完了した作業に戻る: 1 時間後または翌朝に戻ると、Overview ペインに完了したスレッド、レビュー準備ができたプルリクエスト、回答を待っているスレッドが表示されます。

プロジェクトで実行する作業が既にわかっている場合は、プロジェクトを作成する に直接進んでください。

プロジェクトを使用する場合

プロジェクトは、作業に 1 つのセッションを超えて続く目標があり、タスクを生成し続ける場合に作成する価値があります。これらの種類の作業はプロジェクトに適しています。

• 多くのリポジトリにまたがる 1 つの目標: 「すべてのサービスを新しい lint 設定に対応させる」。Claude はリポジトリごとに 1 つのスレッドを実行でき、各スレッドは独自のプルリクエストを持ち、Overview ペイン にはどのスレッドがレビュー準備ができているかが表示されます。
• 継続的に供給する領域: 1 つのサービスのバグ、スタックトレース、レビューリクエストが到達するたびに会話に貼り付けられます。1 つの修正後に Claude に覚えておくよう指示した落とし穴は、次のために プロジェクトメモリ に含まれます。
• セッションより大きいビルドまたはマイグレーション: 「docs/spec.md が説明していることをビルドする」または「アプリを非推奨の ORM から移動する」。作業は各部分を取得するスレッドに分割され、Claude に早期に覚えておくよう求めた決定は後のスレッドに到達し、ビルド中に見つかった仕様の変更とバグが同じ会話に入ります。
• コードではない作業: 「これらのチケットで最も一般的な 10 の統合ミスを見つける」など、新しい質問で何度も戻ってくる契約フォルダまたはサポートチケットエクスポート。リポジトリを追加する代わりにドキュメントをアップロードし、スレッドはプロジェクトの Library タブ にファイルとして各レポートを配信します。

これらのいずれかで、タスクのバッチを送信し、Claude に確認を求めずに開始するよう指示し、立ち去り、戻ったときに Waiting on you の下で必要なスレッドを見つけるか、Claude に作業の一部を ルーチン としてスケジュールに入れるよう求めることができます。これらのいずれかが状況に当てはまる場合は、プロジェクトを作成してください。

別のものがより適切な場合

スレッドは GitHub リポジトリおよびプロジェクトにアップロードしたファイル、フォルダ、Google Drive フォルダで機能し、マシンにのみ存在するファイルやツールでは機能しません。これらの場合は別のものがより適切です。

• セッションに収まる 1 つのタスク: 「不安定なログインテストを修正する」。クラウドセッション を自分で開始します。
• マシンのみが到達できるツールまたはサービスが必要な作業: ローカルデータベース、デバイスエミュレータ、VPN の背後にある API。ローカルセッションを使用するか、エージェントビュー を使用して複数を同時に実行します。作業がローカルファイルのみが必要な場合は、代わりにプロジェクトにアップロードしてください。
• スケジュールで繰り返される 1 つのタスク、その周りに会話がない: 「毎週月曜日に依存関係レポートを投稿する」。ルーチン を単独で作成します。
• 複数の人が Claude に作業を与え、Slack チャネルで一緒に操舵する: Claude Tag を参照してください。

プロジェクトは他の Claude Code セッションと同じプラン制限を使用し、より速く使用します。使用量とコスト はプランに何が影響するか、およびそれを低く保つ方法をカバーしています。

プロジェクトの構成方法

プロジェクトは Claude との 1 つの調整会話と、それが作業を行うために開始するスレッドです。これらはその部分です。

• プロジェクト会話: Claude がコーディネーターとして機能する 1 つの長時間実行セッション。送信したものを取得し、何がスレッドになるかを決定し、開始したすべてのスレッドを追跡します。スレッドが報告する内容を確認し、実行するすべてのステップは確認しません。
• スレッド: ワーカー。各スレッドは独自のコンテキストウィンドウを持つ個別の クラウドセッション で、独自のブランチで 1 つの作業を実行し、作業が必要な場合はプルリクエストを開き、完了時に会話に報告します。
• すべてのスレッドが開始する内容:
  • プロジェクトのリポジトリとファイル、およびその 指示とメモリ
  • CLAUDE.md とスキル、および プロジェクトの各リポジトリ のプラグイン、および 1 つのリポジトリを持つプロジェクトでは、そのリポジトリの権限ルールとフックも
  • コネクタ を claude.ai アカウントに
  • ネットワークアクセス、環境変数、API 認証情報、インストール済みツールを設定する クラウド環境
• Overview ペイン: すべてのスレッドを一度に確認 でき、どのスレッドが必要かを確認できる場所。その他のタブは、追加したファイルとスレッドが生成したファイルの Library、スレッドが開いたプルリクエストの Pull requests、プロジェクトのスケジュール作業の Routines です。

スレッドは、独自のマシンの Claude Code セットアップから何も取得しません。スキル、プラグイン、コネクタ、ツールをスレッドに取得する は、それらが不足しているものを提供する方法をカバーしています。

これは、会話を通じてスレッドが作業を行う方法と、Overview がその状態を追跡する方法です。

プロジェクトを作成する

プロジェクトは claude.ai/code、デスクトップアプリの Code タブ、または iOS と Android 向けの Claude モバイルアプリで作成および使用します。ブラウザとデスクトップアプリでは、プロジェクトを開始する 2 つの方法があります。

• ゼロから開始：Claude に実行させたい作業の流れが決まっている場合は、New project ダイアログを開いて名前を付けます。ゼロからプロジェクトを開始するでダイアログの手順を説明しています。
• 既に作業を行っているクラウドセッションから開始：そのセッションのメニューから Continue as a project を選択すると、Claude がセッションで行っていた内容からプロジェクトのセットアップを提案します。既存のクラウドセッションから開始するを参照してください。

どちらの方法でも、まず 前提条件を確認してください。

前提条件を確認する

プロジェクトを作成する前に、プランと GitHub のセットアップ、および作業が到達する必要があるものを確認してください。

• プラン：Pro または Max プランを利用しており、サイドバーに Projects が表示されている。
• GitHub（プロジェクトがコードで作業する場合）：コードが GitHub Enterprise Server、GitLab、または Bitbucket ではなく github.com にあり、接続された GitHub アカウントがそれへのプッシュアクセス権を持っており、Claude GitHub App がインストールされている。/web-setupで GitHub を接続した場合、そのトークンは他のクラウドセッションがリポジトリに到達することを許可しますが、Claude GitHub App が必要なプロジェクトスレッドには十分ではありません。GitHub アクセスをセットアップするに手順があります。
• ネットワーク、認証情報、ツール：これらはプロジェクトの クラウド環境から取得されます。デフォルト環境は既に 一般的なパッケージレジストリに到達しているため、作業が他のドメイン、シークレット、またはプリインストールされていないツールを必要とする場合のみ確認してください。作業が MCP サーバーを必要とする場合は、claude.ai connectorsで接続済みとして表示されていることを確認してください。

ゼロからプロジェクトを開始する

ゼロからプロジェクトを開始するとは、New project ダイアログを開き、作業の流れに名前を付け、オプションでゴールと作業対象のリポジトリおよびファイルを指定することを意味します。必須なのは名前だけなので、プロジェクトを最初に作成してから、作業が進むにつれて残りを入力できます。

プロジェクトはサイドバーの Projects の下にリストされ、その会話が開いています。最初のバッチでは、作業を送信する前に何をセットアップするかについて説明しています。

既存のクラウドセッションから開始する

既にプロジェクトに属する作業を行っているクラウドセッションがある場合は、サイドバーのセッションのメニューを開いて Continue as a project または Move to project を選択します。

• Continue as a project はセッションにちなんで名付けられた新しいプロジェクトを作成して開きます。Claude はセッションを読み取り、確認するための Setup recommendations を会話に投稿します。元のセッションはセッションリストに残り、ターンの途中だった場合は実行を続けるため、両方が同時に作業するのを望まない場合は自分で停止してください。クラウドセッションのメッセージボックスの上に表示される可能性がある Set up project バナーを使用する場合、結果は同じですが、プロジェクトが開くとセッションの実行中のターンが停止します。
• Move to project はセッションの作業を既存のプロジェクトに持ち込みます。そのプロジェクトの会話にメッセージを投稿し、Claude にセッションを読み取って中断したところから再開するよう求め、新しい作業はプロジェクト独自のスレッドで続行されます。元のセッションはセッションリストに変更されずに残ります。

GitHub アクセスをセットアップする

ほとんどの GitHub セットアップはプロジェクトごとではなく、1 回だけ行われます。GitHub アカウントを Claude に 1 回接続し、Claude GitHub App はリポジトリごとに 1 回、またはすべてのリポジトリを付与する場合は GitHub 組織全体に 1 回インストールされます。Claude GitHub App がまだカバーしていないリポジトリを追加する場合、または SSO を強制する GitHub 組織内のリポジトリを追加する場合は、これらの手順に戻ります。

これらのステップのいずれかが不完全な場合、New project ダイアログとプロジェクトページは不足しているステップに名前を付け、それを完了する場所へのリンクを提供します。そこでステップを完了してから、ダイアログが提供する場合は Check again をクリックします。その後もリポジトリがリストに表示されない場合は、GitHub の Claude GitHub App のインストールを github.com/settings/installations で個人アカウント用に開き、Repository access の下にリポジトリがリストされていることを確認します。スレッドまたはプロジェクトがアクセスがまだ間違っている場合に報告するエラーメッセージについては、リポジトリアクセスエラーを参照してください。

プロジェクトで作業する

プロジェクト会話を通じて Claude に作業を提供します。タスクを 1 つずつまたは複数同時に、および更新と発生時の緩い考え。Claude は各メッセージをルーティングし、スレッドが作業を行い、報告します。

最初のバッチ

新しいプロジェクトに作業のバッチを送信する前に、最初のスレッドが希望する方法で戻ってくるようにセットアップします。

1. プロジェクト指示を書く: 対象ブランチ、スレッドが作業をチェックする方法、何があなたの承認が必要かなど、すべてのスレッドが開始する簡潔な指示。
2. 実際の作業の小さな部分を 1 つ送信するか、Claude が提案したスレッドの 1 つを開始し、完了時にスレッドを開いて、どのように報告し、ブランチで何をしたかを確認します。間違った仮定をしたか、必要なものに到達できなかった場合、スレッドが推測または停止した代わりに尋ねる はそれを修正する場所をカバーしています。
3. Project settings > General で Thread model と Thread effort を確認してください。新しいプロジェクトはすべてのスレッドを Opus で高い努力で実行し、プランを最速で使用します。モデルを選択し、Claude にコンテキストを管理させる は代替案をカバーしています。
4. Claude に スレッドを開始する前に提案し、一度に数個実行するよう求め、数個のスレッドが希望する方法で戻ってきたら、これらの制限を削除します。

作業を送信し、結果を読む

Claude は会話で送信する各メッセージがどこに行くかを決定します。

• 簡単な質問は通常、会話で回答を取得します。
• 新しい作業は新しいスレッドまたは既にその領域で作業しているスレッドに移動し、Claude はどちらかを伝えます。各新しいスレッドはメッセージの下にカードとして表示されます。スレッドのタイトルと状態を含むボックスで、クリックしてスレッドを開きます。
• 1 つのメッセージ内の複数の関連のないタスクは個別のスレッドになります。

Claude がメッセージを希望と異なるようにルーティングする場合は、そう言ってください。Claude がプロジェクトを実行する方法を調整する は、既存のスレッドをフォローアップに再利用するか、代わりに回答するなど、伝えることができることをリストします。

スレッドの完全な結果はスレッドに留まり、会話でそのカードを開いて読みます。スレッドが生成したファイルは Overview の Library タブにもあります。

時々 Claude はスレッドを開始する代わりにスレッドを提案し、Suggested threads リストに表示されます。提案の矢印をクリックしてそのスレッドを開始します。複数がリストされている場合、リストの下のボタンはすべてを開始します。

スレッドのプルリクエストをレビューする

スレッドがコードを変更する場合、別の指示がない限り、これが行うことです。

• Branch: リポジトリのデフォルトブランチから開始された新しいブランチで機能します。
• Pull request: 要求時に開き、バグ修正または別の具体的な変更のために独自に開くことができます。
• 開いた後: 他のクラウドセッションで自動修正がオンかどうかに関わらず、自動修正 をオンにしてプルリクエストを監視します。CI が失敗すると修正をプッシュし、レビューコメントに対応し、チェックが成功し、プルリクエストがレビュー準備ができたときにスレッドで返信します。

会話のスレッドのカードは、次のステップのボタンを表示できます。

• Resolve conflicts、Fix CI、Address comments、および Merge it はその指示をスレッドにメッセージとして送信し、プルリクエストに反応するのを待つ代わりにスレッドを自分でプロンプトできます。
• Review PR は GitHub でプルリクエストを開きます。
• Create PR はアイドル状態のスレッドがブランチをプッシュしたがプルリクエストを開いていない場合に表示されます。クリックするとスレッドにプルリクエストを開くよう指示を送信する代わりに、そのブランチから直接プルリクエストを作成します。

スレッドがプルリクエストを開く場合、例えば要求時のみ、またはどのブランチから開始するかを変更するには、タスクまたは プロジェクト指示 で言ってください。

Overview であなたが必要なものを確認する

会話の横の Overview ペインはプロジェクトのスレッドを追跡します。新しいプロジェクトを最初に開くときは既に開いています。プロジェクトヘッダーの Overview ボタンはそれを閉じて再度開き、スレッドがあなたを待機中の場合はドットを表示します。

デスクトップアプリでは、Claude が会話に投稿するとき、スレッドがエラーに当たるとき、またはスレッドが入力を必要とするときにデスクトップ通知も取得するため、プロジェクトを開いたままにしてそれを見つける必要はありません。スレッドが完了するたびに 1 つを取得するか、プロジェクトのためにそれらをオフにするには、プロジェクトのサイドバーメニューで Notifications を選択します。これらの通知はデスクトップのみです。ブラウザでは、Overview ボタンのドットを確認してください。

ペインの Threads タブはスレッドを状態別にグループ化します。

ペインの他のタブは、追加したファイルとフォルダおよびスレッドが生成したファイルの Library、スレッドが開いたプルリクエストの Pull requests、このプロジェクトの ルーチン の Routines です。

コントロールが必要な場合はスレッドを開く

会話のスレッドのカードまたは Overview の行をクリックして、Overview ペインでそのトランスクリプトを開きます。そこから以下ができます。

• Claude が何をしたかをステップバイステップで読みます。
• スレッド独自のメッセージボックスに書き込んでタスクを操舵します。そこのメッセージはそのスレッドに直接移動し、会話のフォローアップはそのスレッドに Claude がフォローアップを一致させるときのみ到達します。
• スレッドが待機している権限プロンプトに答えます。
• Stop でスレッドを中断します。これはスレッドが機能している間、送信ボタンを置き換えるか、Esc を押します。

モデルを選択し、Claude にコンテキストを管理させる

Project settings > General でモデルと努力を設定します。新しいプロジェクトはすべての場所で Opus を実行し、スレッドの高い 努力 と会話の低い努力があります。

• Thread model と Thread effort はスレッドに適用されます。1 つのタスクに異なるモデルを使用するには、タスクで要求してください。既に実行中のスレッドの場合、そのスレッドのモデルピッカーを使用してください。
• Coordinator model と Coordinator effort はプロジェクト会話の Claude に適用されます。

プロジェクトではコンテキストウィンドウを管理しません。スレッドは自動的にコンパクトになり、会話は完全な履歴ではなく最近のメッセージ、最近のスレッド、プロジェクトメモリから機能するため、プロジェクトが実行される限り続きます。決して削除されてはいけないものを プロジェクトメモリ に入れてください。1 つのスレッドがコンテキストを超える場合、Claude がこのターンでコンテキストを使い果たした と表示されます。

Claude がプロジェクトを実行する方法を調整する

会話で Claude に、一度に実行するスレッド数、更新を投稿する時期、プルリクエストを開く時期を伝えます。Claude が希望しない方法で調整している場合は、そう言ってください。例えば、以下のように言うことができます。

• 「スレッドを提案し、開始する前に承認を待つ」または「確認なしで今すぐこれらを開始する」
• 「一度に最大 2 つのスレッドを実行する」または「同じ領域のフォローアップに既存のスレッドを再利用する」
• 「より短い更新を投稿する」または「何かが完了またはブロックされたときのみ投稿する」
• 「すべてのスレッドのステータス更新をください」
• 「このタスクをより小さいモデルで実行する」
• 「計画を見るまでプルリクエストを開かない」
• 「これらのリポジトリで何が間違っているかを教えてください、まだ何も修正しないでください」。スレッドになる前に調査結果を確認したい場合
• 「代わりにここで答えてください」。Claude が簡単な質問のためにスレッドを開始する場合

Claude はこれらのような設定を プロジェクトメモリ に自動的に保存し、後のスレッドで従います。これらは Claude が守る指示であり、強制設定ではないため、この方法で与えるスレッド制限はハードキャップではありません。最初からすべてのスレッドに適用され、正確に文言されたい場合は、プロジェクト指示に 1 つを追加してください。

承認を待機しているスレッドをブロック解除する

スレッドはスレッドのモデルがサポートする場合、自動モード で実行されるため、ほとんどのツール呼び出しは質問なしで実行されます。スレッドが承認を必要とする場合、プロンプトはそのスレッド内にあり、スレッドはそこで答えるまで待機します。プロジェクト会話で Claude に先に進むよう伝えることはそれに到達しません。

各承認はそのプロンプト、またはより広いオプションを選択する場合はそのスレッドの残りをカバーします。すべてのスレッドが特定のコマンドを質問なしで実行できるようにするか、いくつかをブロックするには、リポジトリの .claude/settings.json に 権限ルール を追加してください。スレッドは 1 つのリポジトリを持つプロジェクトでのみそれらを適用します。スレッドがリポジトリから取得するもの を参照してください。

プロジェクトに常時コンテキストを付与する

プロジェクトメモリ、プロジェクト指示、およびプロジェクトのリポジトリ、ファイル、環境は、スレッド全体でコンテキストを保持します。各項目を 1 回設定すると、すべての新しいスレッドに適用されます。

プロジェクト設定 > メモリ は、これらのファイルを 自動メモリ の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する 自動メモリ とは別です。両方とも MEMORY.md インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の CLAUDE.md ファイルとは別です。各スレッドは開始時にクローンからこれらの CLAUDE.md ファイルを読み込むため、リポジトリに関する指示をその CLAUDE.md に、プロジェクトに関するメモをプロジェクトメモリに記載してください。

プロジェクト指示を書く

プロジェクト指示は、各新しいスレッドが開始する際の指示書です。プロジェクトヘッダーのギアアイコンをクリックして プロジェクト設定 を開き、メモリ > プロジェクト指示 に移動します。有用な指示書には以下が含まれます：

• プロジェクトの目的
• 作業が行われる場所：どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法
• スレッドが作業完了と判断する前に自分の作業をチェックする方法
• 必要なものが見つからない場合の対応方法
• あなたの承認が必要な事項

例：

このプロジェクトは、payments API の p95 レイテンシを 200 ms 以下に保ちます：プロファイリング、クエリとキャッシング修正、およびそれに伴う依存関係のアップグレードを payments-api リポジトリで行います。

- main からブランチを作成し、スレッドごとに 1 つのドラフトプルリクエストを開きます。
- 作業完了と判断する前に、`make test` と `make lint` を実行し、最終メッセージに概要行を貼り付けます。
- リポジトリ、シークレット、API、コネクタなど、必要なものに到達できない場合は、最初のメッセージで正確に何が不足しているかを述べて停止します。代替案を提案したり、モックを作成したり、推測したりしないでください。
- マージ、強制プッシュ、CI 設定の変更は、スレッド内で私に確認してから行ってください。

1 つのリポジトリに関するルール（ビルドコマンドなど）は、そのリポジトリの CLAUDE.md に属します。このファイルは、リポジトリがプロジェクトの一部である場合、すべてのスレッドが開始時に読み込みます。作業が進行中の場合、スレッドを修正するときは、Claude にその修正を記憶するよう依頼してください。修正は プロジェクトメモリ に記録され、後のスレッドはそれを使用して開始します。

追加するリポジトリを決定する

プロジェクトに追加するリポジトリは、すべてのスレッドでそれらに含まれるすべてのもの（コード、CLAUDE.md、スキル）を持ってきます。追加しないリポジトリにもアクセスできます：スレッドがタスクで必要な場合、自分自身にリポジトリを追加できます。ほとんどのプロジェクトは両方を使用します：

• プロジェクトに追加します。新規プロジェクト ダイアログ、プロジェクト設定 > 環境、または会話内で Claude にプロジェクトに追加するよう依頼します。その後のすべてのスレッドは、タスクがそれに触れるかどうかに関わらず、それをクローンして CLAUDE.md とスキルを読み込んで開始します。1 つのリポジトリから複数のリポジトリに移行すると、各リポジトリの .claude/settings.json からスレッドが取得するものも変わります。スレッドがリポジトリから取得するもの を参照してください。
• オフのままにして、スレッドが必要な場合に追加させます。 タスクがプロジェクトにないリポジトリを必要とするスレッドは、自分自身にそれを追加でき、スレッド内のメモはそれがこのスレッドのみに追加されたことを示します。クローンはタスクの途中で発生するため、そのリポジトリの CLAUDE.md とスキルはスレッド開始時には存在しません。次のスレッドは再度それなしで開始します。スレッドが追加するリポジトリは、プロジェクトリポジトリと同じ 前提条件 が必要です：Claude GitHub App がインストールされていることと、GitHub アカウントからのプッシュアクセスです。

プロジェクトはリポジトリをまったく必要としません。そのスレッドは、研究、ドキュメント作成、独自のサンドボックスでのコード作成と実行を行うことができ、ライブラリ タブにファイルを配信します。そこのスレッドは、タスクが必要な場合、自分自身にリポジトリを追加することもできます。

プロジェクトにリポジトリがある場合、Claude はプロジェクトが既に使用している GitHub オーナーからのみリポジトリを追加できます。プロジェクトに追加するか、スレッドが自分自身に追加するかに関わらず同じです。別のオーナーからリポジトリを持ってくるには、プロジェクト設定 > 環境 で自分でプロジェクトに追加してください。

サーバー、ウェブ、モバイル、デスクトップコードを持つ機能など、多くのリポジトリにまたがるプロジェクトの場合、ほぼすべてのタスクが触れる 1 つまたは 2 つのリポジトリを追加し、プロジェクト指示 で他のリポジトリに名前を付けて、Claude が残りのコードがどこにあるかを知るようにします。スレッドは小さく開始し、それらが必要なタスクに対してのみ他のリポジトリを取得します。

スレッドがリポジトリから取得するもの

各スレッドはプロジェクト内のすべてのリポジトリをクローンし、すべてのリポジトリから CLAUDE.md とスキルを読み込みます。権限ルール、フック、env は、スレッドが開始するディレクトリ内の .claude/settings.json からのみ取得されます：プロジェクトが 1 つのリポジトリを持つ場合はリポジトリ内、複数のリポジトリを持つ場合はクローンの上で、リポジトリのファイルはそれらに対して読み込まれません。

複数のリポジトリを持つプロジェクトでは、各クローンは CLAUDE.md 読み込みが有効になった 追加ディレクトリ としてスレッドに接続されます。これが、スレッドがそれらの上で開始されるにもかかわらず、すべてのリポジトリの CLAUDE.md とスキルが開始時に読み込まれる理由です。このようなプロジェクトでは、スタンディングルールをプロジェクト指示に記載し、クラウド環境 を通じてスレッドに環境変数を提供してください。

スレッドの環境を選択する

すべての新しいスレッドはプロジェクトの クラウド環境 で開始します。環境は、スレッドが到達できるドメイン、スレッドが持つ環境変数、リクエストに追加される API 認証情報、Claude が開始する前にセットアップスクリプトがインストールするものを設定します。スレッドは、プロジェクト設定 > 環境 で選択するまで、デフォルトの Anthropic ホスト環境を使用します。

スレッドが内部 API またはプライベートパッケージレジストリに到達する必要がある場合、またはマシンが通常保持するトークンが必要な場合は、プロジェクトではなく環境を変更してください：ネットワークアクセス、API 認証情報を追加、セットアップスクリプト を参照してください。

スキル、プラグイン、コネクタ、ツールをスレッドに取得する

スレッドはクラウドセッションであるため、マシンにのみインストールされているスキル、MCP サーバー、プラグイン、ツールを持っていません。これらのそれぞれをスレッドで利用可能にするには：

• スキル、サブエージェント、コマンド：プロジェクトに追加したリポジトリにコミットします。例えば、.claude/skills/<skill-name>/SKILL.md のスキル。各スレッドはプロジェクト内のすべてのリポジトリをクローンし、それぞれから .claude/skills/、.claude/agents/、.claude/commands/ を読み込むため、1 つのリポジトリにコミットされたスキルはすべての新しいスレッドで利用可能です。スレッドは、Claude.ai アカウントで有効化したスキルも読み込みます。
• プラグイン：プロジェクト設定 > プラグイン で追加します。各新しいスレッドに読み込まれます。リポジトリが .claude/settings.json で宣言するプラグインは、スレッドがクラウドセッションであるため、スレッドに読み込まれません。
• MCP サーバー：スレッドは、Claude.ai アカウントのコネクタから MCP ツールを取得します。これは、claude.ai/customize/connectors で 1 回接続する MCP サーバーか、プロジェクト設定 > 環境 の コネクタを管理 リンクを通じて接続します。すべてのスレッドは、プロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をスレッドのタスクとして送信してください。1 つのリポジトリを持つプロジェクトでは、スレッドはそのリポジトリの .mcp.json から MCP サーバーも読み込みます。コネクタが Claude Code に到達する方法 は、クラウドセッションのルールとコネクタをオフにする設定をリストしています。
• コマンドラインツールとパッケージ：環境の セットアップスクリプト にインストールします。

実行中のスレッドが claude.ai/code でどのコネクタを持っているかを確認するには、スレッドを開き、メッセージボックスの横の + メニューから コネクタ を選択します。コネクタをそこでオフにすると、そのスレッドから削除され、アカウントのデフォルトとして保存されます。そのため、新しいスレッドと claude.ai チャットは、再度オンにするまでそれなしで開始します。スレッドは、送信後のメッセージで追加または再接続したコネクタを取得します。

プロジェクト設定リファレンス

プロジェクト設定は settings.json ではなく claude.ai/code またはデスクトップアプリで変更します。プロジェクトのサイドバーメニューの Settings からまたはプロジェクトヘッダーのギアアイコンから Project settings を開きます。

設定は変更時に保存されます。目標や指示などの編集中のテキストフィールドには、そのフィールドを離れるまで Save changes と Discard が表示されます。Project settings の指示、リポジトリ、プラグイン、環境への変更は、既に実行中のスレッドではなく、新しいスレッドに到達します。

プロジェクトを一時停止、アーカイブ、削除する

3 つのコントロールはすべて Project settings > General の下部にあります。

• Pause: すべてを一度に停止します。実行中のすべてのスレッドと会話が中断され、新しいスレッドは開始されず、ルーチンは実行されず、プロジェクトは再開するまでメッセージを受け入れません。同じ場所またはプロジェクトのメッセージボックスの上のバナーで Resume をクリックします。一時停止されたスレッドはその後メッセージを送信すると続きます。
• Archive: プロジェクトをサイドバーから非表示にし、そのスレッドをアーカイブします。実行中またはプルリクエストを監視していたスレッドを停止します。プロジェクトがアーカイブされている間、プロジェクトのルーチンは実行されません。プロジェクトを戻すには、Projects ページから開き、Unarchive をクリックします。そのスレッドはセッションリストから個別にアーカイブ解除するまでアーカイブされたままです。
• Delete: プロジェクト、そのスレッド、メモリ、ファイルを永続的に削除し、プロジェクトのルーチンをオフにします。これは取り消せません。スレッドが GitHub にプッシュしたブランチとプルリクエストは影響を受けません。

使用状況とコスト

プロジェクトの使用状況は、他の Claude Code セッションと同じプラン制限にカウントされ、プロジェクト自体がその制限を超えて使用することはできません。

スレッドがプランの制限に達すると、制限がリセットされるまで待機し、制限がリセットされると自動的に続行されるため、実行中のまま残した作業は、メッセージなしで次の使用期間を使用し始めます。スレッドが使用制限に達したでは、表示される内容、停止方法、および待機しない 1 つのケースについて説明しています。

作業がプランの制限を超えるのは、アカウントで使用クレジットをオンにしている場合のみです。スレッドがあなたのためにそれをオンにすることはできません。

プランに対して何が消費されるか

プロジェクトは単一のセッションよりも速くプランの制限を消費し、特に Pro プランでは、プロジェクトを実行する日には制限に到達するのが早くなることが予想されます。プロジェクトのプランを使用する部分は以下の通りです。

• 実行中のスレッド: それぞれが完全なセッションであり、複数が同時に実行できます。固定数はなく、Claude は作業が必要とする数だけスレッドを開始し、要求する制限は上限ではなく優先度です。実施される制限は、プロジェクト全体で 1 日あたり 200 個の新しいスレッドです。
• 会話: Claude はスレッドが報告する内容を読み、次に何をするかを決定するために独自のトークンを使用します。
• プルリクエストを監視しているスレッド: CI が失敗するか、プルリクエストにレビューコメントが到着すると、アイドル状態のスレッドが起動し、プランを再度使用します。これを停止するには、スレッドでプルリクエストの監視を停止するよう要求してください。

実行中のスレッドがなく、監視されているプルリクエストがなく、新しいメッセージがないプロジェクトは、アイドル状態で待機している間はプランを使用しません。アーカイブされたプロジェクトも同様です。

プロジェクトの使用状況を確認して削減する

プロジェクト設定で使用状況を開くと、スレッド別およびモデル別のトークン使用状況、およびプロジェクト会話に使用された量を確認できます。削減するには、以下の方法があります。

• キャッシュ有効期間より長くアイドル状態にあったスレッドにルーティングされたフォローアップは、Pro および Max ではプランの制限内で 1 時間であり、何かを実行する前にそのスレッドの会話全体を再度読み込みます。新しい作業の場合、Claude に新しいスレッドを開始するよう要求すると、大きな古いスレッドを復活させるよりも少ないトークンを使用できます。
• 最大のモデルを必要としない作業の場合、スレッド、会話、またはその両方に対してより小さいモデルまたはより低い努力レベルを選択してください。
• プロジェクト会話で Claude に、一度に実行するスレッド数を減らすか、スレッドを開始する代わりに小さな質問に自分で答えるよう要求してください。

プロジェクトが他の Claude Code 機能とどのように関連するか

複数の Claude Code 機能により、複数のセッションが同時に機能できるため、並列で作業を実行することはプロジェクトの目的ではありません。プロジェクトでは、Claude はセッションを開始および追跡し、各セッションは同じリポジトリ、指示、メモリから開始し、作業はそれが続く限りクラウドに存在します。これは各隣接機能がプロジェクトにどのように接続するかです。

• Claude Tag: Claude Tag はチームの Slack チャネルの Claude です。Team および Enterprise プランで。チャネル内の誰でもそれに作業を与え、チャネル内の誰もがそれを見て操舵でき、管理者がそのチャネルのために設定した接続を使用します。プロジェクトはあなただけのものです。あなたのみがそれに作業を送信するか、そのスレッドを見ます。独自の GitHub アクセスとコネクタを使用し、Pro および Max にあります。Claude Tag が Cowork および Claude Code とどのように異なるか は並べて比較があります。
• クラウドセッション: すべてのスレッドは クラウドセッション です。あなたではなく Claude によって開始および追跡されます。自分で開始したクラウドセッションは Continue as a project または Move to project を通じてプロジェクトになるか、プロジェクトに供給できます。
• ルーチン: プロジェクトでスケジュール作業を要求する場合、Claude は ルーチン を作成します。そのプロジェクトのスレッドとして実行され、その Routines タブに表示されます。プロジェクト外で作成するルーチンは独自に機能し続けます。
• ローカルセッションとエージェントビュー: ターミナル、IDE、またはデスクトップアプリのローカル環境のセッションはマシンで実行され、プロジェクトの一部にはなりません。エージェントビュー はそれらのローカルセッションの複数を追跡するための画面です。コーディネーターはありません。
• Worktrees: worktree は各ローカルセッションにリポジトリの独自の作業コピーを提供し、マシン上の並列セッションが互いに上書きしません。スレッドはそれらを必要としません。各スレッドはリポジトリをクローンして独自のクラウドサンドボックスに入れ、独自のブランチで機能します。
• エージェントチーム: エージェントチーム は 1 つのセッションです。マシンまたはクラウドセッション内のチームメイトセッションを 1 つのタスクのために開始し、そのタスクで終了します。
• claude.ai チャットおよび Cowork のプロジェクト: 以前のプロジェクト体験 は会話と参照ファイルをグループ化します。スレッドまたはコーディネーターなし。これらのプロジェクトは、再設計された体験がそれらに到達するまで、今日のように機能し続けます。

エージェントを並列実行する はこれらのオプションを並べて比較します。

制限事項

• プロジェクトは claude.ai/code、デスクトップアプリ、Claude モバイルアプリで利用可能です。ターミナル CLI、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。CLI の claude project コマンドはディレクトリの Claude Code ローカル状態を管理するもので、関連がありません。
• プロジェクトスレッドは クラウドセッション です。Anthropic がモデルプロバイダーです。セキュリティ および データ使用 はクラウドセッションがどのように分離され、何が保持されるかをカバーしています。
• ローカルセッションはプロジェクトの一部にはなりません。
• スレッドのサンドボックスはターン間で一時停止し、スレッドが続くときに再開されます。サンドボックスを再開できない場合、スレッドは新しいクローンから続きます。コミットされていない変更は失われる可能性があります。長いタスクでは、Claude にコミットしてプログレス作業をプッシュするよう求めてください。
• プロジェクトは 1 人のユーザーに属します。プロジェクトまたはそのスレッドを別のユーザーと共有することはできず、スレッドトランスクリプトは他のクラウドセッションが持つ共有オプションを持ちません。ベータ中、プロジェクトの組織レベルコントロールはありません。
• スレッドはそれを開始した 1 つのプロジェクトに属します。スレッドを別のプロジェクトに移動またはコピーすることはできず、それを単独で移動することはできません。Move to project は別の方向のみです。クラウドセッションの作業をプロジェクトに持ち込みます。

トラブルシューティング

新規プロジェクトダイアログの GitHub セットアップ プロンプトについては、GitHub アクセスのセットアップを参照してください。

スレッドがハングしているように見える

Claude は、スレッドが実行する各ステップを投稿しないため、プロジェクト会話に新しいメッセージがない実行中として表示されるスレッドは、通常、まだ動作しています。新しいスレッドは、Claude が開始する前に、そのクラウド環境もプロビジョニングするため、最初の更新には少し時間がかかります。スレッドを開いて、そのトランスクリプトを読んでください。スレッドが権限プロンプトを待機している場合は、そこで応答してください。

スレッドが尋ねる代わりに推測または停止した

複数のスレッドが間違った仮定をしたり、アクセスの欠落を回避したり、「ブロック」で停止して戻ってきた場合、原因は通常、各タスクの問題ではなく、プロジェクトのセットアップの同じギャップです。何かを修正する前に、どのスレッドが正常であるかを確認してください。

1. 会話で Claude に「すべてのオープン スレッドについて、それを何をするよう求めたか、何を仮定したか、または到達できなかったか、そして何を待機しているかをリストアップしてください」と尋ねます。Claude は各スレッドを読み、会話で応答します。
2. 間違った仮定から開始したスレッドについては、概要からスレッドを開き、そのメニューから解決済みとしてマークするか、メッセージ ボックスで代わりに何をするかを指示します。そのブランチと任意のプル リクエストは、削除するまで GitHub に残ります。
3. プロジェクト指示または環境でギャップを 1 回修正してから、残りの作業を新しいスレッドとして再度送信する前に、1 つのスレッドを送信します。

Claude が応答していない

Claude が実行中だが、その返信がプロジェクトに到達していない場合、プロジェクト会話に「Claude が応答していません」バナーが表示されます。バナーのClaude を再起動をクリックするか、プロジェクト設定 > 一般に移動して、Claude を再起動行の再起動をクリックします。Claude は会話に再接続します。書き込み中だった返信は失われ、スレッドは影響を受けません。

リポジトリ アクセス エラー

3 つのメッセージは、スレッドまたはプロジェクトがそのリポジトリの 1 つに到達できないことを意味します。プロジェクト スレッドは、他のクラウド セッションが同じリポジトリを問題なく複製する場合でも、GitHub の前提条件が必要です。

• **「セッションを開始できませんでした — Claude はこのプロジェクトのリポジトリへの GitHub アクセス権がありません」**は、Claude GitHub App がそのリポジトリにインストールされていない場合、一時停止されている場合、または接続した GitHub アカウントにリンクされていない場合、スレッドが開始される前に報告されます。
• **「リポジトリにアクセスできません」**は、複製が失敗したときにスレッドによって報告されます。GitHub が複製を拒否した場合、リポジトリがプロジェクトが持つ名前の下で見つからなかった場合、またはスレッドが開始するよう求められたブランチが存在しない場合です。
• 「Claude がアクセスできません」リポジトリは、新規プロジェクトダイアログまたはプロジェクト設定でリポジトリを保存するときに表示されます。メッセージは、インストール リンクと再接続リンクで続きます。Claude GitHub App がそのリポジトリにない場合はインストール リンクを使用し、ある場合は再接続リンクを使用します。GitHub App は GitHub にインストールされていても、Claude に接続したアカウントにリンクされていない可能性があるためです。メッセージが GitHub App が一時停止されているか、このリポジトリを含まないと言っている場合は、そのリンクをたどって GitHub でそれを修正してください。

これらのいずれかを修正するには、メッセージが提供するボタン（GitHub App をインストールまたはGitHub で リポジトリを選択など）をクリックしてから、再度確認をクリックします。ブロックが GitHub 組織側にある場合（アプリを承認していないオーナーや Claude を除外する IP 許可リストなど）、メッセージは代わりに修正方法を確認リンクを表示します。ボタンがない場合は、GitHub アクセスのセットアップに従い、別のメッセージを送信して再試行してください。

スレッドが使用制限に達した

スレッドまたはプロジェクト会話がプランの 5 時間または週間制限に達すると、自動的に再試行を続け、制限がリセットされると続行されます。待機中、スレッドは「Claude はまだ再試行中で、自動的に続行されます」というサービスがビジー状態ですを表示します。作業を続行するために何もする必要はありません。次の使用ウィンドウを使用しないようにしたい場合は、スレッドの停止をクリックするか、プロジェクトを一時停止してすべてのスレッドを保留にします。ルーチンが開始したスレッドは待機しません。そのターンは制限エラーで停止し、制限がリセットされた後にメッセージを送信します。

使用制限エラーは、制限と制限がリセットされるタイミングを説明しています。

追加の使用クレジットが必要です

スレッドまたはプロジェクト会話が、プランが使用クレジットでのみカバーするリクエスト（プランに含まれていないモデルまたはコンテキスト サイズへのリクエストなど）を行い、使用クレジットがアカウントに対して有効になっていません。サブスクリプションに使用クレジットを追加は、各プランでそれらを有効にするか購入できるユーザーをカバーしています。クレジットが利用可能になったら、別のメッセージを送信して再試行してください。

その他のメッセージ

これらのメッセージは、独自の原因に名前を付けます。テーブルは、各メッセージの次のステップを示しています。

関連リソース

• クラウドで Claude Code を使用する: 各スレッドの背後にあるクラウドセッションがどのように機能するか。GitHub アクセスオプションと自動修正を含む
• クラウド環境を設定する: スレッドがネットワークで到達できるもの、環境変数と API 認証情報を提供し、セットアップスクリプトでツールをインストール
• ルーチンで作業を自動化する: スケジュール、トリガー、ルーチンの管理。Claude がプロジェクトから作成するものを含む
• エージェントビューで複数のエージェントを管理する: 作業がマシンのみが到達できるツールまたはサービスが必要な場合、マシンで複数のセッションを実行および追跡します
• プロジェクトの再設計: フォルダから会話へ: ローンチアナウンスメント。プロジェクトを Claude との会話にすることの背景にある考え方を含む