Đồng bộ trạng thái Claude Code

Use case: bạn dùng Claude Code (CLI hoặc VSCode/Antigravity extension) trên cả PC + Laptop. Muốn:

• Conversations history available cả 2 máy
• Memory rules (auto-loaded mọi session) sync
• Custom skills sync
• MCP servers config (vd n8n-mcp, playwright) cùng config
• OAuth tokens không phải re-login mỗi máy

Claude Code lưu file ở đâu

• Thư mục~/

  • Thư mục.claude/ → sync toàn bộ folder này

    • Thư mụcprojects/

      • Thư mục<project-slug>/

        • *.jsonl (conversations history)
        • Thư mụcmemory/

          • MEMORY.md (index)
          • feedback_*.md
          • reference_*.md
    • Thư mụcskills/ (140+ default + custom)

      • …
    • .credentials.json (OAuth tokens — sync OK risk acceptable)
    • settings.json
    • Thư mụcsession-env/ → ❌ KHÔNG sync (per-machine)

      • …
    • Thư mụcshell-snapshots/ → ❌ KHÔNG sync (per-machine)

      • …
  • .claude.json → sync separately (mcpServers, OAuth account info)

Cài đặt đồng bộ ~/.claude/

Như Setup Windows Step 2:

Folder ID + Path

Folder ID: claude-state
Folder Path PC: C:\Users\<user>\.claude
Folder Path Laptop: C:\Users\<user>\.claude

Ignore Patterns

session-env
shell-snapshots
file-history
backups
ide
mcp-needs-auth-cache.json
**/.lock
**/*.tmp
**/.DS_Store
**/Thumbs.db

Đồng bộ ~/.claude.json (file đơn)

⚠ Syncthing không sync single file — chỉ folder. Có 2 options:

Manual copy via shared folder

Copy ~/.claude.json vào folder đã sync (vd D:\Public LAN Folder\_sync\):

# Trên PC, copy tới shared folder
Copy-Item "$env:USERPROFILE\.claude.json" "D:\Public LAN Folder\_sync\claude-config.json" -Force

# Trên Laptop sau sync, copy về vị trí chuẩn
Copy-Item "D:\Public LAN Folder\_sync\claude-config.json" "$env:USERPROFILE\.claude.json" -Force

Manual update khi MCP config thay đổi.

Symlink wrapper folder

Tạo wrapper folder ~/.claude-shared/ chứa file → symlink về vị trí gốc:

# Tạo wrapper (run as admin cho symlink)
New-Item -ItemType Directory "$env:USERPROFILE\.claude-shared" -Force
Move-Item "$env:USERPROFILE\.claude.json" "$env:USERPROFILE\.claude-shared\claude.json"
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.claude.json" -Target "$env:USERPROFILE\.claude-shared\claude.json"

Add Syncthing folder pointing ~/.claude-shared/.

OAuth token — đồng bộ hay không?

~/.claude/.credentials.json chứa Anthropic OAuth accessToken + refreshToken (108 chars each).

Cảnh báo

Sync OK nếu bạn chỉ work 1 máy at a time.

Risk: nếu 1 máy refresh token → invalidate trên máy kia. Hiếm vì refreshToken durable.

Mitigation: sync OAuth, accept risk re-login đôi khi.

Kiểm tra sau khi đồng bộ

# Conversations available
ls ~/.claude/projects/<your-project-slug>/*.jsonl | wc -l

# Memory rules persist
cat ~/.claude/projects/<your-project-slug>/memory/MEMORY.md

# Skills installed
ls ~/.claude/skills | wc -l    # Expect 130+ if custom skills

# MCP servers config
claude mcp list                  # Or check ~/.claude.json

Cách switch máy đúng

1. Đóng Claude Code 1 máy trước khi mở máy kia (tránh .jsonl file lock)

2. Đợi 30s cho Syncthing flush changes

3. Mở máy kia → conversations mới nhất available

Mẹo

Memory rules auto-load mỗi session. Sau sync, agent trên máy mới đọc cùng rules → behavior consistent.

Pro tip: viết memory rules cụ thể về setup (vd “Anh dùng PC + Laptop sync. n8n stack chỉ chạy trên PC, laptop access via URL.”) → agent tự biết context.

Bước tiếp theo

• Sync code projects — multiple project folders
• AI agent prompts — autonomous setup via Claude
• Troubleshooting — fix sync issues