レシピ#4-9: AIのトークン消費を抑える実践テクニック
💡 まず知っておくべきこと：料金プランの選択肢
Claude Proで使える機能
Claude Pro（定額$20/月）で利用可能： - ✅ Claude Code（ターミナル/CLI） - ✅ Claude Code（GitHub連携版） - ✅ Web版 Claude（claude.ai）
参考: https://www.anthropic.com/pricing
個人開発者の選択肢
1. Claude Pro $20/月（定額プラン）
✅ こんな人におすすめ： - 毎日安定してコードを書く - トークン消費を気にしたくない - 月額固定費で予算管理したい
⚠️ 注意： - 使用量上限あり（一般的な個人開発には十分） - 本格的に大量のコードを書く場合は上限に達する可能性
2. Claude MAX（上位プラン）
✅ こんな人に必要： - 本格的に大量のコードを書く - Claude Proの上限では足りない - プロフェッショナル開発者
3. 従量課金（API直接利用）
✅ こんな人に適している： - 受託作業で日によってコード量が大きく変動する - 使用量が不定期 - 細かいコスト管理が必要
💰 料金： - Opus 4.5: $5/1M入力, $25/1M出力 - Sonnet 4.5: $3/1M入力, $15/1M出力
🎯 このガイドの位置づけ
どのプランを使っていても、効率的なAIの使い方は重要です：
- 指示の範囲を適切に絞る
- 無駄な往復を減らす
- トークン消費を抑える = 生産性向上
以下では、Claude Codeを前提に、効率的なAI活用テクニックを学びます。
💰 従量課金を使う場合のコスト
コストの現実
Claude API料金（2025年12月時点）：
| モデル | 入力トークン | 出力トークン |
|---|---|---|
| Opus 4.5 | $5/1M tokens | $25/1M tokens |
| Sonnet 4.5 | $3/1M tokens | $15/1M tokens |
例： 10,000トークンのコンテキスト（約7,500ワード）で100回の対話： - Opus 4.5: 約$30 - Sonnet 4.5: 約$18
個人開発での月間コスト試算： - 毎日10回の対話 × 30日 = 月間300回 - Opus 4.5のみ: 約$90/月 - Sonnet 4.5のみ: 約$54/月 - 効率的な使い分け（Sonnet 80% / Opus 20%）: 約$60/月
効率的な使い方を知ることで、無駄なコストを抑えられます。
🎯 トークン節約の基本原則
原則1: 対象を明示して、範囲を絞る
❌ 悪い例：
「アプリ全体を見て、ボタンの色を赤に変更してください」
→ Claude Codeが不要なファイルまで探索・読み込みする
✅ 良い例：
「lib/home_page.dart の送信ボタンを赤色にしてください」
→ 必要なファイルだけを読んで処理
削減効果： 90%以上のトークン節約
原則2: 目的に合った頼み方をする
| 頼み方 | トークン消費 | 使うべき場面 |
|---|---|---|
| 箇所を指定した小さな修正 | ⭐ 最小 | 1ファイル・1箇所の変更 |
| 「変更せず説明して」 | ⭐⭐ 小〜中 | 質問・相談・エラー調査 |
| 機能単位の実装依頼 | ⭐⭐⭐⭐⭐ 最大 | 複数ファイルの変更・新規作成 |
基本ルール： - 小さな変更 → ファイルと箇所を指定して依頼 - 質問・相談 → 「コードは変更せず、説明だけしてください」と添える - 大規模な実装 → まず計画を出させて、段階ごとに実装
原則3: モデルを使い分ける
/model でいつでも切り替えられます。
Opus 4.5（高コスト）を使うべき場面： - 複雑なアーキテクチャ設計 - 大規模なリファクタリング - 難しいバグの調査 - 初めての技術への挑戦
Sonnet 4.5（低コスト）で十分な場面： - 簡単なUI実装 - 定型的なコード生成 - エラーメッセージの解読 - 小さな修正・調整
削減効果： 80%のコスト削減（同じ作業でも）
🛠️ 実践テクニック
テクニック1: ファイル名を明示する
❌ 無駄なコンテキスト：
「アプリ全体を見て、home_page.dartのボタンを修正してください」
→ プロジェクト全体を探索（数千〜数万トークン）
✅ 必要なファイルだけ指定：
「lib/home_page.dart のボタンを修正してください」
→ 1ファイルだけ読み込み（数百トークン）
削減効果： 90%以上のトークン節約
テクニック2: 段階的に質問する
❌ 一度に全てを聞く：
「Flutterの状態管理について、setState、Provider、Riverpod、BLoC、GetXの
違いを詳しく説明してください。それぞれのメリット・デメリット、使い分け、
サンプルコード、ベストプラクティス、アンチパターンも教えてください」
→ 膨大な回答（数千トークン）
✅ 必要なことだけ聞く：
「FlutterでsetStateとProviderの違いを簡潔に教えてください」
→ 必要な情報だけ（数百トークン）
削減効果： 70〜80%のトークン節約
テクニック3: プロンプトを具体的にする
❌ 曖昧な指示（往復が増える）：
「TODOアプリを作ってください」
Claude: 「どのような機能が必要ですか？」
あなた: 「TODOの追加と削除」
Claude: 「データはどこに保存しますか？」
あなた: 「SharedPreferencesで」
→ 3往復（トークン3倍）
✅ 具体的な指示（1回で完了）：
「TODOアプリを作ってください。機能：TODOの追加・削除・完了チェック。
データ保存：SharedPreferences。UI：Material Design。」
Claude: [実装を開始]
→ 1往復のみ
削減効果： 60〜70%のトークン節約
テクニック4: 小さく実装して確認する
❌ 大規模な実装を一度に依頼：
「TODOアプリを完全に実装してください。ホーム画面、詳細画面、設定画面、
データベース、API通信、認証、通知、テーマ切り替え、多言語対応も。」
→ 実装後に問題発覚 → 大規模な修正が必要（トークン大量消費）
✅ 小さく作って確認：
1. 「TODOのホーム画面だけ作成してください」 → 確認 → OK
2. 「SharedPreferencesでの保存機能を追加してください」 → 確認 → OK
3. 「削除機能を追加してください」 → 確認 → OK
削減効果： 失敗時の無駄なトークンを削減
テクニック5: エラーは最小限の情報で相談
❌ 全ての情報をコピペ：
[エラーログ全文をコピペ（500行）]
[該当ファイル全文をコピペ（300行）]
[pubspec.yaml全文をコピペ（100行）]
「このエラーを修正してください」
→ 900行のコンテキスト（数千トークン）
✅ エラーの核心だけ送る：
「以下のエラーが出ました：
The method 'setState' isn't defined for the class 'MyWidget'
lib/home_page.dart の50行目付近を見てください」
→ 必要最小限（数百トークン）
なお、Claude Codeは自分で flutter analyze を実行してエラーを取得できるので、
「flutter analyze を実行して、出たエラーを直してください」という頼み方も有効です。
削減効果： 80〜90%のトークン節約
テクニック6: /clear で会話をリセットする
会話の履歴は累積する：
1回目の質問: 100トークン
2回目の質問: 100 + 前回の履歴200トークン = 300トークン
3回目の質問: 100 + 前回の履歴500トークン = 600トークン
新しいトピックは新しい会話で：
- タスクが終わったら /clear で会話をリセット
- 長くなった会話は /compact で要約して続行
- 恒常的な前提は会話ではなく CLAUDE.md に書く（毎回自動で読み込まれる）
削減効果： 50%以上のトークン節約（長い対話の場合）
📊 実践例：トークン消費の比較
ケース1: ボタンの色を変更
❌ 非効率な方法（約5,000トークン）：
「プロジェクト全体を見て、ボタンの色を変更してください」
→ 多数のファイルを探索してから変更
✅ 効率的な方法（約500トークン）：
「lib/home_page.dart の送信ボタンを赤色にしてください」
→ 1ファイルだけ読んで即座に変更
削減率： 90%
ケース2: エラー修正
❌ 非効率な方法（約8,000トークン）：
「プロジェクト全体を見て、エラーを探して修正してください」
→ 全ファイルを解析
✅ 効率的な方法（約500トークン）：
「flutter analyze を実行して、出たエラーだけを修正してください」
→ エラー箇所だけを読み、最小の修正
削減率： 94%
ケース3: 新しい画面の作成
❌ 非効率な方法（約15,000トークン）：
曖昧な指示：「設定画面を作ってください」
→ Claudeが詳細を質問（往復3回）→ 実装
✅ 効率的な方法（約3,000トークン）：
「lib/main.dart を参照して、以下の設定画面を作成してください：
- ファイル名: lib/screens/settings_page.dart
- 機能: ダークモード切り替え、通知ON/OFF
- データ保存: SharedPreferences」
→ 1回で実装完了
削減率： 80%
🎓 トークン節約のチェックリスト
実装前のチェック
- [ ] 対象のファイル・箇所を明示したか？
- [ ] プロンプトは具体的か？（往復を減らせるか？）
- [ ] Sonnet 4.5で十分な作業か？（Opusが必要か？）
- [ ] 恒常的な前提は CLAUDE.md に書いてあるか？
実装中のチェック
- [ ] 小さく実装して確認しているか？（大規模な失敗を避けられるか？）
- [ ] 終わったタスクの会話を引きずっていないか？（/clear）
- [ ] エラー情報は必要最小限か？（全文コピペしていないか？）
実装後のチェック
- [ ] 次回のために、効率的だった方法をメモしたか？（CLAUDE.md に足すのも良い）
- [ ] 同じ質問を何度もしていないか？（よくある質問は記録しておく）
💡 モデル別の使い分け戦略
Sonnet 4.5を使う場面（コスト効率重視）
日常的な開発作業： - UI実装（ボタン、リスト、フォームなど） - 定型的なコード生成（モデルクラス、APIクライアントなど） - エラーメッセージの解読 - 簡単なリファクタリング - コードレビュー - ドキュメント作成
コスト： 約$3/100万入力トークン
Opus 4.5を使う場面（品質重視）
複雑な作業： - アーキテクチャ設計 - 複雑なバグの調査 - 大規模リファクタリング - 新しい技術の導入 - パフォーマンス最適化 - セキュリティレビュー
コスト： 約$5/100万入力トークン
戦略： - 全作業の80%をSonnet、20%をOpusにすることで、コストを効率化できる
🚀 実践的な節約ワークフロー
ワークフロー1: 新機能の実装
1. 【Web版Claude または Claude Code + Sonnet】設計を相談（低コスト）
↓
2. 【Claude Code + Sonnet】機能単位で実装（中コスト）
↓
3. 【Claude Code + Sonnet】箇所を指定して微調整（低コスト）
↓
4. 【Claude Code + Opus】複雑な問題の相談（必要時のみ）
ワークフロー2: バグ修正
1. エラーログを確認
↓
2. 【Sonnet】「このエラーの原因を、コードを変更せずに説明して」（低コスト）
↓
3. 【Sonnet】該当ファイルを指定して修正（低コスト）
↓
4. （解決しない場合）【Opus】深い調査
📈 トークン消費の可視化
Claude Code の /cost コマンドで、その会話の消費量を確認できます。
定額プランでも、/cost で自分の使い方の癖を把握しておくと、
上限に達しにくい使い方が身につきます。
⚠️ やってはいけないこと
❌ アンチパターン1: 何でも「プロジェクト全体を見て」
ボタンの色変更 → 「全体を見て」（数千トークン）
変数名の変更 → 「全体を見て」（数千トークン）
コメント追加 → 「全体を見て」（数千トークン）
正解： 小さな変更はファイルと箇所を指定（数百トークン）
❌ アンチパターン2: 常にOpusを使う
簡単なUI実装 → Opus（高コスト）
エラー解読 → Opus（高コスト）
ドキュメント作成 → Opus（高コスト）
正解： 日常作業はSonnet、複雑な作業だけOpus
❌ アンチパターン3: 曖昧な指示で何度も往復
「アプリを作って」
「どんな機能？」
「TODOアプリ」
「どこに保存？」
「SharedPreferences」
→ 3往復（トークン3倍）
正解： 最初から具体的に指示（1往復）
📝 まとめ
トークン節約の3大原則：
-
対象を明示して範囲を絞る - 小さな変更 → ファイルと箇所を指定 - 質問・相談 → 「変更せず説明して」 - 大規模実装 → 計画を出させて段階ごとに
-
必要最小限のコンテキスト - ファイル名を明示する - エラーは核心だけ送る - /clear で会話をリセット、前提は CLAUDE.md へ
-
モデルを使い分ける - 日常作業 → Sonnet 4.5（80%） - 複雑な作業 → Opus 4.5（20%）
これらのテクニックで、無駄なコストを抑えながら、生産性を最大化できます。
効率的なAI活用は、開発スキルの一部です。賢く使って、コストと生産性の両方を最適化しましょう。
次のステップ: これらのテクニックを実際の開発で実践してみましょう。最初は意識的に、やがて自然にできるようになります。
➡️ 関連レシピ:
- #4-1: Claude Codeを使った効率的な開発ワークフロー
- #1-2: AI開発ツールの導入