Solução de problemas

O aplicativo não será instalado ou aberto

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.

Se o aplicativo for instalado, mas não for iniciado, tente instalar a partir da Microsoft Store em vez do instalador direto – a compilação da Store lida com suas próprias dependências.

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.

Certifique-se de arrastar 9xchat para Applications 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.

Móvel

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

Trabalhe com eles em ordem:

1. Verifique sua conexão. Os modelos em nuvem precisam de acesso à Internet. Os modelos locais fazem não - se as solicitações de nuvem falharem, mas as locais funcionarem, o problema é a rede ou o provedor, não 9xchat.

2. Verifique seu saldo de crédito. Se você estiver usando créditos 9xchat e eles tiverem acaba, os pedidos 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álido 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 fornecedor 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 provedor. Em Biblioteca → Modelos, um provedor permanece marcado como Inativo até você adicionar sua chave — esse rótulo é a maneira mais rápida de ver para onde você não tem rota.

• Modelos locais precisam que seu executor local seja iniciado antes que 9xchat possa alcançá-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 — um 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 os modelos precisam de um nível 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 se conectará

1. Inicie seu executor local e confirme se ele responde fora de 9xchat.
2. Confirme se ele está escutando no endereço e na porta que 9xchat espera.
3. Confirme se o modelo em si está puxado e carregado, e não apenas o corredor 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. As ferramentas Agentic e a pesquisa ao vivo na web precisam do Pro — consulte Créditos, Pro e uso.

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 visualização da configuração mostra o comando exato que ela executa, que vale a pena reler se o servidor nunca iniciar.

5. Isole-o. Desative a ferramenta, faça a mesma pergunta e veja se o mudanças de comportamento. Isso informa 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 será 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 marca as que controlam 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 em um arquivo formato comum primeiro.

A geração da imagem falha

• A geração de imagens precisa do Pro.
• Confirme que você selecionou um modelo de imagem — ele é escolhido separadamente do seu modelo de bate-papo.
• Verifique seu saldo de crédito se você estiver gerando créditos por meio de 9xchat.
• Alguns prompts são recusados pelo provedor e não pelo 9xchat; reformulação é 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çãoestá definido emConfigurações → Padrão Modelos.
• Conceda permissão de microfone 9xchat na privacidade do seu sistema operacional configurações — no macOS, Configurações do sistema → Privacidade e segurança → Microfone.
• Ambos precisam de conexão mesmo quando seu modelo de chat é local.

A entrada de microfone precisa do Pro; ler em voz alta não.

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 em execução. 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 Context Shield 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

Vários recursos precisam do Pro: múltiplas guias, janela flutuante, mini chat, assistente rápido, ferramentas de agente, pesquisa ao vivo na web, playground de imagens, entrada de microfone e sistema de memória. Créditos, Pro e uso lista a divisão completa.

Se você já pagou, confirme se este dispositivo está conectado com o UID que contém a assinatura e se você não excedeu o limite de dispositivos – um dispositivo no gratuito, três no Pro. Siga UID em três dispositivos para conectar, trocar ou remover um dispositivo.

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 pega o Pro mesmo que o conteúdo não viaje.

Nada aqui ajudou

Entre em contato por meio de support com:

• seu sistema operacional e a versão 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.