¿Qué hace CC Switch CLI?
CLI para CC Switch, una aplicación de escritorio que gestiona configuraciones de herramientas de codificación con IA (Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes). Construida con Click y la metodología CLI-Anything.
Prerrequisitos
- Python 3.10+
- CC Switch instalado con una base de datos activa en
~/.cc-switch/cc-switch.db
Instalación
pip install -e .
Después de la instalación, el comando cli-anything-ccswitch estará disponible.
Grupos de Comandos
| Grupo | Descripción |
|---|---|
status | Muestra una visión general rápida de la base de datos |
providers | Gestiona configuraciones de proveedores de IA (listar, obtener, establecer-actual) |
proxy | Gestiona el servidor proxy HTTP local (estado, config) |
mcp | Gestiona servidores MCP (Protocolo de Contexto de Modelo) (listar, habilitar) |
skills | Gestiona habilidades instaladas (listar, repos) |
usage | Ver estadísticas de uso y costos de API (stats, logs) |
settings | Ver y gestionar ajustes de CC Switch (listar, obtener, establecer) |
sessions | Navegar y buscar sesiones de conversación de IA (listar) |
Opciones Globales
--json— Salida en formato JSON legible por máquina (recomendado para uso con agentes)--db PATH— Sobrescribe la ruta de la base de datos
Guía Específica para Agentes
Salida JSON
Usa siempre --json para consumo programático. Colócalo antes del
subcomando:
cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude
Valores Sensibles
Los tokens de API, claves y secretos se enmascaran en todas las salidas. El campo
settings_config en los detalles del proveedor muestra valores enmascarados (por ejemplo, sk-bc089...5cbb).
Códigos de Salida
0— Éxito1— Error (por ejemplo, recurso no encontrado, tipo de aplicación no válido)
Tipos de Aplicación
Tipos de aplicación válidos: claude, codex, gemini, opencode, openclaw, hermes.
Ejemplos
Listar todos los proveedores
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
Cambiar proveedor activo
cli-anything-ccswitch providers set-current <provider-id> --app claude
Verificar estado del proxy
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
Ver estadísticas de uso
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
Listar habilidades
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
Servidores MCP
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
Ajustes
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <key>
cli-anything-ccswitch settings set <key> <value>
Sesiones
cli-anything-ccswitch sessions list --app claude --limit 10
Resumen de estado
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
Manejo de Errores
Cuando un recurso no se encuentra, la CLI imprime un mensaje de error en stderr y sale con código 1. Los agentes deben verificar el código de salida antes de analizar la salida.
Base de Datos
La CLI lee de la base de datos SQLite activa de CC Switch. Todas las operaciones de lectura
son seguras y no modifican la base de datos. Las operaciones de escritura (providers set-current, proxy config, mcp enable, settings set) modifican la
base de datos directamente.