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

Hier starten

Status: Aktiv Geltungsbereich: aktueller Stand Zuletzt geprüft: 2026-09-16 Verantwortlich: ax-code runtime

Wenn die README im Stammverzeichnis der schnellste Weg ist, AX Code zu installieren, ist diese Seite der schnellste Weg, es zu verstehen.

Editionen und Verfügbarkeit

Beginnen Sie mit AX Code Standard, der quelloffenen Edition, die für die private und kommerzielle Nutzung kostenlos ist. Nutzen Sie lokale oder Cloud-Modelle; AX Engine bietet auf unterstützten Macs mit Apple Silicon einen nativen Weg für lokale Inferenz. Bestehende Berechtigungen, die Prüfung von Änderungen und lokale Ausführungsnachweise bleiben zentrale Fähigkeiten.

Business ist ein geplantes proprietäres Angebot für die Steuerung von Organisationen über AX Trust und für Geschäftsabläufe über AutomatosX. Standard bei der Arbeit zu nutzen erfordert für sich genommen keine Business-Lizenz. Einzelheiten stehen unter Standard und Business.

Signierte Installationsprogramme und Laufzeitarchive sind anonym verfügbar unter download.ax-code.com. Lesen Sie die Installationsanleitung und die Anleitung zu Aktualisierung und Wiederherstellung. Die öffentliche technische Dokumentation liegt unter ax-code.app/de/docs/, unabhängig vom Quellzugriff. Bereits installiert? Öffnen Sie ein Terminal in Ihrem Projekt, führen Sie ax-code aus und wählen Sie dann mit /connect in der TUI einen Anbieter. Beginnen Sie mit einer Frage zum Projekt, fordern Sie eine kleine Änderung an und prüfen Sie den Diff und die Projektprüfungen, bevor Sie committen. Verwenden Sie ax-code doctor, wenn die installierte Laufzeit eine Diagnose braucht.

Was AX Code ist

AX Code ist eine KI-Coding-Laufzeit. Sie verbindet:

• Agenten für unterschiedliche Programmieraufgaben
• ausdrückliche Werkzeugausführung
• Auswahl von Modell und Anbieter
• dauerhaften Sitzungszustand
• konfigurierbare Isolation und Berechtigungen
• Integrationsflächen wie TUI, SDK, Servermodus und MCP

Das ist wichtig, weil KI-Programmierung in echten Repositorys nur nützt, wenn Sie steuern können, was der Agent tun darf, den Kontext über Sitzungen hinweg bewahren und denselben Ablauf außerhalb eines einzelnen Chatfensters wiederverwenden können.

Woher der Nutzen kommt

AX Code optimiert den Moment danach, wenn der Agent fertig ist: die Entscheidung, ob Sie das Ergebnis behalten.

• Nachweise. Jede Sitzung wird als typisiertes Ereignisprotokoll plus Datei-Snapshots aufgezeichnet, sodass ax-code graph, compare, replay, risk und audit rekonstruieren können, was nach dem Ende des Gesprächs geschehen ist.
• Prüfung. Wo eine Schranke durchsetzbar ist — Arena-Kandidaten, angewandtes Refactoring hinter einer Schranke — entscheiden die eigenen Befehle Ihres Repositorys für Typprüfung, Lint und Test, ob ein Ergebnis angenommen wird.
• Umkehrbarkeit. Snapshots lassen sich je Schritt wiederherstellen, nicht nur je Sitzung, aus einem Git-Objektspeicher außerhalb Ihres Repositorys.
• Ihre Entscheidung. AX Code ordnet ein, bewertet und berichtet. Es führt für Sie nicht zusammen.

Dazu gehören ausdrückliche Werkzeuge mit Berechtigungsregeln und Isolationsmodi, dauerhafte Sitzungen, AGENTS.md für Konventionen des Repositorys, die Übertragbarkeit der Anbieter und eine Laufzeit hinter TUI, CLI, VS-Code-Erweiterung, SDK, Server ohne Oberfläche und MCP-Integrationen. Das sind Grundlagen und nicht der Grund, AX Code zu wählen — siehe Warum AX Code.

Die Befehle selbst stehen unter Ausführungsnachweise.

Mentales Modell

Stellen Sie sich AX Code als fünf Schichten vor:

1. Anbieterschicht: Wählen Sie das Modell-Backend, gegen das ausgeführt werden soll.
2. Agentenschicht: Wählen Sie den passenden Agenten für die Aufgabe oder lassen Sie das Routing helfen.
3. Werkzeugschicht: Der Agent handelt über ausdrückliche Werkzeuge, nicht über verborgene Fähigkeiten.
4. Sitzungsschicht: Gespräch, Entscheidungen und Zustand bleiben erhalten.
5. Steuerungsschicht: Isolation, Berechtigungen und Audit-Verhalten legen die Grenze fest.

