המדריך המלא ל-Claude Code

צעדים ראשונים

מהאפס לעבודה תוך פחות מדקה.

Claude Code הוא כלי קידוד agentic שחי בטרמינל שלך. הוא יודע לערוך קבצים, להריץ פקודות, לחפש בקוד שלך ולעבוד מול git – הכל בשפה טבעית. אחרי שתתקין אותו לפי המדריך הרשמי של Anthropic (macOS, Linux, או Windows), פותחים את התיקייה של הפרויקט ומריצים:

cd your-project
claude

שימוש בתוך VS Code

אפשר גם להריץ את Claude Code ישירות בתוך VS Code. מתקינים את התוסף הרשמי Claude Code מהמרקטפלייס, והוא יופיע כפאנל משולב בעורך.

קיצורי מקלדת

הקיצורים ששווה לזכור.

הרשאות

שליטה מלאה במה ש-Claude Code יכול ולא יכול לעשות.

Claude Code משתמש במערכת הרשאות מדורגת: כלים לקריאה בלבד (כמו Read ו-Grep) לא דורשים אישור, פקודות bash דורשות אישור פר פרויקט, ועריכת קבצים דורשת אישור פר session. הכללים נבדקים לפי הסדר: deny ← ask ← allow. חסימה תמיד מנצחת.

היכן מגדירים

הרשאות יושבות בקובץ settings.json בשתי רמות:

מצבי הרשאה

הגדירו defaultMode ב-settings כדי לשנות את אופן בקשת האישור:

דוגמה 1: מינימלי – אישור אוטומטי לקריאות בלבד

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

{
  "permissions": {
    "allow": [
      "Read",
      "Grep",
      "Glob"
    ]
  }
}

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

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

{
  "permissions": {
    "allow": [
      "Bash(npm *)",
      "Bash(git *)",
      "Read",
      "Edit",
      "Grep",
      "Glob",
      "WebFetch",
      "WebSearch",
      "mcp__*"
    ]
  }
}

דוגמה 3: פרויקט צוותי – אשרו בנייה, חסמו סכנות

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

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git commit *)",
      "Read",
      "Grep",
      "Glob"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)"
    ]
  }
}

פקודות

כל הפקודות המובנות ומתי להגיע אליהן.

Skills מובנים

אלה מגיעים מובנים עם Claude Code – ללא צורך בהתקנה:

פקודות מותאמות אישית

בונים פקודות סלאש משלכם עם קבצי markdown פשוטים.

פקודות מותאמות הן קובצי markdown שהופכים לפקודות סלאש. שומרים אותן כ-skills (מומלץ) או בתיקיית commands הישנה:

השתמשו ב-$ARGUMENTS ב-skill כדי לקבל קלט כשהוא מופעל.

Review the changes on the current branch compared to main.

Focus on:
1. Logic errors and edge cases
2. Security issues
3. Performance concerns
4. Missing error handling

Reference file names and line numbers.
Show the diff summary first.

Write tests for $ARGUMENTS

Cover:
- Happy path
- Empty / null input
- Error cases
- Edge cases

Use the existing test framework. Run tests after writing them.

Refactor $ARGUMENTS to be cleaner and more maintainable.

Rules:
- Keep the same behavior (no feature changes)
- Improve naming and readability
- Extract repeated logic into functions
- Add type hints if missing
- Run tests after to confirm nothing broke

Hooks

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

Hooks הם פקודות shell, קריאות HTTP או פרומפטים ל-LLM שמופעלים אוטומטית בנקודות מסוימות. מוסיפים אותם ב-.claude/settings.json (פרויקט) או ~/.claude/settings.json (גלובלי). פקודות ה-hooks מקבלות JSON ב-stdin עם פרטי הכלי.

פורמט אוטומטי לקבצי Python אחרי כל עריכה

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.file_path' | xargs black 2>/dev/null; exit 0"
      }]
    }]
  }
}

פורמט אוטומטי ל-JS/TS עם Prettier

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write 2>/dev/null; exit 0"
      }]
    }]
  }
}

חסימת פקודות מסוכנות

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.command' | grep -qE 'rm -rf|git push.*--force|git reset --hard' && echo 'Blocked: dangerous command' >&2 && exit 2 || exit 0"
      }]
    }]
  }
}

הגנה על קבצים רגישים מפני עריכה

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.file_path' | grep -qE '\\.env|secrets/|\\.git/' && echo 'Blocked: protected file' >&2 && exit 2 || exit 0"
      }]
    }]
  }
}

התראת שולחן עבודה כש-Claude צריך קלט

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude Code needs input\" with title \"Claude Code\" sound name \"Ping\"'"
      }]
    }]
  }
}

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "powershell -Command \"Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention','Claude Code')\""
      }]
    }]
  }
}

CLAUDE.md

קובץ הקונטקסט שמסביר ל-Claude איך הפרויקט שלך עובד.

Claude קורא את CLAUDE.md בתחילת כל session. שם שמים את הארכיטקטורה של הפרויקט, סטנדרטים של קוד, פקודות build, וכל חוק שרוצים ש-Claude יעקוב אחריו.

בפרויקטים קיימים, מריצים /init – Claude מנתח את הקוד ומייצר CLAUDE.md עם המוסכמות שהוא זיהה. אחר כך מעדכנים אותו עם כל מה ש-Claude לא היה יכול לדעת בעצמו. בפרויקטים חדשים, כדאי להשתמש בתבנית הבאה כנקודת פתיחה.

היכן ממקמים

תבנית

השתמשו בזה כנקודת פתיחה – התאימו לפרויקט שלכם:

# Project: [Name]

## Tech Stack
- [Framework], [Language + version]
- [Database], [Key libraries]

## Commands
- Dev: [command]
- Build: [command]
- Test: [command]
- Lint: [command]

## Architecture
- [Where services live]
- [Where routes/views live]
- [Where models/types live]
- [Where tests live]

## Code Style
- [Rule 1 — be specific]
- [Rule 2]
- [Rule 3]

## Rules
- ALWAYS run tests after changes
- ALWAYS use TypeScript strict mode
- NEVER commit directly to main
- Keep files under 300 lines — split if larger

Skills

פקודות מתקדמות עם auto-triggering ומשאבים נלווים.

Skills הם השלב הבא מעבר לפקודות מותאמות. הם יושבים ב-.claude/skills/your-skill-name/SKILL.md ותומכים ב-auto-triggering, scripts חבילים, ושליטה ב-subagents.

Skills פופולריים

איך לבנות Skill משלכם

יוצרים תיקייה ב-.claude/skills/your-skill-name/ עם קובץ SKILL.md. מוסיפים YAML frontmatter עם name ו-description – Claude משתמש ב-description כדי להחליט מתי לטעון אותו אוטומטית.

---
name: explain-code
description: Explains code with diagrams and analogies. Use when the user asks "how does this work?"
---

When explaining code, always include:

1. **Start with an analogy** — compare the code to something from everyday life
2. **Draw a diagram** — use ASCII art to show the flow or structure
3. **Walk through the code** — explain step-by-step what happens
4. **Highlight a gotcha** — what's a common mistake or misconception?

Keep explanations conversational.

Workflows

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

שלושת העמודים

מחזור הפיתוח

פרומפטים חזקים

פרומפטים שעברו מבחני שטח למצבים שגרתיים. העתיקו ישירות.

Before writing any code, analyze the existing codebase structure and create a detailed plan. List every file you'll create or modify, and explain why. Wait for my approval before implementing.

Knowing everything you know now, scrap this and implement the elegant solution.

This error is happening: [paste error]
Don't just fix the symptom. Find the root cause, explain it, then fix it properly. Run tests after.

Use parallel subagents for these independent tasks:
1. [Task A]
2. [Task B]
3. [Task C]
Work on all three at the same time. Combine results when done.

Create a modular project structure for [description].
Each feature gets its own file in a logical folder structure.
No file should be longer than 300 lines.
Include type hints and error handling from the start.

