Installieren
Web-App für iPhone, iPad und Android
Die AirCode Ø Web-App ist der dauerhafte No-Store-Client. Es wird von Ihrer eigenen laufenden Instanz bedient, nicht in den signierten Download-Kanal verpackt, so dass es unabhängig von Google Play, dem App Store und TestFlight verfügbar bleibt.
- Starten Sie eine AirCode Ø -Instanz und geben Sie ihr eine stabile HTTPS -Adresse. Siehe Quickstart und Remote Access
- Öffnen Sie die dedizierte Web-App-Setup, geben Sie die HTTPS -Instanzquelle ein, und wählen Sie Öffnen Sie die Installationsseite. Das gleiche Setup ist auch verfügbar auf Download Die Website validiert den Wert lokal und sendet oder speichert es nie.
- Sign in der Instanz. Chromium zeigt seine eigene Installationsanleitung; iPhone und iPad Verwenden Sie den geführten Share → Home Screen Fluss hinzufügen.
- Starten Sie das installierte Icon. Aktivieren Sie Push-Benachrichtigungen nur, wenn Sie möchten geschlossene App-Warnungen; iOS und iPadOS bieten diese Steuerung nur von der Home Screen Web-App
Die Installation ist ursprünglich geschnitten. Eine HTTP LAN -Adresse ist kein vollständiges mobiles PWA -Ziel, und die Änderung des HTTPS -Origins erfordert eine separate Installation und kann eine erneute Authentifizierung erfordern. Die Web-App aktualisiert von der Instanz über ihren Service-Arbeiter; es ist kein APK, IPAoder Store-Paket.
Die Web-App trägt den responsiven Kernarbeitsbereich. Native mobile ist immer noch die bessere Wahl, wenn Sie sichere In-App-Serverwechsel, verschlüsselte verwaltete Offline-Dateien, zuverlässige begrenzte Hintergrundaufgaben, native Sharing/Scanning, Haptics, Benachrichtigungs-Kanal-Priorität oder tiefe Links zu Betriebssystem benötigen.
Linux-Server
Das Installationsprogramm wird erst veröffentlicht, wenn Manifest, Prüfsummen und Signaturprüfungen der Version bestanden sind. Prüfen Sie vor dem Ausführen des Befehls, ob der Server-Build auf der Downloadseite als verfügbar markiert ist.
curl -fsSL https://dl.aircodezero.com/install.sh | bash
Dieser Befehl installiert die neueste stable-Version. Mit den weiter unten beschriebenen Optionen des Installationsprogramms wählen Sie stattdessen eine Beta oder eine bestimmte Version.
Der Installer ist:
- Entdeckt Ihre Plattform (
linux-x64,linux-arm64), - Download der Release-Tarball und verifiziert seine sha256 Checksum und Ed25519 Signatur,
- installiert auf
~/.aircode/versions/<version>mit einem Symlink~/.aircode/current, - Links
aircodezu~/.local/bin, - überprüft Systemabhängigkeiten (
git,tmux) und sagt Ihnen genau, was zu tun ist installieren, wenn etwas fehlt.
Keine Wurzeln erforderlich. Alles lebt in Ihrem Home Directory. Beim Neustart des Installationsprogramms wird die Installation repariert oder aktualisiert. Wenn ~/.local/bin nicht in der PATHder aktuellen Shell ist, verwenden die endgültigen Anweisungen den sofort ausführbaren ~/.aircode/current/bin/aircode -Pfad und zeigen auch den optionalen PATH -Export.
Starten Sie dann die Instanz aus dem Verzeichnis, das die ausgewählten Projekte enthalten sollte:
cd /srv/workspaces
aircode start
Auf Linux erstellt aircode start die path-scoped Konfiguration, wählt einen freien Port, erzeugt und druckt ein Zugriffs-Passwort, startet einen systemd-Benutzerdienst und ermöglicht die Wiederherstellung nach Störungen und Neustarts. Es versucht auch systemd Linger zu aktivieren und druckt einen exakten Reparaturbefehl aus, wenn der Host eine Administratorgenehmigung erfordert. Eine handgeschriebene Einheitsdatei ist nicht erforderlich.
Wenn diese Installation immer noch die historische aircode.service -Einheit besitzt, entfernt die erste aircode start diese Einheit sicher, bevor sie den path-scoped-Dienst erstellt, so dass beide Server nicht für denselben Port konkurrieren können. Einheiten, die einem anderen Checkout oder einer anderen Installation gehören, werden nie geändert.
Optionen des Installationsprogramms: --channel beta (der Standardkanal ist stable), --version x.y.z und --no-modify-path. Die historische --service -Option bleibt mit der alten Single-Instance-Einheit kompatibel; Neue Installationen sollten aircode startverwenden.
Systemanforderungen
| Anforderung | Noten |
|---|---|
| Linux x64 / arm64 | Ubuntu 22.04+, Debian 12+, Fedora (neuer) — glibc |
git, tmux |
sudo apt-get install -y git tmux |
| Agent CLIs | Installiert und mit authentifiziert Ihre -Konten; Verwenden Sie die getesteten Versionen von in Quickstart für versionssensitive TUI -Integrationen |
| Systemd | erforderlich für persistente aircode start; nicht erforderlich für Vordergrund aircode serve |
Die Node.js Runtime ist eingebettet – kein System-Node erforderlich.
Docker
Das öffentliche Image aircodezero/aircode führt dasselbe veröffentlichte Linux-Serverpaket aus, das install.sh installiert. Node.js, der Web-Client, Claude Code, Codex, Grok Build und Kimi Code sind enthalten. Es wird für linux/amd64 und linux/arm64 mit den Tags stable und beta sowie mit exakten Versions-Tags wie 0.1.30 veröffentlicht.
Starten Sie es auf jedem Docker-Host mit einem einzigen Befehl:
docker run -d --name aircode --restart unless-stopped --stop-timeout 30 -p 7860:7860 -v aircode-home:/home/aircode aircodezero/aircode:stable
Docker Compose
Die Website stellt eine sofort einsetzbare compose.yaml bereit. Speichern Sie sie in einem eigenen Verzeichnis und starten Sie sie von dort aus:
curl -fsSLO https://aircodezero.com/docker/compose.yaml
docker compose up -d
Auf Hostinger bereitstellen
Auf Hostinger bereitstellen Die geführte Bereitstellung bereitet den Zugang Ihres Browsers vor und öffnet dann Hostinger.
- Wählen Sie einen VPS mit Ubuntu 24.04 und Docker (x86-64). KVM 2 (2 vCPU, 8 GB RAM) eignet sich für einen kleinen Test. Prüfen Sie Preis und Verlängerung vor der Zahlung.
- Docker Manager öffnet die vorbereitete Konfiguration. Wählen Sie Deploy und dann den HTTPS-Link Open des Projekts.
- Fahren Sie im ursprünglichen Browser fort, bestätigen Sie die Instanzadresse und wählen Sie ihr Passwort. Behalten Sie die Websitedaten bis zum Abschluss der Einrichtung.
Erster Zugriff
Diese Schritte gelten für manuelles Docker (docker run oder die portable Compose-Datei). Hostinger verwendet die oben beschriebene HTTPS-Einrichtung.
Öffnen Sie http://<server-address>:7860. Beim ersten Start gibt der Container einmalig ein generiertes Passwort in seinen Logs aus:
docker logs aircode
Um das Passwort selbst festzulegen, setzen Sie beim Erstellen des Containers die Umgebungsvariable AIRCODE_AUTH_PASSWORD. Sie können das Passwort später in den Einstellungen der App ändern.
Private HTTPS-Adresse
Öffnen Sie in AirCode Ø Einstellungen → Fernzugriff und melden Sie sich bei Ihrem AirCode Ø Konto an. Der Server erhält dann über das Relay seine private HTTPS-Adresse:
https://<name>.tunnel.aircodezero.com
Die Verbindung zum Relay ist rein ausgehend, daher müssen Sie keinen Port öffnen. Details finden Sie unter Fernzugriff.
Daten und Updates
Projekte, Anmeldungen bei Anbietern, Unterhaltungen und Einstellungen liegen alle im Volume aircode-home. Wenn Sie das Volume löschen, werden sie ebenfalls gelöscht.
Laden Sie zum Aktualisieren das neue Image herunter und erstellen Sie den Container neu. Mit Docker Compose führen Sie dies neben compose.yaml aus:
docker compose pull && docker compose up -d
Mit docker run laden Sie das Image herunter, stoppen und entfernen den Container und führen anschließend denselben docker run Befehl erneut aus:
docker pull aircodezero/aircode:stable
docker stop aircode && docker rm aircode
Der Container startet nie eine ältere Version als eine, die sein Volume bereits ausgeführt hat. Wenn der Serverprozess im Container stoppt, startet der Container ihn neu, und die Sitzungen der Agenten überstehen diesen Neustart.
macOS
Desktop-App (empfohlen): Laden Sie die .dmg von der Downloadseiteherunter. Es integriert den vollständigen Server (lokale Sitzungen) und verbindet sich auch mit Remote-Servern.
Headless / CLI: der gleiche Ein-Liner wie Linux funktioniert auf macOS 13+ (darwin-arm64, darwin-x64). Installieren Sie tmux zuerst über Homebrew, und verwenden Sie dann aircode serve; Persistent aircode start erfordert derzeit Linux systemd.
Windows
Installieren Sie die Desktop-App von der Download-Seite. Lokale Sitzungen laufen nativ auf Windows über ConPTY. Der Installer integriert den Server und seine Node.js -Laufzeit, so dass WSL, eine Linux -Distribution und eine System-Node-Installation nicht erforderlich sind. Es fügt auch aircode zum aktuellen Benutzer PATHhinzu, so dass der eingebettete Server von PowerShell oder Command Prompt ausgeführt werden kann. Öffnen Sie nach der Installation ein neues Terminal und sehen Sie die Windows Befehlszeilen-Referenz. Die App kann auch eine Verbindung zu entfernten AirCode Ø -Servern herstellen.
Desktop-Betriebsmodi
| Ziel | Startseite | Ergebnisse |
|---|---|---|
| Remote Client nur | Öffnen Sie AirCode Ø und wählen Sie Verbinden Sie sich mit einem Server ohne Konfiguration von Local | Das Electron-Fenster lädt den ausgewählten Remote-Server AirCode Ø ein |
| Lokaler Client + Server | Öffnen Sie AirCode Ø, wählen Sie einen Projektordner aus und wählen Sie dann Auf dieser Maschine ausführen | Electron startet und verwaltet den eingebetteten nativen Server und lädt dann seinen Arbeitsbereich ein |
| Server nur | Führen Sie aircode serve --projects-root "D:\Projects" in PowerShell oder in der Befehlsleiste aus |
Der gebündelte Server läuft im Vordergrund ohne ein Electron-Fenster |
Starten Sie das Desktop-Executable nicht mit --serve: Es öffnet Electron und bietet keinen Server-only-Modus. Verwenden Sie den Befehl aircode , der in PATH für einen Terminalserver installiert ist.
Nachdem Local konfiguriert wurde, sorgt ein normaler Desktop-Start dafür, dass der eingebettete Server ausgeführt wird, auch wenn ein Fenster mit einem Remote-Server verbunden ist. Der Desktop-Managed Server hört nur auf 127.0.0.1. Um eine Verbindung von einem anderen Gerät herzustellen, verwenden Sie Remote Access oder starten Sie einen CLI -Server mit einer expliziten privaten Netzwerkbindadresse.
Bei Windows verlässt das Schließen jedes Desktopfensters AirCode Ø und seinen eingebetteten Server im Benachrichtigungsbereich. Wählen Sie Quit aus diesem Symbol aus, um den eingebetteten Server zu stoppen. Ein CLI -Server ist ein separater Prozess und kann auf einem anderen Port koexistieren; siehe Desktop-App-Koexistenz.
Schwerkomponenten
Nichts Großes wird implizit heruntergeladen:
aircode browser install # pinned Chromium for the agent browser
aircode doctor browser # verify it
Knowledge bleibt lexikal, bis Sie aus den Einstellungen ein lokales Embeddings-Modell explizit installieren. Das Modell wird dann verifiziert und offline verwendet; Indexierung löst nie einen impliziten Modell-Download aus.