Instalación de Claude Code: paso a paso en Windows, macOS y Linux, clave API sin suscripción y pago con tarjeta

Respuesta breve: Claude Code se instala con una sola línea adecuada para tu terminal. En macOS, Linux y WSL ejecutas install.sh, en Windows PowerShell irm … | iex y en el símbolo del sistema (CMD) install.cmd; las tres aparecen justo debajo. Esta vía no requiere Node.js; si quieres instalarlo con npm, necesitas Node.js 22 o posterior. Después de la instalación hay dos opciones: iniciar sesión con una cuenta de Claude (Pro, Max, Team, Enterprise o Console; el plan gratuito no incluye Claude Code) o usar una clave de API sin contratar una suscripción. Con la vía de la clave, defines ANTHROPIC_BASE_URL=https://api.kunavo.com (sin añadir /v1 al final), ANTHROPIC_AUTH_TOKEN y las cuatro variables que fijan los modelos; /status muestra en la sesión si la clave está activa. Solo se cobran los tokens consumidos. Puedes recargar el saldo con una tarjeta Visa o Mastercard, Apple Pay, Google Pay o Link, por un mínimo de 10 USD; no hay opción de pago a plazos ni Papara.

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

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

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un instalación ve conexión al gateway belgelerinden 3 de octubre de 2026 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 3 de octubre de 2026 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: página de países compatibles de Anthropic Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 3 de octubre de 2026).

¿Qué línea corresponde a cada terminal?

La mayoría de quienes se atascan durante la instalación se equivocan de terminal, no de comando. La tabla siguiente relaciona tu entorno con la línea correcta. Si usas Windows, en la sección siguiente explicamos cómo identificar el terminal.

Requisitos del sistema

Lo que exige la documentación oficial de instalación (a fecha de 3 de octubre de 2026):

• Sistema operativo: macOS 13.0 o posterior; Windows 10, versión 1809 o posterior, o Windows Server 2019 o posterior; en Linux, Ubuntu 20.04, Debian 10 y Alpine Linux 3.19 o posterior.
• Hardware: al menos 4 GB de RAM y un procesador x64 o ARM64. Windows de 32 bits no es compatible.
• Shell: Bash, Zsh, PowerShell o CMD.
• Node.js: no es necesario para el instalador nativo; solo se necesita la versión 22 o posterior para la vía de npm.
• Cuenta: si vas a iniciar sesión, necesitas Pro, Max, Team, Enterprise o Console. Con una clave de API no se necesita suscripción ni inicio de sesión.

Parte de las guías en turco que circulan por Internet copia una versión antigua de esta lista: todavía hay algunas que indican Node.js 18 para npm y Ubuntu 18.04 o CentOS 7 para Linux. La documentación actual indica Node.js 22 y Ubuntu 20.04 como versiones mínimas. La advertencia de que “cada paso falla sin un proxy fijo con salida de EE. UU.” tampoco se aplica a Turquía; al contrario, una VPN abierta puede provocar un error de región (consulta los errores de descarga de las secciones de macOS y Linux).

Instalación de Claude Code en Windows

En Windows no necesitas permisos de administrador, WSL ni Git. La documentación oficial no pide abrir el terminal como administrador; puedes omitir el paso “ejecuta PowerShell como administrador” de algunos vídeos en turco. Lo único que debes saber es en qué terminal estás:

• Si el indicador empieza por PS C:\Users\KullaniciAdi> como PS, estás en PowerShell: usa la línea irm … | iex.
• Si no aparece PS al principio y solo ves C:\Users\KullaniciAdi>, estás en el símbolo del sistema: usa la línea install.cmd.
• No abras la entrada “Windows PowerShell (x86)” del menú Inicio. Como es un proceso de 32 bits, también produce el error Claude Code does not support 32-bit Windows en un equipo de 64 bits; elige “Windows PowerShell” sin el sufijo.

Pegar la línea en la ventana equivocada es una de las principales causas de errores en Windows, y los mensajes no siempre lo indican claramente. La línea de CMD pegada en PowerShell devuelve The token '&&' is not a valid statement separator. La línea de PowerShell pegada en CMD muestra en Windows turco «'irm' no se reconoce como un comando interno o externo, programa ejecutable o archivo por lotes» (en un sistema en inglés, 'irm' is not recognized as an internal or external command). Si pruebas la línea curl … | bash de macOS en PowerShell, verás A parameter cannot be found that matches parameter name 'fsSL' o 'bash' is not recognized as the name of a cmdlet; en un sistema turco, estos textos pueden aparecer en turco. En los tres casos, la solución es la misma: usa la línea correspondiente al terminal en el que estás.

