---
title: "60초 만에 Claude Code에 Alchemy 설정하기"
description: "명령어 하나로 Claude Code를 Alchemy에 연결하세요. 코딩 에이전트가 100개 이상의 체인에서 가격, 잔액, NFT, 전송 내역, 시뮬레이션 데이터를 실시간으로 받아옵니다."
---

# 60초 만에 Claude Code에 Alchemy 설정하기

<ImageBlock
  src="https://media.alchemy.com/blog/setup-claude-code-alchemy-hero-16x9-20260821.png"
  alt="60초 만에 Alchemy로 Claude Code 설정하기"
  width={1920}
  height={1080}
  priority
/>

Claude Code는 블록체인과 통신하는 코드를 작성하는 데는 능숙합니다. 문제는 그다음부터입니다. 어떤 [RPC](https://www.alchemy.com/rpc-api) 메서드를 호출해야 할지 추측하고, 응답의 형태를 지어내며, 잔액이나 가격, 트랜잭션이 실제로 무엇을 했는지 확인할 방법이 없습니다. 결국 볼 수 없는 데이터를 대상으로 그럴듯해 보이는 코드를 작성하게 됩니다.

명령어 하나로 이 문제가 해결됩니다. Claude Code를 Alchemy에 연결하면 더 이상 추측하지 않습니다. 100개 이상의 체인에서 실시간 데이터를 읽고, 실행하기 전에 트랜잭션을 시뮬레이션하며, 허용하면 서명하고 전송까지 합니다. 명령어 하나로 Claude Code는 온체인 에이전트가 되고, 설정에는 약 1분이 걸립니다.

## Claude Code를 Alchemy에 연결하면 무엇이 달라지나요?

이 연결은 MCP(Model Context Protocol) 위에서 동작합니다. 이는 에이전트가 런타임에 외부 도구를 발견하고 호출할 수 있게 하는 개방형 표준입니다. 저희 [Alchemy MCP server](https://www.alchemy.com/docs/alchemy-mcp-server)는 호스팅되어 있어 로컬에서 실행할 것이 없습니다. 한 번만 Claude Code를 여기에 연결하면 [100개 이상의 네트워크에서 168개의 도구](https://www.alchemy.com/docs/alchemy-mcp-server)를 사용할 수 있게 되며, 이는 세 그룹으로 나뉩니다: admin(앱 관리), RPC(모든 체인의 모든 JSON-RPC 메서드), data(가격, 토큰 및 NFT 잔액, 전송 내역, 멀티체인 포트폴리오, 트랜잭션 시뮬레이션).

이 차이는 처음으로 실제 질문을 던졌을 때 드러납니다. 데이터 연결이 없으면 "ETH의 현재 가격이 얼마야?"라는 질문에 모델이 출시된 시점에 이미 오래된 학습 데이터 속 숫자가 돌아옵니다. 서버가 연결되어 있으면 Claude Code는 도구를 호출해 실시간 엔드포인트에서 가격을 읽어옵니다. 지갑 잔액, NFT 소유자, 보류 중인 트랜잭션이 일으킬 자산 변동에 대해서도 마찬가지입니다. 에이전트는 체인에 관한 코드를 작성하는 수준에서 체인을 직접 읽는 수준으로 넘어갑니다.

## 60초 설정

가장 빠른 방법은 호스팅 서버를 쓰는 것입니다. 터미널에서 명령어 하나를 실행하세요:

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

Claude Code를 재시작하거나(또는 새 대화를 열고) `/mcp`을 실행해 활성 서버 목록에 `alchemy`이 나타나는지 확인하세요. Claude Code가 Alchemy 도구를 처음 호출할 때 브라우저 창이 열려 계정으로 로그인하게 됩니다. 인증은 OAuth를 사용하므로 붙여넣을 API 키도, 로컬 설치도, `.env` 파일에 담아둘 것도 없습니다.

그다음에는 에이전트에게 자신의 앱 중 하나를 지정하고("select an Alchemy app") 질문을 시작하면 됩니다. 이것이 설정의 전부입니다. 명령어 하나, 브라우저 로그인 한 번이면 코딩 에이전트가 실시간 온체인 데이터를 읽게 됩니다.

## 연결 후에는 무엇을 물어볼 수 있나요?

이 연결의 핵심은 평범한 영어 문장으로 질문하면 Claude Code가 알맞은 도구를 고른다는 점입니다. 서버가 연결되는 즉시 작동하는 몇 가지 프롬프트 예시입니다:

- "ETH와 USDC의 현재 가격이 얼마야?"는 [Data API](https://www.alchemy.com/docs/data) Prices 기능에서 현물 가격을 읽어옵니다.
- "vitalik.eth가 Ethereum, Base, Arbitrum 전체에서 보유한 토큰을 보여줘."는 각 체인을 일일이 조회하는 대신 한 번의 호출로 멀티체인 포트폴리오를 가져옵니다.
- "트랜잭션 0xabc...가 실제로 무엇을 했어?"는 시뮬레이션을 실행해 모든 토큰과 ETH 이동을 사람이 읽을 수 있는 형태의 diff로 반환하므로, 에이전트는 원시 calldata가 아니라 결과를 바탕으로 추론합니다.
- "이 주소는 최근 100블록 동안 어떤 컨트랙트와 상호작용했어?"는 전송 내역과 이벤트 로그를 직접 읽습니다.

각 답변은 에이전트가 파싱해야 하는 산문이 아니라, 바로 활용할 수 있는 구조화된 데이터로 돌아옵니다. 이 점이 연결된 에이전트를 유용하게 만듭니다. 에이전트는 스스로 근거가 되는 데이터를 읽고, 그 위에서 현재 시점의 사실에 근거해 코드를 작성하거나 추천을 내놓습니다.

## CLI와 Skills로 더 나아가려면 어떻게 하나요?

호스팅 서버는 가장 빠르게 시작하는 방법입니다. 번들 형태를 원한다면 [Alchemy plugin for Claude Code](https://www.alchemy.com/blog/alchemy-claude-plugin-now-live)가 같은 MCP 서버를 `/alchemy:balance` 같은 슬래시 명령어 및 Agent Skills와 함께 하나의 설치 과정으로 패키징해 제공합니다. 더 깊이 들어가려면 [Alchemy CLI](https://agents.alchemy.com/)가 적합한데, 이 둘 어디에도 없는 두 가지, 즉 파이프와 체이닝이 가능한 스크립트형 명령어와 직접 관리하는 지갑을 이용한 트랜잭션 서명을 추가로 제공하기 때문입니다.

설치하고, 로그인하고, Claude Code에 연결하세요:

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

`alchemy install skills`는 [Alchemy Skills](https://github.com/alchemyplatform/skills)를 추가합니다. 이는 코딩 에이전트가 런타임에 문서를 스캔하지 않고도 CLI 사용법을 익힐 수 있게 하는 기계가 읽을 수 있는 워크플로입니다. 이 번들은 CLI 자체, API 키를 이용한 앱 통합, MCP, 지갑 기반 결제 흐름까지 네 가지 표면을 다룹니다. 또 다른 명령어인 `alchemy agent-prompt`는 모든 명령어, 플래그, 오류 코드, 실행 가능한 예제를 담은 JSON 매니페스트를 생성하며, 이를 Claude Code의 컨텍스트에 바로 넣을 수 있습니다. Skills와 이 매니페스트가 합쳐지면 에이전트는 문서 페이지를 하나도 보기 전에 이미 전체 표면을 알고 있는 상태가 됩니다. 전체 레퍼런스는 [Alchemy CLI docs](https://www.alchemy.com/docs/alchemy-cli)와 [build with AI overview](https://www.alchemy.com/docs/build-with-ai-overview)에 있습니다.

## Claude Code가 트랜잭션에 서명하고 전송할 수 있나요?

읽기는 기본적으로 안전합니다. 쓰기에는 지갑이 필요하며, 모든 개발자가 가장 먼저 물어야 할 질문은 개인 키가 어디에 있는가입니다. CLI를 쓰면 개인 키가 에이전트의 컨텍스트에 들어가는 일이 없습니다.

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

이는 [agent wallets with Privy custody](https://www.alchemy.com/blog/agent-wallets-alchemy-cli)를 연결합니다. Privy는 지갑의 개인 키를 자신 쪽에 보관합니다. CLI는 여러분의 기기에서 새로 시간 제한이 걸린 세션 키를 생성해 이것으로 서명하므로, 프롬프트가 탈취되더라도 지갑을 비울 수 없고 원시 키는 모델에 닿지 않습니다. 대시보드나 `alchemy wallet disconnect`으로 세션을 취소하면 즉시 작동을 멈춥니다. 이 상태에서 에이전트는 트랜잭션을 시뮬레이션하고 diff를 보여준 뒤, 승인해야만 전송합니다. 어떤 모드를 선택하든 이 규칙은 그대로 적용됩니다. 에이전트는 원시 개인 키를 절대 보지 못하며, 설계상 컨텍스트에 키를 넣게 되면 에이전트가 아니라 취약점을 만든 것입니다.

이는 또한 여러분의 도구에 가르쳐둘 만한 패턴이기도 합니다. Alchemy 컨텍스트가 없는 코딩 에이전트는 서명을 요청받으면 원시 키 처리 방식을 택하는 경향이 있습니다. CLI를 연결해두면 관리형 세션 흐름이 기본값이 되고, 이것이 더 안전한 답이자 에이전트가 배워야 할 방식입니다. 전체 아키텍처는 [how to build onchain agents](https://www.alchemy.com/blog/how-to-build-onchain-agents)를 참고하세요.

더 살펴보고 싶다면 아래 데모를 확인하세요:

<a
  href="https://x.com/uttam_singhk/status/2054540200874025224"
  target="_blank"
  rel="noopener noreferrer"
>
  <ImageBlock
    src="https://media.alchemy.com/blog/setup-claude-code-alchemy-tweet-aave.png"
    alt="Alchemy CLI를 사용해 Aave에서 최적의 USDC 수익률을 찾고, Ethereum L2 간 금리를 비교하고, Base에서 Arbitrum으로 브리지한 후 supply까지 실행하는 에이전트. 터미널에서 모두 처리되며 raw private key는 필요 없음"
    width={1036}
    height={1322}
    caption="Source: https://x.com/uttam_singhk/status/2054540200874025224"
  />
</a>

<a
  href="https://x.com/uttam_singhk/status/2071581970807902420"
  target="_blank"
  rel="noopener noreferrer"
>
  <ImageBlock
    src="https://media.alchemy.com/blog/setup-claude-code-alchemy-tweet-solana.png"
    alt="Solana 기반 뉴스 기반 트레이딩 에이전트: 실행은 phoenix-cli를 통한 Phoenix, 실시간 뉴스 피드와 연결, 원하는 모델 사용, 빠르고 안정적인 RPC는 Alchemy"
    width={1036}
    height={1322}
    caption="Source: https://x.com/uttam_singhk/status/2071581970807902420"
  />
</a>

## 60초 만에 시작하기

명령어 하나로 Claude Code를 실시간 온체인 데이터에 연결하세요:

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

브라우저가 열리면 로그인하고 바로 질문을 시작하세요. API 키도, 대시보드 가입도, 로컬 설치도 필요 없습니다. 서명과 스크립트형 명령어까지 원하시나요? [Alchemy CLI](https://agents.alchemy.com/)를 설치하고 `alchemy auth login`을 실행하면, 같은 설정에서 에이전트가 읽고, 시뮬레이션하고, 전송까지 할 수 있습니다. 여러분의 코딩 에이전트는 이미 온체인 코드를 작성하고 있습니다. 이제는 그 코드를 직접 실행할 수 있습니다.