OneNotch
Tải về

Theo dõi Claude Code và Codex trên notch

Bật theo dõi AI agent và kết nối Claude Code, Codex chạy trong terminal để thấy tiến trình ngay trên notch.

OneNotch theo dõi các phiên Claude Code và Codex bạn chạy trong terminal: agent đang làm gì, khi nào cần bạn trả lời, khi nào xong việc và còn bao nhiêu hạn mức. Để làm được vậy, OneNotch cài một vài "hook" nhỏ vào cấu hình của từng agent.

Trước khi bắt đầu

Bạn cần bản chạy trong terminal của Claude Code hoặc Codex, đã cài và đã đăng nhập. Ứng dụng desktop và bản web của Claude hay Codex không ghi ra dữ liệu mà OneNotch đọc được, nên không theo dõi được.

Bật theo dõi

  1. Vào Cài đặt › AI và bật Theo dõi AI agent.
  2. Trong mục Agent, giữ bật Claude Code và/hoặc Codex tuỳ agent bạn dùng.
  3. Trong mục Kết nối, mở Claude Code hoặc Codex và bấm Thiết lập.
  4. Với Codex: lần đầu Codex hỏi về hook mới, chọn Trust all. Nếu đã lỡ bỏ qua, mở Codex và chạy lệnh /hooks để tin cậy các hook của OneNotch.
Cài đặt › AI: Theo dõi AI agent, mục Notch, Hạn mức, Âm thanh, Agent

Bạn cũng có thể bật theo dõi và kết nối agent ngay trong phần hướng dẫn lần đầu mở OneNotch.

Thiết lập làm gì với cấu hình của bạn

  • Claude Code: OneNotch thêm hook vào ~/.claude/settings.json và một dòng trạng thái để đọc hạn mức. Nếu bạn đã có dòng trạng thái riêng, nó vẫn chạy và hiển thị như cũ.
  • Codex: OneNotch thêm hook vào ~/.codex/hooks.json và bật tính năng hook trong config.toml.

Mọi hook và thiết lập bạn đã có vẫn được giữ nguyên. OneNotch sao lưu file trước khi sửa.

Mục Kết nối trong Cài đặt › AI: Codex chưa thiết lập (nút Thiết lập), Claude Code đã kết nối với settings.json, Lệnh hook, Dòng trạng thái sử dụng và các nút Cài đặt lại, Xóa, Làm mới

Nút trong bảng Kết nối đổi theo trạng thái của từng agent:

  • Chưa cài hook: Thiết lập, cùng Làm mới. Xóa bị làm mờ vì chưa có gì để gỡ.
  • Đã kết nối (dấu tích xanh, Đã kết nối): Cài đặt lại, Xóa và Làm mới. Cài đặt lại cài hook một lần nữa, dùng khi hook bị sửa hay xoá mất ngoài ý muốn.

Tuỳ chỉnh

Trong Cài đặt › AI:

  • Hiển thị phần trăm theo: Đã dùng (mặc định) hoặc Còn lại.
  • Sắp xếp session theo: Ưu tiên mục cần xử lý (mặc định) hoặc Cập nhật gần nhất.
  • Biểu tượng đang chạy: kiểu hoạt ảnh trên notch khi agent đang làm việc, như Lưới pixel, Hình khối hay Quả cầu quét.
  • Tắt cảnh báo và Âm thanh cảnh báo: âm thanh khi một phiên xong hoặc cần bạn.

Nếu Claude Code dùng thư mục cấu hình khác ~/.claude, mở Kết nối › Claude Code › Nâng cao và nhập đường dẫn vào Thư mục cấu hình, rồi nhấn Return.

Tắt theo dõi

Tắt Theo dõi AI agent sẽ ẩn trang AI và gỡ hook của OneNotch khỏi cả Claude Code lẫn Codex. Khi bật lại, hãy bấm Thiết lập lần nữa. Muốn gỡ hook của một agent mà vẫn giữ theo dõi agent kia, bấm Xóa trong bảng Kết nối của agent đó.

Cũng trong AI agent