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

# Migre do Replit Auth para o Clerk

> Use o Agent para mover um app existente do Replit Auth para o Clerk Auth preservando os dados de usuário do seu app.

Use este guia para mover um app existente do [Replit Auth](/pt/features/auth-and-identity/authentication) para o [Clerk Auth](/pt/features/auth-and-identity/clerk-auth). O Agent cuida da migração para apps elegíveis, para que usuários que retornam mantenham acesso aos seus dados existentes.

<Note>
  Esta migração automatizada é para apps que usam o Replit Auth. Se o seu app usa um sistema de autenticação diferente, não use este fluxo.
</Note>

## Inicie a migração

As migrações do Agent devem sempre ser executadas em uma nova task.

Você pode iniciar a migração de uma das seguintes formas:

### Iniciar a partir do Agent

<Steps>
  <Step title="Crie uma nova task">
    Selecione **+** na barra lateral, ou pressione **Cmd+Shift+P** (Mac) ou **Ctrl+Shift+P** (Windows), para criar uma nova task.

    <Frame caption="Planeje uma nova task: descreva o que você quer e o Agent cria um plano para você.">
      <img src="https://mintcdn.com/replit/HAkP_ROSRoShmzzT/images/workspace/auth/replit-auth-to-clerk-new-task.png?fit=max&auto=format&n=HAkP_ROSRoShmzzT&q=85&s=37874894a973063219f18ff14a409501" alt="A visualização de nova task com o botão de criar nova task destacado na barra lateral, uma dica mostrando o atalho Cmd Shift P, e o estado vazio Plan a new task acima do compositor Message Agent" width="1750" height="1948" data-path="images/workspace/auth/replit-auth-to-clerk-new-task.png" />
    </Frame>
  </Step>

  <Step title="Use o Agent para migrar">
    Na nova task, peça ao Agent para migrar seu app do Replit Auth para o Clerk.
  </Step>
</Steps>

### Iniciar a partir do painel Auth

<Steps>
  <Step title="Abra Tools">
    No Editor de Projeto, abra **Tools**.

    <Frame caption="A aba Tools abre a lista de ferramentas ao lado da ferramenta ativa.">
      <img src="https://mintcdn.com/replit/HAkP_ROSRoShmzzT/images/workspace/auth/replit-auth-to-clerk-open-tools.png?fit=max&auto=format&n=HAkP_ROSRoShmzzT&q=85&s=08fa9a797fdaef123ad8097a04c48254" alt="A aba Tools do Editor de Projeto aberta, mostrando a lista de ferramentas com Publishing, Domains, Monitoring, Users & Auth e mais ao lado da visão geral do Publishing" width="1500" height="1018" data-path="images/workspace/auth/replit-auth-to-clerk-open-tools.png" />
    </Frame>
  </Step>

  <Step title="Selecione Users & Auth">
    <Frame caption="Users & Auth na lista de ferramentas.">
      <img src="https://mintcdn.com/replit/HAkP_ROSRoShmzzT/images/workspace/auth/replit-auth-to-clerk-users-auth.png?fit=max&auto=format&n=HAkP_ROSRoShmzzT&q=85&s=301ed2722dba42beb848e02a47148aa3" alt="A lista de ferramentas com Users & Auth destacado e uma dica de texto dizendo 'Let users log in to your App using a prebuilt login page'" width="1154" height="1018" data-path="images/workspace/auth/replit-auth-to-clerk-users-auth.png" />
    </Frame>
  </Step>

  <Step title="Selecione Update now">
    No banner **Introducing a new Replit Auth**, selecione **Update now**.

    <Frame caption="A ferramenta Users & Auth mostra o banner Introducing a new Replit Auth e sua ação Update now.">
      <img src="https://mintcdn.com/replit/HAkP_ROSRoShmzzT/images/workspace/auth/replit-auth-to-clerk-banner.png?fit=max&auto=format&n=HAkP_ROSRoShmzzT&q=85&s=c115f201dc69c4b014a7134145c27c4a" alt="Editor de Projeto com Users & Auth selecionado e o banner Introducing a new Replit Auth mostrando um botão Update now" width="1220" height="764" data-path="images/workspace/auth/replit-auth-to-clerk-banner.png" />
    </Frame>
  </Step>

  <Step title="Ask agent to migrate">
    Selecione **Ask agent to migrate** no diálogo.

    <Frame caption="O diálogo de visão geral da migração explica a atualização do Clerk Auth e oferece Ask agent to migrate.">
      <img src="https://mintcdn.com/replit/HAkP_ROSRoShmzzT/images/workspace/auth/replit-auth-to-clerk-dialog.png?fit=max&auto=format&n=HAkP_ROSRoShmzzT&q=85&s=83d3d51db78ea750472bb5a98c989eb8" alt="Diálogo Introducing a new Replit Auth com um botão Ask agent to migrate" width="1259" height="790" data-path="images/workspace/auth/replit-auth-to-clerk-dialog.png" />
    </Frame>
  </Step>
</Steps>

### Revise o plano de migração

De qualquer forma que você iniciar, o Agent cria a task **Migrate from Replit Auth to Clerk** e prepara o plano de migração. Selecione **View plan** e revise o plano antes que a task prossiga.

<Frame caption="A task Migrate from Replit Auth to Clerk começa com uma ação View plan para que você possa revisar o guia de migração.">
  <img src="https://mintcdn.com/replit/HAkP_ROSRoShmzzT/images/workspace/auth/replit-auth-to-clerk-task.png?fit=max&auto=format&n=HAkP_ROSRoShmzzT&q=85&s=91b6d45806c6d55e83b3579f7cdcb59a" alt="Task do Agent chamada Migrate from Replit Auth to Clerk com um botão View plan e atividade de revisão do guia de migração" width="575" height="900" data-path="images/workspace/auth/replit-auth-to-clerk-task.png" />
</Frame>

Não altere o código de autenticação do seu app nem as credenciais do Clerk enquanto o Agent estiver trabalhando.

## O que o Agent faz

O Agent conclui a migração nesta ordem:

1. Move os dados de usuário do Replit Auth para o Clerk, incluindo detalhes de identidade da conta e credenciais de login suportadas.
2. Aguarda a conclusão da migração de dados antes de alterar seu app.
3. Atualiza a lógica de login e sessão do seu app, reinicia o app e executa as verificações automatizadas disponíveis.

## Os dados do seu app permanecem no lugar

O Agent altera apenas o código de autenticação do seu app. Ele não atualiza os dados existentes nem o esquema do banco de dados do seu app. Suas tabelas e relacionamentos permanecem intactos.

Seus usuários existentes continuam conectados aos registros que já possuem, como perfis, trabalho salvo e permissões.

## Quanto tempo leva

Espere que o Agent trabalhe entre 10 minutos e uma hora. A migração de dados em si pode levar alguns minutos para apps menores e até algumas horas para apps com muitos usuários. O Agent não começa a alterar o código do seu app até que essa migração seja concluída.

## Depois da migração

Antes de publicar, teste o app atualizado em Desenvolvimento:

1. Faça login com uma conta existente e confirme que seus dados salvos estão disponíveis.
2. Saia e faça login novamente.
3. Crie uma nova conta de teste e confirme que ela consegue usar o app como esperado.

## Recursos adicionais

* [Visão geral do Clerk Auth](/pt/features/auth-and-identity/clerk-auth) — Como o Clerk Auth funciona no Replit
* [Planeje uma migração de autenticação personalizada](/pt/features/auth-and-identity/custom-auth-migration) — Planeje uma migração a partir de um sistema de autenticação personalizado