Dùng Claude Code có mất phí không?

Có. Theo tài liệu của Anthropic, Claude Code cần tài khoản Pro, Max, Team, Enterprise hoặc tài khoản Claude Console. Gói claude.ai miễn phí không có quyền dùng Claude Code.

Ở Việt Nam có dùng được Claude Code không?

Được. Việt Nam nằm trong danh sách quốc gia được hỗ trợ cho cả claude.ai và API của Anthropic (kiểm ngày 2026-10-04). Theo tài liệu, thông báo App unavailable in region khi cài nghĩa là Claude Code không có ở quốc gia mà máy chủ nhận diện cho bạn.

Tôi không biết code thì có dùng được không?

Được. Bạn mô tả việc cần làm bằng lời, Claude viết code và giải thích. Điều bạn cần học là cách mô tả rõ ràng và cách đọc những gì Claude định làm trước khi đồng ý.

Có cách nào dùng Claude Code mà không cần terminal không?

Có. Anthropic có ứng dụng Claude desktop cho macOS và Windows, cùng tiện ích cho VS Code và bản web tại claude.ai/code. Bài này tập trung vào terminal vì đó là nơi tài liệu chính thức bắt đầu.

Cài xong, làm sao biết đã thành công?

Mở một cửa sổ terminal mới và gõ claude --version. Nếu máy in ra một số phiên bản kèm chữ (Claude Code) thì đã cài xong.

Claude Code là gì? Cài đặt và chạy lệnh đầu tiên khi chưa biết code

Claude Code là trợ lý lập trình AI của Anthropic. Bạn mô tả việc cần làm bằng tiếng Việt hoặc tiếng Anh, nó đọc file trong thư mục dự án, viết hoặc sửa file và chạy lệnh giúp bạn. Để cài, bạn cần máy macOS 13 hoặc Windows 10 (bản 1809) trở lên, một tài khoản Claude trả phí, và dán đúng một dòng lệnh vào terminal.

Tôi là Haile, UI/UX designer biết code. Site này được dựng bằng Next.js cùng Claude Code, và repo của nó có sẵn file hướng dẫn để Claude đọc mỗi lần làm việc. Bài này viết cho người chưa từng mở terminal. Mọi lệnh bên dưới chép từ tài liệu chính thức của Anthropic, kiểm ngày 2026-10-04.

Claude Code khác gì Claude trên web?

Claude trên claude.ai là cửa sổ chat. Bạn dán nội dung vào, nó trả lời, rồi bạn tự mang câu trả lời đi dùng.

Claude Code làm việc ngay trong thư mục trên máy bạn. Nó tự mở file để đọc, tự tạo file mới, tự chạy lệnh để kiểm tra kết quả. Bạn đóng vai người giao việc và duyệt thay đổi.

Với designer, điều này có nghĩa bạn có thể nói "dựng cho tôi trang landing theo bố cục này" và nhận về một thư mục code mở được ngay trên trình duyệt. Tôi kể kỹ cách làm đó trong bài Claude Code cho designer.

Cần chuẩn bị gì trước khi cài?

Thứ cần có	Yêu cầu theo tài liệu chính thức
Hệ điều hành	macOS 13.0 trở lên, hoặc Windows 10 bản 1809 trở lên
Phần cứng	RAM từ 4 GB, chip x64 hoặc ARM64
Mạng	Cần kết nối internet
Tài khoản	Claude Pro, Max, Team, Enterprise, hoặc Claude Console
Quốc gia	Nằm trong danh sách được hỗ trợ (Việt Nam có trong danh sách)

Gói miễn phí của claude.ai không dùng được Claude Code. Nếu bạn chưa có gói trả phí, hãy nâng cấp trên claude.ai trước khi làm các bước dưới.

Muốn kiểm phiên bản macOS: bấm vào logo Apple ở góc trái màn hình, chọn About This Mac.

Terminal là gì và mở ở đâu?

Terminal là một cửa sổ chỉ có chữ. Bạn gõ lệnh, bấm Enter, máy làm theo và in kết quả ra. Bạn không bấm chuột được vào nội dung bên trong, chỉ dùng bàn phím và phím mũi tên.

