Onboarding¶

Kompletni vodič za postavljanje razvojnog okruženja sa AI-assisted workflowom.

Sistemski preduvjeti¶

Prije početka, provjerite da imate:

macOS ili Linux (Windows sa WSL2)
Node.js v18+ i npm
Git v2.30+
Python 3.10+ (za MkDocs i neke alate)
Pristup internetu za API pozive

Provjera:

node --version    # v18+
npm --version     # 9+
git --version     # 2.30+
python3 --version # 3.10+

Korak 1: Node.js RAM alokacija¶

Obavezno prije svega ostalog

Node.js ima poznati memory leak problem koji se manifestira kod dugih sesija ili velikih projekata. Bez ove konfiguracije, Claude Code može postati spor ili se srušiti.

Dodajte u vaš shell config (~/.bashrc, ~/.zshrc, ili ~/.bash_profile):

export NODE_OPTIONS="--max-old-space-size=16384"

Ovo alocira 16 GB RAM-a za Node.js proces.

Zatim reload-ujte shell:

source ~/.zshrc   # ili source ~/.bashrc

Monitoring RAM-a¶

Pratite korištenje memorije tokom rada:

macOS: Activity Monitor → filtrirajte "node"
Linux: htop ili top → filtrirajte node procese

Ako primjetite da Claude Code postaje spor:

Završite trenutni zadatak
Zatvorite sesiju
Provjerite da su svi node procesi zatvoreni
Pokrenite novu sesiju

Korak 2: Claude Code CLI¶

Instalirajte Claude Code CLI prema zvaničnoj dokumentaciji:

npm install -g @anthropic-ai/claude-code

Provjera:

claude --version

Korak 3: Claude Code Router¶

npm install -g @musistudio/claude-code-router

Konfiguracija:

Preuzmite config template: ccr-config.json
Kopirajte u config direktorij:

mkdir -p ~/.claude-code-router
cp ccr-config.json ~/.claude-code-router/config.json

Unesite svoje API ključeve u config fajl

API ključevi

API ključeve zatražite na https://backoffice.infopuls.net/requests. Ne dijelite ih i ne commitujte u repozitorij.

Korak 4: MCP Serveri¶

MCP serveri se konfiguriraju u Claude Code settings fajlu.

Jira¶

Zatražite od admina:

Jira API token
Email povezan sa Jira računom
URL Jira instance

Bitbucket¶

Zatražite od admina:

Bitbucket App password
Username za Bitbucket

Context7¶

Context7 se obično instalira kao plugin i ne zahtijeva posebne kredencijale.

Korak 5: GSD Skill¶

GSD workflow se instalira kao skill za Claude Code. Pratite upute za instalaciju sa zvaničnog repozitorija ili zatražite setup instrukcije od tima.

Korak 6: Podešavanje dozvola¶

Claude Code traži dozvolu za izvršavanje akcija. Preporučene postavke:

Lokalni settings¶

Kreirajte ili uredite ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "WebSearch"
    ],
    "deny": []
  }
}

Projektni settings¶

Svaki projekat može imati .claude/settings.json sa specifičnim dozvolama:

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run build)",
      "Bash(git *)"
    ]
  }
}

Sigurnosni savjet

Počnite sa restriktivnijim dozvolama i dodajte po potrebi. Bolje je da Claude Code pita za dozvolu nego da automatski izvrši nešto neželjeno.

Korak 7: Team-wide settings¶

Za konzistentnost u timu, koristimo zajedničke settings fajlove koji se commituju u repozitorij.

Kako radi¶

Projektni .claude/settings.json se commituje u repo. Svi članovi tima dobijaju iste postavke:

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run build)",
      "Bash(npm run lint)",
      "Bash(git add *)",
      "Bash(git commit *)"
    ],
    "deny": [
      "Bash(git push *)"
    ]
  }
}

Prednosti¶

Konzistentnost — AI se ponaša isto za cijeli tim
Sigurnost — centralno upravljanje dozvolama
Onboarding — novi članovi odmah imaju ispravne postavke

Princip

"Ako ne pita mene da pusha, neće ni tebe." — Zajedničke dozvole znače predvidljivo ponašanje za cijeli tim. Niko ne mora ručno podešavati dozvole na svom računaru.

Korak 8: Verifikacija¶

Testirajte cijeli setup:

1. Claude Code¶

claude "Zdravo, reci mi koji si model"

2. CCR routing¶

ccr status

3. MCP serveri¶

# U Claude Code sesiji
claude "Pokaži mi moje Jira tikete"

4. Context7¶

# U Claude Code sesiji
claude "Koristi Context7 da dohvatiš React dokumentaciju"

5. GSD¶

# U Claude Code sesiji
/gsd:help

Česte greške¶

Problem	Rješenje
`command not found: claude`	Provjerite da je `@anthropic-ai/claude-code` globalno instaliran
CCR ne routira	Provjerite config putanju i format JSON-a
MCP server timeout	Provjerite API tokene i network pristup
Permission denied	Dodajte dozvolu u settings.json
Node.js out of memory	Provjerite `NODE_OPTIONS` env varijablu (Korak 1)
Claude Code spor	Restartujte sesiju, provjerite RAM (Korak 1)

Sljedeći koraci¶

Nakon što je sve postavljeno:

Pročitajte GSD Workflow — naš primarni način rada
Pogledajte Best Practices — savjeti iz prakse
Isprobajte /gsd:quick na nekom malom zadatku za vježbu
Držite Cheat Sheet pri ruci kao referencu