Com utilitzar Claude Code: Guia completa (2026)

Resum ràpid: Claude Code és l'assistent de codificació per a terminals i IDE impulsat per IA d'Anthropic que ajuda els desenvolupadors a crear, depurar i enviar codi més ràpidament mitjançant ordres en llenguatge natural. S'integra directament al vostre terminal, VS Code i altres entorns de desenvolupament, oferint cerca agentiva, edició de diversos fitxers i automatització del flux de treball de GitHub. La instal·lació triga minuts mitjançant un simple comandament curl, i els desenvolupadors poden personalitzar el comportament mitjançant fitxers CLAUDE.md, comandes de barra i habilitats d'agent.

Claude Code ha transformat la manera com els desenvolupadors interactuen amb els assistents de codificació d'IA. En lloc de copiar fragments de codi entre finestres de xat i editors, Claude Code resideix directament al vostre entorn de desenvolupament, executant ordres, editant fitxers i gestionant fluxos de treball mitjançant llenguatge natural.

La eina representa un canvi fonamental de la IA conversacional a la IA agentiva que realment realitza tasques. Però començar i entendre les seves capacitats requereix més que només la instal·lació.

Aquesta guia cobreix tot, des de la configuració fins als fluxos de treball avançats, basant-se en la documentació oficial i les experiències reals dels desenvolupadors.

Què és Claude Code

Claude Code és un assistent de codificació agentiu que s'integra directament al vostre terminal, IDE i flux de treball de desenvolupament. A diferència de les eines de codificació d'IA tradicionals que generen suggeriments, Claude Code pot llegir tot el vostre codi, realitzar edicions de diversos fitxers, executar ordres del terminal i gestionar operacions de git, tot mitjançant interacció conversacional.

El sistema utilitza la cerca agentiva per entendre l'estructura del projecte i les dependències sense selecció manual de context. Això significa que Claude Code pot navegar per bases de codi complexes i prendre decisions informades sobre on realitzar canvis.

Segons el lloc web oficial d'Anthropic, Claude Code té un preu de 30 dòlars per milió de tokens d'entrada i 150 dòlars per milió de tokens de sortida. La eina es connecta amb GitHub, GitLab i eines de línia de comandes per gestionar fluxos de treball des de la lectura d'incidències fins a la presentació de sol·licituds de pull.

Les capacitats clau inclouen:

• Edició de diversos fitxers a través de la vostra base de codi
• Execució d'ordres del terminal amb controls de permís
• Integració de GitHub i GitLab per a fluxos de treball d'incidència a pull request
• Cerca agentiva que entén les dependències del projecte
• Habilitats personalitzades i comandes de barra per a tasques repetides
• Memòria a través de fitxers de configuració del projecte CLAUDE.md

Instal·lació de Claude Code

La instal·lació varia lleugerament depenent del vostre sistema operatiu. El procés d'instal·lació triga típicament entre 5 i 10 minuts segons la velocitat d'internet, segons guies de la comunitat.

Instal·lació en macOS i Linux

Per als usuaris de macOS i Linux, la instal·lació utilitza un sol comandament curl. Obriu el vostre terminal i executeu:

El script descarrega Claude Code i les seves dependències, requerint típicament uns 50 MB per a Claude Code mateix. Necessitareu una connexió a internet estable i Node.js instal·lat al vostre sistema.

Després que la instal·lació es completi, reinicieu el vostre terminal o executeu l'ordre proporcionada per recarregar la configuració de la vostra shell. Després, verifiqueu la instal·lació escrivint claude al vostre terminal.

Instal·lació a Windows

Windows requereix Windows Subsystem for Linux 2 (WSL2) perquè Claude Code s'executa en un entorn Linux. Segons guies de la comunitat, la configuració implica diversos passos:

Primer, instal·leu WSL2 i Ubuntu des de la Microsoft Store. Aquesta descàrrega és d'aproximadament 500 MB. Després, obriu Ubuntu i actualitzeu el sistema amb ordres estàndard del gestor de paquets.

A continuació, instal·leu Node.js dins de l'entorn WSL2. Claude Code requereix Node.js per funcionar, i la versió de Windows no funcionarà; la versió Linux que s'executa dins de WSL2 és necessària.

