← ブログ

xcrun simctlが見つからない? 2つの原因と直し方

2026年10月25日 · 5分で読めます

xcrun simctl listと入力すると、シミュレータの一覧ではなくエラーが出る。この原因は2つあり、直し方も違います。どちらなのかは、エラーの文面でわかります。

当社では、新しいMac miniのラック全体で2つめの問題に遭遇しました。Xcodeはインストール済みで、xcodebuild -versionも動きました。それでもiOSシミュレータのビルドはすべて失敗するところでした。それぞれのエラーの意味と、実際に直したコマンドを説明します。

どちらのエラーですか?

原因1:Command Line Toolsが選択されている

メッセージは次のとおりです。

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

Command Line Toolsにはコンパイラとgitが入っていますが、シミュレータはありません。これがアクティブなデベロッパディレクトリだと、xcrunはそこを探してsimctlを見つけられません。どちらがアクティブか確認します。

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

Xcodeに向けます。Xcodeの名前にバージョンが入っている場合は、実際のパスを使ってください。

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

原因2:Xcodeの初回起動処理が実行されていない

こちらはもっと奇妙に見えます。Xcodeは選択されているのに、simctl自体が失敗します。

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

Xcodeを初めて開くと、いくつかのシステムパッケージがインストールされます。そのひとつが/Library/Developer/PrivateFrameworksにあるCoreSimulatorです。Xcode内のsimctlは小さなスクリプトで、処理をこのフレームワークに渡します。Xcodeをインストールしても一度も開いていなければ、このフレームワークはありません。

これはCIマシンやヘッドレスのMacでよく起きます。誰もそこでXcodeを開かないからです。xcodesのようにXcodeをインストールしてくれるツールは、アプリをコピーしますが初回起動処理は実行しません。次のように確認できます。

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

直し方はコマンド2つです。

# 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

Xcode 26.6を入れた当社のM6 miniでは、1つめのコマンドは8秒で終わりました。2つめはiOS 26.5のランタイムを約4分半でダウンロードし、ディスクを約9 GB使いました。Apple IDは不要でした。その後の結果です。

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

CI用のMacに自分自身をチェックさせる

落とし穴は、この問題があるMacでもxcodebuild -versionが普通に動くことです。これを使ったヘルスチェックは通り、最初のシミュレータビルドで失敗します。代わりに、本当に必要なものを確認しましょう。

当社では現在、Macをフリートに加えるときにこれらのチェックを実行しています。MacRunのマシンはどれも、Xcodeの初回起動処理が済み、iOSシミュレータのランタイムもインストール済みです。そのため、最初のビルドからそのまま動きます。

よくある質問

xcrunがsimctlを見つけられないのはなぜですか?
多くの場合、アクティブなデベロッパディレクトリがXcodeではなくCommand Line Toolsになっているためです。Command Line Toolsにはシミュレータのツールがありません。sudo xcode-select -s /Applications/Xcode.app でxcode-selectをXcodeに向けてから、もう一度試してください。
「simctl: No such file or directory」とはどういう意味ですか?
Xcodeは選択されていますが、初回起動時のパッケージがインストールされていません。これらのパッケージはCoreSimulatorを/Library/Developer/PrivateFrameworksに配置します。sudo xcodebuild -runFirstLaunch を実行してインストールしてください。
xcodebuild -downloadPlatform iOSにはApple IDが必要ですか?
いいえ。Xcode 26.6を入れた当社のMacでは、サインインなしでiOS 26.5のシミュレータランタイムをダウンロードしてインストールできました。所要時間は約4分半で、ディスクを約9 GB使いました。
ビルドの前に、CI用のMacの準備ができているか確認するには?
xcodebuild -checkFirstLaunchStatus を実行します。初回起動が済んでいれば0を返します。次に xcrun simctl list runtimes を実行し、iOSの行が少なくとも1つあるか確認します。

自分の数字で試すなら 計算ツール へ。または ランナーを契約する。