Cài đặt Claude Code – Hướng dẫn đầy đủ từ A-Z
Thiết lập Claude Code trên hệ thống của bạn chỉ trong vài bước đơn giản. Hướng dẫn cài đặt và thiết lập Claude Code hoàn chỉnh này bao gồm download, cài đặt, cấu hình và lựa chọn model cho Windows, Mac và Linux.
📝 Lưu ý: Để có hướng dẫn cài đặt cập nhật nhất, hãy truy cập tài liệu chính thức Claude Code.
🖥️ Yêu cầu hệ thống Claude Code
Hệ điều hành được hỗ trợ:
- macOS: 10.15 (Catalina) trở lên
- Windows: 10 trở lên
- Linux: Ubuntu 18.04+, CentOS 7+ hoặc tương đương
Yêu cầu phần cứng:
- RAM: Tối thiểu 4GB (khuyến nghị 16GB)
- Ổ cứng: 500MB không gian trống
- Kết nối internet: Cần thiết để giao tiếp API
📋 Điều kiện tiên quyết
Trước khi cài đặt Claude Code, hãy đảm bảo bạn có:
✅ Node.js phiên bản 18.0 trở lên
✅ API key của Anthropic (lấy từ console.anthropic.com)
✅ Terminal hoặc command prompt
🚀 Cách cài đặt Claude Code: Hướng dẫn từng bước
Tùy chọn 1: npm (Khuyến nghị) ⭐
npm install -g @anthropic-ai/claude-code
Tùy chọn 2: Tải trực tiếp
Tải file binary mới nhất từ trang GitHub releases.
⚙️ Thiết lập và cấu hình Claude Code
Cấu hình API Key
Sau khi cài đặt, cấu hình Claude Code với API key của bạn:
claude config
Bạn sẽ hoàn thành quy trình OAuth một lần với tài khoản Claude PRO/Max hoặc Anthropic Console.
Phương pháp thay thế: Biến môi trường
Bạn cũng có thể đặt API key bằng biến môi trường:
export ANTHROPIC_API_KEY="your-api-key-here"
Thêm dòng này vào shell profile (.bashrc, .zshrc, v.v.) để lưu vĩnh viễn.
💰 Gói đăng ký Claude Max
⚠️ Quan trọng: API của Anthropic tính phí theo mức sử dụng và có thể trở nên đắt đỏ khi sử dụng thường xuyên. Đối với người dùng Claude Code thường xuyên, gói đăng ký Claude Max có thể sẽ tiết kiệm hơn.
🎯 Khi nào nên chọn Claude Max:
✅ Sử dụng Claude Code nhiều giờ mỗi ngày
✅ Làm việc trên codebase lớn
✅ Thực hiện thường xuyên các thao tác multi-file phức tạp
💡 Khuyến nghị cho người mới: Nếu chưa chắc về pattern sử dụng, hãy bắt đầu với ~$20 API credits để test Claude Code với workflow thông thường. Điều này sẽ giúp bạn quyết định có nên đầu tư vào gói Claude Max không.
📊 Chi tiết về giá cả: Xem Hướng dẫn giá Claude AI để so sánh đầy đủ.
📝 Mình đang sử dụng Claude Max 5x.
🧠 Lựa chọn và cấu hình Model Claude Code
Claude Code hỗ trợ nhiều model khác nhau. Bạn có thể chỉ định model nào để có hiệu suất tối ưu:
Claude 4 Sonnet: Hiệu suất cân bằng và tốc độ mới nhất
export ANTHROPIC_MODEL="claude-sonnet-4-20250514"
Claude 4 (4.1) Opus: Khả năng tối đa cho tác vụ phức tạp
export ANTHROPIC_MODEL="claude-opus-4-20250514"
Claude 3.5 Haiku: Nhanh nhất và tiết kiệm chi phí
export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"
Phương pháp thay thế:
Bạn cũng có thể chỉ định model trực tiếp khi khởi động Claude Code:
claude --model claude-sonnet-4-20250514
claude --model claude-opus-4-20250514
claude --model claude-3-5-haiku-20241022
📊 Theo dõi sử dụng: Xem xét add-on cc-usage để monitor usage và cost.
🔍 So sánh chi tiết: Xem Hướng dẫn so sánh Model đầy đủ.
🖥️ Thiết lập Claude Code theo từng hệ điều hành
Windows Setup
Để có trải nghiệm Claude Code tốt nhất trên Windows, hãy làm theo các bước tối ưu sau:
Cài đặt và cấu hình WSL2
1. Cài đặt WSL2 (nếu chưa cài):
wsl --install
2. Cài đặt Linux distribution (khuyến nghị Ubuntu):
wsl --install -d Ubuntu
3. Tối ưu hiệu suất WSL2:
Tạo file .wslconfig trong thư mục Windows user:
# Trong Windows: %USERPROFILE%\.wslconfig
[wsl2]
memory=8GB # Giới hạn memory WSL2
processors=4 # Giới hạn CPU cores
swap=2GB # Đặt kích thước swap
localhostForwarding=true
4. Cập nhật WSL2 lên phiên bản mới nhất:
wsl --update
💻 Khuyến nghị Terminal
Cá nhân mình sử dụng Windows Terminal app để phát triển Claude Code. Bạn có thể tải từ Microsoft Store hoặc GitHub releases.
🔧 Tích hợp Claude Code với VS Code
1. Cài đặt VS Code Extensions:
- WSL Extension:
ms-vscode-remote.remote-wsl - Remote Development Extension Pack:
ms-vscode-remote.vscode-remote-extensionpack
2. Kết nối VS Code với WSL:
# Từ WSL terminal trong thư mục dự án
code .
3. Cài đặt Claude Code VS Code Extension:
Cài đặt extension chính thức từ VS Code Marketplace hoặc tìm “Claude Code” trong panel Extensions của VS Code.
4. Khởi động lại VS Code hoàn toàn để extension có hiệu lực.
5. Sử dụng Claude Code với VS Code:
# Trong VS Code integrated terminal (WSL)
claude
# Hoặc sử dụng lệnh /ide từ terminal bên ngoài để kết nối
6. Tính năng tích hợp VS Code:
- Mở nhanh Claude Code:
Cmd+Esc(Mac) hoặcCtrl+Esc(Windows/Linux) - Chèn file references:
Cmd+Option+K(Mac) hoặcAlt+Ctrl+K(Windows/Linux) - Xem thay đổi đề xuất trong diff viewer của VS Code
✅ Kiểm tra cài đặt Claude Code
Xác minh cài đặt Claude Code bằng cách chạy:
claude --version
Bạn sẽ thấy phiên bản hiện tại của Claude Code được in ra terminal.
🎓 Bước tiếp theo
Đến phần Tutorial để học về thiết lập dự án Claude Code, lệnh cơ bản và tối ưu hóa workflow.
🔍 Từ khóa tìm kiếm phổ biến:
- Cài đặt Claude Code Việt Nam
- Hướng dẫn setup Claude Code tiếng Việt
- Claude Code Windows setup
- Claude Code WSL2 cấu hình
- Cài đặt AI coding tool
- Claude Code VS Code integration
- Anthropic API key setup