Una API para todosGuía de uso
Sitio web ↗
Guía de usoConectar herramientas

CC Switch

CC Switch gestiona configuraciones: después de activar un proveedor, debes abrir el agente correspondiente.

Prepara estos tres datos

Con la aplicación ya instalada, abre Autoservicio en esta web e inicia sesión. Crea o consulta tu clave, copia la dirección de API mostrada y un ID exacto de Modelos y precios. No uses la página de inicio, la contraseña de acceso ni un nombre comercial del modelo. Comprueba el saldo y la cuota de la clave.

API_HOST, YOUR_API_KEY y YOUR_MODEL_ID son marcadores: sustitúyelos antes de usar el ejemplo. Sigue las indicaciones sobre /v1; no añadas /chat/completions ni /responses. Los ejemplos no se conectan automáticamente ni incluyen tu clave.

1. Selecciona el cliente

En la barra lateral elige Codex o Claude Code y pulsa + / Añadir proveedor. Cada pestaña modifica un cliente distinto. Sigue solo la rama correspondiente.

2. Crea un proveedor personalizado

Elige configuración personalizada, llámala My API e introduce tu clave. No conserves la dirección predefinida de otro servicio. Revisa el cliente antes de guardar.

3. Rama Codex: Responses

Elige Responses, usa https://API_HOST/v1 y un ID disponible compatible. Comprueba wire_api = "responses" en la vista previa. Selecciona solo niveles de razonamiento admitidos.

Esquema de campos · no es una captura
Codex
Responses · https://API_HOST/v1
Claude Code
Messages · https://API_HOST
API Key
YOUR_API_KEY
Provider name
My API

4. Rama Claude Code: Messages

Elige Anthropic Messages, la raíz indicada por la plataforma —https://API_HOST en este ejemplo— y ANTHROPIC_AUTH_TOKEN. Sonnet/Opus/Haiku son posiciones de cliente: asígnalas solo a modelos disponibles y compatibles.

5. Activa y prueba en el agente

Guarda, pulsa Activar en la tarjeta y confirma el proveedor activo. Reabre el cliente o terminal. Empieza con conexión directa; no hace falta activar enrutamiento local ni agregación. Haz las dos pruebas siguientes en Codex o Claude Code: una tarjeta activa no demuestra conexión.

Prueba 1: recibir una respuesta

Crea una carpeta vacía de prueba, selecciónala como espacio de trabajo y abre una conversación nueva. Comprueba el proveedor y modelo elegidos y envía el mensaje siguiente. Una respuesta sin errores confirma la conexión básica, no todas las funciones. Las pruebas generan consumo normal de API.

Responde solo: Conexión correcta.

Resultado: aparece «Conexión correcta». Si ves una pantalla de acceso, un error o una carga interminable, revisa la tabla antes de repetir.

Prueba 2: leer un archivo real

Con un editor de texto, crea hello.txt en esa carpeta y escribe «API connection test 27». Guarda y envía la petición siguiente. Si solicita permiso, permite leer únicamente esa carpeta.

Utiliza la herramienta de lectura para abrir hello.txt en el espacio de trabajo actual y dime su contenido. No modifiques archivos.

Resultado: un registro de herramienta que lea hello.txt y una respuesta con API connection test 27. Una respuesta de texto sin registro no demuestra una llamada. Después puedes borrar la carpeta de prueba.

Revisa el problema según el síntoma

401 / Invalid API key

Comprueba que dirección y clave completa pertenecen al mismo servicio y que la clave está activa. No envíes claves completas a soporte.

404 / model not found

Revisa /v1, el ID exacto y el protocolo. Ver un modelo en la lista no garantiza todos los protocolos.

429 / quota / balance

Revisa saldo, cuota y frecuencia de solicitudes según el error. Más razonamiento no resuelve la falta de cuota.

Responde pero no lee archivos

Comprueba las herramientas del modelo, los permisos de carpeta y el error de ejecución.

No aparece el nivel de razonamiento

Revisa capacidades, modelo y versión. Poder razonar no implica admitir varios niveles.

Referencias oficiales y alcance

Configuración contrastada el 2026-11-08. Los menús pueden cambiar; consulta estas referencias oficiales. Utiliza siempre los datos de conexión actuales de nuestra plataforma.