"Tiến trình Claude Code đã thoát với mã 1": cách tìm lỗi thực sự và khắc phục

Bước 1: lấy thông báo lỗi thực sự

claude --version    # is the CLI there at all?
claude              # start it directly: the real error prints here
claude doctor       # install health check

Nếu terminal hoạt động và chỉ tiện ích mở rộng hoặc ứng dụng gặp lỗi, vấn đề nằm ở môi trường mà lớp bao dùng để khởi chạy (PATH, phiên bản Node, biến proxy) — chứ không phải bản thân Claude Code. Nếu terminal cũng gặp lỗi, hãy tìm kiếm thông báo mà nó in ra.

Các nguyên nhân đã biết (từ hệ thống theo dõi sự cố)

• Tiếp tục một phiên chạy nền trong VS Code. Mở một phiên được khởi chạy bằng claude --bg gây ra chính lỗi này — đã được báo cáo trên macOS, Windows và Linux (#77162). Trước tiên hãy dừng tác nhân chạy nền, hoặc mở một phiên mới.
• Windows: tiến trình mồ côi sau khi ứng dụng bị sập. Ứng dụng không thể khởi chạy lại vì một tiến trình cũ vẫn giữ khóa (#42776, #53247). Kết thúc các tiến trình claude còn sót lại trong Task Manager; cách khắc phục đáng tin cậy được báo cáo ở đó là khởi động lại toàn bộ Windows.
• Ứng dụng máy tính trên Apple Silicon gặp lỗi mỗi lần bắt đầu phiên trong khi CLI vẫn hoạt động (#59866, trùng với một sự cố đã biết) — hãy cập nhật ứng dụng; trong thời gian chờ, dùng CLI trong terminal.
• Node.js thấp hơn 18 hoặc PATH bị lỗi sau khi cài đặt bằng npm — lớp bao không thể khởi chạy CLI. node -v; chuyển sang trình cài đặt gốc để loại bỏ phụ thuộc vào Node.
• `~/.claude/settings.json` không hợp lệ. Một dấu phẩy thừa trong khối hooks hoặc permissions khiến CLI thoát ngay lập tức. Hãy kiểm tra tính hợp lệ của JSON.
• Shell không tương thích trên Windows — một công cụ PowerShell gặp lỗi khi chạy từ Git Bash với một mô hình cụ thể (#87980); hãy thử shell còn lại.

Nếu không trường hợp nào ở trên phù hợp

• Cập nhật mọi thành phần: claude update, và cập nhật tiện ích mở rộng VS Code hoặc ứng dụng máy tính.
• Cài lại bằng trình cài đặt gốc (curl -fsSL https://claude.ai/install.sh | bash, hoặc các lệnh một dòng PowerShell / CMD trong hướng dẫn cài đặt).
• Khởi chạy VS Code từ terminal để nó kế thừa cùng môi trường với CLI đang hoạt động.
• Tạo báo cáo sự cố mới kèm đầu ra của claude doctor — hệ thống theo dõi sự cố phân loại các trường hợp bị sập nhanh chóng.

Liên quan

Nếu Claude Code khởi chạy nhưng sau đó gặp lỗi API, đó là một vấn đề khác: xem Lỗi API 500, quá tải / 529, Lỗi API 400 hoặc Lỗi OAuth. Riêng với tiện ích mở rộng, xem Claude Code trong VS Code.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.