پرش به مطلب اصلی

اتصال Claude Code به چابکان

Claude Code چیست؟​

Claude Code یک عامل برنامه‌نویسی مبتنی بر هوش مصنوعی است که در ترمینال و محیط توسعه اجرا می‌شود. این ابزار می‌تواند ساختار پروژه را بررسی کند، درباره کد توضیح بدهد، تغییر چندفایلی پیشنهاد کند، تست و فرمان‌های توسعه را اجرا کند و در رفع خطا یا بازنویسی کد کمک کند. برخلاف یک چت‌بات عمومی، Claude Code context پروژه و نتیجه ابزارهای محلی را وارد چرخه حل مسئله می‌کند.

اتصال Claude Code به هوش مصنوعی چابکان برای توسعه‌دهندگانی مناسب است که رابط و گردش‌کار Claude Code را می‌خواهند، اما قصد دارند مدل و مصرف API را از سرویس چابکان مدیریت کنند. Claude Code از قرارداد Anthropic Messages استفاده می‌کند و درگاه چابکان این قرارداد را در مسیر /v1/messages ارائه می‌دهد.

کاربردهای رایج​

  • شناخت سریع یک codebase و پیدا کردن محل پیاده‌سازی قابلیت‌ها؛
  • تولید، اصلاح و refactor کد با مشاهده diff؛
  • نوشتن تست و تحلیل خطاهای build یا lint؛
  • ساخت مستندات فنی از روی کد؛
  • اجرای کارهای چندمرحله‌ای با تأیید کاربر.

Claude Code مجوز فایل و terminal را روی دستگاه شما مدیریت می‌کند؛ API Key چابکان فقط مجوز فراخوانی مدل است. پیش از تأیید هر فرمان یا ویرایش، هدف و محدوده آن را بررسی کنید.

پیش‌نیازها​

  • یک سرویس فعال، اعتبار مثبت و API Key طبق راهنمای آماده‌سازی
  • شناسه یک مدل قابل استفاده از پنل
  • Node.js نسخه ۱۸ یا جدیدتر برای روش نصب npm

۱. نصب Claude Code​

در macOS، Linux یا WSL ویندوز اجرا کنید:

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

برای بررسی وضعیت نصب نیز می‌توانید اجرا کنید:

claude doctor

۲. تنظیم اتصال در macOS، Linux و WSL​

در همان ترمینالی که Claude Code را اجرا می‌کنید، این متغیرها را تنظیم کنید:

export ANTHROPIC_BASE_URL="https://ai.chabokan.net"
export ANTHROPIC_AUTH_TOKEN="sk-chbk-کلید-واقعی-شما"
export ANTHROPIC_MODEL="anthropic/شناسه-مدل-انتخابی"
export ANTHROPIC_SMALL_FAST_MODEL="anthropic/شناسه-مدل-انتخابی"

مقدار دو متغیر مدل باید شناسه دقیق موجود در پنل باشد. لازم نیست حتماً با مثال بالا شروع شود؛ هر مدل سازگار و مجاز در پلن را می‌توانید انتخاب کنید.

چرا Base URL بدون /v1 است؟

Claude Code خودش /v1/messages را اضافه می‌کند. اگر https://ai.chabokan.net/v1 وارد کنید، ممکن است درخواست به مسیر اشتباه /v1/v1/messages برود.

۳. تنظیم اتصال در PowerShell ویندوز​

این متغیرها برای پنجره فعلی PowerShell هستند:

$env:ANTHROPIC_BASE_URL = "https://ai.chabokan.net"
$env:ANTHROPIC_AUTH_TOKEN = "sk-chbk-کلید-واقعی-شما"
$env:ANTHROPIC_MODEL = "anthropic/شناسه-مدل-انتخابی"
$env:ANTHROPIC_SMALL_FAST_MODEL = "anthropic/شناسه-مدل-انتخابی"

سپس Claude Code را از همان پنجره اجرا کنید.

۴. اجرای اولین درخواست​

cd /path/to/your/project
claude

در محیط Claude Code بنویسید:

فایل‌های پروژه را بررسی کن و فقط معماری کلی را توضیح بده. هیچ فایلی را تغییر نده.

برای آزمایش غیرتعاملی:

claude -p "فقط بنویس: اتصال چابکان برقرار است"

۵. تنظیم دائمی اختیاری​

Claude Code می‌تواند متغیرها را از ~/.claude/settings.json بخواند:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.chabokan.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-chbk-کلید-واقعی-شما",
    "ANTHROPIC_MODEL": "anthropic/شناسه-مدل-انتخابی",
    "ANTHROPIC_SMALL_FAST_MODEL": "anthropic/شناسه-مدل-انتخابی"
  }
}

این فایل حاوی راز است؛ دسترسی فایل را محدود کنید و آن را در مخزن پروژه قرار ندهید. برای محیط‌های تیمی، secret manager یا متغیر محیطی ترجیح دارد.

بررسی نهایی​

بعد از یک پاسخ موفق، در پنل چابکان زبانه گزارش درخواست‌ها را باز کنید. مسیر درخواست باید messages و وضعیت آن موفق باشد.

منابع: نصب Claude Code، تنظیم LLM Gateway