Claude Code paralleelsed agendid

🏗️

Algupärane allikas: github.com/stephengpope/no-code-architects-toolkit — Stephen Pope'i no-code architects toolkit, mille põhjal see juhend koostati

Mis on Claude Code?

Põhimõte

Claude Code on AI-assistendi käsurea tööriist, mis töötab otse sinu terminalis ja suudab lugeda, muuta ning käivitada koodi — ilma et sa peaksid kogu aeg kõike ise tegema.

Peamine eelis standardse AI-chati ees: Claude Code saab käivitada mitu agenti korraga, kes töötavad erinevate ülesannetega samaaegselt. Samal ajal kui üks agent kirjutab testi, teine refaktorib komponendi ja kolmas vaatab üle dokumentatsiooni.

See on nagu tiimi juhtimine — sa annad suuna, agendid teevad töö.

Arhitektuur

Kuidas see töötab

Komponent	Kirjeldus	Staatus
Claude Code CLI	Peamine tööriist terminalis — loed, muudad, käivitad	Paigaldatud
Agent tööriist	Käivitab alam-agendid paralleelselt erinevate ülesannete jaoks	Aktiivne
Task tööriist	Loob ja jälgib ülesandeid staatuste kaupa	Aktiivne
GitHub	Koodihoidla, versioonihaldus	Ühendatud
Vercel	Automaatne deploy iga push'i peale	Seadistamata
claude-code-mobile	Next.js 16 + React 19 demo rakendus	Pooleli

Miks see kasulik on?

Väärtus võrreldes tavalise AI-chatiga

Tavaline AI chat	Claude Code
Üks vestlus, üks ülesanne korraga	Mitu agenti samaaegselt eri ülesannetega
Koodi kopeerid käsitsi	Loeb ja muudab faile otse
Käske käivitad ise	Käivitab terminalis käske automaatselt
Ei tea projekti kontekstist	CLAUDE.md + AGENTS.md annavad alati konteksti
Iga kord nullist alustamine	Mälu süsteem säilitab konteksti sessioonide vahel

Põhiidee: Claude Code saab ühes sõnumis käivitada mitu tööriista korraga — need töötavad paralleelselt. Kui tööriistad ei sõltu teineteisest, saadab Claude kõik käsud ühe sõnumiga, mitte järjestikku.

Kuidas paralleelsus töötab

Näide: 3 agenti samaaegselt

Kui sa küsid: "Analüüsi minu repot ja anna ülevaade" — Claude käivitab paralleelselt:

Agent 1 Uurib projekti struktuuri ja failid (Glob, Read)

Agent 2 Otsib spetsiifilisi sümboleid (Grep)

Agent 3 Loeb konfiguratsioone (Read mitu faili korraga)

Kõik kolm töötavad korraga → tulemus on 3x kiirem kui järjestikku.

Agent tüübid

Spetsialiseeritud agendid

Agent tüüp	Milleks kasutatakse	Tööriistad
general-purpose	Keerukad mitmeastmelised ülesanded, laiaulatuslikud otsingud	Kõik tööriistad
Explore	Kiire koodibaasiuurimine, failiotsing, struktuurianalüüs	Glob, Grep, Read, Bash
Plan	Implementatsiooni planeerimine, arhitektuuri kujundamine	Glob, Grep, Read
claude-code-guide	Küsimused Claude Code kohta, API kasutus, hooks seaded	Glob, Grep, Read, Web

AGENTS.md — agentide juhend

Projekti agentide konfiguratsioon

Failis claude-code-mobile/AGENTS.md on järgmine juhend:

<!-- BEGIN:nextjs-agent-rules -->
# This is NOT the Next.js you know

This version has breaking changes — APIs, conventions,
and file structure may all differ from your training data.
Read the relevant guide in node_modules/next/dist/docs/
before writing any code. Heed deprecation notices.
<!-- END:nextjs-agent-rules -->

See tähendab: iga agent, kes selle projekti peal töötab, saab automaatselt teada, et Next.js 16 on erinev ja peab enne dokumentatsiooni lugema. CLAUDE.md sisaldab ainult @AGENTS.md — mis laeb selle juhendi automaatselt iga seansi alguses.

Paralleelsete agentide käivitamine praktikas

Näidispromptid

Ühes sõnumis mitu tööd:

"Tee samaaegselt kolm asja:
1. Lisa kasutajaliidesele dark mode toggle
2. Kirjuta selle jaoks test
3. Uuenda README et dark mode on mainitud"

→ Claude käivitab 3 agenti paralleelselt, igaüks tegeleb oma ülesandega

Uurimise paralleliseerimine:

"Analüüsi samaaegselt:
- src/app/ komponendid
- package.json sõltuvused
- AGENTS.md reeglid
ja anna kokkuvõte"

→ Kõik kolm loetakse korraga, mitte ükshaaval

