Cómo instalar Claude Code: comandos oficiales para Windows, macOS y Linux, clave de API sin suscripción, comprobar /status y pagar con tarjeta o Link

En resumen: instala Claude Code con un único comando oficial (elige abajo la línea para macOS/Linux, PowerShell o CMD) y conéctalo a una clave de API en lugar de iniciar sesión. Solo necesitas seis variables: ANTHROPIC_BASE_URL=https://api.kunavo.com (sin /v1), ANTHROPIC_AUTH_TOKEN con la clave y cuatro variables que fijan el modelo. Comprueba el resultado con /status. No necesitas una suscripción Pro ni Max; pagas los tokens con el saldo prepagado desde $10, recargado con tarjeta (Visa, Mastercard, etc.) o Link. QRIS, GoPay, OVO y DANA 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 Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Semua perintah dan nama variabel di sini kami samakan dengan dokumentasi resmi Claude Code pada 3 de octubre de 2026. Dokumentasi itu sudah ada dalam bahasa Indonesia, termasuk página de instalación dan página de conexión al gateway de LLM, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 3 de octubre de 2026.

Seis pasos desde cero hasta ejecutar Claude Code

1. Comprueba que el portátil cumple los requisitos y decide: iniciar sesión con una cuenta de Claude o utilizar una clave de API.
2. Ejecuta el instalador nativo correspondiente a tu terminal.
3. Abre un terminal nuevo, comprueba claude --version y corrige PATH si es necesario.
4. Configura la clave de API y fija el modelo.
5. Abre la primera sesión y confirma mediante /status que se está utilizando tu clave.
6. Recarga el saldo con una tarjeta o Link y empieza a trabajar.

Paso 1: comprueba los requisitos y elige entre iniciar sesión o usar una clave de API

Setelah terinstal, Claude Code harus tahu siapa yang membayar. Jalan pertama adalah login akun Claude, yang mensyaratkan paket Pro, Max, Team, Enterprise, atau akun Console; paket gratis Claude.ai tidak mencakup Claude Code. Menurut página de precios de Claude (dicek 3 de octubre de 2026), Pro berharga $20 per bulan, atau $17 per bulan kalau dibayar tahunan ($200 di muka), Max mulai $100 per bulan, dan semua harga belum termasuk pajak. Untuk langganan yang dibeli lewat web, Anthropic hanya menerima kartu kredit atau debit; langganan dari aplikasi iOS atau Android dibayar lewat App Store atau Google Play (Preguntas frecuentes sobre la facturación de Claude, dicek 3 de octubre de 2026). Cara login dijelaskan di página oficial de autenticación.

La segunda opción, explicada detalladamente en esta guía, es la clave de API: sin suscripción y sin pantalla de inicio de sesión. Pagas por los tokens realmente utilizados, por lo que en un mes tranquilo el coste también es bajo. Solo se pierden dos funciones vinculadas a la cuenta de claude.ai: Remote Control y el dictado por voz; la lista completa de diferencias aparece en el paso 5.

Baru pertama kali membuka terminal? Anthropic menyediakan guía de terminal en indonesio untuk pemula.

Paso 2: ejecuta el instalador

macOS, Linux y WSL

Pega la línea install.sh al principio de la página en Terminal, pulsa Intro y espera a que termine. El script se descarga directamente de claude.ai, instala el programa en ~/.local/bin/claude y, desde entonces, Claude Code se actualiza automáticamente en segundo plano. En la documentación oficial, este método aparece etiquetado como “Recomendado”.

Windows: identifica primero tu terminal

Muchos tutoriales antiguos indican que hay que abrir PowerShell con “Ejecutar como administrador” e instalar WSL primero. Ninguna de las dos cosas es necesaria: la documentación oficial en indonesio afirma que la instalación en Windows se ejecuta desde un terminal normal sin permisos de administrador, y que WSL es solo una opción. Lo que determina qué comando usar es el aspecto del indicador:

• El indicador PS C:\Users\NamaAnda> significa PowerShell. Usa la línea irm … | iex.
• El indicador C:\Users\NamaAnda> sin PS significa Command Prompt (CMD). Usa la línea install.cmd.
• En el menú Inicio, elige “Windows PowerShell”, no “Windows PowerShell (x86)”. La versión x86 funciona en 32 bits y termina con Claude Code does not support 32-bit Windows, aunque el portátil sea de 64 bits.

Los comandos intercambiados entre terminales se reconocen directamente por el mensaje, por ejemplo The token '&&' is not a valid statement separator (línea de CMD en PowerShell) o 'irm' is not recognized as an internal or external command (línea de PowerShell en CMD). En Windows en indonesio, el mensaje puede aparecer traducido. La lista completa está en la tabla de errores de abajo.

