Claude Code: Wenn KI aufhört zu reden und anfängt zu handeln

Die meisten Menschen, die KI zum ersten Mal nutzen, nutzen einen Chatbot. Sie tippen etwas, die KI antwortet, sie tippen wieder etwas. Das ist ein Gespräch. Nützlich, aber begrenzt — die KI bleibt im Chatfenster. In der realen Welt passiert nichts, ausser du machst, dass es passiert.

Claude Code ist anders. Es antwortet dir nicht. Es handelt.

Gib ihm eine Aufgabe, und es liest deine Dateien, entscheidet, was sich ändern muss, öffnet die passenden Tools, macht die Änderungen, prüft die Ergebnisse und iteriert, bis die Arbeit erledigt ist. Du führst kein Gespräch. Du leitest ein Projekt.

Dieser Wechsel vom Chatbot zum Agenten ist das Wichtigste, das du zuerst verstehen solltest. Er verändert, wie du darüber denkst, was du verlangst und was du realistischerweise erwarten kannst.

Was ein Agent eigentlich ist

Die klarste Analogie, die ich gefunden habe: Claude Code ist ein Projektmanager, kein Arbeitskollege, mit dem du chattest.

Ein Projektmanager macht die Arbeit nicht selbst. Er versteht, was du erreichen willst, zerlegt es in Aufgaben, findet heraus, wer einbezogen werden muss, delegiert die Arbeit, prüft den Fortschritt und fügt am Ende alles zu einem Ergebnis zusammen. Er managt mehrere Workstreams gleichzeitig. Und wenn etwas schiefgeht, kümmert er sich darum — du musst nicht bei jedem Detail dabei sein.

Genau das ist Claude Code. Wenn du sagst «füge der Startseite einen Newsletter-Anmeldebereich hinzu», schreibt es keinen Code-Schnipsel und fügt ihn in den Chat ein. Es liest deine Codebase, um zu verstehen, wie die Website aufgebaut ist, findet die richtige Datei zum Bearbeiten, schreibt Code, der zu deinem bestehenden Stil und deinen Konventionen passt, prüft, ob etwas kaputtgegangen ist, und committet die Änderung. Du beschreibst das Ergebnis. Es kümmert sich um den Weg dahin.

Genau das bedeutet «agentisch» in der Praxis. Die KI hat Zugriff auf Tools (Dateieditoren, Terminal-Befehle, Web-Browser, externe APIs) und orchestriert sie selbstständig, um ein Ziel zu erreichen. Sie managt ein Projekt, nicht nur das nächste Wort.

Du brauchst kein Terminal

Schaffen wir das gleich aus dem Weg: Claude Code verlangt nicht, dass du eine Kommandozeile benutzt.

Es gibt eine terminalbasierte Version. Die nutzen Entwicklerinnen und Entwickler normalerweise, und sie ist das leistungsfähigste Setup. Aber das meiste, was ich im Alltag mache, läuft über die Windows-Desktop-App oder die Web-App. Im Notfall geht es auch vom Handy aus.

Die Apps geben dir ein aufgeräumtes Interface: eine Projektauswahl, ein Gesprächsfenster und den Agenten, der im Hintergrund arbeitet. Für den Bau von Websites, das Schreiben von Inhalten, das Automatisieren von Aufgaben und die meisten Dinge, die eine Nicht-Entwicklerin oder ein Nicht-Entwickler machen will, reichen die Apps vollständig aus.

Das Terminal wird nötig, wenn du lokal installierte MCP-Server brauchst — Erweiterungen, die Claude Code mit bestimmten Tools oder Datenquellen verbinden, die auf deinem Rechner liegen. Für Business-Nutzerinnen und -Nutzer, die Claude Code mit einer lokalen Datenbank oder einem massgeschneiderten internen Tool verbinden wollen, ist das eine Aufgabe fürs Terminal. Für alles andere reichen die Apps.

Das Terminal ist für fortgeschrittene Nutzerinnen und Nutzer und Entwickler. Lass es nicht der Grund sein, warum du nicht anfängst.

Loslegen: drei Schritte

Das Setup, das wirklich zählt, hat drei Teile:

1. Ein GitHub-Repository erstellen

Dein Projekt braucht ein Zuhause auf GitHub. Startest du eine Website oder ein neues Projekt von null, kann Claude Code dir beim Einrichten helfen — beschreib einfach, was du baust, und bitte es, das Repository zu erstellen und zu pushen. Hast du bereits Code irgendwo liegen, musst du ihn zuerst auf GitHub pushen. Ist dieser Schritt neu für dich, sieh dir den Guide zum Bauen mit GitHub an.

