Guía completa de CC-Switch: aprende a gestionar múltiples configuraciones de API de Claude Code en 5 minutos

Programar con Claude Code es genial, ¿pero el API oficial es muy caro? ¿Quieres cambiar a un intermediario de API de terceros pero no sabes cómo modificar el archivo de configuración? CC-Switch es la herramienta creada para solucionar este problema. Este artículo te llevará a dominar la instalación y el uso de CC-Switch en 5 minutos, logrando fácilmente la gestión unificada de API para los cuatro asistentes de programación de IA: Claude Code, Codex, OpenCode y Gemini CLI.

Valor central: Al terminar de leer este artículo, habrás aprendido a usar CC-Switch para gestionar visualmente múltiples Proveedores de API (Providers), cambiar configuraciones con un solo clic y decir adiós a la tediosa tarea de editar manualmente archivos JSON.

¿Qué es CC-Switch? ¿Por qué lo necesitas?

CC-Switch es una aplicación de escritorio de código abierto y multiplataforma, diseñada específicamente para gestionar de forma unificada las configuraciones de los asistentes de programación de IA. Fue creada por el desarrollador farion1231 y está disponible en GitHub.

Posicionamiento principal de CC-Switch

En pocas palabras, CC-Switch es el "centro de gestión de configuración" para tus herramientas de IA:

Las 4 herramientas de programación de IA compatibles

🚀 Inicio rápido: CC-Switch permite conectar intermediarios de terceros como APIYI (apiyi.com). Una vez configurado el Provider, puedes usar herramientas como Claude Code a un costo menor, disfrutando al mismo tiempo de la comodidad del cambio con un solo clic.

Funciones principales de CC-Switch en detalle

CC-Switch no es solo un selector de configuraciones, es una plataforma completa para la gestión de herramientas de IA:

Función 1: Gestión de Proveedores (Funcionalidad principal)

Esta es la función más utilizada de CC-Switch, y permite:

Ejemplo de configuración de proveedor:

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "models": {
    "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
    "claude-opus-4-20250514": "claude-opus-4-20250514"
  }
}

Función 2: Gestión de servidores MCP

MCP (Model Context Protocol) es el protocolo de extensión de Claude Code. CC-Switch ofrece una interfaz de gestión unificada:

• Soporta tres tipos de transporte: stdio, http y sse.
• Configuración unificada para múltiples aplicaciones (Claude/Codex/Gemini).
• Agrega, edita y elimina servidores MCP de forma visual.

Función 3: Gestión de Habilidades (Skills)

CC-Switch puede descubrir e instalar automáticamente habilidades para Claude:

• Escaneo automático de Skills en repositorios de GitHub.
• Instalación en un solo clic en el directorio ~/.claude/skills/.
• Soporte para escaneo recursivo en directorios anidados.

Función 4: Gestión de Indicaciones de sistema (System Prompts)

Crea preajustes de indicaciones para diferentes escenarios:

• Cantidad ilimitada de preajustes de indicaciones.
• Soporte para archivos CLAUDE.md, AGENTS.md y GEMINI.md.
• Cambio rápido entre diferentes modos de trabajo.

Función 5: Proxy API local (v3.9.0+)

CC-Switch integra un servidor proxy local que ofrece funciones avanzadas:

💡 Sugerencia técnica: La función de proxy local funciona mucho mejor cuando se utiliza con APIYI (apiyi.com). APIYI proporciona interfaces compatibles con OpenAI de gran estabilidad, y la función de failover de CC-Switch puede cambiar automáticamente ante fluctuaciones de red, garantizando que tu experiencia de programación no se interrumpa.

Guía de instalación de CC-Switch

CC-Switch es compatible con las tres plataformas principales: Windows, macOS y Linux, y ofrece diversos métodos de instalación.

Instalación en Windows

Opción 1: Instalador MSI (recomendado)

Descarga el archivo .msi desde GitHub Releases y haz doble clic para instalarlo.

Opción 2: Versión portátil

Descarga la versión portátil en .zip, descomprímela y ejecútala directamente, sin necesidad de instalación.

