Documentación / MCP y ACP
Claude Code
Ejecuta tu propio Claude Code dentro de Yuli, con tu cuenta, conectado a todo el IDE y con las mismas reglas.
En Modo suscripción, Yuli ejecuta tu propio Claude Code, sin modificarlo y con tu propia cuenta. Claude Code razona; Yuli le da el IDE completo como herramientas y hace cumplir las mismas reglas que a su agente propio.
Claude Code es un producto de Anthropic. Yuli no está afiliado con Anthropic ni respaldado por ella. Yuli nunca toca tus credenciales: inicias sesión tú, con el flujo oficial.
Conectar paso a paso
- Elige el agente. En el selector de arriba del chat, ¿Con quién trabajas?, elige Claude Code en el grupo «Tu suscripción · tu cuenta». También puedes hacerlo en Opciones globales → IA y modelos → Modo de IA → Agente.
- Instalación. Si Yuli no encuentra
claude, verás «Instala Claude Code para usarlo aquí». Pulsa Abrir instalador oficial, instálalo y pulsa Volver a detectar. Yuli no descarga ni instala el CLI. - Aviso. Una sola vez, «Antes de empezar con el modo suscripción» te explica que Claude Code usa tu cuenta y que el código que lee va a Anthropic bajo tu cuenta, igual que fuera de Yuli. Pulsa Entendido, continuar.
- Confianza de la carpeta. A «¿Confías en esta carpeta para Claude Code?» responde con Confiar y abrir Claude Code. Yuli deja aprobado también el servidor
yuli, así Claude Code no vuelve a preguntar. - Inicia sesión dentro de Claude Code, en la terminal, como siempre.
- Si Claude Code todavía no aprobó el servidor
yuli, aparece Aprobar ahora: reinicia la sesión con la misma conversación.
Yuli detecta claude en el PATH, en las rutas del instalador oficial y de npm, y dentro de WSL en Windows.
Dónde vive la configuración
Por defecto, Yuli no escribe nada en tu proyecto. Su configuración vive en la carpeta de trabajo de Yuli y se entrega a Claude Code al iniciarlo, con opciones documentadas del CLI:
| Opción | Archivo | Contenido |
|---|---|---|
--settings |
settings.json |
Permisos, hooks y línea de estado. |
--mcp-config |
mcp.json |
El servidor yuli por stdio. |
--append-system-prompt-file |
rules.md |
Las reglas de Yuli. |
--plugin-dir |
plugin/ |
El plugin yuli-code: skills de Yuli y el agente revisor. |
En Windows, esos archivos están en %LOCALAPPDATA%\.yulicode\workspaces\<id del proyecto>\claude\ y se regeneran en cada inicio de sesión.
Dentro del proyecto (opcional)
En Opciones globales → IA y modelos → Modo de IA, grupo «Reglas del Modo suscripción», desactiva Configuración fuera del proyecto. Entonces Yuli escribe su configuración dentro del proyecto, excluida de Git:
| Archivo | Contenido |
|---|---|
.mcp.json |
Registra el servidor yuli. Conserva tus otros servidores. |
.claude/CLAUDE.md |
Reglas de Yuli en un bloque gestionado. Lo que escribas fuera nunca se toca. |
.claude/settings.local.json |
Permisos y hooks. Tus reglas se conservan. |
.claude/hooks/yuli-hook |
Reenvía cada evento a Yuli. |
.claude/rules/ |
Estándares del stack y reglas Sonar. |
.claude/skills/yuli-* |
Procedimientos de Yuli. |
.claude/agents/yuli-reviewer.md |
El agente revisor. |
Antes de escribir, Yuli te muestra cada archivo con su diff: Aplicar N archivos o Ahora no. Se aplica como una tarea en la ventana de cambios y se puede deshacer.
Permisos
| Lista | Contenido |
|---|---|
| allow | Bash, Edit, Write, MultiEdit, NotebookEdit, WebFetch, WebSearch y las herramientas yuli_* (salvo Git y CI). |
| ask | git commit, git push, git merge, git rebase, git reset --hard, gh pr, glab mr, az pipelines, az repos, y yuli_git_commit, yuli_git_push, yuli_cloudbees. |
| deny | Leer .env (en cualquier carpeta) y ~/.ssh/**. Las llaves y *.pem las bloquea el hook. |
Yuli también desactiva la atribución automática en commits y PR.
Hooks
| Evento | Qué hace Yuli |
|---|---|
SessionStart |
Inyecta la memoria del proyecto, el estilo de arquitectura y la misión. Tras compactar o reanudar, vuelve a inyectar la misión. |
UserPromptSubmit |
Decide si Git y CI quedan habilitados en la sesión según tu pedido. |
PreToolUse |
Bloquea Git/CI no pedidos y la lectura de secretos, revisa estructura y nombres, y muestra preguntas como tarjetas. |
PostToolUse |
Refleja el trabajo en la ventana de cambios, el plan, la verificación y la calidad. |
PermissionRequest |
Muestra la petición como tarjeta de Yuli. |
Stop |
No deja cerrar el turno sin verificación en verde ni medición, hasta el número de reintentos. |
SubagentStart / SubagentStop |
Cuenta los subagentes en segundo plano. |
Notification |
Avisa de los diálogos de la terminal. |
Si Yuli está cerrado, los hooks no bloquean nada.
Trabajar
La pestaña tiene dos vistas, que cambias arriba a la derecha:
- Chat (por defecto): tus pedidos, las respuestas con formato, los archivos cambiados, la verificación y el plan en vivo. Claude Code queda compacto abajo: ahí escribes.
- Terminal: Claude Code a pantalla completa.
Arriba de ambas:
- Modelo y Esfuerzo de razonamiento. Aplicar y reiniciar reinicia Claude Code y continúa la misma conversación.
- Uso del plan de Claude: la ventana de 5 horas, la semana y el límite de gasto.
Los menús propios de la terminal de Claude Code aparecen como una tarjeta con las mismas opciones. Yuli envía las teclas solo cuando haces clic.
Reglas que Yuli hace cumplir
| Regla | Cómo |
|---|---|
| Git, CI y DevOps solo si lo pides | El hook los bloquea si en la sesión no lo pediste. Con el pedido, cada acción sigue pidiendo aprobación. |
| Ramas solo si las pides | Crear una rama o un worktree se bloquea aunque Git esté habilitado. |
| Secretos protegidos | No se leen .env, llaves ni credenciales. |
| Estructura y nombres | Cada escritura se revisa; si algo falla, se bloquea con la corrección exacta. |
| Criterio de terminado | Sin verificación en verde (build, pruebas y arranque), Claude Code no puede terminar el turno. |
Desactiva Hacer cumplir las reglas para pasar a «Solo avisar». Git y secretos se protegen siempre. Reintentos de verificación fija cuántas veces insiste Yuli (3 por defecto).
Solución de problemas
| Síntoma | Qué hacer |
|---|---|
| «Esperando a que Claude Code use las herramientas de Yuli» | Aprueba el servidor yuli o pulsa Aprobar ahora. Revísalo con /mcp. |
/mcp muestra yuli con error |
Abre el proyecto en Yuli. yuli_status explica el motivo. |
| Las reglas no cambiaron | Se cargan al iniciar: reinicia la sesión desde la barra. |