Configuración de CC Switch Claude Code con Flatkey y NewAPI

Si está buscando CC Switch Claude Code, probablemente ya tenga instalado el asistente de codificación. El problema de configuración es más específico: necesita que CC Switch escriba la configuración correcta del proveedor de Claude Code, use la clave correcta de Flatkey, apunte a la URL base correcta, elija modelos a los que su clave realmente pueda acceder y verifique la solicitud en los registros de uso.

Esta guía cubre el مسیر práctico para el enrutamiento de CC Switch Claude Code con Flatkey y el flujo de trabajo de un clic al estilo de NewAPI. La documentación actual de CC Switch de NewAPI describe una importación de enlace profundo ccswitch:// desde la página de tokens de New API. Los usuarios de Flatkey pueden usar manualmente la misma superficie de configuración de CC Switch: añadir un proveedor de Claude Code, pegar una clave API de Flatkey, establecer la URL base de gateway de Claude Code, obtener modelos, guardar el perfil y verificar la ruta.

La guía es solo texto. No utiliza capturas de pantalla de la aplicación porque el flujo actual de la interfaz de usuario de CC Switch y Flatkey debería revisarse con capturas antes de publicar imágenes de los pasos.

Respuesta rápida: Ajustes de CC Switch Claude Code para Flatkey

Para una configuración de CC Switch Claude Code respaldada por Flatkey, crea un proveedor de Claude Code en CC Switch y usa el router de Flatkey como gateway. Para las solicitudes estilo Anthropic Messages de Claude Code, usa la URL raíz del gateway, no la ruta de completions de chat de OpenAI.

Campo o configuración de CC Switch	Valor de Flatkey	Qué verificar
Aplicación	Claude o Claude Code	No configures la app de Codex o Gemini cuando el destino sea Claude Code.
Pestaña del proveedor	App-specific Provider para Claude Code, o Universal Provider si también sincronizas Codex/Gemini	Los proveedores universales necesitan una comprobación posterior a la sincronización porque cada app puede esperar una forma de URL diferente.
Nombre	Flatkey Claude Code	Usa un nombre que quede claro en el cambio de bandeja de CC Switch más adelante.
Clave API	Tu clave API de Flatkey	Créala o cópiala desde el panel de Flatkey. Nunca pegues una clave real en documentos compartidos.
URL base de Claude Code	https://router.flatkey.ai	Usa esto para ANTHROPIC_BASE_URL. Luego Claude Code accede a rutas como /v1/messages.
URL base compatible con OpenAI	https://router.flatkey.ai/v1	Usa esto para clientes compatibles con OpenAI y comprobaciones de obtención de modelos que llaman a /v1/models.
Modelos Main/Sonnet/Opus/Haiku	IDs de modelo del resultado de fetch de CC Switch, de la consola de Flatkey o del catálogo de precios	Usa los IDs exactos de modelo. No uses nombres de marketing ni etiquetas de familia de modelos.
Verificación	Ejecuta un prompt pequeño de Claude Code y revisa los registros de uso de Flatkey	La configuración no está terminada hasta que la solicitud aparezca en el panel de Flatkey.

Si tu formulario de CC Switch expone un editor JSON avanzado, el perfil de Claude Code debería resolverse en una forma como esta. Usa un marcador de posición en la documentación; nunca almacenes una clave real en un repositorio.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-fk-your-flatkey-key",
    "ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
    "ANTHROPIC_MODEL": "your-claude-model-id"
  }
}

Claude Code también admite ANTHROPIC_API_KEY. Usa una variable de autenticación, no ambas, a menos que entiendas intencionalmente la precedencia. Para el enrutamiento de gateway estilo bearer, ANTHROPIC_AUTH_TOKEN mantiene explícito el mapeo porque Claude Code lo envía como valor del encabezado Authorization.

Dónde encaja NewAPI en el flujo de trabajo de cambio de CC

La documentación actual de CC Switch de NewAPI dice que la consola de New API puede añadir un acceso directo de Configuración de Chat con este JSON:

{ "CC Switch": "ccswitch" }

Después de eso, la página de gestión de tokens de New API puede mostrar una opción de CC Switch que inicia CC Switch mediante el enlace profundo ccswitch:// y abre el diálogo de importación del proveedor. La documentación de NewAPI describe los campos del diálogo como tipo de aplicación, nombre, modelo principal y selecciones de modelo Haiku/Sonnet/Opus.

