چگونه کلید API Claude بگیریم (راهنمای 2026)

پاسخ سریع: سه گام تا یک کلید API Claude

برای گرفتن کلید API Claude از Anthropic: در console.anthropic.com حساب بسازید، زیر Plans and billing اعتبار پیش‌پرداخت بخرید (کارت اعتباری یا نقدی لازم است)، سپس Settings را باز کنید، به API Keys بروید و روی Create Key کلیک کنید. کلید با sk-ant- شروع می‌شود و فقط یک بار دقیقاً نمایش داده می‌شود، پس بلافاصله آن را در یک password manager یا متغیر محیطی کپی کنید. دو چیز باعث گیر افتادن افراد می‌شود. اول، اشتراک چت Claude Pro یا Max دسترسی API را شامل نمی‌شود؛ Console یک محصول جداگانه با صورت‌حساب جداگانه است. دوم، درخواست‌ها با خطای اعتبار شکست می‌خورند تا زمانی که واقعاً اعتبار خریده باشید، حتی اگر ساخت خود کلید بدون پرداخت کار کند. اگر اولین فراخوانی شما خطایی درباره موجودی برمی‌گرداند، دلیلش همین است. اگر نمی‌توانید کارت اضافه کنید، یا می‌خواهید یک کلید داشته باشید که هم به Claude برسد هم به خانواده‌های مدل دیگر، یک gateway پیش‌پرداخت جایگزین عملی است. این مسیر در انتهای این راهنما، با ذکر صریح مصالحه‌ها، پوشش داده شده است.

گام 1: ساخت حساب Anthropic Console

Console در console.anthropic.com داشبورد توسعه‌دهنده Anthropic است، و از اپلیکیشن چت claude.ai متمایز است. با یک آدرس ایمیل یا حساب Google ثبت‌نام کنید. Anthropic از شما می‌خواهد در طول onboarding یک شماره تلفن تأیید کنید، و دسترسی API به کشورهای پشتیبانی‌شده محدود است، پس اگر فرآیند ثبت‌نام در این مرحله شما را متوقف کرد، لیست دسترسی Anthropic را بررسی کنید. در طول راه‌اندازی یک سازمان (organization) می‌سازید. کلیدها، اعتبارها، محدودیت‌های نرخ و لاگ‌های مصرف همه متعلق به سازمان هستند نه به ورود شخصی شما. این بعداً وقتی همکاران را دعوت می‌کنید اهمیت دارد: همه یک استخر اعتبار مشترک دارند و ادمین‌ها می‌توانند مصرف را به تفکیک هر کلید ببینند. در این مرحله هنوز هیچ‌چیز پولی نیست. می‌توانید لیست مدل‌ها را مرور کنید، مرجع API را بخوانید و Workbench را باز کنید، یک playground مرورگری برای آزمایش prompt ها روی مدل‌های Claude، پیش از اضافه کردن هر جزئیات صورت‌حساب. Workbench برای بررسی اینکه یک prompt همان‌طور که انتظار دارید رفتار می‌کند، پیش از نوشتن یک خط کد یکپارچه‌سازی مفید است.

گام 2: تنظیم صورت‌حساب پیش از اولین درخواست

API آنتروپیک پیش‌پرداخت است. زیر Plans and billing، یک کارت اضافه کنید و یک بلوک اولیه اعتبار بخرید؛ حداقل خرید کم است، به‌طور تاریخی پنج دلار. هر فراخوانی API از این موجودی با نرخ‌های هر token کم می‌کند، پس در پایان ماه هیچ فاکتور غافلگیرکننده‌ای وجود ندارد. وقتی موجودی به صفر برسد، درخواست‌ها متوقف می‌شوند. دو تنظیم در روز اول ارزش پیکربندی دارند. Auto-reload وقتی موجودی زیر یک آستانه که خودتان تعیین می‌کنید بیفتد، آن را به‌طور خودکار شارژ می‌کند. آن را برای بارهای کاری تولیدی فعال کنید تا موجودی خالی‌شده هرگز به یک outage تبدیل نشود. برای آزمایش‌ها آن را خاموش بگذارید، تا یک حلقه فرار نتواند بیشتر از آنچه عمداً بارگذاری کرده‌اید خرج کند. محدودیت‌های نرخ با سطوح مصرف مقیاس می‌گیرند. سازمان‌های جدید از پایین‌ترین سطح شروع می‌کنند و محدودیت‌های درخواست در دقیقه و token در دقیقه با رشد هزینه تجمعی شما بالا می‌روند. اگر در طول یک ترافیک ناگهانی روی یک حساب جوان پاسخ‌های 429 می‌بینید، معمولاً سیستم سطوح دلیل آن است، نه کد شما.

گام 3: ساخت کلید و اولین فراخوانی شما

در Console، Settings را باز کنید، سپس API Keys، سپس Create Key. به کلید نامی بدهید که اپلیکیشن یا محیطی که به آن تعلق دارد را مشخص کند، چون در نهایت چندین کلید خواهید داشت و کلیدهای بی‌نام قابل بازرسی نخواهند بود. مقدار کامل کلید فقط در زمان ساخت نمایش داده می‌شود؛ پس از بستن دیالوگ، Console فقط یک نسخه کوتاه‌شده نشان می‌دهد. کلید را به‌عنوان یک متغیر محیطی export کنید و پیش از دست زدن به کد اپلیکیشن، از ترمینال تست کنید. دو جزئیات مختص Anthropic افرادی که از provider های دیگر مهاجرت می‌کنند را غافلگیر می‌کند: احراز هویت از یک هدر x-api-key استفاده می‌کند نه Authorization: Bearer، و هر درخواست باید یک هدر anthropic-version داشته باشد. یک هدر version گمشده با یک پیام خطای واضح شکست می‌خورد، پس وقتی چیزی خراب شد بدنه پاسخ را بخوانید.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

