Codex und Claude Code: Subagenten parallel starten – Prompts, Befehle

Der verbreitete Eindruck, „Claude Code arbeitet von selbst parallel, Codex aber erst, wenn man es ihm sagt“, ist richtig, mit Einschränkungen. Die Codex-App, die CLI und die IDE-Erweiterung starten parallele Helfer (Subagenten), wenn Sie darum bitten oder wenn AGENTS.md oder ein Skill vorgibt, die Arbeit auf Subagenten zu verteilen. Claude Code delegiert zusätzlich nach eigenem Ermessen, abhängig vom Inhalt Ihrer Anfrage und der Beschreibung jedes Subagenten.

Dieser Artikel vergleicht anhand der offiziellen Dokumentation von OpenAI und Anthropic (geprüft am 26. Oktober 2026), wie man beide Tools zum parallelen Arbeiten bringt, in dieser Reihenfolge: Auslöser, Formulierung der Anweisungen, Konfiguration, Befehle und Kosten. In jedem Abschnitt erscheinen die beiden Tools in derselben Reihenfolge und denselben Farben: Codex → Claude Code. Am Ende fasse ich zusammen, was diese Website beim parallelen Einsatz von Subagenten mit Claude Code gelernt hat.

1. Was paralleles Arbeiten auslöst und was passiert, wenn Sie nichts sagen

Ein Subagent ist ein separater Helfer, der einen Teil der Arbeit aus der Hauptunterhaltung übernimmt. Jeder führt Recherchen oder Tests in seinem eigenen Kontext aus und gibt nur eine Zusammenfassung seiner Ergebnisse an die Hauptunterhaltung zurück. Laufen sie parallel, verkürzt das die Wartezeit, und die Hauptunterhaltung füllt sich nicht mit Zwischenprotokollen. Diese Idee teilen beide Tools.

Der Unterschied liegt darin, wer den Anstoß gibt. Hier sind vier Situationen.

Quellen: OpenAI „Subagents“; Anthropic „Create custom subagents“. Geprüft am 26. Oktober 2026.

Laut offizieller Dokumentation von Codex delegieren die lokalen Versionen von Codex (App, CLI, IDE-Erweiterung) „wenn direkt darum gebeten wird oder wenn entsprechende Anweisungen in AGENTS.md oder einem Skill Delegation verlangen“. Die Funktion ist nicht abgeschaltet: Das Subagenten-System ist in aktuellen Versionen standardmäßig aktiviert. Ob welche gestartet werden, bleibt Ihren Anweisungen überlassen. In ChatGPT Work (Web) verlangen die meisten Intelligenzstufen eine ausdrückliche Bitte, und nur wenn Sie Ultra wählen (Ultra ist auf berechtigte Konten und unterstützte Modelle beschränkt), kann es von selbst delegieren, wenn paralleles Arbeiten Tempo oder Qualität deutlich verbessern würde.

Die offizielle Beschreibung von Claude Code lautet, dass es „automatisch delegiert, basierend auf der Aufgabe in Ihrer Anfrage, der description in der Subagenten-Definition und dem aktuellen Kontext“. Für Subagenten, die häufiger von sich aus genutzt werden sollen, wird empfohlen, Formulierungen wie „use proactively“ in die Beschreibung zu schreiben. Subagenten, die die Unterhaltung unverändert übernehmen (Forks), startet Claude standardmäßig ebenfalls nach eigenem Ermessen.

Ein Detail: Das Codex-Changelog enthält eine Änderung, mit der alle, die Codex in eigene Produkte einbetten (App-Server-Clients), die Delegation aus „deaktiviert, nur auf ausdrückliche Bitte oder proaktiv“ wählen können (Codex CLI 0.142.0, 22. Juni 2026). Für Nutzer von App, CLI und IDE gilt das Verhalten aus der Tabelle oben.

2. Wie beide funktionieren, im direkten Vergleich

Hier sehen Sie, wie Subagenten-Definitionen geschrieben werden, wie viele gleichzeitig laufen können, wie Arbeitsverzeichnisse getrennt werden und mehr. Wo nur die offizielle Dokumentation einer Seite etwas abdeckt, steht „Nicht dokumentiert“.

