この記事の結論:Claude Codeを夜間自動実行したとき、1セッション113ターンで$5.27相当かかることが2026年9月に実測で分かった。その後、同じ作業を70〜90ターン台に削減した3つの対策を書く。
対象読者
Claude Codeを夜間バッチとして動かしており、コストが気になっている人。または、自動化スクリプトをClaudeに書かせる回数(ターン数)を最小化したい人。この記事で書く「ターン数」は、Claude Pro サブスクリプション経由(APIキーなし)での実行を前提にしている。API経由の場合はトークン数とドル単価が変わるが、「ターン数を減らす」という方向性は同じはずだ。
2026年9月の実測——113ターンとは何か
2026年9月25日、夜間自動実行の1セッション(前半のみ)をターン数で測った。
結果:113ターン、$5.27相当。
「1ターン」はClaudeが応答を1回返すことだ。ファイルを読む、コードを実行する、テキストを生成する、それぞれが1ターン以上になる。
113ターンで何をやっていたか(大まかな内訳):
- 状況確認(ファイルの読み込み・統計の確認):約25ターン
- 記事の執筆・追加(Qiita 2本 + ブログ 1本):約40ターン
- 投稿キューへの追加・確認(Threads, blog pool):約20ターン
- 日次ログへの追記:約5ターン
- その他(エラー対処・確認し直し):約23ターン
「その他」の23ターンが問題だった。半分は「確認し直し」、もう半分は「Bashコマンドが弾かれて再試行」だった。
ターン数が増える3つのパターン
パターン1:同じファイルを繰り返し読む
Qiitaのpendingの件数を確認するために check-pool-qiita.mjs を実行し、次に content-pool-qiita.csv を読み、さらに posted-log.json を確認する——これを毎回バラバラにやっていた。
実測では、状況確認だけで14回のツール呼び出しをしていた日があった。これを pool-brief.mjs --qiita-zenn の1回に変えると、同じ情報が1ターンで揃う。
パターン2:Bashで禁止された操作を試みて再試行する
以下のコマンドは権限設定でブロックされており、実行しようとすると拒否される:
- python3
- sed
- cat(ファイル内容の確認)
- echo + ヒアドキュメント(heredoc)
特に「JSONファイルを作ってそのまま渡す」ときに、Bashのヒアドキュメントを使おうとして弾かれることが多かった。弾かれた後で正しい方法(Writeツール直接)を使うと、往復で2〜3ターンの無駄になる。
2026年10月22日の実行ログでは、この原因による余分なターンが1セッションで4回発生していた。
パターン3:書いた記事が品質チェックで弾かれて書き直す
Qiita・Zennの記事追加スクリプト(append-pool-row-qiita.mjs)は、quality フィールドや文字数が足りない場合に弾く。
弾かれた後で指摘を見て全部まとめて直し、1回だけ再実行する——というのが正しいやり方だ。ところが最初のころは「とりあえず書いて弾かれたら直す」を何度も繰り返しており、1本の記事追加に5〜7ターン余分にかかっていた。
弾かれる主な原因:
- quality フィールドがない(pain・payoff・changeが必須)
- tags が文字列で書かれている(配列にしなければならない)
- 本文が800字未満
削減策1——状況確認は pool-brief.mjs 1回だけ
Qiita・Zennの状況確認は node pool-brief.mjs --qiita-zenn の1回で済む。
このコマンドで取得できる情報:
- Qiita・Zennのpending件数と最近の投稿タイトル
- Qiita読まれ方の上位3本・下位3本
- リライト元に使えるmainのnote記事(noteId・URL付き)
- 書く前の条件(品質ゲートの必須項目)
- 使えない型のリスト
以前は check-pool-qiita.mjs・check-pool-zenn.mjs・posted-log.json・pool-brief.mjs を別々に呼んでいた。これを1回に変えることで、状況確認のターン数を14→1に減らした。
node pool-brief.mjs --qiita-zenn
# → Qiita・Zennのpending、最近の投稿、上位/下位、リライト元候補が1回で出る
削減策2——JSONはWriteツールで直接書く
記事のJSONファイルを作るときの書き方が変わった。
Bashのヒアドキュメント(cat <<'EOF' > file.json ... EOF)は権限でブロックされる。ブロックされた後で正しい方法に切り替えると往復のターンが増える。
ファイルの内容を直接Writeツールに渡すことで、Bashを経由せずにJSONを作成できる。ターン数の節約というより「往復のムダゼロ」が正確な表現だが、効果は同じだ。
記事の内容を書いてそのままファイルに保存し、append-pool-row-*.mjs --file=<ファイル> に渡す流れが1往復で終わる。
Bashで使えるのは node ... コマンドだけという制約は、一度把握してしまえば迷わなくなった。
削減策3——検索は1テーマ1回まで
タイムリーな記事(速報)を書くときに、同じキーワードで複数回検索していた。「Dify 1.19.0 リリース」→見つからない→「Dify 新バージョン 2026」→別のサイト→さらに確認、のように繰り返す。
ルールを「検索は1テーマ1回まで」に変えた。1回の検索で必要な情報が揃わない場合は、公式のリリースノートに直接アクセスするか、速報を諦めて翌日に回す。
これは質を下げずにターン数を減らせる数少ない対策だと感じた。検索を重ねて情報を「念のため確認」しても、記事の精度が上がるとは限らないからだ。
削減策の効果
削減策を入れた後の実測(2026年10月末〜11月初旬の平均):
| セッション | 削減前ターン数(平均) | 削減後ターン数(平均) | 変化 |
|---|---|---|---|
| 前半(急ぐ作業) | 113ターン | 78ターン | -31% |
| 後半(急がない作業) | 72ターン | 51ターン | -29% |
| 合計(前半+後半) | 185ターン | 129ターン | -30% |
30%削減は想定より大きかった。ファイルの読み直しが一番効いていたと感じる。
ただし記事の本数・品質は変えていない(削減したのは事務作業の回数だけ)。同じ本数の記事を書いて、確認の手順が効率化されただけだ。
注意点
ターン数を減らすことだけを目標にすると、必要な確認を省いて品質が下がる。たとえば「記事のURLは実在するものを確認してから使う」「実際のログを確かめてから数字を書く」は省略できない。
削減対象は「事務作業の繰り返し」だけだ。
もう一つの注意点は、削減後のターン数が「正しい数字」として固まらないことだ。書く記事の種類(リライトか新規かで大きく変わる)や、その日の速報の有無によって変動する。78ターンはあくまで平均値で、100ターンを超える日もある。
今後
現状の目安は「前半80ターン以下・後半55ターン以下」だ。
これを超えた日は daily-log.md を見て原因を確認する。朝の通知(morning-digest.mjs)でターン数が多い日にアラートが出る仕組みを入れているので、実際にはログを追うことはほとんどない。
Claude Code のモデルや利用制限の変更によってこの数字も変わる可能性があるため、2〜3ヶ月に1回は実測をやり直す予定だ。
関連記事:
https://note.com/light_tern636/n/n6958f1413b15
無人実行が止まる原因の点検を、ココナラで承っています(「Claude Code 点検」で検索)。