Takeover com um clique para ferramentas de programação com IA

O takeover com um clique permite que você aponte ferramentas CLI de programação com IA para o gateway de IA local sem editar manualmente nenhum arquivo de configuração. Após o takeover, as requisições dessas ferramentas são roteadas por meio de http://127.0.0.1:11580 para os canais de provedores configurados no gateway e passam a fazer parte das estatísticas unificadas de uso e custo.

Como funciona

Ao executar o takeover com um clique para cada ferramenta, o gateway realiza, em sequência:

1. Verifica a saúde do gateway e confirma que o endpoint de proxy está disponível.
2. Cria automaticamente uma chave virtual exclusiva (o gateway grava a chave na configuração da ferramenta; o texto em claro pode ser recuperado a qualquer momento na página de chaves).
3. Faz backup do arquivo de configuração original com o sufixo .bak (por exemplo, ~/.claude/settings.json.bak).
4. Grava com precisão / faz mesclagem profunda da configuração que aponta para o gateway, preservando suas outras configurações sem alterá-las.
5. Atualiza o status da interface para mostrar a situação atual do takeover.

Ao interromper o takeover, o processo também é de "remoção precisa": a chave correspondente só é removida quando a configuração realmente aponta para este gateway, evitando excluir acidentalmente outras configurações que você tenha definido manualmente; além disso, a chave virtual criada automaticamente durante o takeover é revogada.

Status do takeover

Cada ferramenta exibe um entre quatro status na página Gateway de IA → Gerenciamento de Integração → Clientes:

Status	Significado
Takeover ativo (este gateway)	A ferramenta aponta para o gateway de IA local
Conectado (outro endereço)	A ferramenta está configurada com outro endereço (definido manualmente por você ou apontando para outro gateway); o gateway não sobrescreve sem autorização
Takeover inativo	A ferramenta foi detectada, mas ainda não aponta para o gateway
Não detectado	O diretório de configuração da ferramenta não foi encontrado na máquina local

Pré-requisitos

• Ter feito login na conta ServBay e ter pelo menos um canal disponível configurado na página Canais.
• A ferramenta de IA de destino estar instalada na máquina local (o gateway determina sua existência com base no diretório de configuração dela).

Operação de takeover com um clique

Acesse a página Gateway de IA → Gerenciamento de Integração → Clientes, localize a ferramenta desejada na lista e clique em Takeover com um clique. Após o takeover bem-sucedido, o status muda para "Takeover ativo (este gateway)". Para reverter, clique em Interromper takeover.

Detalhes do takeover de cada ferramenta

A tabela abaixo lista os arquivos de configuração e o conteúdo realmente modificados quando cada ferramenta passa pelo takeover, para ajudar você a entender e solucionar problemas:

Ferramenta	Arquivo de configuração	Conteúdo gravado	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] + model_provider = "servbay" no nível superior	http://127.0.0.1:11580/v1
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (compatível com OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Seção [model_providers.servbay] + definição do modelo	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Mesclagem profunda do nó de modelo servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Mesclagem profunda do nó provider.servbay (agrega modelos de cada canal)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Mesclagem profunda do nó providers.servbay	http://127.0.0.1:11580/v1

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

O Claude Code usa o protocolo Anthropic, e o gateway monta por conta própria caminhos como /v1/messages; portanto, ANTHROPIC_BASE_URL deve ser o endereço raiz do gateway (sem /v1). A maioria das outras ferramentas usa o protocolo compatível com OpenAI, que exige o sufixo /v1. O takeover com um clique preenche automaticamente conforme a convenção de cada ferramenta, sem que você precise diferenciar manualmente.

Restauração e solução de problemas

• Restaurar a configuração original — Clique em Remover e o gateway removerá com precisão a configuração que aponta para ele. Você também pode restaurar manualmente usando o arquivo de backup .bak no mesmo diretório.
• O status mostra "Conectado (outro endereço)" — Isso indica que a ferramenta aponta atualmente para outro endereço (configurado manualmente por você ou apontando para outro gateway). Para evitar sobrescrever suas configurações, o gateway não faz o takeover automaticamente; você pode limpar manualmente essa configuração e depois fazer o takeover.
• A ferramenta ainda apresenta erros após o takeover — Confirme se o serviço de proxy do gateway está em execução, se o canal correspondente está saudável e se a chave virtual não foi revogada; além disso, na página Estatísticas e Monitoramento você pode verificar se as requisições estão chegando ao gateway.

Perguntas frequentes (FAQ)

• P: O takeover com um clique vai quebrar minhas configurações atuais das ferramentas?
  • R: Não. O gateway apenas grava / mescla com precisão as chaves relacionadas ao gateway e faz backup do arquivo original como .bak antes de gravar. As demais configurações permanecem inalteradas.
• P: Depois do takeover, ainda posso reverter manualmente?
  • R: Sim. Clique em "Remover" para que o gateway reverta, ou restaure manualmente usando o backup .bak.
• P: Onde está a chave virtual usada pelo takeover?
  • R: O gateway cria automaticamente uma chave virtual exclusiva para cada ferramenta com takeover ativo; você pode visualizá-la e gerenciá-la na página Chaves.
• P: A ferramenta aparece como "Não detectado" na lista?
  • R: Isso significa que o diretório de configuração da ferramenta não foi encontrado na máquina local. Instale e execute a ferramenta uma vez para que ela gere o diretório de configuração e, depois, faça o takeover.

Resumo

O takeover com um clique transforma a tarefa tediosa e propensa a erros de "editar manualmente os arquivos de configuração de cada ferramenta" em um único clique: criação automática de chave, backup automático, gravação precisa e restauração a qualquer momento. Com canais unificados e estatísticas de uso, você pode fazer com que todas as suas ferramentas de programação com IA compartilhem o mesmo conjunto de configurações de provedor e a mesma visão de custos. Se você quiser chamar o gateway no seu próprio código, consulte Endpoints e Variáveis de Ambiente.