本文へスキップ
制作ツール

launchdで動かすNodeが起動しない。Nodeを上げたら、デスクトップの保護(TCC)で固まっていた

公開 約7分で読めます

TL;DRこの記事の要点

  • Nodeを上げたら、launchdで常駐させていたNode製サービスがエラーなしで応答しなくなった
  • 原因は作業フォルダを~/Desktopに置いていたこと(macOSのデスクトップ保護)
  • フォルダをデスクトップの外へ移したら、Node 26のまま約8秒で動いた
  • Node更新後はWorkingDirectoryの場所とNodeパスの直書きを確認する
目次6項目
  1. Nodeのセキュリティ更新で、nvmのNodeを入れ替えた
  2. Node 26に上げたら、エラーなしで応答しなくなった
  3. 原因を調べる: 作業フォルダと、TCCの許可の記録
  4. デスクトップの外にフォルダを移したら、Node 26で動いた
  5. 2か月前にも、デスクトップで同じ目にあっていた
  6. launchdで動かすNodeを、Node更新のあとに確認すること

Nodeを上げたら、常駐サービスが黙りこみました。
エラーも出ないんです。

🎥 この記事の内容は動画でも解説しています。

launchd(macOSの自動起動の仕組み)で動かしていた、Node製の自作サービスの話です。
Nodeのバージョンを上げて、設定のパスも書き換えて再起動しました。
プロセスは動いてるのに、ポートに聞いても返事なし。

原因は、サービスの作業フォルダを~/Desktopに置いていたことでした。
正確には、許可の記録がある古いNodeでも止まったので、細かい仕組みまでは分かってません。
macOSはデスクトップを守っていて、launchdから動くプログラムが読むには許可が要るんです。
フォルダをデスクトップの外に移したら、約8秒で動きました。

launchdで動かすものがNodeの更新後に起動しないなら、まずは2つ見てみてください。

  • plistのWorkingDirectoryやスクリプトの場所が、~/Desktop・~/Documents・~/Downloadsの中にないか
  • plistに、古いNodeのパスが直接書かれていないか

Nodeのセキュリティ更新で、nvmのNodeを入れ替えた

きっかけは、Node.jsのセキュリティリリースです。
22系はv22.23.5、26系はv26.13.1で直りました。

Claude Code(AIのコーディングツール)に、更新をお願いしました。
nvm(Nodeのバージョンを切り替えるツール)で22.23.5を入れて、古いバージョンは消す流れです。

ここで1つ見つかりました。
Nodeのパスを直接書いている場所が、2か所あったんです。

  • YouTubeの関連動画を設定する自作スクリプト
  • 常駐サービスclaude-codex-hubのlaunchd設定(plist)

claude-codex-hubは、ClaudeとCodexを外からつなぐために作ったNode製のサーバーです。
plistは、こうなってました(必要なところだけ)。

<key>KeepAlive</key>
<true/>
<key>ProgramArguments</key>
<array>
  <string>/Users/(ユーザー名)/.nvm/versions/node/v22.14.0/bin/node</string>
  <string>backend/dist/src/index.js</string>
</array>
<key>WorkingDirectory</key>
<string>/Users/(ユーザー名)/Desktop/連携</string>

nvmのNodeは、バージョンごとに別のフォルダに入ります。
なので古いバージョンを消すと、このパスの先が無くなります。
そのまま消してたら、サービスは起動できなくなってました。

Claude Codeがパスを書き換えて、サービスを読み込み直しました。
plistを書き換えたら、一度外してから読み込み直すと反映されます。

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.claude-codex-hub.remote.plist
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-codex-hub.remote.plist

22.23.5では、ここで普通に動きました。

Node 26に上げたら、エラーなしで応答しなくなった

その日の昼、22から26(LTS)にも上げることにしました。
22のサポートは2027年4月まで。
26は2029年4月までです。

コマンドで使うツール4つと、動画を書き出すRemotionは26でも動きました。
ところが、常駐サービスだけ返事がありません。

  • psで見ると、v26.13.1のnodeが2分以上動いている
  • curl http://127.0.0.1:4318/は、何度聞いても応答なし
  • ログには新しい行がない。エラーログも更新されていない

落ちてないし、エラーも出してない。
ただ固まってる。
いちばん困るやつです。

Claude Codeは「画面に出ている許可のダイアログを押して」と言ってきました。
でも、画面には何も出てません。
押すものがない。

原因を調べる: 作業フォルダと、TCCの許可の記録

プロセスが開いているものをlsofで見てもらうと、作業フォルダは/Users/(ユーザー名)/Desktop/連携でした。

lsof -p <プロセスID>

macOSには、TCC(プライバシー保護の仕組み)があります。
デスクトップ・書類・ダウンロードなどのフォルダは、アプリやプログラムごとに許可が要ります。

