Hôm nay mình sẽ hướng dẫn anh em dùng Claude Code cho người mới bắt đầu, từ bước cài đặt bằng terminal đến cách xem quyền và xử lý tài liệu văn phòng.
Mình soạn hướng dẫn này từ tài liệu chính thức để anh em biết cách mở công cụ, yêu cầu nó đọc file và kiểm tra trước khi sửa. Mình chưa chạy thử, nên các bước đều bám theo tài liệu.
Anh em hiểu terminal là cửa sổ gõ lệnh trên máy tính. Nếu chưa từng mở cửa sổ này, anh em có thể đọc phần làm quen để biết cách mở và dán lệnh trước khi bắt đầu cài công cụ.
Bước 1: Cài đặt Claude Code cho người mới bắt đầu
Anh em mở terminal trước khi chọn lệnh cài cho máy mình.
Với các máy chạy macOS, Linux hoặc WSL, tài liệu hướng dẫn anh em dùng lệnh dưới đây. Anh em hiểu WSL là môi trường chạy Linux trên máy Windows.
curl -fsSL https://claude.ai/install.sh | bashTài liệu ghi quá trình tải không hiện tiến trình, nên anh em chờ lệnh cài chạy xong rồi mở terminal mới để kiểm tra máy đã nhận công cụ chưa. Anh em dùng lệnh dưới đây để xem phiên bản đã cài.
claude --versionNếu cài thành công, công cụ sẽ in phiên bản trong terminal. Với Windows, anh em cần chọn lệnh cài tương ứng với PowerShell hoặc CMD đang mở.
Mình giữ lệnh cài phía trên cho nhóm máy đã nêu, còn anh em dùng cửa sổ khác cần lấy đúng lệnh trong tài liệu trước khi dán vào terminal. Cách cài trực tiếp này tự cập nhật khi công cụ chạy ngầm.
Bước 2: Bắt đầu phiên làm việc đầu tiên
Anh em mở công cụ trong thư mục chứa tài liệu cần xử lý để nó biết mình đang làm việc ở đâu. Tài liệu ghi nó làm được việc trong thư mục ghi chú.
Nguồn cũng nói đến thư mục tài liệu và các file markdown. Anh em hiểu markdown là cách viết văn bản có tiêu đề và danh sách bằng ký hiệu đơn giản, nên mình chọn nhóm file này để giải thích việc làm quen.
Anh em dùng lệnh dưới đây để chuyển thư mục rồi mở công cụ:
cd /path/to/your/project
claudeAnh em cần thay /path/to/your/project bằng thư mục thực tế trên máy. Phần đó là chỗ tài liệu để người đọc điền thư mục của mình, nên giữ nguyên rồi chạy sẽ chưa đưa công cụ tới nơi anh em muốn làm việc.
Trong lần đầu sử dụng, công cụ sẽ yêu cầu anh em mở trình duyệt web để hoàn tất đăng nhập. Anh em cần tài khoản được hỗ trợ, chẳng hạn gói Pro hoặc Console.
Sau khi đăng nhập, công cụ lưu tài khoản đăng nhập để anh em không phải làm lại mỗi lần mở. Mình sẽ chuyển sang việc đọc file trước khi giao nhiệm vụ sửa.
Bước 3: Cấp quyền an toàn cho thư mục và file
Mình muốn anh em kiểm tra quyền trước khi giao việc sửa tài liệu, vì quyền của phiên chat quyết định những thao tác công cụ được tự làm. Tài liệu ghi anh em có thể bấm Shift+Tab để đổi quyền trong phiên chat đang mở.
Anh em cần phân biệt quyền này với việc chia sẻ thư mục. Phần hướng dẫn đang nói về thao tác công cụ được phép thực hiện, nên đổi quyền trong phiên chat không có nghĩa anh em đang cấp quyền xem tài liệu cho người khác.
Trong ví dụ sửa code, tài liệu ghi công cụ tìm file phù hợp rồi cho người dùng xem thay đổi. Nếu nó hỏi, anh em kiểm tra nội dung trước khi đồng ý.
Việc công cụ có hỏi trước khi sửa hay không phụ thuộc vào quyền của phiên chat, nên mình không hứa lần nào anh em cũng thấy câu hỏi. Anh em kiểm tra quyền trước. Anh em có thể đọc phần quyền trước khi đổi sang cách làm ít hỏi hơn.
Với lần làm quen đầu tiên, mình sẽ yêu cầu nó đọc và giải thích file trước khi giao việc sửa. Anh em dùng phần giải thích để kiểm tra nó hiểu đúng chưa.
Bước 4: Tự động hóa xử lý tài liệu văn phòng
Tài liệu ghi anh em có thể chạy công cụ trong thư mục ghi chú, tài liệu hoặc các file markdown để tìm, sửa và sắp xếp nội dung. Mình sẽ bắt đầu bằng việc tìm phần tài liệu cần sửa.
Chẳng hạn, anh em có thể yêu cầu nó tìm đoạn hướng dẫn đăng nhập trong thư mục tài liệu, rồi đọc phần nó tìm được trước khi yêu cầu chỉnh sửa. Đây là ví dụ áp dụng, chưa phải kết quả mình đã chạy.
Anh em gõ ký tự @ để chọn file hoặc thư mục muốn đưa vào phiên chat. Khi chọn thư mục, anh em mới đưa vào danh sách file.
Tài liệu ghi chọn thư mục chưa đưa toàn bộ nội dung các file vào phiên chat, nên anh em chọn file cụ thể khi muốn nó xem ngay phần cần xử lý. Công cụ cũng tự đọc file khi cần trong lúc làm việc.
Anh em không phải đưa tất cả tài liệu vào từ đầu. Với câu hỏi chỉ cần chạy một lần, anh em có thể dùng lệnh dưới đây để công cụ trả lời rồi thoát, theo đúng ví dụ trong tài liệu.
claude -p "explain this function"Anh em hiểu prompt là yêu cầu mình gửi cho công cụ. Câu trong lệnh là ví dụ hỏi về code, nên khi xử lý tài liệu văn phòng, anh em thay phần đó bằng yêu cầu cụ thể với file đang làm.
Lệnh này kết thúc lượt chạy của công cụ sau khi trả lời. Tài liệu không nói nó đóng terminal hay ngăn lưu lịch sử, nên mình chỉ dùng ví dụ này để giải thích cách chạy một yêu cầu rồi kết thúc.
Bước 5: Tiếp tục phiên làm việc cũ
Anh em có thể tiếp tục phiên chat gần nhất trong thư mục hiện tại bằng lệnh dưới đây. Mình thấy thao tác này hữu ích khi công việc còn dang dở.
claude -cNếu muốn chọn một phiên chat trước đó, anh em dùng lệnh còn lại trong tài liệu:
claude -rAnh em gõ /help trong phiên chat để xem các lệnh đang có. Những lệnh có dấu gạch chéo được gõ sau khi công cụ đã mở, nên anh em cần phân biệt chúng với lệnh mở công cụ từ terminal phía trên.
Khi cần xóa lịch sử hội thoại hiện tại, anh em dùng /clear. Khi đã hoàn thành phần việc muốn làm, anh em dùng /exit trong phiên chat để thoát công cụ theo bảng lệnh mà tài liệu cung cấp cho người mới.
Lỗi hay gặp
Nếu terminal báo không tìm thấy lệnh sau khi cài, tài liệu giải thích thư mục cài chưa nằm trong PATH. Anh em hiểu PATH là danh sách thư mục máy tìm lệnh.
Anh em mở terminal mới rồi kiểm tra lại như bước cài đặt. Nếu lỗi còn xuất hiện, anh em đọc phần sửa PATH để làm theo cách dành cho máy của mình, thay vì dán lại lệnh cài nhiều lần.
Với Windows, tài liệu chỉ ra lỗi khi người dùng dán lệnh dành cho CMD vào PowerShell. Anh em chọn đúng cửa sổ. Nếu cửa sổ báo không nhận irm, tài liệu ghi anh em đang dùng CMD với lệnh dành cho PowerShell.
Mình muốn anh em giữ một thói quen ngay từ lần đầu: đọc yêu cầu sửa, kiểm tra quyền, rồi mới đồng ý.
