Kako deluje Claude Code

Agentni programerski pomočnik, ki živi v vašem terminalu, prebere celoten projekt in samostojno ukrepa.

10 sections·27 min read

01Kaj je Claude Code

Preprosto povedano

Claude Code si predstavljajte kot najem izkušenega razvijalca, ki sedi v vašem terminalu. V vsakdanjem jeziku opišete, kaj želite, on pa se loti dela: prebere pomembne datoteke, si zamisli načrt, napiše kodo, zažene teste in se vrne z dokončanim rezultatom. Kadar koli ga lahko prekinete in usmerite drugam, tako kot bi sodelavca potrepljali po rami.

Klasična programerska orodja z AI (na primer klepetalniki) so bolj podobna dopisovanju s svetovalcem. Kodo prilepite v okno za klepet, on predlaga spremembe, vi jih prilepite nazaj. Claude Code vse to preskoči. Že ima dostop do vaših datotek, terminala in zgodovine gita. Ukrepa neposredno.

Klasičen klepet z AI

Kako vidi vašo kodo

Odlomke prilepite v okno za klepet

Kako nastanejo spremembe

Predloge prekopirate nazaj v urejevalnik

Kontekst

Omejen na to, kar prilepite

Delovni potek

Kopiranje, lepljenje, kopiranje, lepljenje

Prekinitev

Začnete novo sporočilo

Claude Code (agentni)

Kako vidi vašo kodo

Celoten projekt prebere neposredno z diska

Kako nastanejo spremembe

Datoteke ureja sam, izvaja ukaze in preverja rezultate

Kontekst

Celoten projekt: datoteke, zgodovina gita, terminal, navodila v CLAUDE.md

Delovni potek

Opišete cilj, pregledate rezultat

Prekinitev

Sredi naloge vpišete popravek in Claude se takoj prilagodi

💻

Pisanje in preoblikovanje kodeFunkcije opišete v vsakdanjem jeziku. Claude prebere kodno zbirko, ustvari ali spremeni datoteke in z zagonom testov preveri rezultat.

🔍

Raziskovanje in razumevanjeVprašate »kako deluje modul za prijavo?« in Claude poišče, prebere in pojasni vašo kodno zbirko s sklici na konkretne datoteke.

⚡

Izvajanje ukazovClaude poganja orodja za gradnjo, git, upravljalnike paketov in testne zbirke. Vse, kar zmorete iz ukazne vrstice, zmore tudi Claude.

🌐

Iskanje po spletu in pridobivanjeIščite po spletu, pridobivajte dokumentacijo, poiščite sporočila o napakah in vključite zunanji kontekst, ne da bi zapustili terminal.

📦

Delovni poteki z gitomPripravite spremembe, iz razlik ustvarite sporočila objav, ustvarjajte veje in odpirajte zahteve za združitev prek GitHubovega CLI ali vključitve MCP.

🧩

Razširitve z vtičnikiPovežite se z zunanjimi storitvami prek MCP, ustvarjajte agente po meri, s hooki avtomatizirajte delovne poteke in določite veščine za večkratno uporabo.

0M tokenov

Okno konteksta pri modelu Opus (približno 2.500 strani besedila)

Vzporednih podagentov za zahtevne naloge

Vrst vizualnih blokov za bogato vsebino

Namestitev prek npm

V terminalu zaženite npm install -g @anthropic-ai/claude-code. Zahteva Node.js 18 ali novejši.

Prijava

V katerem koli imeniku zaženite claude. Odpre se okno brskalnika za prijavo v račun Anthropic. Potrebujete ključ API ali naročnino Claude.

Začnite z delom

Pojdite v kateri koli imenik projekta in zaženite claude. Samodejno prebere strukturo projekta in datoteko CLAUDE.md. Začnite opisovati, kaj želite narediti.

(Izbirno) Vključitev v IDE

Za povezano izkušnjo namestite razširitev za VS Code ali vtičnik za JetBrains. V ozadju vse še vedno poganja CLI.

Kaj Claude Code NI

Claude Code ni razvojno okolje (IDE) ali urejevalnik kode. Ne nadomešča orodij VS Code, JetBrains ali Cursor. Je orodje za terminal (in razširitev za IDE), ki deluje ob boku vašega obstoječega urejevalnika. Predstavljajte si ga kot samostojnega sodelavca, ki ga dodate svojemu delovnemu poteku, ne kot zamenjavo za vaša orodja. Urejevalnik vam kodo prikaže, Claude Code pa jo po vaših navodilih napiše in spreminja.

02Arhitektura

Preprosto povedano

Jedro orodja Claude Code je zanka, ki deluje kot detektiv pri preiskovanju primera. Prvi korak: prebere dokaze (vašo kodo, sporočila o napakah, izpis testov). Drugi korak: oblikuje teorijo (odloči, kaj je treba spremeniti). Tretji korak: ukrepa (uredi datoteko, zažene ukaz). Četrti korak: preveri, ali je primer rešen (zažene teste, preveri izpis). Če ni, se z novimi informacijami vrne na prvi korak. Ta zanka teče, dokler ni naloga opravljena ali dokler je ne prekinete.

Celoten sistem ima tri plasti. Na vrhu ste vi (uporabnik) v terminalu, VS Code ali JetBrains. V sredini je »agentno ogrodje« (sam Claude Code), ki upravlja orodja, kontekst, dovoljenja in zanko. Na dnu je model Claude (Opus, Sonnet ali Haiku), ki opravi dejansko sklepanje.

Prispe vaš prompt

Vpišete zahtevo, na primer »popravi neuspešne teste v modulu za prijavo«. Claude Code jo skupaj s sistemskimi navodili in vsebino datoteke CLAUDE.md posreduje modelu.

