Claude Codeが50%表示なのに週間制限警告が出る原因と対処法

3つの異なるカウンターを理解する

警告の意味を正確に把握するには、以下の3つの指標を区別する必要があります。

1. セッションコンテキスト表示（Context Window）：現在の対話履歴、システム指示、読み込んだファイルがセッション上限（例：200kトークン）のうちどれだけ占めているかを示します。50%という数字は、そのセッション内にまだ半分余裕があることを意味するに過ぎません。
2. サブスクリプションの週間ローリング制限：契約プランに基づき、過去7日間に利用可能な計算リソースやトークンの上限です。直近の数日間で大量のコード生成を行った場合、新規セッションであっても週間上限に達することがあります。
3. APIレート制限とトークン残高：APIキーを直接利用する場合、1分あたりのリクエスト数（RPM/TPM）およびチャージ残高に基づいて制御されます。

Webプランの制限や待ち時間に左右されずにターミナル環境で開発を続けたい場合、専用のAPIゲートウェイを活用する方法があります。たとえばBetterTokenを利用すれば、自身のAPIキーで従量課金制によりClaudeモデルにアクセスでき、詳細な利用ログも確認可能です。設定手順はBetterToken Docsで案内されています。

状況の診断と利用状況の確認手順

制限警告が表示された際、無意味な再試行を繰り返すと一時ロックが長引く恐れがあります。次の手順で状況を確認してください。

ステップ1：正確なエラーメッセージの確認

ターミナルの出力を確認します。

• Approaching weekly usage limit：週間制限の閾値に近づいていることを示す事前通知。
• You have reached your usage limit：ローリングウィンドウがリセットされるまでのリクエスト停止。
• HTTP 429 Too Many Requests：短時間の同時リクエスト過多、またはAPI残高不足。

ステップ2：Webダッシュボードの確認

プロバイダーの管理画面で利用状況を確認します。

• 次回のリセット日時（Reset Time）を確認します。
• 日別の利用グラフを確認し、どの作業で消費が増えたかを把握します。

作業を中断する基準と安全なハンドオフ手順

週間上限が近い状態で大規模なリファクタリングを継続すると、作業途中で突然停止するリスクがあります。

以下の安全なハンドオフ手順を実行してください。

1. Gitで現在の作業を退避：未コミットの変更を一時ブランチに保存します。

git checkout -b task/pause-checkpoint
git add -A
git commit -m "checkpoint: リセット前の状態保存"

2. 引継ぎ文書（HANDOFF.md）の作成：完了した項目、残りのタスク、変更したファイル一覧を記録します。これにより、次回セッションでプロジェクト全体を再読み込みすることなく作業を再開できます。

3. アクティブセッションの終了：ターミナルを閉じ、バックグラウンドでの不要なポーリングを停止します。

WebサブスクリプションとAPI接続の違い

API残高を追加すればClaude CodeのWebプラン制限が解除されると誤解されることがありますが、両者は独立した仕組みです。

この違いを把握し、日常の相談にはWebプラン、大規模なコーディングにはAPIゲートウェイを使い分けることで、開発の継続性を確保できます。