Back to Blog
BlogMarch 25, 20262

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

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: defaultacceptEditsplanauto.
    • 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.

Share this article