Lỗi cài đặt Claude Code trên Windows: không nhận lệnh, thiếu Git Bash, sai Path và cách sửa

Tóm tắt nhanh
Phần lớn lỗi sau khi cài Claude Code trên Windows không phải do cài sai. Terminal cũ chưa nạp Path mới, thư mục cài chưa nằm trong Path, hoặc máy thiếu Git for Windows. Cách xử lý đúng là mở PowerShell mới, gõ claude --version, kiểm tra bằng where.exe claude, rồi mới sửa đúng chỗ bị lỗi thay vì cài lại nhiều lần.
Cài Claude Code xong mà gõ claude vẫn báo không nhận lệnh thì chưa chắc bạn cài sai. Nhiều khả năng cửa sổ terminal bạn đang dùng chưa nạp lại biến Path, hoặc thư mục chứa lệnh chưa nằm trong Path, hoặc máy còn thiếu Git for Windows. Mỗi nguyên nhân có một cách sửa riêng, và cài lại từ đầu thường không giải quyết được cái nào.
Vì sao chuyện này đáng quan tâm? Vì đây là chỗ người mới hay bỏ cuộc nhất. Bạn làm đúng theo hướng dẫn, nhưng màn hình đỏ chữ. Rất dễ nghĩ rằng công cụ này không dành cho mình, rồi gỡ ra cài lại ba, bốn lần, mỗi lần lại thêm một thư mục cài rải rác khiến mọi thứ rối hơn.
Bài này đi sâu hơn video ngắn bên dưới. Mình giải thích vì sao các lỗi này xảy ra, cách phân biệt chúng bằng vài lệnh đọc-chỉ (không thay đổi gì trên máy), cách sửa an toàn từng loại, và khi nào thì nên cân nhắc cách cài khác. Đọc xong, bạn sẽ có một quy trình chẩn đoán ngắn để áp dụng được cho cả những lỗi mình chưa liệt kê.
I.Bản chất: máy tính tìm lệnh claude như thế nào
A.Path là danh sách thư mục để tìm lệnh
Khi bạn gõ claude vào PowerShell, Windows không tự biết claude nằm ở đâu. Nó đi qua một danh sách thư mục, gọi là Path, và tìm một file chạy được tên claude trong từng thư mục. Thấy thì chạy. Không thấy thì báo kiểu "không nhận ra lệnh".
Vì vậy câu báo lỗi đó chỉ nói một điều: trong danh sách thư mục mà cửa sổ này đang biết, không có file tên claude. Nó không nói là chưa cài. Hai chuyện này khác nhau, và cả bài xoay quanh sự khác biệt đó.
B.Terminal chỉ nạp Path một lần lúc mở
Đây là điểm khiến nhiều người bất ngờ. Mỗi cửa sổ terminal đọc Path một lần, lúc nó được mở. Trình cài đặt có thể đã thêm thư mục mới vào Path của Windows rất đúng, nhưng cửa sổ PowerShell bạn mở từ trước khi cài vẫn cầm bản Path cũ. Cho nên bạn cài xong, gõ claude ngay trong cửa sổ cũ, và nhận lỗi.
Cách quen thuộc để bạn hình dung: giống như bạn in danh bạ điện thoại rồi để trên bàn. Sau đó có người thêm số mới vào bản gốc, nhưng tờ giấy trên bàn bạn vẫn là bản cũ. Muốn thấy số mới, bạn phải in lại, tức là mở cửa sổ mới.
C.Hai lỗi nhìn giống nhau nhưng khác bản chất
Có hai nhóm lỗi thường bị nhầm là một:
- Lỗi "không nhận lệnh"máy không tìm thấy file
claude. Nguyên nhân thuộc về Path hoặc về việc cài chưa hoàn tất. - Lỗi "thiếu công cụ"lệnh
claudegọi được, nhưng khi chạy nó báo thiếu một thành phần đi kèm, điển hình là Git Bash. Claude Code trên Windows cần một môi trường dòng lệnh kiểu Git để chạy một số thao tác, và môi trường đó đến từ Git for Windows.
Hai nhóm này có cách sửa hoàn toàn khác nhau. Sửa Path không giúp gì cho lỗi thiếu Git, và cài Git không giúp gì cho lỗi Path. Đó là lý do tiêu đề video nhấn mạnh: lỗi khác thì cách sửa khác.
II.Làm thế nào: quy trình chẩn đoán từ nhẹ đến nặng
- Mở cửa sổ mớiĐóng PowerShell cũ, mở PowerShell mới rồi gõ claude --version.
- Kiểm tra PathNếu vẫn lỗi, gõ where.exe claude để xem máy có thấy file không.
- Xác định thư mục thậtTìm xem file claude nằm ở đâu trước khi đụng vào Path.
- Sửa đúng chỗChỉ thêm thư mục cài thực tế vào Path, hoặc cài Git for Windows nếu báo thiếu Git Bash.
- Mở lại terminalSau khi sửa Path hoặc cài thêm gì, mở cửa sổ mới rồi thử lại.
Nguyên tắc xuyên suốt: đọc lỗi trước, sửa sau, và mỗi lần chỉ đổi một thứ để biết cái nào thực sự có tác dụng.
A.Bước 1: mở PowerShell mới và gõ claude --version
Đây là bước rẻ nhất và giải quyết được phần lớn trường hợp. Đóng hẳn cửa sổ terminal đang mở, kể cả terminal tích hợp trong trình soạn code nếu bạn đang dùng. Mở một cửa sổ PowerShell hoàn toàn mới rồi gõ:
claude --versionNếu hiện ra số phiên bản, xong: lệnh đã gọi được, vấn đề chỉ là cửa sổ cũ chưa nạp Path. Bạn có thể gõ claude trong thư mục dự án để bắt đầu dùng. Nếu bạn đang dùng terminal trong một trình soạn code, đôi khi phải đóng cả ứng dụng đó rồi mở lại mới nạp Path mới, vì nó giữ Path từ lúc ứng dụng khởi động.
B.Bước 2: kiểm tra bằng where.exe claude
Vẫn không nhận? Đừng vội cài lại. Gõ:
where.exe claudeLệnh này hỏi Windows: "Trong các thư mục của Path, file claude nằm ở đâu?". Kết quả có hai khả năng:
- Hiện ra một đường dẫnmáy thấy file. Lúc này lỗi có thể nằm ở chỗ khác, ví dụ lỗi thiếu Git Bash, hoặc lỗi lúc chạy chứ không phải lúc tìm lệnh.
- Báo không tìm thấyPath hiện tại không chứa thư mục có
claude. Nhưng không tìm thấy không có nghĩa là chưa cài. File có thể đang nằm đâu đó mà Path chưa trỏ tới.
Lưu ý gõ đủ .exe. Trong PowerShell, where đứng một mình là một alias của lệnh khác và sẽ không cho kết quả bạn cần. Một cách tương đương trong PowerShell là gõ Get-Command claude, nó cũng cho biết lệnh đang trỏ vào đâu.
C.Bước 3: tìm thư mục cài thực tế trước khi sửa Path
Chỗ này dễ mắc sai lầm nhất. Nhiều hướng dẫn trên mạng bảo bạn "thêm thư mục X vào Path", nhưng thư mục X trên máy bạn có thể khác. Cách cài khác nhau thì thư mục khác nhau, và mình không muốn đoán đường dẫn thay bạn.
Cách an toàn: nhớ lại trình cài đặt đã in ra gì ở cuối, vì nhiều trình cài báo luôn nơi nó đặt file. Hoặc mở File Explorer, tìm tên claude trong thư mục người dùng của bạn. Khi đã xác định được thư mục chứa file chạy, bạn mới thêm đúng thư mục đó, không thêm cả ổ đĩa hay cả thư mục cha cho chắc ăn.
Cách thêm bằng giao diện: mở phần chỉnh biến môi trường của tài khoản (gõ "biến môi trường" hoặc "environment variables" vào ô tìm kiếm của Windows), chọn Path của người dùng hiện tại, bấm Edit, thêm một dòng mới là thư mục đó. Dùng giao diện thay vì lệnh ghi đè giúp bạn tránh nguy cơ xoá nhầm toàn bộ Path cũ.
Đừng dán lệnh sửa Path mà bạn không hiểu. Một lệnh viết sai có thể ghi đè cả Path, khiến nhiều chương trình khác ngừng chạy. Trước khi sửa, hãy copy nguyên giá trị Path hiện tại ra một file ghi chú để còn khôi phục.
D.Bước 4: lỗi thiếu Git Bash thì cài Git for Windows
Khi lệnh claude gọi được nhưng khi khởi động nó báo thiếu Git Bash, nguyên nhân khác hẳn: máy chưa có Git for Windows. Cách sửa là tải Git for Windows từ trang chính thức git-scm.com, cài với các tuỳ chọn mặc định là đủ cho người mới. Cài xong, mở lại terminal rồi chạy claude lần nữa.
Vì sao phải mở lại? Cùng lý do như Path: Git cũng thêm mình vào Path, và cửa sổ cũ không biết điều đó.
E.Bước 5: mở lại terminal sau mọi thay đổi
Sau khi cài Git, sau khi sửa Path, sau khi cài lại bất cứ thứ gì, hãy mở cửa sổ mới trước khi kết luận "không được". Đây là một thói quen nhỏ nhưng tránh được rất nhiều vòng sửa vô ích.
F.Một số lỗi lân cận bạn có thể gặp
Ngoài ba lỗi chính trong video, có vài tình huống tương tự mà cách nghĩ vẫn như trên:
- PowerShell chặn chạy script khi cài. Đây là chính sách của máy, không phải lỗi của Claude Code. Đọc kỹ nội dung thông báo; nếu máy công ty quản lý chính sách này, hãy hỏi người phụ trách IT thay vì tự nới lỏng.
- Cài qua npm nhưng báo
npmkhông nhận. Đây lại là chuyện Path, lần này của Node.js. Cùng cách chẩn đoán: mở cửa sổ mới, kiểm tra bằngwhere.exe. - Máy công ty hạn chế quyền cài đặt. Bạn có thể thiếu quyền ghi vào thư mục hệ thống. Cài vào thư mục của riêng người dùng thường là hướng đỡ rắc rối hơn.
Không chắc lỗi thuộc loại nào thì chụp nguyên văn thông báo lỗi, rồi hỏi chính Claude hoặc người rành. Một thông báo lỗi đầy đủ giá trị hơn ba câu mô tả "nó không chạy".
III.Dùng vào việc thật
A.Chủ shop online cài trên máy tính bàn ở cửa hàng
Bối cảnh: Chị Lan bán đồ gia dụng, nhờ cháu cài Claude Code để xử lý file đơn hàng. Cài xong, chị mở lại PowerShell đang mở sẵn, gõ claude, nhận lỗi không nhận lệnh. Chị định gỡ ra cài lại.
Cách làm đúng: đóng hẳn cửa sổ, mở PowerShell mới và thử trước. Nếu vẫn lỗi, nhờ Claude trong một ứng dụng chat khác (hoặc người quen) đọc giúp kết quả các lệnh chẩn đoán. Bạn có thể dùng mẫu sau với bất kỳ trợ lý AI nào:
Mình vừa cài Claude Code trên Windows 11. Mở PowerShell mới, gõ claude --version thì báo không nhận lệnh. Mình đã chạy where.exe claude và kết quả là: [dán nguyên văn kết quả]. Hãy giải thích kết quả này nghĩa là gì, và liệt kê các bước kiểm tra tiếp theo theo thứ tự từ ít rủi ro đến nhiều rủi ro. Chưa đề xuất cài lại hay chỉnh Path nếu chưa có bằng chứng.Kết quả nhận được: thường là xác định được cửa sổ cũ chưa nạp Path, hoặc chỉ ra thư mục cài thực tế. Chỗ cần kiểm tra lại: nếu câu trả lời bảo bạn thêm một đường dẫn vào Path, hãy tự mở thư mục đó trong File Explorer xem có đúng file claude bên trong không rồi mới thêm.
B.Nhân viên văn phòng gặp lỗi thiếu Git Bash
Bối cảnh: Anh Minh làm hành chính, máy có tài khoản người dùng thường. Lệnh claude --version hiện số phiên bản bình thường, nhưng khi gõ claude để bắt đầu thì có thông báo nhắc thiếu Git Bash.
Cách làm đúng: đây là lỗi thiếu công cụ chứ không phải lỗi Path, nên đừng đụng vào Path. Tải Git for Windows từ git-scm.com, cài, mở lại terminal. Nếu máy công ty không cho cài phần mềm, nhắn bộ phận IT:
Chào anh/chị IT, mình cần cài Git for Windows để chạy công cụ Claude Code phục vụ công việc soạn thảo và xử lý file trong thư mục dự án của mình. Công cụ này chỉ đọc và sửa file trong thư mục mình mở. Anh/chị hỗ trợ cài giúp hoặc cấp quyền cài được không? Thông báo lỗi nguyên văn mình gặp: [dán lỗi].Kết quả nhận được: IT có đủ thông tin để xử lý mà không phải hỏi lại. Chỗ cần kiểm tra lại: sau khi cài, chạy lại claude --version và mở Claude trong một thư mục thử nghiệm không chứa dữ liệu quan trọng để chắc nó hoạt động bình thường.
C.Lập trình viên mới có nhiều bản cài chồng lên nhau
Bối cảnh: Bạn Hùng mới học code, đã cài Claude Code ba lần bằng ba cách khác nhau theo ba bài hướng dẫn khác nhau. Giờ claude chạy được nhưng không rõ đang chạy bản nào, và có lúc gọi ra bản cũ.
Cách làm đúng: dùng where.exe claude để xem tất cả vị trí máy thấy. Nếu hiện nhiều dòng, Windows sẽ dùng dòng đầu tiên theo thứ tự trong Path. Bạn có thể nhờ Claude hoặc người rành phân tích:
Kết quả where.exe claude trên máy mình hiện ra các dòng sau: [dán các dòng]. Mình nghi có nhiều bản cài chồng nhau. Hãy giải thích bản nào đang được ưu tiên chạy và vì sao, rồi đề xuất cách dọn dẹp an toàn: bước nào chỉ để xem, bước nào có thay đổi, và cách khôi phục nếu sai. Chưa xoá gì cả.Kết quả nhận được: bạn biết bản nào đang chạy và một kế hoạch dọn dẹp có thứ tự. Chỗ cần kiểm tra lại: trước khi xoá bất cứ thư mục nào, chắc chắn đó là thư mục của chính công cụ, không phải thư mục dự án của bạn. Gỡ bản không dùng bằng cách gỡ cài đặt đúng cách (nếu có) thay vì xoá tay.
IV.Góc nhìn khách quan
A.Điểm mạnh thật sự của cách chẩn đoán này
Quy trình "cửa sổ mới, rồi where.exe, rồi sửa đúng chỗ" có một ưu điểm lớn: mỗi bước đều chỉ đọc, không thay đổi máy, trừ bước sửa cuối cùng. Bạn không cần hiểu sâu về hệ điều hành vẫn làm được, và hầu hết trường hợp dừng ở bước đầu tiên.
Nó cũng áp dụng được ngoài Claude Code. Cùng một cách nghĩ này giúp bạn xử lý lỗi "không nhận lệnh" của Node, Python, Git hay bất kỳ công cụ dòng lệnh nào khác. Học một lần dùng được nhiều lần.
Lỗi cài đặt hiếm khi cần cài lại. Phần lớn chỉ cần đọc đúng thông báo và mở một cửa sổ mới.
Ông T
B.Giới hạn và rủi ro
Trước hết, mình không biết máy bạn cấu hình thế nào. Hướng dẫn này chỉ đúng ở mức nguyên tắc; chi tiết như thư mục cài thực tế, tên chính xác của thông báo lỗi có thể khác nhau tuỳ cách cài, tuỳ bản mới hay cũ. Khi có chỗ nào khác với bài, hãy tin vào thông báo lỗi trên máy bạn hơn là tin bài viết.
Tiếp theo là rủi ro khi sửa Path. Sửa sai có thể làm các chương trình khác ngừng nhận lệnh. Đó là lý do mình khuyên sao lưu giá trị cũ và chỉ thêm đúng một thư mục đã xác định.
Thứ ba là bảo mật. Khi dán thông báo lỗi hay kết quả lệnh cho một trợ lý AI hoặc lên diễn đàn, hãy xem kỹ có đường dẫn chứa tên thật, tên công ty hay thông tin nhạy cảm không. Đường dẫn trong thư mục người dùng thường chứa tên tài khoản của bạn. Che bớt trước khi gửi.
Cuối cùng, Claude Code cần kết nối mạng và đăng nhập tài khoản để làm việc, nên cài xong mà chạy không được đôi khi là lỗi mạng hay lỗi đăng nhập chứ không phải lỗi cài đặt. Phần lỗi đăng nhập đã có bài riêng trong series này.
C.Khi nào nên chọn cách khác
Nếu bạn không muốn đụng vào dòng lệnh và Path, có thể bắt đầu bằng một công cụ chạy trên trình duyệt như ChatGPT hay Gemini để làm việc với văn bản, rồi quay lại Claude Code khi cần xử lý file hàng loạt. Dân văn phòng không nhất thiết phải dùng công cụ dòng lệnh từ ngày đầu.
Nếu bạn đã quen một trình soạn code, các công cụ tích hợp trong trình soạn như Cursor hoặc GitHub Copilot có thể là điểm khởi đầu dễ hơn vì không phải gọi lệnh trong terminal. Một số người dùng Windows cũng chọn chạy Claude Code trong môi trường Linux trên Windows (WSL) để tránh vài rắc rối riêng của Windows, nhưng cách này có độ phức tạp riêng và không phải ai cũng cần.
Nếu máy công ty khoá quyền cài đặt, đừng cố lách. Hãy xin phép bộ phận IT, hoặc chọn công cụ mà công ty đã cho phép.
V.Lỗi hay gặp và cách tránh
1. Cài lại ngay khi thấy lỗi. Mỗi lần cài lại có thể thêm một thư mục mới và một mục Path mới. Cách tránh: thử cửa sổ mới và where.exe claude trước. Chỉ cài lại khi có bằng chứng là file không tồn tại.
2. Gõ lệnh trong cửa sổ terminal cũ. Đây là nguyên nhân số một. Cách tránh: sau mọi lần cài hoặc sửa Path, đóng hẳn cửa sổ cũ, kể cả terminal nằm trong trình soạn code, rồi mở mới.
3. Thêm sai thư mục vào Path. Thêm thư mục "chắc là đúng" theo một bài viết nào đó, thay vì thư mục thực tế trên máy bạn. Cách tránh: mở thư mục đó trong File Explorer, thấy file claude bên trong rồi mới thêm. Thêm từng thư mục một, thử lại sau mỗi lần.
4. Nhầm lỗi thiếu Git Bash với lỗi Path. Gặp thông báo nhắc Git, nhưng lại đi sửa Path. Cách tránh: đọc xem thông báo đang nói gì. Nếu claude --version đã chạy được, Path không còn là vấn đề; hãy cài Git for Windows và mở lại terminal.
5. Dán lệnh lạ từ internet mà không hiểu. Đặc biệt là lệnh ghi đè Path hoặc lệnh đổi chính sách máy. Cách tránh: chỉ chạy lệnh bạn hiểu chức năng. Nếu không hiểu, hỏi một trợ lý AI giải thích từng dòng trước khi chạy, và sao lưu Path trước.
VI.Dự phóng: chủ đề này sẽ đi về đâu
Đây là nhận định của Ông T dựa trên hướng đi chung của công cụ lập trình bằng AI, không phải thông báo chính thức của ai.
Cài đặt sẽ ngày càng ít bước tay (khả năng cao). Mọi công cụ dòng lệnh đều chịu áp lực phải dễ cài hơn, vì người dùng mới liên tục tăng. Xu hướng chung là trình cài tự lo phần thêm Path và kiểm tra thành phần phụ thuộc. Bạn nên chuẩn bị: vẫn học cách đọc thông báo lỗi và dùng where.exe, vì khi tự động hoá thất bại, đó là lúc bạn cần kỹ năng chẩn đoán.
Thông báo lỗi sẽ rõ và có hướng dẫn sửa hơn (có thể). Thay vì "không nhận lệnh" khô khan, công cụ có thể tự gợi ý nguyên nhân gần đúng. Nhưng chừng nào hệ điều hành còn là chỗ cấu hình khác nhau trên mỗi máy, sẽ luôn có trường hợp công cụ không đoán được. Hãy tập thói quen lưu lại nguyên văn lỗi.
Trợ lý AI sẽ tự chẩn đoán môi trường cài đặt (có thể). Hướng đi của AI agent là tự chạy lệnh kiểm tra và đề xuất sửa. Nghịch lý là khi công cụ chưa cài được thì agent chưa giúp được. Bạn nên chuẩn bị bằng cách biết rõ những lệnh nào chỉ để xem, những lệnh nào làm thay đổi máy, để khi giao việc chẩn đoán cho AI bạn biết cần duyệt gì.
Cách chạy trên Windows có thể thay đổi (còn bỏ ngỏ). Có thể công cụ sẽ ít phụ thuộc vào thành phần như Git Bash hơn, hoặc ngược lại ưu tiên môi trường khác. Mình không có căn cứ chắc chắn về hướng này. Bạn nên theo dõi tài liệu hướng dẫn cài đặt chính thức khi cài mới, thay vì dựa vào bài viết cũ.
VII.Bắt đầu từ đâu
Lỗi cài đặt nghe đáng sợ nhưng bản chất khá đơn giản: máy chưa tìm thấy lệnh, hoặc thiếu một công cụ đi kèm. Nắm hai ý đó, bạn không cần cài lại nhiều lần để thử vận may.
Ba việc bạn làm được ngay hôm nay:
- Mở một cửa sổ PowerShell mới và gõ
claude --version. Nếu hiện số phiên bản, bạn đã xong phần khó nhất. - Nếu vẫn lỗi, gõ
where.exe claudevà lưu lại nguyên văn kết quả. Chưa sửa gì vội, chỉ ghi lại để có bằng chứng. - Sao lưu giá trị Path hiện tại ra một file ghi chú trước khi chỉnh bất cứ thứ gì, rồi mới thêm đúng thư mục cài thực tế mà bạn đã xác định được.
Câu hỏi thường gặp
Cài Claude Code xong gõ claude báo không nhận lệnh, có phải cài sai không?
Chưa chắc. Thường là cửa sổ terminal bạn đang dùng mở từ trước khi cài nên chưa nạp Path mới. Hãy đóng hẳn, mở PowerShell mới rồi gõ claude --version trước khi nghĩ đến chuyện cài lại.
where.exe claude không tìm thấy gì thì nghĩa là gì?
Nghĩa là trong các thư mục của Path hiện tại không có file tên claude. Nó không chứng minh là chưa cài, vì file có thể nằm ở thư mục chưa có trong Path. Hãy tìm thư mục cài thực tế rồi mới thêm vào Path.
Lỗi thiếu Git Bash là gì và sửa thế nào?
Claude Code trên Windows cần môi trường dòng lệnh kiểu Git để chạy một số thao tác. Khi máy chưa có, bạn sẽ thấy thông báo nhắc thiếu. Cách sửa là cài Git for Windows từ git-scm.com rồi mở lại terminal.
Tại sao sau khi cài Git hoặc sửa Path vẫn phải mở lại terminal?
Mỗi cửa sổ terminal đọc Path một lần lúc được mở. Thay đổi sau đó không tự cập nhật vào cửa sổ đang chạy. Mở cửa sổ mới là cách đơn giản nhất để nạp bản Path mới.
Tự thêm thư mục vào Path có an toàn không?
An toàn nếu bạn làm cẩn thận: chỉ thêm đúng thư mục chứa file claude mà bạn đã xác nhận, dùng giao diện chỉnh biến môi trường và sao lưu giá trị cũ trước. Không nên dán lệnh ghi đè Path mà bạn không hiểu, vì sai có thể ảnh hưởng chương trình khác.
Máy công ty không cho cài Git thì làm sao?
Bạn nên nhờ bộ phận IT cài hoặc cấp quyền, kèm thông báo lỗi nguyên văn và mục đích sử dụng. Đừng cố lách chính sách của công ty. Nếu không được phép, hãy chọn công cụ mà công ty cho dùng.
Tôi không rành dòng lệnh, có nên bỏ qua Claude Code không?
Không bắt buộc phải dùng ngay. Bạn có thể bắt đầu bằng công cụ chat trên trình duyệt và quay lại Claude Code khi cần xử lý file hàng loạt. Nếu muốn thử, quy trình chẩn đoán trong bài khá ngắn và làm theo được.


