usageでClaude CodeとCodexの使用量をメニューバー確認する方法

AI開発ツールを毎日使う人にとって、Claude CodeやCodexの使用量、トークン、コスト感をすぐ確認できることは大きな安心材料です。usageは、macOSのメニューバーからそれらの情報を確認できるローカル重視のツールです。

この記事で分かること

• usageで確認できるClaude CodeとCodexの使用量の見方
• 初心者が導入前に知っておきたい仕組みと注意点
• 画面操作、CLI、HTMLレポートの使い分け

usageとは何か

usageは、GitHubで公開されているmacOS向けのメニューバーアプリです。公式リポジトリでは、Claude CodeとCodexのクォータ、トークン、コストを画面上に固定表示できるツールとして説明されています。特徴は、AIサービスのAPIを直接呼び出して使用量を取得するのではなく、ローカルに残された利用データを読む設計になっている点です。

初心者にとって分かりやすく言うと、usageは「AI開発ツールの残り時間や使いすぎを、Macの右上で見られる小さなメーター」のようなものです。開発中に何度も別画面を開いて確認する必要が減るため、作業の流れを止めにくくなります。

公式READMEによると、表示できる内容にはSession、Weekly、各プロジェクトの使用量、今日のtoken使用量、コスト推定などが含まれます。また、HTMLレポートや複数テーマの表示にも対応しているため、単なる小さな表示ツールではなく、あとから振り返るための分析画面としても使えます。

関連情報は、aqua5230/usage公式GitHubで確認できます。導入方法や対応状況は更新される可能性があるため、実際に使う前にはREADMEの最新内容を見るのが安全です。

ずんだもん

usageは何をしてくれるツールなんですか？

メタン

Claude CodeやCodexの使用量を、Macのメニューバーで確認しやすくしてくれるツールです。

管理人

AIツールは便利ですが、残り使用量が見えないまま作業すると、集中している途中で制限に当たることがあります。メニューバーで状態を見られるだけでも、作業計画を立てやすくなります。

usageが向いている人

usageが特に向いているのは、Claude CodeやCodexを日常的に使っているmacOSユーザーです。たとえば、授業の課題、研究用スクリプト、ブログ執筆、個人開発などでAI支援を使っている人は、今日どれくらい使ったかを把握できると便利です。使用量を見ながら作業できれば、重い相談を後回しにする、短い確認だけにする、別の日に分けるといった判断がしやすくなります。

また、プロジェクト別の使用量を見たい人にも合います。公式READMEでは、今日、7日、月単位でプロジェクト使用量を見られることが説明されています。これは、どの作業にAI利用が集中しているかを振り返る手がかりになります。

一方で、WindowsやLinux向けの一般的な常駐ツールとして紹介されているわけではありません。公式README上の必要条件にはmacOSが挙げられています。そのため、Windows環境の授業用PCやDocker中心の環境で同じように使えると決めつけない方が安全です。MacでClaude CodeやCodexを使っている人向けのツールとして理解すると、期待とのズレが少なくなります。

初心者がうれしいポイント

初心者にとって一番大きい利点は、数字の確認場所が分かりやすいことです。AI開発ツールは便利ですが、トークン、セッション、週次制限、コスト推定など、慣れない言葉が多く出てきます。usageはそれらをメニューバーやポップオーバーでまとめて見せるため、「今どれくらい使っているのか」を視覚的に理解しやすくします。

さらに、公式READMEでは、メニューバー表示だけでなくTUIモードやHTMLレポートにも触れられています。つまり、普段は小さく確認し、必要なときだけ詳しく分析する使い方ができます。最初から全機能を覚える必要はありません。まずはメニューバーでSessionとWeeklyの進捗を見るところから始めるとよいでしょう。

使用量を取得する仕組み

usageの重要な考え方は、ローカルに残された情報を読むことです。公式READMEでは、AnthropicやOpenAIのAPIを呼び出さず、Keychainも読まないと説明されています。これは、利用状況を確認するためだけに余計なAPI通信を増やしたくない人にとって分かりやすい設計です。

