Claude Code مع Venice | Venice API Docs

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

الإعداد

ثبّت Claude Code

إذا لم تكن قد فعلت ذلك بالفعل، ثبّت أداة Claude Code CLI من Anthropic:

npm install -g @anthropic-ai/claude-code

ثبّت الـ Router

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

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

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

أنشئ التكوين

أنشئ مجلد التكوين:

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 لتطبيق التغييرات.

الإطلاق

ابدأ الـ router، ثم Claude Code:

ccr start
ccr code

أو استخدم طريقة التفعيل:

eval "$(ccr activate)" && claude

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

النموذج	معرّف Venice	الأنسب لـ
Claude Opus 4.5	`claude-opus-4-5`	استدلال معقد، إعادة هيكلة كبيرة
Claude Sonnet 4.5	`claude-sonnet-4-5`	تكرار سريع، برمجة يومية
Claude Opus 4.6	`claude-opus-4-6`	استدلال معقد، إعادة هيكلة كبيرة
Claude Opus 4.6 Fast	`claude-opus-4-6-fast`	استدلال معقد بزمن استجابة أقل
Claude Sonnet 4.6	`claude-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 للتكرارات السريعة.

التكوين البصري مع وضع UI

تفضّل واجهة رسومية؟ قم بتشغيل محرر التكوين المعتمد على الويب:

ccr ui

يفتح هذا واجهة متصفح لتحرير config.json دون لمس الملف مباشرة.

سيناريوهات الـ Router موضّحة

يتحكم قسم تكوين 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 فقط

متى لا تستخدم cleancache (معظم المستخدمين)

يتيح التكوين الافتراضي للنظامين التعاون:

يرسل Claude Code علامات cache_control الأصلية
تضيف Venice التخزين المؤقت حولها بـ TTL مدته 5 دقائق
يتشارك النظامان حد الـ 4 كتل للكاش

يعمل هذا جيدًا لجلسات البرمجة النشطة حيث تقوم بطلبات متكررة.

متى تستخدم cleancache

أضف cleancache إلى المُحوِّل إذا كنت:

تواجه أخطاء حد الـ 4 كتل للكاش
تشهد سلوك تخزين مؤقت غريبًا
تفضّل TTL مدته ساعة في Venice للجلسات الأطول

"transformer": {
  "use": ["anthropic", "cleancache"]
}

يزيل هذا علامات كاش Claude Code، مما يمنح Venice التحكم الكامل بـ TTL أطول.

Guides

Getting Started

Text & Chat

Image & Video

Agents & Integrations

Agent Tooling

Coding Tools

SDKs & Frameworks

Projects

Claude Code

ادفع لكل token

نماذج Claude

Prompt Caching

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

المتطلبات

حساب Venice

Node.js

Claude Code

الإعداد

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

ميزات الـ Router

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

الموارد

وثائق Venice API

claude-code-router

ادفع لكل token

نماذج Claude

Prompt Caching

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

​المتطلبات

حساب Venice

Node.js

Claude Code

​الإعداد

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

​ميزات الـ Router

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

​الموارد

وثائق Venice API

claude-code-router

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

المتطلبات

الإعداد

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

ميزات الـ Router

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

الموارد