Git tidak wajib. Kalau Git for Windows terpasang, tool Bash Claude Code memakai Git Bash; kalau tidak, perintah dijalankan lewat PowerShell. Bila Git sudah ada tetapi Git Bash tidak ditemukan, isi CLAUDE_CODE_GIT_BASH_PATH di blok env ~/.claude/settings.json dengan lokasi bash.exe, misalnya C:\Program Files\Git\bin\bash.exe. Kapan WSL layak dipakai:

¿Eliges WSL? Ejecuta la línea install.sh dentro del terminal de WSL y abre siempre claude desde ese mismo terminal de WSL.

Alternativas: Homebrew, WinGet o npm

Homebrew y WinGet también son oficiales, pero según la documentación ninguno se actualiza automáticamente de forma predeterminada. Debes actualizarlos por tu cuenta:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm masih didokumentasikan, dengan syarat Node.js 22 o posterior (unduh dari nodejs.org). Di Node.js lama npm hanya memberi peringatan EBADENGINE dan tetap memasang, karena paket ini sebenarnya mengunduh program native yang tidak bergantung pada Node.js saat berjalan.

node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

Tres hábitos que rompen la instalación con npm: usar sudo npm install -g (la documentación lo identifica como una fuente de problemas de permisos y riesgos de seguridad), actualizar con npm update -g en lugar de @latest y desactivar las dependencias opcionales mediante --omit=optional o optional=false en .npmrc. Esto último impide descargar el paquete @anthropic-ai/claude-code-* para tu plataforma, por lo que en macOS o Linux claude responde claude native binary not installed.

En PowerShell, npm a veces se detiene en npm.ps1 cannot be loaded because running scripts is disabled on this system. Se trata de la política de ejecución que bloquea los scripts .ps1. La documentación ofrece tres soluciones: permitir scripts locales para tu usuario con el comando de abajo, llamar a npm.cmd y claude.cmd o abandonar npm y utilizar el instalador nativo.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Una advertencia más: ignore el instalador .exe de terceros que circula en tutoriales, especialmente si solicita privilegios de administrador. El comando oficial anterior es suficiente.

Paso 3: asegúrese de que Claude Code esté instalado

Cierre la terminal donde realizó la instalación y abra una nueva. La ventana antigua todavía utiliza PATH anterior a la instalación, por lo que allí claude a menudo aún no se reconoce. En la terminal nueva:

claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor sirve para separar dos tipos de problemas: si el informe está limpio pero Claude Code sigue sin conectarse, el origen está en la configuración (paso 4), no en la instalación.

¿Sigue apareciendo command not found: claude o 'claude' is not recognized? La carpeta de instalación aún no está incluida en PATH. En macOS y Linux, esa carpeta es ~/.local/bin; en Windows, %USERPROFILE%\.local\bin. Para Windows, la documentación proporciona el siguiente comando de PowerShell:

# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Kalau unduhan sudah gagal sejak awal, perhatikan pesannya. Menurut página de solución de problemas de instalación (dicek 3 de octubre de 2026), syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti yang terunduh adalah halaman HTML atau kode error, bukan skrip. Tulisan App unavailable in region berarti koneksi Anda terlihat berasal dari negara yang tidak didukung; karena Indonesia didukung, tersangka utamanya VPN atau proxy. 403 tanpa isi juga sering datang dari proxy kantor atau firewall kampus. Homebrew, WinGet, dan npm mengambil dari host yang sama, jadi coba jaringan lain atau minta admin jaringan membuka aksesnya sebelum berganti metode.

Paso 4: configure la clave de API sin suscripción

Claude Code tiene la variable integrada ANTHROPIC_BASE_URL para enviar solicitudes a una puerta de enlace distinta de Anthropic, y su documentación oficial incluye una página específica para ello. Por tanto, es una configuración compatible, no una modificación ni un complemento. Obtenga primero la clave sk-kn-… (consulte el paso 6 para ver cómo registrarse y añadir saldo) y, a continuación, elija uno de los lugares donde guardarla.

macOS y Linux: añada estas seis líneas al final de ~/.zshrc (Zsh, predeterminado en macOS) o ~/.bashrc, guarde los cambios y abra una terminal nueva.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /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

Windows, para probar primero: establezca las variables en una ventana de PowerShell y ejecute inmediatamente claude.

# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$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

