Instalar Claude Code: comandos para Windows, macOS y Linux, clave de API sin suscripción y pago con iDEAL

Instala Claude Code con un único comando oficial: en macOS, Linux y WSL con curl -fsSL https://claude.ai/install.sh | bash, en Windows en PowerShell con irm https://claude.ai/install.ps1 | iex (en el símbolo del sistema, CMD, con la línea install.cmd que aparece abajo). Después, elige cómo pagar. Inicia sesión con una cuenta Pro, Max, Team, Enterprise o Console (la suscripción gratuita de Claude.ai no incluye Claude Code), o usa una clave API sin suscripción: establece ANTHROPIC_BASE_URL (solo el dominio, sin /v1), ANTHROPIC_AUTH_TOKEN y cuatro variables de modelo, y comprueba con /status si la clave está activa. Recarga el saldo de Kunavo con iDEAL (Países Bajos) o Bancontact (Bélgica), desde $10, sin cuota mensual.

Commando’s en variabelen gecontroleerd op 3 de octubre de 2026 in de documentación oficial de instalación de Claude Code en de documentación sobre variables de entorno; prijzen en betaalmethoden gecontroleerd op 3 de octubre de 2026. Nederland en België staan allebei op de lista de países compatibles con Anthropic (gecontroleerd op 3 de octubre de 2026), zowel voor Claude.ai als voor de API. Deze handleiding bestaat ook in het Engels: Instalar Claude Code.

Antes de instalar

Instalar Claude Code en macOS y Linux

Abre Terminal y pega esta línea:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

Esta es la instalación nativa recomendada: un único programa independiente que se actualiza en segundo plano. El comando claude se instala en ~/.local/bin. Un terminal que ya estaba abierto aún no conoce el nuevo PATH, así que abre primero una ventana nueva antes de probarlo. En WSL utiliza exactamente la misma línea, en el terminal de WSL.

Instalar Claude Code en Windows

En Windows hay dos líneas, y cuál necesitas depende únicamente de la ventana que tengas abierta. Si el indicador comienza con PS C:\Users\Naam>, estás en PowerShell; si solo aparece C:\Users\Naam> sin PS, es el símbolo del sistema (CMD). No necesitas abrir la ventana como administrador: según la documentación oficial, no es necesario.

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

El error más común es pegar la línea en la ventana equivocada. La línea de CMD en PowerShell produce The token '&&' is not a valid statement separator; la línea de PowerShell en CMD produce 'irm' is not recognized as an internal or external command. En un Windows en neerlandés, ese segundo mensaje puede aparecer en neerlandés, con la misma causa. Y la línea de macOS con | bash en PowerShell produce un error indicando que bash no se reconoce. En los tres casos: utiliza la línea correspondiente a tu ventana.

Git for Windows is optioneel. Staat het erop, dan voert Claude Code commando’s uit via de meegeleverde Git Bash; zonder Git gebruikt het PowerShell. Is Git wel geïnstalleerd maar wordt Git Bash niet gevonden, zet dan CLAUDE_CODE_GIT_BASH_PATH in het env-blok van ~/.claude/settings.json op het pad naar bash.exe; het voorbeeldpad in de documentatie is C:\Program Files\Git\bin\bash.exe.

Por tanto, WSL no es un requisito, como afirman algunas guías antiguas, sino una opción. Si eliges WSL, ejecuta la línea de macOS/Linux en el terminal de WSL y ejecuta claude también allí, no desde PowerShell o CMD.

Mediante Homebrew, WinGet o npm

También es posible, con una diferencia importante: según la documentación oficial, las instalaciones mediante Homebrew y WinGet no se actualizan automáticamente. En ese caso, debes actualizarlas manualmente:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # bijwerken gebeurt niet vanzelf

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # bijwerken gebeurt niet vanzelf

El paquete de npm requiere Node.js 22 o posterior, no Node.js 18 como aún indican algunas guías antiguas. Con una versión anterior de Node.js, npm solo muestra una advertencia EBADENGINE y la instalación continúa con normalidad: el paquete instala el mismo programa nativo, que no necesita Node.js para ejecutarse. No utilices nunca sudo npm install -g: causa problemas de permisos y supone un riesgo de seguridad. Actualiza con @latest, no con npm update -g.

node -v                                           # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code          # nooit met sudo

# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latest

Comprobar la instalación

claude --version   # toont het versienummer, gevolgd door (Claude Code)
claude doctor      # alleen-lezen diagnose van installatie en instellingen, start geen sessie

claude doctor no inicia una sesión, sino que muestra el estado de la instalación y de tus archivos de configuración. Así puedes ver rápidamente si el problema está en la instalación o en la configuración.

