Instala la CLI de Solana y Anchor

Esta sección cubre los pasos para configurar tu entorno local para el desarrollo en Solana.

Instalación rápida

En Mac y Linux, ejecuta este único comando para instalar todas las dependencias.

Terminal

$ curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Usuarios de Windows: primero deben instalar WSL (ver Instalar dependencias). Luego ejecuten el comando anterior en la terminal de Ubuntu (Linux).

Después de la instalación, deberías ver una salida como la siguiente:

Installed Versions:
Rust: rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Anchor CLI: anchor-cli 0.31.1
Node.js: v23.11.0
Yarn: 1.22.1

Si el comando de instalación rápida no funciona, consulta la sección Instalar dependencias a continuación para obtener instrucciones para instalar cada dependencia individualmente.

Si el comando de instalación rápida se ejecuta correctamente, salta a las secciones Conceptos básicos de Solana CLI y Conceptos básicos de Anchor CLI a continuación.

Instalar dependencias

Las instrucciones a continuación te guían a través de la instalación de cada dependencia individualmente.

Los usuarios de Windows primero deben instalar WSL (subsistema de Windows para Linux) y luego instalar las dependencias especificadas en la sección de Linux a continuación.
Los usuarios de Linux deben comenzar con la instalación de las dependencias especificadas en la sección de Linux a continuación.
Los usuarios de Mac deben comenzar con las instrucciones de instalación de Rust a continuación.

Instalar Rust

Los desarrolladores construyen programas de Solana utilizando el lenguaje de programación Rust.

Instala Rust con rustup.

Ejecuta el siguiente comando para instalar Rust:

Terminal

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Deberías ver el siguiente mensaje después de que se complete la instalación:

Ejecuta el siguiente comando para recargar tu variable de entorno PATH para incluir el directorio bin de Cargo:

Terminal

$ . "$HOME/.cargo/env"

Para verificar que la instalación se realizó correctamente, comprueba la versión de Rust:

Terminal

$ rustc --version

Deberías ver un resultado como el siguiente:

rustc 1.86.0 (05f9846f8 2025-03-31)

Instalar la CLI de Solana

La CLI de Solana proporciona todas las herramientas necesarias para construir y desplegar programas en Solana.

Instala el conjunto de herramientas de la CLI de Solana 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.

Para una primera instalación de la CLI de Solana, es posible que veas el siguiente mensaje solicitándote que agregues una variable de entorno PATH:

Cierra y vuelve a abrir tu terminal para aplicar los cambios en el PATH o ejecuta lo siguiente en tu shell actual:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

Si estás usando Linux o WSL, necesitas añadir el binario de Solana CLI a tu PATH para que el comando esté disponible en tu terminal.

Primero, ejecuta el siguiente comando para verificar qué shell estás utilizando:

Terminal

$ echo $SHELL

Si la salida contiene /bash, usa .bashrc.
Si la salida contiene /zsh, usa .zshrc.

Dependiendo de tu shell, ejecuta el comando apropiado.

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

Luego ejecuta el siguiente comando para actualizar la sesión de terminal o reinicia tu terminal.

Terminal

$ source ~/.bashrc # If using Bash
$ source ~/.zshrc # If using Zsh

Para verificar que la instalación se realizó correctamente, comprueba la versión de Solana CLI:

Terminal

$ solana --version

Deberías ver un resultado como el 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 el cliente validator de Solana Labs.

Para actualizar posteriormente la CLI de Solana a la última versión, puedes usar el siguiente comando:

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 escritura de programas en Solana.

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 gestor 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.

Instala AVM con el siguiente comando:

Terminal

$ cargo install --git https://github.com/coral-xyz/anchor avm --force

Confirma que AVM se instaló correctamente:

Terminal

$ avm --version

Instala la última versión de Anchor CLI usando AVM:

Terminal

$ avm install latest
$ avm use latest

Puedes instalar una versión específica de Anchor CLI especificando el número de versión:

Terminal

$ avm install 0.30.1
$ avm use 0.30.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, ejecuta avm use latest.
Si instalaste la versión 0.30.1, ejecuta avm use 0.30.1.

Para verificar que la instalación se realizó correctamente, comprueba la versión de la CLI de Anchor:

Terminal

$ anchor --version

Deberías ver un resultado como el siguiente:

anchor-cli 0.31.1

Al instalar la CLI de Anchor 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:

Instala las dependencias listadas en la sección Linux al principio de esta página.
Intenta instalar la CLI de Anchor nuevamente.

Node.js y Yarn

El archivo de prueba predeterminado del proyecto Anchor (TypeScript) creado con el comando anchor init requiere Node.js y Yarn. (La plantilla de prueba en Rust está disponible usando anchor init --test-template rust)

Al ejecutar anchor build, si encuentras los siguientes errores:

Después de aplicar la solución anterior, intenta ejecutar anchor build nuevamente.

