CLI CC Switch
CLI para CC Switch, um aplicativo desktop que gerencia configurações de ferramentas de codificação de IA (Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes). Construído com Click e a metodologia CLI-Anything.
Pré-requisitos
- Python 3.10+
- CC Switch instalado com um banco de dados ativo em
~/.cc-switch/cc-switch.db
Instalação
pip install -e .
Após a instalação, o comando cli-anything-ccswitch estará disponível.
Grupos de Comandos
| Grupo | Descrição |
|---|---|
status | Mostra uma visão geral rápida do banco de dados |
providers | Gerencia configurações de provedores de IA (listar, obter, definir-atual) |
proxy | Gerencia o servidor proxy HTTP local (status, config) |
mcp | Gerencia servidores MCP (Model Context Protocol) (listar, ativar) |
skills | Gerencia skills instaladas (listar, repositórios) |
usage | Visualiza estatísticas de uso e custo da API (stats, logs) |
settings | Visualiza e gerencia configurações do CC Switch (listar, obter, definir) |
sessions | Navega e pesquisa sessões de conversa de IA (listar) |
Opções Globais
--json— Saída em formato JSON legível por máquina (recomendado para uso por agentes)--db PATH— Substitui o caminho do banco de dados
Orientações Específicas para Agentes
Saída JSON
Sempre use --json para consumo programático. Coloque-o antes do
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 Sensíveis
Tokens de API, chaves e segredos são mascarados em toda a saída. O campo
settings_config nos detalhes do provedor mostra valores mascarados (ex.: sk-bc089...5cbb).
Códigos de Saída
0— Sucesso1— Erro (ex.: recurso não encontrado, tipo de app inválido)
Tipos de App
Tipos de app válidos: claude, codex, gemini, opencode, openclaw, hermes.
Exemplos
Listar todos os provedores
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
Alternar provedor ativo
cli-anything-ccswitch providers set-current <provider-id> --app claude
Verificar status do proxy
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
Visualizar estatí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 skills
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
Configurações
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <key>
cli-anything-ccswitch settings set <key> <value>
Sessões
cli-anything-ccswitch sessions list --app claude --limit 10
Visão geral do status
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
Tratamento de Erros
Quando um recurso não é encontrado, o CLI imprime uma mensagem de erro no stderr e sai com código 1. Agentes devem verificar o código de saída antes de interpretar a saída.
Banco de Dados
O CLI lê do banco de dados SQLite ativo do CC Switch. Todas as operações de leitura
são seguras e não modificam o banco de dados. Operações de escrita (providers set-current, proxy config, mcp enable, settings set) modificam o banco de dados diretamente.