Pular para o conteúdo principal
PromptQuorumFeito para humanos. Estruturado para IA.
Início/LLMs locais avançados
Overview & Reference

AIClient2API: Um Proxy Local para Todos os Protocolos de IA

·10 min de leituraPor Hans Kuepper · Fundador do PromptQuorum · Mecanismo de descoberta de IA de pesos abertos e código aberto

O AIClient2API é um proxy gratuito, open source e auto-hospedado que converte os protocolos de cliente do Gemini CLI, Codex, Grok, Kiro e Antigravity em uma única API local compatível com OpenAI. Desenvolvido por justlovemaki e distribuído sob a licença GPL-3.0, ele roda via Docker ou Node.js, expõe um endpoint no formato OpenAI além de um console web, e permite que qualquer cliente compatível com OpenAI converse com provedores que, de outra forma, não conseguiria acessar diretamente.

Principais conclusões

  • O AIClient2API (github.com/justlovemaki/AIClient2API) é um proxy de API gratuito, open source e auto-hospedado — não é um serviço hospedado
  • Desenvolvido por justlovemaki; existem vários forks quase idênticos em outras contas do GitHub, mas este repositório é confirmado como a versão original com mais estrelas
  • Licenciado sob GPL-3.0, segundo o próprio campo de licença do repositório
  • Converte os protocolos de cliente do Gemini CLI, Codex, Grok, Kiro e Antigravity em uma única API compatível com OpenAI, com conversão bidirecional entre os protocolos OpenAI/Claude/Gemini
  • Roda via Docker (recomendado) ou Node.js/npm; inclui um console web para configuração e monitoramento de saúde
  • Mais de 8.700 estrelas no GitHub e mais de 1.380 forks no momento desta análise, com lançamentos ativos (a v3.5.0 saiu em setembro de 2026)

📍 Em uma frase

O AIClient2API é um proxy gratuito, open source (GPL-3.0) e auto-hospedado, criado por justlovemaki com mais de 8.700 estrelas no GitHub, que converte os protocolos de cliente do Gemini CLI, Codex, Grok, Kiro e Antigravity em uma única API local compatível com OpenAI.

💬 Em termos simples

O AIClient2API é um pequeno servidor que você roda na sua própria máquina, ficando entre suas ferramentas de cliente de IA e os provedores de IA com os quais elas conversam. Em vez de aprender cinco protocolos de provedores diferentes, você aponta tudo para um único endereço local, e o AIClient2API traduz as requisições nos bastidores para o formato que cada provedor realmente espera.

📌Nota: Esta análise se baseia no próprio repositório do GitHub, README e histórico de lançamentos do projeto. Ela não afirma que a PromptQuorum realizou testes de carga ou auditoria de segurança práticos sobre o comportamento do proxy do AIClient2API.

Ler em:
🇺🇸en🇩🇪de🇫🇷fr🇯🇵ja🇨🇳zh🇪🇸es🇧🇷pt🇸🇦ar🇰🇷ko

O AIClient2API (github.com/justlovemaki/AIClient2API) é um proxy gratuito, open source e auto-hospedado que converte os protocolos de cliente do Gemini CLI, Codex, Grok, Kiro e Antigravity em uma única API compatível com OpenAI, com mais de 8.700 estrelas no GitHub. Esta análise complementa a entrada do AIClient2API no Diretório de Software LLM Local e mostra o que ele realmente faz, como rodá-lo e para quem ele é indicado.

O Que É o AIClient2API?

