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

Installation und Laufzeitkanäle

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

Die README im Stammverzeichnis beschreibt den primären Installationsweg. Diese Seite ist die maßgebliche Quelle für unterstützte CLI-Installationskanäle, Laufzeitkennungen ax-code doctor, das Verhalten des lokalen Startprogramms und das öffentliche Aktualisierungsverhalten.

Öffentliche Verfügbarkeit

Öffentliche Release-Installationsprogramme und signierte Laufzeitarchive werden über download.ax-code.com verteilt. Die Installation erfordert keine privaten GitHub-Zugangsdaten.

AX Code und das SDK unterstützen nur Node.js 26 oder neuer. Eigenständige Installationsprogramme bündeln eine geprüfte Node.js-Laufzeit. Quell-Checkouts und SDK-Anwendungen auf Node.js-Basis müssen Node.js 26 oder neuer bereitstellen; die Paketinstallation lehnt ältere Node.js-Versionen ab.

AX Code Standard bleibt für die private und kommerzielle Nutzung unter der bestehenden Lizenz kostenlos. Der Zugang zum Entwicklungsquelltext wird getrennt von der öffentlichen Verteilung verwaltet. Die geplanten proprietären Business-Komponenten haben eine eigene Lizenzierung; das ändert die Lizenz von Standard nicht. Einzelheiten stehen unter Standard und Business, öffentliche Installationsaktualisierungen unter der Website-Anleitung. Öffentliche Installationsprogramme und ihre signierten Assets müssen erreichbar und geprüft sein, bevor die Website einen einzeiligen Installationsbefehl bewirbt.

Verfügbarkeit einer Veröffentlichung

Das Setzen eines Git-Tags vMAJOR.MINOR.PATCH startet den Release-Workflow. Der öffentliche Veröffentlichungsindex zeigt eine Version erst, nachdem dieser Workflow die Assets signiert und veröffentlicht hat. Bis dahin bleibt Latest auf dem zuvor veröffentlichten Tag. Nach erfolgreichem Validate sehen Betreuende einen Entwurf (Draft) für den neuen Tag; er ist nicht das öffentliche Latest.

Für bestehende Installationen folgen Sie Aktualisierung und Wiederherstellung.

Empfohlener Weg

Verwenden Sie ein unterstütztes gepacktes Installationsprogramm, sofern Sie nicht aus einem Checkout entwickeln. Das Release-Installationsprogramm ist der primäre CLI-Weg unter macOS und Linux; unter Windows verwenden Sie das native PowerShell-Installationsprogramm.

macOS (Apple Silicon)

curl -fsSL https://download.ax-code.com/install | bash

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Ubuntu 24.04+

curl -fsSL https://download.ax-code.com/install | bash

Homebrew bleibt eine unterstützte Alternative für die macOS-CLI:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Homebrew verlangt ausdrückliches Vertrauen für nicht offizielle Taps. Dieses Vertrauen für den gesamten Tap umfasst alle aktuellen und künftigen Formulae, Casks und externen Befehle, die in defai-digital/tap veröffentlicht werden. Der gemeinsame Tap enthält sowohl die CLI-Formula als auch den Desktop-Cask, und Homebrew kann beide Definitionen laden, während eine Installation aufgelöst wird. Verwenden Sie stattdessen das Release-Installationsprogramm, wenn Vertrauen für den gesamten Tap nicht akzeptabel ist.

Eine bestehende Installation vom alten Tap umziehen

defai-digital/ax-code ist nun ein Tap nur für die Migration. Veröffentlichungen von AX Code aktualisieren nur defai-digital/tap. Wenn Sie über den alten Tap installiert haben, fügen Sie den gemeinsamen Tap hinzu, bevor Sie aktualisieren, damit Homebrew die Tap-Zugehörigkeit des installierten Pakets verschieben kann:

brew tap defai-digital/tap
brew trust --formula defai-digital/tap/ax-code
brew update
brew upgrade defai-digital/tap/ax-code
brew info defai-digital/tap/ax-code

Nachdem Sie bestätigt haben, dass die Installation den gemeinsamen Tap verwendet, entfernen Sie den alten Tap:

brew untap defai-digital/ax-code

