shiichan

Claude Code セッションを無駄なく使い倒す6つのコツ、Claude Blog が公開!

みんな、しぃちゃんだよ! 今日は Claude Code を使ってる人みんなに知ってほしい話を見つけちゃった!

Claude Blog claude.com

なにが発表されたの?

今回紹介するのは Claude Blog に掲載された「Maximizing the value of your Claude Code sessions」っていうガイド記事なの。著者は Lydia Hallie さんで、Claude Code のセッションをどう使えばトークンを無駄にせず、コストを抑えて価値を最大化できるかっていう実践的な Tips がまとめられてるよ。

新機能の発表じゃなくて、既存の Claude Code をより賢く使うための知識ガイドっていう位置づけなの。記事の冒頭では、テストファイルを読んで編集してテストを流すだけの効率的なセッションと、grep で探し回って複数ファイルを読んでから編集するような非効率なセッションを比べていて、同じ修正でもコストが大きく変わるって指摘してるよ。

なぜ重要なの?

昔のコード編集ツールは定額制が多かったけど、Claude Code はトークンベースの課金なの。だから「何をどう頼むか」でコストが変わっちゃうんだって。しぃちゃんもびっくりしたんだけど、トークンの値段自体もいくつかの要因で変わるみたい。

  • モデル選択 — 大きいモデルほど計算量が多くて価格も高い。難しい問題は大きいモデル、ルーチン作業は小さいモデルが向いてるって
  • 入力(prefill)と出力(decode)— 出力トークンは入力トークンのおよそ5倍のコストがかかるらしいの。GPU が長く動くからなんだって
  • プロンプトキャッシュ — 同じ先頭部分を再送信するとサーバーが前回の計算結果を再利用してくれる。キャッシュ読み取りは入力価格の0.1倍まで下がるけど、キャッシュ書き込みは入力の最大2倍かかるんだって

このキャッシュ、実はけっこう繊細で、/model/effort の切り替え、Fast mode の切り替え、/compact の実行のどれかをやると全部作り直しになっちゃうの。しかも有効期限があって、サブスクリプション利用なら1時間、API キーなら5分で切れちゃう(ENABLE_PROMPT_CACHING_1H=1 を設定すれば API キーでも1時間に延ばせるみたい)。だからこそ、セッションの最初に /model/effort を決めておくのが大事なんだね。

これで何が変わるの?

このガイドを読むと、普段なんとなく使ってた /clear/compact の使い分けがはっきりするよ。Claude Code を毎日使う開発者さんにとっては、同じ作業をしていても意識ひとつでコストと快適さが変わってくるの。特にセッションが長くなりがちな人、大きめのリポジトリで作業してる人には嬉しい内容だと思う!

深く潜ってみよう

記事ではセッション中にコンテキストへ積み上がっていくものについても詳しく説明してるよ。

  • ファイルの読み取り結果やコマンド実行結果は、一度読み込むと以降の全ターンで再送信され続ける(キャッシュ読み取りとはいえ文脈は圧迫される)
  • @ でファイルをメンションすると、Read 呼び出しを使わずに最初のリクエストへ直接ファイルが添付される。ただし同じターンで同じファイルを何度もメンションすると、ファイルが複数コピー添付されちゃうことがあるので、メンションは最初に1回だけがおすすめなんだって
  • コマンドの出力が長い場合(3万文字を超えるくらい)は自動でファイルに書き出されて、会話にはパスだけが残る仕組みがあるみたい。それでも数百行のテスト結果みたいな出力がそのまま会話に残ると、以降の全ターンで再送信されちゃうから、CLAUDE.md に npx vitest run <file> --reporter=dot みたいな静かなコマンドを書いておくのがコツなんだって
  • 出力が多いジョブは、サブエージェントを使って別のコンテキストウィンドウで処理させるのも手。ログ処理みたいなノイズの多い仕事は、モデルに haiku を指定したサブエージェントに任せるとメインの会話が汚れにくいよ
  • /rewind は直前の数ターンを削除するだけだから、キャッシュが有効なうちならコストがかからない。一方 /compact は会話全体を要約し直すからサマリー生成のコストがかかるの(ただし直前の会話がキャッシュに残っていれば比較的安いみたい)

記事の最後では、コスト削減への効き目が大きい順に「セッションの長さ(コンテキストの積み上がり)」「ターン数」「モデルと effort の選択」「入力の書き方」の4つが挙げられていたよ。

まとめ

  • Claude Blog が Lydia Hallie さんによる Claude Code のトークン効率化ガイドを公開したよ
  • 出力トークンは入力の約5倍、キャッシュ読み取りは入力の0.1倍というコスト構造がポイント
  • /model/effort はセッション開始時に決める、タスクの切れ目では /clear、休憩前は /compact、直前の失敗ターンだけ消したいなら /rewind が使い分けのコツ
  • @ メンションやノイズの少ないコマンド、サブエージェントの活用で無駄なコンテキストの積み上がりを防げる
  • Claude Code を日常的に使っていて、少しでもコストや快適さを改善したい人にはすごく刺さる内容だと思うな!