Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

AX Code Dokumentation

Status: Aktiv Geltungsbereich: öffentlich, aktueller Stand Zuletzt geprüft: 2026-10-09 Verantwortlich: Betreuende von AX Code

AX Code ist eine Laufzeit für Coding-Agenten für prüfbare, umkehrbare Arbeit: Jede Sitzung wird als strukturiertes Ereignisprotokoll mit Datei-Snapshots aufgezeichnet, Kandidatenimplementierungen lassen sich gegen die eigenen Prüfungen Ihres Repositorys verifizieren, und nichts wird automatisch zusammengeführt. Warum AX Code erklärt, worauf das optimiert, für wen es gedacht ist und was es bewusst nicht behauptet.

Die README im Stammverzeichnis ist der kürzeste Weg, AX Code zu installieren und zu starten. Nutzen Sie diese Übersicht, wenn Sie einen Ablauf konfigurieren, eine Laufzeitgrenze verstehen oder AX Code mit einem anderen System integrieren möchten.

Interne Prozessunterlagen (PRDs, ADRs, Spezifikationen, Roadmaps, Umsetzungspläne, Wettbewerbsprüfungen und Arbeitsdateien von Audits) liegen unter .internal/, nicht in diesem öffentlichen Baum — siehe unten „Grenzen der Dokumentation“. Die öffentlichen Seiten sind die hier verlinkten.

Öffentliche Website: ax-code.app/de/docs/. Für bestehende Installationen beginnen Sie mit Aktualisierung und Wiederherstellung. Quellzugriff und öffentliche Downloads sind getrennt; siehe Quellzugriff.

Nach Aufgabe wählen

Für die optionale gemeinsame Terminalnavigation über einen externen MCP-Client siehe Eine laufende TUI über MCP teilen.

Für die experimentelle Browserbrücke (Seiten lesen, optional klicken und ausfüllen) siehe WebMCP-Browserbrücke.

Für eigenständige Fragen zu ausgewählten Dateien über den Cache von AX Trust siehe Fragen mit festem Kontext.

Ich möchte …	Hier beginnen
Entscheiden, ob AX Code zu meiner Arbeit passt	Warum AX Code
AX Code verstehen, bevor ich es installiere	Hier starten
Prüfen, vergleichen oder rückgängig machen, was ein Agent getan hat	Ausführungsnachweise
Mehrere Modelle denselben Änderungsversuch machen lassen	Geprüfte Änderungen mit mehreren Modellen
Einen Installations- oder Laufzeitkanal wählen	Installation und Laufzeitkanäle
Einen gehosteten, CLI-, eigenen oder lokalen Anbieter verbinden	Unterstützte Anbieter und Modelle
Verwaltete lokale Inferenz auf Apple Silicon aktivieren	Modellauswahl für AX Engine
Die aktuellen Geschwindigkeitszahlen von Tiel gegenüber MTPLX lesen	Tiel-Vergleich (20 September 2026)
AX Code mit einer kostenlosen Modell-API ausprobieren	Schnelleinstieg für kostenlose APIs
Einen Agenten mit sicheren Grenzen für Dateisystem und Netzwerk ausführen	Sandbox-Modus
Cloud- oder Netzwerkinfrastruktur sicher verwalten	Cloud-Betriebsmodus
Unbeaufsichtigt oder in CI ausführen	Autonomer Modus
Die einmalige CLI `ax-code run` aus Skripten oder CI aufrufen	Headless-CLI
Wiederkehrende Prompts ausführen oder dauerhafte Aufgaben planen	Loop-Modus und geplante Aufgaben
Einen Ton oder eine gesprochene Meldung hören, wenn ein Lauf Aufmerksamkeit braucht	Akustische Hinweise
Geplante Arbeit über das Ende von Prozess oder Host hinweg laufen lassen	Lang laufende Vorgänge
Ausführung als local, cloud, hybrid, council oder arena wählen	Ausführungsmodi
Externe Werkzeuge und Daten verbinden	MCP-Integrationen
Den Agenten in Chrome über WebMCP lesen und handeln lassen	WebMCP-Browserbrücke
AX Code in eine Anwendung einbetten	`@defai-digital/ax-code-sdk`
Einen Client für eine andere Sprache erzeugen	Kompatibilität mit HTTP und OpenAPI
Einen Desktop- oder nativen Host bauen	Nativer SDK-Transport

Erste Schritte

