On this page16 sections
Claude Code: Hướng Dẫn Cài Đặt Hoàn Chỉnh cho macOS, Windows và Linux
Cài xong trong vòng 30 phút — bất kể bạn đang dùng hệ điều hành nào.
Mở đầu: Khi Terminal trở thành người đồng đội
Bạn đã bao giờ ngồi debug một đoạn code và ước gì có một senior engineer ngồi cạnh, hiểu toàn bộ codebase của bạn và có thể sửa file, chạy lệnh ngay lập tức chưa? Đó chính xác là những gì Claude Code mang lại.
Claude Code là công cụ dòng lệnh (CLI) chính thức của Anthropic dành cho lập trình viên. Không phải autocomplete thông thường — nó đọc toàn bộ repository của bạn, chạy lệnh terminal, chỉnh sửa file và hiểu ngữ cảnh dự án ở mức độ mà không IDE plugin nào sánh được.
Bài viết này sẽ bỏ qua phần marketing và đi thẳng vào những gì thực sự quan trọng: các bước cài đặt dễ bị sai nếu bỏ qua, các thiết lập cần chỉnh ngay từ ngày đầu, và workflow giúp Claude Code trở thành một người cộng sự thực thụ trong terminal của bạn.
Bạn sẽ học được gì?
Cài đặt Claude Code trên macOS, Windows và Linux
Đăng nhập bằng tài khoản Anthropic hoặc API key
Khai báo project đầu tiên và chạy prompt đầu tiên
Cấu hình permissions, hooks và MCP servers
Workflow hàng ngày để làm việc hiệu quả nhất
Yêu cầu trước khi bắt đầu
Bạn cần:
Một terminal đang hoạt động
Node.js 18 trở lên (nếu cài qua npm)
Tài khoản Anthropic (đăng ký tại claude.ai)
Về chi phí: nếu bạn có gói Claude.ai Pro, bạn sẽ được dùng với hạn mức khá rộng rãi. Nếu dùng API key thì tính phí theo token — linh hoạt hơn cho server hoặc CI/CD.
Hệ điều hànhYêu cầu thêmmacOSTerminal hoặc iTerm2, Apple Silicon hoặc Intel đều đượcWindowsWindows 10/11, khuyến nghị dùng WSL2LinuxBất kỳ distro phổ biến nào có shell hiện đại
Cài đặt trên macOS
Cách nhanh nhất là dùng script cài đặt chính thức. Script sẽ tải binary về, đặt vào ~/.local/bin và tự động thêm vào PATH nếu chưa có.
bash
# Cài đặt chính thức (khuyến nghị)
curl -fsSL https://claude.ai/install.sh | sh
# Kiểm tra
claude --versionNếu bạn quen quản lý tool bằng package manager, có thể dùng Homebrew hoặc npm:
bash
# Qua Homebrew
brew install anthropic/claude/claude
# Hoặc qua npm (chạy được trên mọi OS)
npm install -g @anthropic-ai/claude-codeMẹo: Nếu sau khi cài xong mà gõ
claudekhông nhận lệnh, hãy restart terminal để shell nạp lạiPATH.
Cài đặt trên Windows
Trên Windows bạn có hai lựa chọn: Native PowerShell hoặc WSL2.
Đa số team chọn WSL2 vì toàn bộ toolchain developer (Docker, Git, Node) chạy mượt hơn trong môi trường Linux. Nếu bạn dùng WSL2, hãy làm theo các bước của phần Linux bên dưới.
Nếu muốn cài native trên Windows:
powershell
# Mở PowerShell với quyền Admin
npm install -g @anthropic-ai/claude-code
claude --versionLưu ý: Nếu lệnh
claudekhông được nhận diện sau khi cài, hãy restart PowerShell đểPATHmới có hiệu lực.
Cài đặt trên Linux
bash
# Cách khuyến nghị
curl -fsSL https://claude.ai/install.sh | sh
# Hoặc qua npm
npm install -g @anthropic-ai/claude-code
# Xác nhận cài thành công
claude --versionĐăng nhập lần đầu
Chạy lệnh claude trong bất kỳ terminal nào. Trình duyệt sẽ tự mở, bạn đăng nhập tài khoản Anthropic, và CLI sẽ nhận session token. Những lần chạy sau không cần đăng nhập lại.
bash
claude
# → Trình duyệt mở → Đăng nhập → Quay lại terminal và sẵn sàng làm việcDùng API key (cho server hoặc CI/CD): Export trước khi chạy:
bash
export ANTHROPIC_API_KEY=sk-ant-...
claudeKhai báo project đầu tiên
Mở một repository thực (không phải thư mục home) và chạy claude từ bên trong đó. Lần đầu, Claude Code sẽ hỏi xin quyền đọc và chỉnh sửa file trong thư mục đó — hãy cấp quyền cho thư mục gốc của project.
bash
cd ~/code/my-project
claudeBắt đầu bằng một task nhỏ và quan sát được. Ví dụ: nhờ Claude tóm tắt project, tìm entry point, hoặc sửa một bug nhỏ. Mục tiêu là thấy Claude đọc file, chạy lệnh và đề xuất thay đổi trước khi bạn tin tưởng nó với những task lớn hơn.
Cấu hình ngay từ ngày đầu
Ba thiết lập sau đây giúp bạn không phải hối tiếc sau này:
1. Permissions — Phân quyền rõ ràng
Trong file ~/.claude/settings.json, cho phép các shell tool an toàn chạy mặc định, nhưng yêu cầu xác nhận với các lệnh nguy hiểm (xóa file, thao tác Git history, push lên remote).
2. Hooks — Vòng lặp phản hồi tự động
Thêm hook chạy formatter và test suite sau mỗi lần Claude chỉnh sửa file. Khi model làm hỏng gì đó, nó nhận phản hồi ngay lập tức và có thể tự sửa.
3. MCP Servers — Mở rộng ngữ cảnh cho Claude
Kết nối MCP server với database để Claude đọc được schema của bạn, hoặc MCP server của framework đang dùng để nó hiểu tài liệu mà không cần bạn copy-paste thủ công.
Workflow làm việc hiệu quả
Bí quyết thực sự để dùng Claude Code hiệu quả là đối xử với nó như một kỹ sư junior — nhưng cực kỳ nhanh. Hãy brief nó như một đồng nghiệp thực thụ: giải thích mục tiêu, chỉ rõ file liên quan, nêu rõ ràng điều kiện thành công, và review diff của nó như review pull request của teammate.
Checklist workflow hàng ngày:
Đầu mỗi session: Định hướng cho Claude — "Đây là task chúng ta đang làm, đây là file liên quan, đây là định nghĩa thành công."
Viết test trước: Khi có thể, nhờ Claude viết test trước rồi mới implement — nó buộc spec phải rõ ràng ngay từ đầu.
Vòng lặp chặt: Sửa → test → commit. Đừng để Claude stack 10 thay đổi mà không có checkpoint xác minh.
Xử lý sự cố thường gặp
Hầu hết lỗi cài đặt rơi vào ba nhóm:
Triệu chứngNguyên nhânCách xử lýScript cài thất bạiCorporate proxy chặnThử cài qua npm thay vì scriptclaude không được nhận diệnShell chưa nạp PATH mớiRestart terminal, kiểm tra which claudeLỗi Node versionNode quá cũNâng lên Node 18+ bằng nvm hoặc fnm
Quy tắc chung: restart shell trước, kiểm tra which claude, và thử dùng official installer nếu npm có vấn đề.
Tiếp theo bạn nên học gì?
Sau khi cài xong và chạy được, hãy tìm hiểu thêm ba khái niệm này:
Slash commands — tạo workflow có thể tái sử dụng
Hooks — tự động xác minh sau mỗi lần Claude chỉnh sửa
MCP Servers — cho Claude quyền truy cập các nguồn dữ liệu ngoài filesystem
Kết luận
Claude Code không chỉ là thêm một AI tool vào terminal. Khi được thiết lập đúng cách, nó thực sự giống như có thêm một người trong team — người đọc codebase nhanh hơn bạn, không mệt mỏi, và luôn sẵn sàng pair programming lúc 2 giờ sáng.
Cài đặt mất 30 phút. Làm quen mất vài buổi. Nhưng một khi đã quen với workflow này, bạn sẽ khó quay lại cách cũ.