# Sanggunian ng mga command

> Bawat command at option ng ccam, mula sa ccam add at ccam <name> hanggang ccam usage, ccam next at ccam doctor.

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

Ilagay ang `--dry-run` bago ang isang command para makita kung ano ang gagawin nito nang hindi ito talagang ginagawa, halimbawa `ccam --dry-run work`. Gumagana ito kapag sinisimulan ang Claude Code (`ccam <name>`, `ccam run`, `ccam next`) at sa `share`, `migrate`, `shortcut`, `update` at `doctor --fix`. Tinatanggihan ito ng ibang command na may binabago sa halip na tumakbo.

| Utos | Ano ang ginagawa nito |
| --- | --- |
| `ccam` | Buksan ang pagpili ng account |
| `ccam <name|number> [claude arguments]` | Simulan ang Claude Code bilang account na iyon; ipinapasa nang walang pagbabago ang mga argument |
| `ccam add [name]` | Magdagdag ng account: config folder, login at opsyonal na shortcut |
| `ccam completion bash|zsh` | I-print ang bash o zsh completion |
| `ccam doctor` | Suriin ang mga link, permission, login at bersyon, at mag-ayos |
| `ccam import [folder]` | Irehistro ang umiiral na ~/.claude folder kung nasaan ito |
| `ccam list` | Ilista ang mga account |
| `ccam login <name|number>` | Mag-log in muli sa isang account |
| `ccam logout <name|number>` | Alisin ang login ng isang account |
| `ccam mcp [command]` | Pamahalaan ang mga shared na MCP server |
| `ccam migrate [folder]` | Kopyahin ang dati nang Claude Code setup (~/.claude) sa isang shared na group |
| `ccam next [--auto] [--continue] [-- claude args]` | Buksan ang susunod na account; pinapanatili ng --continue ang usapan, pinipili ng --auto ang may pinakamaraming natitira |
| `ccam remove <name|number>` | Mag-alis ng account; mapupunta ang folder nito sa trash folder |
| `ccam rename <name> <new-name>` | Palitan ang pangalan ng account; hindi nagbabago ang pangalan ng shortcut nito |
| `ccam share <name|number> [--mcp on|off|<group>] [--history …]` | Baguhin kung ano ang ishe-share ng account, pagkatapos ipakita ang plano |
| `ccam shims [command]` | Gawin muli ang mga shortcut link ng lahat ng account |
| `ccam shortcut <name|number> [command]` | Ipakita, gawin, palitan ang pangalan o alisin ang shortcut command ng isang account, gaya ng ccwork |
| `ccam statusline` | Ipakita ang account at usage sa status line ng Claude Code |
| `ccam update` | I-update ang ccam sa pinakabagong release matapos suriin ang checksum nito |
| `ccam usage` | Ipakita ang 5-oras at lingguhang usage ng bawat account |
| `ccam use <name|number>` | Itakda ang default na account |

## Pagsisimula ng Claude Code

Sinisimulan ng `ccam <name|number> [arguments]` ang Claude Code bilang account na iyon. Hindi binabasa ng ccam ang mga argument na kasunod ng pangalan; ipinapasa nito ang mga iyon sa `claude` sa parehong pagkakasunod-sunod, at kumikilos ang standard input, exit code at mga signal nang eksaktong gaya ng sa `claude` mismo. Opsyonal ang `--` pagkatapos ng pangalan.

Ang `ccam` na may mga argument pero walang pangalan ng account, gaya ng `ccam -p "summarise"`, ay gumagamit ng default na account. Itakda ito gamit ang `ccam use <name>`.

