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

OpenCode הוא עוזר קידוד בקוד פתוח המאפשר לך לכתוב קוד מטרמינל, IDE או שולחן עבודה. הוא אינו שומר את הקוד או ההקשר שלך, מה שהופך אותו למתאים לפרויקטים רגישים לפרטיות. build משמש לשינוי פרויקט, בעוד ש- plan הוא לקריאה בלבד כברירת מחדל ושימושי להבנת קוד לא מוכר ותכנון שינויים לפני ביצועם. ניתן לבחור שירות מודל בהתאם לצרכים שלך.

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

סקריפט ההתקנה הוא האפשרות הקלה ביותר. אתה צריך טרמינל מודרני—אפליקציית טרמינל שיכולה להריץ פקודות ולעבוד עם קבצי פרויקט—כגון WezTerm, Alacritty, Ghostty או Kitty. ב-Windows, WSL מועדף. הוא מספק סביבת Linux בתוך Windows עם ביצועים ופונקציונליות מלאים יותר.

הכי קל

סקריפט התקנה

• curl opencode.ai/install
• השתמש ישירות ב-macOS Linux
• WSL מומלץ ב-Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• מתעדכן בתדירות גבוהה יותר מהנוסחה
• חבילה זמינה גם עבור Arch

Windows מקורי

מנהל חבילות

• choco או scoop
• או התקן גלובלית עם npm
• ניתן גם להוריד אותו מ-Releases

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

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

פקודת ההתקנה הקלה ביותר היא:

curl -fsSL https://opencode.ai/install | bash

ניתן גם להשתמש באחת משיטות ההתקנה הללו:

• Node.js: npm install -g opencode-ai. ל-Bun, pnpm ו-Yarn יש גם פקודות התקנה גלובליות תואמות; עיין בדף המבוא בסוף מדריך זה.
• Homebrew ב-macOS ו-Linux: brew install anomalyco/tap/opencode. השתמש ב-tap זה מכיוון שהוא מתעדכן בתדירות גבוהה יותר מ- brew install opencode, המתוחזק על ידי צוות Homebrew.
• Arch Linux: השתמש ב- sudo pacman -S opencode עבור הגרסה היציבה, או בחבילת AUR opencode-bin עבור גרסה חדשה יותר.
• Windows: השתמש ב- choco install opencode או scoop install opencode. ניתן גם להשתמש ב- npm install -g opencode-ai. ניתן גם להוריד קבצים בינאריים מ-Releases. התמיכה בהתקנה עם Bun ב-Windows עדיין בתהליך.

היכנס לספריית הפרויקט שלך, ולאחר מכן הפעל את OpenCode:

cd /path/to/project
opencode

בעת השימוש בו בפעם הראשונה, ניתן להריץ /init. הוא מנתח את הפרויקט ויוצר AGENTS.md בשורש הפרויקט. ניתן לשלוח קובץ זה ל-Git כך שהפרויקט ישמור על הוראות אלו.

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

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL הוא כתובת השירות, API Key הוא אישור הגישה, ו- Model ID הוא השם המלא של המודל.

בעת שימוש ב- /v1/chat/completions, הגדר את חבילת ה-npm ל- @ai-sdk/openai-compatible. Chat Completions הוא סוג של ממשק בקשת צ’אט. עבור ל- @ai-sdk/openai רק כאשר המודל משתמש ב- /v1/responses. כאשר OmniProxy משמש דרך נקודת הקצה של chat completions, שמור על חבילת התאימות.

העתק את מזהה המודל המלא מרשימת OmniProxy הנוכחית, כולל לוכסנים. נכון ל-09-10-2026, שני מזהי הפניה היו claude-sonnet-5-5 ו- gpt-6-luna. gpt-6-luna תומך ב-Chat Completions; קריאת פונקציות דרך Chat Completions נתמכת רק כאשר reasoning_effort הוא none. אל תעתיק מזהה שאינו ברשימה.

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

ניתן להבין ספק (Provider) כקבוצה של ערכי הגדרה ש-OpenCode משתמש בהם כדי להתחבר לשירות מודל. תיעוד הספק מתייחס לשירות תואם OpenAI שאינו רשום תחת /connect כספק מותאם אישית. שירות תואם OpenAI משתמש באותו פורמט בקשה וניתן לקרוא לו על ידי אותו סוג של לקוח.

