Claude Codeの効果的な使い方：フルSaaSアプリ構築における開発者の経験談

2021年からSaaS製品を開発してきた開発者が、最近Claude Codeを使用してcodefluent.appという完全なアプリケーションを構築しました。重要な洞察は、効果的なツールの使用には「アプリを作って」といった曖昧なプロンプトではなく、詳細な技術仕様が必要だということです。開発者は、明確な仕様を動作するコードに迅速に変換するためにClaude Codeを使用しながら、すべてのアーキテクチャ上の決定を自分で行うことを強調しています。

プロジェクト詳細と技術スタック

このプロジェクトはcodefluent（codefluent.app）で、プログラミング構文を学習するための間隔反復アプリです。ランディングページ全体は、セクションを説明し、希望する視覚的な方向性を参照しながらClaude Codeで構築され、レスポンシブでクリーンなTailwindマークアップが実現されました。

技術スタック:

• SvelteKitモノリス
• PostgreSQL + Drizzle ORM
• Better Auth
• LLM機能のためのOpenRouter
• Stripe
• CodeMirror 6
• Tailwind v4
• Railway

作業方法：詳細な仕様

開発者は曖昧なプロンプトを使用しません。代わりに、すべての機能は正確な要件の記述から始まります：スキーマ、認証戦略、コンポーネント階層、APIの形状、エッジケースなどです。Claude Codeは既存のコードベースを読み取り、パターンや規則を把握し、適合するコードを記述します。

使用されたプロンプトの例:

「userId、date、cardsStudied、correctCount、streakCountの列を持つdaily_statsテーブルを追加してください。練習完了時にアップサートするサービス関数を作成してください。ユーザーが昨日練習した場合はストリークを増やし、練習しなかった場合は1にリセットします。ログインしているユーザーの過去30日間の統計を返すサーバーエンドポイントを追加してください。」

開発者は生成されたコードのすべての行をレビューし、エッジケースを捕捉し、内容を厳密に調整してリリースします。重要な点は、どのテーブルが存在するか、認証スコープがどのように機能するか、ビジネスルールといったアーキテクチャ上の決定は、AIではなく開発者によって行われるということです。

うまくいった点

• データベース操作: スキーマ変更と制約を説明することで、動作するDrizzleマイグレーションが数秒で生成されました。
• Stripe統合: チェックアウトフローとWebhookのライフサイクルを指定することで、すべての配管コードが生成され、少なくとも丸一日の作業が節約されました。
• /simplifyコマンド: このコマンドはコードを再利用性、品質、効率性についてレビューし、開発者が残したかもしれない技術的負債を捕捉します。
• 一貫性: ルートとサービス構造のパターンが確立されると、Claude Codeは最小限の逸脱でそれらを維持しました。

課題と注意点

• 過剰な設計: Claude Codeは、一度きりの使用ケースであっても、抽象化やヘルパー関数を作成する傾向があります。開発者は「もっとシンプルに、直接的な方法で行って」と積極的に押し戻す必要がありました。
• 認証の複雑さ: SvelteKitのSSRセッションハンドリングを伴うBetter Authは扱いが難しかったです。生成されたパターンは単体では動作することもありますが、サーバーサイドレンダリングでは壊れることがあり、問題を捕捉するために開発者が認証フローを理解する必要がありました。
• AI採点システム: このアプリはLLMを使用してコードの説明を採点します。一貫した採点を、寛容すぎず厳しすぎずに達成するには、AIに委任できない広範な手動プロンプトの反復が必要でした。

重要なポイント

Claude Codeは、何を構築しているかを知ることを置き換えるものではありません。良い結果と混乱の違いは、明確な仕様を記述し、出力内の悪い決定を捕捉する能力に依存します。以前にプロジェクトをリリースしたことがあるなら、何を探すべきかはすでに知っています。もしそうでないなら、それが実際に開発すべきスキルです—プロンプト技術ではありません。