Claude Code: إعداد API واختيار النموذج
آخر تحديث: 2026-08-31
يستخدم Claude Code واجهة برمجة تطبيقات Anthropic افتراضياً، لكنه يدعم أيضاً الاتصال بنماذج خارجية مثل DeepSeek عبر واجهات متوافقة. الإعداد الصحيح لـ API هو مفتاح التحكم في التكلفة والجودة.
💡 نصيحة: يدعم Claude Code واجهة برمجة تطبيقات Anthropic أصلاً عبر متغير البيئة
ANTHROPIC_API_KEY. النماذج الخارجية تتطلب واجهات متوافقة مع OpenAI.
📋 المتطلبات المسبقة: الفصل 2 - التثبيت والاستخدام
1. ما ستتعلمه
- إعداد API لـ Anthropic والفوترة
- تكامل DeepSeek والنماذج الخارجية
- استراتيجية اختيار النموذج (Sonnet مقابل Opus)
- تقدير تكلفة API
- إدارة مفاتيح API المتعددة
2. إعداد API لـ Anthropic
(1) الحصول على مفتاح API
BASH
# Steps:
# 1. Visit https://console.anthropic.com/
# 2. Register/login to your account
# 3. Go to the API Keys page
# 4. Click "Create Key"
# 5. Copy the Key (format: sk-ant-api03-xxxxx)
(2) ضبط متغير البيئة
BASH
# Temporary (current terminal only)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"
# Permanent (add to shell config)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc
# Verify
echo $ANTHROPIC_API_KEY
# sk-ant-api03-xxxxx
(3) اختيار النموذج
| النموذج | السياق | سعر الإدخال | سعر الإخراج | حالة الاستخدام |
|---|---|---|---|---|
| Claude Sonnet | 200K | $3/MTok | $15/MTok | البرمجة اليومية، أفضل قيمة |
| Claude Opus | 200K | $15/MTok | $75/MTok | البنية المعقدة، الاستدلال العميق |
| Claude Haiku | 200K | $0.25/MTok | $1.25/MTok | استعلامات سريعة، تكلفة منخفضة |
BASH
# Specify model
claude --model claude-sonnet-4-20250514
claude --model claude-opus-4-20250514
# Or via environment variable
export CLAUDE_MODEL="claude-sonnet-4-20250514"
3. تكامل نموذج DeepSeek
(1) إعداد API لـ DeepSeek
يوفر DeepSeek واجهات متوافقة مع OpenAI قابلة للاستخدام من Claude Code:
BASH
# Set DeepSeek API
export ANTHROPIC_API_KEY="your-deepseek-api-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
# Or use OpenAI compatible endpoint
export OPENAI_API_KEY="your-deepseek-api-key"
export OPENAI_BASE_URL="https://api.deepseek.com/v1"
(2) مقارنة نماذج DeepSeek
| النموذج | السياق | السعر (إدخال/إخراج) | حالة الاستخدام |
|---|---|---|---|
| DeepSeek V3 | 128K | ¥2/MTok / ¥8/MTok | برمجة عامة، قيمة ممتازة |
| DeepSeek R1 | 128K | ¥4/MTok / ¥16/MTok | استدلال عميق، رياضيات/منطق |
▶ مثال 1: سير إعداد DeepSeek الكامل
BASH
# Alice uses DeepSeek to reduce costs
# 1. Get DeepSeek API Key
# Visit https://platform.deepseek.com/
# 2. Configure environment variables
export ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export CLAUDE_MODEL="deepseek-chat"
# 3. Run Claude Code
claude "Help me refactor this function"
4. تقدير التكلفة والتحكم فيها
(1) أنماط استهلاك Token
استهلاك Token في Claude Code يأتي أساساً من:
| المصدر | الحصة | الوصف |
|---|---|---|
| سياق المشروع | 40-60% | قراءة محتويات ملفات المشروع |
| سجل المحادثة | 20-30% | سجلات التفاعل السابقة |
| إخراج الأكواد | 10-20% | الأكواد المُنشأة |
| محفزات النظام | 5-10% | CLAUDE.md والتعليمات الأخرى |
(2) تقدير التكلفة
▶ مثال 2: سكريبت تقدير التكلفة الشهرية
PYTHON
def estimate_monthly_cost(
daily_sessions: int,
avg_context_tokens: int,
avg_output_tokens: int,
model_input_price: float,
model_output_price: float,
working_days: int = 22
):
daily_input = daily_sessions * avg_context_tokens
daily_output = daily_sessions * avg_output_tokens
monthly_input = daily_input * working_days
monthly_output = daily_output * working_days
cost = (
monthly_input * model_input_price / 1_000_000
+ monthly_output * model_output_price / 1_000_000
)
return round(cost, 2)
# Sonnet plan
sonnet_cost = estimate_monthly_cost(
daily_sessions=10,
avg_context_tokens=50000,
avg_output_tokens=5000,
model_input_price=3,
model_output_price=15
)
print(f"Sonnet monthly: ${sonnet_cost}")
# DeepSeek plan
deepseek_cost = estimate_monthly_cost(
daily_sessions=10,
avg_context_tokens=50000,
avg_output_tokens=5000,
model_input_price=0.27,
model_output_price=1.1
)
print(f"DeepSeek monthly: ${deepseek_cost}")
Output:
TEXT
📖 للعرض فقط
Sonnet monthly: $46.2
DeepSeek monthly: $3.74
5. إدارة مفاتيح API المتعددة
▶ مثال 3: تبديل إعدادات API لكل مشروع
BASH
# Configure per project in .env files
# project-a/.env
ANTHROPIC_API_KEY=sk-ant-project-a-key
CLAUDE_MODEL=claude-sonnet-4-20250514
# project-b/.env
ANTHROPIC_API_KEY=sk-deepseek-key
ANTHROPIC_BASE_URL=https://api.deepseek.com
CLAUDE_MODEL=deepseek-chat
# Use direnv for auto-switching
# .envrc
source .env
export ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL
export CLAUDE_MODEL
(2) مراقبة حصة API
BASH
# Check Anthropic API usage
curl https://api.anthropic.com/v1/usage \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"
# Claude Code built-in stats
claude /cost
# Current session token usage: 125,430
# Estimated cost: $2.34
6. مثال شامل: إعداد تحسين التكلفة
BASH
# Alice's cost optimization plan
# Core projects: Use Sonnet (quality first)
export PROJECT_CORE_API_KEY="sk-ant-api03-xxxxx"
export PROJECT_CORE_MODEL="claude-sonnet-4-20250514"
# Auxiliary projects: Use DeepSeek (cost first)
export PROJECT_AUX_API_KEY="sk-deepseek-xxxxx"
export PROJECT_AUX_BASE_URL="https://api.deepseek.com"
export PROJECT_AUX_MODEL="deepseek-chat"
# Configure in shell aliases
alias claude-core='ANTHROPIC_API_KEY=$PROJECT_CORE_API_KEY CLAUDE_MODEL=$PROJECT_CORE_MODEL claude'
alias claude-aux='ANTHROPIC_API_KEY=$PROJECT_AUX_API_KEY ANTHROPIC_BASE_URL=$PROJECT_AUX_BASE_URL CLAUDE_MODEL=$PROJECT_AUX_MODEL claude'
# Usage
cd core-project && claude-core "Refactor authentication module"
cd side-project && claude-aux "Add logging feature"
❓ أسئلة شائعة
س كيف تقارن جودة DeepSeek بـ Claude؟
ج DeepSeek V3 يصل لحوالي 80-90% من مستوى Claude Sonnet في مهام البرمجة، لكنه لا يزال قاصراً في الاستدلال المعقد وفهم السياق الطويل. كافٍ للبرمجة اليومية؛ المهام الحرجة يجب أن تستخدم Claude.
س ماذا لو سُرّب مفتاح API الخاص بي؟
ج ألغِ المفتاح فوراً في وحدة التحكم وأنشئ واحداً جديداً. تحقق من سجل git من المفاتيح المُلتزمة عرضياً.
س كم تدوم الأرصدة المجانية؟
ج يمنح Anthropic الحسابات الجديدة $5 كرصيد، يدعم حوالي 50-100 جلسة برمجة متوسطة التعقيد بأسعار Sonnet.
س هل يمكنني تهيئة عدة APIs في وقت واحد؟
ج نعم. بدّل بين المشاريع عبر متغيرات البيئة، أو استخدم direnv للتبديل التلقائي.
س هل طول سياق DeepSeek كافٍ؟
ج DeepSeek V3 يدعم سياق 128K، كافٍ لمعظم المشاريع. المشاريع الكبيرة جداً (100+ ملف) قد تحتاج 200K من Claude.
س كيف أعرف استهلاك Token الحالي؟
ج اكتب
/cost في Claude Code لرؤية استهلاك Token للجلسة الحالية والتكلفة المقدرة.📖 ملخص
- إعداد API لـ Anthropic عبر متغير البيئة
ANTHROPIC_API_KEY - Sonnet يقدم أفضل قيمة، Opus للاستدلال المعقد، Haiku للاستعلامات السريعة
- DeepSeek يتصل عبر واجهة متوافقة مع OpenAI بتكلفة 1/10 من Claude
- استهلاك Token أساساً من سياق المشروع (40-60%)
- تبديل إعدادات API المتعددة عبر متغيرات البيئة والأسماء المستعارة
📝 تمارين
- أساسي (⭐): اضبط مفتاح API لـ Anthropic، شغّل Claude Code وأكّد نجاح الاتصال.
- متوسط (⭐⭐): قدّر تكلفة API الشهرية لفريقك (باستخدام السكريبت في المثال).
- متقدم (⭐⭐⭐): اضبط تكامل DeepSeek، قارن جودة وتكلفة نفس المهمة بين Claude Sonnet و DeepSeek V3.