AgentOS-Handbuch für Claude Code

Du brauchst kein Technikwissen. Du beschreibst eine Aufgabe so, wie du sie einer Kollegin erklären würdest. Programmieren musst du nicht. Das hier legst du dir zurecht:

• Einen Mac oder einen Windows-Computer. Darauf läuft dein Agent. Auf dem Handy arbeitet er nicht.
• Ein bezahltes Claude-Abo. Für Claude Code brauchst du von Anfang an Claude Pro oder Max. Mit einem kostenlosen Claude-Konto läuft Claude Code nicht.
• Deine Vorlage von AgentOS. Das ist ein Ordner mit Arbeitsregeln, Anleitungen und Übungen. Du stellst sie dir im Lernportal auf der Seite „Mein Agent“ zusammen.
• Etwa 15 Minuten. So lange dauert die Einrichtung. Mit der ersten Aufgabe zusammen rechnest du mit etwa 1 Stunde.

Was es kostet

Beim Geld sagen wir es dir lieber gleich. Du zahlst nur dein KI-Abo, und zwar beim Anbieter.

Das Abo zahlst du direkt bei Anthropic. Mit Claude Pro nutzt du Claude wie gewohnt und dazu Claude Code. Die Preise legt der Anbieter fest und ändert sie manchmal. Den aktuellen Stand findest du beim Anbieter.

Claude Code kommt von Anthropic, der Firma hinter Claude. Es steckt in der Claude-App. Ein zweites Programm brauchst du nicht.

1. Installieren Installiere die Claude-App von Anthropic.
2. Anmelden Melde dich mit deinem Claude-Konto an. Dein Konto braucht ein bezahltes Abo, also Claude Pro oder Max.
3. Zu „Code“ wechseln In der Claude-App wechselst du zu „Code“. Dort arbeitet dein Agent.

Fragt die App nach einem Abo, fehlt dir Claude Pro oder Max. Das Abo schließt du direkt bei Anthropic ab.

Kurz gesagt: Installiere die Claude-App von Anthropic und melde dich mit deinem Claude-Konto an.

Die Vorlage holen

Stell dir deine Vorlage im Lernportal auf der Seite „Mein Agent“ zusammen. Dort wählst du Claude Code als Programm, deinen Computer, deine Ziele und deine Anleitungen. Danach lädst du die Datei „Mein-Agent.zip“ herunter. Lade sie direkt auf dem Computer herunter, auf dem dein Agent arbeiten soll.

Eine ZIP-Datei ist ein gepacktes Paket, in dem ein ganzer Ordner steckt. Nach dem Herunterladen liegt „Mein-Agent.zip“ in deinem Ordner „Downloads“.

Auspacken auf dem Mac

1. Auspacken Öffne die Datei „Mein-Agent.zip“ mit einem Doppelklick. Daneben erscheint der Ordner „Mein-Agent“.
2. Umziehen Zieh den Ordner „Mein-Agent“ in deinen Ordner „Dokumente“. Dort bleibt er.

Auspacken unter Windows

1. Auspacken Klick mit rechts auf die Datei „Mein-Agent.zip“ und wähle „Alle extrahieren“. Bestätige mit „Extrahieren“.
2. Umziehen Leg den Ordner „Mein-Agent“ in deinen Ordner „Dokumente“. Dort bleibt er. Steckt darin noch einmal ein Ordner „Mein-Agent“, nimm diesen inneren Ordner.

Kurz gesagt, Mac: Öffne die ZIP-Datei mit einem Doppelklick. Zieh den Ordner „Mein-Agent“ in „Dokumente“. Windows: Klick mit rechts auf die ZIP-Datei und wähle „Alle extrahieren“. Leg den Ordner „Mein-Agent“ in „Dokumente“.

Was im Ordner liegt

