Cài đặt PC + Laptop (Windows)

Setup full real-world: nhiều folders, ignore patterns, daily workflow.

Lưu ý

Đây là Windows-side only. Nếu cần sync WSL projects → tiếp theo WSL Native Sync sau khi xong page này.

Kiểm tra trước

• Quick Start đã xong (Syncthing pair 2 máy thành công)
• Quyết định những folder nào sync (vd: ~/.claude/, ~/Documents/, D:/Projects/)
• Backup data quan trọng trước (peace of mind)

Kiến trúc đề xuất

┌──────────────── PC (always-on) ──────────────────┐
│ Windows Syncthing :8384                          │
│ ├─ claude-state    → C:\Users\<user>\.claude\    │
│ ├─ documents       → C:\Users\<user>\Documents\  │
│ └─ public-shared   → D:\Public LAN Folder\       │
└──────────────────────────────────────────────────┘
                      ↕ LAN P2P
┌────────────── Laptop (mobile) ───────────────────┐
│ Windows Syncthing :8384                          │
│ ├─ claude-state                                  │
│ ├─ documents                                     │
│ └─ public-shared                                 │
└──────────────────────────────────────────────────┘

Bước 1: Backup trạng thái hiện tại của Laptop

Cảnh báo

Quan trọng: nếu Laptop đã có ~/.claude/ riêng (conversations cũ), backup trước khi sync overwrites.

# Trên LAPTOP
$timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
$backup = "C:\Users\$env:USERNAME\.claude.bak-$timestamp"
Copy-Item -Recurse "C:\Users\$env:USERNAME\.claude" $backup
Write-Host "✓ Backup saved to: $backup"

# Move existing claude folder để sync overwrite
Move-Item "C:\Users\$env:USERNAME\.claude\projects" "C:\Users\$env:USERNAME\.claude\projects.local-bak"
Move-Item "C:\Users\$env:USERNAME\.claude\skills" "C:\Users\$env:USERNAME\.claude\skills.local-bak"

Sau sync xong, có thể merge từ backup nếu cần files unique chỉ ở Laptop.

Bước 2: Thêm folder vào Syncthing trên PC

1. PC Web UI http://127.0.0.1:8384 → Add Folder

2. Folder 1: claude-state

   • Folder Label: Claude state
   • Folder ID: claude-state
   • Folder Path: C:\Users\<your-user>\.claude
   • Tab Sharing: tick Laptop
   • Tab Ignore Patterns: paste:

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

   • Save

3. Folder 2: documents

   • Folder Path: C:\Users\<your-user>\Documents
   • Sharing: tick Laptop
   • Ignore Patterns:

     **/node_modules
     **/.cache
     **/temp
     **/*.log
     **/.DS_Store

4. Folder 3+: tương tự cho D:\Projects\, etc.

Bước 3: Chấp nhận folder trên Laptop

1. Sau Step 2, Laptop sẽ pop-up notification mỗi folder offer

2. Mỗi notification → click Add:

   • Set Folder Path trên Laptop (mirror với PC)
   • Save

3. Initial sync starts. Monitor qua Web UI → folder card → progress %

Bước 4: Kiểm tra đồng bộ

# Trên Laptop, sau initial sync done

# Check claude-state có conversations
Get-ChildItem "C:\Users\$env:USERNAME\.claude\projects" -Recurse -Filter "*.jsonl" | Measure-Object

# Check skills synced
Get-ChildItem "C:\Users\$env:USERNAME\.claude\skills" -Directory | Measure-Object

Ignore Patterns — kinh nghiệm thực tế

Ignore patterns dùng glob syntax. Em recommend cho từng loại folder:

Code projects

# Build artifacts
**/node_modules
**/dist
**/build
**/.next
**/out
**/coverage

# Dependencies caches
**/.venv
**/venv
**/__pycache__
**/*.pyc

# Per-machine env
**/.env.local
**/.env.development

# IDE / OS junk
**/.vscode
**/.idea
.DS_Store
Thumbs.db
desktop.ini

# Logs + temp
**/*.log
**/tmp
**/temp/

Claude Code (~/.claude/)

# Per-machine session state
session-env
shell-snapshots
file-history
backups
ide

# Cache files
mcp-needs-auth-cache.json
**/.lock

# Temp
**/*.tmp
**/.DS_Store
**/Thumbs.db

Documents (general)

# Application caches
**/.cache
**/temp/

# OS junk
**/.DS_Store
**/Thumbs.db
**/desktop.ini

# Logs
**/*.log

Đồng bộ OAuth token — lưu ý

Một số files chứa auth tokens (vd ~/.claude/.credentials.json):

Cảnh báo

Trade-off khi sync OAuth tokens:

Pros: 2 máy login same account, không phải re-auth Cons: 1 máy refresh token → máy kia có thể bị invalidate Recommend: Sync OK nếu chỉ work 1 máy at a time. Avoid khi 2 người cùng dùng 2 máy đồng thời.

Quy trình hàng ngày tối ưu

Switch máy

1. Trên máy đang dùng: đóng app đang write file (vd Antigravity, IDE)
2. Đợi 30s cho Syncthing flush
3. Mở máy kia → tiếp tục work

Đi xa, tắt PC

1. Tắt PC ở nhà (off LAN)
2. Laptop work tiếp, edit nhiều files — Syncthing queue changes
3. Về nhà bật PC → 2 máy auto pair lại → resume sync

Conflict file

Syncthing tạo file *.sync-conflict-<date>-<deviceID>.<ext> khi 2 máy edit cùng file lúc 1 máy offline. Cách handle:

1. Mở cả 2 versions, compare
2. Quyết bản đúng, copy nội dung sang file gốc
3. Xóa file .sync-conflict-*

Tạm dừng / Tiếp tục đồng bộ

Đôi khi cần pause:

# API key trong config.xml
$apiKey = (Select-String -Path "C:\Users\$env:USERNAME\AppData\Local\Syncthing\config.xml" -Pattern "<apikey>([^<]+)").Matches.Groups[1].Value

# Pause folder
Invoke-RestMethod -Uri "http://127.0.0.1:8384/rest/db/pause?folder=claude-state" -Method Post -Headers @{"X-API-Key"=$apiKey}

# Resume folder
Invoke-RestMethod -Uri "http://127.0.0.1:8384/rest/db/resume?folder=claude-state" -Method Post -Headers @{"X-API-Key"=$apiKey}

Hoặc Web UI → folder → click pause icon.

Tự khởi động Syncthing khi đăng nhập

Task Scheduler (recommended)

# Create scheduled task to run Syncthing on logon
$binary = (Get-ChildItem "C:\Users\$env:USERNAME\AppData\Local\Microsoft\WinGet\Packages\Syncthing.Syncthing*" -Filter "syncthing.exe" -Recurse | Select-Object -First 1).FullName

$action = New-ScheduledTaskAction -Execute $binary -Argument "serve --no-browser"
$trigger = New-ScheduledTaskTrigger -AtLogOn -User "$env:USERNAME"
$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -Hidden
Register-ScheduledTask -TaskName "Syncthing Daemon" -Action $action -Trigger $trigger -Settings $settings

Startup folder

Tạo shortcut syncthing.exe (with arg serve --no-browser) trong:

shell:startup (Win+R → paste shell:startup → Enter)

Auto-run on Windows login.

Bước tiếp theo

PC + Laptop đã sync OK qua Windows. Tiếp theo:

• WSL Native Sync ⭐ — nếu bạn dùng WSL Ubuntu
• Sync Claude Code state — use case cụ thể
• Troubleshooting — fix khi sync fail