Como Usar o Modo Auto de Código do Claude: Tutorial Passo a Passo (2026)

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

Abra seu terminal.
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
```
Verifique a instalação:
```
claude --version
```
(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

Inicie uma sessão interativa:
```
claude
```
Siga o prompt de login na tela (apenas no primeiro uso).
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.

Inspecione as regras internas:
```
claude auto-mode defaults
```

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"
    ]
  }
}

Valide sua configuração:
```
claude auto-mode config
```
Obtenha feedback da IA sobre regras personalizadas:
```
claude auto-mode critique
```

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

Navegue até seu projeto:
```
cd /caminho/para/seu-projeto
```
Inicie o Claude Code com o Modo Automático habilitado:
```
claude --enable-auto-mode
```
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.

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.

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.