ما هو Claude Code GitHub Actions؟

هل ترغب في تعزيز سير عملك كمطور باستخدام الذكاء الاصطناعي؟ نقدم لك إجراء GitHub لـ Claude Code، وهو أداة ثورية تجلب ذكاء Anthropic الاصطناعي (Claude) إلى مستودعات GitHub الخاصة بك. ما عليك سوى ذكر @claude في طلب سحب أو مشكلة، وفجأة—يقوم Claude بإنشاء التعليمات البرمجية، أو إصلاح الأخطاء، أو إعادة الهيكلة كالمحترفين، كل ذلك عبر إجراءات GitHub. قمت بإعداده في 15 دقيقة فقط، وهو فعال بشكل مذهل! في هذا الدليل التعليمي، سأرشدك خلال تثبيت إجراء GitHub لـ Claude Code، وإعداده، واستخدامه لأتمتة مهام البرمجة الخاصة بك. هل أنت مستعد لترك الذكاء الاصطناعي يقوم بالعمل الشاق؟ هيا بنا نبدأ!

لماذا يُعد إجراء GitHub لـ Claude Code رائعًا

إجراء GitHub لـ Claude Code يشبه وجود مبرمج عبقري في فريقك، على مدار الساعة طوال أيام الأسبوع. يعتمد على ذكاء Anthropic الاصطناعي (Claude)، ويستمع إلى الإشارات التي تتضمن @claude في مستودعك وينطلق للعمل، مدعومًا بـ إجراءات GitHub. إليك سبب كونه رائعًا:

• طلبات السحب الفورية: صف ميزة، وسيقوم Claude بإنشاء طلب سحب (PR) بجميع التغييرات.
• إصلاح الأخطاء تلقائيًا: أبلغ عن خطأ، وسيقوم Claude ببرمجة الإصلاح—لا حاجة لعمل يدوي.
• اتساق التعليمات البرمجية: يتبع نمط مشروعك (على سبيل المثال، عبر ملف CLAUDE.md) للحصول على تعليمات برمجية نظيفة ومتجانسة.
• آمن وخاص: يعمل على مُشغّلات GitHub الخاصة بك، مما يحافظ على أمان التعليمات البرمجية الخاصة بك.
• إعداد سريع: جاهز للعمل في دقائق بتكوين بسيط.

يتميز مستودع GitHub بسير عمل أنيق، ورأيته ينتج دالة مُعاد هيكلتها في ثوانٍ. هيا بنا نجعله يعمل!

كيف يعمل إجراء GitHub لـ Claude Code

يتكامل Claude Code مع إجراءات GitHub لمراقبة مستودعك بحثًا عن الإشارات التي تتضمن @claude في المشكلات، أو طلبات السحب، أو تعليقات المراجعة. عند تشغيله، يقوم بما يلي:

• يحلل قاعدة التعليمات البرمجية الخاصة بك أو سياق المشكلة.
• ينشئ أو يعدل التعليمات البرمجية بناءً على طلبك.
• ينشئ طلب سحب (PR) بالتغييرات أو ينشر تعليقات.
• يشغل العديد من وكلاء Claude بالتوازي لزيادة السرعة.

إنه مثل وجود صديق مبرمج لا ينام أبدًا، وكل ذلك مدعوم بمُشغّلات إجراءات GitHub. هل أنت مستعد لإعداده؟ إليك الطريقة!

الإعداد خطوة بخطوة: إجراء GitHub لـ Claude Code

هيا نجعل Claude Code يعمل في مستودعك. لقد اختبرت هذا على مشروع Node.js، ولكنه يعمل مع أي قاعدة تعليمات برمجية. اتبع هذه الخطوات لأتمتة سير عملك في حوالي 15 دقيقة.

1. تثبيت تطبيق Claude GitHub

ستحتاج إلى حقوق المسؤول لمستودعك.

• توجه إلى صفحة تطبيق Claude GitHub.
• قم بتثبيته على مستودعك أو مؤسستك، ومنح الأذونات اللازمة لـ المحتويات (contents)، والمشكلات (issues)، وطلبات السحب (pull requests).
• قمت بتثبيته على مستودعي التجريبي، واستغرق الأمر دقيقتين فقط—سلس جدًا!

2. إضافة مفتاح API الخاص بـ Anthropic

يحتاج Claude إلى مفتاح API ليقوم بسحره.

• انتقل إلى الإعدادات (Settings) > الأسرار والمتغيرات (Secrets and variables) > الإجراءات (Actions) في مستودعك.
• انقر على سر مستودع جديد (New repository secret).
• سمّه ANTHROPIC_API_KEY والصق مفتاح API الخاص بـ Anthropic (يمكنك الحصول عليه من console.anthropic.com).
• هذا يحافظ على مفتاحك آمنًا لسير عمل إجراءات GitHub.

3. إضافة ملف سير عمل Claude

الآن، لنقم بإعداد سير عمل إجراءات GitHub.

• انسخ مثال ملف claude.yml من grll/claude-code-action.
• أنشئ مجلد .github/workflows/ في مستودعك.
• الصق ما يلي في ملف .github/workflows/claude.yml:

# .github/workflows/claude.yml
name: Claude PR Assistant

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude-code-action:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude PR Action
        uses: grll/claude-code-action@beta
        with:
          use_oauth: true
          claude_access_token: ${{ secrets.CLAUDE_ACCESS_TOKEN }}
          claude_refresh_token: ${{ secrets.CLAUDE_REFRESH_TOKEN }}
          claude_expires_at: ${{ secrets.CLAUDE_EXPIRES_AT }}

          timeout_minutes: "60"
          # Optional: add custom trigger phrase (default: @claude)
          # trigger_phrase: "/claude"
          # Optional: add assignee trigger for issues
          # assignee_trigger: "claude"
          # Optional: add custom environment variables (YAML format)
          # claude_env: |
          #   NODE_ENV: test
          #   DEBUG: true
          #   API_URL: https://api.example.com

• يستمع سير العمل هذا إلى الإشارات التي تتضمن @claude في التعليقات أو المشكلات ويشغل Claude على مُشغّلات إجراءات GitHub.

4. تكوين أسرار تطبيق GitHub

لكي يقوم سير العمل بإنشاء رموز التطبيق:

• احصل على APP_ID و APP_PRIVATE_KEY الخاصين بتطبيق GitHub الخاص بك من إعدادات التطبيق (بعد التثبيت).
• أضفهما كأسرار في الإعدادات (Settings) > الأسرار والمتغيرات (Secrets and variables) > الإجراءات (Actions):
• APP_ID: معرف تطبيق GitHub الخاص بك.
• APP_PRIVATE_KEY: محتوى ملف المفتاح الخاص.

5. تشغيل Claude باستخدام @claude

الآن، اختبره!

• افتح مشكلة أو علّق على طلب سحب بشيء مثل:

@claude Please refactor the data fetching logic in `api.js` for better error handling.

• يقوم Claude بتحليل طلبك، وينشئ طلب سحب (PR) بالتعليمات البرمجية المُعاد هيكلتها، ويضيف تعليقات.
• لقد جربت هذا، وقام Claude بتسليم ملف api.js أنظف مع كتل try-catch في لمح البصر!

تخصيص إجراء GitHub لـ Claude Code

هل ترغب في تعديل سلوك Claude؟ سير عمل إجراءات GitHub مرن للغاية. إليك كيفية جعله خاصًا بك:

• مطالبات مخصصة: أضف ملف CLAUDE.md يتضمن إرشادات المشروع (على سبيل المثال، "استخدم async/await، تجنب console.log"). يتبع Claude ذلك كدليل نمط.
• مهلات: اضبط قيمة timeout_minutes في ملف claude.yml (على سبيل المثال، "30" لتشغيل أقصر).
• اختيار النموذج: قم بتبديل النماذج في سير العمل (على سبيل المثال، claude-3-5-sonnet بدلاً من claude-3-7-sonnet).
• المصادقة: استخدم AWS Bedrock أو Google Vertex AI عن طريق تحديث use_vertex ومتغيرات البيئة.
• الوصول إلى الأدوات: قم بتقييد عمليات ملفات Claude أو استدعاءات GitHub API عبر إعدادات سير العمل لمزيد من الأمان.

لقد أضفت ملف CLAUDE.md يتضمن "تفضيل TypeScript"، وتطابقت طلبات سحب Claude مع نمطي تمامًا!

حالات الاستخدام الواقعية: Claude Code قيد العمل

يتألق Claude Code في تسريع مهام المطورين. إليك ما جربته وما يمكنك فعله باستخدام إجراءات GitHub:

• إصلاح الأخطاء: نشرت مشكلة: “@claude Fix the null error in user.js.” أنشأ Claude طلب سحب (PR) يتضمن فحصًا للقيمة الفارغة (null)—تم في دقيقتين!
• بناء الميزات: علّقت: “@claude Add a login endpoint to server.js.” حصلت على طلب سحب (PR) يتضمن مسارات Express ومصادقة JWT.
• إعادة هيكلة التعليمات البرمجية: سألت: “@claude Optimize utils.js for performance.” أعاد Claude كتابة الحلقات ونتائج التخزين المؤقت.
• مراجعات التعليمات البرمجية: راجع Claude طلب السحب (PR) الخاص بي، واقترح أسماء متغيرات أفضل ومعالجة للأخطاء.

نصائح لإتقان إجراء GitHub لـ Claude Code

للحصول على أقصى استفادة من Claude Code مع إجراءات GitHub:

• كن محددًا: اكتب تعليقات @claude واضحة (على سبيل المثال، "أضف معالجة الأخطاء إلى الدالة fetchData في ملف api.js").
• استخدم CLAUDE.md: حدد معايير البرمجة (على سبيل المثال، المسافات البادئة بالمسافات أو علامات الجدولة، تسمية الدوال) للحصول على مخرجات متناسقة.
• مراقبة التشغيلات: تحقق من علامة تبويب الإجراءات (Actions) في GitHub لتصحيح أخطاء سير العمل أو عرض سجلات Claude.
• الدمج مع VS Code: قم بالاقتران مع إضافة Anthropic لـ VS Code للبرمجة المحلية باستخدام Claude، مع المزامنة مع إجراءات GitHub.
• اختبر مهام صغيرة: ابدأ بمهام بسيطة (على سبيل المثال، “@claude Add a README”) لتعلم نمط Claude.

لقد وجدت أن المطالبات المفصلة قللت وقت استجابة Claude إلى النصف—الدقة تؤتي ثمارها!

لماذا يتميز إجراء GitHub لـ Claude Code

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

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