> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# استخدم Claude Code مع CometAPI

> استخدم هذا الدليل لتهيئة Claude Code مع CometAPI عبر بيانات اعتماد متوافقة مع Anthropic، وإعدادات base URL، وmodel ID الخاصة بـ Claude.

استخدم هذا الدليل لربط [Claude Code](https://code.claude.com/docs/en/overview) بـ CometAPI.

المراجع الرسمية:

* [نظرة عامة على Claude Code](https://code.claude.com/docs/en/overview)
* [البدء باستخدام Claude Code](https://code.claude.com/docs/en/getting-started)

<Note>
  يتغير توفر النماذج بمرور الوقت. للاطلاع على model ID الحالية الخاصة بـ Claude، راجع
  [صفحة النماذج في CometAPI](/ar/overview/models).
</Note>

## المتطلبات الأساسية

* مفتاح CometAPI من [لوحة التحكم](https://www.cometapi.com) الخاصة بك (يبدأ بـ `sk-`)
* تثبيت Git
* نظام تشغيل مدعوم: macOS أو Linux أو Windows

## تثبيت Claude Code

<Steps>
  <Step title="شغّل المُثبّت الرسمي">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://claude.ai/install.sh | bash
        ```
      </Tab>

      <Tab title="Homebrew">
        ```bash theme={null}
        brew install --cask claude-code
        ```
      </Tab>

      <Tab title="Windows">
        PowerShell:

        ```powershell theme={null}
        irm https://claude.ai/install.ps1 | iex
        ```

        CMD:

        ```batch theme={null}
        curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
        ```

        <Info>يتطلب Windows تثبيت [Git for Windows](https://git-scm.com/downloads/win) أولاً.</Info>
      </Tab>
    </Tabs>
  </Step>

  <Step title="تحقق من التثبيت">
    ```bash theme={null}
    claude --version
    ```
  </Step>
</Steps>

## تهيئة نقطة نهاية CometAPI

أنشئ ملف الإعدادات أو حرّره:

* macOS / Linux: `~/.claude/settings.json`
* Windows: `%USERPROFILE%\.claude\settings.json`

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
```

استبدل `sk-your-cometapi-key` بمفتاح CometAPI الفعلي الخاص بك، ثم شغّل Claude Code:

```bash theme={null}
cd your-project
claude
```

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

<AccordionGroup>
  <Accordion title="لا يتم تطبيق settings.json">
    1. أعد تشغيل الطرفية بالكامل عبر إغلاق جميع النوافذ ثم فتحها مرة أخرى.
    2. إذا استمرت المشكلة، أنشئ `~/.claude.json` وأضف:

    ```json theme={null}
    {
      "hasCompletedOnboarding": true
    }
    ```

    3. كحل بديل، صدّر متغيرات البيئة مباشرةً:

    ```bash theme={null}
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
    export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
    export ANTHROPIC_BASE_URL="https://api.cometapi.com"
    ```
  </Accordion>

  <Accordion title="Invalid API Key أو Please run /login">
    تأكد من أن `~/.claude/settings.json` موجود وأن تنسيق JSON صالح، من دون فواصل زائدة في النهاية ومع علامات اقتباس صحيحة. تحقّق منه عبر [jsonlint.com](https://jsonlint.com).
  </Accordion>

  <Accordion title="يتم استخدام بيانات اعتماد رسمية مخزنة مؤقتًا">
    يعطي Claude Code أولوية لبيانات الاعتماد الرسمية المخزنة مؤقتًا. شغّل `/logout` داخل Claude Code، ثم أغلقه وأعد تشغيله.

    إذا استمر الفشل، احذف ملف المصادقة المخزن مؤقتًا:

    ```bash theme={null}
    rm -rf ~/.config/claude-code/auth.json
    ```
  </Accordion>

  <Accordion title="تُظهر الحالة offline">
    يتحقق Claude Code من الاتصال عبر Google. تعني `offline` أن Google غير قابل للوصول. هذا لا يؤثر على استخدام CometAPI.
  </Accordion>

  <Accordion title="يفشل Fetch أو التصفح عبر الويب">
    تستدعي ميزة Fetch في Claude Code خدمة Anthropic الأصلية أولًا، وهذا يتطلب وصولًا مباشرًا إلى الإنترنت. قد تكون هناك حاجة إلى proxy على مستوى النظام.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-code#howto",
        "name": "استخدام Claude Code مع CometAPI",
        "description": "استخدم هذا الدليل لتهيئة Claude Code مع CometAPI من خلال بيانات اعتماد متوافقة مع Anthropic، وإعدادات base URL، وmodel ID الخاصة بـ Claude.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-1",
            "position": 1,
            "name": "مراجعة المتطلبات المسبقة",
            "text": "أكمل خطوة مراجعة المتطلبات المسبقة في دليل استخدام Claude Code مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-2",
            "position": 2,
            "name": "تثبيت Claude Code",
            "text": "أكمل خطوة تثبيت Claude Code في دليل استخدام Claude Code مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-3",
            "position": 3,
            "name": "تهيئة نقطة نهاية CometAPI",
            "text": "أكمل خطوة تهيئة نقطة نهاية CometAPI في دليل استخدام Claude Code مع CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "مستندات CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "عمليات التكامل",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "استخدام Claude Code مع CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-code"
          }
        ]
      }
    ]
    }
    `}
</script>