> ## 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.

# دليل استخدام واجهة سطر الأوامر (CLI) لـ Claude Code

> Claude Code 集成指南 - Ace Data Cloud

Claude Code هو أداة **Agentic Coding** أطلقتها شركة Anthropic، ويعتبر واحدًا من أقوى وكلاء البرمجة في العالم. واجهة سطر الأوامر CLI هي التجربة الأساسية لـ Claude Code، يمكنك تشغيل الأمر `claude` في أي طرفية، والتعاون مع الذكاء الاصطناعي في البرمجة باستخدام اللغة الطبيعية.

تتناول هذه الوثيقة كيفية تثبيت وتكوين واستخدام واجهة سطر الأوامر لـ Claude Code من خلال خدمة الوكيل الخاصة بـ AceData Cloud.

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

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

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

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

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

## تثبيت Claude Code

### متطلبات النظام

* macOS أو Linux أو Windows (بما في ذلك WSL)
* Node.js ليس ضروريًا، حيث ستقوم طريقة التثبيت الأصلية بمعالجة التبعيات تلقائيًا

### طرق التثبيت

يدعم Claude Code عدة طرق للتثبيت:

**الطريقة الأولى: التثبيت الأصلي (موصى به)**

macOS / Linux / WSL:

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

Windows PowerShell:

```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```

Windows CMD:

```cmd theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

**الطريقة الثانية: Homebrew (macOS / Linux)**

```bash theme={null}
brew install claude-code
```

**الطريقة الثالثة: WinGet (Windows)**

```cmd theme={null}
winget install Claude.ClaudeCode
```

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

## تكوين واجهة برمجة التطبيقات لـ AceData Cloud

بعد الانتهاء من التثبيت، سيطلب منك تسجيل الدخول إلى حساب Anthropic الرسمي بشكل افتراضي. يمكننا استخدام متغيرات البيئة لتكوين واجهة برمجة التطبيقات الخاصة بـ AceData Cloud، **دون الحاجة إلى اشتراك رسمي**.

### تكوين متغيرات البيئة

هناك طريقتان لتكوين متغيرات البيئة، يمكنك اختيار أي منهما.

**الطريقة الأولى: إعداد في ملف تكوين Shell (موصى به)**

أضف المحتوى التالي إلى ملف تكوين Shell الخاص بك (`~/.zshrc`، `~/.bashrc` أو `~/.bash_profile`)، واستبدل `{token}` بالتوكن الخاص بك الذي حصلت عليه من لوحة تحكم AceData Cloud:

```bash theme={null}
# تكوين وكيل Claude Code - AceData Cloud
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
```

بعد التعديل، نفذ الأمر التالي لتفعيل التكوين:

```bash theme={null}
source ~/.zshrc  # أو source ~/.bashrc
```

**الطريقة الثانية: إعداد في ملف settings.json لـ Claude Code**

قم بتحرير `~/.claude/settings.json` (إذا لم يكن موجودًا، قم بإنشائه) وأضف تكوين `env`:

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

تتمثل فائدة هذه الطريقة في أن متغيرات البيئة تؤثر فقط على Claude Code، ولا تؤثر على البرامج الأخرى.

> **تلميح**: يمكنك عرض توكن واجهة برمجة التطبيقات في [لوحة تحكم AceData Cloud](https://platform.acedata.cloud/console). سيتم إضافة قيمة `ANTHROPIC_AUTH_TOKEN` تلقائيًا مع بادئة `Bearer` عند إرسالها إلى الخادم.

## البدء في الاستخدام

### بدء وضع التفاعل

افتح الطرفية، وانتقل إلى دليل مشروعك، ثم قم بتشغيل:

```bash theme={null}
cd /path/to/your/project
claude
```

سترى واجهة الترحيب لـ Claude Code، يمكنك البدء في التفاعل مباشرة بإدخال اللغة الطبيعية.

### الأوامر الشائعة

| الأمر                 | الوصف                               | المثال                        |
| --------------------- | ----------------------------------- | ----------------------------- |
| `claude`              | بدء وضع التفاعل                     | `claude`                      |
| `claude "مهمة"`       | تنفيذ مهمة لمرة واحدة               | `claude "إصلاح خطأ البناء"`   |
| `claude -p "استعلام"` | تنفيذ استعلام ثم الخروج             | `claude -p "اشرح هذه الدالة"` |
| `claude -c`           | متابعة أحدث محادثة في الدليل الحالي | `claude -c`                   |
| `claude -r`           | استعادة المحادثة السابقة            | `claude -r`                   |
| `claude commit`       | إنشاء التزام Git                    | `claude commit`               |

### أوامر وضع التفاعل

في وضع التفاعل، يمكنك استخدام الأوامر المدمجة التالية:

| الأمر              | الوظيفة              |
| ------------------ | -------------------- |
| `/help`            | عرض معلومات المساعدة |
| `/clear`           | مسح تاريخ المحادثة   |
| `/config`          | فتح لوحة الإعدادات   |
| `/model`           | تبديل النموذج        |
| `/mcp`             | إدارة خدمة MCP       |
| `/compact`         | ضغط السياق           |
| `/memory`          | إدارة الذاكرة        |
| `/login`           | تبديل الحساب         |
| `exit` أو `Ctrl+C` | الخروج               |

### أمثلة على التفاعل في المحادثة

```bash theme={null}
# تحليل المشروع
> ماذا يفعل هذا المشروع؟

