OmniRoute בעברית: התקנה בטוחה עם Claude Code, ומה חינמי באמת

בקצרה: OmniRoute הוא תוכנה חינמית בקוד פתוח שרצה אצלכם במחשב, ומחברת את Claude Code (וכלים דומים) למאות ספקי AI דרך כתובת אחת. כשספק אחד מגיע למכסה, הבקשה עוברת אוטומטית לספק הבא. יש בו הרבה ספקים עם שכבה חינמית, אבל הוא לא נותן Claude בחינם, ויש דרכים להשתמש בו שעלולות לחסום לכם חשבון. המדריך הזה עובר על ההתקנה הבטוחה, צעד אחר צעד.

מה זה OmniRoute

OmniRoute הוא "שער" (Gateway) מקומי. הוא רץ על המחשב שלכם, ומציג כתובת אחת שתואמת לממשקים של OpenAI, Anthropic ו-Gemini. מאחוריה אפשר לחבר ספקים רבים ולהגדיר להם סדר עדיפויות. יש לו לוח בקרה בדפדפן, כלי שורת פקודה, ודחיסה של הודעות כדי לחסוך בטוקנים.

• רישיון MIT, חינמי גם לשימוש מסחרי. המתחזק הוא מפתח יחיד (Diego Souza) בחשבון GitHub אישי.
• פרויקט פעיל מאוד: הגרסה היציבה האחרונה היא 3.8.51, מ-30 בספטמבר 2026.
• הפרויקט עצמו מציג מספרים שונים של ספקים בדפים שונים (בין 352 ל-359). הניסוח הנכון: מאות ספקים.

מה חינמי ומה עולה כסף

לפני שמתחילים: מה עלול לחסום לכם חשבון

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

• Anthropic (Claude Pro/Max): בדף המשפטי של Claude Code כתוב שהתחברות עם חשבון Claude מיועדת לשימוש רגיל באפליקציות של Anthropic בלבד, ושאסור לנתב בקשות דרך פרטי מנוי Free, Pro או Max או לאחסן את טוקני ההתחברות. Anthropic שומרת לעצמה את הזכות לאכוף את זה בלי הודעה מראש. לכן: לא לחבר את מנוי Claude ולא את עוגיית claude.ai.
• Google (Antigravity ו-Gemini CLI): התנאים שלהם אוסרים במפורש גישה דרך כלים חיצוניים עם ההתחברות שלהם, והעונש הוא השעיה או סגירה של החשבון. בפברואר 2026 דווח על גל חסימות כזה, ובתיעוד של OmniRoute עצמו מתועד חשבון שנחסם לצמיתות. מפתח API רגיל מ-Google AI Studio הוא דרך אחרת, ובטוחה יותר.
• Kiro ועוד: הפרויקט עצמו מסמן 16 ספקים שהתנאים שלהם בעייתיים, אבל משאיר אותם פעילים כברירת מחדל. לפני שמחברים ספק, כדאי לבדוק את הסימון שלו בלוח הבקרה.
• מצב "Stealth": ב-OmniRoute יש אפשרות שמסווה בקשות כך שייראו כמו Claude Code המקורי. אל תפעילו אותה. זו בדיוק ההתנהגות שהתנאים אוסרים.

עוד דבר שכדאי לדעת: Anthropic כותבת בתיעוד שלה שהיא לא תומכת בהפעלת Claude Code על מודלים שאינם Claude דרך שער כלשהו. זה עובד, אבל האיכות והתאימות באחריותכם.

אבטחה: שתי הגדרות שחייבים לשנות

• ברירת המחדל פתוחה לרשת. לפי קוד המקור, השרת מאזין לכל הרשת ולא רק למחשב שלכם, ולא דורש מפתח לבקשות. המשמעות: כל מכשיר ברשת הביתית או המשרדית יכול לשלוח בקשות על חשבון המכסות והחיובים שלכם. הפתרון: להגדיר OMNIROUTE_SERVER_HOST=127.0.0.1 ו-REQUIRE_API_KEY=true לפני ההפעלה הראשונה.
• לעדכן לגרסה 3.8.51 ומעלה. בספטמבר 2026 פורסמה חולשה קריטית (CVE-2026-88062) שמאפשרת הרצת קוד מרחוק בלי התחברות. לא חושפים את הפורט 20128 לאינטרנט, אף פעם.

מה צריך להכין

