דרור משה אהרוני
EN

ארגז הכלים של היוצר העצמאי

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

סדרת Claude Code — מדריך 2 מתוך 5

הכנת מחשב חדש ל-Claude Code ו-Codex

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

איפה אנחנו בסדרה? המדריך הראשון בסדרה הסביר למה Claude Code הוא תשתית ולא רק כלי. המדריך הזה הוא הצעד הפרקטי הראשון: להכין את המחשב מאפס. אחריו תגיע ארכיטקטורת סביבת העבודה (7 תיקיות ו-CLAUDE.md), אינטגרציה עם Composio MCP, ויועץ ריפואים ב-AI.
חשבונות שצריך לפתוח לפני שמתחילים
  • GitHub (חינם): github.com — נדרש בשלב 3.
  • Anthropic (מנוי בתשלום): claude.ai — נדרש לשלב 5. Claude Code דורש מנוי פעיל; אין גרסת חינם לשימוש ב-CLI.
  • OpenAI (מנוי בתשלום): platform.openai.com — אם רוצים גם את Codex. גם הוא דורש מנוי.

אם התקציב מוגבל: Cursor ו-Antigravity מציעים רמות חינם שמאפשרות להתחיל בלי תשלום. הם לא זהים ל-Claude Code, אבל הם נקודת כניסה סבירה.

1פותחים טרמינל
לומדים מה זה, איפה זה, ואיך מדביקים פקודה.
2מתקינים בסיס
עורך קוד, Git, GitHub CLI ו-Node.js.
3מחברים סוכנים
Claude Code, Codex ו-Bun — מתקינים ומאמתים.
4ממשיכים לפרויקט
רק אחרי שהבסיס יציב, פותחים ריפו וממשיכים למדריך 3.

מה זה טרמינל ולמה צריך אותו

חלון שמדבר עם המחשב בטקסט

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

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

לדוגמה, הפקודה הבאה שואלת את המחשב איזו גרסה של Node.js מותקנת:

node --version

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

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

איך פותחים טרמינל ב-Windows

  1. לחצו על כפתור Start (לוגו Windows).
  2. כתבו PowerShell בשורת החיפוש.
  3. בחרו Windows PowerShell או Terminal.
  4. אל תבחרו "Run as Administrator" אלא אם מדריך רשמי מבקש זאת במפורש.

תראו חלון כהה עם שורה שמסתיימת ב->. שם מדביקים פקודות.

איך פותחים טרמינל ב-Mac

  1. לחצו Command + Space לפתיחת Spotlight.
  2. כתבו Terminal.
  3. לחצו Enter.

תראו חלון עם שורה שמסתיימת ב-$ או %. שם מדביקים פקודות.

כלל בטיחות — חשוב אם פקודה כוללת מילים כמו delete, remove, rm, reset, force — או מבקשת סיסמה, מפתח API או גישה מנהלתית — עצרו ובדקו מה היא עושה לפני שמריצים. ספק לא מוכר ביקש להריץ פקודה? אל תריצו. הורו לסוכן AI להסביר לפני שהוא פועל.

שלבי ההתקנה — 8 שלבים עם בדיקה

התקינו עורך קוד

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

  • VS Code — הבחירה הפשוטה להתחלה. חינם לחלוטין. המקובל ביותר בקרב מפתחים.
  • Cursor — עורך קוד עם AI מובנה; יש רמת חינם מוגבלת ורמות בתשלום. אם אין לכם תקציב ל-Claude Code עכשיו, Cursor הוא חלופה סבירה להתחיל איתה.

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

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

התקינו Git

Git הוא כלי לניהול גרסאות — הוא שומר היסטוריה של כל שינוי בפרויקט ומאפשר לחזור אחורה אם משהו השתבש. תחשבו עליו כ-"Ctrl+Z" שעובד גם אחרי שסגרתם את הקובץ, גם אחרי שבאתם ביום שאחרי. לסוכן ה-AI גם כן חשוב שיהיה Git — הוא שומר את עבודתו דרכו.

הורידו Git מהאתר הרשמי ובצעו את ההתקנה הרגילה. ב-Windows, תראו כמה מסכי wizard — אפשר לאשר את ברירות המחדל בכל שלב.

אחרי ההתקנה, פתחו טרמינל חדש (חשוב לפתוח חדש, לא לסגור ולפתוח שוב את אותו חלון) והריצו:

git --version

הצלחה: מופיעה שורה שמתחילה ב-git version 2. לדוגמה git version 2.49.0. המספר המדויק לא חשוב.

