Alchemy CLI로 터미널에서 RPC 사용량을 확인하는 방법

Alchemy CLI를 사용하면 터미널에서 RPC 사용량을 확인할 수 있습니다. alchemy usage summary는 팀의 컴퓨트 유닛과 USD 지출을 명령어 하나로 보여주고, alchemy usage timeseries는 그 사용량을 네트워크, 앱, 메서드, 요청 타입별로 나눠 보여줍니다. 같은 CLI로 앱, 허용 목록, 웹훅도 관리할 수 있습니다.

이제 사용량을 확인하기 위해 Dashboard를 열 필요가 없습니다. 이 글에서는 두 가지 사용량 명령어의 작동 방식, 컴퓨트 사용을 늘리는 원인을 찾는 방법, CLI로 관리할 수 있는 다른 항목, 그리고 사용량 확인을 스크립트로 만들거나 코딩 에이전트에게 맡기는 방법을 설명합니다.

터미널에서 RPC 사용량은 어떻게 확인하나요?

한 번 로그인한 다음 요약을 요청하세요.

alchemy auth는 브라우저를 열어 Alchemy 계정으로 로그인할 수 있게 하고, 사용량 명령어는 그 로그인을 재사용하므로 API 키를 복사할 필요가 없습니다. 원격 머신, CI 러너, SSH 세션에서는 alchemy auth login --device-code를 실행한 다음 아무 기기의 브라우저에서 짧은 코드를 승인하세요.

alchemy usage summary는 이번 달 누적, 최근 7일, 최근 30일, 이렇게 세 가지 팀 총합을 반환합니다. 각 총합은 현재 결제 기간의 시작일 및 종료일과 함께 컴퓨트 유닛과 USD로 표시됩니다. 기본 출력은 사람이 읽기 쉬운 형식입니다. 스크립트나 다른 도구에서 숫자가 필요하다면 --json을 추가하세요.

먼저 요약으로 결제 기간 현황을 빠르게 파악하세요. 숫자가 예상보다 높다면 시계열에서 그 원인을 확인할 수 있습니다.

어떤 앱, 네트워크, 메서드가 사용량을 늘리고 있는지 어떻게 확인하나요?

alchemy usage timeseries는 사용량을 일 단위 또는 시간 단위 구간으로 나눕니다. 시작 날짜가 필요하며, app, network, method, requestType 중 최대 세 가지 기준으로 그룹화합니다.

필터는 그룹화하기 전에 데이터 범위를 좁힙니다. 각 필터는 쉼표로 구분된 값을 받으며, 여러 필터는 AND 조건으로 결합됩니다.

--app-ids는 앱 기준으로 필터링하며, 요청 타입은 http, websocket, webhook, grpc입니다. 시계열은 컴퓨트 유닛만 보고하므로, USD 총합은 usage summary에서 확인해야 합니다.

시계열을 얼마나 과거까지 조회할 수 있는지는 플랜에 따라 다르며, 한 번의 요청은 최대 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
• 웹훅 관리. alchemy webhook list와 alchemy webhook create --body <json>
• 설정 확인. alchemy auth status와 alchemy doctor

앱이나 웹훅을 변경하는 명령어는 --dry-run을 지원하므로, 변경 사항을 적용하기 전에 미리 확인할 수 있습니다. 웹훅 명령어에는 Dashboard에서 발급받은 웹훅 API 키도 필요하며, alchemy config set webhook-api-key <key>로 한 번만 설정하면 됩니다. 각 웹훅 유형이 무엇을 추적하는지는 Alchemy Webhooks 페이지에서 확인하세요.

CLI는 체인 데이터를 읽고 트랜잭션도 보냅니다. alchemy evm data balance vitalik.eth와 alchemy evm block latest는 스크립트 없이 결과를 반환하며, Alchemy CLI용 Agent Wallets는 서명과 전송 기능을 더합니다. 나머지 명령어는 Alchemy CLI로 더 빠르게 할 수 있는 12가지를 참고하세요.

앱 생성, 앱이 받는 요청 제한, 앱이 발생시키는 사용량 확인까지 모두 하나의 터미널 세션에서 처리할 수 있습니다.

사용량 확인을 스크립트로 만들거나 에이전트에게 맡기려면 어떻게 하나요?

두 가지 전역 플래그를 사용하면 어떤 명령어든 안전하게 자동화할 수 있습니다. --json은 구조화된 출력을 내보내고(출력을 파이프로 넘기면 자동으로 JSON으로 전환됩니다), --no-interactive는 CLI가 프롬프트에서 입력을 기다리지 않게 합니다.

cron이나 CI용 예산 확인은 jq 표현식 하나로 충분합니다. 다음 예시는 이번 달 누적 지출이 500 USD를 넘으면 상태 코드 1로 종료됩니다.

Claude Code, Cursor, Codex처럼 터미널 명령어를 실행하는 코딩 에이전트도 같은 명령어를 호출할 수 있습니다. 먼저 CLI 자체의 사용 안내를 에이전트에게 넘겨주세요.

출력에는 명령어 트리, 인증 방식, 재시도 가이드가 포함된 에러 코드, 실행 가능한 예제가 담겨 있어 에이전트의 시스템 프롬프트에 바로 넣을 수 있습니다. 에이전트용 인터페이스는 두 가지가 더 있습니다. Agent Skills는 에이전트가 코드에서 Alchemy API 호출을 작성하는 방법을 알려주고, https://mcp.alchemy.com/mcp의 Alchemy MCP Server는 대화 안에서 체인 데이터와 앱 관리 기능을 제공합니다. 클라이언트별 설정 방법은 MCP 서버 발표 글을 참고하세요.

MCP 서버는 같은 사용량 데이터를 get_usage_summary와 get_usage_time_series 두 가지 도구로 제공합니다. Cursor, Claude Code, Codex에서 MCP 서버에 연결된 에이전트는 CLI를 실행하지 않고도 대화 중에 사용량과 비용을 확인할 수 있습니다.

사용량을 읽을 수 있는 에이전트는 비용 급증을 일으킨 코드를 작업하는 도중에 그 급증을 바로 알려줄 수 있습니다.

Alchemy CLI는 어떻게 설치하나요?

npm으로 설치하고, 로그인한 다음, 첫 사용량 확인을 실행하세요.

CLI가 이미 설치되어 있다면 같은 명령어로 업데이트됩니다. alchemy doctor는 설정에서 빠진 항목을 알려주고 이를 해결하는 명령어를 출력합니다. 모든 플래그와 필터는 CLI 문서의 사용량 섹션에 정리되어 있습니다.

자주 묻는 질문

블록체인 인프라를 관리하고 RPC 사용량을 확인할 수 있는 CLI가 있나요?

네. Alchemy CLI는 터미널에서 Alchemy 앱, 허용 목록, 웹훅을 관리하며, 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 중 최대 세 가지를 동시에 그룹화 기준으로 쓸 수 있습니다. --networks, --methods, --app-ids, --request-types 같은 필터로 먼저 데이터 범위를 좁힐 수 있습니다. --granularity로 시간 단위 또는 일 단위 구간을 선택하세요.

Alchemy CLI로 사용량을 얼마나 과거까지 조회할 수 있나요?

사용량 시계열은 무료 플랜에서 1일, 종량제 플랜에서 7일, 엔터프라이즈 플랜에서는 팀에 활성화된 경우 최대 90일까지 조회할 수 있습니다. 한 번의 요청은 최대 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를 연결하세요.