Claude Codeのプロジェクト機能を使ってみた——Webサイトを丸ごと作らせて分かった並列スレッドの強みと落とし穴

Claude Code の「プロジェクト」は、1本の会話の中で Claude が仕事をスレッドに切り分け、クラウドで並列に進めてくれる機能です。仕組みと使える条件はプロジェクト機能とはで整理しました。この記事はその続きで、実際に1つの Web サイトをまるごと作らせてみた記録です。

試したのは2026年9月26日から28日で、プロジェクト機能は公開ベータの段階でした（Pro・Max 向けに順次配布中。公式ドキュメント）。画面や挙動はこれから変わる可能性があります。ここに書くのは、その時点で実際に起きたことと、画面・使用量レポート・リポジトリの記録から確かめた数字です。

一言でまとめると、開発は驚くほど放っておいても進む。ただし出てくるのは完成品ではなく叩き台で、SSH でしか入れないサーバへの公開では行き詰まる、です。以下、良かった点も悪かった点も、起きた順に書きます。

1. 何を作らせたか——条件と、最初に正直に書いておくこと

題材は、ローカル LLM の「必要メモリ」を調べられるデータベースサイトです。「このモデルは自分の PC で動くか」に答えるために、Hugging Face から量子化ファイルのサイズを集め、コンテキスト長ごとの必要メモリを計算し、GPU や Mac のメモリ量から逆引きできるようにします。小さすぎず、並列に分けられる部品（データ収集・計算・ページ・逆引き・SEO）がそろっているので、プロジェクト機能の試験台に向いていました。

2. 始めるまでの手順と、つまずいた5か所

始める手順そのものは短く、デスクトップアプリの Code タブで「プロジェクト」→「新規」を選び、名前・目標・リポジトリを入れて作成するだけです。ただ、その前後で次の5か所につまずきました。

②について補足すると、作成直後の会話には「Up to $100 of initial usage, including the automatic setup, won't count towards your usage limits」という案内が出ていました。最初の利用のうち $100 分までは通常の利用枠に数えないという意味で、使用量の画面にも「プロジェクトセットアップクレジット（有効期限まで約24時間）」として表示されました。この特典は、9月28日時点で公式ドキュメントのプロジェクトのページには書かれていません。6章で実際の減り方を載せます。

環境の設定画面で迷ったのは、既存の環境を直すときです。「環境を追加」から入ると新しい環境の画面になり、最初は許可ドメインをセットアップスクリプトの欄に書いてしまいました。既存の環境は、一覧でその環境にマウスを乗せると出る歯車から編集します（公式ドキュメントの手順どおりですが、画面だけでは分かりにくい部分です）。

3. 約20時間の実録——寝ている間に何が起きたか

作成（9月26日の22時ごろ）から、最後の PR がマージされる（翌27日の17時半ごろ）までの流れです。時刻は日本時間です。

もう1つ、良くなかった点も書いておきます。データ収集の土台を作るとき、スレッドは外部サービスの回数制限の仕組みを確かめるために、Hugging Face の API へ520回続けてアクセスしていました。レビューのスレッドが「妥当ではなかった」と判定して外部 API の利用ルールを文書にし、その後のデータ収集のスレッドは作業全体で8回しかアクセスしていません。放っておくと、外部への負荷の配慮までは自分からはしないので、指示に書いておく価値があります。

4. 細かく承認させた場合と、任せた場合

1章で書いたとおり、前半は人間の承認を細かく挟む指示で動かし、27日の17時に「任せる」指示へ書き換えました。挙動ははっきり変わりました。

任せるときに気をつけたいことが2つありました。1つは、書き換えた指示は、そのとき動いているスレッドには届かないことです。配り役自身が「このスレッドは指示を書き換える前に始まったので、新しい指示が見えていません」と説明していました。もう1つは、プロジェクトのメモリに残った古いルールを、スレッドが消せなかったことです。「マージは人間だけ」という古いメモを書き換えようとした作業が、安全の確認で止められました。古いメモは、人間が設定の「メモリー」から消す必要があります。

最終的に落ち着いた指示の骨組みは、次のとおりです。

このプロジェクトは〇〇を作って運用する。
進め方は任せる：スレッドを立てる・本数・モデル・順番は配り役が決めてよい。
CI が通った PR はマージしてよい。衝突は自分で解消する。

人間に聞くのはこれだけ：
- お金がかかること（有料 API・有料サービス）
- 秘密情報（API キー・パスワード）が必要なとき
- 本番へのデプロイ・本番データの変更
- 方針が分かれて、どちらでも筋が通るとき
- 必要なものに届かないとき（推測やダミーのデータで埋めない）

外部 API は回数制限を守り、調査のために大量にアクセスしない。

