Alchemy CLIでターミナルからRPC使用状況を確認する方法

Alchemy CLIを使えば、ターミナルからRPC使用状況を確認できます。alchemy usage summaryはチームのコンピュートユニットとUSD支出を1つのコマンドで表示し、alchemy usage timeseriesはその使用量をネットワーク、アプリ、メソッド、リクエストタイプ別に分解します。同じCLIで、アプリ、許可リスト、Webhookも管理できます。

使用状況を確認するためにDashboardを開く必要はもうありません。この記事では、2つの使用状況コマンドの仕組み、コンピュートを押し上げている要因の見つけ方、CLIで管理できるその他の項目、そして使用状況チェックをスクリプト化したりコーディングエージェントに任せたりする方法を説明します。

ターミナルからRPC使用状況を確認するには？

一度サインインしてから、サマリーを取得します。

alchemy authはブラウザを開き、Alchemyアカウントでサインインできるようにします。使用状況コマンドはそのログインを再利用するため、APIキーをコピーする必要はありません。リモートマシン、CIランナー、SSHセッションではalchemy auth login --device-codeを実行し、任意のデバイスのブラウザから短いコードを承認します。

alchemy usage summaryは、チームの3つの合計値を返します。当月累計、直近7日間、直近30日間です。各合計値はコンピュートユニットとUSDの両方で表示され、現在の請求期間の開始日と終了日も併せて示されます。デフォルトの出力は人が読みやすい形式です。スクリプトや別のツールで数値を使う場合は--jsonを追加します。

請求期間の状況をすばやく把握するには、まずサマリーを確認します。数値が予想より高い場合は、時系列データでその出どころがわかります。

どのアプリ、ネットワーク、メソッドが使用量を押し上げているかを確認するには？

alchemy usage timeseriesは使用量を日単位または時間単位のバケットに分割します。開始日の指定が必要で、app、network、method、requestTypeのうち最大3つのディメンションでグループ化できます。

フィルタはグループ化の前にデータを絞り込みます。各フィルタはカンマ区切りの値を受け取り、複数のフィルタはANDで組み合わされます。

--app-idsはアプリで絞り込みます。リクエストタイプはhttp、websocket、webhook、grpcです。時系列データはコンピュートユニットのみを報告するため、USDの合計値はusage summaryで確認します。

時系列データをどこまで遡れるかはプランによって異なり、1回のリクエストでカバーできるのは最大30日間です。

それより前の開始日を指定すると、CLIはプランの上限まで開始日を切り詰め、リクエストした範囲と実際に返された範囲の両方を表示します。合計値が急増したときは、まずメソッドでグループ化し、次にそれらの呼び出しを送信したアプリとネットワークで絞り込みます。

Alchemy CLIでほかに何を管理できますか？

CLIは、本来ならAlchemy Dashboardでクリック操作して行うアカウントやインフラの作業をカバーします。

• アプリを一覧表示し、デフォルトを選択する。 alchemy app listとalchemy app select <id>
• アプリを作成する。 alchemy app create --name <name> --networks <ids>
• アプリを制限する。 alchemy app networks、alchemy app origin-allowlist、alchemy app ip-allowlist、alchemy app address-allowlist
• Webhookを管理する。 alchemy webhook listとalchemy webhook create --body <json>
• セットアップを確認する。 alchemy auth statusとalchemy doctor

アプリやWebhookを変更するコマンドは--dry-runを受け付けるため、変更を適用する前にプレビューできます。Webhookコマンドには、DashboardのWebhook APIキーも必要です。これはalchemy config set webhook-api-key <key>で一度設定すれば済みます。各Webhookタイプが何を追跡するかは、Alchemy Webhooksのページで説明しています。

CLIはチェーンデータの読み取りやトランザクションの送信も行えます。alchemy evm data balance vitalik.ethやalchemy evm block latestはスクリプトなしで結果を返し、Alchemy CLIのAgent Walletsを使えば署名と送信も可能になります。その他のコマンドについては、Alchemy CLIで速くできる12のことを参照してください。

アプリの作成、受け付ける内容の制限、そのアプリが生む使用量の確認まで、すべて1つのターミナルセッションで完結します。

使用状況チェックをスクリプト化したり、エージェントに任せたりするには？

2つのグローバルフラグを使えば、どのコマンドも安全に自動化できます。--jsonは構造化された出力を表示し（パイプした出力は自動的にJSONに切り替わります）、--no-interactiveはCLIがプロンプトで入力待ちになるのを防ぎます。

