Claude Developer Blogآخر تحديث

كلاود كود في السحابة: دليل عملي لجلسات السحابة

تُشغّل جلسات السحابة كلاود كود على جهاز افتراضي جديد لكل مهمة. أربع جلسات حقيقية، وسبعة سير عمل تناسبها، وكيفية ربط GitHub دون الوقوع في مشكلات.

Timeline of three cloud sessions in three VMs, started within 16 seconds of each other. After a hatched setup bar, the flaky-test fix finishes at 65 seconds with the suite run 40 times and 0 failures, the docs rewrite at 62 seconds with 5 doc errors fixed, and the structured-logging change at 87 seconds with JSON logs and 5 new tests.
مصدر الصورة · Claude Developer Blog

ربما تُشغّل كلاود كود في طرفية على حاسوبك المحمول. تلك الجلسة تعتمد على الحاسوب المحمول بثلاث طرق:

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

جلسة السحابة تُشغّل كلاود كود على جهاز خاص بها. كل مهمة تحصل على جهاز افتراضي جديد مع استنساخ مستودعك على فرع جديد وإتمام إعداد بيئتك مسبقًا.

يمكنك بدء جلسة من claude.ai/codeأو من تطبيق Claude للهواتف المحمولةأو تطبيق سطح المكتبأو من الطرفيةأو من Slack. يمكنك بعدها متابعتها من المتصفح وتطبيق الهاتف المحمول وتطبيق سطح المكتب. عند انتهاء العمل، يكون موجودًا على فرع يمكنك تحويله إلى طلب سحب.

تأتي جلسات السحابة مع خطة Pro أو Max أو Team أو Enterprise الخاصة بك دون تكلفة إضافية: لا توجد رسوم منفصلة على جهاز السحابة، وتستهلك الجلسات من حدود الاستخدام نفسها كبقية كلاود كود. بحسب خطتك، قد يحتاج مالك المؤسسة إلى تشغيل جلسات السحابة أولًا.

رصيد إضافي لجلسات السحابة. يمكن للمشتركين الأفراد الحاليين في Pro وMax المطالبة برصيد إضافي لمرة واحدة لجلسات السحابة، يُضاف إلى حدود خطتهم: 100 دولار على Pro و250 دولار على Max. اطلبه قبل 7 أكتوبر على claude.ai/code/claim-credit أو باستخدام /claim-credit داخل كلاود كود. تنتهي صلاحية الرصيد في 4 نوفمبر. بعد استخدامه أو انتهاء صلاحيته، تنطبق حدود الاستخدام المعتادة لخطتك. وهو غير مؤهل للاستخدام مع Projects أو Routines. راجع شروط عرض الرصيد الترويجي.

لهذا الدليل شغّلت أربع جلسات سحابة حقيقية على مستودع عينات صغير. وتظهر نصوصها واختلافاتها وتوقيتاتها في جميع أنحاء الدليل. المستودع والمستخدم في لقطات الشاشة من نسج الخيال. أما العمل والمخرجات والأرقام فمأخوذة من تلك الجلسات.

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

Timeline of three cloud sessions in three VMs, started within 16 seconds of each other. After a hatched setup bar, the flaky-test fix finishes at 65 seconds with the suite run 40 times and 0 failures, the docs rewrite at 62 seconds with 5 doc errors fixed, and the structured-logging change at 87 seconds with JSON logs and 5 new tests.
FIG Aالخط الزمني الحقيقي لثلاث جلسات سحابة على مستودع واحد، بالثواني منذ بداية الجلسة الأولى. الأشرطة المظللة هي خطوة الإعداد التي أعادت إنشاء مستودع العينات (يحل محلها استنساخ GitHub في الاستخدام العادي)، وكل نقطة تمثل استدعاء أداة واحدًا.

ثلاث مهام، مستودع واحد، ثلاثة أجهزة

المستودع النموذجي هو tidepool، وهي واجهة برمجية صغيرة لـ Node تتنبأ بالمد والجزر لثلاثة مرافئ خيالية. كانت لديه ثلاث مشكلات عادية: اختبار واحد يفشل في نحو واحدة من كل أربع مرات، ووثائق الواجهة البرمجية تصف معاملات لم يعد الكود يقرأها، والمسجل (logger) يبني أسطره عبر دمج السلاسل النصية.

بدأت ثلاث جلسات سحابية في غضون 16 ثانية من بعضها، جلسة لكل مشكلة. بدأتها برمجياً، ولأن tidepool ليس على GitHub، أعادت كل جلسة أولاً إنشاء المستودع من الملفات الموجودة في مطالبتها. مع مستودع حقيقي ستتخطى تلك الخطوة، ومن طرفية (terminal) كل جلسة هي claude --cloud أمر واحد. باختصار، كانت المطالبات الثلاث:

CODEShell
claude --cloud "npm test fails maybe one run in four. Find the flaky test, fix the root cause in the code (not the test), and prove it by running the suite at least 30 times in a row."
claude --cloud "docs/API.md is out of date with src/server.js. Rewrite it so every endpoint, parameter, default and response shape matches the code. Start the server and run each curl example to check it."
claude --cloud "Make src/logger.js emit one JSON object per line, keep LOG_LEVEL, and log method, path, status and duration_ms as fields. Add a test for the logger."

