Bài 2 — Cài đặt & phiên đầu tiên

#Vấn đề: muốn thử nhưng không biết bắt đầu từ đâu

Bạn đã đọc bài 1, hiểu Claude Code là gì, muốn thử ngay — nhưng mở terminal ra thì gõ gì? Cài như nào? Đăng nhập ở đâu?

Bài này dẫn bạn từ con số 0 đến phiên đầu tiên chạy thành công, trên mọi nền tảng.

#Yêu cầu hệ thống

Trước khi cài, kiểm tra máy bạn đã có chưa:

node --version   # Cần Node.js 18 trở lên

Chưa có Node? Cài từ nodejs.org — chọn bản LTS. Hoặc dùng nvm/fnm nếu bạn thích quản lý nhiều version.

Ngoài Node.js, bạn cần một trong các tài khoản sau để đăng nhập:

• Claude Pro hoặc Claude Max (nếu đã đăng ký)
• Anthropic Console account (tạo tại console.anthropic.com)

#Cài đặt

Chọn cách phù hợp với hệ điều hành của bạn.

#macOS / Linux / WSL

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

Một lệnh duy nhất. Script sẽ tự động tải và cài đặt Claude Code.

#Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Mở PowerShell với quyền chạy script (nếu bị chặn, chạy Set-ExecutionPolicy RemoteSigned -Scope CurrentUser trước).

#Homebrew (macOS)

brew install --cask claude-code

#WinGet (Windows)

winget install Anthropic.ClaudeCode

#Kiểm tra cài đặt thành công

claude --version

Thấy phiên bản là xong. Ví dụ output:

Claude Code 1.0.x

⚠️ Cẩn thận: Phiên bản Node.js

Claude Code yêu cầu Node.js 18 trở lên. Nếu bạn đang dùng Node 16 hoặc thấp hơn, cài đặt có thể chạy được nhưng sẽ lỗi bất ngờ khi dùng. Kiểm tra trước bằng node --version. Đừng bỏ qua bước này — đây là lỗi cài đặt phổ biến nhất.

#Đăng nhập lần đầu

Lần đầu chạy claude, hệ thống sẽ hỏi bạn đăng nhập. Quy trình khá tự nhiên:

1. Chạy claude trong terminal
2. Terminal hiển thị link đăng nhập + mã xác thực
3. Mở link trong trình duyệt
4. Đăng nhập bằng tài khoản Anthropic
5. Approve quyền truy cập
6. Quay lại terminal — đã sẵn sàng

Sau lần đầu, bạn không cần đăng nhập lại (token được lưu local).

#Phiên đầu tiên: Hello World

Tạo một thư mục test để thử, tránh ảnh hưởng dự án thật:

mkdir claude-test && cd claude-test
npm init -y

Khởi động Claude Code:

claude

Terminal chuyển sang giao diện chat. Giờ bạn có thể nói chuyện trực tiếp với Claude về code.

Thử prompt đầu tiên:

> Tạo một file hello.js in "Hello from Claude Code" ra console,
  rồi chạy nó cho tôi xem output.

Claude Code sẽ:

1. Tạo file hello.js
2. Viết code vào đó
3. Chạy node hello.js
4. Hiển thị output

Bạn sẽ thấy diff của file trước khi nó lưu. Nếu đồng ý, approve. Nếu muốn sửa, nói luôn.

#Đọc output: hiểu Claude Code đang làm gì

Khi Claude Code thực hiện task, terminal hiển thị rõ ràng:

• File nó đang đọc — biết nó hiểu context nào
• Diff trước khi sửa — thấy chính xác thay đổi gì
• Command nó định chạy — approve trước khi thực thi
• Kết quả từng bước — biết tiến trình đến đâu

Đây là điểm quan trọng: bạn kiểm soát mọi bước. Claude Code không tự ý chạy lệnh hay sửa file mà không cho bạn xem trước.

⚠️ Cẩn thận: Đọc kỹ trước khi approve

Anti-pattern lớn nhất khi mới dùng: thấy diff dài là bấm approve luôn mà không đọc. Đừng. Nhất là khi Claude Code sửa file liên quan đến logic xử lý tiền, xác thực, hoặc database. Đọc diff mất 30 giây, sửa hậu quả mất 30 phút. Lấy thói quen đọc ngay từ đầu.

#Prompt đầu tiên trên dự án thật

Giờ thử trên dự án thật của bạn. Thoát phiên test (/exit hoặc Ctrl+C), rồi:

cd du-an-cua-ban
claude

Thử các prompt khởi đầu:

> Giải thích kiến trúc dự án này. Các thư mục chính chứa gì?

> Dự án này dùng framework gì? Danh sách dependencies quan trọng nhất?

> Có test không? Chạy test giúp tôi.

Những prompt này giúp bạn hiểu cách Claude Code đọc và phân tích codebase. Nó không trả lời chung chung — nó đọc đúng file trong dự án bạn.

#Các lệnh cơ bản cần biết

Trong phiên Claude Code, một số lệnh hữu ích:

CLAUDE.md là file đặc biệt — nó chứa hướng dẫn persistent cho Claude Code về dự án của bạn. Sẽ nói kỹ hơn ở bài sau.

#Cập nhật tự động

Claude Code cài đặt native sẽ tự động cập nhật nền (background auto-update). Bạn không cần chạy lệnh update thủ công. Khi có phiên bản mới, lần chạy tiếp theo sẽ dùng bản mới nhất.

#Tóm tắt

Quy trình cài đặt chỉ mất 2 phút:

1. Cài Node.js 18+ (nếu chưa có)
2. Chạy lệnh cài đặt phù hợp hệ điều hành
3. Đăng nhập lần đầu qua trình duyệt
4. cd vào dự án, chạy claude, bắt đầu

Điểm mấu chốt: hãy đọc output trước khi approve. Đó là thói quen quan trọng nhất khi dùng agent coding.

Bài tiếp theo: Hướng dẫn tạo và sử dụng CLAUDE.md — cách "dạy" Claude Code về dự án của bạn để nó làm việc hiệu quả hơn mỗi lần chạy.