ZCode erklärt: Was der Coding-Agent kann und wie du ihn verwendest

Was ist ZCode?

Stell dir vor, du willst in einer bestehenden Web-App einen Fehler beheben. In einem normalen Editor suchst du die betroffenen Dateien, änderst den Code und startest die Tests selbst. In ZCode beschreibst du dem Agenten das Ziel. Er kann sich im Projekt orientieren, Dateien bearbeiten und Werkzeuge ausführen. Du entscheidest über den Berechtigungsmodus, siehst dir die Änderungen an und prüfst das Ergebnis.

ZCode nennt sich Agentic Development Environment (ADE). Das ist mehr als ein Chatfenster für Code: Die Desktop-App bündelt Aufgaben, Dateiansicht, Terminal, Git-Kontext und einen eingebauten Browser. Laut Repository-README gibt es außerdem Web- und Terminal-Oberflächen. Nicht jede Funktion ist in jeder Oberfläche verfügbar; die Browsersteuerung etwa ist laut Dokumentation auf den Desktop beschränkt.

Wichtig ist die Trennung zwischen ZCode und dem Modell: ZCode organisiert Arbeitsbereich, Werkzeuge, Berechtigungen und Oberfläche. Das angeschlossene Modell liefert die Antworten und entscheidet im Rahmen seiner Rechte über die nächsten Schritte. Z.ai stellt den eigenen ZCode Agent mit GLM in den Vordergrund, dokumentiert aber auch kompatible Modellanbieter. Den Unterschied zwischen Modell und Ausführungsumgebung erkläre ich ausführlicher in Was ist ein AI Harness?.

Infografik: Schematische Übersicht der Komponenten und Berechtigungsmodi. Die dargestellten GLM-Fähigkeiten stammen aus Angaben von Z.ai; die Grafik ist kein eigener Funktionstest.

Wie fängst du mit ZCode an?

Für einen ersten Versuch würde ich kein echtes Kundenprojekt öffnen, sondern ein kleines Test-Repository ohne Zugangsdaten. So lernst du die Oberfläche kennen, ohne einem neuen Agenten gleich Zugriff auf sensible Dateien zu geben.

1. App installieren: Lade ZCode über die offizielle Installationsseite für macOS, Windows oder Linux. Die Seite bietet je nach System andere Pakete an. Ein Download der Desktop-App ist etwas anderes als das Bauen des GitHub-Repositories aus dem Quellcode.
2. Modell verbinden: Beim ersten Start kannst du dich mit Z.ai beziehungsweise BigModel verbinden oder einen API-Zugang einrichten. Ohne nutzbaren Modellzugang beantwortet der Agent keine Entwicklungsaufgaben. Den Anbieter kannst du später über den Modellwähler und Manage Models ändern. Die App selbst ist laut ZCode-FAQ kostenlos; Modellpläne, API-Nutzung und Kontingente sind davon getrennt.
3. Projektordner öffnen: Wähle ein lokales Verzeichnis als Workspace. Dateien und Ordner kannst du im Chat mit `@` referenzieren. Für feste Projektregeln liest ZCode laut Agent-Dokumentation eine `AGENTS.md` im Workspace oder unter `~/.zcode/AGENTS.md`. Eine vorhandene `CLAUDE.md` wird nicht automatisch als laufende Projektregel verwendet.
4. Berechtigungsmodus wählen: Starte mit Ask before changes. In diesem dokumentierten Standardmodus fragt der Agent vor Dateiänderungen und Befehlen nach. Plan eignet sich, wenn du vor einem größeren Umbau erst den Ansatz sehen willst. Full access reduziert Rückfragen und ist für den Einstieg keine gute Wahl. Details stehen in der Berechtigungsdokumentation.
5. Eine kleine, überprüfbare Aufgabe stellen: Bitte zunächst um Analyse und einen Vorschlag, dann um die Umsetzung. Lies die angezeigten Befehle vor einer Freigabe und kontrolliere hinterher die geänderten Dateien und Tests.

Eine brauchbare erste Anfrage wäre zum Beispiel:

Untersuche, warum das Suchformular nach dem Zurücknavigieren seinen Filter verliert. Nenne zuerst die betroffenen Dateien und deinen Lösungsansatz. Ändere nur die dafür nötigen Stellen, führe die vorhandenen Tests aus und zeige mir anschließend die Änderungen und offene Risiken.

Das ist absichtlich enger als „Mach die App besser“. Der Agent bekommt ein beobachtbares Problem, einen begrenzten Änderungsumfang und ein klares Prüfkriterium. Ob er es tatsächlich löst, musst du am Ergebnis und an den Tests feststellen – nicht an einer überzeugend formulierten Abschlussmeldung.

Wie läuft die Arbeit mit dem Agenten ab?

ZCode verwaltet Aufgaben und Dateien pro Workspace. Du kannst eine Datei oder einen Ordner als Kontext anhängen, das Modell wählen und die Aufgabe im Chat verfolgen. Bei einer anstehenden Freigabe zeigt dir die Oberfläche laut Safety-Dokumentation, welche Aktion der Agent ausführen will. Allow gilt für diese eine Aktion; Always Allow senkt die Hürde auch für spätere Aktionen desselben Typs.

Nach einer Änderung solltest du drei Dinge getrennt prüfen: Was wurde geändert? Laufen die Tests? Funktioniert die betroffene Oberfläche? Für Web-Projekte kann der eingebaute Browser beim letzten Punkt helfen: Laut Dokumentation kann der Agent dort eine lokale Seite öffnen, Formulare bedienen und Screenshots aufnehmen. Das ist eine Funktion des Desktop-Produkts, keine von mir durchgeführte Browserprüfung.

Für längere Aufgaben gibt es den dokumentierten Goal Mode. Mit `/goal <konkretes Ziel>` kann der Agent nach einer Runde prüfen, ob das Ziel erreicht ist, und andernfalls weiterarbeiten. Ein Ziel wie „Tests bestehen und der Fehler ist im Browser nicht mehr reproduzierbar“ ist sinnvoller als „verbessere die Qualität“. Der Modus ersetzt trotzdem kein Code-Review: Er bewertet das Ziel innerhalb des eigenen Arbeitsablaufs, nicht als unabhängiger Prüfer.

Wo könnte ZCode Vorteile haben?

Das sind mögliche Vorteile aus Funktionen und Architektur, keine gemessenen Zeitgewinne. Wer bereits mit Claude Code oder Codex produktiv ist, sollte ZCode nicht wegen eines vermeintlichen Leistungsabstands wechseln. Codex hat selbst ein öffentliches Repository, und Claude Code ist längst nicht mehr auf ein Terminalfenster beschränkt. ZCodes konkreter Reiz liegt für mich in der Kombination aus eigenständigem Workspace, GLM-Anbindung, mehreren Oberflächen und offenem Code – sofern dieser Workflow zu deinem Projekt passt.

Was musst du bei Daten und Berechtigungen beachten?

Ein Coding-Agent kann weit mehr als Text erzeugen: Er kann Projektdateien lesen, Befehle starten und unter Umständen Netzwerkverbindungen herstellen. Die ZCode-NOTICE weist ausdrücklich darauf hin, dass der gemeinsame Agent-Ausführungsadapter standardmäßig keine Betriebssystem-Sandbox bietet. Die Rechte des Betriebssystemkontos sind deshalb eine reale Grenze – ein separates Verzeichnis allein ist keine Isolation.

Dazu kommt ein konkreter Anlass zur Vorsicht: Reuters berichtete am 21. September 2026 über von Nutzern gemeldete, ungewollte Uploads lokaler Repositories im Zusammenhang mit Codebase Indexing. Z.ai erklärte laut Reuters, die Ursache behoben und betroffene Funktionen deaktiviert zu haben. Die Aussage zur Löschung der Daten ist eine vom Unternehmen berichtete Prüfung; Nutzer konnten die Löschung verschlüsselter Archive laut Reuters nicht selbst nachweisen. Ich habe weder die betroffenen Systeme noch den Patch überprüft.