Quellen: OpenAI „Subagents“, „Configuration Reference“, „Worktrees“; Anthropic „Create custom subagents“, „Run parallel sessions with worktrees“. Geprüft am 26. Oktober 2026.

Es gibt zwei große Unterschiede. Der erste: ob man einem Subagenten das Schreiben unmöglich machen kann. Codex verwendet die Berechtigungen des Elternteils unverändert, „nichts bearbeiten“ ist für einen Subagenten also nur eine Bitte. Claude Code kann einem Subagenten die Bearbeitungstools (Write, Edit) komplett entziehen. Um auch Schreibzugriffe über die Shell zu blockieren, entfernen Sie zusätzlich Bash. Der zweite: eine Arbeitskopie pro Subagent. Claude Code kann für jeden Subagenten einen Git-Worktree anlegen (eine separate Arbeitskopie desselben Repositorys), während Worktrees in Codex pro Chat gelten.

Claude Code bietet neben Subagenten weitere Wege, parallel zu arbeiten (die agent view, die separate Sessions auf einem Bildschirm laufen lässt, und agent teams, deren Helfer miteinander kommunizieren). Die Unterschiede behandeln „Claude Code: Subagents vs. Agent Teams“ und „Die agent view von Claude Code“.

3. Anweisungen formulieren, mit fertigen Prompts

Die offizielle Codex-Dokumentation empfiehlt, dass ein guter Prompt angibt, wie die Arbeit aufgeteilt wird, ob vor dem Weitermachen auf alle Agenten gewartet wird und was zurückgegeben werden soll. Aus dem parallelen Betrieb von Subagenten auf dieser Website wissen wir: Zwei weitere Punkte verringern Pannen.

1. Wie die Arbeit aufgeteilt wirdNach Anliegen (Sicherheit, Tests, Wartbarkeit), nach Ort (Verzeichnis, Modul) und so weiter. So aufteilen, dass nie zwei Subagenten dasselbe ansehen
2. Was sie anfassen dürfen„Nur lesen“ oder „du darfst nur dieses Verzeichnis bearbeiten“. Nie zwei Subagenten an dieselbe Datei lassen
3. Ob auf alle gewartet wirdErst zusammenführen, wenn alle Ergebnisse da sind, oder Weitermachen zwischendurch erlauben
4. Was zurückgegeben wirdFormat und Länge („unter 10 Zeilen mit Dateinamen“ usw.). Lange Antworten füllen den Hauptkontext schnell
5. Was nicht getan werden darfCommitten, Pushen, Subagenten, die weitere Subagenten starten, und so weiter. Sagt man ihnen nicht, was tabu ist, tun Subagenten es in bester Absicht

Schreibgeschützte Recherche und Reviews (hier anfangen)

Prüfe diesen Branch im Vergleich zu main. Starte drei Subagenten parallel:
einen für Sicherheitsprobleme, einen für fehlende Tests und einen für die Wartbarkeit.
Keiner von ihnen darf Dateien bearbeiten.
Warte, bis alle drei fertig sind, und fasse dann nach Anliegen zusammen, mit Dateinamen und Zeilenangaben.

Untersuche die Module für Authentifizierung, Datenbank und API parallel mit separaten Subagenten.
Jeder Subagent soll nur lesen und keine Dateien ändern.
Lass jeden „Einstiegsdateien, Hauptverarbeitungsablauf, Bedenken“ in unter 10 Zeilen zurückgeben
und führe alles erst zusammen, wenn alle Ergebnisse vorliegen.

Arbeit aufteilen, die Dateien bearbeitet

Beide offiziellen Dokumentationen behandeln paralleles, schreiblastiges Arbeiten mit Vorsicht. Geben Sie jedem Subagenten einen eigenen Bereich, den er bearbeiten darf, und trennen Sie in Claude Code auch die Arbeitskopien.

