共用 MCP 伺服器、設定和對話記錄

每個帳號都保有自己的登入資訊。其他所有內容都可以逐項共用：ccam 會將帳號的檔案或資料夾連結到共用的群組資料夾，因此在一個帳號中所做的變更，會出現在該群組的所有帳號中。

可以共用的項目

新帳號會共用對話記錄以外的所有項目。

登入檔案 .credentials.json 和 .claude.json 永遠不會共用。ccam 只連結固定清單中的路徑，而這兩個檔案不在清單上。

群組

on 代表 default 群組。你也可以指定名稱，讓只有部分帳號共用某個項目：

ccam share work --history team
ccam share side --history team

現在 work 和 side 彼此共用對話，但不與你的其他帳號共用。

開啟共用

當帳號開始共用某個項目時，ccam 會：

1. 印出一份計畫，列出它將移動、複製或連結的每個檔案，並在開始前徵求你的同意；
2. 如果群組仍是空的，就把帳號的檔案移到群組資料夾，否則只加入群組還沒有的檔案；
3. 遇到同一個檔案內容不同時，詢問要保留群組的版本、使用你的版本，還是合併 JSON；
4. 將你的原始檔案保留在帳號資料夾內的 .ccam-backup/<time>/ 中；
5. 以指向群組的連結取代原始檔案。

對話檔案以工作階段 ID 命名，因此多個帳號的對話記錄可以合併而不會衝突。

當 Claude Code 正以該帳號執行時，ccam 不會變更共用，因為工作階段會持續寫入正在移動的檔案。請先結束工作階段。

關閉共用

ccam share work --history off

連結會被移除，帳號會取得一份群組目前內容的副本。加上 --fresh 則改為從空白開始。群組會為其他帳號保留其內容。

複製現有的設定

如果你在使用 ccam 之前就用過 Claude Code，你的設定都在 ~/.claude 中。ccam migrate 會把它們複製到一個群組，讓共用這些項目的每個帳號都能使用：

ccam migrate

在終端機中，ccam 會先顯示項目的核取清單。除了對話記錄以外的項目都已勾選；按 Space 切換項目，按 Enter 查看計畫。資料夾中沒有內容的項目會標示為 not found。

它會複製：

• settings.json 和全域 CLAUDE.md；
• 擴充功能 agents/、commands/、skills/、plugins/、output-styles/ 和 rules/；
• 你的使用者 MCP 伺服器，也就是 ~/.claude.json 中的 mcpServers 項目，會複製到群組的 mcp.json；
• 所複製的 MCP 伺服器已儲存的登入（OAuth），會複製到每個帳號自己的登入檔案；
• 對話記錄（projects/ 和 history.jsonl），但只有在你加上 --history 時才會複製。

來源資料夾只會被讀取：其中的內容都不會被移動、連結或變更，直接執行 claude 也會和以前一樣運作。登入檔案 .credentials.json 和 .claude.json 絕不會被複製到群組。

使用 OAuth 登入的 MCP 伺服器會把權杖存放在登入資訊中，而不是伺服器清單中。為了讓你不必重新登入這些伺服器，ccam 會把這些登入複製到每個透過群組取得這些伺服器的帳號的登入檔案，除非該帳號已有自己的登入。它會略過正在執行、尚未登入、以 ccam import 就地註冊，或把登入資訊存放在 macOS 鑰匙圈中的帳號，並列出它們的名稱；請在這些帳號中用 /mcp 登入伺服器。之後才開始共用 MCP 伺服器的帳號，會在你再次執行 ccam migrate 時取得這些登入。

ccam 在複製任何內容之前，會先顯示計畫並詢問你：

$ ccam migrate
Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default):
  mcp         ~/.claude.json  new: context7, fs
  settings    settings.json   new: 80 B
  memory      CLAUDE.md       new: 31 B
  extensions  agents/         add 1 file the group lacks (17 B)
              commands/       add 1 file the group lacks (15 B)
              skills/         add 1 file the group lacks (32 B)
              not found, skipped: plugins/, output-styles/, rules/
  Conversation history (projects/, history.jsonl) is not included; add --history to copy it.
Copy these into group default? [y/N] y
✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, commands/, skills/
Accounts that share these through group default:
  mcp         personal
  settings    personal
  memory      personal
  extensions  personal

最後，ccam 會列出透過該群組共用每個項目的帳號。如果有帳號尚未共用，它會顯示為這些帳號開啟共用的 ccam share 指令。

如果群組中已有內容不同的檔案，ccam 會像開啟共用時一樣詢問你：保留群組中的副本，或使用你的副本。settings.json 等 JSON 檔案也可以合併，history.jsonl 則可以逐行合併。群組原本的副本會保存在群組資料夾內的 .ccam-backup/<time>/。

在指令前加上 --dry-run，例如 ccam --dry-run migrate，就能只查看計畫而不複製任何內容。若要從其他資料夾複製，請指定該資料夾：ccam migrate ~/.claude-work --group work。

MCP 伺服器

Claude Code 將 MCP 伺服器和登入資訊一起存放在 .claude.json 中，所以這個檔案無法共用。ccam 將共用的伺服器保存在群組的 mcp.json 中，並以 --mcp-config=<group>/mcp.json 啟動 Claude Code。你自己的 --mcp-config 選項仍會疊加套用。

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp list

你在工作階段中用 claude mcp add 新增的伺服器只會儲存在該帳號。下次啟動該帳號時，ccam 會列出這個伺服器的名稱，以及將它移到群組的指令：

ccam mcp import work gh

如果群組中已有同名的不同伺服器，ccam 會略過它並告訴你。--force 會取代群組的伺服器，並把舊的 mcp.json 保留在群組的 .ccam-backup/ 資料夾中。

使用 OAuth 登入的 MCP 伺服器會將權杖和帳號的登入資訊存放在一起，所以請在每個帳號中各授權一次，或用 ccam migrate 從 ~/.claude 複製這些登入。

如果你希望這些伺服器以一般使用者伺服器的形式出現在 claude mcp list 和 /mcp 中，請在 ~/.config/ccam/config.toml 中設定 mcp_strategy = "sync"。ccam 會在啟動前將它們寫入每個帳號的 .claude.json，過程中使用 Claude Code 自己的檔案鎖，並保留備份。

兩個帳號在同一個資料夾

共用對話記錄的帳號會寫入相同的檔案。如果你在某個資料夾中啟動第二個 Claude Code，而同一群組的另一個帳號已經在該資料夾中執行，ccam 會警告你並詢問是否繼續。

發生問題時

ccam doctor
ccam doctor --fix

如果某個共用路徑變成了一般檔案（例如你手動還原了備份），ccam 會在啟動 Claude Code 前停止，並提示你使用 ccam doctor --fix；這個指令會將該檔案合併到群組中，並保留備份。