התקנת goose והגדרת ספק מותאם אישית

goose הוא עוזר AI לשימוש כללי הפועל ישירות על המחשב שלכם. מעבר לכתיבת קוד, הוא מסוגל להתמודד עם מחקר, כתיבה, אוטומציה וארגון נתונים. ניתן להשתמש בו דרך אפליקציית שולחן העבודה, הטרמינל או API, כאשר גרסאות שולחן העבודה והטרמינל חולקות את אותה הגדרת מודל. הכלי מתאים למשימות קידוד חוזרות ויכול גם להתחבר ל-GitHub, למסדי נתונים ולקבצים.

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

goose מציע שתי אפשרויות התקנה: Desktop ו-CLI. גרסת Desktop היא הממשק הגרפי עם חלון, בעוד ש-CLI מיועדת לשימוש באמצעות פקודות בטרמינל. שתי הגרסאות חולקות את אותה ליבת הגדרות, כולל הספק (Provider) והמודל. ספק הוא הגדרת החיבור שמורה ל-goose באיזה שירות מודלים להשתמש.

רוצים חלון גרפי

goose Desktop

• הורידו את קובץ ה-zip ב-macOS
• או השתמשו ב-brew cask
• השתמשו בחבילת ההתקנה ב-Linux

טרמינל בלבד

goose CLI

• download_cli.sh
• או דרך Homebrew CLI
• לאחר מכן הריצו goose session

Windows

בחרו תחילה סביבת עבודה

• Git Bash או MSYS2
• ניתן להשתמש גם ב-PowerShell
• אם הפקודה לא נמצאה, הוסיפו אותה ל-PATH

לפני ההתחלה, ודאו שיש ברשותכם את מזהה המודל (Model ID) מתוך רשימת המודלים העדכנית. מזהה המודל הוא השם שבו שירות המודלים משתמש כדי לזהות מודל ספציפי, ועליכם להעתיק את המזהה המלא בעת השימוש בו.

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

אם אתם מעוניינים בחלון גרפי

קיימות שתי שיטות התקנה מתועדות עבור macOS:

• הורדה מדף ההתקנה. הדף מספק גרסאות עבור macOS Silicon ו-macOS Intel. לאחר ההורדה, חלצו את קובץ ה-zip והריצו את האפליקציה שבתוכו.
• לחלופין, השתמשו ב-Homebrew:

brew install --cask block-goose

פעולה זו מורידה את אותה אפליקציה ויכולה לטפל גם בעדכונים עתידיים.

אם אתם משתמשים ב-Apple Mac M3 ולא מופיע חלון לאחר פתיחת האפליקציה, בדקו האם ~/.config ניתן לקריאה וכתיבה. goose משתמש בתיקייה זו לכתיבת יומני רישום (logs).

עבור גרסת שולחן העבודה ב-Linux, הורידו את הקובץ מדף ההתקנה. החבילות הזמינות הן DEB עבור Ubuntu/Debian, RPM עבור RHEL/Fedora, ו-Flatpak. ב-Debian או Ubuntu, הורידו את קובץ ה-DEB, פתחו את התיקייה אליה נשמר, הריצו את sudo dpkg -i (filename).deb, ולאחר מכן פתחו את goose מתפריט היישומים. החליפו את (filename) בשם הקובץ האמיתי.

עבור גרסת שולחן העבודה ב-Windows, הורידו את הקובץ מדף ההתקנה, חלצו את קובץ ה-zip, והריצו את האפליקציה שבתוכו.

אם אתם מעוניינים בגרסת הטרמינל בלבד

ב-macOS וב-Linux, הריצו:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

כדי לדלג על ההגדרה האינטראקטיבית במהלך ההתקנה, הוסיפו את CONFIGURE=false לפני bash:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

ב-macOS, ניתן גם להריץ:

brew install block-goose-cli

כדי לעדכן גרסת CLI קיימת, הריצו:

goose update

ב-Windows, נדרשת אחת משלוש הסביבות הבאות: Git Bash, הכלולה ב-Git for Windows ומסומנת כמומלצת; MSYS2; או PowerShell הכלולה ב-Windows 10/11. ב-Git Bash וב-MSYS2, השתמשו באותה פקודת download_cli.sh המוצגת למעלה. ב-PowerShell, הורידו תחילה את הסקריפט ולאחר מכן הריצו אותו:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

אם מתקבלת הודעה ש-goose אינו נמצא ב-PATH, פעלו לפי דף ההתקנה והוסיפו את ~/.local/bin או את %USERPROFILE%\.local\bin להגדרות ה-shell הנוכחיות, ואז פתחו מחדש את הטרמינל. PATH הוא אוסף של תיקיות שהטרמינל מחפש בהן תוכניות. אם תיקיית ההתקנה אינה כלולה בו, ייתכן שלא תוכלו להריץ תוכנית מותקנת על ידי הקלדת שמה בלבד.

