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

> امنح حسابًا أمرًا خاصًا به مثل ccwork باستخدام ccam shortcut، وأعد إنشاء الروابط في ~/.local/bin باستخدام ccam shims install.

Source: https://ccam.dev/ar/features/shortcuts/ · Updated 2026-10-19

الأمر المختصر أمر تختار اسمه بنفسك، ويشغّل Claude Code بحساب واحد: يفعل `ccwork --resume` ما يفعله `ccam work --resume`. وهو رابط إلى ccam في `~/.local/bin`، لذلك يعمل في bash وzsh والسكربتات وأي شيء آخر يشغّل البرامج من `PATH`. الأوامر المختصرة اختيارية؛ أنشئ واحدًا للحسابات التي تشغّلها كثيرًا.

## الاستخدام

```sh
ccam shortcut work ccwork     # create the shortcut ccwork for work
ccam shortcut 2 ccside        # the account with number 2
ccam shortcut work            # show it
ccam shortcut work ccw        # rename it; the old link is removed
ccam shortcut work --remove   # delete it
ccam add side --shortcut ccside
ccam shims install            # recreate missing links of all accounts
ccwork -p "summarise" --output-format json
```

يؤكد ccam كل تغيير:

```console
$ ccam shortcut work ccwork
✓ shortcut for work: ccwork
$ ccam shortcut work ccw
✓ shortcut for work: ccw (was ccwork)
$ ccam shortcut work --remove
✓ ccw removed; work has no shortcut now
$ ccam shortcut work
work: none (add one with `ccam shortcut work ccwork`)
```

للحساب أمر مختصر واحد على الأكثر، ويُخزَّن باسم `shortcut` في `~/.config/ccam/config.toml`. يسأل معالج `ccam add` السؤال `Create a shortcut command for <name>? [y/N]` ثم `Shortcut name [cc<name>]:`. وخارج المعالج، لا ينشئ `ccam add` أمرًا مختصرًا إلا مع `--shortcut`. ويعرض `ccam list` الأمر المختصر لكل حساب، أو `-`.

يمرّر الأمر المختصر كل وسيط إلى Claude Code، بالطريقة نفسها التي يفعلها `ccam <name>` بعد الاسم. ويشمل ذلك `--dry-run` و`--help`: لمعاينة تشغيل، استخدم `ccam --dry-run work`.

## الخيارات

| الخيار | ما يفعله | القيمة الافتراضية |
| --- | --- | --- |
| `--remove` | يحذف الأمر المختصر للحساب ورابطه | معطّل |
| `-h`، `--help` | مساعدة الأمر | |
| `--dry-run` | يدعمه `ccam shortcut`: يتحقق من الاسم ويطبع `Would set the shortcut of work to ccwork.` أو `Would remove ccwork, the shortcut of work.` دون حفظ أو إنشاء رابط | معطّل |

لا يأخذ `ccam shims install` أي وسائط، ويرفض `--dry-run` مع الرسالة `` ccam: --dry-run is not supported by `ccam shims install`; nothing was changed ``.

قواعد الاسم، وتُفحص بهذا الترتيب:

- من 1 إلى 64 حرفًا من `a-z` و`0-9` و`.` و`-` و`_`، ويبدأ بحرف أو رقم؛
- ليس `ccam` أو `claude` أو أمرًا من أوامر ccam مثل `run` أو `usage`؛
- ليس أمرًا مختصرًا لحساب آخر؛
- ليس ملفًا في `~/.local/bin` إلا إذا كان رابطًا إلى ccam بالفعل؛
- ليس اسم برنامج تنفيذي آخر في `PATH`.

تحديد أمر مع `--remove` معًا يتوقف مع `give a command or --remove, not both`. وتعيين الاسم الذي يملكه الحساب بالفعل يطبع `work: ccwork (unchanged)` ويعيد إنشاء رابطه إذا كان مفقودًا.

## كيف يعمل

تعيين اسم يشغّل `checkShortcut`، الذي يستدعي `shim.Check` مع مجلد bin والمسار الحقيقي لملف ccam التنفيذي:

ينتقل الاسم عبر الفحوص بالترتيب. وبجانب كل فحص اسم يرفضه: `Work` لا يطابق النمط، و`run` أمر من أوامر ccam، و`ccside` يخص حسابًا آخر، و`ccfile` ملف موجود في `~/.local/bin`، و`git` سيحجب `/usr/bin/git`. ولا يُحفظ ويُربط إلا الاسم الذي يجتاز كل الفحوص.

