> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-de47a659.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> وجّه طلبات Claude Code CLI عبر Venice باستخدام claude-code-router للوصول بالدفع لكل توكن إلى نماذج البرمجة Claude Opus وSonnet وFable.

[Claude Code](https://code.claude.com/docs) هو أداة CLI من Anthropic للبرمجة الوكيلية. يوضح هذا الدليل كيفية تشغيله عبر Venice للحصول على وصول مجهول الهوية ومدفوع لكل token إلى نماذج Claude.

<CardGroup cols={3}>
  <Card title="ادفع لكل token" icon="coins">
    لا اشتراك. ادفع فقط مقابل ما تستخدمه
  </Card>

  <Card title="نماذج Claude" icon="cpu">
    الوصول إلى نماذج Opus وSonnet وFable الحالية عبر Venice
  </Card>

  <Card title="Prompt Caching" icon="bolt">
    يعمل Venice caching جنبًا إلى جنب مع Claude Code
  </Card>
</CardGroup>

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

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

<Steps>
  <Step title="الاعتراض" icon="hand-stop">
    يلتقط طلبات Claude Code الصادرة قبل أن تصل إلى Anthropic
  </Step>

  <Step title="التحويل" icon="refresh">
    يحوّل طلبات Anthropic Messages إلى تنسيق المحادثة المتوافق مع OpenAI في Venice
  </Step>

  <Step title="إعادة التوجيه" icon="route">
    يعيد توجيه الطلبات إلى `api.venice.ai/api/v1/chat/completions`
  </Step>
</Steps>

***

## المتطلبات

<CardGroup cols={3}>
  <Card title="حساب Venice" icon="user" href="https://venice.ai/settings/api?utm_source=venice-api-documentation">
    مع اعتمادات Venice
  </Card>

  <Card title="Node.js" icon="brand-nodejs" href="https://nodejs.org/">
    v22 أو أعلى
  </Card>

  <Card title="Claude Code" icon="terminal" href="https://code.claude.com/docs">
    مثبَّت عبر npm
  </Card>
</CardGroup>

***

## الإعداد

<Steps>
  <Step title="ثبّت Claude Code أو حدّثه">
    ثبّت أحدث إصدار من Claude Code CLI:

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code@latest
    claude --version
    ```
  </Step>

  <Step title="ثبّت Claude Code Router">
    ```bash theme={null}
    npm install -g @musistudio/claude-code-router@latest
    npm list -g @musistudio/claude-code-router --depth=0
    ```
  </Step>

  <Step title="احصل على مفتاح API الخاص بك">
    ولِّد مفتاحًا من [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation). ستضيفه إلى CCR في الخطوة التالية.
  </Step>

  <Step title="أضف Venice كمزوّد">
    ابدأ واجهة الإدارة في CCR:

    ```bash theme={null}
    ccr ui
    ```

    في صفحة **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 واحد.
  </Step>

  <Step title="أنشئ ملف تعريف 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 أيضًا.

    احفظ ملف التعريف.
  </Step>

  <Step title="الإطلاق والتحقق">
    أطلق ملف التعريف بالاسم:

    ```bash theme={null}
    ccr "Claude Code - Venice"
    ```

    في Claude Code:

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

***

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

| النموذج              | معرّف Venice           | السياق |
| -------------------- | ---------------------- | ------ |
| Claude Fable 5.1     | `claude-fable-5-1`     | 1M     |
| Claude Fable 5       | `claude-fable-5`       | 1M     |
| Claude Opus 5        | `claude-opus-5`        | 1M     |
| Claude Opus 5 Fast   | `claude-opus-5-fast`   | 1M     |
| Claude Opus 4.8      | `claude-opus-4-8`      | 1M     |
| Claude Opus 4.8 Fast | `claude-opus-4-8-fast` | 1M     |
| Claude Opus 4.7      | `claude-opus-4-7`      | 1M     |
| Claude Opus 4.6      | `claude-opus-4-6`      | 1M     |
| Claude Opus 4.5      | `claude-opus-4-5`      | 198K   |
| Claude Sonnet 5      | `claude-sonnet-5`      | 1M     |
| Claude Sonnet 4.6    | `claude-sonnet-4-6`    | 1M     |
| Claude Sonnet 4.5    | `claude-sonnet-4-5`    | 198K   |

يتغير الكتالوج بمرور الوقت. استخدم **Search models** في CCR أو [`GET /models?type=text`](/api-reference/endpoint/models/list) للحصول على القائمة والحدود الحالية.

<Info>
  Claude Code مُحسَّن لنماذج Claude. بينما قد تعمل النماذج الأخرى المتاحة عبر Venice (GPT و DeepSeek و Grok وغيرها)، لا يمكننا ضمان تجربة مكافئة لأن Claude Code يعتمد على ميزات خاصة بـ Claude مثل التفكير الممتد. للنماذج الأخرى، فكّر في استخدام [Venice API القياسية](/api-reference/endpoint/chat/completions).
</Info>

***

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

حدّث CCR قبل استكشاف أخطاء تثبيت موجود وإصلاحها:

```bash theme={null}
npm install -g @musistudio/claude-code-router@latest
npm list -g @musistudio/claude-code-router --depth=0
ccr ui
```

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

إذا كانت هناك عملية خلفية لا تزال تعمل بعد التحديث، أعد تشغيلها:

```bash theme={null}
ccr stop
ccr start
```

***

## Prompt Caching

يعمل [Venice prompt caching](/guides/features/prompt-caching) مع علامات الكاش الأصلية لـ Claude Code. لا حاجة إلى مُحوِّل كاش إضافي للإعداد العادي.

***

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

<AccordionGroup>
  <Accordion title="السياق يصل إلى 100% مبكرًا أو يفشل الضغط">
    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.
  </Accordion>

  <Accordion title="ينهار CCR أثناء بدء التشغيل">
    تأكد من وجود Node.js 22 أو أحدث وحدّث CCR:

    ```bash theme={null}
    node --version
    npm list -g @musistudio/claude-code-router --depth=0
    ```

    استخدم `ccr serve` للتشغيل في المقدمة وإظهار خطأ بدء التشغيل الأصلي. يشير تتبع الخطأ `Cannot read properties of undefined (reading 'error')` الصادر من `server.logger.error` إلى تثبيت CCR قديم؛ حدّثه قبل مواصلة التحقيق.
  </Accordion>

  <Accordion title="يبلّغ Claude Code عن ConnectionRefused">
    ابدأ البوابة وتحقق من سلامتها:

    ```bash theme={null}
    ccr start
    curl http://127.0.0.1:3456/health
    ```

    فشل فحص السلامة يعني أن بوابة CCR المحلية غير متاحة؛ ولم يصل الطلب إلى Venice.
  </Accordion>

  <Accordion title="تغييرات التكوين يتم تجاهلها">
    افتح `ccr ui` وأجرِ التغيير هناك. تخزّن إصدارات CCR الحالية التكوين في `config.sqlite`؛ أما `config.json` فهو مجرد مصدر ترحيل للتثبيتات الأقدم.
  </Accordion>
</AccordionGroup>

***

## الموارد

<CardGroup cols={3}>
  <Card title="وثائق Venice API" icon="book" href="/api-reference/api-spec">
    مرجع API الكامل
  </Card>

  <Card title="claude-code-router" icon="brand-github" href="https://github.com/musistudio/claude-code-router">
    الكود المصدري والمشكلات
  </Card>

  <Card title="إصدارات CCR" icon="history" href="https://github.com/musistudio/claude-code-router/releases">
    الإصدارات الحالية وملاحظات الإصدار
  </Card>
</CardGroup>