Cómo instalar Claude Code【Windows y Mac】: configuración de API key sin suscripción y pago con JCB y Apple Pay

Instalar Claude Code solo requiere ejecutar una línea del instalador nativo oficial. En Mac, Linux y WSL usa install.sh; en Windows, PowerShell usa install.ps1 y CMD usa install.cmd (también se puede instalar con npm, pero en ese caso se requiere Node.js 22 o posterior). Normalmente después se inicia sesión con un plan como Pro o Max, pero si no quieres contratar una suscripción, puedes iniciarlo sin iniciar sesión configurando ANTHROPIC_BASE_URL=https://api.kunavo.com (sin añadir /v1), ANTHROPIC_AUTH_TOKEN con la clave de API y las cuatro variables que fijan los modelos. Comprueba que funciona con /status. El saldo de API se puede prepagar con tarjetas como JCB, Apple Pay, Google Pay y Link desde $10; la pantalla de pago muestra los importes en yenes.

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

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

:: Windows コマンドプロンプト（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

インストール手順の一次情報は、日本語で読める Anthropic の公式ドキュメント（Configuración、Solución de problemas de instalación、3 de octubre de 2026確認）です。このページはその内容をなぞるのではなく、日本語の解説記事で食い違っている点（Node.js のバージョン、Windows の管理者権限と Git）と、公式ドキュメントが扱っていないこと——ログインせずに API キーで動かす設定と、日本からの支払い——を中心にまとめています。料金と決済手段は 3 de octubre de 2026時点の情報です。日本は Anthropic のLista de países compatiblesに、Claude.ai と API の両方で載っています（3 de octubre de 2026確認）。

Decide primero: iniciar sesión con una suscripción o usar una clave de API

La instalación es la misma en ambos casos; la diferencia aparece después del primer inicio. Claude Code solicita autenticación al iniciarse. Si no estás seguro, puedes decidir según estos 3 puntos:

• Ya tienes contratado Pro, Max, Team o Enterprise, o dispones de una cuenta de Console: puedes usarlo iniciando sesión directamente. No necesitas configurar la clave de API de esta página. Claude Code no está incluido en el plan gratuito.
• No quieres pagar una tarifa fija mensual o hay una gran diferencia entre los meses en que lo usas y los meses en que no lo usas：API キーで動かし、使ったトークン分だけ払う形が合います。参考までに、Claude のサブスクは Pro が月 $20（年払いは $200 で月 $17 相当）、Max は月 $100 からで、いずれも税別です（Página de precios de Claude、3 de octubre de 2026確認）。どちらが安くなるかの分岐点は Precios de Claude Codeで試算しています。
• Quieres usar Remote Control o la entrada de voz: ambos requieren una cuenta de claude.ai, por lo que no se pueden usar con una clave de API. Elige iniciar sesión.

支払い手段も違います。Anthropic の Web サイトで契約するサブスクはクレジットカードかデビットカードのみで、iPhone・Android アプリから契約した場合は App Store・Google Play が決済します（Ayuda de Anthropic、英語版、3 de octubre de 2026確認）。Kunavo の API 残高は、JCB を含むカード、Apple Pay、Google Pay、Link でチャージします（詳しくは後半の支払いの章）。

Comprobaciones previas a la instalación

Los requisitos son los indicados en la documentación oficial (consulta 3 de octubre de 2026). La columna de la derecha explica cómo comprobarlos localmente.

Método de instalación

La documentación oficial recomienda el instalador nativo. La principal diferencia con los demás métodos es cómo se realizan las actualizaciones.

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

Con cualquier método, cuando termines, cierra y vuelve a abrir el terminal antes de comprobarlo. Es posible que las ventanas abiertas antes de la instalación no hayan cargado el nuevo PATH. claude doctor muestra únicamente el estado de la instalación y la configuración sin iniciar una sesión, por lo que resulta útil para diagnosticar problemas.

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

Precauciones al instalar con npm

日本語の解説記事では今も「Node.js 18 以上」という記載をよく見かけますが、公式ドキュメントの要件はNode.js 22 o posteriorです（Documentación oficial、3 de octubre de 2026確認）。古い Node.js でも npm は EBADENGINE の警告を出すだけでインストールを止めず、claude も起動しますが、警告が出たら Node.js を上げておくほうが安全です。nvm や Volta などでバージョンを切り替えている場合は、インストールするシェルで node -v を確かめてください。

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

La documentación oficial indica explícitamente que no se debe usar sudo npm install -g. Además, como el binario principal se instala como dependencia opcional, si --omit=optional o .npmrc usan optional=false para omitir las dependencias opcionales, en Mac y Linux aparecerá claude native binary not installed y no se iniciará.