• Node.js בגרסה 22.22.2 ומעלה או 24 ומעלה (גרסה 23 לא נתמכת). בודקים בטרמינל:

node -v

• Claude Code בגרסה עדכנית. התיעוד של הפרויקט סותר את עצמו לגבי גרסת המינימום, אז פשוט מעדכנים לאחרונה:

claude --version

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

התקנה בטוחה, צעד אחר צעד

1. התקנה

npm install -g omniroute

אפשר גם להריץ בלי התקנה קבועה עם npx omniroute@latest. ב-Windows, אם מופיעה השגיאה "omniroute is not recognized", צריך להוסיף את תיקיית ה-npm הגלובלית למשתנה PATH.

2. נעילה למחשב שלכם (לפני ההפעלה הראשונה)

ב-Windows (PowerShell):

$env:OMNIROUTE_SERVER_HOST = "127.0.0.1"
$env:REQUIRE_API_KEY = "true"

ב-Mac או Linux:

export OMNIROUTE_SERVER_HOST=127.0.0.1
export REQUIRE_API_KEY=true

ההגדרה הזו תקפה לחלון הטרמינל הנוכחי. כדי שתישמר, מוסיפים אותה לקובץ ההגדרות של הטרמינל, או לקובץ ה-.env של OmniRoute.

3. הפעלה ולוח הבקרה

omniroute

פותחים בדפדפן את http://localhost:20128 ומגדירים סיסמה חזקה ללוח הבקרה. אם שכחתם אותה, מאפסים עם omniroute reset-password.

4. בדיקת תקינות

omniroute doctor

5. חיבור ספקים

בלוח הבקרה מוסיפים ספקים עם מפתח API, ובודקים כל אחד מהטרמינל:

omniroute providers test <id>

6. יצירת פרופילים ל-Claude Code

קודם רואים מה ייכתב, בלי לשנות כלום:

omniroute setup-claude --dry-run

ואם הכל נראה בסדר:

omniroute setup-claude

הפקודה יוצרת פרופיל לכל מודל בתיקייה ~/.claude/profiles. הטוקן לא נשמר בפרופיל.

7. הפעלה ובדיקה

omniroute launch --profile <name>

כותבים ל-Claude Code בקשה קצרה, ובודקים איזה ספק ומודל ענו בפועל:

omniroute quota

חלופה: Docker

מי שעובד עם Docker יכול להריץ מכולה. חשוב להשאיר את 127.0.0.1 לפני הפורט, כדי שהשער לא ייפתח לרשת:

docker run -d --name omniroute --restart unless-stopped -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

לפי ה-README, לעבודה עם סוכן קוד כמו Claude Code צריך להגדיל את הזיכרון של המכולה (הם ממליצים על 8GB לתהליך ו-10GB למכולה).

חיבור ידני, בלי פרופילים

אפשר גם להגדיר את Claude Code ישירות עם משתני סביבה. את המפתח לוקחים מלוח הבקרה (Endpoints):

ANTHROPIC_BASE_URL=http://localhost:20128
ANTHROPIC_AUTH_TOKEN=<המפתח מלוח הבקרה>
ANTHROPIC_MODEL=<מזהה המודל>

• הכתובת בלי /v1 בסוף. זו הטעות הנפוצה ביותר.
• שמים את המפתח בהגדרות האישיות (הטרמינל או ~/.claude/settings.json), ולא בקובץ ההגדרות של הפרויקט, שעלול להגיע ל-GitHub.
• Claude Code קורא את המשתנים רק בהפעלה, אז אחרי שינוי מפעילים אותו מחדש.
• בבורר /model מופיעים רק מזהים שמכילים claude או anthropic. למודלים אחרים משתמשים ב-ANTHROPIC_MODEL, וזה בדיוק מה שהפרופילים עושים.
• לפי Anthropic, כשמחוברים דרך שער, מכסות המנוי לא חלות, ו-Remote Control והכתבה קולית לא זמינים.

פרומפט מוכן להעתקה ל-Claude Code

אם אתם מעדיפים ש-Claude Code יעשה את העבודה, הפרומפט הזה מנחה אותו להתקין לפי התיעוד הרשמי בלבד, לבקש אישור לפני כל שינוי, ולהישאר בדרכים המותרות:

אני רוצה להתקין את OmniRoute ולחבר אותו ל-Claude Code, לפי התיעוד הרשמי בלבד:
https://github.com/diegosouzapw/OmniRoute
https://github.com/diegosouzapw/OmniRoute/wiki/Claude-Code-Configuration

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

