Solução de problemas

O aplicativo não instala ou não abre

Windows

Se o SmartScreen bloquear o instalador, escolha Mais informações → Executar mesmo assim. A versão da área de trabalho é assinada por código, portanto isso normalmente não aparece.

macOS

Se o macOS se recusar a abrir o aplicativo, abra Configurações do sistema → Privacidade e segurança, permita-o e inicie-o novamente.

Verifique se arrastou o 9xChat para Aplicativos, em vez de executá-lo a partir da imagem de disco montada.

Linux

Verifique se o arquivo baixado está marcado como executável. Caso contrário, defina o bit executável e execute-o novamente.

Celular

Instale através do Google Play ou da App Store para que as atualizações cheguem automaticamente. Se o aplicativo não iniciar, atualize-o e reinicie o dispositivo.

As respostas falham ou param no meio do caminho

Siga estes passos em ordem:

1. Verifique sua conexão. Os modelos em nuvem precisam de acesso à Internet. Os modelos locais fazem isso sem Internet. Se as solicitações à nuvem falham, mas as locais funcionam, o problema está na rede ou no provedor, não no 9xChat.

2. Verifique seu saldo de créditos. Se você usa créditos do 9xChat e eles tiverem acabado, as solicitações param. Recarregue ou mude para sua própria chave de API.

3. Verifique sua chave de API. Se você trouxe sua própria chave, confirme se ela ainda está válida e ainda tem cota com esse provedor.

4. Tente um modelo diferente. Se um modelo falhar e outro for bem-sucedido, o problema é com esse modelo ou provedor específico.

Um modelo está faltando ou não carrega

• Modelos de nuvem precisam de créditos ou de uma chave de API configurada para isso no provedor correspondente. Em Biblioteca → Modelos, um provedor fica marcado como Inativo até você adicionar a chave dele. Esse rótulo é a maneira mais rápida de identificar os provedores aos quais você ainda não tem acesso.

• Modelos locais precisam que o ambiente de execução local esteja iniciado para que o 9xChat consiga acessá-los. Inicie primeiro e depois reabra a lista de modelos.

Sua chave de API foi rejeitada

A falha está no provedor, então a solução também está lá:

1. Cole a chave novamente, sem espaços à esquerda ou à direita.
2. Confirme se a chave pertence ao provedor ao qual você a adicionou.
3. Verifique se a chave ainda existe e não foi revogada ou rotacionada.
4. Verifique se você tem o faturamento configurado e a cota restante com esse provedor: uma chave válida sem saldo falha da mesma forma que uma chave incorreta.
5. Confirme se o modelo que você escolheu é aquele que sua conta pode usar. Alguns modelos exigem um nível de acesso separado com o provedor.

As chaves são armazenadas criptografadas em sua máquina. Se uma chave parar de funcionar em qualquer lugar, substitua-a no provedor em vez de reinstalar o 9xChat.

Um modelo local não conecta

1. Inicie seu executor local e confirme se ele responde fora de 9xChat.
2. Confirme que ele está escutando no endereço e na porta esperados pelo 9xChat.
3. Confirme que o modelo em si foi baixado e carregado, e não apenas que o executor está em execução.
4. Reabra Biblioteca → Modelos para que a lista seja atualizada.

Os modelos locais não precisam de chave nem de créditos. Se um modelo local funciona e um modelo em nuvem não, o problema é sua chave, seu saldo ou a rede.

Uma ferramenta ou servidor MCP não está funcionando

1. Verifique se a ferramenta está habilitada. Cada ferramenta tem um botão Habilitado em Biblioteca → Ferramentas.

2. Verifique o plano. Ferramentas agênticas e pesquisa na web em tempo real precisam do Pro. Veja Free e Pro.

3. Leia a linha de segurança. Ela indica quais permissões a ferramenta precisa. Uma ferramenta que não consegue alcançar o que precisa, falha em vez de pedir.

4. Para servidores MCP, confirme se os segredos necessários foram fornecidos: uma entrada ainda marcado Precisa de configuração não foi configurado. A prévia da configuração mostra o comando exato que ele executa, que vale a pena reler se o servidor nunca iniciar.

5. Isole o problema. Desative a ferramenta, faça a mesma pergunta e veja se o comportamento muda. Isso mostra se a ferramenta está envolvida.

A pesquisa de conhecimento não encontra nada

Uma coleção deve ser indexada antes de poder ser pesquisada.

• Confirme se os arquivos foram adicionados a uma coleção e não apenas anexados a um bate-papo.
• Confirme se a ferramenta Pesquisar conhecimento está ativada.
• Se o seu provedor de embeddings estava inacessível quando você adicionou os arquivos, a pesquisa recorre à correspondência de palavras-chave e perderá qualquer coisa que precise do índice. Adicione novamente os arquivos assim que o provedor estiver acessível.

Consulte Conhecimento e Memórias.

Um anexo não é processado

• Confirme se o modelo selecionado aceita esse tipo de arquivo. Um modelo somente texto não consegue ler uma imagem, e a lista de modelos indica quais têm suporte a visão.
• Arquivos muito grandes podem exceder o contexto de um modelo. Experimente um extrato menor ou um modelo com uma janela de contexto maior.
• Se o arquivo abrir corretamente em outro lugar, mas falhar aqui, tente convertê-lo primeiro para um formato comum.

