ローカルのSolana開発環境をセットアップするためのガイド。Windows（WSL）、Linux、MacでRust、Solana CLI、Anchorフレームワークをインストールする方法を学びます。各依存関係を個別にインストールしたい場合、またはクイックインストールが何らかの理由で失敗した場合は、このガイドを使用してください。
前提条件
Rustをインストールする
開発者はRustプログラミング言語を使用してSolanaプログラムを構築します。
- ターミナルで以下のコマンドを入力し、rustupを使用してRustをインストールします：
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
インストールが正常に完了すると、以下のメッセージが表示されます：
- Cargoのbinディレクトリを含めるため、PATH環境変数を再読み込みします：
$. "$HOME/.cargo/env"
- インストールが正常に完了したことを確認します。
$rustc --version
以下のような出力が表示されます：
rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLIのインストール
Solana CLIは、Solanaプログラムの構築とデプロイに必要なすべてのツールを提供します。
- 公式インストールコマンドを使用して、Solana CLIツールスイートをインストールします：
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
stableを、希望するリリースのソフトウェアバージョンに対応するリリースタグ（例：v2.0.3）に置き換えるか、3つのシンボリックチャネル名（stable、beta、またはedge）のいずれかを使用できます。
- PATH環境変数を追加します
Solana
CLIを初めてインストールする際、PATH環境変数を追加するよう求められる場合があります。追加するには、ターミナルを閉じて再度開くか、シェルで以下を実行します：
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- PATH環境変数を更新します
LinuxまたはWSLを使用している場合、ターミナルでコマンドを使用できるようにするため、Solana CLIバイナリをPATHに追加する必要があります。追加するには、以下の手順に従ってください：
a. 使用しているシェルを確認します：
$echo $SHELL
- 出力に
/bashが含まれている場合は、.bashrcを使用してください。 - 出力に
/zshが含まれている場合は、.zshrcを使用してください。
b. シェルに応じて、適切なコマンドを実行してください。
Bash（bashrc）の場合：
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Zsh（zshrc）の場合：
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- ターミナルを再起動するか、次のコマンドを実行してターミナルセッションを更新してください：
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Solana CLIのバージョンを確認して、インストールが成功したことを確認してください：
$solana --version
次のような出力が表示されます：
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
利用可能なすべてのバージョンは、Agave Githubリポジトリで確認できます。AgaveはAnzaのvalidatorクライアントで、以前はSolana Labsのvalidatorクライアントとして知られていました。
- 必要に応じて、Solana CLIを最新バージョンに更新してください（オプション）
$agave-install update
Anchor CLIのインストール
Anchorは、Solanaプログラムを開発するためのフレームワークです。AnchorフレームワークはRustマクロを活用して、Solanaプログラムの記述プロセスを簡素化します。
前提条件
*shellanchor initコマンドで作成されるデフォルトのAnchorプロジェクトテストファイル（TypeScript）には、Node.jsとYarnが必要です。（Rustテストテンプレートはshellanchor init --test-template rust*を使用して利用できます）
インストール
Anchor CLIとツールは、2つの方法でインストールできます：
- Anchor Version Manager（AVM）— 推奨されるインストール方法
- AVMを使用しない — GitHubから直接インストール
Anchor Version Manager（AVM）を使用すると、システムに異なるAnchorバージョンをインストールして管理し、将来的にAnchorバージョンを簡単に更新できます。AVMを使用してAnchorをインストールするには、以下の手順に従ってください：
- 次のコマンドでAVMをインストールします：
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- AVMが正常にインストールされたことを確認します：
$avm --version
- AVMを使用してAnchor CLIをインストールします：
最新バージョンをインストールする場合：
$avm install latest$avm use latest
特定のバージョンをインストールする場合は、バージョン番号を指定します：
$avm install 0.30.1$avm use 0.30.1
LinuxまたはWSLでAnchor CLIをインストールする際に、次のエラーが発生する場合があります：
error: could not exec the linker cc = note: Permission denied (os error 13)
このエラーメッセージが表示された場合は、次の手順に従ってください：
- このページの上部にあるLinuxセクションに記載されている依存関係をインストールします。
- Anchor CLIのインストールを再試行します。
- Anchor CLIのバージョンを確認して、インストールが成功したことを確認します：
$anchor --version
次のような出力が表示されます：
anchor-cli 0.31.1
システムで実行するAnchor
CLIバージョンを宣言するために、*shellavm use*コマンドを実行することを忘れないでください。
latestバージョンをインストールした場合は、*shellavm use latest*を実行します。- バージョン
0.30.1をインストールした場合は、*shellavm use 0.30.1*を実行します。
Surfpool CLIのインストール
Surfpoolは、ローカル開発用のツールであり、solana-test-validatorの改良版です。Surfpoolの機能の詳細については、Surfpoolドキュメントをご覧ください。
- 次のコマンドでSurfpoolをインストールします：
$curl -sL https://run.surfpool.run/ | bash
- Surfpool CLIのバージョンを確認して、インストールが成功したことを確認します：
$surfpool --version
次のような出力が表示されます：
surfpool 0.12.0
Solana開発用のAIツールのセットアップ
このセクションでは、Solana開発を加速するために使用できるオプションのAIツールのセットアップについて説明します。
| ツール | 説明 | リンク |
|---|---|---|
| MCP | CursorなどのエディタでSolanaのAI支援開発を改善するために接続できるMCPサーバー。 | https://mcp.solana.com/ |
| LLMs.txt | SolanaドキュメントでLLMをトレーニングするために使用できる、LLM最適化ドキュメント。 | https://solana.com/llms.txt |
Is this page helpful?