Documentație / MCP și ACP
Claude Code
Rulează propriul tău Claude Code în Yuli, cu contul tău, conectat la întregul IDE și cu aceleași reguli.
În Modul abonament, Yuli rulează propriul tău Claude Code, nemodificat și cu propriul tău cont. Claude Code raționează; Yuli îi pune la dispoziție întregul IDE ca unelte și impune aceleași reguli ca pentru agentul propriu.
Claude Code este un produs Anthropic. Yuli nu este afiliat cu Anthropic și nici susținut de aceasta. Yuli nu atinge niciodată credențialele tale: te autentifici tu, prin fluxul oficial.
Conectare pas cu pas
- Alege agentul. În selectorul de deasupra chatului, Cu cine lucrezi?, alege Claude Code din grupul „Abonamentul tău · contul tău”. O poți face și din Opțiuni globale → IA și modele → Modul IA → Agent.
- Instalare. Dacă Yuli nu găsește
claude, vei vedea „Instalează Claude Code ca să-l folosești aici”. Apasă Deschide instalatorul oficial, instalează-l și apasă Detectează din nou. Yuli nu descarcă și nu instalează CLI-ul. - Avertisment. O singură dată, „Înainte să începi cu modul abonament” îți explică faptul că Claude Code folosește contul tău și că, sub contul tău, codul pe care îl citește ajunge la Anthropic, exact ca în afara Yuli. Apasă Am înțeles, continuă.
- Încrederea în folder. La „Ai încredere în acest folder pentru Claude Code?” răspunde cu Am încredere, deschide Claude Code. Yuli aprobă și serverul
yuli, astfel încât Claude Code să nu mai întrebe. - Autentifică-te în Claude Code, în terminal, ca de obicei.
- Dacă Claude Code încă nu a aprobat serverul
yuli, apare Aprobă acum: repornește sesiunea cu aceeași conversație.
Yuli detectează claude în PATH, în căile instalatorului oficial și ale npm, iar în Windows și în interiorul WSL.
Unde se află configurația
Implicit, Yuli nu scrie nimic în proiectul tău. Configurația lui se află în folderul de lucru Yuli și este transmisă lui Claude Code la pornire, prin opțiuni documentate ale CLI-ului:
| Opțiune | Fișier | Conținut |
|---|---|---|
--settings |
settings.json |
Permisiuni, hooks și linia de stare. |
--mcp-config |
mcp.json |
Serverul yuli prin stdio. |
--append-system-prompt-file |
rules.md |
Regulile Yuli. |
--plugin-dir |
plugin/ |
Pluginul yuli-code: skills Yuli și agentul revizor. |
În Windows, aceste fișiere se află în %LOCALAPPDATA%\.yulicode\workspaces\<id del proyecto>\claude\ și sunt regenerate la fiecare pornire a sesiunii.
În interiorul proiectului (opțional)
În Opțiuni globale → IA și modele → Modul IA, grupul „Regulile modului abonament”, dezactivează Configurație în afara proiectului. Atunci Yuli își scrie configurația în interiorul proiectului, exclusă din Git:
| Fișier | Conținut |
|---|---|
.mcp.json |
Înregistrează serverul yuli. Păstrează celelalte servere ale tale. |
.claude/CLAUDE.md |
Regulile Yuli într-un bloc gestionat. Ce scrii în afara lui nu este atins niciodată. |
.claude/settings.local.json |
Permisiuni și hooks. Regulile tale se păstrează. |
.claude/hooks/yuli-hook |
Redirecționează fiecare eveniment către Yuli. |
.claude/rules/ |
Standardele stack-ului și regulile Sonar. |
.claude/skills/yuli-* |
Procedurile Yuli. |
.claude/agents/yuli-reviewer.md |
Agentul revizor. |
Înainte de a scrie, Yuli îți arată fiecare fișier cu diff-ul lui: Aplică N fișiere sau Nu acum. Se aplică drept o sarcină în fereastra de modificări și poate fi anulat.
Permisiuni
| Listă | Conținut |
|---|---|
| allow | Bash, Edit, Write, MultiEdit, NotebookEdit, WebFetch, WebSearch și uneltele yuli_* (cu excepția Git și CI). |
| ask | git commit, git push, git merge, git rebase, git reset --hard, gh pr, glab mr, az pipelines, az repos, precum și yuli_git_commit, yuli_git_push, yuli_cloudbees. |
| deny | Citirea .env (în orice folder) și ~/.ssh/**. Cheile și *.pem sunt blocate de hook. |
Yuli dezactivează și atribuirea automată în commit-uri și PR-uri.
Hooks
| Eveniment | Ce face Yuli |
|---|---|
SessionStart |
Injectează memoria proiectului, stilul de arhitectură și misiunea. După compactare sau reluare, reinjectează misiunea. |
UserPromptSubmit |
Decide, în funcție de cererea ta, dacă Git și CI rămân activate în sesiune. |
PreToolUse |
Blochează Git/CI necerute și citirea secretelor, verifică structura și numele și afișează întrebările sub formă de carduri. |
PostToolUse |
Reflectă munca în fereastra de modificări, plan, verificare și calitate. |
PermissionRequest |
Afișează cererea ca un card Yuli. |
Stop |
Nu permite închiderea turei fără verificare în verde și fără măsurare, până la numărul de reîncercări. |
SubagentStart / SubagentStop |
Numără subagenții din fundal. |
Notification |
Anunță dialogurile din terminal. |
Dacă Yuli este închis, hook-urile nu blochează nimic.
Lucrul
Fila are două vizualizări, pe care le comuți din colțul din dreapta sus:
- Chat (implicit): cererile tale, răspunsurile formatate, fișierele modificate, verificarea și planul în timp real. Claude Code rămâne compact jos: acolo scrii.
- Terminal: Claude Code pe tot ecranul.
Deasupra ambelor:
- Model și Efort de raționament. Aplică și repornește repornește Claude Code și continuă aceeași conversație.
- Utilizarea planului Claude: fereastra de 5 ore, săptămâna și limita de cheltuieli.
Meniurile proprii ale terminalului Claude Code apar ca un card cu aceleași opțiuni. Yuli trimite tastele doar când dai clic.
Reguli impuse de Yuli
| Regulă | Cum |
|---|---|
| Git, CI și DevOps doar dacă le ceri | Hook-ul le blochează dacă nu le-ai cerut în sesiune. Cu cerere, fiecare acțiune necesită în continuare aprobare. |
| Ramuri doar dacă le ceri | Crearea unei ramuri sau a unui worktree este blocată chiar dacă Git este activat. |
| Secrete protejate | Nu se citesc .env, chei sau credențiale. |
| Structură și nume | Fiecare scriere este verificată; dacă ceva nu este în regulă, este blocată cu corectura exactă. |
| Criteriul de finalizare | Fără verificare în verde (build, teste și pornire), Claude Code nu poate încheia tura. |
Dezactivează Impune regulile pentru a trece la „Doar avertizare”. Git și secretele sunt protejate întotdeauna. Reîncercări de verificare stabilește de câte ori insistă Yuli (implicit 3).
Depanarea problemelor
| Simptom | Ce faci |
|---|---|
| „Se așteaptă ca Claude Code să folosească uneltele Yuli” | Aprobă serverul yuli sau apasă Aprobă acum. Verifică cu /mcp. |
/mcp arată yuli cu eroare |
Deschide proiectul în Yuli. yuli_status explică motivul. |
| Regulile nu s-au schimbat | Se încarcă la pornire: repornește sesiunea din bară. |