ただし、このあとで分かったことを踏まえると、「CI の設定・デプロイ用のスクリプトの変更は人間が承認する」を足しておくのがおすすめです。任せたスレッドは CI の設定も変えられるため、デプロイの仕組みと組み合わせると、確認なしに本番まで変わる経路ができるからです（7章）。

5. 公開して分かった品質——テストは全部通っていた

プロジェクトで作ったものを、いつもの手元の Claude Code に引き継いで本番に出しました。出した直後の感想は「なんか普通」でした。モデルのページが1件も無かったからです。原因を追うと、並列開発ならではの穴が見えてきました。

スレッド10本、百数十件のテスト、Opus のレビュー、CI のどれも、この抜けを見つけていません。どのスレッドも、自分の担当の中では正しかったからです。端から端までを通して見る役がいないと、分担の境目に穴が開きます。

実データを入れると、さらに2つの問題が出ました。

• 量子化の表に、本体ではないファイルが混ざっていた。先読み用の補助モデル（MTP・EAGLE など）や LoRA のファイルを本体の量子化として数えていて、ある 12B のモデルの表の先頭に「Q8_0 0.47GB」という行が出ていました（本物の Q8_0 は 12.7GB）。直したところ、56リポジトリの195件が補助扱いに変わりました。
• 最新で需要の大きいモデルで、必要メモリが「計算不可」だった。作った時点の計算式は、新しい世代のアーキテクチャ（層によって記憶の持ち方が違うものなど）に対応していませんでした。サイトの一番の売りが、一番見られるページで出ない状態です。

どちらも、テストが「見本データ」だけで組まれていたので、本番にデータを入れて初めて分かりました。手元の Claude Code で直した内容と、かかった時間は次のとおりです（9月28日17時21分〜22時54分・コミット13本）。

一方で、良かった点もはっきりあります。表示は速く（主要ページは0.1秒前後）、ファイルサイズは Hugging Face の実際の値で、対応しているモデルの必要メモリは計算式と合っていました。タイトル・構造化データ・sitemap・llms.txt といった SEO の作り込みも最初から入っていました。骨格と細部はよくできていて、抜けていたのは「つなぎ目」と「実データ」、というのが総評です。

6. 使用量と料金——1.9億トークンの内訳

プロジェクトの設定の「使用量」画面には、スレッド別・モデル別のトークンが出ます。右上のボタンで、そのままテキストとしてコピーすることもできます。9月27日11時47分の時点のレポートでは、次のとおりでした。

1.9億という数字は大きく見えますが、97.7%はキャッシュの読み取りです。スレッドは操作のたびにそれまでの会話を読み直すので、1本が何百回も操作するとこの形になります。配り役の上乗せは2%で、管理のコストはわずかでした。

比較のため、「読み込んだトークン ÷ 出力したトークン」を手元の Claude Code（筆者の PC の直近3日分）と比べると、プロジェクトは約330、手元は約340でした。作業量あたりの消費は、手元のセッションとほぼ同じです。プロジェクトが重く感じるのは、並列で一気に進むので短時間に集中して減るからだと考えられます（作業の中身が違うので、目安の比較です）。

料金の面では、セットアップクレジット（$100）の減り方をたどれました。

このクレジットは、API の単価で数えた金額に近い動きをしていました。11時47分のレポートを Anthropic の公式の単価（Pricing：Sonnet 5 は入力 $2・出力 $10・キャッシュ読み取り $0.20、Opus 5.5 は入力 $4・出力 $20・キャッシュ読み取り $0.20／いずれも100万トークンあたり）で計算すると約$58〜65で、そのときの表示（78%＝$78）とおおむね合います。つまり「$100 分」は、API で払えば $100 かかる量という意味で、Max の定額プランの中ではそれほど大きな量ではありません。なお、別に配られていたクラウドセッション用のクレジット（Max は $250）は、受け取り画面に「プロジェクトは対象外」とあり、実際に1ドルも減りませんでした。

7. 本番への公開で詰まった理由

一番苦労したのは、作ったものを本番に出すところでした。公開先が SSH でしか入れない共有レンタルサーバだったためです。

• クラウドのスレッドは、本番サーバに届きません（SSH の鍵は手元の PC にしかない）。
• 手元の PC で動かすには、プロジェクトの「ローカルで作業」を使います。中身は Remote Control で、デスクトップアプリの「このコンピューターをスマートフォンや claude.ai から使用できます」をオンにする必要があります。
• ところが、この設定の対象はそれまでに Claude Code で開いたフォルダの一覧で、自動で集まります。筆者の環境では22件あり、うち1件は数十のプロジェクトを中に含む親フォルダでした。オンにしている間は、それらが遠隔から作業を始められる対象になり、フォルダ名・パス・リポジトリの URL も Anthropic に送られます。1つのフォルダだけに絞るには、ターミナルでそのフォルダに入って claude remote-control を起動する別の方法になります。

そこで、公開の方法をいくつか検討しました。

