📘 תיעוד 2

התחלה מהירה

#אינדקס תיעוד

אפשר לשלוף את אינדקס התיעוד המלא בכתובת: https://code.claude.com/docs/llms.txt השתמשו בקובץ הזה כדי לגלות את כל הדפים הזמינים לפני שממשיכים לחקור.

ברוכים הבאים ל-Claude Code.

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

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

ודאו שיש לכם:

• מסוף או שורת פקודה פתוחים
  • אם מעולם לא השתמשתם במסוף, עיינו במדריך המסוף
• פרויקט קוד לעבודה
• מנוי Claude (Pro, Max, Team או Enterprise), חשבון Claude Console, או גישה דרך ספק ענן נתמך

הערה: המדריך הזה עוסק ב-CLI של המסוף. Claude Code זמין גם באינטרנט, כאפליקציית שולחן עבודה, בVS Code ובסביבות JetBrains, בSlack, וב-CI/CD עם GitHub Actions ועם GitLab. ראו את כל הממשקים.

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

כדי להתקין את Claude Code, השתמשו באחת מהשיטות הבאות:

#התקנה Native (מומלץ)

macOS, Linux, WSL:

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

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

אם מופיעה ההודעה The token '&&' is not a valid statement separator, אתם ב-PowerShell ולא ב-CMD. אם מופיעה ההודעה 'irm' is not recognized as an internal or external command, אתם ב-CMD ולא ב-PowerShell. בשורת הפקודה מופיע PS C:\ כשאתם ב-PowerShell, ומופיע C:\ בלי PS כשאתם ב-CMD.

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

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

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

#Homebrew

brew install --cask claude-code

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

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

#WinGet

winget install Anthropic.ClaudeCode

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

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

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

claude --version

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

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

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

claude

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

/login

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

• Claude Pro, Max, Team או Enterprise (מומלץ)
• Claude Console (גישת API עם קרדיטים בתשלום מראש). בהתחברות הראשונה נוצרת אוטומטית ב-Console סביבת עבודה בשם "Claude Code" למעקב עלויות מרוכז.
• Amazon Bedrock, Google Cloud's Agent Platform או Microsoft Foundry (ספקי ענן לארגונים)
• Claude apps gateway באירוח עצמי, אם הארגון מפעיל אחד כזה: מנהל המערכת מגדיר מראש את כתובת ה-URL של ה-gateway, ו-/login נפתח ישירות במסך Cloud gateway כדי שתיכנסו עם SSO ארגוני

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

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

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

cd /path/to/your/project
claude

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

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

#שלב 4: השאלה הראשונה

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

what does this project do?

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

what technologies does this project use?

where is the main entry point?

explain the folder structure

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

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

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

#שלב 5: שינוי הקוד הראשון

עכשיו נבקש מ-Claude Code לבצע כתיבת קוד ממש. נסו משימה פשוטה:

add a hello world function to the main file

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

Auto mode הוא מצב הרשאות ההתחלה המובנה להפעלות מסוף אינטראקטיביות בתוכניות Pro, Max ו-Team: מסווג בודק פעולות במקומכם, ו-Claude עורך את רוב הקבצים ומריץ את רוב הפקודות בלי לשאול אתכם. בתוכניות אחרות, Manual mode הוא מצב הרשאות ההתחלה המובנה. לגבי ההפעלה שמתחילים מיד אחרי ההתקנה, ראו ההפעלה הראשונה אחרי התקנה או שדרוג.

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

#שלב 6: שימוש ב-Git עם Claude Code

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

what files have I changed?

commit my changes with a descriptive message

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

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

#שלב 7: תיקון באג או הוספת יכולת

Claude מיומן בניפוי באגים וביישום יכולות.

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

add input validation to the user registration form

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

there's a bug where users can submit empty forms - fix it

Claude Code יעשה את הדברים הבאים:

• יאתר את הקוד הרלוונטי
• יבין את ההקשר
• יישם פתרון
• יריץ בדיקות אם הן זמינות

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

יש כמה דרכים לעבוד עם Claude:

שינוי מבנה קוד

refactor the authentication module to use async/await instead of callbacks

כתיבת בדיקות

write unit tests for the calculator functions

עדכון תיעוד

update the README with installation instructions

סקירת קוד

review my changes and suggest improvements

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

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

אלה הפקודות החשובות ביותר לשימוש יומיומי. פקודות מעטפת רצות מהמסוף כדי להתחיל או לחדש את Claude Code. פקודות הפעלה רצות בתוך Claude Code אחרי שהוא מתחיל.

פקודות מעטפת

פקודות הפעלה

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

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

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

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

במקום: "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

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

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

#מה הלאה?

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

• איך Claude Code עובד: הבינו את הלולאה הסוכנית, את הכלים המובנים, ואת האופן שבו Claude Code מתקשר עם הפרויקט
• שיטות עבודה מומלצות: קבלו תוצאות טובות יותר עם הנחיות יעילות ועם הגדרת פרויקט נכונה
• תהליכי עבודה נפוצים: מדריכים שלב אחר שלב למשימות נפוצות
• הרחבת Claude Code: התאמה אישית עם CLAUDE.md, skills, hooks, MCP ועוד

#קבלת עזרה

• בתוך Claude Code: הקלידו /help או שאלו "how do I..."
• תיעוד: אתם כאן. עיינו במדריכים נוספים
• קהילה: הצטרפו לDiscord שלנו לטיפים ולתמיכה