Skip to content

原文(日本語に翻訳)

@ でファイルをメンションする際のトークンオーバーヘッドを削減 — 生の文字列コンテンツのJSONエスケープを廃止

原文(英語)

Reduced token overhead when mentioning files with @ — raw string content no longer JSON-escaped

概要

Claude Code v2.1.86より、@でファイルをメンションする際にファイルの内容がJSONエスケープされなくなりました。これにより、特にバックスラッシュ、引用符、その他の特殊文字を多く含むファイル(コードファイルなど)でのトークン消費量が削減されます。同じ内容のファイルを参照する際に、より少ないトークンで処理できるようになります。

基本的な使い方

特別な操作は不要です。@でファイルをメンションするだけで、自動的にトークン効率が改善されます。

# プロンプト入力例
@src/main.py のコードをレビューしてください

# 以前: ファイル内容がJSONエスケープされてトークン増加
# 以降: 生の文字列として送信されトークン削減

実践例

大規模コードファイルのレビュー

# 特殊文字を多く含むファイルでの効果が大きい
@src/parser.py のパースロジックを説明してください
@lib/regex_patterns.js の正規表現を最適化してください
@config/settings.json の設定を確認してください

JSONやYAMLなど引用符・コロンを多用するファイルでは、トークン削減効果が特に顕著です。

複数ファイルの同時参照

# 複数ファイルを同時にメンションする場合も効果あり
@src/api/client.py と @src/api/server.py の
インターフェースの違いを教えてください

各ファイルで削減されるトークン数が積み重なるため、複数ファイルを参照する場面では効果が大きくなります。

コンテキストウィンドウの有効活用

# トークン削減により、より多くのファイルを同時に参照可能
@src/models/user.py
@src/models/product.py
@src/models/order.py
@src/models/payment.py
これらのモデル間のリレーションシップを図解してください

注意点

  • この最適化は自動的に適用されるため、ユーザー側での設定変更は不要です
  • トークン削減量はファイルの内容によって異なります(特殊文字が多いほど効果大)
  • プレーンテキストファイルでは削減効果が小さい場合があります
  • この変更はファイルの読み取り内容には影響しません — Claudeへの入力精度は変わりません

関連情報