איך לעבור מ-Claude Code ל-Codex ב-2026: מדריך שלב אחר שלב

תיעוד Ailoot: API, מפתחות והגדרה.

למה בכלל צריך את כלי Migration של Codex?#

OpenAI הוסיפה את התכונה ל-Codex בתחילת יוני 2026. יומן השינויים הרשמי מתאר אותה בקצרה:

במילים אחרות: בהפעלה הראשונה של Codex App, או דרך ההגדרות של לקוח שכבר פועל, מופעל אשף שקורא את התצורות המקומיות של סוכן אחר. כרגע יש תמיכה ב-Claude Code וב-Claude Cowork.

ברור מדוע OpenAI עושה זאת. אחרי השקת Sites ועדכון Codex App במאי–יוני 2026, Codex קיבלה את כל מה שהיה ל-Claude Code על פני OpenAI: מסוף, תוספים, הפעלות ארוכות ותזמור. ההגירה מסירה את המחסום האחרון עבור צוותים שכבר שילבו את Claude Code בערימה שלהם: "אפשר לייבא הגדרות נתמכות ואז לבדוק אותן מול רשימת המלאי המקורית."

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

מה כלי Migration מעביר אוטומטית?#

אעבור על הקבוצות ואסביר בדיוק מה קורה לכל חלק ב-~/.claude.

1. הוראות והקשר. קובצי CLAUDE.md — הקובץ הגלובלי ב-~/.claude/ וקובצי הפרויקט במאגרים — מומרים לפורמט AGENTS.md. הקובץ הגלובלי מגיע ל-~/.codex/AGENTS.md; קובצי הפרויקט נשארים בשורש המאגר ובתיקיות הבנות. פורמט AGENTS.md הוא למעשה אותו סוג של קובץ Markdown עם כללים; ההבדלים בעיקר קוסמטיים — שמות סעיפים וכמה הנחיות ספציפיות. הסברתי מהו AGENTS.md ולמה Codex זקוקה לו.

2. מיומנויות. תיקיית ~/.claude/skills/ נסרקת במלואה; כל מיומנות מותאמת למבנה של Codex וממוקמת ב-$HOME/.agents/skills. מיומנויות פרויקט מ-.claude/skills/ שבמאגר מועברות ל-.agents/skills. הפורמט SKILL.md עם frontmatter מועבר כמעט כפי שהוא. אם מיומנות משתמשת בטריגרים ייחודיים ל-Claude, היא מסומנת לבדיקה.

3. שרתי MCP. תצורת .mcp.json (גם הגלובלית וגם זו שברמת הפרויקט) מיובאת לפורמט של Codex. שמות השרתים, פקודות ההפעלה והנתיבים נשמרים. מה לא מועבר: אסימונים ומשתני סביבה. מטעמי אבטחה, Codex תבקש מכם שוב מפתחות API וסיסמאות כדי שלא ייחשפו במהלך ההגירה. זו משימה חד-פעמית: פתחו את סעיף MCP ב-Codex App והזינו את האסימונים שכבר שמורים אצלכם במנהל הסיסמאות.

4. Hooks. זו הקבוצה המסובכת. Hooks עם לוגיקה דטרמיניסטית (חסימת rm -rf, התרעה על נתיבים שנראים כמו פרטי גישה, תיעוד ראיות) מועברים במלואם. Hooks עם טריגרים שאין להם מקבילה ב-Codex (למשל, אירועים ספציפיים במחזור החיים של Claude Code) מסומנים כ"בדיקה ידנית" ואינם מופעלים אוטומטית. הסברתי בפירוט איך hooks פועלים ב-Claude Code, כנקודת ייחוס — ל-Codex יש פחות סוגים.

5. היסטוריית הפעלות. עד 30 הימים האחרונים של פעילות Claude Code מיובאים לעיון. אין פירוש הדבר "להמשיך בדיוק מהמקום שבו הפסקתם", אבל השיחות הקודמות שלכם יהיו זמינות ב-Codex, כך שתוכלו להיזכר במהירות בהקשר של פרויקט בלי להסביר הכול מחדש.

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

מה לא מועבר, ולמה?#

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

