OpenCodeDocs

日本語

English
简体中文
繁體中文
한국어
Español
Français
Deutsch
Português
Русский

日本語

English
简体中文
繁體中文
한국어
Español
Français
Deutsch
Português
Русский

テーマ

クイックスタート：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のプラグインであり、その核心的な価値は以下の通りです：

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

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

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

実践 ​

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

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

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:        [email protected] (team)

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

Account:        [email protected] (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プラットフォームタイトル
[email protected] (team)[email protected] (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が設定ファイルを再読み込みしていない

解決方法：

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

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

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

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

解決方法：

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

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

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

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

解決方法：

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

まとめ ​

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

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

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

次のレッスン ​

次のレッスンでは mystatusの使用：スラッシュコマンドと自然言語 を学びます。

学べること：

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

付録：ソースコード参照 ​

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

更新日時：2026-01-23

機能ファイルパス行番号
プラグインエントリplugin/mystatus.ts26-94
mystatusツール定義plugin/mystatus.ts29-33
認証ファイルの読み取りplugin/mystatus.ts35-46
すべてのプラットフォームの並列クエリplugin/mystatus.ts49-56
結果の収集と集計plugin/mystatus.ts58-89
スラッシュコマンド設定command/mystatus.md1-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行を参照してください。