> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Claude Code 集成指南 - Ace Data Cloud

Claude Code هو أداة **Agentic Coding** أطلقتها شركة Anthropic، وتعتبر واحدة من أقوى الوكلاء البرمجيين في العالم. يمكن أن تدمج Claude Code GitHub Actions قدرات البرمجة الذكية في سير عمل GitHub الخاص بك، فقط قم بكتابة `@claude` في PR أو Issue، ليقوم Claude بتحليل الكود تلقائيًا، وإنشاء PR، وتنفيذ الوظائف، وإصلاح الأخطاء.

تتناول هذه الوثيقة كيفية تكوين واستخدام Claude Code GitHub Actions من خلال خدمة الوكيل من AceData Cloud.

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

لاستخدام Claude Code، يمكنك أولاً زيارة [صفحة خدمة Claude Messages](https://platform.acedata.cloud/documents/claude-messages) والنقر على زر "Acquire" للحصول على الشهادات المطلوبة:

![](https://cdn.acedata.cloud/nyq0xz.png)

إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية.

عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربة خدمة Claude Code مجانًا.

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

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

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

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

انتقل إلى [https://github.com/apps/claude](https://github.com/apps/claude) لتثبيت تطبيق Claude GitHub في مستودعك.

![صفحة تثبيت تطبيق GitHub Claude](https://cdn.acedata.cloud/ba4b8df66d.png)

يتطلب هذا التطبيق الأذونات التالية للمستودع:

| الأذونات          | المستوى      | الوصف                   |
| ----------------- | ------------ | ----------------------- |
| **Contents**      | Read & Write | تعديل ملفات المستودع    |
| **Issues**        | Read & Write | الاستجابة لـ Issue      |
| **Pull requests** | Read & Write | إنشاء PR ودفع التغييرات |

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

قم بإضافة مفتاح API الخاص بـ AceData Cloud كسر للمستودع:

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

> **تلميح**: يمكنك عرض رمز API في [وحدة تحكم AceData Cloud](https://platform.acedata.cloud/console).

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

قم بإنشاء ملف `.github/workflows/claude.yml` في المستودع:

```yaml theme={null}
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 }}
```

إذا كنت بحاجة إلى استخدام نقطة نهاية API الخاصة بـ AceData Cloud، فستحتاج أيضًا إلى إعداد متغيرات البيئة في Workflow:

```yaml theme={null}
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

بعد الانتهاء من التكوين، في أي تعليق على Issue أو PR، اكتب `@claude`، وسيتفاعل Claude تلقائيًا:

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

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

قم بإنشاء Workflow يقوم تلقائيًا بمراجعة الكود عند فتح PR:

```yaml theme={null}
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"
```

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

قم بإنشاء مهمة أتمتة تعمل بشكل دوري:

```yaml theme={null}
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

| المعلمة             | الوصف                                                    | إلزامي |
| ------------------- | -------------------------------------------------------- | ------ |
| `anthropic_api_key` | مفتاح API                                                | نعم    |
| `prompt`            | التعليمات الموجهة إلى Claude (نص أو Skill مثل `/review`) | لا     |
| `claude_args`       | المعلمات المرسلة إلى CLI الخاص بـ Claude Code            | لا     |
| `github_token`      | رمز GitHub                                               | لا     |
| `trigger_phrase`    | عبارة التحفيز المخصصة (افتراضيًا `@claude`)              | لا     |

### معلمات claude\_args الشائعة

```yaml theme={null}
claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
```

| المعلمة           | الوصف                                      |
| ----------------- | ------------------------------------------ |
| `--max-turns`     | الحد الأقصى لعدد جولات الحوار (افتراضي 10) |
| `--model`         | النموذج المستخدم                           |
| `--mcp-config`    | مسار ملف تكوين MCP                         |
| `--allowed-tools` | الأدوات المسموح بها (مفصولة بفواصل)        |
| `--debug`         | تفعيل إخراج التصحيح                        |

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

### تكوين CLAUDE.md

قم بإنشاء ملف `CLAUDE.md` في الدليل الجذر للمستودع، لتعريف إرشادات أسلوب الكود ومعايير المراجعة ومعايير المشروع، سيتبع Claude هذه القواعد تلقائيًا.

### ملاحظات أمان

* **لا تقم أبدًا** بكتابة مفتاح 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 صحيح

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

قم بتسجيل الدخول إلى [لوحة تحكم AceData Cloud](https://platform.acedata.cloud/console) لرؤية الرصيد المتبقي الحالي وحالة الاستخدام.

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

* 📖 [وثائق GitHub Actions الرسمية لـ Claude Code](https://code.claude.com/docs/en/github-actions)
* 📂 [مستودع claude-code-action](https://github.com/anthropics/claude-code-action)
* 📋 [أمثلة على سير العمل](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [خدمة Claude Code من AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 إذا كان لديك أي استفسارات، لا تتردد في الاتصال بنا عبر خدمة العملاء في المنصة