# コマンドリファレンス

> ccam addやccam <name>から、ccam usage、ccam next、ccam doctorまで、ccamのすべてのコマンドとオプションを説明します。

Source: https://ccam.dev/ja/docs/commands/ · Updated 2026-10-19

コマンドの前に`--dry-run`を付けると、実際には実行せずに何をするかを確認できます。たとえば`ccam --dry-run work`のように使います。これが使えるのは、Claude Codeを起動するとき（`ccam <name>`、`ccam run`、`ccam next`）と、`share`、`migrate`、`shortcut`、`update`、`doctor --fix`です。何かを変更するそれ以外のコマンドは、実行せずにこのオプションを拒否します。

| コマンド | 説明 |
| --- | --- |
| `ccam` | アカウント選択画面を開く |
| `ccam <name|number> [claude arguments]` | そのアカウントでClaude Codeを起動する。引数はそのまま渡される |
| `ccam add [name]` | アカウントを追加する（設定フォルダー、ログイン、任意のショートカット） |
| `ccam completion bash|zsh` | bashまたはzshの補完スクリプトを出力する |
| `ccam doctor` | リンク、権限、ログイン、バージョンを確認して修復する |
| `ccam import [folder]` | 既存の~/.claudeフォルダーをその場所のまま登録する |
| `ccam list` | アカウントを一覧表示する |
| `ccam login <name|number>` | アカウントに再度ログインする |
| `ccam logout <name|number>` | アカウントのログインを削除する |
| `ccam mcp [command]` | 共有MCPサーバーを管理する |
| `ccam migrate [folder]` | 既存のClaude Codeの環境（~/.claude）を共有グループにコピーする |
| `ccam next [--auto] [--continue] [-- claude args]` | 次のアカウントを開く。--continueは会話を引き継ぎ、--autoは最も余裕があるアカウントを選ぶ |
| `ccam remove <name|number>` | アカウントを削除する。フォルダーはゴミ箱フォルダーに移動する |
| `ccam rename <name> <new-name>` | アカウントの名前を変更する（ショートカットの名前はそのまま） |
| `ccam share <name|number> [--mcp on|off|<group>] [--history …]` | 計画を表示したうえで、アカウントが共有する項目を変更する |
| `ccam shims [command]` | すべてのアカウントのショートカットのリンクを作り直す |
| `ccam shortcut <name|number> [command]` | アカウントのショートカットコマンド（ccworkなど）を表示、作成、名前変更、削除する |
| `ccam statusline` | Claude Codeのステータスラインにアカウントと使用量を表示する |
| `ccam update` | チェックサムを確認したうえで、ccamを最新のリリースに更新する |
| `ccam usage` | すべてのアカウントの5時間と週間の使用量を表示する |
| `ccam use <name|number>` | デフォルトのアカウントを設定する |

## Claude Codeの起動

`ccam <name|number> [arguments]`は、そのアカウントでClaude Codeを起動します。ccamは名前より後の引数を読まず、同じ順序で`claude`に渡します。標準入力、終了コード、シグナルも`claude`そのものとまったく同じように動作します。名前の後の`--`は省略できます。

`ccam -p "summarise"`のように、引数はあってもアカウント名がない`ccam`は、デフォルトのアカウントを使います。デフォルトのアカウントは`ccam use <name>`で設定します。

`ccwork`のようなショートカットも、同じようにそのアカウントを起動します。`ccwork --resume`は`ccam work --resume`と同じ動作です。詳しくは[ショートカット](https://ccam.dev/ja/docs/commands.md#shortcuts)を参照してください。

## アカウントの追加と削除

```sh
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`に対応付けます。

## ショートカット

```sh
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を移動した後などに、すべてのアカウントのリンクを作り直します。

## 共有

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

各項目には、`on`（`default`グループ）、`off`、またはグループ名を指定します。詳しくは[共有](https://ccam.dev/ja/docs/sharing.md)を参照してください。

## 既存の環境のコピー

```sh
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`を付けると確認なしでコピーし、内容が異なるファイルはグループのものを残します。また、サーバーの保存済みのサインイン情報を各アカウント自身のログインファイルにコピーします。詳しくは[既存の環境をコピーする](https://ccam.dev/ja/docs/sharing.md#copy-an-existing-setup)を参照してください。

## MCPサーバー

```sh
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は先にバックアップを取ります。

## 使用量と切り替え

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

## メンテナンス

```sh
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で更新します。詳しくは[アップデート](https://ccam.dev/ja/docs/install.md#update)を参照してください。

## ファイル

| パス | 内容 |
| --- | --- |
| `~/.config/ccam/config.toml` | アカウントと、それぞれが共有する項目 |
| `~/.local/share/ccam/profiles/<name>/` | 各アカウントの`CLAUDE_CONFIG_DIR` |
| `~/.local/share/ccam/groups/<group>/` | 共有される設定、MCPサーバー、拡張機能、履歴 |
| `~/.local/state/ccam/` | 使用量のキャッシュと最終使用日時 |
| `~/.local/bin/<shortcut>` | `ccwork`のようなショートカットコマンド（ccamへのリンク） |

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