Cài Claude Code + Obsidian
trên nhiều máy tính

Bạn sẽ đồng bộ những gì?

Khi làm việc trên nhiều máy, có 4 thứ cần "đi theo" bạn. Mỗi thứ đồng bộ bằng một con đường riêng — hiểu rõ chỗ này thì làm đâu trúng đó:

Chuẩn bị trước khi bắt đầu

Trên mỗi máy mới, bạn cần sẵn sàng các tài khoản và công cụ sau. Đăng nhập cùng tài khoản với máy cũ thì mọi thứ mới gặp nhau.

• ✅ Tài khoản Claude (Anthropic) — cùng email đang dùng ở máy cũ.
• ✅ Tài khoản Obsidian có gói Obsidian Sync (~$4–5/tháng) — nếu chưa có, mua tại obsidian.md/sync.
• ✅ Node.js 18+ và Git — nền để cài Claude Code (hướng dẫn cho cả Mac & Windows ngay dưới).
• 🔶 NÂNG CAO Tài khoản GitHub + Google Drive (cùng email với máy cũ).

🍎 Trên máy Mac — cài Homebrew & Node.js

# 1) Cài Homebrew (trình quản lý phần mềm cho Mac)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2) Cài Node.js (kèm npm) + Git
brew install node git

# 3) Kiểm tra — cần Node v18 trở lên
node -v
npm -v
git --version

🪟 Trên máy Windows — cài Node.js & Git

Mở PowerShell (bấm Start → gõ "PowerShell" → Enter) rồi chạy:

# Cài Node.js LTS + Git bằng winget (có sẵn trên Windows 10/11)
winget install OpenJS.NodeJS.LTS
winget install Git.Git

# ĐÓNG PowerShell rồi mở lại, sau đó kiểm tra:
node -v
git --version

Đưa Obsidian Vault về máy 2

Đây là phần quan trọng nhất với người làm note. Obsidian Sync sẽ tự kéo toàn bộ vault (note, wiki, tài liệu) từ máy 1 về máy 2 — không cần copy tay.

Cài & đăng nhập Claude Code

Claude Code là "trợ lý lập trình + trợ lý vận hành" chạy ngay trong Terminal. Cài một lệnh, đăng nhập một lần là dùng được.

# Cách 1 — cài qua npm (khuyên dùng)
npm install -g @anthropic-ai/claude-code

# Kiểm tra cài thành công
claude --version

# 🍎 Mac
curl -fsSL https://claude.ai/install.sh | bash

# 🪟 Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

# 🍎 Mac
cd ~/Documents

# 🪟 Windows
cd $env:USERPROFILE\Documents

# Rồi mở Claude và đăng nhập
claude
# Trong Claude, gõ:
/login

Kiểm tra: đã đồng bộ chưa?

Đến đây, với mức cơ bản bạn đã làm việc được 2 máy. Thử nhanh:

• ✅ Mở Obsidian máy 2 → thấy đủ note như máy 1.
• ✅ Sửa 1 note trên máy 1 → vài giây sau máy 2 cập nhật theo.
• ✅ Mở Terminal, gõ claude → trò chuyện được, không đòi đăng nhập lại.

Két sắt Git — lịch sử & tua ngược

Obsidian Sync giữ bản mới nhất, nhưng nếu lỡ xoá nhầm hay muốn xem "tháng trước file này thế nào" thì cần Git — một két sắt ghi lại mọi thay đổi, tự sao lưu lên GitHub mỗi tối.

# Tạo key mới (đặt tên gợi nhớ theo máy)
ssh-keygen -t ed25519 -C "macbook-cas" -f ~/.ssh/github-cas

# In khoá công khai ra để copy
cat ~/.ssh/github-cas.pub

# Tạo key mới (Enter 3 lần để bỏ qua passphrase)
ssh-keygen -t ed25519 -C "pc-windows-cas" -f "$env:USERPROFILE\.ssh\github-cas"

# In khoá công khai ra để copy
Get-Content "$env:USERPROFILE\.ssh\github-cas.pub"

# Tạo/sửa file ~/.ssh/config
cat >> ~/.ssh/config <<'EOF'

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/github-cas
EOF

# Kiểm tra kết nối
ssh -T git@github.com

# Bật ssh-agent (chạy PowerShell với quyền Administrator)
Set-Service ssh-agent -StartupType Automatic
Start-Service ssh-agent

# Khai báo key trong file config
@"

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/github-cas
"@ | Add-Content "$env:USERPROFILE\.ssh\config"

# Kiểm tra kết nối
ssh -T git@github.com

cd ~/Documents
git clone git@github.com:<tài-khoản>/<tên-repo>.git "Brain to Letandao"

# 🌅 ĐẦU buổi làm — kéo bản mới nhất về (chạy giống nhau trên Mac & Windows)
git pull

# 🌙 CUỐI buổi làm — đẩy việc của mình lên
git add -A
git commit -m "cập nhật ngày ..."
git push

git log -1 --format="Lần lưu gần nhất: %cd"

Đừng đưa gì vào két sắt Git

Đây là phần ít ai nói nhưng dễ vỡ trận nhất. Git sinh ra để quản chữ (note, code, cấu hình) — không phải để chứa file nặng. Nhồi media vào là repo phình, push mãi không xong, và mỗi máy mới phải kéo về hàng GB.

Bảng phân loại: cái gì đi đường nào

