アカウント間の共有

各アカウントは独自のフォルダーを持ちますが、その中身の多くは分けておく必要がありません。ccam shareは、1つのアカウントの1つの項目ごとに共有を有効または無効にします。アカウントのファイルやフォルダーはグループのフォルダーに移動し、シンボリックリンクに置き換えられるので、グループのすべてのアカウントが同じコピーを読み書きします。ccam addの後にアカウントが共有するものを変更したり、いくつかのアカウントだけで独自のグループを作ったりするときに使います。

使い方

ccam share work                       # show what work shares, and with which group
ccam share work --history on          # share conversation history with the default group
ccam share side --history team        # share it with the group team instead
ccam share work --settings off        # give work its own copy of settings.json again
ccam share work --memory off --fresh  # stop sharing CLAUDE.md and start with no file
ccam share work --settings on --yes --prefer merge   # no questions; merge JSON on conflicts
ccam --dry-run share work --history on               # print the plan, change nothing

項目のオプションを付けない場合、ccam shareは現在の状態を表示します。

$ ccam share work
Sharing for work
  MCP servers                        shared (group default)  --mcp
  settings.json                      shared (group default)  --settings
  global CLAUDE.md                   shared (group default)  --memory
  agents, commands, skills, plugins  shared (group default)  --extensions
  conversation history               local                   --history

オプションを付けると、ccamは計画を表示し、グループのコピーと内容が異なるファイルごとに確認し、何かを変更する前にProceed? [y/N]と尋ねます。新しいアカウントは会話履歴以外のすべてを共有します。各項目をユーザーの視点から説明したものは、MCPサーバー、設定、履歴の共有を参照してください。

オプション

値のonはdefaultグループ、offはローカル（共有しない）を意味し、それ以外の値はグループ名です。グループ名は~/.local/share/ccam/groups/の下のフォルダー名になるため、ccam share side --history ../xはinvalid group name: "../x"で失敗します。アカウントは名前か番号で指定し、変更されるのは指定した項目だけです。

しくみ

関係するファイルは次のとおりです。

• ~/.config/ccam/config.toml: 各アカウントの[profile.share]テーブルで、項目ごとに1つの値を持ちます。
• ~/.local/share/ccam/profiles/<name>/: アカウントのCLAUDE_CONFIG_DIRです。
• ~/.local/share/ccam/groups/<group>/: 共有されるコピーです。

1. internal/cli/share.goが設定を読み込み、config.Share.Setで各--<item>の値をアカウントの設定のコピーに適用します。アカウントが実行中の場合は拒否します。
2. share.Buildが現在の設定と目標の設定を比較し、手順を列挙します。ディスクは読み取るだけで、share.Layoutのすべてのパスについてos.Lstatとos.Readlinkを使います。計画は操作の一覧です。グループの空の場所への移動（adopt）、グループにないファイルの移動（merge dir）、解決した競合のグループへの書き込み、バックアップ、リンクの削除、リンクの作成、コピーの戻し、プラグインのパスの書き換え、プラグインのレジストリのマージがあります。
3. 確認か--preferで、競合を決めます。
4. Plan.Describeが計画を表示し、ccamが確認を求めます。
5. 何かを移動する前に、目標の設定をconfig.tomlに書き込みます。Plan.Applyが途中で止まった場合、ccam doctor --fixや再実行は、保存された目標に向けて計画を立て、変更を完了します。
6. Plan.Applyが手順を順に実行します。どの手順もデータをグループかバックアップフォルダーに移動するだけで、何も削除しません。

share.Layoutは、各項目が対象とするパスの許可リストです。ここにないものがグループに入ることはありません。share.Neverは.credentials.jsonと.claude.jsonを指定しており、どちらかがレイアウトに現れた場合、Buildは内部エラーで停止します。mcp項目にはパスがありません。サーバーの一覧は.claude.jsonの中にあるため、MCPの共有は代わりにグループのmcp.jsonを通じて行われ、--mcpは設定を変更するだけです。

次の図は、sideが履歴の共有を有効にし、グループにすでに内容がある場合に、1つのフォルダーprojects/がどうなるかを示しています。

グループのそのパスにまだ何もない場合、そのアカウントが最初の共有者となり、フォルダーはバックアップなしでそのままグループに移動します。そうでない場合は、mergeDirがグループにない各ファイルをグループに移動し、両方にあるファイルはアカウントのフォルダーに残すので、グループのバージョンが保たれます。その後、アカウントのフォルダーはアカウントのフォルダー内の.ccam-backup/<time>/に移動し、os.Symlinkがその場所にリンクを置きます。会話ファイルの名前はセッションIDに基づいているため、複数のアカウントの履歴を競合なく結合できます。

