AI Session Meter Support

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

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

There are two ways to get data on iPhone or iPad:

Sign in with your Claude account directly on the iPhone/iPad (in Settings) to fetch live usage on-device — no Mac required.
Or sync from your Mac: sign in to the same iCloud account on both devices and keep the Mac app running.

Codex stats and longer history always come from the Mac app via iCloud sync.

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?

Go to System Settings → General → Login Items and add AI Session Meter.app.

A note on reliability

AI Session Meter uses a private usage API and reads local CLI tokens/logs. Provider-side changes at Anthropic or OpenAI can break it 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 アプリにデータが表示されない

データを表示する方法は2つあります。

iPhone/iPad 上で直接 Claude アカウントにサインインする（設定から）— Mac不要でライブの使用量を端末上で取得できます。
または Mac から同期する — 両方のデバイスを同じ iCloud アカウントにサインインし、Mac アプリを起動しておきます。

Codex の統計や長期履歴は、常に Mac アプリから iCloud 同期で取得されます。

既存の DMG 版ユーザーです

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

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

システム設定 → 一般 → ログイン項目と機能拡張 で AI Session Meter.app を追加してください。

信頼性についての注意

AI Session Meter は非公開 API を利用し、ローカルの CLI トークン／ログを読み取ります。そのため Anthropic や OpenAI 側の変更により、アプリの更新が出るまで一時的に動作しなくなることがあります。