Relay de API de Claude Code (disponible en China, pago por uso)

Qué es un relay de Claude Code

Claude Code en sí es un cliente de línea de comandos; envía las peticiones al endpoint que se indica en ANTHROPIC_BASE_URL. Por defecto es el endpoint de Anthropic, al que las redes de China normalmente no pueden llegar, y el pago también requiere una tarjeta de crédito extranjera. Un relay ofrece una dirección compatible con la API de Anthropic; no necesitas cambiar el cliente, solo la dirección del endpoint y la Key.

Un relay utiliza llamadas con API Key; no necesitas iniciar sesión en una cuenta de Claude y no usa una suscripción de Claude.

Relay vs. suscripción de Claude vs. sitios espejo

Un «sitio espejo» suele referirse al acceso compartido o vendido a la versión web de Claude; no es lo mismo que el relay de API que se usa con el CLI de Claude Code.

Configuración en 3 pasos

1. 1. Consigue una Key

   Regístrate e inicia sesión en AICodeWith y crea una Key en la página de API Keys de la consola. Tienes capturas de pantalla detalladas en la página Obtener API Key.

2. 2. Configura ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN

   Se recomienda escribirlas en ~/.claude/settings.json; el CLI, VS Code y los plugins de JetBrains leen este archivo. Deja ANTHROPIC_API_KEY vacío para evitar conflictos.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

3. 3. Verifica

   Vuelve a abrir la terminal, ejecuta claude y entra en /status para confirmar que el endpoint de la API es api.aicodewith.ai. También puedes verificar de forma temporal con variables de entorno:

   macOS / Linux

   export ANTHROPIC_BASE_URL="https://api.aicodewith.ai"
   export ANTHROPIC_AUTH_TOKEN="你的_API_KEY"
   export ANTHROPIC_API_KEY=""

Tutorial para obtener la API Key con capturas de pantallaGuía de integración de Claude CodeGuía de configuración de la API de terceros para Claude Code

Modelos compatibles y precios

Se admiten los modelos de la familia Claude; usa /model en Claude Code para cambiar entre ellos. Los precios unitarios en tiempo real, los canales disponibles y el estado de cada canal están en la página de Modelos. La facturación se basa en el uso real de tokens.

Modelos y precios en tiempo realRecargas y planes

Cómo elegir un relay

• •Estabilidad: comprueba si hay varios canales disponibles, si la página de Modelos muestra públicamente el estado de los canales y si puedes cambiar de canal cuando aparece overloaded en horas punta.
• •Facturación: si el uso de tokens se factura de forma transparente, si puedes ver el registro de uso de cada petición y si puedes fijar límites de gasto en una Key.
• •Privacidad: revisa cómo se tratan los datos según la política de privacidad y evita dar tu Key a «cuentas compartidas» de origen desconocido.
• •Reembolsos: si existen reglas de reembolso claras. AICodeWith: el saldo no usado se puede reembolsar en un plazo de 90 días con una comisión de gestión del 10% descontada; consulta la política de reembolso para más detalles.

Errores habituales

Los más comunes son 401 (Key o variable incorrecta), 429 (concurrencia demasiado alta), overloaded (modelo ocupado) y cambios de configuración que no surten efecto. Consulta la referencia de errores para ver la causa y la solución de cada uno.

Errores habituales de Claude Code y cómo solucionarlos

FAQ