Task süsteem: Claude Code saab luua ülesandeid (TaskCreate), neid uuendada (TaskUpdate) ja kuvada nimekirja (TaskList). See võimaldab jälgida, millises etapis erinevad tööd on.

Ülesannete staatused

Võimalikud staatused

Staatus	Tähendus	Näide
pending	Ülesanne on loodud, pole alustatud	Vercel seadistamine
in_progress	Töö käib praegu	Dark mode komponendi kirjutamine
completed	Ülesanne on lõpetatud	GitHub SSH seadistamine ✓
failed	Ülesanne ebaõnnestus	Build vigadega, test läbi kukkunud

Claude-code-demo projekti praegune seis

Ülesannete tahvel

Tegemata

Vercel ühendamine npm install -g vercel → vercel login → vercel --prod

Funktsionaalne UI Praegu ainult boilerplate, sisu puudub

API route'd Next.js API endpoints puuduvad

Käib

Dokumentatsioon See leht — claude-code-demo.html

Valmis

Next.js projekt loodud claude-code-mobile/ ✓

GitHub repo madislaansalu/claude-code-demo ✓

AGENTS.md seadistus Next.js 16 agendi reeglid ✓

Node.js + Claude Code Tööriistad paigaldatud ✓

Ülesannete jälgimine terminalis

TaskCreate / TaskList käsud

Claude Code kasutab neid automaatselt, aga sa saad ka ise küsida:

# Näita kõiki käimasolevaid ülesandeid
"Mis ülesandeid sa praegu jälgid?"

# Loo konkreetne ülesanne järelkontrolliks
"Loo ülesanne: kontrolli et Vercel deploy töötab"

# Uuenda staatust
"Märgi Vercel seadistamine lõpetatuks"

GitHub + Vercel automaatne töövoog

Deploy pipeline

Claude Code

→

git push

→

GitHub

→

Vercel

→

Live URL

Iga git push käivitab Vercelis automaatse buildi → ~1-2 minutiga on muudatused live.

Vercel seadistamine (järgmised sammud)

Samm-sammult juhend

1 Paigalda Vercel CLI

Käivita hostis:

npm install -g vercel
vercel --version  # kontrolli

2 Logi sisse

Ühenda GitHub kontoga:

vercel login
# Avab brauseri → vali "Continue with GitHub"

3 Deploy alamkaustas

Tähtis: rakendus on claude-code-mobile/ all, mitte repo juures!

cd /home/madislaansalu/claude-code-demo/claude-code-mobile
vercel --prod
# Framework: Next.js (automaatne)
# Root Directory: . (praegune kaust)

4 Edaspidi automaatne

Pärast esimest deploy'd töötab kõik automaatselt:

# Claude Code teeb muudatuse
git add . && git commit -m "feat: lisa dark mode"
git push origin main
# → Vercel buildib ja deployib automaatselt

CLAUDE.md ja AGENTS.md roll töövoos

Konteksti automaatne laadimine

CLAUDE.md

@AGENTS.md

Laeb AGENTS.md sisu automaatselt iga seansi alguses

AGENTS.md

# This is NOT the Next.js you know
Breaking changes — read docs first.

Hoiatab agente Next.js 16 eripärade eest

Kasulikud Claude Code käsud

Igapäevased käsud

Käsk / Prompt	Mida teeb
/clear	Tühjendab vestluse konteksti, alustab puhtalt
/compact	Tihendab vestluse ajalugu, vabastab kontekstiruumi
/help	Näitab kõiki saadaval käske
! <käsk>	Käivitab shelli käsu terminalis (nt `! git status`)
/commit	Loob git commiti praeguste muudatustega

Agentide käivitamine

Paralleelsete tööde käivitamine promptidega

# Uuri repot paralleelselt mitmest nurgast
"Analüüsi samaaegselt komponendid, testid ja konfiguratsioon"

# Käivita mitu tööd korraga
"Tee paralleelselt:
1. Refaktori Header komponent
2. Lisa sellele TypeScript tüübid
3. Kirjuta üks unit test"

# Jälgi staatuseid
"Mis on praeguste ülesannete seis?"

# Deploy koos staatuse kontrollimisega
"Push GitHubi ja vaata kas Vercel build õnnestus"

Vercel CLI käsud

Vercel käsud

Käsk	Kirjeldus
vercel --version	Kontrolli paigaldust
vercel whoami	Vaata kellena oled sisse logitud
vercel login	Logi sisse (avab brauseri)
vercel	Deploy preview keskkonda
vercel --prod	Deploy production keskkonda
vercel ls	Näita kõiki deployid
vercel logs	Vaata viimase deploy logisid
vercel env add	Lisa keskkonnamuutuja

Git käsud töövoos

Tüüpiline Claude Code git töövoog

# Claude Code teeb muudatused → sina commitid
git status               # mis muutus?
git diff                  # täpsed muudatused
git add src/             # lisa konkreetsed failid
git commit -m "feat: ..."
git push origin main     # → Vercel deploy käivitub

# Vaata Vercel deploy staatust
vercel ls