Lỗi thường gặp

claude: command not found sau khi cài

npm đã cài xong nhưng terminal hiện tại chưa nạp lại PATH. Mở terminal mới rồi thử lại.

Nếu vẫn không được, kiểm tra thư mục bin global của npm có trong PATH chưa:

npm config get prefix
# thư mục trên + /bin phải nằm trong $PATH

Lỗi EACCES: permission denied khi npm install

Xem cách sửa chi tiết ở trang Lỗi thường gặp của Codex — giống hệt nhau (đổi npm prefix hoặc dùng nvm).

Windows: running scripts is disabled on this system

PowerShell trên Windows mặc định chặn chạy file .ps1 (execution policy Restricted), mà lệnh claude khi gõ trong PowerShell lại đi qua shim claude.ps1 của npm. Mở PowerShell và chạy một lần duy nhất:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Rồi mở terminal mới. (Script cài đặt của chúng tôi không bị ảnh hưởng — nó tự gọi npm qua cmd để né việc này.)

Windows: lỗi EBUSY: resource busy or locked

Claude Code đang chạy (terminal khác, hoặc VS Code) nên npm không ghi đè được claude.exe. Script bản mới tự phát hiện trường hợp này: bỏ qua bước nâng cấp và vẫn cập nhật settings — bạn dùng được ngay. Muốn nâng cấp CLI lên bản mới nhất: đóng hết mọi cửa sổ đang chạy claude rồi chạy lại lệnh cài đặt.

Key sai hoặc hết hạn (lỗi 401 / unauthorized)

• Mở ~/.claude/settings.json, kiểm tra giá trị ANTHROPIC_AUTH_TOKEN đúng key của bạn
• Đổi key mới: chạy lại lệnh cài đặt với key mới — settings cũ tự được sao lưu

Claude Code không dùng đúng model

Kiểm tra trong settings.json:

• "model": "default" — Claude Code tự chọn theo các biến ANTHROPIC_DEFAULT_*_MODEL
• Trong phiên chạy, gõ /model để xem và đổi model đang dùng

Task dài bị ngắt giữa chừng

Cấu hình mặc định đã đặt API_TIMEOUT_MS = 3000000 (50 phút). Nếu bạn từng sửa tay settings, chạy lại lệnh cài đặt để về cấu hình chuẩn.

Khôi phục settings cũ

ls ~/.claude/*.bak.*
# khôi phục: copy đè lại, ví dụ
cp ~/.claude/settings.json.bak.20260811120000 ~/.claude/settings.json

Vẫn chưa hết lỗi?

Liên hệ hỗ trợ kèm ảnh chụp lỗi — xem kênh liên hệ ở trang Bắt đầu.