استغرقت الجلسات 61 و65 و72 ثانية، واكتملت الجملة الثلاث قبل 87 ثانية من بدء الأولى. استغرق إعادة إنشاء المستودع نحو ثلث إلى ما يزيد قليلاً عن نصف مدة كل تشغيل. وهذه هي النتائج.

  • الاختبار المتقلب. اكتشف كلود (Claude) حالة تسابق في TtlCache.get. كانت الذاكرة المؤقتة تخزن القيمة فقط بعد انتهاء المحمّل (loader)، لذا فإن طلب ثانٍ get لنفس المفتاح أثناء جارٍ التحميل يستدعي المحمّل مرة أخرى. غيّر كلود الذاكرة المؤقتة لتخزين الوعد الجاري (in-flight promise)، وحذف الإدخال عند فشل التحميل، وشغّل npm test 40 مرة متتالية بدون أي فشل.
  • الوثائق. شغّل كلود الخادم، ونفّذ أمر curl ضد كل نقطة نهاية، ووجد خمس طرق كانت فيها الوثيقة القديمة خاطئة. ذكر حقولاً لا تُرجعها الواجهة البرمجية أبداً، ووثّق معاملاً days يتجاهله الكود، وأعطى الارتفاعات بالأقدام بينما هي بالأمتار، وتجاهل نقطة النهاية /next-high وأغفل استجابات الأخطاء. كما وجد أن قيمة from= مشوهة تُرجع قائمة فارغة مع رمز 200، ووثّق ذلك كملاحظة تحذيرية بدلاً من تعديل كود الخادم الذي لم يُطلب منه لمسه.
  • المسجل. كتب كلود مسجل JSON، ونقل سجل الطلبات إلى حقول مهيكلة، وأضاف خمسة اختبارات. دخل التزام (commit) الخاص به مع اختبار واحد فاشل، لذا أعاد كلود تشغيل اختبار الذاكرة المؤقتة ثماني مرات، ورآه يفشل في خمس منها، وتتبع سبب الفشل إلى نفس حالة التسابق التي كانت الجلسة الأولى تصلحها. اقترح الإصلاح نفسه، وترك الذاكرة المؤقتة دون تغيير لأن ذلك كان خارج نطاق مهمته، وقال في ملخصه أن مجموعة الاختبارات لم تكن نظيفة.
claude.ai/code showing the Structured logging session: an expanded diff of src/server.js replacing a string-built request log with logger.info('request', { method, path, status, duration_ms }), and a branch bar for claude/structured-logging with a Create PR button.
الشكل Bالجلسات الثلاث في واجهة claude.ai/code، وهي تعمل محليًا وتعيد تشغيل نصوصها الحقيقية. خطوات الإعداد مقتطعة، والمسارات تظهر تحت /home/user، وعناوين الشريط الجانبي الثلاثة السفلية هي حشو، وشريحة الوضع تُظهر الوضع الافتراضي.
The Fix the flaky test session: the command that patched cache.js and ran the test suite 40 times, its output runs=40 fails=0, and Claude's explanation of the race in TtlCache.get.
الشكل Cجلسة Fix the flaky test
The Update the tidepool API docs session: Claude's summary of the five ways the old docs/API.md was wrong.
الشكل Dجلسة Update the tidepool API docs
الشكل Eتسجيل مدته 20 ثانية للنسخة المحلية نفسها: التنقل بالنقر بين الجلسات الثلاث، ثم تمرير نص جلسة logger

توضح نتيجة logger لماذا تناسب الجلسات السحابية العمل المتوازي. كان لكل جلسة نسختها الخاصة من المستودع، وعملياتها الخاصة، وفرعها الخاص. بدأت جلسة المستندات وجلسة logger كلٌّ منهما خادم الـ API للاختبار ضده، ولم تؤثر إحداهما على الأخرى. على حاسوب محمول واحد، يعمل وكيلان في نسخة عمل واحدة فيعدّلان الملفات نفسها، ويصطدمان في منفذ ما لم يختار كل منهما منفذًا خاصًا به.

بسبب هذا العزل، لم يكن لجلسة logger أي اطلاع على إصلاح ذاكرة التخزين المؤقت الذي كانت الجلسة الأولى تعمل عليه. قسّم المهام المتوازية على حدود الملفات، وادمج الفروع بترتيب منطقي، وتوقع من الجلسة أن تبلّغ عن مشكلات تعمل جلسة أخرى على إصلاحها بالفعل.

داخل جلسة CLOUD الخاصة بـ CLAUDE CODE

الجلسة السحابية هي جلسة Claude Code تعمل على بنية تحتية تديرها Anthropic، أو على أجهزة مؤسستك الخاصة مع بيئة مستضافة ذاتيًا. يوضح الشكل الأجزاء. والاستنتاجات الأربعة بعده هي تلك التي تغيّر طريقة عملك.

