# AgentVera nutzen: erstes Projekt, Agenten und Raster

URL: https://agentvera.dev/de/blog/getting-started-with-agentvera/ · Veröffentlicht: 2026-10-24

AgentVera nutzen Schritt für Schritt: Projektordner hinzufügen, Claude-Code- oder Codex-Agenten starten, Raster anordnen, Status verfolgen und nur für Pro anmelden.

**Kurz gesagt:**

- Installiere die gewünschten Agenten-CLIs, öffne AgentVera, füge einen Projektordner hinzu und starte Agenten mit New agent; jeder läuft als echte CLI in einem eigenen Terminal-Bereich.
- Agenten nutzen die vorhandenen Logins der CLIs. Zusätzliche Claude- und Codex-Accounts kommen in Settings → Accounts, und im Dialog New agent wählst du pro Agent einen aus.
- Die Kernfunktionen laufen ohne AgentVera-Account. Melde dich nur für Pro- und Team-Funktionen wie Flows, automatische Freigabe und automatischen Account-Wechsel an.

**Um AgentVera zu nutzen, installierst du die gewünschten Coding-Agent-CLIs, fügst einen Projektordner hinzu, startest über New agent einen oder mehrere Agenten und arbeitest mit ihnen nebeneinander im Raster des Projekts.** Jeder Agent ist die echte CLI, etwa Claude Code oder Codex, in einem eigenen Terminal-Bereich mit eigenem Login. AgentVera ergänzt das Drumherum: ein Raster pro Projekt, ein Nachrichtenfeld mit Warteschlange, den Status auf einen Blick, Checkpoints pro Turn, Code-Review und Account-Verwaltung.

Diese Anleitung führt dich von einem leeren Fenster zu ein paar funktionierenden Agenten. Sie behandelt, was du zuerst installierst, wie der Dialog New agent funktioniert, wie du das Raster anordnest, wie die Anmeldung für die CLIs und für AgentVera selbst funktioniert und welche Gewohnheiten parallele Agenten davon abhalten, sich in die Quere zu kommen.

## Was du vor dem Start brauchst

AgentVera ist eine Desktop-App für macOS, Windows und Linux. Du bekommst sie auf der [Download-Seite](/de/download/). Es bringt kein eigenes Modell mit, sondern führt die Agenten-CLIs aus, die schon auf deinem Computer sind.

| Du brauchst | Warum |
| --- | --- |
| Mindestens eine Agenten-CLI, etwa Claude Code oder Codex | AgentVera startet für jeden Agenten die echte CLI |
| Ein Login für diese CLI | Agenten nutzen die Anmeldung und den Tarif der CLI |
| Einen Projektordner, idealerweise ein Git-Repository | Checkpoints, Worktrees und Code-Review bauen auf Git auf |
| Einen AgentVera-Account (optional) | Nur für Pro- und Team-Funktionen |

Hast du Claude Code noch nie benutzt, behandelt [Claude Code nutzen](/de/blog/how-to-use-claude-code/) Installation und Login. AgentVera unterstützt 18 Agenten-CLIs, darunter Claude Code, Codex, Gemini CLI und GitHub Copilot CLI, du kannst also mit der anfangen, für die du ohnehin zahlst.

## Schritt 1: Füge dein erstes Projekt hinzu

Öffne AgentVera und klicke in der oberen Leiste auf **Add project folder**. Wähle den Ordner eines Repositories, an dem du arbeitest. Das Projekt erscheint auf dem Bildschirm **Projects home** und in der oberen Leiste, und von dort oder mit der Befehlspalette (⌘K, Strg K unter Windows und Linux) springst du zwischen Projekten.

Jedes Projekt hat zwei Ansichten:

- **Workspace:** das Raster der Agenten-Bereiche, in dem du die meiste Zeit verbringst.
- **Details:** Informationen zum Projekt rund um die Agenten.

