アカウントを接続。
取得値の意味を知る。

動作要件とリリース情報

AIUsageWatchは無料のネイティブメニューバーアプリです。対応環境は macOS 14以降です。一般公開に向けて準備中です。公開可能になり次第、確認済みのダウンロードリンクを本ウェブサイトに追加します。プロバイダーのアカウントと各プランの料金は、アプリとは別に扱われます。

公開されたアプリを「アプリケーション」フォルダに移動してから、 ログイン時に起動を有効にしてください。アプリはメニューバーで動作し、Dockアイコンは必要ありません。実行中のアプリをFinderから開くと、環境設定が前面に表示されます。

プロバイダーを接続する

1. Codex： Codex CLIをインストールしてログインし、アカウントの設定ディレクトリを指定してください。通常は ~/.codexです。アプリはローカルのCLI app-serverを通じて、そのディレクトリの保存済みログインを使用します。
2. Claude： 既定の ~/.claude アカウントは、Safariのclaude.aiセッションを使用します。環境設定で、Safariの Cookies.binarycookies ファイルへのアクセスを許可してください。別のClaude設定ディレクトリを使う場合は、その CLAUDE_CONFIG_DIRを指定してClaude Codeにログインしてください。アプリは次のファイルを読み取ります： .credentials.json.
3. Cursor： Safariでcursor.comにログインし、環境設定でSafariのCookieファイルへのアクセスを許可してください。Cursorの取得ではアカウントディレクトリを使用しません。
4. Grok： 選択するGrokディレクトリに必要なファイルは logs/unified.jsonlです。Grokを実行すると、そのログの請求関連の取得値を更新できます。

アプリは各ソースから取得できる利用枠情報を読み取ります。ClaudeとCodexのCLIソースには、それぞれの保存済みログインが必要です。ウェブサイトのプレビューはアカウントにアクセスしません。

個人用と仕事用のアカウントを一緒に

メニューから 環境設定… を開くか、 ⌘,を押してください。各アカウントにはラベル、プロバイダー、ディレクトリ、色、文字を設定できます。ディレクトリを追加するには + を使います。アプリはディレクトリの内容からプロバイダーを推測します。新しいアカウントを使う前に、プロバイダーを確認してください。

別のCodexログインには、専用の CODEX_HOMEを選択してください。別のClaudeログインには、認証情報を個別に保存した専用の CLAUDE_CONFIG_DIR を使います。既定のClaudeのSafariセッションに複数の組織が含まれていると、アカウントを特定できない場合があります。その場合は別の設定ディレクトリを使ってください。Cursorのデータ取得は利用可能なSafariのセッションを使うため、Cursorの行を複製しても独立したログインは作成されません。

アカウントを追加すると列が増え、1列につき最大3行を表示します。文字と色を設定すると、アカウントを見分けやすくなります。一般設定には、更新のタイミング、割合マーカー、文字、対応するCodexのストック済みリセット権の期限情報に基づく警告があります。

バーの意味を理解する

塗りつぶされた部分は 利用枠の残量を意味します。残り0%では塗りつぶしがなくなります。色はアカウントを識別します。メニューには割合、取得できるリセット時刻、関連する利用期間の詳細、取得状態が表示されます。

Claudeは週間と、取得できる5時間の詳細を表示します。Codexは主要な週間上限を選択します。Cursorは独自のプラン内利用量を使い、そのデータには利用期間が明示されていません。GrokはCLIログの週間クレジットの数値を使います。プロバイダー間で同じ割合でも、トークン数、プロンプト数、金額が同じとは限りません。

Codexのストック済みリセット権を期限前に確認

Codexが利用可能なストック済みリセット権と有効期限を報告する場合、AIUsageWatchは次のリセット権が失効する前に、アカウントの横に警告ドットを表示できます。メニューで利用可能な数と期限情報を確認してください。使わないまま期限を迎えると、ストック済みリセット権を失うことがあります。これは通常の週間利用枠のリセット時刻とは別のものです。

環境設定で リセット前に警告 を有効にし、警告のタイミングを 1〜14日前に設定してください。既定は2日前で、赤い警告ドットを表示します。色は変更できます。アカウントの文字表示をオフにしても、ドットは表示されます。警告には、アプリが起動中で、警告が有効になっており、最新の期限データが取得できることが必要です。ストック済みリセット権の自動使用やシステム通知の送信は行いません。

Codexの自動開始用リクエスト

条件は、 Codexから直接取得した週間利用枠の残量が100%であることです。このとき、AIUsageWatchは小さな codex exec リクエストを、そのディレクトリの保存済みCLIログインで1回送信します。未開始のままになる可能性がある週間の利用期間を開始することが目的です。Codexの利用可能な既定のモデルを使い、 そのアカウントの利用枠を少量消費します.

リクエストの実行中や失敗時には、アカウントに赤いドットを表示します。メニューには状態の説明と手動の再試行を用意しています。アプリは、その週間の利用期間での試行をメモリに記憶します。記憶している試行については、繰り返し取得しても追加のリクエストを送りません。アプリを再起動すると記憶が消え、直接取得した残量がまだ100%の場合は再びリクエストを送ることがあります。

過去のセッション記録による代替取得では、開始用リクエストを送信しません。現在のビルドではClaudeの自動開始用リクエストは有効になっていません。これは利用状況の取得とは別の動作で、現在の環境設定にはCodexの開始用リクエストを切り替える設定はありません。

数値が古い、表示されない、予想と違う場合

• 保存された取得値： 直近の正常な取得値はMacにキャッシュされ、起動時に復元されます。更新に失敗すると、メニューに取得からの経過時間が表示されます。
• レート制限または接続の失敗： レート制限後は15分、その他のエラー後は2分待ってから再試行します。 今すぐ更新 は、その待ち時間を無視します。
• Safariの接続： 該当するプロバイダーにログインしているか、Cookieファイルへのアクセスが許可されているか、セッションからアカウントを明確に特定できるかを確認してください。
• Grok： CLIを実行して、新しい利用状況の取得値を記録してください。期限切れの利用期間や古いログは、現在の残量ではなく過去のデータとして表示されます。
• Codex： CLIが使用可能で、設定したディレクトリに意図したログインが保存されているか確認してください。app-serverが使えない場合、セッション記録による代替取得では古い情報を表示することがあります。

プロバイダーの接続先やデータ形式は変わる場合があります。取得値は、プロバイダーが次のリクエストを受け付けることを保証しません。残量やリセット情報がおかしい場合は、プロバイダー自身のアカウントページを確認してください。

ローカル設定とプロバイダーへの接続

環境設定とキャッシュした取得値の保存先は ~/Library/Application Support/AiUsageWatch/です。アプリはキーチェーンを直接読み取りません。プロバイダーのCLIはそれぞれ独自にログインを管理します。現在の利用状況を取得する際には、既存のセッションや認証情報を使って該当するプロバイダーに接続します。 プライバシーポリシー で、アプリのローカル保存、プロバイダーへの接続、サポートメッセージの違いを確認してください。

問題を報告する

AIUsageWatchサポートへのお問い合わせ には、アプリのバージョン、macOSのバージョン、プロバイダー、取得状態、問題の再現手順を添えてください。診断用の --dump モードを使う場合、送信前に出力内容を確認してください。トークン、Cookieの値、非公開のアカウントパス、その他の機密情報を削除してください。認証情報ファイルはアップロードしないでください。