Scan the entire project for files larger than 600 lines of code. List them sorted by size, and suggest how each could be split into smaller, focused modules.

Before you start, ask me questions to make sure you understand exactly what I want.

Plugins ו-MCP

הרחבה של Claude Code עם plugins ו-MCP servers.

Plugins מאגדים skills, agents, hooks ו-MCP servers לחבילה לשיתוף קל. MCP servers מחברים את Claude לכלים חיצוניים כמו דפדפנים, בסיסי נתונים ו-APIs.

התקנת Plugins

מריצים /plugin בתוך Claude Code כדי לפתוח את מנהל ה-plugins. בלשונית Discover רואים את כל הזמינים, או מתקינים ישירות:

# UI generation with design system
/plugin install frontend-design@claude-plugins-official

# GitHub integration
/plugin install github@claude-plugins-official

# Sentry error monitoring
/plugin install sentry@claude-plugins-official

# TypeScript code intelligence
/plugin install typescript-lsp@claude-plugins-official

MCP Servers

MCP servers נותנים ל-Claude Code גישה לכלים חיצוניים – דפדפנים, בסיסי נתונים, APIs, וכל דבר שמדבר את פרוטוקול ה-MCP. מוסיפים אותם עם claude mcp add.

# Browser automation — Claude can see your UI
claude mcp add --transport stdio playwright -- npx @playwright/mcp@latest

# Fetch web content — read docs, APIs
claude mcp add --transport stdio fetch -- npx @anthropic-ai/mcp-fetch@latest

# Notion — connect to your workspace
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Any HTTP MCP server
claude mcp add --transport http my-server https://example.com/mcp

בחירת מודל

התאימו את המודל למשימה.

Claude Code עובד כברירת מחדל עם מודלים של Anthropic (Opus ו-Sonnet). משתמשים ב-/model כדי לעבור ביניהם. למודלים שאינם של Anthropic, אפשר להשתמש ב-CC Switch שמאפשר ניתוב ליותר מ-50 מודלים מספקים כמו DeepSeek, MiniMax, OpenRouter ועוד.

שימוש ב-Claude Code בחינם

ניתוב Claude Code למודל חינמי ב-OpenRouter – פר פרויקט, ללא התנגשות עם הקונפיג הגלובלי.

אפשר להריץ את Claude Code בעלות של 0 ש״ח על ידי הצבעה למודל חינמי ב-OpenRouter. עושים את זה ברמת הפרויקט כדי שלא ייגע בהגדרות הגלובליות שלכם – ללא התנגשויות וללא שבירה של הסידור הראשי, רק override מבודד לפרויקט אחד.

שלב 1 – יצירת קונפיג ברמת הפרויקט

בתוך הפרויקט שבו רוצים להשתמש חינם, יוצרים תיקיית .claude, ובתוכה קובץ בשם settings.local.json.

שלב 2 – מקבלים מפתח API חינמי מ-OpenRouter

נרשמים ב-openrouter.ai, יוצרים מפתח API, ואז בעמוד המודלים מעתיקים את ה-slug של כל מודל שמסומן free (למשל minimax/minimax-m2.5:free).

שלב 3 – מדביקים את זה ב-.claude/settings.local.json

(מחליפים את המפתח ואת slug המודל בשלכם):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "XXX",
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "minimax/minimax-m2.5:free",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "minimax/minimax-m2.5:free",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "minimax/minimax-m2.5:free"
  }
}

שלב 4 – מפעילים Claude Code בפרויקט

פותחים טרמינל בתיקיית הפרויקט ומריצים claude. אחר כך מריצים את הפקודה /model – אתם אמורים לראות את המודל החינמי של OpenRouter כפעיל. רושמים hi כדי לוודא שהוא עונה.

שלב 5 – מוודאים שזה באמת בחינם

נכנסים ל-OpenRouter usage logs – תראו את הקריאות שלכם נוחתות ב-$0. בהצלחה.

שאלות נפוצות

תשובות מהירות לשאלות החוזרות.