איך להפעיל את Qwen Code במסוף ולהגדיר מצב עריכה

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

זה בדיוק מה ש-Qwen Code: סוכן מן המניין. הוא יכול לפתוח קבצים, לערוך אותם ולהריץ פקודות בעצמו. התנהגותו תלויה במצב האישור הפעיל: Ask Permissions מבקש אישור, ואילו Auto-Edit ו-Auto מאפשרים עבודה עצמאית יותר. בדקו את שורת המצב במקום להניח שמצב בשם Default הוא הבחירה הראשונית בהתקנה. בהמשך, לפי הסדר: התקנה, הפעלה בפרויקט, חיבור מודל אחרי השינויים באפריל, ומעבר למצב שבו הסוכן עורך קוד בלי לשאול שאלות מיותרות. הכול נבדק מול התיעוד הרשמי של Qwen נכון ל-30 באוגוסט 2026.

משאבים מעשיים על מודלים וסוכנים: התיעוד של Ailoot.

מה פירוש הדבר ש״Qwen Code כותב קוד בעצמו״?#

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

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

מכאן נובע הבלבול בשאלה. ״Qwen לא כותב קוד בעצמו״ פירושו כמעט תמיד אחד משני דברים: או שהאדם פתח צ'אט בדפדפן במקום את סוכן המסוף, או שהסוכן פועל אבל מוגדר למצב שבו הוא מבקש רשות לפני כל עריכה. את הראשון פותרים בהתקנת Qwen Code; את השני, בהחלפת מצב. שני הפתרונות מוסברים בהמשך.

איך מתקינים את Qwen Code במסוף?#

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

ב-macOS וב-Linux, פתחו את המסוף והדביקו שורה אחת:

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

ב-Windows, עשו אותו דבר באמצעות פקודת PowerShell הזאת:

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

האפשרות השנייה היא npm, אם הוא כבר מותקן אצלכם. נדרשת גרסה 22 ואילך של Node.js:

npm install -g @qwen-code/qwen-code@latest

לאחר ההתקנה, הפעילו מחדש את המסוף. המתקין מוסיף את הפקודה qwen לנתיבי המערכת, והמסוף לא יכיר אותה עד שתפעילו אותו מחדש — זו הסיבה הנפוצה ביותר להודעה ״התקנתי, אבל הוא לא מוצא את הפקודה״. כדי לבדוק שהכול הותקן, הריצו:

qwen --version

אם מופיע מספר גרסה, הסוכן מותקן ומוכן להפעלה בפרויקט שלכם.

איך מפעילים את Qwen Code בפרויקט?#

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

cd path-to-your-project
qwen

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

what does this project do?

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

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

qwen -p "reread README and update the list of commands"

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

למה הסוכן פועל אבל לא עושה שום דבר בעצמו?#

המכשול הראשון הוא הגישה למודל. בעבר Qwen Code הציע גישה בחינם: התחברתם באמצעות חשבון qwen.ai והסוכן עבד בלי כרטיס אשראי. הגישה הזאת נקראה Qwen OAuth והופסקה. בתיעוד האימות נאמר זאת במפורש: מסלול Qwen OAuth החינמי הופסק ב-15 באפריל 2026; כניסות שנשמרו קודם לכן עשויות להמשיך לעבוד לזמן קצר, אבל השרת דוחה בקשות חדשות. גם האפשרות ״להיכנס עם qwen.ai״ הוסרה מהתפריט.

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

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

איך מחברים מודל עכשיו, לאחר שהגישה החינמית נסגרה?#

בסוכן, הקלידו את הפקודה:

/auth

ייפתח תפריט עם שלוש אפשרויות עיקריות. הנה מה שכל אחת מהן עושה.

Alibaba ModelStudio היא האפשרות הרשמית של יוצרי Qwen. היא מציעה Coding Plan במחיר קבוע ובמכסה שבועית למפתח יחיד, Token Plan בתשלום לפי שימוש לצוותים, ואפשרות לחבר מפתח ModelStudio קיים. זו גישה בתשלום למודל ה״מקורי״ של Qwen.

ספקי צד שלישי מאפשרים לבחור ספק מובנה ולהתחבר באמצעות מפתח. הרשימה הרשמית כוללת את DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope ואחרים. קבלו מפתח מהספק, הזינו אותו, והסוכן ישתמש במודל של אותו ספק.

Custom Provider מחבר שרת, פרוקסי או מנוע מקומי משלכם. כאן מחברים מודל שפועל במחשב שלכם באמצעות Ollama. האפשרות הזאת תומכת בפורמטים של OpenAI,‏ Anthropic ו-Gemini, ולכן היא עובדת כמעט עם כל שיטת גישה.

אפשר גם להזין את המפתח ואת ההגדרות ידנית בקובץ ~/.qwen/settings.json. יש בו את השדה modelProviders (המודלים הזמינים), env (המפתחות עצמם), security.auth.selectedType (הפרוטוקול שיופעל בהפעלה) ו-model.name (מודל ברירת המחדל). לאחר מכן qwen יופעל עם ההגדרות האלה ולא ישאל דבר. בפעם הראשונה קל יותר להשתמש ב-/auth; תוכלו לחזור לקובץ כשתרצו לשמור את כל ההגדרות.

כדי לראות מה נשאר בחינם אחרי אפריל, קראו את המאמר על Qwen Code בחינם.

באיזה מצב כדאי להשתמש כדי שהסוכן יערוך קוד בעצמו?#

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

