دليل استخدام Claude Code GitHub Actions

​

عملية التقديم

​

ميزات الوظيفة

• إنشاء PR فوري: وصف المتطلبات، يقوم Claude بإنشاء طلب سحب كامل تلقائيًا
• تنفيذ الكود تلقائيًا: في Issue، قم بكتابة @claude، لتحويل Issue إلى كود قابل للتنفيذ
• اتباع معايير المشروع: يقوم بقراءة CLAUDE.md تلقائيًا، واتباع أسلوب الكود ومعايير المشروع الخاصة بك
• آمن وموثوق: يتم تشغيل الكود على Runner الخاص بـ GitHub، مما يضمن أمان البيانات

​

خطوات التكوين

​

الخطوة الأولى: تثبيت تطبيق Claude GitHub

​

الخطوة الثانية: إضافة مفتاح API

1. انتقل إلى Settings → Secrets and variables → Actions
2. انقر على New repository secret
3. اكتب في Name ANTHROPIC_API_KEY، وأدخل قيمة رمز API الذي حصلت عليه من AceData Cloud
4. انقر على Add secret للحفظ

تلميح: يمكنك عرض رمز API في وحدة تحكم AceData Cloud.

​

الخطوة الثالثة: إنشاء ملف Workflow

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

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

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

طريقة الاستخدام

​

استخدامه في تعليقات Issue أو PR

@claude قم بتنفيذ الوظيفة بناءً على وصف هذا Issue
@claude راجع أمان كود هذا PR
@claude إصلاح TypeError في مكون لوحة المستخدم
@claude كيف يمكن تنفيذ مصادقة المستخدم في هذه النقطة؟

​

مراجعة الكود تلقائيًا

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

أتمتة المهام المجدولة

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "إنشاء ملخص للتقديمات من الأمس وتقرير عن Issues غير المغلقة"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

شرح معلمات Action

​

معلمات claude_args الشائعة

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

​

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

​

تكوين CLAUDE.md

​

ملاحظات أمان

• لا تقم أبدًا بكتابة مفتاح API مباشرة في ملف Workflow
• استخدم دائمًا أسرار GitHub (مثل ${{ secrets.ANTHROPIC_API_KEY }})
• قيد أذونات Action إلى الحد الأدنى الضروري
• قم بمراجعة اقتراحات Claude يدويًا قبل الدمج

​

التحكم في التكاليف

• استخدم تعليمات @claude الواضحة لتقليل المكالمات غير الضرورية لـ API
• قم بتكوين قيود معقولة لـ --max-turns على عدد جولات الحوار
• قم بتعيين وقت انتهاء على مستوى Workflow
• استخدم التحكم في التوازي من GitHub للحد من عدد العمليات المتزامنة

​

الأسئلة الشائعة

​

لماذا لا يستجيب Claude لأمر @claude؟

1. تأكد من أن تطبيق Claude GitHub مثبت بشكل صحيح
2. تحقق مما إذا كان Workflow مفعلًا
3. تأكد من أن مفتاح API تم تعيينه كسر للمستودع
4. تأكد من استخدام @claude في التعليق (وليس /claude)

​

خطأ في المصادقة؟

1. تأكد من أن مفتاح API صالح وله الأذونات الكافية
2. تحقق من أن اسم السر صحيح (ANTHROPIC_API_KEY)
3. إذا كنت تستخدم ANTHROPIC_BASE_URL، تأكد من أن URL صحيح

​

كيف يمكنني查看 الرصيد المتبقي؟

​

تعرف على المزيد

• 📖 وثائق GitHub Actions الرسمية لـ Claude Code
• 📂 مستودع claude-code-action
• 📋 أمثلة على سير العمل
• 🔧 خدمة Claude Code من AceData Cloud
• 💬 إذا كان لديك أي استفسارات، لا تتردد في الاتصال بنا عبر خدمة العملاء في المنصة