Para Flatkey, usa el mismo concepto sin afirmar una importación desde la página de tokens de NewAPI. Si tu clave es una clave de Flatkey, añade el proveedor directamente en CC Switch. Si tu clave reside en una implementación de NewAPI, usa la importación con un clic de NewAPI. La distinción importante es simple: CC Switch gestiona la configuración local de Claude Code, mientras que Flatkey o NewAPI se encargan de la capa de enrutamiento upstream.

Antes de empezar

Antes de cambiar el proveedor CC Switch Claude Code, confirme estos requisitos previos:

• CC Switch está instalado en la máquina donde se ejecuta Claude Code.
• Claude Code ya está instalado y puede abrirse normalmente.
• Puede iniciar sesión en Flatkey y abrir el panel.
• Tiene una clave API de Flatkey para esta estación de trabajo o desarrollador.
• Conoce al menos un ID de modelo de Claude disponible para su cuenta de Flatkey.
• Puede revisar los registros de uso de Flatkey después de la primera solicitud de prueba.

No use una clave de producción compartida para la primera prueba. Cree una clave limitada con el nombre de la herramienta y del propietario, como cc-switch-lee o claude-code-devbox. Eso hace que la primera prueba rápida de CC Switch Claude Code sea fácil de auditar y fácil de revocar.

Paso 1: Crear o copiar una clave API de Flatkey

Abre el panel de Flatkey y crea una clave para usar Claude Code a través de CC Switch. Cópiala una sola vez y guárdala en tu gestor de contraseñas o en el gestor de secretos del equipo.

El campo de clave API de CC Switch debe contener la clave de Flatkey. No pegues una clave de Anthropic, OpenAI, Google ni de un proveedor específico en este perfil a menos que estés configurando intencionalmente ese proveedor directo en lugar de Flatkey.

Para equipos, crea claves separadas por usuario, dispositivo o entorno. Una clave compartida puede funcionar técnicamente, pero dificulta más adelante la revisión del uso y la revocación.

Paso 2: Añadir un proveedor de Claude Code en CC Switch

Abre CC Switch y ve al área de proveedores de Claude Code. El manual de usuario de CC Switch describe dos rutas de adición: proveedores específicos de la app para la app seleccionada y Universal Provider para una configuración compartida entre Claude Code, Codex y Gemini.

Para la primera configuración de CC Switch Claude Code con Flatkey, comienza con un proveedor de Claude Code específico de la app:

1. Abre CC Switch.
2. Selecciona Claude o Claude Code en el selector de aplicaciones.
3. Haz clic en el botón + para añadir un proveedor.
4. Elige una ruta de proveedor personalizada si no hay un ajuste preestablecido de Flatkey.
5. Establece el nombre del proveedor en Flatkey Claude Code.
6. Pega tu clave API de Flatkey.
7. Establece la URL base del gateway de Claude Code en https://router.flatkey.ai.
8. Elige los IDs de modelo para Main, Sonnet, Opus y Haiku solo después de confirmar que están disponibles para tu cuenta.

Si usas un Universal Provider, completa Name, API Key y Endpoint URL, y luego marca las apps que quieres sincronizar. Después de sincronizar, revisa la configuración generada de Claude Code. Para Claude Code, la base activa debe ser https://router.flatkey.ai. Para las configuraciones de apps compatibles con OpenAI, https://router.flatkey.ai/v1 suele ser la URL base esperada.

Paso 3: Obtener modelos antes de elegir Main, Sonnet, Opus y Haiku

CC Switch documenta una acción Fetch Models junto a las entradas de modelo. Usa la clave de API configurada para llamar a un endpoint /v1/models compatible con OpenAI y luego te permite seleccionar los IDs de modelo devueltos desde un menú desplegable.

Para este artículo, una comprobación fechada de Flatkey el 11 de junio de 2026 devolvió HTTP 200 desde https://router.flatkey.ai/v1/models con una respuesta de lista de modelos para la clave de prueba configurada. Los ejemplos devueltos incluyeron IDs de modelos de la familia Claude como claude-sonnet-4-6, claude-sonnet-4-5, claude-opus-4-7 y claude-haiku-4-5. Toma esos ejemplos como una instantánea actual, no como una recomendación permanente de modelo.

Usa esta regla de selección de modelos:

• Main Model: elige el modelo Claude que quieras que Claude Code use de forma predeterminada.
• Sonnet Model: elige el modelo equilibrado que tu equipo espera para la programación diaria.
• Opus Model: elige un modelo de mayor capacidad solo si tu presupuesto y acceso lo permiten.
• Haiku Model: elige un modelo ligero para tareas más rápidas o en segundo plano, si está disponible.

Si Fetch Models falla, no adivines. Abre la consola de Flatkey o el catálogo de precios, copia un ID de modelo exacto compatible con Claude y prueba primero solo con ese modelo.

