Claude Desktop の
サイドバーを日本語化する

Claude Desktop の Recents サイドバーに表示されるセッションタイトルを、Windows 環境で自動日本語化するセットアップをして欲しいです。

実証済みの Windows 用構成です。1 名の Windows ユーザー (Git Bash + winget jq) で動作確認済みですが、環境差で動かないケースもあるので、必ず段階テストしてから進めてください。

## ⚠️ 重大な注意: 安全策を必ず実施

Qiita で `%APPDATA%\Claude\claude-code-sessions\` の JSON を直接編集して過去スレッドが消失した事例があります。下記の順序を厳守してください:

1. **Claude Desktop を完全終了** (タスクトレイの Claude アイコン右クリック → Quit、Task Manager で残プロセス無いか確認)
2. `%APPDATA%\Claude\` を zip で全体バックアップ
3. **手動 1 件だけ** スクリプトをテスト
4. UI で反映確認 + 健全性確認
5. **複数回問題なく動いてから** hook を settings.json に自動登録
6. 万一壊れたら zip から復元

## やってほしいこと (順番に)

### 1. 環境探索

Git Bash を経由してすべて確認してください (PowerShell では一部見えないケースあり):

```bash
# シェルと OS 確認
uname -s   # MINGW64_NT-... が出れば Git Bash
ver        # Windows のバージョン

# claude CLI のパス
where.exe claude    # PowerShell スタイル
command -v claude   # Git Bash スタイル

# jq の有無
where.exe jq        # 無ければ後で winget install

# python3 は Windows ストアのスタブを踏むので、tr で代替する (確認不要)

# Claude Desktop データの実パス
# %APPDATA% は OneDrive リダイレクトで PowerShell から見えないケースがあるので、Git Bash の cygpath で確認
cygpath -u "$APPDATA"
ls "$(cygpath -u "$APPDATA")/Claude/claude-code-sessions" 2>/dev/null | head -5
# もし見えなければ、find で広く探す:
find /c/Users -name "claude-code-sessions" -type d 2>/dev/null | head -3
```

### 2. jq の準備 (未インストールなら)

`where.exe jq` で見つからなければ、ユーザーに **PowerShell (管理者不要)** で以下を実行してもらう:

```powershell
winget install jqlang.jq
```

完了後、Git Bash で jq の実パスを取得:

```bash
JQ_WIN=$(where.exe jq 2>/dev/null | head -1 | tr -d '\r')
JQ=$(cygpath -u "$JQ_WIN")
"$JQ" --version  # 動けば OK
```

### 3. Claude Desktop の完全終了 + バックアップ

ユーザーに以下を依頼:
1. タスクトレイ (画面右下) の Claude アイコンを右クリック → Quit
2. Task Manager (Ctrl+Shift+Esc) で Claude 関連プロセスが残ってないか確認

その後 Git Bash で:

```bash
BACKUP_NAME="Claude-backup-$(date +%Y%m%d%H%M%S)"
# OneDrive を使ってる場合は OneDrive 配下に、そうでなければ Desktop に
BACKUP_DEST="$(cygpath -u "$USERPROFILE")/Desktop/$BACKUP_NAME"
APPDATA_UNIX=$(cygpath -u "$APPDATA")
cp -r "$APPDATA_UNIX/Claude" "$BACKUP_DEST"
echo "完了: $BACKUP_DEST"
ls "$BACKUP_DEST" | head -5
```

PowerShell の `Compress-Archive` でも良いが、OneDrive リダイレクトで `$env:APPDATA` が違うパスを返すケースがあるため、**Git Bash の `cp -r` を推奨**。

### 4. スクリプトを作成

`%USERPROFILE%\.claude\hooks\rename-session-title.sh` を以下の内容で作成 (Git Bash 経由で改行コード LF 維持):

```bash
#!/usr/bin/env bash
# Windows (Git Bash) 用: Claude Desktop の全 local_*.json を走査し、
# title が英語のものを claude -p haiku で日本語化する。

set -uo pipefail

LOG="$HOME/.claude/hooks/rename-session-title.log"
mkdir -p "$(dirname "$LOG")"
log() { printf '[%s] %s\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$*" >> "$LOG"; }

if [ "${CLAUDE_RENAME_HOOK_ACTIVE:-}" = "1" ]; then exit 0; fi
export CLAUDE_RENAME_HOOK_ACTIVE=1

log "=== hook fired (pid=$$) ==="

# Windows (Git Bash) 判定
case "$(uname -s)" in
  MINGW*|MSYS*|CYGWIN*) : ;;
  *) log "ERROR this script requires Git Bash on Windows (uname=$(uname -s))"; exit 0 ;;
esac

