المتطلبات الأساسية وإعداد API

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

البرامج المطلوبة

البرنامج	أي إصدار	الغرض
Python	ما يتطلبه SDK حالياً — راجع README الخاص بالـ SDK	SDK والنصوص البرمجية
Docker	الإصدار المستقر الحالي	بيئة معزولة
Anthropic SDK	الأحدث (pip install anthropic)	عميل API

لماذا بلا أرقام مثبتة؟ الحدود الدنيا للإصدارات تتحرك، والدورة التي تثبّتها تصبح خاطئة خلال إصدار أو اثنين. يعلن SDK حدّه الأدنى من Python بنفسه — وpip يفرضه وسيخبرك إن كان مفسّرك أقدم من اللازم. ثبّت الإصدارات في requirements.txt الخاص بك، لا من جدول في درس.

الحصول على مفتاح API الخاص بك

1. اذهب إلى console.anthropic.com
2. انتقل إلى API Keys
3. أنشئ مفتاحاً جديداً باسم وصفي
4. خزّنه بأمان (لا تودعه في git أبداً)

# تعيين مفتاح API كمتغير بيئة
export ANTHROPIC_API_KEY="sk-ant-..."

تثبيت حزمة Anthropic SDK

# إنشاء بيئة افتراضية
python -m venv venv
source venv/bin/activate  # على Windows: venv\Scripts\activate

# تثبيت SDK
pip install anthropic

التحقق من التثبيت

from anthropic import Anthropic

client = Anthropic()

# اختبار اتصال API
response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=100,
    messages=[{"role": "user", "content": "مرحبا!"}]
)

print(response.content[0].text)

الوصول إلى بيتا استخدام الحاسوب

يتطلب استخدام الحاسوب ترويسة البيتا computer-use-2025-11-24 — وبالتالي نقطة نهاية بيتا:

response = client.beta.messages.create(
    model="claude-sonnet-5",
    max_tokens=4096,
    betas=["computer-use-2025-11-24"],
    # ... باقي المعاملات
)

اعتبارات التكلفة

المكون	عامل التكلفة
لقطات الشاشة	رموز الصور (تتغير حسب الدقة)
استدعاءات الأدوات	رموز الإخراج القياسية
الجلسات الطويلة	استخدام نافذة السياق

⚠ Prices change frequently. The values above are for illustration only and may be out of date. Always verify current pricing directly with the provider before making cost decisions: Anthropic · OpenAI · Google Gemini · Google Vertex AI · AWS Bedrock · Azure OpenAI · Mistral · Cohere · Together AI · DeepSeek · Groq · Fireworks AI · Perplexity · xAI · Cursor · GitHub Copilot · Windsurf.

نصيحة: استخدم دقة 1024x768 أثناء التطوير لتقليل التكاليف. قم بالترقية للإنتاج.

بعد ذلك، سنقوم بإعداد Docker لبيئة تطوير معزولة. :::