Projects は Pro、Max、Ultra プランでパブリックベータ版として提供されており、段階的にロールアウト中です。ロールアウトは、クラウドセッション を使用したことがあり、claude.ai チャットまたは Cowork に既存のプロジェクトがないアカウントから開始されました。Team または Enterprise プランではまだ利用できません。claude.ai/code のサイドバーまたは デスクトップアプリ の Code タブに Projects が表示されない場合は、そこにある More の下を確認してください。そこにもない場合は、ロールアウトがまだアカウントに到達していません。ウェイトリストに参加 できます。また、その間に利用できるものについては エージェントを並列実行する を参照してください。
- 作業を 1 つの場所に送信する: バグレポート、スタックトレース、またはタスクのリストが発生するたびに会話に貼り付けます。Claude は各作業のスレッドを開始するか、その領域で既に作業しているスレッドに渡し、その場で簡単な質問に答えます。
- コンテキストを 1 回設定する: すべての新しいスレッドはプロジェクトの指示で開始されるため、対象ブランチなどの 1 回述べたルールがすべてのスレッドに到達します。
- 立ち去って完了した作業に戻る: 1 時間後または翌朝に戻ると、Overview ペインに完了したスレッド、レビュー準備ができたプルリクエスト、回答を待っているスレッドが表示されます。
プロジェクトを使用する場合
プロジェクトは、作業に 1 つのセッションを超えて続く目標があり、タスクを生成し続ける場合に作成する価値があります。これらの種類の作業はプロジェクトに適しています。- 多くのリポジトリにまたがる 1 つの目標: 「すべてのサービスを新しい lint 設定に対応させる」。Claude はリポジトリごとに 1 つのスレッドを実行でき、各スレッドは独自のプルリクエストを持ち、Overview ペイン にはどのスレッドがレビュー準備ができているかが表示されます。
- 継続的に供給する領域: 1 つのサービスのバグ、スタックトレース、レビューリクエストが到達するたびに会話に貼り付けられます。1 つの修正後に Claude に覚えておくよう指示した落とし穴は、次のために プロジェクトメモリ に含まれます。
- セッションより大きいビルドまたはマイグレーション: 「
docs/spec.mdが説明していることをビルドする」または「アプリを非推奨の ORM から移動する」。作業は各部分を取得するスレッドに分割され、Claude に早期に覚えておくよう求めた決定は後のスレッドに到達し、ビルド中に見つかった仕様の変更とバグが同じ会話に入ります。 - コードではない作業: 「これらのチケットで最も一般的な 10 の統合ミスを見つける」など、新しい質問で何度も戻ってくる契約フォルダまたはサポートチケットエクスポート。リポジトリを追加する代わりにドキュメントをアップロードし、スレッドはプロジェクトの Library タブ にファイルとして各レポートを配信します。
別のものがより適切な場合
プロジェクトはまだ一部のタスクのみがマシンを必要とする場合に適しています。Cloud スレッドは GitHub リポジトリおよびプロジェクトにアップロードしたファイル、フォルダ、Google Drive フォルダで機能し、マシンを必要とする場合があるタスクについては、Claude に そのタスクのスレッドをコンピュータで実行 するよう求めることができます。これらの場合は別のものがより適切です。- セッションに収まる 1 つのタスク: 「不安定なログインテストを修正する」。クラウドセッション を自分で開始します。
- すべてのタスクがマシンを必要とする作業: ローカルデータベース、デバイスエミュレータ、または VPN の背後にある API。ローカルセッションを使用するか、エージェントビュー を使用して複数を同時に実行します。作業がローカルファイルのみを必要とする場合は、代わりにプロジェクトにアップロードしてください。
- スケジュールで繰り返される 1 つのタスク、その周りに会話がない: 「毎週月曜日に依存関係レポートを投稿する」。クラウドスケジュールタスク を単独で作成します。
- 複数の人が Claude に作業を与え、Slack チャネルで一緒に操舵する: Claude Tag を参照してください。
プロジェクトの構成方法
プロジェクトは Claude との 1 つの調整会話と、それが作業を行うために開始するスレッドです。これらはその部分です。- プロジェクト会話: Claude がコーディネーターとして機能する 1 つの長時間実行セッション。送信したものを取得し、何がスレッドになるかを決定し、開始したすべてのスレッドを追跡します。スレッドが報告する内容を確認し、実行するすべてのステップは確認しません。
- スレッド: ワーカー。各スレッドは独自のコンテキストウィンドウを持つ個別のセッションで、1 つの作業を実行し、完了時に会話に報告します。クラウドスレッドは独自のブランチで作業し、作業が必要な場合はプルリクエストを開きます。
- すべてのクラウドスレッドが開始時に持つもの:
- プロジェクトのリポジトリとファイル、およびその 指示とメモリ
- プロジェクトの各リポジトリ にある
CLAUDE.md。ただし、リポジトリのスキル、.claude/settings.json、.mcp.jsonは含まれません - claude.ai アカウントの コネクタ
- ネットワークアクセス、環境変数、ネットワークシークレット、インストール済みツールを設定する クラウド環境
- Overview ペイン: すべてのスレッドを一度に確認 でき、どのスレッドが必要かを確認できる場所。その他のタブは、追加したファイルとスレッドが生成したファイルの Library、スレッドが開いたプルリクエストの Pull requests、プロジェクト内のスケジュールされた作業の Scheduled tasks です。
プロジェクトを作成する
プロジェクトは claude.ai/code、デスクトップアプリの Code タブ、または iOS と Android 向けの Claude モバイルアプリで作成および使用します。ブラウザとデスクトップアプリでは、プロジェクトを開始する 2 つの方法があります。- ゼロから開始:Claude に実行させたい作業の流れが決まっている場合は、New project ダイアログを開いて名前を付けます。ゼロからプロジェクトを開始するでダイアログの手順を説明しています。
- 既に作業を行っているクラウドセッションから開始:そのセッションのサイドバーメニューで Continue in project を選択し、次に Continue as new project を選択します。Claude がセッションで行っていた内容からプロジェクトのセットアップを提案します。既存のクラウドセッションから開始するを参照してください。
前提条件を確認する
プロジェクトを作成する前に、プランと GitHub のセットアップ、および作業が到達する必要があるものを確認してください。- プラン:Pro、Max、または Ultra プランを利用しており、サイドバーに Projects が直接または More の下に表示されている。Projects を選択し、New project または Get started が表示されることを確認してください。
- 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 ダイアログを開き、作業の流れに名前を付け、オプションでゴールと作業対象のリポジトリおよびファイルを指定することを意味します。必須なのは名前だけなので、プロジェクトを最初に作成してから、作業が進むにつれて残りを入力できます。1
Projects を開く
claude.ai/code またはデスクトップアプリの Code タブで、左側のサイドバー、またはその More の下から Projects を選択します。ブラウザでは claude.ai/code/projects/browse に直接移動することもできます。次に New project を選択します。ボタンが Get started と表示されている場合は、それを選択し、まず一覧に表示される既存の claude.ai プロジェクトをアップグレードまたはアーカイブしてください。
2
New project ダイアログに入力する
プロジェクトを 1 つの作業の流れにスコープします。これは、1 つの API をレイテンシ目標の下に保つために必要なすべてのことなど、継続的に追加していくものです。プロジェクトを使用する場合にさらに多くの例があります。次に、ダイアログのフィールドに入力します。
- 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 をクリックして残りを追加するか、推奨事項を無視して自分で作業を説明します。
既存のセッションから開始する
自分で開始したクラウドセッションがプロジェクトに属する作業を行っている場合は、そのセッションのサイドバーメニューを開いて Continue in project を選択し、サブメニューから選択します。- Continue as new project を選択すると、セッションから新しいプロジェクトを作成します。プロジェクトが開き、Claude がセッションを読み取って、確認用の Setup recommendations をプロジェクトの会話に投稿します。元のセッションはセッションリストに残ります。ターンの途中だった場合は実行を続けるため、両方が同時に作業するのを望まない場合は自分で停止してください。
- 既存のプロジェクトのいずれかを選択すると、セッションの作業をそのプロジェクトに持ち込みます。そのプロジェクトが開き、ユーザーに代わって送信されたメッセージが、セッションを読み取って中断したところから再開するよう Claude に求めます。元のセッションはセッションリストに変更されずに残ります。
- セッションがまだ接続されていない場合は、そのセッションで
/remote-controlを実行します。この設定がオンの間に接続した場合は、まず切断してから再接続してください。 - ブラウザで claude.ai/code のサイドバーにあるセッションの行を見つけ、そのメニューを開いて、同じサブメニューから選択します。
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 に表示されません。
プロジェクトで作業する
プロジェクト会話を通じて Claude に作業を与えます。一度に 1 つのタスク、または複数のタスクを同時に、さらに更新や思いついたことを送信します。Claude は各メッセージをルーティングし、スレッドが作業を実行して報告します。最初のバッチ
プロジェクトに新しい作業バッチを送信する前に、最初のスレッドが希望する方法で戻ってくるようにセットアップします。- プロジェクト指示を書く:すべてのスレッドが開始する簡潔な指示。対象とするブランチ、スレッドが作業をチェックする方法、あなたの承認が必要なものなどが含まれます。
- 実際の作業の小さな部分を 1 つ送信するか、Claude が提案したスレッドの 1 つを開始し、スレッドが完了したときにスレッドを開いて、どのように報告し、ブランチで何を実行したかを確認します。間違った仮定をしたか、必要なものに到達できなかった場合は、スレッドが尋ねる代わりに推測または停止したで修正する場所をカバーしています。
- プロジェクト設定 > 一般でスレッドモデルとスレッド努力を確認します。新しいプロジェクトはすべてのスレッドを Opus で高努力で実行します。これはあなたのプランを最も速く消費します。モデルを選択して Claude にコンテキストを管理させるは代替案をカバーしています。
- Claude にスレッドを開始する前に提案し、一度に数個実行することを求め、数個のスレッドが希望する方法で戻ってきたら、それらの制限を削除します。
作業を送信して結果を読む
Claude は会話で送信する各メッセージがどこに行くかを決定します。- 簡単な質問は通常、会話で答えが得られます。
- 新しい作業は新しいスレッドまたはその領域で既に作業しているスレッドに送られ、Claude はどちらかを教えてくれます。新しい各スレッドはあなたのメッセージの下にカードとして表示されます。スレッドのタイトルとステータスを含むボックスで、クリックしてスレッドを開きます。
- 1 つのメッセージ内の複数の関連のないタスクは、別々のスレッドになります。
スレッドのプルリクエストをレビューする
クラウドスレッドがコードを変更する場合、別途指示しない限り、これが実行されます。- ブランチ:リポジトリのデフォルトブランチから開始された新しいブランチで作業します。
- プルリクエスト:あなたが要求したときに開き、バグ修正または別の具体的な変更のために自動的に開くことができます。
- 開いた後:自動修正をオンにしてプルリクエストを監視します。他のクラウドセッションで自動修正がオンかどうかに関わらず。CI が失敗したときに修正をプッシュし、レビューコメントに対処し、チェックが成功してプルリクエストがあなたの準備ができたときにスレッドで返信します。
- 競合を解決、CI を修正、コメントに対処、およびマージするは、その指示をあなたからのメッセージとしてスレッドに送信します。プルリクエストに反応するのを待つ代わりに、スレッド自体にプロンプトを出すことができます。
- PR をレビューは GitHub でプルリクエストを開きます。
- PR を作成は、アイドル状態のスレッドがブランチをプッシュしたが、プルリクエストを開いていない場合に表示されます。クリックすると、スレッドに開くように指示を送信するのではなく、そのブランチから直接プルリクエストを作成します。
概要で必要なものを確認する
会話の横の概要ペインは、プロジェクトのスレッドを追跡します。新しいプロジェクトを初めて開いたときは既に開いています。プロジェクトヘッダーの概要ボタンはそれを閉じて再度開き、スレッドがあなたを待っているときにドットを表示します。 デスクトップアプリでは、Claude が会話に投稿したとき、スレッドがエラーに達したとき、またはスレッドがあなたの入力を必要とするときにデスクトップ通知も取得します。プロジェクトを開いたままにしておく必要はありません。スレッドが各ターンを完了するたびに 1 つ取得するか、プロジェクトの通知をオフにするには、プロジェクトのサイドバーメニューで通知を選択します。これらの通知はデスクトップのみです。ブラウザでは、概要ボタンのドットを確認してください。 ペインのスレッドタブはスレッドを状態でグループ化します。
ペインの他のタブは次のとおりです。
- ライブラリ:追加したファイルとフォルダ、およびスレッドが生成したファイル
- プルリクエスト:スレッドがプルリクエストを開くと表示されます
- スケジュールタスク:このプロジェクトから Claude が設定したクラウドスケジュールタスク
コントロールが必要なときにスレッドを開く
会話でスレッドのカードをクリックするか、概要でその行をクリックして、概要ペインでそのトランスクリプトを開きます。そこから以下を実行できます。- Claude が何をしたかをステップバイステップで読みます。
- スレッド独自のメッセージボックスに書き込んでタスクを操舵します。そこのメッセージはそのスレッドに直接送られ、プロジェクト会話でのフォローアップは Claude がフォローアップをそのスレッドと一致させるときにのみそれに到達します。
- スレッドが待機している権限プロンプトに答えます。
- 停止でスレッドを中断します。これはスレッドが作業中に送信ボタンを置き換えるか、Esc を押します。
モデルを選択して Claude にコンテキストを管理させる
プロジェクト設定 > 一般でモデルと努力を設定します。新しいプロジェクトはすべての場所で Opus を実行し、スレッドの高努力と会話の低努力を実行します。- スレッドモデルとスレッド努力はスレッドに適用されます。1 つのタスクに別のモデルを使用するには、タスクで要求します。既に実行中のスレッドの場合は、そのスレッドのモデルピッカーを使用します。
- コーディネーターモデルとコーディネーター努力は、プロジェクト会話で Claude に適用されます。
Claude がプロジェクトを実行する方法を調整する
会話で Claude に、一度に実行するスレッド数、更新を投稿するタイミング、プルリクエストを開くタイミングを伝えます。Claude がコーディネートしている方法が希望と異なる場合は、そう言ってください。たとえば、以下のように言うことができます。- 「スレッドを提案し、開始する前に私の承認を待ってください」または「これらを今すぐ開始してください。確認を求めないでください」
- 「一度に最大 2 つのスレッドを実行してください」または「同じ領域でのフォローアップに既存のスレッドを再利用してください」
- 「より短い更新を投稿してください」または「何かが完了またはブロックされたときのみ投稿してください」
- 「すべてのスレッドのステータス更新をください」
- 「このタスクをより小さいモデルで実行してください」
- 「計画を見るまでプルリクエストを開かないでください」
- 「これらのリポジトリで何が間違っているかを教えてください。まだ何も修正しないでください」。スレッドになる前に調査結果を確認したい場合
- 「代わりにここで答えてください」。Claude が簡単な質問として意図したものに対してスレッドを開始する場合
承認を待機しているスレッドのブロックを解除する
スレッドはスレッドのモデルがサポートしている場合、自動モードで実行されるため、ほとんどのツール呼び出しはあなたに尋ねずに実行されます。スレッドがあなたの承認を必要とする場合、プロンプトはそのスレッド内にあり、スレッドはあなたがそこで答えるまで待機します。プロジェクト会話で Claude に先に進むように伝えることはそれに到達しません。 各承認はそのプロンプト、またはより広いオプションを選択した場合はそのスレッドの残りをカバーします。クラウドスレッドはリポジトリの.claude/settings.json から権限ルールを読み取らないため、auto モードと各スレッド内で与える承認に依存します。
コンピューターでスレッドを実行する
タスクがローカルデータベース、デバイスエミュレーター、または VPN の背後にある API など、コンピューターのみが持つものを必要とする場合、Claude にクラウドではなくコンピューターでそのタスクのスレッドを実行するよう求めます。プロジェクト会話で要求すると、スレッドはマシン上のフォルダー内の Claude Code セッションであり、Remote Controlを通じて接続されます。プロジェクトの他のスレッドはクラウドで実行し続けます。クラウドスレッドと比較して、コンピューター上のスレッドは以下のようになります。- そのマシン上のファイル、ツール、MCP サーバー、および Claude Code 設定で機能し、プロジェクトのクラウド環境ではなく、hooks と権限ルールを含む
- プロジェクトの指示で開始しますが、メモリファイルが読み込まれていない状態で
- そのコンピューターが起動していて Remote Control がオンになっている間のみ実行
1
フォルダーを接続する
タスクが必要とするフォルダーを持つコンピューター上で、次の 2 つの方法のいずれかで Remote Control を通じて利用可能にします。どちらも、そのコンピューター上の Claude Code v2.1.280 以降が必要です。
- Claude デスクトップアプリで:設定 > Code または 設定 > Claude Code を開き、このコンピューターを電話と claude.ai から使用するをオンにします。そのスイッチの下のリストにフォルダーを追加します。アプリが開いている間、スレッドはこのコンピューター上で実行できます。
- ターミナルで:フォルダーで
claude remote-controlを実行し、実行したままにします。Git リポジトリでは、--spawn worktreeを追加して、各スレッドにフォルダー自体ではなく独自の worktree を与えます。
2
「ローカルで作業」でタスクを要求する
プロジェクト会話で、メッセージボックスの横の**+メニューからローカルで作業を選択します。これはメッセージにローカル**タグを付け、実行したい内容を書きます。メッセージでタスクがコンピューター上で実行されるべきであると言うことも機能します。
3
カードで許可する
Claude はデバイス上のフォルダーで作業することを Claude に許可するカードで応答します。複数のフォルダーを接続した場合はフォルダーを選択します。1 つのフォルダーで同時に 2 つのスレッドが作業している場合、互いの変更を上書きする可能性があるため、フォルダーが Git リポジトリの場合、フォルダーのオプションでWorktreeをオンにして、このスレッドに独自の worktree を与えることができます。次に1 回許可するをクリックします。
claude remote-control が終了すると停止します。
- スレッドを再開するには:フォルダーとの接続を失ったを参照してください
- コンピューターが自動的にスリープ状態になるのを防ぐには:デスクトップアプリで、設定 > Code または 設定 > Claude Code のRemote Control のためにこのコンピューターを起動したままにするをオンにします
プロジェクトに常時コンテキストを付与する
プロジェクトメモリ、プロジェクト指示、およびプロジェクトのリポジトリ、ファイル、環境は、スレッド全体でコンテキストを保持します。各項目を 1 回設定すると、すべての新しいスレッドに適用されます。
プロジェクト設定 > メモリ は、これらのファイルを 自動メモリ の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する 自動メモリ とは別です。両方とも
MEMORY.md インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の CLAUDE.md ファイルとは別です。各クラウドスレッドは開始時にクローンからこれらの CLAUDE.md ファイルを読み込むため、リポジトリに関する指示をその CLAUDE.md に、プロジェクトに関するメモをプロジェクトメモリに記載してください。
プロジェクト指示を書く
プロジェクト指示は、各新しいスレッドが開始する際の指示書です。プロジェクトヘッダーのギアアイコンをクリックして プロジェクト設定 を開き、メモリ > プロジェクト指示 に移動します。有用な指示書には以下が含まれます:- プロジェクトの目的
- 作業が行われる場所:どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法
- スレッドが作業完了と判断する前に自分の作業をチェックする方法
- 必要なものが見つからない場合の対応方法
- あなたの承認が必要な事項
CLAUDE.md に属します。このファイルは、リポジトリがプロジェクトの一部である場合、すべてのクラウドスレッドが開始時に読み込みます。作業が進行中の場合、スレッドを修正するときは、Claude にその修正を記憶するよう依頼してください。修正は プロジェクトメモリ に記録され、後のクラウドスレッドはそれを使用して開始します。
追加するリポジトリを決定する
プロジェクトに追加したリポジトリは、すべてのクラウドスレッドでそのコードとCLAUDE.md を提供しますが、スキル、.claude/settings.json、.mcp.json は提供しません。追加していないリポジトリにもアクセスできます:クラウドスレッドは、タスクで必要になったときに自分自身にリポジトリを追加できます。ほとんどのプロジェクトは両方を使用します:
- プロジェクトに追加します。新規プロジェクト ダイアログ、プロジェクト設定 > 環境、または会話内で Claude にプロジェクトへの追加を依頼します。その後のすべてのクラウドスレッドは、タスクがそれに触れるかどうかに関わらず、それをクローンし、
CLAUDE.mdを読み込んだ状態で開始します。 - プロジェクトには追加せず、必要な場合にスレッドに追加させます。 タスクがプロジェクトにないリポジトリを必要とするクラウドスレッドは、自分自身にそれを追加でき、スレッド内のメモはそれがこのスレッドのみに追加されたことを示します。クローンはタスクの途中で行われるため、スレッド開始時にはそのリポジトリの
CLAUDE.mdは存在しませんでした。次のスレッドはそれなしで開始します。この方法で追加するリポジトリには、プロジェクトリポジトリと同じ 前提条件 が必要です:リポジトリに Claude GitHub App がインストールされていることと、GitHub アカウントからのプッシュアクセスです。
ファイルとフォルダを追加する
新規プロジェクト ダイアログの コンテキスト フィールド、または後で 概要 の ライブラリ タブの 追加 を使用して、スレッドに読み込ませたいファイルとフォルダを追加します。追加するものに適用される制限は以下の通りです:- ライブラリタブ:1 回の選択で最大 100 ファイル、2 GB、単一ファイルは最大 480 MB。
- 新規プロジェクトダイアログ:30 MB を超えるファイルはスキップされるため、プロジェクト作成後に ライブラリ タブから大きなファイルを追加してください。
- フォルダ:どちらの場所からフォルダを追加する場合でも、プロジェクトは最初の 100 ファイルまで 200 MB までのコピーを受け取ります。30 MB を超えるファイル、隠しファイル、
node_modulesは含まれません。プロジェクトは最大 10 個のフォルダと Google Drive フォルダを保持でき、単一ファイルはこの制限にカウントされません。 - アップロード後の変更:アップロードはコピーであるため、その後コンピュータで行った変更は、ファイルを再度アップロードして既存の名前について 置換 を選択するまで、プロジェクトに到達しません。
スレッドがリポジトリから取得するもの
プロジェクトのリポジトリが 1 つでも複数でも、クラウドスレッドは各リポジトリのCLAUDE.md の指示を読み込みますが、スキル、.mcp.json のサーバー、.claude/settings.json は読み込みません。
スレッドの環境を選択する
すべての新しいクラウドスレッドはプロジェクトの クラウド環境 で開始します。環境は、スレッドが到達できるドメイン、スレッドが持つ環境変数、リクエストに追加されるネットワークシークレット、Claude が開始する前にセットアップスクリプトがインストールするものを設定します。クラウドスレッドは、プロジェクト設定 > 環境 で選択するまで、デフォルトの Anthropic ホスト環境を使用します。 クラウドスレッドが内部 API またはプライベートパッケージレジストリに到達する必要がある場合、またはマシンが通常保持するトークンが必要な場合は、プロジェクトではなく環境を変更してください:ネットワークアクセス、ネットワークシークレットを追加、セットアップスクリプト を参照してください。スキル、プラグイン、コネクタ、ツールをスレッドに取得する
クラウドスレッドはマシンにのみインストールされているスキル、MCP サーバー、プラグイン、ツールを持っていません。Remote Control を通じてマシン上で Claude が実行するスレッドは、そこにインストールされているものを使用します。これらのそれぞれをクラウドスレッドで利用可能にするには:- スキル:claude.ai アカウントで有効化すると、クラウドスレッドは そこで有効化したスキル を読み込みます。ただし、セルフホスト環境の一部のスレッド は除きます。リポジトリの
.claude/skills/にコミットされたスキルは、クラウドスレッドでは読み込まれません。 - プラグイン:プロジェクト設定 > プラグイン で追加します。各新しいクラウドスレッドに読み込まれます。リポジトリが
.claude/settings.jsonで宣言するプラグインは、クラウドスレッドでは 読み込まれません。 - MCP サーバー:クラウドスレッドは、claude.ai アカウントのコネクタから MCP ツールを取得します。これは、claude.ai/customize/connectors で 1 回接続する MCP サーバーです。すべてのクラウドスレッドは、プロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をクラウドスレッドのタスクとして送信してください。コネクタが Claude Code に到達する方法 は、クラウドセッションのルールとコネクタをオフにする設定をリストしています。
- コマンドラインツールとパッケージ:環境の セットアップスクリプト にインストールします。
プロジェクト設定リファレンス
プロジェクト設定は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 日あたり 500 個の新しいスレッドです。
- 会話: Claude はスレッドが報告する内容を読み、次に何をするかを決定するために独自のトークンを使用します。
- プルリクエストを監視しているスレッド: CI が失敗するか、プルリクエストにレビューコメントが到着すると、アイドル状態のスレッドが起動し、プランを再度使用します。これを停止するには、スレッドでプルリクエストの監視を停止するよう要求してください。
プロジェクトの使用状況を確認して削減する
プロジェクト設定で使用状況を開くと、スレッド別およびモデル別のトークン使用状況、およびプロジェクト会話に使用された量を確認できます。削減するには、以下の方法があります。- Pro、Max、Ultra では、プランの制限内であればキャッシュ有効期間は 1 時間です。それより長くアイドル状態にあったスレッドは、フォローアップが届くと、何かを実行する前に会話全体を再度読み込みます。新しい作業の場合、Claude に新しいスレッドを開始するよう要求すると、大きな古いスレッドを復活させるよりも少ないトークンを使用できます。
- 最大のモデルを必要としない作業の場合、スレッド、会話、またはその両方に対してより小さいモデルまたはより低い努力レベルを選択してください。
- プロジェクト会話で Claude に、一度に実行するスレッド数を減らすか、スレッドを開始する代わりに小さな質問に自分で答えるよう要求してください。
プロジェクトと他の Claude Code 機能の関係
複数の Claude Code 機能により、複数のセッションを同時に実行できるため、並列で作業を実行することだけがプロジェクトの目的ではありません。プロジェクトでは、Claude があなたの代わりにセッションを開始して追跡し、各セッションは同じ指示から開始します。各隣接機能がプロジェクトにどのように接続するかは以下の通りです。- Claude Tag: Claude Tag は Team および Enterprise プランでチームの Slack チャンネルに存在する Claude です。チャンネル内の誰もが作業を割り当てることができ、チャンネル内の全員がそれを見て操作でき、管理者がそのチャンネル用に設定した接続を使用します。 プロジェクトは Pro、Max、Ultra で利用できます。プロジェクトは自分だけのものです。作業を送信したり、スレッドを見たりするのは自分だけで、自分の GitHub アクセスとコネクタを使用します。Claude Tag が Cowork および Claude Code とどのように異なるかに並べて比較があります。
- クラウドセッション: すべてのスレッドはクラウドセッションです。ただし、Claude にマシン上で実行するよう要求する場合を除きます。どちらの場合でも、Claude がユーザーに代わってそれを開始して追跡します。自分で開始したクラウドセッションの作業をプロジェクトに取り込むこともできます。そのセッションのサイドバーメニューで Continue in project を選択します。
- スケジュールタスク: プロジェクトでスケジュールされた作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その Scheduled tasks タブに表示されるクラウドスケジュールタスクを作成します。プロジェクト外で作成したスケジュールタスクは独立して動作し続けます。
- Remote Control: Remote Control は claude.ai をマシン上で実行している Claude Code セッションに接続します。プロジェクトで Claude にコンピュータ上でスレッドを実行するよう要求すると、プロジェクトは Remote Control を使用してそれを実行します。
- ローカルセッションと agent view: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトの外に留まりますが、その作業をプロジェクトに取り込むことはできます。Agent view は複数のローカルセッションを並べて追跡するための画面であり、各セッションの開始とタスクの割り当ては引き続き自分で行います。
- worktree: worktree は各ローカルセッションにリポジトリの独自の作業コピーを提供します。クラウドスレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。
- Agent teams: agent team は、マシン上またはクラウドセッション内で単一のタスク用にチームメイトセッションを開始し、そのタスクで終了する 1 つのセッションです。
- Subagents: subagent は 1 つのセッション内で実行され、独自のコンテキストウィンドウで副次的なタスクを実行し、そのセッションに概要を返します。プロジェクトのスレッドは Claude が開始し、プロジェクト会話に報告する完全なセッションであり、スレッドは独自の副次的なタスク用に subagents を使用することができます。
- Projects in claude.ai chat and Cowork: 以前の Projects エクスペリエンス。これはスレッドやコーディネーターなしで会話と参照ファイルをグループ化します。これらのプロジェクトは、再設計されたエクスペリエンスがそれらに到達するまで、今日のように動作し続けます。
制限事項
- プロジェクトは claude.ai/code、デスクトップアプリ、Claude モバイルアプリで利用可能です。ターミナル CLI、VS Code 拡張機能、JetBrains プラグイン、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。
- プロジェクトスレッドは クラウドセッション です。または Remote Control を通じてお客様のマシン上のセッションです。どちらの場合も Anthropic がモデルプロバイダーです。セキュリティ および データ使用 はクラウドセッションがどのように分離され、何が保持されるかをカバーしています。また 接続とセキュリティ はお客様のマシン上のスレッドがどのように接続され、何が保存されるかをカバーしています。
- 自分のマシン上で自分で開始したセッションをプロジェクトに追加することはできませんが、その作業をプロジェクトに持ち込む ことはできます。プロジェクトを自分のマシン上で使用するには、Remote Control を通じてそこでスレッドを実行 します。必要なものはそのセクションに記載されています。
- クラウドスレッドのサンドボックスはターン間で一時停止し、スレッドが続くときに再開されます。サンドボックスを再開できない場合、スレッドは新しいクローンから続きます。コミットされていない変更は失われる可能性があります。長いタスクでは、Claude にコミットしてプログレス作業をプッシュするよう求めてください。
- プロジェクトは 1 人のユーザーに属します。プロジェクトまたはそのスレッドを別のユーザーと共有することはできず、スレッドトランスクリプトは他のクラウドセッションが持つ共有オプションを持ちません。ベータ中、プロジェクトの組織レベルコントロールはありません。
- スレッドは、それを開始した 1 つのプロジェクトに属します。スレッドを別のプロジェクトに移動またはコピーしたり、プロジェクトから外して単独のスレッドにしたりすることはできません。Continue in project は逆方向のみに機能し、クラウドセッションの作業をプロジェクトに取り込みます。2 つのプロジェクトを 1 つにマージすることはできません。
トラブルシューティング
新規プロジェクトダイアログの GitHub セットアップ プロンプトについては、GitHub アクセスのセットアップを参照してください。スレッドがハングしているように見える
Claude は、スレッドが実行する各ステップを投稿しないため、プロジェクト会話に新しいメッセージがない実行中として表示されるスレッドは、通常、まだ動作しています。新しいクラウド スレッドは、Claude が開始する前に、そのクラウド環境もプロビジョニングするため、最初の更新には少し時間がかかります。スレッドを開いて、そのトランスクリプトを読んでください。スレッドが権限プロンプトを待機している場合は、そこで応答してください。スレッドが尋ねる代わりに推測または停止した
複数のスレッドが間違った仮定をしたり、アクセスの欠落を回避したり、「ブロック」で停止して戻ってきた場合、原因は通常、各タスクの問題ではなく、プロジェクトのセットアップの同じギャップです。何かを修正する前に、どのスレッドが正常であるかを確認してください。- 会話で Claude に「すべてのオープン スレッドについて、それを何をするよう求めたか、何を仮定したか、または到達できなかったか、そして何を待機しているかをリストアップしてください」と尋ねます。Claude は各スレッドを読み、会話で応答します。
- 間違った仮定から開始したスレッドについては、概要からスレッドを開き、そのメニューから解決済みとしてマークするか、メッセージ ボックスで代わりに何をするかを指示します。そのブランチと任意のプル リクエストは、削除するまで GitHub に残ります。
- プロジェクト指示または環境でギャップを 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 でそれを修正してください。
スレッドが使用制限に達した
スレッドまたはプロジェクト会話がプランの 5 時間または週間制限に達すると、自動的に再試行を続け、制限がリセットされると続行されます。スケジュールタスクが開始したスレッドは待機しません。そのターンは制限エラーで停止します。制限がリセットされた後に、そのスレッドにメッセージを送信してください。 待機中、スレッドは「Claude はまだ再試行中で、自動的に続行されます」というサービスがビジー状態ですを表示します。作業を続行するために何もする必要はありません。次の使用ウィンドウを使用しないようにしたい場合は、スレッドの停止をクリックするか、プロジェクトを一時停止してすべてのスレッドを保留にします。使用制限エラーは、制限と制限がリセットされるタイミングを説明しています。追加の使用クレジットが必要です
スレッドまたはプロジェクト会話が、プランが使用クレジットでのみカバーするリクエスト(プランに含まれていないモデルまたはコンテキスト サイズへのリクエストなど)を行い、使用クレジットがアカウントに対して有効になっていません。サブスクリプションに使用クレジットを追加は、各プランでそれらを有効にするか購入できるユーザーをカバーしています。クレジットが利用可能になったら、別のメッセージを送信して再試行してください。フォルダとの接続が失われました
コンピュータで実行されているスレッドは、Claude Code セッションがそこで応答しなくなったときにこれを表示します。通常、コンピュータがスリープ状態になったか、デスクトップ アプリまたはclaude remote-control が終了したためです。コンピュータをウェイクアップしてください。デスクトップ アプリまたは claude remote-control がそこで実行されなくなった場合は、再度開始してください。
- デスクトップ アプリ: アプリを再度開き、設定 > Codeまたは設定 > Claude Codeの下でこのコンピュータを携帯電話と claude.ai から使用するがまだオンになっていることを確認します
- ターミナル: 同じフォルダで
claude remote-controlを再度実行します
その他のメッセージ
これらのメッセージは、独自の原因に名前を付けます。テーブルは、各メッセージの次のステップを示しています。関連リソース
- クラウドで Claude Code を使用する: 各クラウドスレッドの背後にあるクラウドセッションがどのように機能するか、GitHub アクセスオプションとプルリクエストの自動修正を含む
- クラウド環境を設定する: クラウドスレッドがネットワーク上で到達できる範囲を変更し、環境変数とネットワークシークレットを提供し、セットアップスクリプトでツールをインストール
- スケジュールタスクで作業を自動化する: スケジュールタスクのスケジュール、トリガー、管理。Claude がプロジェクトから作成するものを含む
- エージェントビューで複数のエージェントを管理する: 作業がマシンのみが到達できるツールまたはサービスが必要な場合、マシンで複数のセッションを実行および追跡します
- プロジェクトの再設計: フォルダから会話へ: ローンチアナウンスメント。プロジェクトを Claude との会話にすることの背景にある考え方を含む