Claude駆動開発マニュアル
このマニュアルについて
Claudeでアプリを作るときの手順を、誰が読んでも同じように進められるようにまとめたものです。開発のルールそのものは GitHub の jirotobokuto/dev-rules(CLAUDE.md)にあり、Claudeは毎回それを読んで動きます。
- メールアドレス
- nagatomo.yusei@gmail.com
- 使い道
- プライベートと仕事用
- 使う場所
- Claudeデスクトップアプリ
- ルールの変更
- できる
- メールアドレス
- bash.recruit@gmail.com
- 使い道
- 仕事用
- 使う場所
- Chrome(Bのプロフィール)
- ルールの変更
- できる
- メールアドレス
- 未作成
- 使い道
- 仕事用(第三者の使用も可能)
- ルールの変更
- できない(改善案だけ残せる)
3つとも、プロジェクトの「コンテキスト」に共通ルール(dev-rules)をつないでいるので、同じルールを読みます。
まず知っておく言葉
- サーバー
- アプリを置いておく、24時間動いているパソコン。みんながいつでもアプリを使えるようにするためのもの。
- リポジトリ
- アプリのプログラムをしまっておく、インターネット上のフォルダ。直した記録が全部残り、いつでも前の状態に戻せる。
- GitHub(ギットハブ)
- リポジトリを置いておくサービス。Claudeはここを読み書きして開発する。
- デプロイ
- 作ったアプリをサーバーに載せて、実際に使えるようにすること(公開)。
- Vercel(バーセル)
- アプリを簡単に公開できるサービス。GitHubに上げると自動で公開してくれる。
- AWS(エーダブリューエス)
- Amazonの、サーバーを借りられるサービス。その中の「Lightsail(ライトセイル)」を使っている。
- ドメイン
- インターネット上の住所(例:bash.co.jp)。
- サブドメイン
- 住所の前に名前を足したもの(例:ca-kpi.bash.co.jp)。アプリごとに住所を分けられる。
- DNS
- 住所(ドメイン)とサーバーを結びつける案内板。Xserverで設定する。
- 本番とテスト用
- 本番=みんなが使う本物。テスト用=本物を壊さずに確かめるための練習場。
- Claudeのプロジェクト
- チャットをまとめておく部屋。部屋ごとに指示や資料を設定できるので、毎回同じ説明をしなくて済む。
- CLAUDE.md
- Claudeが最初に読むルールブック。どのアカウントでも同じやり方で作れる。
- 同期
- GitHubの最新のルールを、プロジェクトに取り込むこと。
Claude Code の2つの使い方
Claude Code(Claudeがプログラムを書いて動かす仕組み)の使い方は、大きく2つあります。今は②の「裏側で動かすやり方」がメインです。
- 手元のファイルを直接見ながら作れる
- 細かい操作や設定ができる
- ソフトのダウンロードや設定が必要
- 画面がエンジニア向けで難しい。パソコンを付けておく必要がある
エンジニア、手元で細かく触りたい人
- 普段の言葉で頼むだけ。ソフトの準備が要らない
- スマホからも頼める。パソコンを閉じていても進む
- サイトの画面を操作する作業(ログインが要るものなど)は、パソコンのブラウザが必要
エンジニアでない人。今のやり方
②で、ブラウザを動かす2つのやり方
GitHub や Vercel、Xserver などのサイトを操作するときは、Claude がパソコンのブラウザを動かします。やり方は2つあります。
- Chrome でログイン済みのサイトをそのまま使える
- 「ロボットではありません」の確認も通りやすい
- A・B どちらのアカウントでも使える
- Chrome を開いておく必要がある
- 自分が使っている Chrome なので、作業中に触るとぶつかることがある
- Claude の画面の横で、動いている様子が見える
- いつもの Chrome とは別なので、作業中も Chrome を自由に使える
- 一度ログインすれば、次からもログインしたまま
- デスクトップアプリのダウンロードが必要。今は A のアカウントだけで使える
- サイトごとにログインし直す必要がある
- 「ロボットではありません」の確認が通らないサイトがある(Xserver など)。そのときは Chrome を使う
ログイン情報
作業の始め方
作業の前に1日1回、同期ボタンを押します。いつもの続きでも、新しいアプリでも同じです。
- 開発用のプロジェクトを開く。
- 右側の「コンテキスト」で、
jirotobokuto/dev-rulesの「…」→「今すぐ同期」を押す。 - 続きなら、そのトークを開いて指示する。新しいアプリなら、プロジェクトの中で新しいチャットを始める。
同期したルールが、開いたままのトークにすぐ反映されるかは未確認です。ルールを大きく変えた直後は、新しいチャットで始めると確実です。
新しいプロジェクトを作るときは、「プロジェクトコーディネーター(ベータ)」をオフにします(作業が勝手に並列で進み、使用量が増えやすいため)。
新しいアプリを作るときの流れ
新しいチャットで、作りたいものを普段の言葉で伝えるだけで始まります。例:「社員の目標と実績を入力して、月ごとに見られるツールを作りたい」
分かれ道では、Claudeがメリット・デメリットとおすすめを書いて、ボタンで選ばせてくれます。自動のテストに通ったものだけが本番に公開されるので、壊れたものがいきなり出ることはありません。使い始めたあとは「ここを直して」と伝えるだけです(1回5〜10分が目安)。
作り方の選び方
形がまだ決まっていないなら①、決まっているなら②です。
- 早い。サーバー代がかからない
- 捨てやすいので、相談を気軽にくり返せる
- 本番は作り直しになる(二度手間)
- URLで人に触ってもらいにくい。保存は試せない
新しいアプリで、形がまだ決まっていない
Ril Note の見本(v32)、デブキャン
- そのまま本番になる
- URLで社員などに触ってもらえる。保存や連携も試せる
- 最初の準備(GitHub・サーバー・ドメイン)に時間がかかる
- 方向が大きく変わると、捨てるものが多い
形がほぼ決まっている・元になるものがある・社員に触ってほしい
KPI設定ツール(main が本番、dev がテスト用)
サーバーの選び方
画面が中心の軽いツールは Vercel、自動で動き続ける仕組みやデータをしっかり持つアプリは AWS です。本番づくりに進むとき、Claudeがどちらが合うかを理由つきで提案します。
個人で趣味に使うなら無料。仕事やお金が関わるなら有料(月20ドル〜)
- 設定が簡単。テスト用URLも自動でできる
- サーバーの手入れが要らない
- 時間のかかる処理や、ずっと動き続ける処理には向かないことがある
社内の管理画面、紹介ページなど
KPI設定ツール、デブキャン
月額固定。メモリ1GBで月7ドル
- 決まった時間に自動で動く処理・時間のかかる処理・データの保管など、何でも動く
- 仕事で使ってもよい
- サーバーの手入れが必要(Claudeが代わりにやる)
- 最初の構築に時間がかかる。使っていなくても料金がかかる
自動で動き続ける仕組み、個人の記録アプリ
Ril Note、営業メールの自動化ツール(作成中)
Ril Note で AWS を選んだ理由
- 料金が決まっていて安い:サーバー代は月7ドル。全部で月約1,000〜1,500円が目安。
- データを自分のサーバーに置ける:Supabase(データの保管サービス)は、有料だと月25ドル、無料だと控え(バックアップ)がなく、1週間使わないと止まるため、使わなかった。
- アプリを閉じていても動かしたかった:朝・夕方の通知やAI秘書など、決まった時間に自動で動く仕組みが必要だった。
- 引っ越ししやすい:標準的な仕組みなので、利用者が増えたら大きなサーバーに移れる。
料金と規約は2026年11月時点の公式情報です(Vercelの料金、Vercelのプラン、Lightsailのプラン)。Claudeは提案のたびに公式で確かめます。
ドメインの使い分け
DNSはどれも Xserver の「サーバーパネル」で設定します(「Xserverドメイン」の管理画面では効きません)。
どれにも合わない、外に出す新しいサービスは、専用のドメインを新しく取ることもあります(費用はClaudeが調べてから伝えます)。
GitHub と共通ルール
開発のルールは GitHub の非公開のリポジトリ jirotobokuto/dev-rules に1つだけあり、A・B・Cすべてがそこを読みます。1か所を直せば、同期したあとは全アカウントに反映されます。
ルールを変えるとき(A・B)
- 「こういうルールにして」と頼む。Claudeの方から「共通ルールに足しますか」と提案してくることもある。
- Claudeが変える内容を見せて、「jirotobokuto/dev-rules への書き込みを許可」のボタンを出すので、押す。
- 書き込まれ、記録の先頭に
[A]か[B]が付く。 - ほかのアカウントのプロジェクトで「今すぐ同期」を押す。
ボタンが必要なのは、Claudeの安全確認の仕組みが、本人が書き込み先を名指しで許可したときだけ dev-rules への書き込みを通すからです。
Cからの提案
Cはルール本体を変えられません。改善案を proposals/ に残し、AかBで「提案を見て」と言うと、採用するかどうかを一緒に決められます。
新しいアプリのリポジトリ
本番づくりで「GitHubで作りますか?」にOKすると、Claudeがブラウザで非公開のリポジトリを作り、使えるように設定もします。そのブラウザで GitHub にログインしていることが条件です。
やってはいけないこと
便利な使い方(裏技)
スマホから指示する
スマホのClaudeアプリで同じアカウントにログインし、同じプロジェクトを開けば、外出先からでも指示できます。プログラムを書く・GitHubに上げる作業はパソコンを閉じていても進みます。
ブラウザを操作する作業(GitHubでリポジトリを作る、XserverでDNSを設定するなど)だけは、パソコンを開いてネットにつないでおきます(A:Claudeデスクトップアプリ、B:Chrome のBのプロフィールを開いておく)。
声で指示する
入力欄のマイクのマークを押して話すと、話した言葉がそのまま文字になります。似た言葉に聞き間違えられることがあるので、送る前にざっと見直します。
アイコンや本格的な画像は Gemini に頼む
本格的なアイコン・イラスト・ロゴは Gemini に作ってもらい、背景を透明にした画像(背景透過)で出してもらうと、アプリにそのまま使えます。できた画像は Claude に渡して組み込んでもらいます。
1つのアカウントで、複数の開発を同時に進める
チャットを2つ以上開いて、それぞれ別の開発を同時に進められます。ただし使える量はその分早く減ります。同じアプリを2つのチャットで同時に直すと変更がぶつかるので、別々のアプリにします。
使える量(トークン)の上限
Claude(Proプラン)には、「5時間ごと」と「1週間ごと」の2つの上限があります。どちらかに届くと、戻るまで待つことになります。
- 使った量と次に戻る時刻は、Claudeの「設定」→「使用量」で見られます。
- トークが長くなるほど多く使うので、一区切りしたら新しいチャットに切り替えると長持ちします。
- A・B・Cは別々のアカウントなので、上限もそれぞれ別です。
出典:使用量と長さの制限はどのように機能しますか、Pro プランとは何ですか(2026年11月時点)