zcf: Claude Code und Codex per CLI einrichten, ohne Konfigurationsarbeit

Welches Problem zcf überhaupt löst

Claude Code und Codex sind Befehlszeilenwerkzeuge, die ihre Konfiguration aus mehreren Quellen beziehen: Zugangsdaten für den Modellanbieter, Workflow-Dateien, MCP-Server-Einträge und sprachabhängige Einstellungen. Wer beides parallel nutzt, pflegt diese Dateien doppelt. zcf setzt genau dort an. Das Projekt bezeichnet sich selbst als Zero-Config Code Flow und verspricht laut README ein Zero-config, one-click setup für Claude Code und Codex, dazu zweisprachige Oberfläche, ein Agent-System und einen persönlichen Assistenten. Zielgruppe sind nach dieser Beschreibung Entwickler, die mehrere Agent-Werkzeuge nebeneinander betreiben und die Ersteinrichtung nicht jedes Mal von Hand wiederholen wollen. Der Nutzen liegt in der Wiederholbarkeit, nicht in einer neuen Agent-Fähigkeit. Wer nur ein Werkzeug auf einem Rechner nutzt, gewinnt wenig.

Der Ablauf hinter npx zcf i

Der Einstieg ist ein npm-Paket ohne globale Installation. Das README empfiehlt npx zcf, um ein interaktives Menü zu öffnen, aus dem heraus die benötigten Teile gewählt werden. Der eigentliche Installationslauf ist npx zcf i, beschrieben als Full initialization: install plus workflows plus API beziehungsweise CCR plus MCP. Ein zweiter Befehl, npx zcf u, aktualisiert nur die Workflows und lässt den Rest unangetastet. Damit ist die Datenflussrichtung klar: zcf liest die Auswahl aus dem Menü oder aus Flags, schreibt daraufhin Konfigurationsdateien für die beiden Agent-Werkzeuge und zieht die Workflow-Dateien aus dem Projekt. Ein Modellaufruf findet in diesem Schritt nicht statt. Das Werkzeug ist ein Installer und Konfigurator, kein Proxy und keine Laufzeitkomponente. Diese Trennung ist wichtig für die Fehlersuche: Bricht später ein Agent-Lauf ab, liegt die Ursache in den geschriebenen Dateien oder beim Anbieter, nicht in zcf selbst.

Nicht interaktiv mit Provider-Preset

Für Skripte und Provisionierung ist der nicht interaktive Modus relevant. Das README gibt dieses Beispiel: npx zcf i -s -p 302ai -k "sk-xxx". Der Schalter -s steht für den stillen Lauf, -p wählt ein Anbieter-Preset, -k übergibt den Schlüssel direkt auf der Kommandozeile. Dass 302ai als Preset existiert, passt zur Liste der Sponsoren im README, zu denen mehrere API-Relay-Dienste zählen. Für die Sprachumschaltung nennt das README npx zcf --lang zh-CN. Das ist eine der wenigen Stellen, an denen die Dokumentation einen konkreten Schlüsselwert zeigt. Wer den stillen Modus nutzt, sollte beachten, dass der Schlüssel als Argument im Prozessaufruf landet und damit je nach System in der Prozessliste oder in Shell-Historien sichtbar sein kann. Das README thematisiert diesen Punkt nicht. Für CI-Umgebungen ist das eine Abwägung, die man selbst treffen muss.

Was die Dokumentationslage hergibt und was nicht

Das README ist kurz. Es verweist für Details auf die externe Dokumentationsseite und enthält im Wesentlichen die drei Befehle, ein nicht interaktives Beispiel und die Sponsorenliste. Die interne Struktur der Workflows, das Format der geschriebenen Dateien und die Frage, ob bestehende Konfigurationen überschrieben oder ergänzt werden, lassen sich daraus nicht beantworten. Auch zu den Themen Agent-System und persönlicher Assistent bleibt der Text bei einer Erwähnung in der Projektbeschreibung. Wer vor der Einführung wissen will, welche Pfade zcf anfasst, muss das interaktive Menü öffnen oder in die Quelldateien sehen. Diese Zurückhaltung ist kein Fehler des Projekts, aber sie verschiebt die Prüflast auf den Anwender. Bei einem Werkzeug, das fremde Konfigurationsdateien schreibt, ist das ein realer Kostenfaktor.