You start a session from a browser, phone, Desktop, terminal, Slack or a routine. It runs in a fresh VM with a clone of your repository on a claude branch, Claude Code in auto mode, and your environment's setup. GitHub traffic passes through a proxy that holds your token outside the VM; other traffic passes through a security proxy that applies the network allowlist. The result is a branch and a pull request.
الشكل Fتشريح الجلسة السحابية. كل ما يمكن للوكيل لمسه يقع داخل الـ VM. رمز GitHub الخاص بك وسياسة الشبكة يقعان خارجها.
  • كل مهمة تحصل على جهاز خاص بها. VM جديد مع مستودعك المستنسخ على فرع جديد، حتى لا تتمكن الجلسات من لمس ملفات بعضها أو منافذ بعضها. انظر ما هو مثبّت.
  • رمز GitHub الخاص بك لا يدخل الـ VM أبدًا. يحتفظ به وسيط (proxy)، وتحصل الجلسة على بيانات اعتماد قصيرة الأمد يمكنها الدفع فقط إلى فرع العمل الخاص بها. انظر وسيط GitHub.
  • إعداد Claude الخاص بالمستودع يأتي معه. أمّا إعدادك الشخصي فلا. CLAUDE.mdفالـ rules والمهارات والوكلاء والأوامر تنتقل مع المستودع، بينما يبقى ~/.claude على حاسوبك المحمول. انظر الإعدادات في الجلسات السحابية.
  • تُستعاد أجهزة VM الخاملة. أعد فتح الجلسة وستحصل على VM جديد مع استعادة المحادثة، لذا أنجز التزامات (commits) لما يهمك. انظر انتهاء صلاحية البيئة.

للمواصفات، و أوضاع الأذونات، ومستويات الشبكة، انظر وثائق بيئات السحابة.

محلي أم سحابي؟

الجلسات السحابية لا تحل محل الجلسات المحلية، ومعظم الناس يستخدمون الاثنين معًا. يوضح الجدول أوجه الاختلاف بينهما، وتشرح الفقرات التي تليه متى يناسب كلٌّ منهما.

جلسة محليةجلسة سحابية
يعمل علىجهازكجهاز افتراضي (VM) جديد لكل مهمة
الحاسوب المحمول في وضع السكون أو غير متصلتتوقف الجلسةتستمر الجلسة
عدة مهام على مستودع واحدأشجار عمل ومنافذ منفصلة مع الحذرجهاز افتراضي واحد وفرع واحد لكل مهمة
ما يمكن للوكيل الوصول إليهأي شيء يمكن لحساب المستخدم لديك الوصول إليه، بما في ذلك مفاتيح SSH وأدوات السحابة سطر الأوامر و ~/.claudeالمستودع، ومستوى الشبكة الذي تحدده، والموصلات التي تفعّلها، وبيانات اعتماد GitHub خاصة بالجلسة
البدء أو المتابعة منذلك الجهاز، أو هاتفك عبر التحكم عن بُعدالمتصفح، الهاتف، سطح المكتب، الطرفية، Slack، استدعاء API أو جدول زمني
الموافقاتأي وضع، بما في ذلك لكل أمرتلقائي، قبول التعديلات أو خطة
ينتهي بـالتغييرات في شجرة العمل لديكفرع، وطلب سحب عندما تريد ذلك
الحوسبةجهازكلا توجد رسوم حوسبة منفصلة؛ يستخدم حدود خطتك

ابقَ محليًا عندما تتطلب المهمة شيئًا لا يملكه إلا جهازك. يشمل ذلك قاعدة بيانات تحتوي على بيانات محلية حقيقية، أو خدمة تصل إليها عبر VPN، أو وحدة معالجة رسومية، أو محاكي هاتف، أو عتاد على مكتبك. ابقَ محليًا أيضًا في حلقات العمل البصرية السريعة حيث تريد رؤية كل تغيير في متصفحك خلال ثوانٍ، وعندما تعمل مؤسستك بـ Zero Data Retention، الذي يوقف جلسات السحابة.

تقع ميزتان بين الخيارين. التحكم عن بُعد يُبقي الجلسة على جهازك ويتيح لك توجيهها من هاتفك أو متصفحك. البيئات ذاتية الاستضافة، في نسخة تجريبية لفئتي Team وEnterprise، تشغّل جلسات السحابة على بنيتك التحتية الخاصة بمؤسستك، بحيث تتمكن من الوصول إلى الشبكات الخاصة.

إذا لم ينطبق أي مما سبق، فالمهمة مرشحة جيدة للسحابة. يغطي القسم التالي سير العمل التي تحقق فيه ذلك أكبر فائدة.

سبعة سير عمل تناسب جلسات السحابة

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

1. تصفية تراكم من المهام بالتوازي

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

CODEShell
claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

claude --cloud يستنسخ مستودع GitHub البعيد عند فرعك الحالي، لذا ادفع التزاماتك المحلية أولًا. أثناء بدء تشغيل الآلة الافتراضية، تعرض واجهة CLI قائمة تحقق حية بخطوات الإعداد وتضع أي شيء تكتبه في قائمة الانتظار.

اكتب كل مهمة كتذكرة مكتفية ذاتيًا توضح ما هو الخطأ، وكيف يبدو الإنجاز، وكيفية إثباته. حدد توجيه الاختبار المتقلب إثباته: تشغيل مجموعة الاختبارات 30 مرة على الأقل متتالية. شغّلت الجلسة المجموعة 40 مرة.

