Claude Code の mod の作り方。残量バーを作ってみた

2026年10月2日に Claude Code の mods が公式から告知されたので、アプリの中に組み込めるならそのほうがよいと思い、残量バーを mod で作ってみました。Claude Code の mod は、欲しいものを Claude に説明すれば作ってもらえます。プロンプト入力欄の上に Claude と Codex の残量を出せました。

ただ、mod は Claude Code を開いている間しか動きません。使っていない間も値を新しくしておくために、常駐版の仕組みは結局残しています。この記事では、mods でできること、私が残量バーを作った流れ、作り方の手順、つまずいたところ、常駐版を残した理由を順に書きます。

先に結論

• Claude Code の mod は、Claude Code の画面や動きを変えるプラグイン。プロンプト入力欄の上に帯を出せる
• 作り方は、欲しいものを Claude に説明して書かせるのがいちばん早い
• Claude の残量は Claude Code が mod に渡してくれるので、トークンを扱わずに済む
• Codex の残量とモデル別の週の枠は渡されないので、mod の中から取りに行く形にした
• デスクトップアプリの分割ビューでは、帯が出なかった
• mod は Claude Code を開いている間しか動かない。使っていない間の更新は、常駐版の仕組みに任せた

残量バーを mod で作ってみた理由

残量バーは、Claude Code と Codex の使用量をタスクバーの上に出している自作の道具です。Windows の常駐アプリとして作り、8月に残量バーの記事にまとめました。

2026年10月2日に、Claude Code の公式アカウントが mods を告知しました（ClaudeDevs の投稿）。Claude Code の見た目や動きを、数行の TypeScript で変えられるという内容です。

これを見て、残量バーもアプリの中に組み込めるなら、そのほうがよいと思いました。

Claude Code の mods でできること

公式ドキュメントによると、mod は Claude Code の見た目と動きを変えるプラグインで、JavaScript か TypeScript で書きます（Mods overview・2026年10月14日確認）。ツールの呼び出しやプロンプトの送信、画面の描画といった出来事のたびに、mod の関数が呼ばれます。

• 画面に描く: 会話の横のペイン、プロンプト入力欄の上の帯
• Claude Code が描いている部分を描き直す: ツール呼び出しの行、スピナーなど
• ツールの呼び出しやリクエストに割り込む
• 自分の /コマンドを足す

動くのは、ターミナルの Claude Code と、デスクトップアプリの Code タブです。ターミナルは v2.1.287 以降、デスクトップアプリは同梱の Claude Code が v2.1.286 以降で使えます（同ページ・2026年10月14日確認）。デスクトップアプリの版は、Code タブで /status を打つと Claude Code の行に出ます。同じページには、mod は自分の権限で動くコードで、ファイルの読み書きや通信もできるので、信頼できる作者の mod だけを入れるように、と注意書きがあります。

mod で作った残量バー

10月5日に作ったのは、デスクトップアプリのプロンプト入力欄の上に、帯を2行出す mod です。上の行に Claude の5時間と週の枠、下の行に Codex の5時間と週の枠を出しています。上の行の右端には、モデル別の週の枠（Fable）も足しました。

表示は使用率のゲージと、リセットまでの残り時間です。帯の幅が足りないときは、ゲージを外して文字だけの表示に切り替わります。同じ PC で開いているセッションどうしは、いちばん新しい値を分け合って出します。

作ってみると、Claude の5時間と週の値は Claude Code から mod に渡されていました。常駐版はトークンを使って取りに行っていましたが、mod ではトークンを扱う部分がなくなりました。

Codex の残量と、モデル別の週の枠は、Claude Code から渡される値に入っていませんでした。この2つは、mod の中から取りに行く形にしています。

Claude Code の mod の作り方

公式ドキュメントの作り方は、自分でコードを書く方法と、Claude に頼む方法の2つです（Create a mod・2026年10月14日確認）。Claude に頼むと、Claude Code に入っている mod 作り用のスキル（plugin-authoring）を使って書いてくれます。私はコードを書かず、Claude に作らせました。

