هل أنت مستعد لتعزيز سير عملك باستخدام Claude Code و GitHub Actions؟ تخيل أن لديك زميل فريق يعمل بالذكاء الاصطناعي يراجع طلبات السحب (pull requests)، ويصلح الأخطاء، أو حتى يكتب ميزات جديدة مباشرة في مستودع GitHub الخاص بك. يبدو وكأنه سحر، أليس كذلك؟ **Claude Code** من Anthropic يجعل هذا حقيقة من خلال التكامل السلس مع **GitHub Actions**، مما يؤتمت المهام بمجرد الإشارة البسيطة @claude. لقد عثرت على هذه الجوهرة في وثائق Anthropic ومستودع GitHub، وهي تغير قواعد اللعبة للمطورين. في هذا البرنامج التعليمي، سأرشدك خلال إعداد **Claude Code** في **GitHub Actions**، وإنشاء سير عمل لمراجعة طلبات السحب (PRs)، واستكشاف قدراته. لننطلق ونجعل مستودعك أكثر ذكاءً!
button
لماذا يعتبر Claude Code و GitHub Actions رائعين؟
Claude Code هو أداة ترميز عاملة (agentic) من Anthropic تعيش في الطرفية أو بيئة التطوير المتكاملة (IDE) الخاصة بك، وتفهم قاعدة التعليمات البرمجية الخاصة بك كالمحترفين. عند اقترانه بـ **GitHub Actions**، يصبح زميل فريق افتراضي يؤتمت مراجعات التعليمات البرمجية، وينفذ الميزات، ويصنف المشكلات مباشرة في مستودعك. إنه في مرحلة البيتا (اعتبارًا من مايو 2025)، ولكنه يتألق بالفعل في مهام مثل:
- مراجعات التعليمات البرمجية: يحلل طلبات السحب (PRs) بحثًا عن الأخطاء والأسلوب والمعايير.
- تنفيذ الميزات: يحول أوصاف المشكلات إلى تعليمات برمجية تعمل.
- إصلاح الأخطاء: يكتشف ويصلح الأخطاء مع طلبات سحب (PRs) جاهزة للدمج.
مستودع GitHub anthropics/claude-code-action يسلط الضوء على قدرته على التشغيل عند التعليقات التي تحتوي على @claude، مما يجعله تفاعليًا وسهل الاستخدام للمطورين. لنقم بإعداده!
إعداد Claude Code لـ GitHub Actions
قبل أن نقوم بأتمتة مستودعك، دعنا نجهز بيئتك. هذا مناسب للمبتدئين، وسأجعله سريعًا!
1. التحقق من المتطلبات:
- مستودع GitHub: تحتاج إلى وصول إداري لإضافة الأسرار والتطبيقات.
- مفتاح Anthropic API: احصل على واحد من console.anthropic.com. تعمل الحسابات المجانية، لكن الخطط المدفوعة (Pro/Max) توفر استخدامًا أكبر.
- النظام: أي نظام تشغيل (macOS، Linux، Windows مع WSL2) مثبت عليه Git وطرفية.
- واجهة سطر الأوامر لـ Claude Code (اختياري للإعداد): قم بتثبيتها عبر
npm install -g @anthropic-ai/claude-code.
2. تثبيت تطبيق Claude GitHub:
- افتح الطرفية الخاصة بك وقم بتشغيل:
claude
/install-github-app
- يرشدك هذا إلى تثبيت تطبيق Claude GitHub (github.com/apps/claude) في مستودعك. اتبع التعليمات لاختيار مستودعك وتفويض الأذونات.
- إذا واجهت خطأ 404، قم بتحديث رمز
ghالخاص بك:gh auth refresh -h github.com -s workflowوحاول مرة أخرى. - ملاحظة: هذا الدليل السريع مخصص لمستخدمي Anthropic API. بالنسبة لـ AWS Bedrock أو Google Vertex AI، راجع الإعداد اليدوي في وثائق Anthropic.
3. إضافة مفتاح API الخاص بك:
- بعد التثبيت، تقوم واجهة سطر الأوامر بإنشاء طلب سحب (PR) يحتوي على ملف سير عمل (
.github/workflows/claude.yml). - قبل الدمج، أضف مفتاح Anthropic API الخاص بك كسر GitHub:
- انتقل إلى الإعدادات > الأسرار والمتغيرات > الإجراءات في مستودعك.
- أضف سرًا باسم
ANTHROPIC_API_KEYباستخدام مفتاحك من وحدة تحكم Anthropic. - ادمج طلب السحب (PR) لتفعيل سير العمل.
لقد قمت بإعداد هذا في 10 دقائق على مستودع اختباري - سلس للغاية.
ملاحظة: استخدم دائمًا أسرار GitHub لمفاتيح API!
إنشاء سير عمل Claude Code في GitHub Actions
الآن، دعنا نصمم سير عمل **GitHub Actions** لجعل **Claude Code** يراجع طلبات السحب (PRs) تلقائيًا. سنستخدم anthropics/claude-code-action من مستودع GitHub.
1. إنشاء ملف سير العمل:
- إذا لم يتم إنشاء ملف سير العمل بواسطة
/install-github-app، قم بإضافة.github/workflows/claude.ymlيدويًا في مستودعك:
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Run Claude Code Review
uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
direct_prompt: |
Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.
- يؤدي هذا إلى تشغيل **Claude Code** عند طلبات السحب (PRs) الجديدة أو المحدثة، لمراجعة التعليمات البرمجية بحثًا عن الجودة والأخطاء.
2. اختبار سير العمل:
- ادفع تغييرًا إلى فرع وافتح طلب سحب (PR). سيتم تشغيل **Claude Code**، ونشر تعليق يتضمن مراجعته (على سبيل المثال، "تم العثور على مؤشر محتمل فارغ (null pointer) في
main.py. ضع في اعتبارك إضافة تحقق..."). - لقد اختبرت هذا على مستودع Python، واكتشف Claude تلميح نوع (type hint) مفقود - في الصميم!
3. تخصيص المشغل (Trigger):
- هل تريد تحكمًا يدويًا؟ قم بتعديل سير العمل ليتم تشغيله بناءً على التعليقات:
on:
issue_comment:
types: [created]
jobs:
claude:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
- الآن، علّق بـ
@claude review this PRلتشغيله.
استخدام Claude Code للمهام المتقدمة
Claude Code في **GitHub Actions** ليس فقط للمراجعات - يمكنه تنفيذ الميزات أو إصلاح الأخطاء. إليك كيفية الارتقاء بالمستوى:
1. تنفيذ ميزة:
- أنشئ مشكلة (issue): "أضف مصادقة المستخدم إلى نقطة نهاية تسجيل الدخول."
- علّق:
@claude implement this feature based on the issue description. - يحلل Claude المشكلة، ويكتب التعليمات البرمجية، وينشئ طلب سحب (PR). لقد جربت هذا لواجهة برمجة تطبيقات REST، وأضاف إعداد مصادقة JWT أساسي - مثير للإعجاب.
2. إصلاح خطأ:
- في مشكلة (issue)، صف الخطأ: "خطأ TypeError في
dashboard.js." - علّق:
@claude fix the TypeError in the user dashboard component. - يحدد Claude المشكلة، يدفع الإصلاح، ويفتح طلب سحب (PR).
3. إضافة معايير المشروع:
- أنشئ ملف
CLAUDE.mdفي جذر مستودعك لتحديد معايير الترميز (على سبيل المثال، "استخدم PEP 8 للغة Python"). يحترم Claude هذه الإرشادات أثناء المراجعات والتنفيذات.
مثال على التنفيذ:
1. أولاً، يترك المستخدم تعليقًا يضع علامة @Claude، يطلب منه معالجة الملاحظات، مما يؤدي إلى تشغيل استجابة Claude التلقائية عبر GitHub Actions.
2. ثم يستجيب Claude تلقائيًا للتعليق، ويقوم بالإجراءات المطلوبة (مثل، معالجة أخطاء واجهة برمجة التطبيقات، إزالة التكرار)، ويقدم قائمة مرجعية بالمهام المكتملة.
3. أخيرًا، يوافق المراجع (مثل مهندس الواجهة الأمامية) على التغييرات التي أجراها Claude، يتم دمج طلب السحب بنجاح وإغلاقه، مما يشير إلى أن تغييرات Claude اجتازت المراجعة.
استكشاف ميزات Claude Code في GitHub Actions
هل تريد دفع **Claude Code** إلى أبعد من ذلك؟ إليك بعض الحيل الرائعة:
- تحليل الصور: قم بتحميل لقطة شاشة في تعليق (على سبيل المثال،
@claude fix this UI bug [screenshot])، ويقوم Claude بتحليلها لاقتراح إصلاحات. رائع للأخطاء المرئية. - أدوات مخصصة: قم بتمكين أدوات مثل
Bash(git:*)،GlobTool، أو خوادم MCP (بروتوكول التحكم في النموذج) للمهام المتقدمة (مثل، جلب البيانات). راجع مستودع GitHub للأمثلة. - مشغلات أسرع: استخدم مشغلات Depot (
runs-on: depot-ubuntu-latest) لتنفيذ أسرع وأرخص مقارنة بمشغلات GitHub الافتراضية. - تكامل SDK: قم ببناء سير عمل مخصص باستخدام Claude Code SDK للمهام التي تتجاوز **GitHub Actions**.
لقد جربت تحليل الصور لإصلاح خطأ في CSS، وأتقن Claude الإصلاح - مذهل!
الخلاصة: إتقان Claude Code باستخدام GitHub Actions
أحسنت! لقد قمت للتو بفتح قفل **Claude Code** في **GitHub Actions** لأتمتة مراجعات التعليمات البرمجية، وتنفيذ الميزات، وسحق الأخطاء! من تثبيت تطبيق GitHub إلى صياغة سير العمل، أنت الآن جاهز لجعل مستودعك قوة إنتاجية. جرب إضافة أدوات MCP، أو تعديل ملف CLAUDE.md، أو توثيق واجهات برمجة التطبيقات الخاصة بك باستخدام APIdog. شارك نجاحاتك مع **Claude Code** على X أو Reddit - أنا متحمس لرؤية طلبات السحب الخاصة بك تتألق! ترميز سعيد!
button