---
title: "이제 Alchemy CLI에서 사용량 데이터를 조회할 수 있습니다"
description: "alchemy usage summary와 alchemy usage timeseries로 터미널에서 팀의 컴퓨팅 및 비용 데이터를 가져오세요. 동일한 데이터는 Alchemy MCP Server를 통해 AI 에이전트에서도 사용할 수 있습니다."
---

# 이제 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)에서 사용량 데이터를 쿼리할 수 있습니다. 팀의 컴퓨트 및 비용 데이터를 터미널에서 바로 가져올 수 있으며, 총합과 시간에 따른 분석 모두 가능합니다. 동일한 데이터를 [Alchemy MCP Server](https://www.alchemy.com/docs/alchemy-mcp-server)를 통해 AI 에이전트도 사용할 수 있어, 별도의 커스텀 통합 없이도 에이전트가 팀의 사용량을 파악할 수 있습니다.

지금까지는 사용량을 확인하려면 [Dashboard](https://dashboard.alchemy.com/)에 로그인해서 차트를 직접 읽어야 했습니다. 숫자에 접근할 수 있는 제대로 된 프로그래매틱 방법이 없었습니다. 이제는 있습니다.

## 할 수 있는 것

대부분의 용도는 두 가지 명령어로 해결됩니다.

- `alchemy usage summary`는 이번 달 누적, 최근 7일, 최근 30일 총합을 컴퓨트 유닛과 USD 두 단위로 보여줍니다.
- `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처럼 데이터를 나눠보기

네트워크, 앱, 메서드, 요청 타입별로 사용량을 그룹화하고 각 기준으로 필터링할 수 있어서, 어떤 앱이 컴퓨트를 많이 쓰고 있는지, 어떤 메서드가 밤새 급증했는지 같은 질문에 답할 수 있습니다. `--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`}
/>

## 에이전트에게 사용량 인지 능력 부여하기

동일한 사용량 데이터는 Alchemy MCP Server를 통해 `get_usage_summary`와 `get_usage_time_series` 두 개의 툴로 노출됩니다. 에이전트를 MCP 서버에 연결하면 에이전트가 컨텍스트의 일부로 소비량과 비용을 추론할 수 있어서, 인프라를 모니터링하는 에이전트가 그 인프라의 비용도 함께 파악하게 됩니다.

Cursor, Claude Code, Codex에 이미 MCP 서버를 연결했다면 — [MCP 설정 가이드](https://www.alchemy.com/docs/alchemy-mcp-server)나 [MCP 발표 글](/blog/alchemy-mcp-server)을 참고하세요 — 이 툴들은 기존 Alchemy 기능들과 함께 나타납니다. 에이전트가 코드에서 Alchemy API를 호출하는 방법을 알기를 원한다면 [Agent Skills](https://www.alchemy.com/docs/alchemy-agent-skills)와 함께 사용하세요. 대화 속에서 실시간 사용량 데이터를 제공하는 것은 MCP입니다.

## 이런 분들께 적합합니다

에이전트를 구축 중이거나, 팀이 소비하는 것에 대한 프로그래매틱하고 스크립트 가능한 가시성을 원한다면, 이 기능이 필요합니다. 개발하면서 지출을 모니터링하세요. 사용량을 에이전트의 컨텍스트에 연결하세요. 자체 비용 대시보드나 예산 알림을 만드세요. 어떤 네트워크, 앱, 메서드가 컴퓨트 급증의 원인인지 찾아내세요. 이제 이 모든 것이 이미 작업하고 있는 곳에 있습니다.

## 시작하기

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 서버에서의 사용량 기능은 에이전트와 개발자가 모두 직접 운영할 수 있는 플랫폼을 향한 또 하나의 단계입니다. CLI를 업데이트하고, 명령어를 실행해보고, 다음에 무엇을 보고 싶은지 알려주세요.