Có vài điều nên biết trước khi gõ lệnh đầu tiên:

Dán lệnh bằng Cmd + V trên macOS, Ctrl + V hoặc chuột phải trong PowerShell trên Windows.
Lệnh phải dán nguyên dòng. Thiếu hoặc thừa một ký tự là lệnh sẽ lỗi.
Nhiều thay đổi chỉ có hiệu lực khi bạn mở cửa sổ terminal mới. Khi tài liệu bảo mở cửa sổ mới, hãy làm đúng như vậy.

Trên macOS: bấm Cmd + Space để mở Spotlight, gõ Terminal, bấm Enter.

Trên Windows: bấm Win + X, chọn Windows PowerShell hoặc Terminal. Windows có hai chương trình dòng lệnh là PowerShell và CMD, dùng lệnh khác nhau. Bài này dùng PowerShell. Bạn nhận ra PowerShell vì mỗi dòng bắt đầu bằng PS C:\Users\TenBan>. Nếu không có chữ PS, bạn đang ở CMD.

Cài Claude Code trên macOS thế nào?

Mở Terminal như trên.
Dán dòng sau rồi bấm Enter:

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

Đợi chữ chạy xong. Khi thành công, bạn sẽ thấy dòng Claude Code successfully installed!
Đóng cửa sổ, mở một cửa sổ Terminal mới và kiểm tra:

claude --version

Nếu máy in ra một số phiên bản kèm chữ (Claude Code) là bạn đã cài xong. Nếu máy báo command not found: claude, xem mục lỗi bên dưới.

Nếu bạn đã dùng Homebrew, tài liệu cũng có cách cài bằng brew install --cask claude-code. Cách này không tự cập nhật, bạn phải chạy brew upgrade claude-code định kỳ. Bản cài bằng lệnh curl ở trên thì tự cập nhật ngầm.

Cài Claude Code trên Windows thế nào?

Cài Git for Windows (không bắt buộc). Tải tại git-scm.com/downloads/win, bấm Next ở mọi màn hình để giữ mặc định. Không có Git, Claude Code vẫn chạy và dùng PowerShell thay thế. Bạn không cần tự học Git.
Mở PowerShell bằng Win + X. Không cần chạy bằng quyền Administrator.
Dán dòng sau rồi bấm Enter:

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

Khi thấy Claude Code successfully installed!, đóng PowerShell, mở cửa sổ mới và chạy claude --version để kiểm tra.

Lưu ý: trong menu Start có thể có mục Windows PowerShell (x86). Đừng chọn mục đó, vì nó chạy ở chế độ 32-bit và Claude Code không hỗ trợ.

Chạy phiên làm việc đầu tiên ra sao?

Claude Code làm việc trong thư mục bạn đang đứng. Lần đầu, hãy tạo một thư mục trống để thử, tránh mở nó ngay trong thư mục chứa tài liệu quan trọng. Ba lệnh dưới đây chạy được trên cả Terminal của macOS lẫn PowerShell:

mkdir thu-claude-code
cd thu-claude-code
claude

mkdir tạo thư mục, cd đi vào thư mục đó, claude khởi động Claude Code.

Lần đầu chạy, Claude Code sẽ mở trình duyệt để bạn đăng nhập tài khoản Claude. Đăng nhập xong, quay lại terminal. Bạn sẽ thấy ô nhập kèm phiên bản, model đang dùng và thư mục hiện tại.

Gõ yêu cầu đầu tiên bằng lời thường, ví dụ:

Tạo cho tôi một trang web đơn giản có dòng chữ "Xin chào", nền trắng, chữ đen, căn giữa màn hình.

Claude sẽ tạo file HTML trong thư mục. Nếu nó hỏi trước khi tạo file, bấm Enter để chọn Yes. Xong, mở thư mục thu-claude-code trong Finder hoặc File Explorer và bấm đúp vào file HTML để xem trong trình duyệt.

