Claude Code の OAuth 期限切れ：無人実行の復旧方法
2026-10-26 時点で、無人実行の claude -p、cron、CI では、保存済みのログインが期限切れで更新できなくなると、モデルへの各リクエストが Login expired で失敗します。CI とスクリプト向けに公式ドキュメントが示すのは、claude setup-token で生成する 1 年有効の OAuth トークンです。API キーやゲートウェイ用トークンで認証することもできます。
更新日 2026-10-26
1 つのキーで Claude、GPT、主要な中国系モデルを利用でき、トークン単位の課金で、数分で使い始められます。
- トークン単位の課金・最新単価は /models
- カード（Visa / Mastercard / AMEX）・Apple Pay・Google Pay・暗号資産で支払い可能
- チャージ後すぐにセルフサービスで開通
確認するポイント
長期トークンの有効期間
claude setup-token は 1 年有効の OAuth トークンを生成し、CLAUDE_CODE_OAUTH_TOKEN に設定します。公式ドキュメントでは Pro、Max、Team、Enterprise のいずれかのプランが必要です。
期限切れのエラー
保存済みのログインが期限切れになり更新できないと、モデルへの各リクエストは Login expired で失敗します。再ログインするまで続きます。
更新の予告
ログインの期限が切れる 3 日前に、Claude Code は起動時に期限が近いことを知らせ、/login で更新するよう案内します。
ヘッドレスモードの注意
公式ドキュメントによると、--bare は OAuth 認証情報とシステムキーチェーンを読まず、CLAUDE_CODE_OAUTH_TOKEN も読みません。このモードでは ANTHROPIC_API_KEY または apiKeyHelper を使います。
無人実行で使える認証情報
2026-10-26 時点で、公式の authentication ドキュメントは次の認証情報の取得元を挙げています。購読者向けの長期 OAuth トークン（claude setup-token で生成し、CLAUDE_CODE_OAUTH_TOKEN に設定）、Claude Console の API キー（ANTHROPIC_API_KEY に設定し、非対話モードの -p では存在すれば使用）、ゲートウェイ用トークン（ANTHROPIC_AUTH_TOKEN に設定し、Bearer として送信）、動的な認証情報のための apiKeyHelper です。ログインが期限切れになったら、/login で再ログインするか、長期の認証情報に切り替えます。
公式ページの記載
公式の authentication ドキュメントには、ログインの期限が切れる 3 日前に更新を促す表示が出ること、期限切れ後に更新できない場合は各モデルリクエストが Login expired · Please run /login で失敗することが書かれています。/status の Login 行は Expired — log in again と表示されます（Claude Code v2.1.210 以降）。長期トークンは claude setup-token で生成し、Pro、Max、Team、Enterprise のいずれかのプランが必要です。
タイムライン
コミュニティの報告（Zenn、2026-10-23 公開）：Windows のタスクスケジューラが午前 3 時に claude -p を実行し、ログイン期限切れのため起動から約 20 秒で終了しました。認証エラーは OAuth セッションの期限切れで更新できなかったという内容で、終了コードは 1 でした。
このコミュニティ記事（この日に公開）には、無人実行では再ログインの表示を見る人がいないこと、投稿者が 2026-10-18 の朝に気づいて再ログインし、手動で再実行したことが書かれています。記事には、期限切れ後にできるのは手動で再ログインすることだけだと書かれています。
code.claude.com の authentication、headless、CLI reference の各ページと、QCode ドキュメントの environment ページを確認しました。認証情報とエラーの表記は、2026-10-26 時点のこれらのページに従います。
確認済みと未確認
確認済み（公式ページで逐字確認）
公式ドキュメントには、claude setup-token が 1 年有効の OAuth トークンを生成し、Pro、Max、Team、Enterprise のいずれかのプランが必要であること、CLAUDE_CODE_OAUTH_TOKEN が CI とスクリプト向けであること、ANTHROPIC_API_KEY が -p で存在すれば使用されること、ANTHROPIC_AUTH_TOKEN がゲートウェイ向けであること、--bare が OAuth 認証情報、システムキーチェーン、CLAUDE_CODE_OAUTH_TOKEN を読まないこと、/status の Expired 行に v2.1.210 以降が必要であることが書かれています。
未確認・公式未発表
コミュニティの報告（Zenn、2026-10-23 公開）：2026-10-18 の無人実行が、ログイン期限切れのため起動から約 20 秒で終了しました。これはユーザーの報告であり、公式ドキュメントのエラー一覧ではありません。公式ドキュメントには、agent view または Remote Control のバックグラウンドセッションが、認証情報の期限切れ後に進行を止め、再ログインするまで回復しないと書かれています。CI とスクリプト向けには、claude setup-token で生成する長期トークンが示されています。
購読ログインと API 認証情報の選び方
購読ログインと長期トークン
claude setup-token は Claude の購読に紐づく 1 年有効の OAuth トークンを生成します。CI とスクリプトに向いています。--bare モードはこの変数を読みません。
API キーとゲートウェイ用トークン
ANTHROPIC_API_KEY は Claude Console で作成し、-p では存在すれば使用されます。ANTHROPIC_AUTH_TOKEN はゲートウェイやプロキシ向けで、Bearer として送信されます。
トラブルシューティング手順
① エラーと状態を確認します。リクエストが Login expired で失敗する、または /status の Login 行が Expired なら、保存済みのログインが期限切れです。② 対話できる環境ではセッションで /login（またはシェルで claude auth login）を実行して再ログインします。無人マシンでは claude setup-token を使います。/login と同じブラウザ認可フローで、トークンは端末に表示されるだけで保存されないため、コピーして CLAUDE_CODE_OAUTH_TOKEN に設定します。③ スクリプトが --bare を使っている場合は、ANTHROPIC_API_KEY（Claude Console で作成）または apiKeyHelper に切り替えます。--bare は OAuth 認証情報を読みません。④ ゲートウェイ経由なら ANTHROPIC_AUTH_TOKEN を設定します。これは ANTHROPIC_API_KEY より優先されます。⑤ 認証情報を cron / CI の環境変数や secret に保存し、再実行して終了コード 0 を確認します。
QCode のキーで無人実行する
QCode ドキュメントの接続方法は、ANTHROPIC_BASE_URL=https://api.qcode.cc/api と ANTHROPIC_AUTH_TOKEN=QCode のキー（cr_ で始まる）を設定するものです。ドキュメントによると、3 つの接続ドメインは同じ機能を提供し、同じキーが使えます。キーは ANTHROPIC_API_KEY ではなく ANTHROPIC_AUTH_TOKEN に入れ、Claude Code は Bearer として送信します。モデル呼び出しはトークン単位で課金され、モデルごとの単価は /models に記載されています。個人プランは 1 回の購入につき 30 日間有効です。月額プランをご希望でない場合は、クォータパックが $4 から。7 日以内に使い切る一度限りの枠です。個人プランをお使いで枠が足りないときはブースターパックを追加できます。
よくある質問
Claude Code の OAuth トークンが期限切れになると、どんなエラーが出ますか？
公式ドキュメントのエラーは Login expired · Please run /login です。期限が切れる 3 日前には更新を促す表示も出ます。
無人実行の claude -p では、どの認証情報を使えますか？
claude setup-token で生成する 1 年有効の CLAUDE_CODE_OAUTH_TOKEN（購読が必要）、Claude Console の ANTHROPIC_API_KEY、ゲートウェイ用の ANTHROPIC_AUTH_TOKEN です。apiKeyHelper も使えます。
claude setup-token のトークンはどのくらい有効ですか？
公式ドキュメントでは one-year OAuth token、つまり 1 年有効です。Pro、Max、Team、Enterprise のいずれかのプランが必要で、モデルへのリクエストにのみ使えます。
--bare モードで認証に失敗するのはなぜですか？
公式ドキュメントによると、--bare は OAuth 認証情報、システムキーチェーン、CLAUDE_CODE_OAUTH_TOKEN を読みません。このモードでは ANTHROPIC_API_KEY または apiKeyHelper を使ってください。
ログインの期限切れ後、最短で復旧するには？
対話環境では /login で再ログインします。無人マシンでは長期トークンまたは API キーに切り替え、/status の Login 行で現在の認証情報を確認します。
QCode のキーは購読ログインを使いますか？
QCode ドキュメントの接続方法は、ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN の環境変数を設定するもので、キーは cr_ で始まる QCode のキーです。購読の /login ではありません。公式の認証情報の優先順位では、ANTHROPIC_AUTH_TOKEN は購読の /login より上です。
情報源
code.claude.com の authentication、headless、CLI reference ドキュメント（2026-10-26 取得）、Zenn のコミュニティ記事（2026-10-23 公開、ユーザー報告）、QCode ドキュメントの environment と cloud-servers ページ、qcode.cc/pricing と /pay-as-you-go（2026-10-26 取得）、qcode.cc/models。
関連記事
Claude Code クォータパック：サブスク不要・7日有効
枠を一度購入して 7 日以内に使う方式で、サブスクではありません。追加分は同じキーに加算されます。
Claude Code をサブスクなしで使う 2026年10月
Claude のサブスクを買わない場合の、Claude Code のログイン方法と接続方法。
Claude Code クラウドサーバー（2026年10月）：導入
QCode のクラウドサーバーに Claude Code を入れ、QCode のキーでモデルを呼び出します。
暗号資産チャージガイド
9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。
このページの Claude Code に関する事実は 2026-10-26 に code.claude.com の authentication、headless、CLI reference ドキュメントで確認しました。QCode の接続と課金に関する事実は 2026-10-26 に docs.qcode.cc と qcode.cc/pricing で確認しました。モデルの可用性と単価は /models に従います。公式の変更は別途案内されません。