200K トークン以上の会話が自動圧縮される仕様、大規模プロジェクトでキャッシュ効率が改善しそう。
Claude Code v2.1.299リリース：ファイル参照改善とセッション最適化
原題: v2.1.299
重要度の根拠: Claude Code ユーザーと Mod 開発者向けの多数の改善とバグ修正が含まれるが、破壊的変更なく既存機能の拡張・最適化が主体のため
要約
Anthropic が Claude Code v2.1.299 をリリース。ファイル参照時に実ファイルの内容ではなくパスのみを LLM に渡す `CLAUDE_CODE_DISABLE_FILE_MENTIONS` 環境変数を追加。また 200K トークン以上のアイドル中会話を 1 時間のプロンプトキャッシュ有効期限内に自動圧縮し、次メッセージでの再処理を回避する idle compaction 機能を実装。Mod 向けには `$.prompt.media` で添付画像・文書のバイト読み込み、`$.session.identity()` で セッション認証情報取得、UI コンポーネント拡張（`weight`、`mono` など）を追加。モード選択UX や `/effort` `/fast` コマンド、agent teammate 信任情報漏洩バグ修正など細部の改良が多数。
要点
- ファイル参照時にパスのみ渡す `CLAUDE_CODE_DISABLE_FILE_MENTIONS` 環境変数追加
- 200K+ トークン会話の自動圧縮で キャッシュ再処理を回避
- Mod 向け `$.prompt.media`・`$.session.identity()` で添付ファイル・セッション情報アクセス可能に
- UI コンポーネント API に `weight`・`mono`・`tabular` プロパティ追加
- エージェント表示の信任情報漏洩やクラウドセッション フリーズなど複数バグ修正
開発者向け技術解説（API・実装詳細・破壊的変更）を見る
v2.1.299 adds fine-grained Mod hook enhancements: `$.prompt.media` exposes attached image/document byte streams to `prompt.submit` hooks managed via managed settings; `$.session.identity()` returns session authentication details and organization context for managed `forceLoginOrgUUID` scenarios. New environment variables: `CLAUDE_CODE_DISABLE_FILE_MENTIONS` prevents file content from reaching Claude's file tools (only paths sent); `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` customizes the 200K-token idle compaction threshold; `CLAUDE_CODE_ATTRIBUTION_HEADER=0` disables attribution block in Code tab (Claude apps gateway). UI API changes: `Text`, `Box` components gain `size`, `weight`, `mono`, `tabular` properties; `named spacing` steps (`xs`–`xl`) added to `Box`; `bold` deprecated in favor of `weight`. Self-hosted runner: `--shutdown-drain-sec` flag on orchestrator SIGTERM. `claude plugin eval` adds `--disallow-tools` and `disallowed_tools` case field. Regression fixes: mods submitting prompts mid-turn now respect `--max-turns` / `--max-budget-usd`; installed mods unload immediately when remotely disabled; cloud session freezes on slow uploads resolved.
本文の日本語訳（全文）を見る
## 変更内容
- `CLAUDE_CODE_DISABLE_FILE_MENTIONS` 環境変数を追加：Claude が `@` ファイルメンションのパスを取得してファイルツールで読み込むようになり、ファイル内容そのものは渡されなくなった
- ターミナルに idle compaction を追加：200K+ トークンの会話がアイドル状態で約 54 分間放置された場合、1 時間のプロンプトキャッシュ有効期限が切れる前に圧縮される。これにより次のメッセージで全て再処理されることがなくなった
- `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` を追加して idle compaction の 200K トークン最小値を変更可能に；`settings.json` の `"idleCompaction": false` で無効化できる。両機能は v2.1.290 以降が必要
- `$.prompt.media` を追加：managed settings でインストールされた Mod の `prompt.submit` フックがプロンプトに添付された画像またはドキュメントのバイト列を読み込めるように
- managed settings でインストールされた Mod 向けに `$.session.identity()` を追加：セッションのサインイン方法、managed `forceLoginOrgUUID` にリストされている場合の組織とメールアドレスを取得可能に
- Mod の `Text` に `size`、`weight`、`mono`、`tabular` を、`Box` に `bold` は廃止されて `weight` が推奨される named spacing steps (`xs` から `xl`) を追加
- `claude self-hosted-runner orchestrator` に `--shutdown-drain-sec` を追加：SIGTERM 受信時にポーリングを停止し、飛行中のポール実行と running spawn フックに指定秒数の完了時間を与える
- Mod の `skill.prompt` フックが受け取る情報にスキルのフロントマター、ソース、プラグイン名、ファイルパスを追加
- agent view で `/effort` と `/fast` を追加して新セッションの起動デフォルトを設定可能に；`/model`、`/effort`、`/fast` だけでピッカーが開くように
- background sessions 向けに agent view ピークパネルに「safe mode」行を追加（`--safe-mode` で起動した場合）
- plan mode が bypass permissions 利用時に大部分の編集・コマンド実行前に確認を求めないことについて、一度限りの注記を追加
- `claude plugin eval` に `--disallow-tools` と `disallowed_tools` case フィールドを追加して Agent など特定のビルトインツールを eval 実行から除外可能に
- Claude apps gateway 内の Claude Desktop Code タブ における attribution block（帰属表示）をオフにするサポートを追加：gateway の `code` policy の `env` に `CLAUDE_CODE_ATTRIBUTION_HEADER=0` を設定
- Claude apps gateway 背後の Claude Code セッション内の attribution block にフィールドを追加；`CLAUDE_CODE_ATTRIBUTION_HEADER=0` でブロックを削除可能
- Mod フック `session.append` に `queue` door を追加：Mod がトランスクリプトのキューレコードをプロンプト送信時のものと異なるものにできるように
- organization が Claude Code を管理している場合にスキップされる Mod フックについて、`/plugin` と `claude plugin validate` に注記を追加
- `/usage` 警告に max effort、workflows、always-on context、大型ツール結果を追加
- denied cloud session のエラーを修正（`apiKeyHelper` からのキーが使用中の場合、誤った organization を指す可能性があった）
- custom `ANTHROPIC_BASE_URL` で終わる gateway 固有モデル名の背後にあるセッションが 200K トークン付近で「Prompt is too long · automatic compaction failed」で終わってしまう問題を修正
- Mod がすべてのターンの終わりにプロンプトを送信し続ける場合に、headless 実行が `--max-turns`、`--max-budget-usd`、割り込み、またはホストの会話の終わり後も続く問題を修正
- cloud session がツールグループの 1 行ラベルの後にモデルのフォローアップテキストを表示することがある問題を修正
- Write ツールと Edit ツールが accept-edits mode でセッションの mods フォルダに Mod を作成する際、設定ディレクトリのパスに `.claude` が含まれていない場合に確認なしで作成する問題を修正
- remote でオフにされた後も open session で動作し続ける installed Mod：ターン間でアンロードされるように修正
- Cowork と claude.ai cloud session で Edit と Retry が失敗する問題を修正（メッセージが `UserPromptSubmit` または Mod `prompt.submit` フック実行中に停止された場合）（v2.1.296 での回帰）
- description なしで起動された agent teammate が task description に認証情報の一部を保持し続ける問題を修正
- 遅い接続で大規模なイベント バッチがアップロード完了できない場合に Remote Control または cloud session の claude.ai ビューがフリーズする問題を修正
- sandboxed shell の…（本文が途中で切れている）
出典: https://github.com/anthropics/claude-code/releases/tag/v2.1.299
媒体: Claude Code Releases
※本記事は Anthropic / Claude 関連の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。