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

Documentazione di AX Code

Stato: Attivo Ambito: pubblico, stato attuale Ultima revisione: 2026-10-09 Responsabile: responsabili di AX Code

AX Code è un runtime di agente di programmazione per lavoro revisionabile e reversibile: ogni sessione è registrata come un log di eventi strutturato con istantanee dei file, le implementazioni candidate possono essere verificate contro i controlli propri del repository, e niente viene unito in automatico. Perché AX Code spiega che cosa questo ottimizza, a chi si rivolge e che cosa di proposito non afferma.

Il README alla radice è il percorso più breve per installare e avviare AX Code. Usa questo hub quando devi configurare un flusso, capire un confine di runtime o integrare AX Code con un altro sistema.

I registri di processo interni (PRD, ADR, specifiche, roadmap, piani di implementazione, revisioni competitive e file di lavoro di audit) vivono sotto .internal/, non in questo albero pubblico: vedi «Confini della documentazione» sotto. Le pagine pubbliche sono quelle collegate qui.

Sito pubblico: documentazione su ax-code.app. Per le installazioni esistenti, parti da Aggiornamento e recupero. L’accesso ai sorgenti e i download pubblici sono separati; vedi Accesso ai sorgenti.

Scegli per compito

Per la navigazione condivisa del terminale su adesione, tramite un client MCP esterno, vedi Condividere una TUI attiva tramite MCP.

Per il ponte sperimentale del browser (leggere pagine, e in opzione fare clic e compilare), vedi Ponte browser WebMCP.

Per domande autonome su file selezionati tramite la cache di AX Trust, vedi Domande a contesto fisso.

Per iniziare

• Standard e Business — Standard open source, uso commerciale gratuito, Business proprietario pianificato e stato dell’accesso pubblico.

• Perché AX Code — che cosa ottimizza AX Code, il pubblico previsto, in che cosa differisce e che cosa non afferma.

• Inizia qui — modello mentale del prodotto e i percorsi più brevi per caso d’uso.

• Canali di installazione e runtime — piattaforme supportate, pacchetti, aggiornamenti e launcher per chi contribuisce.

Guide di runtime

• Visualizzazione dell’evidenza Wiki — apri un grafo locale delle relazioni registrate tra pagine e fonti Wiki, oppure esporta HTML offline. Include schermate radiali, di forza e di focus sulla pagina, dal wiki proprio di AX Code.
• Riepilogo della conversazione — rimettiti in pari sul lavoro recente con /recap e configura i banner di inattività.
• Notifiche audio — suoni di sistema e avvisi vocali su adesione quando un’esecuzione ha bisogno della tua attenzione.
• Evidenza di esecuzione — grafo, confronto, replay, rischio, rollback, ramo, traccia ed esportazione di audit.
• Modifiche multi-modello verificate — il flusso council e arena da capo a fondo.
• Modalità sandbox — modalità di isolamento, percorsi protetti, controlli di rete e precedenza.
• Modalità operazioni cloud — flusso piano/approvazione/applicazione, token di approvazione e postura dell’agente cloudops.
• Modalità autonoma — esecuzione non presidiata, approvazioni, uso senza interfaccia e tutele.
• CLI senza interfaccia — il comando una tantum ax-code run per script, CI e chiamanti agente.
• Lingue e configurazione della TUI — lingue dell’interfaccia e della conversazione, prima configurazione.
• Animazioni della TUI — coppie di apertura e chiusura, capacità del terminale e ripieghi di rendering.
• Modalità loop e compiti pianificati — prompt ricorrenti, pianificazioni durevoli e limiti delle esecuzioni lunghe.
• Operazioni di lunga durata — esempi di servizio supervisionato, semantica di recupero e controlli operativi.
• Modalità di esecuzione — comportamento di agente, ibrido, council e arena.
• Buone pratiche di instradamento multi-modello — separa il ragionamento premium e il lavoro di supporto a costo più basso senza indebolire in silenzio i compiti sensibili alla correttezza.
• Recupero del modello — selezione esatta del modello, configurazione esplicita del fallback e diagnostica.
• Auto-Route — instradamento degli specialisti e instradamento facoltativo per complessità.
• Sforzo del modello — livelli di pensiero e comportamento specifico del provider.
• Prestazioni — profili di strumenti di programmazione e diagnostica locale dei tempi di richiesta.
• Uso della memoria — profili di memoria, conservazione della cache e limiti dell’output in background.
• Cache di evidenza locale — riuso facoltativo di evidenza SQLite e RocksDB, qualificazione e rollback.
• Hook del ciclo di vita — eventi degli hook e pacchetti di policy inclusi.
• Report di esecuzione — utilizzo del workspace, attività, ripartizioni di modello e strumenti, e report per sessione.