O AIClient2API é um proxy gratuito, open source e auto-hospedado que unifica os protocolos de cliente de vários provedores de IA e ferramentas de CLI sob uma única API local compatível com OpenAI. Ele é desenvolvido pelo usuário do GitHub justlovemaki e distribuído sob a licença GPL-3.0.

  • Tipo de produto: um servidor proxy/gateway auto-hospedado, não é um app de chat, plugin de IDE ou produto SaaS hospedado
  • Criador: justlovemaki (usuário do GitHub); o repositório em github.com/justlovemaki/AIClient2API é confirmado como a versão original com mais estrelas entre vários forks quase idênticos de outras contas
  • Licença: GPL-3.0, uma licença copyleft — distribuir versões modificadas geralmente exige liberar o código-fonte sob a mesma licença
  • Repositório criado em 20 de julho de 2025, segundo os metadados do GitHub
  • Escala: mais de 8.700 estrelas no GitHub, mais de 1.380 forks e cerca de 5 issues abertas no momento desta análise — um número de issues abertas pequeno em relação à quantidade de forks, o que sugere um projeto ativamente mantido

Qual É o Histórico de Versões do AIClient2API?

O AIClient2API lançou versões pontuais com frequência ao longo de 2026, e a versão mais recente marcada, v3.5.0, foi publicada em setembro de 2026.

  • v3.5.0 (setembro de 2026): a versão marcada mais recente no momento desta análise
  • v3.4.9.1 e v3.4.8 (setembro de 2026): versões de correção incrementais nos dias anteriores à v3.5.0
  • v3.0.0 (maio de 2026): as próprias notas de lançamento do projeto descrevem essa versão como uma integração de IA mais profunda, incluindo guias de habilidades automatizados e endpoints de ajuda remota via API
  • Abril de 2026: suporte completo à API de geração e edição de imagens da OpenAI, com conversão de protocolo, segundo o changelog do projeto
  • Março de 2026: suporte ao protocolo Grok adicionado, incluindo entrada multimodal e geração de imagem/vídeo, segundo o changelog do projeto

O Que o AIClient2API Realmente Faz?

O AIClient2API roda como um servidor local que aceita requisições de API no formato padrão OpenAI e as traduz para o protocolo que o provedor de destino realmente precisa, depois traduz a resposta de volta.

  • Conversão de protocolo: conversão bidirecional entre os formatos de API OpenAI, Claude e Gemini, usando o que o projeto descreve como padrões de design de estratégia e adaptador
  • Provedores/protocolos suportados: Gemini, Claude (acessível via protocolos de cliente do Kiro ou Antigravity), Grok (via cookie ou OAuth de CLI), Codex, Kimi, MiniMax, OpenAI, além de endpoints personalizados compatíveis com OpenAI, segundo a própria documentação do projeto
  • Gerenciamento de pool de contas: alterna entre várias contas por provedor, com failover automático e verificações de saúde
  • Integração OAuth: fluxos OAuth embutidos para Antigravity, Codex, Grok CLI e Kiro
  • Balanceamento de carga: seleção de provedor com cooldown em erros de limite de taxa HTTP 429 e cadeias de fallback entre provedores
  • Sidecar TLS: um componente proxy separado escrito em Go que o projeto descreve como simulando fingerprints TLS JA3 para contornar bloqueios do tipo Cloudflare ou 403 em alguns endpoints de provedores
  • Console web: uma interface baseada em navegador em localhost:3000 para configuração em tempo real, monitoramento de saúde e testes de API
  • Registro de logs: captura completa de requisições/respostas, que o projeto posiciona como útil para auditoria ou construção de datasets de treinamento

Como Configurar e Rodar?

O AIClient2API é configurado por meio de um arquivo de configuração JSON (ou pelo console web) que mapeia as requisições recebidas para uma ou mais contas de provedores no back-end, e depois roda como um processo de servidor local de longa duração.

  • Iniciar via Docker (recomendado): baixe a imagem, monte uma pasta configs local e exponha as portas do proxy
  • Iniciar via Node.js: clone o repositório, rode o script de instalação incluído e depois npm start
  • Configure as credenciais dos provedores e os pools de contas no diretório configs montado, ou pelo console web em http://localhost:3000
  • Aponte qualquer cliente compatível com OpenAI (um app de chat, uma CLI de codificação, um script próprio) para o endereço local do proxy em vez do endpoint de API do próprio provedor
  • Monitore a saúde das contas, os cooldowns de limite de taxa e os logs de requisições em tempo real pelo console web
