Việc cài Claude Code giúp thiết lập trợ lý dòng lệnh có khả năng đọc hiểu cấu trúc thư mục, đề xuất giải pháp và sửa tệp trực tiếp trên máy tính. Bài viết này hướng dẫn đầy đủ từ khâu chuẩn bị môi trường, lệnh cài đặt, đăng nhập đến quy tắc kiểm soát mã nguồn an toàn.

Sau khi hoàn thành các bước, công cụ sẽ sẵn sàng hoạt động trong mọi thư mục làm việc cục bộ được cấp quyền.

Điều kiện cần chuẩn bị

Trước khi cài Claude Code, cần kiểm tra và chuẩn bị sẵn các yếu tố kỹ thuật sau:

  • Môi trường dòng lệnh: macOS (Terminal), Linux hoặc Windows (sử dụng WSL hoặc PowerShell).
  • Node.js phiên bản 18 trở lên đã được cài đặt và thiết lập biến môi trường PATH.
  • Tài khoản Claude đang hoạt động với gói đăng ký hỗ trợ hoặc tài khoản Anthropic Console có sẵn số dư tín dụng.
  • Git đã được khởi tạo trong thư mục dự án để theo dõi thay đổi.

Các bước cài Claude Code và khởi chạy dự án

Quy trình thiết lập công cụ gồm 3 bước cơ bản từ cài đặt toàn cục đến xác thực tài khoản.

Cài đặt gói công cụ vào hệ thống

Thao tác cài đặt được thực hiện trực tiếp trên cửa sổ dòng lệnh của hệ điều hành.

  1. Mở Terminal trên macOS/Linux hoặc mở PowerShell/WSL trên Windows.
  2. Chạy lệnh cài đặt toàn cục sau:
npm install -g @anthropic-ai/claude-code
  1. Chờ tiến trình tải về hoàn tất trong cửa sổ dòng lệnh.
  2. Kiểm tra phiên bản vừa cài đặt bằng lệnh:
claude --version

Chuyển vào thư mục và xác thực tài khoản

Claude Code hoạt động theo ngữ cảnh của thư mục làm việc hiện tại.

  1. Điều hướng cửa sổ lệnh vào thư mục dự án cần thao tác:
cd /duong-dan/toi-thu-muc-du-an
  1. Khởi chạy công cụ bằng lệnh:
claude
  1. Trình duyệt mặc định sẽ tự động mở trang xác thực của Anthropic (giao diện có thể khác tùy phiên bản).
  2. Đăng nhập tài khoản và bấm cấp quyền truy cập để nhận mã xác thực.
  3. Sao chép mã xác thực dán lại vào cửa sổ dòng lệnh và nhấn Enter để hoàn tất.

Thử nghiệm câu lệnh đầu tiên với dữ liệu mẫu

Sau khi đăng nhập thành công, dòng lệnh sẽ chuyển sang giao diện tương tác trực tiếp với AI.

  1. Nhập câu lệnh yêu cầu phân tích tổng quan cấu trúc thư mục:
Hãy đọc các tệp trong thư mục này và giải thích ngắn gọn dự án làm gì.
  1. Quan sát danh sách các tệp được công cụ quét qua trên màn hình.
  2. Đọc kỹ phần tóm tắt do AI phản hồi để đảm bảo công cụ đọc đúng phạm vi.
  3. Nhập lệnh thoát khi cần kết thúc phiên làm việc:
exit

Lưu ý an toàn khi để AI sửa tệp

Việc trao quyền sửa tệp trực tiếp cho công cụ tự động tiềm ẩn rủi ro ghi đè dữ liệu nếu không có cơ chế bảo vệ.

  • Tạo commit Git trước khi ra lệnh: Trước khi yêu cầu AI viết hoặc sửa mã nguồn, hãy lưu lại toàn bộ trạng thái hiện tại bằng lệnh git commit. Điều này đảm bảo có thể hoàn tác mọi thay đổi bất cứ lúc nào.
  • Đọc kỹ bảng so sánh (diff): Công cụ luôn hiển thị các dòng mã thêm bớt trước khi áp dụng. Cần kiểm tra kỹ từng dòng trước khi nhấn xác nhận.
  • Bảo mật khóa truy cập: Đưa toàn bộ tệp chứa biến môi trường như .env hoặc các private key vào tệp .gitignore trước khi khởi chạy công cụ.

Lỗi thường gặp và cách xử lý

Bảng dưới đây tổng hợp các sự cố phổ biến trong quá trình cài đặt và khởi chạy:

Sự cố Nguyên nhân Cách xử lý
claude: command not found Đường dẫn npm global chưa nằm trong biến môi trường PATH Thêm thư mục cài đặt toàn cục của Node/npm vào tệp cấu hình shell (.bashrc hoặc .zshrc)
Lỗi xác thực tài khoản hoặc hết hạn phiên Token đăng nhập bị hủy hoặc tài khoản chưa có số dư tín dụng Kiểm tra trạng thái tài khoản trên trang quản trị Anthropic và chạy lại lệnh claude để đăng nhập lại
Lỗi phân quyền khi ghi tệp Thư mục dự án yêu cầu quyền quản trị viên hoặc đang bị khóa bởi tiến trình khác Kiểm tra quyền sở hữu thư mục hoặc mở terminal với quyền tương ứng

Khi nào nên và không nên dùng

Việc lựa chọn công cụ dòng lệnh cần dựa trên mức độ phù hợp với tác vụ thực tế:

Nên dùng khi Không nên dùng khi
Cần rà soát lỗi nhanh trên nhiều tệp cùng lúc trong một dự án cục bộ Dự án chứa dữ liệu khách hàng thật hoặc bí mật kinh doanh chưa được phân loại an toàn
Đã thiết lập sẵn Git và quen thuộc với việc kiểm tra diff thay đổi mã nguồn Chưa có phương án sao lưu dự phòng cho mã nguồn hiện tại
Muốn AI tự động chạy kiểm thử đơn vị (unit test) và sửa lỗi theo phản hồi của terminal Máy tính không có kết nối mạng ổn định để giao tiếp với máy chủ xác thực

Sau khi cài Claude Code thành công, hãy bắt đầu bằng việc tạo một thư mục trống với vài tệp mẫu để làm quen với các thao tác đọc và chỉnh sửa cơ bản. Khi đã nắm vững luồng kiểm soát Git, bạn có thể áp dụng công cụ vào các dự án chính thức một cách an toàn và hiệu quả.

Nguồn chính thức đã tham khảo