توسعه‌دهندگان

Claude CLI

Claude CLI با API چت‌کیوتی.

در ایران دسترسی مستقیم به سرویس Anthropic اغلب ممکن نیست یا به VPN وابسته است. با ChatQT همان تجربهٔ Claude Code / Claude CLI را روی ترمینال خودتان دارید — درخواست‌ها از طریق api.chatqt.com عبور می‌کنند.

JSON
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CHATQT_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.chatqt.com/api"
  }
}

چرا ChatQT؟

Claude CLI بدون دردسر اتصال.

ما این راهنما را برای توسعه‌دهندگانی نوشته‌ایم که می‌خواهند از ابزار رسمی Anthropic در ترمینال استفاده کنند، اما به‌دلیل محدودیت شبکه یا نیاز مداوم به VPN به دنبال راه‌حل پایدار هستند.

بدون VPN

ترافیک CLI به سرورهای ChatQT در ایران قابل دسترس است؛ نیازی به تونل دائمی به anthropic.com نیست.

دسترسی پایدار

قطع‌شدن‌های مکرر VPN دیگر جریان کدنویسی شما را متوقف نمی‌کند.

پیش‌نیازها

قبل از شروع آماده باشید.

  • ۱ Node.js 18+ برای نصب بستهٔ رسمی Claude Code از npm.
  • ۲ حساب ChatQT و یک کلید API از کنسول.
  • ۳ ترمینال (macOS، Linux یا Windows با WSL). مسیر تنظیمات در ویندوز: %USERPROFILE%\.claude\settings.json

مرحله ۱

نصب Claude CLI (Claude Code)

ابزار رسمی Anthropic برای کار در ترمینال. نام بسته ممکن است به‌روز شود؛ همیشه مستندات Claude Code را برای آخرین دستور نصب ببینید.

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

اگر npm در دسترس نیست، در مستندات Anthropic روش‌های جایگزین (مثلاً Homebrew یا نصب‌گر اختصاصی) را بررسی کنید. پس از نصب، دستور claude باید در PATH شما باشد.

مرحله ۲

پیکربندی Custom Provider

از آنجا که از آدرس سفارشی ChatQT (مشابه OpenRouter) استفاده می‌کنید، متغیرهای محیطی Anthropic را در فایل تنظیمات Claude CLI قرار دهید.

۱) ساخت پوشه و فایل تنظیمات

Bash
mkdir -p ~/.claude
nano ~/.claude/settings.json

۲) مثال settings.json

شناسهٔ دقیق مدل را از console.chatqt.com کپی کنید. مقادیر زیر مطابق آخرین نسل مدل‌های Claude در ChatQT است و ممکن است با اسلاگ کنسول شما یکی باشد.
JSON
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CHATQT_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.chatqt.com/api",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-3.5"
  }
}

ANTHROPIC_AUTH_TOKEN همان کلید API چت‌کیوتی شماست (نه کلید مستقیم Anthropic). ANTHROPIC_BASE_URL باید دقیقاً به آدرس بالا اشاره کند.

۳) جدول متغیرهای مدل

متغیر مدل در ChatQT مثال اسلاگ
ANTHROPIC_DEFAULT_OPUS_MODEL Claude Opus 4.7 anthropic/claude-opus-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL Claude Sonnet 4.6 anthropic/claude-sonnet-4.6
ANTHROPIC_DEFAULT_HAIKU_MODEL Claude Haiku (سریع) anthropic/claude-haiku-3.5

مرحله ۳

تست اتصال

Bash
cd /path/to/your/project
claude

اگر پیکربندی درست باشد، CLI بدون درخواست لاگین مستقیم Anthropic شروع به کار می‌کند و درخواست‌ها از طریق ChatQT ارسال می‌شوند.

خطای ۴۰۱ (Unauthorized)

کلید API را در کنسول بسازید و در ANTHROPIC_AUTH_TOKEN قرار دهید. فاصله یا نقل‌قول اضافه نگذارید.

مدل پیدا نشد

اسلاگ مدل را از کنسول کپی کنید؛ نام نمایشی (مثلاً Opus 4.7) با شناسهٔ API یکی نیست.

اتصال برقرار نمی‌شود

ANTHROPIC_BASE_URL را بررسی کنید: باید https://api.chatqt.com/api باشد.

سوالات متداول

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

آیا این همان Claude رسمی است؟
بله — نرم‌افزار CLI از Anthropic است؛ فقط endpoint و احراز هویت به ChatQT هدایت می‌شود تا از ایران بدون VPN کار کند.
تفاوت با API REST چت‌کیوتی چیست؟
REST API برای ادغام در اپلیکیشن شماست (مستندات API). Claude CLI ابزار تعاملی ترمینال است؛ برای اتوماسیون workflow به راهنمای n8n بروید.
کلید API را کجا نگه دارم؟
فقط در ~/.claude/settings.json روی دستگاه خودتان. آن را commit نکنید و در مخازن عمومی قرار ندهید.
هزینه چگونه محاسبه می‌شود؟
مثل سایر درخواست‌های API — پرداخت به‌ازای مصرف. جدول نرخ در صفحه تعرفه‌ها.

آمادهٔ کدنویسی با Claude هستید؟

کلید API بگیرید، settings.json را تنظیم کنید و در ترمینال claude را اجرا کنید.