Cómo Utilizar el Modo Automático de Código de Claude: Tutorial Completo Paso a Paso

Requisitos previos

Antes de usar el Modo Automático de Claude Code, asegúrate de tener lo siguiente:

• Suscripción a Claude: Plan de Equipo (requerido para la vista previa de investigación) o plan Enterprise (disponible próximamente). El Modo Automático no está disponible en cuentas Pro, Max o gratuitas.
• Modelo de Claude: Claude Sonnet 4.6 u Opus 4.6 (requerido para el Modo Automático).
• Claude Code instalado: La última versión de la CLI, la aplicación de escritorio o la extensión para VS Code.
• Directorio de proyecto: Una base de código local en la que quieras trabajar.
• Acceso a terminal: Para uso de CLI (recomendado para control total).

Nota: El Modo Automático es actualmente una vista previa de investigación. Los administradores pueden desactivarlo para toda la organización a través de la configuración gestionada.

Paso6540 1: Instalar Claude Code

1. Abre tu terminal.

2. Ejecuta el comando de instalación apropiado para tu sistema operativo:

   macOS / Linux / WSL

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

   Windows (PowerShell)

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

3. Verifica la instalación:

   claude --version
   

4. (Opcional) Para Homebrew en macOS:

   brew install --cask claude-code
   

Después de la instalación, Claude Code se actualizará automáticamente en segundo plano.

Paso 2: Iniciar sesión en Claude Code

1. Inicia una sesión interactiva:
   claude
   

2. Sigue la solicitud de inicio de sesión en pantalla (solo en el primer uso).
3. Utiliza una cuenta de Equipo o Enterprise.

Una vez iniciada la sesión, las credenciales se almacenan de forma segura.

Paso 3: Habilitar el Modo Automático

El Modo Automático debe desbloquearse explícitamente antes de que aparezca en el ciclo de modos.

Método CLI (Recomendado)

Inicia con el flag de habilitación:

claude --enable-auto-mode

O inicia con el Modo Automático directamente:

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

Método de archivo de configuración

Crea o edita ~/.claude/settings.json (nivel de usuario) o .claude/settings.local.json (nivel de proyecto):

{
  "defaultMode": "auto"
}

Importante: El flag --enable-auto-mode aún es necesario al inicio para que el modo aparezca en el ciclo Shift+Tab.

Aplicación de escritorio / Extensión de VS Code

• Abre la configuración de Claude Code.
• Activa el interruptor Modo Automático (solo aparece después de habilitarlo mediante el flag CLI o la configuración del administrador).

Paso 4: Configurar el Clasificador del Modo Automático (Recomendado)

El Modo Automático utiliza un clasificador en segundo plano para aprobar acciones seguras. Personalízalo para tu entorno.

1. Inspecciona las reglas incorporadas:

   claude auto-mode defaults
   

2. Copia la salida y crea/edita tu archivo de configuración con la infraestructura de confianza:

   {
     "autoMode": {
       "environment": [
         "Organización: Acme Corp. Uso principal: desarrollo de software",
         "Control de versiones: github.com/acme-corp y todos los repositorios",
         "Almacenamiento en la nube: s3://acme-build-artifacts"
       ],
       "allow": [
         "Permitido desplegar en staging: entorno aislado"
       ],
       "soft_deny": [
         "Nunca ejecutar migraciones de base de datos fuera de la CLI oficial"
       ]
     }
   }
   

3. Valida tu configuración:

   claude auto-mode config
   

4. Obtén retroalimentación de la IA sobre reglas personalizadas:

   claude auto-mode critique
   

Paso4: Iniciar una Sesión y Cambiar al Modo Automático

1. Navega a tu proyecto:

   cd /ruta/a/tu-proyecto
   

2. Lanza Claude Code con el Modo Automático habilitado:

   claude --enable-auto-mode
   

3. Cambia de modos durante la sesión:

   • Presiona Shift + Tab (o Alt + M) repetidamente para alternar: default → acceptEdits → plan → auto.
   • El modo actual aparece en la barra de estado.

4. Asigna una tarea a Claude. Ejemplo:

   Refactoriza el módulo de autenticación, añade pruebas unitarias y ejecuta toda la suite de tests.
   

El Modo Automático ahora aprobará automáticamente las llamadas a herramientas de bajo riesgo (lecturas de archivos, ediciones específicas, compilaciones/pruebas estándar) mientras el clasificador bloquea cualquier cosa riesgosa.

Paso 6: Mejores Prácticas para un Uso Efectivo

• Comienza primero en Modo Plan: Cambia a plan (Shift+Tab dos veces), revisa el plan de Claude, luego cambia al Modo Automático.
• Añade contexto del proyecto: Crea un archivo CLAUDE.md en la raíz con estándares de codificación, comandos de compilación y acciones prohibidas.
• Usa puntos de control: Claude guarda automáticamente estados antes de los cambios. Retrocede con Esc dos veces o /rewind.
• Combina con hooks: Configura .claude/settings.json para linting automático o pruebas después de las ediciones.
• Monitorea el progreso: Usa el modo detallado (Ctrl + R) para ver todo el razonamiento.

Problemas Comunes y Solución de Fallos

• El Modo Auto no aparece en el ciclo:

  • Asegúrate de haber iniciado el programa con --enable-auto-mode.
  • Confirma que estás en un plan Team/Enterprise con Sonnet 4.6 u Opus 4.6.
  • Verifica los ajustes de administrador si estás en una organización.

• El clasificador bloquea acciones legítimas:

  • Añade reglas explícitas a autoMode.allow o environment.
  • Usa claude auto-mode critique para obtener sugerencias.
  • Proporciona instrucciones de tarea más claras o cambia temporalmente a acceptEdits.

• Latencia mayor o uso de tokens elevado:

  • Esto es esperado debido al clasificador en segundo plano. Úsalo solo para sesiones largas.

• Errores de permiso en rutas protegidas:

  • Rutas como .git, .claude, etc., aún solicitan confirmación en la mayoría de modos. Usa entornos aislados (Docker/VM) para autonomía completa.

• La sesión finaliza inesperadamente:

  • Ejecuta claude -c para continuar la conversación más reciente.

Siguientes Pasos

• Explora el Modo Plan para refactorizaciones complejas antes de cambiar al Modo Auto. . Configura comandos personalizados y hooks para flujos de trabajo repetibles.
• Prueba subagentes para tareas paralelas (p. ej., frontend + backend).
• Integra con CI/CD mediante GitHub Actions para canalizaciones completamente automatizadas.
• Experimenta en una rama Git desechable o un contenedor Docker por seguridad.

Con el Modo Auto habilitado y configurado correctamente, puedes ejecutar sesiones de codificación autónoma de una hora con muchas menos interrupciones, manteniendo sólidas barreras de seguridad. Comienza con una tarea simple hoy y expande gradualmente tus reglas de entorno confiable a medida que ganes confianza.