知らないと損するClaude Code: コストと速度を劇的に改善する5つの高度な設定術
【このTipsで何ができる？】
プロジェクトルートのclaude-code.yamlを最適化することで、APIコストを大幅に削減し、応答速度を向上させます。タスクの複雑さに応じてOpus、Sonnet、Haikuを自動で使い分け、不要なファイルがコンテキストに含まれるのを防ぎます。さらに、プロンプトキャッシュを活用することで、短期間の連続したリクエストを高速化し、コーディング体験を向上させることが可能です。
手順・使い方
プロジェクトのルートディレクトリにclaude-code.yamlファイルを作成し、以下の設定を追記・カスタマイズします。これにより、claudeコマンドの挙動をプロジェクト単位で最適化できます。
1. Agents: モデルをタスクに応じて自動で振り分ける
プロンプトのキーワードに応じて、最適なモデル（Opus/Sonnet/Haiku）を自動選択させます。複雑な設計はOpus、簡単な修正はHaikuのように使い分けることで、コストとパフォーマンスのバランスを取ります。
# claude-code.yaml
agents:
- name: high-reasoning-agent
model: claude-3-opus-20240229
when: "複雑な設計 or アーキテクチャ or アルゴリズム"
- name: fast-coding-agent
model: claude-3-sonnet-20240229
when: "リファクタリング or テストコード or 型定義"
- name: simple-task-agent
model: claude-3-haiku-20240307
default: true
2. Skills: 特定のファイル群でのみツールを有効化する
skills（ツール）が有効になる条件をpathsで指定します。例えば、データベース関連のスキルは、スキーマファイルやDBクライアントのコードをコンテキストに含めた場合にのみ発火させることで、不要なツール呼び出しを防ぎます。
# claude-code.yaml
skills:
- name: my-database-schema-skill
paths:
- "prisma/schema.prisma"
- "src/db/**/*.ts"
3. Hooks: 不要なファイルをコンテキストから除外する
hooksとdenyを使って、node_modulesや.envファイルなど、コンテキストに含めたくないファイルやディレクトリを宣言的に定義します。これにより、コンテキスト汚染を防ぎ、トークン数を節約します。
# claude-code.yaml
hooks:
- if: "path(node_modules/**)"
then: deny
- if: "path(.env*)"
then: deny
- if: "path(dist/**)"
then: deny
4. Prompt Cache: 短時間の連続リクエストを高速化する
cacheを有効にすると、指定した時間内（例: 5分）の類似したプロンプトはキャッシュから応答され、APIコールを削減します。同じファイルセットについて連続で質問するデバッグ作業などで絶大な効果を発揮します。
# claude-code.yaml cache: ttl: 5m
5. CLAUDE.md: 指示を簡潔に保つ
プロジェクトの基本ルールを記述するCLAUDE.mdは、最も重要な10個程度のルールに絞り込みます。指示が簡潔であるほど、モデルは意図を正確に理解し、コンテキストトークンの節約にも繋がります。
活用シーン
・大規模なモノレポ開発: hooksで不要なディレクトリをdenyし、skillsのpathsで関連コード群にスコープを絞ることで、巨大なリポジトリでも正確かつ高速なコード生成が可能になります。「フロントエンドのコンポーネントを修正して」と依頼した際に、バックエンドのコードがコンテキストに含まれるのを防ぎます。
・コスト意識の高いチーム開発: agentsによるモデルの自動振り分けは、チーム全体のAPIコストを最適化するのに非常に有効です。高価なOpusモデルは本当に必要な場面に限定し、日常的なコーディングサポートはSonnetやHaikuに任せる文化を醸成できます。
・対話的なリファクタリング・デバッグ: cacheを有効にすることで、「この関数のバグを直して」「テストケースを追加して」「もっと効率的な書き方にして」といった一連の対話が非常にスムーズになります。待ち時間が減るため、思考を中断させずに開発に集中できます。
注意点・Pro Tip
・設定ファイルの検証: claude-code.yamlの記述を間違えると意図通りに動作しません。編集後はターミナルでclaude --validateコマンドを実行し、構文エラーがないか確認する習慣をつけましょう。
・Pro Tip「1Mコンテキストは細く長く保つ」: 長大なコンテキストを扱う際の設計原則です。一度に大量のファイルをclaude addで渡すのではなく、対話を通じて必要なファイルを少しずつ追加していく方が、モデルは文脈を維持しやすくなります。対話の履歴そのものが「細く長い」コンテキストとなり、精度向上に繋がります。
※Claude Codeは継続的にアップデートされます。最新情報は公式ドキュメントをご確認ください。
情報源：@ctsgofficial のポストをもとに編集部が解説記事として構成しました。
コメント