# 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=`（`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+、依存なし） ```js // 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 は叩きすぎない。 ```js // hook ランチャー（例） import { spawn } from 'node:child_process'; const c = spawn(process.execPath, ['/purge-remote-sessions.mjs'], { detached: true, windowsHide: true, stdio: 'ignore' }); c.on('error', () => {}); c.unref(); ``` `settings.json`: ```json { "hooks": { "SessionStart": [{ "hooks": [{ "type": "command", "command": "node /launcher.mjs", "timeout": 5, "async": true }] }] } } ``` ## 検証手順 1. `--dry-run` で対象件数とタイトルを確認する 2. 本実行後に再度一覧を取得し、`status: active` の件数が対象件数ぶん減ったことを確認する（read-back） 3. スマホアプリの一覧を開き直して反映を目視確認する ## 実績 1 アカウントで未アーカイブ 120 件 → 27 件（93 件アーカイブ、失敗 0）。会話はアーカイブ済みとしてサーバーに残る。 ---