Alchemy CLI로 더 빠르게 할 수 있는 12가지

모든 온체인 프로젝트는 늘 같은 방식으로 시작했다. 대시보드를 열고, API 키를 복사하고, .env에 프라이빗 키를 붙여넣고, SDK 세 개를 npm install한 뒤, 마침내 원하던 코드 한 줄을 작성한다. 코딩 에이전트는 어떤 RPC 메서드를 호출해야 할지 알아내느라 세션의 절반을 소모했다. Alchemy CLI는 이런 설정 비용을 파이프로 연결하거나, 스크립트로 만들거나, 코딩 에이전트에게 넘길 수 있는 명령어로 압축한다. 터미널이 온체인으로 가는 가장 빠른 경로다.

이 글에서는 CLI가 한 번의 명령으로 처리하는 열두 가지 작업을 다룬다: 로그인, 에이전트 지갑 생성, 모든 체인 읽기, 쓰기 시뮬레이션, 토큰 전송, 스왑, 브리지, 그리고 Cursor, Claude Code, Codex에 동일한 도구를 연결하는 작업까지. 여기서 보여주는 모든 명령은 오늘 기준으로 실제로 동작한다.

Alchemy CLI란 무엇인가?

Alchemy CLI는 단일 npm 패키지인 @alchemy/cli로, 우리가 제공하는 모든 API 표면(Core RPC, Data API, swap, bridge, simulate, webhook, admin, wallet)을 일관된 서브커맨드 집합으로 감싼다. npm i -g @alchemy/cli@latest로 한 번 설치하고 alchemy auth을 실행하면, 동일한 플래그 집합이 모든 명령에서 작동한다. --json를 jq로 파이프하고, --no-interactive으로 스크립트를 게이트하면, 터미널에서 실행되는 표면이 AI 코딩 에이전트 안에서도 그대로 실행된다.

핵심은 이것이다: 팀이 지금까지 대시보드나 SDK를 통해 실행해온 워크플로가 개발자가 스크립트로 작성할 수 있고 에이전트가 호출할 수 있는 하나의 명령줄로 압축된다는 점이다.

하나의 터미널에서 처리하는 인증과 신원 확인

1. alchemy auth로 한 번 로그인

alchemy auth은 브라우저를 열어 계정에 로그인시키고 세션을 디스크에 저장한다. 프로젝트마다 .env에 API 키를 붙여넣는 작업은 더 이상 필요 없다. alchemy auth login --force으로 팀을 전환하고, alchemy auth status로 상태를 확인하고, alchemy auth logout로 초기화한다.

명령 하나가 모든 프로젝트에서 반복되던 "키 복사, 키 붙여넣기, gitignore 처리, 키 로테이션" 루프를 대체한다.

2. alchemy wallet connect으로 에이전트 지갑 생성

CLI는 Privy가 커스터디하는 에이전트 지갑을 제공한다. Privy는 지갑의 프라이빗 키를 자체적으로 보관하는 임베디드 지갑 제공업체다. alchemy wallet connect --mode session는 로컬에서 새 P-256 키페어를 생성하고, Privy 백엔드에 시간 제한이 있는 세션을 등록한 뒤, 두 단계로 서명한다. CLI가 세션 키 페이로드에 서명하고, Privy가 지갑에 서명한다. 프라이빗 키는 Privy를 벗어나지 않고, 세션 키는 사용자의 기기를 벗어나지 않는다.

대시보드에서 또는 alchemy wallet disconnect로 취소하면 세션은 즉시 작동을 멈춘다. 로컬 키 워크플로를 원한다면 alchemy wallet connect --mode local --chain evm --import ~/.wallet/key을 사용한다. 어느 쪽이든 프라이빗 키가 .env에 그대로 놓여 있는 일은 없다.

3. --x402로 사용한 만큼 지불하기