bash
docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 \
  -v "your_path/configs:/app/configs" \
  justlikemaki/aiclient-2-api

Plataforma, Preços e Licenciamento

Plataforma

O que o AIClient2API declara:
Servidor auto-hospedado, multiplataforma (Mac, Windows, Linux) via Docker ou Node.js — sem versão em nuvem.

Custo

O que o AIClient2API declara:
Gratuito e open source. Pode haver custo na conta/chave de API conectada; o proxy em si não cobra nada.

Licenciamento

O que o AIClient2API declara:
GPL-3.0, uma licença copyleft, segundo o campo de licença do repositório.

Método de instalação

O que o AIClient2API declara:
Docker (recomendado, um comando docker run) ou Node.js via script incluído e npm start.

Verifique o método de instalação recomendado e a lista de portas atuais em github.com/justlovemaki/AIClient2API antes de rodar qualquer um dos comandos.

Quanto Custa o AIClient2API?

O AIClient2API em si é gratuito — não tem taxa de licença, assinatura ou cobrança baseada em uso. Seu custo real depende inteiramente de quais contas ou chaves de API de provedores você conectar a ele.

  • O software proxy: gratuito, open source sob GPL-3.0, sem plano pago
  • Custos de provedor: o que quer que a conta ou chave de API subjacente que você usa já custe (uma chave de API paga da OpenAI/Claude/Gemini, ou uma assinatura vinculada a uma ferramenta de CLI como Codex ou Kiro)
  • Custos de auto-hospedagem: apenas o seu próprio poder de processamento — como é um proxy Node.js leve, isso costuma ser insignificante mesmo em um VPS pequeno

AIClient2API vs. LiteLLM: Qual É a Diferença?

O AIClient2API e o LiteLLM permitem que você fale um único formato de API e alcance vários provedores, mas eles resolvem problemas diferentes: o LiteLLM foca em roteamento multi-provedor de nível de produção para APIs comerciais padrão, enquanto o AIClient2API foca em conectar ferramentas de IA baseadas em assinatura CLI e OAuth de navegador a um formato compatível com OpenAI.

Objetivo principal

AIClient2API:
Conectar ferramentas de IA baseadas em CLI/OAuth (Gemini CLI, Codex, Kiro, Antigravity) a uma única API
LiteLLM:
Unificar mais de 100 APIs de provedores padrão sob uma interface compatível com OpenAI

Licença

AIClient2API:
GPL-3.0 (copyleft)
LiteLLM:
MIT (permissiva)

Usuário típico

AIClient2API:
Desenvolvedores que querem reaproveitar assinaturas de ferramentas de CLI por meio de uma API padrão
LiteLLM:
Equipes que padronizam o tráfego de LLM em produção entre vários fornecedores

Recursos extras

AIClient2API:
Sidecar de fingerprint TLS, fluxos OAuth para ferramentas de CLI específicas
LiteLLM:
Orçamentos, rastreamento de gastos, chaves virtuais, integrações amplas com o ecossistema

Essas ferramentas resolvem problemas sobrepostos, mas distintos — algumas equipes usam as duas: LiteLLM para APIs de provedores padrão e AIClient2API especificamente para provedores baseados em assinatura CLI.

Comparar no diretório

Quem Deveria Usar o AIClient2API?

O AIClient2API é indicado para desenvolvedores que já têm acesso a vários provedores de IA por meio de diferentes ferramentas de cliente e querem um endpoint único, local e compatível com OpenAI para construir suas aplicações.

Use o AIClient2API se você

  • já usa várias ferramentas ou assinaturas de CLI de IA (Gemini CLI, Codex, Kiro, Antigravity, Grok) e quer acessá-las por uma única API padrão
  • quer um proxy auto-hospedado totalmente sob seu controle, em vez de rotear requisições por um gateway hospedado de terceiros
  • precisa de failover automático entre várias contas do mesmo provedor para evitar limites de taxa de uma única conta
  • quer registro completo de requisições/respostas para auditoria ou para construir seus próprios datasets de treinamento ou avaliação
  • se sente confortável para rodar e manter um pequeno servidor auto-hospedado via Docker ou Node.js

