התקנת Aider והגדרת OmniProxy

Aider הוא כלי שעוזר לשנות קוד ישירות מהטרמינל. הוא בונה מפה של כל בסיס הקוד כדי לעזור למודל להבין פרויקטים גדולים. Git הוא כלי לניהול גרסאות שמתעד שינויי קוד, ומאפשר לך לבחון הבדלים ולשחזר גרסאות קודמות. לאחר שתיתן ל-Aider משימה, הוא יעבד אותה צעד אחר צעד ויכתוב הודעות commit. אם השינויים לא לטעמך, ניתן לבטל אותם באמצעות /undo.

לפני שמתחילים

קיימות שתי אפשרויות התקנה נפוצות:

• אם במחשב שלך כבר מותקן Python בגרסאות 3.8 עד 3.13, התקן את aider-install תחילה. Python הוא סביבת ההרצה הנדרשת עבור Aider.
• אם אין לך גרסת Python מתאימה, השתמש בפקודת ההתקנה בשורה אחת. היא גם תגדיר Python 3.12 במידת הצורך.

Mac ו-Linux

install.sh

• הרץ עם sh אחרי curl
• מתקין Python במידת הצורך
• השתמש ב-wget אם curl לא זמין

Windows

install.ps1

• הרץ ב-PowerShell
• פתח מחדש את הטרמינל לאחר ההתקנה
• הגדר משתני סביבה עם setx

Python כבר מותקן

aider-install

• התקן תחילה חבילה זו עם pip
• לאחר מכן הרץ את aider-install
• זה יוצר סביבה עצמאית משלו

וודא ש-OmniProxy פועל. לאחר ההתקנה, היכנס לספריית הפרויקט שברצונך לשנות לפני הפעלת Aider.

התקנה והפעלה ראשונה

אם כבר יש לך Python בגרסאות 3.8 עד 3.13

הרץ פקודות אלו לפי הסדר:

python -m pip install aider-install
aider-install

aider-install מתקין את Aider בסביבת Python נפרדת כדי שלא יפריע לפרויקטי Python אחרים במחשב שלך. במידת הצורך, הוא גם מתקין Python 3.12 לשימוש על ידי Aider.

התקנה בשורה אחת

ב-Mac וב-Linux, הרץ:

curl -LsSf https://aider.chat/install.sh | sh

אם curl לא מותקן, השתמש ב:

wget -qO- https://aider.chat/install.sh | sh

ב-Windows PowerShell, הרץ:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

פקודות שורה אחת אלו מבוססות על uv, תוכנית להתקנה וניהול של כלי וסביבות Python. ניתן להשתמש גם בפקודה הבאה:

uv tool install --force --python python3.12 --with pip aider-chat@latest

ניתן להשתמש גם ב-pipx. בעת התקנה ישירות עם python -m pip install aider-chat, גרסאות ה-Python הנתמכות הן 3.9 עד 3.12. עם זאת, זוהי שיטת התקנה חלופית, לכן העדף את השיטות המתוארות לעיל. חבילות Aider ממנהלי חבילות של מערכת ההפעלה עלולות לסבול מאי-התאמות בתלויות, ולכן הן לא צריכות להיות הבחירה הראשונה שלך.

נכון ל-2026-10-09, פקודת ההתקנה בשורה אחת התקינה את Aider v0.86.2. במהלך ההתקנה, ייתכן שתראה הודעה האומרת שהמטמון (cache) ויעד ההתקנה נמצאים בכוננים שונים ושהקבצים יועתקו. ההתקנה תושלם בכל זאת.

לאחר ההתקנה, היכנס לספריית הפרויקט. API תואם הוא ממשק שמתקשר עם שירותי מודלים אחרים באמצעות פורמט OpenAI. התחל את Aider באמצעות תבנית זו:

aider --model openai/<model-name>

החלף את <model-name> במזהה המודל המלא שהועתק מ-OmniProxy בסעיף הבא. מזהה מודל הוא השם המשמש לזיהוי מדויק של מודל.

קבלת הגדרות חיבור מ-OmniProxy

עליך להגדיר את שני משתני הסביבה הבאים. ניתן להבין משתני סביבה כקבוצה של הגדרות חיבור הנקראות על ידי תוכניות טרמינל:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE הוא נקודת הקצה (endpoint) של ה-API וחייב לכלול את /v1. OPENAI_API_KEY הוא המפתח המשמש לגישה ל-API.

ב-Windows, השתמש ב- setx כדי לשמור את המשתנים. עליך לפתוח מחדש את הטרמינל לאחר מכן:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

העתק את שם המודל המלא מרשימת OmniProxy הנוכחית, כולל לוכסנים במזהה המודל. בעת הפעלת Aider, הוסף את openai/ לפני המזהה המלא.

נכון ל-2026-10-09, שני מזהי הייחוס בתיעוד הספק הם gemini-3.8-flash ו- grok-4.7. אם שמות אלו אינם ברשימה הנוכחית, אל תעתיק אותם ישירות. השתמש במזהה מלא שמופיע בפועל ברשימה.

כתובת

OPENAI_API_BASE

• הפנה אותו ל-OmniProxy
• כלול את /v1
• אל תשים אותו בתוך ה-repository

מפתח

OPENAI_API_KEY

