ヘルプ

インストール、接続、カスタマイズ、トラブルシューティング — だいたい 5 分で完了します。

インストール

  1. 最新の DMG をダウンロードします。
  2. Token Run をアプリケーションにドラッグして起動します。
動作環境: macOS 14.0 以上、Apple Silicon または Intel。

初回起動が macOS にブロックされた場合は、システム設定 → プライバシーとセキュリティを開いて このまま開く をクリックしてください。

プロバイダーの接続

Token Run は、すでに使っている Claude Code、Codex CLI、GitHub Copilot CLI、Google Antigravity のセッションから使用量を読み取ります — API キーは不要です。複数のプロバイダーを同時に有効化でき、ポップオーバーがそれらを合算して表示します。クォータカードは Claude と Codex のみで、Copilot と Antigravity はランナー速度にだけ反映されます。

Claude Code

ポップオーバーを開いて Connect Claude をクリックし、OAuth を承認してください。解除は 設定 → Claude Quota からいつでも行えます。

Codex CLI

Codex CLI にログインしていれば、Token Run が自動的に認識します。オフにするには 設定 → Providers で無効化してください。

GitHub Copilot CLI

Copilot CLI をインストールして一度実行すると、Token Run が ~/.copilot/session-state を自動検出します。Copilot CLI 1.0.35 時点では出力トークンしかログに残らず、入力・キャッシュトークンは提供されていないため、表示される値は実際の使用量より少なめに出て、クォータカードもありません。オフにするには 設定 → Providers で無効化してください。

Google Antigravity

Antigravity をインストールしてください。会話ファイルがディスク上で暗号化されているため、Token Run はファイルサイズの増加分を活動プロキシとして使用します。表示されるトークン数は実際の使用量ではなく、ランナーの速度を動かすための値で、クォータカードもありません。オフにするには 設定 → Providers で無効化してください。

  • ランナースプライト — 分あたりのトークン数に応じて速くなります。
  • トークン数 — 今日の合計。
  • クォータバッテリー — 5時間クォータの残量。Claude、Codex、オフから選択可能。
  • リセットタイマー — 次の 5時間リセットまでのカウントダウン。

各要素は 設定 → Menu bar で個別にオン／オフできます。

速度レベル

  • Resting(休息) — 直近の活動なし。
  • Walking(歩く) — 約 500 tok/分 未満。
  • Running(走る) — 約 1,000 tok/分 以上。
  • Sprinting(全力疾走) — 約 2,000 tok/分 以上。

キャラクター

設定 → Character でランナーをクリックして切り替えできます。すべてのキャラクターはダーク／ライトどちらのメニューバーにも合わせてレンダリングされます。

カスタムキャラクター

設定 → Character → + Add から自分のランナーを追加できます。横並びのスプライトシート PNG またはフレーム PNG フォルダを入れ、順序と fps を調整して保存してください。

コミュニティ順位

この機能を有効にすると、ポップオーバーに他のユーザーと比較した週間バケット(例: 今週 上位28%)が表示されます。送信されるのは匿名 ID と 1 日分のトークン合計のみで、アカウント情報やプロンプトの内容は含まれません。設定 → Share anonymized usage stats でいつでもオフにできます。

プライバシー

  • 認証情報は各 CLI が元々保存する場所に残したまま、クォータの読み取りにのみ使用されます。
  • プロンプト、応答、ツール呼び出し、ファイルパスは端末の外に出ません。
  • トークン数とプロバイダー別の内訳もローカルにのみ保存されます。例外はコミュニティ順位が使用する 1 日分の合計のみです。

トラブルシューティング

ポップオーバーに「Throttling requests…」と表示される

クォータ取得が一時的にレート制限された状態です。1〜2 分以内に自動的に復帰します。

コーディング中なのにランナーが止まっている

  • 使用しているプロバイダーが 設定 → Providers で Installed または Enabled になっているか確認してください。
  • 分あたりのトークン数が歩行しきい値を下回っている可能性があります。ランナーは存在ではなくスループットに反応します。
  • それでも 0 のままなら、該当プロバイダーを一度切断して再接続してください。

アプリが「壊れている」と表示されて開けない

システム設定 → プライバシーとセキュリティを開いて このまま開く をクリックしてください。

カスタムキャラクターが動かない

  • すべてのフレームのピクセルサイズが揃っている必要があります。
  • PNG を使ってください — JPEG は透明度が失われます。
  • fps をより低く試してみてください。

フィードバック

ryanstudio0429@gmail.com までメールでお知らせください。