Claude API, מדריך התחלה מהירה בעברית

אם אתה יודע לכתוב קצת קוד ורוצה לשלב את Claude בתוך אפליקציה, אתר או סקריפט משלך, Claude API הוא הכלי בשבילך. המדריך הזה הוא quickstart בעברית: תוך כמה דקות תוציא מפתח API, תשלח בקשה ראשונה ב-curl וב-Python, תבין את סקירת המודלים ואיך עובדים טוקנים, ותכיר את כללי הבטיחות החשובים. בלי רקע מוקדם ב-API, נתחיל מאפס.

שלב 1: הוצאת מפתח API

כדי לדבר עם Claude API אתה צריך מפתח (API key) שמזהה אותך. הנה הצעדים:

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

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

שלב 2: הבקשה הראשונה ב-curl

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

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

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "שלום קלוד, ספר לי בדיחה קצרה"}
    ]
  }'

שים לב לשלושה חלקים: כותרת x-api-key עם המפתח שלך, שדה model שבוחר את המודל, ומערך messages שמכיל את השיחה. השדה max_tokens מגביל את אורך התשובה.

שלב 3: הבקשה הראשונה ב-Python

לעבודה אמיתית תשתמש ב-SDK הרשמי. התקן אותו:

pip install anthropic

וזה הקוד המלא לבקשה ראשונה:

import anthropic

client = anthropic.Anthropic()  # קורא את ANTHROPIC_API_KEY מהסביבה

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "שלום קלוד, ספר לי בדיחה קצרה"}
    ],
)

print(message.content[0].text)

זהו, הרצת הסקריפט תדפיס את תשובת Claude. לצעד הבא, כמו הוספת streaming לתגובות בזמן אמת, ראה את השיעור Claude API + Python, מהמפתח הראשון לאפליקציה עובדת ואת השיעור היכרות עם Claude API, המפתח הראשון שלך.

סקירת המודלים

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

ההמלצה למתחילים: התחל עם Sonnet, הוא נותן איכות מעולה למרבית המשימות בעלות סבירה. עבור לפי הצורך: Opus כשצריך את המקסימום, Haiku כשצריך מהירות ונפח. בחירת המודל הנכונה יכולה לחסוך הרבה מאוד עלות, והנושא מכוסה לעומק בשיעור מדריך מודלים, Opus, Sonnet, Haiku: מתי להשתמש בכל אחד?.

איך עובדים טוקנים

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

• גם הקלט וגם הפלט נספרים. משלמים על הטקסט שנכנס ועל התשובה שיוצאת.
• לכל מודל יש חלון הקשר (context window), מגבלה על סך הטוקנים בשיחה. אם חורגים, צריך לקצר.

הבנת הטוקנים חשובה כי היא קובעת גם את העלות וגם את הגבולות. טכניקות כמו prompt caching יכולות להוזיל דרמטית את עלות הקלט החוזר.

טיפים לבטיחות ולעלות

• הגדר תקציב וגבולות בקונסול כדי להימנע מהפתעות בחשבון.
• שמור מפתחות במשתני סביבה ולא בקוד. השתמש בקובץ .env והוסף אותו ל-.gitignore.
• הגדר max_tokens הגיוני, הוא תקרה לתשובה ומונע פלט ארוך ויקר מדי.
• טפל בשגיאות ובקצב בקשות (rate limits), הוסף retry עם השהיה בין ניסיונות.

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

מכאן אפשר להעמיק לכל כיוון: Claude API Mastery, Streaming, Caching ו-Tool Use ללימוד הטכניקות המתקדמות, או לקטלוג השיעורים החינמי להיכרות רחבה יותר עם Claude. אם אתה מעדיף לעבוד מהטרמינל בלי לכתוב קוד תשתית בעצמך, שקול את Claude Code. בשורה התחתונה: שלוש שורות קוד מפרידות בינך לבין אפליקציית AI ראשונה, התחל עכשיו.