Puntos importantes al instalar en Windows

まず、ネットでよく見る 2 つの手順は不要です。「PowerShell を管理者として実行」と「Git for Windows を先に入れる」は、どちらも公式ドキュメントの要件ではありません。No se necesitan permisos de administrador y Git for Windows es opcionalで、入っていなければ Claude Code は PowerShell でコマンドを実行します（Configuración en Windows、3 de octubre de 2026確認）。

Antes de pegar el comando, comprueba solo estas 2 cosas.

1. ¿El terminal abierto actualmente es PowerShell o CMD? Si el indicador es PS C:\Users\ユーザー名>, usa la línea de irm para PowerShell; si es PS el que no incluye C:\Users\ユーザー名>, usa la línea de install.cmd para CMD. Si los confundes, PowerShell mostrará un error porque && no se reconoce como separador, y CMD mostrará un error porque no reconoce irm (en Windows configurado en japonés, los mensajes pueden aparecer en japonés).
2. ¿Has abierto «Windows PowerShell (x86)»? La versión (x86) que aparece en el menú Inicio es un proceso de 32 bits, por lo que incluso en un ordenador de 64 bits se detendrá con Claude Code does not support 32-bit Windows.

Hay 3 formas de ejecutarlo en Windows. Si no estás seguro, puedes empezar con la versión nativa.

Si has instalado Git for Windows pero Claude Code no encuentra Git Bash, escribe la ubicación de bash.exe en CLAUDE_CODE_GIT_BASH_PATH dentro de env del archivo de configuración del usuario.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Si claude no funciona después de instalarlo

'claude' is not recognized (en Mac y Linux, command not found: claude) indica que la ubicación de instalación no está incluida en PATH. El instalador nativo se coloca en %USERPROFILE%\.local\bin\claude.exe en Windows y en ~/.local/bin/claude en Mac y Linux. Si no se soluciona al volver a abrir el terminal, compruébalo y añádelo desde PowerShell siguiendo el procedimiento de la documentación oficial.

# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 新しいターミナルで
claude --version

npm で入れた場合に npm.ps1 cannot be loaded because running scripts is disabled on this system （起動時なら claude.ps1）と出るのは、PowerShell の実行ポリシーが npm の .ps1 スクリプトを止めているためです（Documentación oficial、3 de octubre de 2026確認）。現在のユーザーにだけローカルのスクリプト実行を許可する次のコマンドで解消します。ポリシーを変えたくなければ、npm.cmd・claude.cmd を使うか、PowerShell 用のネイティブインストーラーに切り替えてください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Configuración para usar una clave de API sin iniciar sesión

Kunavo no es Anthropic, sino una pasarela de API independiente que ofrece acceso prepago a las API de modelos como Claude.Claude Code には送信先を差し替える ANTHROPIC_BASE_URL という変数が公式に用意されていて、公式ドキュメントにも「Conectar Claude Code a una pasarela de LLM」というページがあります。プラグインや改造版は使いません。この変数が変えるのは送信先だけで、どのモデルが答えるかは別の変数で決まります（Configuración del modelo、3 de octubre de 2026確認）。

Debes configurar estas 6 variables.

En Mac y Linux, añade las variables al archivo de configuración del shell (~/.zshrc o ~/.bashrc) y vuelve a abrir el terminal.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # ドメインだけ。/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

Si solo quieres probarlo en Windows, ejecuta lo siguiente en una ventana de PowerShell. Desaparecerá al cerrar la ventana.

# このウィンドウの中だけで有効（閉じると消える）
$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 no quieres escribirlas cada vez, añádelas al bloque env del archivo de configuración del usuario ~/.claude/settings.json (en Windows, %USERPROFILE%\.claude\settings.json). Se aplican a todos los proyectos y se escriben igual en Mac y Windows. Si el archivo ya contiene otras configuraciones, añade únicamente el bloque env.

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

Hay 3 aspectos importantes sobre dónde colocarlas.

• プロジェクトの .claude/settings.json にはNo escribas la claveでください。リポジトリにコミットされ、クローンした人全員に渡ります（Documentación oficial）。
• Si la misma variable existe tanto en el shell como en el archivo de configuración, se usa el valor del archivo. Si no cambia al volver a ejecutar export, comprueba el archivo de configuración.
• Si lo usas con la extensión de VS Code, introduce las mismas variables en claudeCode.environmentVariables de la configuración de usuario de VS Code.

