تطوير Claude Code عن بُعد على الهاتف المحمول

مقدمة

تخيل هذه السيناريوهات: تفاجئك فكرة رائعة لإصلاح خطأ وأنت في مترو الأنفاق أثناء ذهابك للعمل؛ تتلقى تنبيه طوارئ إنتاج عاجل أثناء وقوفك في طابور المقهى؛ تريد التحقق من تقدم مشروعك الذي بناه AI بينما ترافق صديقتك في التسوق.

في سير عمل التطوير التقليدي، هذه السيناريوهات تعني عادةً أنك بحاجة لإيجاد مكان لفتح حاسوبك المحمول، أو تأجيل العمل بلا حول ولا قوة. لكن في عصر البرمجة بمساعدة AI، تغيرت القواعد. Claude Code يجعل من الممكن حمل بيئة التطوير في جيبك والبقاء منتجًا في أي وقت وأي مكان.

في صيف 2025، مع تزايد تبني Claude Code، بدأ المطورون يستكشفون أساليب مختلفة لـ "البرمجة على الهاتف". من الاستخدام البسيط المحلي عبر Termux، إلى اتصالات SSH + Tailscale عن بُعد المعقدة، إلى تطبيقات Happy Coder المخصصة، تشكلت منظومة تطوير متكاملة للهاتف المحمول تدريجيًا.

المشكلة الأساسية التي يحلها هذا الفصل هي: كيف تجعل Claude Code يتبع هاتفك ويصبح "مساعد تطوير في جيبك" حقًا.

---

نظرة عامة على آراء المجتمع

بناءً على تجارب المجتمع الحقيقية، تتم مقارنة تجربة كل نهج على النحو التالي:

Happy Coder (النهج 2)

• مشاكل استقرار الاتصال: تحدث حالات انقطاع متكررة، ويضيع السياق بعد الانقطاع
• وظائف محدودة: لا يمكن استخدام أوامر /
• مخاوف أمنية: يعتمد على خوادم الترحيل الرسمية، وبعض المستخدمين قلقون بشأن أمن البيانات

HAPI (النهج 3)

• يدعم الخوادم ذاتية الاستضافة: يمكن نشرها على VPS الخاص بك
• تجربة أفضل عند الاقتران مع Tailscale: شغّل hapi server على حاسوبك واتصل من هاتفك عبر عنوان IP الخاص بـ Tailscale
• اتصال مستقر نسبيًا، مناسب للاستخدام طويل الأمد

التحكم عن بُعد من Claude (النهج الرسمي)

• حل رسمي، مدمج أصلاً مع Claude Code
• يدعم الوصول الكامل للبيئات المحلية (MCP، الأدوات، إعداد المشروع)
• يتطلب اشتراك Max (دعم Pro قادم قريبًا)
• يعتمد على اتصال سحابة Anthropic

التوصية: إذا كنت بحاجة لاستقرار اتصال عالٍ، أو قلق بشأن أمان الترحيل عبر طرف ثالث، اختر HAPI + Tailscale أو نهج التحكم عن بُعد الرسمي.

---

المبدأ الأساسي: أنماط بنية تطوير الهاتف المحمول

قبل تقديم النهج المحددة، افهم أولاً جوهر المشكلة.

لماذا يُعد تطوير الهاتف المحمول مشكلة؟

بيئات التطوير المتكاملة التقليدية (مثل VS Code و IntelliJ) تتطلب بيئة نظام تشغيل كاملة، ومعالج قوي، وذاكرة كبيرة، ومساحة تخزين. على الرغم من أن الهواتف أصبحت أقوى، إلا أنها لا تزال لها حدود طبيعية لتجربة التطوير:

قيود الإدخال: لوحات المفاتيح الافتراضية غير فعالة للبرمجة، والصياغة المعقدة سهلة الخطأ

قيود الشاشة: الشاشات الصغيرة تجعل من الصعب عرض الكود والطرفية والمتصفح في نفس الوقت

قيود البيئة: الهواتف لا تستطيع تشغيل سلسلة أدوات تطوير كاملة (المترجمات، قواعد البيانات، أدوات التصحيح)

قيود الاتصال: شبكات الهاتف غير مستقرة، وجلسات SSH تنقطع بسهولة

الفكرة الأساسية: بنية العميل الخفيف