어떤 명령에든 --x402를 설정하면 CLI는 API 키 대신 연결된 지갑으로 우리 API에 인증한다. 요청이 유료 엔드포인트에 도달하면 엔드포인트가 HTTP 402를 반환하고, CLI가 x402 결제 페이로드에 서명해 요청을 완료한다. x402는 Coinbase가 만든 HTTP 네이티브 결제를 위한 오픈 스펙이며, 정산은 Base 위에서 USDC로 이루어진다. 에이전트는 대시보드 가입 없이 단 $1의 컴퓨트 크레딧으로 시작할 수 있다.

에이전트든, 가입한 적 없는 사람이든 이제 프로덕션 워크로드가 사용하는 것과 동일한 API를 호출할 수 있다. API 키도, 대시보드도, 계약도 필요 없다.

fetch 보일러플레이트 없이 모든 체인 읽기

4. 모든 체인에서 모든 JSON-RPC 메서드 호출

alchemy evm rpc은 -n로 선택한 네트워크에 임의의 JSON-RPC 메서드를 그대로 전달한다. fetch 요청 본문을 직접 작성할 필요도, 다섯 줄짜리 스크립트를 위해 SDK를 설치하는 번거로움도 없다.

Solana의 경우 JSON-RPC에는 alchemy solana rpc를, Digital Asset Standard 메서드에는 alchemy solana das을 사용한다. 우리가 지원하는 모든 체인에서 형태는 동일하게 유지된다.

5. 한 번의 호출로 멀티체인 포트폴리오 조회

alchemy evm data portfolio tokens는 지갑이 거쳐간 모든 체인의 토큰 잔액을 반환한다. 일곱 개의 RPC 제공업체를 이어붙일 필요도, 체인별로 각 ERC-20 컨트랙트에 eth_call를 반복할 필요도 없다.

NFT 컬렉션에도 같은 방식을 적용하려면 portfolio nfts과 함께 사용한다. 같은 엔드포인트가 프로덕션에서 우리 Data API 인덱서를 구동한다.

6. 잔액, 전송 내역, NFT를 한 줄 명령으로 조회

잔액, 토큰 메타데이터, 전송 내역, NFT는 각각 Data API 표면의 단일 서브커맨드로 제공된다. --metadata을 추가하면 호출 결과에 이름, 심볼, decimals, 로고 URL이 함께 반환된다.

과거에는 네 개의 서로 다른 SDK 클라이언트에 걸쳐 있던 읽기 작업이 이제 하나의 CLI에서 네 개의 플래그로 제공된다.

셸에서 트랜잭션 작성하기

7. 전송하기 전에 시뮬레이션하기

alchemy evm simulate asset-changes은 트랜잭션이 발생시킬 모든 토큰 및 ETH 이동을 사람이 읽을 수 있는 형태의 diff로 반환한다. simulate execution는 전체 트레이스를 반환한다. 읽는 사람은 온체인에 반영되기 전에 해당 호출이 정확히 무엇을 하는지 확인할 수 있다.

메인넷 자금을 건드리는 evm send이나 contract call을 실행하기 전에는 반드시 이 과정을 거쳐야 한다. "방금 핫월렛을 망가뜨렸다"는 상황에서 다시 작업을 반복하는 일을 막아준다.

8. ENS 이름으로 한 줄에 전송하기

alchemy evm send는 ENS를 해석하고, 가스를 처리하며, 현재 활성화된 지갑(세션, 로컬, 또는 Privy 커스터디)으로 서명한다. --x402과 함께 사용하면 같은 호출이 2단계에서 연결한 지갑을 통해 라우팅된다.

9. 같은 셸에서 승인, 스왑, 브리지 처리하기

alchemy evm swap execute는 동일 체인 스왑을 견적부터 실행까지 처리한다. alchemy xchain bridge execute는 체인 간 버전을 처리한다. alchemy evm approve은 모든 DEX 스왑이 먼저 필요로 하는 ERC-20 승인을 처리한다.

Alchemy CLI 문서에 따르면 동일 체인 스왑은 Ethereum, Base, Arbitrum, Optimism, Polygon, BSC를 포함한 11개 EVM 메인넷에서 사용 가능하다. 체인 간 브리지도 오늘 CLI에서 제공된다. 대시보드 마법사는 셸 세 줄로 압축된다.

