KI-Agenten — Einführung
Einstieg in lokale KI-Agenten: Was sie können, wie man sie installiert und welche Risiken es gibt.
- Sie können den Unterschied zwischen Web-KI (z.B. ChatGPT) und lokalen KI-Agenten (CLI) erklärenVerstehen
- Sie können einen KI-Agenten ihrer Wahl installieren und eine erste Aufgabe ausführenAnwenden
- Sie können grundlegende Risiken beim Umgang mit KI-Agenten benennenVerstehen
# KI-Agenten — Spickzettel ## Claude Code (Anthropic) ### Installation ```bash npm install -g @anthropic-ai/claude-code ``` ### Starten ```bash claude ``` ### Wichtigste Befehle - `claude` — Interaktiver Modus starten - `claude "frage"` — Einzelne Frage stellen - `/help` — Hilfe anzeigen - `/clear` — Kontext zurücksetzen - `Strg+C` — Abbrechen ### Voraussetzung - Claude Pro oder Max Abo (anthropic.com) - Node.js 18+ --- ## Codex CLI (OpenAI) ### Installation ```bash npm install -g @openai/codex ``` ### Starten ```bash codex ``` ### Wichtigste Befehle - `codex` — Interaktiver Modus - `codex "frage"` — Einzelne Frage - `Strg+C` — Abbrechen - Antworten werden in Sandbox ausgeführt ### Voraussetzung - OpenAI API-Key oder ChatGPT Plus - Node.js 18+ --- ## Gemini CLI (Google) ### Installation ```bash npm install -g @anthropic-ai/gemini-cli ``` Oder direkt via Google: ```bash npx https://github.com/google-gemini/gemini-cli ``` ### Starten ```bash gemini ``` ### Wichtigste Befehle - `gemini` — Interaktiver Modus - `gemini "frage"` — Einzelne Frage - Web-Suche integriert ### Voraussetzung - Google-Konto (Free Tier verfügbar) - Node.js 18+ --- ## opencode (Open Source) ### Installation ```bash npm install -g opencode-ai ``` ### Starten ```bash opencode ``` ### Wichtigste Befehle - `opencode` — Interaktiver Modus starten - Unterstützt verschiedene Modelle (Claude, GPT, Gemini, lokale Modelle) - Skills und Konfiguration über `.opencode/` Ordner - `Strg+C` — Abbrechen ### Voraussetzung - API-Key für gewünschtes Modell - Node.js 18+ --- ## Allgemeine Tipps - Immer in einem **eigenen Projektordner** arbeiten - Befehle **lesen**, bevor man sie bestätigt - `Strg+C` wenn etwas schiefgeht - `git init` im Projektordner für Sicherheitt
Lokale KI-Agenten — Einführung
In diesem Modul lernen Sie den Unterschied zwischen Web-KI (z.B. ChatGPT im Browser) und lokalen KI-Agenten kennen. Sie installieren einen Agenten Ihrer Wahl und führen erste Aufgaben aus.
Dauer: 1-2 Doppellektionen
Was sind lokale KI-Agenten?
Wenn Sie ChatGPT im Browser nutzen, tippen Sie eine Frage ein und bekommen eine Antwort. Ein lokaler KI-Agent kann deutlich mehr:
- Dateien lesen und schreiben — Der Agent kann Ihren Code, Ihre Daten oder Dokumente direkt bearbeiten
- Befehle ausführen — Der Agent kann Programme starten, Tests laufen lassen oder Pakete installieren
- Web-Suche — Einige Agenten können im Internet nach aktuellen Informationen suchen
- Kontext behalten — Der Agent merkt sich, was Sie vorher besprochen haben
Der wichtigste Unterschied: Ein KI-Agent läuft lokal auf Ihrem Computer (im Terminal) und hat direkten Zugriff auf Ihr Dateisystem.
Die 4 Tools im Überblick
Es gibt mittlerweile mehrere lokale KI-Agenten. Hier die wichtigsten:
| Tool | Von | Kostenlos? | Besonderheit |
|---|---|---|---|
| Claude Code | Anthropic | Nein (Pro-Abo) | Sehr gut beim Verstehen von Codebases, Agents-Modus |
| Codex CLI | OpenAI | Teils (Limitiert) | Sandboxed Ausführung, mehrere Vorschläge |
| Gemini CLI | Ja (Limitiert) | Grosse Kontextfenster, gute Web-Suche | |
| opencode | Open Source | Ja (mit eigenem API-Key) | Modell-unabhängig, Skill-System, lokal anpassbar |
Ihre Aufgabe: Wählen Sie ein Tool aus, das zu Ihrer Subscription passt. Wenn Sie bereits ein Abo haben (z.B. ChatGPT Plus, Claude Pro, Gemini Advanced), nutzen Sie das passende Tool dazu.
Note
Voraussetzungen
Bevor Sie starten, stellen Sie sicher:
- Terminal-Zugang — Sie können ein Terminal / eine Kommandozeile öffnen
- API-Key oder Abo — Je nach Tool brauchen Sie einen API-Key oder ein aktives Abo
- Projektordner — Erstellen Sie einen neuen Ordner für dieses Modul (z.B.
ki-agenten-modul/) - VS Code — Empfohlen, aber nicht zwingend (einige Tools funktionieren auch nur im Terminal)
⚠️ Kosten beachten: API-Abfragen können Geld kosten. Nutzen Sie Free Tier Limits und prüfen Sie Ihren Verbrauch.
Challenge
Aufgabe: Installation & erster Test
Wählen Sie einen KI-Agenten Ihrer Wahl und installieren Sie ihn:
- Tool wählen — Entscheiden Sie sich für Claude Code, Codex CLI, Gemini CLI oder opencode
- Installieren — Folgen Sie der Installationsanleitung für Ihr Tool (siehe Materialien-Spickzettel)
- Projektordner erstellen — Erstellen Sie einen Ordner
ki-test/und öffnen Sie ihn im Terminal - Erster Prompt — Bitten Sie den Agenten: "Erstelle eine Datei hallo.py mit einem Hello-World-Programm in Python und führe es aus."
- Screenshot — Machen Sie einen Screenshot der Terminal-Ausgabe
Abgabe: Screenshot der erfolgreichen Ausführung
Wie funktioniert ein KI-Agent?
Ein KI-Agent arbeitet in einem Kreislauf:
- Prompt — Sie geben eine Anweisung (z.B. «Lies die Datei daten.csv und zeige die ersten 5 Zeilen»)
- Kontext laden — Der Agent liest relevante Dateien aus Ihrem Projektordner
- Modell — Die Anfrage wird an das KI-Modell gesendet (Claude, GPT, Gemini...)
- Aktion — Der Agent schlägt eine Aktion vor (Datei erstellen, Befehl ausführen, Antwort schreiben)
- Bestätigung — In den meisten Fällen müssen Sie die Aktion bestätigen, bevor sie ausgeführt wird
⚠️ Wichtig: Der Agent kann Dateien verändern und löschen. Arbeiten Sie immer in einem eigenen Projektordner, den Sie notfalls löschen können.
Warning
Risiken & häufige Fehler
- Dateien gelöscht — Ein Agent kann versehentlich Dateien überschreiben oder löschen. Lösung: Arbeiten Sie immer in einem eigenen Ordner. Nutzen Sie Git für wichtige Projekte.
- Unsichere Befehle — Ein Agent könnte Befehle vorschlagen, die Sicherheitsrisiken darstellen (z.B. Dateien aus dem Internet herunterladen). Lösung: Befehle immer lesen, bevor Sie sie bestätigen.
- Halluzinationen — Der Agent kann Befehle erfinden, die gar nicht existieren. Lösung: Befehle prüfen, Fehlermeldungen lesen.
- Kosten — Jede Anfrage kostet Geld bei der API. Lösung: Free Tier Limits kennen, nicht endlos prompten.
- Datenschutz — Ihre Dateien werden an den KI-Anbieter gesendet. Lösung: Keine sensiblen/persönlichen Daten in Projektordner legen.
Challenge
Aufgabe: Dialog üben
Nun üben Sie den Dialog mit dem KI-Agenten:
- Bitten Sie den Agenten: "Schreibe eine kurze Geschichte über einen Jugendlichen, der zum ersten Mal einen KI-Agenten nutzt. Maximal 3 Sätze."
- Lesen Sie das Ergebnis. Korrigieren Sie den Agenten: "Die Geschichte soll lustiger sein."
- Korrigieren Sie noch einmal: "Die Hauptfigur soll Python programmieren, nicht Java."
Beobachtung: Wie reagiert der Agent auf Korrekturen? Behält er den Kontext? Schreibt er die ganze Geschichte neu oder ändert er nur Details?
Notieren Sie sich: 2-3 Beobachtungen zum Verhalten des Agenten.
Reflection
Reflexion
Überlegen Sie sich folgende Fragen:
- Was hat Sie überrascht? — Was konnte der Agent besser (oder schlechter) als erwartet?
- Was war schwierig? — Welche Hürden gab es bei der Installation oder Nutzung?
- Welches Tool haben Sie gewählt und warum? — War die Entscheidung richtig?
- Vertrauen — Auf einer Skala von 1 (gar nicht) bis 10 (voll und ganz): Wie sehr vertrauen Sie dem Agenten? Warum?