לא מופיע כלום, או רואים "not recognized"? סגרו את הטרמינל לגמרי, פתחו חדש ונסו שוב. Git לפעמים לא מתגלה עד שפותחים חלון טרמינל חדש אחרי ההתקנה. אם עדיין לא עובד, כנסו לאתר ההורדה שוב ובדקו שההתקנה הסתיימה ללא שגיאות.

התקינו GitHub CLI והתחברו

GitHub CLI (בקיצור gh) הוא גשר בין הטרמינל לחשבון GitHub שלכם. GitHub הוא אתר שמאחסן פרויקטי קוד בענן. ה-CLI מאפשר לסוכן ה-AI ליצור ריפואים (repositories — תיקיות פרויקט בענן), לפתוח pull requests, ולבדוק חיבור — הכול מתוך הטרמינל בלי לפתוח דפדפן.

הורידו GitHub CLI ובצעו התקנה רגילה.

בדיקה שההתקנה הצליחה:

gh --version

הצלחה: תראו שורה כמו gh version 2.x.x.

אחר כך התחברו לחשבון GitHub שלכם:

gh auth login

תופיע שאלה לגבי פרוטוקול — בחרו GitHub.com, אחר כך HTTPS, ואחר כך Login with a web browser. הדפדפן ייפתח — אשרו את החיבור.