Finde heraus, warum das Speichern auf der Einstellungsseite fehlschlägt, und behebe es.
Lass browser_debugger den Fehler im Browser reproduzieren und die Schritte festhalten,
und lass code_mapper herausfinden, wo der verantwortliche Code liegt (diese beiden dürfen nichts bearbeiten).
Sobald die Ursache bekannt ist, lass ui_fixer die kleinstmögliche Korrektur vornehmen. Fasse keine unbeteiligten Dateien an.

/batch migriere das JavaScript in src/ zu TypeScript

Damit Sie es nicht jedes Mal sagen müssen

Wenn es lästig ist, in Codex jedes Mal um paralleles Arbeiten zu bitten, schreiben Sie Delegationsregeln in die AGENTS.md des Projekts. Laut offizieller Dokumentation delegiert es, wenn entsprechende Anweisungen in AGENTS.md oder einem Skill vorhanden sind. Welche Formulierung das zuverlässig auslöst, steht dort nicht; prüfen Sie deshalb nach dem Schreiben der Regeln einmal, ob bei Ihren üblichen Anfragen Subagenten starten.

## Einsatz von Subagenten
- Bei Recherchen über drei oder mehr Verzeichnisse pro Verzeichnis einen Subagenten starten und parallel recherchieren
- Subagenten keine Dateien bearbeiten lassen. Alle Bearbeitungen im Hauptthread erledigen
- Warten, bis alle Ergebnisse vorliegen, dann nur die Kernpunkte berichten

Wenn Sie in Claude Code einen bestimmten Subagenten häufiger nutzen lassen wollen, schreiben Sie in seine description, wann er eingesetzt werden soll, plus „use proactively“ (ein Definitionsbeispiel folgt im nächsten Abschnitt). Delegiert es umgekehrt zu viel, verhindert Agent in permissions.deny, dass es Subagenten startet.

4. Konfiguration und Definitionsdateien für Subagenten

Codex config.toml und .codex/agents/

Globale Einstellungen gehören unter [agents] in config.toml (persönlich: ~/.codex/config.toml, Projekt: .codex/config.toml).

# .codex/config.toml
[agents]
max_concurrent_threads_per_session = 4     # Max. gleichzeitig offene Subagenten-Threads (Hauptthread zählt nicht)
default_subagent_model = "gpt-6-luna"      # Standardmodell für Subagenten
default_subagent_reasoning_effort = "high" # Standard-Reasoning-Aufwand für Subagenten

Quelle: OpenAI „Configuration Reference“. Geprüft am 26. Oktober 2026. Das in Suchergebnissen häufig auftauchende „multi agent v2“ ist die aktuelle Version dieses Systems; laut Changelog wurde es in Codex CLI 0.145.0 (21. Juli 2026) stabil (Changelog). In aktuellen Versionen ist es aktiviert, ohne dass Sie selbst multi_agent = true schreiben.

Eigene Agenten gehören nach .codex/agents/, eine TOML-Datei pro Agent. Der Name des Agenten stammt aus name, nicht aus dem Dateinamen.

# .codex/agents/reviewer.toml
name = "reviewer"
description = "Reviewer mit Fokus auf Korrektheit, Sicherheit und fehlende Tests"
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
developer_instructions = """
Bearbeite keine Dateien.
Priorisiere Korrektheit, Sicherheit, Verhaltensregressionen und fehlende Tests.
Reine Stilhinweise nur dann, wenn sie einen echten Fehler verdecken.
"""

Nach dem offiziellen Beispiel angepasst. Die Modellnamen stammen aus dem offiziellen Beispiel; welche Modelle verfügbar sind, hängt von Konto und Workspace ab. Offiziell empfohlen wird gpt-6.1-sol für Agenten mit vielen schwierigen Abwägungen und gpt-6-luna für leichtgewichtige Agenten mit klar begrenztem Umfang. Einstellungen wie sandbox_mode, approval_policy und mcp_servers werden von den Einstellungen des Elternteils überschrieben, auch wenn Sie sie in die Agentendatei schreiben.

Claude Code .claude/agents/ und settings.json