A geração da imagem falha

• Editar uma região de uma imagem, gerar novamente uma imagem gerada e usar imagens na conversa exigem o Pro. O espaço de criação de Imagens é gratuito.
• Confirme que selecionou um modelo de imagem. Ele é escolhido separadamente do seu modelo de bate-papo.
• Verifique seu saldo de créditos se você estiver gerando imagens com créditos do 9xChat.
• Alguns prompts são recusados pelo provedor, não pelo 9xChat; reformular é geralmente mais rápido do que tentar novamente.

O ditado ou a leitura em voz alta falham

Ambos precisam de um provedor de áudio funcional e nenhum deles tem opção local.

• Confirme se seu Provedor de transcrição está definido em Configurações → Modelos padrão.
• Dê ao 9xChat permissão para usar o microfone nas configurações de privacidade do sistema operacional. No macOS, Ajustes do Sistema → Privacidade e Segurança → Microfone.
• Ambos precisam de conexão mesmo quando seu modelo de chat é local.

Ditado e chat de voz precisam do Pro; a leitura em voz alta é gratuita.

Os créditos acabam mais rápido que o esperado

Cada mensagem mostra seu próprio custo, latência e detalhamento de token, e a sessão mostra um total acumulado. Se um total parecer errado, abra os números por mensagem para ver qual troca é responsável por ele: contexto longo, tokens de raciocínio e anexos grandes aumentam o custo de um único turno.

Você pode limitar isso por chat diminuindo os tokens máximos de conclusão e o limite de contexto nas configurações do modelo, e o Escudo de contexto reduz quanto histórico é reenviado com cada mensagem.

Para parar totalmente de gastar créditos, adicione sua própria chave de API ou use um modelo local.

Um recurso está esmaecido ou ausente

Recursos que precisam do Pro abrem um diálogo de Recurso Pro em uma conta gratuita, e as configurações Pro exibem o rótulo Premium: entre eles estão várias abas, a janela de conversa, o Assistente rápido, ferramentas agênticas, pesquisa na web em tempo real, edição de imagens, ditado e chat de voz. Free e Pro traz a divisão completa.

Se você já paga, confirme que este dispositivo entrou com o UID que possui a assinatura. Abra Perfil para conferir o plano e os dias restantes. Siga Seu UID e seus dispositivos para conectar, trocar ou remover um dispositivo.

"Créditos insuficientes para esta solicitação"

A solicitação custa mais do que o seu saldo restante. Escolha Comprar créditos ou mude a conversa para um modelo com sua própria chave de API ou um modelo local, que nunca usam créditos. Seu saldo está em Perfil.

"Limite de dispositivos atingido"

Todas as vagas de dispositivos do seu UID estão em uso: uma em uma conta gratuita ou durante o período de teste, três com o Pro. Escolha Gerenciar dispositivos e remova um dispositivo que você não usa mais (no iOS, use a página de licença em um navegador), depois entre novamente. Não crie um novo UID: ele não terá seu plano nem seus créditos. Veja Seu UID e seus dispositivos.

"Pagamento não detectado"

Após o pagamento no navegador, o 9xChat verifica sua conta quando você escolhe Confirmar pagamento. Se aparecer Pagamento não detectado, o pagamento pode ainda estar sendo processado: espere um minuto e escolha Tentar novamente. Se fechou a página de pagamento por engano, escolha Abrir página de pagamento. Compras no Google Play ou na App Store podem ser recuperadas com Restaurar compras na tela de preços.

Um código do Handoff não funciona

• Os códigos expiram após alguns minutos e funcionam uma vez. Cancele no dispositivo de envio e escolha Obter um código de pareamento novamente.
• Digite os 6 dígitos no dispositivo de destino em Receber conversa….
• Mantenha os dois diálogos abertos e os dois dispositivos online até a transferência terminar.

Veja Handoff.

Algo está faltando em outro dispositivo

Seu espaço de trabalho é armazenado localmente em cada dispositivo, portanto, uma segunda máquina conectada com o mesmo UID não herda seus bate-papos, notas ou memórias. Isso é esperado e não uma falha.

• As memórias são por dispositivo. Uma nova instalação começa sem nenhuma.
• Handoff emparelha dois dispositivos para uma conversa; não copia o resto do seu espaço de trabalho.
• Para mover o material você mesmo, use Configurações → Dados e exportações.

Sua assinatura segue o UID, portanto, um dispositivo que faz a verificação com ela recebe o Pro mesmo que o conteúdo não viaje.

Nada aqui ajudou

Marque Incluir diagnósticos ao entrar em contato. Isso anexa versões, números de armazenamento, contagens e categorias de erros recentes, nunca seus prompts, títulos, nomes de arquivos ou chaves. É a maneira mais rápida de evitar uma rodada de perguntas, e Privacidade lista exatamente o que é enviado.

Entre em contato por meio do suporte com:

• seu sistema operacional e a versão do 9xChat,
• o modelo e provedor que você estava usando,
• se você estava com créditos, com sua própria chave ou com um modelo local,
• o que você fez e o erro visível exato.