Claude Code: إعداد API واختيار النموذج

آخر تحديث: 2026-08-31

يستخدم Claude Code واجهة برمجة تطبيقات Anthropic افتراضياً، لكنه يدعم أيضاً الاتصال بنماذج خارجية مثل DeepSeek عبر واجهات متوافقة. الإعداد الصحيح لـ API هو مفتاح التحكم في التكلفة والجودة.

💡 نصيحة: يدعم Claude Code واجهة برمجة تطبيقات Anthropic أصلاً عبر متغير البيئة ANTHROPIC_API_KEY. النماذج الخارجية تتطلب واجهات متوافقة مع OpenAI.

📋 المتطلبات المسبقة: الفصل 2 - التثبيت والاستخدام

1. ما ستتعلمه


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 للجلسة الحالية والتكلفة المقدرة.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): اضبط مفتاح API لـ Anthropic، شغّل Claude Code وأكّد نجاح الاتصال.
  2. متوسط (⭐⭐): قدّر تكلفة API الشهرية لفريقك (باستخدام السكريبت في المثال).
  3. متقدم (⭐⭐⭐): اضبط تكامل DeepSeek، قارن جودة وتكلفة نفس المهمة بين Claude Sonnet و DeepSeek V3.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%