Clave de API de Claude Code: obtén una y configúrala en 1 minuto

Clave API vs inicio de sesión con suscripción

Claude Code tiene dos formas de autenticarse. Con /login usa tu plan Claude Pro o Max, y el uso cuenta contra la cuota de 5 horas y semanal de ese plan. Con una clave API envía solicitudes al endpoint de API que configures, y pagas por token.

Cuando se configura una clave API, Claude Code factura a esa clave y no usa la cuota de tu plan Claude. Elimina las variables y ejecuta /login para volver atrás.

Cómo funcionan los límites de uso de Claude Code

Dónde obtener una clave y cómo recargar

1. 1. Registrarse

   Crea una cuenta en aicodewith.ai con email, Google o GitHub.

2. 2. Recarga tu saldo

   La facturación es prepago. Las cuentas internacionales pagan en USD con tarjeta a través de Stripe; las cuentas de China continental pagan en CNY a través de Alipay. La región de facturación se elige en tu primera recarga y el importe mínimo se muestra al finalizar la compra.

3. 3. Crea la clave

   Abre API Keys en el panel y crea una clave. Opcionalmente, establece un tope de gasto diario, mensual o total. Copia la clave; la pegarás en Claude Code a continuación.

Tu saldo se carga por token al precio del modelo y canal que uses. Los créditos son válidos durante un año, y el saldo no usado se puede reembolsar dentro de 90 days de la recarga; se aplica una tarifa del 10%.

Opciones de recargaPreguntas frecuentes sobre pagos y reembolsosPolítica de reembolsos

"From" prices are based on the Economy channel, the lowest-priced Claude channel currently listed (about 19% of Anthropic list price). Other channels cost more; the rate depends on the channel you choose, and the models page is always the source of truth.

Dónde colocar la clave

Elige un solo lugar. settings.json es el más fiable porque la CLI de Claude Code y sus extensiones de IDE lo leen. Las variables de shell son útiles para una prueba rápida o un trabajo de CI.

1. 1. Opción A: ~/.claude/settings.json (recomendado)

   macOS y Linux: ~/.claude/settings.json. Windows: %USERPROFILE%\.claude\settings.json. Crea el archivo si no existe, y fusiona el bloque env si existe.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

2. 2. Omitir la pantalla de inicio de sesión de primera ejecución

   En una instalación nueva, añade este campo a ~/.claude.json para que Claude Code no te pida iniciar sesión en una cuenta de Anthropic. Si el archivo existe, añade el campo en lugar de sobrescribirlo.

   ~/.claude.json

   {
     "hasCompletedOnboarding": true
   }

3. 3. Opción B: variables de entorno del shell

   Añade estas líneas a ~/.zshrc o ~/.bashrc (o expórtalas en un paso de CI), luego abre una terminal nueva.

   bash / zsh

   export ANTHROPIC_BASE_URL="https://api.aicodewith.ai"
   export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
   export ANTHROPIC_API_KEY=""

4. 4. Opción B en Windows (PowerShell)

   Establece variables a nivel de usuario. Abre una terminal nueva después.

   PowerShell

   [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicodewith.ai", "User")
   [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")

ANTHROPIC_BASE_URL es el dominio sin ruta https://api.aicodewith.ai. No añadas /v1; Claude Code agrega la ruta él mismo y /v1 provoca errores 404.

¿ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY?

Establecer ANTHROPIC_API_KEY a una cadena vacía importa: si una clave antigua de Anthropic todavía está exportada en tu shell, puede enviarse en lugar de tu clave de aicodewith y la solicitud falla con 401.

Guía completa de configuración de Claude Code

Comprobar que funciona y qué significan los errores

1. Cierra todas las sesiones de Claude Code y ejecuta claude de nuevo.
2. Ejecuta /status y confirma que el endpoint de API muestra api.aicodewith.ai.
3. Envía un mensaje corto. La solicitud y su cargo aparecen en los registros de uso del panel.
4. Ejecuta /cost para ver el coste por token de la sesión.

Una clave en varios proyectos y máquinas

Una clave no está vinculada a un dispositivo ni a un proyecto. Usa la misma clave en tu portátil, un servidor de desarrollo y CI, o crea una clave por proyecto, compañero de equipo o canalización. Claves separadas te dan registros de uso separados y topes de gasto separados, y puedes eliminar una sin tocar las demás.

• •Los topes de gasto diarios, mensuales o totales por clave evitan que un bucle de agente descontrolado agote el saldo.
• •Los registros de uso muestran cada solicitud con su modelo, tokens y coste.
• •Trata las claves como contraseñas: mantenlas fuera de git, y rota una clave si se filtra.

Próximos pasos

Usa Claude Code sin suscripciónAlternativa a Claude Max: paga por tokenLímites de uso de Claude Code explicadosGuía de integración de Claude CodeDocumentación

FAQ