速報！Claudeのトークンを無駄遣いしてない？毎回コンテキストを貼り付ける非効率な習慣を改善する方法

Contents

毎回同じ説明を貼り付けていませんか？ 🤔
なぜこの問題が起きるのか
実践的な解決策：CLAUDE.mdを活用する
さらに一歩進める：コンテキストを分割管理する
まとめ

毎回同じ説明を貼り付けていませんか？ 🤔

AI coding assistant / Photo by Daniil Komov via Pexels

「プロジェクトの概要はこうです」「技術スタックはこれです」「フォルダ構成はこんな感じです」……

Claudeを使って開発していると、新しいセッションのたびにこんな説明を延々と貼り付けていませんか？最初のうちはそれでもなんとかなるんですよね。でもプロジェクトが大きくなってくると、この「毎回おなじコンテキストを用意する作業」がじわじわとしんどくなってきます。

これ、トークンの無駄遣いでもあるし、何より時間とエネルギーの無駄遣いなんです。

なぜこの問題が起きるのか

Claudeをはじめとする大規模言語モデルは、会話の外の記憶を持ちません。セッションをまたいだら白紙に戻るわけです。

つまり、あなたが「前回一緒に修正したあのファイル」のことをClaudeは知らない。毎回ゼロから教えなければいけない状態になっています。

これを解決するのが、コンテキストファイルを構造化して管理するというアプローチです。

実践的な解決策：CLAUDE.mdを活用する

Cursor・Claude Codeでは、プロジェクトルートに CLAUDE.md というファイルを置くことで、AIが毎回自動的に読み込んでくれる仕組みがあります。

イメージとしては「プロジェクトの取扱説明書をAIに渡しておく」感じです。毎回口頭で説明しなくて済むようになります 🎉

# CLAUDE.md（プロジェクトルートに置く）

## プロジェクト概要
このアプリはFlaskで作ったタスク管理ツールです。

## 技術スタック
- Python 3.11
- Flask 3.x
- SQLite（開発） / PostgreSQL（本番）
- フロントエンド: Vanilla JS + TailwindCSS

## フォルダ構成
app/
  routes/   # 各エンドポイント
  models/   # DBモデル
  services/ # ビジネスロジック

## コーディング規約
- 関数は必ず型ヒントをつける
- コメントは日本語でOK
- routes/auth.py は直接編集しないこと

## 直近の作業ログ
- セッション#1: ログイン機能を実装
- セッション#2: タスク一覧APIを修正

ポイントをまとめるとこんな感じです👇

✅ プロジェクト概要：何を作っているかを1〜2行で
✅ 技術スタック：バージョンも含めて明記
✅ 編集禁止ファイル：「このファイルは触らないで」を明示
✅ 作業ログ：前回やったことをメモしておく

さらに一歩進める：コンテキストを分割管理する

プロジェクトが大きくなってきたら、CLAUDE.md 一枚では足りなくなってきます。そんなときはサブフォルダごとにコンテキストファイルを分けるのが効果的です。

project/
├── CLAUDE.md           # プロジェクト全体のコンテキスト
├── app/
│   ├── CLAUDE.md       # appディレクトリ専用のルール
│   └── routes/
│       └── CLAUDE.md   # routesの設計方針など

こうすることで、関係のないコンテキストをAIに読ませずに済むので、トークンの節約にもなります。