Skip to main content
Projects は Pro および Max プランで公開ベータ版であり、段階的にロールアウト中です。クラウドセッション を使用したアカウントで、claude.ai チャットまたは Cowork に既存のプロジェクトがないアカウントから始まり、段階的にロールアウト中です。Team または Enterprise プランではまだ利用できません。claude.ai/code のサイドバーまたは デスクトップアプリ の Code タブに Projects が表示されない場合、ロールアウトがまだアカウントに到達していません。その場合は ウェイトリストに参加 できます。エージェントを並列実行する で、その間に利用可能なオプションを確認してください。
プロジェクトは、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 が回答するか、スレッドを開始します。各スレッドは独自のブランチとプルリクエストで作業するクラウドセッションです。Overview ペインはスレッドを状態別にリストします。例えば、レビュー準備完了、あなたを待機中、作業中など。プロジェクトの図。プロジェクト会話に書き込み、Claude が回答するか、スレッドを開始します。各スレッドは独自のブランチとプルリクエストで作業するクラウドセッションです。Overview ペインはスレッドを状態別にリストします。例えば、レビュー準備完了、あなたを待機中、作業中など。

プロジェクトを作成する

claude.ai/code またはデスクトップアプリの Code タブでプロジェクトを作成および使用します。開始する方法は 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 コネクタ で接続済みとして表示されることを確認してください。

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

最初からプロジェクトを開始するとは、New project ダイアログを開き、作業のストリームに名前を付け、オプションで目標とそれが機能するリポジトリとファイルを提供することを意味します。名前のみが必須であるため、プロジェクトを最初に作成し、作業が進むにつれて残りを入力できます。
1

Projects を開く

claude.ai/code またはデスクトップアプリの Code タブで、左サイドバーの Projects を選択し、New project を選択します。ブラウザでは claude.ai/code/projects/browse に直接移動することもできます。
2

New project ダイアログに入力する

プロジェクトを 1 つの API をレイテンシ目標の下に保つために必要なすべてのものなど、継続的に追加する 1 つの作業ストリームにスコープします。プロジェクトを使用する場合 にはさらに多くの例があります。次に、ダイアログのフィールドに入力します。
  • Name: プロジェクトが Projects リストに表示される方法。
  • Goal (オプション): 「p95 API レイテンシを 200 ms 未満に保つ」など、達成しようとしていることの 1 行。会話の Claude はそれに向かって機能します。目標がない場合、Claude は送信するタスクから機能し、後で Project settings > General で目標を追加できます。
  • Context (オプション): このプロジェクトが機能する GitHub リポジトリ、およびスレッドが読む必要があるファイル、フォルダ、または Google Drive フォルダ。各リポジトリに Add をクリックします。ほぼすべてのタスクが必要とするリポジトリを追加し、作業が触れるすべてのリポジトリではなく、どのリポジトリを追加するかを決定する はその選択をカバーし、後で Project settings > Environment でさらに追加できます。
スレッドがどのように機能すべきかについての立ち上がりルールは プロジェクト指示 に入り、プロジェクトが存在した後に設定します。
3

プロジェクトを作成する

Create project をクリックします。プロジェクトの会話が開き、下部にメッセージボックスがあり、Claude の作業を説明します。最初のプロジェクトでは、最初にメッセージを送信しない限り、プロジェクトが作成されるとすぐに Claude が独自のターンを取ります。そのターンはプランを使用します。その中で、Claude は以下を行う可能性があります。
  • プロジェクトがリポジトリを読むことができる場合、リポジトリを探索し、次のステップを提案する 1 つのスレッドを開始します。
  • 最近のクラウドセッションから引き出された Setup recommendations を投稿します。追加するリポジトリ、作成するルーチン、開始できるスレッド。推奨されるすべてのリポジトリとルーチンはオンに切り替えられます。不要なものをオフに切り替え、Update setup をクリックして残りを追加するか、推奨事項を無視して作業を説明してください。
プロジェクトはサイドバーの 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 組織のリポジトリを追加する場合は、これらのステップに戻ります。
1

GitHub アカウントを接続する

以前に claude.ai/code を使用していない場合、最初の訪問は GitHub の接続を説明します。GitHub を接続する を参照してください。それ以外の場合は、GitHub 認証オプション のいずれかを使用してください。
2

Claude GitHub App をプロジェクトのリポジトリにインストールする

Claude GitHub App をインストールし、プロジェクトが使用するリポジトリを付与します。GitHub 組織が所有するリポジトリでは、組織の所有者のみがインストールを完了できます。所有者でない場合、GitHub は所有者にインストールリクエストを送信し、所有者が承認するまでプロジェクトはリポジトリを使用できません。
3

SSO を強制する組織の SSO を認可する

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

プロジェクトで作業する

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

最初のバッチ

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

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