¿Son necesarios Git for Windows y WSL?

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

Hay dos razones para elegir WSL: necesitar herramientas de Linux o querer ejecutar comandos en un entorno aislado (sandbox). La instalación nativa de Windows no tiene sandbox:

Si vas a quedarte en WSL, realiza tanto la instalación como el uso en el terminal de WSL: allí funciona la línea de macOS/Linux y desde allí también se inicia claude.

No se encuentra el comando “claude”

Si, después de terminar la instalación, ves 'claude' is not recognized (en macOS y Linux, command not found: claude), lo más probable es que estés trabajando en una ventana abierta antes de la instalación: el instalador actualiza la variable PATH, pero el terminal antiguo no lo ve. Primero cierra y vuelve a abrir el terminal. En Windows, el programa se encuentra en %USERPROFILE%\.local\bin\claude.exe; en macOS y Linux, en ~/.local/bin/claude. Si en Windows tampoco funciona una ventana nueva, añade la carpeta a la variable de usuario PATH con los comandos de la documentación:

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

No se puede cargar npm.ps1

Este mensaje solo aparece con la vía de npm: npm escribe un iniciador .ps1 para PowerShell y la política de ejecución de scripts del sistema lo bloquea. La documentación ofrece tres salidas: ejecutar los comandos con los nombres npm.cmd y claude.cmd, cambiar al instalador nativo en PowerShell o permitir scripts locales solo para tu propio usuario:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalación en macOS y Linux

La línea install.sh anterior aparece en la documentación oficial en la pestaña “Native Install (Recommended)” y también funciona exactamente igual en WSL. Con esta vía, Claude Code descarga por sí mismo las nuevas versiones en segundo plano. Si prefieres usar un gestor de paquetes, Homebrew y WinGet también son opciones oficiales; sin embargo, según la documentación, esas instalaciones no se actualizan automáticamente de forma predeterminada, por lo que debes obtener la nueva versión mediante el gestor de paquetes:

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Si llega HTML o un 403 en lugar del script

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. Documentación sobre problemas de instalación (kontrol: 3 de octubre de 2026) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

Instalación con npm: Node.js 22 es obligatorio

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

En esta vía, tres hábitos causan problemas:

• Instalar con sudo. La documentación advierte sobre problemas de permisos y riesgos de seguridad para sudo npm install -g.
• Actualizar con npm update -g. Lo correcto es npm install -g @anthropic-ai/claude-code@latest.
• Desactivar las dependencias opcionales. El ejecutable principal llega como dependencia opcional mediante un paquete @anthropic-ai/claude-code-* específico de la plataforma. La bandera --omit=optional o optional=false dentro de .npmrc omite este paquete: la instalación termina sin errores, pero al iniciar claude en macOS y Linux aparece claude native binary not installed.

¿La instalación funcionó?

Sea cual sea la vía elegida, abre un terminal nuevo y ejecuta estos dos comandos:

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Si claude --version muestra un número de versión, el programa está instalado. claude doctor enumera el estado de la instalación y los problemas de los archivos de configuración sin iniciar sesión; si algo falla en el siguiente paso, aquí puedes distinguir si el problema está en la instalación o en la configuración.

Sin suscripción: configurar una clave de API para Claude Code

claude solicita autenticación al abrirse por primera vez. Si tienes un plan de Claude, inicia sesión y continúa; si no tienes un plan o prefieres pagar según el uso en lugar de una cuota mensual fija, ejecuta Claude Code con una clave de API. La diferencia entre las dos vías es:

La vía de la clave es una configuración prevista por Anthropic: ANTHROPIC_BASE_URL es la variable integrada de Claude Code y la documentación oficial del gateway explica con esta variable cómo ejecutar Claude Code detrás de un proxy o gateway. No instalas ningún plugin, parche ni cliente modificado. En macOS y Linux, añade las seis líneas a tu archivo de shell (~/.zshrc o ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Antes de hacer permanentes los ajustes en Windows, pruébalos en una sola sesión de PowerShell; cuando se cierre la ventana, las variables también desaparecerán:

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

Si desea que sea válido en cada terminal, escriba los mismos valores en el bloque env del archivo de configuración del usuario. Según la documentación, este archivo se aplica a todos sus proyectos; en Windows se encuentra en %USERPROFILE%\.claude\settings.json. %APPDATA%\Claude\settings.json, que aparece en algunos resúmenes de IA, no es la ruta de la documentación oficial. Si el archivo ya existe, añada únicamente el bloque env sin borrar su contenido:

{
  "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"
  }
}

