Guía de diagnóstico y resolución de problemas de Claude

1. Diagnóstico de fallos de inicio de sesión (403/429/500)

Los fallos de inicio de sesión suelen mapearse a causas raíz concretas según códigos de estado HTTP y mensajes de error:

Matriz de códigos de error

Procedimiento de diagnóstico

# 1. Check current IP reputation
curl https://ipinfo.io
# Verify "org" does not show datacenter ASN (AWS, Hetzner, etc.)

# 2. Test DNS resolution
nslookup claude.ai
# Should resolve to Cloudflare IPs (104.18.x.x range)

# 3. Clear browser state completely
# Chrome: Settings → Privacy → Clear browsing data → All time → Cookies, Cache
# Firefox: Settings → Privacy → Clear Data → Everything

# 4. Test login with clean profile
google-chrome --user-data-dir="/tmp/test-profile" --proxy-server="socks5://proxy:1080"

2. Resolución de excepciones en llamadas API

Los fallos de API requieren un diagnóstico sistemático de red, autenticación y limitación de tasa:

Errores de API frecuentes

• 401 Unauthorized: API key inválida o revocada. Verifique la clave en Anthropic Console; regenérela si hace falta.
• 429 Rate Limit: La organización superó la cuota RPM (solicitudes por minuto) o TPM (tokens por minuto). Implemente limitación de tasa en el cliente.
• 529 Overloaded: El backend de Anthropic está al límite de capacidad. Reintente con retroceso exponencial (2^n segundos con jitter).
• Timeout: La solicitud superó el tiempo de espera de 60 segundos. Divida prompts grandes en fragmentos o reduzca max_tokens.

Script de depuración de API

#!/usr/bin/env node
const Anthropic = require('@anthropic-ai/sdk');

async function diagnoseAPI() {
  const client = new Anthropic({
    apiKey: process.env.ANTHROPIC_API_KEY,
  });

  try {
    console.log('Testing API connectivity...');
    const response = await client.messages.create({
      model: 'claude-sonnet-4.5-high',
      max_tokens: 100,
      messages: [{ role: 'user', content: 'Hello' }],
    });
    console.log('✓ API key valid, connection successful');
    console.log('Response:', response.content[0].text);
  } catch (error) {
    console.error('✗ API Error:', error.status, error.message);
    if (error.status === 401) console.log('→ Check API key validity');
    if (error.status === 429) console.log('→ Rate limit exceeded, wait 60s');
    if (error.status === 529) console.log('→ Backend overloaded, retry with backoff');
  }
}

diagnoseAPI();

3. Causa raíz del fallo al vincular pago

Anthropic no recibe el motivo del banco por un rechazo, así que recorra las causas probables en orden. La guía de métodos de pago tiene la lista oficial completa:

• Card Declined: Saldo insuficiente, CVV inválido o tarjeta vencida. Asegúrese de que el saldo cubra el monto completo.
• Card Type Not Accepted: Pro y Max solo listan tarjetas de crédito y débito; una tarjeta prepago puede rechazarse solo por eso. Anthropic no publica BIN bloqueados.
• Address Mismatch: La dirección de facturación debe coincidir con el registro del banco y el país de origen de la tarjeta, y ser una ubicación de facturación elegible.
• 3D Secure Not Completed: Confirme el código SMS o el aviso de la app del banco cuando el banco lo solicite.
• Repeated Attempts: Reintente una vez y luego consulte al banco. Solo el emisor puede explicar un rechazo.

4. FAQ de problemas frecuentes y correcciones rápidas

P: "Claude dice que mi sesión expiró, pero acabo de iniciar sesión"

R: Las cookies de sesión están ligadas a la IP y huellas del dispositivo. Cambios rápidos de IP invalidan la sesión. Solución: active 2FA para reducir solicitudes de re-verificación; mantenga una IP consistente por sesión.

P: "La API devuelve respuestas en caché a prompts nuevos"

R: Prompt Cache coincide con contenido no previsto. Solución: añada un identificador único o marca de tiempo al prompt para forzar cache miss: {prompt} [request_id: {Date.now()}].

P: "WebRTC muestra mi IP real aunque uso proxy"

R: WebRTC evita el proxy en conexiones peer. Solución: desactive WebRTC por completo en la configuración del navegador o use la extensión WebRTC Control para bloquear solicitudes STUN.

P: "La cuenta de repente exige verificación por teléfono"

R: Se activa por cambio de IP, inicio de sesión en dispositivo nuevo o actividad sospechosa. Solución: use un servicio de verificación con SIM física real; vincule 2FA inmediatamente después de verificar para evitar nuevas solicitudes.