Todos los sistemas operativos, de forma permanente: colóquelas en el bloque env del archivo de configuración del usuario ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Se aplican a todos los proyectos. Si el archivo ya contiene datos, inserte únicamente el bloque env sin sobrescribir las demás configuraciones.

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

Aspectos importantes de las seis variables anteriores:

Kenapa model dikunci? Menurut documentación de configuración de modelos (dicek 3 de octubre de 2026), untuk pengguna API model default dan alias opus saat ini menunjuk Opus 5.5, dan alias sonnet menunjuk Sonnet 5.5. Alias itu bergeser setiap kali ada rilis baru. Per 3 de octubre de 2026 Sonnet 5.5 belum tersedia di Kunavo, dan model berikutnya belum tentu langsung tersedia; request ke model yang tidak ada dijawab 404. Karena itu blok di atas juga mengunci alias sonnet dengan ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: tanpa pin itu, /model sonnet, fase eksekusi opusplan, dan subagent bermodel sonnet berakhir 404. Alias opus dikunci ke Claude Opus 5.5 (claude-opus-5-5), yang butuh Claude Code v2.1.280 atau lebih baru; kalau versi Anda lebih lama, jalankan claude update.

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

Dua jebakan lain. Pertama, key jangan pernah masuk ke .claude/settings.json milik proyek: menurut documentación de la puerta de enlace, file itu di-commit dan ikut ter-clone oleh siapa pun yang mengambil repositori. Kedua, kalau variabel yang sama ada di shell dan di blok env file pengaturan, umumnya nilai dari file pengaturan yang menang; jadi kalau perubahan di ~/.zshrc seperti tidak berefek, periksa file pengaturan. Pengguna ekstensi VS Code mengisi variabel yang sama di claudeCode.environmentVariables pada user settings VS Code.

Paso 5: abra la primera sesión y compruebe /status

Entre en la carpeta del proyecto y escriba claude. Si la clave ya se ha detectado, la sesión se abre directamente sin pantalla de inicio de sesión. La pantalla de inicio de sesión indica que la clave no ha llegado. La causa más frecuente es que la clave solo esté en .claude/settings.json o .claude/settings.local.json del proyecto. En el modo interactivo, el bloque env del archivo del proyecto solo se lee después del asistente inicial y de la pregunta sobre si se confía en esta carpeta, por lo que durante el primer inicio Claude Code sigue solicitando iniciar sesión. Mueva la clave al shell o a ~/.claude/settings.json.

Una vez abierta la sesión, escriba /status. La configuración es correcta si:

• hay una línea Anthropic base URL que contiene https://api.kunavo.com (esta línea solo aparece cuando se configura la puerta de enlace; si no aparece, significa que ANTHROPIC_BASE_URL no se ha detectado), y
• hay una línea Auth token que menciona ANTHROPIC_AUTH_TOKEN. Si aparece Login method con una cuenta de claude.ai, Claude Code todavía utiliza el inicio de sesión anterior.

¿Quiere probar la clave antes de abrir Claude Code? La documentación oficial utiliza una solicitud que solo pide 1 token de salida, por lo que el saldo descontado es muy pequeño. El comando lee la variable del shell activo; si guarda la clave en un archivo de configuración, ejecute export primero en esta terminal. Un resultado que comienza por {"id":"msg_ indica que todo está correcto; 401 significa que la clave fue 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": "."}]}'

Esta es la versión para PowerShell; funciona si el campo id de la respuesta 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": "."}]}'

Algunas funciones funcionan de manera diferente mientras Claude Code utiliza una clave de API y una puerta de enlace:

Paso 6: añada saldo con tarjeta o Link (sin QRIS, GoPay, OVO, DANA)

Lo que paga en Kunavo es saldo de API prepago, no una suscripción. Claude Code descuenta este saldo por token una vez configurada la clave. El proceso es el siguiente:

1. Cree una cuenta de Kunavo con su correo electrónico o una cuenta de Google. No se solicita ninguna tarjeta al registrarse.
2. Abra Billing y elija un importe. El mínimo es $10, sin cuota mensual. Los importes mayores pueden incluir un bono de saldo: bayar $100 → saldo $110, bayar $1.000 → saldo $1.200, bayar $5.000 → saldo $6.250.
3. Di checkout Stripe, bayar dengan kartu (Visa, Mastercard, dll.), Link, atau Apple Pay/Google Pay kalau perangkat dan browser Anda sudah menyiapkannya. Link menyimpan data pembayaran sehingga top-up berikutnya cukup beberapa klik.
4. Abra API Keys y cree una clave. Las claves que comienzan por sk-kn- solo se muestran una vez, así que cópiela en ese momento en ANTHROPIC_AUTH_TOKEN.

