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

إذا كنت قد استخدمت Claude Code قبل ccam، فإعدادك موجود في ~/.claude و~/.claude.json. ينسخه ccam migrate إلى مجموعة مشاركة، فيبدأ كل حساب يشارك هذه العناصر عبر المجموعة بالإعداد الذي لديك بالفعل. يُقرأ المجلد المصدر فقط، ويستمر claude العادي في العمل كما كان. شغّله مرة واحدة بعد أول ccam add، ومرة أخرى كلما بدأ حساب ما بمشاركة خوادم MCP.

الاستخدام

ccam migrate                         # ~/.claude into group default, checklist on a terminal
ccam --dry-run migrate               # show the plan, copy nothing
ccam migrate --settings --mcp        # only these items, no checklist
ccam migrate --history --yes         # conversation history only, no questions
ccam migrate ~/.claude-work --group work

في الطرفية، ودون خيارات العناصر ودون --yes، يعرض ccam أولًا قائمة اختيار:

 Copy into group default

 From /home/me/.claude
 ? Choose what to copy (Space to toggle)
 › [x] MCP servers
   [x] settings.json
   [x] global CLAUDE.md
   [x] agents, commands, skills
   [ ] conversation history

 Enter show the plan · Esc cancel

يبدّل مفتاح المسافة (أو x) العنصر الذي تحت المؤشر، وتنقل مفاتيح الأسهم أو j/k التحديد، ويعرض Enter الخطة، ويطبع Esc أو q أو Ctrl+C الرسالة Cancelled.. والعناصر التي لا يحتوي المصدر على شيء لها تُعلَّم بـ not found. وإذا ألغيت تحديد كل شيء، يطبع ccam الرسالة Nothing selected. ويتوقف.

ثم يطبع ccam الخطة ويسألك قبل أن ينسخ:

$ ccam migrate --yes
Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default):
  mcp         ~/.claude.json  new: fs, linear
              sign-ins        linear → personal; skipped: work (not logged in yet)
  settings    settings.json   new: 61 B
  memory      CLAUDE.md       new: 11 B
  extensions  agents/         add 1 file the group lacks (6 B)
              skills/         add 1 file the group lacks (13 B)
              not found, skipped: commands/, plugins/, output-styles/, rules/
  Conversation history (projects/, history.jsonl) is not included; add --history to copy it.
✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, skills/, MCP sign-ins for personal
MCP sign-ins were not copied to: work (not logged in yet). Sign in to those servers there with /mcp.
Accounts that share these through group default:
  mcp         personal, work
  settings    personal, work
  memory      personal, work
  extensions  personal, work

لا تصل المجموعة إلا إلى الحسابات التي تشارك عنصرًا عبرها، لذلك يسرد الملخص هذه الحسابات لكل عنصر. وللحسابات التي لا تشاركه، يطبع ccam أوامر ccam share <name> --<item> on التي تفعّل المشاركة.

الخيارات

دون أي خيار للعناصر، تحدد قائمة الاختيار ما يُنسخ في الطرفية. وخارج الطرفية، أو مع --yes، ينسخ ccam كل شيء ما عدا سجل المحادثات. ويُستثنى السجل افتراضيًا لأن projects/ قد يكون كبيرًا.

القيمة --group on تعني default. وتُرفض --group off و--group local مع --group takes a group name, not "off". يدعم ccam migrate الخيار --dry-run، وتظل قائمة الاختيار تظهر في التشغيل التجريبي لتتمكن من معاينة اختيار ما.

كيف يعمل

يختار internal/cli/migrate.go العناصر، ثم يقرأ migrate.Build المصدر والمجموعة ويُرجع خطة. ولا يُكتب شيء حتى Plan.Apply، بعد أن تؤكد.

1. إيجاد المصدر. يرفض checkSource المسار المفقود، أو الذي ليس مجلدًا، أو الذي لا يحتوي على أي مدخل معروف من Claude Code. ويجد migrate.ClaudeJSON ملف .claude.json الذي يخص المجلد: داخله، أو بالنسبة إلى ~/.claude الذي ليس فيه واحد، ~/.claude.json بجانبه. فهناك يحتفظ به Claude Code عندما لا يكون CLAUDE_CONFIG_DIR معيّنًا.
2. ربط العناصر بالمسارات. يأتي كل مسار من share.Layout، وهي قائمة السماح نفسها التي يستخدمها ccam share. وتُقرأ خوادم MCP من .claude.json باستخدام mcp.LocalServers، الذي يستخدم الماسح profile.TopLevelValue بدلًا من تحليل الملف كله.
3. النسخ لا النقل. تذهب الملفات إلى ~/.local/share/ccam/groups/<group>/ باستخدام fsutil.AtomicWrite أو fsutil.CopyFile؛ وتذهب خوادم MCP إلى ملف mcp.json الخاص بالمجموعة.

يربط كل عنصر مسارًا واحدًا في المصدر بمسار واحد في المجموعة:

صفّا السجل متقطعان لأنهما لا يُنسخان إلا مع --history. ويُدرج .credentials.json و.claude.json في share.Never ولا يصلان إلى المجموعة أبدًا: يُرجع Build خطأ داخليًا إذا ظهر أحدهما يومًا في البنية، ويتخطاهما المرور على المجلد بالاسم.

يمنح buildEntry كل مسار حالة، وهي ما يصفه كل سطر في الخطة:

