Kết nối điện thoại với Claude Code (Mac, Windows, Linux)

Q: Mã ghép nối có hiệu lực trong bao lâu?

Cả mã 6 chữ số từ ứng dụng lẫn link QR từ ccn pair đều có hiệu lực 24 giờ. Sau đó, bạn cần tạo mã mới.

Q: Ghép nối có thay đổi cài đặt Claude Code của tôi không?

Khi cài ccn, bảy mục hook được thêm vào ~/.claude/settings.json, mọi thứ khác giữ nguyên và một bản sao lưu một lần được lưu ngay cạnh file. Bản thân việc ghép nối chỉ liên kết điện thoại. ccn uninstall sẽ gỡ các hook, các ghép nối và trạng thái cục bộ.

Q: Làm sao để hủy ghép nối điện thoại?

Chạy ccn devices để xem các điện thoại đã ghép nối, rồi chạy ccn devices revoke . ccn forget còn xóa luôn máy tính khỏi server.

Để kết nối điện thoại với Claude Code, hãy cài app Claude Code Notifier trên iPhone hoặc điện thoại Android, cài công cụ dòng lệnh miễn phí ccn trên máy tính, rồi ghép nối chúng. Chạy ccn pair và quét mã QR hiện ra, hoặc mở app tại Computers > Add a computer rồi chạy ccn pair với mã 6 chữ số mà app hiển thị. Cách làm giống nhau trên Mac, Windows và Linux, mất khoảng một phút.

01Ghép nối mang lại gì

Sau khi ghép nối điện thoại, Claude Code có thể báo cho bạn khi cần:

Push "Claude đã xong" ngay khi một lượt kết thúc.
Yêu cầu cấp quyền mà bạn có thể cho phép một lần, cho phép trong cả phiên, hoặc từ chối.
Câu hỏi mà bạn có thể trả lời bằng cách chọn một lựa chọn.
Chỉ dẫn tiếp theo mà bạn có thể gửi ngay sau khi Claude xong.

Trước khi ghép nối, ccn đã hiển thị thông báo desktop trên máy tính cho đúng những thời điểm này. Ghép nối chỉ thêm điện thoại vào.

Claude Code Notifier là công cụ độc lập do TouchTap Ltd phát triển, không do Anthropic làm ra hay liên kết với Anthropic. Công cụ hoạt động qua hook của Claude Code, nên áp dụng cho mọi phiên claude trong bất kỳ terminal nào, kể cả terminal bên trong các IDE VS Code, Cursor và JetBrains.

02Trước khi bắt đầu

Bạn cần:

Claude Code đã được cài và chạy được trên máy tính.
App Claude Code Notifier trên điện thoại, tải từ App Store hoặc Google Play. Nếu bạn quét mã QR trước khi có app, điện thoại sẽ tự mở cửa hàng ứng dụng cho bạn.
Kết nối mạng trên cả hai thiết bị.

App tải miễn phí nhưng cần đăng ký hoặc mua trọn đời để sử dụng, gói năm có dùng thử miễn phí. Xem bảng giá.

03Hai cách ghép nối

Có hai cách, đều cho kết quả như nhau, nên chọn cách nào tiện hơn.

CáchBắt đầu từPhù hợp khi

Mã QRMáy tínhMàn hình máy tính đang ở ngay trước mặt bạn

Mã 6 chữ sốĐiện thoạiBạn đang dùng máy từ xa, qua SSH, hoặc không quét được mã QR

Cả link QR lẫn mã 6 chữ số đều có hiệu lực trong 24 giờ.

04Cách 1: quét mã QR

Trên Mac hoặc Linux

Mở terminal và cài ccn:

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

Hoặc dùng Homebrew:

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

Chạy ccn (hoặc ccn pair). Lệnh này sẽ cài hook nếu cần, rồi in ra một mã QR và một link.
Hướng camera điện thoại vào mã QR và mở link. Nếu đã cài app, app sẽ mở ra và ghép nối. Nếu chưa, điện thoại sẽ đưa bạn tới App Store hoặc Google Play trước; cài app xong là quá trình ghép nối tiếp tục.
Terminal sẽ xác nhận điện thoại đã được ghép nối.

Trên Windows

Mở PowerShell và cài ccn (hỗ trợ Windows đang ở bản beta):

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

Chạy ccn pair. PowerShell sẽ hiện một mã QR và một link.
Quét mã bằng camera điện thoại như ở trên.
PowerShell sẽ xác nhận điện thoại đã được ghép nối.

Dùng Node.js hoặc plugin, trên mọi hệ điều hành

Nếu có Node.js, lệnh sau sẽ cài đặt và bắt đầu ghép nối luôn:

npx @touchtap/ccn

Hoặc ngay trong Claude Code, cài dưới dạng plugin rồi chạy lệnh setup:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05Cách 2: nhập mã 6 chữ số

Cách này bắt đầu từ điện thoại, tiện khi bạn khó nhìn màn hình máy tính, hoặc khi Claude Code chạy trên server bạn truy cập qua SSH.