Por qué usar ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN se envía mediante el encabezado Authorization: Bearer y se activa en cuanto se configura. En cambio, ANTHROPIC_API_KEY se envía mediante el encabezado x-api-key y, en el modo interactivo, solicita una única aprobación inicial para usarlo. Si lo rechazas, la clave se ignora sin mostrar nada más y no se utilizará hasta que la vuelvas a activar en /config mediante Use custom API key. Kunavo acepta claves enviadas mediante cualquiera de los dos encabezados, por lo que ANTHROPIC_API_KEY también funciona, pero ANTHROPIC_AUTH_TOKEN es más fiable porque evita este inconveniente. La documentación oficial también recomienda usar ANTHROPIC_AUTH_TOKEN cuando no se especifica el tipo de clave.

Por qué fijar los modelos (3 de octubre de 2026)

Documentación oficial（3 de octubre de 2026確認）によると、API キーで使う場合、既定モデルと opus エイリアスは Opus 5.5、sonnet エイリアスは Sonnet 5.5 を指します。エイリアスの行き先は新しいモデルが出るたびに変わりますが、Kunavo で同じ日から使えるとは限りません。実際、Kunavo は 3 de octubre de 2026時点で Sonnet 5.5 を提供していないので、固定せずに /model sonnet を選ぶと 404 になります。opusplan の実行フェーズや、model: sonnet を指定したサブエージェントも同じです。そのため上の設定では ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 で sonnet エイリアスも固定しています。opus エイリアスも、行き先が次の Opus に変わっても困らないよう ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 で Claude Opus 5.5 に固定しています。Claude Opus 5.5 には Claude Code v2.1.280 以降が必要なので、古い場合は claude update で更新してください。

固定しておくと、費用の見通しも立てやすくなります。何も指定しないと既定モデルが Claude Opus 5.5 になり、Claude Sonnet 5 をメインにした場合より 1 トークンあたりの単価が上がります。Kunavo の単価（1M トークンあたり、入力 / 出力）は、Claude Haiku 4.5 が $0.70 / $3.50、Claude Sonnet 5 が $1.40 / $7.00(Los precios de Anthropic son $2.00 / $10.00)、Claude Opus 5.5 が $2.80 / $14.00 です。ANTHROPIC_DEFAULT_HAIKU_MODEL を設定しないと、ANTHROPIC_AUTH_TOKEN で接続したセッションでは claude --resume 用の会話要約などのバックグラウンド処理もメインのモデルで動きます（Guía de compatibilidad con pasarelas、3 de octubre de 2026確認）。なお Anthropic のPágina de preciosでは、メインに固定している Sonnet 5 は「レガシーモデル」の欄に移っています（3 de octubre de 2026確認）。

Comprueba el funcionamiento en 3 pasos

1. Antes de iniciar, prueba solo la URL y la clave

Es una solicitud con solo 1 token de salida, igual que en la documentación oficial (se descuenta una cantidad mínima del saldo). Como lee las variables del shell, si solo has escrito la clave en el archivo de configuración, ejecuta primero export en este terminal. Si devuelve un JSON que comienza por {"id":"msg_ y 200, tanto la URL como la clave son correctas; si devuelve 401, 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": "."}]}'

En PowerShell es lo siguiente; la prueba es correcta si el id devuelto 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": "."}]}'

2. Inicia claude y comprueba que no aparezca la pantalla de inicio de sesión

La primera vez aparecen el asistente de ejecución inicial y la confirmación de confianza de la carpeta, pero después no se solicita iniciar sesión en el navegador. Si se solicita iniciar sesión, la clave no se ha recibido.

Una causa frecuente es haber escrito la clave únicamente en .claude/settings.json o .claude/settings.local.json del proyecto. En una sesión interactiva, el env de la configuración del proyecto se carga después de completar el asistente y la confirmación de confianza de la carpeta, por lo que durante el primer inicio se considera que no existe ninguna clave. Muévela al export del shell o al ~/.claude/settings.json del usuario.

3. Comprueba las 2 líneas de /status

セッションの中で /status を実行し、Status タブを確認します（Documentación oficial、3 de octubre de 2026確認）。

• En Anthropic base URL debe aparecer https://api.kunavo.com. Esta línea solo aparece cuando se configura la pasarela; si no aparece, ANTHROPIC_BASE_URL no ha llegado a la sesión.
• En Auth token debe aparecer ANTHROPIC_AUTH_TOKEN. Si en su lugar aparece Login method de la cuenta de claude.ai, funciona con el inicio de sesión guardado.

Qué cambia al usar una clave de API