عندما تنتمي المهام إلى جهد أكبر، يشغّل المشروع (نسخة تجريبية عامة لفئتي Pro وMax) محادثة منسقة تبدأ جلسات السحابة ويتابعها نيابة عنك. ثم يجمعها حسب الحالة: قيد العمل، بانتظارك، وجاهزة للمراجعة.

2. دعه يثبت الإصلاح

الاختبار المتقلب هو أوضح حالة للعمل الذي يتطلب إثباتًا متكررًا: عليك تشغيل مجموعة الاختبارات مرة تلو الأخرى، ولا تريد أن يستهلك ذلك الاتجار الجهاز الذي تعمل عليه. في السحابة، صحّح Claude ذاكرة التخزين المؤقت وشغّل المجموعة كاملة 40 مرة في أمر واحد.

The flaky-test session's Bash step: a patch to src/cache.js that caches the in-flight promise, then a loop running the test suite 40 times, with output runs=40 fails=0.
FIG Gأربعون تشغيلًا، صفر إخفاقات: الأمر والناتج الحقيقيان لجلسة الاختبارات المتقلّبة، معاد عرضهما في واجهة claude.ai/code التي تعمل محليًا. قام Claude بترقيع src/cache.js وأجرى حزمة الاختبارات الكاملة 40 مرة في خطوة واحدة. تظهر المسارات تحت /home/user.

الجهاز الافتراضي لا يستهلك طاقة حسابية ومعالجه ليس لك، لذا اطلب دليلًا قويًا. شغّل حزمة الاختبارات 200 مرة، أو قسّم انحدارًا عبر 50 إيداعًا (commit)، أو شغّل طبقة التكامل البطيئة، أو شغّل التطبيق واختبره بـ curl كما فعلت جلسة الوثائق.

كل دورة من دورات Claude لا تزال تُحتسب ضمن خطتك، لكن تشغيل اختبار طويل داخل أمر واحد يكلّف القليل. الأوامر الأمامية تنتهي مهلتها بعد دقيقتين (2) افتراضيًا (10 كحد أقصى) ثم تواصل العمل في الخلفية لمدة تصل إلى 30 دقيقة إضافية. يمكنك رفع القيم الافتراضية عبر BASH_DEFAULT_TIMEOUT_MS و BASH_MAX_TIMEOUT_MS في متغيرات البيئة.

3. خطّط عند مكتبك، ابنِ في السحابة، وأنهِ في طرفيتك

بالنسبة لتغيير أكبر، اتفق على النهج أولًا حيث يكون التبادل السريع رخيصًا. ابدأ Claude في وضع الخطة (plan mode)، وضعوا الخطة معًا، ثم إيداعها (commit) وادفعها (push).

CODEShell
claude --permission-mode plan
# ...agree on the plan, save it to docs/migration-plan.md, commit and push...
claude --cloud "Execute the migration plan in docs/migration-plan.md"

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

CODEShell
claude --teleport            # pick a cloud session
claude --teleport <session-id>

يتحقق Teleport من أنك في المستودع نفسه، ويجلب فرع الجلسة، ويسحّبه (checkout)، ويحمّل المحادثة كاملة في طرفيتك. تحتاج إلى شجرة عمل نظيفة (يعرض عليك stash)، ويجب أن يكون الفرع مدفوعًا (pushed). من داخل Claude Code، /teleport (أو /tp) يفتح المحدد نفسه، و /tasks ثم t يعمل أيضًا. يتجه تطبيق Desktop بالاتجاه المعاكس، وقائمته Open in ترسل جلسة محلية إلى السحابة.

4. المتابعة من هاتفك

تتصل علامة التبويب Code في تطبيق Claude بالجلسات نفسها. من هاتفك يمكنك بدء مهمة، ومتابعتها، وتوجيهها، والإجابة على سؤال طرحه Claude، أو إخبار Claude بمراقبة طلب سحب (pull request).

الهاتف مناسب للأسئلة التي قد تنساها بحلول وصولك إلى لوحة مفاتيح. في الجلسة الرابعة طرحت نوعًا من الأسئلة الذي تكتبه عادة على هاتف: كيف يتوقع tidepool المد والجزر، وكيف يمكن أن يخطئ عند أطراف نافذة زمنية؟ نفّذ Claude شيفرة للتحقق من إجابته ووجد خطأً برمجيًا حقيقيًا. الحلقة لا تفحص العينة الأولى أو الأخيرة أبدًا، لذا تفوّت واجهة برمجية التطبيق (API) مدًّا عاليًا يقع تمامًا في بداية النافذة.

Phone-width claude.ai/code showing the start of Claude's answer: predictTides has two edge problems, confirmed by running it, with a How it works section.
FIG Hسؤال طُرح من هاتف: claude.ai/code بعرض الهاتف في متصفح (وليس التطبيق الأصلي)، يعمل محليًا ويعيد تشغيل الإجابة الحقيقية للجلسة الرابعة
The end of the answer: a table of how often reported highs and lows had an equal-height neighbour per station, and the proposed fix.
FIG Iتحقق Claude من كل ادعاء بتشغيل شيفرة على بيانات العينة ولم يغيّر أي ملفات