Claude Codeについては、statusLine hookという仕組みを使い、Claude Codeが更新する状態情報をアプリ側で読める形にします。Codexについては、Codex CLIが残すセッション記録を読み、そこに含まれるquota情報やtoken統計を利用する説明になっています。つまり、usageが独自に勝手な計算だけで残量を推測するというより、各ツールが残している情報を画面表示に使うイメージです。

ただし、コスト推定については注意が必要です。公式READMEでは、Codexのコスト推定時にtoken単価表が必要で、条件によって公開価格表の取得やキャッシュが使われることが説明されています。表示される金額は、請求額そのものと同じとは限らないため、あくまで目安として見るのが安全です。

ずんだもん

APIキーを入れないと使えないタイプのツールですか？

メタン

README上では、使用量取得のためにAnthropicやOpenAIのAPIを直接呼ばない設計として説明されています。

APIを直接呼ばないことの意味

APIを直接呼ばない設計には、初心者にも分かりやすい利点があります。まず、確認のためだけにAIサービス側へ追加リクエストを送る心配が少なくなります。また、APIキーを登録して使うタイプのツールではないため、秘密情報の扱いを増やしにくい点も安心材料です。

ただし、「完全に一切ネットワークを使わない」と短く言い切るのは正確ではありません。公式READMEでは、コスト推定用の価格表取得や、GitHub Releases APIによる更新確認について説明されています。ここは初心者が誤解しやすい部分です。使用量の取得そのものはローカル中心でも、周辺機能でネットワークが使われる場合があります。

管理人

セキュリティ面では「何を読んで、何を送らないのか」を確認する習慣が大切です。便利そうだから入れるのではなく、READMEで動作範囲を見てから試す方が、長く安心して使えます。

最初に試す手順

初めてusageを試すなら、いきなり全部の機能を使おうとしない方が失敗しにくいです。まずは自分の環境が前提に合っているかを確認し、次に公式READMEの手順に沿って導入します。Homebrew、ダウンロード済みアプリ、ソースコード実行など複数の方法が説明されていますが、初心者はREADMEで推奨されている手順を確認してから選ぶのが安全です。

インストールコマンドやダウンロード手順は変わる可能性があります。この記事では古いコマンドを固定して貼るのではなく、公式READMEの最新手順を確認する方法をおすすめします。特にmacOSのGatekeeper、未署名アプリの扱い、更新版の有無は、時期によって注意点が変わることがあります。

• [ ] macOSでClaude CodeまたはCodexを使ったことがあるか確認する
• [ ] 公式READMEで必要条件を確認する
• [ ] まずはアプリ版またはHomebrew版の説明を読む
• [ ] 起動後、メニューバーに表示されるか確認する
• [ ] Claude Codeを使う場合は、状態列設定が必要か確認する
• [ ] Codexを使う場合は、一度対話して使用記録がある状態にする
• [ ] 表示が空の場合は、公式READMEのトラブルシューティングを確認する

画面操作とCLI操作の違い

初心者は、まず画面操作を中心に考えると理解しやすいです。メニューバーに常駐させて、必要なときだけクリックして見る使い方なら、ターミナルに慣れていなくても扱いやすくなります。一方、開発者や検証目的の人は、CLIやTUI、HTMLレポートを使うことで、より詳しい情報を見られます。

usageで見られる主な情報

usageでは、Claude CodeとCodexの使用状況を同じ画面で確認できる点が特徴です。公式READMEによると、メニューバーの表示では、Claude CodeとCodexの使用率が並んで見える場合があります。ポップオーバーを開くと、SessionとWeeklyの進捗、プロジェクト別の利用状況、今日のtoken使用量、コスト推定などが表示されます。

ここで大切なのは、数字を細かく読みすぎないことです。初心者は、最初からすべての項目を正確に解釈しようとすると疲れます。まずは「今のセッションで使いすぎていないか」「今週の使用量に余裕があるか」「どのプロジェクトで多く使っているか」の3点に絞ると、実用的に使えます。

また、HTMLレポートでは、日、週、月のtokenやコストの推移、プロジェクトランキング、モデル分布などを確認できると説明されています。これは、仕事や研究で「どの作業にAIを多く使ったか」を振り返るときに役立ちます。

コスト表示は目安として見る