Wenn Homebrew weiterhin den alten Tap meldet, führen Sie brew reinstall defai-digital/tap/ax-code aus, bevor Sie ihn entfernen. Das alte Repository bleibt erreichbar, damit bestehende Installationen die Migration finden.

Ein versionsfestgelegtes Unix-Installationsprogramm prüfen

Für eine geprüfte, auf eine Version festgelegte Unix-Installation laden Sie zuerst das Installationsprogramm und seine Signatur aus derselben Veröffentlichung herunter. Wenn ein vertrauenswürdiges minisign bereits verfügbar ist:

AX_INSTALL_VERSION="<release>"
AX_INSTALL_BASE="https://download.ax-code.com/releases/download/v${AX_INSTALL_VERSION}"
curl -fsSL "$AX_INSTALL_BASE/install" -o ax-code-install
curl -fsSL "$AX_INSTALL_BASE/install.minisig" -o ax-code-install.minisig
minisign -Vm ax-code-install -x ax-code-install.minisig -P 'RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO'
# Inspect ax-code-install before running it.
bash ax-code-install --version "$AX_INSTALL_VERSION" --no-modify-path

Die Signatur des Archivs authentifiziert das Bootstrap-Skript nicht vor der Ausführung. Ein vom selben Ursprung geladener Digest erkennt Beschädigung, ist aber keine unabhängige Prüfung der Herausgeberidentität. Der einzeilige Weg verlässt sich auf den HTTPS-Verteilungsendpunkt.

Die einzeilige Ausführung aus der Ferne ist ein Bequemlichkeitsweg. Das Windows-Installationsprogramm prüft das heruntergeladene CLI-ZIP mit Minisign, nachdem es gestartet ist, aber irm | iex prüft install.ps1 selbst nicht vor der Ausführung.

Wenn minisign noch nicht im PATH liegt, lädt das PowerShell-Installationsprogramm das festgelegte Minisign-0.12-Archiv von download.ax-code.com herunter, prüft dessen SHA-256 und prüft die entpackte ausführbare Datei erneut, bevor es sie zwischenspeichert. Für den voreingestellten Installationsweg müssen Sie Minisign nicht manuell installieren. Eine bereits im PATH liegende Binärdatei minisign wird unverändert verwendet.

In sicherheitsempfindlichen Umgebungen laden Sie das Installationsprogramm herunter, prüfen es mit Minisign, sehen es durch und legen die in CI verwendete Release-Version fest:

$AX_CODE_VERSION = "<release>"
$AxCodeMinisignPublicKey = "RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO"
irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
irm https://download.ax-code.com/install.ps1.minisig -OutFile ax-code-install.ps1.minisig
# Optional: use a preinstalled minisign, or let install.ps1 bootstrap one when verifying the archive.
minisign -Vm ax-code-install.ps1 -x ax-code-install.ps1.minisig -P $AxCodeMinisignPublicKey
Get-Content .\ax-code-install.ps1
.\ax-code-install.ps1 -Version $AX_CODE_VERSION -NoModifyPath

Setzen Sie AX_CODE_SKIP_MINISIGN_VERIFY=1 nur, wenn Sie einen nicht prüfbaren Release-Download bewusst akzeptieren.

Prüfen Sie die installierte Laufzeit:

ax-code doctor

Unterstützte Benutzerinstallationen sollten Runtime: Node vX.Y.Z (node-bundled) unter macOS, Windows und Linux (glibc) melden.

Diese Installationsprogramme verteilen die CLI-/TUI-Laufzeit. Die Verantwortung für Desktop-Veröffentlichungen liegt bei AX Coder, und neue Desktop-Veröffentlichungen sind derzeit eingefroren. Dieser Leitfaden bietet keinen Installations- oder Aktualisierungskanal für Desktop.

Kanalmatrix

node-bundled und source sind Laufzeitmodi, keine Namen von Paketmanagern. Sie beschreiben, welche ausführbare Datei den Anwendungscode lädt:

• node-bundled: Node.js lädt die gebündelte Release-Laufzeit (alle unterstützten Benutzerinstallationskanäle).
• source: Node.js lädt Dateien direkt aus einem Checkout.

