Configurar un relay de Gemini 3.6 Flash para usarlo desde Claude Code

¿Dónde se cambia base_url y la clave API en Claude Code?

La ubicación exacta para cambiar base_url y la clave API en Claude Code no está confirmada con la información disponible. Por tanto, no es responsable indicar una ruta de archivo, un ajuste de interfaz o una variable de entorno como si estuvieran verificados para esta integración.

Antes de editar nada, identifica si tu instalación de Claude Code permite elegir un proveedor, definir un endpoint compatible o cargar variables de entorno propias. Esa comprobación debe hacerse en la documentación y en la ayuda de la versión concreta instalada, porque un nombre de variable válido en otra herramienta no demuestra que Claude Code lo lea.

Si Claude Code solo admite su flujo de autenticación nativo y no ofrece una opción documentada para sustituir el endpoint, un relay de Gemini 3.6 Flash puede no ser configurable desde el cliente. En ese caso, modificar archivos no documentados puede dejar credenciales duplicadas, provocar errores difíciles de diagnosticar o simplemente no tener efecto.

¿Qué configuración necesito para conectar Gemini 3.6 Flash desde Claude Code?

No existe una configuración completa verificable para pegar en Claude Code con los datos aportados. Faltan el formato de endpoint del relay, el esquema de autenticación que acepta, el protocolo compatible y la forma en que Claude Code selecciona el modelo.

El identificador del modelo disponible en el panel de precios es gemini-3.6-flash. Esto solo confirma que figura como modelo en venta en esa fuente; no confirma que Claude Code pueda enviarlo como valor de model ni que el relay traduzca solicitudes de Claude Code a ese modelo.

No copies configuraciones de Cline, Dify, SDK de OpenAI, SDK de Anthropic u otros clientes esperando que funcionen aquí. Aunque varias herramientas usan nombres parecidos como base_url, api_key o model, la estructura de las solicitudes, las rutas y los campos admitidos pueden ser distintos.

La configuración pendiente debe obtenerse de dos fuentes: la documentación oficial de la versión de Claude Code que se usa y la documentación técnica del relay. Hasta disponer de ambas, cualquier bloque de variables de entorno, JSON, YAML o comando de terminal sería una suposición.

¿Cómo compruebo que Claude Code está usando Gemini 3.6 Flash?

La validación debe basarse en evidencia observable de la solicitud y de la respuesta, no en que Claude Code muestre una respuesta aparentemente correcta. Una respuesta útil no prueba por sí sola qué endpoint recibió la petición ni qué modelo la atendió.

Primero, ejecuta una petición breve y reversible en un entorno sin secretos expuestos en registros. Después, revisa los registros disponibles del cliente y del relay para confirmar la URL de destino, el resultado de autenticación y el identificador de modelo recibido. Los campos concretos de esos registros no están confirmados.

Si el relay dispone de historial de solicitudes, úsalo para contrastar que la petición llegó y que se asoció con gemini-3.6-flash. La disponibilidad de ese historial, sus campos y su retención son Aún no medido. Evita publicar capturas que incluyan claves, encabezados Authorization o contenido sensible de repositorios.

Una comprobación útil también debe detectar fallos de compatibilidad. Si Claude Code rechaza la respuesta, muestra un error de formato o ignora el modelo solicitado, no des por válida la integración aunque el relay registre tráfico. Es posible que el protocolo de respuesta no sea el que el cliente espera.

¿Por qué Claude Code puede dar error al usar un relay de Gemini?

El riesgo principal es la incompatibilidad de protocolo. Claude Code y Gemini 3.6 Flash pueden requerir formatos de solicitud, herramientas, mensajes, streaming o respuestas diferentes; con la información disponible no se puede confirmar que el relay cubra esas diferencias.

También puede fallar la autenticación si el cliente no permite inyectar la clave del relay, si el relay espera un encabezado distinto o si la clave se ha colocado en una variable que Claude Code no consume. No se debe interpretar un error genérico de API como prueba de que la clave sea incorrecta.

Otro punto delicado es el nombre de modelo. gemini-3.6-flash aparece en la fuente de precios como modelo de tipo chat, con precio base de 1,5 USD por millón de tokens de entrada, 7,5 USD por millón de tokens de salida y 0,15 USD por millón de tokens de caché. Eso no garantiza que el cliente acepte ese identificador ni que una ruta destinada a otro proveedor lo resuelva.

La tarifa final depende del multiplicador del grupo de usuario, por lo que no conviene inferir coste real a partir del precio base. Esta página no sustituye la página de precios ni explica compra o pago; el objetivo aquí es determinar si la conexión técnica es viable.

¿Cómo se cambia entre Gemini 3.6 Flash y otros modelos en Claude Code?

No hay un método confirmado para cambiar de modelo en Claude Code cuando se usa un relay. La posibilidad de alternar modelos depende de que el cliente permita elegir model y de que el relay admita esos identificadores bajo el mismo tipo de conexión.

En la fuente disponible aparecen, entre otros modelos de Google, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3-flash-preview, gemini-2.5-flash y gemini-3.6-flash. Su presencia en el catálogo no debe interpretarse como compatibilidad automática con Claude Code.

Si el cliente permite perfiles o configuraciones separadas, el enfoque más seguro es validar un modelo por perfil y conservar una forma clara de volver a la configuración anterior. Los nombres de archivos, perfiles o comandos para hacerlo son Aún no medido y deben confirmarse para la instalación concreta.

No mezcles claves, endpoints y nombres de modelo de varios proveedores en una misma prueba. Cambia un único elemento cada vez, registra el resultado y conserva el error original. Así podrás distinguir entre un problema de credenciales, una ruta errónea, un modelo no admitido o una incompatibilidad de protocolo.

¿Sigues atascado? La documentación completa y el soporte están disponibles en obtén más información.

Más información en este sitio

• ¿Cuánto cuesta la API de Gemini 3.6 Flash?Tarifas base, base de facturación y multiplicadores por grupo
• ¿Cómo se llama a la API de Gemini 3.6 Flash?Pasos de configuración y código listo para copiar y pegar
• Gemini 3.6 Flash: ¿API directa o gateway?Comparación punto por punto, incluidas las limitaciones
• API de Gemini 3.6 Flash: preguntas frecuentesLo que realmente pregunta la gente al integrar
• Cómo comprar Gemini 3.6 Flash API y calcular el coste realCompra y recarga de Gemini
• Cómo pagar el uso de Gemini 3.6 Flash sin asumir métodos no confirmadosMétodos de pago y recargas
• Qué hace una estación intermedia entre tu aplicación y una API de modelosQué es un API relay
• Precio de Gemini 3.6 Flash frente a otros modelosPrecio y ahorro
• ¿Hay riesgo de bloqueo al usar Gemini 3.6 Flash mediante API?Riesgo de bloqueo y datos
• Cuota gratuita de Gemini 3.6 Flash: qué se sabe antes de probar la APICuota gratuita y límites
• Cómo diagnosticar una organización deshabilitada al usar Gemini 3.6 FlashDiagnóstico de organización deshabilitada

Primeros pasos

Consulta el registro de precios actual y valida Gemini 3.6 Flash en tu integración.

Regístrate y empieza a hacer llamadas

Sitio oficial: visita el sitio