Una guía para configurar tu entorno de desarrollo local de Solana. Aprende a instalar Rust, la CLI de Solana y Anchor Framework en Windows (WSL), Linux y Mac. Usa esta guía si prefieres instalar cada dependencia individualmente, o si la instalación rápida falla por alguna razón.
Requisitos previos
Instalar Rust
Los desarrolladores crean programas de Solana usando el lenguaje de programación Rust.
- Instala Rust usando rustup ingresando el siguiente comando en tu terminal:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Después de una instalación exitosa verás el siguiente mensaje:
- Recarga tu variable de entorno PATH para incluir el directorio bin de Cargo:
$. "$HOME/.cargo/env"
- Verifica que la instalación fue exitosa.
$rustc --version
Verás una salida como la siguiente:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instalar Solana CLI
El Solana CLI proporciona todas las herramientas necesarias para construir y desplegar programas de Solana.
- Instala el conjunto de herramientas de Solana CLI usando el comando de instalación oficial:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Puedes reemplazar stable con la etiqueta de versión que coincida con la
versión del software de tu lanzamiento deseado (por ejemplo, v2.0.3), o usar
uno de los tres nombres de canal simbólicos: stable, beta, o edge.
- Agrega una variable de entorno PATH
Una instalación por primera vez del Solana CLI puede solicitarte que agregues
una variable de entorno PATH. Para hacerlo, cierra y vuelve a abrir tu
terminal o ejecuta lo siguiente en tu shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Actualiza tu variable de entorno PATH
Si estás usando Linux o WSL, debes agregar el binario de Solana CLI a tu PATH para que el comando esté disponible en tu terminal. Para hacerlo, sigue los pasos a continuación:
a. Verifica qué shell estás usando:
$echo $SHELL
- Si la salida contiene
/bash, usa.bashrc. - Si la salida contiene
/zsh, usa.zshrc.
b. Ejecuta el comando apropiado, según tu shell.
Para Bash (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Para Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Reinicia tu terminal o ejecuta el siguiente comando para actualizar la sesión de terminal:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Verifica que la instalación fue exitosa comprobando la versión de Solana CLI:
$solana --version
Verás una salida como la siguiente:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Puedes ver todas las versiones disponibles en el repositorio de Github de Agave. Agave es el cliente validador de Anza, anteriormente conocido como el cliente validador de Solana Labs.
- Actualiza Solana CLI a la última versión, según sea necesario (Opcional)
$agave-install update
Instalar Anchor CLI
Anchor es un framework para desarrollar programas de Solana. El framework Anchor aprovecha las macros de Rust para simplificar el proceso de escribir programas de Solana.
Requisitos previos
El archivo de prueba predeterminado del proyecto Anchor (TypeScript) creado con
el comando anchor init requiere Node.js y Yarn. (La plantilla de prueba
de Rust está disponible usando anchor init --test-template rust)
Instalación
Puedes instalar la CLI y las herramientas de Anchor de dos maneras:
- Anchor Version Manager (AVM) — Método de instalación recomendado
- Sin AVM — Instalar directamente desde GitHub
El Anchor Version Manager (AVM) te permite instalar y gestionar diferentes versiones de Anchor en tu sistema y actualizar fácilmente las versiones de Anchor en el futuro. Para instalar Anchor usando AVM, sigue los pasos a continuación:
- Instala AVM con el siguiente comando:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Confirma que AVM se instaló correctamente:
$avm --version
- Instala Anchor CLI usando AVM:
Para instalar la última versión:
$avm install latest$avm use latest
Para instalar una versión específica, especifica el número de versión:
$avm install 0.30.1$avm use 0.30.1
Al instalar Anchor CLI en Linux o WSL, puedes encontrar este error:
error: could not exec the linker cc = note: Permission denied (os error 13)
Si ves este mensaje de error, sigue estos pasos:
- Instala las dependencias listadas en la sección Linux al inicio de esta página.
- Vuelve a intentar instalar Anchor CLI.
- Verifica que la instalación se realizó correctamente, comprobando la versión de Anchor CLI:
$anchor --version
Verás una salida como la siguiente:
anchor-cli 0.31.1
No olvides ejecutar el comando avm use para declarar la versión de
Anchor CLI que se ejecutará en tu sistema.
- Si instalaste la versión
latest, ejecutaavm use latest. - Si instalaste la versión
0.30.1, ejecutaavm use 0.30.1.
Instalar Surfpool CLI
Surfpool es una herramienta para desarrollo local y un
reemplazo mejorado de solana-test-validator. Conoce más sobre las
funcionalidades de Surfpool en la
documentación de Surfpool.
- Instala Surfpool con el siguiente comando:
$curl -sL https://run.surfpool.run/ | bash
- Verifica que la instalación se realizó correctamente comprobando la versión de Surfpool CLI:
$surfpool --version
Verás una salida como la siguiente:
surfpool 0.12.0
Configurar herramientas de IA para desarrollo en Solana
Esta sección detalla la configuración opcional de herramientas de IA que puedes usar para acelerar tu desarrollo en Solana.
| Herramienta | Descripción | Enlace |
|---|---|---|
| MCP | Servidor MCP al que puedes conectarte con cursor para mejorar el desarrollo asistido por IA en Solana. | https://mcp.solana.com/ |
| LLMs.txt | Documentación optimizada para LLM que puedes usar para entrenar modelos de lenguaje en la documentación de Solana. | https://solana.com/llms.txt |
Is this page helpful?