Procure outra opção se você

  • usa apenas uma chave de API de um único provedor padrão e não precisa de conversão de protocolo ou roteamento multi-provedor
  • quer um gateway totalmente gerenciado e hospedado, em vez de algo que você mesmo hospeda e mantém
  • não se sente confortável com a zona cinzenta dos termos de serviço ao rotear tráfego por protocolos de ferramentas de CLI ou OAuth de navegador em vez de APIs oficiais pagas
  • precisa de recursos empresariais como orçamentos por equipe, painéis de gastos ou SSO — esses recursos são mais maduros em gateways dedicados como o LiteLLM

Para Que o AIClient2API Não É Indicado

O AIClient2API não é uma boa opção se você precisa de um gateway totalmente gerenciado, controles de gastos empresariais, ou quer evitar a ambiguidade de termos de serviço da conexão via protocolos de CLI.

  • Não é um serviço gerenciado ou hospedado — você é responsável por rodar, atualizar e proteger sua própria instância
  • Não é construído principalmente em torno de APIs padrão e oficialmente licenciadas de provedores — várias de suas integrações passam por protocolos de ferramentas de CLI ou OAuth que não foram projetados para proxy de terceiros, o que pode entrar em conflito com os termos de serviço de determinado provedor
  • Não é focado em recursos de governança empresarial (orçamentos por equipe, painéis de gastos, SSO) como acontece em gateways de LLM dedicados
  • Não foi auditado de forma independente quanto à segurança, até onde esta análise pôde verificar — trate-o como qualquer proxy auto-hospedado que lida com credenciais de API, e revise a configuração do pool de contas e do registro de logs antes de expô-lo além da sua própria máquina
  • Não tem apoio de uma empresa ou rodada de investimento que esta análise conseguiu verificar — trate-o como um projeto mantido de forma independente e sustentado pela comunidade

Erros Comuns ao Avaliar o AIClient2API

A maior parte da confusão em torno do AIClient2API vem de confundi-lo com seus vários forks, ou de presumir que ele funciona como um gateway multi-provedor padrão.

Erro 1: Instalar um fork em vez do repositório original

Existem vários projetos quase idênticos, com a mesma descrição, em contas diferentes do GitHub. Esta análise confirma o github.com/justlovemaki/AIClient2API como o repositório original com mais estrelas — verifique se você está apontando para esse repositório, e não para um fork, antes de relatar problemas ou verificar atualizações.

Erro 2: Presumir que ele só faz proxy de APIs padrão e oficiais de provedores

Várias das integrações do AIClient2API passam por protocolos de ferramentas de CLI ou OAuth de navegador (Kiro, Antigravity, autenticação por cookie do Grok), em vez de acesso a API de terceiros oficialmente suportado. Verifique os termos de serviço de cada provedor antes de rotear tráfego de produção dessa forma.

Erro 3: Tratá-lo como um substituto direto para um gateway de LLM de produção

O AIClient2API atualmente não documenta os recursos de orçamento por equipe, rastreamento de gastos ou SSO encontrados em gateways de produção dedicados como o LiteLLM. Avalie-o especificamente para conexão de assinaturas via CLI, e não como uma camada geral de roteamento empresarial.

Erro 4: Pular as etapas de configuração do sidecar TLS e do OAuth

Algumas integrações de provedores do AIClient2API dependem do sidecar TLS separado, escrito em Go, ou da conclusão bem-sucedida de um fluxo OAuth. Se a conexão com um provedor específico falhar, verifique se aquele provedor exige o sidecar ou uma etapa de login OAuth, segundo a própria documentação do projeto.

Concorrentes e Alternativas

O AIClient2API é mais diretamente comparado ao LiteLLM; também vale a pena avaliá-lo em relação aos servidores compatíveis com OpenAI que ele pode ficar na frente, como o vLLM, o SGLang e o LocalAI, dependendo se você precisa de um proxy de conexão de protocolos ou do próprio servidor de inferência.

