Bisher hat man Agenten auf der Claude Platform per API-Call oder Console angelegt. Das Ergebnis lebte irgendwo in Anthropics Backend, mit einer ID, die man sich merken musste, und einem Zustand, den niemand im Git nachvollziehen konnte. Mit ant apply, seit 3. September in Version 1.30.0 der ant CLI, ändert sich das. Agenten werden zu Dateien im Repo.
Wie es funktioniert
Man legt eine Markdown-Datei unter agents/ an. Das Frontmatter hält die Konfiguration, also Name, Modell, Tools, Skills. Der Text darunter ist der System-Prompt. Dann ant apply agents/summarizer.md. Die CLI zeigt einen Plan an, was angelegt oder geändert würde, wartet auf ein Ja, und schreibt anschließend eine claude-lock.json. Diese Lockfile merkt sich die ID jeder erzeugten Ressource plus zwei Hashes: was zuletzt gesendet wurde und was die API zurückgegeben hat. Beim nächsten Lauf erkennt die CLI so, ob eine Datei editiert wurde oder ob jemand die Ressource außerhalb der Dateien verändert hat.
Die Lockfile gehört ins Git. Denn genau das ist der Punkt: Der nächste Lauf, ob auf deinem Rechner oder in der CI, aktualisiert dieselben Ressourcen, statt neue anzulegen. --dry-run zeigt den detaillierten Plan ohne etwas zu ändern.
Neben Agenten gehen auch Environments (YAML), Memory Stores (YAML), Deployments (Markdown, der Text wird zur ersten Nachricht jeder Session) und Skills (ein Ordner mit SKILL.md, der als Bundle hochgeladen wird). ant apply . verarbeitet das ganze Verzeichnis auf einmal.
Der eigentliche Trick: relative Pfade statt IDs
Ressourcen verweisen aufeinander per Dateipfad. Wo die API eine ID erwartet, schreibt man ../skills/pr-summary oder ./reviewer.md. Die CLI legt alles in Abhängigkeitsreihenfolge an und setzt die echten IDs ein. Anthropics Beispiel ist ein Reviewer-Agent mit einem PR-Summary-Skill, ein Lead-Agent, der den Reviewer als Koordinator im Roster hat, ein Cloud-Environment, ein Memory Store für wiederkehrende Review-Notizen und ein nächtliches Deployment per Cron, das offene Pull Requests durchgeht. Alles zusammen: sechs kleine Dateien.
Agent- und Skill-Referenzen werden auf die gerade angewendete Version gepinnt. Wer reviewer.md ändert, aktualisiert im selben Lauf alles, was darauf zeigt. Skills lassen sich außerdem direkt aus GitHub referenzieren, etwa ein Ordner aus Anthropics Skills-Repo, festgenagelt auf den aufgelösten Commit, bis man mit --upgrade nachzieht.
Warum mich das freut
Ich habe in den letzten Monaten mehrfach erlebt, wie schnell Agenten-Setups zu Wildwuchs werden. Drei Versionen eines Agenten in der Console, keiner weiß mehr, welche produktiv ist, der System-Prompt liegt in einem Slack-Thread. Das ist genau das Problem, das Terraform vor Jahren für Server gelöst hat: Konfiguration ins Repo, Plan vor Apply, State-File als Wahrheit.
Dass Anthropic das Muster jetzt eins zu eins übernimmt, inklusive Lockfile und Dry-Run, ist konsequent. Agenten laufen damit durch dieselbe Code-Review wie der Rest. Wer heute schon mit der Managed-Agents-API arbeitet, sollte das Wochenende nutzen und seine Agenten in Dateien gießen. Danach will man nicht mehr zurück.
Quellen: Claude Platform Release Notes (3. September 2026), Docs: Manage resources as code with ant apply