powered by TechFeed
表示モード
エンジニア向けニュース

Claude Codeのコスト・制限・CIステータスをターミナルにリアルタイム表示するOSSツール「Claude Statuspane」— 上限を超えてから気づく問題を解消

10月5日、Tom Smithが「Open Source Mod Brings Rate Limits, Costs and CI Status Into View for Claude Code Users」と題した記事を公開した。Claude Codeで長時間タスクを走らせているとき、コンテキストウィンドウ・レート制限・予算のどれが先に尽きるかをリアルタイムで把握できているチームはほとんどいない。気づくのは何かが尽きた後――そのギャップを埋めるOSSツールが「Claude Statuspane」だ。

10月5日、Tom Smithが「Open Source Mod Brings Rate Limits, Costs and CI Status Into View for Claude Code Users」と題した記事を公開した。Claude Codeで長時間タスクを走らせているとき、コンテキストウィンドウ・レート制限・予算のどれが先に尽きるかをリアルタイムで把握できているチームはほとんどいない。気づくのは何かが尽きた後――そのギャップを埋めるOSSツールが「Claude Statuspane」だ。


セッションのコストを誰も把握していない問題

Claude Codeで長時間タスクを走らせると、コンテキストウィンドウ、5時間レート制限、週次上限、予算――これらが静かに消費されていく。多くの場合、誰かが気づくのは何かが尽きた後だ。

この問題に対処するOSSツールが**Claude Statuspane**だ。開発者のAnji Xuが作成し、MITライセンスでGitHubに公開している。Claude Codeのターミナルプロンプトの上に、フローティングのステータスカードを表示するツールで、以下の情報をリアルタイムで見せる。

  • アクティブなモデルと推論努力レベル
  • コンテキストウィンドウの使用率(例:42%、または100万トークン中22.2万)
  • 5時間・7日間レート制限の残量とリセットまでのカウントダウン
  • 現在のディレクトリとGitブランチ
  • セッションの累積コスト

コンテキストバーは60%で警告色、85%でエラー色に変わる。上限に近づいたタイミングで/compactを実行するためのボタンもゲージの隣に配置されている。Claude CodeのstatusLine設定(シェルスクリプトを実行して1行テキストを表示する既存機能)とは異なり、StatuspaneはClaude Codeの新しいmodシステム(Claude Code 2.1以降で導入されたプラグインAPIで、サードパーティのモジュールがターミナルセッション内にUI要素を描画・操作できる仕組み)を使っている。このAPIはまだアーリーアクセス段階であり、Claude Codeのアップデートで変わる可能性があるとREADMEに明記されている。

動作要件はClaude Code 2.1.287以降、かつターミナルの幅が70カラム以上。Claude Codeデスクトップアプリでは動作しない(デスクトップ版には独自のステータス表示がある)。


DevOpsチームへの実用性が高いGitHub CI連携

個人の利便性にとどまらず、チームにとっても使えるのがGitHub Actions連携だ。GitHub CLIでサインイン済みであれば、現在のブランチの最新CIラン結果をカード上に表示できる。チェック間隔は通常1分ごと、ランがアクティブな間は10秒ごとに更新される。

さらに、git pushやgh pr mergeで発火したランを追跡し、完了後10分間は画面に表示し続けるオプションもある。ジョブがrunning・failed・deployedのどの状態か、どれくらい前に実行されたかも確認できる。

エージェントが変更をプッシュした後、パイプラインの結果を確認するためにブラウザタブを開く――そのコンテキストスイッチをなくすのがこの機能の狙いだ。


軽量なプログレスAPIも内蔵

StatuspaneにはシンプルなプログレスAPIも組み込まれている。任意のスクリプトが、ラベル・パーセンテージ・テキスト・TTL(有効期限)・状態(running/ok/error)を含む小さなJSONファイルを所定のフォルダに書き込むと、カードがそれを拾って表示する仕組みだ。直近20件のファイルを監視し、1秒ごとに更新。TTLが切れた行は自動的に消える。ShellとPythonのヘルパーも付属している。

セキュリティ面では、受け付けるのはJSONファイルのみ(最大64KB)で、制御文字・双方向テキストマーク・ゼロ幅文字をテキストフィールドから除去する処理が入っている。エージェントのターミナル内でテキストをレンダリングするものは、インジェクションの経路になりえるため、この対処は妥当だ。CI連携もサードパーティサービスを経由せず、開発者自身のGitHub CLI認証情報を使う。


個人ツールの先にある課題

The Futurum GroupのVP・Mitch Ashleyはこのツールの限界を率直に指摘する。「Statuspaneは1人の開発者にゲージを与える。それは有用だが、ガバナンスには届かない。エージェントのデプロイペースは、組織が何を観測・制御・証明できるかで決まる。個人のステータスカードはチームにそのいずれも与えない」。Ashleyはさらに、エージェントセッションごとの支出・制限・パイプライン結果を集中管理して監査できるかどうかが本質的な問いであり、エージェントプラットフォームがそのテレメトリをネイティブに提供するかを注視すべきだと続ける。

現時点でStatuspaneは公開されたばかりで採用実績も少なく、アーリーアクセスAPIに依存している。チームが試すなら実験として扱うべきだ、と記事は結論づけている。個人の開発者がセッションのコストを即座に把握するためのツールとして実用的だが、組織レベルでのエージェント管理には別の仕組みが必要になる。

詳細はOpen Source Mod Brings Rate Limits, Costs and CI Status Into View for Claude Code Usersを参照していただきたい。