Willst du vor der Einrichtung eines Projekts nur eine kurze Frage stellen, hat der Startbildschirm einen Schnellchat. Diese Chats laufen im eigenen Ordner der App und berühren deine Projekte nicht.

## Schritt 2: Starte deinen ersten Agenten

Klicke in der Seitenleiste auf **New agent** oder drücke ⌘N. Der Dialog sagt, was er will: Wähle ein Tool und gib dem Agenten dann einen Namen und, falls nötig, eine Rolle.

1. **Tool:** Wähle die CLI, zum Beispiel Claude Code oder Codex. Ein Tool, das AgentVera auf diesem Computer nicht findet, ist mit **Not installed** markiert.
2. **Agent name** und **Color:** Ein kurzer Name wie „Backend“ oder „Reviewer“ macht das Raster leichter überschaubar.
3. **Runs on:** Lass es vorerst auf **This computer**. Du kannst einen Agenten auch auf einem SSH-Server ausführen.
4. **Account:** das Login, das der Agent nutzt. Standard ist das, das schon auf diesem Computer ist. Das Feld zeigt **Signed in** oder **Signed out**.
5. **Workspace:** der Hauptordner oder einer der Git-Worktrees des Projekts.
6. **Role and instructions:** optional. Bei Claude wird es dem System-Prompt hinzugefügt, bei Codex als Entwickleranweisungen.
7. Klicke auf **Start agent**.

Der Dialog hat weitere Optionen, darunter Kontextprofil, Browser, Projekt-Map, MCP-Server, Docker-Container, Token-Budget und eigene Pfade. Für den ersten Lauf kannst du alle auf den Standardwerten lassen und später darauf zurückkommen. [Token-Einsparung](/de/features/token-savings/) erklärt Kontextprofile, und [Docker](/de/features/docker/) erklärt, wie du einen Agenten in einem Container ausführst.

Der Agent öffnet sich in einem Bereich. Dieser Bereich ist ein echtes Terminal, das die CLI ausführt, alles, was die CLI in einem normalen Terminal kann, funktioniert also auch hier, einschließlich ihrer Slash-Befehle. Darunter liegt ein Nachrichtenfeld mit Prompt-Verlauf, Entwürfen und einer Warteschlange (⌘Enter stellt eine Nachricht in die Warteschlange, solange der Agent noch beschäftigt ist).

## Schritt 3: Melde die Agenten an

Agenten melden sich nicht über AgentVera an. Sie nutzen die Logins der CLIs, wenn `claude` oder `codex` in deinem Terminal also schon funktioniert, ist der Standard-Account bereit. AgentVera kennzeichnet diesen Standard-Account mit **this computer**.

Ist ein Account abgemeldet, warnt dich der Dialog New agent: „This account is signed out. Sign in from Settings → Accounts, or the agent will ask you to sign in on first launch.“ Du kannst einen der beiden Wege gehen.

Um mehr als einen Claude- oder Codex-Account zu nutzen, öffne **Settings → Accounts**, klicke auf **Add Claude account** oder **Add Codex account**, gib ihm einen Namen und wähle **Add and sign in**. Jeder zusätzliche Account bekommt einen eigenen Konfigurationsordner, und beim Erstellen eines Agenten wählst du, mit welchem Account er läuft. [Claude-Code-Accounts wechseln](/de/blog/switch-claude-code-accounts/) geht das im Detail durch.

## Schritt 4: Weitere Agenten hinzufügen und das Raster anordnen

Ein Agent ist nützlich. Zwei oder drei parallel sind der Punkt, an dem AgentVera sich auszahlt. Erstelle einen zweiten Agenten auf dieselbe Weise und gib jedem eine klare, eigene Aufgabe.

Das Raster steckt im **Screen splitter** (⌘⌥L). Wähle die Anzahl der Spalten und Zeilen, von 1×1 bis 5×4, oder ein fertiges Layout wie „Top 2 · Bottom 1“. Ziehe die Trennlinien, um Bereiche zu skalieren, und setze sie mit **Equalize pane sizes** zurück. Jedes Projekt merkt sich sein eigenes Layout.

