본문으로 건너뛰기
0%

이제 Alchemy CLI에서 사용량 데이터를 조회할 수 있습니다

작성자: Lisa Ma

마지막 업데이트: 2026년 7월 2일2분 읽기
Alchemy CLI의 사용 데이터

이제 Alchemy CLI에서 사용량 데이터를 쿼리할 수 있습니다. 팀의 컴퓨트 및 비용 데이터를 터미널에서 바로 가져올 수 있으며, 총합과 시간에 따른 분석 모두 가능합니다. 동일한 데이터를 Alchemy MCP Server를 통해 AI 에이전트도 사용할 수 있어, 별도의 커스텀 통합 없이도 에이전트가 팀의 사용량을 파악할 수 있습니다.

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

할 수 있는 것

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

  • alchemy usage summary는 이번 달 누적, 최근 7일, 최근 30일 총합을 컴퓨트 유닛과 USD 두 단위로 보여줍니다.
  • alchemy usage timeseries는 동일한 숫자를 시간에 따라 플롯해서, 트래픽과 지출이 언제 움직였는지 볼 수 있습니다.

둘 다 터미널에서 읽기 쉬운 차트로 렌더링됩니다. --json를 추가하면 스크립트, 대시보드, 알림에 바로 연결할 수 있는 구조화된 출력을 받을 수 있습니다.

bash
Copied
alchemy usage summary alchemy usage timeseries

머신이 읽을 수 있는 출력이 필요하다면:

bash
Copied
alchemy usage summary --json alchemy usage timeseries --json

Dashboard처럼 데이터를 나눠보기

네트워크, 앱, 메서드, 요청 타입별로 사용량을 그룹화하고 각 기준으로 필터링할 수 있어서, 어떤 앱이 컴퓨트를 많이 쓰고 있는지, 어떤 메서드가 밤새 급증했는지 같은 질문에 답할 수 있습니다. --granularity로 시간 단위 또는 일 단위 세분화를 선택하세요. 이는 Dashboard의 사용량 뷰와 완전히 동등하며, Dashboard는 여전히 시각적 기준점으로 남아 있습니다.

몇 가지 예시:

bash
Copied
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 설정 가이드나 MCP 발표 글을 참고하세요 — 이 툴들은 기존 Alchemy 기능들과 함께 나타납니다. 에이전트가 코드에서 Alchemy API를 호출하는 방법을 알기를 원한다면 Agent Skills와 함께 사용하세요. 대화 속에서 실시간 사용량 데이터를 제공하는 것은 MCP입니다.

이런 분들께 적합합니다

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

시작하기

Node 22 이상인지 확인한 다음, CLI를 설치하거나 업데이트하세요:

bash
Copied
npm install -g @alchemy/cli

그 다음 alchemy usage summary를 실행하면 바로 숫자를 확인할 수 있습니다. 플래그와 필터에 대해서는 사용량 문서를, 전체 명령어 구성을 보려면 Alchemy CLI로 더 빠르게 할 수 있는 12가지를 참고하세요.

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

Alchemy 뉴스레터

출시 소식을 가장 먼저 받아보세요

뉴스레터 구독하기

Alchemy의 최신 제품 업데이트와 리소스 받기

A
O
D
+
구독자 80,000명 이상

이메일 주소를 입력하면 마케팅 커뮤니케이션 및 제품 업데이트 수신에 동의하게 됩니다. Alchemy는 저희 개인정보 처리방침에 따라 수집한 정보를 처리합니다. 언제든지 구독을 취소할 수 있습니다.