ZCode Einsteiger-Tutorial

ZCode ist eine von Zhipu eingeführte Entwicklungsumgebung für Entwickler-Agenten, auch bekannt als Agentic Development Environment, abgekürzt ADE. Im Gegensatz zu herkömmlichen Editoren verfügt sie über einen KI-Assistenten, der tiefgehend in Projekten arbeiten, Projekte ansehen, Dateien ändern, Befehle ausführen und Codeänderungen nachvollziehen kann.

ZCode kann KI-Agenten mit echten Projekten verbinden und den gesamten Entwicklungsablauf von Anforderungsanalyse, Codeänderung, Test, Code-Review und Prüfungen vor dem Start an einem Ort abschließen.

Gewöhnliche KI-Tools können nur verstreute Codefragmente generieren. ZCode unterstützt das Erteilen vollständiger Entwicklungsaufgaben in natürlicher Sprache und eignet sich für Nutzer, die die Entwicklung mit natürlicher Sprache vorantreiben möchten.

Der Kern von ZCode ist nicht einfaches Chatten, sondern das kontinuierliche Vorantreiben einer vollständigen Aufgabe rund um ein Entwicklungsziel.

Konzept Beschreibung Geeignete Szenarien
ZCode Eine Entwicklungsumgebung für KI-Agenten. Für diejenigen, die die Entwicklung echter Projekte mit natürlicher Sprache vorantreiben möchten.
ZCode Agent Der Agent, der dafür verantwortlich ist, Aufgaben zu verstehen, Kontext zu lesen, Code zu ändern und Ergebnisse zu überprüfen. Komplexe Anforderungszerlegung, Codegenerierung, Debugging, Tests.
Langfristige Aufgabe Entwicklungsaufgaben, die sich über einen langen Zeitraum erstrecken und viele Schritte umfassen. Module refaktorisieren, komplexe Fehler beheben, vollständige Funktionen implementieren.
Arbeitsbereich Der Ort, an dem ZCode Projektdateien, Terminal, Git-Status und Aufgabenkontext verwaltet. Ein vorhandenes Projekt öffnen oder ein neues Projekt in einem Verzeichnis erstellen.

Wofür ZCode geeignet ist

ZCode eignet sich für Entwicklungsarbeiten, die fortlaufenden Kontext erfordern. Es kann Dateien lesen, die Projektstruktur verstehen, Befehle ausführen und nach Abschluss der Änderungen eine Zusammenfassung liefern.

Diese Art von Fähigkeit eignet sich für echte Entwicklungsarbeit, nicht nur für einmalige Frage-und-Antwort-Abläufe.

Aufgabentyp Was Sie ZCode tun lassen können Beispiel-Prompt
Entwicklung neuer Funktionen Projektstruktur anhand der Anforderungen prüfen, zugehörige Dateien erstellen oder ändern. Hilf mir, diesem Projekt eine Login-Seite hinzuzufügen und sie in das bestehende Routing zu integrieren.
Fehlerbehebung Finde die Ursache des Fehlers, ändere den Code und führe Verifikationsbefehle aus. Behebe das Problem, dass die Seite nach dem Klicken auf eine Schaltfläche auf dem Mobilgerät flackert.
Codeverständnis Kläre die Modulbeziehungen und erkläre die Aufrufkette eines Features vom Einstieg bis zur Implementierung. Hilf mir zu erklären, wie der Zahlungsablauf dieses Projekts funktioniert.
Code-Review Prüfe Änderungsrisiken, gib Inline-Vorschläge oder Verbesserungsrichtungen an. Bitte überprüfe die aktuellen Änderungen mit Fokus auf Regressionsrisiken.
Release-Vorbereitung Generiere Changelog, organisiere Release Notes, prüfe den Git-Status. Erstelle einen Entwurf einer Release Note basierend auf den letzten Commits.

Installation von ZCode

Nachdem du die offizielle chinesische ZCode-Website aufgerufen hast, kannst du auf der Startseite auf den Download-Eintrag klicken.

Die offizielle Website-Adresse isthttps://zcode.z.ai/cn。

Auf der offiziellen Website werden die aktuell verfügbaren Download-Versionen angezeigt, mit Unterstützung für Windows, macOS und Linux. Normalerweise zeigt die offizielle Website die Download-Schaltfläche für das aktuelle System:

Nach dem Herunterladen einfach zum Installieren klicken:

Grundlegende Vorbereitung nach der Installation

Beim ersten Start gelangen Sie auf die Seite „Ersteinrichtung“. Nachdem Sie sie abgeschlossen haben, klicken Sie unten links auf „Verbinden und verwenden“, um zur Anmeldeseite zu gelangen:

Wenn Sie Modelldienste nutzen möchten, müssen Sie außerdem die Konfiguration für API-Schlüssel oderCoding Planabschließen. Sie können sich auch anmelden und sie dann auf der Einstellungsseite konfigurieren:

Das offizielle kostenlose Kontingent ist derzeit sehr begrenzt und reicht im Grunde nicht aus. Wir empfehlen die folgenden Coding Plan-Pakete:

Als Nächstes nehmen wirByteDance Arks Coding Planals Beispiel für die Konfiguration. Besuchen Sie ArkCoding Plan Event, abonnieren Sie je nach Bedarf einen Plan. Bei geringer Nutzung reicht die Lite-Version; bei sehr hoher Nutzung können Sie die Pro-Version verwenden.

Klicken Sie nach einem erfolgreichen Kauf aufAPI-Schlüssel erstellen：

Klicken Sie dann auf die Schaltfläche „Erstellen“:

Klicken Sie auf das kleine Augensymbol unten, um den API-Schlüssel anzuzeigen. Bei Bedarf einfach kopieren:

Verschiedene Tools haben je nach kompatiblem Protokoll unterschiedliche Base-URL-Konfigurationen:

  • Mit dem Anthropic-API-Protokoll kompatible Tools:https://ark.cn-beijing.volces.com/api/coding
  • Mit dem OpenAI-API-Protokoll kompatible Tools:https://ark.cn-beijing.volces.com/api/coding/v3

Hier wählen wirhttps://ark.cn-beijing.volces.com/api/coding, legen den API-Schlüssel auf deinen eigenen fest. Die Modellliste ermöglicht das Hinzufügen mehrerer Modelle. Hier trägst duKimi-K2.6ein, du kannst auch andere Modelle hinzufügen wie z. B.DeepSeek-V4-Pro：

Nach dem Hinzufügen kannst du testen, ob das Modell verfügbar ist:

Du kannst das hinzugefügte Modell unten rechts im Dialogfeld auf der Startseite sehen:

ZCode bietet Seiten für API-Key-Konfiguration, Nutzungsstatistiken, Benutzerfeedback und Support.

ZCode zum ersten Mal verwenden

Wir können mit einem einfachen Projekt beginnen, ZCode bitten, ein browserbasiertes Mini-Spiel zu erstellen, oder es bitten, die Verzeichnisstruktur eines vorhandenen Projekts zu erklären.

Dies hilft dir, schnell zu verstehen, wie ZCode funktioniert.

Öffnen oder Erstellen eines Arbeitsbereichs

Ein Arbeitsbereich kann als das Projektverzeichnis verstanden werden, das ZCode aktuell verarbeitet.

Du kannst ein vorhandenes Projektverzeichnis öffnen oder ein neues Projekt in einem leeren Verzeichnis starten.

ZCode liest Dateien, führt Befehle aus und verwaltet Änderungen innerhalb dieses Verzeichnisses.

Eine neue Aufgabe erstellen

In ZCode ist eine Aufgabe die grundlegende Einheit, die die Arbeit des Agenten antreibt.

Die Beispiele auf der offiziellen Website zeigen, wie Aufgaben in natürlicher Sprache beschrieben werden.

Die Seite zeigt außerdem das Tastenkürzel für neue Aufgaben an.⌘N。

Beispiel für das Erstellen einer neuen Aufgabe:

Create a smart Gomoku web game, including a game board, player moves, win/loss detection, and a simple computer opponent.

Beobachten des Ausführungsprozesses

Sobald eine Aufgabe startet, analysiert ZCode das Projekt anhand des Ziels und geht Schritt für Schritt vor.

Sie können den Aufgabenfortschritt, Ausführungsprotokolle, Dateiänderungen, Terminalausgaben und den Git-Status sehen.

Dies ist zuverlässiger als das bloße Kopieren eines Stücks KI-generierten Codes, da der Code zur Überprüfung wieder in das reale Projekt eingesetzt werden kann.

Schnittstellenbereich Zweck Worauf Anfänger achten sollten
Aufgabenfortschritt Zeigt die Aufschlüsselung und den Fertigstellungsstatus der aktuellen Aufgabe an. Bestätigen Sie, ob der Agent zielgemäß voranschreitet.
Terminal-Ausgabe Zeigt die Ergebnisse der Befehlsausführung an. Achten Sie auf Fehler und darauf, ob Verifikationsbefehle erfolgreich sind.
Dateiänderungen Zeigt Dateien an, die hinzugefügt, geändert oder gelöscht wurden. Prüfen Sie, ob die Änderungen den Erwartungen entsprechen.
Git-Status Zeigt den Versionskontrollstatus des aktuellen Arbeitsbereichs an. Bestätigen Sie vor dem Commit, dass er nur die Änderungen enthält, die Sie benötigen.

