Bỏ qua để vào nội dung chính
Claude Code không báo khi xong việc: 3 cách bật thông báo

Claude Code không báo khi xong việc: 3 cách bật thông báo

Bởi Lucas Fischer
11 thg 11, 20264 phút đọc

VS Code và Cursor không bật thông báo cho Claude Code. Ba cách bật: một dòng settings.json, hook Stop, và hook cho biết session nào vừa xong.

Bạn giao cho Claude Code một task refactor dài, chuyển sang tab Slack trả lời vài tin nhắn. Hai mươi phút sau quay lại, nó vẫn đứng im ở một prompt xin quyền chạy lệnh — đợi chữ "yes" suốt từ phút thứ hai. Dưới đây là ba cách bật thông báo, từ một dòng config đến hook cho biết chính xác session nào vừa xong.

Vì sao terminal trong VS Code im lặng

Đây không phải bug cấu hình của bạn. Theo bài hướng dẫn của Eren Çolak: "Claude Code sends a desktop notification on its own only in a few terminals (Ghostty, Kitty, iTerm2). In the VS Code terminal, Warp and most others it sends nothing by default." Nếu bạn dev trong VS Code hoặc Cursor — tức phần lớn anh em — mặc định là không có tín hiệu nào cả. Các cách dưới đây được tác giả kiểm chứng trên Claude Code 2.1.x, cả macOS, Linux lẫn Windows.

Cách 1: một dòng trong settings.json

Mở ~/.claude/settings.json và thêm:

{ "preferredNotifChannel": "terminal_bell" }

Một lưu ý dễ làm bạn tưởng config hỏng: trong VS Code và Cursor, chuông terminal mặc định tắt tiếng. Vào Settings, tìm Terminal Bell (mục Accessibility Signals) rồi bật sound lên. Đổi lại, tiếng bíp này ngắn, bạn phải ngồi trong tầm nghe, và nó không nói được session nào vừa kêu.

Cách 2: hook bắn desktop notification

Hook là lệnh Claude Code chạy tại các mốc vòng đời. Hai event đáng quan tâm:

  • Stop — bắn ngay khi Claude kết thúc lượt.
  • Notification với matcher permission_prompt — khi Claude cần bạn duyệt và prompt đã chờ khoảng sáu giây.

Còn idle_prompt bắn lại khoảng 60 giây sau một lượt đã xong nếu bạn chưa gõ gì — hook cả hai thì một lượt xong bạn nhận hai thông báo. Chọn Stop thôi.

Lệnh theo hệ điều hành: macOS dùng osascript -e 'display notification "Your turn" with title "Claude Code"', Linux dùng notify-send 'Claude Code' 'Your turn' (cần notification daemon, nên không chạy qua SSH trần), Windows phát chime bằng PowerShell.

Chi tiết quan trọng nhất lại là một field nhỏ: "async": true. Hook mặc định chạy đồng bộ, Claude đứng chờ từng cái — riêng thời gian khởi động PowerShell trên Windows đã cỡ một tới ba giây, cộng vào mọi lượt. Bật async, lệnh chạy nền.

Cách 3: nói rõ session nào

Chạy ba, bốn session song song thì "Your turn" vô nghĩa. Mỗi hook nhận một JSON object qua stdin, trong đó có cwd — thư mục session đang chạy. Pipe qua jq -r '.cwd' | xargs basename và nhét vào nội dung thông báo: bạn sẽ thấy api hoặc web thay vì một dòng chung chung.

Ba chỗ dễ sai

  • Hook cộng dồn, không ghi đè. Settings user, project và local đều đóng góp hook và chạy song song. Project đã có Stop hook thì hook của bạn chạy cạnh nó, không thay thế.
  • Độ trễ sáu giây là cố ý. Prompt bạn duyệt ngay sẽ không ping. Đừng "sửa" bằng cách hook PermissionRequest trừ khi bạn muốn nhận alert cho mọi lần approve.
  • macOS không hiện gì? Thông báo osascript đi qua Script Editor. Chạy osascript -e 'display notification "test"' một lần trong Terminal để Script Editor xuất hiện trong System Settings > Notifications, rồi cấp quyền.

Làm gì tiếp

Bắt đầu bằng cách 1 trong năm giây; nếu một ngày bạn mở nhiều hơn hai session thì lên thẳng cách 3. Trước khi dựng hook, kiểm tra version terminal: các terminal hỗ trợ giao thức status OSC 7501 tự hiển thị session nào đang chạy, session nào đang chờ, không cần setup gì, kể từ Claude Code 2.1.295. Và nếu bạn vừa nâng cấp để chạy Fable 5.2 thì bản tối thiểu là v2.1.321 — vẫn nằm trong nhánh 2.1.x mà hướng dẫn trên đã kiểm chứng.

Không spam, hủy đăng ký bất kỳ lúc nào.

Bài viết liên quan