• Missing: غير موجود في المصدر، أو ملف حيث يُتوقع مجلد. يُذكر مرة واحدة لكل عنصر بالشكل not found, skipped.
• Linked: مسار المصدر يشير بالفعل إلى نسخة المجموعة، مثلًا عندما يكون المصدر مجلد حساب في ccam.
• Same: لدى المجموعة بالفعل محتوى مطابق.
• New: لا تملكه المجموعة، فيُنسخ كاملًا.
• Merge: مجلد موجود في الجهتين. لا يضيف copyMissing إلا الملفات التي لا تملكها المجموعة؛ والملفات المختلفة تبقى كما هي في المجموعة، وتقول الخطة group copies kept. وبالنسبة إلى plugins/، يُدمج السجلان installed_plugins.json وknown_marketplaces.json، وتُعاد كتابة مسارات الإضافات المطلقة لتشير إلى مجلد المجموعة.
• Conflict: ملف موجود في الجهتين بمحتوى مختلف. تختار لكل ملف: keep group أو use mine، إضافة إلى merge JSON لملفات .json (دمج عميق تتقدم فيه المجموعة عند تعارض القيم) أو merge by line لـ history.jsonl. وخادم MCP الذي يختلف تعريفه تعارض أيضًا، مع keep group أو use mine. والخيار الأول المذكور هو الافتراضي عندما تضغط Enter؛ ويحتفظ --yes دائمًا بنسخة المجموعة.

قائمة الاختيار نفسها هي tui.MigratePicker المبنية على المكوّن checklist الذي يستخدمه ccam add؛ ويعلّم migrate.Found العناصر المفقودة باستدعاءات lstat وقائمة خوادم MCP.

تسجيلات الدخول إلى MCP

خوادم MCP التي تسجّل الدخول عبر OAuth تحتفظ برموزها في ملف تسجيل الدخول، .credentials.json تحت mcpOAuth، لا في قائمة الخوادم. يجعل Claude Code مفتاح كل مدخل <name>| متبوعًا بأول 16 حرفًا من تجزئة sha256 للقيم type وurl وheaders الخاصة بالخادم. ولا يعتمد المفتاح على المجلد، لذلك يعمل المدخل المنسوخ في حساب آخر ما دام تعريف الخادم مطابقًا. لهذا لا ينسخ buildLogins في internal/migrate/logins.go إلا مدخلات الخوادم التي ينتهي بها الأمر في المجموعة بتعريف المصدر: الجديدة، أو المطابقة بالفعل، أو التعارض الذي اخترت فيه use mine. وتسجيلات الدخول لخوادم الإضافات (المفاتيح التي تبدأ بـ plugin:) تُنسخ معها عندما تنسخ الإضافات ويحتوي المصدر على plugins/.

تذهب المدخلات إلى ملف .credentials.json الخاص بكل حساب مستقبِل، وتُكتب باستخدام fsutil.AtomicWrite بالوضع 0600. ولا تذهب إلى المجموعة أبدًا. ولا يتلقاها الحساب إلا إذا كان يشارك mcp (أو extensions بالنسبة إلى خوادم الإضافات) عبر المجموعة المستهدفة، ولا تُضاف إلا المفاتيح التي لا يملكها: فالمدخلات الموجودة لديه، وربما الأحدث، يُحتفظ بها. يسرد سطر الخطة sign-ins الخوادم والحسابات المستقبِلة والحسابات المتخطاة. ويتخطى ccam الحساب، ويذكر اسمه مع السبب، عندما يكون:

• مسجلًا في مكانه باستخدام ccam import، لأن claude العادي قد يستخدم ملف تسجيل الدخول الخاص به؛
• قيد التشغيل، لأن Claude Code يعيد كتابة ملف تسجيل الدخول الخاص به (يُفحص مرة أخرى قبل الكتابة مباشرة، ويُبلَّغ عنه بـ started meanwhile)؛
• لم يسجّل الدخول بعد؛
• يحتفظ بتسجيل دخوله في سلسلة المفاتيح على macOS، التي لا يكتب فيها ccam.

سجّل الدخول إلى الخوادم في الحساب المتخطى باستخدام /mcp. والحساب الذي يبدأ مشاركة خوادم MCP لاحقًا يحصل على تسجيلات الدخول عندما تشغّل ccam migrate مرة أخرى؛ ويذكر الملخص ذلك مع Then run `ccam migrate` again to give them the MCP sign-ins too.

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

• يُقرأ المصدر فقط. لا يُنقل أي ملف فيه ولا يُربط ولا يُغيَّر، ولا يُكتب تسجيل الدخول في المصدر أبدًا، بما في ذلك على macOS حيث قد يُقرأ من سلسلة المفاتيح.
• قبل استبدال ملف في المجموعة، سواء بـ use mine أو بدمج أو بخوادم MCP جديدة في ملف mcp.json موجود، تُحفظ نسخة المجموعة في <group>/.ccam-backup/<time>/. واسم المجلد فريد لكل تشغيل، فلا يكتب تشغيلان في الثانية نفسها فوق النسخ الاحتياطية لبعضهما. ويطبع الملخص المسار.
• مع --yes، يحتفظ كل تعارض بنسخة المجموعة، ويخبرك ccam كيف تختار بدلًا من ذلك: شغّل الأمر نفسه دون --yes.
• إذا لم يكن هناك ما سيتغيّر، يطبع ccam الرسالة Nothing to copy.؛ وإذا احتفظ كل تعارض بنسخة المجموعة، يطبع Nothing to copy: the group keeps its own copies.
• إذا فشل النسخ في منتصف الطريق، يتوقف ccam مع The source folder was not changed. Group files replaced so far are saved in متبوعًا بمجلد النسخ الاحتياطية.
• ينتهي المصدر المفقود بالرسالة no Claude Code folder at <path>. Give the folder to copy from: ccam migrate <folder>.

صفحات ذات صلة

• مشاركة خوادم MCP والإعدادات والسجل
• الفحص والإصلاح
• عدة حسابات Claude Code
• CLAUDE_CONFIG_DIR