اربط هاتفك بـ Claude Code على Mac أو Windows أو Linux

01ما الذي يمنحك إياه الاقتران

بعد اقتران الهاتف، يستطيع Claude Code الوصول إليك عندما يحتاج إليك:

• إشعار push بعنوان "انتهى Claude" لحظة انتهاء الدور.
• طلبات أذونات يمكنك السماح بها مرة واحدة، أو طوال الجلسة، أو رفضها.
• أسئلة يمكنك الإجابة عنها باختيار أحد الخيارات.
• تعليمة لاحقة يمكنك إرسالها فور انتهاء Claude.

حتى قبل الاقتران، يعرض ccn إشعارات على سطح المكتب للحظات نفسها. والاقتران يضيف الهاتف.

Claude Code Notifier أداة مستقلة من صنع شركة TouchTap Ltd، وليست من صنع Anthropic ولا تابعة لها. تعمل عبر الـ hooks في Claude Code، لذا تغطي كل جلسة claude في أي terminal، بما في ذلك الـ terminal داخل بيئات التطوير VS Code وCursor وJetBrains.

02قبل أن تبدأ

ستحتاج إلى:

• Claude Code مثبّتًا ويعمل على جهاز الكمبيوتر.
• تطبيق Claude Code Notifier على هاتفك، من App Store أو Google Play. وإن مسحت رمز QR قبل تثبيت التطبيق، فسيوجّهك هاتفك إلى المتجر.
• اتصال بالشبكة على كلا الجهازين.

تنزيل التطبيق مجاني، لكن استخدامه يتطلب اشتراكًا أو شراءً مدى الحياة، مع فترة تجريبية مجانية في الخطة السنوية. راجع الأسعار.

03طريقتان للاقتران

هناك طريقتان تؤديان إلى النتيجة نفسها، فاختر الأسهل لك.

تبقى روابط QR والرموز المكوّنة من 6 أرقام صالحة لمدة 24 ساعة.

04الطريقة 1: مسح رمز QR

على Mac أو Linux

1. افتح terminal وثبّت ccn:

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

أو باستخدام Homebrew:

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

2. شغّل ccn (أو ccn pair). سيثبّت الـ hooks عند الحاجة ثم يعرض رمز QR ورابطًا.
3. وجّه كاميرا هاتفك نحو رمز QR وافتح الرابط. إذا كان التطبيق مثبّتًا، فسيفتح ويُكمل الربط. وإن لم يكن مثبّتًا، فسيقترح عليك الهاتف أولًا App Store أو Google Play؛ ثبّت التطبيق وسيستمر الربط تلقائيًا.
4. يؤكّد الـ terminal أن الهاتف قد رُبط.

على Windows

1. افتح PowerShell وثبّت ccn (دعم Windows في المرحلة التجريبية):

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

2. شغّل ccn pair. سيعرض PowerShell رمز QR ورابطًا.
3. امسحه بكاميرا هاتفك كما في الخطوات السابقة.
4. يؤكّد PowerShell أن الهاتف قد رُبط.

باستخدام Node.js أو كإضافة (plugin)، على أي نظام تشغيل

إذا كان Node.js مثبّتًا لديك، فهذا الأمر يثبّت الأداة ويبدأ الربط دفعة واحدة:

npx @touchtap/ccn

أو من داخل Claude Code، ثبّتها كإضافة (plugin) وشغّل أمر الإعداد الخاص بها:

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

05الطريقة 2: إدخال رمز من 6 أرقام

تبدأ هذه الطريقة من الهاتف، وهي مفيدة عندما يصعب عليك رؤية شاشة الحاسوب جيدًا، أو عندما يعمل Claude Code على خادم تصل إليه عبر SSH.

1. افتح تطبيق Claude Code Notifier وانتقل إلى الحواسيب > إضافة حاسوب.
2. يعرض التطبيق رمزًا من 6 أرقام والسطر الذي عليك تشغيله بالضبط حسب نظام تشغيلك.
3. شغّل ذلك السطر على الحاسوب. إذا كان ccn مثبّتًا مسبقًا، فالأمر ببساطة:

ccn pair 482913

استخدم رمزك الخاص بدلًا من 482913.

التثبيت والربط بسطر واحد

يمكن تمرير الرمز إلى أي سطر تثبيت، لذا لا يحتاج الحاسوب الجديد إلا إلى أمر واحد.

على Mac أو Linux:

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

على Windows، في PowerShell:

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

عند استخدامها كإضافة في Claude Code، مرّر الرمز إلى أمر الإعداد: /ccn:setup 482913.

06تحقّق من أنه يعمل

يؤكّد أمران أن كل شيء جاهز:

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

ثم جرّبها فعليًا. شغّل claude، وأعطه مهمة صغيرة، وابتعد عن لوحة المفاتيح. عندما ينتهي، سيصلك push على هاتفك.

لاحظ أن ccn يدرك متى تكون أمام الحاسوب. إذا كتبت شيئًا خلال آخر 30 ثانية، فستظهر طلبات الأذونات والأسئلة في الـ terminal كالمعتاد، ولن يصل إلى الهاتف أكثر من تنبيه بسيط. ابتعد عن الحاسوب لترى الهاتف يتولّى الأمر.

07ربط أكثر من جهاز

• عدة حواسيب وهاتف واحد. كرّر الخطوات على كل حاسوب. يمكن لجهاز Mac في العمل وجهاز Linux في المنزل وحاسوب Windows المحمول أن تصل جميعها إلى الهاتف نفسه. يشرح دليل تشغيل عدة جلسات من Claude Code كيفية التمييز بينها.
• عدة هواتف وحاسوب واحد. اربط كل هاتف بالحاسوب نفسه.
• عرض الهواتف أو إزالتها. يعرض ccn devices الهواتف المرتبطة، ويزيل ccn devices revoke <name> أحدها.

08السكربتات والأجهزة البعيدة

يعرض ccn pair --no-wait رمز QR ويعود فورًا، ما يناسب السكربتات وعمليات التهيئة. أما على خادم عبر SSH، فطريقة الرمز المكوّن من 6 أرقام هي الأبسط عادةً، لأنك تكتب الرمز في جلسة SSH نفسها التي تستخدمها مع Claude Code. يغطي دليل إشعارات Claude Code على خادم بعيد عبر SSH بقية خطوات هذا الإعداد.

09إذا لم ينجح الربط

• رُفض الرمز. تبقى الرموز صالحة لمدة 24 ساعة. أنشئ رمزًا جديدًا في التطبيق، أو استخدم طريقة QR.
• لا يمكن مسح رمز QR. كبّر نافذة الـ terminal، أو افتح الرابط المطبوع على هاتفك بدلًا من ذلك.
• الأمر ccn غير موجود بعد التثبيت. افتح terminal جديدًا حتى يتحدّث PATH.
• تم الاقتران، لكن لا يصل أي إشعار push. شغّل ccn doctor ثم ccn test، وتأكد من السماح بإشعارات التطبيق في إعدادات هاتفك.

القائمة الكاملة موجودة في إشعارات Claude Code لا تعمل؟ قائمة تحقق.

10لست مستعدًا للاقتران بعد؟

لا مشكلة. تعمل إشعارات سطح المكتب فور تثبيت ccn. وإلى أن تقرن هاتفًا، سيقترح عليك ccn أحيانًا تشغيل ccn pair. لإيقاف هذه الاقتراحات:

ccn config set pair_nudges off

11الأسئلة الشائعة