سطر أوامر Claude Code
اربط واجهة Claude Code CLI بـ GetVibe API: ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN واختيار الطراز عبر متغيّرات البيئة.
إعداد جاهز
يُنشأ من كتالوجنا عند الطلب: عنوان API، وكل نموذج منشور مع حدود السياق والإخراج الخاصة به، والإعدادات الموصى بها. لا يحتوي على أي مفتاح. يقرأ Claude Code المفتاح من GETVIBE_API_KEY عبر apiKeyHelper — اضبطه في بيئتك. على Windows دون WSL، اضبط ANTHROPIC_AUTH_TOKEN بدلًا منه.
# macOS / Linux
mkdir -p ~/.claude
curl -fsSL https://getvibeapi.com/api/integrations/claude-code.json -o ~/.claude/settings.json# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/claude-code.json -OutFile "$HOME\.claude\settings.json"- النموذج الرئيسي —
claude-opus-5.5: أقوى نموذج Claude نوفّره عبر /v1/messages. - المهام الصغيرة —
claude-haiku-4.5: أرخص نموذج Claude، يستخدمه Claude Code للمهام الخلفية. - تشغيل البث، ومهلة طلب 600 ثانية، وجهد استدلال medium: الإجابة الاستدلالية الطويلة تستغرق دقائق، وبدون البث تصطدم بحد الانتظار.
- معرّفات النماذج المجرّدة في كل مكان، دون :suffix — فذلك يُبقي التحويل التلقائي عند الفشل إلى قناة سليمة مُفعَّلًا.
?models= مع مُعرّفات مفصولة بفواصل إلى الرابط.Claude Code هي أداة Anthropic الرسمية للبرمجة الوكيلية. تعمل عبر نقطة النهاية /v1/messages بترويسة x-api-key.
1. افتح الطرفية
Windows: ابدأ ← اكتب PowerShell ← Enter. macOS: Terminal (التطبيقات ← الأدوات المساعدة). يتطلّب التثبيت عبر npm وجود Node.js 22 أو أحدث (node --version) — تثبّت الكتلة أدناه واجهة CLI نفسها. أتفضّل عدم استخدام Node.js؟ يعمل برنامج التثبيت الأصلي من Anthropic أيضًا: curl -fsSL https://claude.ai/install.sh | bash (macOS/Linux) أو irm https://claude.ai/install.ps1 | iex (PowerShell)؛ ثم اضبط المتغيرات أدناه في نافذة جديدة.
2. الصق كتلة واحدة واضغط Enter
تثبّت الكتلة الأداة، وتحفظ الإعدادات دائمًا (setx)، وتطبّقها في النافذة الحالية وتشغّل البرنامج. استبدل sk-pv-… بمفتاحك.
Windows (PowerShell)
npm.cmd install -g @anthropic-ai/claude-code
setx ANTHROPIC_BASE_URL "https://getvibeapi.com"
setx ANTHROPIC_AUTH_TOKEN "sk-pv-…"
$env:ANTHROPIC_BASE_URL="https://getvibeapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-pv-…"
$env:ANTHROPIC_API_KEY=""
claude.cmdmacOS / Linux
npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL="https://getvibeapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-pv-…"
export ANTHROPIC_API_KEY=""
claudehttps://getvibeapi.com (من دون /v1): تضيف واجهة CLI اللاحقة بنفسها. يوضع المفتاح في ANTHROPIC_AUTH_TOKEN، ويُترك ANTHROPIC_API_KEY فارغًا: فإذا كان هناك مفتاح Anthropic محفوظ بالفعل على الجهاز، فسيحذّر Claude Code من وجود مفتاحين متعارضين. بعد setx، تُطبَّق الإعدادات في نوافذ PowerShell الجديدة، أما النوافذ المفتوحة مسبقًا فلا تُطبَّق فيها.أين تكتب
بعد التشغيل، السطر الذي يحمل علامة > أسفل النافذة هو مكان الكتابة والضغط على Enter:
+---------------------------------------+
| |
| > _ |
| |
+---------------------------------------+يسأل التشغيل الأول عن السمة (اضغط Enter) وعن الثقة بالمجلد (اختر Yes, I trust this folder). للعمل الفعلي شغّل الأداة من مجلد المشروع.
3. تحقق من الاتصال
أرسل أي رسالة وافتح لوحة التحكم ← الاستخدام: سيظهر سجل جديد يتضمّن النموذج والإنفاق. داخل Claude Code، يعرض /status سطرًا باسم Anthropic base URL — ويجب أن يظهر فيه عنواننا.
اختيار النماذج (اختياري)
افتراضيًا يستخدم Claude Code النموذج الافتراضي من الكتالوج. يمكنك تغييره بمتغيرات البيئة:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
"ANTHROPIC_BASE_URL": "https://getvibeapi.com",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5.5"
}
}إن كنت تفضّل settings.json
يمكن الحصول على النتيجة نفسها باستخدام الملف ~/.claude/settings.json. على Windows: %USERPROFILE%\.claude\settings.json. الصق المفتاح نفسه: لا يستبدل Claude Code المتغيرات مثل $GETVIBE_API_KEY بقيمها داخل settings.json، لذا ستُرسل تلك السلسلة النصية بوصفها المفتاح وسيُرفض الطلب.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
"ANTHROPIC_BASE_URL": "https://getvibeapi.com",
"ANTHROPIC_API_KEY": ""
}
}مشكلات شائعة
| المعلمة | النوع | الوصف |
|---|---|---|
401 | error | تحقّق من قيمة ANTHROPIC_AUTH_TOKEN: يجب أن يحتوي settings.json على المفتاح sk-pv-… نفسه، لا على $variable. |
Requests go to Anthropic | config | لم يصل ANTHROPIC_BASE_URL إلى Claude Code: افتح نافذة جديدة بعد setx، أو اضبط العنوان في settings.json. تحقّق من سطر عنوان URL الأساسي لـ Anthropic في /status. |
404 | error | أُضيف /v1 إلى ANTHROPIC_BASE_URL — المطلوب العنوان الجذري بدون اللاحقة. |
npm.ps1 is blocked | Windows | هذه سياسة تنفيذ PowerShell. استخدم npm.cmd وclaude.cmd كما في الكتلة أعلاه — دون تغيير السياسة. |
"node is not recognized" | Windows | Node.js غير مثبّت، أو أن النافذة فُتحت قبل التثبيت: ثبّت Node.js LTS وافتح نافذة PowerShell جديدة. |
claude native binary not installed / warn install-scripts | npm | تتخطّى إصدارات npm الأحدث خطوة تثبيت Claude Code افتراضيًا. شغّل npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user وثبّت مجددًا، أو استخدم برنامج التثبيت الأصلي. |
Variables are not picked up | config | settings.json أكثر موثوقية من ملفات تعريف الصدفة — خصوصًا على Windows. |