mirror of
https://github.com/NeuralNomadsAI/CodeNomad.git
synced 2026-11-17 22:16:13 +00:00
Trim internal implementation commentary and routine-failure explanations from the interface and public help in all ten languages. Areas: Settings, Missions, providers and plugins, projects and remote access, transcript controls and the 28 help pages. Keep security and irreversible-action warnings, accessible names, scope boundaries and facts needed to act. Preserve current dev behavior and labels; the legacy OpenCode replacement confirmation now identifies its exact target. Validated with UI typecheck, ten-locale key and placeholder checks, help tests, unit contracts and affected browser tests.
71 lines
6.2 KiB
Markdown
71 lines
6.2 KiB
Markdown
# CodeNomad installieren
|
|
|
|
Wählen Sie einen lokalen Desktop-Host oder betreiben Sie den [eigenständigen Server](server.md). In beiden Fällen verwaltet OpenCode den gemeinsamen nativen Dienst und den Verlauf.
|
|
|
|
## Desktop-Downloads {#desktop-downloads}
|
|
|
|
1. Öffnen Sie [die Download-Seite](download.md).
|
|
2. Wählen Sie den Build für Ihr Betriebssystem und Ihren Prozessor.
|
|
3. Entpacken Sie die ZIP-Datei oder installieren/starten Sie das Plattformpaket und starten Sie anschließend CodeNomad.
|
|
|
|
| Plattform | Electron-Release | Tauri-Release | Plattformhinweise |
|
|
| --- | --- | --- | --- |
|
|
| macOS | ZIP, Intel oder Apple Silicon | ZIP, Intel oder Apple Silicon | Tauri: macOS 14+; Electron: macOS 13.5+. |
|
|
| Windows | ZIP, x64 | Installationsprogramm, x64 | Windows 10 oder neuer; Tauri verwendet WebView2. |
|
|
| Linux | Debian-Paket, x64 | AppImage, x64 | Unter Ubuntu 24.04 gebaut und getestet; Kompatibilität mit älteren Distributionen ist nicht garantiert. |
|
|
|
|
Desktop-Releases enthalten die Laufzeitressourcen für Backend und OpenCode-Installation; dafür benötigen Sie keine separate Node.js/npm-Installation. Git wird nicht mitgeliefert. Native Browser-Automatisierung durch Agenten wird in Electron und Tauri unter Windows, macOS und Linux unterstützt. Tauri verwendet unter macOS/Linux WebKit-Vorschauen und native Mobilprofile mit enginespezifischen Grenzen bei Pixeldichte und Eingabe; siehe [Browser-Vorschauen](browser-sidecars.md#signins-automation).
|
|
|
|
Wird ein überprüfter Download beim Start blockiert, lesen Sie die [plattformbezogene Fehlerbehebung](troubleshooting.md#desktop-launch). Führen Sie niemals ein nicht vertrauenswürdiges Archiv aus, nur um eine Warnung zu umgehen.
|
|
|
|
## Unter Linux installieren {#linux-install}
|
|
|
|
Führen Sie im Ordner des heruntergeladenen Releases Folgendes mit dessen tatsächlicher Version und Dateinamen aus:
|
|
|
|
```sh
|
|
sudo apt install ./CodeNomad-Electron-linux-x64-<version>.deb
|
|
```
|
|
|
|
Für das Tauri-AppImage:
|
|
|
|
```sh
|
|
chmod +x CodeNomad-Tauri-linux-x64-<version>.AppImage
|
|
./CodeNomad-Tauri-linux-x64-<version>.AppImage
|
|
```
|
|
|
|
Falls FUSE nicht verfügbar ist, verwenden Sie den Entpacken-und-Ausführen-Modus des AppImage:
|
|
|
|
```sh
|
|
./CodeNomad-Tauri-linux-x64-<version>.AppImage --appimage-extract-and-run
|
|
```
|
|
|
|
Die Electron-Debian-Installation richtet die Chromium-Sandbox ein. Deaktivieren Sie die Sandbox nicht als Installationsbehelf. Für Grafikprobleme unter Linux-Tauri gibt es eine [gezielte WebKit-Abhilfe](troubleshooting.md#desktop-launch).
|
|
|
|
## Anforderungen {#requirements}
|
|
|
|
| Anforderung | Wo sie verfügbar sein muss | Aktuelle Anforderung |
|
|
| --- | --- | --- |
|
|
| OpenCode-CLI | Ausgewählter Ausführungshost, gegebenenfalls einschließlich der ausgewählten WSL-Distribution | Mindestens **2.3.0**; **2.3.0** ist das empfohlene/qualifizierte Ziel. Neuere oder angepasste Versionen werden anhand der Schnittstellenverträge geprüft, nicht wegen fehlender Tests ausgeschlossen. |
|
|
| Git | Im `PATH` des CodeNomad-Backend-Kontos | Erforderlich für Repository-Identität, Git-Vorgänge und Worktrees. |
|
|
| Node.js/npm | Host für eigenständigen Server und Quellcode-Builds | Node.js 24 LTS; reproduzierbare Quellcode-Builds verwenden die in `.node-version` festgelegte Version. Desktop-Releases bringen ihre eigene Laufzeit mit: das integrierte Node von Electron oder das gebündelte Node von Tauri, jeweils mit npm. |
|
|
| Arbeitsbereichsordner | Für das Backend zugänglicher Datenträger | Ein ausdrücklich geöffneter physischer Ordner, kein von einem Remote-Browser angenommener gerätelokaler Ordner. |
|
|
|
|
Installieren Sie unter Windows [Git for Windows](https://gitforwindows.org/) mit aktiviertem Zugriff über Befehlszeile/Drittsoftware. Eine vom Benutzer beschreibbare benutzerbezogene Installation genügt. Unter macOS/Linux folgen Sie [Gits Plattformanleitung](https://git-scm.com/downloads).
|
|
|
|
Beenden Sie nach einer Änderung von `PATH` die Desktop-App vollständig und starten Sie sie neu, oder starten Sie das eigenständige Backend unter dem vorgesehenen Konto neu. Ein Browser-Neuladen aktualisiert die Backend-Umgebung nicht. Nur innerhalb von WSL verfügbares Git erfüllt die Git-Anforderung eines Windows-Backends nicht.
|
|
|
|
Ohne Git können Sie weiterhin einen physischen Ordner öffnen und verzeichnisgebundene Unterhaltungen führen, einschließlich einer Bitte an den Agenten um Installationshilfe. Repository-/Worktree-Vorgänge bleiben nicht verfügbar; der Sitzungszugriff bleibt auf genau diesen Ordner begrenzt. Der Ausführungshost des Agenten kann vom Backend-Host abweichen: Installieren Sie Git für das Backend, nicht nur für die Shell des Agenten.
|
|
|
|
## OpenCode beim ersten Start auswählen {#first-launch}
|
|
|
|
1. Wählen Sie bei der Einrichtung eine kompatible vorhandene Programmdatei oder nutzen Sie die angebotene OpenCode-Installation.
|
|
2. Prüfen Sie vor dem Öffnen eines Projekts den Laufzeitstatus.
|
|
3. Öffnen Sie später **Einstellungen → OpenCode**, um Programmdatei, Installation und gemeinsamen Dienst getrennt zu verwalten.
|
|
|
|
CodeNomad bevorzugt kompatible Programmdateien im `PATH` und unterstützt eine ausdrücklich ausgewählte Programmdatei. Startet `PATH` ein älteres OpenCode, bietet die Einrichtung an, ein mit npm installiertes OpenCode 1.x nach Bestätigung zu ersetzen oder OpenCode 2 für CodeNomad neben einer auf anderem Weg erstellten Installation zu installieren, die sie nie verändert; siehe [OpenCode-Einrichtung](opencode.md#select-cli). Das Installieren/Aktualisieren einer CLI startet einen bereits laufenden gemeinsamen Dienst nicht stillschweigend neu. Die [OpenCode-Einrichtung](opencode.md) erläutert Neustart-/Neuladefolgen, WSL und die Sitzungsumgebung.
|
|
|
|
## Stattdessen einen Browser verwenden {#browser-install}
|
|
|
|
Installieren Sie Node.js/npm, Git und OpenCode auf dem Server-Host und folgen Sie dann den [Server-Startanleitungen](server.md). Verbinden Sie sich über die ausgegebene Adresse mit konfigurierter Authentifizierung und einem vertrauenswürdigen Zertifikat. Ein Browser/eine PWA benötigt ein laufendes Backend; dies ist keine Offline-Kopie Ihrer Projekte.
|
|
|
|
Ports, Bindungen und TLS beschreibt der [Direktzugriff](remote-access.md). Zum Koppeln eines Geräts ohne eingehende Ports verwenden Sie die [Fernsteuerung](remote-control.md). Entwicklungs- und Paketierungsbefehle finden Sie unter [Quellcode-Builds](support.md#build-from-source).
|