אסימוני MCP ומפתחות API. זה החלק הצפוי ביותר. אחרי הסריקה, Codex תציג רשימה של כל שרתי MCP שמצאה ב-Claude. היא תבקש מפתחות ואסימונים עבור כל אחד מהם. הכי קל להחזיק את מנהל הסיסמאות בהישג יד ולעבור על כל השרתים ברצף. לאחר מכן, MCP פועל באופן זהה ב-Codex וב-Claude Code. בדקו את הפקודה ואת פרמטרי החיבור של שרת ה-MCP שבחרתם מול התיעוד שלו.

פקודות slash /name. ב-Claude Code אתם רגילים להפעיל מיומנות באמצעות /skill-name. ב-Codex, אופן ההפעלה הקנוני שונה: $skill-name. טעות הגירה נפוצה היא להתייחס לפקודות /name כהוכחה לכך שהמיומנויות נטענו.

אחרי ההגירה, בדקו כמה מיומנויות מרכזיות באמצעות $skill-name ב-Codex. אם הן פועלות, ההגירה באמת הצליחה. אל תסמכו על תיבת הסימון "המיומנויות הועברו" באשף — אמתו זאת באמצעות הפעלתן.

Hooks בלי מקבילה ב-Codex. אם היה לכם hook לאירועים ספציפיים של Claude Code — למשל, ב-pre-tool-use עבור שילוב מסוים של כלים — ייתכן שלטריגר הזה אין מקבילה ב-Codex. כלי Migration יסמן אותם וישאיר אותם לא פעילים. תצטרכו להחליט אם לשכתב אותם כך שיתאימו ל-Codex, לוותר עליהם או להשאיר אותם ב-Claude Code (אם אתם מפעילים אותה במקביל). כלל טוב: העבירו רק hooks דטרמיניסטיים; כל השאר הם סיבה לא לשכפל את המערכת בכלי החדש.

תהליכי צוות המבוססים על תתי-סוכנים. הסברתי מהם תתי-סוכנים ב-Claude Code ואיך להשתמש בתתי-סוכנים מקוננים. ב-Codex, תתי-סוכנים מאורגנים באמצעות פרופילים ותפקידים (ראו בהמשך). אם הייתה לכם ב-Claude צינור מורכב עם כמה תתי-סוכנים ברצף, תצטרכו לשכתב אותו סביב רעיון הפרופילים של Codex. כלי Migration מסמן הגדרות כאלה כ"דורשות עיצוב מחדש ארכיטקטוני".

קובצי CLAUDE.md גדולים וייחודיים ל-Claude. אם קובץ גדל ל-2,000–3,000 שורות עם סעיפים לכל פרויקט, Codex אולי תקבל אותו, אבל זה דפוס גרוע. AGENTS.md נועד להיות קומפקטי ומבוזר: כללים גלובליים ב-~/.codex/AGENTS.md, כללים ייחודיים לפרויקט בשורש המאגר וחריגות ממוקדות בתיקיות הבנות. אחרי ההגירה, אל תשאירו את CLAUDE.md כ"קובץ הוראות ענק"; פצלו אותו בין הרמות. הסברתי איך להגדיר נכון את CLAUDE.md; אותה גישה מתאימה גם ל-AGENTS.md.

שלב אחר שלב: 4 פעולות ב-Codex App#

הנה רשימת הבדיקה המפורטת.

1. שלב 1: עדכנו את Codex App לגרסה 26.608 ואילך

   כלי Migration הופיע בגרסה 26.608 (שפורסמה ב-9 ביוני 2026). ב-macOS, פתחו את Codex App ובדקו אם יש עדכונים. עשו אותו דבר ב-Windows. אם אתם מפעילים את Codex CLI, ודאו שהיא תואמת ל-App הנוכחית. בלי הגרסה העדכנית ביותר, האפשרות "Import other agent setup" לא תופיע ב-Settings.

2. שלב 2: התחילו את הייבוא דרך Settings

   ב-Codex App, פתחו את Settings וחפשו את "Import other agent setup." אם התקנתם עכשיו את Codex App, האשף יציע הגירה במהלך ההגדרה הראשונית. לאחר ההפעלה, האשף סורק את מערכת הקבצים: ~/.claude/ ומאגרים שמכילים CLAUDE.md או .claude/. הסריקה נמשכת מ-30 שניות ועד כמה דקות, בהתאם למספר הקבצים.