| Aktion | So geht es |
| --- | --- |
| Zwei Bereiche tauschen | Einen Bereich auf einen anderen ziehen |
| Einen Bereich maximieren | Doppelklick auf den Titel oder ⌘⇧Enter |
| Fokus zwischen Agenten wechseln | ⌘⌥ + Pfeiltasten |
| Zu einem Bereich springen | ⌘1 bis ⌘9 |
| Befehlspalette öffnen | ⌘K |
| Screen splitter öffnen | ⌘⌥L |

Unter Windows und Linux nimmst du Strg statt ⌘ und Alt statt ⌥. Jedes Tastenkürzel kannst du in den Einstellungen ändern. Ein Bereich kann sich auch in einem Modal oder in einem eigenen Fenster öffnen, wenn du einen Agenten auf einem zweiten Bildschirm willst.

Teilen sich mehrere Agenten einen Ordner, können sie gegenseitig ihre Dateien überschreiben. Das vermeidest du, indem du jeden Agenten im Feld **Workspace** auf einen eigenen Git-Worktree zeigen lässt. [Git-Worktrees für parallele Agenten](/de/blog/git-worktree-parallel-agents/) erklärt das Setup, und [Mehrere Claude-Code-Agenten betreiben](/de/blog/run-multiple-claude-code-agents/) behandelt, wie du die Arbeit aufteilst.

## Schritt 5: Verfolge, was jeder Agent tut

Jeder Agent zeigt einen Status: **Working**, **Waiting for you**, **Needs approval**, **Idle**, **Asleep**, **Stopped** oder **Error**. Die Statusleiste zählt sie, zum Beispiel „2 working“ oder „3 agents need approval“, sodass du siehst, was dich braucht, ohne jeden Bereich zu öffnen. Mit ⇧⌘A springst du zum nächsten Agenten, der auf eine Freigabe wartet.

Wenn du dich entfernst, sagen dir Desktop-Benachrichtigungen, wann ein Agent fertig ist, scheitert oder auf eine Freigabe wartet. Du kannst sie auch an dein Handy senden lassen. Siehe [Benachrichtigungen und Freigaben](/de/features/notifications-and-approvals/).

## Schritt 6: Arbeit prüfen und einen schlechten Turn rückgängig machen

Zwei Free-Funktionen helfen dir, dem zu vertrauen, was parallele Agenten liefern.

- **Code-Review:** Schaltest du es in den Projekteinstellungen ein, prüft ein von dir gewähltes Claude-Modell den Code jedes Agenten, wenn sein Turn endet. Befunde kommen mit Schweregrad und einem Link auf file:line und können optional zurück an den Agenten gehen. Siehe [Code-Review](/de/features/code-review/).
- **Checkpoints:** Zu Beginn jedes Turns macht AgentVera einen Snapshot des Arbeitsordners des Agenten. Die Schaltfläche **Turns** im Kopf des Bereichs listet die Turns und die Dateien, die jeder geändert hat, und **Roll back this turn** setzt den Ordner zurück. [Claude-Code-Änderungen rückgängig machen](/de/blog/undo-claude-code-changes/) geht das Schritt für Schritt durch.

## Schritt 7: Melde dich bei AgentVera nur an, wenn du es brauchst

Das meiste, was diese Anleitung behandelt, gehört zum Free-Tarif, ohne Account. Pro und Team ergänzen Funktionen wie Flows, Nachtschicht, automatische Freigabe und automatischen Account-Wechsel. Um sie zu nutzen, wähle in der App **Sign in to AgentVera**. Du kannst dich über den Browser anmelden (Google-Anmeldung und Zwei-Faktor-Authentifizierung werden dort abgewickelt) oder mit E-Mail und Passwort. Die [Preisseite](/de/pricing/) listet, was jeder Tarif enthält.

## Eine erste Session, die funktioniert

