Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese

Inizia qui

Stato: Attivo Ambito: stato attuale Ultima revisione: 2026-09-16 Responsabile: runtime di ax-code

Se il README alla radice è il modo più rapido per installare AX Code, questa pagina è il modo più rapido per capirlo.

Edizioni e disponibilità

Parti da AX Code Standard, l’edizione open source gratuita per l’uso personale e commerciale. Usa modelli locali o cloud; AX Engine fornisce un percorso di inferenza locale nativo sui Mac Apple Silicon supportati. Autorizzazioni esistenti, revisione delle modifiche ed evidenza di esecuzione locale restano capacità di base.

Business è un’offerta proprietaria pianificata per la governance dell’organizzazione tramite AX Trust e per i flussi aziendali tramite AutomatosX. Usare Standard al lavoro non richiede di per sé una licenza Business. Vedi Standard e Business per i dettagli.

Installer firmati e archivi di runtime sono disponibili in modo anonimo da download.ax-code.com. Leggi la guida di installazione e la guida di aggiornamento e recupero. La documentazione tecnica pubblica è ospitata su ax-code.app, documentazione, in modo indipendente dall’accesso ai sorgenti. Già installato? Apri un terminale nel progetto, esegui ax-code, poi usa /connect dentro la TUI per scegliere un provider. Inizia con una domanda sul progetto, chiedi una piccola modifica e revisiona il diff e i controlli del progetto prima del commit. Usa ax-code doctor se il runtime installato ha bisogno di diagnosi.

Che cos'è AX Code

AX Code è un runtime di programmazione con IA. Combina:

• agenti per compiti di programmazione diversi
• esecuzione esplicita degli strumenti
• selezione di modello e provider
• stato di sessione persistente
• isolamento e autorizzazioni configurabili
• superfici di integrazione come la TUI, l’SDK, la modalità server e MCP

Conta perché la programmazione con IA è utile nei repository reali solo quando puoi controllare che cosa l’agente può fare, conservare il contesto tra le sessioni e riusare lo stesso flusso fuori da una sola finestra di chat.

Da dove viene il valore

AX Code ottimizza il momento dopo che l’agente ha finito: decidere se tenere ciò che ha prodotto.

• Evidenza. Ogni sessione è registrata come un log di eventi tipizzato più istantanee dei file, così ax-code graph, compare, replay, risk e audit possono ricostruire che cosa è successo dopo la fine della conversazione.
• Verifica. Dove una soglia è applicabile — candidati di arena, applicazione di un refactoring con soglia — sono i comandi propri del repository di typecheck, lint e test a decidere se un risultato è accettato.
• Reversibilità. Le istantanee sono recuperabili per passo, non solo per sessione, da un archivio di oggetti Git tenuto fuori dal repository.
• La tua decisione. AX Code classifica, assegna punteggi e riporta. Non fa il merge al posto tuo.

A sostegno di questo: strumenti espliciti con regole di autorizzazione e modalità di isolamento, sessioni durevoli, AGENTS.md per le convenzioni del repository, portabilità dei provider e un solo runtime dietro TUI, CLI, estensione VS Code, SDK, server senza interfaccia e integrazioni MCP. Sono fondamenta, non il motivo per scegliere AX Code: vedi Perché AX Code.

Per i comandi stessi, vedi Evidenza di esecuzione.

Modello mentale

Pensa ad AX Code come a cinque livelli:

1. Livello provider: scegli il backend di modello contro cui vuoi eseguire.
2. Livello agente: scegli l’agente giusto per il compito, oppure lascia che l’instradamento aiuti.
3. Livello strumenti: l’agente agisce tramite strumenti espliciti, non tramite capacità nascoste.
4. Livello sessione: conversazione, decisioni e stato persistono.
5. Livello di controllo: isolamento, autorizzazioni e comportamento di audit definiscono il confine.

Il resto della documentazione si appoggia su quei livelli.

Scegli il percorso successivo

Voglio provarlo in fretta

• Parti dal README alla radice per l’installazione e il primo avvio.
• I percorsi di installazione supportati usano il runtime compilato:
  • installer di rilascio Bash per macOS Apple Silicon e Linux: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • alternativa Homebrew per la CLI su macOS: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • installer di rilascio GitHub per Windows PowerShell: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• L’installer Bash non è il percorso canonico di configurazione su Windows.
• I pacchetti npm non sono più canali supportati di installazione o aggiornamento. Vedi Canali di installazione e runtime per la policy delle piattaforme, le etichette di runtime e la matrice del launcher locale.
• Usa /connect o ax-code providers login per impostare un modello. Vedi Provider e modelli supportati per i provider di API cloud, i provider CLI, AX Engine e gli ID dei modelli. Per un percorso di valutazione senza costo, usa l’avvio rapido delle API del livello gratuito.
• Esegui ax-code init dopo aver aperto un progetto reale, così AGENTS.md cattura le convenzioni locali.
• Se vuoi confini di sicurezza più stretti, attiva la modalità sandbox prima di modifiche più ampie.

Voglio usarlo in sicurezza in un repository di team o aziendale

• AX Code parte con la modalità autonoma accesa e la modalità sandbox spenta: full-access con filesystem e accesso alla rete senza restrizioni.
• Per lavoro di team, aziendale, non attendibile o non presidiato, attiva --sandbox workspace-write (o read-only) prima di iniziare il compito.
• Leggi Modalità sandbox per i confini di esecuzione.
• Leggi Modalità autonoma se l’agente girerà non presidiato.
• Leggi Policy di sicurezza per il modello delle minacce e i dettagli di conservazione delle credenziali.
• Leggi Livello semantico se provenienza e replay contano per il tuo flusso.

Voglio incorporarlo o automatizzarlo

• Usa i punti di ingresso senza interfaccia o gRPC di @defai-digital/ax-code-sdk per l’integrazione in app TypeScript.
• Usa Compatibilità HTTP e OpenAPI per un confine di servizio, client generati e il contratto OpenAPI autorevole.
• Usa ax-code mcp add quando l’agente ha bisogno di strumenti o servizi esterni.

Voglio capire il repository o dare un riscontro

• Leggi l’hub della documentazione per il resto della documentazione pubblica.
• Leggi CONTRIBUTING.md per la policy attuale di contributo esterno.

Quando AX Code può non essere adatto

AX Code è di proposito più del completamento automatico o di una chat ospitata. Può essere troppo se:

• Ti servono solo suggerimenti di codice in linea e non vuoi agenti che eseguono strumenti.
• Ti serve un’esperienza solo SaaS ospitata, senza runtime locale.
• Non ti servono persistenza di sessione, replay, integrazione SDK o server, né istruzioni a livello di repository.
• Lavori in un ambiente in cui non è consentito alcun processo CLI locale.

In quei casi un assistente di editor più leggero può essere più semplice. AX Code è più forte quando l’agente deve operare dentro flussi di sviluppo reali, con controllo, continuità e confini di integrazione.

Primi comandi comuni

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok gira esclusivamente tramite Grok Build CLI. Seleziona grok-build-cli in /connect; AX Code invoca il comando locale grok e riusa il suo accesso o la sua sessione CLI. Il precedente provider di API cloud diretto xai non è più supportato.

Mappa della documentazione