# أنشئ مفتاح Claude API وأضفه

> إنشاء مفتاح من Claude Console مع ضبط الفوترة، وحفظه في Keychain، واختيار Claude مزودا، واختيار النموذج ومستوى الاستدلال، ثم اختباره.
>
> جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 3 أكتوبر 2026
> https://www.roughcuteditor.com/ar/docs/claude-api-key

Claude من Anthropic هو المزود الثالث الذي يدعمه RoughCut لمرحلة المونتاج بالذكاء الاصطناعي، إلى جانب OpenAI وهو الافتراضي، وGoogle Gemini. تنشئ مفتاح API في Claude Console من الإعدادات ثم مفاتيح API، وتضبط الفوترة هناك لأن Anthropic تحاسب على استخدام API بشكل منفصل، ثم تلصق المفتاح في إعدادات RoughCut حيث يُحفظ في Keychain على macOS، ثم تضبط مزود LLM على anthropic وتضغط حفظ الإعدادات. والنموذج الافتراضي هو Claude Opus 5.5، وتتيح لك نافذة اختيار نموذج وتقدير التكلفة اختيار نموذج آخر ومستوى الاستدلال الخاص به. اختبره بمقطع قصير مفعّل فيه استبعاد المحاولات غير الموفقة. ولا يصل إلى Anthropic إلا نص التفريغ وتوقيت الكلمات، تحت مفتاحك أنت، ولا يصلها فيديوك ولا صوتك أبدا. وواجهة Claude Console تتغير بمعزل عن RoughCut، لذا اعتبر وثائق Anthropic نفسها هي المرجع للشاشات بالضبط.

## المتطلبات المسبقة

- حساب في Claude Console. وهو منفصل عن اشتراك محادثة Claude، الذي لا يموّل استخدام API.
- فوترة مضبوطة في Claude Console.
- RoughCut 1.10 أو أحدث. ولا تحتاج نموذج التعرف على الكلام في هذه الخطوة.

