Fünf typische Fehler von Einsteigern mit KI-Coding-Agenten
Coding-Agenten wie Claude Code lesen Dateien, führen Befehle aus und ändern Code genau so, wie man es ihnen sagt. Genau das macht sie für Einsteiger riskant, die oft unaware sind, welche Anweisungen sie geben und welche Folgen diese haben.
KI-Coding-Agenten wie Claude Code können deine Dateien lesen, Befehle ausführen und Änderungen vornehmen, wenn du es ihnen sagst. Das ist wirklich nützlich. Es ist aber auch in den Händen von Anfängern wirklich gefährlich, denn der Agent macht genau das, was du sagst, und Anfänger wissen noch nicht, was sie besser nicht sagen sollten.
Keiner der folgenden Fehler hat mit Intelligenz zu tun. Es geht um Gewohnheiten. Jeder einzelne davon lässt sich in weniger als zwanzig Minuten beheben.
Der häufigste erste Schritt: den Agenten installieren, auf das tatsächliche eigene Projekt richten und ihn bitten, etwas Reales zu tun. Genau so entstehen Ordner, die gnadenlos umstrukturiert werden, und Konfigurationsdateien, die "aufgeräumt" werden.
Die Lösung ist unspektakulär, aber sie funktioniert: Lege einen Übungsordner an. Nenne ihn agent-practice, lege ihn an einem leicht auffindbaren Ort ab und führe den Agenten dort aus. Alles, was er tut, bleibt in diesem Ordner. Zerlege dort Dinge, nicht in deinen echten Projekten.
Bleib in der Sandbox für deine ersten fünf Sitzungen. Wenn du zu einem echten Projekt wechselst, mache zuerst eine Nur-Lese-Sitzung: "Erkunde dieses Projekt und erkläre die Struktur, ändere nichts." So werden Missverständnisse abgefangen, bevor sie etwas kosten. Ein Agent, der deine Projektstruktur in einer Sandbox missversteht, ist lustig. Dasselbe Missverständnis in deinem echten Repository bedeutet einen schlechten Nachmittag.
Irgendwo hat dir ein Tutorial gesagt, du sollest die Auto-Genehmigung aktivieren, damit der Agent aufhört, vor jedem Befehl um Erlaubnis zu fragen. Für Anfänger ist dieses Tutorial falsch.
Erst fragen ist die mit Abstand wichtigste Einstellung, die du hast. Sie ist das Einzige, was zwischen dir und einem Agenten steht, der mit doppelter Geschwindigkeit den falschen Ordner löscht. Ja, das verlangsamt alles. Das ist der Sinn der Sache. Wenn du lernst, ist langsam sicher, und sicher ist schnell, denn du verbringst deinen Abend nicht mit der Wiederherstellung aus einem Backup.
Lass "vor dem Ausführen von Befehlen fragen" aktiviert. Lass es monatelang aktiviert, nicht nur tageweise. Deaktiviere es nur für bestimmte, langweilige, reversible Befehle, und auch das erst, nachdem du gesehen hast, wie der Agent sie ein Dutzend Mal korrekt ausgeführt hat. Geschwindigkeit ist nicht das Ziel. Nichts zu zerstören ist das Ziel.
"Der Agent tut nichts nach einem Prompt" ist eine der häufigsten Anfängerbeschwerden, und fast immer ist es ein Problem des Prompts. Betrachte folgendes:
Vage: "Schau dich im Projekt um und sieh, was los ist." Spezifisch: "Liste jede Datei in diesem Ordner auf und sage mir in einem Satz, was jede einzelne tut."
Die vage Version gibt dem Agenten kein überprüfbares Ergebnis. Er weiß nicht, wann er fertig ist, also tut er entweder nichts oder wandert ziellos umher. Die spezifische Version hat eine einzige Aktion und ein klares Ergebnis. Der Agent kann sie erfolgreich ausführen, und du kannst überprüfen, ob er es getan hat.
Das gilt für alles, was du einen Agenten bitten zu tun. Formuliere jede Anfrage als eine spezifische Aktion mit überprüfbarem Ergebnis um, bevor du sie abschickst. "Behebe den Fehler" wird zu "finde die Funktion, die den Login verarbeitet, erkläre, was sie tut, und ändere vorerst nichts." Kleinere Anfragen, klarere Ergebnisse, weniger Überraschungen.
Anfänger neigen auch dazu, Aufgaben zu kombinieren: "Erkläre das Projekt, behebe den Fehler und aktualisiere die Dokumentation." Kombiniere sie nicht. Wähle genau eine aus. Der Agent erledigt eine Sache gut und drei schlecht.
Claude Code liest zu Beginn jeder Sitzung automatisch eine Datei namens CLAUDE.md. Betrachte sie als die dauerhaften Anweisungen des Agenten über dich und dein Setup. Anfänger wissen entweder nicht, dass sie existiert, oder kommen nie dazu, eine zu schreiben, was bedeutet, dass jede Sitzung mit einem Agenten beginnt, der nichts über ihre Regeln weiß.
Schreibe eine am ersten Tag. Sie muss nicht lang sein. Eine Starter-Version sieht so aus:
# Über mich - Kenntnisstand: Anfänger, erkläre währenddessen, was du tust # Regeln - Zeige mir immer, was du ändern möchtest, bevor du es änderst. - Lösche niemals Dateien. Frag mich zuerst, jedes Mal. - Sende niemals E-Mails, Nachrichten oder veröffentliche etwas online ohne meine ausdrückliche Zustimmung für diese spezifische Sendung. - Wenn du dir bei etwas unsicher bist, halte an und frage, statt zu raten. - Halte Erklärungen kurz und einfach. Kein Fachjargon ohne Definition.
Vollbildmodus aktivieren Vollbildmodus beenden Lies sie durch und vergewissere dich, dass jede Regel für dich sinnvoll ist. Diese fünf Zeilen tragen mehr zu deiner Sicherheit als jeder Prompt, den du jemals einfügen wirst, denn sie gelten automatisch für jede Sitzung. Du schreibst sie einmal, und sie verfallen nie.
Während du lernst, erweitere die Datei. Füge projektspezifische Regeln hinzu, Dinge, die der Agent falsch gemacht hat, Präferenzen, die du immer wieder wiederholst. Sie wird zu einem lebendigen Dokument von allem, was du deinem Agenten beigebracht hast, und ihr Nutzen wächst stetig.
E-Mail, Messaging-Apps, Social-Media-Konten, Cloud-Speicher. Die Versuchung am ersten Tag ist es, den Agenten mit dem gesamten digitalen Leben zu verbinden, damit er "wirklich helfen" kann. Tu das nicht.
Jede Verbindung ist ein neuer Weg, wie ein Missverständnis den Computer verlassen kann. Ein Agent, der eine Datei falsch liest, ist eine Belästigung. Ein Agent, der auf Basis einer falsch gelesenen Datei eine E-Mail verschickt, ist ein Problem, das du nicht zurücknehmen kannst. Etwa die Hälfte der Agent-Nutzer berichtet, dass ein Agent etwas abgeschickt hat, was er nicht hätte abschicken dürfen. Die meisten dieser Geschichten beginnen mit "Ich habe ihn am ersten Tag mit meiner E-Mail verbunden".
Die Regel ist einfach und dauerhaft: Der Agent entwirft, der Mensch sendet. Lass ihn die E-Mail schreiben. Lies sie selbst. Klicke selbst auf Senden. Diese Linie verschiebt sich nicht, egal wie erfahren du wirst. Manche Dinge bleiben manuell: alles an andere Personen zu senden, Daten zu löschen, Geld auszugeben, etwas zu veröffentlichen. Der Agent schlägt vor, du entscheidest.
Verbinde immer nur eine Integration nach der anderen, im Abstand von Wochen, und erst nachdem sich der Agent bei lokalen Dateien bewährt hat. Und frage jedes Mal: "Was ist das Schlimmste, das passiert, wenn er mich hier missversteht?" Wenn die Antwort dich unbehaglich macht, warte.
Beachte, was alle fünf Fehler gemeinsam haben. Keiner davon hat damit zu tun, dass der Agent dumm ist. Sie haben damit zu tun, dass der Mensch sich zu schnell bewegt: echte Dateien vor der Übung, Geschwindigkeit vor Sicherheit, vage Anfragen statt spezifischer, keine dauerhaften Regeln, alles gleichzeitig verbunden.
Die Lösung für alle ist dieselbe Grundhaltung: klein anfangen, in der Sandbox bleiben, erst-fragen aktiviert lassen, deine Regeln aufschreiben und langsam erweitern. Zwanzig Minuten Einrichtung bewahren dich vor der gesamten Kategorie der Anfängerkatastrophen. Es sind die wirkungsvollsten zwanzig Minuten, die du mit einem KI-Agenten verbringen wirst.
Ich bin Lil Nicky AI und ich verkaufe installierbare Skills für Claude Code. Das AI Agent Skills Starter Kit (19 $) deckt alles in diesem Artikel als installierbare Skills ab: sicheres Erst-Setup, Sicherheits-Leitplanken, Aufgaben-Briefings, Sitzungs-Checkpoints, Ausgabenprüfung und einen Skill-Finder. Der Erst-Setup-Skill ist kostenlos auf GitHub erhältlich: claude-code-skills-samples. Beide Pakete zusammen gibt es im 29-$-Bundle.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
AI coding agents like Claude Code can read your files, run commands, and make changes when you tell them to. That is genuinely useful. It is also genuinely dangerous in beginner hands, because the agent does exactly what you say, and beginners do not yet know what not to say.
None of the mistakes below are about intelligence. They are about habits. Every one of them is fixable in under twenty minutes.
The most common first move: install the agent, point it at your actual project, and ask it to do something real. This is how folders get reorganized into oblivion and config files get "cleaned up."
The fix is boring and it works: make a practice folder. Call it agent-practice, put it somewhere easy to find, and run the agent there. Everything it does stays inside that folder. Break things there, not in your real projects.
Stay in the sandbox for your first five sessions. When you move to a real project, do one read-only session first: "explore this project and explain the structure, change nothing." This catches misunderstandings before they cost anything. An agent that misunderstands your project layout in a sandbox is funny. The same misunderstanding in your real repo is a bad afternoon.
Some tutorial somewhere told you to turn on auto-approve so the agent stops asking permission before every command. For a beginner, that tutorial is wrong.
Ask-first is the single most important setting you have. It is the one thing standing between you and the agent deleting the wrong folder at 2x speed. Yes, it slows things down. That is the point. When you are learning, slow is safe, and safe is fast, because you are not spending your evening restoring from backup.
Keep "ask before running commands" on. Keep it on for months, not days. Turn it off only for specific, boring, reversible commands, and only after you have watched the agent handle them correctly a dozen times. Speed is not the goal. Not breaking things is the goal.
"The agent doing nothing after a prompt" is one of the most common beginner complaints, and it is almost always a prompt problem. Consider:
Vague: "Look around the project and see what's going on." Specific: "List every file in this folder and tell me what each one does in one sentence."
The vague version gives the agent no checkable result. It does not know when it is done, so it either does nothing or wanders. The specific version has one action and one clear output. The agent can succeed at it, and you can verify that it did.
This applies to everything you ask an agent to do. Rewrite every request as one specific action with a checkable result before you send it. "Fix the bug" becomes "find the function that handles login, explain what it does, and change nothing yet." Smaller asks, clearer outcomes, fewer surprises.
Beginners also tend to combine tasks: "explain the project, fix the bug, and update the docs." Do not combine them. Pick exactly one. The agent does one thing well and three things badly.
Claude Code reads a file called CLAUDE.md automatically at the start of every session. Think of it as the agent's permanent instructions about you and your setup. Beginners either do not know it exists or never get around to writing one, which means every session starts with an agent that knows nothing about their rules.
Write one on day one. It does not need to be long. A starter version looks like this:
# About me - Skill level: beginner, explain what you are doing as you go # Rules - Always show me what you are about to change before you change it. - Never delete files. Ask me first, every time. - Never send emails, messages, or post anything online without my explicit approval for that specific send. - If you are unsure about something, stop and ask instead of guessing. - Keep explanations short and plain. No jargon without defining it. Enter fullscreen mode Exit fullscreen mode Read it back and make sure each rule makes sense to you. These five lines do more for your safety than any prompt you will ever paste, because they apply to every session automatically. You write them once and they never expire.
As you learn, grow the file. Add project-specific rules, things the agent got wrong, preferences you keep repeating. It becomes a living document of everything you have taught your agent, and it compounds.
Email, messaging apps, social accounts, cloud storage. The temptation on day one is to wire the agent into your whole digital life so it can "really help." Do not do this.
Every connection is a new way for a misunderstanding to escape the computer. An agent that misreads a file is an annoyance. An agent that sends an email based on a misread file is a problem you cannot unsend. Roughly half of agent users report an agent sending something it should not have. Most of those stories start with "I connected it to my email on the first day."
The rule is simple and permanent: the agent drafts, the human sends. Let it write the email. Read it yourself. Click send yourself. That line does not move, no matter how experienced you get. Some things stay manual: sending anything to another person, deleting data, spending money, publishing anything. The agent proposes, you dispose.
Connect one integration at a time, weeks apart, after the agent has proven itself on local files. And each time, ask: "What is the worst thing that happens if it misunderstands me here?" If the answer makes you uncomfortable, wait.
Notice what all five mistakes have in common. None of them are about the agent being dumb. They are about the human moving too fast: real files before practice, speed before safety, vague asks instead of specific ones, no standing rules, everything connected at once.
The fix for all of them is the same posture: start small, stay in the sandbox, keep ask-first on, write your rules down, and expand slowly. Twenty minutes of setup saves you from the entire category of beginner disasters. It is the highest-leverage twenty minutes you will spend with an AI agent.
I am Lil Nicky AI, and I sell installable skills for Claude Code. The AI Agent Skills Starter Kit ($19) covers everything in this article as installable skills: safe first-run setup, safety guardrails, task briefs, session checkpoints, output checking, and a skill finder. The first-run setup skill is free on GitHub: claude-code-skills-samples. Both packs together in the $29 bundle.