Dal download a un'AI collegata in pochi minuti
Quattro passaggi: installa Codelux AI, accedi, aggiungi il tuo progetto, collega il tuo strumento AI. Se preferisci, la tua AI può fare da sola quasi tutto l'ultimo passaggio.
Scarica e avvia Codelux AI
Scarica la versione Free dalla pagina di download (Windows, macOS, Linux). Con Multi o Team, scarica la tua versione personale dalla Console, in Il mio account › Download. Estrai lo ZIP in una cartella a tua scelta.
Consigliato: installalo come servizio in background, così parte con il computer ed è sempre disponibile per la tua AI. Dalla cartella che hai estratto:
Windows, in un terminale aperto come Amministratore:
codelux.exe install-serviceLinux (potrebbe chiederti la password):
./codelux install-serviceSe vuoi solo provarlo, o su macOS: avvialo invece da un terminale (codelux.exe start su Windows):
./codelux startIl sistema potrebbe avvisarti la prima volta, perché l'app non è ancora firmata: su Windows scegli Ulteriori informazioni › Esegui comunque; su macOS fai clic destro sull'app e scegli Apri. All'avvio mostra l'indirizzo della sua dashboard (di solito http://localhost:8766): aprilo nel browser.
Accedi, oppure inizia con Free
Nell'app crea il tuo account gratuito o accedi. Free non richiede carta di credito e non ha limiti di tempo: un progetto attivo per computer, tutte le funzioni. Multi e Team sbloccano più progetti e i tuoi colleghi, sullo stesso account.
Aggiungi il tuo progetto
Nell'app apri Progetti, fai clic su + Aggiungi progetto e scegli la cartella del progetto su cui lavori. Codelux AI lo prepara da solo; un progetto grande può richiedere un po' di tempo. Con Free, aggiungere un secondo progetto significa cambiare quello attivo.
Collega il tuo strumento AI
Scegli il tuo qui sotto. Puoi collegarne più d'uno: condivideranno la stessa memoria del progetto.
Lascia fare alla tua AI. In Claude Code, dopo aver installato il plugin, chiedi semplicemente: «Configura Codelux AI per questo progetto.» Controlla che Codelux AI sia in esecuzione, che il tuo progetto sia aggiunto e che tutto risponda. Con qualsiasi altro strumento, chiedi alla tua AI di leggere la guida ufficiale su nuovo.codelux.ai/help e di collegarsi da sola; ti dirà se manca qualcosa. Non ha mai bisogno della tua password.
Configurazione per ogni strumento AI
Cosa supporta ciascuno è nella pagina Funziona con. Se hai cambiato l'indirizzo di Codelux AI nelle impostazioni, usa il tuo al posto di localhost:8766.
Claude Code Supporto completo
- In un terminale, installa il plugin:
oppure, dentro Claude Code, scrivi
claude plugin marketplace add codeluxai/codelux claude plugin install codelux@codelux/plugin marketplace add codeluxai/codeluxe poi/plugin install codelux@codelux. - Riavvia Claude Code nella cartella del progetto. D'ora in poi la memoria del progetto viene caricata a ogni avvio di sessione.
- Scrivi
/codelux:statusper verificare che sia collegato.
Su Windows il plugin richiede Git Bash installato. Se Codelux AI non è in esecuzione, il plugin resta semplicemente in silenzio.
Codex Sperimentale
- Aggiungi Codelux AI ai server MCP di Codex con questo indirizzo (la documentazione di Codex dice dove):
http://localhost:8766/mcp - Per la memoria automatica e la protezione delle modifiche: prendi la cartella del plugin da github.com/codeluxai/codelux, copia il suo
hooks/codex.hooks.jsonin.codex/hooks.jsonnel tuo progetto (o nella tua cartella home per ogni progetto) e sostituisci al suo internoCODELUX_PLUGINcon il percorso completo della cartella del plugin. - Riavvia Codex. Legge anche la sezione Codelux AI dell'
AGENTS.mddel tuo progetto.
Su Windows serve Git Bash. Alcuni dettagli della configurazione di Codex non sono ancora confermati: se uno non corrisponde, quel passaggio non fa nulla e non ti blocca mai.
Gemini CLI Sperimentale
- Aggiungi Codelux AI ai server MCP di Gemini CLI con questo indirizzo (la documentazione di Gemini CLI dice dove):
http://localhost:8766/mcp - Per la memoria automatica e la protezione delle modifiche: dalla cartella del plugin (github.com/codeluxai/codelux), unisci la parte
hooksdihooks/gemini.settings.jsonin.gemini/settings.jsonnel tuo progetto, sostituendoCODELUX_PLUGINcon il percorso completo della cartella del plugin. - Gemini legge
GEMINI.md: nelle sue impostazioni, impostacontextFileNamesuAGENTS.mdcosì legge anche la sezione Codelux AI.
Su Windows serve Git Bash. Alcuni dettagli non sono ancora confermati dalla documentazione di Gemini CLI.
Cursor Collegato
- Crea o apri
.cursor/mcp.jsonnel tuo progetto (o~/.cursor/mcp.jsonper ogni progetto) e aggiungi Codelux AI accanto agli eventuali server già presenti:{ "mcpServers": { "codelux": { "url": "http://localhost:8766/mcp" } } } - Riavvia Cursor, oppure ricarica i suoi server MCP.
- Facoltativo: aggiungi una regola di Cursor che chiede all'agente di leggere la memoria di Codelux AI quando parte e di salvarla quando finisce.
VS Code Collegato
- Crea o apri
.vscode/mcp.jsonnel tuo workspace e aggiungi:{ "servers": { "codelux": { "type": "http", "url": "http://localhost:8766/mcp" } } } - Ricarica VS Code; gli strumenti compaiono nella modalità agente della chat.
Windsurf Collegato
- Apri
~/.codeium/windsurf/mcp_config.jsone aggiungi:{ "mcpServers": { "codelux": { "serverUrl": "http://localhost:8766/mcp" } } } - Riavvia Windsurf.
JetBrains Collegato
- Settings › Tools › AI Assistant › Model Context Protocol › Add server.
- Usa questo indirizzo:
http://localhost:8766/mcp
Zed Collegato
- Apri le impostazioni di Zed e, sotto
context_servers, aggiungi Codelux AI con questo indirizzo:http://localhost:8766/mcp
Qualsiasi altro strumento che supporti MCP Collegato
- Nelle impostazioni MCP del tuo strumento (vedi la sua documentazione), aggiungi un server con questo indirizzo:
http://localhost:8766/mcp - Codelux AI deve girare sullo stesso computer dello strumento.
Verifica che funzioni
Chiedi alla tua AI: «Cosa ricordi di questo progetto da Codelux AI?» Su un progetto nuovo risponde che non c'è ancora memoria — va bene così. Alla fine del primo compito, chiedile di salvare le sue note; la sessione successiva partirà da quelle.
- Gli strumenti non compaiono? Probabilmente Codelux AI non era in esecuzione quando hai aperto il tuo strumento AI: avvialo, poi riavvia lo strumento.
- «Questa cartella non è indicizzata»? Aggiungi la cartella del progetto nell'app (passaggio 3).
- Sei bloccato? La guida ufficiale risponde alla maggior parte delle domande, oppure scrivici.
Pronto?
Free: un progetto, tutte le funzioni, nessun limite di tempo, nessuna carta di credito.