אם הסוכן רק מציג לכם עריכות וממתין, סביר שהוא נמצא במצב Ask Permissions (שנקרא Default בגרסאות ישנות יותר). אז צריך לאשר ידנית כל עריכה ופקודה, מה שגורם לתחושה שהוא לא עושה דבר בעצמו.

כדי שיערוך קבצים בלי לבקש אישור, עברו ל-Auto-Edit. העריכות יתבצעו אוטומטית, אבל הסוכן עדיין יבקש אישור לפני הפעלת פקודות — אמצעי הגנה הגיוני מפני הרצה מקרית של rm במקום הלא נכון.

Auto משתמש במעריך פנימי לפעולות שדורשות הערכה. בחרו בו במכוון אחרי בדיקת הגרסה המותקנת והמצב הפעיל; המילה default שנשמרה בתצורת Ask Permissions היא שם לתאימות, ולא הוכחה שזהו מצב ההפעלה הראשוני.

YOLO הוא המצב המתירני ביותר. הסוכן עורך קבצים ומריץ פקודות בעצמו, בלי לשאול דבר. לפי התיעוד, הוא מיועד רק לפרויקטים אישיים מהימנים ולתהליכי עבודה אוטומטיים. קל לקבל תוצאה לא רצויה בפרויקט עבודה, לכן הפעילו אותו רק כשאתם צלולים, ועדיף בעותק.

איך מחליפים מצבים במהלך הפעלה?#

אפשר להחליף מצבים תוך כדי עבודה, באמצע משימה. לחצו על Shift+Tab כדי לעבור למצב הבא. ב-Windows מקש Tab הרגיל עושה את אותו הדבר. המחזור הוא: Plan, אחר כך אישורים, אחר כך עריכות אוטומטיות, אחר כך Auto, אחר כך YOLO, ואז חזרה ל-Plan.

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

למתחילים מומלץ לעבוד בשלושה שלבים:

1. הפעילו את הסוכן במצב Plan ובקשו ממנו לנתח את המשימה ולהציע תוכנית. הוא לא ייגע בדבר; הוא רק יקרא את הקוד ויתאר מה בכוונתו לעשות.
2. קראו את התוכנית, ואם אתם מסכימים, עברו ל-Auto-Edit או ל-Auto בלחיצה על Shift+Tab.
3. אמרו לו להמשיך. כעת הסוכן יערוך קבצים בעצמו בזמן שאתם עוקבים אחר התוצאות.

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

הגישה המלאה ל-vibe coding מבוססת על השיטה; הכלי משני. Qwen,‏ Claude או כל כלי אחר — אפשר להחליף את המודל שפועל מתחת למכסה המנוע. שלושה יסודות עוזרים לשמור על התוצאות כשמחליפים מודלים: שיבוט בינה מלאכותית, מוח שני והנדסת הקשר. יחד הם מניבים תוצאות צפויות; אין לכך קשר למזל חד-פעמי.

מודל מקומי בלי כרטיס אשראי#

התקינו במחשב מודל פתוח באמצעות Ollama או vLLM, ואז חברו אותו כ-Custom Provider מתפריט /auth. לאחר מכן הסוכן ישתמש במודל שפועל במחשב שלכם במקום בענן של Alibaba. אין צורך בכרטיס אשראי או במפתחות, ואין מגבלה על מספר הבקשות. כדי לראות אילו מודלים פתוחים מתאימים לכתיבת קוד, קראו את הסקירה הזאת על מודלים חינמיים לכתיבת קוד.

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

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

מה אפשר לעשות כדי למנוע מהסוכן לשבור את הפרויקט?#

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

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

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

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

שלושת ההרגלים האלה מתמודדים עם החשש העיקרי — ״כתבתי קוד באווירת vibe ושברתי אותו״. למידע נוסף על החזרת שינויים ב-vibe coding, קראו את הסקירה הנפרדת הזאת. היא עוסקת ב-Claude Code, אבל העיקרון של שימוש ב-git זהה לחלוטין.

מאיפה כדאי להתחיל במשימה שלכם?#

הנה התהליך כולו כרשימה קצרה. פעלו לפי הסדר, מלמעלה למטה:

1. התקינו את Qwen Code בפקודה אחת והפעילו מחדש את המסוף.
2. עברו לתיקיית הפרויקט באמצעות cd והריצו qwen.
3. חברו מודל דרך /auth: תוכנית בתשלום או מודל מקומי באמצעות Ollama, אם תשלום בכרטיס אינו אפשרי.
4. תנו לסוכן משימה במצב Plan וקראו את התוכנית שלו.
5. עברו ל-Auto-Edit או ל-Auto בלחיצה על Shift+Tab ותנו לו לעבוד.
6. נהלו את הפרויקט באמצעות git כדי שתוכלו לבטל כל עריכה.

בקיצור, ״Qwen לא כותב קוד בעצמו״ פירושו כמעט תמיד שאין מודל מחובר או שהסוכן נמצא במצב אישורים. את הבעיה הראשונה פותרים בתפריט /auth, ואת השנייה בלחיצה על Shift+Tab עד שמגיעים ל-Auto-Edit. אחרי זה הסוכן באמת עובד בעצמו במסוף.

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

הגישה המלאה ל-vibe coding מבוססת על השיטה, והסוכן הספציפי משני: שיבוט בינה מלאכותית, בתוספת מוח שני והנדסת הקשר. אפשר להחליף את הכלי שפועל מתחת למכסה המנוע; השיטה נשארת זהה. משאבים מעשיים: התיעוד של Ailoot.

משאבים וכלים נוספים: Ailoot.