Switch Provider

Aplicativo desktop em Rust/Slint para gerenciar providers de LLM usados pelo Claude Code.

O Claude Code lê um único arquivo ativo em ~/.claude/settings.json. O Switch Provider mantém backups como settings-minimax.json, settings-openrouter.json e outros settings-NOME.json, permitindo alternar o provider ativo sem reconfigurar tudo manualmente.

Recursos

• Interface desktop para adicionar, ativar, renomear e remover providers.
• Providers suportados: MiniMax, OpenRouter, OpenCode Zen, OpenCode Go, Anthropic, Z.AI/GLM, Google AI, OpenAI e Custom.
• Troca dinâmica de modelo para OpenRouter, OpenCode Zen e OpenCode Go, com carregamento atualizado pela API e filtro na interface.
• OpenCode Zen validado em uso real com Claude Code. O catalogo usa IDs crus, como kimi-k2.5, sem prefixos opencode/.
• OpenCode Go fica disponivel como provider separado e requer assinatura OpenCode Go ativa.
• Modelos OpenCode Zen incompatíveis com tools/function calling do Claude Code podem ser ocultados da lista, como deepseek-v4-flash-free.
• Visualização segura do settings.json, com tokens e API keys mascarados.
• API key fica oculta apos carregar modelos no cadastro do provider.
• Escrita com arquivo temporário e backup .bak para reduzir risco de corrupção.
• Janela configurada com renderer software por padrão e tamanho mínimo para reduzir falhas ao mover entre monitores/DPI.

Como instalar

Windows (disponivel)

O instalador fica na pagina de Releases do GitHub:

https://github.com/danubiolagoa/switch-provider/releases

Na release mais recente, abra a area Assets e baixe o instalador Windows. Link direto:

https://github.com/danubiolagoa/switch-provider/releases/download/v1.0.3/switch-provider_1.0.3_x64-setup.exe

Depois, execute o .exe com duplo clique e abra o Switch Provider pelo Menu Iniciar.

Link direto para a ultima release:

https://github.com/danubiolagoa/switch-provider/releases/latest

Via PowerShell:

irm https://raw.githubusercontent.com/danubiolagoa/switch-provider/main/install/install.ps1 | iex

Linux e macOS

Linux e macOS ainda estao em validacao. Ha issues separadas para gerar e testar .deb/.AppImage no Linux e .app/.dmg no macOS antes de publicar esses downloads como oficiais.

Winget tambem fica para uma etapa posterior.

Como rodar em desenvolvimento

cd switch-provider
cargo run

Build de release:

cd switch-provider
cargo build --release

Executável gerado:

switch-provider/target/release/switch-provider.exe

Gerar instalador Windows local:

cd switch-provider
npx --yes @crabnebula/packager --config Packager.toml --formats nsis

O instalador NSIS sera gerado em dist/. Consulte .docs/instalador-windows.md para o checklist de QA.

Configuração

Os arquivos ficam em ~/.claude:

~/.claude/
├── settings.json
├── settings-minimax.json
├── settings-openrouter.json
└── settings-outro-provider.json

Ao ativar um provider, o app lê o backup correspondente e grava seu conteúdo em settings.json.

Segurança

Não commite settings.json, settings-*.json, chaves de API, binários gerados ou arquivos dentro de target/. O .gitignore já cobre esses casos.

Os instaladores não incluem suas chaves locais nem arquivos settings*.json; cada usuário cadastra os próprios providers após instalar.

Desenvolvimento

cd switch-provider
cargo test
cargo build --release

Antes de publicar alterações, valide pelo menos:

• alternar MiniMax -> OpenRouter -> MiniMax;
• trocar o modelo OpenRouter/OpenCode Zen e confirmar que settings.json e settings-NOME.json foram atualizados;
• confirmar OpenCode Zen funcionando no Claude Code com modelo aceito pelo gateway;
• confirmar que Mudar modelo recarrega o catalogo atual e nao mostra modelos bloqueados como deepseek-v4-flash-free;
• abrir "Ver configs" e confirmar que a chave está mascarada;
• mover a janela entre dois monitores e confirmar que ela nao minimiza/some;
• adicionar provider e confirmar que NVIDIA não aparece na lista.