Krijg je command not found: claude, of meldt Windows dat claude niet wordt herkend, dan staat de installatiemap niet in je PATH. Open eerst een nieuw terminalvenster. Helpt dat niet, zet dan op macOS en Linux ~/.local/bin in je PATH via ~/.zshrc of ~/.bashrc. Op Windows is de map %USERPROFILE%\.local\bin; volgens de solución de problemas oficial controleer en voeg je die zo toe in PowerShell:

# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claude

Si instalas mediante npm y PowerShell muestra npm.ps1 cannot be loaded because running scripts is disabled on this system, la directiva de ejecución de PowerShell está bloqueando los scripts de inicio de npm. Utiliza el instalador nativo, inicia npm.cmd y claude.cmd, o permite scripts locales para tu propio usuario:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Primer inicio: suscripción o clave de API

En el primer inicio eliges cómo se pagará Claude Code. Las dos rutas son mutuamente excluyentes: si se ha configurado una clave de API, el inicio de sesión guardado permanece sin utilizar; si eliminas la variable, Claude Code vuelve a utilizar el inicio de sesión sin necesidad de reinstalarlo.

Ruta A: iniciar sesión con tu suscripción

Inicia claude en la carpeta de tu proyecto e inicia sesión mediante el navegador. Hay una trampa: si ANTHROPIC_API_KEY ya está configurada, Claude Code te pregunta una vez si debe utilizar esa clave. Si la rechazas, la ignora después sin volver a preguntarlo, y parece que la variable no se está leyendo. Vuelve a activarla mediante /config → Use custom API key.

Ruta B: sin suscripción, con una clave de API

ANTHROPIC_BASE_URL es una variable integrada de Claude Code. Según la documentación oficial, sustituye el endpoint de la API para enviar las solicitudes mediante un proxy o gateway. Por tanto, apuntar Claude Code a un endpoint con la API Anthropic Messages es una configuración compatible, sin plugin ni versión modificada. Pasos:

1. Crea una cuenta de Kunavo.
2. Recarga tu saldo a través de Billing, desde $10 (iDEAL y Bancontact aparecen más adelante).
3. Crea una clave en /app/keys que comience por sk-kn-. Solo se muestra una vez, así que guárdala inmediatamente.
4. Configura las variables. En macOS y Linux, en ~/.zshrc o ~/.bashrc:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # alleen het domein, zonder /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

En Windows, para probar primero en una sola ventana de PowerShell:

# Geldt alleen voor dit PowerShell-venster
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Para un uso permanente, el mejor lugar es el bloque env de la configuración del usuario: ~/.claude/settings.json (en Windows, %USERPROFILE%\.claude\settings.json). Allí los valores se aplican en todos los lugares donde se ejecuta Claude Code, también para los agentes en segundo plano. Las variables de tu shell solo se aplican a esa ventana del terminal: un editor que abras desde el Dock o el menú Inicio no las verá. Si el archivo ya contiene otros ajustes, añade únicamente el bloque env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Zet de sleutel nunca in de .claude/settings.json van een project: volgens de documentación oficial del gateway (gecontroleerd op 3 de octubre de 2026) wordt dat bestand gecommit en gedeeld met iedereen die de repository kloont. Let ook op de volgorde: zetten zowel je shell als een instellingenbestand dezelfde variabele, dan wint het instellingenbestand. Heeft een gewijzigde shellvariabele geen effect, kijk dan eerst in settings.json.

Cada línea tiene su propia trampa:

• ANTHROPIC_BASE_URL es solo el dominio. Claude Code añade /v1/messages por sí mismo; si terminas con /v1, la solicitud se envía a /v1/v1/messages y recibes un 404.
• Utiliza ANTHROPIC_AUTH_TOKEN, no ANTHROPIC_API_KEY. Según la documentación, ANTHROPIC_AUTH_TOKEN se envía como encabezado Authorization con Bearer delante y se aplica inmediatamente. ANTHROPIC_API_KEY se incluye en el encabezado x-api-key y, en el modo interactivo, primero debe aprobarse una vez (consulta la ruta A).
• Escribe el nombre del modelo exactamente en ANTHROPIC_MODEL. Kunavo solo reconoce el nombre exacto y no traduce nombres antiguos con una fecha añadida.
• Fija también ANTHROPIC_DEFAULT_OPUS_MODEL y ANTHROPIC_DEFAULT_SONNET_MODEL. Volgens de documentación sobre la configuración de modelos (gecontroleerd op 3 de octubre de 2026) wijzen de standaardinstelling en de alias opus voor API-gebruikers naar Opus 5.5 en de alias sonnet naar Sonnet 5.5, en schuiven die aliassen mee met nieuwe versies. Vastzetten doe je met de volledige modelnaam of met variabelen als ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo biedt Sonnet 5.5 nu niet aan, en een nieuw Opus-model staat er niet altijd meteen; een model dat er niet is, geeft een 404. Zonder ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 mislukken daardoor /model sonnet, de uitvoerfase van opusplan en subagents die op model: sonnet staan. De alias opus zet je vast op Opus 5.5 (claude-opus-5-5); daarvoor heb je Claude Code v2.1.280 of nieuwer nodig; een oudere versie werk je bij met claude update.
• ANTHROPIC_DEFAULT_HAIKU_MODEL también se aplica a las tareas en segundo plano. Según la documentación, esta variable determina el alias haiku y el modelo para funciones en segundo plano, como los títulos de sesión. Con Claude Haiku 4.5 se mantienen económicas.