Standard und Business — quelloffenes Standard, kostenlose kommerzielle Nutzung, geplantes proprietäres Business und der Status des öffentlichen Zugangs.
Warum AX Code — worauf AX Code optimiert, die vorgesehene Zielgruppe, worin es sich unterscheidet und was es nicht behauptet.
Hier starten — mentales Modell des Produkts und die kürzesten Wege nach Anwendungsfall.
Installation und Laufzeitkanäle — unterstützte Plattformen, Pakete, Aktualisierungen und Startprogramme für Mitwirkende.

Laufzeitleitfäden

Visualisierung von Wiki-Nachweisen — öffnen Sie einen lokalen Graphen aufgezeichneter Beziehungen zwischen Wiki-Seiten und Quellen oder exportieren Sie HTML für die Offline-Nutzung. Enthält Screenshots für Radialansicht, Kräfteansicht und Seitenfokus aus dem eigenen Wiki von AX Code.
Gesprächsrückblick — holen Sie jüngere Arbeit mit /recap nach und konfigurieren Sie Hinweise bei Untätigkeit.
Akustische Hinweise — Systemtöne und optionale gesprochene Meldungen, wenn ein Lauf Ihre Aufmerksamkeit braucht.
Ausführungsnachweise — Graph, Vergleich, Wiedergabe, Risiko, Rollback, Branch, Ablaufverfolgung und Audit-Export.
Geprüfte Änderungen mit mehreren Modellen — der Ablauf von Council und Arena von Anfang bis Ende.
Sandbox-Modus — Isolationsmodi, geschützte Pfade, Netzwerksteuerung und Vorrang.
Cloud-Betriebsmodus — Ablauf Planen/Genehmigen/Anwenden, Genehmigungstokens und die Haltung des Agenten cloudops.
Autonomer Modus — unbeaufsichtigte Ausführung, Genehmigungen, Nutzung ohne Oberfläche und Schutzmaßnahmen.
Headless-CLI — der einmalige Befehl ax-code run für Skripte, CI und aufrufende Agenten.
TUI-Sprachen und Einrichtung — Sprachen für Oberfläche und Gespräch, Ersteinrichtung.
TUI-Animationen — Paare für Beginn und Ende, Fähigkeiten des Terminals und Ausweichdarstellung.
Loop-Modus und geplante Aufgaben — wiederkehrende Prompts, dauerhafte Zeitpläne und Grenzen für lange Läufe.
Lang laufende Vorgänge — Beispiele für beaufsichtigte Dienste, Semantik der Wiederherstellung und betriebliche Prüfungen.
Ausführungsmodi — Verhalten von Agent, Hybrid, Council und Arena.
Bewährte Praxis für die Weiterleitung über mehrere Modelle — trennen Sie hochwertiges Reasoning und günstigere Unterstützungsarbeit, ohne Aufgaben mit empfindlicher Korrektheit stillschweigend zu schwächen.
Modellauswahl und Wiederherstellung — genaue Modellauswahl, ausdrückliche Rückfallkonfiguration und Diagnose.
Automatische Weiterleitung — Routing für Spezialisten und optionales Routing nach Komplexität.
Modellaufwand — Denkstufen und anbieterspezifisches Verhalten.
Leistung — Profile der Coding-Werkzeuge und Diagnose der lokalen Anfragezeiten.
Speicherverbrauch — Speicherprofile, Aufbewahrung des Cache und Grenzen für die Hintergrundausgabe.
Lokaler Nachweis-Cache — optionale Wiederverwendung von Nachweisen mit SQLite und RocksDB, Qualifikation und Rollback.
Lebenszyklus-Hooks — Hook-Ereignisse und gebündelte Richtlinienpakete.
Laufbericht — Nutzung des Arbeitsbereichs, Aktivität, Aufschlüsselung nach Modell und Werkzeug sowie Berichte je Sitzung.

Anbieter

Unterstützte Anbieter und Modelle — Anbieterkennungen, Zugangsdaten und Modellermittlung.
Schnelleinstieg für kostenlose APIs — kompatible kostenlose Wege, Grenzen und sichere Bewertung.
Eigene Anbieter und Gateways — mit OpenAI und Anthropic kompatible Endpunkte.
Einrichtung von MTPLX und oMLX — lokale Voreinstellungen aus dem Quell-Checkout, Ermittlung, Werkzeuge und Authentifizierung.
Tiel-Vergleich (20 September 2026) — aktuelle Zahlen der nativen API für Tiel und Cyber-Tiel gegenüber MTPLX; Abschluss-Voreinstellung 194.88, Spitzen-Decode 249.01.
Erneute Client-Prüfung von AX Code und OpenCode — sechs Kombinationen aus Client und Laufzeit, aktives MTP, Zeiten für den ersten und den wiederholten Lauf sowie Codeprüfungen.
Messungen der lokalen Inferenz — datierte Prüfungen von AX Code und OpenCode sowie der Laufzeit, mit Zeiten und Grenzen der Vergleichbarkeit.
Modellauswahl für AX Engine — Rangfolge lokaler Modelle und Hinweise zum Speicher.

