ربط Claude API بتطبيقك: دليل عملي بـ Python و JavaScript

pip install anthropic          # Python
npm install @anthropic-ai/sdk  # JavaScript / TypeScript

import anthropic

client = anthropic.Anthropic()  # يقرأ ANTHROPIC_API_KEY من البيئة

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    system="أنت مساعد دعم لشركة Mit AI. أجب بالعربية وباختصار.",
    messages=[{"role": "user", "content": "ما هي خدمات الشركة؟"}],
)

print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // يقرأ ANTHROPIC_API_KEY

const message = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 1024,
  system: "أنت مساعد دعم لشركة Mit AI. أجب بالعربية وباختصار.",
  messages: [{ role: "user", content: "ما هي خدمات الشركة؟" }],
});

console.log(message.content[0].text);

history = [
    {"role": "user", "content": "أريد مساعداً صوتياً لمتجري."},
    {"role": "assistant", "content": "ممتاز! كم عدد المنتجات تقريباً؟"},
    {"role": "user", "content": "حوالي 300 منتج."},
]
reply = client.messages.create(model="claude-opus-5-5", max_tokens=600, messages=history)

with client.messages.stream(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "اشرح RAG ببساطة"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

final = stream.get_final_message()  # الرسالة الكاملة وعدد الرموز المستهلكة

tools = [{
    "name": "get_order_status",
    "description": "يرجع حالة طلب العميل برقم الطلب.",
    "input_schema": {
        "type": "object",
        "properties": {"order_id": {"type": "string"}},
        "required": ["order_id"],
    },
}]

messages = [{"role": "user", "content": "أين طلبي رقم A-1042؟"}]
response = client.messages.create(
    model="claude-opus-5-5", max_tokens=1024, tools=tools, messages=messages
)

while response.stop_reason == "tool_use":
    messages.append({"role": "assistant", "content": response.content})
    results = []
    for block in response.content:
        if block.type == "tool_use":
            output = lookup_order(block.input["order_id"])  # دالتك
            results.append({
                "type": "tool_result",
                "tool_use_id": block.id,
                "content": output,
            })
    messages.append({"role": "user", "content": results})
    response = client.messages.create(
        model="claude-opus-5-5", max_tokens=1024, tools=tools, messages=messages
    )

print(response.content[0].text)

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=600,
    system=[{
        "type": "text",
        "text": LONG_COMPANY_KNOWLEDGE,          # ثابت بين الطلبات
        "cache_control": {"type": "ephemeral"},
    }],
    messages=[{"role": "user", "content": user_question}],
)
print(response.usage.cache_read_input_tokens)  # > 0 يعني أن الكاش يعمل

import anthropic

try:
    message = client.messages.create(...)
except anthropic.RateLimitError:
    ...  # 429: أعد المحاولة بتأخير تصاعدي
except anthropic.APIConnectionError:
    ...  # مشكلة شبكة
except anthropic.APIStatusError as e:
    ...  # بقية أخطاء الـ API (e.status_code)