Cách dùng Claude Code lần đầu trên máy cá nhân

Hôm nay mình sẽ hướng dẫn anh em cách dùng Claude Code từ lúc cài trong terminal tới lúc giao việc đầu tiên cho nó trong một project có sẵn. Bài này được soạn từ tài liệu chính thức của code.claude.com, nên mình giữ nguyên các lệnh cài đặt và giải thích lại theo cách dễ làm.

Anh em sẽ đi qua năm việc: cài công cụ, kiểm tra lệnh, đăng nhập, mở đúng thư mục và giao một task nhỏ. Terminal chỉ là cửa sổ để gõ lệnh, nên người chưa biết code vẫn theo được.

Bước 1: Cách dùng Claude Code bắt đầu từ terminal

Trước tiên, anh em cần mở terminal và có một project để làm việc. Project có thể là thư mục chứa website, API, script hoặc tài liệu Markdown.

Tài liệu yêu cầu anh em có tài khoản Claude subscription, tài khoản Claude Console hoặc quyền truy cập qua cloud provider được hỗ trợ. Mình chưa tự chạy thử trên máy của anh em, nên phần dưới bám theo tài liệu chính thức.

Nếu anh em dùng macOS, Linux hoặc WSL, chạy lệnh này:

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

Nếu anh em dùng Windows PowerShell, chạy đúng lệnh này:

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

Windows CMD dùng lệnh khác:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Anh em đừng trộn lệnh giữa PowerShell và CMD. Tài liệu ghi prompt có PS C:\` là PowerShell, còn `C:\` không có `PS là CMD. Cài theo cách native thì công cụ tự cập nhật chạy ngầm.

Bước 2: Kiểm tra lệnh cài đặt

Sau khi installer chạy xong, anh em đóng terminal rồi mở một cửa sổ mới. Việc này giúp terminal nhận PATH mới, vì PATH là nơi hệ điều hành tìm các lệnh đã cài.

Chạy lệnh kiểm tra:

claude --version

Nếu cài đúng, terminal sẽ in ra một version kèm chữ Claude Code. Anh em chỉ cần thấy lệnh chạy mà không báo command not found hoặc claude isn't recognized.

Nếu terminal chưa nhận lệnh, anh em mở terminal mới rồi thử lại. Nếu lỗi còn nguyên, tài liệu chính thức hướng dẫn anh em xem mục sửa PATH và phần xử lý lỗi cài đặt.

Bước 3: Đăng nhập tài khoản

Khi lệnh kiểm tra đã chạy, anh em khởi động phiên chat bằng lệnh sau:

claude

Lần đầu mở, nó sẽ yêu cầu anh em đăng nhập trong browser. Tài khoản có thể là Claude Pro, Max, Team, Enterprise hoặc Claude Console. Tài liệu cũng ghi các lựa chọn cloud provider cho môi trường doanh nghiệp.

Nếu máy đã có biến ANTHROPIC_API_KEY, công cụ sẽ yêu cầu anh em duyệt API key thay vì mở bước đăng nhập thông thường. Anh em không cần đặt biến này nếu muốn đăng nhập qua browser bằng tài khoản subscription.

Muốn đổi tài khoản sau này, anh em gõ lệnh dưới đây ngay trong phiên chat:

/login

Sau khi đăng nhập, thông tin đăng nhập được lưu lại. Những lần sau anh em mở công cụ sẽ không phải xác thực lại, trừ khi cần đổi tài khoản hoặc đăng nhập lại.

Bước 4: Mở project và hỏi câu đầu tiên

Anh em nên mở terminal ngay trong thư mục project thay vì đứng ở thư mục home. Nếu terminal đang ở chỗ khác, dùng lệnh dưới đây rồi thay đường dẫn mẫu bằng đường dẫn thật:

cd /path/to/your/project
claude

Khi phiên chat mở ra, phía trên prompt sẽ có version, model hiện tại và thư mục đang làm việc. Đây là chỗ anh em nhập yêu cầu bằng ngôn ngữ tự nhiên.

Mình khuyên anh em cho nó đọc và giải thích trước, chưa sửa ngay. Câu đầu tiên có thể là:

what does this project do?

Sau đó anh em hỏi tiếp về công nghệ, file bắt đầu chạy hoặc cấu trúc folder:

what technologies does this project use?

where is the main entry point?

explain the folder structure

Công cụ tự đọc các file cần thiết trong project. Anh em không phải copy cả repo vào prompt. Nếu muốn xem lệnh có thể dùng, gõ /help; nếu muốn tiếp tục một phiên chat trước đó, gõ /resume.

Bước 5: Giao việc sửa file đầu tiên

Sau khi nó hiểu cấu trúc project, anh em mới giao một việc nhỏ. Tài liệu đưa ra prompt này:

add a hello world function to the main file

Công cụ sẽ tìm file phù hợp và hiển thị thay đổi trước khi áp dụng nếu phiên chat yêu cầu anh em duyệt. Anh em đọc phần thay đổi, kiểm tra đúng file rồi chọn Yes nếu muốn cho phép.

Đừng bắt đầu bằng yêu cầu xây lại cả website. Một task nhỏ giúp anh em nhìn được nó tìm file nào, sửa gì và có chạy lệnh kiểm tra hay không.

Khi đã quen, anh em có thể yêu cầu nó tìm file liên quan tới một tính năng, giải thích luồng đăng nhập, tìm bug hoặc viết test. Prompt nên nói rõ mục tiêu, file liên quan và cách anh em muốn kiểm tra kết quả.

Nếu project dùng Git, anh em có thể hỏi:

what files have I changed?

Mình khuyên anh em đọc diff trước khi cho công cụ tạo commit. Việc này đặc biệt cần thiết khi task làm thay đổi nhiều file.

Lỗi hay gặp

Lỗi đầu tiên là chạy sai lệnh theo loại terminal. Lệnh irm dành cho PowerShell, còn chuỗi có && trong tài liệu dành cho CMD. Prompt của terminal giúp anh em nhận ra mình đang ở đâu.

Lỗi tiếp theo là mở lại terminal nhưng vẫn thấy claude không được nhận diện. Anh em mở một cửa sổ terminal mới, chạy lại claude --version, rồi xem hướng dẫn sửa PATH nếu lỗi còn nguyên.

Trên Windows native, Git for Windows là lựa chọn nên cài nếu anh em muốn công cụ dùng Bash tool. Nếu không có Git for Windows, công cụ dùng PowerShell làm shell tool; WSL thì không cần Git for Windows.

Khi phiên chat đang chạy, anh em có thể gõ /help để xem lệnh hỗ trợ. Cứ để nó khám phá project trước, vì một yêu cầu rõ ràng sau khi hiểu context thường an toàn hơn một task sửa lớn ngay từ đầu.