# Solução de problemas

Descubra se um problema vem da configuração de inicialização, da CLI ou do provedor de modelos.

## Verifique a inicialização solicitada

Execute **Show Agent Launch** na Paleta de Comandos e escolha o local de trabalho. O relatório mostra como cada CLI iniciaria ali agora: executável, diretório, argumentos e nomes de variáveis de ambiente. Valores privados ficam ocultos.

O relatório descreve a próxima inicialização com suas configurações atuais. Ele não descreve um agente que já está rodando. Se uma solicitação funcionar, os registros de uso do provedor podem ajudar a confirmar qual conta a atendeu.

## Encontre o sintoma

| Problema | O que verificar |
| --- | --- |
| Você não encontra o arquivo de configurações | Escolha Open Settings e depois Edit in facade.json em Facade: Home. Se a janela remota abrir as configurações como JSON, o comando abre o facade.json diretamente. |
| Uma entrada não aparece em New Agent | Confira o nome e o `type` da entrada e verifique se ela não está desativada com `enabled: false`. Entradas inválidas aparecem em Unavailable com um motivo. |
| O executável não é encontrado | Instale a CLI onde o projeto roda ou defina o caminho completo em `command`. Para o OpenCode, use a versão 2 (`@opencode/cli`). |
| Uma referência de ambiente está ausente | O host do editor precisa ter essa variável antes de o agente iniciar. Exportá-la em um terminal já aberto não atualiza o host. |
| Um argumento conflita com uma opção controlada pelo Facade | Remova a opção de `args`. Use o campo `model` ou `effort` da entrada, ou o campo `yolo` no nível superior. |
| A autenticação falha ou um modelo está indisponível | Confira a chave do provedor, o endpoint, a região, o ID de modelo e o acesso da conta. |
| Um provedor do Codex não responde | Confirme que o endpoint dele oferece suporte à API Responses. |
| Um agente não encontra outro agente | Confira se os projetos estão conectados pela mesma home do Facade e se as configurações de acesso deles permitem a comunicação. |
| Um programa personalizado não recebe mensagens | Digite no terminal dele. Entradas personalizadas não recebem as mensagens nem as ferramentas do Facade. |
| Configurações salvas não mudaram um agente em execução | Inicie um agente novo. Para manter a conversa, encerre o agente e use Resume Agent para reiniciá-lo com as novas configurações. |

Para configuração de SSH, veja [Execute agentes em uma máquina remota](https://facadecode.com/pt-br/docs/remote-ssh/). Para erros de conexão pelo celular, veja [Continue pelo celular](https://facadecode.com/pt-br/docs/remote-control/).

## Relate um problema

Inclua o que você tentou, o erro exato, seu sistema operacional, as versões do editor e da extensão, a versão da CLI e a entrada selecionada. Se possível, inclua as configurações relevantes, com chaves e valores privados removidos.

[Abra uma issue no GitHub ↗](https://github.com/y5ez3g/facadecode/issues)