コスト推定は便利ですが、請求額の確定情報として扱うのは避けましょう。公式READMEでも、Codexのコストはtoken数からの推定として説明されています。モデル名や価格表の状態、キャッシュ、fallbackなどの条件によって、見え方が変わる可能性があります。

実際の請求管理が必要な場合は、各サービスの公式ダッシュボードや契約情報も確認するのが安全です。usageは日々の作業中に「今どれくらい使っているか」を把握するための補助ツールとして考えると、無理なく活用できます。

ずんだもん

コスト表示はそのまま請求額として見ていいですか？

メタン

請求額ではなく目安として見るのが安全です。最終確認は各サービス側の公式情報も見ましょう。

用語表

AI開発ツールの使用量管理では、似た言葉が多く出てきます。ここでは初心者がつまずきやすい言葉を整理します。

導入前の注意点

導入前には、公式READMEの必要条件とトラブルシューティングを読むことが大切です。公式情報では、macOS、Python 3.13、Claude CodeまたはCodexの利用履歴が必要条件として説明されています。アプリ版を使う場合でも、初回起動時にmacOSのセキュリティ確認が出る場合があります。

また、Claude Codeの表示には状態列設定が関係します。Codexについても、セッション記録がまだない場合は表示されないことがあります。つまり、インストールした直後にすべての数字が出ないからといって、すぐ故障と考える必要はありません。まずは対象ツールを一度使い、記録が作られる状態にしてから確認しましょう。

管理人

初心者ほど、エラーが出たときにすぐ再インストールしたくなります。しかし、こうした常駐系ツールは「データがまだない」「状態列が未設定」「再起動が必要」という単純な理由で表示されないことも多いです。

よくある質問

Q1. usageはWindowsでも使えますか？

A. 公式READMEでは必要条件としてmacOSが示されています。そのため、Windows向けツールとして使えるとは断定しない方が安全です。Windows環境では、同じ使い方を期待するより、公式リポジトリの対応状況を確認してください。

Q2. APIキーを登録する必要がありますか？

A. 公式READMEでは、使用量取得のためにAnthropicやOpenAIのAPIを呼び出さないこと、Keychainを読まないことが説明されています。少なくともREADME上の説明では、APIキーを登録して使用量を読むタイプの設計ではありません。

Q3. メニューバーに何も出ない場合はどうしますか？

A. まずClaude CodeまたはCodexの利用記録があるか確認します。Codexをまだ使っていない場合や、Claude Codeの状態列設定が必要な場合は、表示が空になることがあります。公式READMEのトラブルシューティングを確認しましょう。

Q4. コスト表示は正確な請求額ですか？

A. Codexのコストはtoken数からの推定として説明されています。実際の請求確認には、利用しているサービス側の公式情報も見るのが安全です。usageの表示は日常的な目安として使うのが現実的です。

Q5. HTMLレポートは何に使いますか？

A. 日別、週別、月別のtokenやコストの傾向、プロジェクト別の使用量などを振り返る用途に向いています。研究、授業、仕事でAI利用を記録したい人には、あとから説明しやすい資料になります。

Q6. 初心者はどの機能から使えばよいですか？

A. まずはメニューバー表示だけで十分です。SessionとWeeklyの進捗を見て、使いすぎていないか確認します。慣れてきたら、ポップオーバー、HTMLレポート、TUIの順に試すと混乱しにくいです。

Q7. テーマ切り替えは実用上必要ですか？

A. 必須ではありません。ただ、公式READMEでは複数の視覚テーマが説明されています。毎日見るツールなので、自分が見やすい表示に変えられることは、継続利用のしやすさにつながります。

まとめ

usageは、Claude CodeとCodexの使用量、token、コスト推定をmacOSのメニューバーから確認しやすくするツールです。ローカルに残された情報を読む設計が中心で、APIを直接呼び出して使用量を取得するタイプではない点が特徴です。

初心者は、まずメニューバー表示でSessionとWeeklyを見るところから始めるのがおすすめです。詳しい分析が必要になったら、HTMLレポートやCLIを試すとよいでしょう。導入前には、必ず公式GitHubリポジトリで最新の必要条件、インストール方法、注意点を確認してください。