Im richtigen Ordner liegen die Dateien START-HIER.html und AGENTS.md. Dazu kommt die Datei CLAUDE.md. Sie verweist auf die Arbeitsregeln in AGENTS.md. Dazu kommen diese Ordner:

Deine Anleitungen liegen im Ordner .claude/skills. Sein Name beginnt mit einem Punkt. Deshalb zeigt der Finder oder Explorer ihn normalerweise nicht an. Du musst dort auch nichts tun.

Den Ordner öffnen

Jetzt bekommt dein Agent seinen Arbeitsplatz. Du öffnest den Ordner „Mein-Agent“ in Claude Code. Ab dann arbeitet dein Agent darin und liest zuerst seine Arbeitsregeln.

1. Claude öffnen Öffne die Claude-App und wechsle zu „Code“.
2. Ordner wählen Wähle als Ordner „Mein-Agent“ aus deinen Dokumenten.

Die Programme ändern sich oft. Heißt ein Knopf bei dir anders, such nach der Stelle, an der du einen Ordner öffnest oder hinzufügst.

Dein erstes „Hallo“

Jetzt schreibst du deinem Agenten zum ersten Mal. Mehr als ein Wort brauchst du nicht:

Auf dieses Wort ist dein Agent vorbereitet. Seine Arbeitsregeln schicken ihn zur Anleitung „Begleiter“. Sie führt dich ohne Umweg zum ersten Ergebnis:

1. Nachschauen Er sieht nach, welche Ziele und Anleitungen du beim Zusammenstellen ausgesucht hast.
2. Vorstellen In höchstens drei Sätzen sagt er, wo er arbeitet und wohin Unterlagen und Ergebnisse kommen. Und er sagt dir, dass er nichts ohne dich verschickt, löscht oder bezahlt.
3. Vorschlagen Er schlägt genau eine erste Aufgabe mit den Übungsunterlagen vor.
4. Warten Er wartet auf dein Ja. Erst dann legt er los.
5. Übergeben Er sagt dir, wo das Ergebnis liegt und wie du es öffnest, meist mit einem Doppelklick.

Hallo! Ich bin dein digitaler Mitarbeiter und arbeite in diesem Ordner.
Unterlagen legst du in 01-eingang. Meine Ergebnisse findest du in 02-ergebnisse.
Ich verschicke, lösche und bezahle nichts, ohne dich vorher zu fragen.

Soll ich die Übungsmails lesen und dir eine Wochenübersicht machen?

Eine kurze Probe

Daran siehst du, ob dein Agent seine Regeln und Anleitungen gefunden hat:

• Er nennt „Mein-Agent“ als seinen Ordner und keinen anderen.
• Unter seinen Anleitungen sind begleiter, ergebnis-pruefen, arbeitsstand-sichern und eigene-anleitung. Diese vier stecken in jeder Vorlage.
• Er sagt, dass er nichts verschickt, löscht oder bezahlt, ohne dich zu fragen.

Für Claude Code gibt es noch keinen Bildschirm-Rundgang. Die Schritte in diesem Handbuch gelten aber für dein Programm. Hier steht, was du in Claude Code brauchst und wofür. Wie die Knöpfe genau heißen, kann sich mit jeder neuen Fassung der App ändern.

Die Claude-App und „Code“

Claude und Claude Code stecken in derselben App. Im Chat fragst du, und Claude antwortet. In „Code“ arbeitet dein Agent in deinem Ordner. Er liest Dateien und legt fertige Ergebnisse ab. Für deinen Agenten wechselst du deshalb immer zu „Code“.

Dein Ordner

In „Code“ wählst du den Ordner, in dem dein Agent arbeitet. Das ist immer „Mein-Agent“. Schau vor jeder neuen Aufgabe kurz nach, welcher Ordner offen ist.

Das Feld für deine Anweisung

Dort schreibst du deinem Agenten, was er tun soll. Normale Sätze reichen, so wie im Chat. Tippen musst du nicht unbedingt. Mit der Spracheingabe deines Computers erklärst du eine Aufgabe schneller und gibst ganz nebenbei mehr Zusammenhang.

