クイックスタート：AI プラットフォームのクォータを一括クエリ

学習後のスキル

5分以内にopencode-mystatusプラグインをインストールする
スラッシュコマンド /mystatus を設定する
インストールを検証し、最初のAIプラットフォームのクォータをクエリする

現在の課題

あなたは複数のAIプラットフォーム（OpenAI、Zhipu AI、GitHub Copilot、Google Cloudなど）を使用して開発を行っていますが、毎日頻繁に各プラットフォームの残りのクォータを確認する必要があります。毎回各プラットフォームにログインして確認するのは時間がかかりすぎます。

いつ使用するか

OpenCodeに初めて触れる時：初心者として最初にインストールするプラグイン
マルチプラットフォームのクォータ管理が必要な時：OpenAI、Zhipu AI、GitHub Copilotなど複数のプラットフォームを同時に使用している場合
チームコラボレーション環境：チームメンバーで複数のAIアカウントを共有しており、クォータを一元的に確認したい場合

🎒 始める前の準備

開始前に、以下のことを確認してください：

前提条件

[ ] OpenCode がインストールされていること
[ ] 少なくとも1つのAIプラットフォームの認証情報が設定されていること（OpenAI、Zhipu AI、Z.ai、GitHub Copilot、またはGoogle Cloud）

まだどのAIプラットフォームも設定していない場合は、まずOpenCodeで少なくとも1つのプラットフォームのログインを完了してから、このプラグインをインストールすることをお勧めします。

コアコンセプト

opencode-mystatusはOpenCodeのプラグインであり、その核心的な価値は以下の通りです：

認証ファイルの自動読み取り：OpenCodeの公式認証ストレージから、設定されたすべてのアカウント情報を読み取ります
各プラットフォームの並列クエリ：OpenAI、Zhipu AI、Z.ai、GitHub Copilot、Google Cloudの公式APIを同時に呼び出します
視覚的な表示：プログレスバーとカウントダウンタイマーで残りクォータを直感的に表示します

インストールプロセスはシンプルです：

OpenCode設定ファイルにプラグインとスラッシュコマンドを追加
OpenCodeを再起動
/mystatus と入力してクォータをクエリ

実践

ステップ1：インストール方法の選択

opencode-mystatusは3つのインストール方法を提供しています。お好みに合わせて1つを選択してください：

AIにインストールさせる（推奨）手動インストールローカルファイルからインストール

bash

以下の内容を任意のAIエージェント（Claude Code、OpenCode、Cursorなど）に貼り付けてください：

Install opencode-mystatus plugin by following: https://raw.githubusercontent.com/vbgate/opencode-mystatus/main/README.md

bash

~/.config/opencode/opencode.json を開き、ステップ2で設定を編集します

bash

プラグインファイルを ~/.config/opencode/plugin/ ディレクトリにコピーします（詳細はステップ4を参照）

AIによるインストールが推奨される理由：AIエージェントがすべての設定手順を自動的に実行し、確認するだけで済むため、最も迅速かつ簡単です。

ステップ2：手動インストール設定（手動インストールの場合必須）

手動インストールを選択した場合、OpenCode設定ファイルを編集する必要があります。

2.1 設定ファイルを開く

bash

# macOS/Linux
code ~/.config/opencode/opencode.json

# Windows
code %APPDATA%\opencode\opencode.json

2.2 プラグインとスラッシュコマンドを追加

設定ファイルに以下の内容を追加します（既存の plugin と command 設定は保持し、新しい設定項目を追加します）：

json

{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool to query quota usage. Return the result as-is without modification."
    }
  }
}

このように設定する理由：

設定項目	値	役割
`plugin` 配列	`["opencode-mystatus"]`	OpenCodeにこのプラグインをロードさせる
`description`	"Query quota usage for all AI accounts"	スラッシュコマンドリストに表示される説明
`template`	"Use the mystatus tool..."	OpenCodeにmystatusツールを呼び出す方法を指示する

期待される結果：設定ファイルに完全な plugin と command フィールドが含まれ、形式が正しい（JSONのカンマと引用符に注意）。

ステップ3：ローカルファイルからのインストール（ローカルインストールの場合必須）

ローカルファイルからインストールを選択した場合、プラグインファイルを手動でコピーする必要があります。

3.1 プラグインファイルをコピー

bash

