Skip to main content
Claude Code هو أداة CLI من Anthropic للبرمجة الوكيلية. يوضح هذا الدليل كيفية تشغيله عبر Venice للحصول على وصول مجهول الهوية ومدفوع لكل token إلى نماذج Claude.

ادفع لكل token

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

نماذج Claude

الوصول إلى نماذج Opus وSonnet وFable الحالية عبر Venice

Prompt Caching

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

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

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

الاعتراض

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

التحويل

يحوّل طلبات Anthropic Messages إلى تنسيق المحادثة المتوافق مع OpenAI في Venice

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

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

​
المتطلبات

حساب Venice

مع اعتمادات Venice

Node.js

v22 أو أعلى

Claude Code

مثبَّت عبر npm

​
الإعداد

1

ثبّت Claude Code أو حدّثه

ثبّت أحدث إصدار من Claude Code CLI:
2

ثبّت Claude Code Router

3

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

ولِّد مفتاحًا من venice.ai/settings/api. ستضيفه إلى CCR في الخطوة التالية.
4

أضف Venice كمزوّد

ابدأ واجهة الإدارة في CCR:
في صفحة Providers، اختر Add provider ثم Other / custom API endpoint. أدخل:
  • الاسم: Venice
  • نقطة نهاية API: https://api.venice.ai/api/v1
  • مفتاح API: مفتاح Venice API الخاص بك
ينبغي أن يكتشف CCR بروتوكول OpenAI Chat تلقائيًا. إذا لم يفعل ذلك، افتح Advanced settings، وأوقف الاكتشاف التلقائي للبروتوكول، واختر OpenAI Chat.استخدم Search models أو Custom models لإضافة نماذج Claude التي تريدها، ثم شغّل Check Connection واحفظ المزوّد. يرسل فحص الاتصال طلبًا حقيقيًا بحد إخراج قدره token واحد.
5

أنشئ ملف تعريف Claude Code

في Agent Config، اختر Add profile ثم Claude Code:
  • سمِّ ملف التعريف Claude Code - Venice.
  • أبقِ Effect scope مضبوطًا على Only opened from CCR أثناء الاختبار.
  • اختر CLI only أو CLI & APP.
  • عيّن Model إلى نموذج Venice مثل Venice/claude-opus-4-8.
  • لإبقاء كل مستويات Claude Code على Venice، عيّن حقول نماذج Fable وOpus وSonnet وHaiku الاختيارية إلى نماذج Venice أيضًا.
احفظ ملف التعريف.
6

الإطلاق والتحقق

أطلق ملف التعريف بالاسم:
في Claude Code:
  1. شغّل /context وتأكد من أن نافذة السياق تطابق النموذج المحدد. بالنسبة إلى claude-opus-4-8، ينبغي أن تُظهر 1M.
  2. شغّل /model إذا أردت التبديل إلى نموذج Venice آخر؛ تُميَّز متغيرات 1M بعلامة 1M context.
  3. أرسل رسالة اختبار، ثم تحقق من Request logs في CCR للتأكد من أنها استخدمت Venice.

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

يتغير الكتالوج بمرور الوقت. استخدم Search models في CCR أو GET /models?type=text للحصول على القائمة والحدود الحالية.
Claude Code مُحسَّن لنماذج Claude. بينما قد تعمل النماذج الأخرى المتاحة عبر Venice (GPT و DeepSeek و Grok وغيرها)، لا يمكننا ضمان تجربة مكافئة لأن Claude Code يعتمد على ميزات خاصة بـ Claude مثل التفكير الممتد. للنماذج الأخرى، فكّر في استخدام Venice API القياسية.

​
تحديث تثبيت موجود

حدّث CCR قبل استكشاف أخطاء تثبيت موجود وإصلاحها:
تخزّن إصدارات CCR الحالية التكوين الفعلي في ~/.claude-code-router/config.sqlite. يتم استيراد ملف config.json الأقدم عندما لا تكون قاعدة البيانات موجودة. بعد الترحيل، أجرِ التغييرات عبر ccr ui بدلًا من الاستمرار في تعديل config.json. إذا كانت هناك عملية خلفية لا تزال تعمل بعد التحديث، أعد تشغيلها:

​
Prompt Caching

يعمل Venice prompt caching مع علامات الكاش الأصلية لـ Claude Code. لا حاجة إلى مُحوِّل كاش إضافي للإعداد العادي.

​
استكشاف الأخطاء وإصلاحها

  1. حدّث CCR بـ npm install -g @musistudio/claude-code-router@latest.
  2. أطلق جلسة Claude Code جديدة من ملف تعريف CCR.
  3. شغّل /model واختر إدخال Venice المميَّز بعلامة 1M context.
  4. شغّل /context وتأكد من أن النافذة هي 1M وليست 200K.
قد لا تعرض إصدارات CCR الأقدم نافذة السياق الصحيحة أو استخدام الـ tokens لـ Claude Code.
تأكد من وجود Node.js 22 أو أحدث وحدّث CCR:
استخدم ccr serve للتشغيل في المقدمة وإظهار خطأ بدء التشغيل الأصلي. يشير تتبع الخطأ Cannot read properties of undefined (reading 'error') الصادر من server.logger.error إلى تثبيت CCR قديم؛ حدّثه قبل مواصلة التحقيق.
ابدأ البوابة وتحقق من سلامتها:
فشل فحص السلامة يعني أن بوابة CCR المحلية غير متاحة؛ ولم يصل الطلب إلى Venice.
افتح ccr ui وأجرِ التغيير هناك. تخزّن إصدارات CCR الحالية التكوين في config.sqlite؛ أما config.json فهو مجرد مصدر ترحيل للتثبيتات الأقدم.

​
الموارد

وثائق Venice API

مرجع API الكامل

claude-code-router

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

إصدارات CCR

الإصدارات الحالية وملاحظات الإصدار