Com Començar amb Claude Code (Guia de Configuració 2026)

Resum Ràpid: Claude Code és l'assistent de codi IA basat en terminal d'Anthropic que requereix instal·lació a través de gestors de paquets com npm o Homebrew, seguit d'una autenticació amb una clau API d'Anthropic. Després de la configuració, els desenvolupadors poden utilitzar ordres en llenguatge natural per executar tasques de codificació, des de la depuració i refactorització fins a fluxos de treball git i edicions de fitxers múltiples. L'eina s'integra directament amb projectes existents i admet personalització mitjançant hooks, plugins i fitxers de configuració.

Claude Code és una eina de codificació agentiva construïda per Anthropic que resideix directament a la terminal. No és una extensió d'IDE ni una interfície al núvol; és un assistent de línia de comandes que entén bases de codi, executa tasques rutinàries i gestiona tot, des de la depuració fins als fluxos de treball git, a través del llenguatge natural.

A diferència dels assistents de codificació tradicionals, Claude Code opera de manera autònoma. Pot llegir fitxers, executar ordres i fer edicions de fitxers múltiples amb una mínima intervenció humana. La qualitat del seu resultat depèn totalment d'una configuració adequada i de la gestió del context.

Aquesta guia cobreix tot, des de la instal·lació fins als primers fluxos de treball. Sense distraccions, només els passos pràctics que realment importen.

Requisits del sistema i prerequisites

Abans de començar el procés d'instal·lació, verifica que el sistema compleix els requisits bàsics. Claude Code funciona en macOS, Linux i Windows 10/11 a través de WSL2.

Això és el que es necessita:

• Eliminar aquest requisit o suavitzar-lo a "Node.js pot ser necessari per a certs mètodes d'instal·lació" - el material font no especifica Node.js 18 com a requisit del sistema
• Git instal·lat i configurat
• Accés a la terminal amb permisos de shell
• Connexió a Internet estable per a trucades API
• Un compte d'Anthropic amb accés a API

Per als usuaris de Windows específicament, Claude Code no pot executar-se de forma nativa a Windows. L'eina requereix Windows Subsystem for Linux 2 (WSL2) per crear un entorn Linux on Claude Code funcioni eficaçment. Windows 10 Versió 1903 o posterior (Build 18362+) és necessari per a la instal·lació de WSL2.

La mida total de la descàrrega durant la configuració sol ser inferior a 1 GB, incloent WSL2 a Windows (aproximadament 500 MB), Node.js (uns 30 MB) i Claude Code amb dependències (al voltant de 50 MB).

Troba crèdits d'eines d'IA abans de començar

Començar amb Claude Code sovint significa triar altres eines d'IA al seu voltant. Get AI Perks ajuda amb això recopilant crèdits d'inici i descomptes de programari per a eines d'IA i al núvol en un sol lloc. La plataforma inclou més de 200 avantatges, amb ofertes de Claude, Anthropic, OpenAI, Gemini, ElevenLabs, Intercom i altres, juntament amb les condicions i els passos per reclamar-les.

Busques crèdits d'IA abans d'aplicar?

Consulta Get AI Perks per:

• explorar ofertes de Claude i altres eines d'IA
• veure quins avantatges s'ajusten a la teva empresa
• seguir guies per reclamar els crèdits disponibles

👉 Visita Get AI Perks per comparar els avantatges de programari d'IA disponibles.

Instal·lant Claude Code

El procés d'instal·lació varia lleugerament segons el sistema operatiu, però segueix el mateix patró general.

Instal·lació a macOS i Linux

Per als usuaris de macOS amb Homebrew instal·lat, el procés és senzill:

Sense Homebrew, utilitza npm:

Els usuaris de Linux poden seguir el mateix enfocament npm. El flag d'instal·lació global (-g) assegura que Claude Code estigui disponible a tot el sistema en lloc de ser específic del projecte.

Instal·lació a Windows a través de WSL2

La instal·lació de Windows requereix primer la configuració de WSL2. Obre PowerShell com a Administrador i executa:

Aquesta ordre instal·la WSL2 juntament amb Ubuntu per defecte. Després de completar la instal·lació, reinicia el sistema. En reiniciar, Ubuntu es llança automàticament per completar la configuració amb la creació d'un nom d'usuari i una contrasenya.

Dins de l'entorn Linux de WSL2, instal·la Node.js:

A continuació, instal·la Claude Code utilitzant npm tal com es mostra a dalt.

Verifica la instal·lació executant:

L'ordre hauria de retornar el número de versió actual. Si no és així, potser el camí d'instal·lació no es troba a la variable PATH del sistema.

Autenticació i configuració del compte

Claude Code requereix autenticació amb una clau API d'Anthropic abans que pugui funcionar.

Obtenció d'una clau API

Navega a la Consola d'Anthropic a console.anthropic.com i crea un compte o inicia sessió. A la secció d'API, genera una nova clau API. Copia aquesta clau immediatament; no es tornarà a mostrar després de sortir de la pàgina.

L'accés a API funciona amb un model de pagament per ús. Segons la documentació oficial, els preus funcionen amb un model per token amb diferents tarifes per a diferents models de Claude. Mantenir com a està: verificat al material de la font oficial que indica "Compra mínima: 5 dòlars" i "Recomanat: 20-30 dòlars per a proves i projectes inicials"

Connexió de Claude Code a l'API

Executa Claude Code per primera vegada en qualsevol directori de projecte:

L'eina demana autenticació. Obre una finestra del navegador per iniciar sessió o proporciona una URL per enganxar manualment. Després d'autenticar-se a través del navegador, Claude Code rep autorització i emmagatzema les credencials localment.

El procés d'autenticació crea fitxers de configuració a la carpeta d'inici. Aquests fitxers persisteixen entre sessions, de manera que l'autenticació només es produeix una vegada, a menys que les credencials es revoquin manualment.

Per verificar que tot funciona correctament, executa:

Aquesta ordre de diagnòstic comprova problemes comuns de configuració, connectivitat API i problemes de permisos.

Executant la teva primera sessió de Claude Code

Amb l'autenticació completada, Claude Code està preparat per al treball real.

Iniciant el mode interactiu

Navega a qualsevol directori de projecte i executa:

Això inicia el mode interactiu: una sessió persistent on Claude Code manté el context a través de múltiples ordres i edicions de fitxers. La terminal mostra un prompt indicant que Claude Code està actiu i esperant instruccions.

Patrons d'ordres bàsiques

Claude Code accepta tres formats d'ordres principals:

El mode interactiu és molt útil per a fluxos de treball complexos que impliquen múltiples passos. Les tasques úniques funcionen bé per a correccions ràpides o scripts automatitzats. El mode de consulta (flag -p) proporciona informació sense modificacions de fitxers.

Fent el teu primer canvi de codi

En mode interactiu, prova una tasca senzilla:

Claude Code analitza el fitxer, identifica la funció principal i proposa canvis amb blocs try-catch adequats o lògica de comprovació d'errors. Abans d'aplicar els canvis, mostra una previsualització del diff.

L'eina demana confirmació abans de modificar fitxers. Revisa els canvis proposats acuradament. Aprova escrivint "sí" o rebutja amb "no" per sol·licitar modificacions.

Fluxos de treball essencials i tasques comunes

Claude Code gestiona una àmplia gamma de fluxos de treball de desenvolupament més enllà de les edicions de codi bàsiques.

Integració Git

Claude Code entén els fluxos de treball git de forma nativa. Ordres com aquestes funcionen de manera natural:

• "Crea una nova branca per a la funcionalitat d'inici de sessió"
• "Commite aquests canvis amb un missatge descriptiu"
• "Mostra'm què ha canviat des del darrer commit"
• "Fusiona la branca de funcionalitat i resol conflictes"

L'eina pot llegir l'historial git, entendre les estructures de branques i generar missatges de commit adequats basats en els canvis de codi.

Depuració i resolució de problemes

Quan apareixen errors, Claude Code pot investigar i proposar solucions:

• "Depura per què la trucada API està fallant"
• "Troba la font d'aquesta excepció de punter nul"
• "Per què aquesta funció no retorna el valor esperat"