TCCの許可の記録を、Claude Codeに読んでもらいました。
読むだけのコマンドです。

sqlite3 ~/Library/Application Support/com.apple.TCC/TCC.db 
"select service,client,auth_value,datetime(last_modified,'unixepoch','localtime') from access where client like '%node%';"

デスクトップの許可は、こう残ってました(一部)。

kTCCServiceSystemPolicyDesktopFolder | ~/.nvm/versions/node/v22.14.0/bin/node | 2 | 2026-08-20
kTCCServiceSystemPolicyDesktopFolder | ~/.nvm/versions/node/v22.23.5/bin/node | 2 | 2026-11-12 10:07

自分のMacでは、許可がnodeの実行ファイルのパスごとに記録されてました。
v26.13.1の行はありません。
記録の上では、新しいnodeは別のプログラム扱いです。

ここで話は終わりませんでした。
許可の記録がある22.23.5に戻しても、やっぱり応答しなかったんです。
でも、同じnodeを手で起動すると、8秒以内に応答しました。
launchd経由のときだけダメ。

手で起動したときは、launchdのサービスを止めてから、ポートだけ変えて動かしてもらいました。

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.claude-codex-hub.remote.plist
cd ~/Desktop/連携
PORT=4319 REMOTE_ACCESS=1 ~/.nvm/versions/node/v22.23.5/bin/node backend/dist/src/index.js
# 別のターミナルで
curl -s -o /dev/null -w "%{http_code}n" http://127.0.0.1:4319/

なんで22.23.5でも止まったのかは、分かってません。
朝に動いたのは、たまたまかも。多分。

launchdから、デスクトップの中で動かしてるときだけ止まる。
なので、デスクトップから出してみることにしました。

TCCの記録は~/Library/Application Support/com.apple.TCC/TCC.dbにあります。
今回はsqlite3で読むだけにしました。
このファイルは書き換えないでください。
許可を変えたいときは、システム設定の「プライバシーとセキュリティ」から操作します。

デスクトップの外にフォルダを移したら、Node 26で動いた

フォルダを移していいか聞かれて、「移して」と返しました。
Claude Codeがやったのは、この3つです。

  1. ~/Desktop/連携を~/claude-codex-hub-appに移動(デスクトップにはシンボリックリンクを置いて、今まで通り開けるように)
  2. plistのWorkingDirectoryとnodeのパスを、新しい場所と26に書き換え
  3. bootout→bootstrapで読み込み直し

約8秒で応答が返りました!
Node 26のままです。

mv ~/Desktop/連携 ~/claude-codex-hub-app
ln -s ~/claude-codex-hub-app ~/Desktop/連携

シンボリックリンク(別の場所を指すショートカット)は入口だけ。
plistには、移した先の本当のパスを書いておきます。

・・・で、結局このサービスは今は使ってないので、そのあと消しました。
直したのに!

2か月前にも、デスクトップで同じ目にあっていた

実は2か月前にも、デスクトップに置いた自動化でつまずいてます。
Threadsの自動投稿をlaunchdで動かしていて、「Operation not permitted」で失敗し続けていました。
そのときの話はこちらです。

見てなくても投稿されるようにしたはずが、実は裏で全部失敗してた話

そのときにスクリプトをデスクトップの外へ移して、ルールにもしてました。
でも、それより前に作った常駐サービスだけ、デスクトップに残ってたんです。

前回はエラーが出てました。
今回はエラーすら出ず、固まるだけ。
症状が違うので、同じ原因だとすぐには気づけませんでした。

launchdで動かすNodeを、Node更新のあとに確認すること

Node更新のあとは、この順で見ると早いです。

  1. plistのWorkingDirectoryと、動かすファイルの場所。~/Desktop・~/Documents・~/Downloadsの中なら、外へ移す
  2. plistやスクリプトに、nvmのNodeのパスが直接書かれていないか。grep -rn "nvm/versions/node" ~/Library/LaunchAgentsで探せます。自作スクリプトの置き場所にも同じgrepをかけます(今回は関連動画のスクリプトにもありました)
  3. 書き換えたらbootout→bootstrapで読み込み直して、curlなどで本当に応答するか確かめる

古いNodeは、すぐには消してません。
今回は22.23.5を残しておいて、夜の自動化が26で動いたのを見てから、翌日に消しました。
パスの直書きが残ってると、消した瞬間に止まるので・・・。

この記事が参考になったら、応援クリックをお願いします

Cat's Handこの記事を書いた人

Web制作歴10年以上。WordPressのテーマカスタマイズやコーディングを中心に、副業・本業ともにweb制作に携わっています。このブログでは、実際に手を動かして分かったことを書いています。