Tutorial
Aufgaben von Claude Code und Codex an Ancilo delegieren
Ancilo kann über MCP als lokaler Arbeiter für Claude Code oder Codex dienen. Der aufrufende Agent übergibt einen Auftrag und ein Projektverzeichnis; das lokale Modell bearbeitet die Aufgabe mit den erlaubten Werkzeugen. Die Verbindung ersetzt nicht automatisch das Modell des aufrufenden Dienstes und macht dessen übrige Arbeit nicht lokal.
Modell und Verbindung einrichten
Vorausgesetzt werden Ancilo mit einem eingerichteten lokalen Modell sowie der installierte Client, aus dem die Aufgabe übergeben werden soll. Das Modell muss in den aktuell freien Arbeitsspeicher passen. Eine installierte Modelldatei allein bedeutet noch nicht, dass es gleichzeitig mit allen anderen Programmen geladen werden kann.
In Ancilo unter System im Abschnitt Claude Code und Codex den gewünschten Client verbinden, oder in der Kommandozeile mit den folgenden Befehlen. Für den Einstieg genügt die Verbindung zu einem der beiden Clients. In Versionen vor 0.3.0 schlug das Verbinden aus der App mit „cannot run claude“ fehl; dann zuerst aktualisieren.
Codex fragt vor jedem Aufruf eines Ancilo-Werkzeugs nach. In nicht interaktiven Läufen (codex exec) kann es nicht fragen; dort müssen Ancilos Werkzeuge vorab freigegeben werden. Der passende Befehl steht in der Delegationsdokumentation.
ancilo connect claude
ancilo connect codexMit einem begrenzten Leseauftrag beginnen
Ein erster Auftrag zum Zusammenfassen weniger Dateien lässt sich ohne Schreibzugriff prüfen. Er sollte das absolute Projektverzeichnis, die relevanten Dateien und das erwartete Ergebnis nennen. Ohne Angabe gilt allow: edit – der Lesezugriff muss also ausdrücklich verlangt werden. Der Client benötigt Zugriff auf das Ancilo-Werkzeug; seine jeweiligen Werkzeugfreigaben gelten weiterhin.
Delegiere an Ancilo einen reinen Leseauftrag für das Projekt /absoluter/pfad/zum/projekt. Fasse src/parser.rs und die zugehörigen Tests zusammen. Nenne die behandelten Eingaben und die bereits getesteten Fehlerfälle mit Dateiverweisen. Keine Dateien ändern und keine Shell-Befehle ausführen. Verwende allow: read.
Schreibzugriff und Hintergrundarbeit unterscheiden
Für Änderungen erlaubt allow: edit das Lesen und Schreiben im Projekt. allow: shell erlaubt zusätzlich Befehle in einer Sandbox ohne Netz; diese Freigabe sollte nur gewählt werden, wenn der Auftrag sie benötigt. Was delegierte Aufgaben höchstens dürfen, begrenzt Ancilo selbst: im Bereich Code unter Coding Tasks (sichtbar in der Expertenansicht), wo auch laufende Aufgaben erscheinen. Bei synchroner Delegation arbeitet Ancilo unmittelbar im Projekt; hier gilt nicht das Kopierverfahren aus dem Bereich Aufgaben.
Mit background: true arbeitet eine delegierte Aufgabe in einem eigenen Git-Worktree auf dem Branch ancilo/<id> und committet dort. Der aufrufende Agent erhält sofort eine Aufgaben-ID; das Ergebnis lässt sich später abrufen, etwa mit ancilo task <id> --diff --wait. Die Änderungen bleiben auf diesem Branch, bis sie nach Prüfung zusammengeführt werden. Dafür muss das Projekt ein Git-Repository sein.
Welches Modell die Arbeit übernimmt, bestimmt Ancilo: ein im Auftrag genanntes Modell, sonst eine Regel für die Art der Aufgabe, sonst das Modell, das in Ancilo für die Coding Tasks von Claude Code und Codex eingestellt ist (Rolle delegation), sonst das Standardmodell. ancilo route zeigt, welches Modell eine Aufgabenart verwenden würde und warum.
git merge ancilo/<id>Ergebnis und tatsächliche Änderungen prüfen
Die Rückgabe enthält eine Zusammenfassung und Angaben zu geänderten Dateien. Bei einem Leseauftrag lassen sich die genannten Stellen unmittelbar vergleichen. Bei Änderungen sind der Diff und passende Projektprüfungen maßgeblich; eine Erfolgsmeldung des Modells ersetzt sie nicht.
Für die lokale Bearbeitung selbst entstehen keine Gebühren pro Modellanfrage. Die Arbeit des aufrufenden Cloud-Agenten kann weiterhin Kosten oder Nutzungslimits verursachen. Ebenso bestimmt dessen Nutzung, welche Informationen außerhalb von Ancilo verarbeitet werden. Die lokale Delegation allein ist kein Versprechen, dass der gesamte Arbeitsablauf auf dem Computer bleibt.