Resum ràpid: Iniciar Claude Code al terminal és senzill: instal·leu-lo amb una comanda d'una línia del lloc oficial, autentiqueu-vos amb el vostre compte d'Anthropic i escriviu 'claude' per iniciar una sessió interactiva. L'eina CLI funciona a macOS, Linux i Windows, permetent als desenvolupadors crear funcions, corregir errors i automatitzar tasques mitjançant comandes en llenguatge natural directament al seu entorn de terminal.
Claude Code representa un canvi en la manera com els desenvolupadors interactuen amb l'assistència d'IA. En lloc de copiar codi entre pestanyes del navegador i editors de text, aquesta eina basada en terminal viu dins del flux de treball de desenvolupament, entenent bases de codi senceres i executant tasques complexes mitjançant comandes conversacionals.
El procés de configuració triga menys de cinc minuts per a la majoria de desenvolupadors. Però hi ha més en començar amb Claude Code de manera efectiva que només la instal·lació.
Aquesta guia cobreix tot, des de la instal·lació inicial fins a la iniciació de sessions productives, amb exemples pràctics que funcionen en projectes reals.
Què fa realment Claude Code
Segons la documentació oficial, Claude Code és una eina de codificació agent que llegeix bases de codi, edita fitxers, executa comandes i s'integra amb eines de desenvolupament. La interfície de terminal serveix com a punt d'interacció principal per a la majoria de desenvolupadors.
L'eina gestiona tasques de desenvolupament rutinàries: crear funcions, corregir errors, automatitzar fluxos de treball i explicar seccions de codi complexes. Opera amb el context complet dels fitxers del projecte, la història de git i els processos en execució.
A diferència dels assistents d'IA basats en navegador, Claude Code executa comandes directament a l'entorn de la shell. Quan se li demana que corregeixi un error de compilació, no només suggereix solucions, sinó que pot executar la correcció, provar el resultat i confirmar els canvis.
Terminal vs. Altres Plataformes
Claude Code funciona en múltiples plataformes: terminal CLI, aplicació d'escriptori, interfície web, extensions d'IDE per a VS Code i JetBrains, i una extensió de Chrome per depurar aplicacions en viu. La versió de terminal ofereix el control més directe.
Les sessions de terminal proporcionen dreceres de teclat, execució de tasques en segon pla i integració amb les configuracions de shell existents. Els desenvolupadors que viuen a la línia de comandes troben aquesta la interfície més ràpida.
| Plataforma | Millor per a | Avantatge clau |
|---|---|---|
| Terminal CLI | Desenvolupadors còmodes amb la línia de comandes | Interacció més ràpida, integració completa de la shell |
| Aplicació d'escriptori | Preferència visual amb sessions persistents | Interfície GUI, navegació més fàcil |
| Extensió VS Code | Desenvolupadors que rarament surten del seu IDE | Integració de l'editor perfecta |
| Interfície Web | Accés ràpid sense instal·lació | Funciona en qualsevol dispositiu amb navegador |
Requisits d'instal·lació
Abans d'instal·lar Claude Code, verifiqueu que el sistema compleix els requisits bàsics. L'eina s'executa a macOS, Linux i Windows (inclòs WSL2).
Es requereix un compte actiu d'Anthropic. Si no en teniu, creeu-lo al lloc web oficial d'Anthropic abans de procedir amb la instal·lació.
La terminal ha de tenir connectivitat a Internet i permís per descarregar i executar scripts. Algunes xarxes corporatives restringeixen l'execució de scripts; consulteu amb el departament d'IT si la instal·lació falla.
Sistemes Operatius Admesos
Elimineu aquesta afirmació - no es troba en materials oficials de la font. La instal·lació funciona a través de Terminal o qualsevol altre emulador de terminal com iTerm2.
Les distribucions de Linux requereixen una shell moderna (bash o zsh). La majoria de les instal·lacions recents d'Ubuntu, Debian, Fedora i Arch funcionen sense modificacions.
Els usuaris de Windows han d'instal·lar primer Windows Subsystem for Linux (WSL2). El suport natiu de Windows existeix, però WSL2 proporciona una millor compatibilitat amb les eines de desenvolupament.
Redueix els costos d'eines d'IA amb Get AI Perks quan comences
Començar amb Claude Code sovint significa provar altres eines d'IA també. Get AI Perks ajuda els fundadors a trobar crèdits per a startups i descomptes de programari en productes d'IA i núvol. La plataforma reuneix més de 200 ofertes, incloent-hi avantatges per a Claude, Anthropic, OpenAI, Gemini, ElevenLabs i més, juntament amb les condicions per a cadascuna.
Vols veure els avantatges disponibles per a eines d'IA?
Consulta Get AI Perks per:
- navegar per les ofertes de Claude i altres eines d'IA
- veure quins avantatges s'adapten 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.
Procés d'instal·lació pas a pas
El mètode d'instal·lació oficial utilitza una única comanda que detecta el sistema operatiu i instal·la la versió adequada.
Per a macOS i Linux
Obriu una finestra de terminal i executeu aquesta comanda:
| curl -fsSL claude.ai/install.sh | bash |
El script d'instal·lació descarrega el binari de Claude Code, el col·loca en una ubicació del camí del sistema i configura la integració de la shell. El procés sol completar-se en menys de 30 segons.
Si la instal·lació té èxit, la terminal mostrarà un missatge de confirmació. Proveu la instal·lació escrivint:
| claude –version |
Aquesta comanda hauria de retornar el número de versió actual. Si en canvi apareix un error dient "comanda no trobada", cal ajustar la configuració del PATH.
Per a Windows amb WSL2
Primer, assegureu-vos que WSL2 estigui instal·lat i configurat. Obriu una terminal WSL2 (es recomana Ubuntu) i executeu la mateixa comanda d'instal·lació que per a Linux:
| curl -fsSL install.claude.ai | sh |
Els problemes de xarxa específics de Windows de vegades es produeixen amb WSL2. Segons la documentació de resolució de problemes, és possible que calgui ajustar les regles del tallafocs per permetre la comunicació entre els processos de WSL2 i Windows.
Resolució de problemes d'instal·lació
El problema d'instal·lació més comú és la configuració del PATH. Quan la terminal mostra "comanda no trobada" després de la instal·lació, el binari de Claude no està al camí executable de la shell.
Comproveu la ubicació d'instal·lació amb:
| which claude |
Si això no retorna res, afegiu manualment el directori d'instal·lació al PATH. Per a bash, afegiu aquesta línia a ~/.bashrc:
| export PATH=”$HOME/.local/bin:$PATH” |
Per als usuaris de zsh, afegiu la mateixa línia a ~/.zshrc en el seu lloc. Reinicieu la terminal o executeu source ~/.bashrc per aplicar els canvis immediatament.
Els errors d'instal·lació relacionats amb la xarxa sovint es mostren com a "TLS connect error" o interrupcions de descàrrega. Aquests indiquen restriccions de tallafocs o certificats obsolets. Actualitzeu els certificats del sistema o contacteu amb els administradors de la xarxa si treballeu en una xarxa corporativa.
Autenticació i Primer Llançament
Després d'una instal·lació correcta, l'autenticació connecta la CLI local a un compte d'Anthropic. Inicieu el procés d'autenticació executant:
| claude |
El primer llançament activa automàticament l'autenticació. S'obre una finestra del navegador que mostra una pàgina d'inici de sessió. Inicieu la sessió amb les credencials del vostre compte d'Anthropic.
Un cop finalitzada l'autenticació del navegador, la sessió de terminal s'activa. Un missatge de benvinguda confirma la connexió i mostra instruccions bàsiques d'ús.
Gestió de Sessions
Cada vegada que s'executa claude en una terminal, s'inicia una nova sessió. Les sessions persisteixen fins que s'acaben explícitament amb Ctrl+D o escrivint exit.
El testimoni d'autenticació s'emmagatzema localment, de manera que els llançaments posteriors no requereixen iniciar sessió al navegador. El testimoni roman vàlid fins que no es revoqui manualment a través de la configuració del compte al lloc web d'Anthropic.
Iniciar el Mode Interactiu
El mode interactiu representa la forma principal en què els desenvolupadors utilitzen Claude Code. Inicieu-lo escrivint claude sense arguments addicionals.
La terminal canvia a un prompt interactiu on les comandes en llenguatge natural dirigeixen la IA. Aquest mode manté el context de la conversa, recorda les peticions anteriors i pot executar fluxos de treball de múltiples passos.
Comandes Interactives Essencials
Diverses comandes integrades controlen el comportament de la sessió.
Escriviu-les al prompt de Claude Code:
- /model – Canvieu entre diferents models de Claude (Opus, Sonnet)
- /status – Vegeu el model actual, l'identificador de sessió i la configuració
- /btw – Feu preguntes laterals sense canviar el context de la tasca
- ? – Mostra les drecere de teclat i la informació d'ajuda
Les drecere de teclat milloren la productivitat. Premeu Ctrl+L per netejar la pantalla de la terminal sense finalitzar la sessió. Utilitzeu Ctrl+C per cancel·lar una generació en curs. Ctrl+F mata totes les tasques en segon pla (premeu dues vegades per confirmar).
La línia d'estat a la part inferior mostra els processos actius en segon pla, el model actual i l'ús de testimoni. Aquesta informació ajuda a monitoritzar el consum de recursos durant tasques complexes.
Execució de Tasques en Segon Pla
Claude Code pot executar operacions de llarga durada en segon pla mentre roman responent a noves comandes. Les tasques en segon pla mostren indicadors de progrés i es completen de forma asíncrona.
Quan s'executen múltiples operacions simultàniament, la llista de tasques en fa un seguiment de cadascuna. Premeu Ctrl+F per veure i gestionar els processos en segon pla.
Executar Comandes Úniques
No totes les tasques necessiten una sessió interactiva. Per a operacions ràpides, Claude Code accepta comandes directament com a arguments:
| claude “explica la lògica d’autenticació a src/auth.js” |
Aquesta comanda inicia Claude Code, processa la petició, mostra la sortida i surt immediatament. No s'inicia cap sessió interactiva.
Les comandes úniques funcionen bé per a scripting i automatització. Es poden incorporar a hooks de git, pipelines de CI/CD o scripts de shell que necessiten assistència d'IA per a sub-tasques específiques.
Mode només de consulta
L'indicador -p executa el mode només de consulta, que respon preguntes sense fer canvis de fitxer:
| claude -p “quines dependències utilitza aquest projecte?” |
Aquest mode llegeix els fitxers del projecte però no edita, crea ni elimina res. Proporciona només informació, fent-lo segur per a l'exploració sense risc de modificacions no desitjades.
Selecció i Configuració de Models
Claude Code admet múltiples models d'IA amb diferents capacitats i característiques de velocitat. Segons la documentació oficial, els models admesos inclouen Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5 i Sonnet 4.5.
Canvieu el model actiu utilitzant la comanda /model durant una sessió interactiva. Un menú interactiu enumera les opcions disponibles amb breus descripcions dels punts forts de cada model.
Per a una preferència de model permanent, establiu una variable d'entorn abans d'iniciar Claude Code:
| export ANTHROPIC_MODEL=”claude-opus-4-6″ claude |
Aquesta configuració persisteix entre sessions fins que la variable canvia o s'elimina.
Configuració del Mode Ràpid
El mode ràpid prioritza la velocitat de resposta sobre l'anàlisi exhaustiva. És útil per a iteracions ràpides i tasques senzilles on l'anàlisi de context complet no és necessària.
Habiliteu el mode ràpid mitjançant la configuració de les preferències o utilitzant variants de model optimitzades per a la velocitat. Consulteu la documentació oficial per a les opcions actuals del mode ràpid, ja que evolucionen amb les noves versions de models.
Treballar amb Projectes
Claude Code entén l'estructura del projecte analitzant fitxers al directori actual i als seus subdirectoris. Navegueu fins a un directori de projecte abans d'iniciar:
| cd /path/to/your/project claude |
L'eina llegeix automàticament els fitxers del projecte, entén l'estructura de la base de codi i reconeix patrons comuns com gestors de paquets, configuracions de frameworks i eines de compilació.
Excloure Fitxers Sensibles
Alguns fitxers no s'han d'analitzar ni modificar amb eines d'IA: credencials, claus d'API, fitxers binaris grans o contingut generat. Creeu un fitxer .claudeignore a laarrel del projecte per excloure camins específics:
| .env .env.local node_modules/ dist/ build/ *.log |
Això funciona de manera similar a la sintaxi de .gitignore. Els fitxers exclosos romanen invisibles per a Claude Code tant durant l'anàlisi com durant l'execució.
Consells de Configuració de Terminal
Claude Code funciona millor amb certes configuracions de terminal. La majoria dels problemes provenen de configuracions de shell incompatibles o funcions que falten.
Integració de la Shell
Suavitza: Algunes terminals modernes admeten funcions d'integració de shell opcionals com la detecció de prompts mitjançant seqüències OSC 133, tot i que no són necessàries
Per a una compatibilitat òptima, utilitzeu versions recents d'emuladors de terminal populars: iTerm2 a macOS, Alacritty, Kitty o WezTerm a Linux. Windows Terminal funciona bé amb WSL2.
Personalització de Drecere de Teclat
Les drecere de teclat per defecte poden entrar en conflicte amb les combinacions de tecles de terminal o shell existents. Personalitzeu-les a través del fitxer de configuració de preferències situat a ~/.claude/settings.json.
El fitxer de preferències utilitza format JSON i admet la reassignació de qualsevol comanda integrada a combinacions de tecles diferents. Després d'editar, reinicieu Claude Code perquè els canvis tinguin efecte.
Fluxos de Treball Comuns de la Primera Sessió
Parlem clar: la primera sessió de Claude Code sovint implica experimentació. Aquí teniu punts de partida pràctics que demostren les capacitats principals.
Explorar la Base de Codi
Comenceu demanant a Claude Code que expliqui l'estructura del projecte:
“Dona'm una visió general d'aquesta base de codi. Quins són els components principals i com interactuen?”
Aquesta petició no modifica res, només analitza i explica. La resposta ajuda a verificar que Claude Code entén correctament l'organització del projecte.
Fer un Canvi Simple
Proveu una modificació de baix risc per veure l'edició de fitxers en acció:
“Afegiu un comentari a la part superior de README.md explicant què fa aquest projecte”
Claude Code llegeix el fitxer, genera el contingut adequat i realitza l'edició. Reviseu el canvi amb git diff per veure exactament què ha passat.
Corregir un Problema Existnt
Si el projecte té errors coneguts o elements TODO, demaneu a Claude Code que els abordi:
“Corregeix el bug de validació d'inici de sessió descrit a l'issue #42”
L'eina llegeix els fitxers de codi font rellevants, identifica el problema, implementa una correcció i fins i tot pot executar proves per verificar que la solució funciona.
Permisos i Seguretat
Claude Code demana permís abans d'executar operacions potencialment arriscades. El sistema de permisos classifica les comandes per nivell d'impacte.
Les lectures de fitxers es fan sense sol·licituds de permís: llegir codi sempre és segur. Les escriptures, eliminacions de fitxers i l'execució de comandes de shell requereixen aprovació explícita la primera vegada que ocorren.
Les eleccions de permís es poden desar per a la sessió o permanentment. Els permisos permanents s'emmagatzemen en fitxers de configuració i s'apliquen a totes les sessions futures.
Configuració de Sandboxing
Segons la documentació oficial de preferències, el sandboxing restringeix on Claude Code pot fer canvis. Configureu prefixos de camí de sandbox per limitar l'accés al sistema de fitxers a directoris específics.
Aquesta capa de seguretat evita modificacions accidentals de fitxers del sistema o directoris fora de l'àmbit del projecte. Els equips que treballen en bases de codi sensibles haurien de configurar el sandboxing abans del desplegament.
| Tipus de Permís | Comportament per defecte | Recomanat per a |
|---|---|---|
| Llegir Fitxer | Sempre permès | Tots els casos d'ús |
| Escriure/Editar Fitxer | Preguntar la primera vegada | Desenvolupament actiu |
| Eliminar Fitxer | Preguntar cada vegada | Només usuaris experimentats |
| Comandes de Shell | Preguntar amb previsualització | Fluxos de treball automatitzats |
| Accés a la Xarxa | Preguntar la primera vegada | Treball d'integració d'API |
Preguntes Freqüents
Claude Code funciona fora de línia després de la instal·lació?
No. Claude Code requereix connectivitat a Internet per a totes les operacions perquè els models d'IA s'executen als servidors d'Anthropic. El client de terminal envia peticions a l'API i rep respostes. Sense connexió, l'eina no pot funcionar.
Quant costa executar Claude Code?
El preu depèn del pla del compte d'Anthropic i del volum d'ús. Consulteu el lloc web oficial d'Anthropic per conèixer els detalls actuals dels preus, ja que els plans i les tarifes canvien amb el temps. El consum de testimoni varia segons la mida de la base de codi i la complexitat de la petició.
Claude Code pot accedir a fitxers fora del directori actual?
Per defecte, sí. Claude Code pot accedir a qualsevol fitxer que el compte d'usuari tingui permís per llegir. No obstant això, la configuració de sandboxing restringeix l'accés a directoris especificats. Per a entorns amb requisits de seguretat sensibles, configureu les preferències de sandbox abans del primer ús.
Què passa si Claude Code comet un error?
Tots els canvis de fitxer són visibles mitjançant els comandaments estàndard de git diff. Abans de confirmar qualsevol modificació de Claude Code, reviseu els canvis acuradament. Com que tot passa en un repositori git (recomanat), revertir errors és senzill amb els comandaments git.
Es poden executar múltiples sessions de Claude Code simultàniament?
Sí. Cada finestra de terminal pot executar una sessió independent de Claude Code. Les sessions no interfereixen entre elles, tot i que les modificacions simultànies al mateix fitxer des de sessions diferents podrien causar conflictes.
Com aturo una tasca de Claude Code en curs?
Premeu Ctrl+C per cancel·lar l'operació actual. Per a tasques en segon pla, premeu Ctrl+F per obrir el gestor de tasques, i després confirmeu la cancel·lació. La sessió roman activa després de cancel·lar, només s'atura la tasca específica.
Claude Code recorda converses anteriors?
Dins d'una mateixa sessió, sí. Claude Code manté el context de la conversa i recorda les peticions i canvis anteriors. Iniciar una nova sessió (tancar i tornar a obrir) esborra aquest context. Per a coneixements persistents del projecte, utilitzeu les funcions d'instruccions i memòries documentades a les guies oficials.
Passos Següents Després de la Instal·lació
Un cop Claude Code s'executa correctament, exploreu les seves capacitats ampliades. La documentació oficial cobreix temes avançats com subagents personalitzats, desenvolupament de plugins i automatització de tasques programades.
Les habilitats proporcionen una manera d'estendre Claude Code amb comandes i fluxos de treball específics del projecte. Crear habilitats al directori .claude/skills/ afegeix capacitats personalitzades adaptades a necessitats de desenvolupament específiques.
La integració del Protocol de Context del Model (MCP) permet a Claude Code interactuar amb eines i serveis externs. Això obre possibilitats per a consultes a bases de dades, proves d'API i gestió d'infraestructures a través de la mateixa interfície conversacional.
Les funcions de Control Remot permeten continuar sessions entre dispositius. Comenceu a treballar en una màquina d'escriptori, i després continueu la mateixa sessió en un portàtil o dispositiu mòbil. Consulteu la documentació d'integracions de plataforma per obtenir instruccions de configuració.
Obtenir Ajuda Quan Esteu Aturats
La documentació oficial de resolució de problemes aborda la majoria dels problemes comuns. Quan sorgeixin problemes, consulteu-la primer abans d'aprofundir en la configuració del sistema.
Les discussions de la comunitat en plataformes com Reddit proporcionen solucions del món real d'altres desenvolupadors. Molts usuaris comparteixen les seves ajustades de configuració i optimitzacions de fluxos de treball en aquests fòrums.
Per a problemes d'instal·lació o autenticació, verifiqueu l'estat del compte al lloc web d'Anthropic. Subscripcions expirades o restriccions del compte impedeixen una connexió correcta fins i tot amb una configuració local correcta.
Els problemes específics de la terminal sovint estan relacionats amb la configuració de la shell o la compatibilitat. Provar amb una configuració de terminal per defecte (sense personalitzacions de shell personalitzades) ajuda a aïllar si el problema prové de modificacions locals.
Conclusió
Iniciar Claude Code al terminal triga només uns minuts un cop la instal·lació es completa. La combinació de comandes en llenguatge natural i la integració directa amb la base de codi crea un flux de treball de desenvolupament que gestiona tant consultes senzilles com refactoritzacions complexes de múltiples fitxers.
La interfície de terminal manté els desenvolupadors al seu entorn preferit sense canvis de context a pestanyes del navegador o aplicacions separades. L'execució de tasques en segon pla significa que les operacions de llarga durada no bloquegen altres treballs.
Com amb qualsevol eina de desenvolupament, la competència s'aconsegueix amb la pràctica. Comenceu amb consultes senzilles de només lectura per entendre com Claude Code interpreta l'estructura del projecte. Aneu augmentant cap a edicions de fitxers i fluxos de treball automatitzats a mesura que augmenta la confiança. El sistema de permisos impedeix errors irreversibles durant la fase d'aprenentatge.
Preparat per transformar el teu flux de treball de codificació? Instal·la Claude Code avui mateix i experimenta el desenvolupament assistit per IA directament al teu terminal.
