ccn là một chương trình nhỏ mà Claude Code chạy qua hook. Nó gửi thông báo đẩy tới điện thoại khi Claude xong việc hay cần bạn, và cho phép bạn duyệt, từ chối hoặc trả lời từ đó. Không có gì chạy nền, và nó hoạt động ở bất kỳ terminal nào.
01Cài đặt và ghép nối
macOS và Linux
curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913
Windows (PowerShell)
irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913
Hỗ trợ Windows đang ở bản beta.
Homebrew
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913
Ai có Node.js cũng dùng được
npx @touchtap/ccn pair 482913
Mỗi dòng lệnh cài ccn và ghép nối luôn trong một bước. Để cài mà không cần mã, bỏ phần mã đi (| sh, hoặc phần trước &&) rồi chạy ccn pair CODE sau. Thay 482913 bằng mã trên điện thoại của bạn. Mã có hiệu lực 5 phút; hết hạn thì ứng dụng tạo mã mới. Việc ghép nối thêm bảy mục vào ~/.claude/settings.json và giữ nguyên mọi thứ khác trong tệp đó.
02Bạn nhận được gì
- Claude đã xong việc: thông báo đẩy ngay khi một lượt kết thúc.
- Cấp quyền: cho phép một lần, cho phép cả phiên hoặc từ chối, ngay từ điện thoại.
- Câu hỏi: chọn một đáp án khi Claude yêu cầu bạn lựa chọn.
- Chỉ dẫn tiếp theo: ngay sau khi Claude xong việc, gửi chỉ dẫn kế tiếp từ điện thoại.
Nếu bạn vừa gõ phím trong 30 giây gần đây, không có gì phải chờ: terminal hỏi như thường và điện thoại nhận một ghi chú. Nếu bạn đang rời máy, terminal sẽ chờ điện thoại của bạn, và ngừng chờ ngay khi bạn chạm vào bàn phím. Bạn có thể đổi thời gian chờ cho từng máy tính trong ứng dụng.
03Lệnh
ccn pair CODEGhép nối với điện thoại và cài các hookccn doctorKiểm tra hook, việc ghép nối và kết nốiccn testGửi một thông báo thửccn devicesLiệt kê các điện thoại đã ghép nối, hoặc thu hồi một máyccn config showHiển thị cài đặt của máy tính nàyccn syncLấy ngay các cài đặt đã đổi trên điện thoại04Ứng dụng Mac
Ứng dụng thanh menu Mac của Claude Code Notifier vẫn hoạt động, và miễn phí. Nếu bạn thích ứng dụng hơn terminal, hãy tải về hoặc chạy brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier. Khác với ccn, ứng dụng này có thể hiện thông báo trên Mac và gọi webhook mà không cần điện thoại, và cần iTerm2, kitty hoặc tmux để trả lời từ điện thoại. Đừng chạy cả hai trên cùng một máy Mac, nếu không mỗi thông báo sẽ đến hai lần. Để chuyển từ ứng dụng sang ccn, hãy ghép nối bằng ccn pair CODE --replace-mac-app, lệnh này gỡ các hook của ứng dụng, rồi thoát ứng dụng.
05Gỡ cài đặt
ccn uninstall
Lệnh này gỡ các hook khỏi settings.json, thu hồi các lần ghép nối và xóa trạng thái cục bộ. Sau đó xóa tệp thực thi: ~/.local/bin/ccn trên macOS và Linux, %LOCALAPPDATA%\Programs\ccn trên Windows, hoặc brew uninstall ccn.