Claude Code

قم بإعداد Claude Code مع CometAPI: ثبّت عبر أداة التثبيت الرسمية، واضبط ANTHROPIC_AUTH_TOKEN و ANTHROPIC_BASE_URL في settings.json، وعالج المشكلات الشائعة.

استخدم هذا الدليل لربط Claude Code بـ CometAPI.

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

• نظرة عامة على Claude Code
• البدء مع Claude Code

يتغير توفر النماذج بمرور الوقت. للحصول على معرّفات نماذج Claude الحالية، راجع صفحة نماذج CometAPI.

​

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

• مفتاح CometAPI من لوحة التحكم الخاصة بك (يبدأ بـ sk-)
• تثبيت Git
• أنظمة التشغيل المدعومة: macOS أو Linux أو Windows

​

تثبيت Claude Code

1. تشغيل أداة التثبيت الرسمية

   macOS / Linux

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

   Homebrew

   brew install --cask claude-code
   

   Windows

   PowerShell:

   irm https://claude.ai/install.ps1 | iex
   

   CMD:

   curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   

   يتطلب Windows تثبيت Git for Windows أولاً.
2. التحقق من التثبيت

   claude --version
   

​

تكوين نقطة نهاية CometAPI

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

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

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}

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

cd your-project
claude

​

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

settings.json لا يتم تطبيقه؟

1. أعد تشغيل الطرفية بالكامل (أغلق جميع النوافذ ثم افتحها مجددًا)
2. إذا استمرت المشكلة، أنشئ ~/.claude.json وأضف:
   {
     "hasCompletedOnboarding": true
   }
   
3. كحل بديل، صدّر متغيرات البيئة مباشرة:
   # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
   export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
   export ANTHROPIC_BASE_URL="https://api.cometapi.com"
   

Invalid API Key أو Please run /login؟

تحقق من أن ~/.claude/settings.json موجود وأن تنسيق JSON صالح (من دون فواصل زائدة، وباستخدام علامات اقتباس صحيحة). يمكنك التحقق عبر jsonlint.com.

هل سبق لك تسجيل الدخول إلى الخدمة الرسمية لـ Anthropic؟

يعطي Claude Code أولوية لبيانات الاعتماد الرسمية المخزنة مؤقتًا. شغّل /logout داخل Claude Code، وأغلقه، ثم أعد تشغيله. إذا استمرت المشكلة:

rm -rf ~/.config/claude-code/auth.json

هل الحالة تظهر offline؟

يتحقق Claude Code من الاتصال عبر Google. ظهور offline يعني فقط أن Google غير متاح — وهذا لا يؤثر على استخدام CometAPI.

هل تفشل ميزة Fetch / تصفح الويب؟

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