היכרות עם Claude API, המפתח הראשון שלך

למה API ולא claude.ai?

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

סטארטאפ תל-אביבי שמנהל 500 לקוחות לא יפתח claude.ai לכל לקוח ידנית. הוא יכתוב 20 שורות קוד שמשלחות את נתוני הלקוח ל-API ומקבלות ניתוח אוטומטי, פי 500 מהר יותר, עם עלות של פחות מ-₪1 ל-100 ניתוחים.

צעד 1, חשבון ו-API Key

הכל מתחיל ב-console.anthropic.com (מופנה ל-platform.claude.com). תהליך ההרשמה ישיר: מייל + סיסמה, ואימות טלפון. האימות הזה חובה, בלעדיו אין Credits ואין גישה ל-API.

• לאחר הכניסה: לחץ API Keys בסרגל שמאל
• לחץ Create Key ותן לו שם ברור (לדוגמה: my-chatbot-dev)
• חובה: העתק את ה-Key מיד, הוא מוצג פעם אחת בלבד. אם לא העתקת, צור Key חדש
• חשבונות חדשים מקבלים כ-$5 ב-Credits לניסיון

עכשיו שמור את ה-Key בצורה בטוחה. הדרך הנכונה, environment variable, לא בתוך הקוד:

# Mac/Linux, הוסף ל-~/.zshrc או ~/.bashrc
export ANTHROPIC_API_KEY='sk-ant-api03-...'

צעד 2, הבקשה הראשונה (Python)

התקנה: pip install anthropic. זה ה-SDK הרשמי של Anthropic, הוא מטפל ב-HTTP headers, ב-retry אוטומטי, ובפרסור התשובה.

import anthropic
import os

client = anthropic.Anthropic()
# אם ANTHROPIC_API_KEY מוגדר כ-env var, לא צריך להעביר אותו ישירות

message = client.messages.create(
    model="claude-haiku-4-5",
    max_tokens=512,
    system="אתה עוזר מקצועי שעונה בעברית.",
    messages=[
        {"role": "user", "content": "תסביר מה זה API במשפט אחד."}
    ]
)

print(message.content[0].text)
print(f"Input: {message.usage.input_tokens} | Output: {message.usage.output_tokens}")
print(f"Stop reason: {message.stop_reason}")

שים לב: השתמשתי ב-claude-haiku-4-5, המהיר ביותר, הזול ביותר, ומתאים לניסוי ראשוני. לקריאה מעמיקה על בחירת מודל, ראה שיעור 59.

מבנה הבקשה, מה כל שדה עושה

קריאת תשובת ה-API

ה-API מחזיר אובייקט JSON מובנה. הנה המפתחות שמשתמשים בהם בפועל:

# מה שמחזיר ה-API (מבנה JSON):
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "API הוא ממשק..."}],
  "model": "claude-haiku-4-5-20251001",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 28,
    "output_tokens": 42
  }
}

# גישה ב-Python:
text = message.content[0].text
input_tok = message.usage.input_tokens
output_tok = message.usage.output_tokens

# חישוב עלות (Haiku: $1/$5 per MTok):
cost = (input_tok * 1 + output_tok * 5) / 1_000_000
print(f"עלות הבקשה: ${cost:.6f}")

שים לב ל-stop_reason: אם הוא max_tokens ולא end_turn, התשובה נחתכה באמצע. צריך להגדיל את max_tokens או לקצר את הפרומפט.

מודלים עדכניים ומתי להשתמש בכל אחד

נכון לאפריל 2026, שלושת המודלים הפעילים הם:

• claude-haiku-4-5, $1/$5 per MTok. לסיווג, ניתוח קצר, chatbots. המהיר ביותר.
• claude-sonnet-4-6, $3/$15 per MTok. לכתיבה, קוד, ניתוח מורכב. האיזון הכי טוב.
• claude-opus-4-7, $5/$25 per MTok. לבעיות מחקריות, agentic coding, היסק עמוק. השיק באפריל 2026.

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

שימו לב: claude-sonnet-4-0 ו-claude-opus-4-0 (גרסאות 20250514) יפסיקו לפעול ב-15 יוני 2026. אם יש לכם קוד קיים עם model IDs ישנים, עדכנו עכשיו.

אבטחת API Key, לא אופציונלי

• שמור ב-.env והוסף .env ל-.gitignore לפני git add הראשון
• אל תדפיס את ה-key ב-logs, הוא יכול להופיע ב-CI/CD logs
• אם הupload ה-key ל-GitHub, בטל אותו מיד ב-console.anthropic.com וצור חדש
• ב-production: env variables של הסרבר (Heroku Config Vars, AWS Secrets Manager, Vercel env)

ההבדל: מודל יקר + max_tokens נמוך + system ריק = תוצאה חלשה ויקרה. מודל זול + context מדויק + max_tokens מספיק = תוצאה מצוינת ב-1/5 המחיר.