# واجهة Hugging Face CLI لوكلاء الذكاء الاصطناعي

يُعدّ سطر الأوامر `hf` طريقة رائعة لربط وكلاءك بـ Hugging Face Hub والنظام البيئي المحيط به. ابحث عن النماذج، وأدر مجموعات البيانات والخزانات، وأطلق Spaces، ونفّذ المهام من أي وكيل برمجي.

> [!TIP]
> هذا دليل سريع حول الوكلاء الذين يستخدمون واجهة سطر الأوامر. لمزيد من المعلومات التفصيلية، راجع [مرجع واجهة سطر الأوامر نفسه](https://huggingface.co/docs/huggingface_hub/guides/cli).

## تثبيت واجهة سطر الأوامر

تأكد من تثبيت `hf` CLI وتحديثه إلى أحدث إصدار. راجع [دليل تثبيت CLI](https://huggingface.co/docs/huggingface_hub/guides/cli#getting-started) للحصول على تعليمات الإعداد.

يقوم المثبّت المستقل الموصى به أيضاً بتثبيت مهارة CLI على مستوى النظام، بما في ذلك موقع Claude Code، بحيث يلتقطها الوكلاء دون أي خطوة إضافية. مرّر `--exclude-skill` (أو `-ExcludeSkill` على Windows) لتخطيها.

## أضف مهارة سطر الأوامل

توفّر المهارات (Skills) لوكيلك السياق الذي يحتاجه لاستخدام الأدوات بفعالية. يضيف المثبّت المستقل مهارة سطر الأوامر (CLI Skill) نيابةً عنك — ثبّتها يدويًا إذا كنت قد استخدمت pip أو Homebrew، أو تجاوزتها، أو ترغب في تضمينها في مشروع واحد. تعرّف على المزيد حول المهارات (Skills) في [agentskills.io](https://agentskills.io).

```bash
# install globally (available in all projects, works with Claude Code, Codex, Cursor,
# OpenCode, and any agent that loads skills from ~/.agents/skills)
hf skills add --global

# or install for the current project only
hf skills add
```

> [!TIP]
> يتم توليد المهارة من نسخة CLI المثبتة محليًا لديك، لذا تصبح قديمة عند ترقية البرنامج. `hf update` يحدّث المهارة المثبتة على مستوى النظام — دون إعادة إضافة أي مهارة قمت بإزالتها — بينما `hf skills update -g` يحدّثها بشكل مستقل. كما ينبّهك `hf` مرة واحدة يوميًا إذا كانت المهارة مفقودة أو قديمة؛ ويمكنك كتم هذا التنبيه باستخدام `HF_HUB_DISABLE_UPDATE_CHECK=1`.

بديلًا عن ذلك، يمكنك التثبيت عبر نظام إضافات Claude Code:

```bash
claude
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills
```

## الموارد

- [مرجع سطر الأوامر](https://huggingface.co/docs/huggingface_hub/guides/cli) - توثيق كامل للأوامر
- [إعدادات الرموز](https://huggingface.co/settings/tokens) - إدارة رموزك
- [توثيق المهام](https://huggingface.co/docs/huggingface_hub/guides/cli#hf-jobs) - دليل مهام الحوسبة

