Claude Code مع GitHub Actions: مراجعة الكود وإصلاح الأخطاء

الفارق العملي هنا هو مَن يحتاج إلى البقاء متاحًا أثناء التنفيذ. في السابق، كان على المطور فتح المستودع وتشغيل Claude، ثم نقل النتيجة إلى GitHub وإبقاء الجلسة المحلية قيد التشغيل. مع Action، يترك المسؤول عن المستودع طلبًا محدد النطاق، ثم يعود ليجد تعليقًا أو تغييرًا مقترحًا. يمكن أن يبدأ العمل خارج ساعات دوام ذلك المطور، لكن الوقت اللازم للتحقق من النتيجة يظل مطلوبًا.

يستند هذا الدليل إلى وثائق Anthropic الحالية، التي جرى التحقق منها في 15 أكتوبر 2026. وإعداد سير العمل أدناه مقيد عمدًا ليكون نقطة انطلاق؛ ولا يعني أن كل مشكلة يمكن حلها دون إشراف.

كيف يعمل Claude Code داخل المستودع؟

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

يمكن لـ Action الاستجابة للإشارات إليه في المشكلات وطلبات السحب. أما تمرير prompt فيحوّله إلى مهمة آلية. بالنسبة إلى فريق صغير، تعد الطلبات الصريحة أسهل طريقة لاكتشاف المهام المفيدة قبل دفع تكلفة مراجعة كل تغيير. دليل استخدام Action.

ثبّت التكامل مرة واحدة، ثم ادمج ملف سير العمل

استخدم التثبيت الموجّه بحساب يملك صلاحيات إدارة المستودع. سجّل الدخول إلى GitHub CLI المثبت باستخدام gh auth login، ثم افتح claude داخل المستودع وشغّل /install-github-app. اختر مسارات العمل وطريقة المصادقة، بمفتاح API أو بالاشتراك، ثم أنشئ طلب السحب المجهّز لملف سير العمل وادمجه. يتم التثبيت محليًا، بينما تعمل المهام اللاحقة على GitHub. الإعداد السريع الرسمي.

وتصل إلى النتيجة نفسها بالتثبيت اليدوي:

1. ثبّت Claude GitHub App على المستودع الذي تختاره.
2. افتح في المستودع الإعدادات → الأسرار والمتغيرات → Actions، ثم أضف سرًا واحدًا للمصادقة من الجدول أدناه.
3. انسخ المثال الجاهز للتشغيل من Anthropic إلى .github/workflows/claude.yml، واختر حقل المصادقة المطابق للسر، ثم ادمج الملف.
4. اترك تعليقًا يتضمن @claude وطلبًا محددًا.

هذه هي خطوات الإعداد اليدوي الرسمية، مع توضيح اختيار بيانات الاعتماد. دليل إعداد Action.

إذا اخترت الاشتراك، شغّل claude setup-token محليًا واحفظ الناتج بوصفه سر المستودع. توثّق Anthropic هذه الطريقة لخطط Pro وMax وTeam وEnterprise. يبقى الرمز المُنشأ صالحًا لعام واحد، لذا عيّن شخصًا مسؤولًا عن تجديده. المصادقة بالرمز.

تتحدد الفوترة بحسب بيانات الاعتماد: التشغيل بمفتاح API يخضع لفوترة API، أما التشغيل برمز OAuth فيُحتسب ضمن اشتراك Claude، ويُحسب استخدام أجهزة تشغيل GitHub Actions بصورة منفصلة. يرتبط رمز الاشتراك بالشخص الذي أنشأه؛ وتوصي Anthropic بمفتاح API للأسرار المشتركة بين مستودعات متعددة. المصادقة والتكاليف.

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

ابدأ بسير عمل محدود يستجيب للإشارة إليه

استخدم هذا الإعداد في مستودعات الفريق الموثوقة ولتغييرات محدودة في الملفات. يتيح قراءة الملفات وتعديلها وإنشاء عمليات commit عبر GitHub API. لا يحصل Claude هنا على أداة لتنفيذ أوامر الصدفة، ولذلك لا يستطيع تشغيل أوامر الاختبار. أبقِ مسؤولية تنفيذ الاختبارات على منظومة التكامل المستمر CI المعتادة، أي الفحوص الآلية التي تعمل عند اقتراح تغييرات.