1. 版を確かめる。ターミナルは claude --version、デスクトップアプリは /status
2. 欲しいものを Claude Code のセッションで説明する（例: プロンプト入力欄の上に、Claude の残量を出す mod を作って）
3. Claude が書いた mod を claude plugin validate と claude plugin test で確かめる
4. mod のフォルダを自分の置き場所へ移し、--plugin-dir で読み込ませる。毎回読み込ませるなら、設定の環境変数 CLAUDE_CODE_PLUGIN_DIRS にフォルダを書く
5. 新しいセッションを開いて、帯が出るか見る

Claude にその場で書かせた mod は、そのセッションの中でしか読み込まれません（同ページ）。ほかのセッションでも使うなら、4のように自分の置き場所へ移します。

claude plugin validate は、mod がどの出来事を受け取り、何を呼び出すか（ファイルの読み書きや通信など）を一覧にして出します。claude plugin test は、セッションを開かずに mod のテストを回すコマンドです。どちらも、Claude が直したあとの確かめに使えます。

私は先に設計書を作ってから書かせました

残量バーは、いきなり「作って」とは頼んでいません。どの値をどこから取るか、古い値をどう扱うか、見た目をどうするかを Claude と相談して設計書にまとめ、それに沿って作らせました。相談の中で決めたのは、たとえば次のようなことです。

• Claude の値は、Claude Code が渡してくれるものだけを使い、トークンを扱わない
• リセット時刻を過ぎた枠は、古い使用率を出さずに「—」にする
• 最初は Claude の5時間と週だけを出し、Codex と Fable は動くものができてから足す

常駐版も、設計書を先に作ってから作らせました。常駐版の設計書と作らせ方は、noteにまとめています。

つまずいたところ

設定より前に開いたセッションには帯が出ない

設定で mod を読み込ませたあと、すでに開いていたセッションには帯が出ませんでした。そうしたセッションには mod が入っていないようで、新しいセッションを開くと帯が出ました。

デスクトップアプリの分割ビューでは帯が出ない

新しいセッションで帯が出たあと、そのセッションを分割ビューへ移すと、帯が消えました。幅が足りないなら文字だけの表示に切り替わる作りなので、何も出ないのは幅の問題ではなさそうでした。

そこで、帯を描くたびに記録を残す仕掛けを一時的に入れて確かめました。単独で開いているときは帯を描く処理が呼ばれていましたが、分割ビューへ移したあとは1回も呼ばれていません。値の更新は続いていたので、mod は動いていて、アプリが分割ビューで帯を描こうとしていない、という結果です。

mod からは直せないと判断しました。分割ビューで使うときは、残量はほかの方法で見ることになります。確かめたのは10月5日のデスクトップアプリ（同梱の Claude Code 2.1.286）で、アプリが更新されれば変わるかもしれません。

常駐版は結局残しました

mod は Claude Code の中で動くので、Claude Code を開いていない間は値を取れません。使ってみると、Claude の値は Claude に何かを頼んで応答が返ってきたときに入ってきました。しばらく使っていないと、帯に出るのは最後に使ったときの値です。

常駐版には、2時間ごとに Claude Code を短く動かす定期タスクがあります。もとはトークンを保つための仕組みです。ここで動く Claude Code にも mod を読み込ませると、使っていない間も mod の値が新しくなりました。このタスクは常駐版の仕組みとして入れたもので、mod だけでは代わりになりません。

アプリの中だけで済ませるつもりで作り始めましたが、仕組みの上では常駐版の力を借りる形になりました。タスクバーの上の帯も残して、mod と並べて使っています。

まとめ

Claude Code の mod は、欲しいものを Claude に説明すれば作ってもらえます。残量バーはプロンプト入力欄の上に収まり、Claude の値はトークンを扱わずに取れるようになりました。

一方で、mod は Claude Code を開いている間しか動かず、分割ビューでは帯が出ません。アプリの中だけで済ませるという最初の狙いは、半分だけ叶った形です。

この残量バーは、ブログで1円稼ぐ副業の実験で使っている道具の1つです。実験の経過は初収益の記事に書いています。Codex のモデルを比べたSol と Astra の記事でも、枠の使用率は残量バーと同じところから読んでいます。