코딩 에이전트에 CLI 연결하기

10. alchemy agent-prompt로 전체 에이전트 매니페스트 생성하기

alchemy agent-prompt은 모든 명령, 플래그, 에러 코드, 예제를 설명하는 JSON 문서를 출력한다. 이를 에이전트의 시스템 프롬프트에 파이프하면, 에이전트가 더 이상 플래그 이름을 추측하지 않아도 된다.

매니페스트에는 실행 정책, 사전 점검 사항, 인증 매트릭스, 옵션이 포함된 명령 트리, 재시도 방식이 명시된 에러 카탈로그, 실행 가능한 예제가 포함되어 있다. Cursor, Claude Code, Codex, 또는 다른 어떤 코딩 에이전트든 이 파일을 시스템 프롬프트에 그대로 넣으면 된다. 실제 적용 사례: How to build onchain agents.

11. Alchemy Skills 설치하기

alchemy install skills는 Alchemy Skills 번들을 에이전트 클라이언트에 설치한다. Skills는 코딩 에이전트가 런타임에 문서를 읽지 않고도 CLI 사용법을 익힐 수 있게 해주는 기계가 읽을 수 있는 워크플로다.

번들은 네 가지 표면을 다룬다: CLI 자체, API 키를 통한 앱 통합, MCP, 그리고 지갑 기반 결제 흐름. 명령 하나로 "매 세션마다 에이전트가 문서를 훑어야 하는" 상태를 "에이전트가 이미 워크플로를 알고 있는" 상태로 바꿀 수 있다.

12. MCP 연결하기

alchemy install mcp은 Alchemy MCP 서버를 에이전트 클라이언트에 연결한다. MCP(Model Context Protocol)는 에이전트가 런타임에 도구를 발견하고 호출할 수 있게 해주는 오픈 스펙이다. 호스팅되는 서버는 https://mcp.alchemy.com/mcp에 위치하며, 100개 이상의 체인에 걸쳐 150개 이상의 도구를 제공한다: admin, 모든 RPC 메서드, 그리고 Data API 표면.

Claude Code의 경우 구체적으로:

Skills, 에이전트 프롬프트용 매니페스트, MCP가 함께 작동하면 CLI는 에이전트의 도구 목록 안에서 부수적인 의존성이 아니라 일급 기능이 된다.

다섯 번의 호출로 완성하는 에이전트 데모: 수익률 비교, 브리지, 공급

Alchemy Skills 저장소에 포함된 대표 데모는 Polygon, Arbitrum, Optimism에서 USDC 공급 APY를 읽고, Base에서 수익률이 가장 높은 체인으로 0.2 USDC를 브리지한 뒤, Aave V3에 공급한다. 이 글의 나머지 부분을 구동하는 것과 동일한 표면에서 이루어지는 다섯 번의 CLI 호출이다.

위 데모에서 에이전트는 USDC에 대해 가장 유리한 Aave 마켓을 찾고, 자금을 올바른 체인으로 브리지한 뒤, 풀에 예치한다. 오늘 이전까지 이런 워크플로는 프라이빗 키를 직접 다루는 커스텀 에이전트 코드, 또는 지갑 SDK와 코딩 어시스턴트를 수작업으로 통합하는 작업을 필요로 했다. 이제는 몇 개의 명령과 대시보드 클릭 한 번이면 된다.

첫 번째 명령 시작하기

지금까지 열두 개의 명령을 살펴봤다. 이제 2분 만에 시작하는 방법이다: 설치, 로그인, 지갑 연결, 전송.

SDK가 여기저기 흩어지는 일도, .env에 프라이빗 키가 남는 일도, 대시보드를 오가는 일도 없다. 온체인 워크플로가 어떤 모습이든 CLI는 이를 하나의 프롬프트에서 실행한다. 터미널이 온체인으로 가는 가장 빠른 경로다.