移動にはrename(2)を使い、ファイルシステムをまたぐ場合はコピーと削除にフォールバックします。移動したツリーの中にあり、ツリーの外を指していた相対リンクは絶対リンクに書き換えられるので（fsutil.PortableLink）、新しい場所からも解決できます。plugins/のレジストリ（installed_plugins.json、known_marketplaces.json）は、アカウントのフォルダーを経由する絶対パスを保存しています。ccamはそれらをグループのフォルダーを指すように変更し、グループにすでにレジストリがある場合は、アカウントの項目をそこにマージします。

項目の共有を無効にすると、リンクが逆の処理で戻されます。

ccamは、リンクがgroupsフォルダーの中を指している場合だけリンクを削除し、CopyTreeでグループの現在の内容をアカウントにコピーします。--freshを付けるとコピーをスキップし、アカウントはそのパスに何もない状態から始めます。グループの内容は、ほかのアカウントのためにそのまま残ります。項目をあるグループから別のグループに移すと、リンクを削除して新しいグループにリンクし、古いグループはそのまま残します。計画にはその旨がNote:の行で示されます。

両方にあり内容が異なる1つのファイルは、競合になります。

share.NewConflictは、そのファイルに合った選択肢を列挙します。history.jsonlでは、merge by line、keep group、use mineの順で、マージが先頭です。それ以外の.jsonファイルではkeep group、use mine、merge JSONです。それ以外のファイルではkeep groupとuse mineです。最初の選択肢がデフォルトです。

history.jsonl differs from the group's copy.
  mine:  ~/.local/share/ccam/profiles/side/history.jsonl
  group: ~/.local/share/ccam/groups/default/history.jsonl
  1) merge by line
  2) keep group
  3) use mine
Choice [1]:

merge JSON（MergeJSONBytes）は、オブジェクトを再帰的にマージし、配列を重複なしで結合します。両方が同じキーに異なる値を設定している場合はグループの値を残すので、ほかのアカウントの動作は変わりません。merge by lineはグループの行を残し、そこにない自分の行を追加します。keep group以外のすべての選択肢では、まずグループのコピーをアカウントのフォルダー内の.ccam-backup/<time>/group/に保存し、それから結果をfsutil.AtomicWriteで書き込みます。自分のファイルは常にバックアップに移動します。

--prefer group、mine、mergeを指定すると、確認なしですべての競合を決めます。mergeは、そのファイルが提供するほうのmerge JSONかmerge by lineを意味し、どちらも提供しないファイルはデフォルトのままです。--yesだけを付けた場合は、各ファイルのデフォルトを使います。

起動のたびに、share.Checkがレイアウトの各パスを設定と比較します。使うのはlstatとreadlinkだけなので、起動経路でも十分に軽い処理です。足りないリンクは、失うものがないのでその場で作成します。リンクがあるべき場所に通常のファイルがある場合、リンクが間違った場所を指している場合、古いリンクが残っている場合は、起動を停止します。

ccam: stopped because of share link problems:
  ~/.local/share/ccam/profiles/work/CLAUDE.md: set to shared but is a real file, not a link
Repair them with `ccam doctor --fix`, then run again

ccam doctor --fixは、保存された設定を現在と目標の両方に指定してshare.Buildを実行します。これはディスク上の状態からすべての手順を導き、競合ではグループの内容を残し、置き換えるものはすべてバックアップします。

安全性と特殊なケース

• 実行中のアカウント。 アカウントとしてClaude Codeが実行中の間は、ccamは共有の変更を拒否します（account work is running; quit it first, then change its sharing）。セッションが移動するファイルに書き込み続け、その間に追加された行が失われてしまうためです。--dry-runでは計画が表示されます。
• バックアップ。 計画ごとに、アカウントのフォルダー内に専用の.ccam-backup/<time>/フォルダーが作られます。同じ秒に2つの計画が始まった場合は、番号の接尾辞が付きます。ccamがこれらを削除することはありません。
• 途中での失敗。 手順が失敗した場合、ccamはエラーと元のファイルの場所を表示し、ccam doctor --fixで完了するよう案内します。目標はすでに保存されているので、修復はそこに向けて続きます。
• 自分で作ったリンク。 パスがすでに自分で作ったリンク（たとえばdotfilesのリポジトリへのリンク）で、グループが空の場合、ccamはリンク先の内容をグループにコピーし、リンク自体をバックアップに移動します。リンク先には触れません。
• ログインファイル。 .credentials.jsonと.claude.jsonが、グループにリンク、移動、コピーされることはありません。
• 同じフォルダーで2つのアカウントを使う場合。 履歴を共有するアカウントは同じファイルに書き込みます。同じ履歴グループのアカウントがすでに実行中のフォルダーで2つ目のアカウントを起動すると、ccamは警告を表示し、続行する前に確認を求めます。

関連項目

• MCPサーバー、設定、履歴の共有
• 共有MCPサーバー
• 既存の環境のコピー
• すべてのコマンド