⚡Claude Code v2.1
← Referinta

Troubleshooting

10 probleme frecvente si cum le rezolvi.

#1
Claude nu stie ce sa faca la start de sesiune
Simptom: Claude intreaba "cu ce te pot ajuta?" in loc sa continue lucrul.
Cauza

STATE.md nu exista sau nu a fost actualizat.

Fix
  • Verifica ca .planning/STATE.md exista si are sectiunile 1-6
  • Asigura-te ca sectiunea "4. Next Concrete Step" are un pas concret
  • Daca STATE.md lipseste, creeaza-l cu template-ul din setup-guide
#2
((var++)) cauzeaza exit code 1 in bash
Simptom: Script-ul bash se opreste neasteptat cand folosesti set -e si ((PASS++)).
Cauza

In bash, ((0++)) evalueaza la 0 (falsy), ceea ce cu set -e opreste scriptul.

Fix
  • Inlocuieste ((PASS++)) cu PASS=$((PASS + 1)) — forma sigura care nu returneaza exit code non-zero.
# GRESIT (esueaza cu set -e cand PASS=0)
((PASS++))

# CORECT (functioneaza mereu)
PASS=$((PASS + 1))
#3
set -e nu prinde erori in command substitution
Simptom: OUTPUT="$(./script.sh 2>&1)" || true tot opreste scriptul cu set -e.
Cauza

In bash, set -e se aplica pe command substitution INAINTE ca || true sa poata prinde eroarea.

Fix
  • Captureaza exit code explicit cu && EXIT_CODE=0 || EXIT_CODE=$?
# GRESIT
OUTPUT="$(./script.sh 2>&1)" || true

# CORECT
OUTPUT="$(./script.sh 2>&1)" && EXIT_CODE=0 || EXIT_CODE=$?
#4
Wikilinks nu rezolva in Obsidian
Simptom: [[STATE]] apare ca link broken in Obsidian.
Cauza

Fisierul target e in afara vault-ului (ex: .planning/STATE.md nu e in docs/).

Fix
  • Creeaza symlinks in vault:
ln -sf ../../.planning/STATE.md docs/00-index/STATE.md
ln -sf ../../.planning/ROADMAP.md docs/00-index/ROADMAP.md
#5
Stop hook nu genereaza session note
Simptom: La finalul sesiunii, nu apare fisier nou in docs/30-sessions/.
Cauza

Directorul docs/30-sessions/ nu exista, hook-ul nu e configurat, sau stop.sh nu are permisiuni.

Fix
  • mkdir -p docs/30-sessions
  • Verifica .claude/settings.json contine configuratia Stop hook
  • chmod +x .claude/hooks/stop.sh
#6
MCP server nu porneste
Simptom: Claude raporteaza ca nu poate conecta la context7 sau memory.
Cauza

Node.js/npx nu e instalat sau .mcp.json e malformat.

Fix
  • Verifica Node.js: node --version (trebuie v18+)
  • Verifica .mcp.json e JSON valid: python3 -c "import json; json.load(open('.mcp.json'))"
  • Testeaza manual: npx -y @upstash/context7-mcp@latest
#7
Contextul se umple prea repede
Simptom: Claude devine lent sau pierde informatii importante.
Cauza

Ai incarcat prea multe fisiere in context fara sa compactezi.

Fix
  • Foloseste /compact la breakpoint-uri logice (intre task-uri, NU mid-implementare)
  • Nu incarca tot codebase-ul — foloseste Glob si Grep targetate
  • Foloseste @docs/fisier.md pentru on-demand loading
  • Regula: opreste-te la 75% context, compacteaza
#8
Dataview queries nu afiseaza nimic in Obsidian
Simptom: Blocurile dataview apar ca text, nu ca rezultate.
Cauza

Plugin-ul Dataview nu e instalat sau activat.

Fix
  • Obsidian → Settings → Community Plugins → Browse → Dataview → Install → Enable
  • Restart Obsidian
  • Verifica ca frontmatter YAML e corect (trebuie sa inceapa cu ---)
#9
Git commit esueaza dupa hook pre-commit
Simptom: git commit returneaza eroare de la hook.
Cauza

Pre-commit hook-ul gaseste probleme in cod.

Fix
  • NU folosi --no-verify — fix-eaza problema reala
  • Citeste eroarea exact — de obicei e linting sau formatting
  • Dupa fix, fa un commit NOU (nu --amend — risc de pierdere date)
#10
STATE.md nu a fost actualizat (warning la Stop)
Simptom: "WARNING: STATE.md not updated in this session"
Cauza

Nu ai actualizat STATE.md in ultimele 5 minute ale sesiunii.

Fix
  • Actualizeaza sectiunea "2. Current Phase" — faza actuala
  • Actualizeaza sectiunea "4. Next Concrete Step" — un singur pas concret
  • Actualizeaza sectiunea "6. What Was Done" — lista scurta