Volver a las guías
Instalación·3 de octubre de 2026·13 min de lectura

Instalar Claude Code: comandos de instalación en Windows y macOS, configuración de la clave de API sin plan Pro/Max y pago con tarjeta o Link

Instalar Claude Code solo requiere un comando oficial. Lo más fácil de pasar por alto son los pasos posteriores: la versión de Node.js al instalar con npm, el terminal y PATH en Windows, la configuración de la clave de API sin un plan Pro/Max y cómo pagar desde Vietnam cuando no tienes MoMo, ZaloPay ni VNPay.

Si quieres usar Claude Code sin comprar un plan Pro o Max, debes hacer tres cosas: instalarlo con el comando nativo oficial (una línea para cada tipo de terminal, justo debajo), configurar ANTHROPIC_BASE_URL=https://api.kunavo.com (sin /v1) junto con ANTHROPIC_AUTH_TOKEN y las cuatro variables que fijan el modelo, y escribir /status para comprobar que Claude Code funciona con la clave. El coste de los tokens se descuenta del saldo prepagado, recargado desde 10 USD con una tarjeta Visa/Mastercard o Link; MoMo, ZaloPay y VNPay no están disponibles. Para instalarlo con npm, el equipo necesita Node.js 22 o posterior.

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Lệnh cài và tên biến trong bài lấy từ tài liệu chính thức của Claude Code, gồm página de instalación và lista de variables de entorno, đọc lại ngày 3 de octubre de 2026. Anthropic chưa có bản tiếng Việt của các trang này (đường dẫn /docs/vi/setup báo 404 cùng ngày), nên thông báo lỗi trong bài được giữ nguyên tiếng Anh để bạn tìm cho dễ. Giá và cách thanh toán của Kunavo được kiểm tra ngày 3 de octubre de 2026.

Elige el comando de instalación según el terminal abierto

Todos los métodos de instalación producen el mismo programa claude; la diferencia está en quién se encarga de las actualizaciones. La documentación oficial coloca el método nativo en la pestaña «Native Install (Recommended)», y también es el único método que se actualiza automáticamente sin que tengas que hacer nada.

Estás enUsa el comandoActualizaciones
macOS, Linux o un terminal WSLinstall.sh (primera línea de arriba)Automáticas, en segundo plano
Windows PowerShell, con un indicador como PS C:\Users\TenBan>irm https://claude.ai/install.ps1 | iexAutomáticas, en segundo plano
Windows CMD, con un indicador como C:\Users\TenBan> (sin PS)La línea que contiene install.cmdAutomáticas, en segundo plano
Ya estás familiarizado con Homebrew o WinGetbrew install --cask claude-code, winget install Anthropic.ClaudeCodeNo se actualiza automáticamente por defecto; actualiza mediante el propio gestor de paquetes
Es necesario usar npmnpm install -g @anthropic-ai/claude-code, requiere Node.js 22+Vuelve a ejecutarlo con @latest
# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code

# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCode

El equipo debe cumplir las siguientes condiciones (según la página de instalación, consultada el 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; Ubuntu 20.04+, Debian 10+ o Alpine Linux 3.19+.
  • Como mínimo, 4 GB de RAM y CPU x64 o ARM64. Windows de 32 bits no es compatible.
  • El shell debe ser Bash, Zsh, PowerShell o CMD, y debe haber conexión a Internet.
  • Node.js solo es necesario al instalar mediante npm y debe ser la versión 22 o posterior.

Después de instalarlo, no escribas claude inmediatamente en la ventana antigua: esa ventana aún no ha recibido el nuevo PATH. Abre otro terminal y ejecuta:

claude --version   # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor      # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việc

Si claude --version muestra un número de versión, la instalación ha terminado; cualquier error posterior es un problema de configuración. claude doctor resulta útil cuando no estás seguro de dónde está el error, porque comprueba tanto la instalación como los archivos de configuración sin abrir ninguna sesión de trabajo.

Windows: cinco obstáculos frecuentes

  1. Pegar la línea de comando equivocada. PowerShell mostrará The token '&&' is not a valid statement separator si recibe una línea de CMD; CMD mostrará 'irm' is not recognized as an internal or external command si recibe una línea de PowerShell. Mira el indicador: si aparece PS, usa la línea irm; si no, usa la línea install.cmd.
  2. Abrir por error «Windows PowerShell (x86)». Esta entrada del menú Inicio es un proceso de 32 bits, por lo que incluso en un equipo de 64 bits mostrará Claude Code does not support 32-bit Windows. Elige la entrada sin (x86).
  3. Ejecutarlo con permisos de Administrador es innecesario. La documentación no lo exige, y la versión nativa se instala en la carpeta del usuario: %USERPROFILE%\.local\bin\claude.exe.
  4. Escribir claude muestra «not recognized». La carpeta anterior aún no se ha añadido a PATH. Prueba primero con un terminal nuevo; si el error persiste, usa el fragmento de PowerShell siguiente para comprobar y añadir la ruta. En macOS/Linux, el error equivalente es command not found: claude y el programa se encuentra en ~/.local/bin/claude.
  5. npm muestra npm.ps1 cannot be loaded because running scripts is disabled on this system. La execution policy de PowerShell está bloqueando el script .ps1 que npm crea. La documentación ofrece tres opciones: permitir que el usuario actual ejecute scripts locales mediante el comando Set-ExecutionPolicy siguiente, invocar npm.cmd y claude.cmd en lugar de la versión .ps1, o abandonar npm y usar el comando nativo.
PowerShell
# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Trong terminal mới
claude --version
PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

¿Nativo o WSL? Dự án sống trên Windows thì chạy native là đủ. Lúc đó Git for Windows là tùy chọn: có nó, Claude Code chạy lệnh qua Git Bash; không có, nó dùng PowerShell. Nếu Git đã cài mà Claude Code không thấy Git Bash, khai báo CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, trỏ tới bash.exe (tài liệu lấy ví dụ C:\Program Files\Git\bin\bash.exe). Chọn WSL 2 khi bạn cần công cụ Linux hoặc muốn lệnh chạy trong sandbox, vì sandbox chỉ có trên WSL 2; Windows native và WSL 1 đều không có. WSL 1 chỉ là phương án khi máy không bật được WSL 2. Đã chọn WSL thì cài bằng dòng install.sh và chạy claude hoàn toàn trong terminal WSL.

Instalar mediante npm: requisitos y tres notas

npm hợp lý khi bạn đã quản lý công cụ dòng lệnh bằng Node, hoặc khi mạng công ty chỉ cho tải gói qua registry npm. Điều kiện là Node.js 22 o posterior; con số Node 18 trong nhiều bài cũ không còn đúng. Đáng chú ý là Node cũ hơn không làm hỏng việc cài: npm chỉ in cảnh báo EBADENGINE, vì thứ thật sự chạy là một chương trình native mà gói npm tải về, không phụ thuộc Node. Máy chưa có Node thì lấy bản 22+ ở nodejs.org.

Terminal
node -v                                    # cần v22 trở lên
npm install -g @anthropic-ai/claude-code   # không dùng sudo

# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest
  • No uses sudo npm install -g: la documentación advierte que este método provoca errores de permisos y supone un riesgo de seguridad.
  • Actualiza mediante npm install -g @anthropic-ai/claude-code@latest; npm update -g no es el método recomendado.
  • El programa nativo procede de una dependencia opcional (el paquete @anthropic-ai/claude-code-* correspondiente a tu plataforma). La opción --omit=optional, la línea optional=false en .npmrc o --ignore-scripts harán que falte, y en macOS/Linux recibirás claude native binary not installed.

¿Se necesita una VPN? Errores al descargar el script de instalación

Không cần. Việt Nam nằm trong lista de países compatibles con Anthropic cho cả Claude.ai lẫn API (kiểm tra ngày 3 de octubre de 2026). Chính VPN mới hay gây chuyện: theo página de solución de problemas de instalación (đọc ngày 3 de octubre de 2026), khi địa chỉ cài đặt trả về App unavailable in region, Claude Code không khả dụng ở nơi mà kết nối của bạn được nhìn thấy. Ở Việt Nam mà gặp dòng này thì tắt VPN hoặc proxy đặt ở nước khác rồi chạy lại.

Los otros dos errores tienen el mismo origen: syntax error near unexpected token '<' o curl: (22) The requested URL returned error: 403 significa que, en lugar del script, has recibido una página HTML o un código de error. Una red corporativa con un proxy o un cortafuegos que bloquee la descarga de archivos es el primer sospechoso. No cambies de inmediato a Homebrew, WinGet o npm: la documentación recomienda comprobar primero la conexión de red, porque los métodos de instalación alternativos también descargan los archivos del mismo servidor. Prueba otra red o pide al departamento de TI que quite el bloqueo.

Configurar la clave de API: ejecutar Claude Code sin un plan Pro/Max

Claude Code se autentica de una de dos maneras. La tabla siguiente ofrece una comparación rápida; el resto del artículo sigue la columna de la derecha.

Iniciar sesión en una cuenta de ClaudeClave de API de Kunavo
RequisitosPlan Pro, Max, Team, Enterprise o una cuenta de Console. El plan gratuito de Claude.ai no incluye Claude Code.Una clave sk-kn-… en una variable de entorno. No compres un plan ni inicies sesión.
FacturaciónTheo tháng: Pro 20 USD/tháng (17 USD/tháng nếu trả năm, tức 200 USD một lần), Max từ 100 USD/tháng, chưa gồm thuế (claude.com/pricing, đọc ngày 3 de octubre de 2026).Según los tokens realmente utilizados, descontados del saldo prepagado desde 10 USD. Sin cuota mensual, el saldo no caduca y las solicitudes fallidas no se cobran.
Pagar conMua trên web của Anthropic thì chỉ thẻ tín dụng hoặc ghi nợ (Preguntas frecuentes sobre pagos de Claude, đọc ngày 3 de octubre de 2026).Tarjetas Visa, Mastercard y Link; Apple Pay o Google Pay si el dispositivo lo admite. No se admiten MoMo, ZaloPay ni VNPay.
Qué falta—Remote Control y dictado por voz. No se emiten facturas de IVA.

Dirigir Claude Code a un servicio distinto de Anthropic no es un truco: la documentación oficial describe ANTHROPIC_BASE_URL como la variable que sobrescribe el endpoint de la API al pasar por un proxy o gateway. Kunavo utiliza el protocolo Anthropic Messages API exacto, por lo que puedes usar Claude Code tal cual, sin plugins ni parches. Se necesitan exactamente seis variables:

VariableValorPara qué sirve; qué ocurre si es incorrecta
ANTHROPIC_BASE_URLhttps://api.kunavo.comSolo el dominio. Claude Code añade automáticamente /v1/messages; si agregas /v1, la solicitud se convierte en /v1/v1/messages y devuelve 404.
ANTHROPIC_AUTH_TOKENClave sk-kn-…Se envía en el encabezado Authorization: Bearer, tiene efecto inmediato y no requiere un paso de confirmación.
ANTHROPIC_MODELclaude-sonnet-5Modelo principal (Claude Sonnet 5). El nombre debe coincidir carácter por carácter con la lista de Kunavo; los nombres antiguos con sufijo de fecha no se convierten automáticamente.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5Fija el alias opus (y opusplan cuando estés en modo de plan) en Claude Opus 5.5, para que no cambie al Opus más reciente. Se necesita Claude Code v2.1.280 o posterior; en versiones anteriores, ejecuta claude update.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5El alias sonnet apunta de forma predeterminada a Sonnet 5.5, un modelo que Kunavo no ofrece. Si no lo fijas, /model sonnet, la fase de ejecución de opusplan y los subagentes configurados con model: sonnet devuelven 404.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5El alias haiku y las tareas en segundo plano de Claude Code utilizan este modelo.

Dónde definir las variables

La forma más sencilla de usarlo a largo plazo es el bloque env en el archivo de configuración del usuario, ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Este archivo se aplica a todos los proyectos; si ya contiene contenido, añade únicamente el bloque env:

~/.claude/settings.json
{
  "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"
  }
}