5. تسليم إخفاقات CI وتعليقات المراجعة إلى Claude

مع تثبيت تطبيق Claude GitHub App على مستودع، يمكن لجلسة سحابية مراقبة طلب سحب (pull request) والتصرف بناءً على ما يحدث له. من شريط CI في جلسة على claude.ai/code، فعّل Auto-fix. يمكنك أيضًا تشغيل /autofix-pr على فرع طلب السحب في طرفيتك، أو أن تطلب من التطبيق المحمول مراقبة طلب السحب، أو لصق رابط URL لطلب السحب في جلسة.

يدفع Claude إصلاحات واضحة للفحوصات الفاشلة وتعليقات المراجعة، ويشرح ما غيّره. ويسألك عن أي أمر غامض أو معماري. تُنشر الردود على خيوط المراجعة باسم مستخدمك على GitHub، مع وسمها بأنها Claude Code. لا يتلقى Claude إشعارًا بتعارضات الدمج مع الفرع الأساسي، لذا اطلب منه إعادة التأسيس (rebase). كما يمكن لتعليقاته تشغيل أتمتة قائمة على التعليقات مثل Atlantis.

6. ابدأ العمل دون أن تبدأه بنفسك

الـ routine (معاينة بحثية) هي عدة موارد محفوظة مصممة لإنجاز مهمة، مثل prompt ومستودعات وموصلات وبيئة. كل تشغيل هو جلسة سحابية، يبدأها مُحفِّز (trigger). يمكن أن تكون المُحفِّزات جدولًا زمنيًا (كل ساعة في أقصى التقارير)، أو استدعاء HTTP إلى نقطة النهاية الخاصة بالروتين نفسه، أو حدث GitHub مثل فتح طلب سحب أو إصدار release. أنشئ روتينًا على claude.ai/code/routines، أو في تطبيق سطح المكتب، أو باستخدام /schedule في واجهة سطر الأوامر CLI. تعمل الروتينات دون مطالبات بالمصادقة، وبشكل افتراضي تدفع التغييرات إلى فروع مسبوقة بـ claude/.

تساعدك هنا أداتان أصغر. يمكنك وضع متابعة في الطابور لجلسة قيد التشغيل من أي جهاز مسجَّل دخولك عليه، بما في ذلك مهمة CI.

CODEShell
claude -p "The integration tier is green now; rebase on main and push" --cloud <session-id>

يمكنك أيضًا وضع إشارة مرجعية على جلسة معبأة مسبقًا. رابط URL مثل claude.ai/code?prompt=Triage+the+newest+issues&repositories=acme-labs/tidepool يفتح claude.ai/code مع تعبئة الـ prompt والمستودع مسبقًا.

7. تشغيل شيفرة لا تثق بها تمامًا

طلب سحب من مساهم، أو سكربت تثبيت لاعتمادية جديدة، أو مستودع استنسخته منذ خمس دقائق، كلها يمكن أن تشغّل شيفرة لم تقرأها. على حاسوبك المحمول، تعمل تلك الشيفرة بجانب مفاتيح SSH الخاصة بك، وجلسات CLI السحابية، وملف تعريف متصفحك. في جلسة سحابية، تعمل داخل آلة افتراضية (VM) تُستخدم مرة واحدة ولا تحتوي على أي مما سبق، مع بيانات اعتماد GitHub محدودة بنطاق الجلسة، وشبكة يمكنك تضييقها.

اضبط وصول الشبكة للبيئة إلى None للحصول على أشد التشغيلات تقييدًا، أو أبقِه على Trusted، وهو يسمح بسجلات الحزم وGitHub والمضيفين الرئيسيين لحزم تطوير البرمجيات السحابية (SDK). حتى عند None، لا يزال Claude Code يرسل طلبات إلى واجهة Anthropic API، لذا يمكن أن تخرج البيانات من الـ VM بهذه الطريقة، ويمكن للجلسة أن تدفع التغييرات إلى فرعها الخاص. تمر كل الحركة الصادرة عبر بروكسي يسجل أسماء المضيفين.

ربط GitHub دون الوقوع في مشكلات

إذا سارت جلستك السحابية الأولى على نحو خاطئ، فإن GitHub هو السبب الأكثر احتمالًا. تأتي معظم المشكلات من حاجة الجلسات السحابية إلى إذنين منفصلين على GitHub.

  • تسجيل الدخول باستخدام GitHub يُخبر Claude من أنت.
  • تثبيت تطبيق Claude GitHub App على حساب أو مؤسسة يحدد المستودعات الخاصة التي يستطيع Claude رؤيتها هناك.

المستودعات العامة تعمل بالأولى وحدها. أما المستودعات الخاصة فتحتاج إلى الثانية، على الحساب أو المؤسسة التي تملكها. إذا قمت بربط GitHub وكان مستودع خاص مفقودًا، فغالبًا ما يكون التطبيق App غير مثبّت على الحساب أو المؤسسة التي تملكه.

