Configuração do MandAPI Connect

Resposta rápida

Se você já tem uma conta MandAPI, use o login com a conta. O Connect cria e sincroniza as chaves usadas por Claude Code e Codex CLI, e o consumo continua vinculado aos créditos da sua conta. O caminho manual existe para quem precisa informar uma API Key e uma Base URL específicas.

Os dois caminhos são válidos. A diferença está em quem controla a chave e o endpoint, não em uma suposta compatibilidade “melhor” ou “pior”.

Antes de começar

Você precisa de:

• Windows 10 ou 11;
• a versão atual do MandAPI Connect;
• uma conta MandAPI ou uma API Key ativa;
• acesso ao painel para conferir chave, créditos e consumo;
• uma ferramenta de destino instalada, como Claude Code, Codex CLI ou terminal.

Baixe o aplicativo em MandAPI Connect. A chave completa aparece uma única vez quando é criada; guarde-a em um gerenciador de segredos ou em variável de ambiente. Nunca coloque uma chave real em screenshot, issue, repositório ou mensagem de suporte.

Caminho recomendado: login com a conta MandAPI

Este é o caminho mais simples para quem já usa a MandAPI.

1. Abra o Connect e escolha Configurar com MandAPI.
2. Entre com a conta ou crie uma em app.mandapi.com/register.
3. Deixe o Connect criar e sincronizar as chaves para Claude Code e Codex CLI.
4. Confirme se cada ferramenta aparece como configurada.
5. Faça uma chamada pequena antes de usar em produção.

O consumo sai dos créditos da conta. O Connect não cria uma conta separada e não exige copiar manualmente a chave para cada ferramenta.

Caminho manual: API Key e Base URL próprias

Use este caminho quando precisar controlar a credencial ou apontar para um endpoint específico.

1. Abra o Connect e escolha Configuração manual.
2. Preencha a API Key da ferramenta.
3. Confirme a Base URL exibida.
4. Salve e faça o teste de conexão da ferramenta.

Os endpoints padrão mostrados pelo Connect são:

A chave usada no caminho manual é a mesma criada no painel da conta em app.mandapi.com/console/token. O consumo é vinculado à chave escolhida.

Como validar a configuração

Não confie apenas na mensagem “salvo”. Faça uma verificação curta:

1. Abra a ferramenta configurada.
2. Execute uma chamada pequena, de baixo custo.
3. Confirme que não houve 401, 403 ou 404.
4. Verifique se o consumo apareceu no painel da conta.
5. Registre data, ferramenta e modelo usado.

Se a ferramenta falhar, compare primeiro a Base URL e o método de autenticação. Não troque a chave, o endpoint e o modelo ao mesmo tempo: isso torna o diagnóstico ambíguo.

Como trocar ou restaurar depois

As configurações ficam no próprio Connect. Se você trocar de conta, de chave ou de endpoint, volte à tela de configuração e valide novamente com uma chamada pequena. Evite editar manualmente os arquivos internos do aplicativo sem entender qual ferramenta consome aquela configuração.

Segurança

• Prefira o caminho recomendado quando não houver necessidade de usar uma chave específica.
• Não compartilhe a chave completa em prints ou tickets.
• Revogue imediatamente uma chave exposta e gere outra.
• Use uma chave por projeto ou ambiente quando isso ajudar a limitar impacto.
• Não coloque segredos em arquivos versionados.
• Confirme o consumo no painel depois da primeira chamada.

Problemas comuns

Próximos passos

• Instale a versão atual em MandAPI Connect.
• Veja o fluxo completo em Primeiros passos no MandAPI Connect.
• Crie e proteja a chave em Chaves de API.
• Faça a primeira chamada em Início rápido.

Fontes

• MandAPI — Download do Connect: https://mandapi.com/connect/download
• MandAPI — Início rápido: https://mandapi.com/docs/quickstart
• MandAPI — Chaves de API: https://mandapi.com/docs/api-keys
• Claude Code — Connect to an LLM gateway: https://code.claude.com/docs/en/llm-gateway-connect

Última verificação editorial: 20 de setembro de 2026. A interface pode evoluir; confirme os rótulos atuais no aplicativo e no painel.