Inicio / Fundamentos y bucle del agente

Ejecutar comandos de shell

La herramienta Bash ejecuta un comando de shell real en tu equipo, no una simulación, y Claude Code lee la salida estándar y la salida de error para continuar a partir de lo que realmente se produjo. Aparece un aviso de permiso antes de cada comando nuevo, salvo para un conjunto integrado de comandos de solo lectura.

La herramienta Bash ejecuta un comando de shell real en tu equipo, no una simulación. Claude Code lee después la salida estándar y la salida de error de ese comando para continuar su razonamiento a partir de lo que realmente se produjo, y no de lo que se esperaba.

Un aviso antes de cada comando nuevo

Antes de que se ejecute un comando de shell nuevo, aparece en pantalla un aviso de permiso. La documentación oficial describe este comportamiento para los comandos de shell como una confirmación solicitada cada vez, salvo para un conjunto integrado de comandos de solo lectura que se ejecutan directamente. Responder con la opción que memoriza la elección hace que ese comando preciso quede aprobado de forma permanente, pero solo para el repositorio en curso y para ese comando preciso: no es una autorización general que se extendiera a cualquier comando de shell futuro.

El patrón global que reactiva el aviso

Un comando ya aprobado puede, a pesar de todo, volver a disparar el aviso. Cuando un patrón global sin proteger figura en los argumentos de un comando con banderas capaces de escribir o ejecutar, por ejemplo find, sort, sed o git, el aviso reaparece aunque el comando base ya figure en la lista de comandos de confianza. La razón es concreta: ese patrón podría desarrollarse, en el momento de la ejecución, en una bandera destructiva que nadie había aprobado. Esta salvaguarda es una protección colocada por encima de la propia lista de confianza.

Aquí tienes un ejemplo autónomo, que fabrica su propio archivo antes de leerlo, en lugar de inspeccionar un archivo real del proyecto:

mkdir -p /tmp/demo-bash
echo "erreur : connexion refusée" > /tmp/demo-bash/journal.txt
grep "erreur" /tmp/demo-bash/journal.txt

La última línea devuelve el contenido encontrado, erreur : connexion refusée. Es exactamente lo que Claude recibe de vuelta al llamar a la herramienta Bash: la salida bruta del comando.

Esta lectura de la salida real antes de continuar es lo que hace funcionar el bucle de agente: pensar, llamar a una herramienta, observar lo que realmente devuelve, volver a empezar. El mismo principio de aprobación caso por caso se encuentra en la lectura de un diff de modificación de archivo, donde solo cambia el tipo de acción.

Las comillas saltan de un shell a otro

Un script pasado como argumento a otro programa llega a veces deformado, sin un mensaje de error claro. En el ejemplo siguiente, los acentos graves dentro de una cadena entre comillas dobles los ejecuta el shell antes de que Node vea el texto:

node -e "console.log('carpeta `echo SUSTITUIDO` lista')"

carpeta SUSTITUIDO lista

El texto escrito era «echo SUSTITUIDO» entre acentos graves, y Node recibió el resultado del comando. El remedio cabe en dos líneas: escribe el script en un archivo con un delimitador entre comillas simples y pasa luego su ruta.

cat > note.js << 'EOF'
console.log('carpeta `echo SUSTITUIDO` lista')
EOF
node note.js

carpeta `echo SUSTITUIDO` lista

El mismo riesgo existe entre PowerShell, cmd, ssh y Git Bash, que se disputan cada uno las comillas. En cuanto un comando contiene comillas anidadas, ponlo en un archivo, o verifica el eco de lo que sale antes de lanzar.