خانه → راهنماها → Base URL انتروپیک برای Claude Code: تنظیم درست ANTHROPIC_BASE_URL

Base URL انتروپیک برای Claude Code: تنظیم درست ANTHROPIC_BASE_URL

Claude Code به هر نشانی‌ای که ANTHROPIC_BASE_URL نشان دهد وصل می‌شود. تنها قاعده‌ای که بسیاری را به دردسر می‌اندازد: فقط میزبان را بدون /v1 می‌خواهد — درست برعکسِ تقریباً همهٔ ابزارهای سبک OpenAI.

پاسخ کوتاه

پیش از اجرای Claude Code دو متغیر محیطی را تنظیم کنید:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

نشانی رسمی Anthropic برابر https://api.anthropic.com است و برای استفاده از یک واسط کافی است همین را عوض کنید. Claude Code خودش /v1/messages را اضافه می‌کند، پس base URL باید در میزبان تمام شود. در این درگاه، ۸۸٪ کل ترافیک Claude در ۳۰ روز گذشته از Claude Codeای آمد که دقیقاً همین‌طور تنظیم شده بود.

کجا تنظیم کنیم

macOS / Linux — در شِلی که آن را از آن اجرا می‌کنید:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — فقط برای پنجرهٔ فعلی:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — تا هر جلسه بدون دست زدن به شِل از آن استفاده کند:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

این مقدار هنگام شروع Claude Code خوانده می‌شود. اگر تغییرش دادید، خارج شوید و جلسهٔ تازه باز کنید؛ جلسهٔ باز همچنان نشانی قدیمی را به کار می‌برد. ANTHROPIC_AUTH_TOKEN به‌صورت Authorization: Bearer و ANTHROPIC_API_KEY به‌صورت x-api-key فرستاده می‌شود. این درگاه هر دو را می‌پذیرد؛ فقط یکی را به کار ببرید.

آزمایش با یک فرمان

پیش از اینکه به Claude Code شک کنید، نشانی و کلید را مستقیم بررسی کنید:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

پاسخ JSON یعنی هر دو درست‌اند. text/html یا 404 یعنی نشانی اشتباه است؛ 401 در قالب JSON یعنی نشانی درست و کلید نادرست است.

چه زمانی /v1 اضافه کنیم و چه زمانی نه

دو خانوادهٔ SDK نشانی را در دو نقطهٔ متفاوت تقسیم می‌کنند. کلاینت‌های سبک Anthropic خودشان /v1/messages را اضافه می‌کنند؛ کلاینت‌های سبک OpenAI انتظار دارند /v1 در base URL باشد و فقط /chat/completions را اضافه می‌کنند:

کلاینت	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

اگر در Claude Code مقدار /v1 را بگذارید، درخواست‌ها به /v1/v1/messages می‌روند و 404 برمی‌گردد. اگر در Cursor آن را جا بیندازید، به /chat/completions می‌روند — باز هم 404. هیچ‌کدام به API نمی‌رسند.

خطای نشانی یا خطای کلید؟

• خطا هست اما در گزارش مصرف چیزی نیست ← مسیر اشتباه است. 404 در لبهٔ شبکه پاسخ داده می‌شود و هرگز به صورتحساب نمی‌رسد. اول /v1 را بررسی کنید.
• 401 با یک ردیف در گزارش ← کلید اشتباه، باطل‌شده یا موجودی تمام شده است.
• یک مدل 404 می‌دهد در حالی که بقیه با همان کلید کار می‌کنند ← آن مدل به گروه دیگری تعلق دارد. هر کلید فقط به یک گروه وصل است؛ برای آن گروه کلید دوم بسازید.
• تغییر انگار اثری ندارد ← متغیر در شِل دیگری تنظیم شده، یا جلسه پیش از تنظیم آن آغاز شده است.

انتخاب مدل

نام مدل‌ها رشته‌هایی دقیق با خط تیره‌اند، نه نقطه — claude-fable-5-1، نه claude-fable-5.1. هنگام اجرا مشخص کنید یا درون جلسه با /model عوض کنید:

claude --model claude-opus-5-5

نام‌ها و قیمت‌های فعلی در فهرست قیمت آمده است. تنظیم کلاینت‌های دیگر در شروع سریع و برنامهٔ دسکتاپ Claude در راهنمای برنامه‌های دسکتاپ آمده است.

شروع به استفاده کنید

بدون اشتراک، بدون حداقل ماهانه، بدون تماس فروش. با USDT شارژ کنید و فقط به‌اندازهٔ مصرف بپردازید — 1 USDT برابر 2 اعتبار موجودی API است.

راهنمای 30 ثانیه‌ای شروع سریع را بخوانید

زبان: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

قیمت‌های این صفحه به‌طور خودکار از داده‌های واقعی صورتحساب پر می‌شوند. شرایط اشخاص ثالث از مستندات خودشان نقل شده است.