Documentazione: guida all'installazione di Claude Code e Codex

Aggiunge docs/INSTALL.md con requisiti, comandi per Linux, WSL e Windows,
accesso, verifica e risoluzione dei problemi di PATH. Insiste sul fatto che
il motore va installato nello stesso ambiente dell'app. Collegata da indice
dei doc, README e ADR-0002.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

README.md

@@ -3,7 +3,7 @@
 Eseguibile C# (.NET 10, Windows e Linux) che lancia Claude Code (`claude -p`) nella cartella in cui risiede l'eseguibile. Senza argomenti apre una GUI di chat (Avalonia), con argomenti funziona da riga di comando.
 
 ## Requisiti
-- `claude` (Claude Code) installato e nel PATH, già autenticato
+- `claude` (Claude Code) installato e nel PATH, già autenticato; per Codex lo stesso con `codex`. Istruzioni: [docs/INSTALL.md](docs/INSTALL.md)
 - Per sviluppare: .NET SDK 10
 - Per usare l'eseguibile pubblicato: nessun runtime (è self-contained). Su Linux serve un desktop con X11 o XWayland per la GUI.
 

docs/INSTALL.md

@@ -0,0 +1,90 @@
+# Installare i motori (Claude Code e Codex)
+
+L'app non installa né autentica i motori: lancia quelli che trova nel PATH, già installati e con l'accesso fatto ([ADR-0002](adr/0002-motori-cli-claude-codex-antigravity.md)). Questa pagina spiega come prepararli. Fonti e data di consultazione in fondo.
+
+## Prima di iniziare: un ambiente, un motore
+Il motore va installato **nello stesso ambiente in cui gira l'app**:
+
+| Dove avvii l'app | Dove installare il motore |
+|---|---|
+| Linux nativo | nel terminale Linux |
+| WSL (anche con `dotnet run`) | nel terminale della distribuzione WSL |
+| Windows (`.exe`) | in Windows (PowerShell), non in WSL |
+
+Dentro WSL il PATH di Windows è visibile (compare `/mnt/c/…`): se in WSL non c'è un `claude` o un `codex`, il comando può risolvere nella versione Windows. Controllalo con `command -v claude` e `command -v codex`.
+
+## Claude Code
+
+**Requisiti**: macOS 13+, Windows 10 1809+ o Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+; 4 GB di RAM, x64 o ARM64, connessione a internet. Su Windows nativo [Git for Windows](https://git-scm.com/downloads/win) è consigliato ma facoltativo.
+
+**Installazione** (una delle opzioni; la prima è la raccomandata):
+
+| Metodo | Comando |
+|---|---|
+| Nativo, Linux/macOS/WSL | `curl -fsSL https://claude.ai/install.sh \| bash` |
+| Nativo, Windows PowerShell | `irm https://claude.ai/install.ps1 \| iex` |
+| Nativo, Windows CMD | `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` |
+| Homebrew | `brew install --cask claude-code` |
+| WinGet | `winget install Anthropic.ClaudeCode` |
+| npm (serve Node.js 22 o successivo) | `npm install -g @anthropic-ai/claude-code` (mai con `sudo`) |
+| apt / dnf / apk | repository firmati: vedi la guida ufficiale |
+
+L'installazione nativa non mostra avanzamento durante il download. A fine installazione apri un **nuovo** terminale.
+
+**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**
+```
+claude --version        # stampa la versione, es. 2.1.x (Claude Code)
+claude doctor           # diagnostica di installazione e impostazioni
+claude auth status      # mostra se hai fatto l'accesso
+```
+
+**Aggiornamento**: l'installazione nativa si aggiorna da sola; `claude update` forza l'aggiornamento. Homebrew, WinGet, npm e i gestori di pacchetti vanno aggiornati a mano (`npm install -g @anthropic-ai/claude-code@latest`, evitando `npm update -g`).
+
+## Codex CLI
+
+**Requisiti**: macOS (Apple Silicon e Intel), Linux (x86_64 e arm64), Windows tramite lo script PowerShell. Per l'installazione con npm serve Node.js. Serve un piano ChatGPT (Plus, Pro, Business, Edu o Enterprise) oppure una API key.
+
+**Installazione** (una delle opzioni):
+
+| Metodo | Comando |
+|---|---|
+| Script, Linux/macOS/WSL | `curl -fsSL https://chatgpt.com/codex/install.sh \| sh` |
+| Script, Windows PowerShell | `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \| iex"` |
+| npm | `npm install -g @openai/codex` |
+| Homebrew | `brew install --cask codex` |
+| Binario | archivio dalla pagina delle release su GitHub (`openai/codex`), estratto e rinominato `codex` |
+
+Gli script scaricano da `releases.openai.com` e, se fallisce, da GitHub Releases; per forzare GitHub imposta `CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false`.
+
+**Su Windows preferisci lo script PowerShell a npm.** L'app avvia l'eseguibile direttamente, senza `cmd.exe /c`; un'installazione con npm potrebbe produrre uno script `.cmd` che così non parte (rischio indicato nell'ADR-0002, da verificare su Windows).
+
+**Accesso**: esegui `codex` e scegli "Sign in with ChatGPT" (consigliato), oppure usa una API key (guida ufficiale: sezione autenticazione).
+
+**Verifica**
+```
+codex --version         # es. codex-cli 0.144.x
+codex login status      # "Logged in using ChatGPT" se l'accesso è fatto
+codex exec --help       # uso non interattivo, usato dall'app
+```
+
+**Stato su questa macchina** (WSL, controllato il 2026-10-15): `codex` 0.144.3 in `~/.local/bin/codex`, collegamento a `~/.codex/packages/standalone/current/bin/codex`, con accesso ChatGPT già fatto. `claude` 2.1.252 in `~/.npm-global/bin/claude`, con accesso claude.ai già fatto.
+
+## Controllo finale per l'app
+Dallo stesso terminale da cui avvii l'app:
+```
+command -v claude codex          # Linux/WSL; in PowerShell: Get-Command claude, codex
+claude -p "rispondi solo: ok"
+codex exec "rispondi solo: ok"
+```
+Se i comandi rispondono, l'app li trova. Se l'app dice "'claude' non trovato nel PATH":
+- apri un nuovo terminale (il PATH si aggiorna solo ai nuovi);
+- controlla che la cartella d'installazione sia nel PATH: per Claude Code nativo e per Codex con script è `~/.local/bin` su Linux/macOS/WSL, `%USERPROFILE%\.local\bin` su Windows (per Claude Code);
+- verifica di non aver installato in un ambiente diverso da quello dell'app (tabella iniziale).
+
+## Fonti
+- Claude Code: documentazione ufficiale "Advanced setup", consultata il 2026-10-15 (`code.claude.com/docs/en/setup`).
+- Codex: README del repository `github.com/openai/codex`, consultato il 2026-10-15. La pagina openai.com/it-IT/codex/ non era raggiungibile (HTTP 403).
+- Comandi `--version`, `login status`, `auth status` e `exec --help`: provati sulla macchina descritta sopra.
+- Antigravity CLI (`agy`): non ancora trattato, da aggiungere quando verrà integrato.

docs/README.md

@@ -6,6 +6,7 @@ Indice e regole. Ogni informazione vive in **un solo documento**; gli altri la r
 |---|---|
 | [../README.md](../README.md) | Uso, requisiti, build e publish |
 | [MVP.md](MVP.md) | Specifica funzionale, design UI/UX, criteri di accettazione |
+| [INSTALL.md](INSTALL.md) | Come installare e autenticare i motori (Claude Code, Codex), verifica e problemi comuni |
 | [TESTING.md](TESTING.md) | Piano dei test: regola "nuova funzione = nuovi test", soglie di copertura, matrice requisito → test |
 | [ROADMAP.md](ROADMAP.md) | Fasi e stato (spunte); solo passi, mai motivazioni |
 | `adr/NNNN-*.md` | Decisioni architetturali e loro motivazioni (indice sotto) |

docs/adr/0002-motori-cli-claude-codex-antigravity.md

@@ -45,3 +45,4 @@ Da verificare con `--help` delle versioni installate: derivano da documentazione
 
 ## Riferimenti
 - Passi: [ROADMAP.md](../ROADMAP.md), Fase 4.
+- Installazione e accesso dei motori: [INSTALL.md](../INSTALL.md).