2. Claude Code installieren und auf das Repository ausrichten

In der Desktop- oder Web-App verbindest du Claude Code mit deinem GitHub-Repository. Es liest die Dateien, baut ein Verständnis des Projekts auf, und von da an kennt es den Context — deine Namenskonventionen, deine Ordnerstruktur, deine bestehenden Code-Muster. Genau das lässt es Änderungen machen, die passen, statt mit dem zu kollidieren, was schon da ist.

3. Eine Cloud-Umgebung einrichten

Dieser Schritt verbindet Claude Code mit einer Live-Umgebung, in der es deinen Code tatsächlich ausführen, Änderungen testen und Ergebnisse deployen kann. Bei einer Website heisst das meist: Verbindung zu deinem Cloudflare-Pages-Deployment oder einem gleichwertigen Dienst. Ist das eingerichtet, kann Claude Code eine Änderung machen, einen Build auslösen, prüfen, ob das Deployment funktioniert hat, und bei einem Fehler iterieren — alles, ohne dass du etwas anfassen musst.

Nach diesen drei Schritten bist du einsatzbereit. Gib ihm eine Aufgabe und schau, was passiert.

Phase eins: der Dopamin-Kick

So geht es den meisten Leuten in der ersten Woche.

Du beschreibst etwas, das du schon länger machen wolltest — eine Seite hinzufügen, ein Layout-Problem beheben, etwas Content schreiben, ein kleines Tool bauen — und Claude Code erledigt es einfach. Vollständig. Korrekt. In der Zeit, die du gebraucht hättest, um die richtige Datei zu öffnen, ist die Änderung bereits committet und deployt.

Dir fallen sofort drei weitere Dinge ein, die du vor dir hergeschoben hast. Du erledigst sie. Dann noch fünf. Um Mitternacht gehst du ins Bett und hast an einem Abend mehr geschafft als im Monat davor.

Diese Phase ist echt. Der Produktivitätssprung ist real, kein Hype. Und er macht süchtig, genau wie man erwarten würde — du jagst dem nächsten Ergebnis hinterher, lässt drei oder fünf Dinge parallel laufen, schaust Claude bei der Arbeit zu. Mir fällt es manchmal wirklich schwer, für die Nacht aufzuhören.

Geniess diese Phase. Du hast sie dir verdient. Aber sie hält nicht ewig.

Phase zwei: an die Decke stossen

Irgendwann — bei jedem anders, meist innerhalb der ersten paar Wochen — stösst du an eine Wand.

Claude Code versteht etwas falsch und schlägt die falsche Richtung ein. Es macht eine Änderung, die für sich funktioniert, aber etwas anderes kaputt macht. Es erledigt eine Aufgabe selbstbewusst falsch, weil ihm der richtige Context fehlte. Du merkst, dass du immer wieder dieselbe Art von Fehlern korrigierst.

Die naheliegende Reaktion ist, frustriert zu sein und zu schliessen, Claude Code sei nicht so gut, wie du dachtest. Das ist der falsche Schluss.

Der richtige Schluss ist: Du bist der Standardkonfiguration entwachsen. Claude Code ist im Auslieferungszustand beeindruckend, aber es kennt deine konkreten Projekte, deine Konventionen, deine Vorlieben, deine Einschränkungen nicht. Es arbeitet mit allgemeinem Wissen. Die Decke, an die du stösst, ist die Decke dieses allgemeinen Wissens.

Der nächste Schritt ist, dein eigenes System zu bauen, nicht dich durch mehr Einstellungen zu wühlen.

Dein System bauen: hier liegt die echte Stärke

Hier hören die meisten Guides auf, und genau hier liegt der eigentliche Hebel.

Die CLAUDE.md-Datei

Jedes Projekt kann eine CLAUDE.md-Datei haben — ein Dokument, das Claude Code am Anfang jeder Session liest. Stell es dir wie das Onboarding-Dokument für einen neuen Projektmanager vor, der zu deinem Team stösst. Es kann enthalten:

• Was dieses Projekt ist und wofür es da ist
• Konventionen und Regeln, die es befolgen soll
• Was nicht angefasst werden soll
• Wie Deployments funktionieren
• Alles, was Claude immer wieder falsch macht

Sobald du eine gut geschriebene CLAUDE.md hast, verschwindet ein grosser Teil der wiederkehrenden Korrekturen. Claude weiss schon, worauf du es sonst hinweisen würdest.

