Com instal·lar Claude Code pas a pas (Mac, Windows i Linux)

Per instal·lar Claude Code n'hi ha prou amb una ordre al terminal: a Mac i Linux, curl -fsSL https://claude.ai/install.sh | bash; a Windows, des de PowerShell, irm https://claude.ai/install.ps1 | iex. No cal instal·lar Node.js abans. Després escrius claude, inicies sessió al navegador amb un compte de pagament i ja el tens funcionant. Si en acabar el terminal et diu que claude no existeix, gairebé segur que és un problema de PATH, i més avall tens com arreglar-lo.

Què et cal abans de començar

Un ordinador prou recent i un compte. La documentació oficial demana macOS 13 o posterior, Windows 10 (versió 1809) o posterior, o un Linux com Ubuntu 20.04 o Debian 10, amb un mínim de 4 GB de RAM.

Pel que fa al compte, Claude Code funciona amb els plans Pro, Max, Team o Enterprise de Claude, o amb un compte de la Claude Console (l'API de pagament per ús). El pla gratuït de claude.ai no l'inclou: el pots instal·lar, però no passaràs de la pantalla d'inici de sessió. Val la pena tenir-ho resolt abans de posar-t'hi.

Si fa temps vas llegir que calia Node.js i npm install -g, això ha canviat. L'ordre d'npm encara existeix, però ara és la via secundària i necessita Node 22 o posterior. L'instal·lador natiu no necessita res més i s'actualitza sol.

Obre el terminal (i mira quin és)

El terminal és la finestra de text on escriuràs les ordres. Per obrir-lo:

• Mac: Cmd + Espai, escriu «Terminal» i prem Enter.
• Linux: Ctrl + Alt + T, o busca «Terminal» al menú d'aplicacions.
• Windows: Win + X i tria Windows PowerShell o Terminal.

A Windows hi ha un detall que fa caure molta gent: hi ha dos terminals, PowerShell i CMD, s'assemblen molt i cadascun necessita una ordre diferent. Per saber on ets, mira el principi de la línia. Si hi posa PS C:\Users\el-teu-nom>, ets a PowerShell. Si hi posa C:\Users\el-teu-nom> sense la PS, ets a CMD.

Un altre parany de Windows: al menú d'inici també surt Windows PowerShell (x86). No l'obris; és la versió de 32 bits i l'instal·lador et dirà que no és compatible.

Instal·la'l amb l'ordre que toca

Copia l'ordre que correspon al terminal que tens obert, enganxa-la i prem Enter.

Mac, Linux o WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows, a PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows, a CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Veuràs text que va passant durant uns segons i, al final, el missatge Claude Code successfully installed!. No hi posis sudo al davant: Claude Code s'instal·la a la teva carpeta d'usuari i l'script mateix es nega a funcionar amb sudo. A Windows tampoc cal obrir PowerShell com a administrador.

No tanquis la finestra encara. Llegeix les últimes línies. Si hi apareix un apartat Setup notes, l'instal·lador t'està dient que la carpeta on ha posat claude no és al teu PATH, i sovint t'hi escriu l'ordre exacta per arreglar-ho. Als vídeos d'instal·lació que hem revisat, tant a Mac com a Windows, aquest és el pas on s'atura tothom.

Dues preguntes que surten sovint a Windows:

• Cal Git? No. Si tens Git for Windows, Claude Code el fa servir per executar ordres amb Bash; si no el tens, fa servir PowerShell. Alguns tutorials de principis del 2026 diuen que és obligatori: la documentació actual diu que és opcional.
• I WSL? Si ja treballes dins de WSL (el Linux integrat a Windows), obre el terminal de WSL i fes servir l'ordre de Linux. S'instal·la i s'executa allà dins, no des de PowerShell.

Si prefereixes un gestor de paquets, també hi ha brew install --cask claude-code a Mac i winget install Anthropic.ClaudeCode a Windows. Tingues en compte que aquestes dues vies no s'actualitzen soles; l'instal·lador natiu, sí.

Comprova que ha funcionat

Tanca el terminal, obre'n un de nou i escriu:

claude --version

Si tot és correcte, respon amb un número de versió seguit de (Claude Code), per exemple 2.1.211 (Claude Code). Obrir una finestra nova no és un ritual: moltes vegades el PATH només s'actualitza a les finestres que obres després d'instal·lar.

Si vols una revisió més completa, tens:

claude doctor

Només llegeix: et diu si la instal·lació està bé, si hi ha errors a la configuració i què pots fer per arreglar-los, sense obrir cap sessió.

Inicia sessió i obre'l al teu projecte

Claude Code treballa a la carpeta on l'obres, així que primer ves a la carpeta del projecte amb cd (canvia la ruta per la del teu projecte):

cd /ruta/del/teu/projecte
claude

La primera vegada et farà unes quantes preguntes al mateix terminal: el tema de colors i el mètode d'inici de sessió. Tria el compte de Claude amb subscripció o el de la Console, segons el que tinguis. S'obrirà el navegador perquè entris al teu compte i, quan acabis, el terminal mostrarà Login successful; prem Enter per continuar. Si el navegador no s'obre, prem c per copiar l'adreça i enganxa-la tu. Si en lloc de tornar al terminal el navegador et mostra un codi (passa sovint a WSL), enganxa'l al terminal on diu Paste code here if prompted.

Després et preguntarà si confies en la carpeta. Digues que sí només si és la carpeta del teu projecte: a partir d'aquí Claude Code hi podrà llegir fitxers.

Ja hi ets. Pots escriure-li en català. Una bona primera pregunta és demanar-li que t'expliqui què fa el projecte. Quatre coses útils per als primers minuts: al terminal no es clica, et mous amb les fletxes; Esc l'atura si està fent alguna cosa; /help mostra les ordres; i per sortir escriu exit o prem Ctrl + D dues vegades. Per canviar de compte, /login; per tancar la sessió, /logout.

Un últim detall que despista: Claude Code no és una aplicació amb icona. Cada vegada que el vulguis fer servir, obre el terminal, ves a la carpeta i escriu claude.

Si alguna cosa falla

Busca el missatge que et surt:

Missatge	Què passa	Què fer
'irm' is not recognized	Ets a CMD	Obre PowerShell, o fes servir l'ordre de CMD
The token '&&' is not a valid statement separator	Ets a PowerShell amb l'ordre de CMD	Fes servir l'ordre irm
A parameter cannot be found that matches parameter name 'fsSL'	Has enganxat l'ordre de Mac a PowerShell	Fes servir l'ordre irm
command not found: claude o 'claude' is not recognized	La carpeta no és al PATH	Mira just a sota
Claude Code does not support 32-bit Windows	Has obert PowerShell (x86)	Obre el PowerShell sense «(x86)»
App unavailable in region	Claude Code no està disponible al teu país	Consulta la llista de països
403 després d'iniciar sessió	Sovint, la subscripció no està activa	Revisa-la a claude.ai/settings

Arreglar el PATH a Mac. Si l'instal·lador et va donar una ordre a Setup notes, executa aquella. Si no, aquesta és la de la documentació per a Zsh, el terminal per defecte de Mac (a Linux, canvia ~/.zshrc per ~/.bashrc):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Arreglar el PATH a Windows. A PowerShell:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

En tots dos casos, tanca el terminal, obre'n un de nou i torna a provar claude --version. Si el problema no és a la llista, la pàgina oficial Troubleshoot installation and login té una taula molt més llarga, i claude doctor sol apuntar-te cap a la causa.

On es trenca

• L'instal·lador et pot dir que ha anat bé quan no ha acabat. A Windows hi ha informes a GitHub, com aquest del gener, on l'script diu que tot és correcte i claude no es reconeix perquè no ha tocat el PATH. L'avisa a Setup notes, però no ho arregla. Per això insistim a llegir el final.
• Molts tutorials han caducat. Els que et fan instal·lar Node i fer servir npm, o que diuen que Git Bash és obligatori a Windows, descriuen una versió anterior. Si un vídeo i la documentació no coincideixen, fes cas de la documentació.
• Windows natiu i WSL no són equivalents. L'aïllament de les ordres (el que la documentació anomena sandboxing) només funciona a WSL 2, no a Windows natiu.
• Homebrew i WinGet no s'actualitzen sols. Si els fas servir, recorda't d'actualitzar de tant en tant.
• Una clau d'API antiga pot passar per davant. Si alguna vegada vas definir ANTHROPIC_API_KEY al terminal, Claude Code et proposarà fer-la servir en lloc de la teva subscripció. Si aquella clau ja no és vàlida, veuràs errors estranys encara que el compte estigui bé.
• No hi ha versió gratuïta. Sense un pla de pagament o crèdit a la Console, el pots instal·lar però no fer-lo servir.

I ara què

Obre Claude Code en una carpeta amb un projecte petit, encara que sigui una web d'una sola pàgina, i demana-li que te l'expliqui abans de canviar res. Si no saps ben bé què és ni per a què el faràs servir, llegeix què és Claude Code abans del primer encàrrec seriós. I desa't la pàgina de resolució de problemes: quan alguna cosa falli d'aquí a un mes, serà el primer lloc on mirar.