# إصلاح الأخطاء
> هناك خطأ حيث يمكن للمستخدمين تقديم نماذج فارغة - قم بإصلاحه

# كتابة الاختبارات
> اكتب اختبارات وحدات لوظائف الآلة الحاسبة

# إعادة هيكلة الكود
> أعد هيكلة وحدة المصادقة لاستخدام async/await

# عمليات Git
> قم بالتزام تغييرات مع رسالة وصفية
> أنشئ طلب سحب لهذه الميزة
```

## الاستخدام المتقدم

### الأنابيب والبرمجة النصية

يتبع Claude Code فلسفة Unix، ويدعم الأنابيب والعمليات البرمجية:

```bash theme={null}
# مراقبة السجلات وإرسال تنبيه تلقائي
tail -f app.log | claude -p "إذا تم اكتشاف استثناء، أعلمني"

# ترجمة النصوص الجديدة تلقائيًا
claude -p "إذا كان هناك نصوص جديدة، ترجمها إلى الفرنسية وأنشئ طلب سحب"

# مراجعة الكود
git diff main | claude -p "راجع هذه التغييرات"
```

### مرجع متغيرات البيئة

فيما يلي متغيرات البيئة الشائعة التي يدعمها Claude Code:

| المتغير                      | الوصف                                                            |
| ---------------------------- | ---------------------------------------------------------------- |
| `ANTHROPIC_AUTH_TOKEN`       | قيمة رأس Authorization المخصصة (تتم إضافة بادئة Bearer تلقائيًا) |
| `ANTHROPIC_API_KEY`          | مفتاح واجهة برمجة التطبيقات (يتم إرساله كعنوان X-Api-Key)        |
| `ANTHROPIC_BASE_URL`         | عنوان URL الأساسي لواجهة برمجة التطبيقات                         |
| `ANTHROPIC_MODEL`            | تجاوز النموذج الافتراضي                                          |
| `ANTHROPIC_SMALL_FAST_MODEL` | نموذج بمستوى Haiku (للمهام الخلفية)                              |
| `MAX_THINKING_TOKENS`        | تعيين ميزانية توكن التفكير (تعيين إلى 0 لتعطيل وضع التفكير)      |
| `DISABLE_COST_WARNINGS`      | تعيين إلى 1 لتعطيل تحذيرات التكلفة                               |

### ذاكرة المشروع CLAUDE.md

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

```markdown theme={null}
# وصف المشروع
هذا مشروع كامل المكدس باستخدام Django + Vue.js.

## معايير الترميز
- استخدام Python 3.12
- اتباع نمط كود PEP 8
- يجب كتابة اختبارات وحدات لجميع واجهات برمجة التطبيقات
```

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

### ماذا أفعل إذا فشلت الاتصال؟

1. تحقق من أن ملف `~/.claude/config.json` تم إنشاؤه بشكل صحيح، ومحتواه هو `{"primaryApiKey": "self"}`
2. تأكد من أن متغيرات البيئة تم تعيينها بشكل صحيح:
   ```bash theme={null}
   echo $ANTHROPIC_AUTH_TOKEN
   echo $ANTHROPIC_BASE_URL
   ```
3. تأكد من أن رمز API صالح (يمكنك التحقق منه في [اللوحة](https://platform.acedata.cloud/console))
4. حاول إعادة تشغيل الطرفية

### الأمر غير موجود: claude

إذا ظهرت رسالة `command not found` بعد التثبيت، يرجى المحاولة:

1. أغلق وأعد فتح الطرفية
2. تحقق من PATH: `echo $PATH`
3. أعد التثبيت: `curl -fsSL https://claude.ai/install.sh | bash`

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

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

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

* 📖 [الوثائق الرسمية لـ Claude Code CLI](https://code.claude.com/docs/en/quickstart)
* 📋 [مرجع أوامر CLI](https://code.claude.com/docs/en/cli-reference)
* 🔧 [خدمة Claude Code من AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 إذا كان لديك أي استفسارات، لا تتردد في الاتصال بنا عبر خدمة العملاء في المنصة