Seis variables y aspectos que debe tener en cuenta

ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY? La clave de Kunavo se acepta con ambos encabezados: Authorization: Bearer y x-api-key. La diferencia está en el comportamiento de Claude Code. ANTHROPIC_AUTH_TOKEN se envía con el encabezado Bearer y funciona sin solicitar confirmación. ANTHROPIC_API_KEY se envía con el encabezado x-api-key y, en modo interactivo, solicita su confirmación la primera vez; si responde «no» a esa pregunta, la clave se ignora sin advertencia. Para volver a activarla, debe ir a /config → Use custom API key. Por eso usamos ANTHROPIC_AUTH_TOKEN en esta guía.

¿Por qué fijamos los modelos? Documento de configuración de modelos göre (kontrol: 3 de octubre de 2026) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 3 de octubre de 2026 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.

Tarifas de Kunavo (entrada / salida, por 1 millón de tokens): Claude Sonnet 5 $1,40 / $7,00 (tarifa de Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; para las tareas en segundo plano, Claude Haiku 4.5 $0,70 / $3,50.

¿Dónde no se escribe la clave y qué valor prevalece?

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: documentación del gateway bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

Primer inicio y comprobación de /status

Si las variables están en el lugar correcto, el comando claude inicia la sesión sin mostrar la pantalla de inicio de sesión; así describe el comportamiento la documentación del gateway (comprobación: 3 de octubre de 2026) cuando ANTHROPIC_AUTH_TOKEN está configurado. Si aparece la pantalla de inicio de sesión, Claude Code no ha detectado la clave. Una causa frecuente es que la clave solo esté en la configuración del proyecto: en modo interactivo, el bloque env del archivo .claude/settings.json o .claude/settings.local.json del proyecto se lee después de completar el asistente de primera ejecución y la pregunta de confianza en la carpeta. La clave debe estar en un lugar que se lea antes del asistente: export en el shell, ~/.claude/settings.json a nivel de usuario o en la configuración administrada (managed settings).

Cuando haya iniciado sesión, escriba /status. Dos líneas proporcionan la información necesaria:

• Anthropic base URL: solo aparece si se ha definido una dirección personalizada y debe mostrar https://api.kunavo.com. Si la línea no aparece, ANTHROPIC_BASE_URL no ha llegado a la sesión.
• Auth token: si junto a ella aparece el nombre ANTHROPIC_AUTH_TOKEN, las solicitudes se envían con la clave de API. Si, en su lugar, aparece una línea Login method que muestra su cuenta de claude.ai, Claude Code sigue utilizando el inicio de sesión guardado; cierre la sesión, abra un terminal nuevo y compruebe dónde escribió las variables.

Probar sin abrir Claude Code

También puede probar la dirección y la clave independientemente de Claude Code. El método de la documentación oficial consiste en enviar una solicitud con un token de salida; se descontará una cantidad muy pequeña de su saldo. El comando lee las variables del shell actual; si la clave solo está en el archivo de configuración, ejecute primero export en este terminal. Si la respuesta comienza por {"id":"msg_, la dirección y la clave son válidas; 401 indica que la clave ha sido rechazada.

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": "."}]}'

A continuación se muestra la alternativa para PowerShell; si tiene éxito, la respuesta incluirá un campo id que comienza por msg_:

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": "."}]}'

¿Qué cambia con una clave de API?

• Remote Control y el dictado por voz no están disponibles. Según la documentación, ambos requieren una identidad de claude.ai y no funcionan cuando ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN o un apiKeyHelper están activos. Desde v2.1.196, Remote Control también está desactivado cuando ANTHROPIC_BASE_URL apunta a un servidor que no es de Anthropic.
• /fast aparece desactivado. Según la documentación, cuando solo se define un bearer token, Claude Code no pregunta por el estado del modo rápido (fast mode) y lo considera desactivado.
• La búsqueda de herramientas MCP está desactivada de forma predeterminada. documentación de MCP (kontrol: 3 de octubre de 2026) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• Las cifras de /context son aproximadas. Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, documentación de compatibilidad del gateway göre (kontrol: 3 de octubre de 2026) bağlam kullanımını karakter sayısından tahmin eder.

Los detalles técnicos de la integración están en la documentación de integración de Claude Code en inglés; la versión en inglés de esta guía es Install Claude Code.

Pagos desde Turquía: tarjeta, Apple Pay, Google Pay y Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (Preguntas frecuentes sobre los planes de pago de Claude, kontrol: 3 de octubre de 2026). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Regístrese en Kunavo. Basta con una dirección de correo electrónico o una cuenta de Google; no se solicitan datos de tarjeta durante el registro.
2. Seleccione el importe en la página Billing. El mínimo es 10 USD; no hay suscripción ni cuota mensual. En los importes elevados se añade un bonus: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye.
3. Se abrirá la página de pago de Stripe. Elija entre tarjeta (Visa, Mastercard), Apple Pay, Google Pay o Link; Apple Pay y Google Pay solo se muestran en dispositivos y navegadores compatibles con ellos.
4. Después, en la página API Keys, genere una clave que comience por sk-kn-. La clave solo se muestra una vez; cópiela y escríbala inmediatamente en el valor ANTHROPIC_AUTH_TOKEN.

¿El importe aparece en liras turcas o en dólares?

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. documentación de Adaptive Pricing de Stripe (kontrol: 3 de octubre de 2026) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

Pago a plazos, Papara, transferencia bancaria y Troy

• No hay pago a plazos; el pago se realiza en un solo cargo. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 3 de octubre de 2026).
• No se admiten Papara, transferencias bancarias/EFT ni PayPal. Estas opciones no aparecen en la página de pago.
• Troy: Stripe'ın marcas de tarjetas compatibles sayfasında Troy geçmiyor (kontrol: 3 de octubre de 2026). Visa ya da Mastercard logolu bir kartla ödeyin.
• No se emiten facturas. Kunavo no emite ninguna factura, incluida la factura electrónica e-Arşiv; el detalle de sus recargas se conserva en la página Billing.

Si se rechaza la tarjeta, consulte primero la aplicación móvil de su banco: la tarjeta debe estar habilitada para compras en línea y operaciones internacionales. La recarga automática solo puede configurarse con una tarjeta guardada o Link. El saldo no caduca y las solicitudes fallidas no se cobran. Las tarifas de todos los modelos aparecen en la guía Precios de la API de Claude.

¿Cuánto cuesta una sesión de trabajo?

Con una clave, el coste depende por completo del número de tokens. Claude Code envía el contexto de la conversación desde el principio en cada solicitud; cuando la parte inicial invariable del contexto se lee desde la caché, se factura a una tarifa mucho más baja. La tabla siguiente no es una medición, sino un cálculo basado en supuestos explícitos; tampoco debe interpretarse como un límite superior. Supuestos:

• 40.000 tokens de entrada por solicitud; de ellos, se leen 36.000 (%90) desde la caché y los 4.000 restantes se escriben en la caché;
• 1.000 tokens de salida por solicitud;
• 50 solicitudes en la sesión; no se contabilizaron las Claude Haiku 4.5 llamadas en segundo plano;
• Para Claude Sonnet 5, la lectura desde la caché cuesta %10 de la tarifa de entrada y la escritura en la caché cuesta 1,25 veces esa tarifa. Cada modelo de la tabla se calculó con sus propias tarifas.

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. documentación oficial de costes (kontrol: 3 de octubre de 2026) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

Todas las tarifas están en la página de precios. Puede estimar su propio uso con la calculadora de costes de tokens de Claude (en inglés). La guía Precio de Claude Code analiza si le conviene más una suscripción o la API.

Mensajes de error y soluciones

Limitaciones que debe conocer

• Kunavo no emite facturas; tampoco ofrece e-Arşiv.
• El pago se realiza en un solo cargo: no hay pago a plazos, Papara ni transferencias bancarias/EFT. Para la recarga automática se necesita una tarjeta guardada o Link.
• No se trata de una suscripción Claude Pro o Max, sino de una API que se paga por token. Con una clave, Remote Control y el dictado por voz no funcionan, /fast aparece desactivado y la búsqueda de herramientas MCP está desactivada de forma predeterminada.
• Kunavo no ofrece Sonnet 5.5 a partir de 3 de octubre de 2026; si no se fijan los modelos, el alias sonnet devuelve un error 404.
• La documentación oficial de Claude Code y la documentación de integración de Kunavo solo están disponibles en inglés (comprobación: 3 de octubre de 2026).

Preguntas frecuentes