ما قمت بربطهالمستودعات العامةمستودعاتك الخاصةالمستودعات الخاصة لمؤسسةالإصلاح التلقائي، مشغّلات GitHub، المشاريع
تسجيل الدخول باستخدام GitHub فقطنعملالالا
+ التطبيق App على حسابك الشخصينعمنعملامستودعاتك
+ تطبيق App على المؤسسة (يوافق المالك)نعمفقط إذا كان موجودًا أيضًا على حسابكنعممستودعات المؤسسة
/web-setup (الخاص بك gh token)نعمنعمأي شيء يستطيع الـ token الخاص بك الوصول إليهلا، يحتاج إلى الـ App

المسار A: الاتصال من المتصفح (موصى به)

اربط حساب GitHub الخاص بك على claude.ai/connect-github، ثم ثبّت Claude GitHub App على الحساب أو المؤسسة التي تملك مستودعك. بالنسبة لمؤسسة، عادةً ما يتعين على المالك الموافقة على التثبيت. يشرح quickstart كل خطوة خطوة بخطوة.

The Code with Claude anywhere screen with a Connect to GitHub button.
الشكل Jالخطوة 1، تسجيل الدخول باستخدام GitHub. شاشات الإعداد claude.ai/code، تعمل محليًا ببيانات تجريبية؛ وأسماء المستودعات في الرسوم التوضيحية وشريحة Research preview جزء من رسومات المنتج نفسه.
The Connect your repositories screen asking you to install the Claude GitHub App on your repositories, with Skip and Connect repositories buttons.
الشكل Kالخطوة 2، تثبيت Claude GitHub App

إذا لم يُعِدك GitHub إلى claude.ai/code، فإن صفحة الاتصال على claude.ai/connect-github يمكن أن تعرض قائمة تحقق قصيرة للأسباب المعتادة. أحدها هو خطوة تسجيل الدخول الموحد، التي تُخفي مستودعات المؤسسة إذا تخطيتها.

The Didn't finish connecting screen with five tips: sign in to the right GitHub account, authorize each organization on the single sign-on step, start again if you saw GitHub connection not completed, connect your own account first and let an owner approve organization access later, or run /web-setup from the terminal.
الشكل Lإذا لم يُعِدك GitHub إلى الصفحة: قائمة التحقق الخاصة بالمنتج نفسه لاتصال GitHub المتقطع، من تدفق الإعداد السريع في واجهة claude.ai/code التي تعمل محليًا

الإصلاح التلقائي، والإجراءات التي يشغّلها GitHub والمشاريع تعتمد أيضًا على الـ App، لذا ثبّته حتى لو اتصلت بطريقة أخرى.

المسار B: الاتصال من الطرفية (terminal) الخاص بك باستخدام /web-setup

إذا كنت تستخدم بالفعل واجهة gh ففّعل سطر الأوامر وشغّل /web-setup داخل Claude Code لإرسال رمز gh الخاص بك إلى حسابك في Claude. يمكن بعد ذلك للجلسات الوصول إلى أي مستودع يمكن لذلك الرمز الوصول إليه، مع التطبيق أو بدونه. انظر الاتصال من طرفيتك الطرفية للاطلاع على الشرح الكامل. في خطتي Team وEnterprise، يجب على المالك تفعيل الإعداد السريع أولاً.

المسار ج: تجاوز GitHub لمهمة لمرة واحدة

شغّل claude --cloud في مستودع لا يحتوي على جهاز تحكم بعيد في GitHub، أو على مستودع غير مثبَّت عليه التطبيق، وسيقوم Claude Code عندئذٍ برفع حزمة من مستودعك بدلاً من استنساخه. لا يمكن للجلسة الدفع بالتغييرات إلا إذا كان اتصال GitHub الخاص بك يتمتع بصلاحية الدفع إلى ذلك المستودع. تذكر الوثائق ما تتضمنه الحزمة وما تتركه خارجها.

إذا كنت تشغّل Team أو Enterprise

لدى المالك قائمة مهام قصيرة: تفعيل موصّل GitHub على claude.ai/admin-settings/connectors، والسماح بجلسات السحابة في إعدادات إدارة Claude Code، وتثبيت تطبيق Claude GitHub على مستودعات المؤسسة (أو الموافقة على طلبات الأعضاء)، واتخاذ القرار بشأن تفعيل الإعداد السريعمن عدمه. المؤسسات التي تستخدم قوائم السماح بعناوين IP أو GitHub Enterprise Server لديها خطوة إضافية. انظر الوثائق المتعلقة بـ قوائم السماح بعناوين IP وـ GitHub Enterprise Server.

عندما لا يعمل الأمر بعد