Grenzen und Fälle, in denen zcf das falsche Werkzeug ist

zcf ist an Node.js gebunden, da es als npm-Paket verteilt und per npx gestartet wird. In Umgebungen ohne Node.js und ohne Paketmanager ist es damit nicht einsetzbar. Ein zweiter Punkt ist die zeitliche Kopplung an zwei fremde Produkte. Ändern Claude Code oder Codex das Format ihrer Konfiguration, muss zcf nachziehen. Die veröffentlichten Versionen zeigen diesen Rhythmus: zcf@3.7.1 im Juli, zcf@3.7.2 Anfang August, zcf@3.7.3 Ende August 2026. Drei Releases in rund sechs Wochen sind ein Hinweis auf aktive Pflege, aber auch darauf, dass die Oberfläche der Zielwerkzeuge in Bewegung ist. Wer eine streng kontrollierte Umgebung betreibt, in der jede Änderung an Agent-Konfigurationen durch ein Review muss, wird mit einem Werkzeug, das mehrere Dateien in einem Lauf schreibt, schwerer auditieren als mit einer handgepflegten Vorlage im Repository. Und wer nur einen Anbieter mit einem Schlüssel nutzt, für den ist der Einrichtungsaufwand ohnehin einmalig.

Alternative: eigene Konfigurationsvorlagen im Repository

Der naheliegende Vergleich ist kein anderes CLI-Werkzeug, sondern die manuelle Variante: die Konfigurationsdateien für Claude Code und Codex direkt im Projekt-Repository versionieren und per Symlink oder Kopierskript an den richtigen Ort bringen. Der Unterschied liegt im Zeitpunkt der Kontrolle. Bei der Vorlage im Repository sieht man im Diff genau, was sich ändert, und die Anpassung an ein neues Dateiformat ist eine bewusste Änderung. Bei zcf delegiert man diesen Schritt an das Paket und bekommt dafür die Anbieter-Presets und die Workflow-Aktualisierung über npx zcf u ohne eigene Arbeit. Das ist ein Tausch von Transparenz gegen Geschwindigkeit. Für einzelne Entwickler mit wechselnden Rechnern fällt die Wahl meist zugunsten von zcf aus. Für Teams mit Compliance-Anforderungen an die Herkunft von Konfigurationen eher zugunsten der eigenen Vorlage.

Pflegeaufwand, Lizenz und was vor dem Einsatz zu prüfen ist

zcf steht unter der MIT-Lizenz. Das erlaubt kommerzielle Nutzung, Veränderung und Weitergabe, solange der Lizenztext und der Urheberrechtshinweis beibehalten werden. Das Projekt haftet nach dieser Lizenz nicht für Schäden aus der Nutzung, was bei einem Werkzeug, das Zugangsdaten verarbeitet, relevant ist. Eine rechtliche Bewertung ersetzt das nicht. Der Pflegeaufwand verteilt sich auf zwei Seiten: das Paket selbst und die beiden Agent-Werkzeuge, deren Formate es bedient. Ein Upgrade von zcf ist ein npm-Vorgang, aber die Auswirkung zeigt sich erst beim nächsten Initialisierungslauf, wenn Workflows neu geschrieben werden. Das README empfiehlt für die Aktualisierung ausdrücklich den eingeschränkten Befehl npx zcf u, der nur die Workflows anfasst. Wer diesen Befehl statt eines vollständigen npx zcf i verwendet, begrenzt den Radius einer Aktualisierung auf genau diesen Teil. Das ist der konkreteste Hinweis, den das Material zur Upgrade-Strategie hergibt.

Redaktionelles Fazit

Wer Claude Code oder Codex auf mehreren Rechnern oder im Team nach einem einheitlichen Muster aufsetzen will, findet in zcf eine schlanke Automatisierung mit MIT-Lizenz und überschaubarem Umfang. Wer bereits eine eigene, getestete Konfiguration pflegt oder keinen Node.js-Paketmanager einsetzen darf, sollte nicht wechseln. Vor dem ersten produktiven Einsatz lohnt ein Blick in das interaktive Menü von npx zcf, um zu sehen, welche Dateien der gewählte Modus tatsächlich anfasst.

Offizielle Quellen

1. License: MIT
2. Project website
3. README
4. Releases
5. UfoMiao/zcf on GitHub