Zbiranje konteksta

Model se odloči, katere informacije potrebuje. Pomembne datoteke lahko poišče z orodjem Grep, določene datoteke prebere z orodjem Read ali z ukazom git log razišče nedavne spremembe.

Ukrepanje

Na podlagi ugotovljenega model ureja datoteke, ustvarja nove ali izvaja lupinske ukaze. Pred vsakim uničujočim posegom naredi posnetek datotek za možnost razveljavitve in vas lahko prosi za dovoljenje.

Preverjanje rezultatov

Model svoje delo preveri z zagonom testov, branjem izpisa ali primerjavo s pričakovanim vedenjem. Če je kaj narobe, se z novimi podatki o napaki vrne na drugi korak.

Vrnitev ali nadaljevanje

Ko model presodi, da je naloga končana, predstavi rezultat. Če je potrebno še kaj, se zanka nadaljuje. Kadar koli lahko posežete vmes in ga usmerite drugam.

🔄

Glavna zankaOsrednja zanka while, ki teče, dokler odgovori modela vsebujejo klice orodij. Na videz preprosta koda, ki ustvari prefinjeno vedenje.

📨

Čakalna vrsta sporočilAsinhrona vrsta z dvojnim medpomnilnikom, ki omogoča usmerjanje v realnem času. Medtem ko Claude dela, lahko vrinete popravke, omejitve ali preusmeritve.

📦

StiskalnikSproži se pri približno 92 % zasedenosti konteksta. Pogovor povzame, da sprosti prostor, ob tem pa ohrani ključna navodila iz datoteke CLAUDE.md.

⏪

Sistem kontrolnih točkPred urejanjem naredi posnetek vsake datoteke. Za previjanje nazaj dvakrat pritisnite Esc. Ločen od gita. Zajema le spremembe datotek (ne oddaljenih klicev API ali operacij nad bazo podatkov).

📄

Operacije z datotekamiBranje datotek, urejanje kode, ustvarjanje novih datotek, preimenovanje in preurejanje. Temelj vsega programerskega dela.

🔎

IskanjeIskanje datotek po vzorcu (Glob), iskanje vsebine z regularnimi izrazi (Grep), raziskovanje celotnih kodnih zbirk. Tako Claude razume vaš projekt.

⚡

IzvajanjeIzvajanje lupinskih ukazov, zagon strežnikov, izvajanje testov, uporaba gita. Vse, kar je na voljo iz vaše ukazne vrstice.

🌐

SpletIskanje po spletu, pridobivanje dokumentacije, iskanje sporočil o napakah. V zanko prinese zunanje znanje.

Zakaj je kontekst pomemben

Okno konteksta je Claudov »delovni spomin«. Vse je tam: zgodovina vašega pogovora, vsebina datotek, izpisi ukazov, navodila iz CLAUDE.md, naložene veščine in sistemska sporočila. Ko se napolni, Claude samodejno stisne kontekst (starejšo vsebino povzame, da sprosti prostor). A stiskanje je izgubno; navodila z začetka pogovora se lahko izgubijo. Zato trajna pravila sodijo v CLAUDE.md, ne v sporočila klepeta. Z ukazom /context preverite, kaj zaseda prostor.

Zasedenost konteksta: natančnost začne upadati

Zasedenost konteksta: pogostost halucinacij se občutno poveča

Zasedenost konteksta: sproži se samodejno stiskanje

Kaj to pomeni za vas

Za učinkovito uporabo orodja Claude Code vam notranje arhitekture ni treba razumeti. Bistvo je tole: Claude v zanki prebere vašo kodo, o njej sklepa, ukrepa in preveri rezultat. Vaša naloga je, da daste jasna navodila in po potrebi usmerjate. Vse drugo se zgodi samodejno.

03CLAUDE.md (spomin projekta)

Preprosto povedano

Predstavljajte si, da vsako jutro najamete novega pogodbenika, ki ima izgubo spomina. Vsak dan pride brez spomina na vaš projekt, vaš slog kode, način zaganjanja testov ali to, o čemer ste se pogovarjali včeraj. CLAUDE.md je uvodni dokument, ki mu ga izročite, ko vstopi skozi vrata. Pove mu vse, kar mora vedeti: kaj je projekt, kako je koda organizirana, katere ukaze naj izvaja in na kaj naj pazi.

Brez nje Claude vsako sejo začne brez pojma, vi pa izgubljate čas s ponavljanjem istih stvari. Z dobro vzdrževano datoteko CLAUDE.md Claude nadaljuje točno tam, kjer je treba.

	Lokacija	Obseg	Deljeno z