Die Erlaubnisfragen

Bevor Claude Code Dateien liest oder ändert, fragt es dich oft um Erlaubnis. Das ist gut so. Lies jede Frage. Erlaube es für den Ordner „Mein-Agent“. Will es etwas außerhalb davon, sag Nein.

Ein neues Gespräch

Innerhalb eines Gesprächs merkt sich dein Agent, was du ihm sagst. In einem neuen Gespräch fängt er meist frisch an und kennt nur seine Arbeitsregeln, Anleitungen und Dateien. Ein neues Gespräch hilft, wenn eines festgefahren ist.

Was Claude Code bei jedem Start liest

Claude Code liest bei jedem Start die Datei CLAUDE.md. In deiner Vorlage verweist sie auf AGENTS.md. So gelten überall dieselben Arbeitsregeln. Dazu kennt er die Liste deiner Anleitungen aus .claude/skills. Alles andere öffnet er erst, wenn eine Aufgabe es braucht.

Eine Anleitung enthält feste Regeln für eine Aufgabe, die immer wiederkommt. In Claude Code heißt das Skill. Du kannst eine Anleitung auch beim Namen nennen: „Nutze die Anleitung ergebnis-pruefen.“

Deine Nutzungsgrenze

Wie viel du mit deinem Abo arbeiten kannst, legt Anthropic fest und ändert es manchmal. Aufgaben mit vielen großen Dateien verbrauchen mehr. Teil große Aufgaben deshalb in kleine Schritte.

Dein Agent sortiert eine Woche Mails. Die Mails sind erfunden und liegen in deiner Vorlage, im Ordner 03-uebungen/mails. So übst du, ohne echte Daten preiszugeben.

Die Anweisung geben

Hat dein Agent dir nach deinem „Hallo“ schon eine Wochenübersicht gemacht? Dann liegt sie bereits in 02-ergebnisse, und du machst bei „Das Ergebnis öffnen“ weiter. Sonst kopierst du diese Anweisung und schickst sie ab:

Dein Agent sagt dir zuerst, was er vorhat. Dann liest er die fünf Mails, sortiert sie und schreibt die Entwürfe. Das dauert meist 1 bis 2 Minuten. Fragt dein Programm um Erlaubnis, erlaube es für den Ordner „Mein-Agent“.

Das Ergebnis öffnen

Zum Schluss nennt dir dein Agent den Namen der Datei. Er beginnt etwa mit wochenuebersicht und endet auf .html.

1. Ordner öffnen Öffne den Ordner „Mein-Agent“ in deinen Dokumenten. Am Mac geht das im Finder, unter Windows im Explorer.
2. Datei finden Geh in den Ordner 02-ergebnisse.
3. Doppelklick Öffne die Datei mit einem Doppelklick. Dann erscheint die Seite in deinem Browser.

Die Seite sieht aus wie eine Webseite, steht aber nicht im Internet. Es gibt sie nur als Datei auf deinem Computer.

Wochenübersicht

Heute antworten
· Sabine Berger · Termin verschieben?
  Möchte den Vormittag danach. Frist: morgen.
· Jonas Keller · Anfrage Hochzeit im Mai
  Er fragt nach Zeit und Preis für den 15. Mai.
  Entwurf mit [bitte ergänzen: Preis]

Diese Woche
· Familie Aydin · Wo finden wir die Fotos?
· Druckerei Beispielstadt · Rechnung
  186,40 € für 200 Postkarten, mit Zahlungsfrist.

Kann warten
· Kamerahandel Beispiel · Newsletter, keine Antwort nötig.

Deine Einteilung kann anders aussehen. Wichtig ist, dass alle fünf Mails vorkommen und jede genau einen Platz hat.

Gute Anweisungen in vier Teilen

