CLI CC Switch
Interface en ligne de commande pour CC Switch, une application de bureau qui gère les configurations des outils de codage IA (Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes). Construit avec Click et la méthodologie CLI-Anything.
Prérequis
- Python 3.10+
- CC Switch installé avec une base de données active dans
~/.cc-switch/cc-switch.db
Installation
pip install -e .
Après installation, la commande cli-anything-ccswitch est disponible.
Groupes de commandes
| Groupe | Description |
|---|---|
status | Affiche un aperçu rapide de la base de données |
providers | Gère les configurations des fournisseurs d'IA (liste, obtenir, définir-courant) |
proxy | Gère le serveur proxy HTTP local (état, config) |
mcp | Gère les serveurs MCP (Model Context Protocol) (liste, activer) |
skills | Gère les compétences installées (liste, dépôts) |
usage | Consulte les statistiques d'utilisation et de coût de l'API (stats, logs) |
settings | Consulte et gère les paramètres de CC Switch (liste, obtenir, définir) |
sessions | Parcourt et recherche les sessions de conversation IA (liste) |
Options globales
--json— Sortie au format JSON lisible par machine (recommandé pour les agents)--db CHEMIN— Remplace le chemin de la base de données
Conseils spécifiques aux agents
Sortie JSON
Utilisez toujours --json pour une consommation programmatique. Placez-le avant la
sous-commande :
cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude
Valeurs sensibles
Les jetons API, clés et secrets sont masqués dans toutes les sorties. Le champ settings_config
dans les détails du fournisseur affiche des valeurs masquées (ex. : sk-bc089...5cbb).
Codes de sortie
0— Succès1— Erreur (ex. : ressource introuvable, type d'application invalide)
Types d'applications
Types d'applications valides : claude, codex, gemini, opencode, openclaw, hermes.
Exemples
Lister tous les fournisseurs
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
Changer le fournisseur actif
cli-anything-ccswitch providers set-current <provider-id> --app claude
Vérifier l'état du proxy
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
Consulter les statistiques d'utilisation
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
Lister les compétences
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
Serveurs MCP
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
Paramètres
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <clé>
cli-anything-ccswitch settings set <clé> <valeur>
Sessions
cli-anything-ccswitch sessions list --app claude --limit 10
Aperçu de l'état
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
Gestion des erreurs
Lorsqu'une ressource est introuvable, la CLI affiche un message d'erreur sur stderr et se termine avec le code 1. Les agents doivent vérifier le code de sortie avant d'analyser la sortie.
Base de données
La CLI lit la base de données SQLite active de CC Switch. Toutes les opérations de lecture
sont sécurisées et ne modifient pas la base de données. Les opérations d'écriture (providers set-current, proxy config, mcp enable, settings set) modifient directement la base de données.