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

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

الاستخدام

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 كل تغيير:

$ 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.

الخيارات

لا يأخذ 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> مع الإعداد المحمَّل مسبقًا، ويمرّر 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
• إدارة الحسابات
• مرجع الأوامر
• تثبيت ccam