CC Switch CLI
CLI-Wrapper für CC Switch, eine Desktop-App, die Konfigurationen für KI-Coding-Tools (Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes) verwaltet. Erstellt mit Click und der CLI-Anything-Methodik.
Voraussetzungen
- Python 3.10+
- CC Switch installiert mit einer aktiven Datenbank unter
~/.cc-switch/cc-switch.db
Installation
pip install -e .
Nach der Installation ist der Befehl cli-anything-ccswitch verfügbar.
Befehlgruppen
| Gruppe | Beschreibung |
|---|---|
status | Zeigt eine kurze Datenbankübersicht an |
providers | Verwaltet KI-Anbieterkonfigurationen (list, get, set-current) |
proxy | Verwaltet den lokalen HTTP-Proxy-Server (status, config) |
mcp | Verwaltet MCP (Model Context Protocol)-Server (list, enable) |
skills | Verwaltet installierte Skills (list, repos) |
usage | Zeigt API-Nutzungs- und Kostenstatistiken (stats, logs) |
settings | Zeigt und verwaltet CC Switch-Einstellungen (list, get, set) |
sessions | Durchsucht KI-Konversationssitzungen (list) |
Globale Optionen
--json— Ausgabe im maschinenlesbaren JSON-Format (für Agenten empfohlen)--db PFAD— Überschreibt den Datenbankpfad
Agentspezifische Hinweise
JSON-Ausgabe
Verwenden Sie für die programmatische Verwendung immer --json. Platzieren Sie es vor dem
Unterbefehl:
cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude
Sensitive Werte
API-Token, Schlüssel und Geheimnisse werden in der gesamten Ausgabe maskiert. Das Feld settings_config
in den Anbieterdetails zeigt maskierte Werte (z. B. sk-bc089...5cbb).
Exit-Codes
0— Erfolg1— Fehler (z. B. Ressource nicht gefunden, ungültiger App-Typ)
App-Typen
Gültige App-Typen: claude, codex, gemini, opencode, openclaw, hermes.
Beispiele
Alle Anbieter auflisten
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
Aktiven Anbieter wechseln
cli-anything-ccswitch providers set-current <anbieter-id> --app claude
Proxy-Status prüfen
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
Nutzungsstatistiken anzeigen
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
Skills auflisten
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
MCP-Server
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
Einstellungen
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <schlüssel>
cli-anything-ccswitch settings set <schlüssel> <wert>
Sitzungen
cli-anything-ccswitch sessions list --app claude --limit 10
Statusübersicht
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
Fehlerbehandlung
Wenn eine Ressource nicht gefunden wird, gibt die CLI eine Fehlermeldung auf stderr aus und beendet sich mit Code 1. Agenten sollten den Exit-Code überprüfen, bevor sie die Ausgabe parsen.
Datenbank
Die CLI liest aus der aktiven CC Switch SQLite-Datenbank. Alle Lesevorgänge
sind sicher und ändern die Datenbank nicht. Schreibvorgänge (providers set-current, proxy config, mcp enable, settings set) ändern die
Datenbank direkt.