最終的には、プロジェクトはアーカイブし、作ったものは手元のいつもの Claude Code の運用に移しました。ほかのサイトと同じ公開の仕組みに乗せるほうが、新しい仕組みを増やすより安全だと判断したためです。

振り返ると、プロジェクト機能は「GitHub にマージしたら自動で公開される」ホスティングと組み合わせる前提で考えたほうがよさそうです。たとえば Vercel なら、GitHub と連携させるだけで公開まで流れるので、今回のような行き詰まりは起きません。ただし Vercel は、無料の Hobby プランが非商用に限られ、Google AdSense などの広告を載せるなら有料の Pro（月$20〜）が必要です（Fair Use Guidelines）。また、今回のような PHP と MySQL のサイトとは相性が良くありません。技術と公開先を、最初に一緒に決めておくのが大事です。

自分の PC を遠隔から操作させるときのリスクと、ふだんの Claude Code との違いは、別の記事で詳しく整理する予定です。スマホから手元のセッションを操作する使い方はRemote Control の記事で紹介しています。

8. 向いている仕事・向いていない仕事

始める前に確かめておきたいことを、今回の経験からまとめておきます。

• 公開先：GitHub にマージしたら自動で公開されるか。SSH が要るなら、サーバが取りに行く形などを先に決めておく。
• GitHub の権限：Claude GitHub App を入れる範囲。専用アカウントにするか、リポジトリを絞る。
• 任せる範囲：プロジェクト指示に、人間に聞くことだけを書く。CI とデプロイの設定の変更は承認制にする。
• ネットワーク：外部の API やサイトを使うなら、許可リストに本体のドメインとサブドメインの両方を入れる。
• 実データでの確認：見本データのテストが通っても安心しない。本番と同じデータを端から端まで流して見る役を、最後に1本立てる。
• 利用枠：スレッドの既定モデルを見直す。最初の24時間は $100 分のセットアップクレジットがある。

まとめ

プロジェクト機能は、「人間が配って、追いかけて、同じ前提を説明し直す」手間を本当に引き取ってくれる機能でした。夜のうちに3本の作業が並列で進み、スレッド同士が調整し、任せればマージや次の作業の判断まで自分でやります。作業量あたりのトークンも、手元の Claude Code と変わりませんでした。

一方で、出てくるのは叩き台です。並列に分けると、担当の境目に穴が開く。見本データのテストは全部通っていても、実データを入れると不具合が出る。そして、SSH でしか入れないサーバへの公開とは相性が悪い。使うなら、公開先を GitHub 連携のものにする、任せる範囲を最初に書く、最後に「端から端まで実データで確かめる」役を1本立てる、の3つを押さえておくと、今回のような回り道は避けられるはずです。

FAQ

Q. プロジェクトはいくらかかりますか？

A. 別料金はなく、Pro・Max の通常の利用枠から減ります。今回はそれとは別に、最初の約24時間は $100 分までを利用枠に数えない「セットアップクレジット」が付きました（画面の表示。9月28日時点で公式ドキュメントには記載なし）。スレッド10本・PR 11本の作業で約1.9億トークンを使い、このクレジットを使い切りました。API の単価に換算すると約$100に当たる量です。

Q. 本当に PC を閉じても進みますか？

A. はい。クラウドで動くスレッドは、PC を閉じてもスリープさせても進みました。今回も、夜間の約7時間に3本の作業が終わっていました。ただし「ローカルで作業」で手元の PC に立てたスレッドは、PC が起きている間しか動きません。

Q. GitHub 以外のリポジトリでも使えますか？

A. コードを扱うスレッドは、Claude GitHub App を入れた github.com のリポジトリが前提です。今回は自前の git サーバで管理していたため、Claude 専用の GitHub アカウントを作ってそちらで始め、最後に手元へ戻しました。

Q. 途中でプロジェクトの指示を変えたらどうなりますか？

A. 配り役にはすぐ反映され、話しかけなくても進め方が変わりました。ただし、そのとき動いているスレッドには届かないので、必要なら新しいスレッドで続けさせます。プロジェクトのメモリに残った古いルールは、人間が設定から消す必要がありました。

Q. 「ローカルで作業」は安全ですか？

A. 通信は PC から外へ向かう暗号化された接続だけで、受け付けるポートは開きません。ただ、デスクトップアプリの設定をオンにすると、利用履歴から集まったフォルダの一覧（今回は22件で、親フォルダの中の数十のプロジェクトも含む）が遠隔から作業を始められる対象になります。使う間だけオンにする、ログインに使うアカウントの2段階認証を確かめる、といった運用が必要です。

Q. 作ったものはそのまま使えますか？

A. 今回は、そのままでは使えませんでした。骨格や SEO の作り込みはよくできていましたが、担当の境目の処理が丸ごと抜けていて、実データで出る不具合もありました。公開の前に、実データを入れて全体を通して確かめる工程が必要です。