Cửa sổ cài hiển thị tiến độ chung, việc đang làm và kết quả từng mục. Tiêu đề cửa sổ (trên thanh taskbar) cũng hiện %, nên thu nhỏ cửa sổ vẫn theo dõi được.
Bộ cài 1 chạm50% · Claude Code
[██████░░░░░░░░░░░░░░░░░░] 25% Bước 2/6: Node.js LTS Tải node-v22-win-x64.zip [██████████░░░░░░] 63% 19.1/30.4 MB 4.2 MB/s ✓ OK — v22.20.0 (41 giây)[████████████░░░░░░░░░░░░] 50% Bước 3/6: Claude Code ⠹ Đang tải và cài Claude Code (bộ cài chính thức) (24 giây)================ TÓM TẮT ================ ✓ Git 0 giây ĐÃ CÓ ✓ Node.js LTS 41 giây OK — v22.20.0 ! Antigravity IDE 3 giây CẦN LÀM TAY — đã mở trang tải ✗ GitHub CLI 1 phút 02 giây LỖI — chưa cài được GitHub CLI
✓ OK / ĐÃ CÓ: xong, hoặc máy có sẵn.
! CẦN LÀM TAY / BỎ QUA: làm theo lời nhắc ngay bên cạnh.
✗ LỖI: chạy lại file một lần; vẫn lỗi thì tra Xử lý sự cố.
Nhật ký đầy đủ: %TEMP%\bo-cai-1-cham.log/tmp/bo-cai-1-cham.log và %TEMP%\bo-cai-1-cham-chi-tiet.log.
Bộ cài tự làm gì · việc bạn cần bấm
Tự động
Kiểm tra máy trước khi cài: 64-bit, phiên bản hệ điều hành, dung lượng trống, kết nối mạng.
Mục đã có trên máy thì bỏ qua; chạy lại nhiều lần không sao.
Mỗi mục có 2–4 cách cài dự phòng (winget → tải thẳng bản chính thức → cách khác) (bản chính thức cài vào thư mục người dùng → Homebrew/npm).
Tải lại khi mạng chập chờn, làm mới nguồn cài, xoá file tải dở rồi thử lại.
Ưu tiên cài cho riêng tài khoản, không cần quyền quản trị.
Tự thêm đường dẫn để gõ được lệnh ngay; giữ máy không ngủ trong lúc cài; ghi nhật ký chi tiết.
Vẫn cần bạn bấm
Lần đầu mở file: More info → Run anyway (file chưa có chữ ký số).
Yes khi Windows hỏi quyền (Git, Node.js, bật ảo hoá).
Open Anyway lần đầu mở file, Install ở hộp thoại Command Line Tools.
Mật khẩu máy cho các mục cần quyền quản trị.
Antigravity: nếu không tìm được link tải tự động, bộ cài mở trang tải để bạn tải tay.
Không tự vượt được: máy không có mạng, mạng chặn trang tải, máy công ty khoá cài phần mềm, máy 32-bit hoặc quá cũ.
Chạy thử trước, không cài gì
Mở cửa sổ lệnh tại thư mục chứa file rồi chạy (riêng skill được cài thử vào thư mục tạm):
Command Prompt tại thư mục chứa file .bat
set VBD_THU=1 && Bo-cai-1-cham.bat
Terminal
VBD_THU=1 bash Bo-cai-1-cham.command
Terminal
VBD_THU=1 bash bo-cai-1-cham.sh
Làm trước khi cài
Kiểm tra máy
Biết máy mình là loại nào để chọn đúng bản cài, và cách chạy một câu lệnh.
i
Cách chạy một câu lệnh
Nhấn ⊞ Windows, gõ PowerShell, Enter (không chọn bản x86).
Nhấn ⌘+Space, gõ Terminal, Return.
Nhấn Ctrl+Alt+T, hoặc mở Terminal trong menu.
Bấm Sao chép trên khung lệnh, dán vào cửa sổ: nhấp chuột phải⌘+VCtrl+Shift+V, rồi nhấn Enter.
Mở file .dmg vừa tải, kéo biểu tượng Claude vào thư mục Applications. Lần đầu mở, macOS hỏi về ứng dụng tải từ Internet thì bấm Open.
Bản Linux đang thử nghiệm, chỉ cho Ubuntu 22.04+ hoặc Debian 12+ (x64, ARM64). Máy Linux khác dùng Claude Code. Chạy các lệnh sau (thêm kho phần mềm của Anthropic rồi cài):
Bấm Code ở giữa phía trên → chọn Local → Select folder → chọn thư mục làm việc. Khi mới dùng, chọn chế độ Manual để Claude hỏi trước mỗi thay đổi.
Tab Code cần Git: cài theo bước “Cài Git” ở trang Claude Code. Tab Code dùng chung cài đặt với Claude Code, nên skill thể thức và cấu hình nâng cao cũng áp dụng ở đây.
Cowork chạy trong một “máy ảo” nhỏ. Nếu Cowork báo “Virtualization is not available”: mở PowerShell bằng quyền quản trị (chuột phải biểu tượng PowerShell → Run as administrator) rồi chạy, sau đó khởi động lại máy:
Máy công ty báo lỗi ở bước này thì bỏ qua, không ảnh hưởng việc cài Claude Code.
Cài Git
Git (công cụ quản lý phiên bản) giúp Claude theo dõi thay đổi của file, và cần cho tab Code của Claude Desktop. Kiểm tra trước bằng git --version: thấy số phiên bản là đã có, bỏ qua bước này.
PowerShell
winget install --id Git.Git -e --source winget
Terminal
xcode-select --install
Terminal · Ubuntu/Debian
sudo apt update && sudo apt install -y git
Hoặc tải bộ cài tại git-scm.com. Cài xong, đóng PowerShell và mở lại.
Một hộp thoại hiện ra, bấm Install và chờ vài phút. Báo “already installed” là máy đã có sẵn.
Chỉ làm nếu trình cài báo “…not in your PATH”. Chạy lại nhiều lần cũng không sao. Sau đó đóng hết cửa sổ PowerShellTerminal, Antigravity, VS Code rồi mở lại.
Chọn giao diện sáng/tối, chọn Claude account with subscription (tài khoản gói Pro/Max/Team). Trình duyệt mở trang đăng nhập; đăng nhập xong quay lại cửa sổ lệnh. Thoát Claude bằng cách gõ /exit.
Claude chỉ làm việc trong thư mục bạn mở nó. Thay đường dẫn ví dụ bằng thư mục của bạn. Mẹo: gõ cd (có dấu cách) rồi kéo thả thư mục vào cửa sổ lệnh, đường dẫn tự điền.
PowerShell
cd "D:\DuAn\TenDuAn"
claude
Terminal
cd ~/Documents/DuAn/TenDuAn
claude
Lần đầu vào thư mục, Claude hỏi có tin cậy không: chọn Yes nếu là thư mục của bạn.
Nếu chữ có dấu hiện thành ký tự lạ (Ä‘, ?), chạy lệnh sau một lần; từ đó PowerShell luôn hiển thị đúng. Cần làm bước “Cho phép PowerShell chạy script” trước.
Cài theo cách này không tự cập nhật. Cập nhật bằng winget upgrade --id Anthropic.ClaudeCode -e --source wingetbrew upgrade claude-codesudo apt update && sudo apt upgrade claude-code.
Muốn xoá cả cài đặt và lịch sử: xoá thêm thư mục %USERPROFILE%\~/.claude và file .claude.json cùng chỗ. Không khôi phục lại được, và mất cả skill, cấu hình.
Khoảng 10 phút · Cần cài Claude Code trước
Antigravity IDE
Phần mềm viết code miễn phí của Google. Claude chạy bên trong nó chính là Claude Code, nên cần cài Claude Code trước.
Vào File → Open Folder…, chọn thư mục. Khi được hỏi có tin cậy thư mục không, chọn Yes, I trust the authors (nếu không, Claude sẽ không hoạt động).
Chạy Claude trong Antigravity
Đóng hết cửa sổ Antigravity rồi mở lại (để nhận Claude Code vừa cài). Mở khung gõ lệnh bên trong Antigravity bằng Ctrl+` (phím ` nằm dưới phím Esc), rồi gõ:
Extension (tiện ích mở rộng) cho khung chat bên cạnh code. Mở Extensions (Ctrl⌘+Shift+X), tìm Claude Code của Anthropic, bấm Install. Mở Claude bằng biểu tượng tia sáng ở góc trên bên phải khi đang mở một file.
Nếu kẹt mãi ở chữ Installing: tải file cài tại open-vsx.org (bản win32-x64 (máy ARM: win32-arm64)darwin-arm64 (chip Apple) hoặc darwin-x64 (Intel)linux-x64 hoặc linux-arm64), rồi trong Extensions bấm ⋯ → Install from VSIX….
Đừng để hai trợ lý cùng sửa một file. Antigravity có trợ lý Gemini riêng. Khi Claude đang làm, không giao Gemini sửa cùng các file đó.
Cập nhật và gỡ
Gỡ trong Settings → Apps → Installed apps → Antigravity IDE, hoặc bằng lệnh winget uninstall --id Google.AntigravityIDE -e --source winget.
Gỡ: kéo Antigravity từ thư mục Applications vào Thùng rác.
Cập nhật: tải bản mới và giải nén đè. Gỡ: xoá thư mục đã giải nén.
Sau khi cài
Skill thể thức & Claude web
Skill giúp Claude soạn và xuất file Word đúng thể thức văn bản Đảng (HD 05-HD/VPTW) và văn bản hành chính (NĐ 30/2020/NĐ-CP). Cài bằng Bộ cài 1 chạm (mục “Skill thể thức văn bản”).
Dùng thử
Đóng hẳn rồi mở lại Claude, sau đó gõ: “Soạn quyết định của UBND xã về việc thành lập tổ công tác, xuất file Word”.
Settings → Capabilities: bật Code execution and file creation.
Customize → Skills → + → Create skill → Upload a skill: chọn file the-thuc-van-ban.zip bộ cài đặt trên Desktop.
Settings → General → Instructions for Claude: nhấn Ctrl⌘+V dán câu hướng dẫn (bộ cài đã chép sẵn; mất thì mở file the-thuc-van-ban - Instructions for Claude.txt trên Desktop).
Chỉ cài riêng skill
Bộ cài riêng của skill, dùng khi không cần phần mềm nào khác. Cũng dùng để gỡ skill.
Gỡ skill
Command Prompt tại thư mục chứa file .bat
Cai-dat-the-thuc-van-ban.bat go
Terminal
bash cai-dat-the-thuc-van-ban.command go
Terminal
bash cai-dat-the-thuc-van-ban.sh go
Nâng cao · 20–40 phút · Cần Claude Code
Cấu hình nâng cao
Một prompt (đoạn yêu cầu gửi Claude) soạn sẵn để Claude tự thiết lập: trả lời tiếng Việt, nhớ tiến độ dự án, ít hỏi lại việc an toàn, chặn việc nguy hiểm, thêm 4 lệnh tắt. Làm một lần cho mỗi máy.
Bấm Sao chép prompt, dán vào Claude, nhấn Enter. Prompt đã được viết riêng cho Windows. Bấm Chi tiết để đọc toàn bộ.
Prompt cho Windows
# NHIỆM VỤ: THIẾT LẬP CẤU HÌNH TOÀN CỤC CHO CLAUDE CODE
(Windows + PowerShell + Antigravity IDE; các dự án lưu trên Google Drive để dùng trên nhiều máy)
## CÁCH LÀM VIỆC VỚI TÔI
- Tôi không thạo tiếng Anh: luôn trả lời bằng tiếng Việt; thuật ngữ tiếng Anh thì giải thích bằng một câu ngắn.
- Làm tuần tự từng BƯỚC. Hết mỗi BƯỚC: báo cáo ngắn rồi DỪNG, chờ tôi trả lời "tiếp".
- Trước khi cài đặt hoặc ghi file: nói ngắn gọn việc sắp làm.
- Không xoá file của tôi. Trước khi sửa file đã có: sao lưu thành bản .bak-YYYYMMDD-HHmm cùng thư mục,
và giữ lại nội dung cũ (gộp thêm, không ghi đè).
- Cú pháp settings.json, permissions, hooks, skills: tra tài liệu chính thức https://code.claude.com/docs
trước khi viết, không đoán.
- Máy dùng Windows PowerShell 5.1: khi đọc/ghi file tiếng Việt bằng lệnh shell phải chỉ định UTF-8.
Ưu tiên dùng công cụ Read/Edit/Write của bạn để tạo và sửa file.
## BƯỚC 1 — KIỂM TRA & CÀI ĐẶT MÔI TRƯỜNG
1. Kiểm tra: Windows (phiên bản, 64-bit), PowerShell, winget, Git for Windows, Node.js, npm, Claude Code,
extension Claude Code trong Antigravity (nếu kiểm tra được).
Báo cáo bằng bảng: Thành phần | Đã có? | Phiên bản | Cần làm gì.
2. Claude Code phải là bản native chính thức (%USERPROFILE%\.local\bin\claude.exe).
Chạy `where.exe claude`; nếu có nhiều bản (npm, winget...) thì đề xuất gỡ bản thừa.
3. Cài/cập nhật phần thiếu bằng winget: Git.Git; OpenJS.NodeJS.LTS (hỏi tôi có làm dự án JavaScript không).
Nếu PATH thay đổi, nhắc tôi đóng và mở lại terminal, IDE.
4. Cấu hình Git toàn cục (hỏi tên và email nếu chưa có):
user.name, user.email, core.autocrlf true, init.defaultBranch main,
core.quotepath false (hiện đúng tên file tiếng Việt), core.longpaths true (tránh lỗi đường dẫn dài).
5. Đề xuất công cụ hữu ích (ví dụ GitHub CLI, ripgrep), nêu lợi ích; CHỜ tôi đồng ý mới cài.
## BƯỚC 2 — FILE CẤU HÌNH TOÀN CỤC (%USERPROFILE%\.claude\)
Các file này dùng chung cho Claude Code dòng lệnh, extension trong IDE và tab Code của Claude Desktop.
A. CLAUDE.md — viết gọn, dưới ~60 dòng (file nạp vào MỌI phiên, càng ngắn càng tiết kiệm token):
- Ngôn ngữ: trả lời, giải thích, tóm tắt, hỏi lại bằng tiếng Việt. Code, tên biến, lệnh, commit message
dùng tiếng Anh; comment giải thích trong code viết tiếng Việt. Thuật ngữ tiếng Anh: giải thích một câu
ngắn khi dùng lần đầu.
- Mở dự án: đọc CLAUDE.md và .claude/context/progress.md của dự án trước khi làm việc.
Nếu dự án chưa có cấu trúc kế thừa (Bước 3), đề xuất chạy /khoi-tao-du-an.
- Sau mỗi mốc công việc quan trọng và trước khi kết thúc phiên: cập nhật .claude/context/progress.md.
- Không ghi đường dẫn tuyệt đối (G:\, C:\Users\...) vào file dự án; dùng đường dẫn tương đối,
vì mỗi máy có đường dẫn Google Drive khác nhau.
- Windows: đường dẫn có dấu cách (ví dụ "My Drive") phải đặt trong ngoặc kép; đọc/ghi file tiếng Việt
bằng PowerShell phải dùng -Encoding UTF8.
- An toàn: hỏi tôi trước khi xoá file, git push, cài gói toàn cục hoặc chạy lệnh ảnh hưởng ngoài thư mục
dự án. Không đọc, in ra hoặc commit file .env, khoá API, mật khẩu.
- Tiết kiệm token: các nguyên tắc ở Bước 4.
B. settings.json (phải là JSON hợp lệ; gộp với nội dung cũ nếu có):
- permissions.allow: lệnh an toàn hay dùng, viết quy tắc cho CẢ hai công cụ Bash và PowerShell,
ví dụ git status/diff/log/add/commit, npm run/test, liệt kê thư mục, đọc nội dung file.
- permissions.deny:
• lệnh nguy hiểm: xoá đệ quy (rm -rf, Remove-Item -Recurse), git push --force / -f, git reset --hard;
• đọc file bí mật ở mọi cấp thư mục: .env, .env.*, *.pem, *.key;
• đọc thư mục/file nặng: node_modules, dist, build, .next, coverage, *.log,
package-lock.json, pnpm-lock.yaml, yarn.lock.
Quy tắc đường dẫn trong file cấu hình người dùng phải viết sao cho áp dụng ở MỌI dự án
(xem mục Read/Edit rules trong tài liệu permissions).
- Hook SessionStart (không đặt matcher, để chạy cả khi mở phiên mới, tiếp tục phiên, sau /clear
và sau khi nén ngữ cảnh): in ra tối đa ~80 dòng đầu của .claude/context/progress.md trong dự án
(nếu có), để Claude nắm ngay trạng thái dự án.
Yêu cầu: chạy bằng PowerShell ("shell": "powershell") để hoạt động dù máy có hay không có Git Bash;
dùng biến CLAUDE_PROJECT_DIR; xuất tiếng Việt đúng UTF-8; im lặng khi dự án chưa có file.
- Kiểm tra: chạy `claude doctor`, rồi thử hook thật bằng một thư mục tạm có progress.md mẫu.
Báo tôi kết quả, xoá thư mục tạm sau khi thử.
- Giải thích từng mục bằng tiếng Việt.
C. Lệnh tắt dạng skill tại %USERPROFILE%\.claude\skills\<tên>\SKILL.md
Mỗi skill có mô tả tiếng Việt. Skill có commit hoặc sửa nhiều file thì đặt chế độ chỉ tôi gọi được
(Claude không tự gọi).
- /khoi-tao-du-an : tạo cấu trúc Bước 3 cho dự án hiện tại, không ghi đè file đã có. Tự điền CLAUDE.md
của dự án từ những gì đọc được (công nghệ, lệnh build/test); chỗ nào chưa rõ thì hỏi tôi.
- /tiep-tuc : đọc CLAUDE.md, progress.md, git status và 10 commit gần nhất; tóm tắt tình trạng
bằng tiếng Việt và đề xuất 1–3 việc làm tiếp.
- /luu-phien : cập nhật progress.md (ngày giờ, tên máy, đã làm gì, đang dở gì, bước tiếp theo,
lỗi chưa xử lý); nếu là kho git thì commit (không push), commit message tiếng Anh ngắn gọn.
- /don-dep : lưu các ý quan trọng của phiên vào progress.md và decisions.md, rồi hướng dẫn tôi gõ
/compact (còn làm tiếp việc này) hoặc /clear (chuyển sang việc khác).
## BƯỚC 3 — CẤU TRÚC KẾ THỪA CHO MỖI DỰ ÁN
<du-an>/
├── CLAUDE.md # Mô tả dự án, công nghệ, lệnh build/test, quy ước (dưới ~150 dòng)
├── .claude/
│ ├── settings.json # Cấu hình dùng chung của dự án
│ ├── settings.local.json # Cấu hình cá nhân (không đưa vào git)
│ ├── skills/ # Lệnh tắt riêng của dự án
│ └── context/
│ ├── progress.md # Đã xong, đang dở, bước tiếp theo (giữ dưới ~80 dòng)
│ ├── progress-archive.md # Nhật ký cũ chuyển từ progress.md sang
│ └── decisions.md # Quyết định kỹ thuật quan trọng và lý do
├── .gitignore # .env, node_modules, dist, build, .claude/settings.local.json...
└── .gitattributes # * text=auto (thống nhất ký tự xuống dòng giữa các máy)
Lưu ý:
- Lịch sử hội thoại của Claude Code nằm trong %USERPROFILE%\.claude trên từng máy, KHÔNG đi theo
Google Drive. Mọi thông tin cần kế thừa phải được ghi vào các file trên.
- Thư mục dự án nằm trên Google Drive nên settings.local.json vẫn bị đồng bộ sang máy khác;
không ghi thông tin chỉ đúng cho một máy (đường dẫn, khoá) vào đó.
## BƯỚC 4 — TỐI ƯU TOKEN (ghi gọn vào CLAUDE.md toàn cục)
- Tìm trước (grep/glob), chỉ đọc phần file cần thiết; không đọc lại file chưa thay đổi.
- Dùng subagent cho việc tìm kiếm, khảo sát rộng để giữ ngữ cảnh chính gọn.
- Việc lớn: lập kế hoạch trước (plan mode), chia nhỏ, làm và kiểm tra từng phần.
- Khi ngữ cảnh dùng khoảng 60–70% (xem bằng /context): lưu tiến độ vào progress.md rồi đề xuất /compact.
Chuyển sang việc không liên quan: đề xuất /clear.
- Trả lời ngắn gọn, không nhắc lại lời tôi.
- Sau khi sửa code: chạy test/build để kiểm tra; không bỏ qua chất lượng để tiết kiệm token.
## BƯỚC 5 — GOOGLE DRIVE VÀ BẢO MẬT
1. Hỏi tôi thư mục chứa dự án trên Google Drive; kiểm tra Google Drive đang ở chế độ
"Stream files" hay "Mirror files".
2. Tư vấn rủi ro khi để .git và node_modules trong thư mục đồng bộ (xung đột, file trùng "(1)",
hỏng kho git, đồng bộ chậm) và đề xuất phương án, ví dụ: dùng GitHub (kho riêng tư) làm kho chính;
không mở cùng một dự án trên hai máy cùng lúc; chờ Drive đồng bộ xong rồi mới chuyển máy;
cài lại node_modules trên mỗi máy. Để tôi chọn, không tự di chuyển dự án.
3. Nếu git báo "dubious ownership" với thư mục trên Drive: thêm safe.directory cho đúng thư mục đó
(không dùng "*").
4. API key, mật khẩu chỉ để trong .env, và .env phải có trong .gitignore.
5. Không đồng bộ nguyên thư mục %USERPROFILE%\.claude (có thông tin đăng nhập, lịch sử phiên).
Thay vào đó tạo thư mục sao lưu trên Drive (hỏi tôi vị trí, ví dụ "Claude-Config") gồm CLAUDE.md,
settings.json, skills\ và script khoi-phuc.ps1 để chép ngược về %USERPROFILE%\.claude trên máy mới
(script phải sao lưu file cũ trước khi chép).
## BƯỚC 6 — BÁO CÁO CUỐI
Tóm tắt bằng tiếng Việt: đã cài gì; đã tạo/sửa file nào (đường dẫn đầy đủ, kèm file sao lưu);
cách dùng 4 lệnh tắt; việc nào chưa làm được và vì sao; checklist các bước khi chuyển sang máy mới.
Prompt cho macOS
# NHIỆM VỤ: THIẾT LẬP CẤU HÌNH TOÀN CỤC CHO CLAUDE CODE
(macOS + Terminal (zsh) + Antigravity IDE; các dự án lưu trên Google Drive để dùng trên nhiều máy)
## CÁCH LÀM VIỆC VỚI TÔI
- Tôi không thạo tiếng Anh: luôn trả lời bằng tiếng Việt; thuật ngữ tiếng Anh thì giải thích bằng một câu ngắn.
- Làm tuần tự từng BƯỚC. Hết mỗi BƯỚC: báo cáo ngắn rồi DỪNG, chờ tôi trả lời "tiếp".
- Trước khi cài đặt hoặc ghi file: nói ngắn gọn việc sắp làm. Lệnh cần sudo (mật khẩu máy) thì báo trước.
- Không xoá file của tôi. Trước khi sửa file đã có: sao lưu thành bản .bak-YYYYMMDD-HHmm cùng thư mục,
và giữ lại nội dung cũ (gộp thêm, không ghi đè).
- Cú pháp settings.json, permissions, hooks, skills: tra tài liệu chính thức https://code.claude.com/docs
trước khi viết, không đoán.
## BƯỚC 1 — KIỂM TRA & CÀI ĐẶT MÔI TRƯỜNG
1. Kiểm tra: macOS (phiên bản, chip Apple hay Intel), zsh, Command Line Tools (xcode-select -p),
Homebrew, Git, Node.js, npm, Claude Code, extension Claude Code trong Antigravity (nếu kiểm tra được).
Báo cáo bằng bảng: Thành phần | Đã có? | Phiên bản | Cần làm gì.
2. Claude Code phải là bản native chính thức (~/.local/bin/claude). Chạy `which -a claude`;
nếu có nhiều bản (npm, Homebrew...) thì đề xuất gỡ bản thừa. Bảo đảm ~/.local/bin có trong PATH (~/.zshrc).
3. Cài phần thiếu: Git qua Command Line Tools (xcode-select --install) hoặc Homebrew;
Node.js LTS qua Homebrew (hỏi tôi có làm dự án JavaScript không). Chưa có Homebrew thì hỏi tôi trước khi cài.
4. Cấu hình Git toàn cục (hỏi tên và email nếu chưa có):
user.name, user.email, core.autocrlf input, init.defaultBranch main,
core.quotepath false (hiện đúng tên file tiếng Việt), core.precomposeunicode true (tên file tiếng Việt
thống nhất giữa Mac và Windows).
5. Đề xuất công cụ hữu ích (ví dụ GitHub CLI, ripgrep), nêu lợi ích; CHỜ tôi đồng ý mới cài.
## BƯỚC 2 — FILE CẤU HÌNH TOÀN CỤC (~/.claude/)
Các file này dùng chung cho Claude Code dòng lệnh, extension trong IDE và tab Code của Claude Desktop.
A. CLAUDE.md — viết gọn, dưới ~60 dòng (file nạp vào MỌI phiên, càng ngắn càng tiết kiệm token):
- Ngôn ngữ: trả lời, giải thích, tóm tắt, hỏi lại bằng tiếng Việt. Code, tên biến, lệnh, commit message
dùng tiếng Anh; comment giải thích trong code viết tiếng Việt. Thuật ngữ tiếng Anh: giải thích một câu
ngắn khi dùng lần đầu.
- Mở dự án: đọc CLAUDE.md và .claude/context/progress.md của dự án trước khi làm việc.
Nếu dự án chưa có cấu trúc kế thừa (Bước 3), đề xuất chạy /khoi-tao-du-an.
- Sau mỗi mốc công việc quan trọng và trước khi kết thúc phiên: cập nhật .claude/context/progress.md.
- Không ghi đường dẫn tuyệt đối (/Users/..., ~/Library/CloudStorage/...) vào file dự án; dùng đường dẫn
tương đối, vì mỗi máy có đường dẫn Google Drive khác nhau.
- Đường dẫn có dấu cách (ví dụ "My Drive") phải đặt trong ngoặc kép.
- An toàn: hỏi tôi trước khi xoá file, git push, cài gói toàn cục, dùng sudo hoặc chạy lệnh ảnh hưởng
ngoài thư mục dự án. Không đọc, in ra hoặc commit file .env, khoá API, mật khẩu.
- Tiết kiệm token: các nguyên tắc ở Bước 4.
B. settings.json (phải là JSON hợp lệ; gộp với nội dung cũ nếu có):
- permissions.allow: lệnh an toàn hay dùng, ví dụ git status/diff/log/add/commit, npm run/test,
liệt kê thư mục, đọc nội dung file.
- permissions.deny:
• lệnh nguy hiểm: rm -rf, sudo rm, git push --force / -f, git reset --hard;
• đọc file bí mật ở mọi cấp thư mục: .env, .env.*, *.pem, *.key;
• đọc thư mục/file nặng: node_modules, dist, build, .next, coverage, *.log,
package-lock.json, pnpm-lock.yaml, yarn.lock.
Quy tắc đường dẫn trong file cấu hình người dùng phải viết sao cho áp dụng ở MỌI dự án
(xem mục Read/Edit rules trong tài liệu permissions).
- Hook SessionStart (không đặt matcher, để chạy cả khi mở phiên mới, tiếp tục phiên, sau /clear
và sau khi nén ngữ cảnh): in ra tối đa ~80 dòng đầu của .claude/context/progress.md trong dự án
(nếu có), để Claude nắm ngay trạng thái dự án.
Yêu cầu: dùng biến CLAUDE_PROJECT_DIR; im lặng khi dự án chưa có file.
- Kiểm tra: chạy `claude doctor`, rồi thử hook thật bằng một thư mục tạm có progress.md mẫu.
Báo tôi kết quả, xoá thư mục tạm sau khi thử.
- Giải thích từng mục bằng tiếng Việt.
C. Lệnh tắt dạng skill tại ~/.claude/skills/<tên>/SKILL.md
Mỗi skill có mô tả tiếng Việt. Skill có commit hoặc sửa nhiều file thì đặt chế độ chỉ tôi gọi được
(Claude không tự gọi).
- /khoi-tao-du-an : tạo cấu trúc Bước 3 cho dự án hiện tại, không ghi đè file đã có. Tự điền CLAUDE.md
của dự án từ những gì đọc được (công nghệ, lệnh build/test); chỗ nào chưa rõ thì hỏi tôi.
- /tiep-tuc : đọc CLAUDE.md, progress.md, git status và 10 commit gần nhất; tóm tắt tình trạng
bằng tiếng Việt và đề xuất 1–3 việc làm tiếp.
- /luu-phien : cập nhật progress.md (ngày giờ, tên máy, đã làm gì, đang dở gì, bước tiếp theo,
lỗi chưa xử lý); nếu là kho git thì commit (không push), commit message tiếng Anh ngắn gọn.
- /don-dep : lưu các ý quan trọng của phiên vào progress.md và decisions.md, rồi hướng dẫn tôi gõ
/compact (còn làm tiếp việc này) hoặc /clear (chuyển sang việc khác).
## BƯỚC 3 — CẤU TRÚC KẾ THỪA CHO MỖI DỰ ÁN
<du-an>/
├── CLAUDE.md # Mô tả dự án, công nghệ, lệnh build/test, quy ước (dưới ~150 dòng)
├── .claude/
│ ├── settings.json # Cấu hình dùng chung của dự án
│ ├── settings.local.json # Cấu hình cá nhân (không đưa vào git)
│ ├── skills/ # Lệnh tắt riêng của dự án
│ └── context/
│ ├── progress.md # Đã xong, đang dở, bước tiếp theo (giữ dưới ~80 dòng)
│ ├── progress-archive.md # Nhật ký cũ chuyển từ progress.md sang
│ └── decisions.md # Quyết định kỹ thuật quan trọng và lý do
├── .gitignore # .env, node_modules, dist, build, .DS_Store, .claude/settings.local.json...
└── .gitattributes # * text=auto (thống nhất ký tự xuống dòng giữa Mac và Windows)
Lưu ý:
- Lịch sử hội thoại của Claude Code nằm trong ~/.claude trên từng máy, KHÔNG đi theo Google Drive.
Mọi thông tin cần kế thừa phải được ghi vào các file trên.
- Thư mục dự án nằm trên Google Drive nên settings.local.json vẫn bị đồng bộ sang máy khác;
không ghi thông tin chỉ đúng cho một máy (đường dẫn, khoá) vào đó.
## BƯỚC 4 — TỐI ƯU TOKEN (ghi gọn vào CLAUDE.md toàn cục)
- Tìm trước (grep/glob), chỉ đọc phần file cần thiết; không đọc lại file chưa thay đổi.
- Dùng subagent cho việc tìm kiếm, khảo sát rộng để giữ ngữ cảnh chính gọn.
- Việc lớn: lập kế hoạch trước (plan mode), chia nhỏ, làm và kiểm tra từng phần.
- Khi ngữ cảnh dùng khoảng 60–70% (xem bằng /context): lưu tiến độ vào progress.md rồi đề xuất /compact.
Chuyển sang việc không liên quan: đề xuất /clear.
- Trả lời ngắn gọn, không nhắc lại lời tôi.
- Sau khi sửa code: chạy test/build để kiểm tra; không bỏ qua chất lượng để tiết kiệm token.
## BƯỚC 5 — GOOGLE DRIVE VÀ BẢO MẬT
1. Hỏi tôi thư mục chứa dự án trên Google Drive (thường nằm trong ~/Library/CloudStorage/GoogleDrive-...);
kiểm tra Google Drive đang ở chế độ "Stream files" hay "Mirror files".
2. Tư vấn rủi ro khi để .git và node_modules trong thư mục đồng bộ (xung đột, file trùng "(1)",
hỏng kho git, đồng bộ chậm) và đề xuất phương án, ví dụ: dùng GitHub (kho riêng tư) làm kho chính;
không mở cùng một dự án trên hai máy cùng lúc; chờ Drive đồng bộ xong rồi mới chuyển máy;
cài lại node_modules trên mỗi máy. Để tôi chọn, không tự di chuyển dự án.
3. API key, mật khẩu chỉ để trong .env, và .env phải có trong .gitignore.
4. Không đồng bộ nguyên thư mục ~/.claude (có lịch sử phiên và dữ liệu đăng nhập).
Thay vào đó tạo thư mục sao lưu trên Drive (hỏi tôi vị trí, ví dụ "Claude-Config") gồm CLAUDE.md,
settings.json, skills/ và script khoi-phuc.sh để chép ngược về ~/.claude trên máy mới
(script phải sao lưu file cũ trước khi chép).
## BƯỚC 6 — BÁO CÁO CUỐI
Tóm tắt bằng tiếng Việt: đã cài gì; đã tạo/sửa file nào (đường dẫn đầy đủ, kèm file sao lưu);
cách dùng 4 lệnh tắt; việc nào chưa làm được và vì sao; checklist các bước khi chuyển sang máy mới.
Prompt cho Linux
# NHIỆM VỤ: THIẾT LẬP CẤU HÌNH TOÀN CỤC CHO CLAUDE CODE
(Linux + Terminal (bash) + Antigravity IDE; các dự án lưu trên Google Drive để dùng trên nhiều máy)
## CÁCH LÀM VIỆC VỚI TÔI
- Tôi không thạo tiếng Anh: luôn trả lời bằng tiếng Việt; thuật ngữ tiếng Anh thì giải thích bằng một câu ngắn.
- Làm tuần tự từng BƯỚC. Hết mỗi BƯỚC: báo cáo ngắn rồi DỪNG, chờ tôi trả lời "tiếp".
- Trước khi cài đặt hoặc ghi file: nói ngắn gọn việc sắp làm. Lệnh cần sudo (mật khẩu máy) thì báo trước.
- Không xoá file của tôi. Trước khi sửa file đã có: sao lưu thành bản .bak-YYYYMMDD-HHmm cùng thư mục,
và giữ lại nội dung cũ (gộp thêm, không ghi đè).
- Cú pháp settings.json, permissions, hooks, skills: tra tài liệu chính thức https://code.claude.com/docs
trước khi viết, không đoán.
## BƯỚC 1 — KIỂM TRA & CÀI ĐẶT MÔI TRƯỜNG
1. Kiểm tra: bản phân phối Linux và phiên bản (/etc/os-release), kiến trúc (x86_64 hay aarch64), bash,
trình quản lý gói (apt, dnf...), Git, Node.js, npm, Claude Code, extension Claude Code trong Antigravity (nếu kiểm tra được).
Báo cáo bằng bảng: Thành phần | Đã có? | Phiên bản | Cần làm gì.
2. Claude Code phải là bản native chính thức (~/.local/bin/claude). Chạy `which -a claude`;
nếu có nhiều bản (npm, apt...) thì đề xuất gỡ bản thừa. Bảo đảm ~/.local/bin có trong PATH (~/.bashrc).
3. Cài phần thiếu bằng trình quản lý gói của máy (apt, dnf...): Git;
Node.js LTS qua nvm (hỏi tôi có làm dự án JavaScript không). Lệnh cần sudo thì báo tôi trước.
4. Cấu hình Git toàn cục (hỏi tên và email nếu chưa có):
user.name, user.email, core.autocrlf input, init.defaultBranch main,
core.quotepath false (hiện đúng tên file tiếng Việt).
5. Đề xuất công cụ hữu ích (ví dụ GitHub CLI, ripgrep), nêu lợi ích; CHỜ tôi đồng ý mới cài.
## BƯỚC 2 — FILE CẤU HÌNH TOÀN CỤC (~/.claude/)
Các file này dùng chung cho Claude Code dòng lệnh, extension trong IDE và tab Code của Claude Desktop.
A. CLAUDE.md — viết gọn, dưới ~60 dòng (file nạp vào MỌI phiên, càng ngắn càng tiết kiệm token):
- Ngôn ngữ: trả lời, giải thích, tóm tắt, hỏi lại bằng tiếng Việt. Code, tên biến, lệnh, commit message
dùng tiếng Anh; comment giải thích trong code viết tiếng Việt. Thuật ngữ tiếng Anh: giải thích một câu
ngắn khi dùng lần đầu.
- Mở dự án: đọc CLAUDE.md và .claude/context/progress.md của dự án trước khi làm việc.
Nếu dự án chưa có cấu trúc kế thừa (Bước 3), đề xuất chạy /khoi-tao-du-an.
- Sau mỗi mốc công việc quan trọng và trước khi kết thúc phiên: cập nhật .claude/context/progress.md.
- Không ghi đường dẫn tuyệt đối (/home/..., thư mục đồng bộ Google Drive) vào file dự án; dùng đường dẫn
tương đối, vì mỗi máy có đường dẫn Google Drive khác nhau.
- Đường dẫn có dấu cách (ví dụ "My Drive") phải đặt trong ngoặc kép.
- An toàn: hỏi tôi trước khi xoá file, git push, cài gói toàn cục, dùng sudo hoặc chạy lệnh ảnh hưởng
ngoài thư mục dự án. Không đọc, in ra hoặc commit file .env, khoá API, mật khẩu.
- Tiết kiệm token: các nguyên tắc ở Bước 4.
B. settings.json (phải là JSON hợp lệ; gộp với nội dung cũ nếu có):
- permissions.allow: lệnh an toàn hay dùng, ví dụ git status/diff/log/add/commit, npm run/test,
liệt kê thư mục, đọc nội dung file.
- permissions.deny:
• lệnh nguy hiểm: rm -rf, sudo rm, git push --force / -f, git reset --hard;
• đọc file bí mật ở mọi cấp thư mục: .env, .env.*, *.pem, *.key;
• đọc thư mục/file nặng: node_modules, dist, build, .next, coverage, *.log,
package-lock.json, pnpm-lock.yaml, yarn.lock.
Quy tắc đường dẫn trong file cấu hình người dùng phải viết sao cho áp dụng ở MỌI dự án
(xem mục Read/Edit rules trong tài liệu permissions).
- Hook SessionStart (không đặt matcher, để chạy cả khi mở phiên mới, tiếp tục phiên, sau /clear
và sau khi nén ngữ cảnh): in ra tối đa ~80 dòng đầu của .claude/context/progress.md trong dự án
(nếu có), để Claude nắm ngay trạng thái dự án.
Yêu cầu: dùng biến CLAUDE_PROJECT_DIR; im lặng khi dự án chưa có file.
- Kiểm tra: chạy `claude doctor`, rồi thử hook thật bằng một thư mục tạm có progress.md mẫu.
Báo tôi kết quả, xoá thư mục tạm sau khi thử.
- Giải thích từng mục bằng tiếng Việt.
C. Lệnh tắt dạng skill tại ~/.claude/skills/<tên>/SKILL.md
Mỗi skill có mô tả tiếng Việt. Skill có commit hoặc sửa nhiều file thì đặt chế độ chỉ tôi gọi được
(Claude không tự gọi).
- /khoi-tao-du-an : tạo cấu trúc Bước 3 cho dự án hiện tại, không ghi đè file đã có. Tự điền CLAUDE.md
của dự án từ những gì đọc được (công nghệ, lệnh build/test); chỗ nào chưa rõ thì hỏi tôi.
- /tiep-tuc : đọc CLAUDE.md, progress.md, git status và 10 commit gần nhất; tóm tắt tình trạng
bằng tiếng Việt và đề xuất 1–3 việc làm tiếp.
- /luu-phien : cập nhật progress.md (ngày giờ, tên máy, đã làm gì, đang dở gì, bước tiếp theo,
lỗi chưa xử lý); nếu là kho git thì commit (không push), commit message tiếng Anh ngắn gọn.
- /don-dep : lưu các ý quan trọng của phiên vào progress.md và decisions.md, rồi hướng dẫn tôi gõ
/compact (còn làm tiếp việc này) hoặc /clear (chuyển sang việc khác).
## BƯỚC 3 — CẤU TRÚC KẾ THỪA CHO MỖI DỰ ÁN
<du-an>/
├── CLAUDE.md # Mô tả dự án, công nghệ, lệnh build/test, quy ước (dưới ~150 dòng)
├── .claude/
│ ├── settings.json # Cấu hình dùng chung của dự án
│ ├── settings.local.json # Cấu hình cá nhân (không đưa vào git)
│ ├── skills/ # Lệnh tắt riêng của dự án
│ └── context/
│ ├── progress.md # Đã xong, đang dở, bước tiếp theo (giữ dưới ~80 dòng)
│ ├── progress-archive.md # Nhật ký cũ chuyển từ progress.md sang
│ └── decisions.md # Quyết định kỹ thuật quan trọng và lý do
├── .gitignore # .env, node_modules, dist, build, .claude/settings.local.json...
└── .gitattributes # * text=auto (thống nhất ký tự xuống dòng giữa Mac và Windows)
Lưu ý:
- Lịch sử hội thoại của Claude Code nằm trong ~/.claude trên từng máy, KHÔNG đi theo Google Drive.
Mọi thông tin cần kế thừa phải được ghi vào các file trên.
- Thư mục dự án nằm trên Google Drive nên settings.local.json vẫn bị đồng bộ sang máy khác;
không ghi thông tin chỉ đúng cho một máy (đường dẫn, khoá) vào đó.
## BƯỚC 4 — TỐI ƯU TOKEN (ghi gọn vào CLAUDE.md toàn cục)
- Tìm trước (grep/glob), chỉ đọc phần file cần thiết; không đọc lại file chưa thay đổi.
- Dùng subagent cho việc tìm kiếm, khảo sát rộng để giữ ngữ cảnh chính gọn.
- Việc lớn: lập kế hoạch trước (plan mode), chia nhỏ, làm và kiểm tra từng phần.
- Khi ngữ cảnh dùng khoảng 60–70% (xem bằng /context): lưu tiến độ vào progress.md rồi đề xuất /compact.
Chuyển sang việc không liên quan: đề xuất /clear.
- Trả lời ngắn gọn, không nhắc lại lời tôi.
- Sau khi sửa code: chạy test/build để kiểm tra; không bỏ qua chất lượng để tiết kiệm token.
## BƯỚC 5 — GOOGLE DRIVE VÀ BẢO MẬT
1. Google Drive không có ứng dụng chính thức cho Linux: hỏi tôi đang đồng bộ bằng công cụ nào
(rclone, GNOME Online Accounts, Insync...) và thư mục dự án nằm ở đâu.
2. Tư vấn rủi ro khi để .git và node_modules trong thư mục đồng bộ (xung đột, file trùng "(1)",
hỏng kho git, đồng bộ chậm) và đề xuất phương án, ví dụ: dùng GitHub (kho riêng tư) làm kho chính;
không mở cùng một dự án trên hai máy cùng lúc; chờ Drive đồng bộ xong rồi mới chuyển máy;
cài lại node_modules trên mỗi máy. Để tôi chọn, không tự di chuyển dự án.
3. API key, mật khẩu chỉ để trong .env, và .env phải có trong .gitignore.
4. Không đồng bộ nguyên thư mục ~/.claude (có lịch sử phiên và dữ liệu đăng nhập).
Thay vào đó tạo thư mục sao lưu trên Drive (hỏi tôi vị trí, ví dụ "Claude-Config") gồm CLAUDE.md,
settings.json, skills/ và script khoi-phuc.sh để chép ngược về ~/.claude trên máy mới
(script phải sao lưu file cũ trước khi chép).
## BƯỚC 6 — BÁO CÁO CUỐI
Tóm tắt bằng tiếng Việt: đã cài gì; đã tạo/sửa file nào (đường dẫn đầy đủ, kèm file sao lưu);
cách dùng 4 lệnh tắt; việc nào chưa làm được và vì sao; checklist các bước khi chuyển sang máy mới.
Dán vào cửa sổ Claude: nhấp chuột phải hoặc Ctrl+V⌘+VCtrl+Shift+V. Prompt nhiều dòng nhưng dán một lần là đủ.
Duyệt từng bước
Claude làm từng phần rồi dừng lại. Đọc báo cáo, trả lời câu hỏi (tên, email, thư mục Google Drive), rồi gõ tiếp. Khi Claude xin phép: chọn Yes nếu đúng việc đã báo, No nếu không chắc.
Gõ vài chữ trong thông báo lỗi. Chỉ hiện lỗi của Windows và lỗi chung.
Loại máy
Máy 32-bit, Windows 7/8.1, macOS cũ: không cài được
Claude Code cần máy 64-bit và hệ điều hành đủ mới (Windows 10 bản 1809+, macOS 13+, Ubuntu 20.04+/Debian 10+). Máy cũ hơn: dùng Claude trên web tại claude.ai. Xem trang Kiểm tra máy.
Dùng trên iPad, điện thoại, máy tính bảng
Không cài được Claude Code, Claude Desktop hay Antigravity trên các thiết bị này. Dùng ứng dụng Claude trên App Store / Google Play, hoặc Claude Code trên web.
Máy Windows chip ARM (Snapdragon): tải nhầm bản
Chạy $env:PROCESSOR_ARCHITECTURE. Kết quả ARM64 thì tải bản ARM64 của Claude Desktop và Antigravity. Claude Code và bộ cài skill tự nhận đúng loại máy.
Cài Claude Code
“Cannot find path…”, “No such file or directory” khi gõ lệnh cd
Đường dẫn thư mục không đúng (thường gõ sai tên, thiếu dấu ngoặc kép khi tên có dấu cách). Gõ cd (có dấu cách) rồi kéo thả thư mục vào cửa sổ lệnh để đường dẫn tự điền đúng, rồi nhấn Enter.
“working directory is a network path”
Đang mở Claude trong thư mục mạng dạng \\may-chu\thu-muc. Gán thư mục đó thành ổ đĩa (File Explorer → chuột phải This PC → Map network drive) hoặc chép dự án về ổ máy.
“Constrained Language Mode”, máy công ty chặn PowerShell
Máy bị chính sách bảo mật giới hạn PowerShell, không tự sửa được. Nhờ bộ phận IT cho phép chạy, hoặc dùng Claude Desktop (không cần gõ lệnh).
“zsh: command not found: brew”
Máy chưa có Homebrew. Không cần Homebrew cho Claude Code; muốn cài Node.js thì tải bản LTS tại nodejs.org, hoặc cài Homebrew theo hướng dẫn tại brew.sh.
“irm is not recognized” hoặc “The token '&&' is not a valid…”
Bạn đang dán lệnh vào nhầm loại cửa sổ. Mở đúng PowerShell (dòng lệnh bắt đầu bằng PS) rồi chạy:
PowerShell
irm https://claude.ai/install.ps1 | iex
Lệnh cài chỉ in ra chữ mà không cài
Chưa chép đủ lệnh. Phải có cả phần | iex ở cuối: irm https://claude.ai/install.ps1 | iex
winget báo “Failed when searching source: msstore”, “0x8a15005e : The server certificate did not match…”
winget tìm cả trong kho Microsoft Store (msstore) nhưng mạng hoặc phần mềm diệt virus đang “kiểm tra” kết nối nên chứng chỉ không khớp. Gói cần cài vẫn có trong kho winget (dòng “Claude Code Anthropic.ClaudeCode winget” ở cuối thông báo). Cách sửa: chỉ định rõ kho winget bằng --source winget:
Muốn lần sau không phải thêm, mở PowerShell bằng quyền quản trị và chạy lệnh dưới. Dòng đầu tắt kho Microsoft Store, dòng sau cho phép winget chấp nhận chứng chỉ của mạng:
Lưu ý: nếu bạn đã cài Claude Code thành công bằng lệnh irm https://claude.ai/install.ps1 | iex thì không cần cài thêm bằng winget. Cài hai bản sẽ bị nhầm phiên bản. Kiểm tra bằng where.exe claude: chỉ nên có một dòng.
“npm : The term 'npm' is not recognized…”
Máy chưa cài Node.js (npm đi kèm Node.js), hoặc cửa sổ PowerShell mở từ trước khi cài. Claude Code không cần npm: dùng lệnh cài chính thức ở trang Claude Code là đủ. Nếu vẫn muốn có npm, cài Node.js rồi đóng và mở lại PowerShell:
Mở lại PowerShell, kiểm tra bằng npm --version. Báo “running scripts is disabled” thì làm bước “Cho phép PowerShell chạy script”.
Lỗi 403, “App unavailable in region”, lỗi có mã HTML, “ParserError”, “syntax error near unexpected token '<'”
Mạng đang chặn máy chủ tải, hoặc khu vực chưa được hỗ trợ. Thử đổi mạng (ví dụ phát Wi-Fi từ điện thoại), tắt VPN, rồi cài lại. Hoặc cài theo cách khác:
“node/npm is not recognized”“zsh: command not found: node / npm”“node: command not found” sau khi cài Node.js
Cửa sổ lệnh được mở từ trước khi cài. Đóng hết cửa sổ PowerShellTerminal, mở lại rồi thử node --version. Vẫn lỗi thì cài lại theo bước “Cài Node.js” ở trang Claude Code.
“xcrun: error: invalid active developer path”
Máy thiếu bộ công cụ dòng lệnh của Apple (có Git). Cài bằng:
Terminal
xcode-select --install
Lệnh claude
“claude : The term 'claude' is not recognized…”“zsh: command not found: claude”“bash: claude: command not found”
Máy chưa biết chỗ để tìm lệnh claude. Làm bước “Giúp máy tìm thấy lệnh claude” ở Claude Code, rồi đóng và mở lại cửa sổ lệnh. Chạy tạm bằng đường dẫn đầy đủ:
PowerShell
& "$env:USERPROFILE\.local\bin\claude.exe"
Terminal
~/.local/bin/claude
“claude is not recognized” ngay sau khi Claude tự cập nhật
Vẫn lỗi thì cài lại: irm https://claude.ai/install.ps1 | iex
Gõ claude lại mở ứng dụng Claude Desktop
Cập nhật Claude Desktop lên bản mới nhất rồi thử lại: winget upgrade --id Anthropic.Claude -e --source winget
Có nhiều bản Claude Code, phiên bản không đúng
Xem các bản đang có, chỉ nên có một dòng:
PowerShell
where.exe claude
Terminal
which -a claude
Có bản cài bằng npm thì gỡ: npm uninstall -g @anthropic-ai/claude-code
Đăng nhập & tài khoản
Trình duyệt không tự mở khi đăng nhập, không dán được mã
Ở màn hình đăng nhập nhấn phím c để chép đường link, dán vào trình duyệt. Không dán được mã thì dùng lệnh:
Lệnh
claude auth login
“OAuth error: Invalid code”
Mã hết hạn. Nhấn Enter để thử lại và đăng nhập ngay khi trình duyệt mở.
“403 … Request not allowed”, bị yêu cầu nâng cấp gói
Kiểm tra gói trả phí còn hiệu lực tại claude.ai/settings. Gói miễn phí không dùng được Claude Code. Sau đó gõ /logout, thoát, mở lại claude và đăng nhập lại.
“This organization has been disabled”, “Invalid API key”
Nhập mật khẩu máy Mac, rồi chạy claude doctor để kiểm tra.
Khi đang làm việc
“You've hit your limit”, hết lượt dùng
Đã dùng hết lượt trong khoảng thời gian đó; thông báo có ghi giờ được dùng lại. Xem bằng /usage. Tiết kiệm bằng cách dùng /clear khi đổi việc.
“429”, “529 Overloaded”, “500”, “No response from API”
Máy chủ đang bận. Claude tự thử lại; nếu vẫn lỗi, chờ vài phút rồi gửi lại.
“Prompt is too long”, “Context limit reached”
Cuộc trò chuyện quá dài. Gõ /compact để tóm gọn, hoặc /clear để bắt đầu mới.
“Unable to connect to API”, mất kết nối
Kiểm tra Internet, tắt thử VPN. Mạng công ty: nhờ IT cho phép api.anthropic.com.
Claude hỏi xác nhận quá nhiều lần
Khi được hỏi, chọn Yes, and don't ask again cho việc an toàn. Xem và sửa danh sách bằng /permissions. Trang Cấu hình nâng cao thêm sẵn danh sách lệnh an toàn.
Claude không nhớ việc hôm trước
Làm tiếp cuộc trò chuyện cũ bằng claude -c. Để nhớ lâu dài, kể cả trên máy khác, làm trang Cấu hình Claude và dùng /tiep-tuc.
File Claude tạo bị lỗi dấu tiếng Việt
Nhắc Claude: “ghi file bằng UTF-8”. Prompt ở trang Cấu hình Claude đã có sẵn quy tắc này.
“Operation not permitted” khi Claude mở thư mục Documents, Desktop, Google Drive
Mở System Settings → Privacy & Security → Files and Folders (hoặc Full Disk Access), bật quyền cho Terminal hoặc Antigravity, rồi mở lại.
Claude Desktop & Cowork
“Virtualization is not available”, Cowork không chạy
Làm bước “Bật ảo hoá cho Cowork” ở trang Claude Desktop. Chạy PowerShell bằng quyền quản trị:
Khởi động lại máy. Máy ảo hoặc máy tính dùng chung từ xa (VDI) có thể không chạy được Cowork.
Bộ cài Claude Desktop báo lỗi, không cài được
Bộ cài cần quyền quản trị (hộp thoại “Do you want to allow…”). Thử cài bằng lệnh winget install --id Anthropic.Claude -e --source winget, cập nhật Windows (Settings → Windows Update), hoặc nhờ người quản lý máy cài giúp.
Tab Code báo lỗi 403 hoặc lỗi đăng nhập
Đăng xuất rồi đăng nhập lại từ menu ứng dụng, khởi động lại ứng dụng.
Tab Code báo lỗi Git
Cài Git theo bước “Cài Git” ở trang Claude Code, rồi khởi động lại Claude Desktop.
Antigravity & extension
Claude chạy ở cửa sổ lệnh ngoài không hiện thay đổi trong Antigravity
Gõ /ide trong Claude để nối với Antigravity. Chạy claude ngay trong Terminal của Antigravity thì tự nối.
Extension kẹt ở “Installing”
Chạy Reload Window, hoặc cài từ file VSIX (xem bước “Cài thêm extension” ở trang Antigravity). Không bắt buộc: gõ claude trong Terminal của Antigravity là dùng được đầy đủ.
Không thấy biểu tượng Claude sau khi cài extension
Mở một file bất kỳ (biểu tượng chỉ hiện khi đang mở file). Nếu thư mục ở chế độ hạn chế (Restricted Mode), bấm thông báo phía trên để tin cậy thư mục. Rồi chạy Reload Window.
Cửa sổ lệnh ngoài gõ claude được, trong Antigravity thì không
Antigravity mở từ trước khi cài. Đóng tất cả cửa sổ Antigravity rồi mở lại.
Không gõ được tiếng Việt trong Antigravity
Antigravity đang chạy bằng quyền quản trị còn Unikey thì không. Mở lại Antigravity bình thường, hoặc chạy Unikey bằng Run as administrator.
Skill thể thức văn bản
“Windows protected your PC” khi mở file .bat
Bấm More info → Run anyway. Phần mềm diệt virus chặn thì cho phép file này hoặc tạm tắt khi cài.
macOS không cho mở file .command
System Settings → Privacy & Security → Open Anyway. Hoặc chạy bằng Terminal:
Máy chưa có Python và không tự cài được (thường do mạng). Kiểm tra mạng rồi chạy lại bộ cài. Hoặc tải Python tại python.org/downloads (khi cài nhớ tích “Add python.exe to PATH”), rồi chạy lại bộ cài.
“Không chép được… đang giữ file”
Đóng Claude Code, Claude Desktop, Antigravity rồi chạy lại bộ cài.
“File bị hỏng hoặc bị cắt xén”
Tải lại bộ cài, giải nén lại rồi chạy.
Claude vẫn không dùng skill khi soạn văn bản
Đóng hẳn rồi mở lại Claude. Trên Claude web cần tải file the-thuc-van-ban.zip lên mục Skills (xem trang Skill).
Git & Google Drive
“detected dubious ownership in repository”
Cho phép đúng thư mục trong thông báo lỗi (thay đường dẫn ví dụ, dùng dấu /):
Có file trùng tên “(1)”, file bị ghi đè sau khi đổi máy
Hai máy cùng sửa khi Google Drive chưa đồng bộ xong. Không mở cùng một dự án trên hai máy cùng lúc; trước khi đổi máy, đóng Claude và chờ Drive báo đồng bộ xong.
Muốn lưu luôn: xem mục “Chữ tiếng Việt bị lỗi” ở trang Claude Code.
Unikey không gõ được dấu
Cửa sổ đang chạy bằng quyền quản trị thì Unikey cũng phải chạy bằng quyền quản trị. Cách gọn: mở cửa sổ đó bình thường.
Gõ tiếng Việt trong Terminal bị nhảy chữ
Dùng bộ gõ Tiếng Việt có sẵn của macOS (System Settings → Keyboard → Input Sources, thêm Vietnamese – Telex), hoặc soạn nội dung ở nơi khác rồi dán vào.
Linux
“E: Unable to locate package claude-desktop”
Máy chưa nhận kho phần mềm vừa thêm. Chạy lại sudo apt update rồi cài lại. Kiểm tra loại chip bằng dpkg --print-architecture: chỉ amd64 và arm64 được hỗ trợ.
“unmet dependencies … libc6 (>= 2.34)”
Hệ điều hành quá cũ cho Claude Desktop (ví dụ Ubuntu 20.04). Nâng cấp lên Ubuntu 22.04+ hoặc Debian 12+, hoặc dùng Claude Code dòng lệnh.
“Cowork requires hardware virtualization (KVM)”, “permission to use virtualization (/dev/kvm)”
Bật ảo hoá trong BIOS, rồi cho tài khoản quyền dùng ảo hoá và đăng xuất, đăng nhập lại:
“Running as root without --no-sandbox is not supported”
Đang mở Claude Desktop bằng tài khoản root. Đăng nhập tài khoản thường rồi mở lại.
“Permission denied” khi chạy file .sh
Chạy bằng lệnh bash cai-dat-the-thuc-van-ban.sh thay vì ./cai-dat-the-thuc-van-ban.sh.
Dán lệnh bằng Ctrl+V không được
Trong Terminal của Linux, dán bằng Ctrl+Shift+V hoặc chuột phải → Paste.
Không tìm thấy. Thử từ khoá ngắn hơn, chạy claude doctor, hoặc xem tài liệu chính thức.
Mọi file cần thiết ở một chỗ
Tải về
Mọi bộ cài và tài liệu ở một chỗ, cho máy Windows.
Bộ cài 1 chạm (khuyên dùng)
Mới
Tự chọn phần mềm cần cài (Claude Desktop, Claude Code, Antigravity, Git, Node.js, skill thể thức…), trang tạo một file cài chứa đúng các mục đó.
Chỉ cài skill thể thức văn bản
Chạy 1 lần là xong
Cài skill cho Claude Code, Claude Desktop và Antigravity, tự kiểm tra Python và tạo thử file Word mẫu.
Mở thư mục Downloads, nhấp đúp file Bo-cai-the-thuc-van-ban-Windows.zip. Windows mở nó ra như một thư mục.
Nhấp đúp file Cai-dat-the-thuc-van-ban.bat bên trong. Nếu Windows hỏi, chọn Run, hoặc chuột phải file .zip → Extract All rồi chạy file .bat trong thư mục vừa giải nén.
Hiện khung xanh “Windows protected your PC” thì bấm More info → Run anyway. Chờ đến dòng CÀI ĐẶT THÀNH CÔNG.
Mở thư mục Downloads, nhấp đúp file Bo-cai-the-thuc-van-ban-macOS.zip để giải nén.
Nhấp đúp file cai-dat-the-thuc-van-ban.command.
macOS chặn thì vào System Settings → Privacy & Security → Open Anyway. Chờ đến dòng CÀI ĐẶT THÀNH CÔNG.
Mở thư mục Downloads, chuột phải file Bo-cai-the-thuc-van-ban-Linux.zip → Extract Here (Giải nén tại đây).
Mở thư mục chứa file cai-dat-the-thuc-van-ban.sh, chuột phải vào khoảng trống → Open in Terminal.
Gõ bash cai-dat-the-thuc-van-ban.sh rồi nhấn Enter. Chờ đến dòng CÀI ĐẶT THÀNH CÔNG.
Máy khác: · ·
Vì sao tải về là file .zip mà không phải file .bat.command.sh?
Claude và trình duyệt không cho trang web tải trực tiếp các file chạy được (.bat, .command, .exe) để chống mã độc. File cài đặt nằm sẵn trong file .zip. Trên Windows chỉ cần mở file .zip rồi nhấp đúp file .bat, không bắt buộc giải nén trước.Trên Mac, file .zip còn giúp giữ quyền chạy của file .command.Trên Linux, file .zip giữ nguyên quyền chạy của file .sh.
Phần mềm cần cài
Các nút dưới đây mở trang tải chính thức của từng hãng.
Antigravity IDEPhần mềm viết code miễn phí của Google.Mở trang tải
Chọn mục Antigravity IDE · hướng dẫn
GitQuản lý phiên bản file. Cần cho tab Code của Claude Desktop.Tải cho WindowsCài bằng 1 lệnh
Máy Mac cài Git bằng lệnh xcode-select --installCài bằng 1 lệnh
Ubuntu/Debian: sudo apt install git
Node.js LTSChỉ cần khi làm dự án web, JavaScript.Mở trang tải
Chọn bản LTS
PythonChỉ cần khi bộ cài skill báo “Python: LỖI”.Mở trang tải
Khi cài, nhớ tích Add python.exe to PATH
Claude CodeCài bằng 1 câu lệnh, không có file tải về.Xem lệnh cài
Tài liệu
Prompt cấu hình ClaudeBản viết riêng cho Windows, dạng file chữ để lưu hoặc gửi người khác.
Hướng dẫn cài skillHướng dẫn từng bước và bảng xử lý lỗi của bộ cài.
Tra cứu nhanh
Từ điển & mẹo
Giải thích từ ngữ
PowerShellTerminal
Cửa sổ để gõ lệnh cho máy tính. Mọi khung lệnh trong cẩm nang đều dán vào đây.
Lệnh (command)
Một dòng chữ ra lệnh cho máy làm việc gì đó. Sao chép, dán, nhấn Enter là chạy.
Claude Code
Claude chạy trong cửa sổ lệnh, đọc và sửa file trong thư mục bạn mở.
Claude Desktop
Ứng dụng Claude có giao diện, gồm Chat, Cowork và Code.
Skill
Gói kiến thức và công cụ dạy Claude làm một việc theo đúng cách, ví dụ trình bày văn bản đúng thể thức.
Prompt
Đoạn yêu cầu bạn gửi cho Claude.
Extension
Tiện ích cài thêm vào phần mềm viết code (Antigravity, VS Code).
PATH
Danh sách thư mục máy tính tìm lệnh. Lệnh “not recognized / not found” thường do thiếu mục này.
Git
Công cụ lưu lại lịch sử thay đổi của file, cho phép quay lại bản trước.
Python
Ngôn ngữ lập trình; skill thể thức văn bản dùng nó để tạo file Word. Bộ cài tự lo.
Chụp toàn bộ trang web trong Chrome
Nhấn F12⌘+Option+I để mở công cụ nhà phát triển.
Nhấn Ctrl⌘+Shift+P, gõ screenshot.
Chọn Capture full size screenshot. Ảnh tự lưu vào thư mục Downloads.