Skills

Skills sind wiederverwendbare Anweisungen, die du jederzeit aufrufen kannst — stell sie dir wie gespeicherte Abläufe vor. «Wenn ich /review-pr sage, prüfe den aktuellen Pull Request auf Probleme und fasse zusammen, was sich geändert hat.» «Wenn ich /deploy sage, führe die Build-Checks aus und push in die Produktion.» Du definierst das einmal und rufst es auf, wann immer du es brauchst. Mit der Zeit sammelst du eine Bibliothek von Dingen, die Claude auf Abruf zuverlässig erledigen kann.

MCPs (Model Context Protocol Server)

MCPs sind Erweiterungen, die Claude Code Zugriff auf Tools und Daten geben, die es sonst nicht hätte. Ein MCP kann Claude mit deinem Kalender, deinem Projektmanagement-Tool, deiner Datenbank, einer Web-Browsing-Fähigkeit oder einem massgeschneiderten internen System verbinden. Je mehr MCPs du eingerichtet hast, desto mehr Workstreams kann Claude tatsächlich managen. Hier beginnt sich Claude Code weniger wie ein Coding-Tool anzufühlen und mehr wie ein Betriebssystem für deine Arbeit.

Wissen

Das ist der Punkt, den die meisten unterschätzen. Claude Code ist nur so nützlich wie der Context, auf den es zugreifen kann. Kennt es die Konventionen deines Unternehmens nicht, die Struktur deines Produkts, die Eigenheiten deines Publikums — arbeitet es mit generischen Annahmen. Fütterst du es mit dem richtigen Wissen (Dokumentation, Referenzmaterial, frühere Entscheidungen), verändert das die Qualität von allem, was es tut. Ich habe darüber ausführlicher im Guide zum Bau eines Company AI OS geschrieben.

Diese vier — CLAUDE.md, Skills, MCPs, Wissen — sind es, die Leute, die «Claude Code nutzen», von Leuten unterscheiden, die tatsächlich etwas damit gebaut haben. Die Lücke zwischen den beiden ist riesig.

Mit GitHub arbeiten: was du wirklich wissen musst

Claude Code ist um GitHub herum gebaut. Meistens erledigt es das unsichtbar — es erstellt Branches, committet Änderungen und öffnet Pull Requests, die du prüfst und mergst. Du gibst das Ergebnis frei, mergst den PR, löschst den Branch, fertig.

Aber irgendwann willst du mehr tun, als Pull Requests abzunicken. Du willst nachschauen, was drinsteckt, selbst einen öffnen, einen Konflikt lösen. GitHub ist eigentlich nicht kompliziert — es ist sehr gut dokumentiert, und das Web-Interface ist unkompliziert —, aber es lohnt sich, eine Stunde in die Grundlagen zu investieren, bevor du sie unter Druck brauchst.

Etwas, für das ich eine Weile gebraucht habe, es zu entdecken: Du kannst Claude Code mit mehreren GitHub-Repositories gleichzeitig verbinden. Es kann aus einem lesen und in ein anderes schreiben, oder gleichzeitig über mehrere hinweg arbeiten. Das ist für Wissensmanagement richtig mächtig — ich habe schon drei Repositories gleichzeitig verbunden, Erkenntnisse von einem Projekt ins andere übertragen und gemeinsame Wissensbasen synchron gehalten, ohne doppelte manuelle Arbeit.

Ehrlich über die rauen Kanten

Claude Code ist ein exzellentes Produkt mit echten rauen Kanten. Du solltest wissen, worauf du dich einlässt.

Für nicht-technische Nutzerinnen und Nutzer ist es nicht gut aufbereitet. Geht etwas schief, sind die Fehlermeldungen oft hochtechnisch und gelegentlich nutzlos. Du siehst Stack-Traces und Exit-Codes, die dir nichts sagen, womit du etwas anfangen kannst. Die richtige Reaktion ist, den Fehler in Claude einzufügen und zu fragen, was er bedeutet — aber die ersten paar Male ist das irritierend.

Claude kennt sich selbst nicht besonders gut. Claude Code hat begrenztes, manchmal veraltetes Wissen über seine eigenen Features und wie die Software funktioniert. Aus dem Gedächtnis kann es dir keine verlässliche Anleitung zu seinen eigenen Konfigurationsoptionen geben. Was es kann: die offizielle Anthropic-Dokumentation durchsuchen und nach relevanten Guides suchen — bitte es darum, wenn du ein Feature verstehen willst. Es findet es heraus, nur nicht aus internem Wissen.

