custom-usage-statusline
Claude Codeの使用状況ステータスラインを設定し、セッション(5時間)と週間(7日)の利用限度のパーセンテージを表示します。ユーザーが使用状況ステータスラインの設定、利用限度の表示、または使用状況表示の構成をリクエストしたときに使用します。
description の原文を見る
Set up a Claude Code statusline that shows session (5h) and weekly (7d) usage limit percentages. Use when user asks to set up usage statusline, show usage limits, or configure usage display.
SKILL.md 本文
使用状況ステータスラインのセットアップ
このスキルは Claude Code のステータスラインを設定し、コンテキストウィンドウバーとともに使用制限(セッション 5h / 週間 7d)を表示します。
動作内容
- OAuth トークンをシステムキーチェーンから読み込みます(個別のログインは不要)
- macOS:
security find-generic-password経由で macOS Keychain から読み込み - Linux:
secret-tool経由で GNOME Keyring から読み込み、~/.claude/.credentials.jsonへのフォールバック対応
- macOS:
- 使用状況 API を呼び出します(
GET https://api.anthropic.com/api/oauth/usage、タイムアウト 3 秒) - レスポンスをキャッシュします -
/tmp/claude-statusline-usage.jsonに 60 秒間保存し、API への過度なアクセスを回避 - ステータスラインにコンテキスト、セッション、週間の使用率をパーセンテージで表示します - 各項目は使用レベルに応じて緑/黄/赤で色分け
- エラーに強い動作 — トークンが見つからない、API に接続できない、またはその他のエラーが発生した場合でも、使用状況セクションは単に省略されます
必須要件
jqがインストールされていることcurlがインストールされていること- 有効な Claude AI OAuth セッション(Claude Code にログインしていること)
手順
ユーザーがこのスキルを呼び出したとき、以下を実行します:
ステップ 1: ステータスラインスクリプトをコピー
このスキルのディレクトリから付属のスクリプトを ~/.claude/statusline-command.sh にコピーします:
- このスキルのベースディレクトリから
statusline-command.shファイルを読み込みます(スキルプロンプトの上部に表示) - その内容を
~/.claude/statusline-command.shに書き込みます
ステップ 2: settings.json を設定
~/.claude/settings.json がステータスラインの設定を含むことを確認します。ファイルがすでに存在する場合は、他の設定を上書きせずに statusLine キーをマージします:
{
"statusLine": {
"type": "command",
"command": "sh ~/.claude/statusline-command.sh"
}
}
$HOME を展開した絶対パスを使用します(例:sh /Users/username/.claude/statusline-command.sh)。
ステップ 3: 動作確認
テスト入力でスクリプトを実行して、動作することを確認します:
echo '{"model":{"display_name":"Opus 4.6"},"context_window":{"used_percentage":42}}' | sh ~/.claude/statusline-command.sh
出力にモデル名、コンテキストバー、および(認証済みの場合)使用率パーセンテージが表示されるはずです。
共有
同僚と共有する場合:
~/.claude/skills/custom-usage-statusline/ディレクトリを彼らの~/.claude/skills/フォルダにコピーします- Claude Code で
/usage-statuslineを実行してセットアップできます
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- assertchris
- ライセンス
- MIT
- 最終更新
- 2026/4/17
Source: https://github.com/assertchris/claude-skills / ライセンス: MIT