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:

Terminal

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

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).

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

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

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.

Terminal

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

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