1. הרץ /connect ב-OpenCode וגלול ל-Other.
2. הזן מזהה ספק. הדוגמה להלן משתמשת ב- omniproxy. בחר מזהה שקל לזכור מכיוון שעליך להשתמש באותו אחד בקובץ ההגדרה.
3. הזן את מפתח ה-API של OmniProxy. שלב זה שומר רק את האישור; את הכתובת והמודלים עדיין יש להוסיף ל- opencode.json. האישור נשמר ב- ~/.local/share/opencode/auth.json.
4. צור או שנה את opencode.json בספריית הפרויקט:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. הרץ /models. הספק המותאם אישית והמודלים שלו יופיעו ברשימה.

המזהה שהוזן תחת /connect חייב להתאים למפתח ב- opencode.json. אל תשים מפתח סודי אמיתי בקובץ זה. אם אינך משתמש ב- /connect, ניתן להשתמש בתחביר משתנה סביבה ב- options.apiKey, כגון {env:VARIABLE_NAME}. בבדיקה ב-09-10-2026 עם OpenCode 1.18.34, הכנסת המפתח ישירות ל- options.apiKey של הפרויקט מבלי להשתמש ב- /connect גם התחברה בהצלחה. אם ה-gateway אינו מאמת את המפתח, ערך זה יכול להיות מחרוזת מציין מיקום המשמשת רק במחשב המקומי. המפתחות תחת models חייבים להשתמש במזהים המלאים מהרשימה.

מפתח

/connect

• בחר Other בתחתית
• בחר מזהה ספק משלך
• נשמר ב-auth.json

פרויקט

opencode.json

• מפתח הספק חייב להשתמש באותו שם
• השתמש בחבילת npm תואמת
• baseURL מסתיים ב-/v1

בחר

/models

• המודל מופיע ברשימה
• בחר אחד לפני שאלת שאלה
• השתמש במזהה מרשימת ה-gateway

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

הרץ משימה אמיתית אחת מספריית הפרויקט תחילה. פורמט הפניית המודל הוא Provider ID/model ID; שמור על לוכסנים בתוך מזהה המודל:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto מאפשר להרצה זו להשתמש בכלים כגון כלי קריאת קבצים. בבדיקה ב-09-10-2026 עם OpenCode 1.18.34, הוא קרא בהצלחה את תוכן הקובץ שצוין. ההרצה הראשונה לקחה כשתי דקות.

לשימוש אינטראקטיבי, הרץ opencode, לאחר מכן בחר מודל עם /models. ניתן להשתמש ב- @ כדי לחפש קבצים. השתמש ב- opencode auth list כדי לאשר את האישור שנשמר דרך /connect, לאחר מכן בדוק את רשומות הבקשות של OmniProxy כדי לאמת את המקור ומזהה המודל.

הפעלה

opencode מופעל

• ראשית cd לפרויקט
• auth list מציג את המזהה
• קובץ ההגדרה נמצא בפרויקט

משימה

הוא קרא את הקוד

• שאל על קובץ ספציפי
• סקור את ההסבר שלו
• השתמש ב-/undo אם הוא שגוי

יומנים

גלוי ב-gateway

• המקור הוא OpenCode
• מזהה המודל תואם
• אל תשלח את המפתח למאגר

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

• OmniProxy אינו מופיע תחת /models: בדוק שהמזהה שהוזן תחת /connect מתאים למפתח ב- opencode.json, ש- npm מוגדר ל- @ai-sdk/openai-compatible, ושה- baseURL מסתיים ב- /v1.
• האישור חסר: הרץ opencode auth list. ספקים כגון Bedrock המסתמכים על משתני סביבה אינם מופיעים כאן; ספק מותאם אישית שהוגדר דרך /connect אמור להיות גלוי.
• פונקציונליות Windows אינה מלאה: השתמש בסקריפט ההתקנה בתוך WSL במקום זאת.
• מזהה המודל אינו חוקי: העתק אותו שוב מרשימת OmniProxy הנוכחית ועדכן את המפתח המתאים תחת models.
• בקשות הולכות לנקודת הקצה הלא נכונה: שמור על @ai-sdk/openai-compatible עבור chat completions. אל תשנה את החבילה עבור ממשק התגובות אלא אם המודל ב-OmniProxy באמת משתמש ב- /v1/responses.

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

עבור התקנה, ראה את OpenCode introduction. עבור ספקים מותאמים אישית, ראה Providers. עבור מזהי המודלים המשמשים בדוגמאות, ראה את Claude model overview ו-GPT-6 Luna.

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

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

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