Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

Remote Controlのセッションが古すぎる場合に、再ログインを促す代わりに汎用エラーを表示していた問題を修正しました。

原文（英語） ​

Fixed Remote Control sessions showing a generic error instead of prompting for re-login when the session is too old.

概要 ​

Claude Code v2.1.110では、Remote ControlセッションのトークンやセッションIDが期限切れになった場合に、ユーザーに分かりにくい汎用エラーメッセージが表示されていた問題が修正されました。修正後は、セッションが古すぎると判断された場合に適切な再ログインのプロンプト（メッセージと手順）が表示されるようになり、ユーザーがどのような操作をすべきかが明確になります。

基本的な使い方 ​

bash
# Remote Control に接続する場合
claude remote connect

# セッションが期限切れの場合:
# 修正前: "エラーが発生しました。もう一度お試しください" のような汎用エラー
# 修正後: "セッションが期限切れです。再ログインしてください" と明確なメッセージ
#          → ログイン手順が自動的に表示される

実践例 ​

ユースケース1: 期限切れセッションの処理 ​

bash
# 数日後に Remote Control に接続を試みる
claude remote connect

// 修正前の出力:
// エラー: Unexpected error occurred (code: 401)
// ← ユーザーはこれを見て何をすべきか分からない

// 修正後の出力:
// Remote Control セッションの有効期限が切れています。
// 再ログインが必要です。
//
// 再ログイン方法:
// 1. claude remote login を実行
// 2. ブラウザが開き、claude.ai での認証を完了
// 3. 認証後、自動的に接続が再開されます
//
// 今すぐ再ログインしますか？ [Y/n]:

ユースケース2: 自動再ログインフロー ​

bash
# 期限切れが検出された場合の自動フロー
claude remote connect

# Remote Control が期限切れを検出
# → 再ログインプロンプトが表示
# → ユーザーが Y を入力
# → ブラウザが開く（claude.ai のログインページ）
# → claude.ai でログイン完了
# → 新しいセッションが確立
# → Remote Control に自動接続

ユースケース3: セッション状態の確認 ​

bash
# Remote Control セッションの状態を確認
claude remote status

// 修正後の出力例:
// Remote Control 状態: 接続済み
// セッション有効期限: 2026-05-15 15:30:00
// 接続先: claude.ai

// 期限切れの場合:
// Remote Control 状態: セッション期限切れ
// 最終接続: 2026-04-01 10:00:00（14日前）
// → 再ログインが必要です

ユースケース4: スクリプトでの期限切れ処理 ​

bash
#!/bin/bash
# remote-control-check.sh
# Remote Control のセッション状態を確認して必要なら再ログイン

STATUS=$(claude remote status --json 2>&1)
SESSION_STATUS=$(echo $STATUS | jq -r '.status')

if [ "$SESSION_STATUS" = "expired" ]; then
  echo "Remote Control セッションが期限切れです"
  echo "自動的に再ログイン処理を開始します..."
  claude remote login
elif [ "$SESSION_STATUS" = "connected" ]; then
  echo "Remote Control: 接続中"
else
  echo "Remote Control: 接続されていません"
fi

ユースケース5: セッション管理のベストプラクティス ​

bash
# セッションの有効期限を事前に確認
claude remote status

# セッションが切れる前に手動で更新
claude remote refresh

# セッションをすべてログアウト
claude remote logout

# 新規ログイン
claude remote login

注意点 ​

  • セッション有効期限 — Remote Controlセッションには有効期限があります。期限は通常数週間〜数ヶ月程度です。
  • 自動更新 — アクティブに使用している場合は自動的にセッションが更新されます。長期間使用しない場合に期限切れになります。
  • エラーメッセージの改善 — この修正により、期限切れ以外の認証エラー（ネットワーク問題など）も適切に区別されてメッセージが表示されます。
  • セキュリティ — セッション有効期限はセキュリティのための機能です。期限切れになっても、再ログインするだけで引き続き使用できます。
  • 複数デバイス — 複数のデバイスでRemote Controlを使用している場合、各デバイスでのセッション管理が必要です。

関連情報 ​