• No se pueden usar Remote Control ni la entrada de voz. Ambos requieren un ID de claude.ai, por lo que se desactivan mientras estén activas credenciales de autenticación de la pasarela como ANTHROPIC_AUTH_TOKEN. Desde v2.1.196, Remote Control se desactiva simplemente si ANTHROPIC_BASE_URL apunta a un host distinto de Anthropic.
• /fast aparece como deshabilitado.Si la autenticación se realiza únicamente mediante un token Bearer, Claude Code considera que el modo rápido está deshabilitado sin consultar su disponibilidad y muestra Fast mode has been disabled by your organization.
• El número de /context es aproximado.Kunavo は /v1/messages/count_tokens を提供していないため、Claude Code は文字数ベースの推定に切り替えます（Guía de compatibilidad con pasarelas、3 de octubre de 2026確認）。

La configuración detallada de Kunavo está en la documentación de integración de Claude Code y en la documentación de ANTHROPIC_BASE_URL (ambas en inglés).

Pago del saldo de API: JCB, Apple Pay, Google Pay y Link

A continuación resumimos las preguntas más frecuentes al pagar desde Japón.

El procedimiento consta de 4 pasos. Primero, regístrate en Kunavo (con una dirección de correo electrónico o una cuenta de Google; no se solicitan datos de tarjeta durante el registro). Después, selecciona el importe de la recarga en Billing del dashboard. El mínimo es $10; no hay cuota mensual y los importes grandes reciben una bonificación ($100 で残高 $110、$1,000 で残高 $1,200、$5,000 で残高 $6,250). Tras pagar en la pantalla de Stripe con uno de los métodos anteriores, crea una clave que empiece por sk-kn- en API Keys e introdúcela en ANTHROPIC_AUTH_TOKEN. La clave solo se muestra una vez al crearla, así que cópiala en ese momento.

El saldo no caduca y las solicitudes fallidas no se cobran. Los métodos disponibles para pagar una suscripción de Claude en Japón (incluidos App Store y Google Play) están recopilados con sus fuentes en Métodos de pago de Claude.

Estimación de costes

Claude Code configurado con una clave de API se factura según los tokens utilizados. Claude Code envía todo el contexto de la conversación en cada solicitud, pero la parte inicial que coincide con la anterior puede facturarse al precio de lectura de caché. La tabla siguiente calcula el coste suponiendo que la entrada de una solicitud es de 40,000 tokens (de los cuales 36,000 = 90% son lecturas de caché y los 4,000 restantes son escrituras de caché), que la salida es de 1,000 tokens y que una tarea consta de 50 solicitudes. No incluye las llamadas de Claude Haiku 4.5 en segundo plano. En Kunavo, para Claude Sonnet 5, la lectura cuesta 10% de la tarifa de entrada y la escritura cuesta 1.25 veces esa tarifa (cada modelo de la tabla se calcula con su proporción correspondiente). No son valores medidos ni un límite máximo.

El importe real varía según la longitud del contexto, la eficacia de la caché, la longitud de la respuesta y si ejecutas /clear para cada tarea. Puedes consultar las tarifas unitarias de todos los modelos en la página de precios, estimar el coste según tu uso en la calculadora de costes de tokens de Claude (en inglés) y consultar las tarifas de API por modelo en Precios de la API de Claude.

Errores frecuentes y soluciones

Casos en los que este método no es adecuado

• Necesitas una factura cualificada para liquidar gastos. El checkout de Kunavo no emite facturas ni facturas cualificadas con número de registro.
• Quieres pagar en tiendas de conveniencia o con PayPay. Ninguno de los dos métodos es compatible, ni tampoco las transferencias bancarias o los pagos mediante operador. La recarga automática solo admite una tarjeta guardada o Link.
• Quieres usar Remote Control o la entrada de voz. No se pueden usar con una clave de API y /fast también aparece como desactivado. Inicia sesión con una suscripción.
• Quieres usar Sonnet 5.5. Kunavo no lo ofrece 3 de octubre de 2026.
• Quieres completar la configuración usando únicamente documentación en japonés. La documentación oficial del propio Claude Code está disponible en japonés, pero la documentación de integración de Kunavo solo está disponible en inglés.

Qué hacer a continuación

Cuando hayas comprobado todo con /status, inicia claude en el directorio del proyecto en el que vas a trabajar y crea primero CLAUDE.md con /init. En Cómo usar Claude Code explicamos paso a paso qué escribir en CLAUDE.md, cómo reducir los diálogos de confirmación y cómo crear comandos personalizados.

Preguntas frecuentes