| name | claude-code-self-generation-over-api |
| description | Use when Claude Code needs to generate or transform text data in bulk. Try self-generation before API calls on Max plan. |
| license | MIT |
| metadata | {"author":"shimo4228","version":"1.0","extracted":"2026-02-11"} |
Claude Code: 自身のLLM能力で直接生成する（APIより先に検討）
Extracted: 2026-02-11
Context: Claude Code（Maxプラン）でデータ生成・テキスト変換・構造化が必要な場面
Problem
Claude Codeが大量データの生成・変換タスクに直面すると、以下の思考パターンに陥りやすい:
- まず正規表現やヒューリスティクスでの機械的処理を試みる
- 品質が不十分だと判明すると「外部API（Anthropic SDK等）を使いましょう」と提案する
- 自分自身がLLMであり、セッション内で直接生成できることを見落とす
これにより:
- 不要なAPI設定・コスト（従量課金）の発生
- 正規表現の限界に無駄に時間を費やす
- ユーザーが「Maxプラン内でできるのでは？」と指摘するまで気づかない
Solution
データ生成・テキスト変換タスクでは、以下の優先順位で検討する:
判断フローチャート
タスク: 大量データの生成/変換/構造化
│
├─ 機械的処理で十分か？（フォーマット変換、フィルタリング等）
│ └─ YES → 正規表現/スクリプトで処理
│
├─ LLMの理解力が必要か？（要約、再構成、品質判断等）
│ └─ YES ─┐
│ │
│ ★ Step 1: まずClaude Code自身で数十件を試作する
│ │ 品質基準を確立し、プロンプトパターンを検証
│ │
│ ├─ 個人プロジェクト / 1回限り / Maxプラン
│ │ └─ そのままClaude Codeでバッチ処理して完走
│ │
│ └─ チーム共有 / 再実行が必要 / CI/CD組み込み
│ └─ 検証済みプロンプトをAPIスクリプトに移植
│ （プロンプトがコードとして残り、誰でも再実行可能）
│
└─ いきなりAPI呼び出しを提案しない
重要: 「まず自分で試す」フェーズを飛ばさない
APIスクリプト化が最終的に正しい場合でも、先にClaude Code自身で試作することで:
- 品質基準が具体的になる（手作りサンプルが増える）
- プロンプトパターンが検証済みの状態でスクリプトに移植できる
- 「個人で完走 or API化」の判断を実データに基づいて行える
バッチ処理の実践パターン
- ヘルパースクリプト: 入力データを読みやすいバッチファイルに分割
- 品質基準: 手作りサンプルを数件用意し、それを基準として全件に展開
- バッチサイズ: 20-30件/バッチが目安（コンテキストウィンドウとの兼ね合い）
- 検証: 生成後にバリデーションスクリプトで品質チェック
Example
# 悪い例（このセッションで実際に起きたこと）
User: 408問の構造化解説を生成したい
Claude:
方針A: 正規表現改善（無料だが品質限界） ← まずこれを提案
方針B: Claude API呼び出し（$2-5） ← 次にこれを提案
方針C: ハイブリッド ← 折衷案
# → Claude Code自身での生成を選択肢に含めていなかった
# 良い例
User: 408問の構造化解説を生成したい
Claude:
手作りサンプル3問が高品質 → これはClaude Code自身が生成したもの
→ Maxプラン内で同じことを408問に拡大するのが最も合理的
→ バッチ処理（20問×21バッチ）で実行可能
When to Use
以下の条件が揃ったとき、このパターンを適用する:
- テキスト生成/変換/要約/構造化のタスク（正規表現では品質不足）
- ユーザーがMaxプラン（またはClaude Codeの利用に追加コストがかからない契約）
- バッチ処理可能（各項目が独立しており、1件ずつ処理できる）
- 品質基準が明確（手作りサンプルや期待出力の例がある）
個人 vs チーム: 使い分け
| Claude Code 直接生成 | API スクリプト |
|---|
| 対象 | 個人・1回限り・プロトタイプ | チーム・再実行可能・プロダクション |
| 再現性 | 低い（会話の流れに依存） | 高い（プロンプトがコードとして残る） |
| コスト | Maxプラン定額内 | 従量課金 |
| 自動化 | 不可（手動バッチ） | CI/CD に組み込み可能 |
ただしどちらの場合も、最初にClaude Codeで試作するフェーズを挟む。
Anti-patterns
- 単純なフォーマット変換（JSON→CSV等）にLLMを使う → スクリプトで十分
- 1万件以上の大量データ → コンテキストウィンドウの限界でAPI呼び出しのほうが効率的
- リアルタイム処理が必要 → APIのほうが適切
- 品質基準なしでいきなりAPI化 → まずClaude Codeで試作し、品質基準とプロンプトを確立すべき
