# مرجع الأوامر

> كل أوامر ccam وخياراتها، من ccam add وccam <name> إلى ccam usage وccam next وccam doctor.

Source: https://ccam.dev/ar/docs/commands/ · Updated 2026-10-19

ضع `--dry-run` قبل أمر لترى ما سيفعله دون أن يفعله، مثلًا `ccam --dry-run work`. يعمل ذلك عند تشغيل Claude Code (`ccam <name>` و`ccam run` و`ccam next`) ومع `share` و`migrate` و`shortcut` و`update` و`doctor --fix`. أما الأوامر الأخرى التي تغيّر شيئًا فترفضه بدلًا من أن تعمل.

| الأمر | ما يفعله |
| --- | --- |
| `ccam` | يفتح أداة اختيار الحساب |
| `ccam <name|number> [claude arguments]` | يشغّل Claude Code بذلك الحساب؛ تُمرَّر الوسائط دون تغيير |
| `ccam add [name]` | يضيف حسابًا: مجلد الإعدادات وتسجيل الدخول وأمر مختصر اختياري |
| `ccam completion bash|zsh` | يطبع الإكمال التلقائي لـ bash أو zsh |
| `ccam doctor` | يفحص الروابط والأذونات وتسجيلات الدخول والإصدارات، ويصلحها |
| `ccam import [folder]` | يسجّل مجلد ~/.claude موجودًا في مكانه |
| `ccam list` | يعرض قائمة الحسابات |
| `ccam login <name|number>` | يسجّل دخول حساب من جديد |
| `ccam logout <name|number>` | يزيل تسجيل دخول حساب |
| `ccam mcp [command]` | يدير خوادم MCP المشتركة |
| `ccam migrate [folder]` | ينسخ إعداد Claude Code موجودًا (~/.claude) إلى مجموعة مشتركة |
| `ccam next [--auto] [--continue] [-- claude args]` | يفتح الحساب التالي؛ يحتفظ الخيار --continue بالمحادثة، ويختار الخيار --auto الحساب الأكثر سعة |
| `ccam remove <name|number>` | يزيل حسابًا؛ ويُنقل مجلده إلى مجلد المهملات |
| `ccam rename <name> <new-name>` | يعيد تسمية حساب؛ ويبقى اسم أمره المختصر كما هو |
| `ccam share <name|number> [--mcp on|off|<group>] [--history …]` | يغيّر ما يشاركه الحساب، بعد عرض الخطة |
| `ccam shims [command]` | يعيد إنشاء روابط الأوامر المختصرة لكل الحسابات |
| `ccam shortcut <name|number> [command]` | يعرض الأمر المختصر لحساب، مثل ccwork، أو ينشئه أو يعيد تسميته أو يزيله |
| `ccam statusline` | يعرض الحساب والاستخدام في سطر الحالة في Claude Code |
| `ccam update` | يحدّث ccam إلى أحدث إصدار بعد فحص مجموع التحقق |
| `ccam usage` | يعرض استخدام كل الحسابات خلال 5 ساعات وخلال الأسبوع |
| `ccam use <name|number>` | يعيّن الحساب الافتراضي |

## تشغيل Claude Code

يشغّل `ccam <name|number> [arguments]` برنامج Claude Code بذلك الحساب. لا يقرأ ccam الوسائط التي تأتي بعد الاسم؛ بل يمرّرها إلى `claude` بالترتيب نفسه، ويتصرف الإدخال القياسي ورمز الخروج والإشارات تمامًا كما مع `claude` نفسه. وضع `--` بعد الاسم اختياري.

أما `ccam` مع وسائط ولكن دون اسم حساب، مثل `ccam -p "summarise"`، فيستخدم الحساب الافتراضي. عيّنه باستخدام `ccam use <name>`.