Claude は会話で送信する各メッセージがどこに行くかを決定します。
  • 簡単な質問は通常、会話で回答を取得します。
  • 新しい作業は新しいスレッドまたは既にその領域で作業しているスレッドに移動し、Claude はどちらかを伝えます。各新しいスレッドはメッセージの下にカードとして表示されます。スレッドのタイトルと状態を含むボックスで、クリックしてスレッドを開きます。
  • 1 つのメッセージ内の複数の関連のないタスクは個別のスレッドになります。
Claude がメッセージを希望と異なるようにルーティングする場合は、そう言ってください。Claude がプロジェクトを実行する方法を調整する は、既存のスレッドをフォローアップに再利用するか、代わりに回答するなど、伝えることができることをリストします。 スレッドの完全な結果はスレッドに留まり、会話でそのカードを開いて読みます。スレッドが生成したファイルは OverviewLibrary タブにもあります。 時々 Claude はスレッドを開始する代わりにスレッドを提案し、Suggested threads リストに表示されます。提案の矢印をクリックしてそのスレッドを開始します。複数がリストされている場合、リストの下のボタンはすべてを開始します。

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

スレッドがコードを変更する場合、別の指示がない限り、これが行うことです。
  • Branch: リポジトリのデフォルトブランチから開始された新しいブランチで機能します。
  • Pull request: 要求時に開き、バグ修正または別の具体的な変更のために独自に開くことができます。
  • 開いた後: 他のクラウドセッションで自動修正がオンかどうかに関わらず、自動修正 をオンにしてプルリクエストを監視します。CI が失敗すると修正をプッシュし、レビューコメントに対応し、チェックが成功し、プルリクエストがレビュー準備ができたときにスレッドで返信します。
会話のスレッドのカードは、Resolve conflictsFix CIAddress comments、または Merge it など、次のステップがある場合はボタンを表示します。クリックするとその指示をスレッドにメッセージとして送信し、プルリクエストに反応するのを待つ代わりにスレッドを自分でプロンプトできます。Review PR は GitHub でプルリクエストを開きます。 スレッドがプルリクエストを開く場合、例えば要求時のみ、またはどのブランチから開始するかを変更するには、タスクまたは プロジェクト指示 で言ってください。

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

会話の横の Overview ペインはプロジェクトのスレッドを追跡します。新しいプロジェクトを最初に開くときは既に開いています。プロジェクトヘッダーの Overview ボタンはそれを閉じて再度開き、スレッドがあなたを待機中の場合はドットを表示します。 デスクトップアプリでは、Claude が会話に投稿するとき、スレッドがエラーに当たるとき、またはスレッドが入力を必要とするときにデスクトップ通知も取得するため、プロジェクトを開いたままにしてそれを見つける必要はありません。スレッドが完了するたびに 1 つを取得するか、プロジェクトのためにそれらをオフにするには、プロジェクトのサイドバーメニューで Notifications を選択します。これらの通知はデスクトップのみです。ブラウザでは、Overview ボタンのドットを確認してください。 ペインの Threads タブはスレッドを状態別にグループ化します。 ペインの他のタブは、追加したファイルとフォルダおよびスレッドが生成したファイルの Library、スレッドが開いたプルリクエストの Pull requests、このプロジェクトの ルーチンRoutines です。

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

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

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

Project settings > General でモデルと努力を設定します。新しいプロジェクトはすべての場所で Opus を実行し、スレッドの高い 努力 と会話の低い努力があります。
  • Thread modelThread effort はスレッドに適用されます。1 つのタスクに異なるモデルを使用するには、タスクで要求してください。既に実行中のスレッドの場合、そのスレッドのモデルピッカーを使用してください。
  • Coordinator modelCoordinator effort はプロジェクト会話の Claude に適用されます。
プロジェクトではコンテキストウィンドウを管理しません。スレッドは自動的にコンパクトになり、会話は完全な履歴ではなく最近のメッセージ、最近のスレッド、プロジェクトメモリから機能するため、プロジェクトが実行される限り続きます。決して削除されてはいけないものを プロジェクトメモリ に入れてください。1 つのスレッドがコンテキストを超える場合、Claude がこのターンでコンテキストを使い果たした と表示されます。

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

会話で Claude に、一度に実行するスレッド数、更新を投稿する時期、プルリクエストを開く時期を伝えます。Claude が希望しない方法で調整している場合は、そう言ってください。例えば、以下のように言うことができます。
  • 「スレッドを提案し、開始する前に承認を待つ」または「確認なしで今すぐこれらを開始する」
  • 「一度に最大 2 つのスレッドを実行する」または「同じ領域のフォローアップに既存のスレッドを再利用する」
  • 「より短い更新を投稿する」または「何かが完了またはブロックされたときのみ投稿する」
  • 「すべてのスレッドのステータス更新をください」
  • 「このタスクをより小さいモデルで実行する」
  • 「計画を見るまでプルリクエストを開かない」
  • 「これらのリポジトリで何が間違っているかを教えてください、まだ何も修正しないでください」。スレッドになる前に調査結果を確認したい場合
  • 「代わりにここで答えてください」。Claude が簡単な質問のためにスレッドを開始する場合
