لم تتم ترجمة هذا المقال إلى هذه اللغة بعد؛ تشاهد النسخة الفارسية.

متوسط

وصل کردن یه CLI agent (مثل aider) به بنفش

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

اگه به‌جای این‌که خودت پرامپت بزنی می‌خوای یه agent مستقیم روی فایل‌های پروژه‌ت کار کنه — بخونه، ویرایش کنه، دیف بده — و می‌خوای اون agent از بنفش استفاده کنه، این مقاله برای توئه. فرض می‌کنیم api-quickstart رو خوندی و یه کلید API داری. تا آخرش، یه CLI agent (با مثال مشخص aider) روی بنفش کار می‌کنه.

چیزی که همه‌ی این ابزارها مشترک دارن

اکثر CLI agentهای امروزی (aider، و خیلی از پلاگین‌های سازگار با OpenAI) دو تا چیز از تو می‌خوان: یه base URL و یه API key. اگه بشه این دو تا رو دستی ست کرد، بنفش کار می‌کنه — چون endpoint بنفش با فرمت OpenAI سازگاره، دقیقاً همون‌طور که تو api-quickstart دیدی.

هر دو مقدار رو از صفحه‌ی «اتصال به ابزارها» بگیر: آدرس سرویس رو از همون‌جا کپی کن (محیط به محیط فرق می‌کنه)، و کلیدت رو هم همون‌جا می‌سازی.

مثال مشخص: aider

aider از دو متغیر محیطی برای اتصال به یه provider سازگار با OpenAI استفاده می‌کنه:

bash
export OPENAI_API_BASE=YOUR_SERVICE_URL
export OPENAI_API_KEY=YOUR_API_KEY
aider --model openai/YOUR_MODEL_ID

YOUR_SERVICE_URL همون آدرس سرویسیه که از صفحه‌ی «اتصال به ابزارها» کپی کردی، و YOUR_API_KEY همون کلیدته. پیشوند openai/ جلوی اسم مدل رو aider لازم داره تا بفهمه از یه provider سفارشی داره استفاده می‌کنه، نه از OpenAI مستقیم. YOUR_MODEL_ID رو با شناسه‌ی یکی از مدل‌های فعال عوض کن — از <ModelList /> یا از همون صفحه‌ی «اتصال به ابزارها» بردار. (این مسیر مستقیم به gateway می‌زنه، پس مدل «auto»ی چت مرورگر اینجا جواب نمی‌ده — باید یه شناسه‌ی واقعی بدی.)

⚠️ این پیکربندی هنوز روی خودِ aider اجرا و تست نشده. قبل از این‌که برای کار جدی روش حساب کنی، خودت یه بار با یه پروژه‌ی کوچیک امتحانش کن — اگه جواب نداد، مقاله‌ی «رفع اشکال اتصال» رو ببین.

الگوی کلی برای بقیه‌ی ابزارها

اگه ابزارت aider نیست، دنبال همین دو تا فیلد بگرد — معمولاً یکی از این اسم‌هاست:

  • OPENAI_API_BASE / OPENAI_BASE_URL / یه فیلد به اسم "Base URL" یا "API Endpoint"
  • OPENAI_API_KEY / یه فیلد به اسم "API Key"

اگه ابزارت این دو فیلد رو داره، همون مقدارهای بالا رو بذار توش. اگه ابزارت این‌ها رو نداره — یعنی فقط یه provider ثابت (مثلاً فقط OpenAI یا فقط Anthropic) رو پشتیبانی می‌کنه — نمی‌تونی به بنفش وصلش کنی.

نکته‌ی مهم درباره‌ی Claude Code

این مقاله فرمت OpenAI-compatible رو توضیح می‌ده (aider و اکثر CLI agentها). Claude Code یه فرمت جدا داره (Anthropic Messages، متغیرهای ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN) که این‌جا پوشش داده نمی‌شه — کارت مخصوص Claude Code تو «اتصال به ابزارها» رو ببین، همون‌جا آماده و کپی‌شدنیه.

چی کار نمی‌کنه

  • می‌تونی برای این agent یه کلید جدا بسازی (تا ده‌تا کلید فعال، هر کدوم با اسم و سقف مصرف مخصوص خودش) — از «اتصال به ابزارها» بساز. اگه یه ابزار رو با یه کلید نشتی راه انداختی، همون یکی رو باطل کن؛ بقیه دست‌نخورده می‌مونن. جزئیاتش تو «هایجین کلید».
  • این مسیر (مستقیم به gateway، بدون رد شدن از چت بنفش) هم به کیف پولت گیت شده — فقط با یه سقف روی gateway، نه چک لحظه‌ای مثل چت. جزئیاتش تو «کنترل مصرف و هزینه» هست.

الأسئلة الشائعة

غیر از aider، ابزار دیگه‌ای هم همین‌جوری وصل می‌شه؟
هر CLI agent که بذاره یه base URL و API key سازگار با OpenAI رو دستی تنظیم کنی، همین دو مقدار رو لازم داره — الگو یکیه، فقط اسم متغیرها فرق می‌کنه.
می‌تونم Claude Code رو هم همین‌جوری وصل کنم؟
با همین متغیرها نه — Claude Code فرمت Anthropic (ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN) می‌خواد، نه OPENAI_API_BASE/OPENAI_API_KEY. بنفش این فرمت رو هم پیاده کرده؛ کارت Claude Code تو «اتصال به ابزارها» پیکربندی کامل رو بهت می‌ده.