ccn là một chương trình nhỏ mà Claude Code chạy qua hook, trên macOS, Windows hoặc Linux. Cài xong là bạn nhận được thông báo trên máy tính ngay khi Claude xong việc, cần cấp quyền hay đặt câu hỏi. Ghép nối điện thoại khi nào bạn muốn: những khoảnh khắc đó cũng sẽ đến dưới dạng thông báo đẩy, và bạn có thể duyệt, từ chối hoặc trả lời từ điện thoại. Không có gì chạy nền, và nó hoạt động ở bất kỳ terminal nào.

đã có mã? Bạn đến từ ứng dụng điện thoại với mã 6 chữ số? Chuyển tới Ghép nối điện thoại: mọi dòng lệnh cài đặt đều nhận mã và ghép nối luôn trong cùng một bước. Chưa có ứng dụng? Tải cho iOS hoặc Android.

01Cài đặt

macOS và Linux

curl -fsSL https://claudecodenotifier.com/web/install.sh | sh

Windows (PowerShell)

irm https://claudecodenotifier.com/web/install.ps1 | iex

Hỗ trợ Windows đang ở bản beta. Gói winget và Scoop sắp có.

Homebrew

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn

Ai có Node.js cũng dùng được

npx @touchtap/ccn pair

Mỗi dòng lệnh cài ccn cùng các hook của nó, nên lần tới khi Claude Code xong việc hay cần bạn, một thông báo sẽ hiện trên máy tính này. Không cần điện thoại và không có gì chạy nền. ccn thêm bảy mục vào ~/.claude/settings.json và giữ nguyên mọi thứ khác trong tệp đó. Bạn có mã từ ứng dụng điện thoại? Các dòng lệnh trong mục Ghép nối điện thoại cài đặt và ghép nối trong một bước.

02Ghép nối điện thoại

Ghép nối là tùy chọn và không bao giờ làm gián đoạn: ccn vẫn thông báo trên máy tính này dù có điện thoại ghép nối hay không. Khi đã ghép nối, mọi thông báo cũng đến điện thoại dưới dạng thông báo đẩy, và bạn có thể duyệt, từ chối hoặc trả lời từ đó. Có hai cách ghép nối.

Quét mã QR từ terminal

ccn pair

Chạy ccn hoặc ccn pair. Lệnh sẽ in ra một mã QR và một liên kết có hiệu lực 24 giờ: quét mã bằng camera điện thoại, hoặc mở liên kết trên điện thoại. Chưa có ứng dụng thì liên kết sẽ đưa bạn tới cửa hàng trước; có rồi thì điện thoại tự kết nối. ccn pair --no-wait in chúng ra rồi thoát ngay, để bạn tiếp tục làm việc và quét sau.

Nhập mã từ ứng dụng

ccn pair 482913

Mở Claude Code Notifier trên điện thoại và thêm một máy tính. Ứng dụng hiển thị mã 6 chữ số cùng dòng lệnh chính xác cần chạy, đã có sẵn mã trong đó. Nếu ccn đã được cài, chỉ cần ccn pair kèm mã phía sau. Nếu chưa, mỗi dòng lệnh cài đặt đều nhận mã, cài đặt và ghép nối trong một bước:

Cách càiDòng lệnh cần chạy

macOS và Linuxcurl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913

Windows (PowerShell)irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913

Homebrewbrew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913

Ai có Node.js cũng dùng đượcnpx @touchtap/ccn pair 482913

Thay 482913 bằng mã trên điện thoại của bạn. Mã có hiệu lực 24 giờ; hết hạn thì ứng dụng tạo mã mới.

Sau mười thông báo trên máy tính mà chưa ghép nối điện thoại, ccn thêm một dòng gợi ý chạy ccn pair. ccn config set pair_nudges off sẽ tắt dòng này.

03Bạn nhận được gì

Tự thân ccn hiển thị thông báo trên máy tính này khi Claude xong việc, cần cấp quyền hay đặt câu hỏi. Khi ghép nối điện thoại, bạn còn có thêm:

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.

04Lệnh

LệnhCông dụng

ccn pairHiện mã QR và liên kết để ghép nối điện thoại (hiệu lực 24 giờ) rồi chờ

ccn pair CODEGhép nối bằng mã 6 chữ số từ ứng dụng

ccn pair --no-waitIn mã QR và liên kết rồi thoát ngay

ccn doctorKiểm tra hook, việc ghép nối và kết nối

ccn 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áy

ccn config showHiển thị cài đặt của máy tính này

ccn config set pair_nudges offTắt gợi ý ghép nối sau các thông báo trên máy tính

ccn syncLấy ngay các cài đặt đã đổi trên điện thoại

ccn upgradeCập nhật ccn lên phiên bản mới nhất ngay

ccn config set auto_update offTắt kiểm tra cập nhật hằng ngày

ccn unlockMua giấy phép và mở khóa máy tính này (xem Giấy phép)

05Giấy phép

Giấy phép mua tại claudecodenotifier.com/licence mở khóa mọi điện thoại ghép nối với tối đa 3 máy tính. Giấy phép gắn với máy tính: bạn nhập khóa vào ccn, không bao giờ nhập vào ứng dụng điện thoại.

ccn unlockMua giấy phép trên trình duyệt và mở khóa máy tính này (--lifetime để trả một lần)

ccn activate KEYDùng khóa của bạn trên máy tính này (--replace NAME giải phóng chỗ của máy tính khác)

ccn deactivateGiải phóng chỗ của máy tính này để dùng khóa ở nơi khác

ccn licenceHiện gói, ngày gia hạn và các máy tính đang dùng khóa

Khi chưa có giấy phép, ccn có thể hiện một dòng mỗi ngày trong Claude Code, cùng một thông báo trên máy tính, hướng dẫn cách mở khóa. CCN_NO_NUDGE=1 sẽ tắt điều này.

06Cập nhật

ccn upgrade

ccn tự giữ mình luôn mới: mỗi ngày một lần, nó kiểm tra phiên bản mới trong nền và cài đặt. ccn upgrade cập nhật ngay, và ccn config set auto_update off tắt kiểm tra hằng ngày. Nếu bạn cài bằng Homebrew hoặc npm, ccn để việc cập nhật cho trình quản lý gói và cho bạn biết lệnh cần chạy.

07Ứ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ể gọi webhook, 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.

08Gỡ 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.

ccn forget

Xóa máy tính này khỏi máy chủ chuyển tiếp và gỡ ccn.