Al ejecutar anchor test después de crear un nuevo proyecto Anchor en Linux o WSL, puedes encontrar los siguientes errores si no tienes Node.js o Yarn instalados:

Permission denied (os error 13)

No such file or directory (os error 2)

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

Conceptos básicos de Solana CLI

Esta sección explica algunos comandos comunes de Solana CLI para ayudarte a comenzar.

Configuración de Solana

Para ver tu configuración actual:

Terminal

$ solana config get

Deberías ver un resultado como el siguiente:

Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: confirmed

La URL RPC y la URL Websocket especifican el clúster de Solana al que la CLI envía solicitudes.

Puedes actualizar el clúster de Solana CLI usando los siguientes comandos:

Terminal

$ solana config set --url mainnet-beta
$ solana config set --url devnet
$ solana config set --url localhost
$ solana config set --url testnet

También puedes usar las siguientes opciones abreviadas:

Terminal

$ solana config set -um    # For mainnet-beta
$ solana config set -ud    # For devnet
$ solana config set -ul    # For localhost
$ solana config set -ut    # For testnet

La ruta del keypair apunta a la cartera Solana predeterminada (keypair) utilizada por la CLI de Solana para pagar las tarifas de transacción y desplegar programas. Por defecto, este archivo se almacena en ~/.config/solana/id.json.

Crear cartera

Para enviar transacciones utilizando la CLI de Solana, necesitas una cartera Solana financiada con SOL.

Para generar un keypair en la ruta predeterminada, ejecuta el siguiente comando:

Terminal

$ solana-keygen new

Deberías ver un resultado como el siguiente:

Generating a new keypair

For added security, enter a BIP39 passphrase

NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text

BIP39 Passphrase (empty for none):

Wrote new keypair to /Users/test/.config/solana/id.json
===========================================================================
pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT
===========================================================================
Save this seed phrase and your BIP39 passphrase to recover your new keypair:
cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing
===========================================================================

Si ya tienes una cartera guardada en el sistema de archivos en la ubicación predeterminada, este comando no la sobrescribirá a menos que fuerces explícitamente la sobrescritura usando la bandera --force.

Para ver la dirección de tu cartera (clave pública), ejecuta:

Terminal

$ solana address

Airdrop de SOL

Solicita un airdrop de SOL a tu cartera para pagar transacciones y despliegues de programas.

Configura tu clúster a devnet:

Terminal

$ solana config set -ud

Luego solicita un airdrop de SOL en devnet:

Terminal

$ solana airdrop 2

Los airdrops en devnet limitan las solicitudes a 5 SOL por petición. Si alcanzas los límites de frecuencia o encuentras errores, intenta usar el Faucet Web en su lugar.

Para verificar el saldo de SOL de tu cartera, ejecuta el siguiente comando:

Terminal

$ solana balance

Ejecutar validator local

La CLI de Solana incluye un validator de prueba integrado para desarrollo local.

En una terminal separada, ejecuta el siguiente comando para iniciar un validator local:

Terminal

$ solana-test-validator

Recuerda también actualizar tu CLI para usar localhost antes de ejecutar comandos de Solana CLI:

Terminal

$ solana config set -ul

Conceptos básicos de Anchor CLI

Esta sección explica algunos comandos comunes de Anchor CLI para ayudarte a comenzar. Para más información sobre Anchor CLI, consulta la documentación de Anchor.

Inicializar proyecto

Para crear un nuevo proyecto de Anchor, ejecuta el siguiente comando:

Terminal

$ anchor init <project-name>

Por ejemplo, para crear un proyecto llamado my-project, ejecuta:

Terminal

$ anchor init my-project

Este comando crea un nuevo directorio con el nombre del proyecto e inicializa un nuevo proyecto de Anchor con una plantilla básica de programa en Rust y pruebas en TypeScript.

Navega al directorio del proyecto:

Terminal

$ cd <project-name>

Consulta la estructura de archivos del proyecto Anchor.

Compilar programa

Para compilar tu proyecto, ejecuta el siguiente comando:

Terminal

$ anchor build

Puedes encontrar el programa compilado en el directorio /target/deploy.

Desplegar programa

Para desplegar tu proyecto, ejecuta el siguiente comando:

Terminal

$ anchor deploy

Este comando despliega tu programa en el cluster especificado en el archivo Anchor.toml.

Probar programa

Para probar tu proyecto, ejecuta el siguiente comando:

Terminal

$ anchor test

Este comando compila, despliega y ejecuta las pruebas para tu proyecto.

Cuando se usa localnet como cluster en Anchor.toml, Anchor automáticamente inicia un validator local, despliega tu programa, ejecuta las pruebas y luego detiene el validator.

Subsistema de Windows para Linux (WSL)

Linux

Mensaje de instalación exitosa de Rust

Instalación de Node

Instalación de Yarn

error: not a directory

lock file version 4 requires `-Znext-lockfile-bump

Tabla de Contenidos