Từ bản v2.1.283, phiên làm việc trong terminal mặc định chạy ở auto mode: một bộ phân loại duyệt thay bạn, và Claude sẽ sửa hầu hết file, chạy hầu hết lệnh mà không hỏi. Đây là lý do nên thử trong thư mục trống. Bấm Shift + Tab để đổi chế độ quyền bất cứ lúc nào.

Vài phím nên nhớ trong phiên làm việc:

Thao tác	Tác dụng
`Esc`	Dừng Claude khi nó đang chạy
`/help`	Xem các lệnh có sẵn
`/login`	Đăng nhập lại hoặc đổi tài khoản
`/clear`	Xoá lịch sử hội thoại hiện tại
`exit`, hoặc `Ctrl + D` hai lần	Thoát Claude Code

Lần sau muốn tiếp tục cuộc trò chuyện gần nhất trong cùng thư mục, chạy claude -c.

Gặp lỗi khi cài thì sửa thế nào?

Thông báo	Nguyên nhân	Cách sửa
`command not found: claude` (macOS)	Thư mục cài chưa nằm trong PATH	Chạy lệnh sửa PATH bên dưới, mở cửa sổ mới
`'claude' is not recognized` (Windows)	Như trên	Chạy lệnh sửa PATH cho PowerShell bên dưới
`'irm' is not recognized`	Bạn đang ở CMD	Mở PowerShell rồi chạy lại
`The token '&&' is not a valid statement separator`	Bạn dán lệnh dành cho CMD vào PowerShell	Dùng lệnh `irm` ở trên
`syntax error near unexpected token '<'` hoặc thấy mã HTML	Đường dẫn cài trả về trang web	Chạy lại; nếu trang ghi "App unavailable in region" thì Claude Code không có ở quốc gia được nhận diện
`dyld: cannot load` trên Mac	macOS cũ hơn 13.0	Cập nhật macOS qua Software Update
`Could not create SSL/TLS secure channel`	Thường gặp trên Windows 10 cũ	Xem lệnh TLS trong tài liệu khắc phục sự cố

Sửa PATH trên macOS (shell mặc định là Zsh):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Sửa PATH trên Windows, chạy trong PowerShell:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Sau đó đóng terminal, mở cửa sổ mới và chạy lại claude. Nếu vẫn không được, lệnh claude doctor in ra chẩn đoán cài đặt và gợi ý cách sửa mà không mở phiên làm việc.

Không muốn dùng terminal thì sao?

Anthropic có ứng dụng desktop cho macOS và Windows để dùng Claude Code mà không cần terminal, cùng tiện ích cho VS Code và bản web tại claude.ai/code. Tôi vẫn khuyên thử terminal một lần, vì hầu hết hướng dẫn và tài liệu đều viết theo cách đó, và hiểu nó giúp bạn đọc được Claude đang làm gì.

Cài xong rồi thì học gì tiếp?

Thử một việc thật, nhỏ. Nếu bạn là designer, hãy dựng lại một màn hình bạn đã vẽ trong Figma. Bạn sẽ nhanh chóng thấy AI tự chọn màu và font theo ý nó. Cách sửa là đưa cho nó một file mô tả design system, tôi giải thích trong bài DESIGN.md là gì.

Bước tiếp theo là nối Claude Code với Figma để nó đọc thẳng token và component, xem bài Figma MCP và Claude Code. Nếu bạn còn mới với Figma, bắt đầu từ lộ trình học Figma từ số 0.

Các dự án thật của tôi, như Joyme, đều bắt đầu từ research và Figma trước khi có dòng code nào. Claude Code giúp tôi đi nhanh hơn ở đoạn sau. Muốn biết thêm về cách tôi làm việc, xem trang giới thiệu.

Nguồn

Claude Code docs: Advanced setup: yêu cầu hệ thống, lệnh cài, tài khoản cần có, claude doctor. Truy cập 2026-10-04.
Claude Code docs: Quickstart: đăng nhập, phiên đầu tiên, auto mode, bảng lệnh.
Claude Code docs: Terminal guide for new users: mở terminal, sửa PATH, lỗi thường gặp.
Claude Code docs: Troubleshoot installation and login.
Anthropic: Supported countries and regions.