# jq の解決 (PATH に無くても where.exe で探す)
JQ=""
if command -v jq >/dev/null 2>&1; then
  JQ=$(command -v jq)
else
  JQ_WIN=$(where.exe jq 2>/dev/null | head -1 | tr -d '\r')
  [ -n "$JQ_WIN" ] && JQ=$(cygpath -u "$JQ_WIN")
fi
if [ -z "$JQ" ] || ! "$JQ" --version >/dev/null 2>&1; then
  log "ERROR jq not found. Install via PowerShell: winget install jqlang.jq"
  exit 0
fi

# claude CLI の解決
CLAUDE_BIN=$(command -v claude 2>/dev/null)
if [ -z "$CLAUDE_BIN" ]; then
  log "ERROR claude CLI not found in PATH"
  exit 0
fi

# tr で非 ASCII 判定 (python3 不要)
is_non_ascii() {
  [ -n "$(printf '%s' "$1" | tr -d '\000-\177')" ]
}

INPUT=$(cat 2>/dev/null || true)
SID=$(printf '%s' "$INPUT" | "$JQ" -r '.session_id // empty' 2>/dev/null || echo "")
EVENT=$(printf '%s' "$INPUT" | "$JQ" -r '.hook_event_name // empty' 2>/dev/null || echo "")
log "event=$EVENT session_id=$SID jq=$JQ claude=$CLAUDE_BIN"

# セッション保存先 (cygpath で APPDATA を Unix 形式に)
SESSIONS_DIR="$(cygpath -u "$APPDATA")/Claude/claude-code-sessions"
[ -d "$SESSIONS_DIR" ] || { log "no sessions dir at $SESSIONS_DIR"; exit 0; }

# ロック (時間ベースのみ: Windows では kill -0 が不安定なため PID 判定は使わない)
LOCKDIR="$HOME/.claude/hooks/.rename.lock.d"
if [ -d "$LOCKDIR" ]; then
  if [ -n "$(find "$LOCKDIR" -maxdepth 0 -mmin +10 2>/dev/null)" ]; then
    rm -rf "$LOCKDIR"; log "removed stale lock by age (>10min)"
  else
    log "lock held, skipping"; exit 0
  fi
fi
mkdir "$LOCKDIR" 2>/dev/null || { log "lock acquire failed, skipping"; exit 0; }
trap 'rm -rf "$LOCKDIR"' EXIT

COUNT=0
SCANNED=0
while IFS= read -r -d '' f; do
  SCANNED=$((SCANNED+1))
  TITLE=$("$JQ" -r '.title // empty' "$f" 2>/dev/null)
  [ -n "$TITLE" ] || continue

  # 既に非 ASCII (= 日本語) ならスキップ
  if is_non_ascii "$TITLE"; then continue; fi

  log "translating: $TITLE  ($f)"

  PROMPT="次の英語のセッションタイトルを、自然で簡潔な日本語に翻訳してください。
ルール:
- タイトルだけを1行で返す
- 引用符・前置き・補足説明は不要
- 20文字以内を目安に
- **半英半日のミックスを避け、完全な日本語タイトルにする** (自然さ最優先)
- 動物名・地名・人名・一般的なサービス名は日本語/カタカナにする
  例: Scottish Fold cats → スコティッシュフォールド猫、Tokyo → 東京
- コマンド・ファイル名・拡張子・技術用語のみ原文維持
  例: \`git rebase\`、\`file.json\`、\`npm install\` は英語のまま

タイトル: $TITLE"

  # Git Bash の GNU sed は UTF-8 を正しく扱うが、念のため strip は ASCII 範囲のみ
  JP_TITLE=$("$CLAUDE_BIN" -p --model haiku "$PROMPT" </dev/null 2>>"$LOG" \
    | tr -d '\r' \
    | head -1 \
    | sed -E 's/^[[:space:]"'\'']+//; s/[[:space:]"'\'']+$//')

  [ -n "$JP_TITLE" ] || { log "  empty result, skip"; continue; }
  [ ${#JP_TITLE} -le 200 ] || { log "  too long, skip"; continue; }

  if ! is_non_ascii "$JP_TITLE"; then
    log "  ascii result, skip: $JP_TITLE"; continue
  fi

  TMP="${f}.tmp.$$"
  if "$JQ" --arg t "$JP_TITLE" '.title = $t | .titleSource = "user"' "$f" > "$TMP" 2>>"$LOG"; then
    if "$JQ" -e '.sessionId and .cliSessionId and (.title != null)' "$TMP" >/dev/null 2>&1; then
      BACKUP_DIR="$HOME/.claude/hooks/backup/$(date '+%Y-%m-%d')"
      if ! mkdir -p "$BACKUP_DIR" 2>>"$LOG"; then
        rm -f "$TMP"; log "  backup dir creation failed, aborting"; continue
      fi
      BACKUP_FILE="$BACKUP_DIR/$(basename "$f")"
      if [ ! -f "$BACKUP_FILE" ]; then
        if ! cp "$f" "$BACKUP_FILE" 2>>"$LOG"; then
          rm -f "$TMP"; log "  backup failed, aborting"; continue
        fi
      fi
      if mv "$TMP" "$f" 2>>"$LOG"; then
        log "  -> $JP_TITLE  file=$f  backup=$BACKUP_FILE"
        COUNT=$((COUNT+1))
      else
        rm -f "$TMP"; log "  mv failed, original not overwritten"
      fi
    else
      rm -f "$TMP"; log "  health check failed, skipping"
    fi
  else
    rm -f "$TMP"; log "  jq failed"
  fi
done < <(find "$SESSIONS_DIR" -name "local_*.json" -print0 2>/dev/null)

log "done. scanned=$SCANNED translated=$COUNT"
exit 0
```

