Como Usar o Modo Auto de Código do Claude: Tutorial Completo Passo a Passo

Pré-requisitos

Antes de usar o Claude Code Modo Automático, garanta que você tem o seguinte:

• Assinatura Claude: Plano Team (necessário para a prévia de pesquisa) ou plano Enterprise (em lançamento gradual). O Modo Automático não está disponível em contas Pro, Max ou gratuitas.
• Modelo Claude: Claude Sonnet 4.6 ou Opus 4.6 (necessário para o Modo Automático).
• Claude Code instalado: Versão mais recente do CLI, aplicativo Desktop ou extensão VS Code.
• Diretório de projeto: Uma codebase local na qual você deseja trabalhar.
• Acesso ao terminal: Para uso via CLI (recomendado para controle total).

Nota: O Modo Automático está atualmente em uma prévia de pesquisa. Administradores podem desativá-lo para toda a organização via configurações gerenciadas.

Passo104: Instalar o Claude Code

1. Abra seu terminal.

2. Execute o comando de instalação apropriado para seu sistema operacional:

   macOS / Linux / WSL

   curl -fsSL https://claude.ai/install.sh | bash
   

   Windows (PowerShell)

   irm https://claude.ai/install.ps1 | iex
   

3. Verifique a instalação:

   claude --version
   

4. (Opcional) Para Homebrew no macOS:

   brew install --cask claude-code
   

Após a instalação, o Claude Code será atualizado automaticamente em segundo plano.

Passo 2: Fazer Login no Claude Code

1. Inicie uma sessão interativa:
   claude
   

2. Siga o prompt de login na tela (apenas no primeiro uso).
3. Use uma conta Team ou Enterprise.

Uma vez conectado, as credenciais são armazenadas de forma segura.

Passo 3: Ativar o Modo Automático

O Modo Automático deve ser explicitamente desbloqueado antes de aparecer no ciclo de modos.

Método CLI (Recomendado)

Inicie com o sinalizador de ativação:

claude --enable-auto-mode

Ou inicie diretamente com o Modo Automático:

claude --enable-auto-mode --permission-mode auto

Método do Arquivo de Configurações

Crie ou edite ~/.claude/settings.json (nível de usuário) ou .claude/settings.local.json (nível de projeto):

{
  "defaultMode": "auto"
}

Importante: O sinalizador --enable-auto-mode ainda é necessário na inicialização para que o modo apareça no ciclo Shift+Tab.

Aplicativo Desktop / Extensão VS Code

• Abra as configurações do Claude Code.
• Ative o Modo Automático (aparece apenas após a ativação via sinalizador CLI ou configurações de administrador).

Passo 4: Configurar o Classificador de Modo Automático (Recomendado)

O Modo Automático utiliza um classificador em segundo plano para aprovar ações seguras. Personalize-o para seu ambiente.

1. Inspecione as regras internas:

   claude auto-mode defaults
   

2. Copie a saída e crie/edite seu arquivo de configurações com infraestrutura confiável:

   {
     "autoMode": {
       "environment": [
         "Organização: Acme Corp. Uso principal: desenvolvimento de software",
         "Controle de versão: github.com/acme-corp e todos os repositórios",
         "Buckets de nuvem: s3://acme-build-artifacts"
       ],
       "allow": [
         "Implantação em staging é permitida: ambiente isolado"
       ],
       "soft_deny": [
         "Nunca execute migrações de banco de dados fora do CLI oficial"
       ]
     }
   }
   

3. Valide sua configuração:

   claude auto-mode config
   

4. Obtenha feedback da IA sobre regras personalizadas:

   claude auto-mode critique
   

Passo Monthly: Iniciar uma Sessão e Alternar para o Modo Automático

1. Navegue até seu projeto:

   cd /caminho/para/seu-projeto
   

2. Inicie o Claude Code com o Modo Automático habilitado:

   claude --enable-auto-mode
   

3. Altere os modos durante a sessão:

   • Pressione Shift + Tab (ou Alt + M) repetidamente para alternar: default → acceptEdits → plan → auto.
   • O modo atual aparece na barra de status.

4. Dê uma tarefa ao Claude. Exemplo:

   Refatore o módulo de autenticação, adicione testes unitários e execute a suíte completa de testes.
   

O Modo Automático agora aprovará automaticamente chamadas de ferramentas de baixo risco (leitura de arquivos, edições direcionadas, builds/testes padrão) enquanto o classificador bloqueia qualquer coisa arriscada.

Passo 6: Melhores Práticas para Uso Eficaz

• Comece primeiro no Modo de Planejamento: Altere para plan (Shift+Tab duas vezes), revise o plano do Claude, depois mude para o Modo Automático.
• Adicione contexto do projeto: Crie um arquivo CLAUDE.md na raiz com padrões de codificação, comandos de build e ações proibidas.
• Use checkpoints: Claude salva automaticamente estados antes das alterações. Retroceda com Esc duas vezes ou /rewind.
• Combine com hooks: Configure .claude/settings.json para linting ou testes automáticos após edições.
• Monitore o progresso: Use o modo verboso (Ctrl + R) para ver todo o raciocínio.

Problemas Comuns e Solução de Problemas

• Modo Auto não aparece no ciclo:

  • Certifique-se de que iniciou o programa com --enable-auto-mode.
  • Confirme que você está na versão Team/Enterprise com Sonnet 4.6 ou Opus 4.6.
  • Verifique as configurações de administrador se estiver em uma organização.

• O classificador bloqueia ações legítimas:

  • Adicione regras explícitas a autoMode.allow ou environment.
  • Use claude auto-mode critique para sugestões.
  • Forneça instruções de tarefa mais claras ou alterne temporariamente para acceptEdits.

• Latência maior ou uso de tokens mais alto:

  • É esperado devido ao classificador em segundo plano. Use apenas para sessões mais longas.

• Erros de permissão em caminhos protegidos:

  • .git, .claude, etc., ainda solicitam na maioria dos modos. Use ambientes isolados (Docker/VM) para autonomia total.

• A sessão é encerrada inesperadamente:

  • Execute claude -c para continuar a conversa mais recente.

Próximos Passos

• Explore o Modo Plano para refatorações complexas antes de mudar para o Modo Auto.
• Configure comandos personalizados e hooks para fluxos de trabalho repetíveis. – Experimente subagentes para tarefas paralelas (ex.: frontend + backend).
• Integre com CI/CD via GitHub Actions para pipelines totalmente automatizados.

1. Experimente em um branch Git descartável ou em um container Docker por segurança.

Com o Modo Auto habilitado e configurado corretamente, você pode executar sessões de codificação autônomas de longa duração com significativamente menos interrupções, mantendo fortes mecanismos de segurança. Comece com uma tarefa simples hoje e expanda gradualmente suas regras de ambiente confiável conforme ganha confiança.