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つです。
~/Desktop/連携を~/claude-codex-hub-appに移動(デスクトップにはシンボリックリンクを置いて、今まで通り開けるように)- plistの
WorkingDirectoryとnodeのパスを、新しい場所と26に書き換え 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更新のあとは、この順で見ると早いです。
- plistの
WorkingDirectoryと、動かすファイルの場所。~/Desktop・~/Documents・~/Downloadsの中なら、外へ移す - plistやスクリプトに、nvmのNodeのパスが直接書かれていないか。
grep -rn "nvm/versions/node" ~/Library/LaunchAgentsで探せます。自作スクリプトの置き場所にも同じgrepをかけます(今回は関連動画のスクリプトにもありました) - 書き換えたら
bootout→bootstrapで読み込み直して、curlなどで本当に応答するか確かめる
古いNodeは、すぐには消してません。
今回は22.23.5を残しておいて、夜の自動化が26で動いたのを見てから、翌日に消しました。
パスの直書きが残ってると、消した瞬間に止まるので・・・。