الفكرة الأساسية وراء جميع نهج تطوير الهاتف المحمول هي نفسها: الهاتف هو فقط "وحدة التحكم"؛ العمل التطويري الحقيقي يتم في مكان آخر.

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│    ┌─────────────┐              ┌─────────────┐             │
│    │   الهاتف    │              │ المضيف/سحابة│             │
│    │  (المتحكم)  │   ────────►  │  (المنفذ)   │             │
│    │             │   الأوامر    │             │             │
│    │ • إرسال    │              │ • تشغيل CLI │             │
│    │ • عرض      │              │ • تنفيذ     │             │
│    │ • مراجعة   │              │ • وصول fs   │             │
│    └─────────────┘              └─────────────┘             │
│                                                             │
└─────────────────────────────────────────────────────────────┘

تسمح هذه البنية للهاتف بالتركيز فقط على التفاعل بين الإنسان والحاسوب، بينما يتم تفويض العمليات الحسابية الثقيلة إلى مضيفك أو السحابة.

---

النهج 1: تطبيق iOS الرسمي

في أكتوبر 2025، أطلقت Anthropic رسميًا دعم Claude Code للهاتف المحمول في تطبيق iOS. هذا هو خيار تطوير الهاتف المحمول الأبسط.

القيود الإقليمية

ملاحظة مهمة: تطبيق Claude لا يمكن استخدامه مباشرة في بر الصين الرئيسي.

إذا كنت في بر الصين الرئيسي، يُنصح باستخدام Happy Coder مباشرة (النهج 2)، والذي يمكنه العمل بشكل طبيعي من خلال خدمات ترحيل API المحلية المكونة.

إذا كان لديك حساب Apple ID خارجي، يمكنك تبديل المناطق وتحميل تطبيق Claude.

كيف يعمل

┌─────────────┐                    ┌─────────────────┐
│  تطبيق iOS  │ ──────────────────► │ سحابة Anthropic │
│  (الهاتف)   │   HTTPS + OAuth    │  Claude Code    │
└─────────────┘                    └────────┬────────┘
                                           │
                                           ▼
                                   ┌───────────────┐
                                   │  GitHub API   │
                                   └───────────────┘

تطبيق هاتفك يرسل الأوامر فقط. جميع عمليات تنفيذ الكود تعمل في بيئة اختبار سحابة Anthropic، ويتم المزامنة عبر GitHub.

الاستخدام الأساسي

المتطلبات المسبقة:

• هاتف iPhone بنظام iOS 15 أو أحدث
• اشتراك Claude Pro/Team/Enterprise (الخطة المجانية غير مدعومة)
• حساب GitHub

الخطوات:

1. حمّل تطبيق Claude من App Store
2. سجّل الدخول إلى حساب Anthropic الخاص بك
3. ابحث عن تبويب "Code" في التطبيق
4. اربط مستودع GitHub الخاص بك عبر OAuth
5. ابدأ في إنشاء المهام

المزايا والعيوب

المزايا هي عدم وجود حاجز إعداد، تجربة سلسة، وإشعارات فورية. العيوب هي دعم iOS فقط، سير عمل GitHub أساسي، قدرات محدودة نسبيًا (لا يمكن الوصول إلى أنظمة الملفات المحلية)، وعدم التوفر المباشر في بر الصين الرئيسي.

---

النهج 2: Happy Coder

Happy Coder هو عميل مفتوح المصدر للهاتف المحمول والويب مصمم لـ Claude Code و Codex، مع تشفير من طرف إلى طرف وتحكم عن بُعد في مساعد البرمجة الذكي الخاص بك من أي مكان.

كيف يعمل

┌─────────────┐              ┌─────────────┐              ┌─────────────┐
│  تطبيق Happy│   ────────►  │ خادم Happy  │   ◄────────  │happy-coder  │
│ (هاتف/ويب)  │ WS مشفر     │  (ترحيل)    │  WebSocket   │ (سطح مكتب)  │
└─────────────┘              └─────────────┘              └──────┬──────┘
                                                               │
                                                               ▼
                                                        ┌─────────────┐
                                                        │ Claude Code │
                                                        │    CLI      │
                                                        └─────────────┘

على حاسوبك، شغّل happy بدلاً من claude لإطلاق مساعد البرمجة الذكي. عندما تحتاج إلى تحكم الهاتف، تتحول الجلسة تلقائيًا إلى وضع عن بُعد. اضغط على أي مفتاح على حاسوبك للعودة إلى التحكم المحلي.

التثبيت والاستخدام

الخطوة 1: تحميل التطبيق

المنصة	الرابط
iOS	App Store
Android	Google Play
الويب	app.happy.engineering

الخطوة 2: تثبيت CLI على الحاسوب

npm install -g happy-coder

الخطوة 3: الإطلاق والاقتران

# شغّل في مجلد مشروعك
cd ~/my-project
happy

# سيتم عرض رمز QR للاقتران

