Instalar dependencias
Una guía para configurar tu entorno de desarrollo local de Solana. Aprende cómo 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 construyen programas de Solana utilizando el lenguaje de programación Rust.
- Instala Rust usando rustup introduciendo el siguiente comando en tu terminal:
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:
Terminal
$. "$HOME/.cargo/env"
- Verifica que la instalación se realizó correctamente.
Terminal
$rustc --version
Verás una salida como la siguiente:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instalar Solana CLI
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:
Terminal
$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 de software de tu versión deseada (por ejemplo, v2.0.3), o usar uno
de los tres nombres de canal simbólicos: stable, beta, o edge.
- Añade una variable de entorno PATH
Una instalación por primera vez de Solana CLI puede pedirte que añadas 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 añadir 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. Comprueba qué shell estás utilizando:
Terminal
$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):
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Para Zsh (zshrc):
Terminal
$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 del terminal:
Terminal
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Verifica que la instalación se realizó correctamente comprobando la versión de Solana CLI:
Terminal
$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 validator de Anza, anteriormente conocido como cliente validator de Solana Labs.
- Actualiza Solana CLI a la última versión, según sea necesario (Opcional)
Terminal
$agave-install update
Instalar Anchor CLI
Anchor es un framework para desarrollar programas en Solana. El framework Anchor utiliza macros de Rust para simplificar el proceso de escribir programas en 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 de Anchor y sus herramientas de dos maneras:
- Anchor Version Manager (AVM) — Método de instalación recomendado
- Sin AVM — Instalar directamente desde GitHub
El Administrador de Versiones de Anchor (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:
Terminal
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Confirma que AVM se instaló correctamente:
Terminal
$avm --version
- Instala Anchor CLI usando AVM:
Para instalar la última versión:
Terminal
$avm install latest$avm use latest
Para instalar una versión específica, especifica el número de versión:
Terminal
$avm install 0.30.1$avm use 0.30.1
Al instalar Anchor CLI en Linux o WSL, es posible que encuentres 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 principio de esta página.
- Intenta instalar Anchor CLI nuevamente.
- Verifica que la instalación se realizó correctamente, comprobando la versión de Anchor CLI:
Terminal
$anchor --version
Verás un resultado como el 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.
Configuración de herramientas de IA para el 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 LLMs en la documentación de Solana. | https://solana.com/llms.txt |
Is this page helpful?