Integración con Claude Code · API de pago por uso

Configuración de API de terceros de Claude Code

Claude Code lee su endpoint de API y su clave de variables de entorno. Apunta ANTHROPIC_BASE_URL a aicodewith, añade tu clave de API y usa Claude Opus 5.5, Sonnet 5.5 y más en tu terminal, con cobro por token.

Para desarrolladores que superan el límite de su plan de Claude Code, equipos que necesitan contabilidad por clave y cualquiera que prefiera pagar por token desde un saldo.

Vista previa de la configuración~/.claude/settings.json
ANTHROPIC_BASE_URL
https://api.aicodewith.ai
ANTHROPIC_AUTH_TOKEN
Tu clave de API de AI Code With
ANTHROPIC_API_KEY
""
Model
claude-sonnet-5-5 (ejemplo, cambia con /model)

Configura en 1 minuto

Guarda esta clave para terminales posteriores

Una vez que inicies sesión, este comando incluye tu propia clave. Cópialo, ejecútalo una vez y la herramienta guardará la clave en la ubicación que probamos.

bash
dir="$HOME/.claude"
settingsFile="$dir/settings.json"
claudeJsonFile="$HOME/.claude.json"
mkdir -p "$dir"
cat > "$settingsFile" << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-***",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}
EOF
cat > "$claudeJsonFile" << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF
echo "配置完成!"
claude

Los visitantes que no han iniciado sesión solo ven un marcador de posición. Inicia sesión y completaremos tu clave. Sign in · Obtén una clave en la consola

Copiar solo pone el comando en el portapapeles. Aún necesitas ejecutarlo en una terminal o pegar la clave en la configuración de la herramienta. Cómo obtener una clave API

Esta es exactamente la configuración que obtienes en la incorporación del panel.

  1. 1

    Crea una clave de API

    Inicia sesión en el panel y crea una clave en la página API Keys. Puedes establecer límites de gasto diarios, mensuales o totales en ella.

  2. 2

    Escribe settings.json

    macOS / Linux: ~/.claude/settings.json. Windows: %USERPROFILE%\.claude\settings.json. Crea el archivo si no existe.

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": "",
        "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
      }
    }
  3. 3

    Omite el inicio de sesión de la primera ejecución

    Añade hasCompletedOnboarding a ~/.claude.json para que Claude Code no te pida iniciar sesión en una cuenta de Anthropic.

    ~/.claude.json
    {
      "hasCompletedOnboarding": true
    }

    Si ~/.claude.json ya existe, añade este campo al JSON existente en lugar de sobrescribirlo.

  4. 4

    Reinicia Claude Code

    Cierra todas las sesiones de Claude Code, ejecuta claude de nuevo y envía un mensaje de prueba.

Qué hace cada variable

Al iniciarse, Claude Code lee el bloque env en settings.json y lo usa como variables de entorno.

ANTHROPIC_BASE_URL
El endpoint de la API. Usa https://api.aicodewith.ai como dominio base, sin /v1; Claude Code añade la ruta por sí mismo.
ANTHROPIC_AUTH_TOKEN
Tu clave de API de aicodewith, enviada como Authorization: Bearer.
ANTHROPIC_API_KEY
Déjala vacía para que no entre en conflicto con una clave de Anthropic ya configurada en tu sistema.

Una vez configurada una clave de API, Claude Code usa la facturación por API en lugar del límite de tu plan de Claude. El uso se descuenta por token de tu saldo de aicodewith.

Elige un modelo

Escribe /model en Claude Code para cambiar. Una configuración común:

Claude Sonnet 5.5

El predeterminado para programar a diario; equilibrio entre velocidad y precio.

Claude Opus 5.5

Refactorizaciones grandes, trabajo de arquitectura y errores difíciles de encontrar.

Claude Haiku 5.5

Subagentes y lotes de tareas pequeñas; la opción más barata.