الخطوة 4: المسح والاقتران على الهاتف

افتح تطبيق Happy وامسح رمز QR المعروض على حاسوبك. بعد نجاح الاقتران، يمكنك التحكم في Claude Code من هاتفك.

الخطوة 5: الاستخدام

# إطلاق Claude Code
happy

# أو إطلاق Codex
happy codex

روابط الموارد

• مشروع GitHub - الكود المصدري
• التوثيق - وثائق الاستخدام
• مجتمع Discord - نقاش المجتمع

المزايا والعيوب

المزايا هي سهولة الإعداد، دعم متعدد المنصات، تشفير من طرف إلى طرف، وقابلية التدقيق مفتوحة المصدر. العيوب هي الاعتماد على بنية تحتية لترحيل طرف ثالث والحاجة للتحقق من توفر تطبيق الهاتف في بيئتك الخاصة.

---

النهج 3: HAPI

HAPI هو بديل لـ Happy Coder، بتصميم محلي أولاً ودعم لتبديل الأجهزة السلس عبر نماذج AI متعددة.

كيف يعمل

┌─────────────┐              ┌─────────────┐              ┌─────────────┐
│  تطبيق HAPI │   ────────►  │ خادم HAPI   │   ◄────────  │    hapi     │
│ (هاتف/PWA/  │  WireGuard   │ (ترحيل ذاتي│  WireGuard   │ (سطح مكتب)  │
│  Telegram)  │   + TLS      │  الاستضافة) │   + TLS      │             │
└─────────────┘              └─────────────┘              └──────┬──────┘
                                                               │
                                                               ▼
                                                        ┌─────────────┐
                                                        │ Claude Code │
                                                        │ / Codex /   │
                                                        │ Gemini إلخ. │
                                                        └─────────────┘

يستخدم HAPI تقنية WireGuard بالإضافة إلى TLS للتشفير من طرف إلى طرف. جميع الاتصالات تمر عبر خوادم ترحيل مشفرة. يمكنك استضافة خوادم الترحيل ذاتيًا للتحكم الكامل في تدفق بياناتك.

الميزات الأساسية

• تبديل سلس: تبديل التحكم بين سطح المكتب والهاتف؛ اضغط على أي مفتاح للعودة إلى التحكم المحلي
• أصلي أولاً: تطبيقات الهاتف مغلقة بتقنية أصلية لتفاعل سلس
• موافقات AFK: استلم طلبات الموافقة على هاتفك أثناء ابتعادك عن حاسوبك
• دعم متعدد النماذج: يدعم Claude Code و Codex و Gemini و OpenCode والمزيد
• طرفية في أي مكان: وصول عبر PWA و Telegram Mini App والمزيد
• تحكم صوتي: يدعم إدخال الأوامر الصوتية، لتبقى يداك حرتين

التثبيت والاستخدام

الخطوة 1: بدء خادم الترحيل

# شغّل على خادمك (أو أطلقه مباشرة مع npx)
npx @twsxtd/hapi hub --relay

الخطوة 2: تثبيت CLI على الحاسوب

# شغّل في مجلد مشروعك
cd ~/my-project
npx @twsxtd/hapi

# أو التثبيت العام
npm install -g @twsxtd/hapi
hapi

الخطوة 3: اقتران الأجهزة

اتبع التعليمات في الطرفية، وافتح تطبيق HAPI على هاتفك، وامسح رمز QR لإكمال الاقتران.

الخطوة 4: طرق الوصول

طريقة الوصول	الوصف
Web PWA	وصول عبر المتصفح، يدعم التثبيت على الشاشة الرئيسية
Telegram Mini App	استخدم مباشرة داخل Telegram
تطبيق الهاتف	تجربة تطبيق أصلي (إذا تم نشره)

الاختلافات عن Happy Coder

الميزة	Happy Coder	HAPI
فلسفة التصميم	سحابة أولاً	محلي أولاً
طريقة التشفير	WebSocket + E2E	WireGuard + TLS
دعم متعدد النماذج	Claude Code، Codex	Claude، Codex، Gemini، OpenCode
طرق الوصول	iOS/Android/ويب	PWA، Telegram، المزيد
تحكم صوتي	لا	نعم
موافقات AFK	لا	نعم
ترحيل ذاتي الاستضافة	يتطلب نشر يدوي	دعم جاهز للاستخدام

روابط الموارد

• مشروع GitHub - الكود المصدري
• توثيق PWA - تثبيت واستخدام PWA
• كيف يعمل - تفاصيل التنفيذ التقني
• المساعد الصوتي - ميزات التحكم الصوتي
• لماذا HAPI - فلسفة التصميم
• الأسئلة الشائعة - الأسئلة المتكررة

