
AIのトークン、何に使った? ccusage・RTK・context-modeで見直す
AIにコードの相談をしていると、回答だけでなく、指示や会話の履歴、ターミナルの結果も読み込まれます。長いログや大量の検索結果を何度も会話へ入れると、必要な情報が埋もれたり、利用量が増えたりします。
そこで役割の違う3つの道具を組み合わせます。ポイントは「記録する」「短くする」「必要な所を探す」を分けること。どれか一つが全部を解決するわけではありません。
| ツール | すること | たとえるなら |
|---|---|---|
| ccusage | AIコーディングツールのローカル記録を日別・月別に集計 | 家計簿 |
| RTK | ターミナルの長い結果を短く整理してAIに見せる | 長い報告の要点版 |
| context-mode | 大きな結果をローカルに置き、必要な部分を検索する | 資料棚と検索係 |
ccusage:使い過ぎに気づくための記録係
Claude CodeやCodexなどがPCに保存した利用記録を読み、日別・月別・セッション別の使用量を表示します。たとえば月末に「どの日に利用が多かったか」「どの作業で長い会話になったか」を振り返れます。
ただし、ccusage自体がトークンを減らすわけではありません。ClaudeやCodexの公式利用残量を表示するメーターとも違います。表示される金額はモデル単価などを使った推定で、定額プランの請求額とは一致しない場合があります。APIの明細や契約プランの上限は、各サービスの公式画面で確認してください。Codexのログ集計は公式ガイドでベータ扱いです。
RTK:コマンドの「全部表示」を短くする
テスト結果が何百行も出たとき、RTKは成功した項目をまとめたり、失敗箇所を見つけやすくしたりして、AIが読むコマンド結果を小さくします。検索やGitの状態確認など、対応するコマンドで役立ちます。
公式の削減率はコマンド出力のサイズについての数字で、請求額が同じ割合で下がるという意味ではありません。指示文や過去の会話、AIの回答も利用量に関係します。また、要約から漏れた行が原因調査に必要なこともあるので、大事な判断では元の結果も確認します。
context-mode:大きな資料を会話に詰め込まない
数千行のテストログや大量のWeb資料を、AIとの会話に毎回丸ごと入れる代わりに、context-modeはローカルの索引へ置いて必要な箇所を検索します。
例として、テストが失敗したときに「失敗したテスト名と、最初のエラーの前後を探して」と頼む使い方があります。関連部分を読んで原因の候補を考え、必要なら人が元ログを見直します。すべてのデータを最初から読み込ませる手間を減らしやすい一方、検索や抜粋の結果だけで正しさが保証されるわけではありません。
Claude CodeやCodexとどう違う?費用は?
Claude CodeやCodexは、指示を理解して作業するAIエージェントです。今回の3つは、その代わりではなく、周辺の作業を助けます。
| 比較 | 役割 | ソフトの費用 | 別にかかるもの |
|---|---|---|---|
| ccusage | 使用量を記録・集計 | 無料で利用できるCLI | Claude/Codexの契約・API料金は別。金額は推定値 |
| RTK | コマンド出力を短くする | 通常利用に月額課金なし | AI側の料金は別。配布版ごとのライセンス条件を確認 |
| context-mode | 大きな結果を保存・検索 | 個人が自分で使うソフト自体に月額利用料なし | AI側の料金、導入・更新の手間。ELv2ライセンスの制約あり |
| Claude Code / Codex | AIとしてコード作業を行う | 利用プランやAPI方式で異なる | プランの利用上限、API従量料金など |
この3つを入れたから、ClaudeやCodexの契約料金が自動的に安くなるわけではありません。ccusageで傾向を見つけ、RTKで長いコマンド結果を減らし、context-modeで大きな資料から必要な箇所を探す。作業に合った工夫を選ぶための道具です。context-modeはソースを読めますが、一般的なオープンソースと同じ条件ではありません。仕事で使う前に最新ライセンスを確認してください。
仕事での具体例
「テストが落ちたので原因を調べて」とAIに頼む場面を考えます。最初にRTKでテスト結果の失敗箇所を見やすくする。それでもログが大きければ、context-modeでエラー前後だけを検索する。修正とテストが終わったら、ccusageでその日の利用傾向を見て、次回は不要なファイルを読ませないなどの改善を一つ決めます。
小さな作業なら何も追加せず、いつものClaude CodeやCodexだけで十分です。長いログや繰り返しの調査が多い人ほど、役割ごとの道具を試す価値があります。まずは機密情報を含まないテスト用プロジェクトで使い、料金・保存先・削除方法を確かめてください。
まとめ
ccusageは「どれだけ使ったか」を見る。RTKは「出力を短くする」。context-modeは「大きな結果から必要な所を探す」。計測、圧縮、検索を分けると、AIを使う作業のどこに手を入れるべきか考えやすくなります。
参考:
ccusage ガイド:https://ccusage.com/guide/
ccusage Codex対応:https://ccusage.com/guide/codex/
RTK公式:https://github.com/rtk-ai/rtk
context-mode公式・ライセンス:https://github.com/mksglu/context-mode
Claude Code費用:https://code.claude.com/docs/en/costs
ChatGPTプラン:https://chatgpt.com/pricing/