3d (edited) • AI Tools
🚀 Setup GRATIS: Claude Code + OpenRouter (Guida Completa)
In questa guida vediamo come usare **Claude Code GRATIS** utilizzando **OpenRouter** e modelli free.
Trovate il setup nel file md allegato.
🚀 Usa Claude Code GRATIS con OpenRouter
Guida completa passo per passo — nessun abbonamento Anthropic richiesto
💡 Cos'è OpenRouter?
OpenRouter è un aggregatore di modelli AI: ti dà un'unica API per accedere a decine di modelli diversi (GPT-4, Claude, Llama, Mistral, Gemini…) senza doverti registrare su ogni singola piattaforma.
Alcuni modelli sono a pagamento, ma molti sono completamente gratuiti con un limite giornaliero. Il trucco è usare proprio questi con Claude Code, che normalmente richiede un piano Anthropic a pagamento.
⏱ Tempo stimato: 5 minuti | 💰 Costo: 0 euro | 📦 Requisiti: Node.js installato + account OpenRouter gratuito
00 — Registrati su OpenRouter
Vai su openrouter.ai, clicca su Sign Up e crea un account gratuito.
Non serve inserire una carta di credito per usare i modelli free.
01 — Crea la tua API Key
Vai su openrouter.ai/keys → clicca Create Key → dai un nome a piacere → copia la chiave che appare.
sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxx
⚠️ Copiala subito: non la rivedrai più dopo aver chiuso la finestra.
02 — Scegli un modello gratuito e copia il suo ID
Vai su openrouter.ai/models → filtra per Free → clicca su un modello → copia il suo ID completo dalla pagina del modello.
Il formato è sempre: autore/nome-modello:free
Il suffisso :free alla fine è obbligatorio — senza di esso il modello diventa a pagamento e ricevi un errore 402.
Esempi consigliati per il coding:
meta-llama/llama-3.3-70b-instruct:free ← ottimo per coding
mistralai/mistral-7b-instruct:free ← leggero e veloce
nousresearch/hermes-3-llama-3.1-405b:free ← molto potente
google/gemma-3-27b-it:free ← da Google
03 — Crea la cartella .claude nel tuo progetto
Apri il terminale nella cartella del progetto ed esegui:
mkdir .claude
Su Windows (PowerShell):
New-Item -ItemType Directory -Path ".claude"
04 — Crea il file di configurazione
touch .claude/settings.local.json
Su Windows (PowerShell):
New-Item -ItemType File -Path ".claude/settings.local.json"
05 — Incolla la configurazione nel file
Apri .claude/settings.local.json con qualsiasi editor di testo e incolla questo contenuto, sostituendo i valori indicati:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-INSERISCI-LA-TUA-CHIAVE",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_MODEL": "meta-llama/llama-3.3-70b-instruct:free"
},
"permissions": {
"allow": [
"WebSearch"
]
}
}
Spiegazione di ogni campo:
ANTHROPIC_AUTH_TOKEN → la tua API key di OpenRouter (quella che inizia con sk-or-v1-)
ANTHROPIC_API_KEY → lascia vuoto con "". Serve solo per non far andare in errore Claude Code
ANTHROPIC_MODEL → l'ID completo del modello scelto al passo 02, con il suffisso :free
ANTHROPIC_BASE_URL → l'endpoint di OpenRouter — non modificare
06 — Struttura finale del progetto
tuo-progetto/
├── .claude/
│ └── settings.local.json ✓
├── src/
└── ...
07 — Avvia Claude Code e verifica
Dal terminale, nella cartella del progetto:
claude
Per verificare che funzioni, scrivi nel prompt:
Dimmi che modello stai usando
Ti risponderà con il nome del modello OpenRouter configurato.
⚠️ Errori comuni
✗ Dimenticare :free alla fine del nome modello — diventa a pagamento (errore 402)
✗ Usare virgolette tipografiche (" ") invece di quelle dritte (" ") — il JSON non viene parsato
✗ Aggiungere commenti nel JSON (// commento) — il formato JSON non li supporta
✗ Copiare un ID modello sbagliato — controlla sempre su openrouter.ai/models
✗ Mettere la cartella .claude fuori dalla cartella del progetto — vale solo per quel progetto
Hai problemi con il setup? Scrivi nei commenti con l'errore che vedi — ti aiuto 👇
#claudecode #openrouter #AIgratis #coding #llm
Fatemi sapere che ne pensate.
0
0 comments
🚀 Setup GRATIS: Claude Code + OpenRouter (Guida Completa)
powered by
skool.com/enzo-di-roma-3126
Community del canale TechTonic per creare siti, UI e progetti digitali con l’AI. Workflow reali, prompt, tool e test su Antigravity.
Suggested communities
Powered by