Sobre o projeto

O claude-desktop-gateway é um programa de proxy leve que permite ao Claude Desktop acessar modelos de IA de provedores que não sejam a Anthropic, como OpenAI, Gemini, DeepSeek e outros. Ele funciona traduzindo requisições da API da Anthropic para formatos compatíveis com a OpenAI e vice-versa, permitindo uma integração perfeita sem modificar o comportamento central do Claude Desktop. O gateway é configurado inteiramente através de um único arquivo YAML (models.yaml), onde os usuários definem os provedores e seus modelos associados. Cada provedor pode ser ativado ou desativado, e as chaves de API são carregadas de variáveis de ambiente, de um arquivo auth.json ou incorporadas diretamente na configuração (com avisos de segurança). Os modelos são mapeados com aliases começando com 'claude-' para evitar conflitos com os modelos oficiais da Anthropic. Ele suporta texto, entrada de imagem, chamadas de ferramentas (tool calls), modos de raciocínio e respostas em streaming. O gateway funciona como um serviço headless no Linux/WSL ou como um aplicativo de bandeja do sistema no Windows, escutando na porta 3458 por padrão. Os usuários devem ativar o Modo Desenvolvedor no Claude Desktop e configurá-lo para apontar para a URL do gateway local. Nenhuma dependência de tempo de execução é necessária além do Go para a compilação. O programa registra as requisições quando GATEWAY_LOG está definido, auxiliando na resolução de problemas. Reiniciar o gateway e o Claude Desktop é necessário após alterações na configuração para atualizar as listagens de modelos. O gateway não valida a chave da Gateway API — qualquer valor (ex: 'x') é suficiente para a autenticação dentro do Claude Desktop.