ファイル作成時の注意:
- 改行コードは **LF** (CRLF だと Git Bash で `bad interpreter` エラー)
- BOM 無し
- 実行権限は Git Bash 経由なら `chmod +x` 不要 (NTFS の制約)

### 5. 手動テスト (重要、まだ hook 登録しない)

```bash
# Claude Desktop を起動した状態でも未起動でも OK
bash "$HOME/.claude/hooks/rename-session-title.sh" <<< '{"session_id":"manual-test","hook_event_name":"Stop"}'
tail -20 "$HOME/.claude/hooks/rename-session-title.log"
```

ログに `translated=N` (N >= 1) が出れば 1 件以上翻訳成功。

### 6. UI 確認

1. Claude Desktop を起動
2. Recents サイドバーで英語タイトルが日本語化されているか確認
3. 該当セッションをクリック → 日本語タイトルのまま維持されるか確認 (`titleSource: "user"` が効いてるか)
4. JSON の健全性確認:
   ```bash
   "$JQ" '.title, .titleSource, .sessionId' "$(find "$SESSIONS_DIR" -name 'local_*.json' | head -1)"
   ```

### 7. CLAUDE.md に指示を追記

`%USERPROFILE%\.claude\CLAUDE.md` の末尾に以下を追記 (既存セクションあれば内容更新、重複追記しない):

```
## セッションタイトル
新しいセッションのタイトル / 会話のタイトルは必ず日本語で生成してください。
```

### 8. hook 登録 (settings.json) — テスト OK のときだけ

`%USERPROFILE%\.claude\settings.json` の `hooks.Stop` と `hooks.SessionStart` に登録 (冪等マージ):

```bash
HOOK_CMD="$(cygpath -u "$USERPROFILE")/.claude/hooks/rename-session-title.sh"
SETTINGS="$HOME/.claude/settings.json"

[ -f "$SETTINGS" ] && cp "$SETTINGS" "$SETTINGS.bak.$(date +%s)"
[ -f "$SETTINGS" ] || echo '{}' > "$SETTINGS"

"$JQ" --arg cmd "$HOOK_CMD" '
  .hooks = (.hooks // {}) |
  .hooks.Stop = (
    (.hooks.Stop // [])
    | map(.hooks = ((.hooks // []) | map(select(.command != $cmd))))
    | map(select((.hooks // []) | length > 0))
  ) |
  .hooks.SessionStart = (
    (.hooks.SessionStart // [])
    | map(.hooks = ((.hooks // []) | map(select(.command != $cmd))))
    | map(select((.hooks // []) | length > 0))
  ) |
  .hooks.Stop += [{
    "hooks": [{ "type": "command", "command": $cmd, "async": true, "timeout": 120 }]
  }] |
  .hooks.SessionStart += [{
    "hooks": [{ "type": "command", "command": $cmd, "async": true, "timeout": 120 }]
  }]
' "$SETTINGS" > "$SETTINGS.tmp" && mv "$SETTINGS.tmp" "$SETTINGS"
```

### 9. Claude Desktop 完全終了 → 再起動 → 確認

タスクトレイ → Quit → Task Manager 確認 → 再起動。Recents サイドバーが全部日本語タイトルになっていれば成功。

### 10. 完了報告

ユーザーに以下を伝えてください:
- セットアップ完了
- バックアップ場所: `%USERPROFILE%\Desktop\Claude-backup-YYYYMMDDHHMMSS\`
- ログ場所: `%USERPROFILE%\.claude\hooks\rename-session-title.log` (Git Bash で `tail -f` で監視可能)
- 今後新しいセッションが英語タイトルで作られた場合、Stop / SessionStart のタイミングで自動日本語化される