Finalment, executeu l'ordre d'instal·lació dins del vostre terminal d'Ubuntu:

La mida total de descàrrega entre tots els components per a una instal·lació nova de Windows oscil·la típicament per sota d'1 GB, segons guies de la comunitat.

Instal·lació de l'extensió VS Code

Per instal·lar l'extensió oficial de Claude Code, obriu la vista d'Extensions de VS Code (Ctrl+Shift+X o Cmd+Shift+X), busqueu "Claude Code" d'Anthropic i feu clic a Instal·lar. Alternativament, executeu code 

Començar amb Comandes Bàsiques

Després de la instal·lació, Claude Code respon al llenguatge natural. Però entendre la seva estructura de comandes ajuda els desenvolupadors a treballar de manera més eficient.

Inicieu Claude Code escrivint claude al vostre terminal. La interfície presenta un prompt on podeu escriure les sol·licituds.

Comandes de Barra Fonamentals

Les comandes de barra proporcionen accés ràpid a funcions comunes. Aquestes comandes comencen amb una barra inclinada i activen comportaments específics.

Les comandes de barra essencials inclouen:

Els desenvolupadors experimentats informen que utilitzen /clear amb freqüència, cada vegada que comença una nova tasca. Això evita la contaminació del context, on converses prèvies influeixen inapropiadament en el treball actual.

L'ordre /compact s'ha d'utilitzar aproximadament al 20-30% del context disponible per mantenir la qualitat, segons usuaris experimentats de Claude Code. La qualitat del context es degrada quan la finestra s'omple, fent que la compressió sigui necessària per a una eficàcia continuada.

Interacció amb Llenguatge Natural

Més enllà de les comandes de barra, Claude Code respon a peticions conversacionals. Com més específic i detallat sigui el prompt, més probable és que produeixi resultats efectius.

Els prompts efectius inclouen:

• El que voleu aconseguir
• Restriccions o requisits rellevants
• Tecnologies o patrons específics a utilitzar
• Fitxers o components afectats

En lloc de "arregla el bug", proveu "hi ha una excepció de punter nul a api/users.js quan la base de dades retorna resultats buits. Afegeix gestió d'errors que retorni un array buit en el seu lloc."

Per a tasques complexes, alguns desenvolupadors informen que utilitzen "ultrathink" als prompts per animar Claude Code a pensar més profundament en els problemes abans de la implementació.

Entendre la Configuració CLAUDE.md

El fitxer CLAUDE.md serveix com a memòria del projecte: un fitxer de context persistent que Claude Code llegeix cada vegada que treballa a la vostra base de codi. Aquest fitxer actua com un document d'incorporació per a la IA.

Col·loqueu CLAUDE.md a la vostra arrel del projecte o en un directori .claude. Quan Claude Code comenci a treballar, llegirà aquest fitxer primer per entendre les convencions del projecte, les decisions d'arquitectura i els estàndards de codificació.

Seccions Essencials de CLAUDE.md

Segons les millors pràctiques de desenvolupadors experimentats, els fitxers CLAUDE.md efectius inclouen seccions específiques:

• Visió general del projecte: Breu descripció del que fa el projecte, el seu propòsit principal i les tecnologies clau utilitzades. Mantingueu-ho a un màxim de 3-4 frases.
• Arquitectura: Estructura d'alt nivell que explica com es connecten els components. Mencioneu frameworks, patrons de disseny i directoris clau.
• Estil de codificació: Preferències de formatació específiques, convencions de nomenclatura i patrons a seguir. Per exemple: "utilitzar components funcionals amb hooks, no components de classe" o "totes les trucades API passen per la capa de servei."
• Aproximació a les proves: Framework de proves, expectatives de cobertura i on resideixen les proves. Incloeu ordres per executar les proves.
• Comandes comunes: Scripts npm utilitzats amb freqüència, comandes de compilació o procediments de desplegament.
• Incidències conegudes: Errors actuals, deute tècnic o àrees a evitar modificar. Utilitzeu comentaris TODO com a marcadors.
• Dependències: Llibreries crítiques i els seus propòsits, especialment les no obvies.
• El fitxer ha de ser concís; la majoria dels fitxers CLAUDE.md efectius oscil·len entre 200 i 500 paraules. Claude Code utilitza aquest context per a cada interacció, de manera que la claredat és més important que la exhaustivitat.