Paso 4: Guarda, sincroniza y verifica la configuración generada de Claude Code

Después de guardar el proveedor, CC Switch escribe la configuración activa del proveedor para Claude Code. La ruta exacta del archivo puede variar según la versión de CC Switch y el ámbito de la aplicación, pero la documentación oficial de configuración de Claude Code confirma que las variables de entorno se pueden configurar a través de settings.json bajo la clave env.

Comprueba que la configuración generada no contenga valores de autenticación en conflicto. Un perfil limpio de Flatkey debería tener uno de estos patrones:

# Estilo de gateway con token Bearer
ANTHROPIC_AUTH_TOKEN=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.ai

o:

# Estilo de clave API
ANTHROPIC_API_KEY=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.ai

No dejes una clave directa antigua de Anthropic activa en tu shell mientras pruebas un nuevo perfil de CC Switch Claude Code. Si el shell todavía exporta un ANTHROPIC_API_KEY diferente, puede dificultar la solución de problemas porque el proceso activo podría no estar usando el perfil de CC Switch que crees que está usando.

Paso 5: Verificar en Claude Code y los registros de uso de Flatkey

Abra una terminal nueva después de habilitar el proveedor Flatkey en CC Switch. Claude Code puede admitir el cambio en caliente en algunas rutas de CC Switch, pero una terminal nueva elimina la confusión del estado del shell durante la primera prueba.

1. Inicie Claude Code.
2. Compruebe el modelo activo o el estado en Claude Code.
3. Envíe una indicación pequeña, como pedirle que responda con una sola frase corta.
4. Abra el panel de control de Flatkey.
5. Revise los registros de uso para ver la hora de la solicitud, el ID del modelo y el nombre de la clave.

La configuración de CC Switch Claude Code solo se completa cuando las tres capas coinciden: CC Switch muestra el proveedor Flatkey como activo, Claude Code usa el modelo/URL base esperados y los registros de Flatkey muestran la solicitud.

Solución de problemas de CC Switch Claude Code con Flatkey

Problema	Causa probable	Solución
Error de autenticación	La clave es incorrecta, está deshabilitada, se copió con espacios o no es una clave de Flatkey.	Crea una clave חדשה en Flatkey, pégala de nuevo y verifica que estás usando ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY, no valores en conflicto.
404 o ruta de endpoint incorrecta	La URL incluye la forma de ruta incorrecta para Claude Code.	Para Claude Code, usa https://router.flatkey.ai. Para la obtención de modelos compatible con OpenAI u otros clientes, usa https://router.flatkey.ai/v1.
Falla la obtención de modelos	La clave no puede llamar a /v1/models, la URL base es incorrecta o el endpoint no está disponible temporalmente.	Usa https://router.flatkey.ai/v1 para la ruta de obtención de modelos y luego recurre a los IDs exactos de modelo desde la consola de Flatkey.
Claude Code sigue usando el proveedor anterior	Un proceso de terminal antiguo o una exportación de shell está sobrescribiendo el perfil de CC Switch.	Abre una nueva terminal, revisa las variables de entorno del shell y asegúrate de que el proveedor de Flatkey esté habilitado en CC Switch.
La selección de modelo funciona pero las solicitudes fallan	El modelo seleccionado aparece en la lista, pero no está disponible para tu clave, grupo, saldo o política actual de la cuenta.	Prueba primero un modelo del que sepas que tienes acceso. Revisa el acceso de la cuenta Flatkey, el saldo, las cuotas y los registros de uso.
La búsqueda de herramientas MCP cambia el comportamiento	Claude Code trata las URL base que no son de primera parte como enrutamiento de gateway.	Sigue la guía de gateway de Claude Code antes de habilitar el comportamiento avanzado de búsqueda de herramientas a través de un proxy. No habilites marcas específicas de gateway a menos que tu gateway reenvíe los bloques requeridos.

La mayoría de los fallos de CC Switch Claude Code se reducen a cuatro campos: clave, URL base, ID de modelo y perfil activo. Revisa eso antes de reconstruir toda la base de datos de CC Switch.

CC Switch Vs A Claude Code Router

CC Switch y un router de Claude Code resuelven distintas partes del flujo de trabajo. CC Switch es el gestor de configuración local. Flatkey es la capa de enrutamiento y acceso.

