← blog

¿xcrun simctl not found? Las dos causas y cómo arreglarlo

25 de octubre de 2026 · 5 min de lectura

Escribes xcrun simctl list y, en lugar de simuladores, recibes un error. Hay dos problemas distintos que lo causan, y cada uno se arregla de forma diferente. El texto del error te dice cuál tienes.

Nosotros nos topamos con el segundo en un rack entero de Mac mini nuevos. Xcode estaba instalado y xcodebuild -version funcionaba. Aun así, todas las builds para el simulador de iOS habrían fallado. Aquí tienes qué significa cada error y los comandos exactos que lo arreglaron.

¿Qué error tienes?

Causa 1: están seleccionadas las Command Line Tools

Este es el mensaje:

xcrun: error: unable to find utility "simctl", not a developer tool or in PATH

Las Command Line Tools traen compiladores y git, pero no simuladores. Si son el directorio de desarrollo activo, xcrun busca ahí y no encuentra simctl. Comprueba cuál está activo:

xcode-select -p
# /Library/Developer/CommandLineTools          (the problem)
# /Applications/Xcode.app/Contents/Developer   (what you want)

Apúntalo a Xcode. Usa la ruta real si tu Xcode lleva la versión en el nombre.

sudo xcode-select -s /Applications/Xcode.app
xcrun simctl list runtimes

Causa 2: el primer arranque de Xcode nunca se ejecutó

Este es más raro. Xcode está seleccionado y es el propio simctl el que falla:

Install Started
Install Failed: Authorization is required to install the packages.
/Applications/Xcode.app/Contents/Developer/usr/bin/simctl: line 15:
  /Library/Developer/PrivateFrameworks/CoreSimulator.framework/Versions/A/Resources/bin/simctl:
  No such file or directory

La primera vez que abres Xcode, instala algunos paquetes del sistema. Uno de ellos es CoreSimulator, en /Library/Developer/PrivateFrameworks. El simctl de Xcode es un pequeño script que delega en ese framework. Si Xcode se instaló pero nunca se abrió, el framework no está.

Pasa mucho en máquinas de CI y en Mac sin pantalla. Nadie abre Xcode en ellas. Las herramientas que instalan Xcode por ti, como xcodes, copian la app pero no ejecutan su primer arranque. Puedes comprobarlo:

xcodebuild -checkFirstLaunchStatus; echo $?
# 69 means first launch has not run. 0 means it has.

La solución son dos comandos:

# 1. install Xcode's first-launch packages, including CoreSimulator
sudo xcodebuild -runFirstLaunch

# 2. install an iOS simulator runtime if there is none
sudo xcodebuild -downloadPlatform iOS

En nuestros mini M6 con Xcode 26.6, el primer comando tardó 8 segundos. El segundo descargó el runtime de iOS 26.5 en unos cuatro minutos y medio y ocupó unos 9 GB de disco. No pidió Apple ID. Después:

xcrun simctl list runtimes
== Runtimes ==
iOS 26.5 (26.5 - 23F77) - com.apple.CoreSimulator.SimRuntime.iOS-26-5

Haz que un Mac de CI se compruebe solo

La trampa es que xcodebuild -version funciona sin problema en un Mac con este fallo. Un health check basado en él pasa, y la primera build para el simulador falla. Comprueba mejor lo que de verdad necesitas:

Ahora pasamos estas comprobaciones cada vez que un Mac entra en nuestra flota. Cada máquina de MacRun llega con el primer arranque de Xcode hecho y un runtime del simulador de iOS instalado, así que la primera build funciona sin más.

Preguntas

¿Por qué xcrun dice que no encuentra simctl?
Normalmente porque el directorio de desarrollo activo son las Command Line Tools, no Xcode. Las Command Line Tools no traen herramientas de simulador. Apunta xcode-select a Xcode con sudo xcode-select -s /Applications/Xcode.app y vuelve a probar.
¿Qué significa "simctl: No such file or directory"?
Xcode está seleccionado, pero sus paquetes de primer arranque nunca se instalaron. Esos paquetes ponen CoreSimulator en /Library/Developer/PrivateFrameworks. Ejecuta sudo xcodebuild -runFirstLaunch para instalarlos.
¿xcodebuild -downloadPlatform iOS necesita un Apple ID?
No. En nuestros Mac con Xcode 26.6 descargó e instaló el runtime del simulador de iOS 26.5 sin iniciar sesión. Tardó unos cuatro minutos y medio y ocupó unos 9 GB de disco.
¿Cómo compruebo que un Mac de CI está listo antes de una build?
Ejecuta xcodebuild -checkFirstLaunchStatus, que devuelve 0 cuando el primer arranque está hecho. Después ejecuta xcrun simctl list runtimes y busca al menos una línea de iOS.

Haz tus propias cuentas con la calculadora o alquila un runner.