Habilitats i Comandes Personalitzades

Més enllà de CLAUDE.md, Claude Code admet habilitats personalitzades definides als directoris .claude/skills/. Les habilitats són capacitats especialitzades escrites en Markdown que amplien les funcions de Claude Code.

Segons la documentació oficial, Anthropic proporciona habilitats preconstruïdes per a tasques comunes com crear presentacions de PowerPoint, fulls de càlcul d'Excel i documents PDF. Les habilitats personalitzades segueixen el mateix format per a necessitats específiques del projecte.

Les comandes de barra també es poden personalitzar afegint fitxers Markdown a .claude/commands/. Aquests creen dreceres per a fluxos de treball repetits específics del vostre projecte.

Treballar amb Claude Code al vostre IDE

L'extensió VS Code porta les capacitats de Claude Code a la interfície de l'editor. Aquesta integració funciona de manera diferent a la versió de terminal, però proporciona la mateixa funcionalitat bàsica.

Experiència de Terminal vs IDE

Cursor i Claude Code difereixen en els enfocaments de disseny fonamentals. La interfície de terminal proporciona una interacció més ràpida per als usuaris experimentats que treballen principalment en entorns de línia de comandes. Les ordres s'executen ràpidament sense canviar de context.

Però l'extensió VS Code ofereix millor visualització. Veure els canvis proposats ressaltats al vostre editor abans d'acceptar-los proporciona claredat. El sistema de permisos també se sent menys intrusiu a la GUI en comparació amb els prompts constants del terminal.

Alguns desenvolupadors combinen ambdues eines: Cursor per a suggeriments de codi en línia i Claude Code per a tasques a nivell de projecte.

Gestió de Permisos

Claude Code opera amb un sistema de permisos que pregunta abans d'executar ordres del terminal o modificar fitxers. Això evita accions no desitjades però pot interrompre el flux.

Alguns desenvolupadors informen que el sistema de permisos pot interrompre el flux de treball, ja que cada ordre requereix aprovació. La solució implica aprendre quines operacions són segures per aprovar automàticament versus aquelles que requereixen escrutini. Les edicions de fitxers al vostre directori de projecte solen ser de baix risc. Les ordres del sistema o les operacions fora del vostre projecte mereixen una inspecció més propera.

Alguns desenvolupadors configuren permisos a nivell de projecte per reduir interrupcions per a operacions de confiança.

Accedeix a Crèdits per a Emprenedors per a Eines Utilitzades amb Claude Code

Un cop Claude Code passi de la curiositat a l'ús real, els costos circumdants es tornen més visibles. Get AI Perks dóna accés a una llista curada d'ofertes per a startups en eines d'IA, serveis al núvol i productes de programari que poden donar suport al treball de desenvolupament, proves i desplegament.

Amb Get AI Perks, podeu:

• Trobar crèdits per a eines connectades a fluxos de treball de codificació
• Revisar els detalls de l'oferta abans de dedicar temps a les sol·licituds
• Identificar descomptes útils per a equips en fase inicial
• Mantenir els costos d'experimentació més manejables

Consulteu la biblioteca de Get AI Perks abans de construir la resta del vostre flux de treball Claude Code.

Fluxos de Treball Avançats i Millors Pràctiques

L'eficàcia real amb Claude Code prové del desenvolupament de fluxos de treball sistemàtics. Usuaris experimentats comparteixen patrons que maximitzen les capacitats de la eina.

El Mètode Dos-Claude

Alguns desenvolupadors utilitzen un patró de dues instàncies: executing one Claude in the desktop app for planning and another in the terminal for implementation. (Alguns desenvolupadors utilitzen un patró de dues instàncies: executionant un Claude a l'aplicació d'escriptori per a la planificació i un altre al terminal per a la implementació.)

El primer Claude, típicament a l'aplicació d'escriptori, actua com a pensador. Aquesta instància rep problemes complexos, preguntes d'arquitectura i decisions de disseny. Genera plans, considera alternatives i pensa en les implicacions sense tocar el codi.

El segon Claude, al terminal o VS Code, serveix com a executor. Rep instruccions específiques del primer Claude (o del desenvolupador) i les implementa. Aquesta separació evita que el mateix context barregi la planificació amb la implementació.

