Claude Code llama a la API de Anthropic de forma predeterminada. Los desarrolladores en China continental suelen encontrarse con acceso inestable, métodos de pago restringidos y una gestión de cuotas incómoda para equipos; por eso tantos buscan «Claude Code relay».

Este artículo explica qué es un relay, qué puede y qué no puede resolver, cómo elegirlo, cómo configurarlo y qué riesgos conviene vigilar.

Nota: Claude Code y Anthropic son marcas registradas de sus respectivos propietarios. Este artículo es solo para debate técnico. Consulta la documentación oficial y el sitio del proveedor para los detalles concretos.

1. Qué es un relay de Claude Code

No es otro Claude Code. Es una capa de gateway de API:

Claude Code → relay gateway (auth / billing / routing) → Anthropic or another compatible model

Sigues usando el cliente de Claude Code; solo cambias ANTHROPIC_BASE_URL y la clave por los valores del gateway. Desde la perspectiva del cliente, sigue llamando a la API de Messages de Anthropic.

2. Qué resuelve

  • Acceso inestable desde China continental.
  • Métodos de pago o recargas poco cómodos.
  • Equipos que necesitan una factura unificada y una política de cuotas.
  • Una sola clave puede alternar entre modelos de varios proveedores.
  • Hay logs de uso y diagnóstico de errores disponibles.
  • Se pueden fijar límites por miembro o por proyecto.

3. Qué no puede resolver

  • No puede convertir una suscripción web o una membresía en acceso a la API.
  • No puede prometer disponibilidad ininterrumpida; los incidentes upstream te siguen afectando.
  • No puede sustituir tu propia evaluación de cumplimiento normativo y de datos.
  • No puede prometer soporte el mismo día para cada nueva función de Claude Code.
  • No puede eliminar los cambios de precio de los modelos upstream.

4. Cómo elegir un relay de Claude Code

1. Compatibilidad de protocolo

Debe admitir la API de Messages de Anthropic y cubrir al menos:

  • Conversación normal.
  • Salida en streaming.
  • Llamadas a herramientas.
  • Contexto largo.
  • Peticiones habituales de Claude Code.

Un relay que solo admita el protocolo de OpenAI puede no funcionar directamente con Claude Code. Confirma si ofrece un endpoint compatible con Anthropic.

2. Estabilidad

Fíjate en la tasa de error, la latencia P95, la política de límites de velocidad y si existen reintentos o canales de respaldo. No juzgues por una sola petición.

3. Facturación

Comprueba cómo se calculan los tokens de entrada, salida y caché, si hay un gasto mínimo y cuáles son las reglas de reembolso. Los precios están en Precios de modelos.

4. Gestión de cuotas

¿Puedes emitir una clave por persona, fijar límites por proyecto y configurar fechas de caducidad? Para los equipos es esencial.

5. Logs

¿Puedes ver el modelo, el número de tokens, la latencia y el error de cada llamada? La depuración y el análisis de costes dependen de ello.

6. Cumplimiento

Pregunta si se almacenan datos, durante cuánto tiempo, si se usan para entrenamiento y si hay contrato disponible. Los compradores empresariales necesitan respuestas claras.

5. Pasos de configuración

1. Crear una clave

Regístrate en ZSQH AI Gateway, crea una clave dedicada para claude-code y fija un límite de gasto.

2. Configurar variables de entorno

macOS/Linux:

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-your-key"
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
$env:ANTHROPIC_API_KEY="sk-your-key"
claude

Algunos clientes usan ANTHROPIC_AUTH_TOKEN en su lugar; sustitúyelo según la documentación del cliente.

3. Elegir un modelo

Los nombres de modelo están en Precios de modelos. Dentro de Claude Code puedes alternar entre Opus, Sonnet y Haiku según la tarea.

4. Verificar

Ejecuta claude en un directorio de proyecto, dale una tarea sencilla y confirma que puede leer archivos, editar código y ejecutar comandos con normalidad.

6. Lista de verificación

  1. ¿Una conversación normal devuelve una respuesta?
  2. ¿Funciona la salida en streaming?
  3. ¿Funcionan las llamadas a herramientas, incluida la lectura de archivos y la ejecución de comandos?
  4. ¿Se trunca el contexto largo?
  5. ¿Es estable la concurrencia con 5 y 10 peticiones?
  6. ¿Son claros los códigos de error?
  7. ¿Es razonable la factura?

Observa el servicio durante 3–7 días antes de decidir si lo usas a largo plazo.

7. Riesgos y trampas

1. Solo protocolo OpenAI

Claude Code usa el protocolo de Anthropic, así que confirma la compatibilidad antes de comprar.

2. Fuga de claves

No pongas claves en el código, capturas de pantalla ni repositorios públicos. Emite una clave por persona y fija una cuota.

3. Trampas de precios bajos

Los precios demasiado bajos pueden indicar cuotas compartidas, limitación de velocidad, poca capacidad upstream o restricciones ocultas. Empieza con una prueba de poco tráfico.

4. Nombres de modelo obsoletos

Los nombres antiguos pueden dejar de funcionar tras las actualizaciones upstream. Vigila la página de precios y los anuncios.

5. Cumplimiento de datos

Antes de un uso empresarial, confirma retención de datos, uso para entrenamiento, contratos y emisión de facturas.

8. Acceso oficial directo vs. un relay

Dimensión Acceso oficial directo Gateway (relay)
Acceso Depende de tu red Normalmente mejor adaptado a China continental
Pago Métodos oficiales Recarga en el sitio del proveedor
Modelos Solo Claude Varios modelos
Facturación Panel oficial Consola unificada
Riesgo Barreras de cuenta y pago Riesgo de elegir mal proveedor

No hay un ganador absoluto. Depende de tu red, tus opciones de pago, tu equipo y tus requisitos de cumplimiento.

Preguntas frecuentes

¿Un relay de Claude Code puede hacer que me bloqueen la cuenta?

Depende del cumplimiento upstream del proveedor y de cómo uses el servicio. Elige un proveedor con condiciones claras y operaciones estables, y respeta las políticas upstream.

¿Un relay admite todas las funciones de Claude Code?

No necesariamente. Las funciones nuevas pueden depender de capacidades específicas de la API. Pruébalas con tu propio flujo de trabajo antes de depender de ellas.

¿Puedo montar uno yo mismo?

Sí. Gateways de código abierto como New API y One API pueden autoalojarse, pero necesitas servidores, canales upstream y trabajo de operación. Consulta la guía de One API y New API.

Próximos pasos

Si necesitas acceso estable a Claude Code desde China continental, regístrate en ZSQH AI Gateway, crea una clave pequeña y recorre la lista de verificación anterior. Para los detalles de configuración, consulta la guía de la API de Claude Code.

Lecturas relacionadas: