如何使用 Alchemy CLI 在终端中查看 RPC 用量

Q: 有没有用于管理区块链基础设施和查看 RPC 用量的 CLI？

有。Alchemy CLI 可以在终端中管理 Alchemy app、白名单和 webhook，alchemy usage summary 会以 compute unit 和美元显示本月至今、最近 7 天和最近 30 天的用量。alchemy usage timeseries 按 network、app、method 或 request type 拆分用量。使用 npm i -g @alchemy/cli@latest 安装。

Q: 如何从命令行查看我的 Alchemy compute unit 用量？

安装 Alchemy CLI，用 alchemy auth 登录，然后运行 alchemy usage summary。它会以 compute unit 和美元返回团队本月至今、最近 7 天和最近 30 天的总量。加上 --json 可获得结构化输出，便于通过管道传给 jq、仪表盘或告警系统。

Q: 能否按 method、network 或 app 查看 RPC 用量？

可以。alchemy usage timeseries --start-date --group-by method 会按 method 对用量分组，你最多可以同时按 app、network、method 和 requestType 中的三个维度分组。--networks、--methods、--app-ids 和 --request-types 等过滤条件会先缩小数据范围。用 --granularity 选择按小时或按天的粒度。

Q: AI 编码 agent 能用 Alchemy CLI 查看用量吗？

能。任何能运行终端命令的 agent，包括 Claude Code、Cursor 和 Codex，都可以调用 alchemy --json --no-interactive usage summary 并读取 JSON 结果。运行 alchemy --json --no-interactive agent-prompt 可以为 agent 提供完整的命令树、认证方式和错误码，让它无需反复试错就能正确调用 Alchemy CLI。连接了 Alchemy MCP Server 的 agent 也可以使用其中的 get_usage_summary 和 get_usage_time_series 工具。

作者：Lisa Ma

最后更新：2026年7月2日3 分钟阅读

Alchemy CLI 让你可以在终端中查看 RPC 用量。alchemy usage summary 用一条命令显示团队的 compute unit 和美元支出，alchemy usage timeseries 则按 network、app、method 或 request type 拆分这些用量。同一个 CLI 还可以管理你的 app、白名单和 webhook。

查看用量不再需要打开 Dashboard。本文介绍这两个用量命令如何工作、如何找出 compute 消耗的来源、CLI 还能管理哪些内容，以及如何把用量检查写成脚本或交给编码 agent。

如何在终端中查看 RPC 用量？

先登录一次，再查看汇总。

bash

Copied

alchemy auth
alchemy usage summary

alchemy auth 会打开浏览器，让你用 Alchemy 账户登录。用量命令会复用这次登录，因此无需复制 API key。在远程机器、CI runner 或 SSH 会话中，运行 alchemy auth login --device-code，然后在任意设备的浏览器上批准显示的短代码。

alchemy usage summary 返回团队的三个总量：本月至今、最近 7 天和最近 30 天。每个总量都以 compute unit 和美元两种单位给出，并附上当前账单周期的起止时间。默认输出是人类可读的格式。当脚本或其他工具需要这些数字时，加上 --json。

bash

Copied

alchemy --json usage summary

先用汇总快速了解当前账单周期的情况。当某个数字高于预期时，时间序列会告诉你它从何而来。

如何查看用量来自哪个 app、network 或 method？

alchemy usage timeseries 把用量拆分为按天或按小时的时间桶。它需要一个开始日期，最多可以同时按以下维度中的三个分组：app、network、method 和 requestType。

bashCopied
# Window start, 6 days ago (macOS syntax first, then Linux)
SINCE=$(date -u -v-6d +%F 2>/dev/null || date -u -d '6 days ago' +%F)
# Usage per network, per day
alchemy usage timeseries --start-date "$SINCE" --group-by network
# Usage per app and method
alchemy usage timeseries --start-date "$SINCE" --group-by app,method
# Hourly usage per method, to pin down when a spike started
alchemy usage timeseries --start-date "$SINCE" --granularity hour --group-by method

过滤条件会在分组之前缩小数据范围。每个过滤条件都接受逗号分隔的值，多个过滤条件之间以 AND 组合。

bashCopied
alchemy usage timeseries --start-date "$SINCE" --networks base-mainnet --methods eth_getLogs
alchemy usage timeseries --start-date "$SINCE" --request-types websocket,webhook

--app-ids 按 app 过滤，request type 包括 http、websocket、webhook 和 grpc。时间序列只报告 compute unit，美元总额需要通过 usage summary 获取。

时间序列能回溯多久取决于你的套餐，单次请求最多覆盖 30 天。

套餐	时间序列回溯范围
免费版	1 天
按量付费	7 天
企业版	最多 90 天，需为你的团队启用

如果你请求的开始日期更早，CLI 会将其限制在套餐允许的范围内，并同时显示请求的范围和实际返回的范围。当某个总量突然上升时，先按 method 分组，再过滤到发出这些调用的 app 和 network。

Alchemy CLI 还能管理什么？

原本需要在 Alchemy Dashboard 中逐项点击完成的账户和基础设施操作，CLI 都能处理。

列出 app 并选择默认 app。alchemy app list 和 alchemy app select <id>
创建 app。alchemy app create --name <name> --networks <ids>
限制 app 的访问。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