אם הדפדפן לא נפתח אוטומטית: העתיקו את הקישור שמופיע בטרמינל (משהו כמו https://github.com/login/device) והדביקו אותו ידנית בדפדפן. הכניסו את הקוד שמופיע לצד הקישור.

בדיקה סופית:

gh auth status

הצלחה: מופיע שם המשתמש שלכם ב-GitHub וסטטוס "Logged in to github.com". אם רואים זאת, ה-CLI מחובר ומוכן לעבודה.

התקינו Node.js

Node.js הוא סביבת הרצה שמאפשרת להריץ JavaScript מחוץ לדפדפן. בפשטות: הוא מריץ קוד. רוב כלי ה-AI שנתקין אחר כך (כולל Codex) מגיעים כחבילות Node ונדרשים ש-Node יהיה מותקן קודם. npm (Node Package Manager) הוא מנהל החבילות שמגיע עם Node — תחשבו עליו כ-"App Store" של הטרמינל, שממנו מתקינים כלים בפקודה אחת.

הורידו Node.js מגרסת LTS (LTS = Long Term Support, כלומר גרסה יציבה ומומלצת). בצעו התקנה רגילה.

פתחו טרמינל חדש (חשוב מאוד — הטרמינל הישן לא יזהה התקנות שנעשו בזמן שהוא היה פתוח) והריצו:

node --version
npm --version

הצלחה: שתי שורות שמציגות מספרי גרסה. לדוגמה v24.2.0 ו-10.9.2. Node צריך להיות v18 ומעלה.

אם npm לא מוכר ב-Windows: לפעמים צריך לאשר ל-PowerShell להריץ סקריפטים. הריצו:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

אשרו עם Y אם תישאלו, ואחר כך נסו npm --version שוב.

התקינו Claude Code

תיעוד רשמי של Claude Code

חשוב: Claude Code דורש מנוי Anthropic בתשלום. כניסה עם חשבון חינם לא תעבוד ב-CLI.

Desktop app מול CLI: אם מורידים את אפליקציית Desktop, היא כוללת את ה-CLI — אין צורך להריץ את הפקודות למטה. התקינו את ה-CLI בנפרד רק אם אתם רוצים את הפקודה claude בטרמינל בלי אפליקציית Desktop.

Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Mac
curl -fsSL https://claude.ai/install.sh | bash
מה הפקודות האלה עושות? irm (Windows) ו-curl (Mac) מורידים קובץ התקנה מהאינטרנט, ו-iex / bash מריצים אותו. זה כמו להוריד installer ולהפעיל אותו — רק בשורה אחת. הפקודות מגיעות מהאתר הרשמי של Anthropic, אז בטוח להריץ.

בדיקה:

claude --version
claude doctor

הצלחה: מספר גרסה וסטטוס "healthy" מ-claude doctor.

הפעלה ראשונה והתחברות:

claude

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

ממשקים ומצבי הפעלה של Claude Code

אפשר לעבוד עם Claude Code בשלוש דרכים עיקריות:

  • Terminal CLI: מריצים claude מתוך תיקיית הפרויקט — הדרך הנפוצה ביותר, ועליה מתמקד המדריך הזה.
  • Desktop app: מורידים מ-claude.com/download, נכנסים לחשבון, ופותחים את לשונית Code. ה-CLI כלול — אין צורך בהתקנה נפרדת.
  • Web: claude.ai/code לשימוש בענן או ל-Remote Control.

פקודות הפעלה שימושיות:

claude                          # פתיחה רגילה
claude --continue               # ממשיך שיחה קודמת
claude --permission-mode plan   # מצב מוגן — מתכנן בלי לשנות קבצים
claude --permission-mode acceptEdits  # מאשר עריכות אוטומטית

שני הגדרות קטנות שכדאי לעשות בהתחלה:

  • מצב כהה: הריצו claude config set --global theme dark אם אתם מעדיפים רקע כהה, או שנו ב-Settings (לחצו / ואז בחרו Settings).
  • שפת תגובה: Claude Code מגיב בשפה שבה כותבים לו. כתבו בעברית — תקבלו תשובה בעברית. אין הגדרה נפרדת.
זהירות: מצב מסוכן claude --dangerously-skip-permissions מדלג על כל בקשות האישור ועל בדיקות הבטיחות. משתמשים בו רק בסביבה מבודדת לחלוטין (container, VM) — לא על המחשב הראשי, ובטח לא אם אתם בתחילת הדרך.

התקינו Codex CLI

מקור רשמי: openai/codex ב-GitHub

מה זה Codex? Codex הוא סוכן ה-AI של OpenAI לכתיבת קוד, שמשתמש במודל GPT-5.5. נכון ל-2026, Codex ו-Claude Code נמצאים ברמת יכולת דומה — לכל אחד נקודות חוזק קצת שונות, וכדאי להכיר את שניהם. גם Codex דורש מנוי OpenAI בתשלום. אין גרסת CLI חינמית.

ההתקנה נעשית דרך npm שהתקנתם בשלב 4:

npm install -g @openai/codex

הדגל -g מתקין את הכלי גלובלית — כלומר זמין מכל תיקייה בטרמינל, לא רק מתוך פרויקט ספציפי.

בדיקה:

codex --version

הצלחה: מוצג מספר גרסה.

הפעלה ראשונה:

codex

Codex יבקש התחברות — אפשר להתחבר עם חשבון ChatGPT מתאים או עם API key.

ממשקים ומצבי הפעלה של Codex

פקודות כניסה:

codex login           # התחברות ראשונה
codex login status    # בדיקה שמחובר
codex logout          # יציאה

אם הדפדפן לא נפתח (לדוגמה, שרת מרוחק):

codex login --device-auth

אם משתמשים ב-API key — אל תדביקו אותו ישירות לצ׳אט. השתמשו במשתנה סביבה:

printenv OPENAI_API_KEY | codex login --with-api-key

דרכי עבודה:

  • Terminal CLI: מריצים codex מתוך תיקיית הפרויקט.
  • Desktop app: מריצים codex app — פותח את Codex Desktop ב-macOS/Windows.
  • Web: chatgpt.com/codex — אם התוכנית שלכם כוללת גישה.
codex
codex --sandbox workspace-write --ask-for-approval on-request
codex --search
זהירות: מצב מסוכן codex --dangerously-bypass-approvals-and-sandbox (ידוע גם כ-codex --yolo) מריץ פקודות בלי אישורים ובלי sandbox. משתמשים בזה רק בסביבת runner חיצונית ומבודדת.

התקינו Bun

Bun הוא סביבת הרצה של JavaScript שנבנתה מאפס על מהירות. הוא גם מריץ קוד, גם מתקין חבילות, גם מריץ בדיקות — בחלק מהמשימות הוא מהיר פי 10 מ-Node. הוא נפוץ בפרויקטים חדשים ורוב סוכני ה-AI ציפו שיהיה מותקן. לא צריך להבין אותו עמוק עכשיו — פשוט מתקינים אחת ואחת.

תיעוד רשמי של Bun

Windows PowerShell
powershell -c "irm bun.sh/install.ps1|iex"
Mac
curl -fsSL https://bun.com/install | bash

בדיקה:

bun --version

הצלחה: מוצג מספר גרסה כמו 1.2.x.

לא מוכר? ב-Windows, סגרו ופתחו טרמינל חדש. ב-Mac, הריצו source ~/.zshrc (או source ~/.bashrc אם אתם משתמשים ב-bash) ונסו שוב. אם עדיין לא עובד, כנסו לאתר הרשמי לפתרון תקלות לפי מערכת ההפעלה שלכם.

כלים ספציפיים לפרויקטים — לפי צורך

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

  • Supabase CLI — לפרויקטים עם מסד נתונים, אותנטיקציה ואחסון.
  • Netlify CLI — לפרסום אתרים ואפליקציות ב-Netlify.
  • Playwright — לבדיקות דפדפן אוטומטיות בתוך פרויקט ספציפי.

הערה לעתיד: ב-2026 גוגל ו-xAI (של Elon Musk) נכנסים גם הם לתחום הסוכנים לכתיבת קוד. כלים נוספים צפויים — הבסיס שהקמתם היום ישרת אתכם גם עימם.

Prompt מוכן לסוכן לאחר ההתקנה

מה לתת ל-Claude Code או Codex בפעם הראשונה

אחרי ההתקנה, אפשר לבקש מהסוכן לאמת שהכול עובד בצורה עצמאית. הדביקו את ה-Prompt הבא ב-Claude Code או Codex לאחר ההתקנה:

I am setting up this computer for AI coding work.

Please help me verify the setup slowly and safely.

I am not a developer, so explain every step in plain language.

Do not install or change anything before showing me:
1. What you are checking
2. Why it matters
3. The exact command
4. What a successful result should look like
5. What could go wrong

Check these tools in order:
- Git
- GitHub CLI (gh auth status)
- Node and npm
- Bun
- Claude Code
- Codex CLI

After each check, wait for my confirmation before moving to the next step.

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

צ׳קליסט אימות סופי

הריצו את הפקודות האלה לפי הסדר

פתחו טרמינל חדש לחלוטין (לא הישן שעמד פתוח כל ההתקנה) והריצו את הפקודות האלה אחת אחת. כל פקודה אמורה להחזיר מספר גרסה או הודעת הצלחה.

git --version
gh auth status
node --version
npm --version
bun --version
claude --version
claude doctor
codex --version

מה לצפות לראות:

  • git --version → שורה שמתחילה ב-git version
  • gh auth status → שם המשתמש שלכם ב-GitHub + "Logged in"
  • node --version → מספר כמו v24.x.x
  • npm --version → מספר כמו 10.x.x
  • bun --version → מספר כמו 1.x.x
  • claude --version → מספר גרסה
  • claude doctor → כל שורה ירוקה או "healthy"
  • codex --version → מספר גרסה

כולן עונות? המחשב מוכן לעבודה.

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

claude doctor

מה הלאה

agent-onboarding-wizard — לחקור בלי להיות מוצף

התקנתם הכול — עכשיו מגיעה ההחלטה הקשה: מאיפה מתחילים? Claude Code תומך בעשרות plugins, skills ושרתי MCP. כל אחד מהם מוסיף יכולות — שרת MCP לדוגמה מחבר את הסוכן לכלים חיצוניים כמו Supabase, GitHub או Notion; סקיל הוא קבוצת הוראות שמלמדת את הסוכן איך לגשת למשימה ספציפית. קל מאוד להרגיש מוצף כשמנסים להבין הכול בבת אחת.

הסקיל agent-onboarding-wizard בנוי בדיוק בשביל הרגע הזה. הוא מוביל אתכם בצורה מובנית דרך הגדרת הסביבה: אילו plugins שווים להתחיל איתם, אילו skills הכי שימושיים לסוג הפרויקט שלכם, ואיך לחבר שרתי MCP בלי לשבור שום דבר. כל צעד מוסבר לפני שמבצעים אותו.

להפעלה: פתחו Claude Code בתיקיית הפרויקט שלכם, והקלידו:

/agent-onboarding-wizard

זה הצעד הטבעי הבא אחרי שמסיימים את ההתקנה.

ארכיטקטורת סביבת העבודה — 7 תיקיות ו-CLAUDE.md

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

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

new-project-from-prd — מרעיון לריפו עובד

אם כבר יש לכם רעיון לפרויקט ואתם רוצים לעבור מ-"מה רציתי לבנות" לריפו עובד עם מבנה ראשוני — הסקיל new-project-from-prd מוביל אתכם דרך כתיבת מסמך דרישות (PRD) ויצירת מבנה פרויקט ראשוני מותאם אישית. הוא מיועד לאחרי השלמת מדריך 3 ולאחר שה-onboarding wizard הגדיר את הסביבה — אבל כדאי לדעת שהוא קיים.