השלבים:
1. בדוק את גרסת Node.js (node -v). נתמכות 22.22.2 ומעלה או 24 ומעלה; 23 לא נתמכת. אם צריך, הסבר מה להתקין, ואל תתקין בעצמך.
2. התקן את OmniRoute בגרסה 3.8.51 ומעלה, ובדוק את הגרסה אחרי ההתקנה.
3. לפני ההפעלה הראשונה, הגדר שני משתני סביבה: OMNIROUTE_SERVER_HOST=127.0.0.1 ו-REQUIRE_API_KEY=true. הסבר לי למה.
4. הפעל את OmniRoute, ותגיד לי לפתוח את לוח הבקרה ב-http://localhost:20128 ולהגדיר סיסמה.
5. הרץ omniroute doctor ותסביר לי את התוצאה.
6. עזור לי לחבר ספקים שעובדים עם מפתח API בלבד. אל תציע לחבר מנוי Claude Pro/Max, עוגיית claude.ai, או התחברות OAuth של Gemini CLI, Antigravity או Kiro: זה אסור בתנאים שלהם ועלול לחסום את החשבון. אל תפעיל מצב Stealth.
7. הרץ omniroute setup-claude --dry-run, הצג לי מה ייווצר, ורק אחרי אישור הרץ בלי --dry-run.
8. הפעל פרופיל אחד עם omniroute launch --profile <שם>, ובדוק עם omniroute quota איזה ספק ומודל ענו בפועל.

כללים: רק פקודות שמופיעות בתיעוד הרשמי. אם משהו נכשל, הסבר לפי פרק Troubleshooting ואל תנחש. אל תבטיח שימוש חינמי ב-Claude: הסבר מה חינמי ומה עולה כסף.

רוצים לבנות פרומפטים כאלה בעצמכם? נסו את מחולל הפרומפטים המקצועי שלנו.

תקלות נפוצות

• Claude Code מתעלם מהשער: בדקו שאין /v1 בכתובת, והפעילו את Claude Code מחדש.
• שגיאת התחברות: הפרופיל לא שומר טוקן. מפעילים דרך omniroute launch --profile, שמוסיף אותו, או מגדירים ANTHROPIC_AUTH_TOKEN.
• "omniroute is not recognized" ב-Windows: להוסיף את תיקיית ה-npm הגלובלית ל-PATH.
• שגיאות התקנה ב-Node 23: לעבור ל-Node 24.
• המכולה נופלת בעבודה עם סוכן: להגדיל את הזיכרון שלה, כמו בפרק Docker.

OmniRoute הוא חלק ממשפחה של כלים שמאפשרים לבחור ספק AI לפי מחיר וזמינות. עוד על Claude Code יש בעמוד הכלי שלנו, ועל צוותים של סוכנים במדריך צוותי סוכני AI.

שאלות נפוצות

האם OmniRoute נותן גישה חינמית ל-Claude?

לא. התוכנה עצמה חינמית, ויש בה ספקים עם שכבה חינמית, אבל הדרך המותרת להשתמש במודלים של Claude דרכה היא מפתח API של Anthropic, בתשלום לפי שימוש. חיבור של מנוי Claude Pro או Max דרך OmniRoute אסור לפי התנאים של Anthropic.

האם OmniRoute בטוח?

הוא קוד פתוח ופעיל, אבל צריך להגדיר אותו נכון: להגדיר OMNIROUTE_SERVER_HOST=127.0.0.1 ו-REQUIRE_API_KEY=true, לעדכן לגרסה 3.8.51 ומעלה בגלל חולשה קריטית שפורסמה בספטמבר 2026, ולא לחשוף את הפורט 20128 לאינטרנט.

אילו ספקים אפשר לחבר בחינם?

ספקים עם שכבה חינמית שדורשים מפתח API חינמי, כמו Mistral, Groq ו-Cloudflare. לפי הערכת הפרויקט מדובר בכ-1.6 מיליארד טוקנים בחודש מ-35 מקורות, אבל המכסות משתנות ואין הבטחה.

האם אפשר להיחסם בגלל OmniRoute?

כן, אם מחברים חשבונות בדרך שהספק אוסר: מנוי Claude או עוגיית claude.ai, התחברות של Gemini CLI או Antigravity, ו-Kiro. עם מפתחות API רגילים הסיכון נמוך הרבה יותר.