Consulta la página de modelos para ver los modelos disponibles y los precios actuales. /models

Comprueba que funcionó

  • Ejecuta /status en Claude Code y confirma que el endpoint de la API es api.aicodewith.ai.
  • Después de un mensaje, la solicitud y su cargo aparecen en los registros de uso de tu panel.
  • Ejecuta /cost para ver el coste por token de la sesión.

Volver a tu plan de Claude

Elimina estas entradas env de settings.json, luego ejecuta /login en Claude Code para iniciar sesión en tu cuenta de Anthropic.

¿Aún no tienes Claude Code?

Claude Code necesita Node.js 18 o posterior. Instálalo globalmente con npm:

bash
npm install -g @anthropic-ai/claude-code

Sigue la documentación de Anthropic para el método de instalación actual. Ejecuta claude en la carpeta de tu proyecto para empezar.

Claude Code en npm

Preguntas frecuentes

¿La URL base debe incluir /v1?

No. Configura ANTHROPIC_BASE_URL solo en https://api.aicodewith.ai; añadir /v1 provoca errores 404.

¿Seguirán aplicándose los límites de 5 horas o semanales de mi plan de Claude?

Las solicitudes no usan el límite de tu plan. Se facturan por token desde tu saldo de aicodewith; nuestros propios límites de tasa y concurrencia siguen aplicándose como se describe en nuestra documentación.

¿Cómo controlo el gasto?

Configura límites de gasto diarios, mensuales o totales en cada clave de API en el panel, y ejecuta /cost en Claude Code para consultar el coste de una sesión en cualquier momento.

¿Funciona con la extensión de Claude Code para VS Code o JetBrains?

Sí. Las extensiones leen el mismo ~/.claude/settings.json que la CLI, así que solo lo configuras una vez.

¿aicodewith está afiliado a Anthropic?

No. aicodewith es un servicio de API independiente de terceros. Claude y Claude Code son marcas comerciales de Anthropic.

Errores comunes

La mayoría de los problemas vienen de la URL base, la clave o una variable de entorno residual.

401 / Clave de API no válida

Síntoma: La autenticación falla en cuanto envías un mensaje.

Causa: Clave incorrecta o eliminada, o una ANTHROPIC_API_KEY del sistema anula la configuración.

  • Copia la clave de nuevo y comprueba que no haya espacios adicionales
  • Asegúrate de que ANTHROPIC_API_KEY esté vacía
  • Ejecuta echo $ANTHROPIC_API_KEY para buscar un valor residual

404 Not Found

Síntoma: Las solicitudes devuelven 404.

Causa: La URL base incluye /v1 o tiene un error tipográfico.

  • Cámbiala a https://api.aicodewith.ai
  • Guarda y reinicia Claude Code por completo

Sigue apareciendo "Has alcanzado el límite de tu sesión"

Síntoma: Todavía recibes el mensaje de límite de tu plan de Claude.

Causa: La configuración no está activa y Claude Code sigue usando el inicio de sesión de tu plan.

  • Comprueba la ruta de settings.json y que el JSON sea válido
  • Cierra todas las sesiones y reinicia
  • Ejecuta /status para ver el endpoint actual

429 / límite de tasa

Síntoma: Respuestas 429 ocasionales.

Causa: La tasa de solicitudes o la concurrencia superaron el límite de tasa.

  • Ejecuta menos subagentes en paralelo
  • Espera un momento y vuelve a intentarlo
  • Comprueba tu saldo y el límite de gasto de la clave

¿Te quedaste sin uso de Claude Code?

Mira cómo funcionan los límites de 5 horas y semanales de Pro y Max, y cómo se comparan en coste un plan, créditos de uso y la API de pago por uso.

Lee la guía de límites de uso de Claude Code

Fuentes

Enlaces relacionados

Claude y Claude Code son marcas comerciales de Anthropic PBC. Esta página no está afiliada ni respaldada por Anthropic.