Upravljano pravilo	/Library/Application Support/ClaudeCode/CLAUDE.md (macOS)	Za celotno organizacijo, uvede ga IT	Vsi uporabniki v organizaciji
Uporabniški spomin	~/.claude/CLAUDE.md	Vaše osebne privzete nastavitve za vse projekte	Samo vi (vsi projekti)
Uporabniška pravila	~/.claude/rules/*.md	Modularna osebna pravila po temah	Samo vi (vsi projekti)
Spomin projekta	./CLAUDE.md ali ./.claude/CLAUDE.md	Navodila projekta, deljena z ekipo	Ekipa prek nadzora različic
Pravila projekta	./.claude/rules/*.md	Modularna pravila projekta po posameznih temah	Ekipa prek nadzora različic
Lokalni spomin	./CLAUDE.local.md	Osebne nastavitve projekta (samodejno v .gitignore)	Samo vi (ta projekt)
Samodejni spomin	~/.claude/projects//memory/	Claudovi samodejni zapiski in spoznanja	Samo vi (za posamezni projekt)
Podimenik	src/api/CLAUDE.md	Naloži se po potrebi, ko Claude bere datoteke v tem imeniku	Ekipa prek nadzora različic

Kontekst projekta (1 do 2 stavka)

»To je spletna trgovina v Next.js 15 s prijavo prek Supabase in plačili prek Stripe.« Clauda takoj usmeri.

Ukazi

Kako graditi, testirati, preverjati kodo in objavljati. Navedite točne ukaze: npm run test, npm run build. Claude jih bo uporabil, namesto da bi ugibal.

Slog kode in dogovori

»Uporabljaj enojne narekovaje. Daj prednost funkcijskim komponentam. Datoteke poimenuj v slogu kebab-case.« Claude to upošteva pri vsakem urejanju.

Pregled arhitekture

Ključni imeniki in kaj je kje. »Poti API so v app/api/, modeli baze podatkov v lib/models/.«

Pomembna opozorila in pasti

»NIKOLI ne uvažaj iz zastarelega imenika utils/; namesto tega uporabi lib/.« Predpono IMPORTANT: uporabljajte le izjemoma, za ključna pravila.

Česa NE početi

»Ne ustvarjaj novih datotek CSS; uporabljaj razrede Tailwind.« »Ne objavljaj datotek .env.« Izrecni protivzorci prihranijo čas.

🔗

Sistem @importsZ zapisom @path/to/file se sklicujte na zunanje datoteke in tako ohranite datoteko CLAUDE.md jedrnato. Uvožene datoteke lahko rekurzivno uvažajo druge, do 5 ravni globoko.

📂

Modularna pravila (.claude/rules/)Navodila razdelite na osredotočene datoteke: testing.md, api-design.md, security.md. Vse datoteke .md v mapi rules/ se naložijo samodejno. Podpira omejevanje na določene poti prek glave YAML.

🧠

Samodejni spominClaude samodejno shranjuje vzorce projekta, spoznanja pri razhroščevanju in zapiske o arhitekturi. Prvih 200 vrstic datoteke MEMORY.md se naloži ob vsaki seji.

🔒

CLAUDE.local.md (zasebno)Osebne nastavitve projekta, samodejno vključene v .gitignore. Naslovi vašega peskovnika, priljubljeni testni podatki, osebni zapiski o delovnem poteku. Nikoli deljeno z ekipo.

Omejena pravila za monorepozitorije in velike projekte

Pravila v .claude/rules/ lahko z glavo YAML in poljem paths ciljajo na določene datoteke. Pravilo, omejeno na paths: ["src/api/**/*.ts"], na primer velja le, kadar Claude dela z datotekami TypeScript za API. Podpira standardne vzorce glob: **/*.ts za vse datoteke TypeScript, src/components/*.tsx za komponente React.

Dobre prakse za CLAUDE.md

Naj bo krajša od 300 vrstic. Tokeni konteksta so dragoceni, napihnjena datoteka CLAUDE.md pa jih troši v vsakem koraku. Bodite natančni: »Uporabljaj zamik z 2 presledkoma« je boljše od »Ustrezno oblikuj kodo«. Popravke dodajajte sproti, ko se pojavijo težave. Vsakih nekaj tednov jo preglejte glede zastarelosti. Predpono IMPORTANT: uporabljajte le izjemoma, za resnično ključna pravila. Pri zapletenih projektih pravila razdelite v .claude/rules/, namesto da ustvarite eno orjaško datoteko. Za začetno datoteko CLAUDE.md zaženite /init.

Predolga: nad 300 vrstic v vsakem koraku troši kontekst. Podrobnosti prestavite v datoteke, uvožene z @, ali v .claude/rules/.

Presplošna: »Piši čisto kodo« Clauda ničesar ne nauči. Bodite natančni glede SVOJEGA projekta.

Manjkajoči ukazi: če Claude ne ve, kako zagnati vaše teste, bo ugibal (pogosto napačno).

Nikoli posodobljena: zastarela pravila povzročijo, da se Claude upira. Izbrišite pravila za vzorce, ki jih ne uporabljate več.

Brez pasti: najdragocenejši vnosi so neočitne stvari: »crypto.randomUUID() se na mobilnih napravah prek HTTP sesuje.«

04Način načrtovanja

Preprosto povedano

Način načrtovanja je kot prošnja arhitektu, naj nariše načrte, preden najamete gradbeno ekipo. Brez njega Claude nemudoma začne pisati kodo, kar pri manjših nalogah deluje dobro, pri zapletenih pa gre pogosto narobe. Z načinom načrtovanja Claude razišče vašo kodno zbirko, razčleni problem in predstavi načrt. Vi ga pregledate, predlagate spremembe in šele nato Claude začne graditi.

Vklop načina načrtovanja

Dvakrat pritisnite Shift+Tab (ali se sprehodite skozi načine dovoljenj), da vstopite v način načrtovanja. Claude preklopi na orodja samo za branje: datoteke lahko išče in bere, ničesar pa ne more urejati.

Opišite nalogo

»Dodaj podporo za OAuth v modul za prijavo.« Claude z orodji Glob, Grep in Read razišče pomembne datoteke in razume obstoječo arhitekturo.

Pregled načrta

Claude predstavi strukturiran načrt: katere datoteke spremeniti, kateri pristop ubrati in kje so morebitne pasti. Lahko se pogovarjate, ga izpopolnite ali preusmerite.

Potrdite in izvedite

Pritisnite Shift+Tab, da zapustite način načrtovanja in se vrnete v običajni način. Claude izvede načrt in se pri tem opira na to, kar je izvedel med raziskovanjem.

Uporabite način načrtovanja

Vrsta naloge

