資料と指示の 6 つの渡し方 — 使い分けと費用の差
4 分で読む
AI エージェント(Claude Code、Antigravity CLI、Cursor など)に資料を読ませて作業を頼むとき、資料や指示を会話に貼るか、ファイルに置くか、SKILL や AGENTS.md に書くかで迷うことがあります。IT連携マップ編集部は、6 つの渡し方を Claude Code(サブスクリプション)と Antigravity で、会話を 10 ターン(長文は 5 ターン)続けて測りました。
6 つの方法は、それぞれどんな場合に使うのか?
使い分けは、費用ではなく、その情報をどれだけ長く・どこまで使うかで決めます。費用の列は、10 ターン(長文は 5 ターン)の入力の費用を、1b(1 ターン目だけ貼って参照する)と比べたものです。
| 方式 | 置く場所 | 向いている場合 | 1b と比べた入力の費用(Claude Code・Claude 短文/Antigravity・Claude 短文/Antigravity・Gemini 短文/Antigravity・Gemini 長文) |
|---|---|---|---|
| 1a 会話に2回貼り付け | 毎ターン、会話に貼る | 使わない | +136%/+83%/−41%/+173% |
| 1b 会話貼付と参照指示 | 1 ターン目だけ会話に貼る | その場限りの資料・短い作業 | 基準 |
| 2 資料を外部ファイルに | ファイル(article.md など) |
何度も読む長い資料・要約の後も読み直す資料 | +26%/+89%/+29%/+84% |
| 3 指示をSKILLに | SKILL(Claude Code は .claude/skills/) |
特定の作業でだけ使う手順 | +38%/±0%/+12%/+8% |
| 4 指示をAGENTS.mdに | AGENTS.md(Claude Code は CLAUDE.md) | 毎回守らせる共通ルール | +1%/−5%/+6%/−2% |
| 5 資料ファイル+SKILL | ファイル + SKILL | 同じ手順で長い資料を何度も扱う作業 | +114%/+29%/+50%/+20% |
1a・1b・3・4 は 1 ターン目に資料本文を会話に貼り、2・5 はファイルを読ませました。全ターンの数は「6 方式のトークン測定と費用」に載せています。では、費用の差は、どこから生まれたのでしょうか。
費用の差は、どこから生まれたのか?
費用の差がいちばん大きいのは、同じ資料を貼り直すかどうかです。プロンプトキャッシュは、前の問い合わせと先頭から一致する部分だけを安く読みます。2 ターン目に資料を貼り直すと、貼った分は新しい入力として普通の料金で数えられ、しかも履歴に残るので、3 ターン目からは毎ターン送り続けることになります。
編集部の測定では、2 ターン目にキャッシュの外で払った入力が、貼り直した 1a のほうが Antigravity の Claude の短文で 2,461 トークン、Gemini の長文で 19,092 トークン多くなりました。1 ターンの入力は、1a が毎ターン 3,457 トークン(Claude の短文)増えたのに対し、参照する 1b は 929 トークンでした。
SKILL とファイルが安くならなかったのは、エージェントが SKILL やファイルを読みに行くたびに、それまでの内容をもう一度送るからです。資料をファイルに置いた 2 では、エージェントが毎ターンファイルを読み直して上書きし、1 ターンの入力は 1b の 1.3〜3.4 倍でした。Gemini の短い会話だけは、1b の 1 回の入力が小さく、1 度もキャッシュヒットしなかったので、1a のほうが安くなりました(短文と長文の違い)。では、どの順番で置き場所を決めればよいのでしょうか。
どの順番で置き場所を決めればよいのか?
| 確かめること | はい なら |
|---|---|
毎回守らせるルールは AGENTS.md(Claude Code は CLAUDE.md)に書いたか |
共通ルールは済み(AGENTS.md とは) |
たまにしか使わない専門の手順は SKILL に分けたか |
手順は済み(AI のスキルとは) |
長い資料や何度も使う資料はファイル(.md や .txt)に置いたか |
資料は済み |
| 2 ターン目以降に、資料や前の出力を貼り直していないか | 会話は済み |
| 使った後の usage で、キャッシュから読んだトークンの数を確かめたか | 確認は済み |
| 保持時間(製品によって 5 分〜1 時間)を過ぎた会話を、そのまま続けていないか | 時間は済み(キャッシュの保持時間) |
置き場所の使い分けで、費用が大きく下がることはありませんでした。置き場所は、それぞれの用途(共通ルール・手順の使い回し・長い資料)で選び、2 ターン目以降は資料を貼り直さないのが基本です。
ここから先は調査の詳細です(約 8 分)。上のカードだけで決められます。調べた 1 件ずつの記録は IT連携マップ に、出典 URL と調査日つきで公開しています。
調査の詳細
IT連携マップ編集部は、Antigravity CLIで、Claude Sonnet 5.5 と Gemini 3.8 Flash に 6 つの渡し方で同じ課題を出し、会話を続けて全ターンのトークンの数を測りました。短文(2,893 字)は 8 つの決まりで書き直して 10 ターン、長文(39,875 字)は 300 字程度に要約して書き直して 5 ターン続け、2 ターン目以降は毎ターン 1 か所だけを直させました。試行ごとに作業場所を新しくし、各方式 1 回測りました。費用は、測ったトークンの数を公式の料金(1M トークンあたり、Claude Sonnet 5.5: 入力 $2・キャッシュ読み出し $0.10・出力 $10、Gemini 3.8 Flash: $0.75・$0.075・$3.75)で換算した値です。比べる費用は入力だけで、出力(考えるトークンを含む)は回ごとに大きく揺れるので、実験編で別に見積もりました。
貼り直しの測定の差
| ターン | 1a 会話に2回貼り付け | 1b 会話貼付と参照指示 | キャッシュへの影響 |
|---|---|---|---|
| Turn 1 | 【指示】+【白書本文】を送信 | 【指示】+【白書本文】を送信 | 両者とも同じ初期コンテキスト |
| Turn 2 | 「修正して」+もう一度【白書本文】を貼り付け | 「先の文章 の 3 段落目を短くして」とだけ送信 | 1a は貼った分がキャッシュの外 1b は前の内容をキャッシュから読む |
| Turn 2 の測定 | キャッシュの外の入力: 8,573 トークン(長文 22,771) | キャッシュの外の入力: 6,112 トークン(長文 3,679) | 差は短文 2,461・長文 19,092 トークン |
| Turn 3 以降 | 毎ターン資料を貼り直す。1 ターンの入力が毎ターン 3,457 トークン増えた(長文 22,705) | 参照だけ。1 ターンの入力の増え方は 929 トークン(長文 256) | 1a は貼った資料が履歴に積み上がる |
Claude Sonnet 5.5 の短文では、資料を貼り直された AI は 2 ターン目に全文(3,123 字)を書き直し、2 ターン目の出力は 3,195 トークンで、3 段落目(127 字)だけを返した 1b の 5.5 倍でした。10 ターンの入力の費用は 1a が $0.1361、1b が $0.0745(1a 比 −45%)です。出力を足した実際の請求でも、1b は 1a より 39% 安くなりました。
Gemini 3.8 Flash の長文では、2 ターン目の入力のうちキャッシュから読まれた割合は、1a が 58%、1b が 89% でした。5 ターン目には 1a の 1 回の入力が 122,891 トークンになり、5 ターンの入力の費用は 1b が 1a より 63% 安くなりました。
時間と会話の要約の落とし穴
| 落とし穴 | 公式の説明 | 対策 |
|---|---|---|
| キャッシュの保持時間(TTL)が切れる | Claude のサブスクリプション(プランの範囲内)の会話は 1 時間、API キーやクラウド経由は 5 分(Claude Code の公式) | キャッシュが切れると、キャッシュから読んでいた(入力の 0.05 倍)履歴を、もう一度キャッシュへ書き込む(1.25〜2 倍)。同じ履歴の費用が API の料金で 25〜40 倍になる |
| 会話の要約(compaction)で資料の細部が消える | 要約の後、最近読んだり書いたりしたファイルを最大 5 つ読み直す。5,000 トークンを超えるファイルは中身なしのパス(Referenced file)で戻る(Claude Code の公式) |
資料は外部ファイルに置く。会話に貼った資料は要約にまとめられるが、ファイルなら view_file 等で読み直せる |
今回の測定は、ターンを数十秒おきに続けたので、保持時間は 1 度も切れていません。最後のターンの履歴を、保持時間が切れた後にもう一度送ったとすると(1 時間のキャッシュへの書き込みの料金・入力の 2 倍で換算)、Claude の短文の 10 ターン目の後の 1 ターンは、1a が $0.213、1b が $0.111 です。この 1 ターンだけで、1b の 10 ターン分の入力の費用($0.0745)を超えます(Gemini の数も含めた表は実験編)。間の長さだけを変えて Antigravity で測ると、Claude は 6 分、Gemini は 12 分あけた回からキャッシュが切れ、切れた後の 1 ターンの入力はキャッシュから読めた場合の 9.4 倍・6.1 倍になりました(会話の間を空けたときのキャッシュの保持時間と費用)。貼り直して履歴が大きい会話ほど、この損も大きくなります。会話を閉じて 1 時間後に再開すると、作業を中断したまま会話を自動で要約させた場合の約 10 倍かかった、という測定の報告もあります(Qiita の記事 Claude Code の長い会話は、閉じずに席を外したほうが安かった。1時間後に戻った費用は閉じた場合の1割)。
短文と長文で、方式の順位はどう変わったか
全ターンの入力の費用(Claude 短文・Gemini 短文は 10 ターン、Gemini 長文は 5 ターン。すべて測定)の表は、実験編の 1 節にあります。
- Claude の短文と Gemini の長文: 4(AGENTS.md)と 1b が最も安く、3(SKILL)もほぼ同じでした。貼り直す 1a は、Claude の短文で 1b の約 1.8 倍、Gemini の長文で約 2.7 倍の費用でした。
- Gemini の短文: 1b・3・4 は、2 ターン目以降の 1 回の入力が 1.2 万〜1.6 万トークンで、10 ターンとも 1 度もキャッシュヒットしませんでした。1a は貼り直しで入力が 19,492 トークンに届いた 4 ターン目からキャッシュヒットし、6 方式で最も安くなりました。キャッシュヒットする量に届いたかどうかで、順位が逆転したことになります。公式の最小(4,096 トークン)は超えていたので、Gemini では使った後の usage でキャッシュから読んだ数を確かめるのが確実です。
- 外部ファイルの 2・5: エージェントが毎ターンファイルを読み直したり上書きしたりして、1 ターンの入力が増えました。2 は Claude の短文で 6 方式のうち最も高くなりました。同じ依頼を 2 回測ると、2・5 の入力は回ごとに 0.5〜4.6 倍揺れたので、順位は 1 回の測定では言えません。
ツールの往復で 1 ターン目がどれだけ増えたか
エージェントが外部ファイル(view_file)や SKILL.md を読むとき、ツールを使うたびに、それまでの内容をもう一度モデルに送ります。ツールを使わない 1b を基準に、Claude の短文で 1 ターン目の入力の合計を比べると、2 が +455%、3 が +102%、5 が +211%、4 が +1% でした(計算式と表は 実験編 参照)。
Claude では、増えた分の多くがキャッシュから読まれるので、トークンが 2〜5.6 倍になっても、1 ターン目の入力の費用は 1.3〜2 倍で済みました。同じ依頼を別の日に測ると、2 の 1 ターン目の入力は 1.84 倍違いました(今回はファイルを上書きし、確認のスクリプトを書いたため)。
会話中にキャッシュを無駄にしない 4 つの鉄則
鉄則 1: 参照指示を使い、対象のタイトル・見出しを明確に指定する
AI はこれまでの会話履歴を持っています。「先ほど出力した要約の 2 行目を〜」と指示すれば通じるので、貼り直しはやめましょう。ただし会話が長くなったり複数の資料を扱ったりすると、「先の文章」がどれを指すのか曖昧になります。実務では「先ほど生成した『総務省白書 令和5年版要約』の第3段落を〜」や「『article.md』の第3段落を〜」のように、タイトル・見出し・対象物を名指しした参照指示にすると、資料を払い直さずに、どこを直すかも AI に正しく伝わります。
鉄則 2: 指示ファイルを直したら、新しい会話で
Claude Code の公式の説明では、プロジェクトの CLAUDE.md(と AGENTS.md)は会話の始めに 1 度だけ読み込まれます。会話の途中で書き換えてもキャッシュは切れませんが、書き換えた内容もその会話には届きません。直した指示は /clear・/compact・新しい会話の後に読み込まれます。
鉄則 3: キャッシュが使える最小量と「キャッシュヒットしないこと」を知る
キャッシュが使える最小量は、Claude Sonnet 5.5 が 512 トークン、Gemini 3.8 Flash の暗黙のキャッシュが 4,096 トークンです(公式)。ただし Gemini の暗黙のキャッシュはキャッシュヒットの保証が無く、今回の測定では 1 回の入力が 17,459 トークン以下の 20 回は 1 度もキャッシュヒットせず、19,492 トークン以上の 19 回はすべてキャッシュヒットしました。費用は、使った後の usage(キャッシュから読んだトークンの数)で確かめてください。
鉄則 4: 保持時間を過ぎて再開すると、履歴を丸ごと払い直す
キャッシュの保持時間は、Claude Code のサブスクリプションで 1 時間、API キーやクラウド経由で 5 分です(公式)。測ると、Claude Code のサブスクリプションは 58 分あけた回までキャッシュから読めて 61 分から切れ、Antigravity では Claude が 6 分、Gemini が 12 分あけた回から切れました(測定の詳細)。それを過ぎてから同じ会話を続けると、それまでの履歴をキャッシュにもう一度書き込みます。Claude の短文の 10 ターン目の後なら、次の 1 ターンだけで 1a は $0.213、1b は $0.111 です(1 時間のキャッシュへの書き込みの料金で換算)。長い会話を 1 時間以上中断するときは、作業が一段落したときに /compact するか、要約をファイルに残して新しい会話にしてください。約 5.4 万トークンの会話では、外す前に /compact した場合の費用は、そのまま続けた場合の 43% でした。戻ってからの要約は、切れた履歴を全部読み直すので安くなりません(85%)。