Instalación en macOS

Opción 1: Homebrew (recomendado)

brew install --cask cc-switch

Opción 2: Instalación manual

Descarga el archivo .dmg o .zip y arrástralo a la carpeta de Aplicaciones (Applications).

Nota: Es posible que al iniciarlo por primera vez aparezca una advertencia de Gatekeeper. Deberás permitir su ejecución en "Ajustes del Sistema → Seguridad y privacidad".

Instalación en Linux

CC-Switch ofrece varios formatos de paquetes para Linux:

Verificar la instalación

Una vez completada la instalación, abre CC-Switch. Deberías ver en la interfaz principal el estado de las herramientas de CLI detectadas.

Configuración rápida de CC-Switch

Paso 1: Añadir el Proveedor APIYI

1. Haz clic en el botón 「Add Provider」 de la interfaz principal.
2. Selecciona 「Custom」 para una configuración personalizada.
3. Rellena la siguiente información:

Nombre: APIYI
Base URL: https://api.apiyi.com
API Key: sk-your-apiyi-key  # Consíguela en apiyi.com

4. Configura el mapeo de modelos (opcional):

{
  "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
  "claude-opus-4-20250514": "claude-opus-4-20250514",
  "gpt-4o": "gpt-4o"
}

5. Haz clic en 「Save」 para guardar la configuración.

Obtener API Key: Regístrate en APIYI (apiyi.com) para obtener tu API Key. La plataforma ofrece una cuota de prueba gratuita y es compatible con los principales modelos como Claude, GPT y Gemini.

Paso 2: Cambiar de Proveedor

Una vez guardada la configuración, en la lista de proveedores de la interfaz principal:

1. Busca el proveedor «APIYI» que acabas de añadir.
2. Haz clic en 「Switch」 o simplemente selecciona dicho proveedor.
3. CC-Switch modificará automáticamente el archivo de configuración de la herramienta correspondiente.
4. Reinicia Claude Code u otras herramientas de CLI para que los cambios surtan efecto.

Paso 3: Probar la conexión

Utiliza la función de prueba de velocidad de CC-Switch para verificar la configuración:

1. Haz clic en el botón 「Test」 junto al proveedor.
2. Espera a que termine la prueba de latencia.
3. Comprueba el tiempo de respuesta y el indicador de estado.

Si la prueba es satisfactoria, abre la terminal y ejecuta Claude Code:

claude

Si puedes iniciar una conversación con normalidad, significa que la configuración se ha realizado correctamente.

Ejemplo de configuración simplificada

{
  "id": "apiyi-provider",
  "name": "APIYI (Recomendado)",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "enabled": true,
  "models": {
    "claude-sonnet-4-20250514": {
      "id": "claude-sonnet-4-20250514",
      "name": "Claude Sonnet 4",
      "maxTokens": 64000
    },
    "claude-opus-4-20250514": {
      "id": "claude-opus-4-20250514",
      "name": "Claude Opus 4",
      "maxTokens": 32000
    },
    "gpt-4o": {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "maxTokens": 16384
    },
    "gpt-4o-mini": {
      "id": "gpt-4o-mini",
      "name": "GPT-4o Mini",
      "maxTokens": 16384
    }
  },
  "healthCheck": {
    "enabled": true,
    "interval": 60
  }
}

Funciones avanzadas de CC-Switch

Estrategia de gestión multi-proveedor (Multi-Provider)

CC-Switch permite configurar múltiples proveedores para implementar estrategias de uso flexibles:

┌─────────────────────────────────────────────────────────┐
│              Lista de proveedores de CC-Switch          │
├─────────────────────────────────────────────────────────┤
│  ⭐ APIYI (Principal)    Latencia: 120ms   ✓ Saludable  │
│  📦 OpenRouter (Respaldo) Latencia: 280ms   ✓ Saludable  │
│  🏢 Claude Oficial (Garantía) Latencia: 350ms ✓ Saludable│
└─────────────────────────────────────────────────────────┘

Configuración recomendada:

• Principal: APIYI – Precios económicos y acceso rápido desde regiones con restricciones.
• Respaldo: OpenRouter – Gran variedad de modelos y estabilidad internacional.
• Garantía (Failsafe): Inicio de sesión oficial – Para asegurar disponibilidad en todo momento.

Configuración de sincronización en la nube

CC-Switch permite sincronizar tu configuración con almacenamiento en la nube:

1. Ve a Settings → Storage
2. Selecciona una carpeta de sincronización (Dropbox, OneDrive, iCloud Drive)
3. CC-Switch sincronizará automáticamente la configuración de tus proveedores.

De esta manera, puedes compartir la misma configuración de API entre múltiples dispositivos.

Configuración avanzada de proxy local

Al activar el proxy local, CC-Switch hará lo siguiente:

1. Iniciará un servidor proxy de forma local.
2. Modificará automáticamente la configuración de la CLI para que apunte al proxy local.
3. El servidor proxy reenviará las solicitudes al proveedor real.

Ventajas:

• Todas las solicitudes pasan por un punto único, facilitando el monitoreo.
• Conmutación por error (failover) automática: si un proveedor cae, cambia al siguiente automáticamente.
• Registro de logs de solicitudes para facilitar la resolución de problemas.

# Flujo de solicitud en modo proxy
Claude Code → localhost:8080 → Proxy de CC-Switch → APIYI → Claude API

Función Claude Rectifier

La nueva función Claude Rectifier, añadida en la v3.10.0, sirve para solucionar problemas de compatibilidad con APIs de terceros:

• Corrige automáticamente el formato de la "thinking signature".
• Mejora la compatibilidad con APIs no oficiales.
• Reduce los errores de tipo "formato incorrecto".

Preguntas frecuentes (FAQ) sobre CC-Switch

# Opción 1: Cierra la terminal actual y ábrela de nuevo.
# Opción 2: Escribe /exit en Claude Code para salir y luego reinícialo.
claude  # Reiniciar

# Elimina la configuración personalizada y restaura el modo oficial
rm ~/.claude/settings.json
claude  # Inicia sesión de nuevo con tu cuenta oficial

CC-Switch vs. Configuración manual: Comparativa

Comparativa de eficiencia: CC-Switch vs. Configuración manual

VS

<!-- 标题 -->
<rect x="0" y="0" width="280" height="45" rx="12" fill="url(#ccGrad)" />
<rect x="0" y="30" width="280" height="15" fill="url(#ccGrad)" />
<text x="140" y="30" text-anchor="middle" fill="#ffffff" font-size="16" font-weight="bold" font-family="system-ui, sans-serif">Método CC-Switch</text>

<!-- 优势列表 -->
<g transform="translate(20, 65)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#059669" opacity="0.3" />
  <text x="15" y="23" fill="#10b981" font-size="12" font-family="system-ui, sans-serif">✓ Interfaz visual, sin formatos complejos</text>
</g>

<g transform="translate(20, 110)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#059669" opacity="0.3" />
  <text x="15" y="23" fill="#10b981" font-size="12" font-family="system-ui, sans-serif">✓ Cambio en un clic, efecto inmediato</text>
</g>

<g transform="translate(20, 155)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#059669" opacity="0.3" />
  <text x="15" y="23" fill="#10b981" font-size="12" font-family="system-ui, sans-serif">✓ Gestión unificada de 4 herramientas</text>
</g>

<g transform="translate(20, 200)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#059669" opacity="0.3" />
  <text x="15" y="23" fill="#10b981" font-size="12" font-family="system-ui, sans-serif">✓ Test de velocidad + failover automático</text>
</g>

<g transform="translate(20, 245)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#059669" opacity="0.3" />
  <text x="15" y="23" fill="#10b981" font-size="12" font-family="system-ui, sans-serif">✓ Backup auto + Sincronización nube</text>
</g>

