קלוד קוד וקודקס: המדריך לחיבור ולמעבר בין שני סוכני קוד

מאת ירון דויטשר עודכן לאחרונה: 20 בספטמבר 2026

למה צריך מדריך נפרד למי שכבר בקלוד קוד

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

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

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

הדבר האחד שהשתנה ב-18 בספטמבר

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

בגרסה 2.1.277, שיצאה ב-18 בספטמבר 2026, קלוד קוד התחיל לקרוא גם AGENTS.md: בפרויקט שאין בו CLAUDE.md כלל, הוא נופל ל-AGENTS.md במקומו. מחליפים את ההתנהגות תחת ״Project instructions״ בפקודה ‎/config‎. שווה לדעת שזה עדיין לא חל על Bedrock, על Vertex ועל Foundry.

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

הזהירות היחידה: הנפילה ל-AGENTS.md קורית רק כשאין CLAUDE.md. אם השארתם קובץ ישן במאגר, קלוד קוד ימשיך לקרוא אותו ויתעלם מהשני, ותבלו ערב בלתרץ למה ההנחיות לא נתפסות.

מפת התרגום

מה שאתם מכירים בקלוד קוד	המקבילה בקודקס	עד כמה זה באמת אותו דבר
`CLAUDE.md`	`AGENTS.md`	קרוב מאוד. אותו Markdown חופשי, מנגנון חיפוש שונה
`.claude/settings.json`	`~/.codex/config.toml` ו-‎`.codex/config.toml`‎	אותו תפקיד, פורמט אחר לגמרי
מצבי הרשאה	`approval_policy` יחד עם `sandbox_mode`	שני צירים נפרדים במקום אחד. כאן נופלים
סקילים ב-‎`.claude/skills`‎	סקילים ב-‎`.agents/skills`‎	אותו שלד קובץ, נתיב אחר, מפעילים בדולר ולא בלוכסן
סוכני משנה ב-Markdown	סוכני משנה ב-TOML	אותו רעיון, כתיבה שונה
שרתי MCP	שרתי MCP	כמעט זהה, וההגדרה בקודקס משותפת לשלושה לקוחות
‎`claude --resume`‎	‎`codex resume`‎	אותו דבר
‎`claude -p`‎	‎`codex exec`‎	אותו דבר
‎`/init`‎, ‎`/status`‎, ‎`/model`‎, ‎`/review`‎	אותם שמות בדיוק	מפתיע, אבל כן

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

מה עובר כמו שהוא

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

שרתי MCP, וכאן קודקס דווקא נוח יותר: מוסיפים שרת בפקודה ‎codex mcp add‎, רואים את הרשימה ב-‎codex mcp list‎, ולפי התיעוד אפליקציית ChatGPT לדסקטופ, הטרמינל ותוסף ה-IDE חולקים את אותה הגדרה. מי שסבל מהגדרת שרתים מחדש בכל לקוח בנפרד יזהה את השיפור מיד.

הסקילים, כמעט. אותו שלד בדיוק: תיקייה, קובץ SKILL.md, ובראשו frontmatter עם name ו-description, שעליו נשענת ההפעלה האוטומטית. התיעוד של קודקס מפרט את סדר הסריקה: התיקייה הנוכחית, שורש המאגר, רמת המשתמש ואחריהן רמת המערכת. בפועל, סקיל שאינו נשען על כלים ייחודיים לקלוד קוד עובר בהעתקת תיקייה.

הרגלי העבודה. worktree נפרד למשימה, סשן ברקע, סקירת קוד לפני מיזוג. יש לזה מקבילות, ויש גם ‎/worktree‎ כפקודה מובנית.

מה נראה זהה ומתנהג אחרת

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

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

הציר הראשון הוא sandbox_mode, והוא קובע מה מותר מבחינה טכנית:

‎read-only‎: קריאה בלבד
‎workspace-write‎: קריאה, עריכה והרצת פקודות בתוך סביבת העבודה. זו ברירת המחדל בתיקייה שמנוהלת בבקרת גרסאות
‎danger-full-access‎: בלי בידוד ובלי אישורים

הציר השני הוא approval_policy, והוא קובע מתי קודקס עוצר ושואל. ברירת המחדל היא ‎on-request‎: הוא מבקש אישור כדי לערוך מחוץ לסביבת העבודה או כדי לגשת לרשת. יש גם ‎never‎, שמכבה את השאלות, ומבנה granular שמאפשר להחליט לפי קטגוריה. הערך ‎untrusted‎ סומן כמיושן, כך שמדריכים ישנים שמזכירים אותו כבר לא רלוונטיים.

המלכודת היא הצירוף. ‎workspace-write‎ עם ‎never‎ אינו ״כמו מצב אוטומטי״: זה סוכן שעורך בלי לשאול בתוך גבול טכני, ושני המשתנים צריכים להיבחר ביחד ובמודע. התיעוד מפרט גם את האכיפה, והיא אמיתית ולא מוסכמה: Seatbelt במק, ‎bwrap‎ יחד עם ‎seccomp‎ בלינוקס, ובידוד מובנה בווינדוס. ברירת המחדל כוללת חסימת רשת, ופתיחתה היא הגדרה נפרדת תחת ‎[sandbox_workspace_write]‎.

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

מה לא עובר בכלל