Claude はこれらのような設定を プロジェクトメモリ に自動的に保存し、後のスレッドで従います。これらは Claude が守る指示であり、強制設定ではないため、この方法で与えるスレッド制限はハードキャップではありません。最初からすべてのスレッドに適用され、正確に文言されたい場合は、プロジェクト指示に 1 つを追加してください。

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

スレッドはスレッドのモデルがサポートする場合、自動モード で実行されるため、ほとんどのツール呼び出しは質問なしで実行されます。スレッドが承認を必要とする場合、プロンプトはそのスレッド内にあり、スレッドはそこで答えるまで待機します。プロジェクト会話で Claude に先に進むよう伝えることはそれに到達しません。 各承認はそのプロンプト、またはより広いオプションを選択する場合はそのスレッドの残りをカバーします。すべてのスレッドが特定のコマンドを質問なしで実行できるようにするか、いくつかをブロックするには、リポジトリの .claude/settings.json権限ルール を追加してください。スレッドは 1 つのリポジトリを持つプロジェクトでのみそれらを適用します。スレッドがリポジトリから取得するもの を参照してください。

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

プロジェクトメモリ、プロジェクト指示、およびプロジェクトのリポジトリ、ファイル、環境は、スレッド全体でコンテキストを保持します。各項目を一度設定すると、すべての新しいスレッドに適用されます。 プロジェクト設定 > メモリ は、これらのファイルを 自動メモリ の下に一覧表示します。Claude がプロジェクトで作業する際に自分自身で書き込むためです。これらは Claude Code がマシン上で保持する 自動メモリ とは別です。どちらも MEMORY.md インデックスを使用していますが、別のものです。また、プロジェクトのリポジトリ内の CLAUDE.md ファイルとも別です。各スレッドは開始時にクローンからこれらの CLAUDE.md ファイルを読み込むため、リポジトリに関する指示をそのリポジトリの CLAUDE.md に記載し、プロジェクトに関するメモをプロジェクトメモリに記載してください。

プロジェクト指示を書く

プロジェクト指示は、各新しいスレッドが開始する際の指示書です。プロジェクトヘッダーのギアアイコンをクリックして プロジェクト設定 を開き、メモリ > プロジェクト指示 に移動します。有用な指示書には以下が含まれます:
  • プロジェクトの目的
  • 作業が行われる場所:どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法
  • スレッドが作業完了前に自分の作業をチェックする方法
  • 必要なものが見つからない場合の対応方法
  • あなたの承認が必要な事項
例:
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 で一度接続するか、プロジェクト設定 > 環境コネクタを管理 リンクを通じて接続する MCP サーバーです。すべてのスレッドはプロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をスレッドのタスクとして送信してください。1 つのリポジトリを持つプロジェクトでは、スレッドはそのリポジトリの .mcp.json から MCP サーバーも読み込みます。コネクタが Claude Code に到達する方法 はクラウドセッションのルールと、コネクタをオフにする設定を一覧表示します。
  • コマンドラインツールとパッケージ:環境の セットアップスクリプト にインストールします。
実行中のスレッドが claude.ai/code でどのコネクタを持っているかを確認するには、スレッドを開き、メッセージボックスの横の + メニューから コネクタ を選択します。そこでコネクタをオフにすると、そのスレッドから削除され、あなたがそれをオンに戻すまで、後で開始されたスレッドでもオフのままになります。スレッドは、あなたが追加またはオンに戻したコネクタを、次のメッセージを送信した後に取得します。

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

プロジェクト設定は settings.json ではなく claude.ai/code またはデスクトップアプリで変更します。プロジェクトのサイドバーメニューの Settings からまたはプロジェクトヘッダーのギアアイコンから Project settings を開きます。 設定は変更時に保存されます。目標や指示などの編集中のテキストフィールドには、そのフィールドを離れるまで Save changesDiscard が表示されます。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 およびデスクトップアプリで利用可能です。ターミナル 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 はまだ再試行中で、自動的に続行されます」というサービスがビジー状態ですを表示します。作業を続行するために何もする必要はありません。次の使用ウィンドウを使用しないようにしたい場合は、スレッドの停止をクリックするか、プロジェクトを一時停止してすべてのスレッドを保留にします。ルーチンが開始したスレッドは待機しません。そのターンは制限エラーで停止し、制限がリセットされた後にメッセージを送信します。 使用制限エラーは、制限と制限がリセットされるタイミングを説明しています。

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

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

その他のメッセージ

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