compiled und bun-bundled sind eingestellte Laufzeitmodi aus der Bun-Zeit und bleiben nur für die Diagnose alter Installationen erhalten. Sie sind keine unterstützten Benutzerinstallationskanäle.

pnpm dev und pnpm cli übersetzen das Workspace-SDK (packages/sdk/js) vor dem Start mit dem TypeScript des Repositorys nach dist, sodass ein frischer Checkout ohne manuellen SDK-Build läuft. Der Schritt ruft typescript/bin/tsc über node direkt auf und hängt daher nicht davon ab, dass node_modules/.bin verknüpft ist. Die gebündelten Pfade (pnpm run setup:cli und pnpm --dir packages/ax-code run build) benötigen weiterhin zuerst pnpm --dir packages/sdk/js run build.

Plattformrichtlinie

• macOS: Verwenden Sie das Bash-Release-Installationsprogramm als den primär dokumentierten CLI-Weg. Es installiert unter ~/.ax-code, richtet bei Bedarf die festgelegte Minisign-Version ein, prüft das Release-Archiv und benötigt Homebrew nicht. Das Archiv darwin-arm64 enthält einen eigenständigen AX-Engine-Sidecar für lokale Inferenz. Builds für Mitwirkende verwenden pnpm run setup:cli.
• Der unterstützte Homebrew-Weg tappt und vertraut ausdrücklich defai-digital/tap, bevor vollständig qualifizierte Installationsbefehle verwendet werden. Vertrauen für den gesamten Tap umfasst alle aktuellen und künftigen Formulae, Casks und externen Befehle im gemeinsamen Tap; verwenden Sie das Bash-Release-Installationsprogramm, wenn dieser Vertrauensumfang nicht akzeptabel ist.
• Linux-CLI: Verwenden Sie das Bash-Installationsprogramm für Ubuntu Desktop/Server 24.04 LTS und neuer auf amd64 und arm64 (glibc). Release-Builds erzeugen ax-code-linux-x64.tar.gz und ax-code-linux-arm64.tar.gz auf Ubuntu-24.04-Runnern, damit die glibc-Basis mit 24.04 und neuer kompatibel bleibt. Musl (Alpine) wird von den aktuellen Release-Archiven nicht unterstützt.
• macOS-CLI-Archive: Release-Builds veröffentlichen nur darwin-arm64 (Apple Silicon). Intel-macOS ist für aktuelle CLI- und Desktop-Pakete kein unterstütztes Installationsziel.
• Windows-CLI: Verwenden Sie das native PowerShell-Installationsprogramm. Es installiert das GitHub-Release-Asset in ein benutzerlokales Verzeichnis und aktualisiert den Benutzer-PATH, sofern nicht -NoModifyPath angegeben ist. Es prüft das heruntergeladene ZIP vor dem Entpacken mit dem festgelegten öffentlichen Schlüssel und sperrt im Fehlerfall, sofern AX_CODE_SKIP_MINISIGN_VERIFY=1 nicht absichtlich gesetzt ist. Fehlt minisign, lädt das Installationsprogramm das festgelegte Minisign-0.12-Archiv von download.ax-code.com nach %LOCALAPPDATA%\ax-code\tools\minisign und prüft die entpackte ausführbare Datei, bevor es sie zwischenspeichert. Eine bereits im PATH liegende Binärdatei minisign wird unverändert verwendet. Mit -Uninstall entfernen Sie die benutzerlokale Installation und den PATH-Eintrag.
• Windows-Desktop: Verwenden Sie das signierte Electron-Installationsprogramm aus den GitHub Releases mit dem Namen AX-Code-<version>-win-x64.exe oder AX-Code-<version>-win-arm64.exe. Der erwartete Authenticode-Herausgeber ist DEFAI Private Limited. Beschreiben Sie install.ps1 nicht als Desktop-Installationsprogramm. Stille Installation: .\AX-Code-<version>-win-x64.exe /S (NSIS).
• Winget: Paketmanifeste werden mit pnpm exec tsx tools/winget/generate-manifests.ts --version <ver> erzeugt und an microsoft/winget-pkgs übermittelt (siehe tools/winget/README.md). Bis zur Veröffentlichung upstream bleiben GitHub Releases die maßgebliche Windows-Installationsquelle.
• npm: kein unterstützter Installations- oder Aktualisierungskanal.