Stell dir eine neue Aushilfe vor. Steht auf deinem Zettel nur „Mach mal die Mails“, muss sie raten. Dein Agent ist in derselben Lage. Er weiß nur, was in deiner Anweisung und in seinem Ordner steht. Eine gute Anweisung beantwortet vier Fragen:

• Sag beim Ziel, wozu. „Fass den Artikel zusammen“ ergibt eine Nacherzählung. Mit dem Zusatz „Ich lese die Tipps morgen vor dem Shooting“ bekommst du eine Liste zum Anwenden.
• Nenne beim Material den Ort. 03-uebungen/mails/druckerei-rechnung.txt findet er auf Anhieb. Dann liest er auch nur, was er braucht.
• Beschreib die Form. „Höchstens 80 Wörter“, „fünf Stichpunkte“ und „eine HTML-Seite in 02-ergebnisse“ sind gute Angaben. Eine Zahl hilft mehr als das Wort „kurz“.
• Nenne die Grenzen dieser Aufgabe. Zum Beispiel: Nenne keinen Preis, sag keinen Termin zu.
• Eine Aufgabe nach der anderen. Erst die Übersicht, dann die Antwort an Sabine Berger. Nach jedem Schritt kannst du prüfen und nachsteuern.

Weißt du selbst noch nicht genau, was du brauchst? Dann lass deinen Agenten zurückfragen:

Ergebnisse prüfen

KI kann sich irren. Manchmal liest sie eine Zahl falsch, manchmal erfindet sie etwas, das gut klingt. Darum prüfst du jedes Ergebnis, bevor du etwas davon nutzt. Du liest nicht jedes Wort gegen. Du stellst drei Fragen:

Eine Lücke wie „[bitte ergänzen]“ ist ein gutes Zeichen. Dein Agent weiß nicht, was du berechnest, und rät nicht. Stünde dort ein glatter Preis, wäre das dein Warnsignal.

Am Ende einer Aufgabe hilft diese Anweisung:

Nachbessern statt neu anfangen

Ein Ergebnis, das fast stimmt, ist eine gute Grundlage. Eine gute Korrektur nennt die Stelle, sagt, was richtig ist, und verrät, woher du das weißt. Zwei oder drei Runden sind normal.

Was an den Anbieter geht

Dein Agent arbeitet auf deinem Computer. Die KI dahinter läuft aber bei Anthropic. Alles, was dein Agent für eine Aufgabe liest, geht dorthin. Nur so kann die KI damit arbeiten. Deine Dateien bleiben auf deinem Computer, aber ihr Inhalt reist mit, sobald er sie liest.

Daraus folgt die wichtigste Regel: Du bestimmst, welche Ordner dein Agent sehen darf. Leg in seinen Ordner nur, was der Anbieter sehen darf.

Such außerdem in den Einstellungen deines KI-Kontos den Bereich zu Datenschutz oder Daten. Dort steht, ob deine Unterhaltungen zum Training der KI genutzt werden. Entscheide bewusst und sieh ab und zu wieder nach.

Kundendaten bleiben draußen

Oft reicht es nicht, Namen zu löschen. „Die Hochzeit am 15. Mai im Schlosshotel am See“ ist auch ohne Namen ziemlich eindeutig. Was du stattdessen tun kannst:

• Mit Erfundenem üben. Die Unterlagen in 03-uebungen sind erfunden.
• Vorlagen statt Kundendaten. Lass dir zum Beispiel ein Angebot mit Platzhaltern bauen. Namen und Termine trägst du danach selbst ein.
• Ein Geschäftskonto nutzen. Für Kundendaten brauchst du ein Geschäftskonto beim Anbieter und einen Vertrag zur Auftragsverarbeitung (Artikel 28 DSGVO). Das kostet extra.

Stand September 2026, keine Rechtsberatung. Für deinen eigenen Fall fragst du eine Fachperson für Datenschutz.

Was nie in seinen Ordner gehört