Subagenten liegen als Markdown in .claude/agents/. Sie können Claude auch einfach bitten, „einen Subagenten zu erstellen, der X erledigt“, und die Datei schreiben lassen.

---
name: test-runner
description: Führt die Testsuite aus und meldet nur fehlgeschlagene Tests mit ihren Fehlern. Use proactively nach Codeänderungen.
tools: Read, Grep, Glob, Bash
model: haiku
---

Führe die Tests aus und gib nur die Namen der fehlgeschlagenen Tests und den Kern ihrer Fehler zurück.
Korrigiere keinen Code. Gib nicht die Liste der bestandenen Tests zurück.

Da tools weder Write noch Edit enthält, kann dieser Subagent laut offizieller Dokumentation Dateien weder bearbeiten noch schreiben. Bash bleibt jedoch erhalten, damit er die Tests ausführen kann, was Schreibzugriffe über Shell-Befehle offenlässt. „Korrigiere keinen Code“ im Dateiinhalt dient als Erinnerung daran. model akzeptiert sonnet, opus, haiku, fable, eine Modell-ID oder inherit (wie die Hauptunterhaltung). Wie man pro Subagent ein Modell wählt, erklärt „Claude Code: Subagenten mit einem anderen Modell ausführen“.

Gleichzeitigkeitslimit und Verschachtelungstiefe werden über Umgebungsvariablen gesetzt, die Sie unter env in settings.json eintragen können.

{
  "env": {
    "CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS": "5",
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "1"
  }
}

Quellen: Anthropic „Create custom subagents“, „Orchestrate teams of Claude Code sessions“. Geprüft am 26. Oktober 2026.

5. Befehlsübersicht

Das sind die Befehle, um laufende Subagenten zu beobachten, Arbeitskopien zu trennen, eine Unterhaltung abzuzweigen und mehr. Manche tragen denselben Namen, tun aber Verschiedenes, also Vorsicht.

Quellen: OpenAI „Command line options, Slash commands“, „Subagents“; Anthropic „Commands“, „Run agents in parallel“, „Create custom subagents“ (mehrere Ansätze mit Forks testen). Geprüft am 26. Oktober 2026.

Verwirrend ist /agents, weil die Namen übereinstimmen. In Codex ist /agents die Liste der Chats auf dem Server (die Kommandozentrale). In Claude Code verweist /agents darauf, wo Subagenten-Definitionen liegen, und die Session-Liste ist claude agents (aus der Shell gestartet).

6. Aufgaben, die sich für paralleles Arbeiten eignen, und solche, die es nicht tun

Die beiden offiziellen Dokumentationen sagen fast dasselbe: mit schreibgeschützter Arbeit beginnen und bei schreiblastiger Arbeit vorsichtig sein.

Quellen: OpenAI „Subagents“ (Why subagent workflows help); Anthropic „Create custom subagents“ (Choose between subagents and main conversation) und „agent teams“ (Avoid file conflicts). Geprüft am 26. Oktober 2026.

7. Auswirkung auf die Kosten (Nutzungslimits)

Paralleles Arbeiten geht schneller, verbraucht aber mehr von Ihrem Nutzungskontingent, weil jeder Subagent eigene Modellaufrufe macht und eigene Tools nutzt.

Quellen: OpenAI „Subagents“, „Changelog“; Anthropic „Manage costs effectively“, „Create custom subagents“. Geprüft am 26. Oktober 2026.

Leicht übersehen wird außerdem, dass auch die Antworten der Subagenten im Hauptkontext landen. Die Doku von Claude Code warnt, dass viele Subagenten mit ausführlichen Ergebnissen einen großen Teil des Hauptkontexts verbrauchen können. Ein Rückgabeformat wie „unter 10 Zeilen“ hilft daher auch bei den Kosten. Allgemeines Token-Sparen in Claude Code behandelt „Claude Code Token-Spar-Tipps“.

8. Lehren aus dem Betrieb (Beispiele dieser Website)

