كلود كود سلسلة دروس 6: كيفية المصادقة - تسجيل الدخول عبر المتصفح والتكوين اليدوي لمفتاح API

عملية المصادقة: تسجيل الدخول عبر المتصفح والتكوين اليدوي لمفتاح API

بعد تثبيت كلود كود، تحتاج إلى المصادقة لاستخدامه. يجب ربط الأداة بحسابك في Anthropic. هناك طريقتان للربط: تسجيل الدخول عبر المتصفح والتكوين اليدوي لمفتاح API. كلا الطريقتين تؤديان لنفس النتيجة، اختر ما يناسبك.

الطريقة الأولى: تسجيل الدخول عبر المتصفح (موصى به)

يوفر كلود كود أمر مصادقة تلقائي claude login، يفتح المتصفح لتفويض الوصول عبر صفحة ويب، ثم يكتب بيانات الاعتماد تلقائيًا في الطرفية.

خطوات العمل:

1. في الطرفية، أدخل:

bash claude login

1. سيعرض النظام رسالة ويفتح تلقائيًا صفحة تفويض Anthropic في متصفحك الافتراضي.
   إذا لم يتم فتحها تلقائيًا، ستظهر رسالة في الطرفية تحتوي على رابط، يمكنك نسخه وفتحه في المتصفح يدويًا.

2. سجل الدخول إلى حسابك في Anthropic في المتصفح (إذا كنت مسجلاً بالفعل، ستطلب الصفحة التفويض مباشرة).

3. انقر على "سماح" أو "تفويض"، ستظهر الصفحة رسالة "تم التفويض بنجاح، يمكنك إغلاق هذه الصفحة".

4. ارجع إلى الطرفية، سترى رسالة تفيد باكتمال المصادقة. الآن عند تشغيل الأمر claude، سيكون مرتبطًا بحسابك.

الطريقة الثانية: التكوين اليدوي لمفتاح API

إذا كنت تستخدم خادمًا بدون واجهة رسومية، أو حاوية، أو لا ترغب في استخدام تفويض المتصفح، يمكنك الحصول على مفتاح API من لوحة تحكم Anthropic وتكوينه في كلود كود.

الخطوات:

1. افتح المتصفح، وانتقل إلى https://console.anthropic.com، وسجل الدخول إلى حسابك في Anthropic.

2. اذهب إلى صفحة API Keys (عادة في الإعدادات أو خيارات المطور)، وانقر على "إنشاء مفتاح API".

3. أعط المفتاح اسمًا (مثل claude-code-local)، ثم انسخه فورًا بعد الإنشاء.
   ملاحظة: يظهر المفتاح مرة واحدة فقط، إذا أغلقت الصفحة فلن تراه مرة أخرى. إذا نسيت حفظه، احذف القديم وأنشئ واحدًا جديدًا.

4. ارجع إلى الطرفية، هناك طريقتان لتزويد كلود كود بالمفتاح:

أ. طريقة متغير البيئة:

bash export ANTHROPIC_API_KEY=مفتاح-api-الخاص-بك

أضف هذا السطر إلى ملف ~/.bashrc أو ~/.zshrc ليصبح ساري المفعول تلقائيًا في كل جلسة.

ب. طريقة كتابة المفتاح في ملف الإعدادات:

يقرأ كلود كود أيضًا ملف الإعدادات الخاص به. قم بتحرير ~/.claude/config.json (إذا لم يكن موجودًا، أنشئه)، واكتب:

json { "apiKey": "مفتاح-api-الخاص-بك" }

ملاحظة: يُوصى بتعيين صلاحيات الملف إلى 600 (chmod 600 ~/.claude/config.json) لمنع المستخدمين الآخرين من قراءته.

1. اختبر الاتصال:

bash claude "مرحبًا، أرجو الرد بـ 'موافق'"

إذا تلقيت ردًا طبيعيًا، فهذا يعني أن المفتاح تم تكوينه بنجاح.

الأخطاء الشائعة في التكوين اليدوي:

• هل يبدأ المفتاح بـ sk-ant- أو sk-؟ لا، مفتاح API الخاص بـ Anthropic يبدأ بـ sk-ant-api03- وهو سلسلة طويلة. عند النسخ، تأكد من عدم فقدان أي حرف.
• إذا قمت بتعيين متغير البيئة والملف معًا، فمتغير البيئة له أولوية أعلى. احتفظ بواحد فقط لتجنب الارتباك.
• المفتاح هو بيانات اعتماد مدفوعة، لا تقم بإضافته إلى مستودع Git. يُوصى بإضافة الدليل ~/.claude أو ملف الإعدادات إلى .gitignore.

تبديل الحساب أو تسجيل الخروج

لتبديل الحساب أو مسح بيانات الاعتماد المحلية:

• إذا كنت تستخدم claude login: نفذ claude logout، ثم أعد claude login.
• إذا قمت بتكوين المفتاح يدويًا: احذف المفتاح القديم من متغير البيئة أو ملف الإعدادات، واستبدله بالمفتاح الجديد.

اختبار المصادقة

claude "اشرح ما يفعل الدليل الحالي"

إذا تمكن من قراءة ملخص مشروعك، فهذا يعني أن البيئة جاهزة.