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

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

لاستخدام Claude Code، يمكنك أولاً زيارة صفحة خدمة Claude Messages والنقر على زر “Acquire” للحصول على الشهادات المطلوبة: إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربة خدمة Claude Code مجانًا.

​
تثبيت Claude Code

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

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

​
طرق التثبيت

يدعم Claude Code عدة طرق للتثبيت: الطريقة الأولى: التثبيت الأصلي (موصى به) macOS / Linux / WSL: 
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell: 
irm https://claude.ai/install.ps1 | iex
Windows CMD: 
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
الطريقة الثانية: Homebrew (macOS / Linux) 
brew install claude-code
الطريقة الثالثة: WinGet (Windows) 
winget install Claude.ClaudeCode
سيقوم التثبيت الأصلي بالتحديث تلقائيًا في الخلفية، مما يحافظ على أحدث إصدار دائمًا.

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

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

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

هناك طريقتان لتكوين متغيرات البيئة، يمكنك اختيار أي منهما. الطريقة الأولى: إعداد في ملف تكوين Shell (موصى به) أضف المحتوى التالي إلى ملف تكوين Shell الخاص بك (~/.zshrc، ~/.bashrc أو ~/.bash_profile)، واستبدل {token} بالتوكن الخاص بك الذي حصلت عليه من لوحة تحكم AceData Cloud: 
# تكوين وكيل Claude Code - AceData Cloud
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
بعد التعديل، نفذ الأمر التالي لتفعيل التكوين: 
source ~/.zshrc  # أو source ~/.bashrc
الطريقة الثانية: إعداد في ملف settings.json لـ Claude Code قم بتحرير ~/.claude/settings.json (إذا لم يكن موجودًا، قم بإنشائه) وأضف تكوين env: 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
تتمثل فائدة هذه الطريقة في أن متغيرات البيئة تؤثر فقط على Claude Code، ولا تؤثر على البرامج الأخرى.
تلميح: يمكنك عرض توكن واجهة برمجة التطبيقات في لوحة تحكم AceData Cloud. سيتم إضافة قيمة ANTHROPIC_AUTH_TOKEN تلقائيًا مع بادئة Bearer عند إرسالها إلى الخادم.

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

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

افتح الطرفية، وانتقل إلى دليل مشروعك، ثم قم بتشغيل: 
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إنشاء التزام Gitclaude commit

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

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

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

# تحليل المشروع
> ماذا يفعل هذا المشروع؟

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

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

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

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

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

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

يتبع Claude Code فلسفة Unix، ويدعم الأنابيب والعمليات البرمجية: 
# مراقبة السجلات وإرسال تنبيه تلقائي
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 بتحميل هذا الملف تلقائيًا عند البدء. 
# وصف المشروع
هذا مشروع كامل المكدس باستخدام Django + Vue.js.

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

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

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

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

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

إذا ظهرت رسالة command not found بعد التثبيت، يرجى المحاولة:
  1. أغلق وأعد فتح الطرفية
  2. تحقق من PATH: echo $PATH
  3. أعد التثبيت: curl -fsSL https://claude.ai/install.sh | bash

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

قم بتسجيل الدخول إلى لوحة تحكم AceData Cloud لرؤية الرصيد المتبقي الحالي لحسابك واستخدامه.

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