Si prefieres mantenerlo en el shell, añádelo a ~/.zshrc o ~/.bashrc. En Windows, el segundo fragmento de abajo (las líneas $env:) sirve para probar rápidamente, pero las variables desaparecen al cerrar la ventana de PowerShell.

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # chỉ tên miền, không thêm /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
PowerShell
# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$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

Tres cosas que conviene saber antes de tener problemas:

  • No pongas la clave en .claude/settings.json del proyecto. Documentación sobre la conexión al gateway nhắc rằng file này được commit, ai clone repo cũng có.
  • El archivo de configuración tiene prioridad sobre el shell. Si una variable aparece en ambos lugares, se utiliza el valor del bloque env del archivo de configuración. Si cambias el shell y no ves ningún cambio, revisa primero el archivo de configuración.
  • La primera ejecución necesita la clave a nivel de usuario. En modo interactivo, el bloque env de .claude/settings.json o .claude/settings.local.json del proyecto solo funciona después del asistente inicial y de responder si confías en la carpeta. Si la clave solo está allí, en el primer inicio seguirá apareciendo la pantalla de inicio de sesión.

ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY, y el asunto del «error 403»

Kunavo đọc key ở cả Authorization: Bearer lẫn x-api-key, nên biến nào cũng kết nối được. Khác biệt nằm ở phía Claude Code. Theo documentación sobre variables de entorno (đọc ngày 3 de octubre de 2026), ANTHROPIC_AUTH_TOKEN đi vào header Authorization với tiền tố Bearer và có hiệu lực ngay. ANTHROPIC_API_KEY đi vào header X-Api-Key, và ở chế độ tương tác Claude Code hỏi bạn một lần có dùng key này thay cho gói đăng ký không. Trả lời “không” thì key bị bỏ qua mà không hỏi lại; muốn bật lại thì vào /config, mục Usar una clave de API personalizada. Bài này chọn ANTHROPIC_AUTH_TOKEN chỉ để bỏ được bước hỏi đó.

