OpenCode מבפנים: לולאה אחת, מודלים רבים, ומשוב אמיתי מהסביבה
איך OpenCode משלב לולאת סשן, כלים מותאמי מודל, הרשאות ודיאגנוסטיקה של LSP, ומה נקודת העיצוב הייחודית שהופכת אותו לעמיד יחד עם לקח למי שבונה harness.
OpenCode מציג את עצמו כסוכן קידוד בקוד פתוח, אבל מבחינה ארכיטקטונית הוא נראה יותר כמו פרויקט של אינטגרציית מערכות: harness אחד שצריך לעבוד מול מודלים, ספקים, ממשקים וסביבות פיתוח אמיתיות. התשובה שלו היא לא להשאיר לולאה “חכמה” ולקוות שהמודל הסתגל. במקום זה, OpenCode מנרמל הבדלים בתוך ה-runtime ומזין בחזרה אל החלטת ה-agent אותות שמגיעים מהסביבה.
השילוב הזה - ליבה פנימית יציבה וקצוות מסתגלים - הוא מה שהופך אותו למעניין.
runtime ממוקד סשן
OpenCode מאורגן סביב סשנים. הממשקים (TUI, דסקטופ, שרת/API) יושבים מעל ליבת runtime שמנהלת הודעות, כלים, הרשאות ואינטראקציה עם מודלים. במקום להתייחס לכל prompt כבקשה מבודדת, ה-harness מתמיד ומעבד סשן עבודה כך שתורים, קריאות כלים ומצבי ממשק שונים יכולים לחלוק אותו state.
ברמת הלולאה, העיצוב ישיר במכוון: לאסוף את הקשר הסשן הנוכחי, לפתור את המודל והגדרות ה-agent המתאימים, לקרוא למודל, להריץ כלים שהתבקשו, לשמר תוצאות ולהמשיך עד שהסשן מגיע לנקודת עצירה טבעית. הפשטות של “להריץ לולאה” מאוזנת בעבודה מדויקת מסביב: תורי משימות, טיפול ב-compaction/גלישת הקשר ומעברי state מפורשים.
להסתגל למודלים במקום לכפות צורה אחת
אחד המאפיינים הבולטים של OpenCode הוא שהוא לא מניח שכל מודל צריך לראות בדיוק את אותו ממשק כלים. סט הכלים יכול להיבנות לכל בקשה לפי ההקשר של ספק/מודל/agent. דוגמה מוכרת מניתוחים ציבוריים של הארכיטקטורה היא שלחלק מהגדרות ממשפחת GPT יש זרימת עריכה מבוססת patch, בעוד מודלים אחרים מקבלים כלים בסגנון edit/write. הפרטים המדויקים משתנים, אבל העיקרון יציב: ה-harness מתאים את affordances הכלים למודל שהוא מפעיל.
השונות בין ספקים עמוקה משמות כלים. בגרסאות האחרונות OpenCode תומך בכמה מסלולי הרצה לאינטראקציה עם מודלים (כולל המסלול ברירת המחדל המבוסס על Vercel AI SDK ומסלול native ניסיוני), תוך שאיפה להתכנס לזרם אירועים פנימי עקבי עבור שאר המערכת. זו תנועה קלאסית של harness: לבודד הבדלים חיצוניים בגבול, ואז לתת לליבה לצרוך ייצוג מנורמל אחד.
הרשאות והרצה הן מפורשות
OpenCode מתייחס להרצת כלים כפעולה מנוהלת מדיניות, לא רק כ-dispatch של פונקציה. כללי הרשאה יכולים לאפשר, לשאול או לחסום פעולות, וההחלטות האלה הן חלק מזרימת ה-runtime. כך בטיחות ושליטה של המשתמש הופכות לתכונה של ה-harness, לא לנוהג שהמודל אמור לכבד מרצונו.
שכבת הכלים היא גם המקום שבו OpenCode מחבר בין כוונת המודל לבין מציאות הפיתוח: קריאת קבצים, עריכת קוד, הרצת פקודות, אינטגרציה עם יכולות חיצוניות ותיאום עם תתי-סוכנים. מכיוון שהפעולות מתווכות, ה-harness יכול לבדוק, לתחום, לתעד ולהמיר אותן לפני ואחרי ההרצה.
נקודת הסוד: לסגור את הלולאה עם אותות אמיתיים מהסביבה
הסוד שבולט ב-OpenCode הוא זה: הוא הופך משוב מהסביבה לחלק מלולאת החשיבה של ה-agent.
דוגמה טובה היא דיאגנוסטיקה אחרי עריכות. כשה-harness יכול להחיל שינוי ואז להחזיר שגיאות של language server או קומפיילר כמשוב כלי, המודל לא צריך לנחש אם העריכה הייתה תקינה - הוא יכול להגיב לאותות קונקרטיים מהסביבה בתור הבא. זה הבדל גדול בין “LLM שיודע לכתוב קבצים” לבין “coding harness שמשתף פעולה עם סביבת פיתוח”.
בשילוב עם התמדה של סשן וטיפול מנורמל באירועים, מתקבל מחזור משוב הדוק: להציע שינוי, להחיל אותו תחת מדיניות, לצפות בתוצאות האמיתיות, ולתקן. ה-harness לא רק מעביר הודעות; הוא מעצב לולאה שבה אותות נכונות זמינים.
לקח למי שבונה harness
הלקח שאפשר לקחת מ-OpenCode הוא: לנרמל את החוץ, למדוד את הפנים, ולהזין בחזרה מציאות.
בונים רבים מתמקדים באיכות ה-prompt או בבחירת המודל, אבל אמינות של harness מגיעה לרוב מהאינסטלציה:
- לנרמל הבדלים בין ספקים/מודלים מאחורי ממשק פנימי יציב כדי שהלולאה תישאר פשוטה.
- להתאים יכולות לחוזקות של המודל במקום להעמיד פנים שכל המודלים מתנהגים אותו דבר.
- לתחום הרצה עם הרשאות מפורשות והחלטות שניתנות לביקורת.
- ללכוד משוב מהסביבה (דיאגנוסטיקה, תוצאות טסטים, פלט פקודות, שגיאות ולידציה) ולהחזיר אותו כקלט מובנה לצעד הבא.
אם המודל הוא המוח, ה-harness הוא מערכת העצבים. החוזק של OpenCode הוא שהוא לא מסתפק בשליחת פקודות החוצה - הוא מחזיר פנימה מהר את תגובת הסביבה, בצורה שהלולאה יכולה להשתמש בה.
מקורות
- הריפו של OpenCode
- הדוקומנטציה של OpenCode
- OpenCode agents docs
- OpenCode permissions docs
- Agent Harness Anatomy: OpenCode
- סקירת session ו-pipeline מודל (Zread)
סדרה שבועית
אפשר לקרוא את הפוסטים לפי הסדר:
- הוספתי בלוג לאתר האישי (בלי לבנות הכול מחדש) - 2026-11-11
- למה PostHog הוא אחד הכלים הראשונים שאני מוסיף למוצר חדש - 2026-11-18
- האנטומיה של coding harness: מה באמת מפעיל סוכני קידוד - 2026-11-11
- ניהול context ב-coding harnesses: מה באמת נשלח למודל ולמה זה חשוב - 2026-11-18
- Goose מבפנים: harness מבוסס MCP עם פרוטוקול במרכז - 2026-11-11
- Pi מבפנים: harness מינימלי שנבנה סביב עץ סשנים ופרימיטיבים - 2026-11-18
- OpenCode מבפנים: לולאה אחת, מודלים רבים, ומשוב אמיתי מהסביבה (הפוסט הזה) - 2026-11-11
- DeepSeek Harness מבפנים: הכול plugin, והלוג הוא החוזה - 2026-11-18
הקודם: Pi מבפנים: harness מינימלי שנבנה סביב עץ סשנים ופרימיטיבים הבא: DeepSeek Harness מבפנים: הכול plugin, והלוג הוא החוזה