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

یه ایجنت خط فرمان وصل کن

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

چی یاد می‌گیری

یاد می‌گیری یه ایجنت خط‌فرمان (مثل aider) رو با الگوی «سازگار با OpenAI» وصل کنی — یه آدرس سرویس و یه کلید که خودت دستی وارد می‌کنی. همین الگو برای هر ابزاری که این دو فیلد رو داره کار می‌کنه، نه فقط aider، برای همین یه بار یادش می‌گیری و دیگه هیچ‌وقت گیر نمی‌کنی، حتی اگه ابزار دلخواهت تو هیچ راهنمایی نباشه.

تمرین

از صفحهٔ «کلیدهای API» آدرس سرویس رو از ردیف «ابزارهای سازگار با OpenAI — با /v1» کپی کن، و یه کلید بساز. اگه aider داری:

ini
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 رو با چیزی که از همون صفحه کپی کردی عوض کن. YOUR_MODEL_ID رو از لیست زنده‌ی مدل‌ها بردار — «auto» که تو چت مرورگر می‌بینی اینجا کار نمی‌کنه، باید یه شناسه‌ی واقعی بدی:

  • BGE-M3
  • Claude Haiku 4.5 — حوالي ۱٬۲۴۹ تومان لكل رسالة عادية
  • Claude Opus 5 — حوالي ۶٬۲۴۵ تومان لكل رسالة عادية
  • Claude Opus 5.5 — حوالي ۴٬۹۹۶ تومان لكل رسالة عادية
  • Claude Sonnet 4.6 — حوالي ۳٬۷۴۷ تومان لكل رسالة عادية
  • Claude Sonnet 5 — حوالي ۲٬۴۹۸ تومان لكل رسالة عادية
  • Claude Sonnet 5.5 — حوالي ۲٬۴۹۸ تومان لكل رسالة عادية
  • DeepSeek V4 Flash — حوالي ۷۱ تومان لكل رسالة عادية
  • Embed Multilingual V3
  • Gemini 3.1 Flash Lite — حوالي ۳۵۴ تومان لكل رسالة عادية
  • Gemini 3.1 Pro — حوالي ۲٬۸۱۰ تومان لكل رسالة عادية
  • Gemini 3.5 Flash — حوالي ۲٬۱۰۸ تومان لكل رسالة عادية
  • Gemma 4 26B A4B — حوالي ۸۷ تومان لكل رسالة عادية
  • Gemma 4 31B — حوالي ۱۵۶ تومان لكل رسالة عادية
  • GLM-4.7 Flash — حوالي ۱۱۴ تومان لكل رسالة عادية
  • GLM-5 — حوالي ۱٬۱۶۱ تومان لكل رسالة عادية
  • GPT Oss 120B — حوالي ۴۴ تومان لكل رسالة عادية
  • GPT-6 Astra — حوالي ۱۲٬۴۹۰ تومان لكل رسالة عادية
  • GPT-6 Luna — حوالي ۱۲۵ تومان لكل رسالة عادية
  • GPT-6.1 Sol — حوالي ۲٬۴۹۸ تومان لكل رسالة عادية
  • Grok 4.7 — حوالي ۱٬۸۷۴ تومان لكل رسالة عادية
  • Kimi K2 Thinking — حوالي ۷۹۱ تومان لكل رسالة عادية
  • Kimi K2.6 — حوالي ۹۰۰ تومان لكل رسالة عادية
  • Llama 3.3 70B Turbo — حوالي ۹۷ تومان لكل رسالة عادية
  • Llama 4 Scout 17B 16E — حوالي ۹۴ تومان لكل رسالة عادية
  • Mistral Large 3 — حوالي ۵۵۲ تومان لكل رسالة عادية
  • Mistral Small 3.2 24B Instruct — حوالي ۷۰ تومان لكل رسالة عادية
  • Multilingual E5 Large
  • Qwen3 235B A22B Instruct — حوالي ۱۲۹ تومان لكل رسالة عادية
  • Qwen3 Coder 480B A35B Turbo — حوالي ۲۹۷ تومان لكل رسالة عادية
  • Qwen3 Embedding 8B
  • Qwen3 VL 30B A3B — حوالي ۱۶۶ تومان لكل رسالة عادية
  • Qwen3.5 397B A17B — حوالي ۶۸۱ تومان لكل رسالة عادية
  • Qwen3.6 35B A3B — حوالي ۱۹۶ تومان لكل رسالة عادية
  • Qwen3.8 Max — حوالي ۱٬۵۵۰ تومان لكل رسالة عادية
  • Titan Embed Text V2

اگه ابزارت aider نیست، دنبال همین دو فیلد بگرد — معمولاً اسمشون یکیه از: OPENAI_API_BASE/OPENAI_BASE_URL یا یه فیلد «Base URL»، و OPENAI_API_KEY یا یه فیلد «API Key». همون دو مقدار رو بذار توشون.

بعد از ایجنت بخواه یه فایل تو مخزنت رو برات توضیح بده. اگه جواب گرفتی، وصلی. اگه خواستی، چند دقیقه بعد یه نگاه هم به «مصرف» بنداز: شاید عدد ستون «توکن» تو ردیف «کد و ابزارها (IDE/CLI)» بالا رفته باشه — ولی اگه عوض نشده بود نگران نباش، گاهی دیر می‌رسه یا صفر می‌مونه.

این تمرین معمولاً یه کم از سهم اشتراک کدنویسی‌ات یا یه مبلغ کوچیک از کیف پولت (پرداخت به‌اندازه‌ی مصرف) می‌گیره.

کی تمومه؟

  • ایجنت یه فایل تو مخزنت رو توضیح داد، بدون این‌که کلیدی تو یه فایلی که git ردش رو داره تایپ شده باشه.
  • می‌تونی بگی کدوم متغیر محیطی آدرس سرویس رو حمل می‌کنه.

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

این الگو فقط برای ابزارهایی کار می‌کنه که صریحاً «سازگار با OpenAI» باشن و یه فیلد base URL و API key دستی بدن — ابزاری که آدرس یه provider رو تو خودش هاردکد کرده نمی‌تونی وصلش کنی. Claude Code فرمت جدایی داره (Anthropic Messages)؛ این الگو روش کار نمی‌کنه — کارت مخصوص Claude Code تو «کلیدهای API» رو ببین.

می‌تونی برای این ایجنت چند تا کلید جدا بسازی، هر کدوم با اسم و سقف خودش — اگه یه کلید جایی نشتی کرد، فقط همون یکی رو باطل کن، بقیه دست‌نخورده می‌مونن. از «کلیدهای API» بساز؛ جزئیاتش تو «امنیت کلید API»ه.

عادت ارزون‌نگه‌داشتن

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