התקנה והגדרה, צעד אחר צעד

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

שלב 1: פותחים טרמינל

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

שלב 2: מתקינים את Claude Code

מעתיקים את הפקודה המתאימה (יש כפתור העתקה בפינת התיבה), מדביקים בטרמינל ולוחצים Enter:

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

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

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

דרכי התקנה נוספות (לא חובה)

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

winget install Anthropic.ClaudeCode

winget install Anthropic.ClaudeCode

brew install --cask claude-code

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

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

claude --version

אם הכול תקין, יופיע מספר גרסה, למשל:

2.1.211 (Claude Code)

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

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

claude doctor

שלב 4: מתחברים לחשבון

יש שתי דרכים עיקריות לשלם על Claude Code. ההבדל ביניהן הוא בעיקר איך משלמים:

אפשרות א': התחברות עם מנוי Claude (מומלץ)

1. בטרמינל, הקלידו claude ולחצו Enter:

   Terminalהעתקה

   claude

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

3. כשתתבקשו לבחור שיטת התחברות, בחרו באפשרות של חשבון Claude (מנוי).

4. ייפתח חלון בדפדפן. התחברו לחשבון Claude שלכם ואשרו את הגישה.

5. חזרו לטרמינל. כשמופיע Login successful, לחצו Enter, וזהו: אתם מחוברים.

אפשרות ב': התחברות עם Claude Console (תשלום לפי שימוש)

1. היכנסו ל-platform.claude.com, פתחו חשבון וטענו קרדיט.
2. בטרמינל, הקלידו claude.
3. בחרו באפשרות של Anthropic Console והתחברו בדפדפן. אפשר להתחבר עם החשבון עצמו, בלי ליצור מפתח API בכלל.

למתקדמים: עבודה עם מפתח API קיים

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

$env:ANTHROPIC_API_KEY = "sk-ant-..."

set ANTHROPIC_API_KEY=sk-ant-...

export ANTHROPIC_API_KEY="sk-ant-..."

החליפו את sk-ant-... במפתח האמיתי שלכם.

החלפת חשבון והתנתקות

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

/logout
/login

עדכונים

ההתקנה הרשמית (הפקודה משלב 2) מתעדכנת לבד ברקע, ולא צריך לעשות כלום. אם בכל זאת רוצים לעדכן מיד:

claude update

אם התקנתם עם WinGet או Homebrew, העדכון ידני:

winget upgrade Anthropic.ClaudeCode

winget upgrade Anthropic.ClaudeCode

brew upgrade claude-code

פתרון בעיות

משהו לא עבד? אל דאגה, כמעט כל הבעיות בהתקנה הן אחת מהרשימה הזאת.

"claude: command not found" או "'claude' is not recognized"

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

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

אם זה לא עזר, הוסיפו את התיקייה ל-PATH:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

"'irm' is not recognized" או "The token '&&' is not a valid statement separator"

מה קרה: הפקודה שהעתקתם מיועדת לסוג טרמינל אחר.

• irm is not recognized: אתם ב-CMD, אבל הרצתם את פקודת PowerShell. עברו ללשונית Windows CMD בשלב 2, או פתחו PowerShell.
• && is not a valid statement separator: אתם ב-PowerShell, אבל הרצתם את פקודת CMD. עברו ללשונית Windows PowerShell.
• A parameter cannot be found that matches parameter name 'fsSL' או 'bash' is not recognized: הרצתם ב-Windows את הפקודה של Mac/Linux. השתמשו בפקודה של PowerShell.

"running scripts is disabled on this system" (מדיניות הרצה ב-PowerShell)

מה קרה: ל-PowerShell יש מנגנון אבטחה שנקרא Execution Policy (מדיניות הרצה), שחוסם הרצה של קובצי סקריפט. השגיאה הזאת לא מופיעה בהתקנה הרשמית משלב 2. היא מופיעה בעיקר אם התקנתם את Claude Code דרך npm, מנהל החבילות של Node.js.

יש שלוש דרכים לפתור, מהמומלצת ביותר:

1. התקינו מחדש בדרך הרשמית עם פקודת PowerShell משלב 2. היא לא מושפעת מהמדיניות.
2. הריצו claude.cmd במקום claude. זו אותה תוכנה, והמדיניות לא חלה עליה.
3. אפשרו הרצה של סקריפטים מקומיים למשתמש שלכם בלבד:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

ההתקנה נכשלת עם שגיאה אחרת

• syntax error near unexpected token '<' או 403: במקום תוכנת ההתקנה הגיע דף אינטרנט, בדרך כלל בגלל בעיית רשת, VPN או חסימה ברשת של מקום העבודה. נסו מרשת אחרת, או השתמשו ב-WinGet או ב-Homebrew.
• App unavailable in region: Claude Code לא זמין במדינה שממנה אתם מתחברים. רשימת המדינות הנתמכות.

בעיות בהתחברות

• הדפדפן לא נפתח: לחצו c בטרמינל כדי להעתיק את הקישור, והדביקו אותו בדפדפן.
• התחברתם לחשבון הלא נכון: הקלידו /logout ואז /login בתוך Claude Code.
• הודעה שאין לכם גישה: ודאו שיש לכם מנוי בתשלום. המנוי החינמי של Claude לא כולל את Claude Code.

סיכום

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

בפרק הבא נפעיל את Claude Code בפעם הראשונה ונבקש ממנו לבנות משהו אמיתי.

בדקו את עצמכם