Raycastが動かないときに見る場所|権限、常駐、起動項目の順で確かめる
Raycastが反応しない、ホットキーを押しても窓が出ない、スニペットが展開されない。こうした症状に当たったとき、最初に思いつくのはアプリの入れ直しです。ところがこの手の常駐アプリでは、原因の多くがmacOS側の許可設定か、他のアプリとの入力の奪い合いにあります。どちらもアプリを入れ直しても残るため、同じ状態に戻ります。
「Raycast fuguai」で調べている段階で必要なのは、対処法の羅列ではなく、どこから順に見るかという道筋です。見る順番は、権限、二重起動、入力の奪い合い、起動項目の4つ。上から確かめると、症状の大半はどこかで止まります。
以下では、症状を先に分類したうえで、各段階で何を確認するのかを具体的に整理します。最後に、不具合ではないのに不具合に見える2つの状態にも触れます。
症状を先に4つに分ける
「動かない」という言葉には、原因の異なる状態が混ざっています。手を動かす前にどれに当たるかを決めておくと、後の作業が半分になります。
- アプリ自体が起動しない、または起動直後に落ちる
- 起動はしているが、ホットキーを押しても窓が出ない
- 窓は出るが、特定の機能だけが働かない(ウィンドウ操作、スニペット展開、音声入力など)
- 以前は動いていたが、macOSかアプリの更新のあとから急に止まった
1つ目はアプリ本体の問題、2つ目は入力を受け取る手前の問題、3つ目は機能ごとに要求される権限の問題、4つ目は更新で許可が外れた可能性が高い状態です。4つ目に当たる場合、原因の候補は1つ目や3つ目と重なりますが、確認の起点が変わります。更新の直後に止まったなら、まず権限の一覧を疑うのが最短です。
もうひとつ、切り分けの前提として押さえておきたい点があります。Raycastは機能ごとに別々のOS権限を要求する作りになっており、「アプリ全体が許可されているかどうか」という1つのスイッチでは決まりません。ここを一括で考えていると、動く機能と動かない機能が混在する状態が説明できなくなります。
第1段階: 機能ごとに要求される権限を見る
最初に開くのはシステム設定の「プライバシーとセキュリティ」です。公式の切り分け手順でも、機能が止まったときに最初に見る場所として挙げられています。確認するのは次の3か所で、それぞれ担当する機能が違います。
| 権限の欄 | これが無いと止まる機能 |
|---|---|
| アクセシビリティ | ホットキー全般、スニペットの自動展開 |
| 画面収録 | ウィンドウの移動とリサイズ |
| マイク | 音声入力 |
この対応関係は公式の資料に明記されています。とくにアクセシビリティは影響範囲が広く、ここが外れているとホットキーが1つも登録されません。「設定画面ではホットキーが割り当てられているのに、押しても何も起きない」という症状は、ほぼこの欄が原因です。
Open System Settings → Privacy & Security → Accessibility and confirm Raycast is enabled. Without it, no Raycast hotkey can register. 出典: manual.raycast.com(2026年9月10日確認)
ここで見落としやすいのが、一覧に名前は載っているのにスイッチの状態が実態と食い違っている場合です。公式の案内は、一覧に出ているのに効いていないように見えるときは、いったんオフにしてからオンに戻すよう勧めています。macOSのメジャーアップデートのあとにこの状態になることがあります。
ウィンドウ操作だけが動かない場合は、画面収録の欄を見ます。ウィンドウの移動とリサイズには、この権限が必要です。初回に操作を実行したとき、許可が無ければ画面上で促されますが、そこで見送ったままになっていると以後は黙って何も起きません。
第2段階: 同じアプリが二重に動いていないか
意外に多いのが、Raycastが2つ動いている状態です。版を入れ替えた直後や、別の場所に置いたアプリを起動したまま忘れている場合に起きます。公式の切り分けでも、確認事項として挙げられています。
アクティビティモニタを開いてRaycastで検索し、プロセスが2つ出るようなら、使わないほうを終了します。両方を意図して使っている場合は、スニペットの展開を有効にする設定をどちらか一方だけにするよう案内されています。両方で有効にしていると、同じキーワードに2つが反応して、文字が二重に入る、あるいは互いに打ち消し合って何も出ない、といった症状が出ます。
この段階は1分ほどで済みますが、飛ばすと後の作業がすべて空振りになります。権限を直しても直らない、設定を戻しても直らない、という状態が続くときは、ここを疑ってください。
第3段階: ホットキーの奪い合いを解く
窓が出ない症状で、権限も二重起動も問題ない場合、次に見るのは同じキーの組み合わせを他が握っていないかです。呼び出しの初期値はOption+Spaceですが、Spotlightの代わりにCommand+Spaceを割り当てる人が多く、その場合は競合が起きやすくなります。
公式マニュアルは、Command+Spaceが登録できないときに確かめる先を3つ挙げています。
- システム設定のキーボードにあるショートカットの一覧から、Spotlightの検索を表示する項目を外すか変更する
- 同じ一覧の入力ソースにある、入力言語を切り替えるショートカットを外すか変更する
- Siriの呼び出しが同じキーの長押しに割り当てられていないか確認する
3つ目は見落とされがちです。Siriが「Command+Spaceの長押し」に設定されていると、押した瞬間ではなく押し続けたときに競合し、窓の開閉にわずかな遅れが出ます。動かないというより「反応が鈍い」と感じる場合は、ここが原因のことがあります。
キー入力を横取りする常駐アプリを入れている場合も同様です。公式の資料は、テキスト展開の道具、キー配列を書き換える道具、他のランチャーを競合の候補として名前を挙げています。疑わしいものを一時的に止めて再現するかどうかを見るのが、いちばん確実な確かめ方です。
スニペットが展開されない症状には、これとは別の原因もあります。キーワードに空白や引用符が含まれていると、そこが区切りとして扱われて一致しません。また、独自の入力欄を持つアプリ、たとえば一部のコードエディタや端末、パスワード管理アプリでは、テキストの置換そのものが働かないことがあります。別のアプリで試して再現しないなら、アプリ側の作りの問題です。
第4段階: 起動項目の登録が古いまま止まっている
「自動で立ち上がらなくなった」という症状は、上の3つとは別系統です。システム設定の一般から「ログイン項目と機能拡張」を開き、Raycastが自動起動の一覧に載っていて、かつ有効になっているかを確認します。
ここで有効になっているのに起動しない場合、公式の案内は一度削除してから登録し直すよう勧めています。macOSが持つ起動項目のデータベースが、更新の頻度が高いアプリで古い情報のまま止まることがあるためです。これはRaycastに限った話ではなく、更新の多い常駐アプリで一般的に見られる現象です。
ここまでの4段階で直らない場合に、初めて入れ直しを検討します。公式の手順では、最新版を入手して置き換える、それでも直らなければ関連ファイルごと削除してから入れ直す、という順序が案内されています。逆に言えば、入れ直しは4番目より後の手段であって、最初にやることではありません。
それでも直らないときに集めておく情報
4段階を通しても直らない場合、次は開発元への報告になります。ここで手ぶらで問い合わせると、やり取りの往復が増えて時間だけが過ぎます。公式の資料が挙げている項目を先に揃えておくと、最初の返信で話が進みます。
- Raycastの版とmacOSの版。前者は設定のAboutで、後者はシステム設定の一般にある情報で確認できます
- 再現の手順。どのコマンドを開き、どのキーを押し、何を選んだかを順に書きます。毎回起きるのか、たまに起きるのかも添えます
- ログ。Copy Raycast Logsというコマンドが用意されており、実行するとクリップボードに入ります
- 画面の録画。文章で説明しづらい症状は、短い録画のほうが伝わります
- クラッシュの記録。起動直後に落ちる場合は、これが決め手になります
公式の資料は、この中で再現の手順を最も価値のある情報だと位置づけています。開発元の側で同じ状態を作れれば直せますが、作れない場合は未解決のまま残りやすいためです。特定のアプリを前面にしているときだけ起きる、外部ディスプレイをつないでいるときだけ起きる、といった条件は必ず書き添えてください。
なお、ベータ版のRaycastやベータ版のmacOSを使っている場合は、その旨を明記するよう案内されています。この情報が抜けていると、原因の切り分けがまるごと空振りになります。
不具合に見えて不具合ではない2つの状態
切り分けの最後に、症状ではないものを除いておきます。
1つ目は、メモリの使用量です。公式の資料は、外部の統計表示アプリが実際より大きな数値を出すことがあると注意を促し、まずアクティビティモニタで確かめるよう案内しています。加えて、大量のファイルを索引に入れていると索引そのものが大きくなるため、使わないフォルダを検索対象から外すことで縮みます。数時間の使用で単調に増え続ける場合だけが、報告に値する状態です。
2つ目は、メニューバーからアイコンが消えた状態です。Raycastは設定の一般タブに表示のスイッチを持っており、これをオフにすると常駐したままアイコンだけが消えます。さらに、隠す道具を使っている場合は、道具の側が畳んでいるだけということもあります。どちらの場合もアプリは動いているので、ホットキーを押せば窓は出ます。「アイコンが無い」を「壊れた」と読み替えないことが、無駄な入れ直しを防ぎます。
メニューバー側の要因を切り分けるために
上の2つ目は、原因がRaycastの側に無いという点で厄介です。何がアイコンを畳んでいるのかを把握していないと、アプリ側をいくら調べても答えが出ません。整理の道具を入れているなら、その道具が何を隠して何を出しているのかを先に確認してください。隠す動作の範囲と、常駐したときの挙動についてはできることに整理されています。
道具によって隠し方の方式が違うため、同じ「隠す」でも復帰の手数が変わります。展開しないと押せないのか、畳んだまま扱えるのかは、切り分けの手間に直結します。方式ごとの違いはほかの道具との違いにまとまっています。隠したアイコンを、メニューバーを畳んだまま押してその場でメニューを開ける作りであれば、確認のたびに全体を広げる必要がありません。
導入前に費用を確かめておきたい場合は料金を見てください。無料で試せる範囲があるかどうかは、切り分けのために一時的に入れる場合にも関係します。macOSの版との相性や、再起動後に設定が戻らないかといった疑問はよくある質問に載っています。手元で挙動を確かめるならダウンロードから入手できます。
切り分けの順番としては、まずアプリ側の4段階を上から潰し、それでも説明が付かない表示上の症状だけをメニューバー側の要因として扱う、という並びが確実です。逆順にすると、権限が原因の症状を表示の問題として追いかけることになります。
よくある質問
ホットキーを押しても窓が出ません。最初に何を見ればよいですか?
システム設定のプライバシーとセキュリティにあるアクセシビリティの欄です。ここでRaycastが有効になっていないと、設定画面で割り当てたホットキーが1つも登録されません。一覧に名前があるのに効かない場合は、いったんオフにしてからオンに戻してください。macOSの更新後に外れることがあります。
ウィンドウ操作のコマンドだけが何も起きません。原因は違いますか?
違います。ウィンドウの移動とリサイズには画面収録の権限が必要で、ホットキー全般とは別の欄で管理されています。初回の実行時に許可を求められた際に見送ると、以後は促されないまま何も起きない状態になります。プライバシーとセキュリティの画面収録の欄を確認してください。
スニペットの展開だけが効かないのはなぜですか?
原因は3つ考えられます。アクセシビリティの権限が外れている場合、キーワードに空白や引用符が含まれて区切りとして扱われている場合、そして独自の入力欄を持つアプリで置換自体が働かない場合です。別のアプリで試して再現しないなら、そのアプリ側の作りが理由です。
メニューバーからアイコンが消えたのですが、壊れたのでしょうか?
壊れているとは限りません。設定の一般タブに表示のスイッチがあり、オフにすると常駐したままアイコンだけが消えます。隠す道具を使っている場合は、その道具が畳んでいることもあります。どちらの場合もホットキーを押せば窓は出るので、まず呼び出せるかどうかで判断してください。