ما تراهالسببالحل
مستودع خاص مفقود من قائمة الاختيارالتطبيق غير مثبّت على الحساب أو المؤسسة التي تملكه، أو أن صلاحيات وصوله إلى المستودعات لا تشملهثبّت التطبيق هناك، أو أضف المستودع إلى صلاحيات الوصول إلى المستودعات الخاصة بالتطبيق في إعدادات GitHub لديك
ظهور رسالة خطأ تفيد بأنه يجب أن تكون مالكًا للمؤسسة لربطهاالمؤسسة حظرت فحصًا للعضوية، وعادةً ما يكون ذلك بسبب طلب صلاحيات معلّق من التطبيق، أو قائمة سماح بعناوين IP، أو تسجيل الدخول الأحادي عبر SAMLيقبل أحد المالكين طلب الصلاحيات المعلّق في إعدادات GitHub App الخاص بالمؤسسة، أو يفعّل وراثة قائمة السماح بعناوين IP للتطبيقات المثبّتة، أو (في حالة SAML) يمنح Claude صلاحية الوصول إلى المؤسسة
مستودعات إحدى المؤسسات غير ظاهرة مباشرة بعد الاتصالالمؤسسة تستخدم تسجيل الدخول الأحادي عبر SAML، وتم تخطي خطوة التخويل الخاصة بهافي خطوة "Single sign-on to your organizations" على GitHub، انقر فوق Authorize بجوار كل مؤسسة قبل المتابعة. إذا كنت قد تخطّيتها بالفعل، فخوّل Claude لتلك المؤسسة من إعدادات GitHub لديك، ثم أعد الاتصال
تفشل جميع جلسات السحابة بخطأ في المصادقةمؤسسة Claude لديك تستخدم قوائم السماح بعناوين IPاطلب من الدعم استثناء الخدمات المستضافة من Anthropic

لأي أمر آخر، راجع استكشاف الأخطاء وإصلاحها في الوثائق، بما في ذلك عدم ظهور أي مستودعات بعد ربط GitHub. لقطع الاتصال بـ GitHub تمامًا، استخدم claude.ai/customize/connectors.

امنح الجلسات ما يلزمها لمراجعة أعمالها بنفسها

الجلسة القادرة على تشغيل اختباراتك تراجع عملها بنفسها قبل إعادتك إليه. من دون ذلك، تراجع تغييرات لم يشغّلها أحد. معظم القيمة في عروض هذا الدليل جاءت من تشغيل Claude للأشياء: حزمة الاختبارات 40 مرة، والخادم وأوامر curl الخاصة به، وحساب المد والجزر عند حافة النافذة. عشر دقائق من إعداد البيئة تمنح Claude وسيلة لتشغيل تلك الفحوصات.

The Add cloud environment dialog with the name tidepool, Trusted network access, LOG_LEVEL=debug, and a setup script that installs shellcheck with apt-get.
الشكل Mإضافة بيئة سحابية في واجهة claude.ai/code، وتشغيلها محليًا بقيم نموذجية: اسم، ومستوى وصول للشبكة، ومتغيرات بصيغة .env، وسكربت إعداد
  • ابدأ ببيئة Default. تستخدم Trusted network access، دون متغيرات ودون سكربت إعداد، وهذا كافٍ لمعظم مستودعات JavaScript وPython وGo وRust.
  • استخدم سكربت إعداد للجهاز. يعمل بصلاحيات root قبل بدء Claude Code، لذا فإن apt install يعمل. يجب أن ينتهي بالرمز 0 وإلا لن تبدأ الجلسة، ويُفضل أن ينتهي خلال حوالي خمس دقائق حتى تُخزَّن البيئة مؤقتًا. بعد ذلك، تبدأ الجلسات الجديدة من لقطة تتضمن أدواتك على القرص. يُعاد بناء ذاكرة التخزين المؤقت عند تغيير السكربت أو المضيفين المسموح بهم، وحوالي كل سبعة أيام.
  • استخدم خطاف SessionStart للمشروع. ضع npm install وخطوات مشابهة في خطاف (hook) داخل .claude/settings.jsonالمخصص للمستودع، حتى تعمل بنفس الطريقة محليًا وفي السحابة. تحقّق من CLAUDE_CODE_REMOTE إذا كانت الخطوة يجب أن تعمل في السحابة فقط. تُحمَّل خطافات المستودع في الجلسات الأحادية المستودع.
  • ابدأ الخدمات لكل جلسة. يخزّن الكاش الملفات. العمليات التي كانت تعمل لا تبقى بعد ذلك. اطلب من Claude تشغيل service postgresql start، أو افعل ذلك في خطاف SessionStart.
  • اختر أضيق مستوى شبكة يفي بالغرض. خيار Trusted يغطي السجلات الشائعة. استخدم Custom لإضافة سجل خاص، وFull فقط عندما تتطلب المهمة الإنترنت المفتوح. تصل التغييرات إلى الجلسات الجارية خلال نحو دقيقة.
  • احتفظ بالأسرار بعيدًا عن المتغيرات المشتركة. متغيرات البيئة مرئية لأي شخص يستخدم البيئة. على Pro وMax، تُرفق بيانات اعتماد API الخاصة بالبيئة مفتاحًا للطلبات الموجّهة إلى المضيفين الذين تحددهم، خارج الجهاز الافتراضي، لذلك لا يوضع المفتاح أبدًا في متغير.
  • ضع الأوامر في CLAUDE.md. ملفك الشخصي ~/.claude لا يصل إلى الجهاز الافتراضي السحابي. إذا احتاج Claude إلى معرفة كيفية تشغيل اختبارات التكامل، فيجب أن يذكر المستودع ذلك.