Mở app Claude Code Notifier và vào Computers > Add a computer.
App sẽ hiện một mã 6 chữ số và đúng dòng lệnh cần chạy cho hệ điều hành của bạn.
Chạy dòng lệnh đó trên máy tính. Nếu đã cài ccn, chỉ cần:

ccn pair 482913

Thay 482913 bằng mã của bạn.

Cài đặt và ghép nối chỉ với một dòng lệnh

Dòng lệnh cài đặt nào cũng nhận được mã, nên máy mới chỉ cần một lệnh duy nhất.

Trên Mac hoặc Linux:

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

Trên Windows, trong PowerShell:

irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913

Nếu dùng plugin Claude Code, truyền mã vào lệnh setup: /ccn:setup 482913.

06Kiểm tra xem đã chạy chưa

Hai lệnh sau giúp xác nhận mọi thứ đã sẵn sàng:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

Sau đó thử thật. Chạy claude, giao một tác vụ nhỏ rồi rời khỏi bàn phím. Khi xong, điện thoại sẽ nhận được push.

Lưu ý: ccn biết khi nào bạn đang ngồi ở máy. Nếu bạn vừa gõ phím trong 30 giây gần nhất, các prompt xin quyền và câu hỏi sẽ hiện trong terminal như bình thường, điện thoại cùng lắm chỉ nhận một thông báo nhỏ. Hãy rời máy để thấy điện thoại tiếp quản.

07Ghép nối nhiều thiết bị

Nhiều máy tính, một điện thoại. Lặp lại các bước trên từng máy. Mac ở công ty, máy Linux ở nhà và laptop Windows đều có thể gửi tới cùng một điện thoại. Chạy nhiều phiên Claude Code hướng dẫn cách phân biệt chúng.
Nhiều điện thoại, một máy tính. Ghép nối từng điện thoại với cùng một máy tính.
Xem hoặc gỡ điện thoại. ccn devices liệt kê các điện thoại đã ghép nối, còn ccn devices revoke <name> gỡ một thiết bị.

08Script và máy từ xa

ccn pair --no-wait in mã QR rồi trả về ngay, phù hợp cho script và provisioning. Trên server qua SSH, cách dùng mã 6 chữ số thường đơn giản nhất, vì bạn nhập mã ngay trong phiên SSH đang dùng cho Claude Code. Nhận thông báo từ Claude Code trên server từ xa qua SSH hướng dẫn phần còn lại.

09Nếu ghép nối không thành công

Mã bị từ chối. Mã chỉ có hiệu lực 24 giờ. Hãy tạo mã mới trong app, hoặc dùng cách quét QR.
Không quét được mã QR. Hãy phóng to cửa sổ terminal, hoặc mở đường link được in ra trên điện thoại.
Không tìm thấy ccn sau khi cài đặt. Mở một terminal mới để PATH được cập nhật.
Đã ghép nối nhưng không nhận được push. Chạy ccn doctor, rồi ccn test, và kiểm tra xem ứng dụng đã được cho phép gửi thông báo trong phần cài đặt của điện thoại chưa.

Danh sách đầy đủ có trong Thông báo Claude Code không hoạt động? Danh sách kiểm tra.

10Chưa muốn ghép nối ngay?

Không sao cả. Thông báo trên desktop hoạt động ngay khi cài ccn. Cho đến khi bạn ghép nối điện thoại, ccn thỉnh thoảng sẽ gợi ý chạy ccn pair. Để tắt các gợi ý này:

ccn config set pair_nudges off

11Câu hỏi thường gặp

Có cần tài khoản để ghép nối không?

Không. Claude Code Notifier không dùng tài khoản. Việc ghép nối liên kết máy tính với điện thoại mà không cần đăng ký. Thông báo đi qua một relay được mã hóa và bị xóa trong vòng 48 giờ. Xem Chính sách quyền riêng tư.

Mã ghép nối có hiệu lực trong bao lâu?

Cả mã 6 chữ số từ ứng dụng lẫn link QR từ ccn pair đều có hiệu lực 24 giờ. Sau đó, bạn cần tạo mã mới.

Có thể ghép nối máy tính không có màn hình không?

Có. Dùng cách mã 6 chữ số: mở Computers > Add a computer trong ứng dụng rồi chạy ccn pair kèm mã đó trên máy kia, ví dụ qua SSH.

Ghép nối có thay đổi cài đặt Claude Code của tôi không?

Khi cài ccn, bảy mục hook được thêm vào ~/.claude/settings.json, mọi thứ khác giữ nguyên và một bản sao lưu một lần được lưu ngay cạnh file. Bản thân việc ghép nối chỉ liên kết điện thoại. ccn uninstall sẽ gỡ các hook, các ghép nối và trạng thái cục bộ.

Làm sao để hủy ghép nối điện thoại?

Chạy ccn devices để xem các điện thoại đã ghép nối, rồi chạy ccn devices revoke <name>. ccn forget còn xóa luôn máy tính khỏi server.

Claude Code Notifier Nhận push trên điện thoại khi Claude Code chạy xong hoặc cần bạn, rồi duyệt, từ chối hoặc trả lời ngay tại đó. Công cụ dòng lệnh ccn miễn phí trên Mac, Windows và Linux.

Tải cho iOS Tải cho Android Cài đặt ccn