Dựng "hàng rào" .gitignore

Tạo file tên .gitignore ngay trong thư mục vault, nội dung:

# --- Bí mật: TUYỆT ĐỐI không lên git ---
.secrets/
.env
**/.env
.claude/settings.local.json

# --- Media nặng: để trên Google Drive ---
*.mp4
*.mov
*.wav
*.m4a
*.bin

# --- Rác máy tính ---
node_modules/
.DS_Store
Thumbs.db
*.log

# Liệt kê file > 50MB trong thư mục (GitHub cảnh báo >50MB, CHẶN >100MB)
find . -type f -not -path './.git/*' -size +50M -exec ls -lh {} \; | awk '{print $5, $9}'

git rm --cached "đường/dẫn/file-nang.bin"
# thêm vào .gitignore rồi sửa lại commit vừa nãy
git commit --amend --no-edit

Đồng bộ "bộ não AI" qua Google Drive

Bộ nhớ dài hạn của Claude nằm ở ~/.claude/memory. Để nó theo bạn sang máy 2, ta đặt thư mục thật trên Google Drive rồi tạo symlink (liên kết tắt) trỏ tới — cả 2 máy cùng dùng một bộ nhớ.

# Sao lưu thư mục memory cũ (nếu có) cho chắc
mv ~/.claude/memory ~/.claude/memory.bak 2>/dev/null

# Tạo symlink trỏ tới bộ nhớ trên Drive
ln -s "$HOME/Library/CloudStorage/GoogleDrive-<email>/My Drive/claude-cas/memory" ~/.claude/memory

# Kiểm tra
ls -la ~/.claude/memory

# Sao lưu memory cũ (nếu có)
Rename-Item "$env:USERPROFILE\.claude\memory" "memory.bak" -EA SilentlyContinue

# Tạo symlink trỏ tới bộ nhớ trên Drive (G: là ổ Drive, sửa cho đúng máy bạn)
New-Item -ItemType SymbolicLink `
  -Path "$env:USERPROFILE\.claude\memory" `
  -Target "G:\My Drive\claude-cas\memory"

# Kiểm tra
Get-Item "$env:USERPROFILE\.claude\memory" | Select-Object LinkType, Target

Mang Secrets sang máy 2 — đúng cách

Secrets là API key, token, mật khẩu (thường trong .secrets/, .env). Đây là phần dễ sai nhất và nguy hiểm nhất.

Cách chuyển an toàn

• AirDrop (2 máy Mac): gửi thẳng thư mục .secrets/ sang máy 2, đặt vào đúng vị trí.
• Sau khi đặt xong, khoá quyền lại: chmod 600 .secrets/*
• Nếu cần dán giá trị key vào file mà không hiện ra màn hình, dùng lệnh ẩn input:

read -s -p "Dán credential rồi Enter: " S \
  && sed -i '' "s|^FIELD=.*|FIELD=$S|" .secrets/file.env \
  && unset S && echo "✅ Đã lưu"

Dùng chung Mac ↔ Windows: 3 cái bẫy

Nếu bạn chỉ dùng toàn Mac (hoặc toàn Windows) thì bỏ qua phần này. Nhưng nếu trộn Mac và PC Windows trên cùng một két sắt, có 3 thứ chắc chắn sẽ cắn bạn nếu không xử trước.

💊 Thuốc: chạy 1 lần trên MỖI máy

🍎 Trên Mac — Terminal:

git config --global core.autocrlf input
git config --global core.precomposeunicode true
git config --global core.quotepath false

🪟 Trên Windows — PowerShell (dòng cuối cần quyền Administrator):

git config --global core.autocrlf true
git config --global core.quotepath false
git config --global core.longpaths true

Và thêm 1 file .gitattributes vào vault

File này ép mọi máy hiểu giống nhau — tạo trong thư mục vault, đặt cạnh .gitignore:

# Chuẩn hoá xuống dòng cho mọi file chữ
* text=auto eol=lf

# File nhị phân: cấm Git đụng vào nội dung
*.png binary
*.jpg binary
*.pdf binary
*.wav binary
*.mp4 binary

Quy trình làm việc nhiều máy hằng ngày

Dù bạn có 2 máy hay 5 máy, giữ một thói quen nhỏ này là không bao giờ xung đột hay mất việc:

git pull --rebase
# Git tự ghép việc của bạn lên trên bản mới. Xong thì:
git push

Checklist cho mỗi máy mới (bấm để tick)

• ✓Obsidian đã cài + đăng nhập tài khoản
• ✓Obsidian Sync bật, vault báo "Fully synced"
• ✓Selective sync đã loại trừ .git / .secrets / .claude / node_modules
• ✓Node.js 18+ và Git đã cài (node -v, git --version chạy được)
• ✓Claude Code đã cài + /login thành công
• ✓PRO SSH key riêng của máy này đã gắn vào GitHub, ssh -T git@github.com OK
• ✓PRO Đã git clone két sắt về đúng tên thư mục
• ✓PRO Đã có .gitignore chặn media nặng + secrets
• ✓PRO Trộn Mac–Windows? Đã chạy 3 lệnh git config ở Phần 8
• ✓PRO Google Drive đã cài, thư mục memory symlink về Drive
• ✓SEC Secrets đã chuyển tay an toàn + khoá quyền lại
• ✓Đã test: sửa note máy cũ → máy mới cập nhật; claude chạy không đòi login

Lỗi thường gặp