Skip to content

原文(日本語に翻訳)

再開した長いコンテキストセッションをコンパクト化する際に「長いコンテキストリクエストにはExtra usageが必要です」というエラーで失敗する問題を修正しました。

原文(英語)

Fixed compacting a resumed long-context session failing with "Extra usage is required for long context requests"

概要

以前のセッションを再開(resume)した際に、セッションが長いコンテキストを保有している場合、/compact コマンドを実行すると「Extra usage is required for long context requests」というエラーが発生して失敗する問題がありました。これはセッション再開時のコンテキスト管理に問題があり、適切なパラメーターが設定されていなかったためです。今回の修正で、再開したセッションでも /compact が正常に動作するようになります。

基本的な使い方

# 過去のセッションを再開する
claude --resume <session-id>

# または対話的にセッションを選択
claude --resume

# 再開後に /compact を実行(修正後は正常に動作)
/compact

# 修正前: "Extra usage is required for long context requests" エラー
# 修正後: 正常にコンパクト化が完了

実践例

長いセッションの再開とコンパクト化

bash
# 1. セッションの一覧を確認
claude --resume
# → セッション一覧が表示される
# [1] 2026-04-15 大規模リファクタリング作業 (コンテキスト: 180K tokens)
# [2] 2026-04-14 APIドキュメント作成 (コンテキスト: 95K tokens)

# 2. 長いコンテキストのセッションを再開
# → "1" を選択して再開

# 3. コンパクト化を実行
/compact

# 修正後: エラーなく正常にコンパクト化される
# コンテキストが圧縮され、引き続き作業が可能になる

コンパクト化が必要なタイミング

# 以下のような状況で /compact が役立つ:

# 1. コンテキストウィンドウが満杯に近い警告が出ている時
# "Warning: Context window is 85% full"

# 2. 長いセッションを再開して続きから作業したい時
# 古い会話履歴を圧縮して新しい作業に集中

# 3. パフォーマンスを維持しながら長期的なプロジェクトを続けたい時

エラーが発生していた状況の詳細

# 修正前のエラーフロー:
# 1. セッションを再開(--resume)
# 2. コンテキストが長い(100K+ tokens)
# 3. /compact を実行
# 4. エラー: "Extra usage is required for long context requests"

# エラーの原因:
# セッション再開時に「長いコンテキストへのアクセス許可」フラグが
# 正しく引き継がれていなかった

# 修正後:
# セッション再開時にコンテキスト設定が正しく引き継がれ
# /compact が正常に動作する

セッション管理のベストプラクティス

bash
# 長期プロジェクトでのセッション管理

# 1. 作業開始時に前回のセッションを確認
claude --resume

# 2. 必要に応じてコンパクト化(修正後は確実に動作)
/compact

# 3. 作業を継続
「前回の続きから実装を進めましょう」

# 4. 定期的にコンパクト化してコンテキストを管理
# 推奨: コンテキストが70-80%になったら /compact を実行

注意点

  • この修正は --resume でセッションを再開した後/compact に関するものです
  • 新規セッションでの /compact は以前から正常に動作していました
  • コンパクト化を行うと、会話履歴の詳細が失われますが、重要なコンテキストは保持されます
  • 「Extra usage is required」エラーは Claude API のプランによっては引き続き発生する場合があります(アカウントの利用制限による場合)
  • セッションIDを指定した再開(--resume <id>)でも、対話的な再開でも修正が適用されます

関連情報