ویرگول
ورودثبت نام
یاسر
یاسر
یاسر
یاسر
خواندن ۳ دقیقه·۴ ساعت پیش

راه‌اندازی Claude Code در ایران با کلید API: سه متغیر، سه اشتباه رایج

می‌خواهید با Claude Code کار کنید، اما اشتراک Claude ندارید و پرداخت بین‌المللی هم از اینجا ساده نیست؟ راه دیگری هست: کلید API یک درگاه سازگار، و پرداخت ریالی. این یادداشت همان راه را قدم به قدم می‌رود، با سه اشتباهی که بیشتر از همه وقت می‌گیرد.

ابزار Claude Code چیست و چرا با کلید API کار می‌کند؟

کلود کد (Claude Code) ابزار خط فرمان Anthropic برای کدنویسی با هوش مصنوعی است. در پوشۀ پروژه اجرا می‌شود، کد را می‌خواند، فایل‌ها را ویرایش می‌کند و دستورها را اجرا می‌کند. برای کار فقط یک نشانی و یک کلید می‌خواهد، و آن نشانی لازم نیست سرور Anthropic باشد.

دال یکی از همین نشانی‌هاست. دال، یک درگاه API هوش مصنوعی است که Claude، Gemini، DeepSeek و چند خانوادۀ دیگر را با یک کلید و پرداخت ریالی در دسترس می‌گذارد. نشانی آن در ایران است، پس درخواست‌های Claude Code بدون تحریم‌شکن و VPN به آن می‌رسد. ثبت‌نام فعلاً با دعوت‌نامه است؛ برای درخواست دسترسی به [email protected] ایمیل بزنید، یا از شبکه‌های اجتماعی و راه‌های تماس صفحۀ تماس با دال استفاده کنید.

نصب

نصب Claude Code با Node.js انجام می‌شود:

npm install -g @anthropic-ai/claude-code

بعد از نصب، دستور claude در خط فرمان در دسترس است. پیش از اجرای آن، سه متغیر بخش بعد را بگذارید؛ بدون آن‌ها اولین دستور با خطا برمی‌گردد.

سه متغیر محیطی

نشانی و کلید را در تنظیمات خود برنامه وارد نمی‌کنید. سه متغیر محیطی می‌گذارید و claude را اجرا می‌کنید. در macOS و Linux:

export ANTHROPIC_BASE_URL=https://dalai.ir export ANTHROPIC_AUTH_TOKEN=sk-YOUR-KEY export ANTHROPIC_MODEL=claude-sonnet-4-5 claude

در ویندوز، همین سه مقدار را در PowerShell می‌گذارید:

$env:ANTHROPIC_BASE_URL="https://dalai.ir" $env:ANTHROPIC_AUTH_TOKEN="sk-YOUR-KEY" $env:ANTHROPIC_MODEL="claude-sonnet-4-5" claude

کلید را از پنل کاربری دال، بخش API Keys، می‌گیرید. با sk- شروع می‌شود و مثل رمز عبور نگه داشته می‌شود.

سه اشتباهی که کار را متوقف می‌کند

یک: مسیر /v1 را به نشانی اضافه نکنید. ابزارهای سازگار با OpenAI نشانی https://dalai.ir/v1 را می‌خواهند، اما Claude Code مسیر را خودش کامل می‌کند. فقط https://dalai.ir را بدهید.

دو: کلید را در ANTHROPIC_AUTH_TOKEN بگذارید، نه در ANTHROPIC_API_KEY.

سه: ANTHROPIC_MODEL را خالی نگذارید. بدون آن، ابزار نام تاریخ‌دار مدل خودش را می‌فرستد و خطای No available channel for model برمی‌گردد. برای کارهای جانبی خود ابزار هم ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 را اضافه کنید: Claude Code برای کارهای سبک یک مدل کوچک صدا می‌زند و نام پیش‌فرض آن هم تاریخ‌دار است.

کدام مدل را انتخاب کنم؟

برای بیشتر کارهای کدنویسی، claude-sonnet-4-5 شروع خوبی است. claude-sonnet-4-6 نسل تازه‌تر Sonnet است و برای کارهای عامل‌محور طولانی ساخته شده. claude-opus-4-6 سخت‌ترین کارها را برمی‌دارد و گران‌تر است، پس فقط وقتی لازم است. claude-haiku-4-5 مدل کوچک کارهای جانبی است. در Claude Code از همین چهار نام استفاده کنید.

هزینۀ Claude Code از کجا می‌آید؟

پیش از رسیدن به کار شما، Claude Code یک دستور سیستمی حدوداً ۳۵٬۰۰۰ توکنی می‌فرستد، پس اولین پیام هر نشست گران‌تر از بقیه است. بخش تکراری این دستور در پیام‌های بعدی معمولاً از حافظۀ موقت (کش) خوانده می‌شود که ارزان‌تر حساب می‌شود.

سه کار ساده هزینه را قابل پیش‌بینی می‌کند. با موجودی نزدیک به صفر شروع نکنید. برای کلیدی که به Claude Code می‌دهید سقف اعتبار بگذارید. بعد از اولین نشست، هزینۀ واقعی خودتان را در Usage Logs ببینید. قیمت هر مدل در صفحۀ مدل‌ها و قیمت‌های دال آمده است.

پرسش‌های رایج

برای Claude Code اشتراک Claude Pro یا Max لازم است؟ نه. با کلید API کار می‌کند و هر درخواست به اندازۀ توکن مصرفی از موجودی کم می‌شود.

با مدل‌های دیگر هم می‌شود Claude Code را به کار برد؟ این ابزار برای خانوادۀ Claude ساخته شده است. برای Qwen، GLM یا DeepSeek، ابزارهایی مثل opencode و Cline مناسب‌ترند.

خطای No available channel for model یعنی چه؟ نام مدل شناخته نشده است؛ معمولاً چون ANTHROPIC_MODEL گذاشته نشده.

راهنمای کامل و به‌روز، با پرسش‌های بیشتر: Claude Code در ایران
دال: ارائه‌دهندۀ برترین مدل‌های هوش مصنوعی
سایت دال: https://dalai.ir
مستندات بیشتر: https://dalai.ir/docs

هوش مصنوعیبرنامه‌نویسیapi
۲
۰
یاسر
یاسر
شاید از این پست‌ها خوشتان بیاید