Vài hướng dẫn tiếng Việt viết rằng ANTHROPIC_API_KEY khiến Claude Code phớt lờ ANTHROPIC_BASE_URL, gọi thẳng api.anthropic.com và nhận 403. Cả tài liệu biến môi trường lẫn documentación de conexión del gateway (đọc ngày 3 de octubre de 2026) đều không nói vậy: hai biến là hai cách đưa key tới cùng một gateway trong ANTHROPIC_BASE_URL. Nếu bạn thật sự gặp 403 sau khi đổi biến, hãy kiểm tra lại base URL và key thay vì đổi qua đổi lại tên biến.

Por qué fijar el modelo y cuánto cuesta cada modelo

Alias của Claude Code không đứng yên. Theo documentación de configuración del modelo (đọc ngày 3 de octubre de 2026), với người dùng API, mô hình mặc định và alias opus đang trỏ tới Opus 5.5, alias sonnet trỏ tới Sonnet 5.5; tài liệu cũng nói alias “được cập nhật theo thời gian” và khuyên dùng tên đầy đủ hoặc các biến ANTHROPIC_DEFAULT_*_MODEL khi cần cố định. Tính đến ngày 3 de octubre de 2026, Kunavo có Opus 5.5 nhưng không có Sonnet 5.5. Hệ quả nếu bỏ qua bước ghim: phiên mặc định chạy Opus 5.5, đắt hơn Claude Sonnet 5; /model sonnet, giai đoạn thực thi của opusplan và subagent đặt model: sonnet trả về 404; và lần tới alias opus nhảy sang bản Opus mới, bản đó chưa chắc đã có trên Kunavo. Vì vậy đoạn cấu hình ở trên ghim alias sonnet vào claude-sonnet-5 bằng ANTHROPIC_DEFAULT_SONNET_MODEL, và ghim alias opus vào Opus 5.5 (claude-opus-5-5). Opus 5.5 cần Claude Code v2.1.280 trở lên; bản cũ hơn thì chạy claude update.

Precios de Kunavo, por cada millón de tokens (entrada / salida): Claude Sonnet 5 1,40 USD / 7,00 USD (precios de Anthropic: 2,00 USD / 10,00 USD); Claude Opus 5.5 2,80 USD / 14,00 USD; Claude Haiku 4.5 0,70 USD / 3,50 USD.

Comprobar con /status

Cuando se ha leído ANTHROPIC_AUTH_TOKEN, el comando claude entra directamente en la sesión de trabajo, sin pantalla de inicio de sesión (según la documentación de conexión al gateway, consultada el 3 de octubre de 2026); la primera vez aún hay algunos pasos de configuración, como la pregunta sobre si confías en la carpeta. Si ves la pantalla de inicio de sesión, la clave no ha llegado. En la sesión, escribe /status y busca:

  • Anthropic base URL: https://api.kunavo.com. Esta línea solo aparece cuando hay una dirección de gateway; su ausencia significa que ANTHROPIC_BASE_URL no llegó a la sesión.
  • Auth token: ANTHROPIC_AUTH_TOKEN. Si allí aparece Login method junto con una cuenta de claude.ai, la sesión sigue utilizando el inicio de sesión guardado.

