دليل استكشاف أخطاء Claude والتشخيص

1. تشخيص فشل تسجيل الدخول (403/429/500)

فشل تسجيل الدخول يُربط عادة بأسباب جذرية محددة وفق رموز حالة HTTP ورسائل الخطأ:

مصفوفة رموز الخطأ

إجراء التشخيص

# 1. Check current IP reputation
curl https://ipinfo.io
# Verify "org" does not show datacenter ASN (AWS, Hetzner, etc.)

# 2. Test DNS resolution
nslookup claude.ai
# Should resolve to Cloudflare IPs (104.18.x.x range)

# 3. Clear browser state completely
# Chrome: Settings → Privacy → Clear browsing data → All time → Cookies, Cache
# Firefox: Settings → Privacy → Clear Data → Everything

# 4. Test login with clean profile
google-chrome --user-data-dir="/tmp/test-profile" --proxy-server="socks5://proxy:1080"

2. استكشاف أخطاء استدعاء API

فشل API يتطلب تشخيصاً منهجياً للشبكة والمصادقة وتحديد المعدل:

أخطاء API الشائعة

• 401 Unauthorized: مفتاح API غير صالح أو ملغى. تحقق من المفتاح في Anthropic Console وأعد توليده عند الحاجة.
• 429 Rate Limit: تجاوزت المنظمة حصة RPM (طلبات في الدقيقة) أو TPM (رموز في الدقيقة). طبّق تحديد معدل من جهة العميل.
• 529 Overloaded: خلفية Anthropic بكامل طاقتها. أعد المحاولة بتراجع أسي (2^n ثانية مع jitter).
• Timeout: الطلب تجاوز مهلة 60 ثانية. قسّم المطالبات الكبيرة أو قلّل max_tokens.

سكربت تصحيح API

#!/usr/bin/env node
const Anthropic = require('@anthropic-ai/sdk');

async function diagnoseAPI() {
  const client = new Anthropic({
    apiKey: process.env.ANTHROPIC_API_KEY,
  });

  try {
    console.log('Testing API connectivity...');
    const response = await client.messages.create({
      model: 'claude-sonnet-4.5-high',
      max_tokens: 100,
      messages: [{ role: 'user', content: 'Hello' }],
    });
    console.log('✓ API key valid, connection successful');
    console.log('Response:', response.content[0].text);
  } catch (error) {
    console.error('✗ API Error:', error.status, error.message);
    if (error.status === 401) console.log('→ Check API key validity');
    if (error.status === 429) console.log('→ Rate limit exceeded, wait 60s');
    if (error.status === 529) console.log('→ Backend overloaded, retry with backoff');
  }
}

diagnoseAPI();

3. السبب الجذري لفشل ربط الدفع

Anthropic لا تتلقى سبب الرفض من البنك، لذا راجع الأسباب المحتملة بالترتيب. دليل طرق الدفع يتضمن القائمة الرسمية الكاملة:

• رفض البطاقة: رصيد غير كافٍ، CVV غير صالح، أو بطاقة منتهية. تأكد أن الرصيد يغطي المبلغ كاملاً.
• نوع بطاقة غير مقبول: Pro وMax يذكران بطاقات ائتمان وخصم فقط، فقد تُرفض البطاقة مسبقة الدفع لذلك وحده. Anthropic لا تنشر BIN المحظورة.
• عدم تطابق العنوان: عنوان الفوترة يجب أن يطابق سجل البنك وبلد إصدار البطاقة، وأن يكون موقع فوترة مؤهل.
• 3D Secure غير مكتمل: أكّد رمز SMS أو مطالبة تطبيق البنك عند طلب البنك ذلك.
• محاولات متكررة: أعد المحاولة مرة واحدة ثم اسأل البنك. فقط جهة الإصدار تشرح سبب الرفض.

4. أسئلة شائعة وإصلاحات سريعة

س: «Claude يقول إن جلستي انتهت لكنني سجّلت الدخول للتو»

ج: cookies الجلسة مرتبطة بـ IP وبصمة الجهاز. تغيّر IP السريع يبطل الجلسة. الحل: فعّل 2FA لتقليل مطالبات إعادة التحقق، وحافظ على IP ثابت لكل جلسة.

س: «API يعيد استجابات مخزّنة لمطالبات جديدة»

ج: Prompt Cache يطابق محتوى غير مقصود. الحل: أضف معرّفاً فريداً أو طابع زمني لإجبار miss للتخزين المؤقت: {prompt} [request_id: {Date.now()}].

س: «WebRTC يعرض IP الحقيقي رغم استخدام البروكسي»

ج: WebRTC يتجاوز البروكسي لاتصالات النظير. الحل: عطّل WebRTC بالكامل في إعدادات المتصفح أو استخدم إضافة WebRTC Control لحجب طلبات STUN.

س: «الحساب فجأة يطلب التحقق بالهاتف»

ج: يُفعَّل بتغيير IP أو دخول من جهاز جديد أو نشاط مشبوه. الحل: استخدم خدمة تحقق SIM فعلية، واربط 2FA فور التحقق لتقليل إعادة المطالبة.