Diese Website (AI Arte) wird betrieben, indem Übersetzungen und Prüfungen von Artikeln parallel an Subagenten von Claude Code übergeben werden. Auch Recherche und Entwurf dieses Artikels hat einer der Subagenten geschrieben, die die Hauptsession losgeschickt hat. Im Folgenden steht, was tatsächlich passiert ist, und wie man es vermeidet. Alles stammt aus Claude Code; nichts davon wurde in Codex nachgestellt. Konflikte um dieselbe Datei und ungenaue Berichte über Dinge außerhalb des Zuständigkeitsbereichs eines Subagenten verdienen aber auch in Codex Aufmerksamkeit, da der Mechanismus ähnlich ist.

1. Juli 2026Die Zahl gleichzeitiger Subagenten an die eigenen Limits anpassen

   Was passierte

   Mit sechs oder mehr gleichzeitig scheiterten Subagenten an Ratenlimits

   So vermeiden

   Auf 5 gleichzeitig begrenzen und größere Aufträge nacheinander in Gruppen zu je 5 abarbeiten. Eine Obergrenze passend zu den eigenen Limits setzen, unterhalb der Standardgrenze von Claude Code (20)

2. 22. September 2026Subagenten keine weiteren Subagenten starten lassen

   Was passierte

   Ein Subagent, der einen Auftrag für 10 Sprachen erhalten hatte, startete selbst 5 Übersetzungs-Subagenten. Zusammen mit den 5 des Elternteils liefen damit 10 gleichzeitig, das Nutzungslimit war erreicht, und alle blieben mittendrin stehen

   So vermeiden

   Unter „was nicht getan werden darf“ in die Anweisungen schreiben: „Starte keine Subagenten. Das Elternteil verteilt die Arbeit.“ Claude Code lässt Subagenten standardmäßig Subagenten starten (bis zu 3 Ebenen), daher können Sie die Verschachtelung auch mit CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 unterbinden

3. 22. August 2026Nie zwei Subagenten an dieselbe Datei lassen

   Was passierte

   Ein Satz, den das Elternteil ans Ende eines Kurskapitels angefügt hatte, wurde von einem anderen Subagenten als „nicht in den Anweisungen“ gelöscht, dann wieder eingefügt, immer wieder

   So vermeiden

   Jedem Subagenten die Dateien zuweisen, die er anfassen darf. Was das Elternteil später gesammelt ergänzt, entweder auch in den Anweisungen der Subagenten erwähnen oder erst ergänzen, wenn alle fertig sind

4. 22. September 2026Auch den Ablageort für temporäre Dateien trennen

   Was passierte

   Ein temporäres Skript, das ein Subagent direkt in den Scratch-Ordner gelegt hatte, war von der gleichnamigen Datei eines anderen Subagenten überschrieben worden. Subagenten, die aus derselben Unterhaltung gestartet werden, sehen denselben Scratch-Ordner

   So vermeiden

   In den Anweisungen jedem Subagenten einen eigenen Unterordner zuweisen

5. 5. September 2026Nicht alles auf einmal committen, während Subagenten laufen

   Was passierte

   Während 5 liefen, wurde eine unabhängige Änderung mit git add -A (alle Änderungen) committet, wodurch 100 von den Subagenten fertiggestellte Dateien in einen fremden Commit gerieten

   So vermeiden

   Beim Committen die Dateien angeben. Den Subagenten außerdem sagen, dass Operationen, die alle Änderungen bündeln oder Änderungen zurücksetzen, verboten sind

6. 22. August 2026Alles nachzählen, was Subagenten außerhalb ihres Bereichs melden

   Was passierte

   Zwei Subagenten meldeten „24 Einträge fallen bei der Prüfung durch“ und „28“, tatsächlich waren es 16. Sie hatten den Zustand von Dateien geraten, die sie nicht angefasst hatten

   So vermeiden

   Das Elternteil prüft Anzahl und Ziele, indem es die Prüfungen selbst ausführt. Befunde innerhalb des eigenen Bereichs eines Subagenten sind sehr genau und können als verlässlich gelten