Para asegurarte de que la clave y la dirección son correctas antes de abrir Claude Code, envía una solicitud de prueba que pida exactamente 1 token de salida (consume una cantidad muy pequeña del saldo). El comando lee las variables del shell actual, así que si la clave solo está en el archivo de configuración, ejecuta primero export en este terminal. Un resultado que empiece por {"id":"msg_ es correcto; 401 significa que la clave fue rechazada.

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

Versión de PowerShell de la misma prueba; si tiene éxito, el campo id del resultado empieza por msg_:

PowerShell
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é se pierde al usar una clave de API

  • Remote Control y el dictado por voz requieren una identidad de claude.ai, por lo que no funcionan cuando ANTHROPIC_AUTH_TOKEN está activa. Remote Control también se desactiva cuando ANTHROPIC_BASE_URL apunta a un servidor distinto de api.anthropic.com.
  • /fast muestra Fast mode has been disabled by your organization: según la documentación de conexión al gateway, la comprobación del modo rápido requiere iniciar sesión en claude.ai o utilizar una clave de API de Anthropic; por eso, con un token bearer, Claude Code lo considera desactivado y no consulta al servidor.
  • MCP tool search está desactivado de forma predeterminada cuando la URL base no pertenece a Anthropic.
  • Métricas en /context là ước tính: Kunavo không có endpoint /v1/messages/count_tokens, và theo documentación del protocolo del gateway (đọc ngày 3 de octubre de 2026), khi thiếu endpoint này Claude Code đếm token dựa trên số ký tự.

Los detalles de integración están en la documentación de integración de Claude Code (en inglés); el artículo correspondiente en inglés es Install Claude Code.

Recargar saldo desde Vietnam: tarjetas o Link; no hay monederos electrónicos locales

Lo decimos claramente: Kunavo no acepta MoMo, ZaloPay, VNPay ni transferencias bancarias. Las tarjetas ATM nacionales que solo funcionan en la red Napas tampoco sirven, porque no son tarjetas Visa ni Mastercard. La página de pago de Stripe de Kunavo ofrece las siguientes opciones para compradores en Vietnam:

  • Tarjetas Visa o Mastercard, tanto de crédito como de débito internacionales.
  • Link, ví của Stripe, lưu phương thức thanh toán để lần sau trả nhanh hơn (documentación de Link, đọc ngày 3 de octubre de 2026).
  • Apple Pay o Google Pay, chỉ xuất hiện trên thiết bị và trình duyệt đã thiết lập ví, vì chúng trả bằng thẻ có trong ví. Apple Pay có mặt ở Việt Nam từ 08/08/2023 và dùng được khi mua hàng trực tuyến (Apple Newsroom Vietnam, đọc ngày 3 de octubre de 2026).

Phía Anthropic cũng vậy: gói Claude mua trên web chỉ nhận thẻ tín dụng hoặc ghi nợ (Preguntas frecuentes sobre pagos de Claude, đọc ngày 3 de octubre de 2026), nên ví điện tử Việt Nam không trả trực tiếp được ở đó; gói mua trong ứng dụng iOS hay Android thì đi theo phương thức của App Store hoặc Google Play. Khác ở chỗ, tiền nạp vào Kunavo thành số dư API, và Claude Code trừ dần theo token sau khi bạn cấu hình key như trên.

Pagar en VND o USD

Kunavo niêm yết giá bằng USD. Vì Việt Nam nằm trong các thị trường của Stripe Adaptive Pricing (đọc ngày 3 de octubre de 2026), trang thanh toán có thể hiện số tiền đã quy đổi sang VND, và con số chính xác luôn hiện ra trước khi bạn bấm xác nhận. Tỷ giá Stripe đưa ra đã cộng phí chuyển đổi 2–4%, người mua chịu. Chọn trả bằng USD thì không có khoản đó, nhưng ngân hàng phát hành thẻ có thể áp tỷ giá và phí của họ.

Trả bằng VND cũng chưa chắc rẻ hơn: một số ngân hàng thu phí khi thẻ thanh toán bằng VND cho đơn vị bán hàng đăng ký ở nước ngoài. Chẳng hạn Techcombank thu “phí giao dịch nội tệ ở nước ngoài” 1,1% số tiền giao dịch (đã gồm VAT) với thẻ ghi nợ Visa, áp dụng từ 13/08/2023 (Preguntas frecuentes de Techcombank, đọc ngày 3 de octubre de 2026). Đây chỉ là ví dụ của một ngân hàng, và Kunavo chưa xác minh được ngân hàng có xếp giao dịch của mình vào loại này hay không; xem biểu phí thẻ của bạn rồi hãy chọn VND hay USD.

Las tarjetas suelen rechazarse porque no tienen activados los pagos en línea o internacionales en la aplicación bancaria. Actívalos y vuelve a intentarlo, o cambia a Link o a Apple Pay/Google Pay con una tarjeta compatible con ese monedero.

Del registro a la obtención de la clave

  1. Regístrate en Kunavo con un correo electrónico o una cuenta de Google; este paso no solicita ninguna tarjeta.
  2. Abre Billing y selecciona el importe de recarga (el mínimo es 10 USD). Los importes mayores incluyen un extra: nạp 100 USD được 110 USD vào số dư; nạp 1.000 USD được 1.200 USD vào số dư; nạp 5.000 USD được 6.250 USD vào số dư.
  3. En la página de Stripe, selecciona una tarjeta, Link o un monedero disponible en el dispositivo, revisa el importe y confirma.
  4. Ve a API Keys y crea una clave sk-kn-…. La clave solo se muestra una vez, así que cópiala inmediatamente en ANTHROPIC_AUTH_TOKEN.

Para recargar automáticamente cuando el saldo sea bajo, debes usar una tarjeta guardada o Link. El saldo no caduca y las solicitudes fallidas no se cobran. Kunavo no emite facturas de IVA, incluidas las facturas electrónicas exigidas por la normativa vietnamita; consulta el historial de recargas en Billing. Este saldo solo sirve para la API de Kunavo; no se puede utilizar para pagar Claude Pro, Claude Max ni ChatGPT Plus.

¿Cuánto cuesta aproximadamente una sesión de programación?

En cada solicitud, Claude Code vuelve a enviar todo el contexto de la conversación, por lo que el coste depende mucho de la caché: el contexto repetido se cobra a un precio de lectura de caché considerablemente menor. La tabla siguiente es un cálculo teórico con los supuestos indicados, no una medición real ni un límite máximo:

  • por cada solicitud de 40.000 tokens de entrada: 36.000 tokens (90%) leídos de la caché, 4.000 tokens escritos en la caché;
  • cada solicitud tiene 1.000 tokens de salida;
  • una sesión de 50 solicitudes, sin contar las Claude Haiku 4.5 ejecuciones en segundo plano;
  • para Claude Sonnet 5 en Kunavo, la lectura de caché cuesta 10% veces el precio de entrada y la escritura de caché cuesta 1,25 veces el precio de entrada; cada modelo de la tabla utiliza su propia proporción.
ModeloUna solicitud50 solicitudes50 solicitudes, sin acertar en la caché ni una sola vez
Claude Sonnet 50,019 USD0,95 USD3,15 USD
Claude Opus 5.50,033 USD1,65 USD6,30 USD

La última columna muestra hasta qué punto importa la caché. Un contexto largo, una respuesta larga o olvidarse de /clear entre dos tareas distintas hacen que la cifra aumente. Compara la suscripción con la API y consulta la estimación mensual en el artículo Cuánto cuesta Claude Code; para ver el precio de cada modelo, consulta la tabla de precios de la API de Claude o la página de precios; si quieres introducir tus propios datos, utiliza la calculadora de costes de tokens de Claude (en inglés).

Solucionar problemas según el mensaje

CuándoQué vesSolución
InstalaciónThe token '&&' is not a valid statement separatorEstás en PowerShell y has pegado una línea de CMD. Usa irm … | iex.
Instalación'irm' is not recognized as an internal or external commandEstás en CMD y has pegado una línea de PowerShell. Usa la línea install.cmd.
Instalaciónsyntax error near unexpected token '<', 403, App unavailable in regionRecibes una página HTML en lugar del script. Desactiva la VPN o el proxy de otro país y prueba primero con otra red antes de cambiar el método de instalación (los otros métodos descargan desde el mismo servidor).
InstalaciónClaude Code does not support 32-bit WindowsHas abierto PowerShell (x86). Abre el “Windows PowerShell” normal.
Instalación (npm)Advertencia EBADENGINENode.js inferior a 22. La instalación termina, pero se recomienda actualizar Node.
Instalación (npm)claude native binary not installedFalta una dependencia opcional debido a --omit=optional, optional=false o --ignore-scripts. Elimina esa configuración y vuelve a instalar.
Instalación (npm)npm.ps1 cannot be loadedLa política de ejecución bloquea el script. Ejecuta Set-ExecutionPolicy de arriba, utiliza npm.cmd o cambia al comando nativo.
Después de la instalacióncommand not found: claude, 'claude' is not recognizedLa carpeta de instalación aún no está en PATH. Abre un terminal nuevo; en Windows, ejecuta el fragmento adicional de PowerShell PATH.
ConfiguraciónSigue apareciendo la pantalla de inicio de sesiónNo se ha leído la clave. Defínela en el shell o en ~/.claude/settings.json del usuario, no solo en la configuración del proyecto; abre un terminal nuevo.
Configuración401Clave rechazada: se copió incompleta, contiene espacios adicionales, se eliminó en /app/keys o se colocó en la variable equivocada.
Configuración404La URL base contiene /v1 de más o el modelo no está disponible en Kunavo (normalmente, el alias sonnet no está fijado y apunta a Sonnet 5.5).
Recargar saldoTarjeta rechazadaActiva los pagos en línea e internacionales en la aplicación bancaria; las tarjetas que solo funcionan con Napas no sirven. También puedes probar con Link, Apple Pay o Google Pay.

Antes de recargar saldo

  • Solo se admiten tarjetas Visa/Mastercard, Link y monederos que funcionen con tarjetas; no MoMo, ZaloPay, VNPay ni transferencias bancarias.
  • La recarga automática solo funciona con una tarjeta guardada o Link. Kunavo no emite facturas de IVA.
  • Esta es una API de pago por token, no un plan Claude Pro/Max: no incluye Remote Control ni dictado por voz, /fast indica que está desactivado y MCP tool search está desactivado de forma predeterminada.
  • A fecha de 3 de octubre de 2026, Kunavo no ofrece Sonnet 5.5, por lo que el alias sonnet no fijado devuelve 404.
  • La documentación de Claude Code y la documentación de integración de Kunavo solo están disponibles actualmente en inglés.

Preguntas frecuentes

¿Claude Code es gratis? ¿Qué significa «Claude Code no necesita un plan»?

Descargar e instalar Claude Code no cuesta dinero, pero para que responda necesitas una de estas dos opciones: iniciar sesión con un plan de Claude de pago (Pro, Max, Team, Enterprise) o una cuenta de Console, o usar una clave de API. El plan gratuito de Claude.ai no incluye Claude Code. «No necesita un plan» es la segunda opción: configura ANTHROPIC_BASE_URL=https://api.kunavo.com y ANTHROPIC_AUTH_TOKEN; Claude Code omite el inicio de sesión y descuenta el coste según los tokens realmente utilizados del saldo prepagado de Kunavo, con un mínimo de 10 USD y sin cuota mensual.

¿Cuál es el comando para instalar Claude Code en Windows? ¿Es necesario instalar WSL o ejecutarlo como Administrador?

Abre PowerShell (el indicador comienza con PS) y ejecuta irm https://claude.ai/install.ps1 | iex; si estás en CMD, usa curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. No se requieren permisos de Administrador, ni WSL ni Git. Si tienes Git for Windows, Claude Code ejecuta los comandos mediante Git Bash; si no, mediante PowerShell. WSL 2 solo merece la pena instalarlo si necesitas herramientas de Linux o quieres ejecutar los comandos en un sandbox. Recuerda abrir «Windows PowerShell», no la entrada que contiene (x86), porque Claude Code no funciona en Windows de 32 bits.

¿Qué versión de Node.js se necesita para instalar Claude Code con npm?

Node.js 22 o posterior, según la documentación oficial de instalación consultada el 3 de octubre de 2026. Muchos artículos antiguos todavía indican Node 18, pero esa cifra está obsoleta. Una versión antigua de Node solo hace que npm muestre la advertencia EBADENGINE; la instalación se completa porque el paquete npm en realidad descarga un programa nativo que no necesita Node para ejecutarse. El comando de instalación es npm install -g @anthropic-ai/claude-code (sin sudo); para actualizar a la versión más reciente, vuelve a ejecutarlo con @latest en lugar de usar npm update -g. Si no tienes un motivo específico para usar npm, el comando nativo es más sencillo.

¿Dónde se introduce la clave de API para Claude Code? ¿ANTHROPIC_BASE_URL debe incluir /v1?

El lugar más persistente es el bloque env del archivo ~/.claude/settings.json del usuario (Windows: %USERPROFILE%\.claude\settings.json), que se aplica a todos los proyectos; también puedes exportarla en ~/.zshrc, ~/.bashrc o $PROFILE de PowerShell. La URL base es solo https://api.kunavo.com, sin /v1, porque Claude Code añade automáticamente /v1/messages; un /v1 adicional se convertiría en /v1/v1/messages y produciría un 404. No dejes la clave en .claude/settings.json del proyecto: ese archivo está en el repositorio y se incluye en cada clonación.

Un artículo dice que usar ANTHROPIC_API_KEY provoca un 403. ¿Es cierto?

No según la documentación oficial. Tanto ANTHROPIC_API_KEY como ANTHROPIC_AUTH_TOKEN se envían a la dirección indicada en ANTHROPIC_BASE_URL; se diferencian en la cabecera (X-Api-Key frente a Authorization: Bearer) y en que debes aprobar ANTHROPIC_API_KEY una vez en el modo interactivo. Kunavo lee la clave en ambas cabeceras. Esta guía recomienda ANTHROPIC_AUTH_TOKEN solo porque funciona de inmediato. Si rechazaste esa pregunta, la clave se ignora sin volver a preguntar; entra en /config, en la opción Use custom API key, para activarla de nuevo.

¿Qué modelo usa Claude Code si no se configura ANTHROPIC_MODEL?

Funciona mediante alias, y los alias cambian gradualmente con el tiempo. La documentación de configuración de modelos (consultada el 3 de octubre de 2026) indica que, para los usuarios de API, el modelo predeterminado y el alias opus son actualmente Opus 5.5, mientras que el alias sonnet es Sonnet 5.5. Kunavo tiene Opus 5.5, pero no Sonnet 5.5, por lo que una sesión sin modelo fijado usará Opus 5.5 con un precio superior a Claude Sonnet 5; /model sonnet, la fase de ejecución de opusplan y los subagentes que establecen model: sonnet devolverán 404. Si fijas 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, sabrás con certeza qué modelo se cobra en cada turno. Fijar el alias opus en Opus 5.5 requiere Claude Code v2.1.280 o posterior; en versiones anteriores, ejecuta claude update.

¿Qué debe aparecer al escribir /status para saber que funciona con una clave de API?

Dos líneas: «Anthropic base URL» es https://api.kunavo.com y «Auth token» indica ANTHROPIC_AUTH_TOKEN. Si en su lugar aparece «Login method» con una cuenta de claude.ai, la sesión sigue usando el inicio de sesión anterior; sal, abre un terminal nuevo y comprueba dónde se ha configurado la variable. Puedes probar la clave antes de abrir Claude Code con un comando curl que envíe una solicitud a /v1/messages con max_tokens igual a 1: si devuelve un JSON que comienza por {"id":"msg_, es correcto; 401 significa que la clave fue rechazada.

¿Se necesita una VPN en Vietnam para instalar o usar Claude Code?

No. Vietnam figura en la lista de países compatibles de Anthropic tanto para Claude.ai como para la API (comprobada el 3 de octubre de 2026). En cambio, si la VPN dirige la conexión a un país no compatible, la dirección de instalación puede devolver la página «App unavailable in region» en lugar del script. Si aparece ese error mientras estás en Vietnam, desactiva la VPN o el proxy y vuelve a ejecutar el comando de instalación.

¿Se puede añadir saldo con MoMo, ZaloPay o VNPay? ¿Se emiten facturas con IVA?

Ninguna de las dos cosas. La página de pago de Stripe de Kunavo permite a los compradores de Vietnam elegir Visa, Mastercard o Link, y Apple Pay o Google Pay si el dispositivo ya está configurado; MoMo, ZaloPay, VNPay y las transferencias bancarias no están disponibles. El importe puede mostrarse en VND; en ese caso, el tipo de cambio de Stripe ya incluye la comisión de conversión del 2–4% que paga el comprador; si eliges pagar en USD, no se aplica esa comisión, pero tu banco puede cobrar su propio tipo de cambio y sus propias comisiones. La recarga mínima es 10 USD, el saldo no caduca y la recarga automática solo funciona con una tarjeta guardada o Link. Kunavo no emite facturas con IVA, tampoco electrónicas.