El flux de treball sembla així: descriure el problema a Claude 1, obtenir recomanacions d'aproximació, passar instruccions d'implementació específiques a Claude 2, verificar els resultats, iterar.

Estratègia de Gestió del Context

La gestió de la finestra de context separa els usuaris hàbils de Claude Code dels principiants. Això és el que funciona:

Utilitzeu /clear agressivament. Comenceu cada tasca distintiva amb una conversació nova. El cost de perdre context és menor que el cost de context contaminat.

Executeu /compact quan el context disponible cau al 20-30%. Els usuaris experimentats suggereixen que aquest llindar manté la qualitat alhora que amplia la durada de la conversa.

Passeu al mode de pla abans de la implementació per a funcions complexes. Això fa que Claude Code pensi en l'aproximació abans d'escriure codi, reduint les reescritures.

Utilitzeu comentaris i marcadors TODO estratègicament. Claude Code cerca aquests marcadors quan entén què necessita treball. Marcar errors o oportunitats de refactorització ajuda Claude Code a prioritzar.

Selecció del Model

Claude Code utilitza Opus per defecte per a les sol·licituds inicials. Opus proporciona una major capacitat però costa més tokens, mentre que Sonnet és més ràpid i econòmic amb una reducció de la capacitat.

El comportament per defecte canvia d'Opus a Sonnet al 50% d'ús per equilibrar el cost i la qualitat.

Però per a implementacions crítiques, sol·licitar explícitament Opus garanteix la màxima capacitat. Guardeu Opus per a decisions d'arquitectura, algorismes complexos o codi no familiar. Utilitzeu Sonnet per a tasques rutinàries, refactoritzacions i implementacions directes.

Flux de Treball d'Integració amb GitHub

La integració amb GitHub converteix les incidències directament en pull requests. Aquest flux de treball elimina el canvi d'eines per a cicles de desenvolupament comuns.

El procés funciona així: Claude Code llegeix una incidència de GitHub, entén els requisits, realitza els canvis de codi necessaris a través de diversos fitxers, executa proves per verificar la funcionalitat, confirma els canvis amb missatges significatius i crea una pull request amb la incidència enllaçada.

El sistema s'integra amb GitHub, GitLab i eines de línia de comandes per a l'automatització de fluxos de treball. Per als equips, això crea un flux fluid: triatge d'incidències, assignació a Claude Code, revisió de PR generades, fusió o sol·licitud de modificacions. La IA s'encarrega dels detalls d'implementació mentre els humans es concentren en el disseny i la revisió del codi.

Trets Comuns i Solucions

Fins i tot els desenvolupadors experimentats troben reptes recurrents amb Claude Code. Reconèixer aquests patrons ajuda a evitar la frustració.

El Problema de la Fatiga dels Permisos

Els prompts constants de permisos interrompen el flux i redueixen la productivitat. Això representa la queixa més comuna en les discussions de la comunitat.

La solució implica dos enfocaments. Primer, configureu permisos a nivell de projecte per a operacions comunes. Segon, agrupeu operacions: demaneu a Claude Code que prepari tots els canvis, reviseu-los junts i després aproveu l'execució en grup en lloc d'individualment.

Alguns desenvolupadors també mantenen un projecte de proves separat on concedeixen permisos més amplis per a l'experimentació sense risc.

Contaminació del Context

Quan les converses s'allarguen sense esborrar, la qualitat del context es degrada. Claude Code comença a fer suposicions basades en informació obsoleta d'abans en la conversa.

Els símptomes inclouen: suggerir solucions de tasques anteriors que no s'apliquen a l'actual, realitzar edicions en fitxers equivocats o ignorar instruccions recents.

La solució és senzilla però requereix disciplina: netejar el context entre tasques. Si Claude Code sembla confús o fa suggeriments inesperats, això indica que és hora d'utilitzar /clear.

Dependència excessiva de la generació d'IA

Alguns desenvolupadors informen que deixen que Claude Code faci massa sense entendre el codi generat. Això crea problemes de manteniment més tard quan el codi generat per IA falla o necessita modificació.

La solució implica tractar Claude Code com a programador parella en lloc de generador de codi. Reviseu tot el que produeix. Feu preguntes sobre els enfocaments que no enteneu. Demaneu a Claude Code que expliqui seccions complexes abans d'acceptar-les.