Ein vollständiges Anfängerbeispiel

Im Folgenden verwenden wir ein einfaches Frontend-Projekt, um zu demonstrieren, wie man ZCode Aufgaben zuweist.

Dieses Beispiel ist nicht auf ein Backend angewiesen und eignet sich daher für Anfänger, um den Ablauf zu verstehen.

Beispiel

Bitte helfen Sie mir, ein einfaches Webseiten-Zähler-Projekt zu erstellen.

Requirements:
1. Verwenden Sie drei Dateien: HTML, CSS und JavaScript.
2. Zeigen Sie den aktuellen Zählerwert auf der Seite an.
3. Stellen Sie drei Schaltflächen bereit: "Eins hinzufügen", "Eins abziehen" und "Zurücksetzen".
4. Halten Sie den Stil einfach und für Anfänger gut lesbar.
5. Führen Sie nach Abschluss bitte die erforderlichen Prüfungen aus und teilen Sie mir mit, welche Dateien erstellt wurden.

Dieser Prompt teilt ZCode klar mit, was erstellt werden soll, welche Dateien verwendet werden sollen, welche Funktionen enthalten sein sollen und dass die Ergebnisse nach Abschluss gemeldet werden müssen.

Je spezifischer der Prompt ist, desto wahrscheinlicher entspricht die Ausführung des Agenten den Erwartungen.

Dann erscheint eine Berechtigungsaufforderung; erteilen Sie die Berechtigung und klicken Sie auf Bestätigen:

Mögliche generierte Projektstruktur

Wenn du diese Aufgabe in einem leeren Verzeichnis ausführst, kann ZCode eine Dateistruktur ähnlich der untenstehenden erstellen.

counter-demo/
├── index.html
├── styles.css
└── app.js

Du kannst den Quellcode ansehen:

Anzeigeeffekt des Quellcodes:

Wie man gute Prompts für ZCode schreibt

ZCode kann natürliche Sprache verstehen, aber das bedeutet nicht, dass kürzere Prompts immer besser sind.

Ein guter Prompt sollte Ziel, Umfang, Einschränkungen und Akzeptanzkriterien enthalten.

Dies ermöglicht es dem Agenten, zuverlässiger zu planen und auszuführen.

Komponente Beschreibung Beispiel
Ziel Beschreibe, was du letztendlich erreichen möchtest. Füge eine Benutzereinstellungsseite hinzu.
Geltungsbereich Gib an, welche Teile geändert werden sollen und welche nicht. Ändere nur die Frontend-Seite, ändere nicht die Backend-APIs.
Einschränkungen Gib den Tech-Stack, den Stil und die Kompatibilitätsanforderungen an. Verwende die vorhandene Komponentenbibliothek, füge keine neuen Abhängigkeiten hinzu.
Akzeptanzkriterien Erkläre, wie der Erfolg nach Abschluss festgestellt werden kann. npm test läuft erfolgreich durch, und das Layout funktioniert ordnungsgemäß auf Mobilgeräten.

Beispiel

Bitte hilf mir, das Problem zu beheben, dass der Button auf der Anmeldeseite auf Mobilgeräten verdeckt wird.

Gültigkeitsbereich:
- Ändere nur Dateien, die mit der Anmeldeseite zusammenhängen.
- Ändere keine Backend-APIs.
- Füge keine Drittanbieter-Abhängigkeiten hinzu.

Requirements:
- Behalte den vorhandenen visuellen Stil bei.
- Passe es an mobile Bildschirme mit einer Breite von 375px an.
- Erkläre nach der Änderung bitte, welche Dateien geändert wurden.
- Wenn das Projekt Test- oder Prüfbefehle hat, führe sie bitte aus und melde die Ergebnisse.

Schreibe nicht einfach "Hilf mir, es zu optimieren." Diese Art von Prompt hat einen zu breiten Umfang, und der Agent wird Schwierigkeiten haben zu bestimmen, was du wirklich willst.

Gängige Workflows

Der Vorteil von ZCode liegt darin, den Entwicklungsprozess miteinander zu verknüpfen.

Du kannst eine Aufgabe von der Anforderungsbeschreibung über die Codeänderung bis hin zur Validierung und Zusammenfassung führen.

Ein Feature von Grund auf neu erstellen

