המדריך המלא לקודקס: שורת הפקודה החכמה של OpenAI

מה זה קודקס

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

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

הכלי הוא קוד פתוח, כתוב ב-Rust, וזמין ב-Windows, ב-macOS וב-Linux.

מה קודקס יודע לעשות

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

במה זה שונה מצ'אט רגיל

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

בקודקס אתם אומרים מה צריך, והוא עושה את זה בפועל על הקבצים. הוא רואה את השגיאות בעצמו, מריץ שוב, ומתקן.

זה כל היופי, הוא עושה בדיוק את התפקיד של המתכנת.

איפה קודקס רץ

יש לקודקס כמה גרסאות:

כולן מתחברות לאותו חשבון ומשתמשות באותה מכסה.

מה צריך לפני שמתחילים

1. חשבון ChatGPT בתוכנית שכוללת קודקס. נכון להיום זה Plus, Pro, Business, Edu ו-Enterprise. אפשר גם להתחבר עם מפתח API ולשלם לפי שימוש.
2. מערכת הפעלה נתמכת. ב-Windows מומלץ Windows 11. Windows 10 עובד רק אם הוא מעודכן, מגרסה 1809 ומעלה.
3. גיט מותקן, אם אתם עובדים על פרויקט עם היסטוריה.
4. חיבור לאינטרנט.

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

בפעם הראשונה שתריצו codex הוא יבקש מכם להתחבר. בוחרים Sign in with ChatGPT, נפתח דפדפן, מתחברים, והטוקן חוזר לטרמינל לבד.

אם אתם רוצים להתחבר ידנית:

codex login

אם הדפדפן לא נפתח, או שאתם על מחשב מרוחק בלי ממשק גרפי:

codex login --device-auth

לבדוק באיזה חשבון אתם מחוברים:

codex login status

להתנתק:

codex logout

נכנסים לתיקיית הפרויקט ומריצים:

cd C:\path\to\your-project
codex

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

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

אפשר גם לתת לו משימה כבר מהשורה:

codex "תקן את הבאג בטופס ההרשמה"

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

לדוגמא, הרצה נוחה ובטוחה:

codex --sandbox workspace-write --ask-for-approval on-request

באמצע העבודה אפשר לשנות עם /permissions.

יש גם דגל --dangerously-bypass-approvals-and-sandbox, שנקרא גם --yolo. הוא מבטל הכל. אל תשתמשו בו על המחשב האישי שלכם. הוא נועד למכונות מבודדות בלבד.

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

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

יוצרים אותו מתוך הסשן:

/init

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

• תעבדו תמיד בתוך גיט. לפני שאתם נותנים לו לשנות משהו, תוודאו שהכל מקומם. ככה כל טעות שלו היא ביטול אחד במרחק פקודה. אם קודקס עשה בלגן ואתם לא בגיט, אין לכם דרך חזרה.
• תבקשו תוכנית לפני ביצוע. /plan על משימה גדולה שווה יותר מעשר תיקונים אחר כך.
• תבדקו לפני שאתם סוגרים. /diff ואז /review. הוא טועה, בדיוק כמו כל אחד.
• תהיו ספציפיים. "תשפר את האתר" זאת בקשה שלא אומרת כלום. "תקטין את הפונט בכותרת הראשית ל-32 פיקסל ותוסיף רווח של 24 פיקסל מתחתיה" זאת בקשה שהוא יבצע מדויק. אם קיבלתם תשובה לא טובה, כתבתם פרומפט לא טוב.
• תפרקו משימות גדולות. במקום "תבנה לי אתר", תעשו קובץ אחד, תבדקו, תמשיכו.
• תכתבו AGENTS.md פעם אחת. זה חוסך לכם חזרה על אותן הוראות בכל שיחה.
• תשתמשו ב-/compact בשיחות ארוכות. ההקשר נגמר, והוא מתחיל לשכוח דברים מההתחלה.
• תתחילו ב-read-only. רק כשאתם סומכים עליו תעלו לרמה הבאה.

עדכון, לפי איך שהתקנתם:

codex update

או, בהתקנה דרך הסקריפט הרשמי, פשוט מריצים אותו שוב.

npm update -g @openai/codex

brew upgrade --cask codex

הסרה:

npm uninstall -g @openai/codex

brew uninstall --cask codex

הגדרות ופרטי התחברות יושבים בתיקייה .codex בתיקיית הבית שלכם.

פתרון תקלות

"codex is not recognized as the name of a cmdlet"

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

שמתם את הפקודה בתוך מרכאות והיא רק הודפסה

זאת טעות שקורית להמון אנשים. אם תכתבו:

"irm https://chatgpt.com/codex/install.ps1 | iex"

העתקה

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

"The property 'OSArchitecture' cannot be found on this object"

זאת השגיאה שאני עצמי נתקעתי עליה. השגיאה מגיעה עם PropertyNotFoundStrict, מה שאומר שסקריפט ההתקנה רץ במצב מחמיר ולא מצא מאפיין שהוא ציפה לו.
הסיבה הכי סבירה: אתם ב-Windows PowerShell 5.1 הישן, וסקריפט ההתקנה מצפה ל-PowerShell 7.
הפתרון:

