目次

概要

「Claude CodeにiOS、Android、Web、Chrome拡張機能まで全部任せて、数ヶ月かかる開発を数週間に短縮できた」という華々しい成功談の裏には、想定外の課金という手痛い失敗も存在するようです。今回は、そうした事例をもとに、個人開発でClaude Codeを使う際のタスクの粒度設計について考えてみます。

90%をAIに書かせるという挑戦

ある個人開発の事例では、iOS、Android、Web、Chrome拡張機能、そしてGo言語のコードの実に90%程度をClaude Codeに書かせるという挑戦が行われています。結果として、本来なら数ヶ月かかるはずの開発を数週間にまで短縮できたという成果が確認されています。この事例は、Claude Codeが単なる補助ツールではなく、開発の主軸を担えるだけの実力を持っていることを示しているようです。

5万円溶けた理由

一方で、この挑戦の過程では「5万円吹っ飛んだ」という体験談も語られています。そもそもPro/Maxプランなどでサブスクリプション契約してログインして使っていれば、月額固定しかかからないので、これはAPIで利用していたと考えられます。

その上で、大きな粒度のタスク、たとえば「アプリ全体を作って」といった指示を一度に投げ続けたことです。大きすぎる指示は、AIとの間で無駄なやり取りやリトライを発生させやすく、その分APIのトークン消費がかさみ、結果として想定外の課金につながってしまったようです。

なぜ5万円という金額になるのか、料金から逆算してみる

感覚的に理解しやすくするために、APIの料金体系から逆算してみます。Claude Sonnet系のモデルは、100万トークンあたり入力3ドル・出力15ドル程度、より高性能なOpus系のモデルは入力5ドル・出力25ドル程度とされています(為替やモデルの世代によって変動します)。一見安く感じる単価ですが、「アプリ全体を作って」のような大きな指示では、AIが一度に大量のコードを生成しては修正し、また生成しては修正する、というやり取りが何十回も発生することがあります。1回のやり取りで数万トークンを消費するとして、それが数百回に及べば、あっという間に数万円規模のコストに膨れ上がってしまう計算になりそうです。逆に言えば、指示を細かく分割し、無駄なやり直しを減らすだけで、同じ機能を実装するにしても消費トークン数を大きく圧縮できる余地があるということです。

教訓：計画確認を挟むことの重要性

この事例から得られる教訓は明確です。まず、特に初心者は自分がどういったモードでクロードコードを使用しているか確認しましょう。Login methodにAPI Accountなど表示されていたら、従量課金になっているので、/loginでサブスクリプションログインに変更したほうが良いでしょう。Login methodがPro PlanなどになっていたらOKです。

大きな指示を出す前に、必ずPlan Modeで計画を確認するという一手間を挟むべきだということです。いきなり実装に入るのではなく、まず「どういう設計で、どんな手順で進めるか」という計画をAIに立てさせ、その内容を人間が確認してから実装フェーズに移ることで、無駄なコード生成やリトライを大幅に減らせそうです。

実践テクニックからの抜粋

個人開発でClaude Codeを使いこなす上で紹介されている実践テクニックには、次のようなものがあります。

  • 最初にPlan Modeで計画だけを立てさせてから実装に入る
  • 大きなタスクは小さなチケット単位に分割して依頼する
  • エラーが出た際はスタックトレースの全文をそのまま貼り付ける
  • 生成されたコードに不要なコメントを求めない
  • 定期的に「/compact」でコンテキストを整理する

これらはいずれも、AIとのやり取りにおける「無駄」を減らすための工夫だと考えられます。

初心者はまずCLAUDE.mdから

これから個人開発に挑戦する初心者にとっては、まずCLAUDE.mdを「取扱説明書」として先に用意しておくことが有効なスタート地点になりそうです。プロジェクトのルールや使用する技術スタックを最初に伝えておけば、以降のやり取りで説明を繰り返す必要がなくなり、結果としてコストの節約にもつながります。そのうえで、簡単なタスクから徐々に慣れていくのが安全な進め方でしょう。

まとめ：コスト管理の3原則

まず/statusでLogin methodでAPIなどになっていない事を確認しましょう。その上でClaude Codeで個人開発を効率よく進める原則は、次の3つに集約できそうです。

  1. 大きな指示を出す前に、必ずPlan Modeで計画を確認する
  2. タスクは小さなチケット単位に分割して依頼する
  3. CLAUDE.mdを整備し、毎回の説明コストを減らしておく

「AIに全部任せる」という挑戦は魅力的ですが、その裏には粒度設計というひと手間が欠かせないようです。

関連記事