Facade CodeSoluçã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. Para erros de conexão pelo celular, veja Continue pelo celular.
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.