ملف إعدادات Aider لمفتاح API الخاص بك: .aider.conf.yml وWindows setx

متغيران، OPENAI_API_BASE وOPENAI_API_KEY، ووسيطة نموذج مثل openai/<model id> تكفي لتوجيه Aider إلى CheapTokens. الأساسيات خطوة بخطوة (التثبيت، أول طلب، 401/404/400/402) موجودة في كيفية ربط Aider بـ CheapTokens؛ تغطي هذه الصفحة ما يغفله ذلك الدليل: Windows setx، وملف الإعدادات وترتيب تحميله، وتقدير تكلفة الجلسة.

المصدر: وثائق Aider لواجهات API المتوافقة مع OpenAI (تم فحص الصفحة في 26 أكتوبر 2026؛ لا تُظهر الوثائق تاريخًا أو إصدارًا، وكان أحدث aider-chat على PyPI في ذلك اليوم هو 0.86.2).

Windows: setx وطرفية جديدة#

على Mac وLinux تقوم بـexport للمتغيرين. على Windows (PowerShell أو cmd) استخدم setx:

setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

على Windows هناك مشكلة. يكتب setx المتغيرات للجلسات المستقبلية، وليس للجلسة التي تكتب فيها، لذا أغلق الطرفية وافتح واحدة جديدة قبل تشغيل Aider. إذا ضبطت المتغيرات وما زال Aider يطلب مفتاحًا، فهذا هو السبب المعتاد.

أي نموذج لأي تعديلات#

وسيطة النموذج هي openai/ بالإضافة إلى المعرّف الكامل، لذا بالنسبة لـ CheapTokens تحتوي على شرطتين مائلتين:

cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

يمتلك MiniMax-M2.7 سياقًا بحجم 180K ويجيب بما يصل إلى 8,192 رمزًا، وهو مناسب للتعديلات الصغيرة والمتوسطة حيث تبقى الإجابات قصيرة. إذا عادت تعديلاتك كفروقات طويلة، فالنموذج الآخر الجدير بالتجربة هو DeepSeek-V4-Flash: حتى 32,768 رمزًا لكل إجابة، وسياق بحجم 380K، وسعر واحد في أي وقت من اليوم.

aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

انسخ المعرّف الكامل من وثائق CheapTokens أو قائمة النماذج على صفحة الأسعار.

شغّل أول تعديل#

يعمل Aider داخل مستودع git، لذا ابدأ داخل واحد. أضف ملفًا واطلب شيئًا صغيرًا:

> /add app.py
> Add a --verbose flag that prints each file before it is processed

عندما يجيب Aider بتعديل على الملف، يكون المفتاح وعنوان URL الأساسي ومعرّف النموذج كلها صحيحة.

توقف عن إعادة الكتابة: .aider.conf.yml#

يقرأ Aider .aider.conf.yml من دليل المنزل، ثم جذر مستودع git، ثم الدليل الحالي، والملفات اللاحقة تفوز. لذا يمكن لملف عام أن يحمل المفتاح والعنوان الأساسي، ويمكن لملف المستودع أن يختار النموذج. إذا أردت ملفًا واحدًا محددًا ولا شيء غيره، فإن aider --config <file> يحمّل ذلك الملف فقط.

ملف في دليل المنزل (مثال، ضع مفتاحك الخاص فيه):

openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

الآن aider وحده يبدأ بنقطة النهاية والنموذج الصحيحين. إذا أودعت الملف في مستودع، فاترك المفتاح خارجًا واحتفظ به في متغير البيئة أو في ملف .env؛ أسطر المفتاح مخصصة لدليل المنزل الخاص بك.

بالنسبة لنموذج لا يعرفه Aider، تصف الوثائق model-settings-file (.aider.model.settings.yml) حيث يمكنك تحديد إعداداته.

كم تكلف الجلسة#

يعيد Aider إرسال الملفات التي أضفتها وسجل المحادثة مع كل رسالة، لذا تنمو رموز الإدخال أسرع من الإخراج. لنفترض أن جلسة عمل من حوالي 20 رسالة ترسل 400,000 رمز إدخال وتحصل على 40,000 رمز إخراج (افتراض للمثال؛ ضع أرقامك الخاصة). على MiniMax-M2.7 يكون ذلك $0.026، وأرخص من OpenRouter إجمالًا، مع احتساب الإدخال والإخراج معًا. يشغّل الجدول أدناه الجلسة نفسها عبر نماذجنا:

كيفية إبقاء جانب الإدخال صغيرًا (ملفات للقراءة فقط، /drop، حجم خريطة المستودع) مشروحة في كم يكلف Aider. الأسعار الحالية دائمًا على صفحة الأسعار.

إذا لم يعمل#

• Aider يطلب مفتاح API أو يتحدث إلى خدمة خاطئة. المتغيرات غير مرئية للعملية. على Windows، أعد تشغيل الطرفية بعد setx؛ على Mac وLinux، شغّل echo $OPENAI_API_BASE في نفس الصدفة.
• يبدو أن إعداداتك متجاهلة. تذكر الترتيب: المنزل، جذر المستودع، الدليل الحالي. الملف الأقرب إليك يتجاوز الملف العام.
• النموذج غير موجود، 404 أو خطأ مصادقة. هذه مغطاة في كيفية ربط Aider بـ CheapTokens.

نفس العنوان المتوافق مع OpenAI يعمل في أدوات أخرى؛ إذا كنت تستخدم أيضًا وكيل محرر، راجع ربط OpenCode أو نظرة عامة على أين تُدرج مفتاح API الخاص بك.