Analiza Claude Code arhitekture: reverse-engineering TypeScript izvora otkriva 5 vrijednosti i 13 dizajn principa AI agent alata

Što ovaj rad radi?

Tim istraživača (Jiacheng Liu, Xiaohan Zhao, Xinyi Shang, Zhiqiang Shen) objavio je 17. travnja 2026. na arXivu opsežnu analizu Claude Code arhitekture — Anthropicovog AI coding agenta koji je postao jedan od najutjecajnijih alata u kategoriji zadnje godine.

Pristup je necommon: autori su reverse-engineerirali TypeScript source kod distribuiranog Claude Code paketa (isporučuje se kao npm modul koji je tehnički čitljiv), mapirali arhitekturu i usporedili s OpenClaw — open-source agentom koji pokušava replicirati Claude Code funkcionalnost.

Cilj nije bio “kopirajte Claude Code”, nego: razumjeti dizajn principe koje Anthropic implicitno slijedi, kako bi šira zajednica mogla graditi bolje agente.

Što su našli — 5 temeljnih vrijednosti

Analiza je destilirala 5 vrijednosti koje strukturalno vode Claude Code arhitekturu:

1. Human authority — korisnik uvijek ima konačnu riječ. Agent može predlagati, planirati, izvršavati — ali kritične odluke (destruktivne akcije, commitanje, deploy) prolaze kroz eksplicitno odobrenje.

2. Safety — višeslojna obrana: runtime permissions, sandboxing, audit log, rollback. Agent ne može “slučajno” uništiti projekt.

3. Execution — agent ne samo da priča o rješenju, nego ga i izvršava. Shell pristup, file editovi, git operacije — sve iz istog konteksta.

4. Capability — širok tool set (bash, read, edit, grep, web fetch, itd.) čini agent praktičnim za realni rad, ne samo demo.

5. Adaptability — skills mechanism omogućuje proširenje bez rekompajliranja. MCP server pristup otvara integraciju s vanjskim sustavima.

Autori zatim izvode 13 dizajn principa koji operacionaliziraju ovih 5 vrijednosti — npr. “svaki destruktivni alat traži eksplicitno odobrenje”, “kontekst čuva ne više od N poruka za token efikasnost”, “tool rezultati idu natrag u model kao sljedeći input bez miješanja uloga”.

Iznenađenje: srž je jednostavna while-petlja

Najzanimljiviji nalaz rada je koliko je srž Claude Code-a zapravo jednostavna:

while not done:
    response = model(current_context)
    if response contains tool_call:
        result = execute_tool(tool_call)
        context.append(result)
    else:
        wait_for_user_input()

Sva složenost — inteligencija, kontekst, alati, sigurnost — nalazi se u:

• Prompt-u i system messageu (kako se model instruira)
• Tool setu i njihovim permissionima (što agent smije, pod kojim uvjetima)
• Upravljanju kontekstom (što se čuva, kompresira, briše)

Ne postoji magična “agent orchestration” biblioteka u srži. Samo petlja, model, i pažljivo dizajnirani alati.

Zašto je to važno za sve koji grade agente?

Zaključak je značajan:

• Ne trebaš složene frameworke. LangGraph, CrewAI, AutoGen, AGP — svi nude bogatu orkestraciju, ali Claude Code pokazuje da je moćna jednostavnost konkurentna.
• Vrijednosti > features. 5 temeljnih vrijednosti koje Anthropic slijedi su vidljive u svakom aspektu proizvoda — od UX-a do sigurnosnih pragova.
• OpenClaw replika potvrđuje: moguće je napraviti konkurentan agent s jednostavnom arhitekturom ako su vrijednosti i alati dobro definirani.

Rad je preprint. Code je dostupan (rad spominje reproducibility), a analiza je dovoljno konkretna da može poslužiti kao blueprint za vlastite agent projekte. Za inženjere koji razmišljaju o building vs. buying u AI agent prostoru — ovo je obavezna referentna točka.