Com instal·lar Claude Code CLI el 2026: Guia completa de configuració

Sponsored

Round Funded

Raise money from 10,000+ active vetted investors.

Start Raising

Com instal·lar Claude Code CLI el 2026

Per instal·lar Claude Code, executeu npm install -g @anthropic-ai/claude-code@latest al vostre terminal. La instal·lació triga uns 30 segons. Verifiqueu amb claude --version, i després autentifiqueu-vos amb claude auth login per començar a utilitzar-lo.

Claude Code requereix Node.js 18 o superior. Un cop instal·lat, s'executa a macOS, Linux i Windows amb els mateixos comandaments. I mentre el configureu, AI Perks us pot proporcionar crèdits gratuïts d'Anthropic per valor de 1.000-25.000 $+ per alimentar Claude Code sense cap cost.

SponsoredRaise money from 10,000+ active vetted investors.

Start Raising

Requisits del sistema

Comproveu la vostra versió de Node.js:

node --version

Si és inferior a 18, instal·leu la darrera LTS des de nodejs.org o utilitzeu nvm.

Instal·lar Claude Code a macOS

Pas 1: Instal·lar Node.js (si encara no el teniu)

Utilitzeu Homebrew:

brew install node

O descarregueu-lo des de nodejs.org.

Pas 2: Instal·lar Claude Code

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

Pas 3: Verificar la instal·lació

claude --version

Haureu de veure un número de versió imprès (per exemple, 1.x.x).

Pas 4: Autenticar-se

claude auth login

Això obre un navegador per iniciar sessió a través del vostre compte d'Anthropic.

SponsoredRaise money from 10,000+ active vetted investors.

Start Raising

Instal·lar Claude Code a Linux