Wenn du ein neues Feature erstellen möchtest, kläre zuerst die Grenzen des Features.

Wenn das Projekt bereits einen Tech-Stack hat, verlange außerdem von ZCode, die bestehenden Konventionen zu befolgen.

Beispiel

Bitte füge dem aktuellen Projekt eine "Über uns"-Seite hinzu.

Requirements:
- Verwende den bestehenden Routing-Ansatz des Projekts.
- Verwende bestehende Seitenlayout-Komponenten wieder.
- Die Seite enthält drei Abschnitte: Titel, Einleitung und Kontaktinformationen.
- Füge keine neuen Abhängigkeiten hinzu.
- Bitte liste nach Abschluss die hinzugefügten und geänderten Dateien auf.

Bestehenden Code verstehen

Wenn Sie ein unbekanntes Projekt übernehmen, können Sie ZCode zunächst bitten, die Struktur zu erklären, anstatt sofort Code zu ändern.

Dies hilft, das Risiko unbeabsichtigter Änderungen zu verringern.

Beispiel

Bitte ändern Sie vorerst keine Dateien.

Helfen Sie mir, die aktuelle Projektstruktur zu lesen und zu erklären:
- Wo der Einstiegspunkt der Anwendung ist.
- Wo Routen definiert sind.
- Wo API-Anfragen gekapselt werden.
- Was die Build- und Testbefehle jeweils sind.

Pre-Commit-Prüfungen

Bevor Sie Code committen, können Sie ZCode bitten, die aktuellen Änderungen zu überprüfen.

Es kann Ihnen helfen, fehlende Dateien, mögliche Regressionen und fehlende Tests zu erkennen.

Beispiel

Bitte überprüfe die Änderungen im aktuellen Arbeitsbereich.

Konzentriere dich auf die Prüfung:
- Ob es offensichtliche Fehler gibt.
- Ob bestehende Funktionalität beeinträchtigt ist.
- Ob es ungenutzte Variablen oder Debug-Code gibt.
- Ob zusätzliche Tests erforderlich sind.

Bitte gib zuerst eine Liste der Probleme an; ändere Dateien nicht direkt.

Sicherheitsbestätigung und Berechtigungen

ZCode startet einen Bestätigungsablauf vor kritischen Befehlen, Dateiänderungen und Operationen mit hohen Privilegien. Dies verhindert, dass der Agent gefährliche Operationen ohne dein Wissen ausführt.

Du kannst die Bestätigungsdetails lesen, bevor du einen Befehl ausführst, und dann entscheiden, ob du ihn zulässt.

Vorgangstyp Warum eine Bestätigung erforderlich ist Empfohlene Vorgehensweise
Dateien ändern Ändert den Projektcode. Bestätigen Sie, ob der Dateipfad und das Änderungsziel korrekt sind.
Dateien löschen Kann zu Datenverlust führen. Prüfen Sie den Dateiinhalt vor dem Löschen und sichern Sie ihn bei Bedarf.
Befehle ausführen Befehle können Abhängigkeiten installieren, Dienste starten oder die Umgebung ändern. Bestätigen Sie den Zweck des Befehls und vermeiden Sie die Ausführung unbekannter Hochrisiko-Befehle.
Git-Operationen Kann die Commit-Historie oder das Remote-Repository beeinflussen. Prüfen Sie git status vor dem Committen und Pushen.

Wenn Sie sich nicht sicher sind, ob ein Befehl sicher ist, können Sie ZCode zunächst bitten, den Zweck des Befehls zu erklären, anstatt ihn direkt ausführen zu lassen.

Häufige Befehle und Prüfmethoden

ZCode kann das Terminal verwenden, um Projektbefehle auszuführen.

Die konkreten Befehle hängen vom Tech-Stack deines Projekts ab.

Nachfolgend finden sich einige Befehle, die in offiziellen Beispielen und gängigen Entwicklungsszenarien vorkommen.

Befehl Funktion Beispiel
pwd Aktuelles Verzeichnis anzeigen. Bestätigen, ob sich das aktuelle Terminal von ZCode im Projektverzeichnis befindet.
git status --short Git-Änderungen in einem kompakten Format anzeigen. Bestätigen, welche Dateien vor dem Commit geändert wurden.
node --check app.js JavaScript-Dateisyntax prüfen. Überprüfen, ob app.js Syntaxfehler enthält.
npm test Projekt-Tests ausführen. Geeignet für JavaScript- oder Frontend-Projekte.
npm run build Führe den Projekt-Build aus. Bestätige, dass das Projekt vor der Veröffentlichung korrekt gepackt werden kann. 
$ git status --short
 M src/App.js
 M src/styles.css