1. يطابق `shim.Check` الاسم مع `^[a-z0-9][a-z0-9._-]{0,63}$`، ثم مع `config.Reserved`، ثم مع `cfg.FindShortcut`. ويستدعي `os.Lstat` على `~/.local/bin/<name>`، ولكل مجلد آخر في `PATH` يستدعي `os.Stat` ويرفض الملف التنفيذي الذي ليس رابطًا إلى ccam.
2. يحفظ ccam الملف `config.toml` باستخدام `fsutil.AtomicWrite` (ملف مؤقت، ثم `fsync`، ثم إعادة تسمية).
3. يحذف `shim.Remove` رابط الأمر المختصر القديم، ولكن فقط إذا كان رابطًا إلى ccam.
4. ينشئ `shim.Install` رابط كل أمر مختصر مُعدّ ومفقود، باستخدام `os.Symlink` إلى ملف ccam التنفيذي، الذي يُحدَّد مساره باستخدام `os.Executable` و`filepath.EvalSymlinks`. ولا يحذف أي شيء أبدًا.

يُعدّ الرابط خاصًا بـ ccam عندما يُرجع `os.Readlink` مسار ccam، أو عندما يشير الرابط ومسار ccam إلى الملف نفسه. وكل عملية حذف وكل فحص استبدال يمرّ عبر هذا الاختبار، فلا يلمس ccam ملفات لم ينشئها.

عندما تشغّل أمرًا مختصرًا، فالاسم الذي كتبته هو كل ما يحتاجه ccam:

تجد الصدفة `ccwork` في `PATH`، ويتبع النواة الرابط ويشغّل ملف ccam التنفيذي، ويظل `argv[0]` هو `ccwork`. في `app.Main`، أي اسم غير `ccam` يحمّل `config.toml` مرة واحدة ويستدعي `shim.Lookup`، الذي يجد الحساب الذي يساوي `shortcut` فيه `filepath.Base(argv[0])`. ثم يتبع `launcher.LaunchWith` الخطوات نفسها التي يتبعها [`ccam <name>`](https://ccam.dev/ar/features/launch.md) مع الإعداد المحمَّل مسبقًا، ويمرّر `argv[1:]` إلى `claude` دون تغيير.

لماذا رابط رمزي وليس اسمًا مستعارًا في الصدفة أو سكربتًا مغلِّفًا: الرابط الرمزي يعمل في كل صدفة وفي السكربتات، ولا يضيف تشغيل صدفة إضافيًا (نحو 1 إلى 2 ms)، ويظل التشغيل يقرأ ملفًا واحدًا. يقيس `scripts/perf-check.sh` الأمر المختصر باستخدام `hyperfine` مقابل الحد نفسه البالغ 10 ms (p95) المطبق على `ccam <name>`.

## الأمان والحالات الخاصة

- **رابط لا يملكه أي حساب.** إذا كان في `~/.local/bin` رابط إلى ccam باسم لا يستخدمه أي حساب، مثلًا بعد أن عدّلت `shortcut` في `config.toml` يدويًا، فلا يلجأ ccam إلى الحساب الافتراضي. بل يتوقف مع `` ccam: ccold is not the shortcut of any account (see `ccam list`, `ccam shortcut`) ``. عيّن الاسم مرة أخرى باستخدام `ccam shortcut`، أو احذف الرابط.
- **الملفات الموجودة.** لا يستبدل ccam أبدًا ملفًا لم ينشئه. ويتوقف `ccam shims install` مع `<path> already exists and is not a ccam link, so it was left alone`.
- **نقل ملف ccam التنفيذي.** عندها تشير الروابط القديمة إلى مسار لم يعد موجودًا، ولا يعدّها ccam خاصة به. احذفها، ثم شغّل `ccam shims install`.
- **إعادة التسمية والإزالة.** يحتفظ `ccam rename` باسم الأمر المختصر، ويظل الرابط يعمل، لأنه يشير إلى ccam ويبحث ccam عن الاسم في `config.toml`. ويحذف `ccam remove` رابط الحساب. ويحذف `ccam shortcut <account> <new>` الرابط القديم قبل أن ينشئ الجديد.
- **PATH.** عندما ينشئ ccam رابطًا ولا يكون `~/.local/bin` في `PATH` لديك، يطبع `Note: /home/me/.local/bin is not in PATH. Add it to ~/.bashrc or ~/.zshrc:` متبوعًا بسطر `export PATH=...` الذي تضيفه.
- **الفحص لاحقًا.** يبلّغ `ccam doctor` بـ `missing shortcuts in /home/me/.local/bin: ccwork` ويحذّر عندما لا يكون المجلد في `PATH`. وينشئ `ccam doctor --fix` الروابط المفقودة.

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

- [تشغيل Claude Code](https://ccam.dev/ar/features/launch.md)
- [إدارة الحسابات](https://ccam.dev/ar/features/accounts.md)
- [مرجع الأوامر](https://ccam.dev/ar/docs/commands.md#shortcuts)
- [تثبيت ccam](https://ccam.dev/ar/docs/install.md)