Pas 1: Instal·lar Node.js (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Per a altres distribucions (Fedora, Arch, etc.), utilitzeu el vostre gestor de paquets.

Pas 2: Instal·lar Claude Code

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

Si obteniu errors de permís, no utilitzeu sudo amb npm. En lloc d'això, corregeix el prefix de npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Després, torneu a instal·lar.

Pas 3: Verificar i autenticar-se

claude --version
claude auth login

Instal·lar Claude Code a Windows

Pas 1: Instal·lar Node.js

Descarregueu l'instal·lador de Windows des de nodejs.org i executeu-lo. Assegureu-vos que "Add to PATH" estigui marcat durant la instal·lació.

Pas 2: Obriu PowerShell o Terminal

Obriu PowerShell (o Windows Terminal) com a Administrador.

Pas 3: Instal·lar Claude Code

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

Pas 4: Verificar la instal·lació

claude --version

Si claude no es reconeix, reinicieu el vostre terminal o comproveu que la carpeta d'executables globals de npm estigui al vostre PATH:

npm config get prefix

Afegiu el camí resultant (amb \ afegit) a la vostra variable d'entorn PATH del sistema.

Pas 5: Autenticar-se

claude auth login

SponsoredRaise money from 10,000+ active vetted investors.

Start Raising

Mètodes d'autenticació

Claude Code admet tres mètodes d'autenticació:

Mètode 1: Inici de sessió OAuth (El més fàcil)

claude auth login

Obre un navegador per iniciar sessió a través del vostre compte d'Anthropic. Ideal per a ús personal amb una subscripció Pro/Max.

Mètode 2: Clau API (Recomanat per a crèdits gratuïts)

Configureu la vostra clau API d'Anthropic com a variable d'entorn:

macOS/Linux:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc  # o ~/.bashrc

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-...', 'User')

Aquesta és la millor opció per utilitzar crèdits gratuïts d'Anthropic de AI Perks en lloc d'una subscripció de pagament.

Mètode 3: Fitxer de configuració

Editeu ~/.claude/auth/credentials.json:

{
  "api_key": "sk-ant-...",
  "auth_type": "api_key"
}

Configuració per primera vegada: Verificar que tot funciona

Després de la instal·lació i autenticació:

Provar la funcionalitat bàsica

claude

Haureu de veure el REPL de Claude Code. Proveu una petició:

Hola! Quin model estàs executant?

Claude hauria de respondre amb una salutació i indicar el model actiu.

Provar operacions de fitxers

Navegueu fins a la carpeta d'un projecte:

cd ~/projects/my-app
claude

Demaneu a Claude que llegeixi el vostre README:

Pots llegir el README.md i resumir aquest projecte?

Si Claude llegeix i respon, la vostra configuració funciona.

SponsoredRaise money from 10,000+ active vetted investors.

Start Raising

Errors comuns d'instal·lació i solucions

Error: npm ERR! EACCES permission denied

No teniu permís per escriure a la carpeta global de npm. Solució:

# No utilitzeu sudo. En lloc d'això, canvieu el prefix de npm:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Afegiu l'exportació al vostre ~/.zshrc o ~/.bashrc per fer-ho permanent.

Error: command not found: claude

Després de la instal·lació, no es troba el comandament claude. Causes:

1. Terminal no reiniciat - Tanqueu i torneu a obrir el vostre terminal
2. PATH mancant el binari de npm - Executeu echo $(npm config get prefix)/bin i afegiu-lo al PATH
3. Configuració de shell incorrecta - Per a zsh, editeu ~/.zshrc; per a bash, editeu ~/.bashrc

Error: versió de Node.js massa antiga

Claude Code requereix Node.js 18+. Actualitzeu:

# macOS (Homebrew)
brew upgrade node

# Linux (nvm)
nvm install 20
nvm use 20

# Windows
# Descarregueu la darrera LTS de nodejs.org

Error: Autenticació fallida

• Verifiqueu que la vostra clau API comenci amb sk-ant-
• Comproveu que no hagi estat revocada a console.anthropic.com
• Assegureu-vos que no hi hagi espais addicionals a la vostra variable d'entorn ANTHROPIC_API_KEY
• Proveu de regenerar la clau

Error: Cannot find module '@anthropic-ai/claude-code'

La instal·lació no es va completar. Proveu:

npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest --force

Potencia Claude Code amb crèdits gratuïts d'Anthropic

Claude Code requereix una subscripció de pagament (20-200 $/mes) o crèdits API per executar-se realment. Els crèdits gratuïts d'Anthropic mitjançant AI Perks cobreixen el cost de l'API completament.

Total potencial: 4.500 - 156.000 $+ en crèdits gratuïts de Claude

Després d'instal·lar Claude Code, configureu-lo amb una clau API impulsada per crèdits gratuïts i ometeu la facturació de subscripció per complet.

SponsoredRaise money from 10,000+ active vetted investors.

Start Raising

Pas a pas: Instal·lar + Executar Claude Code gratuïtament

Pas 1: Instal·lar Claude Code

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

Pas 2: Obtenir crèdits gratuïts d'Anthropic

Subscriviu-vos a AI Perks i sol·liciteu programes de crèdit. La majoria de decisions arriben en una setmana.

Pas 3: Generar una clau API

Inicieu sessió a console.anthropic.com i creeu una clau API a Configuració > Claus API.

Pas 4: Configurar Claude Code

export ANTHROPIC_API_KEY="sk-ant-..."

Afegiu-ho a la vostra configuració de shell per fer-ho persistent.

Pas 5: Començar a codificar

claude

Cada petició ara prové del vostre saldo de crèdits gratuïts. No cal subscripció.

Preguntes freqüents

Quant de temps triga a instal·lar Claude Code?

La instal·lació triga entre 30 i 60 segons mitjançant npm, suposant que Node.js 18+ ja estigui instal·lat. Si necessiteu instal·lar Node.js primer, afegiu 5-10 minuts. Verifiqueu l'èxit amb claude --version.

Necessito una subscripció de pagament per instal·lar Claude Code?

No, la instal·lació és gratuïta. Només necessiteu una subscripció d'Anthropic de pagament o crèdits API per utilitzar Claude Code realment. Els crèdits gratuïts per valor de 1.000-25.000 $+ mitjançant AI Perks eliminen el cost per complet.

Puc instal·lar Claude Code a diverses màquines?

Sí, instal·leu-lo a tantes màquines com vulgueu. La instal·lació en si és gratuïta. El vostre compte d'Anthropic, les claus API i els crèdits es comparteixen entre màquines; l'ús de qualsevol màquina compta per al mateix saldo.

Com instal·lo Claude Code en un servidor (CI/CD)?

Utilitzeu el mateix comandament npm install, i després configureu-lo mitjançant una variable d'entorn (ANTHROPIC_API_KEY). Per a CI/CD, emmagatzemeu la clau API com a secret i injecteu-la durant l'execució de la pipeline. Els crèdits gratuïts mitjançant AI Perks financen l'ús de CI/CD a 0 $.

Puc instal·lar Claude Code sense Node.js?

No, Claude Code requereix Node.js 18+ per funcionar. No hi ha binaris independents distribuïts oficialment per Anthropic. Utilitzeu nvm o el gestor de paquets del vostre sistema operatiu per instal·lar Node.js si cal.

Com instal·lo una versió específica de Claude Code?

Instal·leu amb l'etiqueta de versió: npm install -g @anthropic-ai/claude-code@1.2.0 (substituïu per la versió desitjada). Vegeu les versions disponibles al changelog de GitHub.

Què passa després d'instal·lar Claude Code?

Executeu claude --version per verificar, i després claude auth login (o configureu ANTHROPIC_API_KEY). Inicieu amb claude des de qualsevol carpeta de projecte. Claude pot llegir el vostre codi, suggerir canvis i executar tasques. Amb crèdits gratuïts mitjançant AI Perks, l'ús il·limitat costa 0 $.

SponsoredRaise money from 10,000+ active vetted investors.

Start Raising

Instal·lar Claude Code + Obtenir crèdits gratuïts d'Anthropic

La instal·lació de Claude Code triga 30 segons. Alimentar-lo gratuïtament requereix una subscripció a AI Perks:

• 1.000-25.000 $+ en crèdits gratuïts d'Anthropic
• Estratègies d'apilament per a més de 50.000 $ de recorregut
• Més de 200 avantatges addicionals per a startups més enllà dels crèdits d'IA
• Guies actualitzades per a cada versió de Claude Code

Subscriviu-vos a getaiperks.com →

Instal·leu Claude Code en 30 segons. Alimenteu-lo gratuïtament a getaiperks.com.