Home › Per iniziare
Per iniziare

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-service

Linux (potrebbe chiederti la password):

./codelux install-service

Se vuoi solo provarlo, o su macOS: avvialo invece da un terminale (codelux.exe start su Windows):

./codelux start

Il 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

  1. In un terminale, installa il plugin:
    claude plugin marketplace add codeluxai/codelux
    claude plugin install codelux@codelux
    oppure, dentro Claude Code, scrivi /plugin marketplace add codeluxai/codelux e poi /plugin install codelux@codelux.
  2. Riavvia Claude Code nella cartella del progetto. D'ora in poi la memoria del progetto viene caricata a ogni avvio di sessione.
  3. Scrivi /codelux:status per 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

  1. Aggiungi Codelux AI ai server MCP di Codex con questo indirizzo (la documentazione di Codex dice dove):
    http://localhost:8766/mcp
  2. 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.json in .codex/hooks.json nel tuo progetto (o nella tua cartella home per ogni progetto) e sostituisci al suo interno CODELUX_PLUGIN con il percorso completo della cartella del plugin.
  3. Riavvia Codex. Legge anche la sezione Codelux AI dell'AGENTS.md del 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

  1. Aggiungi Codelux AI ai server MCP di Gemini CLI con questo indirizzo (la documentazione di Gemini CLI dice dove):
    http://localhost:8766/mcp
  2. Per la memoria automatica e la protezione delle modifiche: dalla cartella del plugin (github.com/codeluxai/codelux), unisci la parte hooks di hooks/gemini.settings.json in .gemini/settings.json nel tuo progetto, sostituendo CODELUX_PLUGIN con il percorso completo della cartella del plugin.
  3. Gemini legge GEMINI.md: nelle sue impostazioni, imposta contextFileName su AGENTS.md così legge anche la sezione Codelux AI.

Su Windows serve Git Bash. Alcuni dettagli non sono ancora confermati dalla documentazione di Gemini CLI.

Cursor Collegato

  1. Crea o apri .cursor/mcp.json nel tuo progetto (o ~/.cursor/mcp.json per ogni progetto) e aggiungi Codelux AI accanto agli eventuali server già presenti:
    {
      "mcpServers": {
        "codelux": { "url": "http://localhost:8766/mcp" }
      }
    }
  2. Riavvia Cursor, oppure ricarica i suoi server MCP.
  3. 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

  1. Crea o apri .vscode/mcp.json nel tuo workspace e aggiungi:
    {
      "servers": {
        "codelux": { "type": "http", "url": "http://localhost:8766/mcp" }
      }
    }
  2. Ricarica VS Code; gli strumenti compaiono nella modalità agente della chat.

Windsurf Collegato

  1. Apri ~/.codeium/windsurf/mcp_config.json e aggiungi:
    {
      "mcpServers": {
        "codelux": { "serverUrl": "http://localhost:8766/mcp" }
      }
    }
  2. Riavvia Windsurf.

JetBrains Collegato

  1. Settings › Tools › AI Assistant › Model Context Protocol › Add server.
  2. Usa questo indirizzo:
    http://localhost:8766/mcp

Zed Collegato

  1. 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

  1. Nelle impostazioni MCP del tuo strumento (vedi la sua documentazione), aggiungi un server con questo indirizzo:
    http://localhost:8766/mcp
  2. 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.