Die übrige Dokumentation ordnet sich diesen Schichten zu.

Den nächsten Weg wählen

Ich möchte es schnell ausprobieren

• Beginnen Sie mit der README im Stammverzeichnis für Installation und ersten Start.
• Unterstützte Installationswege verwenden die kompilierte Laufzeit:
  • Bash-Release-Installationsprogramm für macOS mit Apple Silicon und für Linux: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • Homebrew-Alternative für die macOS-CLI: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • GitHub-Release-Installationsprogramm für Windows PowerShell: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Das Bash-Installationsprogramm ist nicht der maßgebliche Einrichtungsweg unter Windows.
• npm-Pakete sind keine unterstützten Installations- oder Aktualisierungskanäle mehr. Siehe Installation und Laufzeitkanäle für die Plattformrichtlinie, Laufzeitkennungen und die Matrix der lokalen Startprogramme.
• Setzen Sie ein Modell mit /connect oder ax-code providers login. Siehe Unterstützte Anbieter und Modelle für Cloud-API-Anbieter, CLI-Anbieter, AX Engine und Modellkennungen. Für einen kostenlosen Bewertungsweg nutzen Sie den Schnelleinstieg für kostenlose APIs.
• Führen Sie ax-code init aus, nachdem Sie ein echtes Projekt geöffnet haben, damit AGENTS.md lokale Konventionen erfasst.
• Wenn Sie engere Sicherheitsgrenzen wünschen, aktivieren Sie den Sandbox-Modus vor umfassenderen Änderungen.

Ich möchte es sicher in einem Team- oder Unternehmensrepository nutzen

• AX Code startet mit aktivem autonomen Modus und deaktiviertem Sandbox-Modus: full-access mit uneingeschränktem Dateisystem- und Netzwerkzugriff.
• Aktivieren Sie für Team-, Unternehmens-, nicht vertrauenswürdige oder unbeaufsichtigte Arbeit --sandbox workspace-write (oder read-only), bevor Sie die Aufgabe starten.
• Lesen Sie den Sandbox-Modus zu den Ausführungsgrenzen.
• Lesen Sie den Autonomen Modus, wenn der Agent unbeaufsichtigt laufen soll.
• Lesen Sie die Sicherheitsrichtlinie zum Bedrohungsmodell und zur Speicherung von Zugangsdaten.
• Lesen Sie die Semantische Schicht, wenn Herkunft und Wiedergabe für Ihren Ablauf wichtig sind.

Ich möchte es einbetten oder automatisieren

• Nutzen Sie kopflose oder gRPC-Einstiegspunkte von @defai-digital/ax-code-sdk für die Integration in TypeScript-Anwendungen.
• Nutzen Sie die Kompatibilität mit HTTP und OpenAPI für eine Dienstgrenze, erzeugte Clients und den maßgeblichen OpenAPI-Vertrag.
• Nutzen Sie ax-code mcp add, wenn der Agent externe Werkzeuge oder Dienste braucht.

Ich möchte das Repository verstehen oder Rückmeldung geben

• Lesen Sie die Dokumentationsübersicht für die übrigen öffentlichen Dokumente.
• Lesen Sie CONTRIBUTING.md zur aktuellen Richtlinie für externe Beiträge.

Wann AX Code nicht passen kann

AX Code ist bewusst mehr als Autovervollständigung oder ein gehostetes Chatfenster. Es kann zu viel sein, wenn:

• Sie nur eingebettete Codevorschläge brauchen und nicht möchten, dass Agenten Werkzeuge ausführen.
• Sie eine rein gehostete SaaS-Erfahrung ohne lokale Laufzeit brauchen.
• Sie keine Sitzungsdauerhaftigkeit, keine Wiedergabe, keine SDK- oder Serverintegration und keine Anweisungen auf Repository-Ebene brauchen.
• Sie in einer Umgebung arbeiten, in der kein lokaler CLI-Prozess erlaubt ist.

In diesen Fällen kann ein schlankerer Editor-Assistent einfacher sein. AX Code ist am stärksten, wenn der Agent in echten Entwicklungsabläufen mit Steuerung, Kontinuität und Integrationsgrenzen arbeiten muss.

Häufige erste Befehle

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 läuft ausschließlich über Grok Build CLI. Wählen Sie grok-build-cli in /connect; AX Code ruft den lokalen Befehl grok auf und verwendet dessen CLI-Anmeldung und Sitzung wieder. Der frühere direkte Cloud-API-Anbieter xai wird nicht mehr unterstützt.

Dokumentationsübersicht