Preoblikovanja več datotek, nove funkcije, arhitekturne spremembe

Negotovost

Niste prepričani, katere datoteke so vpletene ali kateri pristop ubrati

Tveganje

Spremembe bi lahko pokvarile več delov sistema

Zapletenost

Zahteva razumevanje, kako sodeluje več modulov

Preskočite način načrtovanja

Vrsta naloge

Popravki ene datoteke, hitra urejanja, vprašanja o kodi

Negotovost

Natanko veste, kaj je treba spremeniti

Tveganje

Spremembe so osamljene in jih je preprosto preveriti

Zapletenost

Enostavno in samostojno

Delovni potek raziskovanja, načrtovanja in pisanja kode

Anthropicove notranje ekipe uporabljajo tristopenjski pristop, ki dosledno prinaša boljše rezultate:

1. Raziskovanje: naročite Claudu, naj prebere pomembne datoteke in razume trenutno stanje. Uporabite način načrtovanja ali ga prosite, naj razišče, preden ukrepa.
2. Načrtovanje: pretehtajte pristop, načrt zapišite v datoteko (na primer SCRATCHPAD.md) in ga izpopolnite v pogovoru.
3. Pisanje kode: zapustite način načrtovanja in pustite, da Claude izvede načrt. Ker kodno zbirko in načrt že razume, je izvedba hitrejša in natančnejša.

V Anthropicovi dokumentaciji piše: »Dvojni pritisk Shift+Tab pred zahtevo po funkcijah dosledno prinaša boljše rezultate kot neposredne zahteve.«

Kaj to pomeni za vas

Za hitre popravke in preprosta urejanja Clauda preprosto vprašajte neposredno. Za vse, kar posega v več datotek ali zahteva arhitekturno razmišljanje, najprej porabite 30 sekund v načinu načrtovanja. Čas, ki ga vložite v načrtovanje, se vam večkratno povrne s preprečenim ponovnim delom.

05Hooki

Preprosto povedano

Hooki so kot samodejni sprožilci na tovarniškem tekočem traku. Ko izdelek (koda) zapusti urejevalno postajo, ga stroj za oblikovanje (Prettier) samodejno počisti. Ko nekdo poskuša pritisniti nevaren gumb (izbrisati zaščiteno datoteko), alarm dejanje blokira. Ko je serija končana (Claude opravi nalogo), obvestilo prispe na vaš telefon. Te sprožilce nastavite enkrat, nato pa vsakič zanesljivo delujejo, ne da bi se morali zanašati, da se bo AI »spomnil« ukrepati.

	Kako deluje
Command	Izvede lupinski ukaz. Prek stdin prejme JSON, sporoča prek stdout/stderr in izhodnih kod. Najpogostejša vrsta.
Prompt	Vhod hooka pošlje modelu Claude (privzeto Haiku) za presojo da/ne. Vrne {"ok": true} ali {"ok": false, "reason": "..."}.
Agent	Ustvari podagenta, ki lahko bere datoteke, izvaja ukaze in preverja pogoje. Uporablja se, kadar preverjanje zahteva pregled dejanskega stanja kodne zbirke.

	Kdaj se sproži	Pogosta uporaba
PreToolUse	Preden se izvede klic orodja (lahko ga blokira)	Blokiranje urejanja zaščitenih datotek, preverjanje ukazov
PostToolUse	Ko klic orodja uspe	Samodejno oblikovanje kode, beleženje ukazov, zagon preverjevalnikov kode
Notification	Ko Claude pošlje obvestilo	Namizna opozorila, ko Claude potrebuje vnos
SessionStart	Ko se seja začne, nadaljuje ali stisne	Ponovno vstavljanje konteksta po stiskanju
Stop	Ko Claude konča z odgovorom	Preverjanje, ali so vse naloge končane, pred zaustavitvijo
UserPromptSubmit	Ko oddate prompt, preden ga Claude obdela	Preverjanje ali obogatitev uporabnikovega vnosa
PreCompact	Pred stiskanjem konteksta	Shranjevanje pomembnega stanja pred povzemanjem
SubagentStart / Stop	Ko se podagenti zaženejo ali končajo	Priprava in pospravljanje okolij za podagente

🎨

Samodejno oblikovanje po urejanjuHook PostToolUse za Edit ali Write, ki na spremenjeni datoteki zažene Prettier. Vsaka datoteka, ki se je Claude dotakne, je samodejno oblikovana. Nič več opominjanja AI, naj oblikuje kodo.

🛡️

Blokiranje zaščitenih datotekHook PreToolUse za Edit ali Write, ki poti datotek primerja z zaščitenimi vzorci (.env, package-lock.json, .git/). Izhodna koda 2 dejanje blokira.

🔔

Namizna obvestilaHook Notification, ki z ukazom osascript prikaže obvestilo v sistemu macOS, ko Claude potrebuje vašo pozornost. Preklopite na druge naloge, ne da bi zamudili pozive.

♻️

Obnovitev konteksta po stiskanjuHook SessionStart z ujemalnikom »compact«, ki po stiskanju ključne opomnike znova vnese v kontekst, ko se izgubijo. »Opomnik: uporabljaj Bun, ne npm.«

Kam shraniti nastavitve hookov

Hooki so določeni v datotekah JSON z nastavitvami. ~/.claude/settings.json za globalne hooke (vsi projekti). .claude/settings.json za hooke projekta (mogoče jih je objaviti v git). .claude/settings.local.json za osebne hooke projekta (v .gitignore). Za interaktivni meni za ustvarjanje, pregledovanje in upravljanje hookov uporabite /hooks v orodju Claude Code.