المزايا والعيوب

المزايا هي تصميم محلي أولاً، دعم متعدد النماذج، تشفير من طرف إلى طرف، تحكم صوتي، وقدرة ترحيل ذاتية الاستضافة. العيوب هي أن المشروع جديد نسبيًا والمنظومة لا تزال في طور النمو.

---

النهج 4: SSH + Tailscale + Tmux

هذا هو الخيار الأفضل للمطورين المحترفين. تتصل عن بُعد بجهاز التطوير الخاص بك عبر SSH وتحافظ على استمرار الجلسات مع Tmux.

كيف يعمل

┌─────────────┐              ┌─────────────┐              ┌─────────────┐
│   الهاتف    │   ────────►  │  Tailscale  │   ◄────────  │  الحاسوب    │
│(عميل SSH)   │   VPN P2P    │ ترحيل/ثقب   │   VPN P2P    │(مضيف التطوير)│
└─────────────┘              └─────────────┘              └──────┬──────┘
                                                               │
                                                               ▼
                                                        ┌─────────────┐
                                                        │    Tmux     │
                                                        │ (استمرارية  │
                                                        │  الجلسة)    │
                                                        └─────────────┘

ينشئ Tailscale شبكة VPN من نظير إلى نظير حتى تتمكن من الوصول إلى حاسوبك المنزلي من أي شبكة. يضمن Tmux استمرار تشغيل Claude Code في الخلفية حتى عند انقطاع SSH.

لماذا تحتاج Tailscale؟

مشاكل SSH التقليدية:

الهاتف (4G) ──XX──> راوتر NAT ──XX──> الحاسوب المنزلي
             (لا يمكن الاختراق)   (عزل الشبكة المحلية)

حاسوبك على شبكة خاصة، وهاتفك على الشبكة العامة، لذا يفشل الوصول المباشر. الحلول التقليدية تتطلب توجيه المنافذ بالإضافة إلى DNS ديناميكي، وهي معقدة ومحفوفة بالمخاطر.

حل Tailscale:

الهاتف (4G) ──► ترحيل Tailscale ──◄── الحاسوب المنزلي
            (ثقب تلقائي أو ترحيل)

يستخدم Tailscale اختراق NAT، ويلجأ إلى الترحيل تلقائيًا إذا فشل الاختراق. الاتصال بالكامل مشفر.

خطوات الإعداد الكاملة

الخطوة 1: تثبيت Tailscale على الحاسوب

# macOS
brew install --cask tailscale

# أو تحميل المثبت
# https://tailscale.com/download

الخطوة 2: تسجيل الدخول والحصول على IP

# بدء Tailscale
sudo tailscale up

# التحقق من IPv4 الخاص بـ Tailscale
tailscale ip -4
# مثال على المخرجات: 100.x.x.x

الخطوة 3: تثبيت Tailscale على الهاتف

حمّل Tailscale من App Store أو Google Play وسجّل الدخول بنفس الحساب.

الخطوة 4: تثبيت وإعداد Tmux

# macOS
brew install tmux

# إنشاء ~/.tmux.conf
cat > ~/.tmux.conf << 'EOF'
# تفعيل دعم الماوس
set -g mouse on

# الطرفية الافتراضية بـ 256 لون
set -g default-terminal "screen-256color"

# تغيير مفتاح البادئة إلى Ctrl+A (اختياري)
unbind C-b
set -g prefix C-a

# اختصارات تقسيم مبسطة
bind v split-window -h
bind h split-window
EOF

الخطوة 5: إنشاء جلسة مستمرة

# إنشاء جلسة باسم "claude"
tmux new -s claude

# بدء Claude Code في هذه الجلسة
cd ~/my-project
claude

# فصل بدون إغلاق
# اضغط Ctrl+B ثم D

الخطوة 6: الاتصال من عميل SSH على الهاتف

عملاء SSH الموصى بهم:

العميل	المنصة	ملاحظات
Blink Shell	iOS	يدعم MOSH، ممتاز للشبكات غير المستقرة
Termius	iOS/Android	متعدد المنصات وواجهة مصقولة
a-Shell	iOS	مجاني وخفيف

إعدادات الاتصال:

المضيف: 100.x.x.x (عنوان IP الخاص بـ Tailscale)
المنفذ: 22
اسم المستخدم: اسم مستخدم حاسوبك

بعد الاتصال، ارتبط بـ Tmux:

tmux attach -t claude

نصائح متقدمة

منع حاسوبك من النوم:

# macOS
caffeinate -dimsu &

# أو اضبط إعدادات النظام > موفر الطاقة > منع النوم التلقائي

استخدام MOSH للشبكات غير المستقرة:

MOSH (Mobile Shell) هو بديل SSH محسّن للشبكات المحمولة، مع استرداد سلس عبر تغييرات الشبكة.

# التثبيت على الحاسوب
brew install mosh

# استخدام MOSH من عميل الهاتف
# Blink Shell يدعم MOSH أصلاً

برمج اتصال بأمر واحد:

اضبط هذا كأمر بدء التشغيل في عميل SSH الخاص بك:

tmux attach -t claude || tmux new -s claude

سيؤدي هذا إلى الارتباط التلقائي بجلسة موجودة أو إنشاء جلسة جديدة.

المزايا والعيوب

المزايا هي قدرات كاملة وسير عمل مكافئ لسطح المكتب مع جميع أدوات التطوير. العيوب هي إعداد أكثر تعقيدًا ومتطلب إبقاء حاسوبك متصلاً بالإنترنت.

---

النهج 5: بيئة Termux المحلية

إذا كنت مستخدم Android، يمكنك تشغيل Claude Code مباشرة على هاتفك دون الاتصال بأجهزة خارجية.

كيف يعمل

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│                    ┌─────────────┐                          │
│                    │   Termux    │                          │
│                    │ (بيئة Linux)│                          │
│                    │             │                          │
│                    │ • Node.js   │                          │
│                    │ • Claude    │                          │
│                    │   Code CLI  │                          │
│                    │             │                          │
│                    │ • ملفات     │                          │
│                    │   المشروع   │                          │
│                    │ • Git       │                          │
│                    └─────────────┘                          │
│                         │                                   │
│                         ▼                                   │
│                   ┌─────────────┐                           │
│                   │ Anthropic   │                           │
│                   │    API      │                           │
│                   └─────────────┘                           │
└─────────────────────────────────────────────────────────────┘

Termux هو محاكي طرفية وبيئة Linux لأجهزة Android. يمكنك تثبيت Node.js و Claude Code مباشرة فيه.

خطوات التثبيت

مهم: حمّل Termux من F-Droid، وليس من Google Play (نسخة Play قديمة).

الخطوة 1: تثبيت الأدوات الأساسية

# تحديث مدير الحزم
pkg update && pkg upgrade

# تثبيت أدوات التطوير
pkg install git nodejs python vim

الخطوة 2: تثبيت Claude Code

npm install -g @anthropic-ai/claude-code

الخطوة 3: إعداد البيئة

# إنشاء مساحة العمل
mkdir -p ~/projects
cd ~/projects

# تهيئة المشروع
git clone https://github.com/your-repo.git
cd your-repo

# إطلاق Claude Code
claude

الخطوة 4: إعداد لوحة مفاتيح خارجية (موصى به)

في Termux:

# تفعيل صف المفاتيح الإضافية
# اضغط مطولاً على الشاشة > المزيد > صف المفاتيح الإضافية

# إعداد الاختصارات
# أضف في ~/.termux/termux.properties
extra-keys = [['ESC','/','-','HOME','UP','END','PGUP','~'], \
              ['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN','|']]

اعتبارات الأداء

نوع المهمة	أداء Android
تطوير الويب (HTML/CSS/JS)	ممتاز
سكربتات Python	ممتاز
تطبيقات Node.js	جيد
تشغيل مجموعات الاختبار	متوسط
ترجمة مشاريع كبيرة	غير موصى به

المزايا والعيوب

المزايا هي تحكم محلي كامل، عدم الاعتماد على مضيف خارجي، وتشغيل غير متصل. العيوب هي أداء الهاتف المحدود، تجربة إدخال نص ضعيفة، وتوفر Android فقط.

---

النهج 6: واجهة Claude Code UI

Claude Code UI (المعروفة أيضًا باسم CloudCLI) هي مشروع مفتوح المصدر يوفر واجهة ويب لـ Claude Code، مع دعم متصفح الهاتف.

كيف يعمل

┌─────────────┐              ┌─────────────┐              ┌─────────────┐
│متصفح الهاتف │   ────────►  │ خادم ويب    │   ◄────────  │ Claude Code │
│             │  HTTP/HTTPS  │ (localhost) │   استدعاء    │    CLI      │
└─────────────┘              └─────────────┘              └─────────────┘

تشغّل خادم ويب على حاسوبك، ثم تصل إليه من متصفح هاتفك. هذا يتطلب وصول LAN أو نفقًا.

التثبيت والاستخدام