Die einzeilige Ausführung aus der Ferne ist ein Bequemlichkeitsweg, nicht der einzige Weg. Belassen Sie in der Dokumentation einen einsehbaren Installationsablauf (unter Windows mit Minisign geprüft), verwenden Sie in CI festgelegte Versionen und dokumentieren Sie Plattform-Installationsprogramme nur mit Abdeckung in der Installationsmatrix, die ax-code --version prüft und prüft, dass ax-code doctor den für diese Plattform erwarteten Laufzeitmodus meldet.

Installationen für Unternehmen und unbeaufsichtigte Installationen

Windows-CLI (benutzerlokal, ohne Administrator)

# Pin version in CI/images
$env:AX_CODE_VERSION = "7.9.4"
irm https://download.ax-code.com/releases/download/v$env:AX_CODE_VERSION/install.ps1 -OutFile install.ps1
# Optional: verify install.ps1.minisig first (see SECURITY.md)
.\install.ps1 -Version $env:AX_CODE_VERSION -NoModifyPath
# Then add %USERPROFILE%\.ax-code\bin to the machine/user PATH via your MDM.

macOS (benutzerlokal / Homebrew / MDM)

Verwenden Sie das Release-Installationsprogramm für eine benutzerlokale CLI-Installation ohne Homebrew:

curl -fsSL https://download.ax-code.com/install | bash

Verwaltete Macs können die Homebrew-Formula verwenden, damit CLI-Aktualisierungen dem Tap folgen:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Für per MDM gepackte DMG-Installationen verwenden Sie das notarisierte AX-Code-*-mac-arm64.dmg aus den GitHub Releases und prüfen die abgetrennte .minisig, wenn die Richtlinie Prüfungen der Lieferkette verlangt.

Verfügbarkeit von Winget

Verwenden Sie das öffentliche Installationsprogramm, sofern kein geprüftes Community-CLI-Paket verfügbar ist. Gehen Sie nicht davon aus, dass bei GitHub gehostete Manifest-Bündel anonym zugänglich sind.

Aktualisieren

Wählen Sie den Kanal, zu dem die aktive Installation gehört:

Bestehende Benutzer des alten Taps sollten der Migration zum gemeinsamen Tap folgen. Eine zweite Installation kann die erste im PATH überdecken; verwenden Sie which -a ax-code, ax-code --version und ax-code doctor, bevor Sie den Kanal wechseln. Die Installation der eigenständigen Version deinstalliert Homebrew nicht. Wechseln Sie Kanäle nur bewusst und behalten Sie Ihre Sitzungs- und Konfigurationsdaten.

Selbstaktualisierungen unter Unix holen das Installationsprogramm aus der Zielveröffentlichung und verlangen dessen SHA-256-Begleitdatei. Fehlt das Installationsprogramm oder der Digest, stoppt die Aktualisierung; es gibt keinen Rückfall auf einen veränderlichen main. Um ein älteres Archiv aus einer Veröffentlichung ohne Installations-Assets zu installieren, laden Sie ein aktuell veröffentlichtes Installationsprogramm herunter, prüfen es und führen es dann mit --version <older-version> aus.

Eigenständige Unix-Installationen verwenden ~/.ax-code/bin/ax-code als stabile symbolische Verknüpfung auf eine eindeutige Laufzeitgeneration unter ~/.ax-code/versions/. Das Installationsprogramm prüft den vollständigen neuen Baum, bevor es diese Verknüpfung umschaltet. Das erneute Installieren einer Version erzeugt eine neue Generation. Alte Generationen und ältere Laufzeitdateien bleiben erhalten, damit bereits laufende Agenten weiterhin ihre eigenen Module laden können. Laufende Agenten werden nicht neu gestartet. Starten Sie einen neuen Client bzw. eine neue Laufzeit, um die neue Version zu verwenden; beenden Sie aktive Arbeit ausdrücklich vor einem Neustart der Laufzeit. Homebrew-Dateien bleiben von Homebrew verwaltet.

