Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

/context の空き領域とメッセージ内訳がヘッダーのパーセンテージと一致しない問題を修正しました。

原文（英語） ​

Fixed /context Free space and Messages breakdown disagreeing with the header percentage

概要 ​

/context コマンドで表示されるコンテキスト情報の中で、「空き領域」と「メッセージ内訳」の数値が、ヘッダーに表示されるパーセンテージと一致していないというバグがありました。このアップデートにより、すべての表示が一貫した計算方法で同期されるようになりました。ユーザーは正確なコンテキスト使用状況を把握できます。

基本的な使い方 ​

bash
# コンテキスト使用状況を確認
/context

# 修正後の表示例（数値が一致している）:
# コンテキスト使用状況: 45%
# ────────────────────────────────
# 使用済み: 45,000 トークン
# 空き領域: 55,000 トークン (55%)  ← 修正前: 不一致の値が表示されることがあった
#
# メッセージ内訳:
# - システムプロンプト: 5,000 トークン (5%)
# - 会話履歴: 35,000 トークン (35%)
# - 現在のメッセージ: 5,000 トークン (5%)

実践例 ​

コンテキスト管理のベストプラクティス ​

bash
# 長期セッションでのコンテキスト管理

# コンテキスト使用状況を定期的に確認
/context

# 修正後: 表示される数値が全て一致しているため、信頼できる情報として活用できる

# コンテキストが80%以上になったら圧縮を検討
# ヘッダーのパーセンテージと /context の詳細が一致するため、正確な判断ができる
/compact

コンテキスト最適化のタイミング ​

bash
# セッション開始後、定期的にコンテキスト使用状況を確認

# 作業前の確認
/context
# 使用済み: 20% (良好)

# 大量のファイルを読み込んだ後
/context
# 使用済み: 65% (要注意)

# 圧縮を実施
/compact

# 圧縮後の確認
/context
# 使用済み: 30% (圧縮が効果的だった)

# 修正後: ヘッダーの表示と詳細の数値が常に一致している

コンテキストサイズを考慮した作業計画 ​

bash
# 大きなコードベースを扱う場合のコンテキスト管理

# プロジェクトの大きなファイルを読む前にコンテキストを確認
/context
# 現在のコンテキスト: 25% 使用
# 空き領域: 75% (75,000 トークン)

# ファイルサイズを確認
wc -c large_file.ts  # 200,000 文字 ≈ 50,000 トークン

# コンテキストに収まることを確認してから読み込む
# 修正後の正確な数値を信頼できる

claude "large_file.ts を詳しく分析して"

# 分析後のコンテキスト確認
/context
# 使用済み: 75% (予測通り)

自動化スクリプトでのコンテキスト監視 ​

bash
#!/bin/bash
# コンテキスト使用量を監視して警告するスクリプト

check_context() {
  # /context コマンドの出力を解析
  # 修正後: 数値の一貫性が保証されているため、信頼できる解析ができる
  
  context_output=$(echo "/context" | claude --stdin 2>&1)
  
  # パーセンテージを抽出
  percentage=$(echo "$context_output" | grep "使用済み" | grep -oP '\d+(?=%)')
  
  if [ -n "$percentage" ]; then
    echo "コンテキスト使用率: ${percentage}%"
    
    if [ "$percentage" -gt 80 ]; then
      echo "警告: コンテキストが80%を超えています。/compact を検討してください。"
    fi
  fi
}

check_context

注意点 ​

  • この修正はUI表示の一貫性に関するバグ修正です
  • コンテキスト計算ロジック自体は変更されておらず、表示の同期が修正されました
  • 修正後は /context の全ての数値が同じ計算に基づいて表示されます
  • コンテキストウィンドウのサイズはモデルによって異なります（Claude Sonnetは200Kトークンなど）
  • /context の情報を基に /compact の実行タイミングを判断することが推奨されます

関連情報 ​