メインコンテンツへスキップ
見出し画像

Claude Codeで大量の文章を自動で分類する方法|claude -p×Haiku 5.5×JSONスキーマで30件を処理して、費用を比べた【実機で確認・2026年10月】

    お客様からのメールやレビューが、毎日たくさん届く。一件ずつ読んで「褒め言葉か、苦情か、問い合わせか」を分けるのは、時間がかかります。Claude Code に任せられないか。そう考える人は多いと思います。

    そのときに、次の3つの疑問が出てきます。

    • 1件ずつ頼むのと、まとめて頼むのとで、結果と費用はどう違うのか

    • 答えを JSON で受け取って、そのまま表計算や次の処理に使えないか

    • PowerShell でも Git Bash でも、同じように書けるのか

    この記事は、「Claude Codeを自動実行する方法」の記事(claude -p の使い方)の続きです。「Claude Codeを自動実行する方法」の記事では、claude -p の基本と、暴走を止める上限を書きました。この記事では、その使い方で大量の文章を分類する形を、実際に動かして比べた結果を書きます。

    私は Claude Code と Codex を毎日使って、教材づくり、note・Gumroad への出品、画像づくりを自動化しています。ただ、私は専門家ではありません。全文無料です。

    情報の扱いを書いておきます。公式の情報は、2026年10月17日に、料金のページ、CLI のリファレンス、ヘッドレス(claude -p)のページを開いて確かめました。公式の文は要約して、私の言葉で書いています。

    実測の条件は、次のとおりです。Windows 11、Claude Code 2.1.301、2026年10月17日、claude -p(画面なし)、モデルは haiku(Haiku 5.5)です。費用は、実行結果に出る total_cost_usd の値で、API の定価で計算した見積もりです。サブスクリプションの枠の減りそのものではありません。

    この記事で分かること

    • 30件のお客様の声を分類する、やりたいことの形

    • 1件ずつ30回と、まとめて1回の、4通りの実測結果

    • 1件ずつのほうが費用が大きくなる理由(呼び出しごとの土台)

    • claude -p の主なオプションと、JSON で答えを受け取る方法

    • PowerShell と Git Bash での書き方と、つまずいた点

    • まとめて頼むときの注意と、この試験の限界

    先に結論

    • 4通りとも、30件中30件すべて正解でした。ただし、例文はやさしい文だけです

    • 費用は、1件ずつ30回(通常の設定)が約0.055ドル、まとめて1回(土台を軽くした設定)が約0.00074ドル。差は約74倍でした

    • 時間は、1件ずつ30回(3並列)が約40〜44秒、まとめて1回が約5〜6秒でした

    • 差が大きい理由は、1回の呼び出しごとに Claude Code の土台(約2万5千トークン)が文脈に載るからです。1件ずつ頼むと、その土台が30回ぶん載ります

    • --json-schema で答えの形を決めると、結果は structured_output に入り、そのまま機械で使えます

    • 公式の Batch API(50%引き)は別の仕組みで、今回は使っていません

    画像

    試したこと:30件のお客様の声を分ける

    やりたいことは、大量のお客様の声を、「称賛」「苦情」「問い合わせ」の3つに分けることです。例は次のとおりです。

    • 「届くのが早くて助かりました。また利用します。」→ 称賛

    • 「商品が破損していました。交換してください。」→ 苦情

    • 「領収書は発行できますか。」→ 問い合わせ

    試験に使ったのは30件です。称賛・苦情・問い合わせが、それぞれ10件ずつ。あらかじめ正解を付けておき、AI の答えと照らし合わせました。

    限界を先に書きます。 例文は、どれも一文で、言いたいことがはっきりした、やさしい文です。皮肉、複数の内容が混ざった長文、「褒めながら苦情を言う」ような文では、精度を確かめていません。実際に使う前には、手元の本物のデータで確かめてください。

    4通りで比べた結果

    同じ30件を、次の4通りで動かしました。1回ずつの実測です。

    • ① 1件ずつ30回(通常の設定):費用 約0.055ドル、44.0秒、30件中30件正解。1回ごとの文脈は約25,100トークン

    • ② 1件ずつ30回(土台を軽く):費用 約0.014ドル、40.0秒、30件中30件正解。1回ごとの文脈は約4,400トークン

    • ③ 30件を1回で(通常の設定):費用 約0.0057ドル、6.2秒、30件中30件正解。文脈は約25,800トークン

    • ④ 30件を1回で(土台を軽く):費用 約0.00074ドル、5.3秒、30件中30件正解。文脈は1,782トークン

    「土台を軽く」は、--system-prompt に「あなたは分類担当です。」という一文だけを渡し、--tools "" で道具を使わせない設定です。1件ずつの30回は、3本ずつ同時に動かしました(3並列)。

    正解数は、どの設定でも30件中30件でした。違いが大きかったのは、費用と時間です。①と④の費用の差は約74倍(0.0549 ÷ 0.00074)、①と③の差は約10分の1でした。

    費用の差の理由:1回ごとに載る「土台」

    ここが、この記事でいちばん伝えたいことです。

    Claude Code に「OK と答えて」とだけ頼んだ場合でも、実行結果の入力トークン(キャッシュ分を含む)で数えると、約25,000トークンでした。CLAUDE.md を空にした状態での実測です。/context で中身を見ると、組み込みの道具の定義が約1.36万トークン、システムの指示が約3,300トークンで、大きな割合を占めていました。/context の合計表示(約2.05万)と、実行結果の数え方は違うので、大まかな目安として読んでください。

    つまり、呼び出しのたびに、この土台が文脈に載ります。1件ずつ30回では、土台が30回ぶん載る計算です。前に読んだ内容が一致する部分は、キャッシュで安い単価で読まれるので、費用は単純な回数の比にはなりません。それでも、30回の呼び出しであることは変わりません。

    まとめて1回なら、土台は1回ぶんです。③の文脈は約25,800トークンで、30件ぶんの文を入れても、土台に少し足した程度でした。

    ④の設定では、文脈が1,782トークンまで減りました。道具を使わせない(--tools "")と、システムの指示を短くする(--system-prompt)の2つで、土台のほとんどが消えます。

    claude -p の主なオプション

    今回の分類で使ったオプションを、公式の説明を要約して並べます。

    • -p(--print):画面なしで1回だけ動かし、結果を返して終わる。成功なら終了コードは 0

    • --model haiku:モデルの別名。公式の設定ページによると、Anthropic API の場合の haiku は Haiku 5.5 を指す。今回の /context の表示にも claude-haiku-5-5 と出ました

    • --output-format json:結果(result)、費用(total_cost_usd)、会話のID(session_id)などを JSON で返す。項目の見方は「Claude Codeを自動実行する方法」の記事で書いています

    • --json-schema:答えの形を JSON Schema で指定する。答えは structured_output に入る。enum で「称賛」「苦情」「問い合わせ」の3つに縛ると、今回の実測では、その3つから選ばれました

    • --tools "":道具(ファイルを読む、コマンドを動かす、など)を全部使わせない

    • --system-prompt:Claude Code の標準の指示を、渡した文章で置き換える。分類だけなら短くできますが、標準の指示は消えます

    • --max-turns:ターン数の上限。上限に達すると、終了コード 1 で止まる(「Claude Codeを自動実行する方法」の記事で確認)。今回の実測では、ターン数は記録していません

    • --max-budget-usd:費用の上限。見積もりで判定し、上限を少し超えて止まることがある(「Claude Codeを自動実行する方法」の記事で確認)

    • --setting-sources:読む設定の範囲(user・project・local)を指定する。測定では、条件をそろえるため project,local を付け、ユーザー全体の設定を読まない形にしました

    書き方:PowerShell と Git Bash

    以下のコードは、説明用に短くしたものです。実測は30件でした。--max-budget-usd は、今回の実測では付けていません。ここでは、上限を付ける形にしています(0.05ドルは例です)。voices.txt には、1行に1件ずつお客様の声を書いておきます。

    PowerShell(Windows PowerShell 5.1)の例です。

    # voices.txt に、1行に1件ずつお客様の声を書いておく
    $voices = Get-Content voices.txt -Encoding utf8
    $items = ($voices | ForEach-Object -Begin { $i = 0 } -Process { $i++; "$i. $_" }) -join "`n"
    # 5.1 では引数の中の " が消えるので \" と書く
    $schema = '{\"type\":\"object\",\"properties\":{\"labels\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"称賛\",\"苦情\",\"問い合わせ\"]}}},\"required\":[\"labels\"]}'
    $prompt = "次の$($voices.Count)件のお客様の声を、それぞれ「称賛」「苦情」「問い合わせ」のどれかに分類して。番号順に labels の配列で返して。`n$items"
    $json = $null | claude -p $prompt --model haiku --output-format json --json-schema $schema --max-budget-usd 0.05 --setting-sources "project,local" | Out-String
    $labels = ($json | ConvertFrom-Json).structured_output.labels
    if ($labels.Count -ne $voices.Count) { Write-Warning "件数が合いません: $($labels.Count) / $($voices.Count)" }
    $labels

    Git Bash の例です。

    # voices.txt に、1行に1件ずつお客様の声を書いておく
    items="$(awk '{print NR ". " $0}' voices.txt)"
    n="$(wc -l < voices.txt)"
    schema='{"type":"object","properties":{"labels":{"type":"array","items":{"type":"string","enum":["称賛","苦情","問い合わせ"]}}},"required":["labels"]}'
    claude -p "次の${n}件のお客様の声を、それぞれ「称賛」「苦情」「問い合わせ」のどれかに分類して。番号順に labels の配列で返して。
    $items" \
      --model haiku --output-format json \
      --json-schema "$schema" \
      --max-budget-usd 0.05 --setting-sources "project,local" \
      < /dev/null > result.json
    jq -r '.structured_output.labels[]' result.json

    答えは、structured_output.labels に番号順で入ります。件数は、入力と同じかを数えてください。Git Bash で件数を確かめるなら、jq '.structured_output.labels | length' result.json が使えます。jq が無い場合は、PowerShell の ConvertFrom-Json の方法で同じ項目を読めます。

    標準入力を空にするのは、「Claude Codeを自動実行する方法」の記事と同じ考え方です。PowerShell では $null |、Git Bash では < /dev/null を使います。

    上の④の設定にするなら、--system-prompt "あなたは分類担当です。" --tools "" を足します。PowerShell では、空の文字の引数が消えるので、--tools '""' と書きます。

    PowerShell 5.1 でつまずく所

    次の4点は、claude を呼ばず、同じ形の引数を別のプログラムに渡して確かめたものです。PowerShell 7 では確かめていません。

    • 引数の中の二重引用符:'{"type":...}' のまま渡すと、" が消えて {type:object,...} になりました。\" と書けば、正しく渡りました

    • カンマで区切る値:--setting-sources project,local のままだと、project と local の2つに割れました。"project,local" と囲みます

    • 空の文字の引数:--tools "" は、--tools だけになって値が消えました。'""' と書けば、空の文字が渡ります

    • .ps1 ファイルの文字コード:日本語を含むファイルを BOM なしの UTF-8 で保存して実行すると、文字が化けました。BOM 付きの UTF-8 で保存してください

    使うときの注意点

    件数が増えると、取り違えが起きやすくなります。 今回は30件で、labels の数は30件、並びも入力と同じでした。ただ、50件や100件でどうなるかは試していません。件数が増えると、答えの数が合わなくなったり、順番がずれたりすることが考えられます。そのため、件数と並び順を、毎回確かめてください。

    結果は、人が抜き取りで確かめてください。 全部を見る必要はありませんが、10件ほどを目で見て、分類が合っているかを見るだけでも、ずれにすぐ気づけます。

    上限は、付けておいてください。 --max-budget-usd と --max-turns で、暴走を止めます。「Claude Codeを自動実行する方法」の記事の試しでは、費用の上限 0.0001 ドルに対して、0.0014 ドルで止まりました。上限は、ぴったりの保証ではありません。

    公式の Batch API とは別の仕組みです。 Batch API は、非同期で処理する代わりに、入力も出力も50%引きになる、と公式のページにあります。Anthropic API の機能なので、API での呼び出しが前提です。今回は使っていません。claude -p とは、別の仕組みです。

    サブスクリプションの枠と、費用の比率は同じとは限りません。 公式の料金のページによると、Pro・Max のプランでは、使用量がプランに含まれ、表示される費用は請求の計算には関係ない、とされています。サブスクリプションの枠(セッションの枠と週の枠)が、ここで出た費用と同じ比率で減るとは、確かめていません。

    料金の単価が変わる境目があります。 Haiku 5.5 の料金は、公式の料金のページによると、入力は100万トークンあたり0.10ドル、出力は0.50ドルです(プロンプトが10万トークン以下の場合。2026年10月17日に確認)。10万トークンを超えると単価が上がります。今回の入力は、それより十分に小さい量でした。

    まとめ

    • 30件の分類は、4通りとも30件正解。ただし、やさしい例だけでの試しです

    • 費用と時間は、まとめて1回のほうが大きく小さくなりました(①と④の費用の差は約74倍)

    • 差の理由は、1回の呼び出しごとに載る土台(約2万5千トークン)です

    • --json-schema で答えの形を決め、structured_output から取り出します

    • 件数と並び順を確かめ、結果は人が抜き取りで見ます

    • 上限は --max-budget-usd と --max-turns で付けます。費用は少し超えることがあります

    • 公式の Batch API は別の仕組みで、今回は使っていません。枠の減りと費用の比率は同じとは限りません

    次の一歩は、手元の文章を10件だけ選び、正解を自分で付けて、まとめて1回の形で動かしてみることです。10件なら短時間で、結果と費用を見比べられます。


    次に読む

    このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。

    この先で分かること(今後の有料記事)

    • 大量の文章を分類・整理する、Claude Code に実行させる指示文とスクリプトの実物

    • 件数が増えたときに、答えの数と並び順を機械で確かめる方法

    • 実際に起きた失敗と、直し方の記録

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。

    あなたへのおすすめ