---
title: "Alchemy CLI 现已支持查询使用数据"
description: "通过终端使用 alchemy usage summary 和 alchemy usage timeseries 获取团队的计算和费用数据。相同的数据也可通过 Alchemy MCP Server 提供给 AI agents 使用。"
---

# Alchemy CLI 现已支持查询使用数据

<ImageBlock
  src="https://media.alchemy.com/usage-data.png"
  alt="Alchemy CLI 中的使用数据"
  width={1920}
  height={900}
  priority
/>

用量数据现在可以在 [Alchemy CLI](https://www.alchemy.com/docs/alchemy-cli#usage) 中查询了。你可以直接从终端拉取团队的 compute 和成本数据，包括总量以及随时间变化的明细。同样的数据也可以通过 [Alchemy MCP Server](https://www.alchemy.com/docs/alchemy-mcp-server) 提供给 AI agent，这样 agent 无需自定义集成就能查看团队的消耗情况。

在此之前，查看用量意味着登录 [Dashboard](https://dashboard.alchemy.com/) 并手动读取图表。此前没有一种可编程的一等方式来获取这些数字。现在有了。

## 你可以做什么

有两个命令基本能满足大部分需求。

- `alchemy usage summary` 给出本月至今、最近 7 天或最近 30 天的总量，单位为 compute unit 和美元。
- `alchemy usage timeseries` 给出同样的数字随时间变化的曲线，让你看到流量和支出在什么时候发生了变化。

两者都会在终端中渲染成可读的图表。加上 `--json`，你会得到结构化输出，可以直接输入脚本、仪表盘或告警系统。

<CodeSnippet
  language="bash"
  code={`alchemy usage summary
alchemy usage timeseries`}
/>

如需机器可读的输出：

<CodeSnippet
  language="bash"
  code={`alchemy usage summary --json
alchemy usage timeseries --json`}
/>

## 按 Dashboard 的方式切分数据

你可以按 network、app、method 或 request type 对用量进行分组，并对其中任意一项进行过滤，从而回答诸如哪个 app 占用了更多 compute、或哪个 method 在夜间突然飙升之类的问题。用 `--granularity` 选择按小时或按天的粒度。这与 Dashboard 的用量视图功能完全对等，Dashboard 仍是可视化的权威来源。

一些示例：

<CodeSnippet
  language="bash"
  code={`alchemy usage summary --metrics amount,usd
alchemy usage timeseries --group-by network --granularity day
alchemy usage summary --app-ids <id> --methods eth_getLogs`}
/>

## 让你的 agent 具备用量感知

同样的用量数据通过 Alchemy MCP Server 以两个工具的形式暴露：`get_usage_summary` 和 `get_usage_time_series`。将 agent 指向你的 MCP server，它就能把消耗和成本作为上下文的一部分进行推理，让监控你基础设施的 agent 同时了解这套基础设施花费了多少。

如果你已经把 MCP server 连接到了 Cursor、Claude Code 或 Codex——参见 [MCP 配置指南](https://www.alchemy.com/docs/alchemy-mcp-server)或我们的 [MCP 发布公告](/blog/alchemy-mcp-server)——这些工具会和 Alchemy 的其他功能一起出现。如果你希望 agent 知道如何在代码中调用 Alchemy API，可以搭配 [Agent Skills](https://www.alchemy.com/docs/alchemy-agent-skills) 使用；而 MCP 提供的是对话中的实时用量数据。

## 适合谁使用

如果你正在构建 agent，或者只是想要对团队的消耗有可编程、可脚本化的可见性，这就是为你准备的。在开发过程中监控支出。把用量接入 agent 的上下文。构建你自己的成本仪表盘或预算告警。追查是哪个 network、app 或 method 导致了 compute 的激增。现在这一切都可以在你已经使用的工具中完成。

## 开始使用

确保你使用的是 Node 22 或更高版本，然后安装或更新 CLI：

<CodeSnippet
  language="bash"
  code={`npm install -g @alchemy/cli`}
/>

然后运行 `alchemy usage summary`，就能看到你的数据了。关于各种标志和过滤条件，参见 [用量文档](https://www.alchemy.com/docs/alchemy-cli#usage)；如果想了解完整的命令集，可以看看我们的 [用 Alchemy CLI 更快完成的 12 件事](/blog/12-things-faster-with-alchemy-cli) 一文。

CLI 和 MCP server 中的用量功能，是迈向一个 agent 与开发者都能直接操作的平台的又一步。更新 CLI，运行一个命令，然后告诉我们你还想看到什么。