الخطوة 1: التثبيت

# بدء بأمر واحد (موصى به)
npx @siteboon/claude-code-ui

# أو التثبيت العام
npm install -g @siteboon/claude-code-ui
claude-code-ui

الخطوة 2: فتح الواجهة

الخادم يعمل افتراضيًا على http://localhost:3001.

الخطوة 3: الوصول من الهاتف

الطريقة A - وصول LAN (نفس Wi-Fi):

# الربط بجميع الواجهات
claude-code-ui --host 0.0.0.0

# الوصول من الهاتف
http://<computer-lan-ip>:3001

الطريقة B - نفق ngrok:

# تثبيت ngrok
brew install ngrok

# بدء النفق
ngrok http 3001

# افتح عنوان URL الخاص بـ ngrok من الهاتف

الميزات

• تصميم متجاوب مع دعم الهاتف المحمول
• واجهة محادثة مدمجة
• متصفح ملفات
• واجهة عمليات Git
• إدارة الجلسات

المزايا والعيوب

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

---

النهج 7: بيئة التطوير السحابية

إذا لم يكن لديك حاسوب محلي يعمل طوال الوقت، يمكنك استخدام بيئات تطوير سحابية حيث يعمل Claude Code على خوادم سحابية.

كيف يعمل

┌─────────────┐              ┌─────────────┐              ┌─────────────┐
│   الهاتف    │   ────────►  │  صندوق      │   ─────────► │ Claude Code │
│(متصفح/تطبيق)│    HTTPS     │  سحابي      │              │    CLI      │
└─────────────┘              │  (DevBox)   │              └─────────────┘
                             └─────────────┘

حاوية سحابية مزودة بـ Claude Code مثبت مسبقًا، وتصل إليها من المتصفح أو تطبيق الهاتف.

استخدام Sealos DevBox

الخطوة 1: إنشاء البيئة

اذهب إلى Sealos DevBox، اختر قالب Claude Code، وأنشئ بيئة.

الخطوة 2: بدء بيئة التطوير

البيئة جاهزة في حوالي 30-60 ثانية، وتحصل على طرفية ويب.

الخطوة 3: إعداد Claude API

export ANTHROPIC_API_KEY="your-api-key"

الخطوة 4: ربط تطبيق Happy

# تثبيت happy-coder (أو استخدم المثبت مسبقًا)
npm install -g happy-coder

# إنشاء رمز QR للاقتران
happy

بعد المسح على هاتفك، يمكنك استخدامه فورًا.

مقارنة الخيارات السحابية

المنصة	Claude Code	تحسين الهاتف	وقت البدء	التسعير
Sealos DevBox	مثبت مسبقًا	دعم Happy	~60 ثانية	الدفع حسب الاستخدام
GitHub Codespaces	إعداد يدوي	تدفق المتصفح	~2-3 دقائق	حصة مجانية + بالساعة
Gitpod	إعداد يدوي	تدفق المتصفح	~1-2 دقيقة	حصة مجانية + بالساعة
Replit	لا Claude Code أصلي	تطبيق أصلي	فوري	مجاني + اشتراك

المزايا والعيوب

المزايا هي عدم الحاجة لحاسوب محلي، اتساق البيئة، وقابلية التوسع. العيوب هي الاستخدام المدفوع، الاعتماد على الشبكة، واستضافة الكود في السحابة.

---

المقارنة والاختيار

كل نهج نقاط قوة مختلفة ومناسب لسيناريوهات مختلفة.

جدول المقارنة

النهج	الصعوبة	يتطلب نفق	التكلفة	أفضل السيناريوهات
تطبيق iOS الرسمي	سهل	لا	$20/شهر	فحوصات سريعة، مهام بسيطة
Happy Coder	سهل نسبيًا	لا	مجاني	استخدام يومي، راحة
HAPI	متوسط	لا	مجاني	متعدد النماذج، محلي أولاً
SSH + Tailscale	معقد نسبيًا	لا	مجاني	تطوير احترافي، ميزات كاملة
Termux	متوسط	لا	مجاني	تطوير محلي على Android
Claude Code UI	متوسط	نعم	مجاني	تفضيل واجهة الويب
DevBox سحابي	سهل	لا	الدفع حسب الاستخدام	بدون حاسوب محلي

دليل الاختيار

إذا كنت في بر الصين الرئيسي: استخدم Happy Coder؛ مع إعداد ترحيل API المحلي، يعمل بشكل جيد.

إذا كنت تريد أقصى راحة: اختر Happy Coder. تدفق المسح والاستخدام مريح جدًا.