احفظ الإعداد في .github/workflows/claude.yml. المرجعان actions/checkout@v6 وanthropics/claude-code-action@v1 واردان في مثال Anthropic الحالي. أما الحد الأقصى البالغ خمس دورات عمل والمهلة البالغة خمس عشرة دقيقة فهما اختياران للبدء، وليسا إعدادين افتراضيين من Anthropic. سير العمل الرسمي.

name: Claude on request
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    timeout-minutes: 15
    concurrency:
      group: claude-small-team
      cancel-in-progress: false
    permissions:
      contents: write
      issues: write
      pull-requests: write
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          use_commit_signing: true
          claude_args: |
            --max-turns 5
            --tools "Read,Glob,Grep,Edit,Write"
            --disallowedTools "Bash,WebFetch,WebSearch"

للفوترة عبر الاشتراك، استبدل سطر anthropic_api_key بالسطر claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}. استخدم طريقة واحدة فقط. وأبقِ id-token: write، فهو مطلوب للمصادقة الافتراضية عبر GitHub App. سير العمل الرسمي والمصادقة، مرجع حقول الإدخال.

لكل عنصر ضبط وظيفة مختلفة:

• يحدد --tools الأدوات المدمجة التي يمكن لـ Claude استخدامها. تفحص Read وGlob وGrep الملفات، بينما تعدّلها Edit وWrite. لكنه لا يقيد أدوات MCP، وهي الأدوات المتصلة بصورة منفصلة التي يستخدمها Action للتعامل مع GitHub.
• يمنح --allowedTools الإذن باستخدام الأدوات المسماة دون طلب موافقة. وهو ليس قائمة سماح شاملة للأدوات. أما سطر --disallowedTools الصريح هنا فيمنع أدوات الصدفة والويب.
• يحد --max-turns من دورات عمل الوكيل. ولا يضع سقفًا لعدد الرموز النصية أو التكلفة بالدولار، وقد يؤدي بلوغ الحد إلى انتهاء التشغيل بخطأ وبقاء العمل غير مكتمل. مرجع واجهة سطر الأوامر.

يوجّه use_commit_signing: true عمليات commit عبر GitHub API. وهذا ما يتيح لهذا الإعداد حفظ التغييرات دون منح Claude أوامر git عبر الصدفة، ومن دون سر إضافي للتوقيع. وتظل أدوات GitHub الخاصة بـ Action متاحة، لذا يملك هذا الإعداد القدرة على الكتابة. توقيع عمليات commit، تنفيذ Action.

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

جرّب @claude review this PR for missing permission checks; report findings without changing files. ولإصلاح مشكلة، جرّب @claude fix the null handling described above, change only the parser and its regression test, and state which checks were not run.

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

أضف المراجعة الآلية بعد التجربة

لإجراء مراجعات آلية لطلبات السحب، اختر سير عمل المراجعة أثناء الإعداد عبر /install-github-app. تستخدم إضافة مراجعة الكود الخيار --comment وإذن أداة التعليقات أدناه لنشر الملاحظات. المثال الرسمي للمراجعة.

تتضمن مدخلات Action في سير عمل المراجعة المنفصل ما يلي:

plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
plugins: "code-review@claude-code-plugins"
prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
claude_args: >-
  --max-turns 5
  --allowedTools "mcp__github_inline_comment__create_inline_comment"

استخدم هذه المدخلات داخل سير العمل الرسمي الخاص بحدث pull_request، وليس سير العمل القائم على الإشارات أعلاه. احتفظ بخطوة جلب الكود والمصادقة وصلاحيات المهمة، وأضف مهلة زمنية، وتجاوز طلبات السحب الواردة من نسخ متفرعة باستخدام if: github.event.pull_request.head.repo.full_name == github.repository. تعامل مع حد دورات العمل بوصفه إعدادًا تجريبيًا: المراجعة التي تستنفد دوراتها تبقى غير مكتملة. كما تتجاوز مهارة المراجعة الموثقة بعض طلبات السحب، ومنها المسودات.

افصل نطاق تثبيت التطبيق عن نطاق الأدوات

