# کمانڈز کا حوالہ

> ccam کی ہر کمانڈ اور آپشن، ccam add اور ccam <name> سے لے کر ccam usage، ccam next اور ccam doctor تک۔

Source: https://ccam.dev/ur/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/ur/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/ur/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/ur/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/ur/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` ویری ایبلز ان فولڈرز کی جگہ بدل دیتے ہیں۔