Tóm tắt: macOS, Linux chạy curl -fsSL https://claude.ai/install.sh | bash. Windows mở PowerShell chạy irm https://claude.ai/install.ps1 | iex. Đóng cửa sổ, mở cửa sổ mới, gõ claude --version để kiểm tra. Bản cài này không cần Node.js. Muốn dùng, bạn cần gói Claude trả phí (Pro, Max…) hoặc một API key.
Claude Code là gì?
Claude Code là công cụ lập trình bằng AI của Anthropic. Bạn gõ yêu cầu bằng lời thường, Claude Code đọc mã nguồn trong thư mục dự án, sửa tệp và chạy lệnh giúp bạn. Bản phổ biến nhất chạy trong cửa sổ dòng lệnh (terminal). Bài này hướng dẫn cài bản đó.
Nếu không quen terminal, Anthropic còn có ứng dụng Claude Desktop với Claude Code dạng giao diện đồ hoạ, không cần gõ lệnh.
Cần phân biệt hai việc: cài Claude Code và trả tiền để dùng. Lệnh cài chỉ tải chương trình về máy; tài khoản được hỏi khi bạn chạy claude lần đầu. Lúc đó bạn mới phải chọn trả bằng gói tháng hay bằng API (xem mục Đăng nhập).
Yêu cầu máy tính
Theo trang cài đặt chính thức của Claude Code (đọc ngày 08/10/2026):
- Hệ điều hành: macOS 13.0 trở lên; Windows 10 bản 1809 trở lên hoặc Windows Server 2019 trở lên; Ubuntu 20.04+, Debian 10+, Alpine 3.19+.
- Máy: RAM từ 4 GB, chip x64 hoặc ARM64 (cả Mac chip Intel lẫn chip M).
- Mạng: cần kết nối internet.
- Cửa sổ lệnh: Bash, Zsh, PowerShell hoặc CMD.
Bản cài chính thức (gọi là bản native) không cần Node.js. Chỉ khi cài qua npm mới cần Node.js 22 trở lên. Bạn cũng không cần quyền quản trị (Administrator).
Cài Claude Code trên macOS
- Mở ứng dụng Terminal (nhấn Cmd + Space, gõ "Terminal").
- Dán lệnh sau rồi nhấn Enter:
curl -fsSL https://claude.ai/install.sh | bash
Lệnh cài không hiện thanh tiến trình khi tải, nên có lúc màn hình đứng yên một lúc. Cứ chờ đến khi lệnh chạy xong.
Cách khác cho Mac: Homebrew. Nếu bạn đã dùng Homebrew:
brew install --cask claude-code
Bản Homebrew không tự cập nhật. Muốn lên bản mới, chạy brew upgrade claude-code.
Cài Claude Code trên Windows
Trên Windows có hai loại cửa sổ lệnh, mỗi loại một lệnh cài khác nhau. Cách nhận biết: dòng nhắc của PowerShell có chữ PS ở đầu (ví dụ PS C:\Users\ban>); CMD thì không có chữ "PS".
Cách 1, PowerShell (dễ nhất): nhấn phím Windows, gõ "PowerShell", mở lên rồi chạy:
irm https://claude.ai/install.ps1 | iex
Cách 2, CMD: nếu bạn đang ở CMD, chạy:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Cách 3, WinGet:
winget install Anthropic.ClaudeCode
Bản WinGet nâng cấp bằng winget upgrade Anthropic.ClaudeCode.
Nên cài thêm Git for Windows. Việc này không bắt buộc, nhưng nên làm: tải ở git-scm.com/downloads/win. Có Git for Windows, Claude Code dùng Git Bash để chạy lệnh; không có thì nó dùng PowerShell.
Dùng WSL 2: nếu bạn lập trình trong WSL, hãy mở terminal WSL rồi cài và chạy Claude Code ngay bên trong đó, bằng lệnh cài của Linux ở mục dưới.
Cài Claude Code trên Linux
Ubuntu, Debian (và WSL) dùng cùng lệnh với macOS. Alpine thiếu sẵn bash và curl: chạy trước apk add bash curl libgcc libstdc++ ripgrep, rồi xem thêm hướng dẫn Alpine trên trang của Anthropic.
curl -fsSL https://claude.ai/install.sh | bash
Cài qua npm (mọi hệ điều hành, cần Node.js 22 trở lên):
npm install -g @anthropic-ai/claude-code
Không chạy lệnh này với sudo. Nếu không có lý do riêng, hãy dùng bản native ở trên: đây là cách Anthropic khuyên dùng và không cần Node.js.
Kiểm tra và sửa lỗi hay gặp
Kiểm tra cài xong chưa: đóng cửa sổ terminal, mở cửa sổ mới, gõ:
claude --version
Nếu thấy số phiên bản, ví dụ 2.1.211 (Claude Code), là đã cài xong. Muốn kiểm tra kỹ hơn, chạy claude doctor.
Các lỗi hay gặp:
- "command not found" hoặc "not recognized": thư mục cài Claude Code chưa có trong PATH (danh sách nơi máy tìm lệnh). Trước hết hãy đóng hẳn terminal và mở cửa sổ mới, vì cửa sổ cũ chưa nhận PATH mới. Trên Mac vẫn lỗi thì chạy echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc rồi source ~/.zshrc. Vẫn lỗi thì xem mục xử lý lỗi trên trang cài đặt chính thức.
- "The token '&&' is not a valid statement separator": bạn đang chạy lệnh của CMD trong PowerShell. Dùng lệnh irm … | iex thay vào.
- "'irm' is not recognized": ngược lại, bạn đang ở CMD. Dùng lệnh curl … install.cmd, hoặc mở PowerShell.
- Cập nhật: bản native tự cập nhật ngầm. Muốn cập nhật ngay, chạy claude update. Bản Homebrew và WinGet phải nâng cấp bằng lệnh riêng như đã nêu ở trên.
Đăng nhập: gói tháng hay API?
Cài xong, vào thư mục dự án và gõ claude. Lần đầu, Claude Code hỏi cách đăng nhập ngay trong cửa sổ lệnh rồi mở trình duyệt. Theo tài liệu của Anthropic, Claude Code dùng được với tài khoản Pro, Max, Team, Enterprise hoặc Console, hoặc qua nền tảng đám mây Amazon Bedrock, Google Cloud, Microsoft Foundry. Gói Free của claude.ai không có Claude Code.
Hai cách trả tiền khác nhau thế này:
- Gói tháng (Pro, Max…): trả một số tiền cố định mỗi tháng, đổi lại có hạn mức sử dụng. Dùng hết hạn mức thì phải chờ tính lại hoặc lên gói cao hơn. Giá từng gói có trong bài giá Claude 2026.
- API (trả theo token): token là những mẩu chữ ngắn mà AI đọc vào và viết ra. Dùng bao nhiêu trả bấy nhiêu, không phí tháng. Hợp với người dùng không đều, hoặc muốn biết rõ từng lượt tốn bao nhiêu.
Nếu bạn không có thẻ thanh toán quốc tế, có thể dùng API qua một cổng thanh toán bằng VNĐ như APIZ, cách cài ở mục ngay dưới. Một buổi làm việc với Claude Code tốn bao nhiêu token được tính chi tiết trong bài chi phí thật khi dùng Claude Code.
Dùng Claude Code với API trả bằng VNĐ qua APIZ
APIZ (apiz.vn) là cổng API trung gian độc lập cho người Việt: một tài khoản gọi được Claude, GPT, Gemini, Grok, DeepSeek; giá niêm yết bằng VNĐ, trả theo token dùng thật, nạp bằng chuyển khoản VietQR. APIZ không phải đối tác hay đại lý của Anthropic. APIZ không khẳng định kết quả giống hệt khi gọi thẳng Anthropic; tốc độ và giới hạn ngữ cảnh có thể khác. Hãy nạp ít và thử bằng việc thật trước.
Bước 1, lấy key: đăng ký, nạp tiền, rồi vào Bảng điều khiển → Khóa API để tạo key thuộc nhóm Claude. Key mặc định (nhóm Tự động) cũng gọi được Claude.
Bước 2, cấu hình lâu dài: mở (hoặc tạo) tệp ~/.claude/settings.json. Trên Windows, tệp nằm ở %USERPROFILE%\.claude\settings.json: dán đường dẫn này vào thanh địa chỉ File Explorer, hoặc trong PowerShell gõ notepad $env:USERPROFILE\.claude\settings.json. Chưa có thư mục .claude thì chạy claude một lần hoặc tự tạo; lưu bằng Notepad nhớ chọn "All files" để tệp không thành settings.json.txt. Nếu tệp đã có nội dung, chỉ thêm khối "env", đừng tạo khối thứ hai. Ghi nội dung sau, thay sk-... bằng key của bạn:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiz.vn",
"ANTHROPIC_AUTH_TOKEN": "sk-...key-của-bạn"
}
}
Nếu tệp đã có sẵn nội dung, chỉ thêm khối "env" và giữ nguyên các mục khác.
Hoặc thử nhanh trong cửa sổ đang mở (đóng cửa sổ là mất). macOS, Linux:
export ANTHROPIC_BASE_URL="https://api.apiz.vn" export ANTHROPIC_AUTH_TOKEN="sk-..."
Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://api.apiz.vn" $env:ANTHROPIC_AUTH_TOKEN="sk-..."
Windows CMD (không có dấu nháy):
set ANTHROPIC_BASE_URL=https://api.apiz.vn set ANTHROPIC_AUTH_TOKEN=sk-...
Cấu hình này (tệp settings.json hoặc biến môi trường) áp dụng cho Claude Code trong cửa sổ lệnh và tiện ích VS Code; ứng dụng Claude Desktop không đọc các biến này. Nếu máy còn đăng nhập gói Pro/Max, Claude Code sẽ ưu tiên key API khi có biến trên.
Bước 3, chạy thử: sửa tệp xong, chạy claude doctor: lệnh này báo lỗi nếu settings.json sai cú pháp. Rồi vào thư mục dự án, gõ claude, gõ /status để thấy địa chỉ api.apiz.vn, và gửi một yêu cầu ngắn. Sau đó mở Bảng điều khiển → Nhật ký API để xem lượt đó dùng bao nhiêu token và tốn bao nhiêu tiền.
Nếu lần đầu chạy, Claude Code vẫn hiện màn hình chọn cách đăng nhập dù đã đặt các biến trên, cách nhanh nhất là dùng CC Switch như dưới đây.
Không muốn sửa tệp? Dùng ứng dụng CC Switch theo hướng dẫn CC Switch, hoặc xem video Claude Code qua CC Switch trên kênh YouTube API APIZ. Chi tiết đầy đủ có trong tài liệu Claude Code của APIZ.
Lưu ý: đừng bật chế độ ngữ cảnh 1M trong Claude Code, key nhóm Claude sẽ báo lỗi. Giữ key như mật khẩu và đặt hạn mức cho từng key trong Bảng điều khiển.
Giá Claude tại APIZ
Giá mỗi 1 triệu token, nhóm Claude, ngày 20/10/2026. Xem bảng giá mới nhất.
| Mô hình | Đầu vào | Đầu ra | Đọc đệm |
|---|---|---|---|
| Claude Sonnet 5.5 | 9.000 ₫ | 45.000 ₫ | 1.350 ₫ |
| Claude Opus 5.5 | 11.000 ₫ | 55.000 ₫ | 1.650 ₫ |
| Claude Haiku 4.5 | 2.000 ₫ | 10.000 ₫ | 300 ₫ |
"Đọc đệm" là phần ngữ cảnh đã gửi ở lượt trước, được đọc lại với giá thấp. Claude Code gửi lại cả cuộc trò chuyện mỗi lượt, nên phần này chiếm đa số token. Với giả định trong bài chi phí một buổi Claude Code (khoảng 100 lượt gọi), một buổi dùng Sonnet 5.5 tại APIZ tốn khoảng 17.100 ₫. Đây là ví dụ, không phải cam kết: dự án lớn hay phiên dài sẽ tốn hơn. Mỗi lượt có thể cộng phụ phí khởi tạo nhỏ, khoảng 1 ₫.
Các mô hình khác có trong bài API giá rẻ.
Gỡ cài đặt Claude Code
Bản native trên macOS, Linux, gỡ bằng hai lệnh:
rm -f ~/.local/bin/claude rm -rf ~/.local/share/claude
Nếu cài bằng Homebrew, WinGet hay npm, hãy gỡ bằng chính công cụ đó. Trên Windows, làm theo hướng dẫn gỡ trên trang cài đặt chính thức. Muốn bỏ cấu hình APIZ, xoá khối "env" trong settings.json.
Bắt đầu với APIZ trong 3 bước
- Đăng ký tại api.apiz.vn/sign-up. Tài khoản mới có số dư 0 ₫.
- Nạp bằng chuyển khoản: quét mã VietQR, tối thiểu 26.000 ₫, số dư thường được cộng sau khoảng 1 phút. Xem Nạp tiền & chi phí.
- Tạo key và kết nối Claude Code: tạo key nhóm Claude, đặt hạn mức, rồi cấu hình theo mục trên hoặc theo hướng dẫn Claude Code.
Số dư đã nạp không hoàn lại trừ các trường hợp ghi trong Chính sách hoàn tiền, vì vậy hãy bắt đầu bằng khoản nhỏ.
Tóm lại
Cài Claude Code chỉ cần một lệnh: macOS, Linux dùng curl … install.sh | bash, Windows dùng irm … install.ps1 | iex trong PowerShell (hoặc lệnh riêng cho CMD, WinGet). Không cần Node.js, không cần quyền quản trị. Mở cửa sổ mới, gõ claude --version để kiểm tra; lỗi "not recognized" thường do PATH hoặc nhầm PowerShell với CMD. Để dùng, bạn cần gói Claude trả phí hoặc API key. Nếu muốn trả theo token bằng VNĐ, không cần thẻ quốc tế, hãy trỏ Claude Code về APIZ bằng settings.json hoặc CC Switch, nạp ít, thử việc thật và xem Nhật ký API.