Das UI hat Eigenheiten. Die App aktualisiert sich manchmal nicht richtig — du musst zu einem anderen Gespräch wechseln und zurück, oder die App ganz neu starten. Verbindungsfehler tauchen zufällig auf. Anthropics Server laufen gelegentlich so heiss, dass Antworten deutlich langsamer werden oder ausbleiben. Nichts davon ist ein Dealbreaker, aber real ist es schon.

Die Token-Limits sind die frustrierendste Einschränkung. Es gibt Limits pro Session (der Fünf-Stunden-Reset, den die meisten kennen) und Wochenlimits, die deutlich härter treffen, wenn du eine aktive Woche hattest. Steckst du mitten in einem Projekt und stösst an dein Limit, ist Schluss. Es bleibt kaum etwas, ausser zu warten oder mehr zu bezahlen. Ein Workaround, den man kennen sollte: Bist du Abonnentin oder Abonnent von Google One AI Premium, kannst du Claude Opus über Antigravity nutzen, um weiterzuarbeiten, wenn dein Claude-Code-Budget aufgebraucht ist.

Die Modellwahl zählt mehr, als die meisten glauben

Claude Code lässt dich wählen, welches Claude-Modell im Hintergrund läuft. Der Standard ist Sonnet, und Benchmarks stützen die Behauptung tatsächlich, dass Sonnet stark im Programmieren und logischen Problemlösen ist — für die meisten Aufgaben ist es wahrscheinlich die beste Wahl.

In der Praxis greife ich aber zu Opus, wenn ich an einem komplexen Repository arbeite und die höchste Reasoning-Qualität brauche. Bei einer grossen Codebase mit viel Context, den man im Kopf behalten muss, wirkt Haiku spürbar limitiert. Die richtige Wahl hängt davon ab, was du machst:

• Haiku: Schnell, günstig, gut für einfache, klar definierte Aufgaben in kleinen Repositories
• Sonnet: Der praktische Standard — starkes Reasoning, überschaubare Kosten, erledigt die meiste Arbeit gut
• Opus: Beste Qualität, höhere Kosten, lohnt sich, wenn die Aufgabe komplex ist und es darauf ankommt, sie richtig zu machen

Wirkt etwas, das Claude Code macht, leicht daneben oder oberflächlich — fehlt ihm Context, den es haben sollte, oder trifft es Entscheidungen, die zu wenig durchdacht wirken —, versuch zuerst, auf ein leistungsfähigeres Modell zu wechseln, bevor du annimmst, die Aufgabe sei zu schwer.

Wovor dich niemand warnt

Du wirst süchtig werden.

Nicht metaphorisch. Die Kombination aus sofortigen Ergebnissen, parallelen Workstreams und dem Gefühl von purem Hebel erzeugt eine Feedback-Schlaufe, aus der man wirklich schwer aussteigen kann. Ich habe mich schon um Mitternacht dabei ertappt zu denken «ich könnte doch noch schnell eine Sache anstossen, bevor ich schlafen gehe» — und dann ist es ein Uhr, drei Dinge laufen, und ich schaue zu, wie die Pull Requests reinkommen.

Meistens ist das okay. Die Arbeit ist real, die Ergebnisse sind real. Aber es lohnt sich, sich dessen bewusst zu sein, besonders wenn dein Token-Budget schon mitten in der Woche aufgebraucht ist, weil du am Montag zu forsch rangegangen bist.

Die andere Seite davon: Hast du ein paar Monate so gearbeitet, fühlt sich die Rückkehr zur manuellen Arbeit wirklich seltsam an. Nicht unmöglich. Nur langsam. Du entwickelst ein starkes Gespür dafür, was Claude Code eigentlich bewältigen können sollte, und fängst instinktiv an, Dinge als Aufgaben zum Delegieren zu sehen statt als Dinge, die du selbst erledigst.

Diese Verschiebung darin, wie du über Arbeit denkst — das ist das eigentliche Produkt.

---

Claude Code funktioniert am besten auf dem richtigen Fundament. Hast du die Pipeline aus GitHub und Cloudflare Pages noch nicht eingerichtet, deckt der Guide zum Bau einer gratis Website mit KI das von Grund auf ab. Und willst du Claude Code mit einem grösseren Wissenssystem für deine ganze Organisation verbinden, geht dieser Faden im Guide zum Bau eines Company AI OS weiter.