修改 app 或 webhook 的命令都支持 --dry-run，让你在变更生效前先预览。webhook 命令还需要一个来自 Dashboard 的 webhook API key，用 alchemy config set webhook-api-key <key> 设置一次即可。我们的 Alchemy Webhooks 页面介绍了每种 webhook 类型跟踪的内容。

CLI 还能读取链上数据并发送交易。alchemy evm data balance vitalik.eth 和 alchemy evm block latest 无需编写脚本就能返回结果，Alchemy CLI 的 Agent Wallets 则增加了签名和发送功能。其余命令请参阅使用 Alchemy CLI 更快完成的 12 件事。

创建 app、限制它接受的请求、查看它产生的用量，都可以在同一个终端会话中完成。

如何把用量检查写成脚本或交给 agent？

两个全局标志让任何命令都能安全地自动化运行。--json 输出结构化数据（通过管道输出时会自动切换为 JSON），--no-interactive 让 CLI 不再等待交互提示。

用于 cron 或 CI 的预算检查只需一个 jq 表达式。下面这个表达式会在本月至今的支出超过 500 美元时以状态码 1 退出。

bash

Copied

alchemy --json --no-interactive usage summary | jq -e '(.data.totals.monthToDate.usd | tonumber) <= 500'

能运行终端命令的编码 agent（例如 Claude Code、Cursor 和 Codex）可以调用同样的命令。先把 CLI 自带的使用说明交给 agent。

bash

Copied

alchemy --json --no-interactive agent-prompt

输出内容包括命令树、认证方式、附带重试建议的错误码以及可运行的示例，可以直接放进 agent 的系统提示词。我们还提供另外两种面向 agent 的接口。Agent Skills 教 agent 在代码中编写 Alchemy API 调用，位于 https://mcp.alchemy.com/mcp 的 Alchemy MCP Server 则在对话中为 agent 提供链上数据和 app 管理能力。我们的 MCP 发布公告介绍了各个客户端的配置方法。

MCP server 以 get_usage_summary 和 get_usage_time_series 两个工具开放同样的用量数据。在 Cursor、Claude Code 或 Codex 中连接了 MCP server 的 agent，无需运行 CLI，就能在对话中查看用量和成本。

能读取用量的 agent，在处理导致成本激增的代码时，就能及时指出这次激增。

如何安装 Alchemy CLI？

从 npm 安装、登录，然后运行第一次用量检查。

bash

Copied

npm i -g @alchemy/cli@latest
alchemy auth
alchemy usage summary

如果已经安装了 CLI，同一条命令会将其更新。alchemy doctor 会报告配置中缺少的内容，并打印修复所需的命令。CLI 文档的用量部分列出了所有标志和过滤条件。

常见问题

有没有用于管理区块链基础设施和查看 RPC 用量的 CLI？

有。Alchemy CLI 可以在终端中管理 Alchemy app、白名单和 webhook，alchemy usage summary 会以 compute unit 和美元显示本月至今、最近 7 天和最近 30 天的用量。alchemy usage timeseries 按 network、app、method 或 request type 拆分用量。使用 npm i -g @alchemy/cli@latest 安装。

如何从命令行查看我的 Alchemy compute unit 用量？

安装 Alchemy CLI，用 alchemy auth 登录，然后运行 alchemy usage summary。它会以 compute unit 和美元返回团队本月至今、最近 7 天和最近 30 天的总量。加上 --json 可获得结构化输出，便于通过管道传给 jq、仪表盘或告警系统。

能否按 method、network 或 app 查看 RPC 用量？

可以。alchemy usage timeseries --start-date <date> --group-by method 会按 method 对用量分组，你最多可以同时按 app、network、method 和 requestType 中的三个维度分组。--networks、--methods、--app-ids 和 --request-types 等过滤条件会先缩小数据范围。用 --granularity 选择按小时或按天的粒度。

用 Alchemy CLI 最多能查询多久以前的用量？

用量时间序列在免费版套餐下可回溯 1 天，按量付费套餐下为 7 天，企业版套餐在为你的团队启用后最多可回溯 90 天。每次请求最多覆盖 30 天。如果你请求的开始日期更早，Alchemy CLI 会将其限制在套餐允许的范围内，并显示实际返回的范围。

AI 编码 agent 能用 Alchemy CLI 查看用量吗？

能。任何能运行终端命令的 agent，包括 Claude Code、Cursor 和 Codex，都可以调用 alchemy --json --no-interactive usage summary 并读取 JSON 结果。运行 alchemy --json --no-interactive agent-prompt 可以为 agent 提供完整的命令树、认证方式和错误码，让它无需反复试错就能正确调用 Alchemy CLI。连接了 Alchemy MCP Server 的 agent 也可以使用其中的 get_usage_summary 和 get_usage_time_series 工具。

从终端开始查看用量

安装 CLI 并运行 alchemy usage summary，即可了解本月的用量情况。CLI 使用你在 Dashboard 中已有的账户登录，用量命令无需 API key，并且适用于所有套餐。刚接触 Alchemy？在 Alchemy Dashboard 中创建一个免费账户，然后用 alchemy auth 将 CLI 连接到该账户。