Wenn du nicht sicher bist, was du zuerst ausprobieren sollst, zeigt dieses einfache Setup den Nutzen schnell:

1. Füge ein Repository hinzu, das du gut kennst.
2. Starte einen Claude-Code-Agenten in einem neuen Worktree und bitte ihn um eine kleine, klar abgegrenzte Änderung.
3. Starte einen zweiten Agenten (Codex oder ein weiteres Claude Code) in einem eigenen Worktree für eine unabhängige Aufgabe.
4. Stelle das Raster auf zwei Spalten und halte beide sichtbar.
5. Während sie arbeiten, liest du die Diffs, beantwortest Freigaben und stellst deine nächste Nachricht in die Warteschlange.
6. Geht ein Turn schief, rolle ihn über **Turns** zurück, statt mit dem Agenten zu diskutieren.

## Tipps für die erste Woche

- **Eine Aufgabe pro Agent.** Benenne Agenten nach ihrer Aufgabe. Eine klare Rolle in **Role and instructions** erspart dir Wiederholungen.
- **Ein Worktree pro Agent.** Das ist der einfachste Weg, Agenten am gegenseitigen Überschreiben zu hindern.
- **Halte das Raster anfangs klein.** Zwei oder drei Agenten, die du wirklich liest, schlagen acht, die du nur überfliegst.
- **Nutze die Palette.** ⌘K findet fast jede Aktion, mit dem Tastenkürzel daneben.
- **Behalte die Limits im Blick.** Die Statusleiste zeigt die 5-Stunden- und Wochennutzung jedes Accounts. [Claude Code Nutzungslimits](/de/blog/claude-code-usage-limits/) hat Tipps, damit sie länger reichen.
- **Wechsle die Sprache, wenn du magst.** Die Oberfläche gibt es auf Englisch und Türkisch, mit hellem und dunklem Design, unter Settings → Appearance.

## Fazit

Der Einstieg in AgentVera dauert ein paar Minuten. Du fügst ein Projekt hinzu, startest einen Agenten mit der CLI, die du schon nutzt, und fügst einen zweiten hinzu, wenn du eine zweite Aufgabe hast. Alles andere, etwa Worktrees, Checkpoints, Review, zusätzliche Accounts und Handy-Benachrichtigungen, baut auf demselben Raster auf. Du kannst jedes davon hinzufügen, wenn du es brauchst.

## Häufige Fragen

**Brauche ich zum Start einen AgentVera-Account?** Nein. Projekte, Agenten, das Raster, Git, MCP, Docker, SSH, Code-Review und Token-Einsparung gehören zum Free-Tarif und brauchen keinen Account. Du meldest dich nur bei deinem AgentVera-Account an, um Pro- oder Team-Funktionen freizuschalten.

**Ersetzt AgentVera Claude Code oder Codex?** Nein. AgentVera führt die echten CLIs aus. Jeder Agent ist ein Prozess von Claude Code, Codex, Gemini CLI, Copilot CLI oder einer anderen CLI in einem eigenen Terminal und nutzt das eigene Login und die Einstellungen dieser CLI.

**Was, wenn das gewählte Tool Not installed anzeigt?** AgentVera konnte diese CLI auf diesem Computer nicht finden. Installiere sie so, wie ihr Hersteller es dokumentiert, stelle sicher, dass der Befehl in einem normalen Terminal läuft, und öffne den Dialog New agent erneut.

**Wie viele Agenten kann ich in einem Projekt betreiben?** Der Free-Tarif hat kein Agentenlimit. Das Raster zeigt pro Projekt bis zu 5 Spalten mal 4 Zeilen an Bereichen, und jedes Projekt merkt sich sein eigenes Layout.

**Auf welchen Systemen läuft AgentVera?** Auf macOS, Windows und Linux. Es aktualisiert sich selbst von agentvera.dev, und Agenten kehren beim nächsten Öffnen der App zu ihrem Gespräch zurück.

---

**Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/