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

Instal·la Claude Code en 2 minuts. Configuració per a macOS, Linux, Windows. Configura claus API, corregeix errors comuns i potencia Claude Code amb crèdits gratuïts d'Anthropic.

Claude CodeInstall Claude CodeClaude CLIClaude Code SetupAI Perks
Author Avatar
Andrew
AI Perks Team
11,969

Quick Answer

Instal·la Claude Code amb `npm install -g @anthropic-ai/claude-code@latest`. Requereix Node.js 18+. Verifica amb `claude --version`. Autentica mitjançant `claude auth login` o estableix ANTHROPIC_API_KEY. Alimenta'l gratuïtament amb crèdits d'Anthropic per valor de 1.000 $-25.000 $ o més a getaiperks.com.

AI Perks

AI Perks ofereix accés a descomptes exclusius, crèdits i ofertes en eines d'IA, serveis al núvol i API per ajudar startups i desenvolupadors a estalviar diners.

AI Perks Cards

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.


Estalvia el teu pressupost en crèdits d'IA

Cerca ofertes per a
OpenAI
OpenAI,
Anthropic
Anthropic,
Lovable
Lovable,
Notion
Notion

Promociona el teu SaaS

Arriba a més de 90.000 fundadors globalment buscant eines com la teva

Sol·licita ara

Requisits del sistema

RequisitMínimRecomanat
Node.js18.020+ (LTS)
npm9.010+
SOmacOS 12+, Ubuntu 20.04+, Windows 10+Més recent
RAM4 GB8 GB+
Espai en disc500 MB2 GB+
InternetRequeritBanda ampla estable

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.


AI Perks

AI Perks ofereix accés a descomptes exclusius, crèdits i ofertes en eines d'IA, serveis al núvol i API per ajudar startups i desenvolupadors a estalviar diners.

AI Perks Cards

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.


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

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.


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.

Programa de crèditsCrèdits disponiblesCom obtenir-los
Anthropic Claude (Directe)1.000 - 25.000 $Guia AI Perks
AWS Activate (Bedrock - Claude)1.000 - 100.000 $Guia AI Perks
Google Cloud Vertex (Claude)1.000 - 25.000 $Guia AI Perks
Microsoft Founders Hub500 - 1.000 $Guia AI Perks
Programes VC + Acceleradores1.000 - 5.000 $Guia AI Perks

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.


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 $.


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.

AI Perks

AI Perks ofereix accés a descomptes exclusius, crèdits i ofertes en eines d'IA, serveis al núvol i API per ajudar startups i desenvolupadors a estalviar diners.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.