---
title: "Claude Code용 Alchemy 플러그인 출시"
description: "Claude Code용 Alchemy 플러그인을 한 번 설치하면 100개 이상의 체인에서 블록체인 데이터를 조회하고, 슬래시 명령을 실행하고, 대화를 벗어나지 않고 Alchemy 앱을 관리할 수 있습니다."
---

# Claude Code용 Alchemy 플러그인 출시

<ImageBlock
  src="https://media.alchemy.com/claude-plugin.png"
  alt="Alchemy Claude Plugin"
  width={1920}
  height={900}
  priority
/>

기존의 개발자 워크플로우는 변하고 있습니다. 예전에는 이런 식이었습니다. 코딩을 하다가 무언가가 필요합니다 - 지갑 잔액, ETH의 현재 가격, 트랜잭션이 실제로 처리됐는지 확인하는 것 등. 그러면 하던 일을 멈춥니다. 대시보드를 열고, 문서를 뒤지고, SDK 호출을 이어붙이고, 체인을 전환한 다음, 마침내 답을 얻습니다.

저희는 이 왕복 과정을 없애기 위해 Claude Code용 Alchemy 플러그인을 만들었습니다. 한 번 설치하면, 코딩 에이전트가 대화를 벗어나지 않고도 100개 이상의 체인에서 블록체인 데이터를 조회하고 Alchemy 앱을 관리할 수 있습니다. "ETH의 현재 가격이 얼마야?"라고 묻거나 "vitalik.eth가 소유한 NFT를 보여줘"라고 물으면, 지금 작업 중인 바로 그 자리에서 실시간 데이터를 기반으로 한 실제 답을 받게 됩니다.

<ExternalVideo
  url="https://www.youtube.com/watch?v=_9EK9tInVDo"
  provider="youtube"
  providerUid="_9EK9tInVDo"
/>

