Tutorial completo para agregar proveedores en CC-Switch: guía de configuración de 4 pasos con APIYI como ejemplo

Una vez instalado CC-Switch, el siguiente paso es añadir tu propio proveedor de API. Muchos principiantes se quedan atascados aquí: no saben qué rellenar, dónde hacerlo o cómo hacer que funcione. En este artículo, tomaremos como ejemplo a APIYI (apiyi.com) para enseñarte paso a paso cómo añadir, cambiar, medir la velocidad y restaurar el inicio de sesión oficial en CC-Switch.

Valor central: Al terminar de leer, dominarás la gestión de proveedores en CC-Switch y podrás completar toda la configuración, desde la adición hasta la activación, en solo 3 minutos.

Preparativos antes de añadir un proveedor en CC-Switch

Antes de comenzar la configuración, necesitas preparar lo siguiente:

Lista de requisitos previos

Registro de cuenta en APIYI

Si aún no tienes una cuenta en APIYI, completa primero el registro:

1. Visita el sitio oficial de APIYI: apiyi.com
2. Haz clic en "Registrarse" y crea tu cuenta.
3. Entra al panel de control para obtener tu API Key.
4. Anota la siguiente información:
   • API Key: Cadena de texto que comienza con sk-.
   • Base URL: https://api.apiyi.com

🚀 Beneficio para nuevos usuarios: Al registrarte en APIYI (apiyi.com), recibirás créditos de prueba gratuitos. Es compatible con los modelos más populares como Claude, GPT y Gemini, así que puedes probarlo antes de decidir si recargar saldo.

Comprobar conflictos de variables de entorno

Importante: Si has configurado previamente una API Key en las variables de entorno de tu sistema, esta podría sobrescribir la configuración de CC-Switch.

Comprueba y limpia las variables de entorno en conflicto:

macOS/Linux:

# Comprobar si existen variables en conflicto
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# Si devuelven algún valor, debes eliminarlas de ~/.zshrc o ~/.bashrc

Windows:

• Abre "Propiedades del sistema → Opciones avanzadas → Variables de entorno".
• Busca y elimina variables como ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.

Pasos para añadir un proveedor en CC-Switch

Paso 1: Abre la interfaz para añadir proveedores

1. Inicia la aplicación CC-Switch.
2. Busca el botón «Add Provider» en la interfaz principal (generalmente se encuentra encima de la lista de proveedores).
3. Haz clic en el botón para abrir la ventana de configuración del proveedor.

Paso 2: Elige el método de configuración

CC-Switch ofrece dos formas de añadir proveedores:

Como APIYI es un proveedor de terceros, elegiremos la opción «Custom» (Personalizada).

Paso 3: Rellena los datos de configuración

Este es el paso más importante; asegúrate de completar los siguientes campos con precisión:

Información básica

Configuración de Claude Code (si se utiliza)

CC-Switch permite configurar los siguientes campos para Claude Code:

Configuración de mapeo de modelos (opcional)

Si necesitas especificar un modelo por defecto, puedes configurar lo siguiente:

Ejemplo de configuración completa

Aquí tienes la configuración completa para añadir APIYI como proveedor:

# Información básica
Name: APIYI
Base URL: https://api.apiyi.com

# Configuración de Claude Code
ANTHROPIC_AUTH_TOKEN: sk-tu-clave-apiyi
ANTHROPIC_BASE_URL: https://api.apiyi.com