> تتحكم Anthropic بهذا المسار وتغيّره من حين إلى آخر. والخطوات أدناه تصف شكل العملية الحالي؛ فإذا وجدت زرا باسم مختلف، اتبع الإجراء المكافئ بدل البحث عن النص الحرفي. ووثائق Anthropic عن [مفاتيح API](https://platform.claude.com/docs/en/get-api-key) هي المرجع.

## الخطوات

1. افتح [Claude Console](https://platform.claude.com/) وسجّل الدخول، أو أنشئ حسابا. وتذكره جولة الترحيب في RoughCut أيضا، في السطر الذي يبدأ بـ `تفضّل Gemini أو Claude؟` في صفحة المفتاح.
2. اضبط الفوترة في Console. فـ Anthropic تحاسب على استخدام API بشكل منفصل عن أي اشتراك في Claude، وعن RoughCut وRoughCut Pro.
3. انتقل إلى `Settings → API keys` واضغط `Create key`. امنحه اسما ومدة صلاحية، واضبط `Linked account` على حسابك. ويُستحسن أن تحدّد للمفتاح مساحة عمل (workspace) واحدة: فإرشادات Anthropic نفسها تنصح بإنشاء المفتاح لمساحة العمل التي يستخدمها التكامل تحديدا، والمفتاح المخصص لـ RoughCut وحده يمكن تعطيله أو حذفه دون المساس بمفاتيحك الأخرى.
4. انسخ المفتاح. يبدأ بـ `sk-ant-`، ولا يعرضه Console إلا مرة واحدة؛ فإذا أضعته، أنشئ مفتاحا جديدا.
5. في RoughCut، افتح `الإعدادات`. ومن تبويب `أساسي` (أو `متقدم` ثم `LLM`) اعثر على `مفتاح Claude API`.
6. ألصق المفتاح في الحقل واضغط زر `حفظ` الخاص به. يؤكد RoughCut بالرسالة `تم حفظ مفتاح Claude API في Keychain.` وهذا الزر يحفظ المفتاح وحده.
7. اضبط `مزود LLM` على `anthropic` واضغط `حفظ الإعدادات` أعلى النافذة.
8. خطوة اختيارية: بجوار `نموذج Claude` اضغط `اختيار نموذج وتقدير التكلفة…`، ثم `تحديث النماذج` لعرض نماذج Claude التي يصل إليها مفتاحك، واختر نموذجا و`مستوى الاستدلال`، واضغط `استخدام النموذج`، ثم `حفظ الإعدادات`. والافتراضي هو `claude-opus-5-5` بمستوى الاستدلال `default`.
9. اختبره: أنشئ مشروعا قصيرا مع تفعيل `استبعاد المحاولات غير الموفقة`. فإذا كان المفتاح والفوترة سليمين، يكتمل المشروع وتعرض قائمة المراجعة ملخص محرر مثل `المحرر: Anthropic (claude-opus-5-5) — عدد المقاطع 12`.

## النتيجة المتوقعة

يعرض حقل `مفتاح Claude API` تأكيدا أخضر والقيمة مخفية، مع العبارة `محفوظ في Keychain` وزري `استبدال...` و`استبعاد`. ويعرض `مزود LLM` القيمة `anthropic`، ويظهر صف `نموذج Claude` بالشكل `claude-opus-5-5 · الاستدلال default` إلى أن تختار غير ذلك. ويكتمل مشروع الاختبار بعمليات استبعاد مقترحة من الذكاء الاصطناعي بدل نتيجة تعتمد على الصمت وحده.

## النماذج ومستويات الاستدلال

يعرض `اختيار نموذج وتقدير التكلفة…` النماذج Claude Opus 5.5 وClaude Sonnet 5.5 وClaude Fable 5.1، ثم أي نماذج Claude أخرى يصل إليها مفتاحك بعد `تحديث النماذج`، مرتبة حسب تاريخ الإصدار. ونص المساعدة الخاص بالإعداد صريح في موقع Claude: `Opus 5.5 هو الخيار المبدئي، ولم تُقيَّم نماذج Claude بعد على مجموعة تقييم RoughCut.`

وفي Claude لا يُرسل مستوى الاستدلال `default` أي مستوى، فيُطبَّق افتراضي النموذج نفسه؛ ويعرضه المنتقي بالتسمية `الافتراضي (medium)` في Claude Opus 5.5، و`الافتراضي (high)` في Claude Sonnet 5.5 وClaude Fable 5.1. وتتيح النماذج الثلاثة المدرجة المستويات `low` و`medium` و`high` و`xhigh` و`max`. والمستويات الأعلى أبطأ وأعلى تكلفة، ولا تعطي دائما مونتاجا أفضل. راجع [اختر OpenAI أو Gemini أو Claude](/ar/docs/choose-ai-provider#sec-5) لمعرفة كيف يعمل المستوى.

## ملاحظة عن الخصوصية والتكلفة

يُحفظ المفتاح في Keychain على macOS، مشفرا بواسطة النظام، ولا يُرسل إلا إلى Anthropic. وحين يكون Claude هو المزود، ترسل مرحلة المونتاج بالذكاء الاصطناعي نص التفريغ وتوقيت الكلمات مباشرة إلى Anthropic تحت مفتاحك — ولا ترسل فيديوك ولا صوتك أبدا. ولا توجد لـ RoughCut خوادم في هذا المسار، ولا يرى استخدامك ولا فاتورتك أبدا.

وتحاسبك Anthropic على مفتاحك وفق أسعارها المعلنة. والتسجيلات الطويلة أعلى تكلفة، والمستوى الأعلى للاستدلال أعلى تكلفة لأن رموز الاستدلال تُحتسب ضمن المخرجات، و[المراجعة الثانية](/ar/docs/second-look) تضيف استدعاء آخر. ولا ينشر RoughCut رقما لكل فيديو؛ ويقدّر `اختيار نموذج وتقدير التكلفة…` تكلفة مشروع بافتراضاتك أنت، ويضم `المساعدة ← تكاليف API` رابط `أسعار Claude API`.

## إدارة المفتاح وتبديله

- **`استبدال...`** يضع مفتاحا جديدا مكان القديم من دون كشف القديم.
- **`استبعاد`** يحذف المفتاح من Keychain. وعندها يتصرف RoughCut كأنه بلا مفتاح: يظل المونتاج المعتمد على الصمت وحده يعمل، بينما يفشل `استبعاد المحاولات غير الموفقة` في الفحص المسبق برسالة تطلب منك إضافة مفتاح أو تعطيل الميزة.
- وإذا تسرب مفتاح يوما ما، احذفه من Claude Console وأنشئ غيره. التبديل يستغرق ثوانٍ ولا شيء يحتاج ترحيلا.

## أخطاء شائعة

- **توقع أن يدفع اشتراك Claude ثمن استخدام API.** لا يدفعه. استخدام API يحتاج فوترة في Claude Console.
- **حفظ المفتاح وترك المزود على OpenAI أو Gemini.** زر `حفظ` الخاص بالمفتاح يخزّن المفتاح فقط. اضبط `مزود LLM` على `anthropic` واضغط `حفظ الإعدادات`.
- **إعادة استخدام مفتاح أنشأته لغرض آخر.** أنشئ مفتاحا مستقلا لـ RoughCut، محددا بمساحة عمل واحدة، لتتمكن من تعطيله أو تبديله وحده.
- **لصق مفتاح تحيط به مسافات أو علامات اقتباس.** ألصق القيمة الخام وحدها.
- **توقع ظهور المفتاح في ملف إعدادات.** لا يظهر أبدا — فالأسرار تعيش في Keychain وحده، وتُنزع قبل كتابة الإعدادات على القرص.

## حل المشكلات

يعرض RoughCut نص خطأ Claude نفسه بعد البادئة `Claude`، لذا تسمي نهاية الرسالة السبب في الغالب. وهذه الرسائل تظهر بالإنجليزية حتى في الواجهة العربية، فنقتبسها كما تظهر مع شرحها.

| الرسالة أو العَرَض | السبب المرجح | الحل |
|---|---|---|
| `لا يوجد مفتاح API للمزود «anthropic». أضفه في الإعدادات، أو عطّل استبعاد المحاولات غير الموفقة لإنشاء مونتاج يعتمد على الصمت فقط.` | لا مفتاح محفوظ | احفظ مفتاحا، أو عطّل `استبعاد المحاولات غير الموفقة` |
| `Claude HTTP 401: …` (رفض المصادقة) | لُصقت قيمة خاطئة، أو حُذف المفتاح أو انتهت صلاحيته | أنشئ مفتاحا جديدا واستخدم `استبدال...` |
| `Claude HTTP 400: …` يذكر الرصيد أو الفوترة | لا فوترة أو لا رصيد على حساب Console | اضبط الفوترة في Claude Console ثم أعد المحاولة |
| `Claude HTTP 400: …` يذكر `anthropic-workspace-id` | المفتاح غير محدد بمساحة عمل واحدة | أنشئ في Claude Console مفتاحا محددا بمساحة عمل واحدة واستخدم `استبدال...` |
| `Claude HTTP 400: …` يذكر `max_tokens` مع Claude Haiku 4.5 | يسمح Claude Haiku 4.5 بـ 64,000 رمز خرج كحد أقصى، وهو أقل من القيمة الافتراضية في RoughCut البالغة 65536 | اضبط `الإعدادات` ثم `متقدم` ثم `الحد الأقصى لرموز خرج محرر LLM` على `64000`، أو اختر نموذجا آخر |
| `Claude HTTP 404: …` (غير موجود) | النموذج المضبوط غير متاح لمفتاحك | قارن `نموذج Claude` بما يعرضه `اختيار نموذج وتقدير التكلفة…` ثم `تحديث النماذج` |
| `Claude declined this request (stop_reason refusal)` (رفض Claude الطلب) | رفض النموذج معالجة هذا النص المفرغ | أعد المحاولة، أو اختر نموذجا أو مزودا آخر لهذا التسجيل |
| `Claude: the transcript exceeds this model's context window (stop_reason model_context_window_exceeded)` (النص يتجاوز نافذة سياق النموذج) | جزء النص المفرغ أطول مما يتسع له هذا النموذج | اختر نموذجا بنافذة سياق أكبر، أو خفّض `حجم جزء محرر LLM (كلمات)` في `الإعدادات` ثم `متقدم` |
| `Claude stream ended before the response completed` أو `Claude: no HTTP response` (انقطع الاتصال) | انقطع الاتصال | تحقق من الاتصال وأعد المحاولة |
| انتهاء المهلة | لم تصل أي بيانات من Claude لمدة أطول من `مهلة Claude (ثانية)` | المهلة 600 ثانية افتراضيا وتقيس الصمت لا المدة الكلية؛ ارفعها، أو أعد المحاولة |
| `… لا يدعم مستوى الاستدلال …` | النموذج المحدد لا يتيح المستوى المحفوظ | اختر مستوى مدعوما في `اختيار نموذج وتقدير التكلفة…` واضغط `حفظ الإعدادات` |