Claude アプリ（スマホ／Web）の「Code」一覧に溜まる古い Remote Control セッションを自動アーカイブする

症状

Claude Code の Remote Control を使っていると、スマホアプリや claude.ai の「Code」一覧に「切断済み」のセッションが溜まり続ける。PC 側の会話ログ（~/.claude/projects/**/*.jsonl）を削除・退避しても、この一覧はサーバー側の記録なので減らない。

解決の要点

Claude Code 本体が内部で使っているセッション API で、古いセッションをアーカイブする（一覧から隠れるだけで会話は消えない）。

• 一覧: GET https://api.anthropic.com/v1/code/sessions?limit=100&cursor=<next_cursor>（data[] と next_cursor）
• アーカイブ: POST https://api.anthropic.com/v1/code/sessions/{id}/archive（body {}。200 = 成功、409 = 既にアーカイブ済み）
• ヘッダ:
  • Authorization: Bearer <~/.claude/.credentials.json の claudeAiOauth.accessToken>
  • anthropic-version: 2023-06-01
  • anthropic-beta: ccr-byoc-2025-07-29
  • x-organization-uuid: <~/.claude.json の oauthAccount.organizationUuid>
• 判定に使うフィールド: status（active / archived）、connection_status（connected / disconnected）、last_event_at、title

注意: 公開ドキュメントのない内部 API。Claude Code 本体（claude 実行ファイル）の文字列から特定したもので、将来変わりうる。失敗しても何もしない作りにする。

安全な対象条件

status !== 'archived' かつ connection_status === 'disconnected' かつ last_event_at から 24 時間以上。 接続中や直近のセッションは作業中の可能性があるので触らない。

スクリプト（Node 18+、依存なし）

// purge-remote-sessions.mjs  — node purge-remote-sessions.mjs [--dry-run]
import fs from 'node:fs'; import os from 'node:os'; import path from 'node:path';
const home = os.homedir(), root = path.join(home, '.claude');
const json = (f, d = {}) => { try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return d; } };
const COOLDOWN = 6 * 3600e3, STALE = 24 * 3600e3, BASE = 'https://api.anthropic.com';
const dry = process.argv.includes('--dry-run'), now = Date.now();
const stateFile = path.join(root, 'purge-remote-sessions-state.json');
if (!dry && now - (json(stateFile).at ?? 0) < COOLDOWN) process.exit(0);
const token = json(path.join(root, '.credentials.json')).claudeAiOauth?.accessToken;
const org = json(path.join(home, '.claude.json')).oauthAccount?.organizationUuid;
if (!token || !org) process.exit(0);
if (!dry) fs.writeFileSync(stateFile, JSON.stringify({ at: now }));
const h = { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json', 'anthropic-version': '2023-06-01',
  'anthropic-beta': 'ccr-byoc-2025-07-29', 'x-organization-uuid': org };
const all = []; let cursor = '';
for (let i = 0; i < 30; i++) {
  const q = new URLSearchParams({ limit: '100', ...(cursor && { cursor }) });
  const r = await fetch(`${BASE}/v1/code/sessions?${q}`, { headers: h, signal: AbortSignal.timeout(15e3) });
  if (!r.ok) process.exit(0);
  const j = await r.json(); all.push(...(j.data ?? []));
  if (!j.next_cursor || !(j.data ?? []).length) break; cursor = j.next_cursor;
}
const stale = (s) => { const t = Date.parse(s.last_event_at ?? s.updated_at ?? s.created_at);
  return s.status !== 'archived' && s.connection_status === 'disconnected' && now - t >= STALE; };
const targets = all.filter(stale);
if (dry) { console.log(targets.length, targets.map((s) => (s.title ?? '').split('\n')[0]).slice(0, 20)); process.exit(0); }
let ok = 0;
for (const s of targets) {
  const r = await fetch(`${BASE}/v1/code/sessions/${encodeURIComponent(s.id)}/archive`, { method: 'POST', headers: h, body: '{}' });
  if (r.status === 200 || r.status === 409) { ok++; fs.appendFileSync(path.join(root, 'archived-remote-sessions.jsonl'),
    JSON.stringify({ id: s.id, title: (s.title ?? '').split('\n')[0].slice(0, 60), at: new Date(now).toISOString() }) + '\n'); }
}
console.log(`archived ${ok}/${targets.length}`);

自動化

Claude Code の SessionStart / Stop hook から detached で起動する（hook をブロックしない）。6時間のクールダウンがあるので、毎回発火しても API は叩きすぎない。

// hook ランチャー（例）
import { spawn } from 'node:child_process';
const c = spawn(process.execPath, ['<path>/purge-remote-sessions.mjs'], { detached: true, windowsHide: true, stdio: 'ignore' });
c.on('error', () => {}); c.unref();

settings.json:

{ "hooks": { "SessionStart": [{ "hooks": [{ "type": "command", "command": "node <path>/launcher.mjs", "timeout": 5, "async": true }] }] } }

検証手順

1. --dry-run で対象件数とタイトルを確認する
2. 本実行後に再度一覧を取得し、status: active の件数が対象件数ぶん減ったことを確認する（read-back）
3. スマホアプリの一覧を開き直して反映を目視確認する

実績

1 アカウントで未アーカイブ 120 件 → 27 件（93 件アーカイブ、失敗 0）。会話はアーカイブ済みとしてサーバーに残る。