Tutorial de la sèrie Claude Code 2: La relació entre Claude Code, Claude Chat i Claude API

1.2 La relació "familiar" amb Claude Chat i l'API

Molts desenvolupadors, en sentir per primera vegada parlar de Claude Code, pensen naturalment en altres dos productes: Claude Chat (interfície de xat web) i Claude API (interfície de programació). Tots provenen d'Anthropic i utilitzen la família de models Claude, però resolen problemes i s'utilitzen en escenaris molt diferents.

En aquesta secció, aclarirem les relacions i diferències entre els tres.

Perfil ràpid dels tres productes

Dimensió	Claude Chat	Claude API	Claude Code
Forma d'interacció	Conversa en navegador web	Crida de codi, retorna JSON	Interacció en terminal de comandaments
Usuaris principals	Tothom (desenvolupadors, no desenvolupadors)	Desenvolupadors (construint aplicacions)	Desenvolupadors (col·laboració de programació local)
Escenari principal	Preguntes i respostes, escriptura, anàlisi de documents	Incrustar IA en productes propis	Modificar codi directament al directori del projecte, executar tasques
Font de context	L'usuari enganxa manualment o puja fitxers	El desenvolupador passa paràmetres	Llegeix automàticament la base de codi local, estructura de directoris
Pot executar codi?	No	Depèn del codi de l'aplicació	Sí, pot executar comandaments Shell
Té memòria persistent?	Sessió única, sense memòria a llarg termini	Sense estat (el desenvolupador ho gestiona)	Persistència entre sessions mitjançant CLAUDE.md
Models integrats	Claude Sonnet, Opus	Tota la sèrie de models Claude	Sonnet, Opus, Haiku, etc.

Claude Chat: Consultor versàtil i flexible

Claude Chat (accessible a través de claude.ai) és la forma que coneixem millor. És una interfície de conversa basada en navegador on pots pujar PDFs, enganxar fragments de codi, discutir solucions tècniques, redactar documents, etc.

El seu avantatge és que funciona directament, sense necessitat d'instal·lació ni configuració, ni coneixements de línia de comandaments. Pots fer preguntes tècniques, demanar que analitzi un contracte o escrigui un correu electrònic.

Però com a eina de programació, té una limitació clara: no es connecta al teu entorn local. No pot veure tots els fitxers del projecte, no pot llegir package.json per analitzar dependències, ni executar proves per verificar si les seves modificacions funcionen. Només pots copiar i enganxar fragments de codi manualment i després aplicar les seves suggerències a l'editor.

Escenaris adequats:
- Aprendre conceptes nous de tecnologia, comparacions de frameworks
- Generar ràpidament fragments de codi o plantilles
- Analitzar documents, redactar articles tècnics
- Assistència per a no desenvolupadors en tasques diàries

Claude API: Infondre ànima d'IA als productes

L'API de Claude és una interfície de programació orientada a desenvolupadors. Pots enviar sol·licituds HTTP al model Claude amb instruccions i rebre respostes de text. És un cervell Claude programable que pots integrar en qualsevol aplicació: construir un chatbot d'atenció al client, una GitHub App de revisió de codi, un generador automatitzat d'informes...

L'API ofereix la màxima flexibilitat, però també implica que has de gestionar moltes coses:
- Gestionar el context: dissenyar com passar l'historial de conversa, instruccions del sistema i dades externes al model.
- Implementar crides a eines: si vols que el model "executi" una acció, com consultar una base de dades, has de definir funcions d'eina i gestionar les sol·licituds d'ús d'eina.
- Mantenir l'estat: l'API és sense estàtica, la memòria entre interaccions l'has d'emmagatzemar i gestionar tu.

Escenaris adequats:
- Construir aplicacions pròpies d'IA o productes SaaS
- Incrustar capacitats d'IA en fluxos de treball existents (p. ex., generació automàtica de notes de versió en CI/CD)
- Processar grans volums de dades i personalitzar formats de sortida complexos
- Necessitats avançades que requereixen control fi del comportament del model

Claude Code: Agent de programació arrelat al terminal

Claude Code es pot considerar el company d'IA més directe i estret en el desenvolupament diari. S'executa al terminal i s'integra activament al teu entorn de desenvolupament.

En comparació amb Chat, Claude Code no requereix que enganxis manualment el context: ell mateix llegeix fitxers, examina l'estructura de directoris i comprèn les dependències i l'estil arquitectònic del projecte.

En comparació amb l'API, Claude Code encapsula moltes pràctiques d'enginyeria: gestiona automàticament la memòria de la sessió, té eines integrades (cerca de fitxers, execució de comandaments, operacions Git) i un sistema de configuració madur (CLAUDE.md, .claudeignore, etc.). No necessites construir un sistema d'agents des de zero, només centrar-te en "programar-hi junts".

Escenaris adequats:
- Comprendre ràpidament codi desconegut en projectes locals
- Refactoritzar entre fitxers, corregir errors de lint automàticament
- Generar proves i executar verificacions per tancar el cercle
- Automatitzar operacions Git diàries i orquestració de tasques
- Rebre retroalimentació de revisió de codi en temps real

Relació de parentiu: Cervell compartit, cossos diferents

Podem fer una analogia:

• Claude Chat és similar a una màquina de consulta de biblioteca: rica en informació, adequada per a preguntes de coneixement i processament de documents, però no està connectada al teu taller privat.
• Claude API és similar a una fàbrica de motors: et proporciona un motor de precisió (capacitat del model) i tu construeixes la carrosseria, les rodes i muntes qualsevol vehicle (aplicació).
• Claude Code és similar a un vehicle d'enginyeria personalitzat per a desenvolupadors: ve de fàbrica amb diverses eines: braç elevador (operacions amb fitxers), cullera (execució de comandaments), navegació (percepció del projecte). Pots començar a treballar-hi directament.

La connexió entre els tres és:
- El mateix model Claude: El Sonnet, Opus del Chat també els pots seleccionar a Claude Code; les versions de model disponibles a l'API es sincronitzen progressivament amb l'eina CLI.
- Principis compartits d'enginyeria de prompts: Tant si has descobert "trucs de prompts" al Chat com si has resumit experiències amb System Prompt a l'API, tot es pot traslladar parcialment a la configuració CLAUDE.md de Claude Code.
- Camí d'evolució gradual: Molts equips comencen amb Chat (proves a petita escala), passen a l'API (integració personalitzada) i finalment introdueixen Claude Code en el desenvolupament local (col·laboració profunda de programació).

Com triar entre Code, Chat i API?

Si només vols fer una pregunta o analitzar un document → Obre Claude Chat, és l'opció més eficient.

Si estàs desenvolupant un producte o flux de treball que necessita incrustar IA → Utilitza Claude API, és el motor programable.

Si estàs programant localment i necessites un company que pugui modificar fitxers i executar comandaments directament → Engega Claude Code, és el teu col·lega que entén de codi.

No són mútuament excloents, sinó complementaris. Jo mateix els uso sovint així:

1. Abans d'implementar una funció complexa amb Claude Code, primer vaig a Claude Chat per discutir el disseny i verificar la viabilitat de la idea.
2. Escric les normes de disseny obtingudes al Chat al fitxer CLAUDE.md del projecte.
3. Faig que Claude Code implementi la funció localment segons les normes, i després, mitjançant l'API, insereixo automàticament aquest procés a la canonada de CI.