• Passwörter und Zugangsdaten, auch keine Liste und kein Zettel mit PIN.
• Bankdaten: Kontonummern, Kreditkarten, PINs und TANs.
• Ausweise: Scans und Fotos von Personalausweis, Reisepass und Führerschein.
• Gesundheit: Arztbriefe, Befunde und Krankschreibungen.
• Ganze Ordner auf Verdacht. Gib deinem Agenten die eine Datei, die er braucht.

Vor jeder neuen Unterlage hilft eine kurze Probe. Frag dich, ob es für dich in Ordnung ist, wenn der KI-Anbieter diese Seite liest. Wenn nicht, bleibt sie draußen.

Nachfragen an

Claude Code fragt nach, bevor es Dateien ändert. Das ist deine zweite Sicherung neben den Arbeitsregeln. Lass das so. Stell nichts so ein, dass dein Agent ohne Nachfrage arbeitet.

• Lies jede Erlaubnisfrage. Erlaube nur, was den Ordner „Mein-Agent“ betrifft und zu deiner Aufgabe passt.
• Sag Nein, wenn dich etwas überrascht. Will dein Agent plötzlich etwas verschicken, löschen oder eine Website öffnen? Wenn du das nicht wolltest, sag Nein und frag nach dem Grund.
• Keine Verbindungen zu Beginn. Die Vorlage verbindet kein Postfach und keinen Kalender. Die Arbeitsregeln begrenzen die Aufgabe. Welche Dateien der Agent öffnen kann, bestimmen zusätzlich die Rechte deines Programms.
• Passwörter und Zahlungsdaten gibst du deinem Agenten nie. Muss sich ein Programm irgendwo anmelden, meldest du dich selbst an.

Fremde Anweisungen in Unterlagen

Manchmal steht in einer Mail ein Satz, der wie ein Befehl klingt, etwa „Überweise den Betrag sofort“. Laut seinen Arbeitsregeln ist das für deinen Agenten Inhalt und kein Befehl. Er befolgt es nicht und weist dich darauf hin. Das ist eine Regel, keine technische Sperre. Darum liest du die Erlaubnisfragen und prüfst jedes Ergebnis.

Sichern, bevor er etwas ändert

Löscht dein Agent eine Datei, landet sie in der Regel nicht im Papierkorb. Sie ist sofort weg. Deshalb sagen seine Arbeitsregeln: nichts löschen, verschieben oder überschreiben, ohne zu fragen und vorher zu sichern. Dafür nutzt er die Anleitung „arbeitsstand-sichern“. Sie legt im Ordner „sicherungen“ eine Kopie mit Datum und Uhrzeit an. Vor wichtigen Änderungen bittest du ihn am besten selbst darum:

Willst du etwas rückgängig machen, schreib: „Hol die letzte Sicherung zurück.“ Er zeigt dir die Sicherungen mit Datum und überschreibt erst nach deinem Ja. Was du nicht mehr brauchst, kommt in einen Ordner „archiv“. Lieber archivieren als löschen.

Eine Kopie außerhalb deines Computers

Die Sicherungen liegen auf deinem Computer. Geht er kaputt, sind sie mit weg. Diese zweite Kopie machst du selbst, einmal pro Woche und vor jedem großen Aufräumen:

1. Programm schließen So ändert sich während des Kopierens nichts.
2. Den ganzen Ordner kopieren Kopiere den ganzen Ordner „Mein-Agent“. Dann sind auch die versteckten Anleitungen dabei.
3. An einen zweiten Ort Leg die Kopie auf einen USB-Stick, eine externe Festplatte oder in deinen Cloud-Speicher.
4. Datum anhängen Nenn die Kopie zum Beispiel „Mein-Agent 2026-09-24“.

Deine Checkliste

