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

# Solução de problemas de acesso

> Respostas rápidas para os bloqueios mais comuns de acesso.

Os poucos pontos que travam FDEs novos durante o [Acesso](/pt-BR/fde-start-here/access/overview). Para o resto, veja a página geral de Solução de problemas.

<AccordionGroup>
  <Accordion title="Meu código de convite diz que já foi usado" icon="ticket">
    Convites são de uso único — o primeiro `khal fde enroll` bem-sucedido o consome. Se tem certeza de que é sua primeira tentativa, talvez já esteja cadastrado(a): rode `khal fde status`. Caso contrário, peça um novo ao admin — não dá para "desusar" um convite.
  </Accordion>

  <Accordion title="O `khal fde ssh` diz que ainda não fui aprovado(a)" icon="lock">
    Esperado, não é erro. O lease de SSH fica bloqueado pelo Deploy Ledger até um lead aprovar — a workstation *existir* e estar *acessível* são passos diferentes. Avise quem está te onboardando ([guia do admin](/pt-BR/fde-start-here/access/admin-guide)). Enquanto espera, `khal fde status` e `khal fde ssh --dry-run` funcionam e não alteram nada.
  </Accordion>

  <Accordion title="Qual --target eu uso?" icon="bullseye">
    Um rótulo de ambiente, não uma URL — `dev`, `hml` ou `prod`. FDEs novos usam `--target dev`. `hml`/`prod` pertencem a engajamentos específicos de cliente e vêm do seu lead. Veja a escada de ambientes.
  </Accordion>

  <Accordion title="Gerar um convite falha ou diz acesso negado" icon="ban">
    `khal fde invite create` é só para superadmin e só aceita endereços `@namastex.ai`. Não é superadmin? Peça a um. Email fora do `@namastex.ai`? Também é um não definitivo — sem contorno.
  </Accordion>

  <Accordion title="Não sei em que ponto do processo eu estou" icon="map">
    ```bash theme={null}
    khal fde status
    ```

    Rode a qualquer momento, do convite até a conexão — mostra seu estado atual e nunca altera nada.
  </Accordion>
</AccordionGroup>

<Accordion title="🤖 Prompt para colar no seu agente">
  ```text theme={null}
  TASK: Use `fde-start-here/access/troubleshooting.mdx` para desbloquear um FDE ou admin travado no meio do Acesso, verificando com a saída atual dos comandos antes de assumir uma correção.
  CONTEXT: Leia esta página e o guia específico para onde ela aponta (admin ou engenheiro) antes de recomendar uma correção.
  SAFE FIRST COMMANDS: `khal fde status`, `khal fde ssh --dry-run`, `khal --version` (nenhum altera estado).
  EVIDENCE: comando, exit status, saída sanitizada (redija códigos de convite e hostnames), o que prova, próxima ação segura. Nunca rode de novo um comando que altera estado (enroll, instance, invite create) de forma especulativa.
  ```
</Accordion>