コンテンツへスキップ
創業プロモーション：先行支援者にはOpenLimiter Proを50%OFFで提供
OpenLimiter
Proを入手
ドキュメントメニュー

はじめに

OpenLimiterは、すでにお金を払っているAIサブスクリプションのためのquota meterです。あなたのマシン上で動き、ツールがすでにそこに書き込んだものを読み取り、コーディングエージェントに、残っている予算の範囲が定まった全体像を渡します。

必要なもの

  • Node 24以降。
  • Nodeに同梱されているnpm。

すべてローカルで動きます。アカウントは作られず、始めるのにキーも必要なく、以下のどの手順でもリクエストがマシンの外へ出ることはありません。

OpenLimiterをインストールする

コマンドラインツールをグローバルにインストールし、合成データによるデモを実行します。

ターミナル
npm install -g openlimiter
openlimiter demo

openlimiter demoは合成フィクスチャを描画します。実際のアカウントに一切触れずにバイナリが動くことを示すもので、出力される数値はすべて架空のものです。

meterする対象を与える

OpenLimiterはこのリリースでプロバイダーに接続することは決してありません。すでに何かが目の前に置いたデータをパースするだけです。取り込み経路のいずれかが動くまで、すべてのコマンドは正直にunknownを報告します。

追加の作業が要らない経路は、Claude Codeのstatuslineです。Claude Codeは描画のたびにあなたのstatuslineコマンドを実行し、現在のセッションを表すJSONオブジェクトをそのコマンドの標準入力に書き込みます。そのオブジェクトがレート制限ブロックを含んでいる場合、OpenLimiterはそれを検証し、キャッシュに保存し、同じ呼び出しの中で新しい数値を描画します。

ターミナル
openlimiter statusline < session.json
OpenLimiter NEAR_CAP NONE UNKNOWN OPENROUTER,CODEX,ANTIGRAVITY,OPENCODE,MANUAL  CLAUDE ####. 87.5%

すべてのClaude Codeのバージョンがレート制限のフィールドを送るわけではありません。もし送られない場合、この経路は静かなままで、残る2つの手動の経路は引き続き機能します。取り込みのページで3つすべてを扱っています。

Claude Codeを組み込む

これをClaude Codeのsettings.jsonに追加してください。グローバルインストールによって、openlimiterコマンドがClaude Codeから使えるようになります。

settings.json
{
  "statusLine": {
    "type": "command",
    "command": "openlimiter statusline"
  },
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "openlimiter hook"
          }
        ]
      }
    ]
  }
}

ソースから貢献する

貢献したい場合は、リポジトリのツールチェーンを使ってください。

ターミナル
git clone https://github.com/lucaswebsystems/openlimiter
cd openlimiter
pnpm install
pnpm build
pnpm typecheck
pnpm test
node packages/cli/dist/bin.js demo

型チェックより先にビルドを実行する必要があります。各パッケージは、ビルドが生成する宣言ファイルを通じて隣接パッケージを解決するためです。

次に読むもの

おすすめの読み進め方

  1. 1この問題が何を解決するかについてはOpenLimiterを使う理由を。
  2. 2各connectorが何を読み取り、どれくらい壊れやすいかについては対応プロバイダーを。
  3. 3エージェントに正確に何が届くかについてはAgent contextを。
  4. 4すべてのコマンドと終了コードについてはCLIリファレンスを。