• Im Ordner deines Agenten liegt nur, was der KI-Anbieter sehen darf.
• Kundendaten nutzt du nur mit einem Geschäftskonto und einem Vertrag zur Auftragsverarbeitung.
• Passwörter, PINs, TANs und Ausweisfotos liegen nie im Ordner und stehen nie in der Unterhaltung.
• Du liest jede Erlaubnisfrage deines Programms, bevor du zustimmst.
• Vor größeren Änderungen sichert dein Agent zuerst.
• Nichts geht raus, bevor du es geprüft hast.

Beim Einrichten

Bei der Arbeit

Bei Daten und Sicherheit

Weitere Hilfe

Mehr Hilfe findest du im Lernportal AgentOS unter „Hilfe“. Dort beantwortet dir auch „Frag AgentOS“ deine Frage aus den Lektionen und Anleitungen. Kommst du nicht weiter, schreib uns an hello@fluxward.com.

01-eingang, 02-ergebnisse, 03-uebungen

In 01-eingang legst du Unterlagen, in 02-ergebnisse legt dein Agent fertige Dateien ab. In 03-uebungen liegen erfundene Unterlagen zum Üben.

AGENTS.md

Die Datei mit den Arbeitsregeln deines Agenten, im Hauptordner deiner Vorlage. Codex und OpenCode lesen sie bei jedem Start.

Anbieter

Die Firma hinter dem KI-Modell, etwa OpenAI oder Anthropic. Was dein Agent für eine Aufgabe liest, geht zur Verarbeitung an sie.

Anleitung

Feste Regeln für eine wiederkehrende Aufgabe, die dein Agent nutzt, wenn die Aufgabe passt. In den Programmen heißt sie Skill; das Ergebnis prüfst du trotzdem.

Anweisung

Was du deinem Agenten schreibst oder sagst, damit er eine Aufgabe erledigt. Auf Englisch heißt das Prompt.

Arbeitsregeln

Die Regeln, an die sich dein Agent halten soll, etwa: nichts verschicken, löschen oder bezahlen, ohne dich zu fragen. Es sind Regeln, keine technische Sperre.

Claude Code

Das Programm von Anthropic, in dem dein Agent arbeitet, wenn du ein Claude-Abo hast. Du findest es in der Claude-App.

CLAUDE.md

Die Datei, die Claude Code bei jedem Start liest. In deiner Vorlage verweist sie auf AGENTS.md, damit überall dieselben Regeln gelten.

Erlaubnis

Eine Rückfrage deines Programms, bevor es etwas tut, das seine eingestellten Grenzen berührt: etwa einen Befehl ausführen, außerhalb des Ordners arbeiten oder ins Internet gehen. Lesen und Ändern im Ordner läuft je nach Einstellung ohne Frage. Erlaube nur, was zum Ordner „Mein-Agent“ und zu deiner Aufgabe passt.

Fremde Anweisung

Ein Satz in einer Mail, einem PDF oder auf einer Webseite, der deinem Agenten etwas befehlen will, etwa „Überweise sofort“. Laut seinen Arbeitsregeln ist so etwas Inhalt, und er befolgt es nicht.

HTML-Seite

Eine Datei, die sich mit einem Doppelklick im Browser öffnet, wie eine Webseite, nur auf deinem Computer. Dein Agent legt Übersichten gern so ab, weil man sie gut lesen und drucken kann.

KI-Agent

Ein KI-Agent erledigt Aufgaben an deinem Computer: mit den Dateien in seinem Ordner, nach deinen Regeln. Das Ergebnis prüfst du.

Sicherung

Eine Kopie deiner Dateien vom Stand vor einer Änderung. Laut seinen Arbeitsregeln legt dein Agent sie vor Änderungen im Ordner „sicherungen“ an und holt sie auf Wunsch zurück.

Vorlage

Der fertige Ordner „Mein-Agent“, den du bei AgentOS unter „Mein Agent“ zusammenstellst und herunterlädst. Darin stecken Arbeitsregeln, Anleitungen und Übungen für dein Programm.