Claude と一緒にゼロから家計簿アプリを作ってみた話
はじめに
「自分で使いたいアプリを自分で作る」というのは、エンジニアなら一度は思い描く夢だと思います。ただ、仕事でコードを書いているわけでもない自分にとって、ゼロから Web アプリを作るのはハードルが高かった。
そこで AI を使ってみることにしました。使ったのは Claude(Anthropic)。結果として、想像以上にちゃんとしたアプリが完成しました。この記事では、実際にどんなふうに開発を進めたか、何が大変だったかを正直に書きます。
なぜ家計簿アプリを作ったのか
既存の家計簿アプリを使っていましたが、どれも帯に短し襷に長し。
- 複数人の家計を管理したい(夫婦でそれぞれ入力したい)
- 誰がいくら立て替えたか記録して、月末に精算したい
- PayPay や銀行の明細を CSV で一括取込したい
- 副業の収入も同じアプリで管理したい
この 4 つが全部揃うアプリが見つからなかったので、「じゃあ作るか」という結論になりました。
完成したアプリの概要
GitHub リポジトリ: (非公開)
主な機能
| 機能 | 内容 |
|---|---|
| 複数ユーザー管理 | 招待コードで家族・カップルがひとつの世帯を共有 |
| 収支登録 | 個人支出・共有支出を区別して記録 |
| 共有支出の精算 | 誰がいくら立て替えたか記録し、最小送金数で精算計算 |
| グラフ表示 | 支出カテゴリ別円グラフ、月別収支推移棒グラフ |
| CSV インポート | PayPay・三菱UFJ・三井住友の明細を一括取込 |
| レシート添付 | 取引にレシート画像を紐付けて保管 |
| 副業管理 | 副業収入のカレンダー管理・年間サマリー・添付ファイル |
| レスポンシブ対応 | PC・タブレット・スマートフォンで動作 |
技術スタック
バックエンド : Python / Flask 3.0
DB : SQLite3
フロント : Vanilla JS(フレームワークなし)
グラフ : Chart.js
デプロイ : PythonAnywhere 想定(WSGI)
Claude との開発フロー
やったこと
大きく分けて、Claude との会話は以下の流れで進みました。
① 要件を話す
↓
② Claude が実装方針を提案
↓
③ 自分が承認 or フィードバック
↓
④ Claude がコードを書く
↓
⑤ 動かして確認
↓
⑥ 気になった点を伝えてブラッシュアップ
コードを書いてもらうだけでなく、設計の相談相手としても使いました。「こういう機能を追加したいんだけど、DB はどう変えればいい?」「共有支出の割り勘って、どういうデータ構造が一番シンプル?」といった問いかけに対して、選択肢とトレードオフを説明してくれるのが助かりました。
実際のやりとり例
自分の入力(要件):
家族で使える家計簿を作りたい。夫婦それぞれがスマホから入力できて、共有の支出(食費・光熱費等)は負担割合を設定して月末に精算できるようにしたい。
Claude の応答(抜粋):
承認前に実装方針を確認します。
DB 設計案:
households(世帯)テーブルで家族を1グループとして管理transaction_shares(負担割合)テーブルで誰が何%負担するか記録transaction_payers(支払者)テーブルで実際に誰が払ったかを記録精算ロジック:
- 「払った額 − 負担すべき額 = 残高」を全員分計算
- 最小送金数になるよう計算(残高プラスの人が残高マイナスの人から受け取る)
こんな感じで、方針を提示してもらって「OK」と言ったら実装してもらうスタイルです。
特にうまくいったこと
1. 共有支出の精算計算が思ったより賢い
最初は「A さんが B さんに ¥3,000 払う」みたいなシンプルな計算を想定していましたが、Claude が提案したのは最小送金数になるアルゴリズムでした。
たとえば3人のケースで:
A: +5,000(立替超過)
B: -3,000(支払不足)
C: -2,000(支払不足)
この場合、B→A で ¥3,000、C→A で ¥2,000 の 2 回の送金で精算が完了します。人数が増えても送金の回数が最小になるよう計算してくれる実装が最初から入っていて、地味に感動しました。
2. セキュリティを勝手に考えてくれる
「ログイン機能を作って」と言ったら、パスワードのハッシュ化・CSRF 対策・レート制限・セッションの設定まで最初から実装されていました。自分だったら後回しにしがちな部分が最初から入っているのはかなり助かりました。
実際に入っていたもの:
- パスワードは Werkzeug の
generate_password_hash(bcrypt 相当) - 全 POST リクエストで CSRF トークンを検証
- ログイン失敗を DB に記録
- Content Security Policy ヘッダー(inline script 禁止)
3. 設計書も作ってくれる
実装が進んできた段階で「現在の実装を基に設計書を作って」とお願いしたら、コードを読み込んで以下のドキュメントを自動生成してくれました:
- システム概要(機能一覧、技術スタック)
- 画面一覧(URL・役割・関連テーブル)
- DB 設計書(全12テーブルのカラム定義・リレーション)
- 機能仕様書
- 技術的負債リスト(優先度 A/B/C 分類)
- ロードマップ
「コードを書くのは得意だけどドキュメントは苦手」という自分には特に嬉しい機能でした。
難しかったこと・失敗したこと
1. 要件の言語化が一番難しい
Claude が詰まるというより、自分が何を作りたいのかを言葉にするのが難しかった。
「共有支出を管理したい」と言っても、「誰がいくら払ったか」と「誰がいくら負担するか」が別の概念だということは、最初はうまく伝えられませんでした。会話を重ねながら「あ、そういうことを実現したかったのか」と自分自身が気づくことも多かったです。
教訓: 作りたいものを紙に書いてから Claude に話しかけると圧倒的にスムーズになります。
2. UI の「なんか違う」感を伝えるのが難しい
「ダサいのでもっとクールにして」は伝わりにくい。具体的に「このアイコンの色が浮いている、エメラルドグリーンのグラデーションに変えたい」と言えるようになってから修正がスムーズになりました。
スクリーンショットを見せながら「ここが見切れている」「ここの余白が狭い」と指摘すると、Playwright(ブラウザ自動化ツール)でブラウザを動かしながら自分で確認・修正してくれます。
3. コンテキストが長くなると「前の話を忘れる」
長い会話を続けていると、Claude が以前の決定事項を忘れて別の実装方針を提案してくることがありました。
これは CLAUDE.md(プロジェクトのルールファイル)に開発方針を書いておくことで改善されました。
# CLAUDE.md の例
## 最重要ルール
- 実装前に必ず方針を提案し、承認を得てから実装する
- 既存機能を壊さないことを最優先とする
- 変更理由を説明すること
- 不要なリファクタリングは禁止
このファイルを置いておくと、毎回の会話で自動的に読み込んでくれます。
4. 動作確認は自分でしないといけない
当然ですが、Claude はコードを書いてくれるだけで、動作確認の判断は自分がしなければなりません。「画面で確認して」と言えば Playwright でブラウザのスクリーンショットを撮って見せてくれますが、「使いやすいかどうか」の感覚は人間にしかわかりません。
完成したアプリのスクリーンショット
ダッシュボード(PC)
サイドバー付きの 2 カラムレイアウト。月別収支サマリー、グラフ、直近の取引を一画面で確認できます。
精算画面
誰がいくら立て替えて、誰が誰にいくら払えば精算が終わるかを自動計算。月ごとに「精算完了」マークをつけて管理できます。
副業管理(カレンダービュー)
月単位のカレンダーで副業の勤務を管理。請求書・領収書の PDF も添付できます。
開発にかかった時間
要件定義から一通り動くまで:約 3 週間(土日中心)
- 毎回の会話で「設計相談 → 承認 → 実装 → 確認」を繰り返す
- 1 セッション 1〜2 時間程度
プログラミングの知識がなくても作れたかというと、完全にゼロではきついというのが正直なところです。コードは書いてもらえますが、「このエラーは何を意味しているのか」「なぜこの実装にしたのか」を理解するためには、ある程度の知識があったほうがスムーズでした。
まとめ
| 項目 | 評価 |
|---|---|
| 実装スピード | ◎ 普通に書くより圧倒的に早い |
| コード品質 | ○ セキュリティ等を最初から考慮してくれる |
| 設計相談 | ○ トレードオフを説明しながら提案してくれる |
| ドキュメント生成 | ◎ コードから設計書を自動生成できる |
| UI の微調整 | △ 感覚的な「なんか違う」は言語化が必要 |
| 動作確認 | △ 最終的な判断は人間がする |
Claude を使った開発は、「何でも魔法のようにやってくれる」というより、優秀なペアプログラミングパートナーがいる感覚に近いです。自分が方向性を決めて、詳細の実装をお任せする、という分業がうまくいったと思います。
「アプリを作りたいけど一人では難しい」という方に、ぜひ試してみてほしいです。