Struktura projekta | Ekosistem NativeAI Hub

Ekosistem Claude Code ima jasno hierarhijo datotek: ~/.claude/ za globalno konfiguracijo (agents/, skills/, settings.json), ~/.claude.json za strežnike MCP in CLAUDE.md v korenu vsakega projekta za projektna posebna navodila. Agente in veščine hranite v pripadajočih imenikih, konfiguracije MCP v ~/.claude.json, projektni kontekst pa v CLAUDE.md.

01Kaj počne

Vse ima svoje mesto

Ekosistem Claude Code se razteza čez tri lokacije na vašem računalniku, vsaka s svojim namenom. Globalna konfiguracija je v ~/.claude/ in ~/.claude.json ter pokriva agente, veščine, nastavitve in strežnike MCP, ki veljajo povsod. Projektni posebni kontekst je v datoteki CLAUDE.md v korenu vsakega projekta in daje Claudu znanje, ki ga potrebuje za tisto kodno bazo. Razumevanje te hierarhije je bistveno, saj napačno umeščene datoteke bodisi naložijo povsod (in trošijo kontekst) bodisi se sploh ne naložijo.

02Zemljevid imenikov

~/.claude/ (globalni imenik)

Ta imenik vsebuje vse, kar velja za vse projekte. Podmapa agents/ vsebuje vaše prilagojene datoteke agentov .md. Podmapa skills/ vsebuje definicije veščin (vsaka v svoji podmapi z datoteko SKILL.md). Datoteka settings.json hrani dovoljenja, hooke, spremenljivke okolja in strežnike MCP. Mapa continue-prompts/ hrani datoteke za nadaljevanje sej. To je vaš osebni operacijski sistem Claude Code.

~/.claude.json (globalni register MCP)

Ločena datoteka JSON v korenu vašega domačega imenika. Hrani globalne konfiguracije strežnikov MCP (orodja, na katera se lahko Claude poveže v vsaki seji) in projektne posebne nastavitve MCP pod ključem "projects". Claude Code sem zapisuje tudi metrike seje in notranje stanje. Zaradi tega nenehnega pisanja jo vedno urejajte z ukazi jq in ne z urejevalnikom besedila.

CLAUDE.md (projektni kontekst)

Datoteka Markdown v korenu vsakega projekta. Sem vpišete projektna posebna navodila: konvencije kodiranja, arhitekturne odločitve, pomembne poti do datotek, ukaze za gradnjo in vse, kar mora Claude vedeti o tej kodni bazi. Claude to datoteko prebere na začetku vsake seje v tem imeniku. Naj bo osredotočena in jedrnata; vse tu troši tokene konteksta.

Kako sodelujejo

Ob zagonu seje Claude Code naloži ~/.claude/settings.json za globalne privzetke, ~/.claude.json za strežnike MCP in projektni CLAUDE.md za lokalni kontekst. Nastavitve se stopnjujejo: globalna dovoljenja veljajo povsod, projektni settings.json jih lahko nadomesti, CLAUDE.md pa doda projektna posebna navodila. Agenti in veščine iz ~/.claude/ so na voljo v vsakem projektu. Ta večplastni pristop pomeni, da nastavite enkrat globalno, po projektih pa prilagodite le tam, kjer je potrebno.