إذا كنت بحاجة لدعم متعدد النماذج: اختر HAPI. يدعم مساعدي برمجة AI متعددين ومثالي لسير عمل تبديل النماذج.

إذا كان لديك حاسوب يعمل طوال الوقت: اختر SSH + Tailscale. هذا يعطي التجربة الأكثر اكتمالاً.

إذا كنت مستخدم iPhone (خارج بر الصين الرئيسي): التطبيق الرسمي هو أسهل طريقة للبدء.

إذا كان لديك Android فقط: Termux يوفر مسار تطوير محلي كامل على الهاتف.

إذا لم يكن لديك حاسوب: DevBox السحابي هو الخيار المثالي.

---

الأمان والخصوصية

يتضمن تطوير الهاتف المحمول نقل الكود عبر الشبكات، لذا يحتاج الأمان لعناية خاصة.

مخاطر خوادم الترحيل

عند استخدام خدمات تعتمد على الترحيل مثل Happy Coder أو HAPI، ضع في اعتبارك هذه المخاطر:

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  ماذا يمكن لخادم الترحيل رؤيته محتملًا؟                   │
│                                                             │
│  • البيانات قبل التشفير (إذا تم تنفيذ E2E بشكل سيء)       │
│  • البيانات الوصفية (متى تتصل، ومدة الجلسات)              │
│  • مفتاح API الخاص بك (إذا تم الإعداد بشكل خاطئ)           │
│                                                             │
│  ماذا يمكن لخادم الترحيل فعله محتملًا؟                    │
│                                                             │
│  • تسجيل محتوى كودك                                       │
│  • سرقة بيانات اعتماد API                                  │
│  • حقن أوامر خبيثة                                        │
│  • إساءة استخدام جهازك كعقدة هجوم                         │
│                                                             │
└─────────────────────────────────────────────────────────────┘

أفضل ممارسات الأمان

1. تصنيف حساسية الكود

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  المشاريع العامة/كود التعلم -> أي نهج مقبول               │
│                                                             │
│  المشاريع الخاصة -> فضّل SSH+Tailscale أو استضافة ذاتية   │
│                                                             │
│  الكود التجاري -> استخدم SSH+Tailscale فقط، عطّل جميع     │
│  مسارات ترحيل الطرف الثالث                                 │
│                                                             │
└─────────────────────────────────────────────────────────────┘

2. إدارة المفاتيح

# لا تضع المفاتيح في الكود المصدري
const apiKey = "sk-ant-xxxxx"

# استخدم متغيرات البيئة
const apiKey = process.env.ANTHROPIC_API_KEY

# استخدم ملفات .env (أضف إلى .gitignore)
ANTHROPIC_API_KEY=sk-ant-xxxxx

3. استخدام وضع الحماية (Sandbox)

يدعم Claude Code وضع الحماية لتحديد نطاق الوصول:

claude --sandbox /path/to/project

4. استضافة الترحيل ذاتيًا

إذا كنت تستخدم Happy Coder، فكر في استضافة الترحيل ذاتيًا:

# استنساخ المشروع (يتضمن تنفيذ الخادم)
git clone https://github.com/slopus/happy.git
cd happy

# نشر الخادم على VPS الخاص بك
# اتبع توثيق المشروع للتفاصيل

5. استخدام Headscale

Headscale هو تطبيق مفتوح المصدر لـ Tailscale ويمكن استضافته ذاتيًا:

# نشر Docker بأمر واحد
docker run -d \
  --name headscale \
  -v /srv/headscale:/etc/headscale \
  -p 3478:3478/udp \
  -p 8080:8080 \
  headscale/headscale:latest

---

الأسئلة المتكررة

هل أحتاج إلى اختراق NAT؟

معظم النهج الحديثة لا تتطلب اختراق NAT يدوي:

النهج	المبدأ
Happy Coder	وضع الترحيل، كلا الطرفين يتصلان بالخادم بنشاط
HAPI	وضع الترحيل، WireGuard + TLS
Tailscale	ثقب NAT أو ترحيل
تطبيق iOS	تنفيذ سحابي
Claude Code UI	يتطلب وصول وارد

لماذا لا يتطلب وضع الترحيل اختراقًا؟

اتصال صادر (NAT يسمح):
الحاسوب ──► خادم الترحيل نعم

اتصال وارد (NAT يمنع):
خارجي ──► الحاسوب لا

حيلة الترحيل:
كلا الطرفين يجريان اتصالات صادرة إلى الترحيل،
لذا لا يحتاج أي طرف إلى اتصال وارد.

هل يؤثر تطوير الهاتف المحمول على عمر البطارية؟

