Takeover com Um Clique para Ferramentas de Programação de IA

O takeover com um clique permite que você direcione suas ferramentas CLI de programação de IA mais usadas para o gateway de IA local sem precisar editar manualmente nenhum arquivo de configuração. Após o takeover, as requisições dessas ferramentas passam a ser roteadas unificadamente por http://127.0.0.1:11580 até os canais de fornecedores configurados no gateway, incluindo controle centralizado de uso e custos.

Como Funciona

Ao executar o takeover para cada ferramenta, o gateway realiza as seguintes etapas:

1. Verifica o status do gateway, garantindo que o endpoint proxy está disponível.
2. Cria automaticamente uma chave virtual exclusiva (o valor em texto simples é exibido apenas na criação e adicionado à configuração da ferramenta).
3. Faz backup do arquivo de configuração original com o sufixo .bak (por exemplo, ~/.claude/settings.json.bak).
4. Escreve/mescla precisamente a configuração para apontar para o gateway, preservando os demais ajustes feitos por você.
5. Atualiza o status da interface, exibindo a situação real do takeover.

A remoção do takeover também é precisa: a configuração só é retirada se realmente apontar para o gateway, evitando excluir outras definições personalizadas.

Status do Takeover

Cada ferramenta, na página Gateway de IA → Endpoints, exibe um dos quatro status possíveis:

Status	Significado
Sob controle (gateway local)	A ferramenta aponta para o gateway de IA local
Conectada (outro endereço)	A ferramenta está configurada para outro endereço (por configuração manual ou outro gateway); não será sobrescrita automaticamente
Não controlada	A ferramenta foi detectada, mas ainda não está apontando para o gateway
Não detectada	O diretório de configuração não foi encontrado no seu computador

Pré-requisitos

• Conta ServBay conectada e pelo menos um canal disponível configurado na página Canais.
• A ferramenta de IA desejada está instalada localmente (a detecção é baseada no diretório de configuração).

Como funciona o Takeover com Um Clique

Acesse Gateway de IA → Endpoints, localize a ferramenta desejada na lista e clique em Takeover com um Clique. Após o sucesso, o status mudará para “Sob controle (gateway local)”. Para desfazer, clique em Remover / Restaurar.

Detalhes do Takeover por Ferramenta

A tabela abaixo mostra quais arquivos e conteúdos são realmente modificados em cada ferramenta ao fazer o takeover, facilitando diagnósticos e entendimento:

Ferramenta	Arquivo de Configuração	Novo Conteúdo	Endereço do Gateway
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (sem /v1)
Codex	~/.codex/config.toml	Seção [model_providers.servbay] + topo model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Duas linhas: GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (compatível OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Seção [model_providers.servbay] + definição de modelo	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Mescla profunda do nó de modelo servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Mescla profunda do nó provider.servbay (agrega modelos dos canais)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Mescla profunda do nó providers.servbay	http://127.0.0.1:11580/v1

Por que o endereço do Claude Code não tem /v1

Claude Code utiliza o protocolo Anthropic e o gateway adiciona /v1/messages automaticamente. Por isso, ANTHROPIC_BASE_URL deve ser apenas a raiz do gateway (sem /v1). A maioria das outras ferramentas utiliza protocolo compatível OpenAI e exige /v1 no final. O takeover com um clique preenche tudo automaticamente, você não precisa se preocupar.

Restauração e Diagnóstico

• Restaurar configuração original — Clique em Remover para retirar apenas as configurações do gateway local, ou faça o restore manualmente usando o arquivo .bak salvo.
• Status “Conectada (outro endereço)” — A ferramenta está configurada para outro gateway ou endereço. O ServBay não sobrescreve nesse caso. Exclua manualmente esta configuração antes de tentar o takeover.
• Ferramenta apresenta erro após takeover — Verifique se o serviço proxy está em execução, o canal está saudável, a chave virtual não foi revogada e confira em Estatísticas e Monitoramento se a requisição chega ao gateway.

Perguntas Frequentes (FAQ)

• Pergunta: O takeover com um clique altera minhas outras configurações dos tools?
  • Resposta: Não. O gateway só escreve ou mescla as chaves relacionadas a ele. O arquivo original é sempre salvo como .bak antes. As configurações restantes permanecem inalteradas.
• Pergunta: Consigo desfazer o takeover manualmente?
  • Resposta: Sim. Você pode clicar em "Remover" ou restaurar manualmente com o arquivo .bak.
• Pergunta: Onde encontro a chave virtual usada pelo takeover?
  • Resposta: O gateway cria automaticamente uma chave virtual exclusiva para cada ferramenta sob takeover. Gerencie em Chaves.
• Pergunta: A ferramenta aparece como “Não detectada” na lista?
  • Resposta: O diretório de configuração não foi localizado. Instale e execute a ferramenta pelo menos uma vez antes de tentar takeover.

Resumo

O takeover com um clique converte o processo manual, complexo e suscetível a erros de editar configurações de várias ferramentas em apenas um clique: chave criada automaticamente, backup garantido, escrita precisa, restauração simples. Com canais e relatórios de uso centralizados, todas as suas ferramentas de IA podem compartilhar as mesmas configurações e visão de custos. Para integração em seu próprio código, veja Endpoints e variáveis de ambiente.