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

# Claude Code

> استخدم Claude Code CLI مع نماذج Claude من Venice AI

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

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

  <Card title="نماذج Claude" icon="microchip">
    الوصول إلى Opus 4.5/4.6 و Sonnet 4.5/4.6 عبر 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">
    يلتقط طلبات Claude Code الصادرة قبل أن تصل إلى Anthropic
  </Step>

  <Step title="التحويل" icon="arrows-rotate">
    يحوّل تنسيق الطلب ويعيّن معرّفات النماذج (مثل `claude-opus-4-5`)
  </Step>

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

***

## المتطلبات

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

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

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

***

## الإعداد

<Steps>
  <Step title="ثبّت Claude Code">
    إذا لم تكن قد فعلت ذلك بالفعل، ثبّت أداة Claude Code CLI من Anthropic:

    ```bash theme={"dark"}
    npm install -g @anthropic-ai/claude-code
    ```
  </Step>

  <Step title="ثبّت الـ Router">
    ```bash theme={"dark"}
    npm install -g @musistudio/claude-code-router
    ```
  </Step>

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

  <Step title="أنشئ التكوين">
    أنشئ مجلد التكوين:

    ```bash theme={"dark"}
    mkdir -p ~/.claude-code-router
    ```

    ثم أنشئ `~/.claude-code-router/config.json` بمحررك المفضل:

    ```bash theme={"dark"}
    # Using nano
    nano ~/.claude-code-router/config.json

    # Or using VS Code
    code ~/.claude-code-router/config.json
    ```

    الصق التكوين التالي:

    ```json theme={"dark"}
    {
      "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
      }
    }
    ```

    <Note>
      إذا قمت بتعديل `config.json` أثناء تشغيل الـ router، أعد تشغيله بـ `ccr restart` لتطبيق التغييرات.
    </Note>
  </Step>

  <Step title="الإطلاق">
    ابدأ الـ router، ثم Claude Code:

    ```bash theme={"dark"}
    ccr start
    ccr code
    ```

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

    ```bash theme={"dark"}
    eval "$(ccr activate)" && claude
    ```
  </Step>
</Steps>

***

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

| النموذج              | معرّف 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`    | تكرار سريع، برمجة يومية         |

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

***

## ميزات الـ Router

يوفر الـ router العديد من الميزات المفيدة بخلاف التوجيه الأساسي:

<AccordionGroup>
  <Accordion title="تبديل النماذج فورًا">
    استخدم أمر `/model` داخل Claude Code للتبديل بين النماذج دون إعادة التشغيل:

    ```
    /model venice,claude-sonnet-4-5
    ```

    مفيد عندما تريد Opus للمهام المعقدة و Sonnet للتكرارات السريعة.
  </Accordion>

  <Accordion title="التكوين البصري مع وضع UI">
    تفضّل واجهة رسومية؟ قم بتشغيل محرر التكوين المعتمد على الويب:

    ```bash theme={"dark"}
    ccr ui
    ```

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

  <Accordion title="سيناريوهات الـ Router موضّحة">
    يتحكم قسم تكوين `Router` بأي نموذج يتعامل مع أنواع المهام المختلفة:

    | السيناريو     | متى يُستخدم                                              |
    | ------------- | -------------------------------------------------------- |
    | `default`     | الطلبات العامة                                           |
    | `think`       | المهام التي تتطلب استدلالًا كثيفًا (Plan Mode)           |
    | `background`  | العمليات الخلفية                                         |
    | `longContext` | عندما يتجاوز السياق `longContextThreshold` من الـ tokens |

    يمكنك توجيه سيناريوهات مختلفة إلى نماذج مختلفة. على سبيل المثال، استخدم Sonnet للمهام الخلفية لتوفير التكاليف.
  </Accordion>

  <Accordion title="التصحيح بالسجلات">
    إذا لم يكن هناك شيء يعمل، تحقق من السجلات:

    ```bash theme={"dark"}
    # 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"` في تكوينك للحصول على إخراج أكثر تفصيلًا.
  </Accordion>
</AccordionGroup>

***

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

يعمل [Venice prompt caching](/guides/features/prompt-caching) جنبًا إلى جنب مع علامات الكاش الأصلية لـ Claude Code. تكتشف Venice تلقائيًا عندما يرسل Claude Code حقول `cache_control` وتُعدِّل استراتيجية التخزين المؤقت وفقًا لذلك.

| السيناريو               | TTL للكاش  | من يتحكم             |
| ----------------------- | ---------- | -------------------- |
| الافتراضي (موصى به)     | 5 دقائق    | Claude Code + Venice |
| مع مُحوِّل `cleancache` | ساعة واحدة | Venice فقط           |

<AccordionGroup>
  <Accordion title="متى لا تستخدم cleancache (معظم المستخدمين)">
    يتيح التكوين الافتراضي للنظامين التعاون:

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

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

  <Accordion title="متى تستخدم cleancache">
    أضف `cleancache` إلى المُحوِّل إذا كنت:

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

    ```json theme={"dark"}
    "transformer": {
      "use": ["anthropic", "cleancache"]
    }
    ```

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

***

## الموارد

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

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