winget install --id Microsoft.PowerShell -e

העתקה

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

$PSVersionTable.PSVersion

העתקה

צריך להופיע 7 משהו. רק אז מריצים את ההתקנה שוב.

"running scripts is disabled on this system"

מדיניות ההרצה של Windows חוסמת סקריפטים. תריצו ככה:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

העתקה

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

התקנתם דרך npm וקודקס לא עושה כלום

בדקו מה בדיוק התקנתם. npm i -g codex מתקין חבילה אחרת לגמרי שאין לה שום קשר ל-OpenAI. הפקודה הנכונה היא:

npm install -g @openai/codex

העתקה

npm מתלונן על גרסת Node

ההתקנה דרך npm דורשת Node.js מודרני. תבדקו:

node --version

העתקה

אם אתם מתחת ל-22, תעדכנו. אם אתם לא רוצים להתעסק עם Node בכלל, תשתמשו בסקריפט ההתקנה הרשמי או ב-Homebrew, הם מתקינים קובץ הרצה עצמאי בלי תלות ב-Node.

שגיאות הרשאה בהתקנה דרך npm

ב-macOS וב-Linux, אם קיבלתם EACCES, אל תרוצו ישר ל-sudo. עדיף להגדיר תיקיית npm גלובלית בתוך תיקיית הבית שלכם, או להשתמש במנהל גרסאות כמו nvm.

הדפדפן לא נפתח בהתחברות

codex login --device-auth

העתקה

זה נותן לכם קוד להקליד בדפדפן, במקום ניסיון לפתוח חלון אוטומטית.

התחברתם לחשבון הלא נכון

codex login status
codex logout
codex login

העתקה

שימו לב שקודקס ב-CLI ובתוסף ל-IDE משתפים את אותם פרטי התחברות.

"codex not found" בתוך WSL

התקנתם ב-Windows אבל אתם מריצים בתוך Linux. אלה שתי סביבות נפרדות. בדקו:

which codex || echo "codex not found"

העתקה

ואם הוא לא שם, תריצו את סקריפט ההתקנה מתוך ה-WSL.

הסנדבוקס ב-Windows נכשל בהתקנה

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

[windows]
sandbox = "unelevated"

העתקה

זה נכנס לקובץ config.toml בתיקיית .codex.

שגיאת Windows 1385

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

קודקס מזהיר שתיקיות פתוחות לכתיבה לכולם

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

פקודה בתוך הסנדבוקס לא מצליחה לקרוא תיקייה

ב-Windows יש פקודה בדיוק בשביל זה:

/sandbox-add-read-dir C:\absolute\directory\path

העתקה

הנתיב חייב להיות מוחלט ולהיות קיים.

פקודות בסנדבוקס לא מגיעות לרשת

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

"not a git repository"

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

codex exec --skip-git-repo-check "..."

העתקה

codex update נכשל ב-Windows

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

התוסף ל-IDE מותקן ולא מגיב

חסרים כלי פיתוח של C++ שחלק מהתלויות דורשות:

winget install --id Microsoft.VisualStudio.2022.BuildTools -e

העתקה

אחר כך לסגור ולפתוח את VS Code לגמרי.

הכל איטי ב-WSL

תוודאו שהפרויקט לא יושב תחת /mnt/c. תעבירו אותו לתיקיית הבית של Linux, ותעדכנו את WSL:

wsl --update
wsl --shutdown

העתקה

winget לא מוכר

חבילת ה-Windows Package Manager חסרה או ישנה. תעדכנו את Windows, או תתקינו את App Installer מחנות מיקרוסופט.

קודקס מתחיל לשכוח דברים באמצע

ההקשר התמלא. תריצו /compact והוא יסכם את השיחה וישחרר מקום. במשימה חדשה לגמרי עדיף /new.

הוא עשה שינוי שלא רציתם

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

שום דבר לא עוזר

מתוך הסשן:

/feedback

העתקה

וב-Windows, אם הבעיה היא בסנדבוקס, הלוג יושב ב-.codex/.sandbox/sandbox.log. אל תשלחו את התוכן של .sandbox-secrets.

שאלות נפוצות

קודקס עולה כסף בנפרד?

לא, אם יש לכם ChatGPT בתוכנית שכוללת אותו. השימוש נספר לכם במכסה של החשבון. אפשר גם לעבוד עם מפתח API, ואז משלמים לפי שימוש בתעריפי ה-API הרגילים.

אפשר לכתוב לו בעברית?

כן.

הוא רואה את כל המחשב שלי?

לא. הוא עובד בתיקייה שפתחתם בה את הסשן, לפי מצב הסנדבוקס. אפשר להוסיף תיקיות עם --add-dir.

צריך לדעת לתכנת?

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

מה ההבדל בין קודקס לקלוד קוד?

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

סיכום

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

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

אהבתם את המדריך? מוזמנים לעקוב אחריי באינסטגרם @moshe.elkrief לעוד תכנים.