Hôm nay mình sẽ hướng dẫn anh em cài Claude Code trên máy tính Windows hoặc macOS để gõ lệnh trực tiếp trong terminal và kiểm tra môi trường làm việc. Mình đọc tài liệu của Anthropic rồi gom lại thành ba bước cho anh em dễ làm theo, kèm phần lỗi hay gặp ở cuối. Mình chưa tự chạy thử bài này, nên chỗ nào là tài liệu ghi thì mình nói rõ là tài liệu ghi nhé anh em.
Trước khi bắt đầu, anh em mở terminal và chuẩn bị một thư mục chứa code. Terminal là cửa sổ gõ lệnh. Làm xong bài này, anh em cài được Claude Code, đăng nhập và hỏi nó câu đầu tiên về project của mình.
Tài liệu ghi anh em cần gói Claude Pro, Max, Team hay Enterprise, hoặc tài khoản Claude Console (dùng API với credit nạp trước), hoặc truy cập qua nhà cung cấp cloud được hỗ trợ. Anh em có sẵn một trong các tài khoản trên là cài được ngay.
Bước 1: Cài Claude Code vào máy
Anh em dùng macOS (hoặc Linux, WSL) thì mở terminal rồi dán đúng lệnh dưới đây để chạy. Lệnh cài không hiện tiến trình. Anh em cứ kiên nhẫn chờ đến khi terminal tải xong và cho phép gõ tiếp.
curl -fsSL https://claude.ai/install.sh | bash
Với anh em dùng máy Windows, tài liệu chỉ ra hai loại terminal khác nhau là PowerShell và CMD. Màn hình hiện chữ PS là PowerShell, còn chỉ hiện ổ đĩa là CMD.
Tài liệu ghi cách cài native này tự cập nhật trong nền để giữ anh em luôn ở bản mới nhất, khác với Homebrew hay WinGet phải nâng cấp bằng tay. Nếu anh em cài bằng Homebrew hay WinGet thì sau này phải tự nâng cấp bản mới chứ công cụ không tự cập nhật.
irm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdCài xong, anh em mở cửa sổ terminal mới rồi gõ lệnh dưới đây để xem phiên bản.
claude --versionMàn hình in số phiên bản kèm chữ Claude Code là máy nhận lệnh. PATH là danh sách các thư mục mà máy tìm trong đó mỗi khi anh em gõ một lệnh, nên nếu Claude Code không nằm trong đó thì gõ claude máy sẽ không biết là lệnh gì. Nếu máy báo không tìm thấy lệnh claude, nghĩa là thư mục cài chưa nằm trong PATH.
Nếu lệnh cài báo lỗi khác, anh em mở trang Troubleshoot installation trong tài liệu Anthropic, ở đó có tra theo từng lỗi và có cách cài khác.
Bước 2: Mở thư mục và khởi động công cụ
Giờ mình cho terminal vào đúng thư mục chứa code bằng lệnh cd (cd nghĩa là chuyển sang thư mục khác) nhé anh em. Đường dẫn mẫu bên dưới nhớ đổi thành đường dẫn thật của anh em. Ví dụ thư mục của anh em là Documents/my-site thì thay /path/to/your/project bằng đường dẫn đó.
Anh em gõ lệnh cd kèm đường dẫn thực tế tới project rồi gõ claude để mở session đầu tiên với công cụ.
cd /path/to/your/project
claudeỞ lần chạy đầu tiên, công cụ mở trình duyệt để anh em đăng nhập. Anh em làm theo hướng dẫn trên màn hình để đăng nhập trong trình duyệt, tài khoản Pro, Max hay Console đều được. Muốn đổi tài khoản sau này thì anh em gõ /login ngay trong session đang chạy.
Tài liệu ghi sau khi đăng nhập thành công thì tài khoản đăng nhập của anh em sẽ được lưu lại để không phải đăng nhập ở các lần tiếp theo. Nếu anh em đã đặt biến môi trường ANTHROPIC_API_KEY và đồng ý cho Claude Code dùng key đó khi nó hỏi, thì nó bỏ qua bước đăng nhập.
Session sẽ hiển thị số phiên bản, model và thư mục hiện tại. Anh em gõ /help trong session để xem danh sách lệnh có sẵn. Theo tài liệu thì công cụ tự động đọc các file trong thư mục khi cần, nên anh em không phải tự đưa từng file vào.
Với tài khoản Console, lần đăng nhập đầu tiên sẽ tự tạo một workspace tên Claude Code trong Console để anh em theo dõi chi phí ở một chỗ. Trong lúc chat, anh em bấm Shift+Tab để đổi quyền hạn, chọn những việc nó được tự làm và những việc bắt buộc phải hỏi lại anh em trước.
Bước 3: Đặt câu hỏi đầu tiên về project
Để thử nghiệm, anh em gửi câu hỏi tổng quan bằng tiếng Anh. Câu này nhờ nó tóm tắt xem project làm gì. Nó sẽ đọc các file trong thư mục rồi tóm tắt lại cho anh em.
what does this project do?Anh em có thể hỏi xem thư mục này dùng những công nghệ gì. Anh em có thể thử hỏi thêm để nhờ nó giải thích cấu trúc thư mục. Khi cần sửa code, anh em gõ yêu cầu cụ thể bằng tiếng Anh, nếu nó hỏi trước khi sửa file thì chọn Yes để đồng ý áp dụng.
Với founder hay marketer, mình nghĩ hỏi kiểu này là cách nhanh để nắm project mà không cần đọc code (đây là ý của mình). Anh em cứ trò chuyện tự nhiên với nó như một đồng nghiệp ngồi cạnh. Muốn thoát thì anh em gõ /exit trong session.
Lỗi hay gặp khi cài đặt
Lỗi mình đoán anh em dễ dính nhất là mở nhầm loại terminal. Nếu thấy màn hình báo lỗi về ký tự && thì anh em đang ở PowerShell mà dán nhầm lệnh của CMD. Ngược lại, nếu máy báo không nhận diện được lệnh irm thì anh em đang ở CMD mà dán nhầm lệnh của PowerShell.
Nếu lệnh cài báo lỗi 403 hay bất kỳ lỗi nào khác, tài liệu bảo anh em mở trang xử lý sự cố để xem cách khắc phục. Tài liệu khuyên máy Windows (không phải WSL) nên cài Git for Windows để Claude Code dùng được công cụ Bash. Nếu chưa cài Git for Windows, Claude Code dùng PowerShell thay cho Bash; còn máy chạy WSL thì không cần cài thêm gói này.
Mình khuyên anh em nhìn dấu nhắc trước khi dán lệnh: có chữ PS là PowerShell, không có là CMD, rồi dán đúng lệnh của loại đó. Vậy là xong, anh em đã có Claude Code trong terminal rồi. Anh em cứ hỏi thử vài câu là sẽ quen cách dùng công cụ này ngay thôi.
