CodeGraph ו-Claude Code: איך סוכני AI מפסיקים לגשש בקוד

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

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

מה CodeGraph עושה

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

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

הכול רץ מקומית. הקוד לא עוזב את המחשב.

הנתונים היבשים

• רישיון: MIT, כלומר חינמי וקוד פתוח
• גרסה: 1.4.1, שיצאה ביולי 2026. גרסה 1.0 יצאה ביוני
• שפות: מעל 20, דרך tree-sitter
• אימוץ: כ-61 אלף כוכבים בגיטהאב וכ-380 אלף הורדות בחודש ב-npm
• תמיכה: Claude Code, Cursor, Codex CLI, Gemini CLI ועוד

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

איך מתקינים

npm i -g @colbymchenry/codegraph
codegraph install
cd your-project && codegraph init

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

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

בשורת הפקודה יש גם codegraph explore לחיפוש, ו-codegraph impact שמראה מה יישבר אם תשנו פונקציה מסוימת. השנייה שימושית גם בלי סוכן AI בכלל.

מה שאהבתי בעיצוב

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

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

מה שכדאי לדעת לפני

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

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

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

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

ועכשיו ללולאות של Claude Code

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

הפקודה /loop

השם הרשמי בתיעוד הוא משימות מתוזמנות. הפקודה /loop מפעילה אותן, ויש לה שלושה מצבים:

• /loop 5m check the deploy מריץ את הבדיקה כל חמש דקות
• /loop check the deploy בלי מרווח זמן, ואז Claude מחליט בעצמו מתי לבדוק שוב
• /loop לבד מריץ פרומפט תחזוקה מובנה

המגבלות שחשוב להכיר:

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

הפקודה /goal, שהיא משהו אחר לגמרי

קל להתבלבל, אבל ההבחנה חדה:

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

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

"Workflows" זה לא שם של פיצ׳ר

זה החלק שהכי חשוב לי להגיד: אין ב-Claude Code פיצ׳ר שנקרא Workflows. זה מונח שהקהילה המציאה.

מה שכן קיים ומתועד רשמית:

• Subagents יציב וזמין. סוכני משנה עם חלון הקשר משלהם, שמדווחים בחזרה לסוכן הראשי. מוגדרים כקובץ markdown בתיקיית .claude/agents
• Agent teams ניסיוני, כבוי כברירת מחדל, ודורש הפעלה דרך משתנה סביבה. זה הפיצ׳ר האמיתי של עבודה מקבילה, והתיעוד עצמו ממליץ על שלושה עד חמישה סוכנים בלבד כי העלות גדלה באופן ליניארי
• Routines בתצוגה מקדימה. רצות בענן של Anthropic, וזה ההבדל המהותי: הן ממשיכות לרוץ גם כשהמחשב שלכם כבוי

הערה על תיעוד

התיעוד של Claude Code עבר כתובת. קישורים ישנים מסוג docs.claude.com/en/docs/claude-code מפנים עכשיו ל-code.claude.com/docs. אם אתם מוצאים מדריך שמצטט את הכתובת הישנה, סביר שהוא גם לא מעודכן בתוכן.

שורה תחתונה

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

ולגבי הלולאות: /loop לתזמון, /goal לתנאי סיום, Routines לדברים שצריכים לשרוד סגירת מחשב. ו-Workflows זה לא שם של כלום.

מקורות: CodeGraph בגיטהאב · תיעוד משימות מתוזמנות · תיעוד סוכני משנה