النهج المختلفة تستهلك طاقة مختلفة:

النهج	استهلاك الطاقة	السبب
طرفية SSH	منخفض	عرض نص فقط
تطبيق iOS	متوسط	تنفيذ سحابي، الهاتف يتحكم فقط
Termux	عالي	تشغيل CLI محلي
المتصفح	متوسط	حمل عرض واجهة ويب

للجلسات الطويلة، أبقِ هاتفك مشحونًا.

ماذا يحدث عند انقطاع الشبكة؟

النهج	تأثير انقطاع الشبكة
SSH + Tmux	Claude يستمر في العمل؛ استعد عند إعادة الاتصال
Happy Coder	إعادة اتصال تلقائية
HAPI	إعادة اتصال تلقائية
تطبيق iOS	السحابة تستمر؛ التطبيق يظهر الانقطاع
Termux	انقطاع الجلسة

هل يمكنني ترجمة مشاريع كبيرة على الهاتف؟

غير موصى به. معالج الهاتف والذاكرة محدودان، والبناءات الكبيرة يمكن أن تسبب:

• ارتفاع حرارة كبير
• استنزاف سريع للبطارية
• أوقات ترجمة طويلة جدًا

شغّل مهام البناء الثقيلة على مضيفات عن بُعد أو بيئات سحابية.

---

الخلاصة

الفكرة الأساسية لتطوير Claude Code على الهاتف المحمول هي: الهاتف هو المتحكم، والتطوير الحقيقي يعمل في مكان آخر.

أي نهج يجب أن تختار يعتمد على احتياجاتك المحددة.

إذا كنت في بر الصين الرئيسي، يُوصى بـ Happy Coder، خاصة عند اقترانه بإعداد ترحيل API محلي.

إذا كنت تريد الإعداد الأكثر راحة، استخدم Happy Coder. امسح للاتصال، واحصل على إشعارات فورية، وبدّل الأجهزة بسلاسة.

إذا كنت بحاجة لدعم متعدد النماذج أو بنية محلية أولاً، استخدم HAPI. يدعم مساعدين متعددين وترحيلاً ذاتي الاستضافة.

إذا كنت تريد تجربة التطوير الأكثر اكتمالاً، استخدم SSH + Tailscale. الإعداد أكثر تعقيدًا، لكن القدرات الأقرب لسطح المكتب.

إذا كنت مستخدم iOS خارج بر الصين الرئيسي، التطبيق الرسمي هو أسهل طريقة للبدء.

إذا كنت مستخدم Android، يتيح لك Termux تطويرًا محليًا كاملاً على الهاتف.

إذا لم يكن لديك حاسوب يعمل طوال الوقت، DevBox السحابي هو الخيار المثالي.

أيًا كان الحل الذي تختاره، الأمان مهم: كن حذرًا مع ترحيل طرف ثالث للكود الحساس، أدر مفاتيح API بشكل صحيح، وفضّل المسارات ذاتية الاستضافة أو الخاصة للمشاريع المهمة.

---

المراجع

موارد رسمية

• توثيق Claude Code الرسمي - التوثيق الرسمي الكامل لـ Claude Code
• تطبيق Claude iOS - تطبيق iOS الرسمي

مشاريع مفتوحة المصدر

• slopus/happy (2.5k نجمة) - عميل Happy Coder للهاتف المحمول
• tiann/hapi - HAPI مساعد برمجة AI متعدد النماذج محلي أولاً
• siteboon/claudecodeui - Claude Code UI (CloudCLI)
• juanfont/headscale (19k نجمة) - تطبيق Tailscale مفتوح المصدر

دروس صينية

• برمجة في أي وقت وأي مكان: إعداد Claude Code على الهاتف - دليل إعداد Termux
• مختبر AI في جيبك: سير عمل Claude Code المحمول دائم الاتصال - نهج Tmux + Docker
• أخذت Claude Code للتسوق مع صديقتي - اتصال عن بُعد عبر Tailscale
• بناء تطبيقات إنتاجية من الهاتف - حالة تطوير هاتف محمول حقيقية

موارد إنجليزية

• الدليل الشامل لاستخدام Claude Code على هاتفك | مدونة Sealos - أكثر أدلة الهاتف المحمول شمولاً
• دليل SSH + Tailscale + Termius الكامل - دليل اتصال عن بُعد مفصل

تحميل الأدوات

• Tailscale - أداة VPN من نظير إلى نظير
• Termux (F-Droid) - محاكي طرفية Android
• Blink Shell - عميل SSH لنظام iOS (دعم MOSH)
• Termius - عميل SSH متعدد المنصات