Izhod 0: dejanje se nadaljuje. Pri SessionStart in UserPromptSubmit se stdout doda v Claudov kontekst.

Izhod 2: dejanje je blokirano. Sporočilo stderr se vrne Claudu kot povratna informacija, da se lahko prilagodi.

Vsaka druga izhodna koda: dejanje se nadaljuje, a stderr se zabeleži. Za ogled z Ctrl+O vklopite podrobni način.

06MCP (Model Context Protocol)

Preprosto povedano

MCP je kot vrata USB na računalniku. Vaš računalnik (Claude) je zmogljiv že sam po sebi, a prek USB lahko priključite tiskalnik, kamero, zunanji disk, igralni krmilnik. Vsaka naprava doda novo zmožnost. MCP deluje enako: »priključite« strežnik MCP in nenadoma se Claude lahko pogovarja z GitHubom, poizveduje po vaši bazi podatkov, pošilja sporočila v Slack ali ustvarja vstopnice v Jiri. Protokol je standardiziran, zato vsak strežnik, združljiv z MCP, deluje z vsakim orodjem AI, ki podpira MCP.

Oddaljeno (HTTP/SSE)

Kje se izvaja

Na internetu (gostovano v oblaku)

Ukaz za nastavitev

claude mcp add --transport http <name> <url>

Overjanje

OAuth 2.0 ali ključ API v glavah

Najprimernejše za

Oblačne storitve (GitHub, Notion, Sentry, Slack)

Lokalno (STDIO)

Kje se izvaja

Na vaši napravi (lokalni proces)

Ukaz za nastavitev

claude mcp add --transport stdio <name> -- <command>

Overjanje

Okoljske spremenljivke

Najprimernejše za

Lokalna orodja, baze podatkov, skripte po meri

🐙

GitHubZahteve za združitev, prijave težav, iskanje po kodi, upravljanje repozitorijev. Najbolj priljubljen strežnik MCP. URL: api.githubcopilot.com/mcp/ (OAuth).

🗄️

PostgreSQLPo bazah podatkov poizvedujte naravno: »Kolikšen je naš skupni prihodek ta mesec?« Prek @bytebase/dbhub s povezovalnim nizom.

🐛

Sentry»Katere so najpogostejše napake v zadnjih 24 urah?« Napake v produkciji razhroščujte neposredno iz programerske seje.

💬

SlackBerite kanale, pošiljajte sporočila, iščite po pogovorih. V Claudov kontekst prinesite ekipno komunikacijo.

📋

NotionDostopajte do strani, baz podatkov in wikijev. URL: mcp.notion.com/mcp (OAuth). Povežite bazo znanja svoje ekipe.

🎨

FigmaBerite oblikovalske zasnove in jih neposredno izvedite. Oblikovalske specifikacije pretvorite v kodo brez ročnega prevajanja.

	Mesto shranjevanja	Vidnost
Lokalno (privzeto)	~/.claude.json pod potjo projekta	Samo vi, le trenutni projekt
Uporabnik	~/.claude.json, globalni mcpServers	Samo vi, vsi projekti
Projekt	.mcp.json v korenu projekta	Ekipa (mogoče objaviti v git)
Upravljano	managed-mcp.json v sistemskem imeniku	Vsi uporabniki v organizaciji (uvede skrbnik)

Dodajte oddaljeni strežnik

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Prijavite se (če je treba)

V orodju Claude Code zaženite /mcp, izberite strežnik in sledite postopku OAuth v brskalniku.

Preverite

claude mcp list prikaže vse nastavljene strežnike. /mcp v orodju Claude Code prikaže stanje in strošek konteksta.

Uporabljajte naravno

Preprosto vprašajte Claude: »Ustvari prijavo težave na GitHubu za to napako« ali »Pokaži mi odprte zahteve za združitev, dodeljene meni.« Claude samodejno izbere pravo orodje MCP.

Razširjanje z veliko strežniki MCP

Ko imate veliko strežnikov MCP, lahko njihove definicije orodij porabijo precej konteksta. Claude Code ima samodejno funkcijo »Tool Search«, ki se vklopi, ko opisi orodij MCP presežejo 10 % okna konteksta. Namesto da bi vnaprej naložil vsa orodja, Claude po potrebi poišče ustrezna.

Strošek konteksta pri MCP

Vsak strežnik MCP vsakemu zahtevku doda definicije orodij in tako porablja kontekst, še preden začnete delati. Nekaj težkih strežnikov lahko poje od 10 do 20 % vašega okna konteksta. Redno zaganjajte /mcp in preverjajte stroške posameznih strežnikov. Odstranite strežnike, ki jih dejavno ne uporabljate.

07Agenti po meri (podagenti)

Preprosto povedano

Podagenti so kot specializirani oddelki v podjetju. Direktor (vaša glavna seja s Claudom) ne opravlja vsega sam. Ko je treba pregledati kodo, jo pošlje oddelku za nadzor kakovosti (podagentu code-reviewer). Ko je potrebno raziskovanje, ga pošlje raziskovalni ekipi (podagentu Explore). Vsak oddelek dela v svoji pisarni (osamljenem oknu konteksta), uporablja le orodja, ki jih potrebuje (omejena dovoljenja), in direktorju pošlje povzetek. Direktorjeva miza se ne zasuje z vso interno papirologijo oddelka.

	Model	Orodja	Namen
Explore	Haiku (hiter)	Samo za branje (brez Write/Edit)	Odkrivanje datotek, iskanje po kodi, raziskovanje kodne zbirke
Plan	Podeduje od glavne seje	Samo za branje (brez Write/Edit)	Raziskovanje med načinom načrtovanja; zbere kontekst, preden predstavi načrt
General-purpose	Podeduje od glavne seje	Vsa orodja	Zapletene večstopenjske naloge, ki zahtevajo raziskovanje in ukrepanje
Bash	Podeduje od glavne seje	Samo Bash	Izvajanje terminalskih ukazov v ločenem kontekstu

