Installa Grok Build su macOS, Linux o Windows in due minuti

Prima di installare

Grok Build è un’app da terminale di SpaceXSI (ex xAI). Esistono binari precompilati per macOS, Linux e Windows. Ti servono:

• Un terminale: Terminale o iTerm su macOS, una shell qualsiasi su Linux, PowerShell o Git Bash su Windows.
• Un browser web per il primo accesso, oppure una chiave API se lo configuri su un server.
• Un account. Grok Build si può provare gratis, e il piano Plus di The X Subscription ($8 al mese) e i livelli superiori aggiungono utilizzo.

Comandi di installazione

1. macOS, Linux o Git Bash: esegui curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell: esegui irm https://x.ai/cli/install.ps1 | iex
3. Verifica che abbia funzionato: esegui grok --version. Se compare un numero di versione, l’installazione è riuscita.

Entrambi i comandi provengono dalla pagina ufficiale di Grok Build e dal repository GitHub. Secondo una guida di configurazione di terze parti, l’installer mette il programma in ~/.grok/bin.

Gli sviluppatori possono anche compilarlo dal sorgente. Servono una toolchain Rust (installata e fissata tramite rustup), DotSlash (cargo install dotslash) e protoc. macOS e Linux sono gli host di compilazione supportati. Le build su Windows sono “best-effort”, quindi chi usa Windows dovrebbe usare il binario precompilato.

Primo avvio e accesso

1. Apri un terminale nella cartella del progetto, non nella tua home.
2. Esegui grok.
3. Si apre una finestra del browser per l’accesso, di solito su grok.com.
4. Dopo l’accesso parte l’interfaccia da terminale. Le credenziali vengono salvate in ~/.grok/auth.json.

Perché conta la cartella del progetto: a luglio 2026 eseguire Grok Build poteva caricare l’intera directory corrente sullo storage cloud dell’azienda. SpaceXSI ha disattivato la funzione lo stesso giorno e dice che ora Build può girare interamente in locale. Partire dalla cartella del progetto resta comunque l’abitudine più sicura, perché l’agente può leggere e modificare i file nel punto in cui viene eseguito.

Per impostazione predefinita Grok Build usa il plan mode: propone un piano e non fa modifiche finché non lo approvi.

Aggiornare e controllare la configurazione

• grok update aggiorna Grok Build all’ultima versione.
• grok doctor controlla la configurazione del terminale e segnala i problemi.
• grok --version mostra la versione installata.

Aggiorna spesso. SpaceXSI rilascia funzioni rapidamente, e i nuovi modelli come Grok 4.7 arrivano su Grok Build il giorno stesso del rilascio.

Usare una chiave API nella CI

L’accesso tramite browser non funziona sui server di build. Per la CI, imposta invece la variabile d’ambiente XAI_API_KEY e usa la modalità headless per script e pipeline.

1. Crea un account su console.x.ai.
2. Carica dei crediti. L’API è prepagata, e le richieste vengono rifiutate quando i crediti finiscono.
3. Genera una chiave nella pagina API Keys.
4. Salvala come segreto nel tuo sistema di CI ed esponila come XAI_API_KEY.

L’utilizzo tramite chiave API è fatturato alle tariffe dell’API, non attinge alla quota del tuo abbonamento. Il modello grok-build-0.1 costa $1 per milione di token in input e $2 per milione di token in output.

File di configurazione e permessi

Grok Build conserva le sue impostazioni in ~/.grok/config.toml. Lì si configurano i server MCP, per collegarsi a strumenti come Linear, Sentry o Postgres.

Le convenzioni per progetto vanno in un file AGENTS.md in ogni directory. Una guida di terze parti elenca queste modalità di permesso: default, acceptEdits, auto, dontAsk, bypassPermissions e plan. Tra i flag utili ci sono --worktree, --no-plan e --no-subagents. Evita bypassPermissions a meno che tu non esegua Build in una sandbox.

Problemi comuni

• “grok: command not found”: apri un nuovo terminale così la shell ricarica il path, e controlla che ~/.grok/bin sia nel tuo PATH.
• La visualizzazione sembra rotta: esegui grok doctor per controllare il supporto del terminale.
• La finestra di accesso non si apre: su una macchina remota, usa invece XAI_API_KEY.
• Chiave API rifiutata: controlla che il tuo account della console abbia crediti caricati.
• Grok 4.7 Fast non c’è: Fast non fa parte del livello gratuito.
• Quota esaurita: i piani a pagamento condividono un’unica quota settimanale con la chat di Grok e Cursor. Un uso intenso in un punto lascia meno spazio per gli altri.

Domande frequenti