الانتقال إلى المحتوى الرئيسي
Claude Code هو أداة CLI من Anthropic للبرمجة الوكيلية. يوضح هذا الدليل كيفية تشغيله عبر Venice AI للحصول على وصول مدفوع لكل token إلى Claude Opus 4.5/4.6 و Sonnet 4.5/4.6.

ادفع لكل token

لا اشتراك. ادفع فقط مقابل ما تستخدمه

نماذج Claude

الوصول إلى Opus 4.5/4.6 و Sonnet 4.5/4.6 عبر Venice

Prompt Caching

يعمل Venice caching جنبًا إلى جنب مع Claude Code

​
لماذا تحتاج إلى Router

يتصل Claude Code مباشرة بـ Anthropic API بشكل افتراضي. لاستخدامه مع Venice، تحتاج إلى claude-code-router، وكيل محلي مفتوح المصدر يقوم بـ:

الاعتراض

يلتقط طلبات Claude Code الصادرة قبل أن تصل إلى Anthropic

التحويل

يحوّل تنسيق الطلب ويعيّن معرّفات النماذج (مثل claude-opus-4-5)

إعادة التوجيه

يعيد توجيه الطلبات إلى Venice على api.venice.ai/api/v1/chat/completions

​
المتطلبات

حساب Venice

مع اعتمادات API

Node.js

v18 أو أعلى

Claude Code

مثبَّت عبر npm

​
الإعداد

1

ثبّت Claude Code

إذا لم تكن قد فعلت ذلك بالفعل، ثبّت أداة Claude Code CLI من Anthropic:
npm install -g @anthropic-ai/claude-code
2

ثبّت الـ Router

npm install -g @musistudio/claude-code-router
3

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

ولِّد مفتاحًا من venice.ai/settings/api. ستلصقه مباشرة في ملف التكوين في الخطوة التالية.
4

أنشئ التكوين

أنشئ مجلد التكوين:
mkdir -p ~/.claude-code-router
ثم أنشئ ~/.claude-code-router/config.json بمحررك المفضل:
# Using nano
nano ~/.claude-code-router/config.json

# Or using VS Code
code ~/.claude-code-router/config.json
الصق التكوين التالي:
{
  "APIKEY": "",
  "LOG": true,
  "LOG_LEVEL": "info",
  "API_TIMEOUT_MS": 600000,
  "HOST": "127.0.0.1",
  "Providers": [
    {
      "name": "venice",
      "api_base_url": "https://api.venice.ai/api/v1/chat/completions",
      "api_key": "your-venice-api-key-here",
      "models": [
        "claude-opus-4-5",
        "claude-sonnet-4-5",
        "claude-opus-4-6",
        "claude-opus-4-6-fast",
        "claude-sonnet-4-6"
      ],
      "transformer": {
        "use": ["anthropic"]
      }
    }
  ],
  "Router": {
    "default": "venice,claude-opus-4-5",
    "think": "venice,claude-opus-4-5",
    "background": "venice,claude-opus-4-5",
    "longContext": "venice,claude-opus-4-5",
    "longContextThreshold": 100000
  }
}
إذا قمت بتعديل config.json أثناء تشغيل الـ router، أعد تشغيله بـ ccr restart لتطبيق التغييرات.
5

الإطلاق

ابدأ الـ router، ثم Claude Code:
ccr start
ccr code
أو استخدم طريقة التفعيل:
eval "$(ccr activate)" && claude

​
النماذج المدعومة

النموذجمعرّف Veniceالأنسب لـ
Claude Opus 4.5claude-opus-4-5استدلال معقد، إعادة هيكلة كبيرة
Claude Sonnet 4.5claude-sonnet-4-5تكرار سريع، برمجة يومية
Claude Opus 4.6claude-opus-4-6استدلال معقد، إعادة هيكلة كبيرة
Claude Opus 4.6 Fastclaude-opus-4-6-fastاستدلال معقد بزمن استجابة أقل
Claude Sonnet 4.6claude-sonnet-4-6تكرار سريع، برمجة يومية
Claude Code مُحسَّن لنماذج Claude. بينما قد تعمل النماذج الأخرى المتاحة عبر Venice (GPT و DeepSeek و Grok وغيرها)، لا يمكننا ضمان تجربة مكافئة لأن Claude Code يعتمد على ميزات خاصة بـ Claude مثل التفكير الممتد. للنماذج الأخرى، فكّر في استخدام Venice API القياسية.

​
ميزات الـ Router

يوفر الـ router العديد من الميزات المفيدة بخلاف التوجيه الأساسي:
استخدم أمر /model داخل Claude Code للتبديل بين النماذج دون إعادة التشغيل:
/model venice,claude-sonnet-4-5
مفيد عندما تريد Opus للمهام المعقدة و Sonnet للتكرارات السريعة.
تفضّل واجهة رسومية؟ قم بتشغيل محرر التكوين المعتمد على الويب:
ccr ui
يفتح هذا واجهة متصفح لتحرير config.json دون لمس الملف مباشرة.
يتحكم قسم تكوين Router بأي نموذج يتعامل مع أنواع المهام المختلفة:
السيناريومتى يُستخدم
defaultالطلبات العامة
thinkالمهام التي تتطلب استدلالًا كثيفًا (Plan Mode)
backgroundالعمليات الخلفية
longContextعندما يتجاوز السياق longContextThreshold من الـ tokens
يمكنك توجيه سيناريوهات مختلفة إلى نماذج مختلفة. على سبيل المثال، استخدم Sonnet للمهام الخلفية لتوفير التكاليف.
إذا لم يكن هناك شيء يعمل، تحقق من السجلات:
# Server logs (HTTP, API calls)
~/.claude-code-router/logs/ccr-*.log

# Application logs (routing decisions)
~/.claude-code-router/claude-code-router.log
عيّن "LOG_LEVEL": "debug" في تكوينك للحصول على إخراج أكثر تفصيلًا.

​
سلوك التخزين المؤقت

يعمل Venice prompt caching جنبًا إلى جنب مع علامات الكاش الأصلية لـ Claude Code. تكتشف Venice تلقائيًا عندما يرسل Claude Code حقول cache_control وتُعدِّل استراتيجية التخزين المؤقت وفقًا لذلك.
السيناريوTTL للكاشمن يتحكم
الافتراضي (موصى به)5 دقائقClaude Code + Venice
مع مُحوِّل cleancacheساعة واحدةVenice فقط
يتيح التكوين الافتراضي للنظامين التعاون:
  • يرسل Claude Code علامات cache_control الأصلية
  • تضيف Venice التخزين المؤقت حولها بـ TTL مدته 5 دقائق
  • يتشارك النظامان حد الـ 4 كتل للكاش
يعمل هذا جيدًا لجلسات البرمجة النشطة حيث تقوم بطلبات متكررة.
أضف cleancache إلى المُحوِّل إذا كنت:
  • تواجه أخطاء حد الـ 4 كتل للكاش
  • تشهد سلوك تخزين مؤقت غريبًا
  • تفضّل TTL مدته ساعة في Venice للجلسات الأطول
"transformer": {
  "use": ["anthropic", "cleancache"]
}
يزيل هذا علامات كاش Claude Code، مما يمنح Venice التحكم الكامل بـ TTL أطول.

​
الموارد

وثائق Venice API

مرجع API الكامل

claude-code-router

الكود المصدري والمشكلات