Claude Code examina els missatges d'error, rastreja els camins d'execució i comprova fitxers relacionats per identificar les causes arrel.

Refactorització de codi

La refactorització a gran escala es torna manejable amb la consciència de múltiples fitxers:

• "Extreu aquesta lògica en un mòdul utilitari separat"
• "Refactoritza aquesta classe per utilitzar composició en lloc d'herència"
• "Actualitza totes les importacions després de moure aquest fitxer"

L'eina fa un seguiment de les dependències entre fitxers i actualitza les referències automàticament.

Suport de proves

Claude Code pot generar proves, executar conjunts de proves i interpretar fallades:

• "Escriu proves unitàries per al mòdul d'autenticació"
• "Executa el conjunt de proves i explica qualsevol fallada"
• "Afegeix proves de casos extrems per a la funció de validació"

La generació de proves segueix les convencions del projecte i els patrons del marc de proves ja en ús.

Gestió del context i configuració

L'efectivitat de Claude Code depèn molt del context proporcionat sobre el projecte.

L'estàndard AGENTS.md

La manera més eficaç de proporcionar context persistent és a través d'un fitxer AGENTS.md a la arrel del projecte. Aquest fitxer serveix com a estàndard universal per instruir agents de codi d'IA sobre l'estructura del projecte, les convencions i els requisits.

Un AGENTS.md bàsic podria incloure:

• Visió general i arquitectura del projecte
• Convencions de codificació i preferències d'estil
• Requisits i patrons de proves
• Processos de compilació i desplegament
• Estructura d'organització de fitxers

Claude Code llegeix i incorpora automàticament el contingut d'AGENTS.md quan inicia sessions en aquest directori.

Hooks per a l'automatització

Els hooks permeten l'execució automàtica d'ordres de shell quan es produeixen esdeveniments específics. Segons la documentació oficial, Claude Code admet múltiples esdeveniments de hook incloent SessionStart, UserPromptSubmit, PreToolUse, PostToolUse i Notification.

Els hooks es configuren en un fitxer JSON que especifica quines ordres s'executen per a quins esdeveniments. Per exemple, un hook PostToolUse podria executar automàticament proves després que Claude Code modifiqui fitxers, o formatar codi segons els estàndards del projecte.

El temps d'espera predeterminat per als hooks és de 10 minuts, encara que això és configurable per hook. Els hooks poden executar-se de manera síncrona (bloquejant Claude Code fins a la finalització) o asíncrona (executant-se en segon pla).

Regles de Cursor i formats alternatius

Per a projectes que utilitzen Cursor o altres eines de codificació d'IA juntament amb Claude Code, el format de fitxer .cursorrules proporciona una alternativa a AGENTS.md. Tot i que AGENTS.md és l'estàndard universal, les regles de Cursor ofereixen una integració més estreta amb les funcions específiques de Cursor.

Els projectes poden mantenir tots dos fitxers. Claude Code prioritza AGENTS.md però respecta altres formats de configuració quan estan presents.

Consells pràctics per a un ús eficaç

L'ús en el món real revela patrons que milloren significativament l'efectivitat de Claude Code.

Sigues específic amb les instruccions

Les ordres vagues produeixen resultats vagues. En lloc de "millora aquest codi", especifica què significa millora: "refactoritza aquesta funció per reduir la complexitat ciclòmatica" o "optimilitza aquesta consulta a la base de dades per reduir el temps d'execució".

Utilitza el context del projecte lliurement

Referencia fitxers, funcions o patrons específics quan donis instruccions. Claude Code entén el context com "segons el patró de UserController" o "coincidint amb l'estil dels nostres gestors d'API existents".

Revisa els canvis abans d'acceptar-los

Claude Code és potent però no infal·lible. Sempre revisa els canvis proposats a la previsualització del diff. Busca efectes secundaris no desitjats, especialment en operacions de refactorització que toquen múltiples fitxers.

Aprofita les xarxes de seguretat de Git