امنیت کلید: پنج عادت که از یک هفته بد جلوگیری می‌کند

این عادت‌ها در روز اول ارزان هستند و پس از یک حادثه گران‌قیمت‌اند برای اضافه کردن دوباره. اگر به‌طور تصادفی یک کلید commit کردید، حتی در یک مخزن خصوصی آن را نشت‌شده در نظر بگیرید: لغو کنید، بچرخانید و تاریخچه commit را پاک کنید. اسکنرهای secret مثل gitleaks در یک pre-commit hook این اشتباه را پیش از خروج از دستگاه شما می‌گیرند.

• فقط متغیرهای محیطی یا یک secrets manager. کلیدی که در کد منبع چسبانده شود در نهایت commit می‌شود، و اسکرپرها مخصوصاً مراقب پیشوند sk-ant- در مخازن عمومی هستند.
• یک کلید به ازای هر اپلیکیشن و هر محیط. کلیدهای جداگانه برای development، staging و production لاگ‌های مصرف را قابل خواندن می‌کنند و اجازه می‌دهند یک سطح را بدون خراب کردن بقیه لغو کنید.
• هرگز یک کلید را در کد مرورگر یا موبایل ارسال نکنید. هرچیزی در JavaScript سمت کلاینت به تعریف عمومی است. فراخوانی‌ها را از طریق backend خودتان مسیردهی کنید و کلید را سمت سرور نگه دارید.
• در هر مورد مشکوک به نشت، فوراً لغو کنید. حذف یک کلید در Console بلافاصله آن را می‌کشد؛ اگر اپ باید در طول چرخش فعال بماند، اول کلید جایگزین را بسازید.
• اعلان‌های هزینه تنظیم کنید. یک آستانه هشدار صورت‌حساب، یک کلید نشت‌شده یا در حلقه را از یک فاکتور بزرگ به یک فاکتور کوچک تبدیل می‌کند، و پیکربندی آن هیچ هزینه‌ای ندارد.

یک فراخوانی Claude چقدر هزینه دارد، همراه با گزینه‌های ارزان‌تر نزدیک

Claude به ازای هر token صورت‌حساب می‌شود، با نرخ‌های جداگانه ورودی و خروجی، و token های خروجی در تولید متن طولانی بر فاکتور غالب هستند. هر دو ستون را مقایسه کنید، نه فقط قیمت ورودی سرتیتر. برای مقیاس، جدول زیر Claude را در کنار سایر مدل‌های در دسترس از طریق کاتالوگ gateway توصیف‌شده در بخش بعدی فهرست می‌کند. DeepSeek تقریباً محبوب جامعه برای ترافیک اقتصادی حجم بالا است، و Claude همچنان انتخاب برتر است وقتی کیفیت نثر اولویت باشد.

بدون کارت بانکی؟ یک کلید کارآمد از طریق یک gateway بگیرید

اگر الزام کارت، محدودیت منطقه‌ای، یا خود راه‌اندازی حساب مانع است، APIsRouter مسیر gateway ای است که این سایت مستند می‌کند. این یک gateway سازگار با OpenAI است: پرداخت در /topup بدون ثبت‌نام لازم است، اول پرداخت می‌کنید و کلید از طریق ایمیل می‌رسد. صورت‌حساب پرداخت بر اساس مصرف بدون اشتراک است. مدل‌های جهانی 20% پایین‌تر از قیمت رسمی لیست اجرا می‌شوند، مدل‌های چینی زیر نرخ رسمی خودشان قرار دارند و اولین شارژ شما +100% به موجودی اضافه می‌کند. هر SDK OpenAI را به https://api.apisrouter.com/v1 اشاره دهید و یک شناسه مدل کاتالوگ ارسال کنید: claude-sonnet-4-6 یا claude-opus-4-7 برای خانواده Claude، deepseek-v4-flash یا glm-5 وقتی token های ارزان‌تر از همان کلید می‌خواهید. همان کلید در اپلیکیشن‌های کاربر نهایی هم کار می‌کند. کاربران SillyTavern base URL را که به /v1 ختم می‌شود می‌چسبانند و لیست مدل‌ها به‌طور خودکار از /v1/models پر می‌شود. JanitorAI به endpoint کامل https://api.apisrouter.com/v1/chat/completions به‌علاوه یک نام مدل و کلید نیاز دارد. مصالحه در مقابل یک کلید مستقیم Anthropic صادقانه و ساده است: شما دارید به یک واسطه برای ترافیک خود اعتماد می‌کنید، و ویژگی‌های سمت Anthropic طبق زمان‌بندی gateway می‌رسند. مزیت یک موجودی و یک endpoint در سراسر Claude، GPT، Gemini، DeepSeek و GLM است به‌جای یک حساب صورت‌حساب جداگانه به ازای هر provider.

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # arrives by email after checkout
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)

پرسش‌های پرتکرار