Referensi perintah

Letakkan --dry-run sebelum perintah untuk melihat apa yang akan dilakukannya tanpa benar-benar menjalankannya, misalnya ccam --dry-run work. Opsi ini berfungsi saat menjalankan Claude Code (ccam <name>, ccam run, ccam next) dan dengan share, migrate, shortcut, update, serta doctor --fix. Perintah lain yang mengubah sesuatu akan menolaknya alih-alih berjalan.

Menjalankan Claude Code

ccam <name|number> [arguments] menjalankan Claude Code sebagai akun tersebut. ccam tidak membaca argumen setelah nama akun; ccam meneruskannya ke claude dengan urutan yang sama, dan input standar, kode keluar, serta sinyal berperilaku persis seperti pada claude itu sendiri. -- setelah nama akun bersifat opsional.

ccam dengan argumen tetapi tanpa nama akun, seperti ccam -p "summarise", menggunakan akun default. Tetapkan akun default dengan ccam use <name>.

Pintasan seperti ccwork menjalankan akunnya dengan cara yang sama: ccwork --resume melakukan hal yang sama dengan ccam work --resume. Lihat pintasan.

Menambah dan menghapus akun

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 tanpa folder akan mencari ~/.claude dan ~/.claude-*, lalu menanyakan masing-masing. Folder yang diimpor didaftarkan di tempatnya; ccam tidak pernah memindahkan atau menyalin login.

ccam rename, ccam remove, dan ccam share menolak mengubah akun saat Claude Code sedang berjalan sebagai akun tersebut. Keluar dari sesi terlebih dahulu.

ccam list --json menampilkan setiap akun beserta slot, pintasan, email, dan foldernya. Objek share di dalamnya memetakan setiap item (mcp, settings, memory, extensions, history) ke nama grup atau local.

Pintasan

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

Pintasan adalah perintah yang namanya Anda pilih sendiri dan menjalankan Claude Code sebagai satu akun. Seperti ccam work, pintasan meneruskan semua argumen ke Claude Code tanpa diubah, sehingga ccwork --resume dan ccwork -p "hi" bekerja seperti yang Anda harapkan. Pintasan adalah tautan ke ccam di ~/.local/bin.

Pintasan bersifat opsional. Wizard ccam add menanyakan apakah perlu membuatnya, ccam add <name> --shortcut <command> membuatnya tanpa bertanya, dan ccam list menampilkan pintasan setiap akun, atau - jika akun tidak punya pintasan.

Nama memakai karakter a-z, 0-9, ., -, dan _. Nama tidak boleh berupa perintah ccam, pintasan akun lain, atau nama program lain di PATH Anda.

ccam rename mempertahankan nama pintasan, dan ccam remove menghapus pintasan bersama akunnya. ccam shims install membuat ulang tautan semua akun, misalnya setelah Anda memindahkan ccam.

Pembagian

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

Setiap item menerima on (grup default), off, atau nama grup. Lihat pembagian.

Menyalin penyiapan yang sudah ada

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 menyalin settings.json, CLAUDE.md, ekstensi, dan server MCP pengguna dari folder Claude Code ke sebuah grup, sehingga setiap akun yang membagikan item tersebut mendapatkannya. Folder itu hanya dibaca. Opsi --settings, --memory, --extensions, --mcp, dan --history hanya menyalin item yang Anda sebutkan. Tanpa opsi itu, di terminal sebuah daftar centang memungkinkan Anda memilih, dengan semua item kecuali riwayat percakapan sudah dicentang; di luar terminal, semuanya disalin kecuali riwayat percakapan. -g atau --group memilih grup, dan -y atau --yes menyalin tanpa bertanya serta mempertahankan salinan grup jika ada file yang berbeda. ccam juga menyalin info masuk server yang tersimpan ke file login milik setiap akun. Lihat menyalin penyiapan yang sudah ada.

Server 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> memindahkan server yang hanya dimiliki akun itu ke grupnya. Server yang namanya sudah dipakai grup untuk definisi yang berbeda akan dilewati; tambahkan --force untuk mengganti salinan milik grup, yang dicadangkan ccam terlebih dahulu.

Penggunaan dan perpindahan akun

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

Pemeliharaan

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 memeriksa checksum SHA-256 rilis sebelum mengganti ccam, dan --version v0.2.0 menginstal rilis tertentu. ccam yang diinstal dari paket .deb diperbarui dengan apt. Lihat pembaruan.

File

Variabel XDG_CONFIG_HOME, XDG_DATA_HOME, dan XDG_STATE_HOME memindahkan folder-folder ini.