Ustvarite datoteko

Shranite datoteko Markdown v ~/.claude/agents/agent-name.md (uporabniška raven, vsi projekti) ali .claude/agents/agent-name.md (raven projekta). Glava YAML se mora začeti v prvi vrstici. Prazna vrstica pred njo povzroči tiho napako.

Določite glavo

Obvezni polji: name (v slogu kebab-case) in description (kdaj naj Claude uporabi tega agenta). Izbirno: tools, model, permissionMode, color, hooks, memory, skills, maxTurns.

Napišite sistemski prompt

Telo Markdown za glavo postane sistemski prompt agenta. Natančno opišite, kaj naj agent počne in kako naj oblikuje izpis.

Preizkusite ga

»Z agentom code-reviewer preglej moje nedavne spremembe.« Ali pa z /agents interaktivno upravljajte vse agente.

# ~/.claude/agents/code-reviewer.md
---
name: code-reviewer
description: Strokovnjak za pregled kode. Uporabi po spremembah kode.
tools: Read, Glob, Grep, Bash
model: sonnet
color: green
---

Ste izkušen pregledovalec kode. Ko ste priklicani:
1. Zaženite git diff za ogled nedavnih sprememb
2. Osredotočite se na spremenjene datoteke
3. Preglejte kakovost, varnost in vzdržljivost

Povratne informacije podajte po prednosti:
- Kritične težave (nujno popraviti)
- Opozorila (priporočljivo popraviti)
- Predlogi (razmislite o izboljšavi)

⚡

Vzporedno raziskovanje»Vzporedno razišči module za prijavo, bazo podatkov in API.« Vsak raziskuje samostojno, Claude pa združi ugotovitve. Do 7 hkratnih podagentov.

📦

Naloge v ozadjuPodagenti lahko tečejo v ozadju, medtem ko nadaljujete z delom. Za premik izvajajoče se naloge v ozadje pritisnite Ctrl+B. Claude vnaprej vpraša za potrebna dovoljenja.

🌿

Osamitev z delovnim drevesomNastavite isolation: "worktree", da podagent teče v začasnem delovnem drevesu gita in dobi osamljeno kopijo repozitorija. Počisti se samodejno.

🧠

Trajni spominNastavite memory: user, da podagentu dodelite trajni imenik, ki gradi znanje skozi pogovore. »Preveri svoj spomin za vzorce, ki si jih že videl.«

Uporabite podagente

Kontekst

Naloga ustvari obsežen izpis, ki naj ne zasuje vaše glavne seje

Osamitev

Želite uveljaviti določene omejitve orodij ali dovoljenja

Hitrost

Naloga je samostojna in lahko vrne povzetek

Uporabite glavni pogovor

Kontekst

Naloga zahteva pogosto izmenjavo ali postopno izpopolnjevanje

Osamitev

Več faz si deli precej konteksta (načrtovanje, izvedba, testiranje)

Hitrost

Delate hitro, ciljno spremembo

Omejitve podagentov

Podagenti ne morejo ustvarjati drugih podagentov (brez gnezdenja). Če vaš delovni potek potrebuje gnezdeno prenašanje nalog, podagente verižite iz glavnega pogovora ali uporabite veščine. Poleg tega: ko se več podagentov konča, se vsi njihovi rezultati vrnejo v vaš glavni kontekst, zato ga lahko številni obsežni podagenti hitro napolnijo.

08Veščine in ukazi s poševnico

Preprosto povedano

Veščine so kot kartice z recepti v kuharjevi kuhinji. Vsaka kartica ima navodila za določeno jed. Kuhar (Claude) lahko pregleda naslove in opise kartic ter se odloči, kateri recept ustreza naročilu. Ko gost naroči testenine, kuhar vzame kartico za testenine. Lahko pa tudi vstopite v kuhinjo in neposredno rečete »uporabi recept za testenine«. Nekatere recepte sprožite le vi (pomočnik kuharja), za druge pa se lahko glavni kuhar odloči sam.

Ukazi s poševnico so bili združeni z veščinami. Če imate datoteke v .claude/commands/, te še vedno delujejo. Veščine dodajajo izbirne zmožnosti: podporne datoteke, nadzor priklica in samodejno nalaganje.

Ustvarite imenik

mkdir -p ~/.claude/skills/my-skill za osebne (vsi projekti) ali .claude/skills/my-skill za raven projekta.

Napišite SKILL.md

Glava YAML z name in description, ki ji sledijo navodila v Markdownu. Ime postane /ukaz-s-poševnico.

(Izbirno) Dodajte podporne datoteke

Predloge, skripte, primere, referenčno dokumentacijo. Datoteko SKILL.md ohranite pod 500 vrstic; podrobnosti prestavite v podporne datoteke.

Preizkusite jo

Vpišite /my-skill za neposreden priklic ali pa Claude vprašajte nekaj, kar se ujema z opisom, in opazujte samodejno nalaganje.

Veščine

Kontekst

Teče v kontekstu vašega glavnega pogovora (deljena zgodovina)

Najprimernejše za

Navodila za večkratno uporabo, referenčno znanje, vodene delovne poteke

Priklic

/ime-veščine ali samodejno zazna Claude

Gnezdenje

Mogoče jih je vstaviti v podagente prek polja skills

Podagenti

Kontekst

Teče v osamljenem kontekstu (ločeno od glavnega)

Najprimernejše za

Obsežne naloge, uveljavljene omejitve orodij, vzporedno delo