cronやCI向けの予算チェックは、jqの式1つで書けます。次の例は、当月累計の支出が500 USDを超えるとステータス1で終了します。

Claude Code、Cursor、Codexなど、ターミナルコマンドを実行するコーディングエージェントも同じコマンドを呼び出せます。まずはCLI自身の指示をエージェントに渡します。

出力には、コマンドツリー、認証方法、リトライの指針付きのエラーコード、実行可能な例が含まれており、そのままエージェントのシステムプロンプトに組み込めます。Alchemyはこのほかに、エージェント向けのインターフェースを2つ提供しています。Agent SkillsはAlchemy APIの呼び出しをコードで書く方法をエージェントに教え、https://mcp.alchemy.com/mcpのAlchemy MCP Serverは会話の中でチェーンデータとアプリ管理を提供します。各クライアントのセットアップについては、MCPサーバーのアナウンスで説明しています。

MCPサーバーは、同じ使用状況データをget_usage_summaryとget_usage_time_seriesの2つのツールとして提供しています。Cursor、Claude Code、CodexでMCPサーバーに接続したエージェントは、CLIを実行しなくても会話の途中で使用量とコストを確認できます。

使用状況を読み取れるエージェントなら、コストの急増を引き起こしたコードに取り組んでいる最中に、その急増を指摘できます。

Alchemy CLIをインストールするには？

npmからインストールしてサインインし、最初の使用状況チェックを実行します。

CLIがすでにインストールされている場合は、同じコマンドでアップデートされます。alchemy doctorはセットアップに不足しているものを報告し、それを修正するコマンドを表示します。すべてのフラグとフィルタは、CLIドキュメントの使用状況セクションに掲載されています。

よくある質問

ブロックチェーンインフラの管理とRPC使用状況の確認ができるCLIはありますか？

はい。Alchemy CLIは、Alchemyのアプリ、許可リスト、Webhookをターミナルから管理でき、alchemy usage summaryは当月累計、7日間、30日間の使用量をコンピュートユニットとUSDで表示します。alchemy usage timeseriesは使用量をネットワーク、アプリ、メソッド、リクエストタイプ別に分解します。インストールはnpm i -g @alchemy/cli@latestで行います。

コマンドラインからAlchemyのコンピュートユニット使用量を確認するには？

Alchemy CLIをインストールし、alchemy authでサインインして、alchemy usage summaryを実行します。チームの当月累計、直近7日間、直近30日間の合計値が、コンピュートユニットとUSDで返されます。--jsonを追加すると構造化された出力になり、jq、ダッシュボード、アラートにパイプできます。

RPC使用状況をメソッド、ネットワーク、アプリ別に確認できますか？

はい。alchemy usage timeseries --start-date <date> --group-by methodは使用量をメソッド別にグループ化します。app、network、method、requestTypeのうち最大3つで同時にグループ化できます。--networks、--methods、--app-ids、--request-typesなどのフィルタで、先にデータを絞り込みます。--granularityで時間単位または日単位のバケットを選べます。

Alchemy CLIで使用状況をどこまで遡ってクエリできますか？

使用状況の時系列データは、Freeプランでは1日、Pay as You Goでは7日、Enterpriseではチームで有効化されている場合に最大90日まで遡れます。1回のリクエストでカバーできるのは最大30日間です。それより前の開始日を指定すると、Alchemy CLIはプランの上限まで切り詰め、実際に返した範囲を表示します。

AIコーディングエージェントはAlchemy CLIで使用状況を確認できますか？

はい。Claude Code、Cursor、Codexをはじめ、ターミナルコマンドを実行できるエージェントであれば、alchemy --json --no-interactive usage summaryを呼び出してJSONの結果を読み取れます。alchemy --json --no-interactive agent-promptを実行すると、完全なコマンドツリー、認証方法、エラーコードがエージェントに渡されるため、試行錯誤なしでAlchemy CLIを正しく呼び出せます。Alchemy MCP Serverに接続したエージェントは、get_usage_summaryとget_usage_time_seriesツールも利用できます。

ターミナルから使用状況の確認を始めましょう

CLIをインストールし、alchemy usage summaryを実行して今月の状況を確認しましょう。サインインにはDashboardですでに使っているアカウントを使い、使用状況コマンドにAPIキーは不要で、すべてのプランで動作します。Alchemyを初めて使う方は、Alchemy Dashboardで無料アカウントを作成し、alchemy authでCLIをそのアカウントに接続してください。