Der Open-Source KI-Coding-Agent.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
Important
Android data survives reinstall only if all-files access is granted: server data is stored under /sdcard/OpenCode/home; otherwise app-private data is removed on uninstall. You may need to reselect a project after reinstalling. The v0.1.1 source tag predates the Android module; build from main. The uploaded APK has not been verified as a byte-for-byte build of main. See the current Android notes.
Dieser Fork lässt das bestehende opencode nativ auf Android laufen: Auf dem Telefon arbeiten der echte Server, der Agent, die Sitzungen und die unveränderte packages/app-Weboberfläche (über Loopback im WebView). Kein PC, kein Termux, kein externer Server, keine Protokolländerungen.
Was wir zusätzlich zum Upstream hinzugefügt haben (alles andere ist Upstream-opencode):
| Pfad | Inhalt |
|---|---|
packages/android |
Android-Host: Gradle-Projekt, WebView-Activity, eingebetteter Server, mobile UI-Anpassungen |
script/android |
Reproduzierbarer Build: build-apk.sh sowie Helfer für Server, ripgrep, Git-Runtime und Übersetzungen |
docs/android |
Technische Dokumente: Build, Ausführungsrichtlinie, native Abhängigkeiten, Upstream-Patches |
Es werden nur fünf Upstream-Dateien geändert (Android-Build-Ziel und Laufzeitkompatibilität); jede ist mit Begründung in docs/android/UPSTREAM_PATCHES.md dokumentiert.
So funktioniert es: Die Activity startet den eingebetteten Server (libopencode.so serve --hostname=127.0.0.1) und lädt http://127.0.0.1:<port>/ im WebView. Werkzeuge laufen aus dem nativen Bibliotheksverzeichnis: /system/bin/sh, mitgeliefertes git, rg und eine Bun-Runtime als bun/node.
- Download: releases (
app-release.apk, arm64, Android 8.0+) - Build:
./script/android/build-apk.sh— siehedocs/android/BUILD.md - Erster Start: Dateizugriff erlauben (Sitzungen liegen in
/sdcard/OpenCode/homeund überstehen Neuinstallationen), dann Einstellungen → Anbieter → Anbieter verbinden und ein Projekt (~/workspace) hinzufügen - Funktioniert: Server und Web-UI, Sitzungen, git mit Diffs und Syntaxhervorhebung (Changes), Projekt-Dateibrowser (Files), Kontextverbrauchs-Panel (Usage), Befehls- und JS/TS-Ausführung
- Einschränkungen: kein PTY-Terminal, keine LSP/Formatter, keine lokalen MCP-Prozesse; der native File-Watcher fehlt (Suche nutzt
rg) - Lizenz: MIT, wie im Original
# YOLO
curl -fsSL https://opencode.ai/install | bash
# Paketmanager
npm i -g opencode-ai@latest # oder bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS und Linux (empfohlen, immer aktuell)
brew install opencode # macOS und Linux (offizielle Brew-Formula, seltener aktualisiert)
sudo pacman -S opencode # Arch Linux (Stable)
paru -S opencode-bin # Arch Linux (Latest from AUR)
mise use -g opencode # jedes Betriebssystem
nix run nixpkgs#opencode # oder github:anomalyco/opencode für den neuesten dev-BranchTip
Entferne Versionen älter als 0.1.x vor der Installation.
OpenCode ist auch als Desktop-Anwendung verfügbar. Lade sie direkt von der Releases-Seite oder opencode.ai/download herunter.
| Plattform | Download |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg |
| macOS (Intel) | opencode-desktop-mac-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm oder AppImage |
OpenCode läuft auch auf Android als native APK aus diesem Fork. Die App enthält den echten Server und dieselbe Web-Oberfläche; Sitzungen, Anbieterschlüssel und Projekte liegen in /sdcard/OpenCode/home und überstehen Neuinstallationen.
| Plattform | Download | Hinweise |
|---|---|---|
| Android 8.0+ (arm64) | app-release.apk |
BETA — beim ersten Start Dateizugriff erlauben |
| Build aus Quellcode | ./script/android/build-apk.sh |
siehe packages/android/README.md |
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktopDas Installationsskript beachtet die folgende Prioritätsreihenfolge für den Installationspfad:
$OPENCODE_INSTALL_DIR- Benutzerdefiniertes Installationsverzeichnis$XDG_BIN_DIR- XDG Base Directory Specification-konformer Pfad$HOME/bin- Standard-Binärverzeichnis des Users (falls vorhanden oder erstellbar)$HOME/.opencode/bin- Standard-Fallback
# Beispiele
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bashOpenCode enthält zwei eingebaute Agents, zwischen denen du mit der Tab-Taste wechseln kannst.
- build - Standard-Agent mit vollem Zugriff für Entwicklungsarbeit
- plan - Nur-Lese-Agent für Analyse und Code-Exploration
- Verweigert Datei-Edits standardmäßig
- Fragt vor dem Ausführen von bash-Befehlen nach
- Ideal zum Erkunden unbekannter Codebases oder zum Planen von Änderungen
Außerdem ist ein general-Subagent für komplexe Suchen und mehrstufige Aufgaben enthalten.
Dieser wird intern genutzt und kann in Nachrichten mit @general aufgerufen werden.
Mehr dazu unter Agents.
Mehr Infos zur Konfiguration von OpenCode findest du in unseren Docs.
Wenn du zu OpenCode beitragen möchtest, lies bitte unsere Contributing Docs, bevor du einen Pull Request einreichst.
Wenn du an einem Projekt arbeitest, das mit OpenCode zusammenhängt und "opencode" als Teil seines Namens verwendet (z.B. "opencode-dashboard" oder "opencode-mobile"), füge bitte einen Hinweis in deine README ein, dass es nicht vom OpenCode-Team gebaut wird und nicht in irgendeiner Weise mit uns verbunden ist.