Dokumentation / MCP und ACP
Claude Code
Führe dein eigenes Claude Code in Yuli aus – mit deinem Konto, verbunden mit der gesamten IDE und unter denselben Regeln.
Im Abo-Modus führt Yuli dein eigenes Claude Code aus – unverändert und mit deinem eigenen Konto. Claude Code denkt; Yuli stellt ihm die komplette IDE als Tools bereit und setzt dieselben Regeln durch wie beim eigenen Agenten.
Claude Code ist ein Produkt von Anthropic. Yuli ist weder mit Anthropic verbunden noch von Anthropic unterstützt. Yuli rührt deine Zugangsdaten nie an: Du meldest dich selbst über den offiziellen Ablauf an.
Schritt für Schritt verbinden
- Agent wählen. Wähle im Auswahlfeld oberhalb des Chats, Mit wem arbeitest du?, in der Gruppe „Dein Abo · dein Konto“ Claude Code. Alternativ unter Globale Optionen → KI und Modelle → KI-Modus → Agent.
- Installation. Findet Yuli
claudenicht, siehst du „Installiere Claude Code, um es hier zu nutzen“. Klicke auf Offiziellen Installer öffnen, installiere es und klicke auf Erneut erkennen. Yuli lädt die CLI weder herunter noch installiert es sie. - Hinweis. Ein einziges Mal erklärt dir „Bevor du mit dem Abo-Modus startest“, dass Claude Code dein Konto nutzt und der gelesene Code unter deinem Konto an Anthropic geht – genau wie außerhalb von Yuli. Klicke auf Verstanden, weiter.
- Ordnervertrauen. Beantworte „Vertraust du diesem Ordner für Claude Code?“ mit Vertrauen und Claude Code öffnen. Yuli gibt dabei auch den Server
yulifrei, damit Claude Code nicht erneut fragt. - Melde dich wie gewohnt in Claude Code im Terminal an.
- Hat Claude Code den Server
yulinoch nicht freigegeben, erscheint Jetzt freigeben: Damit wird die Sitzung mit derselben Unterhaltung neu gestartet.
Yuli findet claude im PATH, in den Pfaden des offiziellen Installers und von npm sowie unter Windows innerhalb von WSL.
Wo die Konfiguration liegt
Standardmäßig schreibt Yuli nichts in dein Projekt. Die Konfiguration liegt im Arbeitsordner von Yuli und wird Claude Code beim Start über dokumentierte CLI-Optionen übergeben:
| Option | Datei | Inhalt |
|---|---|---|
--settings |
settings.json |
Berechtigungen, Hooks und Statuszeile. |
--mcp-config |
mcp.json |
Der Server yuli über stdio. |
--append-system-prompt-file |
rules.md |
Die Regeln von Yuli. |
--plugin-dir |
plugin/ |
Das Plugin yuli-code: Yuli-Skills und der Review-Agent. |
Unter Windows liegen diese Dateien in %LOCALAPPDATA%\.yulicode\workspaces\<id del proyecto>\claude\ und werden bei jedem Sitzungsstart neu erzeugt.
Im Projekt (optional)
Deaktiviere unter Globale Optionen → KI und Modelle → KI-Modus, Gruppe „Regeln des Abo-Modus“, die Option Konfiguration außerhalb des Projekts. Dann schreibt Yuli seine Konfiguration ins Projekt, von Git ausgeschlossen:
| Datei | Inhalt |
|---|---|
.mcp.json |
Registriert den Server yuli. Deine anderen Server bleiben erhalten. |
.claude/CLAUDE.md |
Yuli-Regeln in einem verwalteten Block. Was du außerhalb davon schreibst, bleibt unangetastet. |
.claude/settings.local.json |
Berechtigungen und Hooks. Deine Regeln bleiben erhalten. |
.claude/hooks/yuli-hook |
Leitet jedes Ereignis an Yuli weiter. |
.claude/rules/ |
Stack-Standards und Sonar-Regeln. |
.claude/skills/yuli-* |
Abläufe von Yuli. |
.claude/agents/yuli-reviewer.md |
Der Review-Agent. |
Bevor Yuli schreibt, zeigt es dir jede Datei mit ihrem Diff: N Dateien anwenden oder Jetzt nicht. Das Ganze wird als Aufgabe im Änderungsfenster angewendet und lässt sich rückgängig machen.
Berechtigungen
| Liste | Inhalt |
|---|---|
| allow | Bash, Edit, Write, MultiEdit, NotebookEdit, WebFetch, WebSearch und die yuli_*-Tools (außer Git und CI). |
| ask | git commit, git push, git merge, git rebase, git reset --hard, gh pr, glab mr, az pipelines, az repos sowie yuli_git_commit, yuli_git_push, yuli_cloudbees. |
| deny | Lesen von .env (in jedem Ordner) und ~/.ssh/**. Schlüssel und *.pem blockiert der Hook. |
Yuli deaktiviert außerdem die automatische Attribution in Commits und PRs.
Hooks
| Ereignis | Was Yuli tut |
|---|---|
SessionStart |
Injiziert das Projektgedächtnis, den Architekturstil und die Mission. Nach dem Kompaktieren oder Fortsetzen wird die Mission erneut injiziert. |
UserPromptSubmit |
Entscheidet anhand deiner Anfrage, ob Git und CI in der Sitzung freigeschaltet werden. |
PreToolUse |
Blockiert nicht angeforderte Git-/CI-Aktionen und das Lesen von Secrets, prüft Struktur und Namen und zeigt Fragen als Karten an. |
PostToolUse |
Spiegelt die Arbeit im Änderungsfenster, im Plan, in der Verifizierung und in der Qualität. |
PermissionRequest |
Zeigt die Anfrage als Yuli-Karte an. |
Stop |
Lässt den Turn ohne grüne Verifizierung und ohne Messung nicht enden – bis zur festgelegten Zahl an Wiederholungen. |
SubagentStart / SubagentStop |
Zählt die Subagenten im Hintergrund. |
Notification |
Weist auf Dialoge im Terminal hin. |
Ist Yuli geschlossen, blockieren die Hooks nichts.
Arbeiten
Der Tab hat zwei Ansichten, zwischen denen du oben rechts wechselst:
- Chat (Standard): deine Anfragen, formatierte Antworten, geänderte Dateien, die Verifizierung und der Plan live. Claude Code bleibt kompakt unten: Dort schreibst du.
- Terminal: Claude Code im Vollbild.
Über beiden Ansichten:
- Modell und Denkaufwand. Übernehmen und neu starten startet Claude Code neu und setzt dieselbe Unterhaltung fort.
- Claude-Plannutzung: das 5-Stunden-Fenster, die Woche und das Ausgabenlimit.
Die eigenen Menüs des Claude-Code-Terminals erscheinen als Karte mit denselben Optionen. Yuli sendet die Tasten erst, wenn du klickst.
Regeln, die Yuli durchsetzt
| Regel | Wie |
|---|---|
| Git, CI und DevOps nur auf deine Anfrage | Der Hook blockiert sie, wenn du sie in der Sitzung nicht angefordert hast. Auch mit Anfrage erfordert jede Aktion weiterhin eine Freigabe. |
| Branches nur auf Anfrage | Das Anlegen eines Branches oder Worktrees wird blockiert, selbst wenn Git freigeschaltet ist. |
| Geschützte Secrets | .env, Schlüssel und Zugangsdaten werden nicht gelesen. |
| Struktur und Namen | Jeder Schreibvorgang wird geprüft; schlägt etwas fehl, wird er mit der exakten Korrektur blockiert. |
| Fertig-Kriterium | Ohne grüne Verifizierung (Build, Tests und Start) kann Claude Code den Turn nicht beenden. |
Deaktiviere Regeln durchsetzen, um auf „Nur warnen“ umzuschalten. Git und Secrets sind immer geschützt. Prüfwiederholungen legt fest, wie oft Yuli nachhakt (standardmäßig 3).
Fehlerbehebung
| Symptom | Was zu tun ist |
|---|---|
| „Warte darauf, dass Claude Code Yulis Werkzeuge nutzt“ | Gib den Server yuli frei oder klicke auf Jetzt freigeben. Prüfe es mit /mcp. |
/mcp zeigt yuli mit Fehler |
Öffne das Projekt in Yuli. yuli_status erklärt den Grund. |
| Die Regeln haben sich nicht geändert | Sie werden beim Start geladen: Starte die Sitzung über die Leiste neu. |