Priklic

Claude prenese nalogo ali pa jo izrecno zahtevate vi

Gnezdenje

Ne morejo ustvarjati drugih podagentov

	Prikličete lahko vi	Prikliče lahko Claude	Primer uporabe
Default	Da	Da	Večina veščin. Sproži jo lahko človek ali Claude.
disable-model-invocation: true	Da	Ne	Veščine s stranskimi učinki: /deploy, /commit. Čas nadzorujete vi.
user-invocable: false	Ne	Da	Znanje v ozadju, ki naj ga Claude pozna, ko je pomembno, ni pa smiselno uporabniško dejanje.

🔀

Zamenjave nizov$ARGUMENTS se zamenja s tem, kar sledi imenu veščine. $ARGUMENTS[0], $1 za dostop po položaju. /fix-issue 123 v promptu postane številka težave.

⚡

Dinamično vstavljanje kontekstaZapis !`command` zažene lupinske ukaze, preden vsebino pošlje Claudu. !`gh pr diff` v prompt veščine vstavi dejansko razliko zahteve za združitev.

🌿

Razvejitev v podagentaDodajte context: fork, da veščina teče v osamljenem kontekstu podagenta. Za raziskovalne veščine samo za branje jo združite z agent: Explore.

🛡️

Omejitve orodijallowed-tools: Read, Grep, Glob Claude med delovanjem veščine omeji na operacije samo za branje. Varnost za občutljive delovne poteke.

Kaj to pomeni za vas

Veščine ponavljajoče se prompte spremenijo v delovne poteke z enim ukazom. Namesto da vsakič vpišete »zaženi teste, preveri napake pri preverjanju kode in ustvari sporočilo objave«, ustvarite veščino /pre-commit, ki naredi vse. Veščine z ekipo delite prek .claude/skills/ v svojem repozitoriju.

09Upravljanje konteksta

Preprosto povedano

Claudovo okno konteksta je kot tabla v sejni sobi. Med delom se tabla napolni z zapiski, diagrami in seznami opravil. Na neki točki zmanjka prostora. Stiskanje je kot fotografiranje table in njeno brisanje, pri čemer ostane le povzetek. Čiščenje je brisanje celotne table in nov začetek. Ključno spoznanje: pomembne informacije ne smejo živeti le na tabli. Zapišite jih na trajne napise na steni (CLAUDE.md), da preživijo vsako čiščenje.

	Kaj počne	Kdaj uporabiti
/clear	Zbriše celoten pogovor. Nov začetek brez zgodovine.	Prehod na povsem drugo nalogo. Kontekst je nepopravljivo poslabšan.
/compact [focus]	Povzame pogovor, da sprosti prostor. Izbirna fraza za osredotočenje ohrani določene teme.	Merilnik konteksta je pri 70 % ali več. Isto delo želite nadaljevati, a potrebujete prostor.
/context	Prikaže, kaj zaseda prostor: pogovor, datoteke, orodja MCP, sistemska sporočila.	Ugotavljanje, zakaj se kontekst polni. Preverjanje stroškov strežnikov MCP.
/memory	V urejevalniku odpre datoteke spomina za pregled in urejanje.	Preverjanje ali posodabljanje datotek CLAUDE.md, samodejnega spomina ali pravil.

📝

SCRATCHPAD.mdNaročite Claudu, naj načrte, ugotovitve ali napredek zapiše v datoteko SCRATCHPAD.md. Ta preživi /clear in stiskanje. Pozneje nadaljujte tako, da Claudu naročite: »preberi SCRATCHPAD.md in nadaljuj«.

🧠

Samodejni spominClaude samodejno piše zapiske v ~/.claude/projects/<project>/memory/. MEMORY.md (prvih 200 vrstic) se naloži ob vsaki seji. Datoteke po temah se naložijo po potrebi.

📌

CLAUDE.md za trajna pravilaNavodila, ki so pomembna med sejami, sodijo v CLAUDE.md, ne v pogovor. Navodila iz pogovora se med stiskanjem izgubijo, CLAUDE.md pa preživi.

🔄

Upravljanje sejclaude --continue nadaljuje najnovejšo sejo. claude --resume <id> nadaljuje določeno. --fork-session se razveji, ne da bi vplivalo na izvirnik.

Zdravje konteksta glede na raven zasedenosti

IDEALNO

0 do 50 %

Polna zmogljivost

50 do 70 %

Še vedno dobro

70 do 85 %

Uporabite /compact

POSLABŠANO

85 % in več

Uporabite /clear

En pogovor na funkcijo. Nepovezanih nalog ne mešajte v isti seji.

Shranite pred čiščenjem. Pred /clear Claudu naročite: »shrani svoje ugotovitve v SCRATCHPAD.md«.

Odstranite neuporabljene strežnike MCP. Vsakemu zahtevku dodajo definicije orodij in tiho jedo kontekst.

Za obsežne naloge uporabite podagente. Dobijo svoj svež kontekst in ne napihnejo vašega glavnega pogovora.

Redno zaganjajte /context. Poglejte natanko, kaj troši prostor in kje lahko prihranite.

Kaj to pomeni za vas

Upravljanje konteksta je razlika med tem, ali je Claude videti bister ali zmeden. Naj bodo seje osredotočene na eno nalogo, pomembno stanje prenesite v datoteke in ko postane počasno, uporabite /compact ali /clear. Te navade se sčasoma obrestujejo.

10Dobre prakse in delovni potek

Preprosto povedano

