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

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/

     
     
    無料のOSS、便利なWebサービス、AIツールなど、見つけたものを「これ、何に使えるの?」という視点で紹介。 誰かが作ったすごいものを、必要としている誰かに届けたい。 そんな気持ちで、今日もツールを探しています。

    あなたへのおすすめ