コンテンツにスキップ

cruise を長期トークンで起動する(8 時間の期限で止めない)

対話ログイン(/login)の OAuth のアクセストークンは 8 時間で切れます。更新に失敗すると、 不在のあいだに動いていた cruise が 401 OAuth access token has expired で止まり、/login するまで戻りません (#584。Mac Studio で、朝のログインのちょうど 8 時間後に 401 が集中していました)。

claude setup-token が発行する長期トークンを、cruise を動かす端末でだけ CLAUDE_CODE_OAUTH_TOKEN に入れて起動すると、 この 8 時間の期限を避けられる見込みです。ただし、長期トークンで起動した cruise が 8 時間を超えて止まらないことは、まだ確かめていません (下の「確かめていないこと」)。

長期トークンでは、claude.ai のコネクタ・claude.ai から届くスキル(anthropic-skills:*)・Remote Control・Claude in Chrome が使えません(Claude Code 2.1.316 で測りました。 エラーは出ず、黙って無い・繋がらない形です)。サブエージェントと /code-review(low)は動きました。通知が届くかは判定できていません (下の「機能の表」)。

トークンを置かない場所

長期トークンの有効期間は、発行時に表示される期間が正です(#584 の記録では 1 年。ここでは確かめていません)。 .zshrc・.env・リポジトリ・Claude Code のセッションの中に置かないでください。 置くのは macOS のキーチェーンだけで、読むのは下の起動口だけです。 例外が 1 つあります——cruise の周を claude -p の子プロセスで回す起動口(cruise/scripts/child-cycle.py)は、長期トークンで起動した親の子が 同じトークンで回るように、親のセッションを起動した claude の環境からトークンを読み、子の環境に置きます(値は出力・記録に出しません。#785)。 全部のセッションに効かせると、1 本のトークンをすべてのプロセスに配ることになります。

部品

部品 置き場所(dev-loop スキルの base ディレクトリから) 役割
起動口 scripts/launch-with-long-token.sh キーチェーンからトークンを読み、CLAUDE_CODE_OAUTH_TOKEN に入れて claude を起動する。読めなければ起動せずに理由を出して止まる。--store-token で入れる・入れ替える、--status で入っているかを見る
点検 scripts/check-unattended-env.py 「認証」の行で、長期トークンで起動したか、対話ログイン(8 時間)かを出す。Bash の環境に無ければ、セッションを起動した claude のプロセスの環境を見る(下の 3)

base ディレクトリの場所は オートクルーズ の「部品の一覧」の下を見てください。 起動口が何をし、どこで止まるかは、起動口の冒頭のコメントを正とします(ここは要点だけです)。

手順

1. トークンを発行してキーチェーンに入れる(1 度だけ・入れ替えるとき)

Claude Code のセッションの外の、別の端末で行います。セッションの中(Bash や !)で claude setup-token を打つと、 表示されたトークンがセッションの記録に残ります。

claude setup-token                                   # ブラウザでログイン。表示されたトークンを控える
bash <base>/scripts/launch-with-long-token.sh --store-token   # プロンプトにトークンを貼る
  • --store-token は security add-generic-password -U -a "$USER" -s claude-long-token … -w を走らせます。 -w を最後に置くと値をプロンプトで訊かれる(man security)ので、トークンはシェルの履歴にも引数にも残りません。 プロンプトが入力を画面に出さないかは確かめていません。
  • 入れた日時(UTC)をキーチェーンの項目のコメントに残します。これはトークンの発行日でも期限でもありません—— 期限は手元からは読めません。切れていれば、起動した claude が 401 を出します。そのときはもう一度 1 を行います。
  • 入っているかは --status で見られます(値は読みません)。

2. 起動口で cruise を起動する

bash <base>/scripts/launch-with-long-token.sh "/dev-loop:cruise <親 Issue> --absent"

引数はそのまま claude に渡ります。キーチェーンに無い・値が空・security が無い・macOS でないときは、起動せずに止まります (対話ログインのまま起動すると、気づかないまま 8 時間で止まる状態に戻るためです)。 環境に ANTHROPIC_API_KEY・ANTHROPIC_AUTH_TOKEN があっても止まります——長期トークンより先に使われうるためです。

3. cruise の起動時の点検で確かめる

cruise は起動時に check-unattended-env.py --cruise を回し、「認証」の行を見せます。 対話ログイン(8 時間)で起動していたら、長期トークンで回すかを訊きます(利用者が居ないタイマーの再開では訊きません)。 長期トークンを選ぶと、cruise は 1 と 2 のコマンドを見せて、周を始めずに止まります——起動し直すと台帳から続きます。

長期トークンで起動していても、セッションの Bash の環境(env)には CLAUDE_CODE_OAUTH_TOKEN が見えません(Claude Code 2.1.316 で観測。 起動時のトークンを Bash の環境から外しています)。だから点検は、Bash の環境に無ければ、セッションを起動した claude のプロセスの環境を ps eww で見て、変数の名前があり値が空でないかだけで決めます(値は出しません)。そのプロセスの環境を読めないときは「判定できない」と出し、 対話ログインとは言いません。env の結果で「対話ログインで動いている」と判断しないでください——確かめるのは /status の認証の行か、点検の「認証」の行です。

動いているセッションの認証は、そのセッションの中からは切り替えられません。 トークンは起動した claude の環境変数で、 セッションの中のコマンド(子のプロセス)からは親の環境を変えられないためです。Claude Code に、セッションの途中で認証を入れ替える別の道があるかは確かめていません。

アカウントを分ける(--account)

bash <base>/scripts/launch-with-long-token.sh --account work --store-token
bash <base>/scripts/launch-with-long-token.sh --account work "/dev-loop:cruise <親 Issue> --absent"

アカウントごとにキーチェーンの別の項目(claude-long-token-<名前>)を使います。週の上限に当たったアカウントから 別のアカウントに切り替えて起動し直すためのものです。切り替えるのは利用者で、cruise は切り替えません。

確かめていないこと

次の 3 つのうち、2 と 3 は 2026-11-02 に確かめました(Claude Code 2.1.316)。1 はまだ確かめていません:

  1. 長期トークンで起動した cruise が、起動から 8 時間を超えても 401 で止まらないこと——まだです
  2. cruise で使う機能が、長期トークンで動くか——測りました。結果は下の「機能の表」です。 測っていないのは次の 4 つです: 対話のセッションの中で、端末が使われていないときの通知・対話のセッションの中で /remote-control を打ったときの表示 (起動時の --remote-control だけを見ました)・haiku 以外のモデル(Opus など)でのサブエージェントと、low 以外の effort(high など)の /code-review・ 対話ログインの側にだけ読み込まれた組み込みのプラグイン cc-plugin-sec-default が無いことで、何が変わるか(下の「機能の表」の後)
  3. 点検が、長期トークンで起動したセッションの中で「良い」と出ること——確かめました。起動口で起動したセッションの中から check-unattended-env.py --cruise --present を回し、「認証」が [良い](起動した claude の環境の CLAUDE_CODE_OAUTH_TOKEN)と出ました (#584 のコメント)。 2.1.316 の Bash の環境には CLAUDE_CODE_OAUTH_TOKEN が無いので、点検は起動した claude のプロセスの環境を見ます(上の「3. cruise の起動時の点検で確かめる」)

機能の表

長期トークンで起動した claude と、同じ端末の対話ログイン(Claude Team)の claude を、同じ引数で起こして比べました (Claude Code 2.1.316・-p … --model haiku --permission-mode dontAsk・一時のリポジトリに 1 行の差分)。 Remote Control の行だけは条件が違います——-p ではなく対話の起動で、--remote-control <名前> だけを付け(--model も --permission-mode も付けず、モデルは既定の Opus 5.5)、 信頼済みのリポジトリで疑似端末に 30 秒起こした画面を見ました。起動の引数はファイルに残っておらず、測った側の記録によります。 結果は #584 のコメント です。 ただしこのページのほうを正とします——コメントの前書きの「同じ引数(-p … haiku)」は Remote Control の行に当たらず、 コメントには claude.ai から届くスキルの行と組み込みのプラグインの差が無く、道具の数も 1 つの組の値です(このページは生の出力から数え直しました)。

機能 長期トークン 対照(対話ログイン) 判定
サブエージェント(Agent) 親が指定した文字列を子が返した(子の agentId と、子が使ったトークン数が記録に残る) 同じ 動く
/code-review(low) 小さな差分の誤り(a + b → a - b)を正しく指摘した 同じ 動く(low だけ測った)
claude.ai のコネクタ(/mcp) 起動時の MCP サーバーに claude.ai のサーバーが 0 件・mcp__claude_ai_* の道具が 0 件 6 件(Claude Docs は接続済み)・道具 8 件 使えない(エラーは出ず、黙って無い)
claude.ai から届くスキル(anthropic-skills:*) 起動時のスキルが 37 個で、anthropic-skills:* が 0 個 46 個(anthropic-skills:docs・docx・pdf・pptx・xlsx などの 9 個が多い。--chrome の組では 47 個で、claude-in-chrome のスキルも長期トークンの側に無い) 使えない(エラーは出ず、黙って無い)
Remote Control(--remote-control) 30 秒起こして Remote Control の表示が出ない。見出しの認証は Claude API /rc connecting… → /remote-control is active 使えない(エラーは出ず、黙って繋がらない)
Claude in Chrome(--chrome) 道具 0 件・claude-in-chrome のサーバーなし 道具 22 件・接続済み 使えない
通知(PushNotification) 「Not sent — this terminal is active …」で送らない 同じ文で送らない 判定できない——対照も送らないので、-p の起動では測れない

同じ引数で起こした組どうしでは、MCP を除く道具の一覧は両方で同じでした(組によって 29 個か 31 個)。code-review のスラッシュコマンドも両方にありました。 読み込まれたプラグインは 1 つ違いました——-p のどの組でも、組み込みのプラグイン cc-plugin-sec-default が対話ログインの側にだけあり、長期トークンの側にはありませんでした (9 個と 10 個。ほかは同じ)。これが無いことで何が変わるかは確かめていません(上の「確かめていないこと」の 2)。

Remote Control が繋がらないので、不在のあいだに iPhone から様子を見ることはできません。 通知が iPhone に届くかは判定できていません (-p では対照も送らないので測れず、対話のセッションの中ではまだ測っていません——上の 2)。cruise の周が claude.ai のコネクタ(Claude Docs など)・claude.ai から届くスキル・Claude in Chrome を使うなら、 長期トークンでは黙って無いので、その周は進められません。 長期トークンで回すかは、8 時間で止まることと、これらが使えないことを比べて決めてください。

測り方(利用者が行う)

残っているのは上の「確かめていないこと」の 1 と、2 の測っていない 4 つです(3 は確かめました)。

# 1 と 2 のとおり入れて、新しい端末で起動する
bash <base>/scripts/launch-with-long-token.sh

起動したセッションで:

  • /status——認証の行が CLAUDE_CODE_OAUTH_TOKEN から来ているか
  • 測っていない 4 つ(上の 2)——対話のセッションの中で /remote-control を打ったときの表示・端末を離れているときの iPhone への通知の試し (リモートコントロールの設定手順)・Opus などのモデルでサブエージェントに 1 つ読ませる/小さな差分に low 以外の effort(high など)で /code-review・ cc-plugin-sec-default の有無で何が変わるか

8 時間を超えて止まらないか(上の 1)は、起動口で cruise を起動した時刻を控え、9 時間ほど後に、その間の記録に 401 が無いかを見ます:

grep -l "OAuth access token has expired" ~/.claude/projects/<プロジェクトのディレクトリ>/*.jsonl

StopFailure の hook を登録していれば、~/.claude/usage-limit-stops.jsonl に authentication_failed の行が無いことでも見られます。 結果は #584 に書いてください。

関連