Claude Code 使用状況ステータスライン

ラベルの代わりにアイコンを表示

• ⌛ 5時間のスライディングウィンドウ
• 📅 モデルを問わない7日間
• F 現在のモデルのゲージ（ここでは Fable）
• 💰 残高または残りクレジット
• 💸 API に課金されるアカウントでのセッション料金
• 🧠 コンテキストウィンドウ

モデルごとのゲージにはアイコンではなく頭文字（F、s、o）を使用しています。ラベルは API から取得されモデルによって変わるため、固定アイコンではいずれ誤った表示になってしまうからです。

3つのOSで読みやすい

Linuxでは、以前のセッション記号が四角形になっていました。エンコーディングの問題ではなく、出力は正しくUTF-8です。その文字が、等幅フォントでは単純に対応していないUnicodeブロックに含まれていたためです。

採用したピクトグラムは、デフォルトでカラー表示される絵文字なので、システムに応じてSegoe UI Emoji、Apple Color Emoji、またはNoto Color Emojiで自動的に表示されます。最小構成のLinuxディストリビューションでは、fonts-noto-color-emojiをインストールすれば解決します。

モデルとクレジットごとのゲージ

移行済みのアカウントでは、AnthropicはSonnetとOpusの2つの固定ゲージではなく、現在のモデルに紐づいた週間ウィンドウを返すようになりました。そのため、表示される文字はモデルに応じて変わり、Fableの場合はFになります。

ウィンドウが上限に達してクレジットに切り替わると、💰セグメントが詳細モードになり、使用額、上限、残額を表示します：💰 €12.56/€14 (left €1.44)。未移行のアカウントでは、sとoを使った従来の表示が維持されます。

短縮表示のディレクトリ

~/My Projects/Brolと表示する代わりに、statuslineにはBrolだけが表示されます。すでにプロジェクト内にいるターミナルでは、完全なパスが役立つ場面はほとんどありません。末尾のディレクトリ名だけで位置を把握でき、メトリクス用のスペースも確保できます。

データが古くなっている場合、つまりキャッシュの有効期限が切れ、APIが429のバックオフ中または利用できない状態になると、値の前に~の接頭辞が表示されます（例：~5%）。

プロジェクトを自動検出

現在のディレクトリ名（パスの末尾）を表示します。完全なパスで行を埋め尽くすことなく、常にどのプロジェクトで作業しているかを把握できます。

アクティブなモデル

ステータスバーで使用中のモデル（Opus、Sonnet、Haiku または GLM）を直接確認できます。プロバイダーは自動的に検出されます。

使用率

5時間、7日間のウィンドウと現在のモデルの使用率（未移行のアカウントでは Sonnet と Opus が別々に表示）を確認できます。色付きのインジケーターにも対応しています：緑、黄、赤。

カウントダウン

制限がいつリセットされるかを正確に把握できます。対象となる各メトリクスの横にカウントダウン ↻ が表示されます。

コンテキストウィンドウ

会話の途中で上限に達しないよう、コンテキストウィンドウの使用状況を監視できます。

z.ai / GLM 対応

z.ai アカウントの残高（💰 9.88$）を表示し、選択した通貨（EUR、GBP、CAD…）へ自動的に換算します。

古いデータのインジケーター

値の前に付く ~ は、キャッシュの有効期限が切れているものの API が利用できない状態（429 のバックオフ）であることを示します。常に表示内容を正確に把握できます。

スマートキャッシュとバックオフ

API の負荷を抑えるため、プロバイダーごとに1分間キャッシュします。429 が発生した場合は、レート制限を超過しないよう5分間の自動バックオフを行います。

設定不要（Claude）

インストーラーを起動するだけで完了です。~/.claude/.credentials.json から Claude の認証情報を自動的に読み込みます（macOS では Keychain からも読み込みます）。

ステップ1：JWTを取得する

1. 普段使用しているブラウザーでz.ai/manage-apikey/billingを開く
2. ログインする（要求された場合はcaptchaを解決する）
3. F12でDevToolsを開き、Networkタブに移動する
4. F5でページを更新する
5. accountBalanceという名前のリクエストをクリックする
6. Headersで、Authorizationの値を、Bearerプレフィックスなしでコピーする（トークンはeyJhbGciOiJIUzUxMiJ9で始まります）

ステップ2：JWTを保存する

コンパニオンバイナリClaudeUsageStatusline.ZaiRefreshはインストールに含まれています。トークンの形式を検証し、~/.claude/.zai-credentials.jsonに書き込みます。

Windows：

& "$env:LOCALAPPDATA\ClaudeUsageStatusLine\ClaudeUsageStatusline.ZaiRefresh.exe"

Linux / macOS：

~/.local/bin/ClaudeUsageStatusline.ZaiRefresh

ステップ3（任意）：表示通貨

残高はデフォルトでUSDで返されます。EUR（またはその他の通貨）で表示するには、実行ファイルの隣にあるappsettings.jsonを編集します：

{
  "Zai": {
    "NativeCurrency": "USD",
    "DisplayCurrency": "EUR",
    "ExchangeRateCacheHours": 24
  }
}

為替レートは無料のAPIから1日1回取得され、ローカルにキャッシュされます。

JWTを更新するタイミング

セッションJWTには明示的な有効期限がありません。有効期間はz.aiのサーバーによって管理されます。一定期間操作がない場合や、明示的にログアウトした場合、最終的に無効化されます。

更新が必要なサイン：

• ステータスラインにz.ai: token missingと表示され、新しいウィンドウの指示に従うよう求められる
• 期限切れデータのプレフィックス（~💰）が表示され続ける
• ログに401 Unauthorizedが含まれている

どちらの場合も、ZaiRefreshが自動的にウィンドウで開くので、新しいJWTを貼り付けるだけです。