Khắc phục sự cố
Hầu hết sự cố đều có cách sửa nhanh. Nếu vấn đề của bạn không có ở đây, hãy gửi email hỗ trợ kèm hệ điều hành, phiên bản PATerminal (Cài đặt → Cập nhật) và những gì bạn đã thử.
Viết cho PATerminal v1.8.3
Cài đặt và mở ứng dụng
- Windows: “Windows protected your PC”
- Nhấp More info, rồi Run anyway. SmartScreen cảnh báo với ứng dụng mới; hãy so sánh SHA-256 trên hướng dẫn cài đặt Windows nếu bạn muốn chắc chắn.
- macOS hỏi trước khi mở
- Chọn Mở. Ứng dụng được ký bằng Developer ID và được Apple công chứng.
Git báo lỗi
Khi có gì đó trên máy khiến git không chạy được, PATerminal hiển thị Không thể chạy Git trên máy tính này cùng cách sửa. Các trường hợp thường gặp:
| Nguyên nhân | Cách sửa |
|---|---|
| macOS: chưa chấp nhận giấy phép Xcode (thường ngay sau khi cập nhật Xcode) | sudo xcodebuild -license accept |
| macOS: thiếu hoặc hỏng Command Line Tools | xcode-select --install |
| Chưa cài Git | Hãy cài Git (Windows: winget install Git.Git); PATerminal sẽ tự nhận. |
| “Dubious ownership” trên ổ đĩa khác hoặc thư mục chia sẻ qua mạng | git config --global --add safe.directory <path> — chỉ dùng cho thư mục bạn tin cậy. |
| Windows: đường dẫn quá dài | git config --global core.longpaths true |
Pull request hoặc issue không tải được
Đảm bảo gh đã được cài và đăng nhập (gh auth status), và kho có remote trên GitHub. Nhấn Thử lại sau khi sửa.
Phiên cứ ở trạng thái “Đang chạy”
- Có thứ gì đó trong phiên vẫn đang in ra — máy chủ dev, trình theo dõi tệp hoặc biểu tượng đang xử lý. Đó là đầu ra thật, nên trạng thái là đúng.
- Codex 0.154.0 trở lên được khởi động trước khi PATerminal lưu
tui.whimsy = false: hãy khởi động lại phiên Codex đó. Cài đặt tường minh ở cấp dự án hoặc trên dòng lệnh có thể ghi đè nó. Xem Lưu ý cho người dùng Codex.
Không có thông báo
- Kiểm tra Cài đặt → Thông báo đã bật.
- Cho phép thông báo của PATerminal trong cài đặt hệ điều hành, và kiểm tra chế độ Tập trung / Không làm phiền.
- Thông báo chỉ được gửi cho các phiên bạn không xem.
Cuộc trò chuyện không tiếp tục được
- Có thể agent đã thoát trước khi lưu cuộc trò chuyện. Hãy mở nó từ Lịch sử thay vào đó.
- Chuyển Claude Code sang thư mục không liên quan cần Claude Code v2.1.223 trở lên.
- Các tùy chọn bạn chỉ truyền trên dòng lệnh ban đầu sẽ không được áp dụng lại.
Cập nhật thất bại
Nếu không cài được bản cập nhật đã ký, PATerminal sẽ không khởi động lại và không có gì thay đổi. Hãy thử lại sau, hoặc tải trình cài đặt mới nhất từ trang tải về và cài đè lên phiên bản hiện tại — phiên và cài đặt của bạn vẫn được giữ.
Dữ liệu của tôi ở đâu?
Phiên, nhóm, ghi chú, câu mẫu và cài đặt được lưu dưới dạng tệp cục bộ trên máy bạn; cuộc trò chuyện của agent nằm trong thư mục riêng của agent (ví dụ ~/.claude và ~/.codex). Không có gì được đồng bộ lên máy chủ, và PATerminal không có telemetry.
Vẫn chưa giải quyết được?
Xem phần Hỏi đáp, hoặc gửi email cho chúng tôi kèm hệ điều hành, phiên bản PATerminal và những gì bạn đã thử. Chúng tôi trả lời mọi thư.