Erste Schritte

macOS Schnellinstallation

Wenn Sie macOS mit Apple Silicon verwenden, überspringen Sie diese Seite und nutzen Sie den Einzeilen-Installer:

curl -fsSL https://f5-sales-demo.github.io/devcontainer/scripts/install.sh | bash

Er kümmert sich um Homebrew-Pakete, iTerm2-Konfiguration, Podman-Setup und lädt alles herunter, was Sie benötigen.

Voraussetzungen

Container-Runtime

Sie benötigen eine Container-Runtime auf Ihrem Rechner. Sowohl Docker als auch Podman funktionieren.

Docker

Plattform	Installation
macOS	Docker Desktop für Mac
Windows	Docker Desktop für Windows (WSL2-Backend)
Linux	Docker Engine oder Docker Desktop für Linux

Überprüfen Sie die Funktionsfähigkeit:

docker --version
docker compose version

Podman

Plattform	Installation
macOS	Podman Desktop für Mac
Windows	Podman Desktop für Windows
Linux	Podman + Podman Compose

Überprüfen Sie die Funktionsfähigkeit:

podman --version
podman-compose version

Nur Linux

Podman unter Linux führt Container direkt aus (keine VM). Stellen Sie sicher, dass der Podman-Socket aktiv ist, damit podman-compose eine Verbindung herstellen kann:

systemctl --user enable --now podman.socket

Systemressourcen

Ressource	Minimum	Empfohlen
Festplatte	5 GB	10 GB+
RAM	8 GB der Container-Runtime zugewiesen	12 GB+
CPU	2 Kerne	4+ Kerne

Docker

Passen Sie die Ressourcenlimits unter Docker Desktop → Einstellungen → Ressourcen an.

Podman

Unter macOS/Windows passen Sie die Ressourcenlimits unter Podman Desktop → Einstellungen → Ressourcen oder über die CLI an:

podman machine set --cpus 4 --memory 12288
podman machine stop && podman machine start

Unter Linux teilen sich Container die Host-Ressourcen direkt — keine Ressourcenkonfiguration erforderlich.

1. Einrichtung

Erstellen Sie einen Ordner und laden Sie die Compose-Datei herunter:

mkdir devcontainer && cd devcontainer
curl -fsSLO https://raw.githubusercontent.com/f5-sales-demo/devcontainer/main/docker-compose.yml

2. Authentifizierungsdaten hinzufügen (Optional)

Erstellen Sie eine .env-Datei im selben Ordner, um Claude Code vorzukonfigurieren. Wählen Sie eine der folgenden Optionen:

Option A: Claude Max (OAuth)

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here

Option B: LiteLLM oder Anthropic-kompatibler Proxy

Wenn Sie eine LiteLLM-Instanz oder einen anderen Anthropic-kompatiblen Proxy haben, setzen Sie diese beiden Variablen:

LITELLM_BASE_URL=https://your-litellm-endpoint.example.com
LITELLM_API_KEY=your-api-key

Setzen Sie nur die Domain — der Container leitet anbieterspezifische URL-Suffixe automatisch ab (z. B. /anthropic für Claude Code).

Automatisches Befüllen aus lokalen Anmeldedaten

Wenn Sie git und gh auf Ihrem Host konfiguriert haben, können Sie die meisten .env-Werte automatisch befüllen. Kopieren Sie zunächst die Vorlage:

cp .env.example .env

Führen Sie dann die Befehle aus, die zu Ihrer Konfiguration passen:

# Git identity
echo "GIT_AUTHOR_EMAIL=$(git config user.email)" >> .env
echo "GIT_AUTHOR_NAME=\"$(git config user.name)\"" >> .env

# Timezone
echo "TZ=$(readlink /etc/localtime | sed 's|.*/zoneinfo/||')" >> .env

# GitHub CLI token (requires: gh auth login)
echo "GH_TOKEN=$(gh auth token)" >> .env

# SSH key (if you use SSH for git)
echo "SSH_PRIVATE_KEY=$(base64 < ~/.ssh/id_ed25519)" >> .env

Bearbeiten Sie dann .env, um Ihr OAuth-Token oder die LiteLLM-Proxy-Einstellungen hinzuzufügen (siehe Optionen oben).

KI-Assistenten

Die .env.example-Datei enthält @auto-detect-Markierungen bei jeder Variable, die aus lokalen Tools befüllt werden kann. KI-Assistenten wie Claude Code können diese Markierungen erkennen und die zugehörigen Befehle ausführen, um automatisch eine vollständige .env zu erstellen.

3. Starten

Docker

docker compose up -d

Podman

podman-compose pull && podman-compose up -d

Beim ersten Start wird das vorgefertigte Image von ghcr.io heruntergeladen (~1 Min. je nach Verbindung). Nachfolgende Starts verwenden das gecachte Image und dauern nur Sekunden.

4. Verbinden

Docker

docker compose exec dev zsh

Podman

podman-compose exec dev zsh

5. Überprüfen

# AI tools
claude --version
codex --version
pi --version

# Languages
node --version
python3 --version
go version

# Cloud CLIs
aws --version
az --version
terraform --version

Testen Sie die KI-Verbindung:

claude -p "Say hello"

6. Ihr erstes Projekt

cd /workspace
git clone https://github.com/your-org/your-project.git
cd your-project
claude

7. Remote-Anzeige (noVNC)

Der Container enthält eine virtuelle Anzeige, um KI-Agenten bei der Steuerung eines Browsers zu beobachten. Öffnen Sie http://localhost:6080/vnc.html, um sich zu verbinden. Weitere Details finden Sie unter Remote-Anzeige (noVNC).

8. Browser-Automatisierung (Chrome DevTools MCP)

Claude Code kann Webseiten navigieren, Screenshots erstellen und das DOM mithilfe des integrierten Chrome DevTools MCP-Servers inspizieren. Keine Einrichtung erforderlich — es funktioniert automatisch im Headless-Modus. Weitere Details finden Sie unter Chrome DevTools MCP.

9. Stoppen und Neustarten

Docker

# Stoppen (Daten bleiben erhalten)
docker compose down

# Erneut starten
docker compose up -d

# Alles löschen und neu beginnen
docker compose down -v
docker compose up -d

Podman

# Stoppen (Daten bleiben erhalten)
podman-compose down

# Erneut starten (pull stellt das neueste Image sicher)
podman-compose pull && podman-compose up -d

# Alles löschen und neu beginnen
podman-compose down -v
podman-compose pull && podman-compose up -d

Ihr Code in /workspace und das Home-Verzeichnis bleiben über Neustarts hinweg erhalten. Weitere Details finden Sie unter Konfiguration — Datenpersistenz.

---

Für lokale Builds und Dockerfile-Anpassungen siehe Lokale Entwicklung. Für die VS Code-Integration siehe VS Code. Für Remote-Anzeigeoptionen siehe Remote-Anzeige (noVNC).