ccn برنامج صغير يشغّله Claude Code عبر خطّافاته، على macOS أو Windows أو Linux. ثبّته لتحصل على إشعار على سطح المكتب لحظة ينتهي Claude أو يحتاج إلى إذن أو يطرح سؤالًا. اربط هاتفك متى شئت، فتصل اللحظات نفسها أيضًا كإشعار فوري، ويمكنك الموافقة أو الرفض أو الإجابة من هناك. لا شيء يعمل في الخلفية، ويعمل في أي طرفية.
01التثبيت
macOS وLinux
curl -fsSL https://claudecodenotifier.com/web/install.sh | sh
Windows (PowerShell)
irm https://claudecodenotifier.com/web/install.ps1 | iex
دعم Windows في مرحلة تجريبية. حزم winget وScoop قادمة.
Homebrew
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn
لكل من لديه Node.js
npx @touchtap/ccn pair
كل سطر يثبّت ccn وخطّافاته، فعندما ينتهي Claude Code في المرة التالية أو يحتاج إليك يظهر إشعار على هذا الكمبيوتر. لا حاجة إلى هاتف، ولا شيء يعمل في الخلفية. يضيف ccn سبعة إدخالات إلى ~/.claude/settings.json ويترك كل ما عداها في الملف كما كان. لديك رمز من تطبيق الهاتف؟ الأسطر في قسم ربط هاتفك تثبّت وتربط دفعة واحدة.
02ربط هاتفك
الربط اختياري ولا يعطّل شيئًا: يواصل ccn إشعار هذا الكمبيوتر سواء رُبط هاتف أم لا. وبعد الربط يصل كل إشعار إلى هاتفك أيضًا كإشعار فوري، ويمكنك الموافقة أو الرفض أو الإجابة من هناك. هناك طريقتان للربط.
مسح رمز QR من الطرفية
ccn pair
شغّل ccn أو ccn pair. يطبع رمز QR ورابطًا يبقيان صالحين 24 ساعة: امسح الرمز بكاميرا هاتفك، أو افتح الرابط على الهاتف. دون التطبيق يعرض الرابط المتجر أولًا؛ ومع التطبيق يتصل الهاتف من تلقاء نفسه. ccn pair --no-wait يطبعهما ويعود فورًا، لتواصل عملك وتمسح الرمز لاحقًا.
كتابة الرمز من التطبيق
ccn pair 482913
افتح Claude Code Notifier على هاتفك وأضف كمبيوترًا. يعرض التطبيق رمزًا من 6 أرقام والسطر المطلوب تشغيله، وفيه الرمز جاهز. إذا كان ccn مثبّتًا، يكفي ccn pair متبوعًا بالرمز. وإلا فكل سطر تثبيت يقبل الرمز ويثبّت ويربط دفعة واحدة:
curl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913npx @touchtap/ccn pair 482913استبدل 482913 بالرمز الظاهر على هاتفك. تدوم الرموز 24 ساعة، ويُنشئ التطبيق رمزًا جديدًا عند انتهاء صلاحيته.
بعد عشرة إشعارات على سطح المكتب دون هاتف مرتبط، يضيف ccn سطرًا واحدًا يقترح ccn pair. ccn config set pair_nudges off يوقفه.
03ما الذي تحصل عليه
وحده، يعرض ccn إشعارًا على هذا الكمبيوتر عندما ينتهي Claude أو يحتاج إلى إذن أو يطرح سؤالًا. ومع هاتف مرتبط تحصل أيضًا على:
- انتهى Claude: إشعار فوري لحظة ينتهي الدور.
- الأذونات: سماح مرة، أو سماح للجلسة، أو رفض، من الهاتف.
- الأسئلة: اختر إجابة عندما يطلب منك Claude الاختيار.
- متابعة: فور انتهاء Claude، أرسل التعليمات التالية من الهاتف.
إن كتبت شيئًا خلال آخر 30 ثانية، فلا شيء ينتظر: تسأل الطرفية كالمعتاد ويصل الهاتف تنبيه فقط. وإن كنت بعيدًا، تنتظر الطرفية هاتفك، وتتوقف عن الانتظار لحظة تلمس لوحة المفاتيح. يمكنك تغيير المهل لكل كمبيوتر من التطبيق.
04الأوامر
ccn pairعرض رمز QR ورابط لربط هاتف (صالحان 24 ساعة) والانتظارccn pair CODEالربط بالرمز المكوّن من 6 أرقام من التطبيقccn pair --no-waitطباعة رمز QR والرابط ثم العودة فورًاccn doctorفحص الخطّافات والربط والاتصالccn testإرسال إشعار تجريبيccn devicesعرض الهواتف المرتبطة، أو إلغاء ربط أحدهاccn config showعرض إعدادات هذا الكمبيوترccn config set pair_nudges offإيقاف اقتراح الربط بعد إشعارات سطح المكتبccn syncجلب الإعدادات المتغيرة على الهاتف الآنccn upgradeتحديث ccn إلى أحدث إصدار الآنccn config set auto_update offإيقاف فحص التحديثات اليوميccn unlockشراء ترخيص وفتح هذا الكمبيوتر (انظر الترخيص)05الترخيص
الترخيص المشترى من claudecodenotifier.com/licence يفتح كل هاتف مرتبط بما يصل إلى 3 أجهزة كمبيوتر. يُحفظ على الكمبيوتر: تكتب المفتاح في ccn، وليس في تطبيق الهاتف أبدًا.
ccn unlockشراء ترخيص من المتصفح وفتح هذا الكمبيوتر (--lifetime للدفع مرة واحدة)ccn activate KEYاستخدام مفتاحك على هذا الكمبيوتر (--replace NAME يحرّر مكان كمبيوتر آخر)ccn deactivateتحرير مكان هذا الكمبيوتر لاستخدام المفتاح في مكان آخرccn licenceعرض الخطة وتاريخ التجديد وأجهزة الكمبيوتر التي تستخدم المفتاحدون ترخيص، قد يعرض ccn سطرًا واحدًا يوميًا في Claude Code، وإشعارًا على سطح المكتب، يوضح كيفية الفتح. CCN_NO_NUDGE=1 يوقفه.
06التحديثات
ccn upgrade
يحافظ ccn على تحديث نفسه: مرة يوميًا يتحقق في الخلفية من وجود إصدار جديد ويثبّته. ccn upgrade يحدّث فورًا، وccn config set auto_update off يوقف الفحص اليومي. إن ثبّته عبر Homebrew أو npm، يترك ccn التحديث لمدير الحزم ويخبرك بالأمر المطلوب تشغيله.
07تطبيق Mac
ما زال تطبيق Claude Code Notifier في شريط القوائم على Mac يعمل، وهو مجاني. إن كنت تفضّل تطبيقًا على الطرفية، نزّله أو شغّل brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier. وعلى خلاف ccn، يستطيع تشغيل webhooks، ويحتاج إلى iTerm2 أو kitty أو tmux للرد من الهاتف. لا تشغّل الاثنين على جهاز Mac نفسه، وإلا وصل كل إشعار مرتين. للانتقال من التطبيق إلى ccn، اربط بالأمر ccn pair CODE --replace-mac-app الذي يزيل خطّافات التطبيق، ثم أغلق التطبيق.
08إلغاء التثبيت
ccn uninstall
يزيل هذا الخطّافات من settings.json، ويلغي عمليات الربط، ويحذف الحالة المحلية. ثم احذف الملف التنفيذي: ~/.local/bin/ccn على macOS وLinux، أو %LOCALAPPDATA%\Programs\ccn على Windows، أو brew uninstall ccn.
ccn forget
يمحو هذا الكمبيوتر من خادم الترحيل ويزيل ccn.