AI Session Meter Support

Questions, bug reports, and feature requests are welcome by email:

Email: [email protected]

For setup and screen-by-screen instructions, see the complete English/Japanese user manual.

Common questions

My token expired / I see an error

If you already use the claude CLI, copy its token to the clipboard with:

security find-generic-password -s "Claude Code-credentials" -w | pbcopy

security is Apple's signed, built-in CLI. If a Keychain prompt appears, click Allow (AI Session Meter itself never touches the Keychain). Then open the popover, paste into the field, and press Save. It shows "Authenticated (auto-refresh)" and refreshes the token for you from then on. If a token expires and you see an error, run claude once to get a fresh session, copy the token again with the command above, and re-paste it via Update token in the popover.

Optional: paste a Claude Admin key (sk-ant-admin…) instead to track API spend, or set a custom Codex sessions folder in Settings if your logs aren't in the default ~/.codex/sessions (the app also honors the CODEX_HOME environment variable).

It says I need a Claude Max / Pro subscription

The usage endpoint that AI Session Meter reads requires a Claude Max or Pro subscription. Free accounts and API-only accounts cannot reach it, so the app cannot show usage for those accounts.

I'm seeing HTTP 429 errors

The usage endpoint throttles aggressive polling. On a 429 response, the app waits the server's Retry-After time (plus 60 seconds) and recovers automatically — there's no need to spam the refresh button.

The iPhone app shows no data

Use the connections you need on iPhone or iPad:

  1. Sign in with your Claude account directly on the iPhone/iPad (in Settings) to fetch live usage on-device — no Mac required.
  2. Connect a ChatGPT workspace to fetch current Codex limits directly.
  3. Sync from your Mac: sign in to the same iCloud account on both devices and keep the Mac app running for longer history, Mac-observed Codex activity, and Gemini data.

Compare the Updated and Checked timestamps if two devices temporarily show different values.

A forecast is missing after a reset

The app does not reuse the old window's pace. It shows Learning until fresh observations from the new window are available, then adds and refines the forecast automatically.

I have an existing DMG install

Public DMG distribution has been discontinued. Existing DMG installs keep working but no longer receive updates — install AI Session Meter from the Mac App Store to keep getting updates.

How do I make it start at login?

Open AI Session Meter Settings on the Mac and enable Launch at login.

A note on reliability

AI Session Meter uses provider usage endpoints and local CLI files. Provider-side changes at Anthropic, OpenAI, or Google can interrupt metering until an app update ships.

日本語サポート

ご質問・不具合報告は上記メールアドレスまで日本語でお送りいただけます。

メール: [email protected]

初期設定と画面別の詳しい説明は、日本語・英語の取扱説明書をご覧ください。

トークンが失効した／エラーが表示される

claude CLI を使っている場合、ターミナルで次を実行するとトークンがクリップボードにコピーされます。

security find-generic-password -s "Claude Code-credentials" -w | pbcopy

security は Apple 署名済みの標準 CLI です。Keychain 許可ダイアログが出たら 許可 を選択してください（AI Session Meter 本体は Keychain にアクセスしません）。コピーできたらポップオーバーを開いて入力欄に貼り付け、保存 を押します。「認証済み（自動更新）」と表示され、以降はアプリがトークンを自動更新します。トークン失効でエラーが出た場合は、claude を一度実行して新しいセッションを作り、上記コマンドで再度トークンをコピーして、ポップオーバーの トークン更新 から貼り直してください。

任意: 代わりに Claude の Admin キー（sk-ant-admin…）を貼ると今月の API 支出を表示できます。また、ログが既定の ~/.codex/sessions 以外にある場合は、設定で Codex セッションフォルダを指定できます（CODEX_HOME 環境変数も参照します）。

Claude Max / Pro サブスクリプションが必要と表示される

AI Session Meter が読み取る使用量エンドポイントには Claude Max または Pro のサブスクリプションが必要です。無料アカウントや API のみのアカウントではこのエンドポイントにアクセスできないため、使用量を表示できません。

HTTP 429 エラーが出る

使用量エンドポイントはポーリングを積極的に制限します。429 を受け取ると、サーバーの Retry-After（+60秒）だけ待って自動的に回復します。更新ボタンを連打しないでください。

iPhone アプリにデータが表示されない

必要な接続を組み合わせて使えます。

  1. iPhone/iPad 上で直接 Claude アカウントにサインインする（設定から）— Mac不要でライブの使用量を端末上で取得できます。
  2. ChatGPT workspaceを接続して、現在のCodex上限を直接取得します。
  3. Macから同期する — 両方のデバイスを同じiCloudアカウントにサインインし、Macアプリを起動しておくと、長期履歴、Macで観測したCodex活動、Geminiデータが届きます。

端末間で値が一時的に違う場合は、更新と確認の時刻を比べてください。

リセット後に未来予測が表示されない

前の枠のペースは新しい枠へ流用しません。新しい観測がそろうまでは「学習中」と表示し、その後に予測を追加して自動的に精度を上げます。

既存の DMG 版ユーザーです

公開 DMG 配布は終了しました。インストール済みの DMG 版はそのまま動作しますが、今後のアップデートは提供されません。アップデートを受け取るには Mac App Store 版をインストールしてください。

ログイン時に自動起動させるには

MacのAI Session Meter 設定でログイン時に起動を有効にしてください。

信頼性についての注意

AI Session Meter はプロバイダーの使用量エンドポイントとローカルのCLIファイルを利用します。そのためAnthropic・OpenAI・Google側の変更により、アプリの更新が出るまで一時的に計測できなくなることがあります。