Commite el codi funcional abans d'operacions importants de Claude Code. Si els canvis van malament, git proporciona una ruta de retorn fàcil. Aquesta xarxa de seguretat fomenta l'experimentació amb tasques més ambicioses.

Comença sessions amb objectius clars

Començar una sessió amb objectius explícits ajuda Claude Code a mantenir el focus. "Estem afegint autenticació d'usuari" o "Estem depurant el flux de processament de pagaments" estableix el context per a les ordres posteriors.

Problemes comuns i resolució de problemes

Malgrat la configuració adequada, ocasionalment sorgeixen problemes.

Errors de permisos

Mai executis Claude Code amb sudo o permisos elevats. Això crea vulnerabilitats de seguretat i problemes de propietat de fitxers. Si es produeixen errors de permisos, comprova els permisos dels fitxers al directori del projecte i assegura't que l'usuari actual té l'accés adequat.

Problemes de connexió API

Els errors de connexió normalment indiquen problemes de xarxa o credencials API invàlides. Verifica la validesa de la clau API a través de la Consola d'Anthropic. Comprova que els tallafocs o les VPN no estiguin bloquejant les sol·licituds API.

Comportament inesperat a Windows WSL2

Els problemes de camí sorgeixen habitualment quan es barregen camins de Windows i Linux a WSL2. Mantén els projectes dins del sistema de fitxers Linux (/home/usuari/) en lloc d'accedir a unitats de Windows (/mnt/c/). Això millora el rendiment i evita problemes de traducció de camins.

Pèrdua de context durant sessions llargues

Les sessions prolongades poden assolir límits de context, fent que Claude Code perdi el rastre de converses anteriors. Quan això succeeixi, inicia una nova sessió o proporciona recordatoris explícits sobre els objectius del projecte i els canvis recents.

Funcions avançades que val la pena explorar

Després de dominar els conceptes bàsics, diverses funcions avançades desbloquegen capacitats addicionals.

Ordres personalitzades

Els projectes poden definir ordres personalitzades en un directori .claude/commands. Aquestes ordres estenen Claude Code amb fluxos de treball específics del projecte, com ara "@deploy.md staging" o "@benchmark.md performance".

Les ordres s'escriuen en markdown amb una sintaxi especial per a arguments i injecció de context. L'habilitat de desenvolupament d'ordres als plugins oficials de Claude Code proporciona plantilles i exemples.

Equips d'agents

Per a operacions complexes, Claude Code pot coordinar múltiples agents especialitzats treballant junts. Un agent podria gestionar canvis al backend mentre un altre actualitza components del frontend i un tercer gestiona migracions de bases de dades.

Els equips d'agents requereixen configuració, però permeten el treball paral·lel en grans funcionalitats o projectes de refactorització.

Preguntes freqüents

Avançant amb Claude Code

Començar amb Claude Code implica una instal·lació senzilla, autenticació i aprenentatge de patrons d'ordres bàsics. El veritable poder de l'eina emergeix a través d'un ús constant i una gestió adequada del context.

Comença amb tasques senzilles: correccions d'errors, actualitzacions de documentació o refactoritzacions d'un sol fitxer. A mesura que guanyes confiança, aborda fluxos de treball més ambiciosos com la implementació de funcionalitats o canvis arquitectònics. La corba d'aprenentatge és suau perquè les ordres en llenguatge natural redueixen la memorització de sintaxi.

Configura fitxers AGENTS.md per als projectes utilitzats amb freqüència. Aquesta inversió dóna fruits a través d'una millor comprensió de Claude Code i suggeriments més rellevants.

El més important és tractar Claude Code com una eina col·laborativa en lloc d'un reemplaçament del judici del desenvolupador. Revisa les seves suggerències críticament, proporciona instruccions clares i manté xarxes de seguretat de git. Utilitzat correctament, Claude Code accelera el desenvolupament sense sacrificar la qualitat del codi.

Llest per transformar el teu flux de treball de terminal? Instal·la Claude Code avui mateix i experimenta el desenvolupament assistit per IA que realment s'integra amb la manera com treballen els desenvolupadors. Visita la documentació oficial a docs.anthropic.com per obtenir materials de referència detallats i opcions de configuració avançades.