From af171201b55880669d9338abc1c71cbbd47b6cc3 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Thu, 15 Oct 2026 15:13:45 +0200 Subject: [PATCH] Documentazione: installazione di Claude Code e build su Linux ARM64 Aggiunti i passi per installare Claude Code da zero su Linux ARM64 (Raspberry Pi) e per installare il .NET SDK 10 e creare l'eseguibile linux-arm64. Il target resta non verificato su hardware reale. Co-Authored-By: Claude Sonnet 5.5 --- README.md | 4 ++-- docs/INSTALL.md | 11 +++++++++++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 58ae372..30b2a56 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ Ogni eseguibile è un **unico file** che include il runtime .NET: chi lo usa non ### 1. Installare il .NET SDK 10 - **Windows** (PowerShell o Prompt dei comandi): `winget install Microsoft.DotNet.SDK.10`, oppure il programma di installazione da [dotnet.microsoft.com/download](https://dotnet.microsoft.com/download). -- **Linux / WSL / macOS**: pacchetto della distribuzione o script ufficiale da [dotnet.microsoft.com/download](https://dotnet.microsoft.com/download). +- **Linux / WSL / macOS**: pacchetto della distribuzione o script ufficiale da [dotnet.microsoft.com/download](https://dotnet.microsoft.com/download). Funziona anche su ARM64 (Raspberry Pi): `curl -sSL https://dot.net/v1/dotnet-install.sh -o /tmp/dotnet-install.sh && bash /tmp/dotnet-install.sh --channel 10.0`, poi `export DOTNET_ROOT=$HOME/.dotnet PATH=$PATH:$HOME/.dotnet` (da mettere in `~/.bashrc`). - Controllo: `dotnet --version` deve stampare `10.x`. ### 2. Creare gli eseguibili @@ -45,7 +45,7 @@ Risultato (circa 47 MB per file), in `dist/`, ignorata da git: | Windows x64 | `dist/win-x64/agent-wiki-ui.exe` | | Linux x64 | `dist/linux-x64/agent-wiki-ui` | -Altri identificatori (per esempio `win-arm64`, `linux-arm64`) si possono provare allo stesso modo, ma non sono verificati. Lo script è solo una comodità: il comando sotto fa la stessa cosa. +Altri identificatori (per esempio `win-arm64`, `linux-arm64`) si passano allo script allo stesso modo (`scripts/publish.sh linux-arm64`, risultato in `dist/linux-arm64/`), ma non sono verificati. Su un Raspberry Pi servono anche i motori: per Claude Code vedi [docs/INSTALL.md](docs/INSTALL.md). Lo script è solo una comodità: il comando sotto fa la stessa cosa. **Senza script** (identico su qualsiasi sistema; sostituisci `` con `win-x64` o `linux-x64`): ``` diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 075b315..7756332 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -31,6 +31,17 @@ Dentro WSL il PATH di Windows è visibile (compare `/mnt/c/…`): se in WSL non L'installazione nativa non mostra avanzamento durante il download. A fine installazione apri un **nuovo** terminale. +**Da zero su Linux, anche ARM64 (per esempio Raspberry Pi 5 con Raspberry Pi OS a 64 bit).** Il metodo nativo riconosce da solo l'architettura (`uname -m` deve dare `aarch64` o `x86_64`): +``` +sudo apt install -y curl # se manca +curl -fsSL https://claude.ai/install.sh | bash +# apri un nuovo terminale, poi: +command -v claude # atteso: ~/.local/bin/claude +claude --version +claude # primo avvio: accesso nel browser +``` +Su un Raspberry senza schermo l'accesso nel browser si fa da un altro dispositivo, seguendo l'indirizzo che `claude` stampa nel terminale (per esempio via SSH); in alternativa usa una API key o un provider cloud, vedi "Accesso". Se `~/.local/bin` non è nel PATH aggiungi `export PATH="$HOME/.local/bin:$PATH"` a `~/.bashrc`. Con la sola architettura ARM64 e Debian 10+ i requisiti sono soddisfatti; il metodo npm è l'alternativa se lo script nativo non funziona. Non provato su un Raspberry reale: le istruzioni vengono dalla guida ufficiale. + **Accesso**: esegui `claude` e segui le istruzioni nel browser. Serve un account Pro, Max, Team, Enterprise o Console (il piano gratuito di claude.ai non include Claude Code). In alternativa Amazon Bedrock, Google Cloud o Microsoft Foundry. **Verifica**