ログイン切れで夜通しの作業が黙って止まるとき

なぜ起きるのか

Claude のサブスクリプションでログインした Claude Code は、短命のアクセストークンを使い、期限が切れると保存済みのリフレッシュトークンで更新します。更新に失敗すると(サインインが古すぎると拒否される、複数のセッションやデスクトップアプリが同じリフレッシュトークンを取り合う など)、次のリクエストが認証エラーで終わり、そのターンはそこで止まります。目の前にいれば /login 一回で済みますが、夜通し任せた作業は朝までそのままです。

同じ目に遭った人は多くいます: 深夜のログイン切れでサブエージェントが 8.5 時間停止(#104806)、デスクトップアプリが "Authentication failed - sign in again" で止まり遠隔で復旧できない(#106089)、同時セッションがリフレッシュトークンを上書きしてキーチェーンのログインが消える(#88583)、無人ワークフロー向けのトークン更新の要望(#12447)。

自分で備える方法

1. 止まったらすぐ通知を受け取る: API エラーでターンが終わると、Claude Code は StopFailure フックを呼び、入力 JSON の error に authentication_failed などの値を入れます。~/.claude/settings.json に下のように登録し、スクリプトで osascript -e 'display notification "run /login" with title "Claude Code stopped"' を呼べば通知されます。スマホで受け取るには同じスクリプトに curl -d "run /login" https://ntfy.sh/<your-topic> を加えます。そのまま使えるスクリプト: stop-failure-alert.sh。

{ "hooks": { "StopFailure": [ { "matcher": "authentication_failed",
  "hooks": [ { "type": "command", "command": "~/.claude/hooks/stop-failure-alert.sh" } ] } ] } }

限界: Claude Code 2.1.317 で、無効なキーにより authentication_failed がフックに届くところまでは確認しました。実際のサブスクリプションのログインが深夜に切れるケースと、サブエージェントだけが失敗するケースは再現できていません。通知は知らせるだけで、ログインし直してはくれません。

2. 期限切れそのものを減らす: 無人実行が多いなら、claude setup-token で長期の認証トークンを作れます(Claude サブスクリプションが必要)。作ったトークンはパスワードと同じように扱い、シェル履歴やリポジトリに残さないでください。多数の同時セッションとデスクトップアプリは更新を取り合うことがあるので(#88583)、夜通し動かすセッション数を減らすのも効果があります。

Lidnight なら

Lidnight はセットアップ時に Claude Code へ StopFailure フックも入れるので、ログインエラーで終わったセッションを見分けて「ログインが切れて停止: <プロジェクト>」の Mac 通知をすぐ出します(無料。設定の「止まっているかも」通知、初期設定でオン)。フックのない古いセッションや Codex は、会話記録のエラー文(/login、401 など)で判断します。Pro では同じ通知がスマホ(ntfy)にも届きます。使用上限とは区別するので、上限待ちのセッションをログインの問題として知らせることはありません。ログインし直すのはご自身で行ってください。留守中に Claude Code がしたことを確認する