Dựng máy trong 45 phút (Windows)

Node, Git, VS Code, Claude Code, wrangler — cài đúng thứ tự, kiểm từng bước, kèm cách chữa 6 lỗi hay gặp trên Windows.

Bài này là bài làm, không phải bài đọc. Cuối bài bạn có một máy đủ sức làm mọi việc trong giáo trình. Hướng dẫn cho Windows 10/11; macOS và Linux tương tự, chỗ nào khác sẽ ghi rõ.

Bước 0 — Mở đúng cửa sổ dòng lệnh

Bấm Win, gõ PowerShell, mở Windows PowerShell. Đây là nơi bạn sẽ gõ lệnh suốt giáo trình.

Hai điều cần biết ngay:

• Dán vào PowerShell bằng chuột phải, không phải Ctrl+V (tùy cấu hình).
• Lệnh cd để đổi thư mục: cd C:\NVAI\Claude — nếu đường dẫn có dấu cách thì bọc nháy kép.

Bước 1 — Node.js (20 phút)

Node là bộ chạy JavaScript ngoài trình duyệt. Mọi công cụ sau đều cần nó.

Tải bản LTS tại nodejs.org → chạy file .msi → Next hết → xong.

Kiểm:

node -v
npm -v

Phải ra kiểu v22.x.x (hoặc mới hơn) và 10.x.x. Nếu báo "không nhận lệnh": đóng hẳn PowerShell rồi mở lại (biến môi trường chỉ nạp khi mở cửa sổ mới).

$env:Path = "C:\tools\node;" + $env:Path
node -v

Bước 2 — Git (5 phút)

Tải git-scm.com/download/win → chạy → để nguyên mọi tùy chọn mặc định (bộ cài này có nhiều trang, mặc định đều đúng cho người mới).

Kiểm và khai tên:

git --version
git config --global user.name "Ten Cua Ban"
git config --global user.email "email@cua.ban"
git config --global init.defaultBranch main

Tên và email này sẽ hiện trong mọi mốc lịch sử — dùng đúng email GitHub của bạn.

git config --global core.autocrlf false

Bước 3 — VS Code (5 phút)

Tải code.visualstudio.com. Đây là nơi bạn đọc mã, dù AI là người viết. Việc đọc được là việc quyết định bạn có đi xa được hay không.

Cài 2 tiện ích (bấm biểu tượng ô vuông bên trái, tìm theo tên):

• Vietnamese Language Pack — nếu muốn giao diện tiếng Việt.
• Prettier — tự dàn mã cho dễ đọc.

Thêm một tiện ích rất hợp với giáo trình này: Cloudflare Workers (xem log, xem binding).

Bước 4 — Claude Code (10 phút)

Đây là trái tim của cách làm việc trong giáo trình.

npm install -g @anthropic-ai/claude-code
claude --version

Nếu npm install -g báo lỗi quyền: mở PowerShell bằng Run as administrator, hoặc dùng cách không cần quyền:

npx @anthropic-ai/claude-code

Lần đầu chạy, nó mở trình duyệt để bạn đăng nhập tài khoản Anthropic. Bạn tự đăng nhập — không đưa mật khẩu cho ai, kể cả cho trợ lý đang hướng dẫn bạn.

Chạy thử trong một thư mục trống:

mkdir C:\NVAI\thu-nghiem
cd C:\NVAI\thu-nghiem
claude

Khi dấu nhắc hiện ra, gõ:

Tạo file index.html hiển thị "Xin chào" bằng tiếng Việt, nền trắng, chữ đen, căn giữa.

Nó sẽ xin phép sửa file. Đồng ý. Rồi mở file bằng cách bấm đúp — đó là lần đầu tiên bạn có một đồng nghiệp ngồi trong máy.

Bước 5 — Wrangler (5 phút)

wrangler là công cụ dòng lệnh của Cloudflare: tạo project, chạy thử ở máy, deploy, xem log, truy vấn cơ sở dữ liệu.

npm install -g wrangler
wrangler --version
wrangler login

wrangler login mở trình duyệt, bạn bấm Allow. Kiểm đã nối đúng tài khoản:

wrangler whoami

node C:\tools\node\node_modules\wrangler\bin\wrangler.js --version

Bước 6 — Thư mục làm việc

Một quy ước nhỏ, lợi suốt năm: mọi project nằm trong một thư mục mẹ, đường dẫn không dấu, không dấu cách.

mkdir C:\NVAI\Claude
cd C:\NVAI\Claude

Vì sao: đường dẫn kiểu C:\Users\Nguyễn Văn A\Tài liệu\dự án làm vỡ kha khá công cụ dòng lệnh, và lỗi nó báo ra chẳng liên quan gì tới nguyên nhân thật. Mất một buổi để tìm.

Bảng kiểm cuối bài

Dán cả khối này vào PowerShell. Năm dòng đều phải ra số phiên bản:

node -v; npm -v; git --version; claude --version; wrangler --version

curl -X POST https://api.cua-ban.com/thu --data-binary "@du-lieu.json"