<!-- 效率标签 -->
<rect x="80" y="290" width="120" height="25" rx="12" fill="#10b981" />
<text x="140" y="307" text-anchor="middle" fill="#ffffff" font-size="11" font-weight="bold" font-family="system-ui, sans-serif">Eficiencia x10 ⚡</text>

<!-- 标题 -->
<rect x="0" y="0" width="280" height="45" rx="12" fill="url(#manualGrad)" />
<rect x="0" y="30" width="280" height="15" fill="url(#manualGrad)" />
<text x="140" y="30" text-anchor="middle" fill="#ffffff" font-size="16" font-weight="bold" font-family="system-ui, sans-serif">Configuración manual</text>

<!-- 痛点列表 -->
<g transform="translate(20, 65)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#ef4444" opacity="0.2" />
  <text x="15" y="23" fill="#f87171" font-size="12" font-family="system-ui, sans-serif">✗ Requiere editar archivos JSON a mano</text>
</g>

<g transform="translate(20, 110)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#ef4444" opacity="0.2" />
  <text x="15" y="23" fill="#f87171" font-size="12" font-family="system-ui, sans-serif">✗ Necesita reiniciar CLI tras cambios</text>
</g>

<g transform="translate(20, 155)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#ef4444" opacity="0.2" />
  <text x="15" y="23" fill="#f87171" font-size="12" font-family="system-ui, sans-serif">✗ Configuración individual por app</text>
</g>

<g transform="translate(20, 200)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#ef4444" opacity="0.2" />
  <text x="15" y="23" fill="#f87171" font-size="12" font-family="system-ui, sans-serif">✗ Sin test, elección de proveedor al azar</text>
</g>

<g transform="translate(20, 245)">
  <rect x="0" y="0" width="240" height="35" rx="6" fill="#ef4444" opacity="0.2" />
  <text x="15" y="23" fill="#f87171" font-size="12" font-family="system-ui, sans-serif">✗ Recuperación manual de datos</text>
</g>

<!-- 效率标签 -->
<rect x="80" y="290" width="120" height="25" rx="12" fill="#64748b" />
<text x="140" y="307" text-anchor="middle" fill="#ffffff" font-size="11" font-weight="bold" font-family="system-ui, sans-serif">Tedioso y propenso a errores 😓</text>

💡 Recomendación: CC-Switch + APIYI apiyi.com = El combo de eficiencia total

🎯 Sugerencia de elección: Si sueles cambiar entre varios proveedores de API o utilizas varias herramientas de programación con IA de forma simultánea, CC-Switch te ahorrará muchísimo tiempo. Combinado con APIYI (apiyi.com), obtendrás la mejor experiencia: bajo coste y máxima comodidad.

Comparativa de herramientas relacionadas con CC-Switch

Además de CC-Switch, existen otras opciones similares en el ecosistema:

Combo recomendado: CC-Switch (para gestionar la config) + APIYI (como pasarela API) = La solución con mejor relación calidad-precio.

Recursos

Resumen

CC-Switch es una herramienta potente para gestionar la configuración de asistentes de programación de IA, y resuelve los siguientes puntos de dolor:

1. Configuración tediosa: Una interfaz visual reemplaza la edición manual de archivos JSON.
2. Cambios complicados: Cambia entre múltiples proveedores (Providers) con un solo clic.
3. Herramientas dispersas: Gestión unificada de Claude Code, Codex, OpenCode y Gemini CLI.
4. Imposibilidad de medir velocidad: Prueba de latencia integrada para elegir el proveedor más rápido.
5. Pérdida de configuración: Copia de seguridad automática y sincronización en la nube; nunca pierdas tus ajustes.

Para los desarrolladores que utilizan herramientas de programación de IA con frecuencia, la combinación de CC-Switch + APIYI es la solución recomendada:

• CC-Switch: Ofrece una gestión de configuración cómoda y sencilla.
• APIYI (apiyi.com): Ofrece servicios de API estables y a bajo coste.

Visita APIYI (apiyi.com) para registrarte, obtén tu clave de API (API Key), añade el proveedor en CC-Switch y comienza a disfrutar de una experiencia de programación con IA fluida y sin interrupciones.

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