Installare e lanciare Claude Code e Codex

Panoramica

Basta teoria. In questa lezione installi i due agenti di coding, fai girare la tua prima sessione e metti in atto le protezioni che mantengono al sicuro il tuo lavoro. Demistifichiamo anche i piani di subscription, perche la tariffazione confonde davvero le persone e la scelta sbagliata spreca o del denaro, o ti blocca nel bel mezzo di un compito.

Cosa imparerai

Installi Claude Code e Codex, li autentichi, fai girare un primo compito d'agente, capisci i livelli di piano da 20, 100 e 200 dollari e metti in atto tre protezioni fondamentali perche un agente non trapeli mai un segreto ne tocchi codice che non dovrebbe toccare.

Prerequisiti

Hai bisogno di Node.js installato e di una certa dimestichezza nell'aprire un terminale. Se uno di questi punti ti e nuovo, le pagine dei fondamenti su Node.js e le basi del terminale lo trattano da zero - installa prima Node.js poi torna qui. Vuoi anche un editor di codice come VS Code, che ha la sua pagina di fondamenti.

Il problema

La fase del setup e il punto in cui la maggior parte dei principianti resta bloccata. Non sanno quale piano comprare, sono nervosi all'idea di dare a un agente l'accesso alla loro macchina e preoccupati per la sicurezza e i costi. Cosi non lanciano mai davvero lo strumento. Questa lezione toglie ciascuno di questi blocchi a turno, perche tu finisca con un setup funzionante e sicuro.

Passo passo: installare Claude Code

Claude Code si installa tramite npm, il gestore di pacchetti fornito con Node.js. Apri il tuo terminale e lancia il comando di installazione, poi avvialo in una cartella di progetto. Al primo lancio, ti verra chiesto di connetterti tramite il browser per collegare il tuo account Anthropic.

# Installare la CLI Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Andare in una cartella di progetto (creane una se serve)
mkdir my-first-app && cd my-first-app

# Lanciare Claude Code - al primo lancio si apre un browser per connettersi
claude

Appena parte, parlagli semplicemente. Prova: "Crea un README.md che spiega che questo e il mio primo progetto costruito con l'IA." Guardalo proporre la modifica, chiedere il permesso e scrivere il file. Questo ciclo - proporre, permesso, agire - e il modello di sicurezza su cui ti appoggi.

Passo passo: installare Codex

Codex e la CLI di OpenAI e si installa allo stesso modo. Avere entrambi ti da un secondo parere e un ripiego quando un fornitore e saturo o un modello particolare si adatta meglio al compito.

# Installare la CLI Codex globalmente
npm install -g @openai/codex

# Lanciarla nel tuo progetto
codex

Autenticati con il tuo account OpenAI quando te lo chiede. Fai girare un piccolo compito per confermare che funziona, per esempio chiedendogli di spiegare il README che hai appena creato. Ora hai due agenti di coding installati.

Capire i piani: 20, 100 e 200 dollari

Anthropic propone Claude in piani a livelli, e la stessa logica vale per OpenAI. Il piano da 20 dollari e per un uso leggero e occasionale. Il piano da 100 dollari va bene per utilizzatori regolari quotidiani. Il piano da 200 dollari e per i grandi builder a tempo pieno e ti da l'uso piu generoso dei modelli piu potenti. La valutazione onesta: se vivi per costruire, 200 dollari al mese e economico. Un'ora del tempo di uno sviluppatore costa piu di quello, e un piano serio ti fa guadagnare molte ore ogni settimana. L'opzione cara e il piano economico che ti blocca nel bel mezzo di vero lavoro.

• 20 dollari/mese: uso leggero, sere e weekend, apprendimento.
• 100 dollari/mese: compagno quotidiano per la maggior parte dei professionisti.
• 200 dollari/mese: grande build a tempo pieno, accesso massimo ai modelli di punta.
• Riformulazione: paragona il piano a un'ora fatturabile, non a un abbonamento di streaming. Si ripaga in qualche giorno di tempo guadagnato.

Proteggere il tuo business e la tua IP

Un agente esegue comandi e modifica file, quindi delle protezioni fondamentali non sono negoziabili dal primo giorno. Niente di tutto cio e difficile, e saltarlo equivale a cio che fanno i principianti che trapelano chiavi API o pubblicano codice privato su Internet. Metti in atto queste tre protezioni prima di fare vero lavoro.

• Usa repository privati. Quando ti connetti a GitHub, metti ogni progetto business in privato per default, perche il tuo codice e la tua IP non siano visibili pubblicamente.
• Non committare mai segreti. Le chiavi API, le password e i token vivono in un file .env elencato in .gitignore, per non essere mai inviato a GitHub. L'agente non deve mai scrivere un segreto in codice committato.
• Gira con permessi sensati. Lascia che l'agente chieda prima di eseguire comandi all'inizio, per vedere cosa vuole fare. Allentalo solo una volta acquisita fiducia nel workflow.

I due strumenti rispettano anche un file di regole di progetto (CLAUDE.md per Claude Code, AGENTS.md per Codex), dove annoti queste protezioni in linguaggio chiaro perche l'agente le segua automaticamente. Le costruiremo davvero nel Corso 2.

Errori frequenti

Gli errori comuni qui sono comprare il piano sbagliato poi concludere "l'IA non e abbastanza buona" quando sei solo stato bloccato; dare permessi di auto-esecuzione in blocco prima di capire lo strumento; e cominciare a lavorare senza .gitignore, cosicche un segreto atterra nel tuo primo commit. Ognuno e evitabile con i passi qui sopra.

ROI business

Un agente correttamente installato e l'assunzione piu impattante che farai mai, disponibile immediatamente e instancabile. Il costo del piano e irrisorio di fronte alle ore guadagnate, ma solo se scegli un livello adatto al tuo uso e metti in atto protezioni per delegare con fiducia. I fondatori che vedono il piano da 200 dollari come caro ottimizzano generalmente la voce sbagliata di un fattore dieci.

Checklist

Hai finito quando tutto quanto segue e vero. Non andare avanti finche ogni casella non e davvero spuntata, perche il resto del corso suppone un agente funzionante.

• Claude Code installato, autenticato, e ha scritto un file per te.
• Codex installato e autenticato.
• Hai scelto un piano adatto al tuo uso reale.
• Un .gitignore esiste, i segreti vivono in .env, e il tuo progetto e per default su un repo privato.

Risorse

Se i comandi di installazione falliscono, la causa abituale e un Node.js mancante o obsoleto - rivedi la pagina dei fondamenti su Node.js. Tieni nei preferiti la documentazione ufficiale di Claude Code e Codex per i flag e gli aggiornamenti. La prossima lezione ti insegna come parlare davvero a questi agenti perche consegnino.

La tua missione

Installa i due agenti, crea una cartella di progetto nuova con un .gitignore e un .env vuoto, e lascia che Claude Code generi una semplice pagina HTML che dice ciao. Conferma che l'agente ha chiesto il permesso prima di scrivere. Ora hai un setup sicuro e funzionante e il tuo primo file costruito da un agente.

Prossima lezione

Hai gli strumenti. Ora bisogna guidarli. La prossima lezione e il prompt engineering che funziona davvero: gli assiomi, l'inquadramento budget illimitato, chiedere all'agente di contraddirti e scrivere spec sheet che danno ottimi risultati al primo colpo.