Aus den Betriebsaufzeichnungen dieser Website (Juli bis September 2026). Aufgenommen sind nur Zahlen, die in diesen Aufzeichnungen erhalten sind.

Fasst man diese Lehren zusammen, sehen die verteilten Anweisungen so aus. Subagenten kennen den Rest der Unterhaltung nicht, also schreiben Sie sie so, dass die Anweisungen allein ausreichen, um die Aufgabe zu erledigen.

[Aufgabe] Artikel 273 recherchieren und den ja-Entwurf schreiben
[Was nicht getan werden darf]
- Git-Operationen (add, commit, checkout, restore, stash, push)
- Keine Subagenten starten (das Elternteil verteilt die Arbeit)
- Keine anderen Artikel bearbeiten
- Temporäre Dateien in scratch-folder/a273/ ablegen
[Wie recherchiert wird] Aus dem Originaltext der offiziellen Dokumentation (URLs und Prüfdaten festhalten)
[Was zurückgegeben wird] Erstellte Dateien, Titel, alles, was nicht überprüft werden konnte

Das Gerüst (zusammengefasst) der Anweisungen, die der Subagent erhielt, der diesen Artikel geschrieben hat, ergänzt um zwei der Lehren oben (keine Subagenten starten, Ablageort für temporäre Dateien). Dasselbe Format eignet sich für Anweisungen an Subagenten in Codex wie in Claude Code.

Zusammenfassung

Die allgemeinen Unterschiede zwischen beiden Tools (Preise, Limits, Einsatzorte) finden Sie in „Claude Code vs Codex: Welches wählen?“, und Einstellungen, die Subagenten näher an den Nur-Lese-Betrieb bringen, in „Codex und Claude Code schreibgeschützt nutzen“.

FAQ

F. Wie viele Codex-Subagenten können gleichzeitig laufen?

A. Die Obergrenze legen Sie mit agents.max_concurrent_threads_per_session in config.toml fest (der Hauptthread zählt nicht). Lassen Sie sie weg, entscheidet Codex, und dieser Standardwert ist nicht veröffentlicht. Die offiziellen Konfigurationsbeispiele verwenden 6 oder 8. Bei Claude Code sind standardmäßig 20 gleichzeitig möglich, änderbar mit CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. Bei beiden Tools gilt: Je mehr Sie laufen lassen, desto schneller sind die Nutzungslimits aufgebraucht.

F. Kann ich nur für Subagenten ein günstigeres Modell nutzen?

A. Ja. In Codex mit default_subagent_model unter [agents] oder mit model und model_reasoning_effort in der Agentendatei. Ohne Angabe wird das Modell des Elternteils übernommen. In Claude Code setzen Sie model in der Subagenten-Definition (haiku usw.) oder nutzen die Umgebungsvariable CLAUDE_CODE_SUBAGENT_MODEL.

F. Muss ich „multi_agent = true“ in meine Konfiguration schreiben?

A. Im aktuellen Codex nicht. In der Konfigurationsreferenz ist features.multi_agent stabil und standardmäßig aktiviert, und auch agents.enabled steht standardmäßig auf true. Laut Changelog kam multi-agent V2 als Opt-in-System und wurde in Codex CLI 0.145.0 (21. Juli 2026) stabil. Die „Aktivieren“-Schritte älterer Anleitungen führen heute zum selben Zustand, als würden Sie nichts schreiben. Zum Abschalten schreiben Sie enabled = false unter [agents].

F. Wie verhindere ich, dass Claude Code von selbst Subagenten startet?

A. Um Subagenten ganz zu blockieren, fügen Sie Agent zu permissions.deny in Ihren Berechtigungseinstellungen hinzu. Um nur Subagenten zu stoppen, die die Unterhaltung übernehmen (Forks), verwenden Sie Agent(fork) oder die Umgebungsvariable CLAUDE_CODE_FORK_SUBAGENT=0. Sind agent teams aktiviert, kann ein namentlich genannter Subagent als Teammitglied starten; lassen Sie agent teams daher deaktiviert, wenn Sie sie nicht nutzen.