Resum ràpid: Claude Code CLI s'instal·la mitjançant una única comanda que descarrega i configura l'eina automàticament. A macOS i Linux, utilitzeu l'script de shell oficial de la documentació d'Anthropic, mentre que els usuaris de Windows executen comandes de PowerShell o WSL. Després de la instal·lació, autentiqueu-vos amb la vostra clau API per començar a utilitzar l'assistent de codificació d'IA de Claude al vostre terminal.
Claude Code és una eina de codificació agent que viu al vostre terminal i entén tot el vostre codebase. Segons la documentació oficial de Claude Code, pot llegir fitxers, executar comandes, editar codi i integrar-se amb eines de desenvolupament mitjançant converses en llenguatge natural.
Però començar requereix una instal·lació adequada. Aquí teniu tot el necessari per instal·lar Claude Code CLI i configurar-lo correctament.
Requisits del sistema abans de la instal·lació
Abans d'instal·lar Claude Code, verifiqueu que el sistema compleix els requisits bàsics. Segons la documentació oficial de configuració avançada, elimineu aquesta frase completament.
Comproveu la instal·lació de Node.js obrint un terminal i executant:
| node –version |
Si Node.js no està instal·lat o la versió és inferior a 18, descarregueu-lo del lloc web oficial de Node.js. La versió de Suport a llarg termini (LTS) funciona perfectament per a Claude Code.
Més enllà de Node.js, el sistema necessita requisits bàsics: macOS 13.0 o superior per als usuaris de Mac, Windows 10 o superior per als sistemes Windows i la majoria de distribucions Linux modernes funcionen sense problemes. També es requereix un compte de Claude d'Anthropic per a l'autenticació després de la instal·lació.
Instal·lació de Claude Code a macOS i Linux
El procés d'instal·lació per a macOS i Linux utilitza una única comanda de shell que gestiona tot automàticament. Aquest mètode està documentat a la guia oficial d'inici ràpid de Claude Code.
Obriu el Terminal i executeu l'script d'instal·lació:
| curl -fsSL claude.ai/install.sh | bash |
L'script descarrega el binari de Claude Code, el col·loca al directori correcte i configura automàticament la variable PATH. Tot el procés normalment es completa en menys d'un minut.
Per als usuaris de macOS que prefereixen Homebrew, existeix un mètode d'instal·lació alternatiu, encara que no estigui documentat oficialment a les fonts principals. El mètode curl continua sent l'aproximació recomanada segons la documentació oficial.
Verificació de la instal·lació
Un cop finalitzada la instal·lació, verifiqueu que Claude Code sigui accessible:
| claude –version |
Aquesta comanda hauria de mostrar el número de versió instal·lat. Si apareix un error dient "command not found", la configuració del PATH necessita ajustos.
Segons la documentació oficial de resolució de problemes, els problemes de PATH són el problema d'instal·lació més comú. La solució implica afegir el directori d'instal·lació de Claude al fitxer de configuració del shell.
Instal·lació de Claude Code a macOS i Linux
El procés d'instal·lació per a macOS i Linux depèn de npm (Node Package Manager). Segons la documentació oficial, heu de tenir Node.js 18+ instal·lat al vostre sistema abans de continuar. A diferència de les eines CLI tradicionals que utilitzen scripts de shell, Claude Code s'instal·la globalment a través del vostre terminal per garantir que totes les dependències es gestionen correctament.
Obriu el vostre Terminal i executeu la següent comanda per instal·lar el paquet:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Nota: Actualment, la variable d'entorn CLAUDE_CODE_RELEASE_ALPHA=1 és necessària durant la fase beta/alfa pública per reconèixer l'estat de previsualització de l'eina.
Aquesta comanda descarrega el paquet del registre oficial de npm i vincula l'executable `claude` al directori global de binaris del vostre sistema. Encara que alguns usuaris puguin intentar trobar fórmules de Homebrew, el mètode npm és l'únic camí d'instal·lació oficialment suportat i documentat.
Verificació de la instal·lació
Un cop finalitzada la instal·lació, verifiqueu que la CLI estigui correctament mapejada al vostre entorn executant:
| claude –version |
Aquesta comanda hauria de mostrar el número de versió actual (per exemple, 0.2.9). Si trobeu un error de "command not found", normalment significa que el vostre directori global de npm no es troba al PATH del vostre sistema.
Segons la documentació oficial de resolució de problemes, podeu solucionar-ho identificant el vostre prefix npm amb `npm config get prefix` i assegurant-vos que la carpeta `/bin` resultant s'afegeix al vostre fitxer `.zshrc` o `.bashrc`.
Instal·lació de Claude Code a Windows
La instal·lació a Windows ofereix dos enfocaments principals: instal·lació nativa de PowerShell o ús del Subsistema de Windows per a Linux (WSL). La documentació oficial recomana PowerShell per a la majoria d'usuaris.
Mètode d'instal·lació amb PowerShell
Obriu PowerShell com a Administrador (feu clic dret al menú Inici i seleccioneu "Windows PowerShell (Admin)"). Executeu aquesta comanda:
| irm claude.ai/install.ps1 | iex |
L'script de PowerShell s'encarrega automàticament de la descàrrega, la instal·lació i la configuració del PATH. Després de completar-ho, tanqueu i torneu a obrir PowerShell per assegurar-vos que els canvis del PATH tinguin efecte.
Mètode d'instal·lació amb WSL
Els desenvolupadors que ja utilitzen WSL poden instal·lar Claude Code utilitzant el mètode per a Linux. Obriu el terminal WSL i executeu la mateixa comanda `curl` que s'utilitza per a Linux:
| curl -fsSL claude.ai/install.sh | bash |
L'aproximació WSL funciona idènticament a les instal·lacions natives de Linux. Un avantatge: WSL proporciona un entorn més semblant a Unix que coincideix amb les configuracions dels servidors de producció.
Segons la documentació oficial de resolució de problemes, els usuaris de WSL ocasionalment troben problemes de connectivitat de xarxa. Si la instal·lació es penja, verifiqueu que WSL pugui accedir a les xarxes externes i que les regles del tallafoc no bloquegin el trànsit.
Troba crèdits de Claude i eines d'IA en un sol lloc
Instal·lar Claude Code CLI és un pas. Pagar per eines d'IA a llarg termini és un altre. Get AI Perks recopila crèdits per a startups i descomptes de programari per a eines d'IA i cloud en un sol lloc. Ofereix als fundadors accés a més de 200 avantatges, incloses ofertes d'Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom i altres. La plataforma també mostra les condicions dels avantatges i guies per sol·licitar cada oferta.
Busques crèdits de Claude o Anthropic?
Consulta Get AI Perks per:
- trobar crèdits i descomptes per a eines d'IA en un sol lloc
- revisar les condicions dels avantatges abans de sol·licitar-los
- accedir a guies per sol·licitar ofertes per a startups
👉 Visita Get AI Perks per veure els avantatges disponibles de Claude, Anthropic i altres programaris d'IA.
Autenticació i configuració inicial
Després de la instal·lació, Claude Code requereix autenticació abans de poder funcionar. L'eina utilitza claus API d'Anthropic per verificar l'accés.
Inicieu el procés d'autenticació executant:
| claude |
La primera vegada que s'executa aquesta comanda, Claude Code demana autenticació. Segons la guia oficial d'inici ràpid, això obre una finestra del navegador per iniciar sessió al compte d'Anthropic.
Després d'iniciar sessió a través del navegador, la CLI rep automàticament un testimoni d'autenticació. Aquest testimoni es desa localment i persisteix entre sessions, de manera que no cal autenticació repetida.
Configuració de paràmetres a nivell de projecte
Claude Code admet la configuració a diversos nivells segons la documentació oficial de configuració. Els nivells de configuració més comuns són:
| Àmbit | Ubicació | Ús |
|---|---|---|
| Usuari | Directori ~/.claude/ | Preferències personals per a tots els projectes |
| Projecte | .claude/ al repositori | Configuració compartida per a equips |
| Local | .claude/settings.local.json | Substitucions específiques de la màquina |
Per a la configuració inicial, la configuració a nivell d'usuari és suficient. Els paràmetres a nivell de projecte són importants quan es treballa amb equips que comparteixen estàndards de codificació.
Inici de la vostra primera sessió de Claude Code
Amb la instal·lació i l'autenticació completes, inicieu Claude Code executant la comanda sense arguments:
| claude |
Això inicia el mode interactiu on Claude respon a sol·licituds en llenguatge natural. La documentació oficial descriu el mode interactiu com la forma principal d'utilitzar Claude Code per a tasques de desenvolupament.
Proveu una comanda de prova senzilla:
| Mostra'm l'estructura d'aquest projecte |
Claude Code analitza el directori actual i proporciona una visió general de l'estructura del codebase. Això demostra que la instal·lació funciona correctament i Claude té accés per llegir fitxers.
Comandes essencials per a l'ús diari
Més enllà del mode interactiu, Claude Code admet diversos patrons de comandes documentats a la referència de la CLI:
| Patró de comanda | Propòsit | Exemple |
|---|---|---|
| claude | Iniciar sessió interactiva | claude |
| claude “tasca” | Executar tasca única | claude “corregeix els errors de linting” |
| claude -p “pregunta” | Pregunta ràpida sense sessió | claude -p “què fa aquesta funció” |
El patró de tasca única és especialment útil per a pipelines de CI/CD i scripts d'automatització on una sessió interactiva no és adequada.
Solució de problemes comuns d'instal·lació
Fins i tot amb scripts d'instal·lació automatitzats, ocasionalment sorgeixen problemes. La documentació oficial de resolució de problemes cobreix els problemes més freqüents.
Errors de "Command not found"
Si el terminal mostra "command not found: claude" després de la instal·lació, la configuració del PATH no s'ha completat correctament. Per a macOS i Linux, afegiu manualment la ubicació del binari de Claude al fitxer de configuració del shell.
Per als usuaris de bash, editeu `~/.bashrc` o `~/.bash_profile` i afegiu:
| export PATH=”$HOME/.local/bin:$PATH” |
Per als usuaris de zsh (el predeterminat en macOS modern), editeu `~/.zshrc` amb la mateixa línia. Després de desar, recarregueu la configuració amb `source ~/.zshrc` o obriu una nova finestra del terminal.
Problemes de xarxa i tallafocs
Les xarxes corporatives i els tallafocs restrictius de vegades bloquegen l'script d'instal·lació. Segons la documentació de resolució de problemes, si la instal·lació es penja o retorna HTML en lloc d'executar-se, l'accés a la xarxa als servidors d'Anthropic pot estar bloquejat.
La solució implica descarregar l'script d'instal·lació per separat:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Aquest enfocament proporciona més visibilitat sobre què falla si es produeixen errors durant la descàrrega o l'execució.
Problemes específics de WSL
Els usuaris de Windows que executen WSL de vegades tenen problemes de connectivitat entre el subsistema Linux i Windows. La documentació oficial esmenta que les regles del tallafocs poden necessitar ajustos per permetre el trànsit de WSL.
Si Claude Code s'instal·la correctament però no pot arribar als servidors d'Anthropic per a l'autenticació, comproveu que el tallafocs de Windows permeti l'accés a la xarxa de WSL. La guia de resolució de problemes proporciona comandes específiques de PowerShell per configurar les regles del tallafocs.
Actualització de Claude Code
Claude Code rep actualitzacions regulars amb noves funcions i millores. Segons la documentació oficial, les actualitzacions s'instal·len utilitzant la mateixa comanda que la instal·lació inicial.
Executeu de nou l'script d'instal·lació:
| curl -fsSL code.anthropic.com/install.sh | sh |
L'script detecta la instal·lació existent i l'actualitza a la versió més recent. Cap configuració ni autenticació es perd durant el procés d'actualització.
Comproveu la versió actual abans i després d'actualitzar:
| claude –version |
El registre de canvis a la documentació oficial de Claude Code enumera tots els canvis entre versions, cosa que ajuda a determinar si una actualització introdueix funcions rellevants per a fluxos de treball específics.
Pròxims passos després de la instal·lació
Un cop Claude Code estigui instal·lat i funcionant, serà possible explorar funcions avançades. La documentació oficial descriu diverses àrees que val la pena investigar:
- Habilitats i personalització: Segons la documentació oficial d'habilitats, Claude Code admet habilitats personalitzades definides en fitxers Markdown dins del directori `.claude/skills/`. Aquestes habilitats amplien les capacitats de Claude amb comandes i fluxos de treball específics del projecte.
- Protocol de context de model (MCP): La integració MCP permet a Claude Code connectar-se amb eines i serveis externs. Això converteix Claude en un hub que pot accedir a bases de dades, API i altres recursos de desenvolupament.
- Col·laboració en equip: Els fitxers de configuració a nivell de projecte al directori `.claude/` es poden incloure al control de versions, compartint la configuració de Claude Code entre equips de desenvolupament sencers.
- La documentació oficial proporciona guies detallades per a cadascuna d'aquestes àrees, basant-se en la instal·lació bàsica tractada aquí.
Preguntes freqüents
Necessito una subscripció de pagament de Claude per utilitzar Claude Code CLI?
Claude Code requereix un compte de Claude d'Anthropic, però el nivell de subscripció específic necessari depèn de l'ús. Segons la documentació oficial, l'autenticació és necessària, però els detalls de preus s'han de verificar al lloc web oficial d'Anthropic, ja que els plans canvien amb el temps.
Puc instal·lar Claude Code sense privilegis d'administrador?
A macOS i Linux, Claude Code s'instal·la al directori d'inici de l'usuari per defecte i no requereix accés d'administrador. Els usuaris de Windows poden necessitar privilegis d'administrador per al mètode d'instal·lació de PowerShell, encara que les instal·lacions de WSL no requereixen accés d'administrador.
Funciona Claude Code fora de línia?
No. Claude Code és una eina impulsada per IA que es comunica amb els servidors d'Anthropic per processar sol·licituds. Segons la documentació oficial, es requereix una connexió a Internet activa perquè Claude pugui analitzar codi i generar respostes.
Com desinstal·lo Claude Code?
La documentació oficial d'instal·lació avançada explica que la desinstal·lació implica eliminar el binari i els fitxers de configuració. A macOS i Linux, suprimiu el directori `~/.claude` i elimineu la modificació del PATH dels fitxers de configuració del shell. Els usuaris de Windows haurien de suprimir el directori d'instal·lació i buidar la variable d'entorn PATH.
Pot Claude Code accedir a tot el meu sistema de fitxers?
Per defecte, Claude Code opera dins del directori de treball actual i els seus subdirectoris. Segons la documentació oficial de permisos, l'accés es pot restringir encara més mitjançant la configuració de sandboxing als fitxers de configuració. Claude sempre demana confirmació abans d'executar operacions potencialment destructives.
Quina és la diferència entre Claude Code CLI i Claude Desktop?
Claude Code CLI s'executa al terminal i se centra en fluxos de treball de desenvolupament amb accés directe al sistema de fitxers i execució de comandes. Claude Desktop és una aplicació independent amb una interfície gràfica. Ambdues eines tenen diferents casos d'ús, amb la CLI optimitzada per a desenvolupadors que prefereixen fluxos de treball basats en terminal.
Amb quina freqüència hauria d'actualitzar Claude Code?
Les actualitzacions es poden instal·lar quan sigui convenient. El registre de canvis oficial documenta noves funcions i correccions d'errors. Per als equips, coordinar les actualitzacions garanteix que tothom utilitzi versions compatibles, encara que Claude Code manté la compatibilitat amb versions anteriors dels fitxers de configuració entre versions.
Conclusió
La instal·lació de Claude Code CLI triga només uns minuts independentment del sistema operatiu. Els scripts d'instal·lació automatitzats s'encarreguen de la configuració, la configuració del PATH i la col·locació del binari sense intervenció manual.
Després de la instal·lació i autenticació, Claude Code es converteix en un potent assistent de codificació d'IA accessible des de qualsevol terminal. Les comandes en llenguatge natural permeten als desenvolupadors escriure codi, corregir errors i automatitzar tasques sense sortir de la línia de comandaments.
Preparat per experimentar el desenvolupament assistit per IA? Executeu la comanda d'instal·lació per a la vostra plataforma i comenceu la vostra primera sessió de Claude Code avui mateix. La documentació oficial a code.claude.com proporciona guies completes per a funcions avançades un cop la configuració bàsica estigui completa.