ابدأ بتثبيت التطبيق على مستودعات مختارة. يشترك تطبيق Claude الرسمي في صلاحياته بين عدة ميزات في Claude، ولا يتيح GitHub قبول جزء من مجموعة الصلاحيات فقط. وتقليص كتلة permissions في YAML لا يضيّق نطاق تثبيت التطبيق. نموذج صلاحيات التطبيق.

إذا كان نطاق التثبيت أوسع مما يناسبك، فاتبع طريقة التطبيق المخصص مع إتاحة الوصول إلى المحتويات والمشكلات وطلبات السحب. تضيف هذه الطريقة السرّين APP_ID وAPP_PRIVATE_KEY، وخطوة تنشئ رمزًا للتطبيق وتمرره عبر github_token. وللفرق المستعدة للاستغناء عن مفاتيح Claude API الثابتة، يشرح دليل الإعداد أيضًا اتحاد هويات أحمال العمل، الذي يستبدل هوية المهمة في GitHub بإذن وصول قصير الأجل إلى API. إعداد التطبيق المخصص واتحاد الهويات.

أضف ملف CLAUDE.md موجزًا يوضح أولويات المراجعة، والأجزاء المسموح بتغييرها، والأدلة التي يجب أن يرفقها أي إصلاح. توجه التعليمات العمل، بينما تفرض صلاحيات المستودع وقيود الأدوات حدود الوصول. راجع أي خطافات مهيأة، أي الأوامر التي تُنفذ تلقائيًا عند أحداث دورة التشغيل، وأي خوادم أدوات إضافية قبل السماح بالتشغيل دون إشراف. تعليمات المشروع. يتناول دليلنا لمراجعة Claude Code قرار استخدامه للمراجعة بصورة أوسع، ويشرح دليل الأوامر التي تبدأ بشرطة مائلة الأوامر المستخدمة أثناء الإعداد.

ست مهام تستحق التجربة، بحسب الأولوية

ابدأ بالمهام التي يسهل وصفها والتحقق من نتائجها. ما يلي اقتراحات لسير العمل، وليس وفورات مقاسة أو نتائج مضمونة.

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

عالج هذه الأعطال قبل إضافة مزيد من مشغلات الأحداث

قد لا تصل طلبات السحب من النسخ المتفرعة إلى الأسرار. يحجب GitHub الأسرار عادةً عن عمليات pull_request وpull_request_review_comment التي تطلقها النسخ المتفرعة. وظهور حقل اعتماد Claude فارغًا في هذه المهام ناتج عن حدود الثقة. لا تنتقل إلى pull_request_target ثم تنفذ كود النسخة المتفرعة لمجرد الوصول إلى الأسرار. وقد تتوفر الأسرار أيضًا لمهمة issue_comment يطلقها مسؤول المستودع، لذا فإن موثوقية صاحب التعليق لا تجعل ملفات طلب السحب موثوقة. إرشادات GitHub لأمان النسخ المتفرعة.

قيود الأدوات لا تبطل مفعول الكود الذي يُنفذ عند بدء المشروع. يستعيد Action إعدادات محددة لـ Claude من الفرع الأساسي، لكن السكربتات وملفات المشروع الأخرى قد تظل مأخوذة من طلب السحب. افحص الخطافات وإعدادات خوادم الأدوات، إلى جانب الأدوات المسموح بها لـ Claude. حدود الثقة في Action.

يبقى وقت جهاز التشغيل قيدًا مستقلًا. أجهزة التشغيل القياسية التي يستضيفها GitHub مجانية للمستودعات العامة. أما المستودعات الخاصة فلها حصص ضمن الخطة ورسوم على الاستخدام الزائد؛ وقد يؤدي استنفاد الحصة دون وجود وسيلة دفع إلى توقف المهام. راجع صفحة استخدام Actions إلى جانب استخدام Claude. فوترة GitHub Actions.

قد توقف حدود معدل الاستخدام سير عمل صحيح الإعداد. تشمل حدود API عدد الطلبات ورموز الإدخال والإخراج، أي الوحدات النصية التي يعالجها النموذج، في الدقيقة. عند ظهور 429 مع retry-after، انتظر قبل إعادة المحاولة وقلّل عدد المهام المتزامنة. أما 429 الناتج عن سقف الإنفاق في مستوى الاستخدام، من دون تلك الترويسة، فيحتاج إلى معالجة الفوترة أو الحد المسموح، وليس تكرار التشغيل. وتظل المصادقة بالاشتراك خاضعة لحدود استخدام الخطة. حدود معدل استخدام API، حدود استخدام Claude.