Aquest aspecte educatiu representa un benefici clau: Claude Code no només escriu codi, sinó que ensenya als desenvolupadors explicant decisions i compromisos.

Preus i Economia

Entendre el model de preus de Claude Code ajuda els equips a pressupostar eficaçment i a utilitzar la eina estratègicament.

Segons el lloc web oficial d'Anthropic, Claude Opus 4.6, utilitzat per Claude Code, té un preu de 5 dòlars per milió de tokens d'entrada i 25 dòlars per milió de tokens de sortida.

En la pràctica, aquesta estructura de preus afavoreix una enginyeria de prompts acurada. Les sol·licituds concises i específiques costen menys que els prompts vagues que requereixen múltiples iteracions.

El canvi automàtic de model d'Opus a Sonnet al 50% d'ús ajuda a controlar els costos alhora que es manté la qualitat per a la majoria de tasques. Els equips poden ajustar aquest llindar segons els seus requisits de qualitat i les restriccions pressupostàries.

Els desenvolupadors que comparteixen les seves experiències informen que un ús reflexiu —esborrar context regularment, utilitzar models apropiats per a diferents tasques i agrupar operacions relacionades— manté els costos raonables fins i tot per a un ús intensiu.

Claude Code vs Altres Eines de Codificació amb IA

Claude Code competeix amb diverses eines establertes en l'espai de codificació amb IA. Entendre les distincions ajuda els desenvolupadors a triar la eina adequada.

Comparació amb Cursor

Cursor ha estat popular a la comunitat de desenvolupadors durant més d'un any. Cursor i Claude Code difereixen en els enfocaments de disseny fonamentals.

Cursor es centra principalment en la finalització i edició de codi dins de l'IDE. Excels en suggerir la següent línia o funció mentre escriviu.

Claude Code adopta un enfocament més agentiu: gestiona fluxos de treball complets en lloc de només escriure codi. La integració amb GitHub, l'execució d'ordres del terminal i l'edició de diversos fitxers representen capacitats més enllà de l'abast de Cursor.

Alguns desenvolupadors combinen ambdues eines: Cursor per a suggeriments de codi en línia i Claude Code per a tasques a nivell de projecte.

Punts Forts de Claude Code

Claude Code utilitza la cerca agentiva per entendre l'estructura del projecte i les dependències, permetent un treball efectiu en grans bases de codi sense selecció manual de context.

L'edició de diversos fitxers permet canvis coordinats entre components. Les tasques que requereixen canvis coordinats entre components, actualitzant importacions i mantenint la coherència, es converteixen en converses senzilles en lloc d'esforços de coordinació manuals.

Claude Code s'integra amb incidències i pull requests de GitHub per a fluxos de treball optimitzats. Treballar directament amb incidències i pull requests de GitHub elimina el canvi de context.

Casos d'Ús del Món Real

Escenaris específics mostren on Claude Code proporciona el màxim valor.

Refactorització de Codi Legat

Claude Code excel·leix en la comprensió del codi existent i en la realització de millores sistemàtiques. Descriviu l'objectiu de refactorització: extreure una capa de servei, convertir components de classe a components funcionals, actualitzar crides a API obsoletes, i Claude Code s'encarrega dels canvis mecànics en tots els fitxers afectats.

La cerca agentiva troba totes les instàncies que necessiten actualització. L'edició de diversos fitxers realitza els canvis de manera consistent. Les proves verifiquen que res s'ha trencat.

Implementació de Funcions a partir d'Incidències

La integració amb GitHub brilla aquí. Apunteu Claude Code a una incidència, i llegirà els requisits, realitzarà els canvis necessaris, crearà proves i presentarà una pull request.

Els desenvolupadors revisen la PR generada. Si els canvis necessiten ajustos, sol·liciteu modificacions conversacionalment a través de Claude Code en lloc d'editar manualment.

Aprenentatge de Noves Bases de Codi

Claude Code serveix com a sistema de documentació interactiu. Feu preguntes sobre com es connecten els components, on resideix la lògica específica o per què s'utilitzen certs patrons.

Les explicacions ajuden els nous membres de l'equip a entendre les bases de codi més ràpid que llegint documentació estàtica. Claude Code també pot demostrar patrons mostrant exemples del codi existent.

