API Hop

الوثائق

وثائق API Hop

تكامل Claude Code

استخدم نقطة نهاية API Hop المتوافقة مع Claude Messages في Claude Code.

يستدعي Claude Code النماذج عبر بروتوكول Anthropic Messages. اضبط ANTHROPIC_BASE_URL على Base URL المتوافق مع Anthropic المعروض في هذه الصفحة.

يدعم المزود Claude Sonnet 4.6 (claude-sonnet-4-6)، لكنه غير منشور حاليا على API Hop. وليس خيار تكامل افتراضيا نشطا. قبل استدعاء أي نموذج، أكد الوصول من خلال استجابة GET https://api.apihop.ai/v1/models الخاصة بك.

text
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

المتطلبات المسبقة

جهز مفتاح API Hop API صالحا أولا. سيكتب المفتاح في بيئة الطرفية المحلية لديك. لا تضعه في المستودعات أو السجلات أو لقطات الشاشة.

تثبيت Claude Code

في macOS / Linux، استخدم مثبت Claude Code الأصلي:

bash
curl -fsSL https://claude.ai/install.sh | bash

إذا ذكر المثبت ~/.local/bin/claude لكن تعذر العثور على claude، فافتح طرفية جديدة أو أضف ~/.local/bin إلى PATH.

لمسارات العمل الأقدم، ما زالت حزمة npm متاحة:

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

لا تستخدم sudo npm install -g @anthropic-ai/claude-code؛ فقد يسبب مشكلات صلاحيات للترقيات اللاحقة.

تحقق من واجهة الأوامر بعد التثبيت:

bash
claude --version
claude doctor

في Windows، يوصى بـGit Bash أو WSL لاستخدام Claude Code. يستطيع PowerShell أيضا ضبط متغيرات البيئة، لكن حفظها الدائم يختلف بحسب الطرفية.

ضبط متغيرات البيئة

تؤثر الإعدادات المؤقتة في جلسة الطرفية الحالية فقط:

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

يستخدم macOS الصدفة zsh افتراضيا. لإعداد دائم، اكتب المتغيرات في ~/.zshrc، ثم شغل source ~/.zshrc كي تقرأها الطرفية الحالية فورا:

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

في Linux مع bash، اكتب المتغيرات نفسها في ~/.bashrc وشغل source ~/.bashrc.

إعدادات Windows PowerShell المؤقتة:

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

الحفظ الدائم على مستوى المستخدم في PowerShell:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_APIHOP_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

افتح جلسة PowerShell جديدة قبل تشغيل claude.

ملف الإعدادات

بدلا من إعداد الصدفة، أنشئ أو عدل ~/.claude/settings.json. إذا كان الملف موجودا بالفعل، فادمج env وmodel في JSON القائم بدلا من استبدال الإعدادات الأخرى:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIHOP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

النماذج المتاحة:

  • claude-fable-5
  • claude-fable-5-1
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-5
  • claude-sonnet-5-5

استخدم GET https://api.apihop.ai/v1/models للنماذج المتاحة حاليا لمفتاح API لديك.

البدء والاختبار

أعد تشغيل Claude Code بعد ضبط متغيرات البيئة، ثم أرسل تعليمة عادية:

bash
claude "Reply exactly OK."

يمكنك أيضا بدء الوضع التفاعلي:

bash
claude

عند التشغيل الأول، قد يطلب Claude Code مظهرا أو تأكيد أمان أو إعداد الطرفية أو تحديد الثقة بالمجلد الحالي. اتبع تعليمات الطرفية.

اختيار نموذج

اضبط نموذجا افتراضيا بمتغير البيئة، أو اختر نموذجا لأمر واحد باستخدام --model:

bash
claude --model claude-sonnet-5-5 "Review this PR"

سلوك نقطة النهاية

يصادق Claude Code باستخدام مفتاح API Hop API المضبوط. تقبل الخدمة أيا من صيغتي المصادقة:

http
x-api-key: YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01

تحافظ الاستجابات على تنسيق Anthropic Messages الأصلي بصيغة JSON أو أحداث SSE. ولا تحول إلى تنسيق OpenAI.

تشخيص المشكلات

  • يجب أن يكون ANTHROPIC_BASE_URL عنوان API Base URL العام المعروض في هذه الصفحة مضافا إليه /anthropic.
  • لا تضمن مسارات نقاط النهاية في ANTHROPIC_BASE_URL؛ يكفي عنوان الأساس المتوافق مع Anthropic.
  • بعد تعديل ~/.zshrc في macOS، شغل source ~/.zshrc أو افتح طرفية جديدة قبل بدء Claude Code.
  • إذا أعاد claude خطأ عدم العثور على الأمر، فأكد وجود موقع التثبيت في PATH؛ ومن المواقع الشائعة ~/.local/bin/claude.
  • إذا أبلغ claude doctor عن متغيرات بيئة مفقودة، فشغل echo $ANTHROPIC_BASE_URL وecho $ANTHROPIC_MODEL في الطرفية نفسها لتأكيد تحميلها.
  • إذا تلقيت 401، فأكد صلاحية مفتاح API.
  • إذا كان النموذج غير متاح، فأكد أن اسمه من قائمة النماذج المتاحة أعلاه.
  • أعد تشغيل عملية Claude Code بعد تغيير متغيرات البيئة.
  • POST https://api.apihop.ai/anthropic/v1/messages: نقطة نهاية متوافقة مع Anthropic Messages.