Coding-Agent oder Modell wechseln – ohne die Aufgabe zu verlieren
Aufgaben zwischen Coding-Agents und Modellen mit einem strukturierten Handoff, ohne Geheimnisse und mit einer fokussierten Prüfung übergeben.
Wenn Entwickler komplexe Engineering-Probleme bearbeiten, wechseln sie oft zwischen Coding-Agents: Sie beginnen etwa die Architekturplanung in Claude Code und lassen anschließend einen algorithmischen Refaktor oder die Testgenerierung von Codex oder einem anderen Modell prüfen. Wird jedoch der gesamte alte Chatverlauf in den neuen Agent kopiert, füllt er dessen Kontext mit überholten Hypothesen. Das kostet Token und Zeit.
Ein Modellwechsel ist nur dann sinnvoll, wenn er auf einer formalisierten, portablen Handoff-Karte und einem gezielten Prüfschritt beruht – nicht auf dem Versuch, einen unbegrenzten Chatverlauf zu übertragen.
1. Wechsel vergleichen: Modell, Tool oder API-Anbieter
Verwechseln Sie nicht drei grundsätzlich verschiedene Vorgänge:
2. Tool-Auswahl nach Szenario
Wählen Sie anhand der aktuellen Anforderungen:
- Option 1 (Claude Code): Sinnvoll für interaktive Erkundung einer Codebasis, komplexe Architektur-Refaktoren über mehrere Dateien und flexible Shell-Tools.
- Option 2 (Codex CLI / Custom Provider): Sinnvoll für deterministische Testgenerierung, direkte Ausführung über die OpenAI-kompatible Responses API oder eine unabhängige zweite Einschätzung zu einem vorbereiteten Diff.
3. Das portable Handoff-Protokoll
Um einen Aufgabenstand ohne Prompt-Ballast zuverlässig zu übertragen, schreiben Sie eine strukturierte Handoff-Karte, die nur verifizierte Fakten enthält:
Task Handoff: Database Connection Pool Limits
- Goal: Enforce max_connections=20 and add a 5s connection acquisition timeout.
- Current State: Branch
perf/db-pool-limitscreated; modifiedconfig/database.go. - Verified Progress: Test
go test ./config -run TestPoolLimitspasses. - Unresolved Blocker: Under
wrkload, pool exhaustion crashes without returning HTTP 503. - Target Check for Next Agent: Implement 503 error handling on pool timeout and verify with a test.
4. Schrittweise wechseln und verifizieren
Gehen Sie bei der Übergabe an einen anderen Agent in diesen fünf Schritten vor:
- Schritt 1: Git-Status sichern. Prüfen und stashen Sie nicht eingecheckte Änderungen:
git status --short. Speichern Sie danach die strukturierte Handoff-Karte. - Schritt 2: Neue Sitzung starten. Starten Sie den zweiten Agent in einem isolierten Git-Worktree oder einem sauberen Terminalfenster.
- Schritt 3: Nur die Handoff-Karte übergeben. Geben Sie dem neuen Agent das Aufgabenziel und den Prüfschritt, aber keinen alten Chatverlauf.
- Schritt 4: Den fokussierten Prüfschritt ausführen. Der Agent soll den Zieltest ausführen und die geänderten Dateien prüfen:
git diff --check. - Schritt 5: Anhand beobachtbarer Ausgabe entscheiden. Löst das zweite Modell den Blocker sauber, arbeiten Sie in diesem Branch weiter. Andernfalls kehren Sie ohne zusätzlichen Regressionsaufwand zur primären Sitzung zurück.
So verhindert der Ablauf aufgeblähte Prompts und macht den Modellwechsel zu einem objektiven, messbaren Engineering-Experiment.