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

Aprenda exatamente como ativar e usar o Modo Auto de Código do Claude para uma codificação autônoma mais segura. Tutorial completo com instalação, configuração, alternância de modos e solução de problemas para usuários Team/Enterprise.

Canonical URL: https://a2a-mcp.org/blog/how-to-use-claude-code-auto-mode-pt

Language: pt

Published: 2026-03-25

Updated: 2026-03-25

## 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**
   ```bash
   curl -fsSL https://claude.ai/install.sh | bash
   ```

   **Windows (PowerShell)**
   ```powershell
   irm https://claude.ai/install.ps1 | iex
   ```

3. Verifique a instalação:
   ```bash
   claude --version
   ```

4. (Opcional) Para Homebrew no macOS:
   ```bash
   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:
   ```bash
   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:
```bash
claude --enable-auto-mode
```

Ou inicie diretamente com o Modo Automático:
```bash
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):
```json
{
  "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:
   ```bash
   claude auto-mode defaults
   ```

2. Copie a saída e crie/edite seu arquivo de configurações com infraestrutura confiável:
   ```json
   {
     "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:
   ```bash
   claude auto-mode config
   ```

4. Obtenha feedback da IA sobre regras personalizadas:
   ```bash
   claude auto-mode critique
   ```

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

1. Navegue até seu projeto:
   ```bash
   cd /caminho/para/seu-projeto
   ```

2. Inicie o Claude Code com o Modo Automático habilitado:
   ```bash
   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:
   ```text
   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.