Claude Code tutorial saila 2: Claude Code, Claude Chat eta Claude API arteko harremana

1.2 Claude Chat eta API-ren "ahaidetasuna"

Garatzaile askok Claude Code-ren berri izaten dutenean, beste bi produktu-forma datorkie burura: Claude Chat (web elkarrizketa-interfazea) eta Claude API (programazio-interfazea). Biak Anthropic-etik datoz, eta oinarrian Claude modelo familia erabiltzen dute, baina konpontzen dituzten arazoak eta erabiltzen diren eszenatokiak erabat desberdinak dira.

Atal honetan hiruren arteko harremana eta desberdintasunak argituko ditugu.

Hiru produktu-formen erretratu azkarra

Dimentsioa	Claude Chat	Claude API	Claude Code
Elkarreragin era	Web nabigatzaileko elkarrizketa	Kode deia, JSON itzulera	Terminaleko komando-lerroko elkarrizketa
Erabiltzaile nagusiak	Denak (garatzaileak, ez-garatzaileak)	Garatzaileak (aplikazioak eraikitzeko)	Garatzaileak (tokiko programazio-lankidetza)
Funtsezko eszenatokia	Galdera-erantzunak, idazketa, dokumentuen analisia	IA produktu propioetan txertatzea	Kodea zuzenean proiektu-direktorioan aldatu eta atazak exekutatu
Testuinguru iturria	Erabiltzaileak eskuz itsatsi edo fitxategiak igo	Garatzaileak parametro bidez transmititu	Automatikoki irakurri tokiko kode-liburutegia eta direktorio-egitura
Kodea exekuta dezake?	Ez	Zure aplikazio-kodearen araberakoa	Shell komandoak zuzenean exekutatu ditzake
Memoria iraunkorra?	Saio bakarrekoa, epe luzeko memoriorik gabe	Egoerarik gabea (garatzaileak kudeatzen du)	`CLAUDE.md` bidez saio arteko memoria iraunkorra
Eramandako modeloa	Claude Sonnet, Opus	Claude modelo sorta osoa	Sonnet, Opus, Haiku eta beste

Claude Chat: Aholkulari polifazetiko malgua

Claude Chat (claude.ai bidez eskuragarri) ezagunena dugun forma da. Nabigatzailean oinarritutako elkarrizketa-interfazea da, PDFak igo, kode-zatiak itsatsi, eskema teknikoak eztabaidatu, dokumentuak idatzi eta abar egin ditzakezu.

Bere abantaila kutxatik kanpo erabiltzeko prest dagoela da, ez du instalazio edo konfiguraziorik behar, eta ez da komando-lerroko ezagutzarik behar. Bertan galdera teknikoak egin ditzakezu, kontratu bat aztertu edo mezu bat idazteko laguntza eskatu.

Baina programazio-tresna gisa, muga argi bat du: ez du zure tokiko ingurunearekin konexiorik. Ezin ditu zure proiektuko fitxategi guztiak ikusi, ezin du package.json irakurri menpekotasunak aztertzeko, ezin ditu proba-komandoak exekutatu proposatutako aldaketak benetan balio duten egiaztatzeko. Fitxategien edukia zatika itsatsi behar duzu, eta gero bere iradokizunak editorean eskuz aplikatu.

Eszenatoki egokiak:
- Teknologia kontzeptu berriak ikastea, framework-en konparaketa
- Kode-zatiak edo txantiloiak azkar sortzea
- Dokumentuak aztertzea, artikulu teknikoak idaztea
- Ez-garatzaileek eguneroko lanean laguntza

Claude API: Produktuei IA arima ematea

Claude API garatzaileei zuzendutako programazio-interfazea da. HTTP eskaeren bidez Claude modeloei prompt-ak bidali eta testu erantzunak jaso ditzakezu. Programagarria den Claude garuna da, edozein aplikaziotan integra dezakezuna: bezeroarentzako arreta-bot bat eraiki, kode-berrikuspeneko GitHub App bat, txosten-sorgailu automatizatu bat...

APIak malgutasun handiena du, baina esan nahi du gauza asko zuk kudeatu behar dituzula:
- Testuingurua kudeatzea: elkarrizketa-historia, sistema prompt-ak eta kanpoko datuak nola transmititu modelora diseinatu behar duzu.
- Tresna-deiak inplementatzea: modeloak "ekintza" bat exekutatzea nahi baduzu, adibidez, datu-basea galdetzea, tresna-funtzioak definitu eta modeloak itzultzen duen Tool Use eskaera kudeatu behar duzu.
- Egoera mantentzea: APIa berez egoerarik gabea da, eta saioen arteko memoria zuk gorde eta kudeatu behar duzu.

