> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consumo e solução de problemas

> Consulte o consumo e resolva problemas de acesso, projetos, conectores, ambientes remotos, tarefas e Git.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

## Consulte o consumo

Em **Ajustes → Consumo**, você pode consultar a atividade do gateway em um mapa de calor de 30 dias, totais diários de tokens e solicitações e detalhamento por modelo.

A correção do checkout pode gerar várias solicitações ao modelo: uma para decidir o que investigar e outras para analisar arquivos e resultados dos testes. Cada chamada contribui para os totais de solicitações e tokens. Uma tarefa não corresponde necessariamente a uma única solicitação; consulte a linha do tempo para ver as ações do agente.

Passe o cursor sobre um dia para examinar a atividade e use **Atualizar** para obter dados recentes. Cartões de custo ou orçamento aparecem apenas quando o serviço fornece esses dados à conta. Um cartão ausente não significa saldo zero nem atividade gratuita.

## Encontre onde a tarefa parou

Comece pela última ação sem sucesso na linha do tempo. Erro de gateway, falha de comando e aprovação pendente exigem respostas diferentes:

| Sintoma | Primeira verificação |
| - | - |
| Sem resposta ou modelos | Conta, URL do gateway e **Testar conexão**. |
| Ferramenta aguardando | Aprovação ou pergunta pendente. |
| Comando falhou | Saída completa, pasta e ferramentas instaladas. |
| Erro de conector | Autorização, **Testar** e acesso ao recurso. |
| Resposta completa com resultado inesperado | Diff, testes ou estado real do navegador. |

Depois de corrigir a causa, peça para repetir a verificação específica: “As dependências foram instaladas. Execute npm test de novo e informe o resultado.” Assim você obtém uma nova verificação sem presumir sucesso da tentativa anterior.

<Frame caption="Testar conexão confirma o acesso e mostra os modelos disponíveis. Este exemplo usa um gateway local de demonstração.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/troubleshooting.jpg" alt="Teste de conexão bem-sucedido com um modelo disponível" width={2720} height={1660} x={1030} y={30} cropWidth={1080} cropHeight={520} maxWidth="100%" />
</Frame>

## Solução de problemas

Confira a mensagem de erro no aplicativo ou no resultado da ferramenta e procure o sintoma correspondente abaixo.

Com a CLI instalada, `mka1-code doctor` verifica o ambiente de execução do agente, a conta, o catálogo de modelos do gateway, os conectores e a configuração do terminal. Leia os resultados individuais, incluindo avisos, para localizar o problema. Para um conector, execute também **Testar** em **Extensões**; isso verifica a conexão e a descoberta das ferramentas do servidor.

<AccordionGroup>
  <Accordion title="O login não é concluído">
    Se o navegador não abriu, reabra a página de autorização pelo aplicativo. Se o código expirou, escolha **Solicitar novo código** e autorize novamente. Uma sessão de conta expirada exige um novo login. Em caso de erro de conexão, confira a URL do servidor e sua conexão de rede antes de tentar novamente.
  </Accordion>

  <Accordion title="Um comando do projeto não encontra uma ferramenta ou dependência">
    Confira a saída do comando e a pasta selecionada para a sessão. As ferramentas de compilação e teste e as dependências devem estar instaladas no ambiente que executa a tarefa. Em SSH, WSL ou Docker, confira esse ambiente. Um novo worktree pode exigir a configuração habitual do projeto antes de executar testes.
  </Accordion>

  <Accordion title="Um conector está indisponível ou suas ferramentas não aparecem">
    Em **Ajustes → Extensões**, confira se o conector está ativado, conclua o login ou a configuração solicitada e escolha **Testar**. Examine o erro ou a lista de ferramentas descobertas. Mudanças de configuração passam a valer na próxima execução do agente; a execução ativa termina com a configuração anterior.
  </Accordion>

  <Accordion title="O ambiente remoto não conecta">
    Confirme que o destino e a pasta do projeto existem. Para SSH, estabeleça primeiro uma conexão pelo terminal e garanta que a autenticação não exige uma solicitação interativa. Para Docker, confira se o contêiner está em execução e acessível pelo contexto do Docker. Examine o erro no diálogo para identificar ferramentas ausentes ou ambientes sem suporte.
  </Accordion>

  <Accordion title="Uma tarefa agendada não foi executada">
    Confira se o agendamento está ativado, se o aplicativo permaneceu aberto e se o computador estava acordado. Consulte o histórico: execuções simultâneas no mesmo agendamento ou projeto podem causar uma ocorrência ignorada, e o modo de permissão salvo pode exigir sua atenção. Ocorrências perdidas não são repetidas automaticamente.
  </Accordion>

  <Accordion title="Um commit ou envio falhou">
    Resolva o erro do Git exibido no diálogo. Se arquivos ou a área de preparação mudaram durante a revisão, escolha **Atualizar alterações** e selecione os arquivos novamente. Resolva conflitos de merge e conclua operações do Git em andamento antes do commit. Se apenas o envio falhou, use **Tentar push novamente** para enviar o commit local existente.
  </Accordion>

  <Accordion title="O seletor de modelos está vazio">
    Em **Ajustes → Conexão**, teste a credencial e confira a URL. Salve as alterações e atualize o catálogo. Se a autenticação funcionar, mas não houver modelos, pergunte ao administrador quais estão habilitados para a conta. Informe um ID manual apenas quando fornecido pela equipe responsável.
  </Accordion>

  <Accordion title="Uma preferência do projeto não está sendo usada">
    Em **Ajustes → Projetos**, confira conta, pasta e estado da memória. Cada worktree tem suas preferências; uma chave de API sozinha não habilita memória. Se uma mudança interrompeu o turno, reenvie a solicitação. Consulte [Memória do projeto](/pt/docs/mka1-code/memory).
  </Accordion>

  <Accordion title="A prévia de um documento não abre">
    Confira se o arquivo existe na pasta local e usa um formato aceito. Tente novamente ou atualize a prévia após regenerá-lo. Sessões remotas e na nuvem não oferecem prévia. Abra arquivos protegidos ou incompatíveis no aplicativo original.
  </Accordion>
</AccordionGroup>

## Relate um problema reproduzível

Inclua a versão de **Ajustes → Sobre**, sistema operacional, ambiente local ou remoto e etapas até a falha. Copie o erro relevante e descreva o resultado esperado. Para a CLI, inclua a verificação que falhou em `mka1-code doctor`.

Um relato útil delimita uma falha: “Em uma sessão local, Testar conexão retorna este erro após o login e o seletor continua vazio.” Remova chaves de API, códigos de autorização, dados pessoais e conteúdo não relacionado antes de compartilhar capturas ou logs.