Documentation / MCP et ACP
Claude Code
Exécutez votre propre Claude Code dans Yuli, avec votre compte, connecté à tout l’IDE et soumis aux mêmes règles.
En Mode abonnement, Yuli exécute votre propre Claude Code, sans le modifier et avec votre propre compte. Claude Code raisonne ; Yuli lui fournit l’IDE complet sous forme d’outils et fait respecter les mêmes règles qu’à son propre agent.
Claude Code est un produit d’Anthropic. Yuli n’est ni affilié à Anthropic ni approuvé par elle. Yuli ne touche jamais à vos identifiants : c’est vous qui vous connectez, avec le flux officiel.
Connexion pas à pas
- Choisissez l’agent. Dans le sélecteur au-dessus du chat, Avec qui travaillez-vous ?, choisissez Claude Code dans le groupe « Votre abonnement · votre compte ». Vous pouvez aussi le faire dans Options globales → IA et modèles → Mode IA → Agent.
- Installation. Si Yuli ne trouve pas
claude, vous verrez « Installe Claude Code pour l'utiliser ici ». Cliquez sur Ouvrir l'installateur officiel, installez-le, puis cliquez sur Redétecter. Yuli ne télécharge ni n’installe le CLI. - Avertissement. Une seule fois, « Avant de commencer avec le mode abonnement » vous explique que Claude Code utilise votre compte et que le code qu’il lit est envoyé à Anthropic sous votre compte, comme en dehors de Yuli. Cliquez sur Compris, continuer.
- Confiance dans le dossier. À « Faites-vous confiance à ce dossier pour Claude Code ? », répondez avec Faire confiance et ouvrir Claude Code. Yuli approuve également le serveur
yuli, afin que Claude Code ne pose plus la question. - Connectez-vous dans Claude Code, dans le terminal, comme d’habitude.
- Si Claude Code n’a pas encore approuvé le serveur
yuli, Approuver maintenant apparaît : la session redémarre avec la même conversation.
Yuli détecte claude dans le PATH, dans les chemins de l’installateur officiel et de npm, et dans WSL sous Windows.
Où se trouve la configuration
Par défaut, Yuli n’écrit rien dans votre projet. Sa configuration réside dans le dossier de travail de Yuli et est transmise à Claude Code au démarrage, via des options documentées du CLI :
| Option | Fichier | Contenu |
|---|---|---|
--settings |
settings.json |
Permissions, hooks et ligne d’état. |
--mcp-config |
mcp.json |
Le serveur yuli via stdio. |
--append-system-prompt-file |
rules.md |
Les règles de Yuli. |
--plugin-dir |
plugin/ |
Le plugin yuli-code : skills de Yuli et agent relecteur. |
Sous Windows, ces fichiers se trouvent dans %LOCALAPPDATA%\.yulicode\workspaces\<id du projet>\claude\ et sont régénérés à chaque ouverture de session.
Dans le projet (facultatif)
Dans Options globales → IA et modèles → Mode IA, groupe « Règles du mode abonnement », désactivez Configuration hors du projet. Yuli écrit alors sa configuration dans le projet, exclue de Git :
| Fichier | Contenu |
|---|---|
.mcp.json |
Enregistre le serveur yuli. Conserve vos autres serveurs. |
.claude/CLAUDE.md |
Règles de Yuli dans un bloc géré. Ce que vous écrivez en dehors n’est jamais modifié. |
.claude/settings.local.json |
Permissions et hooks. Vos règles sont conservées. |
.claude/hooks/yuli-hook |
Transmet chaque événement à Yuli. |
.claude/rules/ |
Standards de la stack et règles Sonar. |
.claude/skills/yuli-* |
Procédures de Yuli. |
.claude/agents/yuli-reviewer.md |
L’agent relecteur. |
Avant d’écrire, Yuli vous montre chaque fichier avec son diff : Appliquer N fichiers ou Pas maintenant. L’opération s’applique comme une tâche dans la fenêtre de modifications et peut être annulée.
Permissions
| Liste | Contenu |
|---|---|
| allow | Bash, Edit, Write, MultiEdit, NotebookEdit, WebFetch, WebSearch et les outils yuli_* (sauf Git et CI). |
| ask | git commit, git push, git merge, git rebase, git reset --hard, gh pr, glab mr, az pipelines, az repos, ainsi que yuli_git_commit, yuli_git_push, yuli_cloudbees. |
| deny | Lire .env (dans n’importe quel dossier) et ~/.ssh/**. Les clés et les *.pem sont bloqués par le hook. |
Yuli désactive également l’attribution automatique dans les commits et les PR.
Hooks
| Événement | Ce que fait Yuli |
|---|---|
SessionStart |
Injecte la mémoire du projet, le style d’architecture et la mission. Après une compaction ou une reprise, il réinjecte la mission. |
UserPromptSubmit |
Décide si Git et la CI sont activés pour la session selon votre demande. |
PreToolUse |
Bloque Git/CI non demandés et la lecture des secrets, vérifie la structure et les noms, et affiche les questions sous forme de cartes. |
PostToolUse |
Reflète le travail dans la fenêtre de modifications, le plan, la vérification et la qualité. |
PermissionRequest |
Affiche la demande sous forme de carte Yuli. |
Stop |
Empêche de clore le tour sans vérification au vert ni mesure, jusqu’au nombre de tentatives prévu. |
SubagentStart / SubagentStop |
Compte les sous-agents en arrière-plan. |
Notification |
Signale les boîtes de dialogue du terminal. |
Si Yuli est fermé, les hooks ne bloquent rien.
Travailler
L’onglet propose deux vues, que vous changez en haut à droite :
- Chat (par défaut) : vos demandes, les réponses mises en forme, les fichiers modifiés, la vérification et le plan en direct. Claude Code reste compact en bas : c’est là que vous écrivez.
- Terminal : Claude Code en plein écran.
Au-dessus des deux :
- Modèle et Effort de raisonnement. Appliquer et redémarrer redémarre Claude Code et poursuit la même conversation.
- Usage du forfait Claude : la fenêtre de 5 heures, la semaine et la limite de dépenses.
Les menus propres au terminal de Claude Code apparaissent sous forme de carte avec les mêmes options. Yuli n’envoie les touches que lorsque vous cliquez.
Règles que Yuli fait respecter
| Règle | Comment |
|---|---|
| Git, CI et DevOps uniquement si vous le demandez | Le hook les bloque si vous ne l’avez pas demandé dans la session. Avec la demande, chaque action requiert toujours une approbation. |
| Branches uniquement si vous les demandez | La création d’une branche ou d’un worktree est bloquée même si Git est activé. |
| Secrets protégés | Les .env, clés et identifiants ne sont pas lus. |
| Structure et noms | Chaque écriture est vérifiée ; en cas d’échec, elle est bloquée avec la correction exacte. |
| Critère de fin | Sans vérification au vert (build, tests et démarrage), Claude Code ne peut pas terminer le tour. |
Désactivez Faire respecter les règles pour passer en « Avertir seulement ». Git et les secrets restent toujours protégés. Tentatives de vérification fixe le nombre de fois où Yuli insiste (3 par défaut).
Dépannage
| Symptôme | Que faire |
|---|---|
| « En attente de l'utilisation des outils de Yuli par Claude Code » | Approuvez le serveur yuli ou cliquez sur Approuver maintenant. Vérifiez avec /mcp. |
/mcp affiche yuli en erreur |
Ouvrez le projet dans Yuli. yuli_status en explique la raison. |
| Les règles n’ont pas changé | Elles sont chargées au démarrage : redémarrez la session depuis la barre. |