LiteLLM

Mais conhecida por:
Proxy sob MIT que unifica mais de 100 APIs de provedores padrão, com orçamentos e rastreamento de gastos
Link:
Análise do LiteLLM

vLLM

Mais conhecida por:
Servidor/motor de inferência local de alto desempenho, compatível com OpenAI
Link:
vLLM explicado
Artigos sobre vLLM (10)

+92 mais não exibidos

SGLang

Mais conhecida por:
Motor de inferência compatível com OpenAI com otimizações de geração estruturada
Link:
SGLang explicado
Artigos sobre SGLang (8)

Também mencionado em:

+6 mais não exibidos

LocalAI

Mais conhecida por:
Servidor de inferência local auto-hospedado e compatível com OpenAI para modelos de peso aberto
Link:
LocalAI explicado
Artigos sobre LocalAI (10)

+10 mais não exibidos

Esta lista reflete ferramentas comumente avaliadas junto com o AIClient2API, e não um ranking independente da PromptQuorum — verifique o conjunto de recursos atual de cada ferramenta antes de escolher.

Comparar no diretório

Perguntas Frequentes

O que é o AIClient2API?

O AIClient2API (github.com/justlovemaki/AIClient2API) é um proxy gratuito, open source (GPL-3.0) e auto-hospedado que converte os protocolos de cliente do Gemini CLI, Codex, Grok, Kiro e Antigravity em uma única API compatível com OpenAI.

O AIClient2API é gratuito?

Sim, o AIClient2API em si é gratuito e open source sob GPL-3.0. Você ainda pode pagar pela conta ou chave de API do provedor subjacente ao qual o conectar.

Como instalo o AIClient2API?

O próprio README do projeto recomenda o Docker: rode docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 -v "your_path/configs:/app/configs" justlikemaki/aiclient-2-api. Também há um script de instalação para Node.js disponível. Verifique as instruções atuais no repositório do GitHub primeiro.

Quais provedores de IA o AIClient2API suporta?

Segundo a própria documentação do projeto: Gemini, Claude (via Kiro ou Antigravity), Grok, Codex, Kimi, MiniMax, OpenAI, além de endpoints personalizados compatíveis com OpenAI.

Quem criou o AIClient2API?

O AIClient2API foi desenvolvido pelo usuário do GitHub justlovemaki. Existem vários forks quase idênticos em outras contas, mas este repositório é confirmado como a versão original com mais estrelas.

O AIClient2API é a mesma coisa que o LiteLLM?

Não. Ambos unificam vários provedores sob uma API compatível com OpenAI, mas o LiteLLM (licenciado sob MIT) foca em APIs comerciais padrão de provedores, com recursos de produção como orçamentos, enquanto o AIClient2API (GPL-3.0) foca em conectar ferramentas de CLI e assinaturas de IA baseadas em OAuth.

O AIClient2API exige GPU?

Não. O AIClient2API é um proxy leve de conversão de protocolo em Node.js, não um motor de inferência — ele não roda modelos por conta própria, então não tem exigência de GPU.

É seguro rotear tráfego pelas integrações de protocolo CLI do AIClient2API?

Várias de suas integrações passam por protocolos de ferramentas de CLI ou OAuth de navegador que não foram oficialmente projetados para proxy de terceiros, o que pode entrar em conflito com os termos de serviço de determinado provedor. Revise os termos de cada provedor antes de usá-lo para tráfego de produção.

O AIClient2API suporta múltiplas contas por provedor?

Sim, segundo a documentação do projeto ele suporta gerenciamento de pool de contas com alternância, failover automático e verificações de saúde entre várias contas de um mesmo provedor.

A PromptQuorum testou de forma independente as afirmações do AIClient2API?

Esta análise se baseia no próprio repositório do GitHub, README e histórico de lançamentos do projeto, e não em testes de carga ou auditoria de segurança práticos realizados pela PromptQuorum.

Fontes

← Voltar para LLMs locais avançados

MCP