• השתמש בזה שסופק על ידי ה-gateway
• פתח מחדש טרמינלים ב-Windows לאחר השינוי
• שמור מפתחות ספק בתוך ה-gateway

הפעלה

openai/model

• בצע cd לספריית הפרויקט
• הוסף קידומת openai/ לשם המודל
• השתמש בשם מרשימת ה-gateway

הזנת הגדרות הכלי

אין צורך ליצור קובץ הגדרות נפרד. היכנס לספריית הפרויקט, הפעל את Aider, והחלף את מזהה המודל בשם שקיים בפועל ברשימת OmniProxy הנוכחית:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

כדי להשתמש במודל הדוגמה השני, הרץ:

aider --model openai/grok-4.7

כאשר Aider נתקל במודל לא מוכר, הוא מציג אזהרה. אזהרה זו כשלעצמה אינה אומרת שנקודת הקצה שגויה. בדוק את יומני הבקשות (request logs) של OmniProxy כדי לאשר אם הבקשה הופיעה.

Aider מוסיף להקשר (context) רק קבצים שכבר נמצאים במעקב של Git. ההקשר הוא הקוד והמידע שהמודל יכול לקרוא במהלך המשימה הנוכחית. אם הספרייה הנוכחית אינה עדיין מאגר Git, Aider ייצור אחד, אך קבצים ש-Git לא עוקב אחריהם עדיין לא ניתנים לקריאה. השתמש ב- git add כדי להוסיף את הקבצים ולבצע להם commit לפני הפעלת Aider.

Aider עדיין יכול לשנות קבצים. --no-auto-commits רק משבית ביצוע commits אוטומטיים; זה לא מונע שינויי קבצים. בעת השימוש ב-Aider בפעם הראשונה, בחר מאגר לא חשוב והרץ את git diff אחרי המשימה כדי לבחון את השינויים בפועל.

אל תשים מפתחות אמיתיים בקבצי פרויקט או בדפים ציבוריים. אחסן מפתחות ספק רק ב-OmniProxy. אם ה-gateway לא מאמת מפתחות, ניתן להגדיר את OPENAI_API_KEY למחרוזת מציין מיקום (placeholder) המשמשת רק במחשב המקומי שלך.

אימות עם משימה אמיתית

ראשית, וודא שהקובץ שברצונך ש-Aider יקרא עבר commit ל-Git. לאחר מכן הרץ את הפקודה הבאה מספריית הפרויקט. החלף את מזהה המודל במזהה מלא מרשימת OmniProxy הנוכחית:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message שולח משימה ישירות ל-Aider, בעוד ש- --no-auto-commits מורה ל-Aider לא ליצור Git commits באופן אוטומטי במהלך הרצה זו.

נכון ל-2026-10-09, Aider v0.86.2 קרא בהצלחה את השורה הראשונה של קובץ במעקב. אם הקובץ אינו במעקב של Git, Aider יגיד שהוא לא יכול לראות את התוכן. זה לא אומר שנקודת הקצה של ה-API שגויה. לאחר השלמת השאילתה, בדוק את יומני הבקשות של OmniProxy כדי לאמת את מקור הבקשה ומזהה המודל.

הפעלה

Aider מופעל

• הפקודה זמינה
• משתני הסביבה פעילים
• בתוך ספריית הפרויקט

משימה

הוא בדק את הקובץ

• שאל על קובץ ספציפי
• בחן את ההסבר שלו
• מודלים לא מוכרים עלולים להפעיל אזהרה

יומנים

גלויים ב-gateway

• המקור הוא Aider
• מזהה המודל תואם
• המפתח לא הוזן בדף

שגיאות נפוצות

• aider לא ניתן למצוא: פתח מחדש את הטרמינל תחילה. אם התקנת אותו ישירות עם pip, נסה את python -m aider.
• Windows עדיין מתחבר לנקודת הקצה הישנה לאחר שינוי המשתנים: עליך לפתוח מחדש את הטרמינל לאחר הרצת setx. רק חלון חדש יקרא את המשתנים המעודכנים.
• שם המודל לא מתחיל ב- openai/: ה-API התואם דורש את הפורמט openai/<model-name>.
• מופיעה אזהרת מודל לא מוכר: זוהי אזהרה רגילה ואינה אומרת שהחיבור נכשל. בדוק אם OmniProxy קיבל את הבקשה.
• מזהה המודל אינו חוקי: העתק את המזהה המלא שוב מרשימת OmniProxy הנוכחית. שמור על הקידומת openai/ וכל לוכסן שכבר קיים במזהה.
• Aider אומר שאין תוכן קובץ: וודא שהקובץ נמצא במעקב של Git. קבצים במאגר ריק או קבצים ללא מעקב לא מתווספים להקשר.

הפניות רשמיות

לשלבי התקנה, ראה התקנת Aider. עבור משתני סביבה וקידומת המודל, ראה APIs תואמי OpenAI. מזהי מודל לדוגמה ניתן למצוא ב-רשימת מודלי Gemini וב-דף מודלי xAI.

החלף כל מקום לשימוש בערכים מההגדרה שלך ב-OmniProxy. לעולם לא פרסם מפתח אמיתי.

תוצאה שמורה או HTTP 200 בלבד אינם מוכיחים תאימות מלאה של הסוכן. בדוק את המקור והמודל ברשומת הקריאה של OmniProxy.

מקורות רשמיים · Aider ↗