Si utilizas la extensión de VS Code, configura las variables en claudeCode.environmentVariables, en la configuración de usuario del propio VS Code (comando Preferences: Open User Settings (JSON)). La extensión ya comprueba allí las credenciales antes de iniciarse; los valores de ~/.claude/settings.json sí llegan al proceso iniciado, pero no a esa comprobación.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Prijzen per miljoen tokens, uit de Kunavo-catalogus; de lijstprijs van Anthropic komt van claude.com/pricing (gecontroleerd op 3 de octubre de 2026):

Durante una sesión puedes cambiar con /model claude-opus-5-5, o iniciar directamente con claude --model claude-opus-5-5. El coste aproximado mensual de Claude Code y cuándo resulta más barata una suscripción se explican en Claude Code pricing (en inglés); calcula tu propio consumo con la Claude-tokencalculator. Todos los modelos y precios aparecen en la página de precios.

Comprobar con /status

Inicia claude. Con ANTHROPIC_AUTH_TOKEN configurada, no aparece ninguna pantalla de inicio de sesión: la variable se aplica inmediatamente. Si aun así ves la pantalla de inicio de sesión, Claude Code no ha leído ninguna clave. Colócala en un lugar que Claude Code lea antes del asistente del primer inicio: un export en tu shell o el bloque env de ~/.claude/settings.json. Un bloque env en .claude/settings.json o .claude/settings.local.json de un proyecto solo se aplica en una sesión interactiva después del asistente del primer inicio y de la pregunta sobre si confías en la carpeta.

Typ in de sessie /status en kijk op het tabblad Status naar twee regels (bron: de documentación oficial del gateway, gecontroleerd op 3 de octubre de 2026):

• Anthropic base URL debe mostrar https://api.kunavo.com. Esta línea solo aparece si se ha configurado una dirección de gateway; si falta, ANTHROPIC_BASE_URL no ha llegado a la sesión.
• Auth token debe mencionar ANTHROPIC_AUTH_TOKEN. Si en su lugar ves Login method con una cuenta de claude.ai, la variable no se ha leído y la sesión utiliza tu suscripción.

Si antes habías iniciado sesión con una suscripción, Claude Code puede advertir al iniciarse que hay dos fuentes de inicio de sesión activas (el mensaje termina en auth may not work as expected). Las solicitudes se envían mediante la clave; con /logout eliminas el inicio de sesión antiguo.