عدم استجابة الروبوت وعدم تشغيل CI عطلان مختلفان. إذا لم يستجب الروبوت، فتحقق من وجود سير العمل على الفرع الافتراضي، وتفعيل Actions، وتطابق السر مع حقل الإدخال، وامتلاك صاحب التعليق صلاحية الكتابة. استخدم الإشارة كاملة: @claude. أما إذا لم تعمل فحوص CI اللاحقة، فتحقق مما إذا كان أحدهم قد استبدل مصادقة التطبيق بـ github_token: ${{ secrets.GITHUB_TOKEN }}: يمنع GitHub إطلاق كثير من الأحداث التي ينشئها هذا الرمز، وتحتاج بعض مسارات عمل طلبات السحب إلى موافقة. سلوك رمز GitHub.

فرصتان لبناء خدمة حول هذا التكامل

الفرصة الأقوى هي خدمة مُدارة لإعداد المراجعة للفرق الصغيرة. العميل المستهدف هو قائد هندسي يريد ملاحظات مفيدة، ومسؤوليات واضحة، وحدود تشغيل يمكن توقعها. تشير تقديرات DataForSEO لعمليات البحث باللغة الإنجليزية في الولايات المتحدة، التي جُمعت في 15 أكتوبر 2026، إلى 1,300 عملية بحث شهريًا عن عبارة «ai code review». هذا دليل على الاهتمام، وليس عددًا للعملاء. يمكن لنسخة أولى قابلة للبيع أن تهيئ مستودعًا واحدًا، وتحول أولويات مراجعته إلى تعليمات، وتقيّم الملاحظات بالرجوع إلى طلبات سحب سابقة، وتقدم تقريرًا مستمرًا عن الاستخدام والأعطال. التحدي هو إرهاق الفريق بالتنبيهات الخاطئة: العمل الذي تستمر قيمته هو الحفاظ على جودة المراجعة مع تغير قاعدة الكود. أما مجرد تغليف موجّه عام في منتج فلا يمنح العميل سببًا قويًا للاستمرار.

قد تشتري وكالة حزمة قابلة لإعادة الاستخدام لسياسات المراجعة في مستودعات عملائها. تقدر DataForSEO حجم البحث الشهري في السوق نفسها بـ 590 عملية بحث شهريًا عن «ai code review tools»، و140 عن «github ai code review». ويمكن لأصغر منتج قابل للتقديم أن يجمع سير عمل يعاد استخدامه، وقوالب تعليمات مخصصة لكل عميل، وسجلات بمسؤولي بيانات الاعتماد، وفحوصًا تكشف غياب حدود التشغيل. وقد يساعد الوكالة على الحفاظ على اتساق الإعدادات عند تسليم المشاريع بين الفرق. لكن صلاحيات كل عميل وبيئة اختباراته تختلف؛ لذا يحتاج القالب إلى صيانة وتقييم كي يظل مفيدًا. وتتداخل جماهير هذه الاستعلامات، فلا تجمع أحجام البحث لتقدير حجم السوق.

اختر بيئة التنفيذ التي تناسب المهمة

اختر GitHub Actions عندما يرتبط العمل بحدث في المستودع، ويريد فريقك إدارة الإعدادات والصلاحيات والسجلات مع منظومة CI. واختر جلسة سحابية لمهمة لمرة واحدة تريد بدءها وتوجيهها من المتصفح بينما حاسوبك المحمول مغلق. واختر روتينًا مجدولًا لمهمة متكررة محفوظة، مثل مراجعة قائمة المهام المتراكمة كل ليلة، إذا كنت تفضل جدولة Claude المستضافة وإعداداتها على صيانة ملفات YAML لسير العمل. تدعم الروتينات أيضًا مشغلات GitHub وAPI، ولذلك لا تعني الحاجة إلى الجدولة وحدها ضرورة اختيار Actions؛ ولا تزال الروتينات في مرحلة المعاينة البحثية. الجلسات السحابية، الروتينات.

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

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