---
title: "Configura Claude Code con Alchemy en 60 segundos"
description: "Conecta Claude Code a Alchemy con un solo comando. Tu agente de código obtiene datos en vivo en más de 100 chains: precios, balances, NFTs, transferencias y simulación."
---

# Configura Claude Code con Alchemy en 60 segundos

<ImageBlock
  src="https://media.alchemy.com/blog/setup-claude-code-alchemy-hero-16x9-20260821.png"
  alt="Configura Claude Code con Alchemy en 60 segundos"
  width={1920}
  height={1080}
  priority
/>

Claude Code es bueno para escribir código que se comunica con una blockchain. El problema empieza después de eso. Adivina qué método de [RPC](https://www.alchemy.com/rpc-api) llamar, inventa la forma de la respuesta y no tiene manera de verificar un balance, un precio o qué hizo realmente una transacción. Así que escribe código plausible contra datos que no puede ver.

Un solo comando resuelve eso. Conecta Claude Code a Alchemy y deja de adivinar. Lee datos en vivo a través de más de 100 chains, simula una transacción antes de que se ejecute y, si se lo permites, firma y envía. Un comando convierte a Claude Code en un agente onchain, y la configuración toma alrededor de un minuto.

## ¿Qué hace conectar Claude Code a Alchemy?

La conexión funciona sobre MCP (Model Context Protocol), un estándar abierto que permite a un agente descubrir y llamar herramientas externas en tiempo de ejecución. Nuestro [servidor Alchemy MCP](https://www.alchemy.com/docs/alchemy-mcp-server) está alojado, así que no hay nada que ejecutar localmente. Apunta Claude Code hacia él una vez y obtiene [168 herramientas en más de 100 redes](https://www.alchemy.com/docs/alchemy-mcp-server), agrupadas en tres familias: admin (gestiona tus apps), RPC (cada método JSON-RPC en cada chain) y data (precios, balances de tokens y NFT, historial de transferencias, portfolios multi-chain y simulación de transacciones).

La diferencia se nota la primera vez que haces una pregunta real. Sin una conexión de datos, "¿cuál es el precio actual de ETH?" te da un número proveniente de datos de entrenamiento que quedó desactualizado el día en que se lanzó el modelo. Con el servidor conectado, Claude Code llama a una herramienta y lee el precio desde un endpoint en vivo. Lo mismo aplica para el balance de una wallet, el dueño de un NFT o los cambios de activos que causaría una transacción pendiente. Tu agente pasa de escribir código sobre la chain a leer la chain directamente.

## Configuración en 60 segundos

El camino más rápido es el servidor alojado. Ejecuta un comando en tu terminal:

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

Reinicia Claude Code (o abre una nueva conversación) y ejecuta `/mcp` para confirmar que `alchemy` aparece en la lista de servidores activos. La primera vez que Claude Code llama a una herramienta de Alchemy, se abre una ventana del navegador para iniciar sesión con tu cuenta. La autenticación usa OAuth, así que no hay ninguna API key que pegar, ninguna instalación local y nada en un archivo `.env`.

Después de eso, apunta tu agente a una de tus apps ("select an Alchemy app") y empieza a preguntar. Eso es toda la configuración: un comando, un inicio de sesión en el navegador, y tu agente de código ya está leyendo datos onchain en vivo.

## ¿Qué puedes preguntar una vez conectado?

El punto de la conexión es que preguntas en español o inglés llano y Claude Code elige la herramienta correcta. Algunos prompts que funcionan en el momento en que el servidor está conectado:

- "What's the current price of ETH and USDC?" lee precios spot de la superficie Prices de la [Data API](https://www.alchemy.com/docs/data).
- "Show me the tokens vitalik.eth holds across Ethereum, Base, and Arbitrum." obtiene un portfolio multi-chain en una sola llamada en vez de consultar cada chain a mano.
- "What did transaction 0xabc... actually do?" ejecuta una simulación y devuelve un diff legible por humanos de cada movimiento de tokens y ETH, de modo que el agente razona sobre los efectos, no sobre calldata sin procesar.
- "Which contracts has this address interacted with in the last 100 blocks?" lee el historial de transferencias y los logs de eventos directamente.

Cada respuesta vuelve como datos estructurados sobre los que el agente puede actuar, no como prosa que tiene que interpretar. Eso es lo que hace útil a un agente conectado. Lee su propia verdad de referencia, y luego escribe código o hace una recomendación contra datos que son ciertos en este momento.

## ¿Cómo ir más allá con el CLI y Skills?

El servidor alojado es la forma más rápida de empezar. Si prefieres tenerlo empaquetado, el [plugin de Alchemy para Claude Code](https://www.alchemy.com/blog/alchemy-claude-plugin-now-live) empaqueta el mismo servidor MCP con comandos slash como `/alchemy:balance` y Agent Skills en una sola instalación. Y el [Alchemy CLI](https://agents.alchemy.com/) es el camino para ir más lejos, porque agrega dos cosas que ninguno de los anteriores incluye: comandos scriptables que puedes encadenar con pipes, y firma de transacciones con una wallet que controlas.

Instálalo, inicia sesión y conéctalo a Claude Code:

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

`alchemy install skills` agrega [Alchemy Skills](https://github.com/alchemyplatform/skills), flujos de trabajo legibles por máquina que le enseñan a un agente de código cómo usar el CLI sin tener que escanear la documentación en tiempo de ejecución. El paquete cubre cuatro superficies: el CLI en sí, la integración de apps con una API key, MCP y el flujo de pago basado en wallet. Un comando más, `alchemy agent-prompt`, genera un manifiesto JSON de cada comando, flag, código de error y ejemplo ejecutable que puedes colocar directamente en el contexto de Claude Code. Juntos, Skills y el manifiesto hacen que el agente ya conozca la superficie antes de ver una sola página de documentación. La referencia completa está en la [documentación del Alchemy CLI](https://www.alchemy.com/docs/alchemy-cli) y en el [overview de build with AI](https://www.alchemy.com/docs/build-with-ai-overview).

## ¿Puede Claude Code firmar y enviar transacciones?

Leer es seguro por defecto. Escribir necesita una wallet, y la primera pregunta que todo desarrollador debería hacerse es dónde vive la clave privada. Con el CLI, nunca vive en el contexto de tu agente.

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

Esto conecta [agent wallets con custodia de Privy](https://www.alchemy.com/blog/agent-wallets-alchemy-cli). Privy mantiene la clave privada de la wallet de su lado. El CLI genera una session key nueva y con tiempo limitado en tu dispositivo y firma con esa, de modo que un prompt comprometido no puede vaciar la wallet y la clave sin procesar nunca toca el modelo. Revoca la sesión desde el dashboard o con `alchemy wallet disconnect` y deja de funcionar de inmediato. A partir de ahí el agente puede simular una transacción, mostrarte el diff y enviarla solo después de que la apruebes. La regla se mantiene sin importar el modo que elijas. El agente nunca ve una clave privada sin procesar, y si tu diseño pone una en el contexto, has construido una vulnerabilidad en lugar de un agente.

Este es también el patrón que vale la pena enseñarle a tus herramientas. Un agente de código sin contexto de Alchemy tiende a recurrir al manejo directo de claves cuando le pides que firme. Conecta el CLI y el flujo de sesión gestionada se convierte en la opción por defecto a la que recurre, que es la respuesta más segura y la que quieres que aprenda. Para la arquitectura completa, consulta [cómo construir agentes onchain](https://www.alchemy.com/blog/how-to-build-onchain-agents).

Si quieres explorar más, revisa estas demos:

<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="Un agente que usa el Alchemy CLI para encontrar el mejor rendimiento de USDC en Aave, comparar tasas entre los L2 de Ethereum, hacer bridge de Base a Arbitrum, y hacer supply, todo desde la terminal sin necesidad de una clave privada en texto plano"
    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="Un agente de trading basado en noticias en Solana: Phoenix para la ejecución vía phoenix-cli, conectado a un feed de noticias en vivo, el modelo que elijas, y Alchemy para un RPC rápido y confiable"
    width={1036}
    height={1322}
    caption="Source: https://x.com/uttam_singhk/status/2071581970807902420"
  />
</a>

## Empieza en 60 segundos

Conecta Claude Code a datos onchain en vivo con un comando:

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

Inicia sesión cuando se abra el navegador y empieza a preguntar. Sin API key, sin registro en el dashboard, sin instalación local. ¿Quieres firma y comandos scriptables también? Instala el [Alchemy CLI](https://agents.alchemy.com/), ejecuta `alchemy auth login`, y tu agente podrá leer, simular y enviar desde la misma configuración. Tu agente de código ya escribe código onchain. Ahora puede ejecutarlo.