QRIS, GoPay, OVO, DANA, ShopeePay, cuenta virtual y transferencia bancaria no están disponibles. Sin una tarjeta que permita transacciones internacionales en línea, actualmente no puede recargar saldo en Kunavo. Las tarjetas de débito con el logotipo de Visa o Mastercard también cuentan como tarjetas; si se rechazan, normalmente significa que las transacciones en línea o internacionales aún no están activadas en la aplicación bancaria, y la decisión final corresponde al banco emisor.

Harga Kunavo dalam USD. Kalau checkout menampilkan rupiah, kursnya ditentukan Stripe dan sudah memuat biaya konversi 2–4% yang ditanggung pembeli (documentación de Adaptive Pricing de Stripe, dicek 3 de octubre de 2026). Memilih bayar dalam USD menghindari biaya itu, meski kurs dan biaya dari bank Anda sendiri tetap berlaku.

El saldo nunca caduca y las solicitudes fallidas no lo descuentan. La recarga automática solo funciona con una tarjeta guardada o Link. Kunavo no emite ningún documento fiscal. Este saldo tampoco puede utilizarse para pagar Claude Pro o Max. Los detalles de las tarifas de todos los modelos de Claude y cómo pagarlas desde Indonesia están en precios de la API de Claude; la comparación entre suscripción y clave de API específica para Claude Code está en precios de Claude Code.

¿Cuánto se consumirá aproximadamente?

Cada solicitud de Claude Code vuelve a enviar el contexto de la conversación, pero la parte inicial que se repite entre solicitudes se cobra con una tarifa de lectura de caché mucho más económica. El cálculo siguiente es pura aritmética de tokens basada en los supuestos indicados, no una medición ni un límite superior:

• una solicitud = 40.000 tokens de entrada; 36.000 (90%) se leen de la caché, los 4.000 restantes se escriben en la caché;
• una solicitud genera 1.000 tokens de salida;
• una sesión = 50 solicitudes, sin incluir las llamadas de Claude Haiku 4.5 en segundo plano;
• tarifa de lectura de caché 10% y de escritura de caché 1,25× la tarifa de entrada (proporción Claude Sonnet 5 en Kunavo; cada modelo de la tabla utiliza su propia proporción).

Sus cifras reales fluctúan según la longitud del contexto, la frecuencia con la que se utiliza la caché, la longitud de las respuestas y si la conversación se limpia con /clear al cambiar de tarea. Según la documentación de costes de Anthropic, el procesamiento en segundo plano de Claude Code suele costar menos de 0,04 $ por sesión (comprobado 3 de octubre de 2026). Las tarifas completas están en la página de precios, y para estimar su propio patrón de uso puede utilizar la calculadora de costes de tokens de Claude (en inglés).

Cómo utilizar Claude Code a diario

cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini

• Pida las cosas en lenguaje natural, por ejemplo, «explica la estructura de este proyecto» o «corrige el error de la página de inicio de sesión». Claude Code lee los archivos y solicita permiso antes de modificar o ejecutar algo.
• /clear al cambiar de tarea: el historial anterior ya no se vuelve a enviar, por lo que disminuyen los tokens por solicitud.
• /model para cambiar de modelo. Con la fijación del paso 4, opus = claude-opus-5-5, sonnet = claude-sonnet-5 y haiku = claude-haiku-4-5.
• /status para comprobar la puerta de enlace y la clave; /usage para estimar los costes (con la lista de precios, consulte la tabla del paso 5).

Mensajes de error y su significado

Limitaciones

• Pague únicamente con tarjeta, Link o Apple Pay/Google Pay. No hay QRIS, GoPay, OVO, DANA, ShopeePay, cuenta virtual ni transferencia bancaria; la recarga automática solo funciona con una tarjeta guardada o Link.
• Kunavo no emite ningún documento fiscal.
• Es una API de pago por token, no una suscripción a Claude Pro o Max. Con una clave de API, Remote Control y el dictado por voz no están disponibles, /fast está desactivado y la búsqueda de herramientas MCP está desactivada de forma predeterminada.
• Según 3 de octubre de 2026, Sonnet 5.5 aún no está disponible en Kunavo; sin fijar el modelo, el alias predeterminado puede terminar en 404.
• La documentación de Claude Code está disponible en indonesio, pero la documentación de integración de Kunavo y la versión en inglés de esta guía (Install Claude Code) aún no están disponibles en indonesio.

Preguntas frecuentes