נכון לתאריך 2026-10-09, גרסת ה-CLI הייתה 1.54.0. כברירת מחדל, סקריפט ההתקנה ממקם את התוכנית ב-~/.local/bin. ניתן לשנות תיקייה זו באמצעות משתנה הסביבה GOOSE_BIN_DIR. אם תשנו אותה, הסקריפט לא יעדכן אוטומטית את הגדרות ה-shell, והטרמינל ידווח שהתיקייה אינה נמצאת ב-PATH. הוסיפו את התיקייה הזו ל-PATH או הריצו את goose באמצעות הנתיב המלא שלה.

בפעם הראשונה שתשתמשו ב-goose, תתבקשו להגדיר ספק (Provider). ניתן לדלג על הספקים המובנים ולהוסיף ספק מותאם אישית כמתואר בסעיף הבא. בטרמינל, נווטו לתיקייה שבה ברצונכם לעבוד והריצו:

goose session

קבלת ערכי חיבור מ-OmniProxy

הכינו את הכתובת, המפתח ושם המודל ממופע ה-OmniProxy הפרטי שלכם. הדוגמה לספק מותאם אישית משתמשת ב-base_url המסתיים ב-/v1/chat/completions, ולכן מדריך זה עוקב אחר אותו פורמט:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Copy from the current OmniProxy model list; separate multiple models with commas

העתיקו את שם המודל המלא מתוך הרשימה העדכנית של OmniProxy, כולל כל קו נטוי (/). נכון לתאריך 2026-10-09, שני מזהי ייחוס בתיעוד הספקים היו grok-4.7 עבור Grok ו-gpt-6-luna מתוך התיעוד של OpenAI. gpt-6-luna תומך ב-Chat Completions; קריאות לפונקציות (function calling) ב-Chat Completions נתמכות רק כאשר reasoning_effort מוגדר ל-none. אל תעתיקו שם שאינו מופיע ברשימה.

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

ספק מותאם אישית יכול להשתמש בפורמט תואם OpenAI, Anthropic או Ollama. פורמט תואם משמעו שהכלי שולח בקשות בהתאם למפרט API נפוץ. בעת התחברות ל-OmniProxy, בחרו ב-OpenAI Compatible.

Desktop

1. לחצו על הכפתור בפינה השמאלית העליונה כדי לפתוח את סרגל הצד.
2. לחצו על Settings.
3. לחצו על Models.
4. לחצו על Configure providers.
5. לחצו על Add Custom Provider בתחתית החלון.
6. עבור Provider Type, בחרו ב-OpenAI Compatible. ניתן להגדיר את Display Name ל-OmniProxy. הזינו את הכתובת מהסעיף הקודם בשדה API URL. אם נדרש מפתח, בחרו באפשרות הדורשת API Key והזינו את המפתח של OmniProxy. בשדה Available Models, הזינו את שמות המודלים, והפרידו בין שמות מרובים באמצעות פסיקים.
7. לחצו על Create Provider.

גרסת שולחן העבודה אינה יכולה כרגע להגדיר כותרות בקשה (request headers) מותאמות אישית בחלון זה. אם נדרשות לכם כותרות בקשה, ערכו את קובץ ההגדרות לאחר יצירת הספק.

Terminal

הריצו:

goose configure

בחרו ב-Custom Providers, ולאחר מכן ב-Add A Custom Provider. עבור API Type, בחרו ב-OpenAI Compatible, ואז עקבו אחר ההנחיות להזנת השם, כתובת ה-API, האם נדרש מפתח, שמות המודלים, והאם נתמכות תגובות בזרימה (streaming).

בעת הגדרה ידנית ב-Windows, אם ה-keychain מדווח על שגיאה, הוראות ההתקנה ממליצות לסרב לשמירת המפתח בצרור המפתחות (keyring) ולהשתמש במקום זאת במשתנה סביבה. לאחר מכן הריצו את goose configure שוב. ה-keychain הוא מערכת אחסון מאובטחת קטנה שבה משתמשת מערכת ההפעלה לאחסון סודות.

קובץ הגדרות

התיקיות המתועדות הן:

• macOS ו-Linux: ~/.config/goose/custom_providers/
• Windows: %APPDATA%\Block\goose\config\custom_providers\

ניתן לבסס את הקובץ על הדוגמה המסופקת. החליפו את השם, הכתובת והמודלים בערכים שלכם. אחסנו את המפתח במשתנה הסביבה המצוין ב-api_key_env; אל תכתבו את המפתח האמיתי לתוך הקובץ:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

שמרו על ערך מספרי עבור context_limit, כפי שמוצג בדוגמה. מגבלת ההקשר (context limit) בפועל תלויה במודל וב-OmniProxy; אל תתייחסו למספר בדוגמה כאל המגבלה הרשמית של המודל. לפני השימוש, הריצו:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

