En resumen: instale Claude Code con una sola línea en el terminal, sin Node.js y sin permisos de administrador. La línea depende únicamente de la ventana: curl -fsSL https://claude.ai/install.sh | bash en macOS, Linux y WSL, irm https://claude.ai/install.ps1 | iex en Windows PowerShell y la tercera línea de abajo en el símbolo del sistema (CMD). Si no tiene una suscripción de Claude, conecte después Claude Code a Kunavo mediante una clave de API: ANTHROPIC_BASE_URL=https://api.kunavo.com (sin /v1), ANTHROPIC_AUTH_TOKEN y cuatro variables de modelo. /status muestra si se ha aplicado. El pago se realiza por token desde un saldo a partir de $10, recargable con tarjeta de débito o crédito (incluidas Visa Debit y Debit Mastercard), Apple Pay, Google Pay, Link o, en Austria, EPS. PayPal y el débito SEPA no están disponibles.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAnthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 3 de octubre de 2026 mit Configurar Claude Code abgeglichen, die Variablen mit der Liste der Variables de entorno. Kunavos Preise und Zahlungswege sind auf dem Stand vom 3 de octubre de 2026. Deutschland, Österreich und die Schweiz stehen in Anthropics Lista de países sowohl für Claude.ai als auch für die API (Stand 3 de octubre de 2026). Eine englische Fassung gibt es unter Instalar Claude Code.
Resumen del proceso
- Instalar: ejecute arriba la línea adecuada y, después, abra una ventana de terminal nueva.
- Comprobar:
claude --versionmuestra un número de versión. - Decidir: iniciar sesión con una suscripción de Claude o utilizar una clave de API (comparación más abajo).
- Con una clave de API: recargar el saldo, crear la clave y configurar seis variables de entorno.
- Comprobar: escriba
/statusen la sesión.
Requisitos: lo que se aplica actualmente
Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die página oficial de configuración am 3 de octubre de 2026 verlangt.
| Tema | Lo que todavía se suele leer | Según Anthropic |
|---|---|---|
| macOS | macOS 10.15 o posterior | macOS 13.0 o posterior |
| Windows | solo mediante WSL | de forma nativa en Windows 10 a partir de 1809 o en Windows Server 2019; WSL es una opción, no una obligación |
| Permisos | Iniciar PowerShell como administrador | no es necesario |
| Node.js | Node.js 18 o posterior | solo para la instalación mediante npm; en ese caso, versión 22 o posterior |
| npm | obsoleto | sigue siendo un método documentado; se recomienda el instalador nativo |
| Linux | — | Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Equipo y shell | — | al menos 4 GB de RAM, x64 o ARM64, no Windows de 32 bits; Bash, Zsh, PowerShell o CMD |
| Ubicación | — | un país compatible con Anthropic; Alemania, Austria y Suiza están incluidos |
| Cuenta | — | para iniciar sesión, Pro, Max, Team, Enterprise o Console; con una clave de API, ni suscripción ni inicio de sesión |
Instalar en macOS, Linux y WSL
Pegue en el terminal la línea con install.sh. En la documentación oficial, este método aparece en la pestaña «Native Installation (Recommended)». El script coloca el ejecutable en ~/.local/bin/claude y, después, la instalación se actualiza automáticamente en segundo plano. En WSL se aplica la misma línea, ejecutada en el terminal de WSL.
Instalar Claude Code en Windows
Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut Página de configuración für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.
Si confunde las ventanas, recibirá un mensaje en inglés o, en un Windows configurado en alemán, posiblemente uno en alemán. La línea de CMD en PowerShell termina con The token '&&' is not a valid statement separator, y la línea de PowerShell en CMD con 'irm' is not recognized as an internal or external command. En ambos casos significa lo mismo: se ha utilizado la ventana incorrecta; use la otra línea.
Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut Solución de problemas startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.
Git para Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.
Que se utilice de forma nativa o en WSL depende de dónde se encuentren sus proyectos:
| Variante | Requisito | Aislamiento | Conviene si |
|---|---|---|---|
| Windows nativo | ninguno; Git para Windows es opcional | no | sus proyectos y herramientas se ejecutan directamente en Windows |
| WSL 2 | WSL 2 activado | sí | necesita herramientas de Linux o quiere ejecutar comandos en una sandbox |
| WSL 1 | WSL 1 activado | no | WSL 2 no está disponible en el equipo |
Con WSL, instale e inicie claude en el terminal de WSL, no en PowerShell ni en CMD.
Alternativas: Homebrew, WinGet y npm
Quien prefiera mantener el software mediante un gestor de paquetes puede hacerlo, con una salvedad: según la documentación, las instalaciones de Homebrew y WinGet no se actualizan automáticamente, por lo que debe ejecutar upgrade con regularidad. Homebrew ofrece dos Casks. claude-code sigue el canal estable, que lleva aproximadamente una semana de retraso y omite las versiones con regresiones importantes; claude-code@latest recibe cada versión de inmediato.
# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code # aktualisiert sich nicht von selbst
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # aktualisiert sich nicht von selbstSobre npm
npm sigue siendo una vía descrita oficialmente. Se requiere Node.js 22 o posterior. El paquete npm descarga el mismo binario nativo que el instalador y no necesita Node.js en tiempo de ejecución. Por eso la instalación tampoco se interrumpe con una versión antigua de Node.js; npm solo muestra una advertencia con EBADENGINE. Si aún no tiene Node.js, el instalador nativo es la vía más corta.
node -v # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code # niemals mit sudo
# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latestDrei Regeln aus der Página de configuración: ninguno sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.
Comprobar la instalación
Para ello, abra una nueva ventana de terminal. Una ventana que ya estuviera abierta antes de la instalación aún no conoce el PATH ampliado y, por tanto, no encuentra claude.
claude --version # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor # Diagnose von Installation und Einstellungen, startet keine Sitzungclaude doctor es la herramienta que debe usar cuando algo no funciona correctamente. No inicia una sesión, pero muestra el estado de la instalación, los errores de los archivos de configuración y advertencias con propuestas de solución. Así podrá determinar si el problema está en la instalación o en la configuración.
Cuando la instalación presenta problemas
La descarga devuelve HTML o un 403
Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut Solución de problemas (Stand 3 de octubre de 2026) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.
No se encuentra «claude»
command not found: claude en macOS y Linux, o un claude no reconocido en Windows, significa que la carpeta de instalación falta en el PATH. Normalmente basta con abrir una ventana nueva. Si eso no ayuda en macOS o Linux, añada ~/.local/bin a ~/.zshrc o ~/.bashrc. En Windows, compruebe y añada la carpeta tal como indica la solución de problemas:
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Im neuen Fenster
claude --versionPowerShell bloquea npm.ps1
Esto solo afecta a la variante npm. El mensaje npm.ps1 cannot be loaded because running scripts is disabled on this system significa que la directiva de ejecución bloquea el script de inicio de npm. Puede ejecutar npm.cmd y claude.cmd, que no están sujetos a esa directiva, cambiar al instalador nativo o permitir scripts locales para su cuenta de usuario:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser¿Suscripción o clave API?
Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut Guía del gateway Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.
| Suscripción de Claude | Clave API de Kunavo | |
|---|---|---|
| Facturación | monatlich: Pro $20 oder $17 pro Monat bei jährlicher Zahlung ($200 im Voraus), Max ab $100, jeweils ohne etwaige Steuern (claude.com/de/pricing, Stand 3 de octubre de 2026) | por token con saldo prepagado, recarga desde $10, sin cuota mensual y sin caducidad |
| Adecuado para | uso diario durante horas | uso variable; un mes sin uso no cuesta nada |
| Pago | im Web nur Kredit- oder Debitkarte, in den iOS- und Android-Apps über App Store bzw. Google Play (Preguntas frecuentes sobre facturación de Anthropic, Stand 3 de octubre de 2026) | Tarjeta de débito y crédito (Visa, Mastercard), Apple Pay, Google Pay, Link; en Austria, EPS |
| Configuración | Iniciar claude e iniciar sesión en el navegador | seis variables de entorno, sin inicio de sesión |
| No incluye | — | Remote Control y dictado por voz |
El guide sobre el precio de Claude Code muestra a partir de cuándo Pro o Max resultan más rentables que la clave.
Configurar la clave API (sin suscripción)
Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics Lista de variables und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.
- Registrarse en Kunavo con una dirección de correo electrónico o una cuenta de Google.
- En Billing, recargue al menos $10 (consulte los métodos de pago en la sección correspondiente).
- En API-Keys, genere una clave. Comienza por
sk-kn-y solo se muestra una vez, así que cópiela inmediatamente. - Establezca las variables como se muestra a continuación.
Introducidas en ~/.zshrc o ~/.bashrc, las variables se aplican a cada nueva terminal en macOS, Linux y WSL:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # nur die Domain, ohne /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-5En PowerShell, las asignaciones de $env: solo se aplican a la ventana abierta, lo que resulta útil para una primera prueba:
# Gilt nur für dieses PowerShell-Fenster
$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"
claudeAuf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut Guía del gateway (Stand 3 de octubre de 2026) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:
{
"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"
}
}La extensión de VS Code lee las variables de claudeCode.environmentVariables en la configuración de usuario de VS Code (comando Preferences: Open User Settings (JSON)):
{
"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" }
]
}Qué hace cada variable
| Variable | Valor | Efecto | Si falta o es incorrecta |
|---|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | dirige todas las solicitudes a Kunavo; Claude Code añade /v1/messages automáticamente | Con /v1 al final, la solicitud se dirige a /v1/v1/messages y falla con 404. |
ANTHROPIC_AUTH_TOKEN | Su clave (sk-kn-…) | se envía como Authorization: Bearer y tiene prioridad inmediata | Quien establezca ANTHROPIC_API_KEY en su lugar (encabezado x-api-key) debe confirmar la clave una vez en el modo interactivo. Si se rechaza, Claude Code ignora la clave sin volver a preguntar; puede activarla de nuevo en /config → Use custom API key. Kunavo acepta la clave en ambos encabezados. |
ANTHROPIC_MODEL | claude-sonnet-5 | Modelo inicial de cada sesión | Sin ella, la sesión se inicia con el modelo del pin de Opus, es decir, Opus 5.5; si este también falta, se usa el predeterminado de Anthropic (actualmente también Opus 5.5). |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Objetivo de /model opus y versión que usa el valor predeterminado sin ANTHROPIC_MODEL | Sin ella, el alias sigue la indicación de Anthropic, actualmente también Opus 5.5; cuando aparezca un Opus más reciente, podría apuntar a un modelo que Kunavo aún no ofrezca. Opus 5.5 requiere Claude Code a partir de la versión 2.1.280; las versiones anteriores se actualizan con claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Objetivo de /model sonnet, fase de ejecución de opusplan y subagentes con model: sonnet | Sin ella, el alias para usuarios de la API apunta a Sonnet 5.5, que Kunavo no ofrece actualmente (a fecha de 3 de octubre de 2026): 404. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | Objetivo de /model haiku y modelo para funciones en segundo plano | Sin ella, el alias de Anthropic decide qué Haiku se ejecuta. |
Warum ein festes Startmodell? Laut Configuración del modelo (Stand 3 de octubre de 2026) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das cuesta por token el doble que Claude Sonnet 5. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token menos que Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.
Hay dos aspectos sobre el almacenamiento. La clave nunca debe estar en .claude/settings.json de un proyecto, porque, según la guía del gateway, este archivo se confirma en el repositorio y llega a cualquiera que lo clone. Además, si una exportación del shell y un bloque env establecen la misma variable, prevalece el archivo de configuración. Por tanto, si cambia una variable en el shell y no ocurre nada, probablemente el valor antiguo siga en settings.json.
Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 3 de octubre de 2026), jeweils pro 1 Mio. Tokens:
| Modelo | Kunavo (entrada / salida) | Precio de lista de Anthropic (entrada / salida) | Diferencia | Función en Claude Code |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30 % más barato | Alias haiku y tareas en segundo plano de Claude Code |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | ~30 % más barato | Modelo principal (ANTHROPIC_MODEL) para el trabajo diario |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30 % más barato | Alias opus con el modelo fijado arriba (refactorizaciones grandes, planificación); sin fijaciones, es el valor predeterminado para usuarios de la API |
claude-opus-5 | $3,50 / $17,50 | $5,00 / $25,00 | ~30 % más barato | Sin alias; solo de forma explícita con /model claude-opus-5 |
Todos los modelos y tarifas de Claude aparecen en la guía sobre los precios de la API de Claude y en la página de precios.
Primer inicio: comprobar con /status
Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, sin pantalla de inicio de sesión. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Guía del gateway: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.
En la sesión, /status muestra en la pestaña Status de dónde obtiene Claude Code la dirección y las credenciales. Hay dos líneas decisivas:
| Línea | Correcto | Si no |
|---|---|---|
Anthropic base URL | https://api.kunavo.com | La línea solo aparece cuando se ha establecido una dirección del gateway. Si falta, ANTHROPIC_BASE_URL no ha llegado a la sesión. |
Auth token | indica ANTHROPIC_AUTH_TOKEN | Si aparece Login method con una cuenta de claude.ai, la variable no se ha leído y la sesión funciona mediante su suscripción. |
También puede probar la conexión sin Claude Code, con la solicitud de la guía del gateway (aquí el modelo se establece en claude-sonnet-5). Solicita exactamente un token de salida y, por tanto, solo cuesta una cantidad mínima. Los comandos leen las variables del shell; si sus valores solo están en settings.json, expórtelos también para la prueba.
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": "."}]}'Si vuelve un JSON que comienza por {"id":"msg_, o en PowerShell un objeto con una id que comienza por msg_, la dirección y la clave son correctas. Un 401 significa que se rechazó la clave.
Qué cambia con una clave API
La mayor parte permanece igual: editar código, herramientas, subagentes, servidores MCP, hooks y el almacenamiento en caché de prompts funcionan como de costumbre. Debe conocer cuatro diferencias:
- Remote Control y el dictado por voz dejan de estar disponibles. Según la guía del gateway, ambos requieren una identidad de claude.ai y están bloqueados mientras
ANTHROPIC_AUTH_TOKENoANTHROPIC_API_KEYesté activo. Remote Control también está bloqueado desde la versión 2.1.196 cuandoANTHROPIC_BASE_URLapunta a un host fuera de Anthropic. /fastindica que el modo rápido no está disponible. Con solo un token Bearer, Claude Code lo trata como desactivado y ni siquiera envía la comprobación de disponibilidad.- La búsqueda de herramientas para MCP está desactivada. Laut Documentación de MCP (Stand 3 de octubre de 2026) schaltet Claude Code sie ab, sobald
ANTHROPIC_BASE_URLauf einen Drittanbieter zeigt; mitENABLE_TOOL_SEARCHlässt sie sich ausdrücklich einschalten. /contextmuestra valores estimados. Kunavo bietet/v1/messages/count_tokensnicht an. Ohne diesen Endpunkt zählt Claude Code laut Guía de compatibilidad del gateway (Stand 3 de octubre de 2026) anhand der Zeichen.
Encontrará más información sobre la integración en la guía de integración de Claude Code (en inglés).
Pagar sin PayPal ni SEPA
Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (Preguntas frecuentes sobre facturación). PayPal oder Venmo nimmt Anthropic laut dem Artículo de ayuda sobre tarjetas rechazadas nicht an (beides Stand 3 de octubre de 2026).
Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Documentación de Stripe sobre Adaptive Pricing (Stand 3 de octubre de 2026) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:
| Método de pago | Dónde | Nota |
|---|---|---|
| Tarjeta (Visa, Mastercard, Amex, JCB y UnionPay) | en todas partes | Tarjetas de crédito y débito, incluidas Visa Debit y Debit Mastercard; una girocard pura no |
| Apple Pay | Safari, iPhone y iPad; no disponible en India | con una tarjeta en Wallet, incluida una tarjeta de débito Visa o Mastercard; no una girocard exclusivamente |
| Google Pay | Chrome y Android con Google Pay configurado; no disponible en India | con una tarjeta en Wallet, incluida una tarjeta de débito Visa o Mastercard; no una girocard exclusivamente |
| Link | en todas partes excepto India | Servicio de pago de Stripe, guarda tu tarjeta; también permite la recarga automática |
| EPS | Austria, checkout en euros | Redirección a la banca en línea de su banco |
EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.
girocard: Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen marcas de tarjetas compatibles führt (Stand 3 de octubre de 2026). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.
No disponible: PayPal, domiciliación SEPA, transferencia bancaria manual (pago anticipado), giropay y Sofort. Klarna solo está disponible en el checkout para compradores de Estados Unidos; quienes cambien a dólares estadounidenses desde fuera de Estados Unidos tampoco verán Klarna.
- Crear una cuenta; Kunavo no solicita ninguna tarjeta durante el registro.
- En Billing, elija un nivel de recarga desde $10. Los niveles superiores incluyen saldo adicional: $100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250.
- En el checkout de Stripe, elija el método de pago. Verá el importe en euros antes de confirmarlo; con EPS, confirme en su banca en línea.
- En API-Keys, cree una clave e introdúzcala como
ANTHROPIC_AUTH_TOKEN.
El saldo se paga por adelantado: sin cuota mensual, sin caducidad y sin cargos por solicitudes fallidas. La recarga automática solo es posible con una tarjeta guardada o Link; con Apple Pay, Google Pay y EPS, debe recargar manualmente. Kunavo no emite facturas con el IVA desglosado; puede consultar sus recargas en Billing. Más información sobre métodos de pago y tarjetas rechazadas: Pagar Claude sin tarjeta de crédito.
Cuánto cuesta una sesión: ejemplo de cálculo
Con una clave API paga por tokens, y Claude Code envía el contexto completo acumulado en cada paso. Aun así, ese contexto no se cobra íntegramente cada vez: el modelo lee del caché el inicio que no ha cambiado, con la tarifa de lectura de caché más baja. La tabla calcula un patrón supuesto; no es una medición ni un límite superior. Supongamos:
- 40.000 tokens de entrada por solicitud, de los cuales 36.000 (90 %) se leen del caché y 4.000 se escriben por primera vez en el caché;
- 1.000 tokens de salida por solicitud;
- 50 solicitudes de este tipo por sesión de trabajo, sin contar las llamadas en segundo plano;
- La lectura de caché cuesta, para Claude Sonnet 5, 10 % de la tarifa de entrada, y la escritura de caché cuesta 1,25 veces más; cada modelo de la tabla se calcula con sus propios factores.
| Modelo | Una solicitud | 50 solicitudes | 50 solicitudes sin ningún acierto de caché |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,952 | $3,15 |
| Claude Opus 5 | $0,0476 | $2,38 | $7,88 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Lo que realmente paga depende de la longitud del contexto, los aciertos de caché y la longitud de la respuesta, así como de si empieza de nuevo entre dos tareas con /clear. Para sus propios valores, dispone de la calculadora de tokens de Claude (en inglés); la comparación con Pro y Max se calcula en la guía de precios de Claude Code.
Mensajes de error y su significado
| Mensaje | Significado y solución |
|---|---|
The token '&&' is not a valid statement separator | La línea de CMD está en la ventana de PowerShell. Allí debe usar irm … | iex. |
'irm' is not recognized as an internal or external command (o el mismo mensaje en alemán) | La línea de PowerShell está en CMD. Allí debe usar la línea con install.cmd. |
Claude Code does not support 32-bit Windows | Está abierta «Windows PowerShell (x86)». Elija la entrada sin (x86). |
syntax error near unexpected token '<' o 403 | En lugar del script se recibió una página web o un código de error. Compruebe la VPN, el proxy y el firewall de la empresa, o pruebe otra red. |
App unavailable in region | La conexión parece proceder de un país no compatible. En DE, AT y CH, normalmente se debe a una VPN o un proxy. |
No se reconoce command not found: claude ni claude | La carpeta de instalación falta en el PATH. Abra una ventana nueva; en Windows, use el comando de PATH indicado arriba. |
Advertencia EBADENGINE | Node.js es anterior a la versión 22. La instalación se completa de todos modos, aunque conviene actualizarlo. |
claude native binary not installed (macOS, Linux) | npm ha omitido las dependencias opcionales (--omit=optional, optional=false). Elimine la configuración y vuelva a instalar. |
npm.ps1 cannot be loaded | La directiva de ejecución bloquea npm. Use npm.cmd, ejecute la línea con Set-ExecutionPolicy o utilice el instalador nativo. |
| Aparece la pantalla de inicio de sesión aunque la clave está configurada | La clave solo está en la configuración del proyecto. Establézcala mediante export o en ~/.claude/settings.json y abra una terminal nueva. |
ANTHROPIC_API_KEY está configurada, pero no tiene efecto | Se rechazó la confirmación única. Actívela en /config → Use custom API key o cambie a ANTHROPIC_AUTH_TOKEN. |
401 | Se rechazó la clave. ¿La ha copiado completa y sin espacios, sigue estando disponible en /app/keys y está introducida en ANTHROPIC_AUTH_TOKEN? |
404 | ANTHROPIC_BASE_URL termina en /v1, o el modelo solicitado no existe en Kunavo, por ejemplo después de /model sonnet sin un pin de Sonnet. |
Límites de esta vía
- Se paga por token, no una tarifa fija. Quienes usan Claude Code durante horas todos los días suelen ahorrar con Pro o Max. Con un uso variable, solo paga lo que consume, y un mes sin uso no cuesta nada.
- Sin una cuenta de claude.ai no hay Remote Control ni dictado por voz;
/fastse considera desactivado y la búsqueda de herramientas para MCP está desactivada de forma predeterminada. - Kunavo no ofrece Sonnet 5.5 actualmente; por eso
/model sonnet,opusplany los subagentes de Sonnet necesitan el pin de Sonnet de los ejemplos anteriores. - Apple Pay, Google Pay y EPS solo sirven para recargar manualmente; la recarga automática solo funciona con tarjeta o Link. Los importes en euros incluyen la comisión de conversión de Stripe.
- Kunavo no emite facturas con el IVA desglosado.
- La documentación de Claude Code de Anthropic está disponible en alemán; la guía de integración de Kunavo solo está disponible en inglés.
Preguntas frecuentes
¿Cómo se instala Claude Code?
Abra un terminal y ejecute el comando oficial correspondiente a su sistema. En macOS, Linux y WSL: curl -fsSL https://claude.ai/install.sh | bash. En Windows PowerShell: irm https://claude.ai/install.ps1 | iex. En el símbolo del sistema de Windows (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Después, abra una ventana de terminal nueva y escriba claude --version. Si aparece un número de versión, Claude Code está instalado. Esta instalación nativa se mantiene actualizada automáticamente en segundo plano; las instalaciones mediante Homebrew o WinGet debe actualizarlas usted mismo.
Instalar Claude Code en Windows: ¿necesito WSL o permisos de administrador?
Ninguna de las dos cosas. Claude Code se ejecuta de forma nativa en Windows 10 a partir de la versión 1809 y en Windows Server 2019, y según Anthropic el instalador no necesita ejecutarse como administrador. WSL 2 solo merece la pena si necesita herramientas de Linux o sandboxing; en ese caso, instale e inicie Claude Code en el terminal de WSL. Git para Windows es opcional: con Git, Claude Code ejecuta los comandos en Git Bash, sin Git en PowerShell. Los problemas típicos son pegar la línea de CMD en la ventana de PowerShell (o al revés) y usar la entrada del menú Inicio «Windows PowerShell (x86)», que se cierra como proceso de 32 bits.
¿Necesito Node.js para Claude Code?
Solo si instala mediante npm, y entonces necesita Node.js 22 o posterior. Las guías antiguas suelen mencionar Node.js 18, pero esa información está desactualizada. El instalador nativo, Homebrew y WinGet funcionan sin Node.js. Si su Node.js es demasiado antiguo, npm muestra la advertencia EBADENGINE, pero aun así instala el paquete. No instale nunca con sudo y actualice con npm install -g @anthropic-ai/claude-code@latest en lugar de npm update -g.
¿Puedo usar Claude Code sin una suscripción?
Sí, con una clave de API. Para iniciar sesión necesita Pro, Max, Team, Enterprise o una cuenta de Console; el plan gratuito de Claude no incluye Claude Code. Con Kunavo, configure en su lugar ANTHROPIC_BASE_URL=https://api.kunavo.com y ANTHROPIC_AUTH_TOKEN, y Claude Code se iniciará sin mostrar la pantalla de inicio de sesión. Cada token se descuenta de un saldo prepago que puede recargar desde $10; no hay cuota mensual. Tendrá que prescindir de Remote Control y del dictado por voz, ya que ambos requieren una cuenta de claude.ai.
¿Cómo configuro una clave de API en Claude Code?
Lo más recomendable es hacerlo en el bloque env de ~/.claude/settings.json (en Windows, %USERPROFILE%\.claude\settings.json); como alternativa, use líneas export en ~/.zshrc o ~/.bashrc. Necesita seis valores: ANTHROPIC_BASE_URL=https://api.kunavo.com sin /v1 (de lo contrario, la solicitud se enviará a /v1/v1/messages y fallará con 404), ANTHROPIC_AUTH_TOKEN con su clave, además de ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 y ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5. ANTHROPIC_AUTH_TOKEN entra en vigor de inmediato. ANTHROPIC_API_KEY también funciona, ya que Kunavo acepta la clave en ambos encabezados, pero en modo interactivo debe confirmarse una vez. No escriba nunca la clave en el .claude/settings.json de un proyecto, ya que ese archivo se comparte con el repositorio.
¿Qué modelo utiliza Claude Code con una clave de API?
El modelo que usted configure. Sin una configuración explícita, Claude Code se inicia para los usuarios de la API, según Anthropic (a fecha de 3 de octubre de 2026), con Opus 5.5. Kunavo ofrece Opus 5.5, que cuesta por token el doble que Claude Sonnet 5. Con ANTHROPIC_MODEL=claude-sonnet-5, Claude Sonnet 5 se convierte en el modelo inicial; una solicitud del ejemplo de cálculo de esta página cuesta aproximadamente $0,019. ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 determina qué modelo inicia /model opus; Opus 5.5 requiere Claude Code a partir de la versión 2.1.280, y una instalación anterior se actualiza ejecutando claude update. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 también es necesario, porque el alias sonnet apunta a Sonnet 5.5 para los usuarios de la API y Kunavo no ofrece Sonnet 5.5: sin esta línea, /model sonnet, la fase de ejecución de opusplan y los subagentes con model: sonnet terminan con un error 404. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 también se aplica a las tareas en segundo plano.
¿Cómo sé en /status que Claude Code está utilizando la clave de API?
Escriba /status en la sesión activa y consulte la pestaña Status. La línea Anthropic base URL debe mostrar https://api.kunavo.com, y la línea Auth token debe mencionar ANTHROPIC_AUTH_TOKEN. Si falta la línea de la URL base, la variable no ha llegado a la sesión. Si aparece Login method con una cuenta de claude.ai, la sesión utiliza su suscripción. Si la pantalla de inicio de sesión aparece ya en el primer inicio, es probable que la clave solo esté en la configuración del proyecto, que Claude Code evalúa después del asistente de configuración.
¿Puedo pagar Claude Code con PayPal, débito SEPA, girocard o EPS?
Para el saldo de Kunavo: EPS sí, si paga en euros desde Austria. PayPal y el débito SEPA no están disponibles, y Klarna solo para compradores en Estados Unidos. Una girocard exclusivamente falla porque Stripe no reconoce girocard como marca de tarjeta. Si su tarjeta también lleva el logotipo de Visa o Mastercard, puede pagar mediante esa red, incluso con Apple Pay o Google Pay. También se aceptan tarjetas de crédito y débito, así como Link. Importe mínimo $10, sin cuota mensual y el saldo no caduca; según Stripe, el importe en euros incluye una comisión de conversión del 2–4 %. La recarga automática solo funciona con una tarjeta guardada o Link. Kunavo no emite facturas con el IVA desglosado. De este modo no puede pagar una suscripción Claude Pro o Max; la propia Anthropic solo acepta tarjetas en la web y no PayPal.