Hầu hết trường hợp notch không thấy agent rơi vào ba nhóm: chưa có bản terminal của agent, agent đã đăng xuất, hoặc hook chưa được cài đúng.
Agent "chưa kết nối"
OneNotch chỉ đọc được bản chạy trong terminal của Claude Code và Codex. Ứng dụng desktop hay bản web không đủ.
- Mở Cài đặt › AI. Dưới dòng của agent sẽ có hướng dẫn.
- Bấm Mở trang cài đặt để tới trang hướng dẫn cài đặt chính thức của agent. Nếu máy có Homebrew, bạn có thể bấm Sao chép lệnh và dán vào Terminal.
- Cài xong, bấm Kiểm tra lại.
Agent "đã đăng xuất"
- Claude Code: mở Terminal, chạy
claude, gõ/loginrồi hoàn tất đăng nhập qua trình duyệt. - Codex: mở Terminal và chạy
codex login.
Sau đó bấm Kiểm tra lại.
Hook cần sửa
Trong Cài đặt › AI › Kết nối, mở agent có trạng thái Cần kiểm tra:
- Hook OneNotch cần được sửa chữa hoặc một dòng báo Thiếu: bấm Cài đặt lại.
- Hook Codex chưa được thiết lập: bấm Thiết lập.
- Codex chưa tin cậy hook: mở Codex, chạy
/hooksvà tin cậy các hook của OneNotch. Codex chỉ chạy hook bạn đã tin cậy. - Bấm Làm mới để kiểm tra lại trạng thái.
OneNotch tự sửa hook khi mở app nếu thấy hook bị mất hay đã cũ, nhưng không bao giờ tự cài lại sau khi bạn bấm Xóa.
Phiên chạy nhưng không hiện
- Kiểm tra Theo dõi AI agent đang bật và công tắc của agent đó trong mục Agent đang bật.
- Nếu bạn vừa tắt rồi bật lại Theo dõi AI agent, hãy bấm Thiết lập lại, vì tắt theo dõi sẽ gỡ hook.
- Chỉ phiên đang chạy hoặc đang chờ bạn mới hiện trên notch đóng. Phiên đã xong vẫn có trong trang AI.
- Phiên Claude chưa có prompt đầu tiên thì chưa được liệt kê.
Gỡ hoàn toàn
Bấm Xóa trong bảng Kết nối của từng agent. OneNotch gỡ hook của mình, trả lại dòng trạng thái cũ của Claude Code nếu bạn có, và giữ nguyên mọi thiết lập khác.