Claude Code je zmogljiv že takoj po namestitvi, a nekaj navad in nastavitev loči priložnostne uporabnike od naprednih. To poglavje pokriva najpomembnejše vzorce: kako se vključiti v vaš IDE, kako varno ravnati z gitom, kako Claude zaganjati v cevovodih CI/CD, kako vzporedno delati z več primerki orodja Claude in kako učinkovito pisati prompte.

Razširitev za VS Code

Namestitev

V tržnici VS Code poiščite »Claude Code« in kliknite Install

Vmesnik

Vgrajen grafični pult z več zavihki pogovorov

Ključne zmožnosti

Pregled in urejanje načrtov pred sprejemom, samodejno sprejemanje urejanj, sklicevanje na datoteke z @

V ozadju

Isti pogon Claude Code, ista orodja

Vtičnik za JetBrains

Namestitev

Namestite iz tržnice JetBrains: »Claude Code [Beta]«

Vmesnik

Vtičnik, ki ovije CLI in ga poveže s pregledovalnikom razlik v IDE

Ključne zmožnosti

Izkušnja klepeta, sklici na datoteke, zgodovina pogovorov, pregledovalnik razlik

V ozadju

Isti pogon Claude Code, ista orodja

	Kako vklopiti	Vedenje
Default	Zažene se samodejno	Claude vpraša pred urejanjem datotek in lupinskimi ukazi
Auto-accept edits	Enkrat pritisnite Shift+Tab	Claude datoteke ureja prosto, za lupinske ukaze pa še vedno vpraša
Plan mode	Dvakrat pritisnite Shift+Tab	Samo za branje. Claude ustvari načrt, ki ga pred izvedbo potrdite

Osnovna uporaba brez vmesnika

claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash" zažene Claude neinteraktivno z določenimi dovoljenji za orodja.

Strukturiran izpis

claude -p "Summarize this project" --output-format json vrne JSON z ID-jem seje in metapodatki. Za tipiziran izpis dodajte --json-schema.

Pretakanje

--output-format stream-json --verbose pretaka tokene kot dogodke JSON, ločene z novo vrstico, za obdelavo v realnem času.

Vključitev v CI/CD

Naravno deluje v GitHub Actions, GitLab CI in Jenkins. Izhodna koda 0 ob uspehu, neničelna ob napaki. Za varno samodejno odobritev jo združite z --allowedTools.

🧪

Samodejno ustvarjanje testovV CI zaženite "claude -p Write tests for auth.py". Testi, ki jih ustvari AI, v povprečju pokrijejo 72 % nepreizkušenih vej kode.

🔍

Samodejni pregled kodeRazlike zahtev za združitev preusmerite v Claude z --append-system-prompt "Review for security vulnerabilities." Zazna težave, ki jih preverjevalniki kode ne najdejo.

🏷️

Označevanje zahtev za združitevSamodejno razvrščajte in označujte zahteve za združitev glede na vsebino razlik. Enovrstična skripta v vašem cevovodu CI.

Dobre prakse za git s Claude Code

Claude takoj povežite z gitom. Dostop do zgodovine objav občutno zmanjša halucinacije. Uporabite razvoj, voden s testi: »Napiši teste, jih objavi in pusti, da Claude izvaja, dokler ne uspejo« (Anthropicovo interno priporočilo). Za vzporedno delo uporabite delovna drevesa gita: git worktree add ../feature-branch feature-branch ustvari ločen imenik, kjer lahko zaženete drugi primerek orodja Claude. Vsako delovno drevo dobi svojo sejo in samodejni spomin.

🌿

Delovna drevesa gitaV ločenih delovnih drevesih zaganjajte vzporedne primerke orodja Claude. Eden piše kodo, drugi pregleduje. Ločeni imeniki, ločene seje, brez sporov.

🖥️

Splet in CLIBoris (ustvarjalec orodja Claude Code) vzporedno poganja od 5 do 10 primerkov Claude na claude.ai/code skupaj z lokalnimi primerki CLI in med njimi prehaja za različne naloge.

⚡

Agenti v ozadjuPodagenti z background: true tečejo sočasno, medtem ko delate naprej. Za premik katere koli izvajajoče se naloge v ozadje pritisnite Ctrl+B.

🔐

Deljena dovoljenjaVarne ukaze vnaprej odobrite prek /permissions in shranite v deljeno datoteko .claude/settings.json. Zmanjša trenje, ne da bi obšli varnost.

Bodite natančni že na začetku: »Popravi postopek zaključka nakupa za uporabnike s pretečenimi karticami. Preveri src/payments/, zlasti osveževanje tokena.«

Claudu dajte nekaj, ob čemer preveri delo: vključite testne primere, pričakovani izpis ali posnetke zaslona. Claude deluje bolje, ko lahko preveri svoje delo.

Povejte Claudu, česa naj NE počne: »Ne pretiravaj s tem. Ne ustvarjaj novih datotek, razen če je nujno.«

Uporabljajte slike: Claude ima odličen vid. Prilepite posnetke zaslona za razhroščevanje, primerjavo vmesnikov ali izvedbo oblikovanja.

Prenašajte naloge, ne ukazujte: podajte kontekst in usmeritev, glede podrobnosti pa zaupajte Claudu. »Postopek zaključka nakupa je pokvarjen za pretečene kartice. Razišči in popravi.«

Skupnostni viri in tržnice veščin

Agent Skills Marketplace (skillsmp.com): skoraj 60.000 veščin za Claude za pregledovanje in namestitev. Awesome Claude Skills (github.com): skupnostno urejena zbirka z več kot 5.500 zvezdicami, razvrščena po kategorijah. Awesome Claude Code (github.com): zbirka virov za ukaze s poševnico in nastavitve. MCP Tools (modelcontextprotocol.io): celotna dokumentacija za Model Context Protocol s stotinami razpoložljivih strežnikov.