راهنمای عیب‌یابی و تشخیص 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 در ظرفیت کامل است. با backoff نمایی (2^n ثانیه با jitter) دوباره تلاش کنید.
• Timeout: درخواست از timeout 60 ثانیه‌ای گذشت. promptهای بزرگ را تکه کنید یا 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: وقتی بانک می‌خواهد، کد پیامک یا تأیید اپ بانک را انجام دهید.
• تلاش‌های مکرر: یک‌بار دیگر تلاش کنید، سپس از بانک بپرسید. فقط صادرکننده کارت می‌تواند دلیل رد را توضیح دهد.

4. پرسش‌های متداول و اصلاحات سریع

پ: «Claude می‌گوید نشست من منقضی شده، اما همین الان وارد شدم»

ج: کوکی نشست به IP و اثر انگشت دستگاه وابسته است. تغییر سریع IP نشست را باطل می‌کند. راه‌حل: 2FA را فعال کنید تا درخواست‌های تأیید مجدد کمتر شود، در هر نشست IP ثابت نگه دارید.

پ: «API برای promptهای جدید پاسخ کش‌شده برمی‌گرداند»

ج: Prompt Cache با محتوای ناخواسته تطبیق داده است. راه‌حل: شناسه یکتا یا timestamp به prompt اضافه کنید تا cache miss اجبار شود: {prompt} [request_id: {Date.now()}].

پ: «WebRTC با وجود پروکسی IP واقعی من را نشان می‌دهد»

ج: WebRTC برای اتصال peer از پروکسی عبور می‌کند. راه‌حل: WebRTC را در تنظیمات مرورگر کاملاً غیرفعال کنید یا از افزونه WebRTC Control برای مسدود کردن درخواست‌های STUN استفاده کنید.

پ: «حساب ناگهان تأیید تلفن می‌خواهد»

ج: به‌دلیل تغییر IP، ورود از دستگاه جدید، یا فعالیت مشکوک فعال می‌شود. راه‌حل: از سرویس تأیید SIM فیزیکی واقعی استفاده کنید، بلافاصله پس از تأیید 2FA را وصل کنید تا دوباره درخواست نشود.