عادات مجدية

  • مهمة واحدة، جلسة واحدة. الجلسات الصغيرة المنفصلة أسهل في المراجعة وأقل تكلفة عند التخلص منها.
  • اطلب الأدلة. حدّد اسم الأمر الذي يثبت إنجاز المهمة، واقرأ ملخص Claude قبل الـ diff.
  • ادفع التغييرات قبل claude --cloud. يستنسخ الجهاز الافتراضي من GitHub، لذا فإن الالتزامات غير المُدفوعة لا تصل إليه.
  • التزم التغييرات تدريجيًا في المهام الطويلة. يمكن استرداد الأجهزة الافتراضية الخاملة.
  • راجع في عرض الـ diff. تُجمع التعليقات المضمّنة في رسالتك التالية، ويمكن لـ Create PR أن تفتح طلب دمجًا كاملًا أو مسودة أو صفحة الإنشاء في GitHub.
  • وجّه Claude أثناء عمله. تدخل الرسائل التي ترسلها أثناء عمل Claude في قائمة انتظار، ويمكنك سحب إحداها من القائمة.
  • شارك الجلسة. على Team وEnterprise، اضبط رؤية الجلسة على Team ليتمكن المراجع من قراءة كيفية إجراء التغيير. تحمل الالتزامات الصادرة من الجلسات السحابية سطر Claude-Session الذي يرتبط بنسخة المحادثة.
  • راقب حدودك. تستهلك الجلسات المتوازية حدود خطتك بالتوازي، لذا تستهلك خمس جلسات تلك الحدود بنحو خمسة أضعاف سرعة جلسة واحدة. وللإجراءات الروتينية حدود ساعية خاصة بها، ويمكن لـ المشاريع أن تبدأ حتى 200 سلسلة محادثات جديدة يوميًا.

أسئلة شائعة

من يمكنه استخدام جلسات السحابة؟ خطط Pro وMax وTeam، ومستخدمو Enterprise المقعد المميز أو مقعد Chat + Claude Code، مع تسجيل الدخول عبر حساب claude.ai. وهي غير متاحة باستخدام مفتاح Console API أو مزوّد تابع لجهة خارجية. راجع وثائق جلسات السحابة.

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

هل ستدرب Claude على بيانات جلسات السحابة الخاصة بي؟ تتبع جلسات السحابة السياسة نفسها المتبعة في بقية Claude Code. على خطط Team وEnterprise وواجهة API، لا يقوم Anthropic بتدريب النماذج على شيفرتك أو مطالباتك ما لم تختار مؤسستك الاشتراك في ذلك. على خطط Free وPro وMax، الأمر يعتمد على إعداد تحسين النموذجالخاص بك. راجع استخدام البيانات.

هل سيتعامل مع مستودعي الكبير؟ تتضمن الجهاز الافتراضية حوالي 4 من وحدات vCPU، و16 غيغابايت من ذاكرة RAM، و30 غيغابايت من مساحة القرص. ضع عمليات التثبيت الثقيلة في سكربت الإعداد بحيث تُنفَّذ مرة واحدة وتُحفظ في اللقطة المخزَّنة مؤقتاً.

ماذا عن GitLab أو Bitbucket؟ claude --cloud يمكنه رفع حزمة من أي مستودع git، لكن الجلسة لا تستطيع الدفع مرة أخرى إلى تلك المنصات. GitHub Enterprise Server مدعوم على خطتي Team وEnterprise. راجع قيود المنصات.

ماذا يحدث عندما تتعارض الفروع المتوازية؟ الجلسات لا تعلم بعضها بعضاً. ادمج فرعاً واحداً، ثم أرسل متابعة إلى الجلسة التالية مثل claude -p "rebase on main and fix any conflicts" --cloud <session-id>.

هل سأفقد أدواتي المحلية؟ لا تنتقل الإعدادات على مستوى المستخدم، لذا انقل ما يحتاجه الفريق إلى المستودع: قم بحفظ المهارات والأوامر تحت .claude/، وأضف خوادم MCP الخاصة بالمشروع إلى .mcp.json، ووثّق أوامر الاختبار في CLAUDE.md. الإعدادات في جلسات السحابة توضح ما تقرأه كل جلسة.

ابدأ بعد خمس دقائق

يستغرق الإعداد حوالي خمس دقائق. بعد ذلك، يمكنك تسليم مهمة، وإغلاق حاسوبك المحمول، والعودة لاحقاً لتجد فرعاً (branch) جاهزاً للمراجعة.

  1. افتح claude.ai/code، أو شغّل /login في Claude Code باستخدام حسابك على claude.ai.
  2. اربط GitHub وثبّت تطبيق Claude GitHub App في المكان الذي يقع فيه مستودعك.
  3. اختر المستودع وبيئة Default environment.
  4. أعطِ كلود مهمة واحدة من قائمة أعمالك، مع أمر يثبت أن المهمة قد اكتملت.
  5. أغلق علامة التبويب. تحقق من الأمور من هاتفك لاحقاً، ثم راجع الفرق (diff) وأنشئ طلب السحب (pull request) على claude.ai/code.
المصدر الأصلي

Claude Developer Blog

ملاحظات المحتوى

النشر الأصلي والحقوق تعود إلى المصدر.

ترجمة آلية · يُرجى الرجوع إلى الأصل