Deshalb: Starte mit einem synthetischen Projekt ohne Kundendaten oder Schlüssel, prüfe Modell- und Netzwerkwege und lass riskante Befehle bestätigen. Eine separate VM oder ein bewusst beschränkter Container kann bei einer technischen Erprobung sinnvoll sein; beides muss korrekt konfiguriert werden. Besonders bei automatisierten Aufrufen darfst du nicht einfach den interaktiven Standardmodus voraussetzen: Im von mir gelesenen CLI-Quellstand verwendet `–prompt` ohne explizite Modusangabe einen `yolo`-Default. Das ist keine Aussage über jede Desktop-Sitzung.

Einordnung meiner Recherche: Ich habe Dokumentation und Repository untersucht und sieben statische Dateiprüfungen an Commit `29628c9` durchgeführt. Ich habe ZCode nicht installiert oder als Agenten ausgeführt. Die obigen Schritte beschreiben den dokumentierten Weg; sie sind kein eigener Erfahrungsbericht und kein Vergleichstest der Coding-Qualität.

FAQ: Häufige Fragen zu ZCode

Ist ZCode ein Modell wie GLM?

Nein. ZCode ist die Arbeitsumgebung samt Agenten-Werkzeugen. Ein verbundenes Modell wie GLM verarbeitet die Aufgaben. ZCode dokumentiert auch kompatible Anbieter über OpenAI- und Anthropic-Protokolle.

Brauche ich zum Einstieg einen API-Schlüssel?

Nicht zwingend: Die Modellkonfiguration beschreibt auch die Kontoverbindung mit Z.ai oder BigModel. Für manuelle API-Anbindung brauchst du einen passenden Zugang. Ohne Modellzugang funktioniert die Agentenarbeit nicht.

Kann ZCode auf einem Server statt lokal arbeiten?

Laut Remote-Development-Dokumentation lassen sich Workspaces per SSH sowie in laufenden Docker-Containern öffnen. Dateien, Befehle und Agentenaktionen laufen dann in der verbundenen Umgebung. Prüfe dort besonders den verwendeten Benutzer und dessen Rechte.

Ist der offene Quellcode ein Sicherheitsversprechen?

Nein. Die Apache-2.0-Lizenz macht den Erstanbietercode prüfbar, sagt aber nichts über die Sicherheit eines konkreten Builds, angeschlossener Dienste oder deines Berechtigungsmodus aus.

Fazit

Wenn du ZCode kennenlernen willst, fang mit einem kleinen, nicht vertraulichen Projekt an: App installieren, Modell verbinden, Workspace öffnen, Ask before changes wählen und eine klar überprüfbare Aufgabe stellen. Der mögliche Gewinn liegt in einem zusammenhängenden Arbeitsablauf aus Agent, Projektdateien und Prüfwerkzeugen – nicht in einer von mir belegten Überlegenheit gegenüber Claude Code oder Codex. Für sensible Repositories wäre ich angesichts des gemeldeten Datenvorfalls und der fehlenden Standard-OS-Sandbox derzeit zurückhaltend.

Quellen

Herstellerdokumentation und Quellcode

• ZCode: Installation und erste Schritte, abgerufen am 28. September 2026.
• ZCode: Modelle verbinden, abgerufen am 28. September 2026.
• ZCode Agent: Workspace, Kontext und AGENTS.md, abgerufen am 28. September 2026.
• ZCode: Berechtigungsmodi, abgerufen am 28. September 2026.
• ZCode: Goal Mode, abgerufen am 28. September 2026.
• ZCode: Browser Automation, abgerufen am 28. September 2026.
• ZCode: Remote Development, abgerufen am 28. September 2026.
• ZCode Repository, README, LICENSE und NOTICE, geprüfter Commit `29628c9`, abgerufen am 28. September 2026.
• OpenAI Codex Repository und Claude Code Übersicht, abgerufen am 28. September 2026.

Externe Berichterstattung

• Reuters: Z.ai disables AI coding assistant features after security issue, veröffentlicht am 21. September 2026.