Tutorial de la sèrie Claude Code 5: Com instal·lar Claude Code?

Com instal·lar Claude Code

La instal·lació de Claude Code no té cap interfície gràfica amb "Següent"; tot es fa des de la línia d'ordres. Si ja fas servir npm, tot el procés no et portarà més de dos minuts.

Requisits previs

Abans de començar, assegura't de tenir el següent:

Node.js 18 o superior
Comprova-ho executant node -v al terminal. Si la versió és inferior a 18, actualitza'l amb nvm, fnm o directament des de nodejs.org.
Un compte d'Anthropic
Registra't a https://console.anthropic.com. El compte proporcionarà una clau API que necessitaràs després de la instal·lació. El registre és gratuït i el cost real es calcula segons l'ús.
Accés de xarxa a l'API d'Anthropic
El domini per defecte és api.anthropic.com. Si l'entorn requereix un proxy, assegura't de configurar HTTP_PROXY o HTTPS_PROXY al terminal.

Opció d'instal·lació 1: Instal·lació global amb npm

Aquesta és la manera més habitual; un cop instal·lat, es pot fer servir a qualsevol lloc.

npm install -g @anthropic-ai/claude-code

Un cop acabat, executa claude --version. Si apareix un número de versió, la instal·lació ha funcionat. Amb la instal·lació global, l'ordre claude es pot cridar des de qualsevol directori.

Si trobes errors de permisos (habitual al directori /usr/local/lib de macOS), tens dues opcions:

Utilitza sudo per instal·lar (ràpid però qüestionable en seguretat).
Configura npm perquè faci servir el directori de l'usuari, evitant sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Després afegeix ~/.npm-global/bin al teu PATH i reinicia el terminal.

Opció d'instal·lació 2: npx, utilitza i oblida't

Si no vols instal·lar res globalment, o només vols provar-ho temporalment, npx és més directe.

npx @anthropic-ai/claude-code

npx descarregarà temporalment el paquet més recent, l'executarà i no deixarà cap ordre global. Comprova actualitzacions cada cop que es fa servir, així que sempre tens l'última versió. L'inconvenient és que és una mica més lent (cal descarregar cada cop) i no és adequat per a scripts automatitzats que s'executen sovint.

Ideal per: primera presa de contacte, ús temporal en un equip aliè o ús esporàdic.

Verificació del funcionament

Després d'instal·lar, no t'afanyis a autenticar-te. Executa una ordre senzilla per veure si l'eina s'inicia:

claude --help

Si apareix la informació d'ajuda, el binari funciona correctament. El següent pas serà connectar el teu compte, que es tractarà més endavant.

El cos instal·lat amb les dues opcions és el mateix; l'autenticació i l'ús posteriors són idèntics. Tria la que et resulti més còmoda.

Problemes freqüents

Versió de Node massa baixa
Per sota de 18, l'error és directe, no un avís. Actualitzar Node és la solució més senzilla.
Temps d'espera de xarxa
Tant en baixar el paquet npm com en connectar-se a l'API, pot haver-hi bloquejos per proxy o firewall. Primer comprova que curl https://api.anthropic.com funcioni, després continua.
Ús del cmd natiu a Windows
Tot i que teòricament és possible, es recomana fer servir Git Bash, WSL2 o Windows Terminal per evitar problemes estranys d'escapament de camins.