מדריך קלוד קוד בעברית

תיעוד 2

התחלה מהירה

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

ההתחלה המהירה הזו מכסה את Claude Code בטרמינל: התקנת ה-CLI, התחברות מהסשן הראשון, ושימוש בו למשימות פיתוח נפוצות בפרויקט שלכם.

#לפני שמתחילים

ודאו שיש לכם:

[!NOTE]

המקרים האלה מכוסים בדפים אחרים:

#שלב 1: התקנת Claude Code

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

#התקנה מקורית (מומלץ)

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

ב-Windows, ההנחיה מציגה PS C:\ כשאתם ב-PowerShell, ו-C:\ בלי PS כשאתם ב-CMD.

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

אם אתם רואים The token '&&' is not a valid statement separator, אתם ב-PowerShell ולא ב-CMD. אם אתם רואים 'irm' is not recognized as an internal or external command, אתם ב-CMD ולא ב-PowerShell.

אם פקודת ההתקנה נכשלת עם syntax error near unexpected token '<', עם 403, או עם כל שגיאה אחרת, ראו פתרון בעיות התקנה כדי להתאים את השגיאה לתיקון, ולשיטות התקנה חלופיות.

Git for Windows מומלץ ב-Windows מקורי כדי ש-Claude Code יוכל להשתמש בכלי Bash. אם Git for Windows לא מותקן, Claude Code משתמש ב-PowerShell ככלי המעטפת במקום זאת. הגדרות WSL לא זקוקות ל-Git for Windows.

[!NOTE]

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

#Homebrew

brew install --cask claude-code

ל-Homebrew יש שני casks. claude-code עוקב אחרי ערוץ הגרסה היציבה, שבדרך כלל בפיגור של כשבוע ומדלג על גרסאות עם רגרסיות משמעותיות. claude-code@latest עוקב אחרי הערוץ העדכני ומקבל גרסאות חדשות ברגע שהן יוצאות.

[!NOTE]

התקנות Homebrew לא מתעדכנות אוטומטית. הריצו brew upgrade claude-code או brew upgrade claude-code@latest, לפי ה-cask שהתקנתם, כדי לקבל את התכונות ותיקוני האבטחה העדכניים.

#WinGet

winget install Anthropic.ClaudeCode

[!NOTE]

התקנות WinGet לא מתעדכנות אוטומטית. הריצו winget upgrade Anthropic.ClaudeCode מדי פעם כדי לקבל את התכונות ותיקוני האבטחה העדכניים.

אפשר גם להתקין עם apt, dnf או apk ב-Debian, Fedora, RHEL ו-Alpine.

כדי לאשר שההתקנה הצליחה, הריצו:

claude --version

הפקודה מדפיסה מספר גרסה ואחריו (Claude Code).

#שלב 2: התחלת הסשן הראשון

פתחו את הטרמינל בכל תיקיית פרויקט והפעילו את Claude Code:

cd /path/to/your/project
claude

החליפו את /path/to/your/project בנתיב לפרויקט שאתם רוצים לעבוד עליו.

Claude Code מבקש מכם להתחבר בשימוש הראשון. בחשבונות מנוי Claude או Console, עקבו אחרי ההנחיות כדי להשלים את האימות בדפדפן. אם הגדרתם את משתנה הסביבה ANTHROPIC_API_KEY ואישרתם את המפתח כש-Claude Code שואל אם להשתמש בו, Claude Code מדלג על בקשת ההתחברות.

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

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

הנחיית Claude Code מופיעה, ומעליה מוצגים הגרסה, המודל הנוכחי ותיקיית העבודה. הקלידו /help לפקודות הזמינות, או /resume כדי להמשיך שיחה קודמת. כדי להחליף חשבונות מאוחר יותר או לאמת מחדש, הקלידו /login בתוך הסשן הפעיל.

#שלב 3: שאלו את השאלה הראשונה

נסו אחת מהפקודות האלה:

מה הפרויקט הזה עושה?

Claude ינתח את הקבצים שלכם ויספק סיכום. אפשר גם לשאול שאלות ספציפיות יותר:

באילו טכנולוגיות הפרויקט הזה משתמש?
איפה נקודת הכניסה הראשית?
הסבר את מבנה התיקיות

אפשר גם לשאול את Claude על היכולות שלו:

