Claude Codeのトークン消費検証、初期起動で3万超・実用時7.5万のコスト影響

Anthropicが提供する開発者向けのコマンドラインツール「Claude Code」において、ユーザーが具体的な指示を入力する前の初期化段階で、大量のトークンが消費されていることが明らかになった。検証によると、最小限のプロジェクト構成であっても起動時に約33,000トークンが消費され、実際の開発環境を模した実用構成では約75,000トークンにまで達する。この挙動は、Claude Codeが高度な自律性を実現するために、コンテキストウィンドウへ大量の事前情報を注入していることに起因する。

起動時に送信されるデータには、Claude Code自体のシステムプロンプト、実行可能なプラットフォームツール（ファイル操作、検索、シェル実行など）の定義、プロジェクトのディレクトリ構造（ファイルツリー）、および直近のgitコミット履歴やステータスが含まれる。ツールはこれらの情報を事前に把握することで、ユーザーの曖昧な指示に対しても適切なファイルを自律的に選択し、編集やテストを実行できる仕組みとなっている。しかし、この設計がトレードオフとして初期トークン消費の肥大化を招いている。

Claude Codeの実行エンジンである「Claude 3.5 Sonnet」のAPI料金（入力100万トークンあたり3.00ドル、出力100万トークンあたり15.00ドル）を基に、1回あたりのコストを試算する。Anthropic of APIにはプロンプトキャッシュ機能が備わっており、2回目以降の同一コンテキストの送信時にはキャッシュヒット料金（100万トークンあたり0.30ドル）が適用される。しかし、ファイルの変更や新規指示によってキャッシュが破棄された場合、都度フルコストが発生する点に留意する必要がある。

以下は、初期構成（約33,000トークン）と実用構成（約75,000トークン）における、入力トークン消費量と1回あたりのAPIコストの比較表である（1ドル＝150円換算、出力コストは除く）。

実用構成においてキャッシュが効かない状態（キャッシュミスまたは初回送信）で10回コマンドを実行した場合、入力だけで約337円のコストが発生する。これに出力トークン（生成されたコードや説明）のコストが加算されるため、実際の運用コストはさらに高くなる。

競合するAIコーディングアシスタントである「Aider」や「Cursor」などは、ユーザーが明示的に指定したファイルや、RAG（検索拡張生成）によって関連性が高いと判断されたコード断片のみをコンテキストに含めるアプローチを採用している。これにより初期トークン消費を数千トークン程度に抑えているが、一方でプロジェクト全体の構造を俯瞰した自律的なタスク解決能力においては、Claude Codeに劣る場合がある。Claude Codeは、コンテキスト全体をモデルに丸ごと渡すことで、より正確で一貫性のあるコード生成を実現している。

開発者がこのツールを実用的に運用するにあたっては、不要なファイルをコンテキストから除外する設定が不可欠となる。プロジェクトのルートディレクトリに「.claudecodeignore」ファイルを配置し、ビルド生成物や外部ライブラリ（node_modulesなど）、画像などのバイナリファイルを明示的に除外することで、トークン消費を大幅に抑制できる。また、プロンプトキャッシュの有効期限（通常5分間）を意識し、短時間に集中して作業を行うといったワークフローの工夫が、開発効率とコストパフォーマンスを両立させる鍵となる。