Sa parehong paraan sinisimulan ng isang shortcut gaya ng `ccwork` ang account nito: ginagawa ng `ccwork --resume` ang ginagawa ng `ccam work --resume`. Tingnan ang [mga shortcut](https://ccam.dev/fil/docs/commands.md#shortcuts).

## Pagdagdag at pag-alis ng mga account

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

Kapag walang folder, hinahanap ng `ccam import` ang `~/.claude` at `~/.claude-*` at nagtatanong tungkol sa bawat isa. Nirerehistro ang mga in-import na folder kung nasaan sila; hindi kailanman naglilipat o kumokopya ng login ang ccam.

Tumatanggi ang `ccam rename`, `ccam remove` at `ccam share` na baguhin ang isang account habang tumatakbo ang Claude Code bilang account na iyon. Isara muna ang session.

Ipinapakita ng `ccam list --json` ang bawat account kasama ang slot, shortcut, email at folder nito. Ang `share` object nito ay nagtutugma sa bawat item (`mcp`, `settings`, `memory`, `extensions`, `history`) sa pangalan ng group o sa `local`.

## Mga shortcut

```sh
ccam shortcut work ccwork     # create it, or rename the existing one
ccam shortcut work            # show it
ccam shortcut work --remove
```

Ang shortcut ay isang command na ikaw mismo ang nagpangalan at nagsisimula ng Claude Code bilang isang account. Gaya ng `ccam work`, ipinapasa nito nang walang pagbabago sa Claude Code ang bawat argument, kaya gumagana ang `ccwork --resume` at `ccwork -p "hi"` gaya ng inaasahan mo. Isa itong link sa ccam sa `~/.local/bin`.

Opsyonal ang mga shortcut. Nagtatanong ang wizard ng `ccam add` kung gagawa ng isa, gumagawa ng isa ang `ccam add <name> --shortcut <command>` nang hindi nagtatanong, at ipinapakita ng `ccam list` ang shortcut ng bawat account, o `-` kapag wala.

Puwedeng gamitin sa mga pangalan ang mga character na a-z, 0-9, `.`, `-` at `_`. Hindi puwedeng maging ccam command ang pangalan, shortcut ng ibang account, o pangalan ng ibang program sa iyong `PATH`.

Pinapanatili ng `ccam rename` ang pangalan ng shortcut, at binubura ng `ccam remove` ang shortcut kasama ng account. Ginagawa muli ng `ccam shims install` ang mga link ng lahat ng account, halimbawa pagkatapos mong ilipat ang ccam.

## Sharing

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

Tumatanggap ang bawat item ng `on` (ang `default` group), `off`, o pangalan ng group. Tingnan ang [sharing](https://ccam.dev/fil/docs/sharing.md).

## Pagkopya ng dati nang setup

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

Kinokopya ng `ccam migrate` ang `settings.json`, `CLAUDE.md`, mga extension at user MCP server mula sa isang Claude Code folder papunta sa isang group, kaya makukuha ang mga ito ng bawat account na nagshe-share ng mga item na iyon. Binabasa lang ang folder. Kinokopya lang ng mga option na `--settings`, `--memory`, `--extensions`, `--mcp` at `--history` ang mga item na pinangalanan mo. Kung wala ang mga ito, sa terminal ay may checklist para makapili ka, na naka-check ang lahat maliban sa kasaysayan ng usapan; sa ibang lugar, kinokopya ang lahat maliban sa kasaysayan ng usapan. Pinipili ng `-g` o `--group` ang group, at kumokopya ang `-y` o `--yes` nang hindi nagtatanong at pinapanatili ang kopya ng group kapag magkaiba ang isang file. Kinokopya rin nito ang mga naka-save na sign-in ng mga server sa sariling login file ng bawat account. Tingnan ang [pagkopya ng dati nang setup](https://ccam.dev/fil/docs/sharing.md#copy-an-existing-setup).

## Mga MCP server

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

Inililipat ng `ccam mcp import <account>` sa group nito ang mga server na ang account na iyon lang ang mayroon. Nilalaktawan ang server na ang pangalan ay ginagamit na ng group para sa ibang definition; idagdag ang `--force` para palitan ang kopya ng group, na bina-back up muna ng ccam.

## Usage at paglipat

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

## Maintenance

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

Sinusuri ng `ccam update` ang SHA-256 checksum ng release bago nito palitan ang ccam, at nag-i-install ang `--version v0.2.0` ng partikular na release. Ang ccam na in-install mula sa `.deb` package ay ina-update na lang gamit ang apt. Tingnan ang [pag-update](https://ccam.dev/fil/docs/install.md#update).

## Mga file

| Path | Nilalaman |
| --- | --- |
| `~/.config/ccam/config.toml` | Mga account at kung ano ang shine-share nila |
| `~/.local/share/ccam/profiles/<name>/` | Ang `CLAUDE_CONFIG_DIR` ng bawat account |
| `~/.local/share/ccam/groups/<group>/` | Mga shared na setting, MCP server, extension at kasaysayan |
| `~/.local/state/ccam/` | Usage cache at mga oras ng huling paggamit |
| `~/.local/bin/<shortcut>` | Mga shortcut command gaya ng `ccwork`, mga link sa ccam |

Inililipat ng mga variable na `XDG_CONFIG_HOME`, `XDG_DATA_HOME` at `XDG_STATE_HOME` ang mga folder na ito.