# Configuración de modelos (opcional)
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-tu-clave-apiyi",
    "ANTHROPIC_API_KEY": "sk-tu-clave-apiyi",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  },
  "codex": {
    "OPENAI_API_KEY": "sk-tu-clave-apiyi",
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  },
  "gemini": {
    "GEMINI_API_KEY": "sk-tu-clave-apiyi",
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

Paso 4: Guarda la configuración

1. Comprueba que todos los campos obligatorios estén completos.
2. Haz clic en el botón «Save» o «Confirmar».
3. CC-Switch validará el formato de la configuración.
4. Una vez guardado con éxito, el nuevo proveedor aparecerá en la lista.

💡 Consejo de configuración: La interfaz proporcionada por APIYI (apiyi.com) es totalmente compatible con los formatos de OpenAI y Anthropic. Por lo tanto, basta con poner https://api.apiyi.com en el campo Base URL, sin necesidad de añadir el sufijo /v1 (CC-Switch lo gestionará automáticamente).

3 formas de cambiar de proveedor en CC-Switch

Una vez completada la adición, es necesario cambiar al nuevo proveedor para que surta efecto. CC-Switch ofrece 3 formas de hacerlo:

Método 1: Interfaz principal (Recomendado para principiantes)

Esta es la forma más intuitiva:

1. En la lista de proveedores de la interfaz principal de CC-Switch.
2. Busca el proveedor «APIYI» que acabas de añadir.
3. Haz clic en el botón «Enable» o «Activar» a la derecha de dicho proveedor.
4. El estado cambiará a Active, lo que indica que el cambio se realizó con éxito.

┌─────────────────────────────────────────────────┐
│          Lista de proveedores CC-Switch         │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● APIYI (Active)          [Disable] [Test]     │  ← Activo ahora
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

Método 2: Bandeja del sistema (Recomendado para usuarios expertos)

Una forma más rápida, sin necesidad de abrir la ventana principal:

1. Busca el icono de CC-Switch en la bandeja del sistema (esquina inferior derecha en Windows / barra de menús en macOS).
2. Haz clic en el icono para desplegar el menú.
3. Haz clic directamente en el nombre del proveedor «APIYI».
4. El cambio surte efecto de inmediato, sin confirmaciones adicionales.

Ventaja: Este método es el más veloz, ideal para escenarios donde necesites cambiar de proveedor con frecuencia.

Método 3: Configuración por aplicación

Si utilizas varias herramientas CLI al mismo tiempo, puedes asignar un proveedor distinto a cada aplicación:

En CC-Switch, cada aplicación puede tener configurado su propio proveedor de forma independiente.

Cómo aplicar los cambios de proveedor en CC-Switch

Importante: Tras cambiar de proveedor, la configuración no se aplicará inmediatamente en las herramientas de CLI; es necesario reiniciar la aplicación correspondiente.

Pasos para aplicar los cambios

Verificar que la configuración esté activa

Tras reiniciar, puedes comprobarlo de las siguientes formas:

Método 1: Prueba de chat directa

claude
# Escribe una pregunta sencilla; si responde normalmente, la configuración es correcta
> Hola, por favor responde en español

Método 2: Usar la función de prueba de velocidad de CC-Switch

1. Haz clic en el botón "Test" junto al proveedor.
2. Revisa la latencia y el estado.
3. Un check verde ✓ indica que la conexión funciona correctamente.

Método 3: Revisar el archivo de configuración

# Archivo de configuración de Claude Code
cat ~/.claude/settings.json

# Deberías ver un contenido similar a este:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 Sugerencia de verificación: Puedes consultar el historial de llamadas a la API en la consola de APIYI (apiyi.com). Si aparecen nuevos registros de peticiones, significa que la configuración se ha aplicado con éxito.

Restaurar el inicio de sesión oficial en CC-Switch

Si necesitas volver a utilizar los servicios oficiales, CC-Switch ofrece una función de restauración con un solo clic.

Restaurar el inicio de sesión oficial en Claude Code

1. Busca el ajuste preestablecido "Official Login" en la lista de proveedores de CC-Switch.
2. Haz clic en "Enable" para cambiar al modo oficial.
3. Reinicia la terminal y ejecuta claude.
4. Sigue el proceso de inicio de sesión oficial de Claude Code (autenticación OAuth).

Restaurar el inicio de sesión oficial en Codex

1. Selecciona el ajuste preestablecido "Official Login" (versión Codex).
2. Haz clic en habilitar.
3. Reinicia y ejecuta codex.
4. Sigue las instrucciones para completar la autenticación oficial de OpenAI.

Restaurar el inicio de sesión oficial en Gemini CLI

1. Selecciona el ajuste preestablecido "Google Official".
2. Haz clic en habilitar.
3. Reinicia y ejecuta gemini.
4. Sigue las instrucciones para completar el proceso de Google OAuth.

Resumen del proceso de restauración

Nota: Al restaurar el inicio de sesión oficial, CC-Switch guardará automáticamente una copia de seguridad de tu configuración personalizada. La próxima vez que cambies a un proveedor de terceros, tu configuración anterior se mantendrá intacta.

Técnicas avanzadas de gestión de proveedores en CC-Switch

Consejo 1: Comparativa de velocidad de proveedores

Una vez que hayas añadido varios proveedores, puedes realizar una prueba de velocidad masiva para elegir el más rápido:

1. Haz clic consecutivamente en el botón 「Test」 de cada proveedor.
2. Registra los valores de latencia de cada uno.
3. Selecciona el que tenga la latencia más baja como tu proveedor principal.

Estándares de referencia:

Consejo 2: Duplicar proveedores

Si necesitas crear un proveedor con una configuración similar a uno existente:

1. Selecciona el proveedor actual.
2. Haz clic en 「Duplicate」 o haz clic derecho y selecciona "Copiar".
3. Modifica el nombre y los ajustes necesarios.
4. Guárdalo como un nuevo proveedor.

Consejo 3: Respaldo y sincronización de configuración

CC-Switch permite la sincronización de la configuración en la nube:

1. Ve a Settings → Storage.
2. Selecciona una carpeta de sincronización en la nube (como Dropbox o OneDrive).
3. Toda la configuración de tus proveedores se sincronizará automáticamente.

Esto te permite compartir la misma configuración de proveedores entre múltiples dispositivos.

Consejo 4: Compartir configuración de proveedores

La versión v3.9.0 o superior incluye la función "Compartir proveedor":

• Una misma configuración de proveedor se puede aplicar simultáneamente a Claude, Codex y Gemini.
• Es ideal cuando usas pasarelas como APIYI que admiten múltiples protocolos.
• Al añadir un proveedor, marca la opción 「Sync to all apps」.

Preguntas frecuentes sobre la adición de proveedores en CC-Switch

Tabla de consulta rápida de configuración del proveedor APIYI

Para facilitar una configuración rápida, aquí tienes los parámetros completos de APIYI:

Resumen

Con este tutorial, has aprendido el proceso completo de gestión de proveedores en CC-Switch:

1. Añadir proveedor: Haz clic en Add Provider → selecciona Custom → completa la configuración → guardar.
2. Cambiar de proveedor: Haz clic en Enable en la interfaz principal o directamente en el nombre del proveedor en la bandeja del sistema.
3. Método para aplicar cambios: Reinicia la terminal o el cliente CLI correspondiente.
4. Restaurar oficial: Selecciona el ajuste preestablecido Official Login → reinicia → completa el proceso de OAuth.

La combinación de CC-Switch + APIYI simplifica la gestión de APIs:

• CC-Switch: Gestión visual, cambio con un solo clic.
• APIYI (apiyi.com): Interfaz unificada, precios económicos y soporte para múltiples modelos.

¡Visita ahora APIYI (apiyi.com) para obtener tu API Key, añade el proveedor en CC-Switch y empieza a disfrutar de una experiencia de programación con IA eficiente!

📝 Autor: Equipo técnico de APIYI | APIYI (apiyi.com) – Simplificando las llamadas a las API de IA