# opencode-mystatusソースコードを ~/opencode-mystatus/ にクローン済みと仮定します

# メインプラグインとライブラリファイルをコピー
cp -r ~/opencode-mystatus/plugin/mystatus.ts ~/.config/opencode/plugin/
cp -r ~/opencode-mystatus/plugin/lib/ ~/.config/opencode/plugin/

# スラッシュコマンド設定をコピー
cp ~/opencode-mystatus/command/mystatus.md ~/.config/opencode/command/

なぜこれらのファイルをコピーする必要があるのか：

mystatus.ts：プラグインのメインエントリーファイルで、mystatusツールの定義が含まれています
lib/ ディレクトリ：OpenAI、Zhipu AI、Z.ai、GitHub Copilot、Google Cloudのクエリロジックが含まれています
mystatus.md：スラッシュコマンドの設定記述

期待される結果：~/.config/opencode/plugin/ ディレクトリに mystatus.ts と lib/ サブディレクトリがあり、~/.config/opencode/command/ ディレクトリに mystatus.md があります。

ステップ4：OpenCodeを再起動

どのインストール方法を選択した場合でも、最後のステップはOpenCodeを再起動することです。

再起動が必要な理由：OpenCodeは起動時にのみ設定ファイルを読み取るため、設定を変更した後は再起動が必要です。

期待される結果：OpenCodeが再起動した後、正常に使用できるようになります。

ステップ5：インストールを検証

ここでインストールが成功したかどうかを検証します。

5.1 スラッシュコマンドをテスト

OpenCodeで以下を入力します：

bash

/mystatus

期待される結果：

少なくとも1つのAIプラットフォームの認証情報が設定されている場合、以下のような出力が表示されます（OpenAIを例にします）：

日本語システム出力英語システム出力

markdown

## OpenAI アカウントクォータ

Account:        user@example.com (team)

3時間制限
████████████████████████ 剩余 85%
リセット: 2h 30m後

markdown

## OpenAI Account Quota

Account:        user@example.com (team)

3-hour limit
████████████████████████ 85% remaining
Resets in: 2h 30m

出力言語について

プラグインはシステム言語を自動的に検出します（日本語システムでは日本語を表示、英語システムでは英語を表示）。上記の2つの出力はどちらも正しいです。

まだアカウントが設定されていない場合、以下が表示されます：

日本語システム出力英語システム出力

markdown

設定済みのアカウントが見つかりません。

サポートされているアカウントタイプ:
- OpenAI (Plus/Team/Pro サブスクリプションユーザー)
- Zhipu AI (Coding Plan)
- Z.ai (Coding Plan)
- Google Cloud (Antigravity)

markdown

No configured accounts found.

Supported account types:
- OpenAI (Plus/Team/Pro subscribers)
- Zhipu AI (Coding Plan)
- Z.ai (Coding Plan)
- Google Cloud (Antigravity)

5.2 出力の意味を理解する

要素（日本語版）	要素（英語版）	意味
`## OpenAI アカウントクォータ`	`## OpenAI Account Quota`	プラットフォームタイトル
`user@example.com (team)`	`user@example.com (team)`	アカウント情報（メールアドレスまたはチーム）
`3時間制限`	`3-hour limit`	クォータタイプ（3時間制限）
`剩余 85%`	`85% remaining`	残りパーセンテージ
`リセット: 2h 30m後`	`Resets in: 2h 30m`	リセット時間のカウントダウン

なぜAPI Keyが完全に表示されないのか：プライバシーを保護するため、プラグインは自動的にマスキング表示されます（例：9c89****AQVM）。

チェックポイント ✅

以下のステップが完了していることを確認してください：

ステップ	チェック方法	期待される結果
プラグインのインストール	`~/.config/opencode/opencode.json` を確認	`plugin` 配列に `"opencode-mystatus"` が含まれている
スラッシュコマンドの設定	同じファイルを確認	`command` オブジェクトに `mystatus` 設定が含まれている
OpenCodeの再起動	OpenCodeプロセスを確認	再起動されている
コマンドのテスト	`/mystatus` と入力	クォータ情報または「設定済みのアカウントが見つかりません」が表示される

よくある落とし穴

一般的なエラー1：JSON形式エラー

現象：OpenCodeの起動に失敗し、JSON形式エラーが表示される

