Cài Claude Code trên Mac bằng Terminal: mở đúng thư mục và kiểm tra bản đang chạy

Tóm tắt nhanh
Trên Mac, bạn cài Claude Code bằng một lệnh dán vào Terminal, rồi dùng cd để vào đúng thư mục công việc. Trước khi giao việc, gõ pwd để xác nhận thư mục đang đứng và claude --version để xác nhận đã cài. Kiểm tra hai thứ này giúp Claude Code không sửa nhầm chỗ.
Cài Claude Code trên Mac chỉ mất vài phút: mở Terminal, dán lệnh cài, chờ chạy xong. Nhưng cài xong chưa phải là xong. Việc quan trọng hơn là bạn đang đứng ở thư mục nào khi gõ claude, vì Claude Code làm việc ngay trong thư mục đó.
Với người chưa từng đụng terminal, đây là chỗ dễ trượt nhất. Bạn mở Terminal, thấy một dòng chữ lạ, gõ claude luôn. Nếu lúc đó Terminal đang đứng ở thư mục cá nhân thay vì thư mục dự án, bạn vừa trao quyền làm việc cho một vùng rộng hơn nhiều so với ý định. Xem video ngắn bên dưới để thấy toàn bộ thao tác trong vài chục giây.
Bài này đi chậm hơn video. Mình giải thích vì sao thư mục hiện hành quan trọng, cách kiểm tra bằng pwd, cách kéo thư mục từ Finder khỏi gõ đường dẫn, rồi ba tình huống đời thật để bạn tập. Cuối bài là những lỗi hay gặp và vài nhận định về hướng đi sắp tới.
I.Bản chất: vì sao thư mục đang đứng lại quan trọng đến vậy
A.Terminal luôn "đứng" ở một chỗ
Bạn dùng Finder bằng cách nhấp chuột vào các thư mục. Mỗi lúc bạn đều biết mình đang xem thư mục nào, vì tiêu đề cửa sổ ghi rõ. Terminal cũng vậy, chỉ là nó không vẽ cho bạn thấy. Mỗi cửa sổ Terminal có một thư mục hiện hành, tức là nơi mọi lệnh được hiểu là đang chạy.
Khi vừa mở, Terminal thường đứng ở thư mục cá nhân của bạn. Đó là nơi chứa Documents, Downloads, Desktop và nhiều thứ khác. Nếu bạn gõ một lệnh như "liệt kê file" thì nó liệt kê file ở đúng chỗ đó, không phải thư mục bạn đang nghĩ trong đầu.
B.Claude Code lấy thư mục hiện hành làm phạm vi làm việc
Điều này khác hẳn chatbot trên web. Chatbot chỉ nhận chữ bạn dán vào. Claude Code thì đọc được file trong thư mục nơi bạn mở nó, và khi bạn cho phép, nó có thể sửa hoặc tạo file ở đó. Thư mục hiện hành chính là ranh giới công việc.
Nói cách khác, câu "mở đúng thư mục" không phải thủ tục cho vui. Nó là cách bạn quyết định Claude Code được nhìn vào đâu. Mở trong thư mục báo cáo tháng này thì nó chỉ thấy báo cáo tháng này. Mở ở thư mục cá nhân thì phạm vi rộng hơn rất nhiều, và bạn khó kiểm soát hơn.
C.Ba lệnh nhỏ làm nên cả quy trình
Video chỉ dùng đúng ba thứ bạn cần nhớ:
cdđể đổi thư mục hiện hành.pwdđể in ra thư mục đang đứng, giống một câu hỏi "mình đang ở đâu?".claude --versionđể xem số phiên bản, chứng tỏ máy đã nhận lệnhclaude.
Chúng đều là lệnh đọc hoặc lệnh di chuyển, không làm hỏng gì. Bạn có thể gõ bao nhiêu lần cũng được. Chính vì rẻ và an toàn nên nên biến chúng thành thói quen trước mỗi lần giao việc.
II.Làm thế nào: cài, vào đúng thư mục, kiểm tra, rồi mới mở
- Mở TerminalNhấn Command và phím cách, gõ Terminal rồi mở
- Dán lệnh càiDán lệnh trong mô tả video, nhấn Return, đọc hướng dẫn cuối trình cài
- Vào thư mục làm việcGõ cd và một dấu cách, kéo thư mục từ Finder thả vào Terminal, nhấn Return
- Kiểm tra vị tríGõ pwd, đối chiếu với thư mục vừa kéo
- Kiểm tra bản càiGõ claude --version, thấy số phiên bản là đã cài xong
- Mở Claude CodeGõ claude
A.Mở Terminal và dán lệnh cài
Nhấn Command cùng phím cách để mở ô tìm kiếm của máy, gõ Terminal rồi nhấn Return. Một cửa sổ chữ hiện ra. Đừng ngại, bạn chỉ cần dùng vài lệnh.
Lệnh cài mình để trong phần mô tả video. Lý do là lệnh cài có thể được cập nhật theo thời gian, nên bạn nên lấy từ nguồn mới nhất thay vì chép từ một bài viết cũ. Bạn dán vào Terminal, nhấn Return và chờ chạy.
Có một chi tiết hay bị bỏ qua: cuối quá trình cài, trình cài thường in vài dòng hướng dẫn. Hãy đọc kỹ trước khi làm tiếp. Có thể nó nhắc bạn mở cửa sổ Terminal mới, hoặc làm thêm một bước nhỏ để máy nhận lệnh. Bỏ qua dòng này là nguyên nhân phổ biến khiến gõ claude xong lại báo không tìm thấy lệnh.
B.Kéo thư mục từ Finder thay vì gõ đường dẫn
Đường dẫn thư mục trông như một chuỗi dài các tên ngăn cách bởi dấu gạch chéo. Gõ tay rất dễ sai một chữ, và nếu tên có dấu cách hoặc tiếng Việt có dấu thì còn rắc rối hơn.
Cách gọn nhất:
- Gõ
cdrồi thêm một dấu cách. Đừng nhấn Return vội. - Mở Finder, tìm thư mục công việc.
- Kéo thư mục đó thả vào cửa sổ Terminal. Đường dẫn tự điền vào sau chữ
cd. - Nhấn Return.
Terminal tự xử lý tên có dấu cách giúp bạn, nên không cần bận tâm cách viết. Nếu Return xong mà không báo lỗi gì, nghĩa là bạn đã vào được thư mục. Terminal thường im lặng khi thành công, và đó là bình thường.
C.Hỏi lại bằng pwd
Không báo lỗi chưa có nghĩa là đúng chỗ. Gõ pwd và nhấn Return. Terminal sẽ in đường dẫn thư mục đang đứng. Bạn đối chiếu với thư mục vừa kéo: tên cuối cùng có khớp không, có đúng nhánh cha không. Khớp mới giao việc.
Thói quen này giống việc nhìn tên người trên cửa trước khi bước vào phòng họp. Tốn ba giây, đỡ cả buổi sửa lỗi.
D.Kiểm tra bản đang chạy rồi mở Claude Code
Gõ claude --version. Nếu hiện một số phiên bản, Claude Code đã cài xong và máy đã nhận lệnh. Nếu báo không tìm thấy lệnh, quay lại đọc dòng hướng dẫn cuối trình cài, hoặc đóng Terminal rồi mở lại một cửa sổ mới và thử lần nữa.
Cuối cùng gõ claude để mở. Lần đầu bạn sẽ gặp bước đăng nhập. Đó là nội dung của tập sau trong series, nên bài này dừng ở đây.
Trước khi mở claude, luôn xác nhận thư mục bằng pwd. Đừng mở Claude Code ở thư mục cá nhân hoặc ổ đĩa gốc chỉ vì tiện. Hãy tạo riêng một thư mục cho mỗi công việc và chỉ chứa file liên quan.
III.Dùng vào việc thật
A.Chủ shop muốn Claude Code tổng hợp bảng đơn hàng
Bối cảnh: chị Lan bán đồ gia dụng online. Mỗi tuần chị xuất file đơn hàng từ nền tảng bán hàng ra và muốn có bản tóm tắt: sản phẩm nào bán chạy, đơn nào bị hoàn. Chị tạo thư mục don-hang-tuan trên Desktop, chỉ bỏ vào đó các file xuất ra.
Chị mở Terminal, gõ cd kèm dấu cách, kéo thư mục don-hang-tuan vào, nhấn Return, gõ pwd để chắc chắn, rồi gõ claude. Sau đó chị giao việc:
Trong thư mục này có các file đơn hàng tuần vừa rồi. Hãy đọc chúng và cho mình:
1. Năm sản phẩm bán nhiều nhất theo số lượng.
2. Số đơn bị hoàn và lý do hoàn nếu có ghi.
3. Một bảng tóm tắt ngắn mình có thể dán vào báo cáo.
Chỉ đọc file, đừng sửa hay xoá file nào. Nếu cột nào không rõ nghĩa, hỏi mình trước khi đoán.Kết quả là một bản tóm tắt kèm bảng. Chỗ cần kiểm tra lại: chị nên mở file gốc và đối chiếu vài con số, nhất là tổng số đơn, vì phần tính toán có thể sai nếu file có dòng trống hoặc định dạng lạ.
B.Nhân viên văn phòng soạn lại mẫu biên bản
Bối cảnh: anh Hùng làm hành chính, có thư mục chứa mười mấy biên bản họp cũ ở dạng văn bản. Anh muốn thống nhất cách trình bày. Anh tạo một thư mục mới tên bien-ban-thu-nghiem, chép bản sao vào đó, không dùng thư mục gốc.
Sau khi vào thư mục và kiểm tra bằng pwd, anh mở claude và gõ:
Đây là các biên bản họp cũ. Hãy đề xuất một mẫu biên bản thống nhất gồm: thời gian, thành phần tham dự, nội dung chính, việc cần làm kèm người phụ trách và hạn. Chưa sửa file nào, chỉ cho mình xem mẫu đề xuất và một biên bản cũ được chuyển sang mẫu đó làm ví dụ.Điểm đáng học ở đây là anh dùng bản sao. Nếu có sai sót, file gốc vẫn nguyên. Chỗ cần kiểm tra lại là các tên người, ngày tháng và hạn việc trong bản chuyển đổi, vì đây là thông tin dễ bị chép nhầm.
C.Lập trình viên mới đọc hiểu một dự án có sẵn
Bối cảnh: bạn Mai vừa vào công ty, được giao một dự án web nhỏ nhưng chưa biết cấu trúc. Cô kéo thư mục dự án vào Terminal, gõ pwd đối chiếu, mở claude rồi hỏi:
Mình mới vào dự án này. Hãy giải thích cấu trúc thư mục, file nào là điểm bắt đầu, và dự án chạy thế nào ở máy cá nhân. Chỉ đọc, chưa sửa gì. Nếu có chỗ bạn không chắc, nói rõ là không chắc.Đọc hiểu là cách khởi động an toàn nhất, vì không có gì bị thay đổi. Chỗ cần kiểm tra: những lệnh chạy dự án mà Claude Code gợi ý nên được đối chiếu với tài liệu của nhóm trước khi chạy, nhất là lệnh có thể ghi vào cơ sở dữ liệu thật.
IV.Góc nhìn khách quan
A.Điểm mạnh thật sự
Phần mạnh nhất của quy trình này là nó rất rẻ mà hiệu quả. Ba lệnh cd, pwd, claude --version không tốn gì, chạy trong vài giây, nhưng chặn được nhóm lỗi "làm đúng việc nhưng sai chỗ". Kéo thư mục từ Finder còn loại bỏ cả lỗi gõ sai đường dẫn, thứ khiến người mới nản ngay từ bước đầu.
Ngoài ra, việc cài bằng Terminal là cách làm chung, nên các bước sau này như đăng nhập, chạy lệnh đầu tiên đều dùng lại đúng cùng cách mở.
Cài xong chưa đủ. Biết mình đang đứng ở đâu mới là bước an toàn đầu tiên.
Ông T
B.Giới hạn và rủi ro
Đúng thư mục không có nghĩa là an toàn tuyệt đối. Vài điều bạn nên nhớ:
- Quyền truy cập file. Claude Code đọc được những gì nằm trong phạm vi nó làm việc. Nếu thư mục chứa file nhạy cảm như hợp đồng, bảng lương, file chứa mật khẩu hay khoá truy cập thì hãy chuyển chúng ra ngoài trước khi mở.
- Dữ liệu gửi đi. Nội dung bạn cho nó đọc được xử lý qua dịch vụ trực tuyến. Với dữ liệu khách hàng hoặc nội bộ, hãy xem chính sách của công ty và của dịch vụ trước.
- Sai sót. Kết quả có thể sai, nhất là số liệu. Bạn là người chịu trách nhiệm kiểm tra.
- Chi phí lượt dùng. Dùng nhiều thì lượt dùng của gói bạn đăng ký cạn nhanh hơn. Việc nhỏ, rõ phạm vi sẽ đỡ tốn hơn.
- Phụ thuộc mạng. Mất mạng là không làm được.
Một điểm nữa: pwd chỉ cho biết bạn đang ở đâu, không tự ngăn bạn mở nhầm. Nó giúp ích khi bạn chịu nhìn kết quả.
C.Khi nào nên chọn cách khác
Nếu việc của bạn chỉ là hỏi đáp, soạn văn bản ngắn hoặc dịch một đoạn, một chatbot trên web như ChatGPT hay giao diện chat của Claude là đủ, không cần cài gì. Nếu bạn thích làm việc trong trình soạn code có sẵn giao diện đồ hoạ, các công cụ như Cursor hay GitHub Copilot có thể hợp hơn với thói quen của bạn. Còn nếu bạn chưa thoải mái với Terminal, hãy tập vài buổi với ba lệnh cơ bản trước, rồi hẵng quyết định có cần Claude Code hay không.
V.Lỗi hay gặp và cách tránh
A.Mở Claude Code ở thư mục cá nhân
Lỗi này xảy ra khi vừa mở Terminal đã gõ claude. Cách tránh: luôn cd vào thư mục công việc rồi pwd kiểm tra. Nếu lỡ mở sai chỗ, thoát ra, vào đúng thư mục rồi mở lại. Chưa giao việc thì chưa có gì bị thay đổi.
B.Gõ cd mà quên dấu cách trước khi kéo thư mục
Nếu không có dấu cách, đường dẫn dính liền với chữ cd và lệnh sẽ lỗi. Cách khắc phục: xoá dòng, gõ lại cd, thêm một dấu cách rồi kéo.
C.Bỏ qua dòng hướng dẫn cuối trình cài
Người mới hay kéo thẳng xuống và gõ claude, rồi gặp thông báo không tìm thấy lệnh. Hãy cuộn lại đọc dòng cuối. Thường chỉ cần mở cửa sổ Terminal mới hoặc làm theo một bước nhỏ được nhắc ở đó.
D.Làm trực tiếp trên file gốc quan trọng
Ngay cả khi đã đúng thư mục, bạn vẫn nên làm trên bản sao với những file không có bản dự phòng. Sao chép ra một thư mục thử nghiệm, giao việc ở đó, ưng ý rồi mới đưa kết quả về.
E.Chép lệnh cài từ nguồn không rõ
Một lệnh cài chạy thẳng trên máy bạn, nên chỉ dán lệnh từ nguồn bạn tin: phần mô tả của tập này hoặc tài liệu chính thức của Claude Code. Đừng dán lệnh từ một bình luận hay tin nhắn lạ.
VI.Dự phóng: chủ đề này sẽ đi về đâu
Phần này là nhận định của Ông T, không phải thông báo chính thức.
A.Cài đặt sẽ ngày càng ít bước
Mức chắc chắn: khả năng cao. Công cụ nào cũng có xu hướng giảm số bước để người mới bắt đầu. Hướng đi chung của các công cụ AI cho lập trình là làm cho việc cài và mở dễ dần. Bạn nên chuẩn bị bằng cách nắm bản chất (thư mục hiện hành, quyền truy cập) thay vì học thuộc từng thao tác, vì thao tác có thể đổi còn bản chất thì không.
B.Phạm vi làm việc sẽ được kiểm soát rõ hơn
Mức chắc chắn: có thể. Khi AI agent được giao nhiều quyền hơn, nhu cầu giới hạn nó vào đúng phạm vi cũng tăng theo. Có thể ta sẽ thấy nhiều cách hơn để chọn thư mục được phép và hạn chế việc ghi file. Bạn nên tập thói quen mỗi việc một thư mục riêng ngay từ bây giờ, vì thói quen này đúng dù công cụ thay đổi thế nào.
C.Terminal sẽ bớt đáng sợ với người không code
Mức chắc chắn: có thể. Ngày càng nhiều người làm kinh doanh, văn phòng dùng công cụ AI dòng lệnh. Có thể sẽ có thêm giao diện đồ hoạ bao quanh, nhưng phần lõi vẫn là một tiến trình chạy trong một thư mục. Biết ba lệnh cơ bản vẫn có ích khi giao diện có trục trặc.
D.Kiểm tra trước khi giao việc sẽ thành chuẩn chung
Mức chắc chắn: còn bỏ ngỏ. Mình kỳ vọng công cụ sẽ nhắc bạn rõ hơn về thư mục đang mở, nhưng chưa ai biết cách thể hiện cụ thể ra sao. Việc bạn cần làm thì không đổi: tự nhìn và tự xác nhận trước khi cho phép sửa file.
VII.Bắt đầu từ đâu
Cài đặt chỉ là phần dễ. Phần đáng nhớ là hai câu hỏi trước mỗi lần giao việc: mình đang ở thư mục nào, và Claude Code có cần thấy nhiều hơn mức này không. Trả lời xong hai câu đó, bạn đã tránh được phần lớn rắc rối của người mới.
Ba việc bạn làm được ngay hôm nay:
- Tạo một thư mục thử nghiệm trên Desktop, chép vài file không quan trọng vào, rồi tập
cdbằng cách kéo thư mục từ Finder vào Terminal và gõpwdđể đối chiếu. - Làm theo video để cài, sau đó gõ
claude --versionvà ghi lại xem máy báo gì. - Mở
claudetrong thư mục thử nghiệm và giao một việc chỉ đọc, như "liệt kê và tóm tắt các file trong thư mục này, không sửa gì". Sau đó sang tập tiếp theo để đăng nhập.
Câu hỏi thường gặp
Cài Claude Code trên Mac có cần biết lập trình không?
Không. Bạn chỉ cần mở Terminal, dán lệnh cài và dùng vài lệnh cơ bản như cd, pwd. Biết lập trình giúp bạn tận dụng nó tốt hơn, nhưng không phải điều kiện để cài và bắt đầu.
Lệnh cài Claude Code nằm ở đâu?
Trong phần mô tả của video và trong tài liệu chính thức của Claude Code. Mình không ghi lệnh vào bài vì lệnh có thể thay đổi theo thời gian, nên hãy lấy bản mới nhất từ nguồn tin cậy.
pwd dùng để làm gì và có thể làm hỏng gì không?
pwd chỉ in ra thư mục Terminal đang đứng, không thay đổi file nào. Bạn có thể gõ bao nhiêu lần cũng được. Nó giúp bạn xác nhận mình đang ở đúng thư mục trước khi giao việc.
Gõ claude --version báo không tìm thấy lệnh thì làm sao?
Thử đọc lại các dòng hướng dẫn ở cuối trình cài, rồi đóng Terminal và mở cửa sổ mới. Nếu vẫn lỗi, chạy lại lệnh cài từ nguồn chính thức. Mình không chắc nguyên nhân cụ thể trên máy bạn, nên hãy xem thông báo lỗi chi tiết để tra cứu.
Nếu mở Claude Code nhầm thư mục thì có sao không?
Nếu chưa giao việc thì chưa có gì thay đổi, bạn chỉ cần thoát và mở lại đúng thư mục. Rủi ro lớn nằm ở chỗ nó có thể đọc hoặc sửa file trong phạm vi sai. Vì vậy hãy kiểm tra bằng pwd trước khi giao việc.
Có nên dùng Claude Code trên thư mục chứa dữ liệu nhạy cảm không?
Nên tránh. Hãy chuyển file nhạy cảm ra ngoài hoặc làm việc trên bản sao đã lược bỏ thông tin riêng tư. Nội dung bạn cho nó đọc được xử lý qua dịch vụ trực tuyến, nên cần xem chính sách của công ty và của dịch vụ.


