PaPoo
cover

--resume requires a valid session ID or session title when used with --print. が出るときに確認したいこと

このエラーは、--resume に渡した値が Claude Code 側で「有効な session ID でも session title でもない」と判断されたときに出ます。今回の症状クラスタでは、少なくとも 2 つの別ルートが issue として報告されています。

ひとつは #61058 で、claude -p --output-format stream-json --input-format stream-json で生成したセッションが sessions-index.json に登録されず、--resume <title> や対話的な --resume ピッカーから見えないという報告です。もうひとつは #91268 で、セッション管理ツールが返す local_... 形式の ID をそのまま claude --resume に渡すと失敗する、という話です。後者は提示された本文の範囲では、local_ を外した UUID ならどうなるかは断定できません。

実際に issue #61058 では、-p 実行で会話の .jsonl は書き込まれるのに、sessions-index.json は作られないと報告されています。そこでは、直接 UUID を指定した claude --resume <session-id> は動く一方で、タイトル経由の復元や --resume の一覧には出てこない、という整理でした。つまり「履歴ファイルはあるのに、索引がなくて見つからない」状態です。

再現例として issue に載っていたのは次の形です。-pstream-json を使い、あとからプロジェクト配下の *.jsonl は見えるのに、sessions-index.json は見つからない、という確認です。

TD=$(mktemp -d) && cd "$TD"
printf '%s' '{"type":"user","message":{"role":"user","content":"say hi"}}' \
  | claude -p --output-format stream-json --input-format stream-json --verbose

SLUG=$(echo "$TD" | sed 's#/#-#g')
ls   ~/.claude/projects/$SLUG/*.jsonl
test -f ~/.claude/projects/$SLUG/sessions-index.json && echo EXISTS || echo MISSING

issue 本文では、.jsonl は書かれるが sessions-index.jsonMISSING になる、とされています。これが本当に同じ症状なら、--resume がタイトルやピッカー経由で見つからないのは筋が通ります。索引を読めないなら、そこから探せないためです。

一方で #91268 は、セッション管理ツールが返す local_553755dd-186d-4058-a2b5-b528b2483659 のような ID を claude --resume に渡したところ、冒頭のエラーになった、という報告です。ここで見えている事実は、少なくともその local_... 文字列は、そのままでは --resume が受け付けないということです。どう変換すればよいか、あるいは変換不要なのかは、この issue 本文だけでは分かりません。

なので、このエラーに出会ったら、まず次のどちらに近いかを切り分けるのがよさそうです。

前者なら、issue #61058 の報告内容と重なります。後者なら、issue #91268 の報告内容に近いです。少なくとも今回の材料だけでは、どちらも「--resume に渡した文字列が、Claude Code の期待する形と一致していない」ことまでは言えますが、同じ根本原因だとまでは断定できません。

現時点で確認できる範囲では、-pstream-json 経路で sessions-index.json が作られないという報告は issue 上で残っており、解決済みとしては扱われていませんでした。つまり、この種類の症状は「入力した値が悪い」と片づけるより、まずセッションの作られ方と --resume に渡している値を見比べたほうがよさそうです。


検証環境

OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-09-21T08:51:48+09:00

参照した Issue(anthropics/claude-code): #61058, #91268

同じ著者の記事