Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

週次リセット後の低使用率時にレート制限警告が表示される問題を修正（現在は70%使用率で警告）

原文（英語） ​

Fixed rate limit warning appearing at low usage after weekly reset (now requires 70% usage)

概要 ​

Claude Code v2.1.6 では、レート制限警告の表示ロジックが改善されました。以前のバージョンでは、週次リセット直後に API 使用量が少ないにもかかわらず、誤ってレート制限警告が表示される問題がありました。この修正により、使用率が70%に達するまで警告が表示されなくなり、より正確な使用状況の把握が可能になりました。

基本的な使い方 ​

この修正は自動的に適用され、ユーザー側での設定変更は不要です。

レート制限の動作:

  1. API 使用量が週次制限の70%に達すると警告が表示される
  2. 使用量は /stats コマンドで確認可能
  3. 週次リセット後は、正確な使用率に基づいて警告が表示される

実践例 ​

修正前の問題（v2.1.5以前） ​

週次リセット直後に以下のような誤警告が発生していました:

# 月曜日 0:00（週次リセット直後）
# まだほとんど使用していない状態

⚠ Warning: Approaching rate limit
You have used 5% of your weekly API quota
# ← 5%なのに警告が表示されていた

このため、実際には余裕があるのに警告が表示され、混乱を招いていました。

修正後の動作（v2.1.6以降） ​

v2.1.6 では、70%に達するまで警告が表示されません:

# 使用率が70%未満の場合
# 警告は表示されない

# 使用率が70%に達した時点で警告
⚠ Warning: Approaching rate limit
You have used 70% of your weekly API quota
Consider optimizing your usage or waiting for the weekly reset.

使用状況の確認 ​

現在の使用率を確認:

bash
# 統計情報を表示
/stats

# 表示される情報:
# - Total API calls this week
# - Usage percentage
# - Remaining quota
# - Next reset time

警告レベルの段階 ​

使用率に応じた警告:

# 70%未満: 警告なし
Your usage: 45% - No warning

# 70-85%: 注意喚起
⚠ Warning: You have used 75% of your weekly quota

# 85-95%: 警告強化
⚠⚠ Warning: You have used 90% of your weekly quota
Consider reducing usage or waiting for reset.

# 95%以上: 重要警告
⚠⚠⚠ Critical: You have used 98% of your weekly quota
API calls may be throttled or rejected.

使用量の最適化 ​

レート制限に近づいた場合の対策:

  1. 大きなファイルの添付を減らす

    bash
    # 必要なファイルのみを @メンション
# 全プロジェクトではなく、特定のファイルを指定

  2. コンテキストの圧縮

    bash
    # /compact コマンドで会話を圧縮
/compact

  3. 新規セッションの開始

    bash
    # コンテキストをリセットして新規開始
/clear

  4. 使用統計の定期確認

    bash
    # 定期的に使用状況を確認
/stats

週次リセットのタイミング確認 ​

次回のリセット時刻を確認:

bash
/stats

# 表示例:
# Current usage: 75%
# Weekly quota: 1000 requests
# Used: 750 requests
# Remaining: 250 requests
# Next reset: 2026-02-03 00:00 UTC (in 2 days, 5 hours)

レート制限到達時の対処 ​

制限に達した場合:

⚠ Rate limit reached
You have exceeded your weekly API quota.

Options:
1. Wait for weekly reset (2 days, 5 hours)
2. Upgrade your plan for higher limits
3. Use offline features (local file operations)

注意点 ​

  • この修正は Claude Code v2.1.6 で導入されました
  • 警告は使用率70%で表示されるようになり、より余裕を持った対応が可能です
  • 週次リセットは通常、月曜日 00:00 UTC に行われます（プランにより異なる場合があります）
  • 使用量には、全ての API コール（メッセージ送信、ファイル操作など）が含まれます
  • 大きなコンテキストを持つ会話は、より多くの使用量を消費します
  • 誤警告が修正されたことで、実際の使用状況をより正確に把握できます
  • プランによって週次制限の値は異なります

関連情報 ​