Paneflow は、コンピューター上のすべてのアカウントについて、Claude Code と Codex のサブスクリプションをどれだけ使ったかを表示します。
サイドバーのフッターにあるカプセル、アカウントごとの詳細を示すバブル、そして 1 年分の日次アクティビティを表示する Settings の **Usage** ページです。
Paneflow は認証情報やトークンを読み取らず、使用量 API を自分で呼び出すこともありません。

## アカウント [#accounts]

アカウントは、1 つのエージェントと 1 つの設定ディレクトリの組み合わせです。
Paneflow は、デフォルトの `~/.claude` と `~/.codex` ディレクトリ、環境で `CLAUDE_CONFIG_DIR` または `CODEX_HOME` を設定しているすべてのスペース、同じ設定をしているすべてのエージェントプロファイルを一覧にします。
同じディレクトリを指す 2 つのスペースは、1 つのアカウントを共有します。
API キー（`ANTHROPIC_API_KEY`、`OPENAI_API_KEY`）で課金されるアカウントにはプランの上限がなく、その旨が表示されます。

## サイドバーのカプセル [#the-sidebar-capsule]

カプセルはフィルターと Settings ボタンの間にあります。
リングとパーセンテージは、アクティブなスペースのアカウントのうち最も厳しい上限を示します。スペースがアカウントを設定していない場合は、デフォルトのアカウントが対象です。
リングは 80% 未満ではアクセントカラー、80% 以上で琥珀色、95% 以上で赤になります。
カーソルを合わせると、カプセルが示すアカウントと時間枠が表示されます。

カプセルをクリックするか、フォーカスした状態で Enter または Space を押すと、バブルが開きます。
各アカウントには、セッションと週間の時間枠がメーター付きで表示され、メーターのツールチップにはリセット時刻が、さらに週のペースラインが表示されます。
ペースラインは、現在のペースで週間上限に達する時刻か、リセット時点で週のどれだけを使っているかのどちらかを示します。
下部の **Open usage settings** で Usage ページが開きます。

カプセルを非表示にするには、**Customize sidebar › Show** で **Usage** をオフにするか、`sidebar_show.usage` を `false` に設定します。
Claude Code と Codex のアカウントがない場合、カプセルは表示されません。

## Usage ページ [#the-usage-page]

**Settings › Usage** には、アカウントごとに 1 枚のタイルが表示されます。タイルには 2 つのリング（外側が週、内側がセッション）、リセット時刻、ペースラインがあります。
**Refresh** を押すと、すべてのアカウントに現在の上限を問い合わせます。

**Activity by agent** では、直近 53 週間にアクティビティがあるアカウントごとに、1 日 1 セルのレジスターが表示されます。
指標は **Turns**、**Tokens**（入力と出力、キャッシュを除く）、**Active time** から切り替えられます。
すべてのレジスターは同じスケールを共有するため、エージェントにかかわらず、セルが濃いほどアクティビティが多いことを意味します。
日にカーソルを合わせるか、Tab でレジスターに移動してから矢印キーで日を移動すると、その日の各エージェントの値を読めます。

Paneflow はこのアクティビティを、このコンピューター上の自身のペインで動くエージェントから独自に集計します。
ほかの場所で実行したセッションは把握しません。

### 過去のアクティビティをインポートする [#import-past-activity]

アクティビティ台帳が空の状態で Paneflow を初めて起動すると、既存の Claude Code のトランスクリプト（各 Claude 設定ディレクトリ内の `projects/**/*.jsonl`）と Codex のセッションファイルをバックグラウンドで読み込み、まだ集計していない日を埋めます。
ページ下部の **Import past activity** でインポートを再実行できます。
2 回インポートしても同じ日を二重に数えることはなく、当日は常にライブの集計に任されます。

インポートは新しいファイルから順に読み、10,000 ファイルまたは 2 GB に達すると停止します。
途中で停止した場合、ページには **Imported the last \{n\} days** と表示されます。
Claude Code はデフォルトでトランスクリプトを 30 日間保持する（設定の `cleanupPeriodDays`）ため、それより古い日は空のままです。

## 上限の取得元 [#where-the-limits-come-from]

Paneflow は、あなた自身のログインでサインインしたエージェント自身のプログラムからのみ上限を読み取ります:

- **Claude Code のステータスライン。** Claude Code 連携をインストールし、独自のステータスラインがない場合、Paneflow は Claude の設定の `statusLine` を `paneflow-ai-hook StatusLine` に設定します。
  各応答の後、Claude Code は自身が報告する上限をこのコマンドに渡し、Paneflow がそれをカプセルに転送します。
  このコマンドは何も出力しないため、ステータスラインは空のままです。
- **インストール済みの Claude Code と Codex のバイナリ。** バブルを開くか Usage ページを更新すると、Paneflow はインストール済みの `claude` にメッセージを送らずに使用量を問い合わせ、`codex app-server` にレート制限を問い合わせます。
  各アカウントへの問い合わせは最大で 30 秒に 1 回です。
- **Codex のセッションファイル。** Codex のターンが終わるたびに、Paneflow は Codex が最新のセッションファイルに書き込んだ上限を読み取ります。

アカウントごとに、最も新しい読み取り結果が優先されます。

### 独自のステータスラインがある場合 [#if-you-have-your-own-status-line]

Paneflow は、あなたが設定したステータスラインを変更しません。
代わりにインストール済みの Claude Code バイナリから上限を読み取るため、カプセルは同じように動作します。
この読み取りが成功するまで、アカウントには次のメッセージが表示されます:「Claude Code has not reported plan limits for \{folder\} yet. Check that it is installed and signed in for this folder, then reopen this panel.」

## Paneflow が保存するもの [#what-paneflow-stores]

すべて Paneflow ホーム（`~/.paneflow`、Windows では `%USERPROFILE%\.paneflow`）の `usage` フォルダーに保存されます:

- `usage/plans.json`: アカウントごとに、各時間枠の使用率とリセット時刻、読み取った時刻、エージェントのバージョン。
- `usage/ledger.json`: アカウントごと、直近 400 日の各日について、ターン数、アクティブ時間、入力と出力のトークン数、さらに読み込むトランスクリプトのパスと読み取り位置。
  プロンプトや応答のテキストは保存しません。

## オフにする [#turn-it-off]

`paneflow.json` で `usage.plan_limits` を `false` に設定すると、カプセルが非表示になります。
次に Paneflow が Claude Code 連携を更新するとき（起動時、または `paneflow integrations install claude-code` の実行時）、Paneflow が設定したステータスラインも削除されます。
`paneflow integrations remove claude-code` でも削除されます。