O que cc-switch-web faz?
Plataforma de Gestão Tudo-em-Um para CLIs de IA (Claude Code, Codex e Gemini) - Alternância de provedores, servidores MCP, Skills e gerenciamento de prompts. Agora com interface web para ambientes headless/SSH.
Visão Geral
O cc-switch-web unifica o gerenciamento de múltiplos provedores de IA em um único ponto de controle, permitindo que você alterne entre Claude Code, Codex e Gemini, gerencie servidores MCP, importe e organize skills, e administre prompts de forma centralizada.
Funcionalidades
- Alternância de Provedores: Troque entre Claude Code, Codex e Gemini com um único comando.
- Gerenciamento de Servidores MCP: Adicione, remova e configure servidores MCP dinamicamente.
- Gerenciamento de Skills: Importe, organize e ative/desative skills de IA.
- Gerenciamento de Prompts: Crie, edite e organize prompts reutilizáveis.
- Interface Web: Acesse e gerencie tudo via navegador, ideal para ambientes headless/SSH.
Instalação
# Clone o repositório
git clone https://github.com/cp-yu/cc-switch-web.git
cd cc-switch-web
# Instale as dependências
npm install
# Execute a aplicação
npm start
Comandos
cc-switch [provedor]- Alterna para o provedor especificado (claude, codex, gemini).mcp- Gerencia servidores MCP.skill- Gerencia skills.prompt- Gerencia prompts.
Uso
Alternar provedor
cc-switch claude
Gerenciar servidores MCP
mcp add <url>
mcp remove <id>
mcp list
Gerenciar skills
skill import <caminho>
skill list
skill enable <id>
skill disable <id>
Interface web
A interface web está disponível em http://localhost:3000 por padrão. Configure a porta com a variável de ambiente PORT.
Configuração
Variáveis de ambiente:
| Variável | Descrição | Padrão |
|---|---|---|
PORT | Porta do servidor web | 3000 |
DATA_DIR | Diretório para armazenar dados | ./data |
CLAUDE_CONFIG | Caminho do arquivo de configuração do Claude Code | ~/.claude/config.json |
CODEX_CONFIG | Caminho do arquivo de configuração do Codex | ~/.codex/config.json |
GEMINI_CONFIG | Caminho do arquivo de configuração do Gemini | ~/.gemini/config.json |
Estrutura do Projeto
cc-switch-web/
├── src/
│ ├── index.js # Ponto de entrada
│ ├── cli.js # Interface de linha de comando
│ ├── web.js # Servidor web
│ ├── providers/ # Módulos de provedores
│ ├── mcp/ # Gerenciamento de servidores MCP
│ ├── skills/ # Gerenciamento de skills
│ └── prompts/ # Gerenciamento de prompts
├── data/ # Dados persistidos
├── package.json
└── README.md
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.
Licença
MIT