Capa	Qué hace	Qué no hace
CC Switch	Almacena perfiles de proveedor, cambia configuraciones de Claude Code/Codex/Gemini, administra campos de modelo y puede importar proveedores mediante enlaces profundos.	No es la cuenta del modelo upstream, el sistema de facturación ni el router.
Claude Code	Ejecuta el asistente de programación y lee los valores activos del entorno/configuración.	No gestiona por sí solo las claves multi-proveedor de tu equipo ni la facturación.
Flatkey	Proporciona una clave, endpoints de gateway, acceso a modelos, visibilidad del uso, enrutamiento y controles de facturación para los modelos compatibles.	No reemplaza la interfaz local de cambio de perfiles de CC Switch.

Si solo necesitas una configuración de gateway permanente, puedes configurar Claude Code directamente. Si cambias entre varios proveedores, estaciones de trabajo o niveles de modelo, el flujo de trabajo CC Switch Claude Code te ofrece una superficie de control más limpia. Si también estás migrando código de una app a un gateway, lee la guía de migración de API compatible con OpenAI. Si estás decidiendo entre un proxy solo para Claude y un gateway más amplio, lee proxy de API de Claude vs router.

Implementación de equipo recomendada

Para un desarrollador, basta con una clave Flatkey y un proveedor CC Switch. Para un equipo, trate la configuración de CC Switch Claude Code como una implementación pequeña de control de acceso.

• Cree una clave Flatkey con nombre por desarrollador, estación de trabajo o entorno.
• Documente los IDs de modelo de Claude aprobados y a qué nivel se asigna cada uno en CC Switch.
• Use cuotas antes de invitar a más usuarios al mismo entorno de enrutamiento.
• Revise los registros de uso después del primer día, no solo después de una sorpresa en la facturación.
• Mantenga las capturas de pantalla fuera de los documentos públicos hasta que la interfaz actual esté confirmada por el revisor.
• Use la importación en un clic de NewAPI solo para claves gestionadas en NewAPI; use la configuración manual del proveedor Flatkey para las claves Flatkey.

FAQ

¿Qué es una configuración de CC Switch Claude Code?

Una configuración de CC Switch Claude Code es un perfil de proveedor en CC Switch que escribe los ajustes de endpoint, clave y modelo que Claude Code debe usar. Con Flatkey, ese perfil apunta Claude Code al router de Flatkey y usa una clave de Flatkey.

¿La URL base de Flatkey Claude Code debe incluir /v1?

Para ANTHROPIC_BASE_URL de Claude Code, usa https://router.flatkey.ai. Para clientes de aplicaciones compatibles con OpenAI y comprobaciones de obtención de modelos que llaman explícitamente a /v1/models, usa https://router.flatkey.ai/v1.

¿La importación con un clic de NewAPI configura Flatkey automáticamente?

No. La ruta de CC Switch con un clic de NewAPI está documentada para la página de gestión de tokens de New API. Para Flatkey, añade el proveedor manualmente en CC Switch a menos que Flatkey publique más adelante un enlace de importación dedicado ccswitch://.

¿Puede CC Switch obtener los modelos de Flatkey?

Sí, cuando la clave configurada puede acceder a la lista de modelos compatible con OpenAI de Flatkey. Una comprobación del 11 de junio de 2026 para este artículo devolvió HTTP 200 desde https://router.flatkey.ai/v1/models y una respuesta de lista de modelos para la clave de prueba configurada.

¿Debo usar ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN?

Claude Code documenta ambos. ANTHROPIC_API_KEY se envía como un encabezado de clave de API, mientras que ANTHROPIC_AUTH_TOKEN se envía a través de la ruta de autorización. Usa un solo método claro para el perfil de Flatkey y evita dejar ambos configurados con valores diferentes.

¿Cómo sé que la configuración funcionó?

La configuración funcionó cuando CC Switch muestra el proveedor de Flatkey como activo, Claude Code usa el modelo esperado, una prueba con un prompt pequeño se completa correctamente y la solicitud aparece en los registros de uso de Flatkey.

Comprobación final

La configuración de Flatkey de CC Switch Claude Code está lista cuando esta lista de verificación se cumple:

1. CC Switch tiene un proveedor Flatkey claramente nombrado bajo Claude Code.
2. La clave API es una clave Flatkey del panel.
3. ANTHROPIC_BASE_URL resuelve a https://router.flatkey.ai.
4. Los IDs de modelo seleccionados son IDs exactos disponibles para tu clave.
5. Obtener modelos o la entrada manual de modelos se realiza correctamente.
6. Claude Code ejecuta un pequeño prompt de prueba.
7. Los registros de uso de Flatkey muestran la solicitud.

Obtén una clave para enrutar Claude Code a través de Flatkey, y luego usa CC Switch para mantener el perfil del proveedor local fácil de cambiar, inspeccionar y revertir.