Nội dung
Claude Code cài đặt cho người mới chỉ gồm vài bước: chuẩn bị Node.js 18 trở lên, chạy lệnh npm install -g @anthropic-ai/claude-code, đăng nhập và thử lệnh đầu tiên. Claude Code là công cụ dòng lệnh (CLI) giúp bạn ra lệnh cho AI viết, sửa và giải thích code ngay trong terminal.
Điểm chính
- Yêu cầu hệ thống: macOS/Linux/Windows (nên dùng WSL hoặc Git Bash trên Windows), Node.js 18+, Internet ổn định và một tài khoản Anthropic/Claude.
- Claude Code được phân phối dưới dạng gói npm — không có file .exe hay .dmg riêng; cài toàn cục bằng một dòng lệnh, kiểm tra bằng claude –version.
- Tuyệt đối không dùng sudo để cài; nếu lỗi phân quyền thì cấu hình lại thư mục npm global theo hướng dẫn chính thức.
- Đăng nhập bằng tài khoản Claude (gói Pro/Max) hoặc API key của Anthropic; thông tin được lưu an toàn nên lần sau không cần đăng nhập lại.
- Nên làm việc trên dự án đã có Git để hoàn tác được, và luôn đọc kỹ thay đổi Claude Code đề xuất trước khi đồng ý (accept).
Nếu bạn vừa nghe về công cụ lập trình bằng AI của Anthropic và muốn bắt tay vào dùng ngay, thì hướng dẫn Claude Code cài đặt cho người mới này là điểm khởi đầu phù hợp. Claude Code là một công cụ dòng lệnh (CLI) giúp bạn ra lệnh cho AI viết, sửa và giải thích code ngay trong terminal của máy tính. Bài viết tập trung vào phần thực hành: kiểm tra máy, cài đặt qua npm, đăng nhập và chạy lệnh đầu tiên. Nếu bạn còn mơ hồ về khái niệm, hãy đọc trước bài Claude Code là gì rồi quay lại đây để thực hành.
Yêu cầu hệ thống trước khi claude code cài đặt
Trước khi bắt đầu, hãy chắc chắn máy của bạn đáp ứng các điều kiện tối thiểu. Việc chuẩn bị đúng môi trường sẽ giúp quá trình claude code cài đặt diễn ra suôn sẻ, tránh các lỗi phổ biến mà người mới hay gặp.
- Hệ điều hành: macOS, Linux, hoặc Windows. Trên Windows, Claude Code chạy tốt nhất qua WSL (Windows Subsystem for Linux) hoặc Git Bash.
- Node.js phiên bản 18 trở lên: Đây là yêu cầu bắt buộc vì Claude Code được cài qua npm. Bạn tải Node.js miễn phí tại nodejs.org và nên chọn bản LTS để ổn định.
- Kết nối Internet ổn định: Công cụ giao tiếp với mô hình AI qua mạng, nên đường truyền tốt sẽ giúp phản hồi nhanh hơn.
- Một tài khoản Anthropic hoặc Claude: Bạn cần tài khoản để đăng nhập và sử dụng. Tìm hiểu thêm về trợ lý AI nền tảng trong bài Claude là gì.
Để kiểm tra xem máy đã có Node.js chưa, mở terminal và gõ node --version. Nếu kết quả trả về số phiên bản từ 18 trở lên (ví dụ v20.11.0), bạn đã sẵn sàng. Nếu báo lỗi “command not found”, hãy cài Node.js trước.
Cách cài đặt Claude Code qua npm
Claude Code được phân phối dưới dạng một gói npm, không có file cài đặt .exe hay .dmg riêng. Đây là điểm khác biệt mà nhiều người mới hiểu nhầm. Bạn chỉ cần một dòng lệnh duy nhất để cài đặt toàn cục.
- Mở terminal (Terminal trên macOS/Linux, hoặc PowerShell/Git Bash trên Windows).
- Gõ lệnh sau và nhấn Enter:
npm install -g @anthropic-ai/claude-code - Chờ quá trình tải và cài đặt hoàn tất. Tùy tốc độ mạng, việc này mất khoảng một đến vài phút.
- Kiểm tra cài đặt thành công bằng cách gõ:
Nếu terminal hiển thị số phiên bản, nghĩa là bạn đã cài xong.claude --version
Lưu ý quan trọng: Tuyệt đối không dùng sudo để cài đặt (kiểu sudo npm install -g). Cách làm này có thể gây lỗi phân quyền về sau. Nếu gặp lỗi quyền truy cập, hãy cấu hình lại thư mục npm global theo hướng dẫn chính thức thay vì dùng sudo. Tài liệu đầy đủ luôn được cập nhật tại trang docs.anthropic.com/en/docs/claude-code và cổng dành cho lập trình viên code.claude.com.
Đăng nhập và xác thực tài khoản
Sau khi cài xong, bước tiếp theo là kết nối Claude Code với tài khoản của bạn. Hãy điều hướng terminal vào thư mục dự án mà bạn muốn làm việc, rồi khởi động công cụ.
- Di chuyển vào thư mục dự án, ví dụ:
cd ~/du-an-cua-toi - Gõ lệnh khởi động:
claude - Lần đầu chạy, công cụ sẽ mở trình duyệt để bạn đăng nhập. Có hai lựa chọn phổ biến:
- Đăng nhập bằng tài khoản Claude: Phù hợp nếu bạn đã có gói thuê bao Claude Pro hoặc Max.
- Dùng API key của Anthropic: Phù hợp khi bạn muốn trả tiền theo lượng sử dụng. Cách lấy và dùng khóa này được trình bày chi tiết trong bài cách dùng Claude API.
- Hoàn tất xác thực trên trình duyệt, sau đó quay lại terminal — bạn sẽ thấy giao diện dòng lệnh sẵn sàng nhận lệnh.
Thông tin đăng nhập được lưu lại an toàn trên máy, nên những lần sau bạn không cần đăng nhập lại. Với doanh nghiệp nhỏ (SME), nên dùng một tài khoản chung có kiểm soát chi phí để theo dõi mức sử dụng dễ dàng hơn.
Chạy lệnh đầu tiên với Claude Code
Đây là phần thú vị nhất. Khi giao diện claude đã mở, bạn có thể ra lệnh bằng tiếng Việt hoặc tiếng Anh, diễn đạt tự nhiên như đang nhắn tin cho một đồng nghiệp. Dưới đây là vài lệnh nên thử khi mới bắt đầu:
- Hiểu codebase: Gõ “Giải thích cấu trúc dự án này cho tôi”. Claude Code sẽ đọc các file và tóm tắt giúp bạn.
- Sửa lỗi: Dán thông báo lỗi vào và yêu cầu “Tìm và sửa lỗi này”. Công cụ sẽ đề xuất thay đổi và xin phép trước khi sửa file.
- Viết tính năng mới: Mô tả yêu cầu, ví dụ “Tạo một form liên hệ có kiểm tra email”.
- Xem trợ giúp: Gõ
/helpđể xem danh sách lệnh nội bộ, hoặc/exitđể thoát.
Một thói quen tốt cho người mới: luôn đọc kỹ thay đổi mà công cụ đề xuất trước khi đồng ý (accept). Claude Code hỏi xác nhận trước mỗi lần chỉnh sửa file, đây là cơ chế an toàn để bạn kiểm soát. Hãy làm việc trên dự án đã có Git để có thể hoàn tác (revert) bất cứ lúc nào nếu kết quả chưa như ý.
Mẹo dùng hiệu quả cho marketer và SME
Bạn không cần là lập trình viên chuyên nghiệp mới dùng được Claude Code. Marketer và chủ doanh nghiệp nhỏ có thể tận dụng nó để dựng nhanh landing page, viết script tự động hóa, hay chỉnh sửa website. Vài gợi ý:
- Bắt đầu nhỏ: Thử trên một dự án thử nghiệm trước khi áp dụng vào hệ thống thật.
- Mô tả rõ ràng: Yêu cầu càng cụ thể, kết quả càng chính xác. Nêu rõ ngôn ngữ, framework và mục tiêu.
- So sánh công cụ: Nếu phân vân giữa các lựa chọn, tham khảo bài Claude Code vs Cursor để chọn đúng nhu cầu.
- Học thêm nền tảng AI: Cụm bài hướng dẫn AI trên Marketing365 sẽ giúp bạn dùng các công cụ AI bài bản hơn.
Anthropic cũng thường xuyên cập nhật tính năng mới; bạn có thể theo dõi qua kênh chính thức như trang tin Anthropic để không bỏ lỡ.
Câu hỏi thường gặp về claude code cài đặt
Claude Code có miễn phí không?
Bản thân công cụ CLI tải về miễn phí qua npm, nhưng việc sử dụng cần tài khoản Claude (gói thuê bao) hoặc API key tính phí theo lượng dùng. Người mới nên bắt đầu với gói nhỏ để làm quen rồi nâng cấp khi cần.
Tôi không biết lập trình, có dùng được không?
Được. Bạn ra lệnh bằng ngôn ngữ tự nhiên và Claude Code lo phần code. Tuy vậy, hiểu cơ bản về terminal và Git sẽ giúp bạn dùng an toàn và tự tin hơn.
Cài trên Windows có khó không?
Không khó, nhưng nên cài Node.js trước rồi dùng WSL hoặc Git Bash thay vì Command Prompt mặc định để tương thích tốt nhất. Các bước cài đặt còn lại giống hệt macOS và Linux.
Tóm lại, quá trình claude code cài đặt cho người mới chỉ gồm vài bước: chuẩn bị Node.js, chạy lệnh npm install -g @anthropic-ai/claude-code, đăng nhập và thử lệnh đầu tiên. Khi đã quen tay, bạn sẽ thấy công cụ này tiết kiệm rất nhiều thời gian cho cả công việc kỹ thuật lẫn marketing. Hãy bắt đầu với một dự án nhỏ ngay hôm nay và khám phá sức mạnh của Claude Code.