Die obige Ausgabe zeigt an, dass zwei Dateien geändert wurden.

Bevor du einen Commit durchführst, solltest du bestätigen, dass diese Änderungen alle den Erwartungen entsprechen.

Überblick über erweiterte Funktionen

Zusätzlich zur Ausführung von Desktop-Aufgaben erwähnt die ZCode-Dokumentation auch einige erweiterte Funktionen.

Du musst sie in der Anfängerphase nicht alle auf einmal beherrschen, aber du kannst zunächst verstehen, welche Probleme sie lösen.

Fähigkeit Beschreibung Wann zu verwenden
Fernsteuerung Agent-Aufgaben remote verfolgen oder steuern. Wenn eine Aufgabe lange dauert und du den Fortschritt weiter überprüfen möchtest, nachdem du deinen Computer verlassen hast.
Bot-Kanal Aufgaben über Feishu oder WeChat Bot auslösen und vorantreiben. Teamzusammenarbeit, Fortschrittsverfolgung auf Mobilgeräten und ergänzende Anweisungen aus der Ferne.
Skill Spezialisierte Fähigkeiten oder Workflows für bestimmte Aufgaben bereitstellen. Wenn wiederholt ähnliche Aufgaben bearbeitet werden, wie Sicherheitsaudits, Dokumentationsgenerierung oder Testläufe.
MCP-Server Externe Tools oder Datenquellen mit dem Agenten verbinden. Wenn Sie eine Datenbank, Wissensdatenbank, ein internes System oder spezialisierte Tools verbinden müssen.
Sub-Agents Lassen Sie verschiedene Agenten unterschiedliche Teilaufgaben übernehmen. Wenn eine große Aufgabe parallele Erkundung, Überprüfung oder Arbeitsteilung erfordert.

Häufige Anfängerfragen

Nachfolgend sind einige häufige Probleme aufgeführt, auf die Sie beim ersten Einstieg in ZCode stoßen können.

Wird ZCode mein Projekt automatisch ohne Erlaubnis ändern?

Kritische Operationen von ZCode durchlaufen einen Bestätigungsablauf.

Du solltest die Dateien prüfen, die es ändern wird, und die Befehle, die es ausführen wird, bevor du sie zulässt.

Wenn du möchtest, dass es nur das Projekt liest, kannst du im Prompt ausdrücklich "keine Dateien ändern" schreiben.

Sollte ich ZCode viele Dinge auf einmal erledigen lassen?

Für Anfänger ist es nicht empfehlenswert, von Anfang an allzu große Aufgaben zu vergeben.

Ein besserer Ansatz ist, die Aufgabe in kleinere Teile zu zerlegen.

Zum Beispiel kannst du es zuerst bitten, die Projektstruktur zu verstehen, dann ein Modul zu ändern und schließlich eine Validierung auszuführen.

Was tun, wenn eine Aufgabe fehlschlägt

Prüfe zuerst die Terminalausgabe und die Fehlermeldungen.

Fordere ZCode dann auf, die Behebung anhand der Fehler fortzusetzen.

Überstürze es nicht, eine völlig andere Aufgabe zu beginnen, sonst verlierst du möglicherweise den Kontext.

Wann ist eine manuelle Überprüfung erforderlich?

Wenn es um Geschäftslogik, Berechtigungen, Sicherheit, Zahlungen, Datenlöschung oder Release-Vorgänge geht, sollte eine manuelle Überprüfung durchgeführt werden.

KI kann helfen, Probleme zu erkennen, aber die endgültige Verantwortung liegt weiterhin beim Entwickler.

Lernvorschläge

Der beste Weg, ZCode zu lernen, besteht nicht darin, Befehle auswendig zu lernen, sondern darin, mit kleinen Aufgaben zu üben.

Sie können es zunächst verwenden, um eine einfache Seite zu erstellen, und es dann bitten, den generierten Code zu erklären.

Versuchen Sie als Nächstes, es zu bitten, einen kleinen Fehler zu beheben, und beobachten Sie, wie es Dateien liest, Code ändert und Ergebnisse validiert.

Sobald Sie mit diesem aufgabengetriebenen Entwicklungsansatz vertraut sind, nutzen Sie nach und nach Funktionen wie Code Review, Release-Vorbereitung, Remote Control und Skill.

Betrachten Sie ZCode als Entwicklungspartner, der auf Projekten arbeiten kann, und nicht als Chatbot, der nur Fragen beantwortet. Dadurch lässt sich sein Wert leichter nutzen.

Andere Erweiterungen