# 指令參考

> 所有 ccam 指令和選項，從 ccam add、ccam <name> 到 ccam usage、ccam next 和 ccam doctor。

Source: https://ccam.dev/zh-hant/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`，例如 `ccam -p "summarise"`，會使用預設帳號。用 `ccam use <name>` 設定預設帳號。

`ccwork` 這類快捷指令也會以同樣的方式啟動對應的帳號：`ccwork --resume` 的效果和 `ccam work --resume` 相同。請參閱[快捷指令](https://ccam.dev/zh-hant/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 絕不會移動或複製登入資訊。

當 Claude Code 正以某個帳號執行時，`ccam rename`、`ccam remove` 和 `ccam share` 會拒絕變更該帳號。請先結束該工作階段。

`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
```

快捷指令是你自己命名的指令，用來以某個帳號啟動 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/zh-hant/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/zh-hant/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/zh-hant/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` 變數可以變更這些資料夾的位置。