Integrationen

MCP-Integrationen — Vertrauen, Berechtigungen, Ressourcen und Serversicherheit.
ACP — der direkte Weg des Agent Client Protocol für IDE-Hosts.
AX Wiki — quellgestütztes Wissen zum Repository und CI-Workflow.
Integration in VS Code — Befehle, Einstellungen und Abläufe im Editor. Installation über den Marketplace-Eintrag.

SDK und Dienstgrenzen

@defai-digital/ax-code-sdk — offizielle Einbettung für TypeScript und JavaScript.
Nativer SDK-Transport — an gRPC angelehnte Grenze für Desktop und native Hosts sowie Rückfallverhalten.
Kompatibilität mit HTTP und OpenAPI — Servermodus und erzeugte Clients für andere Sprachen.
OpenAPI-Snapshot — maßgeblicher Vertrag für HTTP-Routen und Schema.

Architektur und Zuverlässigkeit

Semantische Schicht — Herkunft von Graph und LSP, Audit und Grenzen der Wiedergabe.
Architektur der lokalen Engine — warum AX Code einen Sidecar von AX Engine verwendet.
Laufzeitstabilität — Verträge zu Abbruch, Absturz, Stream, Timeout und Zuverlässigkeit der TUI.

Referenz

JSON-Schema der Konfiguration — erzeugter Eingabevertrag der Konfiguration.
Native TypeScript-Unterstützung — Quellcompiler, Language Service, Diagnosen und Kompatibilität.
Katalog der Skills und Plugins — gebündelte Skills, Projekt-Skills, Plugins und Auswertungen.
Isolations-Richtlinienpakete — maschinenlesbare Richtlinienbeispiele.
Prüfung von Veröffentlichungen — kanonischer öffentlicher Minisign-Schlüssel und Prüfbefehl.
Laufzeitintegrität unter Windows — Signaturen, Prüfung installierter Dateien und Nachweise zu Antivirenprogrammen.
Sicherheitsrichtlinie — Bedrohungsmodell, Speicherung von Zugangsdaten und unterstützte Versionen.

Grenzen der Dokumentation

docs/ enthält öffentliche Anleitung zu Verhalten, das in einer veröffentlichten Laufzeit vorhanden ist. Planungsmaterial, Release-Ziele, Umsetzungspolitik und vorläufige Analysen gehören nicht hierher:

Inhalt	Ort
Architekturentscheidungen	`.internal/adr/`
Produktanforderungen und technische Spezifikationen	`.internal/prd/` und `.internal/spec/`
Roadmaps, Umsetzungspläne, Release-Ziele, Prüfungen und Audits	`.internal/reports/`
Veröffentlichtes Verhalten und öffentliche Integrationsanleitung	`docs/`

Jede öffentliche Markdown-Seite sollte oben Status, Geltungsbereich, Datum der letzten Prüfung und die verantwortliche Stelle nennen. Bevorzugen Sie Links auf erzeugte Verträge oder Implementierungsquellen gegenüber kopierten Routenlisten und anderen schnell veraltenden Snapshots.

Checkliste für die Pflege

Vor einer Veröffentlichung oder einer wesentlichen Änderung der Dokumentation:

Prüfen Sie Befehle, Voreinstellungen, Flags, Anbieterkennungen und Laufzeitkennungen gegen ihre Implementierung.
Aktualisieren Sie den engsten maßgeblichen Leitfaden, statt dasselbe Verhalten auf mehreren Einstiegsseiten zu wiederholen.
Führen Sie pnpm run test:scripts aus, um defekte lokale Links, verwaiste Seiten und fehlende Seitenmetadaten zu finden.
Aktualisieren Sie das genehmigte Exportmanifest und führen Sie node script/export-public-docs.mjs --website /path/to/ax-code.app aus, danach die Prüfung der Website, den Build und die Smoke-Prüfungen für Workers. Builds der Website verwenden den festgeschriebenen Snapshot und benötigen keinen Quellzugriff. Neue öffentliche Seiten und Assets müssen im Manifest ausdrücklich genehmigt sein.
Belassen Sie Vorschläge, Notizen zur Projektentwicklung, Release-Ziele und historische Entscheidungsunterlagen unter .internal/, nicht in der öffentlichen Navigation.