Provider

• Provider e modelli supportati — ID dei provider, credenziali e scoperta dei modelli.
• Avvio rapido delle API del livello gratuito — percorsi senza costo compatibili, vincoli e valutazione sicura.
• Provider personalizzati e gateway — endpoint compatibili con OpenAI e Anthropic.
• Configurazione di MTPLX e oMLX — preset locali da checkout dei sorgenti, scoperta, strumenti e autenticazione.
• Sintesi dei pari di Tiel (20 settembre 2026) — numeri attuali dell’API nativa di Tiel / Cyber-Tiel rispetto a MTPLX; predefinito di completamento 194.88, picco di decodifica 249.01.
• Ritest del client AX Code/OpenCode — sei combinazioni di client e runtime, MTP attivo, tempi di prima esecuzione e di ripetizione, e controlli del codice.
• Misure di inferenza locale — test datati di AX Code/OpenCode e del runtime, con tempi e limiti di comparabilità.
• Selezione dei modelli di AX Engine — classifica dei modelli locali e guida alla memoria.

Integrazioni

• Integrazioni MCP — fiducia, autorizzazioni, risorse e sicurezza dei server.
• ACP — il percorso di successo di Agent Client Protocol per gli host IDE.
• AX Wiki — conoscenza del repository ancorata alle sorgenti e flusso CI.
• Integrazione VS Code — comandi dell’editor, impostazioni e flussi. Installa dalla scheda del marketplace.

SDK e confini di servizio

• @defai-digital/ax-code-sdk — incorporamento di prima parte in TypeScript e JavaScript.
• Trasporto SDK nativo — confine desktop/nativo a forma di gRPC e comportamento di ripiego.
• Compatibilità HTTP e OpenAPI — modalità server e client generati per altri linguaggi.
• Istantanea OpenAPI — contratto autorevole di route HTTP e di schema.

Architettura e affidabilità

• Livello semantico — provenienza di grafo e LSP, audit e confini di replay.
• Architettura del motore locale — perché AX Code usa un sidecar di AX Engine.
• Stabilità del runtime — contratti di annullamento, crash, flusso, timeout e affidabilità della TUI.

Riferimento

• Schema JSON della configurazione — contratto generato di input della configurazione.

• Supporto nativo di TypeScript — compilatore dei sorgenti, servizio di linguaggio, diagnostica e compatibilità.

• Catalogo di skill e plugin — skill incluse, skill di progetto, plugin e valutazioni.

• Pacchetti di policy di isolamento — esempi di policy leggibili dalla macchina.

• Verifica del rilascio — chiave pubblica Minisign canonica e comando di verifica.

• Integrità del runtime Windows — firme, verifica dei file installati ed evidenza antivirus.

• Policy di sicurezza — modello delle minacce, conservazione delle credenziali e versioni supportate.

Confini della documentazione

docs/ contiene la guida pubblica per il comportamento che esiste in un runtime rilasciato. Materiale di pianificazione, obiettivi di rilascio, policy di implementazione e analisi temporanee non appartengono a questo posto:

Ogni pagina Markdown pubblica dovrebbe dichiarare in alto stato, ambito, data dell’ultima revisione e responsabile. Preferisci i collegamenti ai contratti generati o alle sorgenti di implementazione, invece di elenchi di route copiati e di altre istantanee ad alta deriva.

Lista di controllo della manutenzione

Prima di un rilascio o di un cambiamento sostanziale della documentazione:

1. Verifica comandi, predefiniti, flag, ID dei provider ed etichette di runtime rispetto alla loro implementazione.
2. Aggiorna la guida autorevole più stretta, invece di ripetere lo stesso comportamento in più pagine di ingresso.
3. Esegui pnpm run test:scripts per cogliere collegamenti locali rotti, pagine orfane e metadati di pagina mancanti.
4. Aggiorna il manifesto di esportazione approvato ed esegui node script/export-public-docs.mjs --website /path/to/ax-code.app, poi esegui il controllo del sito, la build e le prove dei Workers. Le build del sito usano l’istantanea committata e non richiedono accesso ai sorgenti. Le nuove pagine e gli asset pubblici devono essere approvati in modo esplicito nel manifesto.
5. Tieni proposte, note di sviluppo del progetto, obiettivi di rilascio e registri storici delle decisioni sotto .internal/, non nella navigazione pubblica.