---
title: "Alchemy CLI로 더 빠르게 할 수 있는 12가지"
description: "Alchemy CLI는 모든 온체인 워크플로우를 하나의 명령으로 처리합니다: 인증, 에이전트 지갑, 멀티체인 조회, 전송, 스왑, 브리지, AI 에이전트 통합."
---

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

<ImageBlock
  src="https://media.alchemy.com/blog/12-things-alchemy-cli-hero-v2.png"
  alt="Alchemy CLI로 더 빠르게 할 수 있는 12가지"
  width={1920}
  height={900}
  priority
/>

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

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

## Alchemy CLI란 무엇인가?

Alchemy CLI는 단일 [npm 패키지](https://www.npmjs.com/package/@alchemy/cli)인 `@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`로 초기화한다.

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

<ImageBlock
  src="https://media.alchemy.com/blog/12-things-alchemy-cli-auth.png"
  alt="Alchemy CLI에 계정 범위 접근 권한을 부여하는 로그인 승인 화면"
  width={1580}
  height={1190}
/>

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy wallet connect --mode session`}
/>

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

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

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

<CodeSnippet
  language="bash"
  code={`# Pay per call with the wallet you connected in step 2
alchemy evm rpc eth_blockNumber -n base-mainnet --x402

# Or make it the default so you can drop the flag:
alchemy config set x402 true`}
/>

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

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm rpc eth_blockNumber -n base-mainnet --json
alchemy evm rpc eth_getLogs '[{"fromBlock":"0x123","topics":["0x..."]}]' \\
  -n arb-mainnet --json`}
/>

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm data portfolio tokens --json --body '{
  "addresses":[{
    "address":"vitalik.eth",
    "networks":["eth-mainnet","base-mainnet","arb-mainnet"]
  }]
}'`}
/>

NFT 컬렉션에도 같은 방식을 적용하려면 `portfolio nfts`과 함께 사용한다. 같은 엔드포인트가 프로덕션에서 우리 [Data API](https://www.alchemy.com/docs/data) 인덱서를 구동한다.

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm data tokens balances 0xabc... --metadata -n base-mainnet --json
alchemy evm data history 0xabc... -n eth-mainnet --json
alchemy evm data nfts 0xabc... --limit 20 -n eth-mainnet --json`}
/>

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

## 셸에서 트랜잭션 작성하기

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm simulate asset-changes --json --tx '{
  "from":"vitalik.eth",
  "to":"0x...",
  "data":"0x..."
}'`}
/>

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm send vitalik.eth 0.01 -n base-mainnet
alchemy evm send 0xabc... 100 --token 0xUsdcAddress -n base-mainnet`}
/>

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy evm approve 0xPool --token-address 0xUsdc --amount 100 -n base-mainnet
alchemy evm swap execute --from 0xUsdc --to 0xEth --amount 100 -n base-mainnet
alchemy xchain bridge execute --from 0xUsdcBase --to 0xUsdcArb \\
  --amount 0.2 --to-network arb-mainnet -n base-mainnet`}
/>

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

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

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

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

<CodeSnippet
  language="bash"
  code={`alchemy agent-prompt > .alchemy-prompt.json`}
/>

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

### 11. Alchemy Skills 설치하기

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

<CodeSnippet
  language="bash"
  code={`alchemy install skills`}
/>

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

### 12. MCP 연결하기

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

<CodeSnippet
  language="bash"
  code={`alchemy install mcp`}
/>

Claude Code의 경우 구체적으로:

<CodeSnippet
  language="bash"
  code={`claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp`}
/>

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

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

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

<ImageBlock
  src="https://media.alchemy.com/blog/12-things-alchemy-cli-demo.png"
  alt="터미널에서 프라이빗 키 없이 Alchemy CLI로 L2 전반의 Aave USDC 수익률을 비교하고, Base에서 Arbitrum으로 브리지하고, Aave에 예치하는 에이전트"
  width={1058}
  height={1292}
  caption="Source: https://x.com/uttam_singhk/status/2054540200874025224"
/>

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

## 첫 번째 명령 시작하기

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

<CodeSnippet
  language="bash"
  code={`npm i -g @alchemy/cli@latest
alchemy auth
alchemy wallet connect --mode session
alchemy evm send vitalik.eth 0.001 -n base-mainnet`}
/>

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