コマンドリファレンス

コマンドの前に--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 -p "summarise"のように、引数はあってもアカウント名がないccamは、デフォルトのアカウントを使います。デフォルトのアカウントは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

ショートカットは、1つのアカウントでClaude Codeを起動する、自分で名前を付けたコマンドです。ccam workと同じように、すべての引数をそのままClaude Codeに渡すので、ccwork --resumeやccwork -p "hi"も期待どおりに動作します。実体は~/.local/binにあるccamへのリンクです。

ショートカットは任意です。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は、Claude Codeのフォルダーからsettings.json、CLAUDE.md、拡張機能、ユーザーのMCPサーバーをグループにコピーし、それらの項目を共有するすべてのアカウントで使えるようにします。フォルダーは読み取るだけです。--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は、ccamを置き換える前にリリースのSHA-256チェックサムを検証します。--version v0.2.0を指定すると、特定のリリースをインストールします。.debパッケージからインストールしたccamは、代わりにaptで更新します。詳しくはアップデートを参照してください。

ファイル

XDG_CONFIG_HOME、XDG_DATA_HOME、XDG_STATE_HOMEの各変数を設定すると、これらのフォルダーの場所が変わります。