Für einen Rollback verwenden Sie ein geprüftes Installationsprogramm mit --version <previous-version>. Die Datei version in jeder behaltenen Generation kennzeichnet deren Veröffentlichung. Alte Generationen werden nicht automatisch bereinigt; nachdem Sie alle Prozesse beendet haben, die sie verwenden, können Sie ungenutzte Generationen entfernen. Bei der Deinstallation behalten Sie Sitzungen und Konfiguration bei Bedarf mit --keep-data --keep-config; folgen Sie der Anleitung zum Entfernen der Binärdatei und entfernen Sie ungenutzte Laufzeitgenerationen getrennt erst, nachdem deren Prozesse beendet sind. Löschen Sie nicht den gesamten Ordner .ax-code, wenn Sie dort weitere Konfiguration oder persönliche Dateien abgelegt haben.

Eine gleichzeitige Unix-Installation schlägt mit dem Verzeichnisort .install-lock fehl. Ein abrupt beendetes Installationsprogramm kann dieses leere Verzeichnis hinterlassen. Prüfen Sie auf aktive Installationsprogramme, bevor Sie eine veraltete Sperre entfernen und es erneut versuchen; entfernen Sie sie nicht, solange eine Installation läuft.

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Unter Windows aktualisiert dies die CLI. So entfernen Sie die CLI-Installation und den Benutzer-PATH-Eintrag:

irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
.\ax-code-install.ps1 -Uninstall

Verhalten des Startprogramms für Mitwirkende

Dieser Abschnitt erfordert einen autorisierten Quell-Checkout. Für die öffentliche Installation oder Aktualisierung ist er nicht nötig; siehe Quellzugriff.

pnpm run setup:cli ist absichtlich standardmäßig ein kompilierter Pfad. Es baut die lokale gebündelte Binärdatei unter packages/ax-code/dist/... oder verwendet sie wieder und installiert ein globales Startprogramm, das auf diese Binärdatei zeigt. So bleiben lokale Prüfungen der gepackten Laufzeit nahe an dem, was Benutzer von Homebrew und des curl-Installationsprogramms ausführen.

Dieses Startprogramm landet gewöhnlich in ~/.local/bin oder PNPM_HOME, was im PATH typischerweise vor Homebrew liegt. Wenn Homebrew bereits ax-code bereitstellt, installiert setup:cli den Checkout als ax-code-src und entfernt einen zuvor geschriebenen Wrapper ax-code, damit brew upgrade ax-code den Befehl ax-code weiter aktualisiert. Verwenden Sie pnpm run setup:cli -- --override-homebrew nur, wenn der Checkout bewusst ax-code übernehmen soll. ax-code doctor warnt weiterhin vor dieser Überschreibung als PATH launchers.

Nachdem Quelländerungen die gepackte Laufzeit betreffen sollen, aktualisieren Sie die gebündelte Binärdatei, bevor Sie das globale Startprogramm prüfen:

pnpm --dir packages/ax-code run build -- --single
pnpm run setup:cli -- --rebuild
ax-code-src --version   # or `ax-code` if Homebrew is not installed

Verwenden Sie das Quell-Startprogramm nur, wenn der Checkout-Befehl diesen Checkout bewusst über Node.js aus Quelldateien ausführen soll:

pnpm run setup:cli -- --source
ax-code-src doctor      # or `ax-code doctor` if Homebrew is not installed

Das Quell-Startprogramm sollte Runtime: Node vX.Y.Z (source) melden.

Anforderungen an die Werkzeugkette

Das Repository erzwingt pnpm@10.33.4 über das Feld packageManager im Stamm und über only-allow pnpm: Der Hook preinstall blockiert Installationen, die nicht pnpm verwenden, und Hooks pre<script> im Stamm blockieren npm run <script> mit derselben Anforderung. Node.js muss zur Engine package.json im Stamm passen (>=26), die auch --experimental-ffi für TUI-Befehle im Quellmodus bereitstellt.

Verwenden Sie nicht das pnpm test im Stamm; das Skript im Stamm beendet sich absichtlich mit do not run tests from root. Für packages/ax-code führen Sie Tests aus packages/ax-code/ aus.

Homebrew-Installationen erhalten Hinweise auf Aktualisierungen ohne automatische Aktualisierung im Hintergrund. Beenden Sie aktive Agentenläufe, bevor Sie ausdrücklich aktualisieren oder alte Homebrew-Kegs bereinigen.