يشغّل الأمر المختصر مثل `ccwork` حسابه بالطريقة نفسها: يفعل `ccwork --resume` ما يفعله `ccam work --resume`. راجع [الأوامر المختصرة](https://ccam.dev/ar/docs/commands.md#shortcuts).

## إضافة الحسابات وإزالتها

```sh
ccam add                      # wizard
ccam add work --share history=on
ccam add side --shortcut ccside
ccam add ci --no-login        # log in later with: ccam login ci
ccam rename work job
ccam remove side              # folder moves to ~/.local/share/ccam/trash
ccam import ~/.claude-old --name old
```

عند تشغيل `ccam import` دون تحديد مجلد، يبحث عن `~/.claude` و`~/.claude-*` ويسألك عن كل واحد منها. تُسجَّل المجلدات المستوردة في أماكنها؛ ولا ينقل ccam أي تسجيل دخول أو ينسخه أبدًا.

ترفض الأوامر `ccam rename` و`ccam remove` و`ccam share` تغيير حساب ما دام Claude Code يعمل بذلك الحساب. أنهِ الجلسة أولًا.

يطبع `ccam list --json` كل حساب مع رقم خانته واختصاره وبريده الإلكتروني ومجلده. ويربط الكائن `share` كل عنصر (`mcp` و`settings` و`memory` و`extensions` و`history`) باسم مجموعة أو بالقيمة `local`.

## الأوامر المختصرة

```sh
ccam shortcut work ccwork     # create it, or rename the existing one
ccam shortcut work            # show it
ccam shortcut work --remove
```

الأمر المختصر أمر تختار اسمه بنفسك، ويشغّل Claude Code بحساب واحد. ومثل `ccam work`، يمرّر كل وسيط إلى Claude Code دون تغيير، لذلك يعمل `ccwork --resume` و`ccwork -p "hi"` كما تتوقع. وهو رابط إلى ccam في `~/.local/bin`.

الأوامر المختصرة اختيارية. يسألك معالج `ccam add` هل تريد إنشاء واحد، وينشئ `ccam add <name> --shortcut <command>` واحدًا دون سؤال، ويعرض `ccam list` الأمر المختصر لكل حساب، أو `-` إذا لم يكن له أمر.

تستخدم الأسماء الأحرف a-z و0-9 و`.` و`-` و`_`. ولا يجوز أن يكون الاسم أمرًا من أوامر ccam، أو أمرًا مختصرًا لحساب آخر، أو اسم برنامج آخر موجود في `PATH`.

يحتفظ `ccam rename` باسم الأمر المختصر، ويحذف `ccam remove` الأمر المختصر مع الحساب. ويعيد `ccam shims install` إنشاء روابط كل الحسابات، مثلًا بعد نقل ccam.

## المشاركة

```sh
ccam share work                       # show the current state
ccam share work --history on --mcp team
ccam share work --settings off --fresh
```

يقبل كل عنصر القيمة `on` (المجموعة `default`) أو `off` أو اسم مجموعة. راجع [المشاركة](https://ccam.dev/ar/docs/sharing.md).

## نسخ إعداد موجود

```sh
ccam migrate                    # ~/.claude into the default group
ccam --dry-run migrate          # show the plan, copy nothing
ccam migrate ~/.claude-work --group work --settings --mcp
ccam migrate --history --yes    # conversation history only
```

ينسخ `ccam migrate` الملفات `settings.json` و`CLAUDE.md` والإضافات وخوادم MCP الخاصة بالمستخدم من مجلد Claude Code إلى مجموعة، فتحصل عليها كل الحسابات التي تشارك هذه العناصر. يُقرأ المجلد فقط. تنسخ الخيارات `--settings` و`--memory` و`--extensions` و`--mcp` و`--history` العناصر التي تحددها فقط. ودونها تتيح لك قائمة اختيار في الطرفية أن تختار، مع تحديد كل شيء ما عدا سجل المحادثات؛ وفي غير ذلك يُنسخ كل شيء ما عدا سجل المحادثات. يختار `-g` أو `--group` المجموعة، وينسخ `-y` أو `--yes` دون سؤال ويحتفظ بنسخة المجموعة عندما يختلف ملف. كما ينسخ تسجيلات الدخول المحفوظة للخوادم إلى ملف تسجيل الدخول الخاص بكل حساب. راجع [نسخ إعداد موجود](https://ccam.dev/ar/docs/sharing.md#copy-an-existing-setup).

## خوادم MCP

```sh
ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp add docs --url https://mcp.example.com/mcp --header "Authorization: Bearer $TOKEN"
ccam mcp add-json db '{"type":"stdio","command":"db-mcp"}'
ccam mcp list
ccam mcp import work gh
ccam mcp remove fs
```

ينقل `ccam mcp import <account>` الخوادم التي لا يملكها إلا ذلك الحساب إلى مجموعته. ويُتخطّى الخادم الذي تستخدم المجموعة اسمه بالفعل لتعريف مختلف؛ أضف `--force` لاستبدال نسخة المجموعة، ويحتفظ ccam بنسخة احتياطية منها أولًا.

## الاستخدام والتبديل

```sh
ccam usage           # also: ccam u
ccam usage --watch   # refresh every 60 seconds
ccam usage --json
ccam next --continue
ccam next --auto
```

## الصيانة

```sh
ccam doctor          # check
ccam doctor --fix    # repair what is safe to repair, with backups
ccam statusline install
ccam shims install   # recreate the shortcut links
ccam update          # install the latest ccam release
ccam update --check  # only check for a newer release
ccam version         # also: ccam -v, ccam --version
```

يتحقق `ccam update` من مجموع SHA-256 الخاص بالإصدار قبل أن يستبدل ccam، ويثبّت `--version v0.2.0` إصدارًا محددًا. أما ccam المثبّت من حزمة `.deb` فيُحدَّث باستخدام apt. راجع [التحديث](https://ccam.dev/ar/docs/install.md#update).

## الملفات

| المسار | المحتوى |
| --- | --- |
| `~/.config/ccam/config.toml` | الحسابات وما تشاركه |
| `~/.local/share/ccam/profiles/<name>/` | مجلد `CLAUDE_CONFIG_DIR` لكل حساب |
| `~/.local/share/ccam/groups/<group>/` | الإعدادات وخوادم MCP والإضافات والسجل المشتركة |
| `~/.local/state/ccam/` | ذاكرة التخزين المؤقت للاستخدام وأوقات آخر استخدام |
| `~/.local/bin/<shortcut>` | أوامر مختصرة مثل `ccwork`، وهي روابط إلى ccam |

تغيّر المتغيرات `XDG_CONFIG_HOME` و`XDG_DATA_HOME` و`XDG_STATE_HOME` مواقع هذه المجلدات.