לאחר הכניסה לתיקיית העבודה, הריצו:

goose session --provider omniproxy --model grok-4.7

החליפו את הערך של --model במזהה המלא מתוך הרשימה. ל-goose session אין תת-פקודת start. ניתן גם להגדיר את --provider ואת --model באמצעות משתני הסביבה GOOSE_PROVIDER ו-GOOSE_MODEL. גם אם ה-gateway אינו מאמת מפתחות, ל-OMNIPROXY_API_KEY עדיין חייב להיות ערך. זו יכולה להיות מחרוזת placeholder המשמשת רק במחשב המקומי שלכם. הגדרה זו קראה בהצלחה קובץ בבדיקה שנערכה ב-2026-10-09.

חלון

הגדרות (Settings)

• הגדרות (Settings) בסרגל הצד
• דף מודלים (Models page)
• הוספת ספק מותאם אישית (Add Custom Provider)

טרמינל

goose configure

• בחר ספקים מותאמים אישית (Custom Providers)
• לאחר מכן בחר הוספה (add)
• בחר ב-OpenAI Compatible כסוג

קובץ

custom_providers

• ב-macOS וב-Linux, הוא נמצא תחת ~/.config
• ב-Windows, הוא נמצא תחת APPDATA
• הגדר את base_url לפי הדוגמה הרשמית

אימות באמצעות משימה אמיתית

פתחו תיקייה המכילה קובץ רגיל והריצו את goose session כפי שמוצג בסעיף הקודם. בקשו ממנו לקרוא את השורה הראשונה של קובץ שתציינו. עליו להחזיר את תוכן הקובץ ולא רק לומר שההגדרות נשמרו.

כדי לקרוא קבצים או לבצע פקודות, ההפעלה (session) זקוקה להרחבת Developer. הרחבת Developer היא מודול כלים המאפשר ל-goose לעבוד עם קבצים ופקודות מקומיים. היא כלולה בדרך כלל בהגדרות ברירת המחדל. אם goose מודיע שאין לו כלי קבצים, הוסיפו את הדברים הבאים לפקודה:

--with-builtin developer

אל תוסיפו גם את --no-profile, מכיוון שאפשרות זו משביתה את ההרחבות המוגדרות כברירת מחדל.

בבדיקה שנערכה ב-2026-10-09, goose 1.54.0 קרא בהצלחה את השורה הראשונה של הקובץ שצוין. התגובה הראשונה עשויה לקחת כדקה.

לאחר מכן, בדקו את יומני הבקשות של OmniProxy כדי לאשר את המקור ואת שם המודל.

הפעלה

סשן נפתח

• goose session
• ה-Provider הוא זה שזה עתה נוסף
• שם המודל נמצא ברשימה

משימה

היא אכן השלימה את המשימה

• לדוגמה, הצגת רשימת הקבצים בספרייה הנוכחית
• סקור את התגובה שלה
• אל תסתמך רק על שמירה מוצלחת

יומנים (Logs)

גלוי ב-gateway

• השתמש בכתובת מתוך דוגמת התיעוד
• אל תשים את המפתח במאגר (repository)
• מזהה המודל תואם לרשימה

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

• הפקודה goose לא נמצאה: הוסיפו את תיקיית ההתקנה ל-PATH כמתואר בדף ההתקנה, ואז פתחו מחדש את הטרמינל.
• לא מופיע חלון בגרסת שולחן העבודה ב-Mac M3: בדקו הרשאות קריאה וכתיבה עבור ~/.config.
• ה-keychain נכשל: אל תשמרו את המפתח ב-keyring; השתמשו במקום זאת במשתנה סביבה.
• המודל אינו ברשימה: בגרסת שולחן העבודה, בחרו ב-Use custom model והזינו את שם המודל ידנית. goose configure אינו יכול לקבל שם מודל מותאם אישית. לשימוש בטרמינל, עברו לגרסת שולחן העבודה או ערכו את GOOSE_MODEL ישירות בהגדרות.
• לא ניתן להגיע לכתובת: ודאו שכתובת ה-API מסתיימת ב-/v1/chat/completions, כפי שמוצג בדוגמה, וש-OmniProxy פועל.
• מתקבלת הודעה שלא ניתן לקרוא קבצים: הוסיפו את הרחבת Developer ואל תשתמשו ב---no-profile.
• מתקבלת התשובה unsupported Responses role: system: הכתובת בדרך כלל נכונה. נסו לעבור למזהה מלא אחר מתוך רשימת המודלים.

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

להתקנה, ראו Install goose. לספקים מותאמים אישית, ראו goose providers. למזהי המודלים המשמשים בדוגמאות, ראו את xAI models page ואת GPT-6 Luna.

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

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

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