¿Quieres probar la dirección y la clave antes de abrir Claude Code? Envía entonces, como propone la documentación, una solicitud de un token de salida; cuesta una cantidad mínima de saldo. Los comandos leen las variables de tu shell, así que configúralas allí también si ya aparecen en settings.json.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Una respuesta JSON que comienza por {"id":"msg_ significa que la dirección y la clave funcionan; en PowerShell verás un id que comienza por msg_. Un 401 significa que la clave fue rechazada.

Qué más funciona con una clave de API

• No hay Remote Control ni dictado por voz. Ambos requieren una cuenta de claude.ai y no están disponibles mientras ANTHROPIC_AUTH_TOKEN esté activa; además, Remote Control permanece desactivado mientras ANTHROPIC_BASE_URL apunte a una dirección fuera de Anthropic.
• /fast informa de que el modo rápido está desactivado. Con solo un token bearer, Claude Code trata el modo rápido como desactivado, sin enviar la comprobación.
• La búsqueda de herramientas MCP está desactivada de forma predeterminada cuando ANTHROPIC_BASE_URL apunta a una dirección fuera de Anthropic.
• Los números de /context son una aproximación: Kunavo biedt /v1/messages/count_tokens nu niet aan. Volgens de documentación oficial de compatibilidad para gateways (gecontroleerd op 3 de octubre de 2026) valt Claude Code zonder dat endpoint terug op een schatting op basis van tekens, dus /context toont benaderde aantallen.

El código, las herramientas, los subagentes, los servidores MCP, los hooks y el almacenamiento en caché de prompts funcionan como siempre. Encontrarás más detalles en la documentación de integración de Claude Code (en inglés) y en Claude Code without a subscription (en inglés).

Pagar con iDEAL o Bancontact

Een Claude-abonnement betaal je via de website alleen met een creditcard of debitcard (Artículo de ayuda de Claude sobre suscripciones de pago, gecontroleerd op 3 de octubre de 2026); de prijzen op claude.com/pricing zijn exclusief belasting.

Het Kunavo-tegoed waardeer je op via Stripe Checkout. De prijzen staan in Amerikaanse dollars; voor kopers in Nederland en België toont Stripe het bedrag in euro’s. Volgens de Documentación de Stripe sobre Adaptive Pricing (gecontroleerd op 3 de octubre de 2026) zit in die wisselkoers een omrekenopslag van 2–4% die de koper betaalt; wie in dollars betaalt (met een kaart, Apple Pay, Google Pay of Link), betaalt die opslag niet. iDEAL en Bancontact werken alleen in euro’s. Op de betaalpagina worden aangeboden:

• iDEAL, voor Nederland. De methode heet inmiddels iDEAL | Wero (Stripe vroeg om die naam in het eerste kwartaal van 2026 over te nemen), dus ook die naam kun je op de betaalpagina zien. Je wordt doorgestuurd naar de omgeving van je eigen bank en bevestigt daar (Stripe sobre iDEAL, gecontroleerd op 3 de octubre de 2026).
• Bancontact, voor België, met je Bancontact-kaart of de app (Stripe sobre Bancontact, gecontroleerd op 3 de octubre de 2026).
• Tarjetas (Visa, Mastercard), Apple Pay, Google Pay y Link.

No ofrecidos: PayPal, domiciliación SEPA, Klarna (solo está disponible para compradores en Estados Unidos), Tikkie, Riverty (la antigua AfterPay) y una transferencia bancaria normal.

1. Crea una cuenta de Kunavo.
2. Elige un importe en Billing, como mínimo $10. Quien añade más saldo de una vez recibe crédito adicional: bij $100 krijg je $110, bij $1.000 krijg je $1.200, bij $5.000 krijg je $6.250.
3. En la página de pago de Stripe, elige iDEAL o Bancontact y completa el pago en el entorno de tu banco (iDEAL) o con la aplicación o tarjeta de Bancontact. El importe en euros aparece en la página de pago antes de confirmar.
4. Crea una clave en /app/keys e introdúcela en ANTHROPIC_AUTH_TOKEN.

El saldo es prepago: no hay importe mensual, no caduca y las solicitudes fallidas no se cobran. La recarga automática solo funciona con una tarjeta guardada o Link; con iDEAL y Bancontact, por tanto, siempre recargas manualmente. Kunavo no emite facturas de IVA; tu historial de recargas aparece en Billing. Estos métodos de pago solo añaden saldo a tu API de Kunavo: no sirven para pagar una suscripción Claude Pro o Max. Más información sobre pagar en euros: Claude pagar con iDEAL.

Errores comunes

Después de la instalación

La primera vez que inicies Claude Code en un proyecto, escribe /init: Claude Code lee el repositorio y crea un CLAUDE.md con los comandos de prueba y las convenciones que encuentra. Comprueba ese archivo y mantenlo breve, porque se carga en cada sesión. Entre tareas independientes, /clear inicia una conversación nueva; si una tarea se alarga, /compact resume el historial y puedes continuar trabajando.

Lo que debes saber

• Esta es una API con pago por token, no una suscripción Claude Pro o Max. Quien utiliza Claude Code durante horas todos los días suele pagar menos con una suscripción; pagar por token se adapta al uso variable, y un mes sin utilizarlo no cuesta nada. La comparación aparece en Claude Code pricing (en inglés).
• Con una clave de API, Remote Control y el dictado por voz no están disponibles.
• Con Kunavo utilizas capacidad compartida, sin cuota reservada ni garantías contractuales; si las necesitas, firma un contrato directamente con Anthropic.
• iDEAL y Bancontact solo sirven para recargas manuales; la recarga automática solo funciona con una tarjeta o Link.
• Los importes en euros incluyen el margen de conversión de Stripe. Kunavo no emite facturas de IVA.

Preguntas frecuentes