原因：設定ファイルにカンマや引用符の過不足がある

解決方法：

オンラインJSON検証ツールを使用して形式をチェックしてください：

json

// ❌ エラー：最後の項目に余分なカンマ
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool..."
    }
  }  // ← ここにカンマを入れてはいけません
}

// ✅ 正しい
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool..."
    }
  }
}

一般的なエラー2：OpenCodeの再起動を忘れる

現象：設定完了後に /mystatus と入力すると、「コマンドが見つかりません」と表示される

原因：OpenCodeが設定ファイルを再読み込みしていない

解決方法：

OpenCodeを完全に終了する（最小化ではない）
OpenCodeを再起動する
/mystatus コマンドを再度試す

一般的なエラー3：「設定済みのアカウントが見つかりません」と表示される

現象：/mystatus を実行すると「設定済みのアカウントが見つかりません」と表示される

原因：まだOpenCodeでどのAIプラットフォームにもログインしていない

解決方法：

OpenCodeで少なくとも1つのAIプラットフォーム（OpenAI、Zhipu AI、Z.ai、GitHub Copilot、またはGoogle Cloud）にログインする
認証情報が自動的に ~/.local/share/opencode/auth.json に保存される
/mystatus を再度実行する

一般的なエラー4：Google Cloud クォータクエリに失敗

現象：他のプラットフォームは正常にクエリできるが、Google Cloudのみエラーが表示される

原因：Google Cloudには追加の認証プラグインが必要

解決方法：

まず opencode-antigravity-auth プラグインをインストールして、Googleアカウント認証を完了してください。

まとめ

このレッスンでは、opencode-mystatusのインストールと基本的な検証を完了しました：

3つのインストール方法：AIにインストールさせる（推奨）、手動インストール、ローカルファイルからインストール
設定ファイルの場所：~/.config/opencode/opencode.json
重要な設定項目：
- plugin 配列："opencode-mystatus" を追加
- command オブジェクト：mystatus スラッシュコマンドを設定
検証方法：OpenCodeを再起動して /mystatus と入力
認証の自動読み取り：プラグインは自動的に ~/.local/share/opencode/auth.json から設定済みのアカウント情報を読み取ります

インストール完了後、OpenCodeで /mystatus コマンドまたは自然言語を使用して、すべてのAIプラットフォームのクォータをクエリできます。

次のレッスン

次のレッスンでは mystatusの使用：スラッシュコマンドと自然言語 を学びます。
学べること：
スラッシュコマンド /mystatus の詳細な使い方
自然言語でmystatusツールをトリガーする方法
2つのトリガー方法の違いと適用シナリオ
スラッシュコマンドの設定原理

付録：ソースコード参照

クリックしてソースコードの場所を展開

更新日時：2026-01-23

機能	ファイルパス	行番号
プラグインエントリ	`plugin/mystatus.ts`	26-94
mystatusツール定義	`plugin/mystatus.ts`	29-33
認証ファイルの読み取り	`plugin/mystatus.ts`	35-46
すべてのプラットフォームの並列クエリ	`plugin/mystatus.ts`	49-56
結果の収集と集計	`plugin/mystatus.ts`	58-89
スラッシュコマンド設定	`command/mystatus.md`	1-6

重要な定数：

認証ファイルパス：~/.local/share/opencode/auth.json（plugin/mystatus.ts:35）

重要な関数：

mystatus()：mystatusツールのメイン関数、認証ファイルを読み取り、すべてのプラットフォームを並列クエリする（plugin/mystatus.ts:29-33）
collectResult()：クエリ結果をresultsとerrors配列に収集する（plugin/mystatus.ts:100-116）
queryOpenAIUsage()：OpenAIクォータをクエリする（plugin/lib/openai.ts）
queryZhipuUsage()：Zhipu AIクォータをクエリする（plugin/lib/zhipu.ts）
queryZaiUsage()：Z.aiクォータをクエリする（plugin/lib/zhipu.ts）
queryGoogleUsage()：Google Cloudクォータをクエリする（plugin/lib/google.ts）
queryCopilotUsage()：GitHub Copilotクォータをクエリする（plugin/lib/copilot.ts）

設定ファイル形式： OpenCode設定ファイル ~/.config/opencode/opencode.json のプラグインとスラッシュコマンド設定は README.zh-CN.md の33-82行を参照してください。