Generació de Proves

Escrivir proves completes requereix temps. Claude Code pot generar suites de proves basades en el codi existent per cobrir diversos escenaris i casos límit.

Els desenvolupadors revisen les proves generades per assegurar la cobertura i modificar segons calgui. Això redueix dràsticament el temps des de l'escriptura del codi fins a tenir codi provat.

Consells d'Usuaris Avançats

Els desenvolupadors que utilitzen Claude Code àmpliament comparteixen patrons que maximitzen l'efectivitat.

1. Utilitzeu el mode de pla abans de la implementació: Premeu Shift+Tab per entrar al mode de pla per a funcions complexes. Això fa que Claude Code pensi en l'aproximació abans d'escriure codi, reduint les reescritures.
2. Marqueu el treball amb comentaris: Utilitzeu comentaris TODO, FIXME o BUG per marcar àrees que necessiten atenció. Claude Code cerca aquests marcadors quan entén què necessita treball.
3. Aprofiteu l'oportunitat d'aprenentatge: Demaneu a Claude Code que expliqui les seves decisions. Entendre per què va triar certs enfocaments fa que els desenvolupadors siguin millors en l'enginyeria de prompts i en la codificació general.
4. Manteniu un fitxer CLAUDE.md: Mantingueu actualitzat el context del projecte a mesura que evoluciona l'arquitectura. Deu minuts mantenint aquest fitxer estalvien hores de proporcionar context en converses.
5. Utilitzeu signes d'exclamació per a la persistència: Quan Claude Code no segueix les instruccions, els desenvolupadors informen que afegir signes d'exclamació ("implementa això exactament com es descriu!") augmenta el compliment.
6. Cua múltiples tasques: Claude Code pot gestionar operacions en cua. Descriviu diversos canvis relacionats, deixeu-los en cua i reviseu tots els resultats junts en lloc d'esperar entre tasques.

Preguntes Freqüents

El Futur del Desenvolupament Assistit per IA

Claude Code representa un canvi de la finalització de codi a l'execució de tasques agentives. En lloc de suggerir la següent línia, gestiona fluxos de treball complets des dels requisits fins a les pull requests.

Aquesta evolució canvia el rol del desenvolupador d'escriure cada línia a dirigir l'execució de la IA i revisar els resultats. Les habilitats que més importen es converteixen en disseny d'arquitectura, especificació de requisits, revisió de codi i pensament sistèmic en lloc de memorització de sintaxi.

Però l'expertesa humana segueix sent crítica. Claude Code excel·leix en tasques mecàniques —refactorització, generació de proves, codi boilerplate— mentre que els humans s'encarreguen de la resolució creativa de problemes, les consideracions de seguretat i les decisions arquitectòniques.

L'enfocament més efectiu combina ambdues coses: utilitzar Claude Code per allò que la IA fa bé, mantenir la supervisió humana per allò que requereix judici i experiència.

Conclusió

Claude Code transforma la manera com els desenvolupadors interactuen amb els assistents de codificació d'IA, passant de suggeriments conversacionals a l'execució de tasques agentives. La eina gestiona fluxos de treball complets —des de la lectura d'incidències de GitHub fins a la creació de pull requests— mitjançant la interacció en llenguatge natural.

Començar només triga minuts per a la instal·lació, però dominar la eina implica entendre la gestió del context, l'enginyeria de prompts i quan utilitzar IA versus codificació manual. El fitxer de configuració CLAUDE.md proporciona un context persistent del projecte que fa que cada interacció sigui més efectiva.

L'economia té sentit per als equips que l'utilitzen estratègicament: aplicant IA a tasques mecàniques mentre es reserva l'expertesa humana per a l'arquitectura i la lògica crítica. El sistema de permisos i el procés de revisió mantenen la seguretat mentre les capacitats agentives eliminen gran part del treball tedios en el desenvolupament de programari.

Llest per provar Claude Code? Visiteu el lloc web oficial d'Anthropic per començar amb la instal·lació, exploreu la documentació per a funcions avançades i uneix-te a les discussions de la comunitat per aprendre d'usuaris experimentats. La eina evoluciona activament, de manera que mantenir-se connectat amb les actualitzacions garanteix l'accés a les últimes capacitats.