مرجع الأوامر

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

تشغيل Claude Code

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

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

يشغّل الأمر المختصر مثل ccwork حسابه بالطريقة نفسها: يفعل ccwork --resume ما يفعله ccam work --resume. راجع الأوامر المختصرة.

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

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.

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

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.

المشاركة

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

يقبل كل عنصر القيمة on (المجموعة default) أو off أو اسم مجموعة. راجع المشاركة.

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

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 دون سؤال ويحتفظ بنسخة المجموعة عندما يختلف ملف. كما ينسخ تسجيلات الدخول المحفوظة للخوادم إلى ملف تسجيل الدخول الخاص بكل حساب. راجع نسخ إعداد موجود.

خوادم MCP

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 بنسخة احتياطية منها أولًا.

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

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

الصيانة

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. راجع التحديث.

الملفات

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