מה Claude Code יכול לעשות?
איך יוצרים מיומנויות מותאמות אישית ב-Claude Code?
האם Claude Code יכול לעבוד עם Docker?

[!NOTE]

Claude Code קורא את קבצי הפרויקט לפי הצורך. אין צורך להוסיף הקשר ידנית.

#שלב 4: בצעו את שינוי הקוד הראשון

נסו משימה קטנה:

הוסף פונקציית hello world לקובץ הראשי

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

מצב ההרשאות של הסשן קובע אילו פעולות Claude יכול לבצע בלי לשאול אתכם קודם. לחצו על Shift+Tab בכל עת כדי להחליף את מצב ההרשאות של הסשן שבו אתם נמצאים.

#שלב 5: השתמשו ב-Git עם Claude Code

Claude Code הופך פעולות Git לשיחה:

אילו קבצים שיניתי?
בצע commit לשינויים שלי עם הודעה תיאורית

אפשר גם לבקש פעולות Git מורכבות יותר:

צור ענף חדש בשם feature/quickstart
הצג לי את 5 ה-commits האחרונים
עזור לי לפתור קונפליקטים של merge

#שלב 6: תקנו באג או הוסיפו תכונה

תארו מה שאתם רוצים בשפה טבעית:

הוסף אימות קלט לטופס הרשמת המשתמשים

או תקנו בעיות קיימות:

יש באג שבו משתמשים יכולים לשלוח טפסים ריקים - תקן אותו

#שלב 7: נסו תהליכי עבודה נפוצים נוספים

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

שפר את מבנה מודול האימות כך שישתמש ב-async/await במקום callbacks
כתוב בדיקות יחידה לפונקציות המחשבון
עדכן את ה-README עם הוראות התקנה
סקור את השינויים שלי והצע שיפורים

[!TIP]

דברו עם Claude כמו עם עמית מועיל. תארו מה אתם רוצים להשיג, והוא יעזור לכם להגיע לשם.

#פקודות חיוניות

אלה הפקודות החשובות ביותר לשימוש יומיומי, מקובצות לפי המקום שבו מריצים אותן.

#פקודות מעטפת

הריצו אותן מהטרמינל כדי להתחיל או לחדש את Claude Code.

פקודהמה היא עושהדוגמה
claudeהתחלת מצב אינטראקטיביclaude
claude "task"התחלת מצב אינטראקטיבי עם הנחיה ראשוניתclaude "fix the build error"
claude -p "query"הרצת שאילתה חד פעמית, ואז יציאהclaude -p "explain this function"
claude -cהמשך השיחה האחרונה בתיקייה הנוכחיתclaude -c
claude -rחידוש שיחה קודמתclaude -r

ראו את הפניה ל-CLI לרשימה המלאה של פקודות המעטפת.

#פקודות סשן

הריצו אותן בתוך Claude Code אחרי שהוא מתחיל.

פקודהמה היא עושהדוגמה
/clearניקוי היסטוריית השיחה/clear
/helpהצגת הפקודות הזמינות/help
/exit או Ctrl+D פעמייםיציאה מ-Claude Code/exit

ראו את הפניה לפקודות לרשימה המלאה של פקודות הסשן.

#טיפים למתחילים

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

#היו ספציפיים בבקשות

במקום: "fix the bug"

נסו: "fix the login bug where users see a blank screen after entering wrong credentials"

#השתמשו בהוראות שלב אחר שלב

פרקו משימות מורכבות לשלבים:

1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

#תנו ל-Claude לחקור קודם

לפני ביצוע שינויים, תנו ל-Claude להבין את הקוד שלכם:

analyze the database schema
build a dashboard showing products that are most frequently returned by our UK customers

#חסכו זמן עם קיצורי דרך

  • הקלידו / כדי לראות את הפקודות והמיומנויות הזמינות לכם
  • השתמשו ב-Tab להשלמת פקודות
  • לחצו על ↑ להיסטוריית פקודות
  • לחצו על Shift+Tab כדי לעבור בין מצבי הרשאה

#מה הלאה?

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

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

#קבלת עזרה

  • בתוך Claude Code: הקלידו /help או שאלו שאלת "איך אני"
  • תיעוד: עיינו במדריכים האחרים באתר הזה
  • קורסים: למדו את Claude Code 101 וקורסים חינמיים נוספים בקצב אישי ב-Claude Academy
  • קהילה: הצטרפו לשרת Discord לטיפים ולתמיכה