3. שלב 3: אשרו את תוכנית ההגירה

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

4. שלב 4: המתינו לסיום והזינו אסימונים

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

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

• cat ~/.codex/AGENTS.md — האם הכללים הגלובליים שלכם נמצאים שם?
• הפעילו מיומנות כלשהי: $skill-name. היא אמורה להיטען.
• פתחו את .mcp.json בפרויקט ובדקו שהשרתים הנדרשים פועלים.
• התחילו שיחה שמייצגת את אופן העבודה הרגיל שלכם. Codex תראה באילו hooks מיובאים היא אינה יכולה להשתמש; אלה פריטים מסוימים ברשימת המלאי שדורשים טיפול ידני; לא נקבע שיעור קבוע של עבודה שנותרת.

Hooks ותתי-סוכנים: מקבילות ב-Codex ומה צריך לשכתב#

Hooks. ב-Claude Code אפשר לשייך פקודת shell לכל אירוע במחזור החיים (pre-tool-use, post-tool-use, on-error, on-context-load וכן הלאה). ל-Codex יש קבוצה קטנה יותר של אירועים: היא יכולה לבדוק לפני ההרצה, לתעד ראיות ולחסום פקודות מסוכנות. אם היה לכם hook מסוג pre-tool-use שסינן לפי שילוב מסוים, ב-Codex תצטרכו לעטוף אותו בבדיקה כללית לפני ההרצה או לוותר עליו. הסברתי בפירוט את הארכיטקטורה של hooks ב-Claude Code; אם השתמשתם בהם בהיקף נרחב, רשמו כל טריגר ואת ההשפעה הדרושה, מצאו מקבילה נתמכת ואמתו אותה לפני ההפעלה.

תתי-סוכנים. ב-Claude Code, תת-סוכן הוא הקשר נפרד עם הנחיית מערכת משלו, שמופעל באמצעות /command או מתוך השיחה הראשית. ל-Codex יש רעיון דומה בפרופילים: אפשר להגדיר פרופיל עם קבוצה מסוימת של מיומנויות, הרשאות ומדיניות אישור. פרופילים פותרים בקירוב את אותה בעיה — בידוד הקשר עבור סוג מסוים של משימות — אך באמצעות הגדרות ולא הפעלה מפורשת של סוכן.

מה פירוש הדבר בפועל:

• אם היה לכם תת-סוכן "security-reviewer" עם הנחיה משלו, צרו ב-Codex פרופיל security-review עם ההרשאות הנדרשות ורמת מאמץ חשיבה גבוהה יותר.
• אם היה לכם תת-סוכן "feature-developer", זה פשוט פרופיל עבודה כברירת מחדל; לא נדרש דבר מיוחד.
• אם השתמשתם בתתי-סוכנים מקוננים, הדבר לא יעבוד אחד לאחד ב-Codex; חשבו עליו מחדש באמצעות שרשרת פרופילים או מיומנויות מפורשות.

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

מתי לעבור לחלוטין ומתי להשאיר את שני הכלים#

מסנן החלטה פשוט:

מעבר מלא ל-Codex הגיוני אם:

• אתם עוסקים בעיקר בבקשות PR אוטונומיות ובמשימות מקבילות.
• תהליך העבודה שלכם ב-GitHub משולב עמוק, ו-Codex Cloud Agent מטפל ב-80% מהעבודה.
• אינכם מקדישים זמן רב לדיונים ארכיטקטוניים ול-Plan Mode.
• אתם רוצים לשלם על כלי אחד במקום על שניים.

השאירו את Claude Code ואת Codex יחד אם:

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

אני אישית משתמש בשניהם: Claude Code שומרת את השיחה הארוכה, ואילו Codex מטפלת ב"תיקון N באגים במקביל" או ב"סקירת PR". הסברתי עוד על כך במדריך לעבודה משותפת עם Claude Code ו-Codex.

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

אם אתם זקוקים לגישה לרשתות נוירונים דרך Ailoot, בקרו ב-Ailoot.