ההגדרות הן TOML ולא JSON. הקובץ הוא ~/.codex/config.toml ברמת המשתמש, ו-‎.codex/config.toml‎ ברמת הפרויקט. יש פה פרט שקל לפספס: ההגדרה ברמת הפרויקט נטענת רק בפרויקט מהימן, ובפרויקט שאינו מהימן כל השכבה הזאת מדולגת בשקט. מי שמעתיק הגדרה למאגר חדש ולא מבין למה היא לא תופסת, יחפש במקום הלא נכון.

סוכני המשנה נכתבים ב-TOML. לא Markdown עם frontmatter, אלא קובץ TOML ב-‎~/.codex/agents/‎ או ב-‎.codex/agents/‎, עם שלושה שדות חובה: name, description ו-developer_instructions. הרעיון מוכר לחלוטין, הכתיבה לא, וההגדרות שהעתקתם מקלוד קוד לא יעברו בהעתק-הדבק.

הסקילים לא יושבים איפה שאתם מחפשים. לא ב-‎.codex/skills‎ כפי שההיגיון מכתיב, אלא ב-‎.agents/skills‎. וההפעלה הידנית היא בתו דולר בטרמינל, לא בלוכסן.

פקודות שאין להן מקבילה. בקודקס יש פקודות שלא תמצאו בקלוד קוד, כמו ‎/reasoning‎ לרמת החשיבה או ‎/cloud‎ להעברת הסשן לענן. גם הכיוון ההפוך נכון. כדאי להתחיל בהרצת ‎/status‎ ולראות מה בעצם פעיל אצלכם.

עשר הדקות הראשונות

התקנה: ‎curl -fsSL https://chatgpt.com/codex/install.sh | sh‎ במק ובלינוקס. אותה פקודה מעדכנת גרסה
כניסה: בהרצה הראשונה בוחרים ״Sign in with ChatGPT״
פותחים תיקיית פרויקט ומריצים ‎codex‎
קובץ ההנחיות: אם יש לכם CLAUDE.md טוב, זה הרגע להמיר אותו ל-AGENTS.md. שני הכלים יקראו אותו, ובלבד שלא יישאר CLAUDE.md לצידו
ההרשאות: מריצים ‎/permissions‎ ובוחרים את שני הצירים במודע. אל תסמכו על ברירת מחדל שאתם מכירים מכלי אחר
בדיקה אחת: ‎/status‎ כדי לראות מה פעיל, ומשימה קטנה שאתם כבר יודעים איך נראית התוצאה הנכונה שלה

נקודה שחשוב לומר ביושר

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

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

שורה תחתונה

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

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

רוצים את העדכונים האלה לפני שהם מתיישנים? ערכת ההתחלה.

שאלות נפוצות

האם קודקס קורא את הקובץ CLAUDE.md שלי?

לא. קודקס קורא AGENTS.md, ורק אותו. הכיוון ההפוך דווקא כן עובד מאז גרסה 2.1.277 של קלוד קוד (18 בספטמבר 2026): בפרויקט שאין בו CLAUDE.md, קלוד קוד קורא את AGENTS.md במקומו. כלומר הקובץ המשותף לשני הכלים הוא AGENTS.md, ומי שרוצה מאגר אחד שמשרת את שניהם ישאיר AGENTS.md בלבד.

מה ההבדל בין AGENTS.md לבין CLAUDE.md?

מבחינת התוכן, כמעט כלום: שניהם קובץ Markdown חופשי עם כללי העבודה של המאגר. ההבדל הוא במנגנון החיפוש. קודקס מחפש קודם AGENTS.override.md ורק אחר כך AGENTS.md, מצרף את הקבצים משורש ה-git כלפי מטה כך שתיקייה קרובה יותר גוברת, ועוצר כשגודל הקבצים המצטבר מגיע ל-project_doc_max_bytes (ברירת מחדל 32 KiB). אפשר גם להגדיר שמות חלופיים דרך project_doc_fallback_filenames.

אפשר להעביר סקילים מקלוד קוד לקודקס?

ברוב המקרים כן, כי השלד זהה: תיקייה שבתוכה SKILL.md, ובראשו frontmatter עם name ו-description. מה שמשתנה הוא הנתיב ודרך ההפעלה. קודקס סורק את .agents/skills בתיקייה הנוכחית ובשורש המאגר, ואת ‎$HOME/.agents/skills‎ ברמת המשתמש, וקוראים לסקיל בתו דולר ולא בלוכסן. סקיל שנשען על כלים ייחודיים לקלוד קוד יצטרך התאמה.

איך מתקינים את קודקס בטרמינל?

בפקודה אחת במק ובלינוקס: curl -fsSL https://chatgpt.com/codex/install.sh | sh — ואותה פקודה בדיוק גם מעדכנת גרסה. בהרצה הראשונה בוחרים ״Sign in with ChatGPT״, ומשם פותחים תיקיית פרויקט ומריצים codex. הכניסה קשורה למנוי ChatGPT שלכם ולא למנוי נפרד.

קודקס או קלוד קוד, במה כדאי לבחור?

זו שאלה אחרת מזו שהעמוד הזה עונה עליה. כאן מוסבר איך עובדים עם קודקס כשכבר מכירים את קלוד קוד; מי שעדיין מחליט בין השניים ימצא את ההשוואה המלאה, כולל מודלים, עבודה בענן ומחירים, בעמוד ההשוואה: /compare/claude-code-vs-codex/.