Eszenatoki egokiak:
- Zure IA aplikazioa edo SaaS produktua eraikitzea
- IA gaitasuna lan-fluxu existenteetan txertatzea (adibidez, CI/CD-n Release Note automatikoa sortzea)
- Datu kopuru handiak prozesatzea eta irteera-formatu konplexuak pertsonalizatzea
- Modeloaren portaeraren kontrol xehea behar duten behar aurreratuak

Claude Code: Terminalean sustraitutako programazio-agentea

Claude Code garatzailearen eguneroko garapenean lagunik zuzenean eta estuena bezala ikus daiteke. Terminalean exekutatzen da, zure garapen-ingurunean aktiboki integratzen da.

Chat-ekin alderatuta, Claude Code-k ez du eskuz testuingurua itsatsi beharrik — berak irakurtzen ditu fitxategiak, direktorio-egitura ikusten du, eta proiektu osoaren menpekotasunak eta arkitektura estiloa ulertzen ditu.

API-arekin alderatuta, Claude Code-k praktika ingeniaritzako ugari biltzen ditu: automatikoki kudeatzen du saioen memoria, barne tresna-deiak (fitxategiak bilatu, komandoak exekutatu, Git manipulatu), konfigurazio sistema heldua du (CLAUDE.md, .claudeignore eta abar), eta ez duzu hutsetik agente sistema bat eraiki beharrik, "berarekin programatzean" soilik zentratu zaitezke.

Eszenatoki egokiak:
- Tokiko proiektuetan kode ezezaguna azkar ulertzea
- Fitxategi arteko birmoldaketa, lint akatsak automatikoki konpontzea
- Probak sortu eta exekutatu, zikloa itxiz
- Eguneroko Git eragiketak eta ataza-antolaketa automatizatzea
- Denbora errealeko kode-berrikuspen feedback-a jasotzea

Hiruren odol-ahaidetasuna: Garuna partekatu, gorputz bakoitza berea

Irudizko metafora bat egin daiteke:

Claude Chat liburutegiko kontsulta-makina baten antzekoa da: informazio oparoa, hainbat jakintza-galderei eta dokumentu-tratamenduari egokia, baina ez du zure tailer pribatuarekin konektatzen.
Claude API motor-fabrika baten antzekoa da: doitasun handiko motorra (modelo gaitasuna) ematen dizu, eta zuk zeuk eraikitzen duzu karrozeria, gurpilak jartzen eta nahi duzun ibilgailua (aplikazioa) muntatzen.
Claude Code garatzaileentzat pertsonalizatutako ibilgailu ingeniaritza baten antzekoa da: fabrikatik hainbat tresna dakartza — besoa (fitxategi eragiketak), pala (komando exekuzioa), nabigazioa (proiektuaren pertzepzioa), eta zuzenean has zaitezke lan egiten.

Hiruren arteko lotura:
- Claude modelo bera: Chat-eko Sonnet, Opus, Claude Code-n ere aukeratu ditzakezu; API-n eskuragarri dauden modelo bertsioak pixkanaka CLI tresnara sinkronizatzen dira.
- Prompt ingeniaritzako printzipio partekatuak: Chat-en aurkitu dituzun "aholku teknikak" edo API bidez laburtutako System Prompt esperientziak, neurri batean Claude Code-ren CLAUDE.md konfiguraziora transferi daitezke.
- Eboluzio bide mailakatua: Talde askoren lan-fluxua Chat-ekin hasten da (probak), ondoren API-ra (integrazio pertsonalizatua), eta azkenik tokiko garapen fasean Claude Code sartzen dute (programazio-lankidetza sakona).

Nola aukeratu code, chat, api?

Galdera bat egin edo dokumentu bat aztertu nahi baduzu soilik → Ireki Claude Chat, da eraginkorrena.

IA txertatu behar duen produktu edo lan-fluxu bat garatzen ari bazara → Erabili Claude API, motor programagarria da.

Tokiko kodea idazten ari bazara eta fitxategiak zuzenean aldatu eta komandoak exekutatu ditzakeen kide bat behar baduzu → Abiarazi Claude Code, da kodea ulertzen duen lankidea.

Hirurak ez dira elkar baztertzen, baizik eta osagarriak. Nik neuk sarritan erabiltzen ditut honela:

Claude Code-rekin funtzio konplexu bat gauzatu baino lehen, Claude Chat-en diseinua eztabaidatzen dut, ideia arrazoizkoa den egiaztatzeko;
Chat-en ateratako diseinu-arauak CLAUDE.md fitxategian idazten ditut;
Claude Code-k arauei jarraituz tokian inplementatzen du, eta gero API bidez prozesu hori CI hodian automatikoki txertatzen dut.