# كيف أجعل Claude Code يفرّغ الصوت والفيديو؟

> أضف خادم MCP من KolWrite بأمر واحد هو claude mcp add، أو ثبّت المهارة kolwrite-transcribe. بعدها يرفع Claude Code ملفك ويبدأ المهمة وينتظر انتهاءها ثم يكتب التفريغ أو الترجمات النصية أو الترجمة إلى لغة أخرى داخل مشروعك، وتُحتسب التكلفة بالثانية من رصيدك في KolWrite.

آخر تحديث: 2026-11-21 · HTML: https://console.kolwrite.com/ar/agents/claude-code

## ما تفعله مرة واحدة

أنشئ الحساب والمفتاح بنفسك من [console.kolwrite.com](https://console.kolwrite.com/auth?lang=ar): سجّل، وأضف رصيدًا، ثم افتح «API Keys» وأنشئ مفتاحًا. لا يستطيع الوكيل القيام بذلك نيابةً عنك.

احفظ المفتاح في ملف إعدادات الـ shell (`~/.zshrc` أو `~/.bashrc`) لتتمكن كل جلسة وكيل تبدأها من قراءته، ثم افتح نافذة طرفية جديدة:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

تقرأ الأدوات المفتاح من هذا المتغير فقط. لا تلصقه في محادثة ولا تضعه في مستودع.

## إضافة خادم MCP

شغّل الأمر التالي في طرفية يكون فيها `KOLWRITE_API_KEY` مضبوطًا. أضف `--scope user` ليكون الخادم متاحًا في كل مشروع:

```bash
claude mcp add --transport stdio --env KOLWRITE_API_KEY="$KOLWRITE_API_KEY" kolwrite -- npx -y https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz
```

يمنح الخادم الوكيل ستّ أدوات: `transcribe_file`، `transcribe_url`، `upload_file`، `get_job`، `list_models`، `list_languages`. يعمل على جهازك بإصدار Node.js 18 أو أحدث، وتُنزَّل حزمته من https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 `0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca`).

تحقق منه بالأمر `claude mcp list`، أو بالأمر `/mcp` داخل الجلسة.

## أو تثبيت مهارة الوكيل

المهارة مجلد يضم ملف SKILL.md والعميل المؤلّف من ملف واحد. يحمّلها Claude Code من `~/.claude/skills` (لكل المشاريع) أو من `.claude/skills` (لمشروع واحد) ويستخدمها عندما تطلب منه تفريغًا:

```bash
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip && rm kolwrite-transcribe.zip
```

نص المهارة موجود في [SKILL.md](https://console.kolwrite.com/skills/kolwrite-transcribe/SKILL.md). استخدم خادم MCP أو المهارة، ولا حاجة إلى الاثنين معًا.

## ماذا تطلب

ثلاثة طلبات يمكنك تجربتها مع Claude Code:

```text
فرّغ الملف ~/Downloads/interview.m4a بواسطة KolWrite واحفظ النص في interview.txt بجانبه.

أنشئ ترجمات SRT بالإنجليزية للملف talk.mp4 بواسطة KolWrite، بحيث تكون كل جملة في مقطع ترجمة مستقل.

من قال ماذا في team-call.mp3؟ فرّغه مع تمييز المتحدثين بالنموذج oracle، ثم اذكر المهام المطلوبة من كل متحدث.
```

يحتاج Claude Code إلى الملف على جهازك أو إلى رابط مباشر لملف وسائط. وإذا تجاوز حجم الفيديو 100 MiB تقريبًا، فإنه يستخرج الصوت أولًا بواسطة ffmpeg.

## التكلفة

| المهمة | النموذج | التكلفة |
| --- | --- | --- |
| مقابلة مدتها 30 دقيقة، نص عادي | `base` | 0.24 دولار |
| اجتماع مدته ساعة مع تمييز المتحدثين | `oracle` | 1.56 دولار |
| محاضرة بالعبرية مدتها ساعة مع ترجمات نصية بالإنجليزية | `oracle` | 1.44 دولار |
| ساعة من صوت مشوَّش وكلام متداخل | `oracle_max` | 3.60 دولار |

تُحتسب التكلفة بالثانية من مدة الصوت وتُخصم من رصيدك، دون حدّ أدنى. يضيف تمييز المتحدثين 0.10 رصيد لكل ساعة صوت. يستخدم خادم MCP وملف kolwrite.py النموذج `base` ما لم تحدد أنت أو الوكيل نموذجًا آخر، والنموذج `oracle_mini` عند الترجمة. الأسعار كاملةً: [/ar/models](https://console.kolwrite.com/ar/models).

## ما يجب ألا يفعله الوكيل

- أن يطلب منك المفتاح في المحادثة، أو يطبعه، أو يكتبه في ملف أو أمر أو commit.
- أن يعيد بدء التفريغ نفسه بعد انتهاء المهلة أو حدوث خطأ في الشبكة. كل بدء يُنشئ مهمة جديدة تُحتسب تكلفتها، لذا عليه أن يتحقق من حالة المهمة القائمة أو يسألك.
- أن يكتب الطوابع الزمنية بنفسه. لقصّ مقطع أو اقتباسه بحسب الوقت، يأخذ أرقام المقاطع من التفريغ ويحسب الأوقات في الكود من أوقات الكلمات.
- أن يرسل رابط YouTube أو أي صفحة ويب أخرى على أنه الملف. المطلوب هو ملف الوسائط نفسه.
- أن يفرّغ تسجيلات طويلة (أكثر من ساعة) دون أن يخبرك بالتكلفة المتوقعة أولًا.

## أسئلة وأجوبة

### هل يحتاج Claude Code إلى خادم MCP، أم يستطيع استدعاء الـ API بنفسه؟

يستطيع استدعاء REST API بنفسه عبر curl أو Python إذا أضفت إلى `CLAUDE.md` القاعدة الموجودة في [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md). يوفّر عليه خادم MCP أو المهارة كتابة كود الرفع والمتابعة في كل مرة.

### إلى أين يذهب الصوت؟

يُرفع الملف إلى KolWrite ويُفرَّغ في السحابة وفق [شروط KolWrite وسياسة الخصوصية](https://www.kolwrite.com/tos_pp.html). لا يحتفظ خادم MCP بأي نسخة.

## صفحات ذات صلة

- [Codex](https://console.kolwrite.com/ar/agents/codex)
- [أي وكيل: kolwrite.py والمهارة](https://console.kolwrite.com/ar/agents/any-agent)
- [تحرير الفيديو مع وكلاء الذكاء الاصطناعي](https://console.kolwrite.com/ar/guides/video-editing-with-ai)
- [أداة تفريغ لوكلاء الذكاء الاصطناعي](https://console.kolwrite.com/ar/guides/transcription-tool-for-ai-agents)
- [توثيق الـ API](https://console.kolwrite.com/ar/public_api_docs)

---
احصل على مفتاح API: https://console.kolwrite.com/auth?lang=ar · توثيق الـ API: https://console.kolwrite.com/ar/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
