# Guia d'instal·lació detallada — Claude Code

> Si no vas poder seguir el bloc 1 al curs, o vols repassar-ho a casa, aquesta guia et porta de zero a "Claude Code funcionant".
> Temps estimat: **20-30 minuts**.

---

## 1. Crear compte a Anthropic i configurar la facturació

1. Obre el navegador i ves a **https://console.anthropic.com**
2. Clica "Sign up" / "Crear compte".
3. Registra't amb un correu **personal** (no el del centre, que pot tindre filtres antispam).
4. Confirma el correu.
5. Ves a **Settings → Plans & Billing**.

### Opcions per pagar l'ús de l'API

Anthropic ja no regala crèdits inicials. Tens dues opcions:

**Opció A — Comprar crèdits (recomanat per provar)**
- Ves a **Settings → Billing → Add credits**.
- El mínim és **5 USD** (~5 €). Per a tasques docents amb Sonnet, pot durar setmanes.

**Opció B — Contractar el pla Pro (ús intensiu)**
- **Claude Pro**: 20 €/mes — accés il·limitat al millor model via claude.ai.
- No inclou API Key; és per al xat web. Per a Claude Code necessites crèdits o el pla **Max** (100 €/mes).

> 💡 **Recomanació per al curs**: compra 5-10 USD de crèdits API per experimentar. Si després l'uses molt, avalua el pla que s'adapte millor.

### Crear una API Key

1. Ves a **Settings → API Keys**.
2. Clica **"Create Key"**.
3. Posa-li un nom descriptiu, per exemple: `claude-code-portatil-feina`.
4. **Copia la clau** (comença per `sk-ant-...`) i guarda-la en un lloc segur.

   ⚠️ La clau només es mostra una vegada. Si la perds, hauràs de generar-ne una de nova.

---

## 2. Instal·lar Node.js

Claude Code necessita Node.js per funcionar. És gratis i lliure.

### Windows

1. Obre el navegador i ves a **https://nodejs.org**
2. Descarrega la versió **LTS** (la verda, no l'altra).
3. Executa l'instal·lador (`.msi`).
4. Accepta totes les opcions per defecte ("Next, Next, Next").
5. **Reinicia el terminal o l'ordinador** (perquè la variable PATH s'actualitze).

### Mac

```bash
# Opció A: descàrrega de nodejs.org (igual que Windows)

# Opció B: amb Homebrew (si en tens)
brew install node
```

### Linux

```bash
# Ubuntu/Debian
sudo apt update && sudo apt install nodejs npm

# Fedora
sudo dnf install nodejs

# Si la versió del repositori és antiga, usar nvm (recomanat):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# Després:
nvm install --lts
```

### Comprovació

Obre un **nou** terminal i escriu:

```bash
node --version
npm --version
```

Han d'aparèixer dues versions (per exemple `v20.11.0` i `10.2.4`).

> 🚧 **Si "node" no es reconeix**: tanca i torna a obrir el terminal. Si encara no, reinicia l'ordinador. Si encara no, comprova que Node aparega a la PATH del sistema.

---

## 3. Instal·lar Claude Code

Al terminal:

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

Espera 1-2 minuts. Pot mostrar avisos (warnings) — és normal, mentre no done error.

### Comprovació

```bash
claude --version
```

Ha d'aparèixer una versió.

> 🚧 **Errors típics a Windows**:
> - `EACCES` o "permís denegat": obre el terminal com a **administrador** (clic dret → "Executar com administrador").
> - "Política d'execució restringida" a PowerShell: obre **Símbol del sistema (cmd)** en lloc de PowerShell.
> - Antivirus blocant: afegeix una excepció a Windows Defender per a la carpeta on s'instal·la Claude Code.

---

## 4. Instal·lar Visual Studio Code

VS Code és l'editor recomanat per usar Claude Code. És gratuït.

1. Ves a **https://code.visualstudio.com**
2. Descarrega per al teu sistema operatiu.
3. Instal·la amb les opcions per defecte.

### Català (opcional)

A VS Code: `Ctrl+Shift+P` → escriure `Configure Display Language` → triar "Catalan" si està disponible, o instal·lar el "Language Pack" de català.

---

## 5. Instal·lar l'extensió Claude Code a VS Code

1. Obre VS Code.
2. Clica la icona d'**Extensions** a la barra lateral (o `Ctrl+Shift+X`).
3. Busca "**Claude Code**" (la oficial d'Anthropic).
4. Clica **Install**.

---

## 6. Login a Claude Code

1. A VS Code, prem `Ctrl+Shift+P` (o `Cmd+Shift+P` a Mac).
2. Escriu "Claude Code: Login" i prem Enter.
3. S'obre el navegador i et demana autoritzar.
4. Accepta. Tornaràs a VS Code i ja estàs autenticat.

> Si prefereixes usar la teua API Key directament, pots fer:
> ```bash
> claude config set apiKey sk-ant-xxxxxxxx
> ```

---

## 7. Primera prova

1. Crea una carpeta nova al Escriptori: `prova_claude`.
2. A VS Code: **File → Open Folder → tria-la**.
3. Obre el panell de Claude Code (icona a la barra lateral o `Ctrl+Shift+P → Claude Code: Open`).
4. Al xat, escriu:
   > "Crea un fitxer hola.html amb un títol que diga 'Funciona!' i un paràgraf amb la data d'avui."

5. Claude crearà el fitxer. Obre'l amb doble clic → s'obrirà al navegador.

🎉 **Si ho veus bé, ja tens Claude Code funcionant.**

---

## 8. Què fer després

- Llegeix els fitxers `HANDOUT_ASSISTENTS.md` i `RECURSOS.md` del curs.
- Practica creant petits projectes: una calculadora, una llista de la compra, un quizz...
- Si vols sincronització multi-dispositiu, mira la secció "Memòria centralitzada" dels materials del curs.
- Comparteix dubtes al canal de seguiment.

---

## 9. Problemes freqüents

### "El meu antivirus bloca Claude Code"
Afegeix excepció a Windows Defender:
1. Configuració → Privadesa i seguretat → Seguretat de Windows → Protecció contra virus i amenaces → Configuració → Afegir o eliminar exclusions.
2. Afegir carpeta: `%APPDATA%\npm` (Windows).

### "He gastat tots els crèdits"
- Comprova `/cost` a Claude Code.
- Considera el pla **Claude Pro** (20 €/mes) si l'utilitzaràs molt.
- Usa més `Sonnet` que `Opus`: gasta unes 5 vegades menys.

### "Claude m'ha esborrat fitxers per error!"
- Treballa **sempre** dins de carpetes amb control de versions (Git) o sincronitzades al núvol amb historial (MEGA, Dropbox, OneDrive).
- Per a coses importants, fes **còpia abans** de demanar-li canvis grans.

### "Claude Code no entén el meu valencià"
- En realitat sí, però si tens dubtes, escriu-li: "Respon-me sempre en valencià".
- Pots posar aquesta instrucció permanent a un fitxer `CLAUDE.md` dins del projecte.