이 플러그인은 오픈소스이며 [alchemyplatform/alchemy-claude-plugin](https://github.com/alchemyplatform/alchemy-claude-plugin)에서 지금 바로 이용할 수 있습니다.

## **한 번의 설치로 얻는 것**

한 번의 설치로 Claude Code는 세 가지를 동시에 얻습니다. 호스팅되는 Alchemy MCP Server에 연결되어, Claude가 실시간 블록체인 데이터를 툴로 호출할 수 있습니다. 가장 자주 실행하는 조회를 위한 슬래시 명령어가 추가되어, 흔히 하는 작업을 명령어 하나로 처리할 수 있습니다. 그리고 Claude가 Alchemy를 올바르게 사용하는 법을 알려주는 Agent Skills가 함께 제공되는데, 이는 대화 중 질문에 답할 때와 저희 API를 대상으로 애플리케이션 코드를 작성할 때 모두 적용됩니다.

이 중 어느 것도 직접 설정할 필요가 없습니다. 설치하고, 로그인하고, 바로 질문을 시작하면 됩니다.

## **시작하기**

Claude Code에서 마켓플레이스를 추가하고 플러그인을 설치합니다:

<CodeSnippet
  language="bash"
  code={`/plugin marketplace add alchemyplatform/alchemy-claude-plugin
/plugin install alchemy@alchemy`}
/>

Claude가 Alchemy 툴을 처음 호출하면 브라우저 창이 열리고, OAuth를 통해 Alchemy 계정으로 로그인하게 됩니다. 복사할 API 키도, 실행할 로컬 서버도 필요 없습니다. 아직 계정이 없다면 [Alchemy Dashboard](https://dashboard.alchemy.com/)에서 무료로 만들 수 있습니다.

그런 다음 작업할 앱을 선택하기 위해 setup을 한 번 실행합니다:

`/alchemy:setup`

이렇게 하면 세션 동안 해당 앱의 API 키가 캐싱되며, 이는 대부분의 데이터 툴이 필요로 하는 것입니다. 이후에는 자연어로 자유롭게 질문하거나 명령어를 사용하면 됩니다.

## **실제로 자주 쓰게 될 명령어**

슬래시 명령어는 작업을 가장 자주 방해하는 조회들을 다룹니다. 각 명령어는 네트워크를 선택 사항으로 받으며, 생략하면 기본값으로 Ethereum 메인넷을 사용합니다.

<EmbeddedTable
  table={{
    columns: [
      { key: "command", width: 200, title: "Command", dataType: "object" },
      { key: "description", width: 420, title: "What it does", dataType: "object" },
    ],
    data: [
      {
        command: { title: "/alchemy:setup", tooltip: "", icon: "" },
        description: {
          title: "Connect and select an Alchemy app for the session",
          tooltip: "",
          icon: "",
        },
        id: 0,
      },
      {
        command: { title: "/alchemy:balance [network]", tooltip: "", icon: "" },
        description: {
          title: "Native and ERC-20 balances with USD values",
          tooltip: "",
          icon: "",
        },
        id: 1,
      },
      {
        command: { title: "/alchemy:nfts [network]", tooltip: "", icon: "" },
        description: { title: "NFTs owned by a wallet", tooltip: "", icon: "" },
        id: 2,
      },
      {
        command: { title: "/alchemy:token [network]", tooltip: "", icon: "" },
        description: {
          title: "Token price and metadata",
          tooltip: "",
          icon: "",
        },
        id: 3,
      },
      {
        command: { title: "/alchemy:tx [network]", tooltip: "", icon: "" },
        description: {
          title: "Transaction details and receipt",
          tooltip: "",
          icon: "",
        },
        id: 4,
      },
      {
        command: { title: "/alchemy:portfolio [networks]", tooltip: "", icon: "" },
        description: {
          title: "Multi-chain tokens and NFTs",
          tooltip: "",
          icon: "",
        },
        id: 5,
      },
      {
        command: { title: "/alchemy:gas [network]", tooltip: "", icon: "" },
        description: {
          title: "Current gas and fee estimates",
          tooltip: "",
          icon: "",
        },
        id: 6,
      },
      {
        command: { title: "/alchemy:solana", tooltip: "", icon: "" },
        description: {
          title: "SOL balance and SPL token accounts",
          tooltip: "",
          icon: "",
        },
        id: 7,
      },
      {
        command: { title: "/alchemy:create-app", tooltip: "", icon: "" },
        description: { title: "Create a new Alchemy app", tooltip: "", icon: "" },
        id: 8,
      },
    ],
  }}
/>

`portfolio`로 여러 체인에 걸쳐 조회할 수 있습니다. 가격 피드를 별도로 연결하지 않고도 USD 기준 잔액을 확인할 수 있습니다. 트랜잭션과 그 영수증을 조회하여 정상적으로 처리되었는지 확인할 수 있습니다. EVM에서 쓰던 흐름 그대로 Solana로 넘어가 SOL과 SPL 토큰 계정을 조회할 수 있습니다. 그리고 배포할 준비가 되면 `create-app`가 터미널을 벗어나지 않고 새 Alchemy 앱을 생성합니다.

각 명령어 뒤에는 호스팅되는 Alchemy MCP Server의 160개 이상의 툴이 있습니다: EVM JSON-RPC, 저희 Token, NFT, Prices, Portfolio API, 트랜잭션 시뮬레이션 및 트레이싱, 가스리스 트랜잭션, 그리고 RPC와 Digital Asset Standard를 모두 지원하는 Solana까지 포함됩니다. 명령어를 외울 필요도 없습니다. Claude에게 직접 물어보면 적절한 툴을 알아서 사용합니다.

## **이것이 중요한 이유**

핵심은 잔액을 조회할 수 있다는 것이 아닙니다. 그건 이전에도 가능했습니다. 핵심은 이 조회가 이제 작업 옆이 아니라 작업 안에서 일어난다는 것입니다.

에이전트가 맥락 안에서 체인을 읽을 수 있게 되면, 질문 자체가 달라집니다. "이 주소가 무엇을 보유하고 있는가"를 별도의 작업으로 묻는 대신, 실패하는 플로우를 디버깅하는 과정의 일부로 묻게 됩니다. Claude에게 트랜잭션 영수증을 확인시키고, 왜 되돌려졌는지(revert) 추론하게 하고, 파일을 벗어나지 않고 수정 방안을 제안하게 할 수 있습니다. 시뮬레이션과 트레이싱이 바로 그 자리에 있으므로, 트랜잭션을 보내기 전에 무엇을 할지 이해할 수 있습니다. 에이전트는 단지 체인에 대한 코드를 작성하는 것이 아닙니다. 체인을 실제로 볼 수 있습니다.

이것이 바로 저희가 툴과 함께 Agent Skills를 제공하는 이유이기도 합니다. 실시간 데이터는 그 순간의 질문에 답합니다. 스킬은 저희 API 뒤에 있는 패턴을 Claude에게 가르쳐서, Alchemy를 대상으로 코드를 작성할 때 저희가 작성했을 법한 코드를 쓰게 합니다. 대화에서는 정확한 도움을, 저장소에서는 정확한 코드를 얻게 됩니다.

## **Claude Code를 사용하지 않는다면**

이 플러그인은 Claude Code 사용자에게 가장 쉬운 방법이지만, 에이전트에서 Alchemy와 작업하는 세 가지 방법 중 하나일 뿐입니다. 개발 환경에 맞는 것을 선택하세요.

<EmbeddedTable
  table={{
    columns: [
      { key: "option", width: 180, title: "", dataType: "object" },
      { key: "bestFor", width: 440, title: "Best for", dataType: "object" },
    ],
    data: [
      {
        option: { title: "Claude plugin", tooltip: "", icon: "" },
        bestFor: {
          title:
            "Claude Code, where one install bundles the MCP server, slash commands, and skills",
          tooltip: "",
          icon: "",
        },
        id: 0,
      },
      {
        option: {
          title:
            '<a href="https://www.alchemy.com/docs/alchemy-cli">Alchemy CLI</a>',
          tooltip: "",
          icon: "",
        },
        bestFor: {
          title:
            "The terminal directly, for live queries, transactions, and admin tasks in shell scripts, cron jobs, and CI pipelines",
          tooltip: "",
          icon: "",
        },
        id: 1,
      },
      {
        option: {
          title:
            '<a href="https://www.alchemy.com/docs/alchemy-mcp-server">MCP server</a>',
          tooltip: "",
          icon: "",
        },
        bestFor: {
          title:
            "Any MCP-compatible client such as Cursor, Codex, Claude Desktop, or VS Code Copilot, for live blockchain data as tool calls",
          tooltip: "",
          icon: "",
        },
        id: 2,
      },
      {
        option: {
          title:
            '<a href="https://www.alchemy.com/docs/alchemy-agent-skills">Agent Skills</a>',
          tooltip: "",
          icon: "",
        },
        bestFor: {
          title:
            "Any agent that writes code against Alchemy APIs, for endpoint knowledge without tool calls",
          tooltip: "",
          icon: "",
        },
        id: 3,
      },
    ],
  }}
/>

Claude Code를 사용 중이라면, 플러그인을 설치하는 것만으로 MCP server, 슬래시 명령어, 스킬이 모두 함께 갖춰집니다.

## **직접 사용해보기**

마켓플레이스를 추가하고, 설치하고, `/alchemy:setup`을 실행한 다음, Claude에게 온체인 관련 질문을 해보세요. 전체 과정은 약 1분 정도 걸리고, 계정은 무료이며, 플러그인은 오픈소스이므로 작동 방식을 확인하거나 기여하고 싶다면 그렇게 할 수 있습니다.

[alchemyplatform/alchemy-claude-plugin](https://github.com/alchemyplatform/alchemy-claude-plugin)에서 받아보거나, [문서](https://www.alchemy.com/docs/alchemy-claude-plugin)를 읽어보세요.