# शॉर्टकट कमांड्स

> ccam shortcut ने खात्याला ccwork सारखी स्वतःची कमांड द्या, आणि ccam shims install ने ~/.local/bin मधील लिंक्स पुन्हा तयार करा.

Source: https://ccam.dev/mr/features/shortcuts/ · Updated 2026-10-19

शॉर्टकट ही तुम्ही स्वतः नाव दिलेली कमांड आहे, जी Claude Code एका खात्याने सुरू करते: `ccwork --resume` तेच करते जे `ccam work --resume` करते. ती `~/.local/bin` मधील ccam ची लिंक आहे, त्यामुळे ती bash, zsh, scripts आणि `PATH` वरून प्रोग्राम चालवणाऱ्या इतर सर्व गोष्टींमध्ये चालते. शॉर्टकट ऐच्छिक आहेत; तुम्ही वारंवार सुरू करता त्या खात्यांसाठी एक तयार करा.

## वापर

```sh
ccam shortcut work ccwork     # create the shortcut ccwork for work
ccam shortcut 2 ccside        # the account with number 2
ccam shortcut work            # show it
ccam shortcut work ccw        # rename it; the old link is removed
ccam shortcut work --remove   # delete it
ccam add side --shortcut ccside
ccam shims install            # recreate missing links of all accounts
ccwork -p "summarise" --output-format json
```

ccam प्रत्येक बदलाची खात्री देते:

```console
$ ccam shortcut work ccwork
✓ shortcut for work: ccwork
$ ccam shortcut work ccw
✓ shortcut for work: ccw (was ccwork)
$ ccam shortcut work --remove
✓ ccw removed; work has no shortcut now
$ ccam shortcut work
work: none (add one with `ccam shortcut work ccwork`)
```

एका खात्याला जास्तीत जास्त एक शॉर्टकट असतो, जो `~/.config/ccam/config.toml` मध्ये `shortcut` म्हणून साठवला जातो. `ccam add` विझार्ड `Create a shortcut command for <name>? [y/N]` आणि मग `Shortcut name [cc<name>]:` विचारतो. विझार्डबाहेर, `ccam add` फक्त `--shortcut` सह शॉर्टकट तयार करते. `ccam list` प्रत्येक खात्याचा शॉर्टकट दाखवते, किंवा `-`.

शॉर्टकट प्रत्येक आर्ग्युमेंट Claude Code ला देतो, जसे `ccam <name>` नावानंतर करते. यात `--dry-run` आणि `--help` सुद्धा येतात: सुरू करण्याचे पूर्वावलोकन करण्यासाठी `ccam --dry-run work` वापरा.

## पर्याय

| पर्याय | काय करतो | डीफॉल्ट |
| --- | --- | --- |
| `--remove` | खात्याचा शॉर्टकट आणि त्याची लिंक हटवा | बंद |
| `-h`, `--help` | कमांडची मदत | |
| `--dry-run` | `ccam shortcut` तो पाळते: ते नाव तपासते आणि सेव्ह किंवा लिंक न करता `Would set the shortcut of work to ccwork.` किंवा `Would remove ccwork, the shortcut of work.` छापते | बंद |

`ccam shims install` कोणतेही आर्ग्युमेंट घेत नाही आणि `--dry-run` `` ccam: --dry-run is not supported by `ccam shims install`; nothing was changed `` देऊन नाकारते.

नावांचे नियम, या क्रमाने तपासले जातात:

- `a-z`, `0-9`, `.`, `-` आणि `_` यांपासून बनलेली 1 ते 64 अक्षरे, अक्षराने किंवा अंकाने सुरू होणारी;
- `ccam`, `claude` किंवा `run` किंवा `usage` सारखी ccam कमांड नाही;
- दुसऱ्या खात्याचा शॉर्टकट नाही;
- `~/.local/bin` मधील अशी फाइल नाही जी आधीच ccam ची लिंक नाही;
- तुमच्या `PATH` वरील दुसऱ्या executable चे नाव नाही.

कमांड आणि `--remove` एकत्र दिल्यास `give a command or --remove, not both` ने थांबते. खात्याकडे आधीच असलेले नाव सेट केल्यास `work: ccwork (unchanged)` छापले जाते आणि लिंक नसल्यास ती पुन्हा तयार होते.

## हे कसे काम करते

नाव सेट केल्यावर `checkShortcut` चालते, जे bin फोल्डर आणि ccam binary चा खरा पाथ देऊन `shim.Check` बोलावते:

नाव तपासण्यांमधून क्रमाने खाली जाते. प्रत्येक तपासणीशेजारी ती नाकारत असलेले एक नाव आहे: `Work` pattern मध्ये बसत नाही, `run` ही ccam कमांड आहे, `ccside` दुसऱ्या खात्याचे आहे, `ccfile` ही `~/.local/bin` मधील आधीपासून असलेली फाइल आहे, आणि `git` `/usr/bin/git` लपवेल. प्रत्येक तपासणी पार करणारे नावच सेव्ह आणि लिंक होते.

1. `shim.Check` नाव `^[a-z0-9][a-z0-9._-]{0,63}$` शी, मग `config.Reserved` शी, मग `cfg.FindShortcut` शी जुळवते. ते `~/.local/bin/<name>` वर `os.Lstat` बोलावते, आणि `PATH` वरील इतर प्रत्येक फोल्डरसाठी `os.Stat` बोलावून ccam ची लिंक नसलेली executable फाइल नाकारते.
2. ccam `config.toml` `fsutil.AtomicWrite` ने सेव्ह करते (तात्पुरती फाइल, `fsync`, rename).
3. `shim.Remove` जुन्या शॉर्टकटची लिंक हटवते, पण ती ccam ची लिंक असेल तरच.
4. `shim.Install` config मधील प्रत्येक शॉर्टकटची नसलेली लिंक `os.Symlink` ने ccam binary कडे तयार करते, जी `os.Executable` आणि `filepath.EvalSymlinks` ने शोधली जाते. ते कधीच काहीही काढत नाही.

`os.Readlink` ccam चा पाथ परत देते तेव्हा, किंवा लिंक आणि ccam चा पाथ एकाच फाइलकडे जातात तेव्हा, ती लिंक ccam ची स्वतःची मानली जाते. प्रत्येक remove आणि प्रत्येक overwrite तपासणी या चाचणीतून जाते, त्यामुळे ccam ने तयार न केलेल्या फाइल्सना ते हात लावत नाही.

तुम्ही शॉर्टकट चालवता तेव्हा, तुम्ही टाइप केलेले नाव हीच एक गोष्ट ccam ला लागते:

shell ला `PATH` वर `ccwork` सापडतो, kernel लिंक पाळून ccam binary सुरू करतो, आणि `argv[0]` तरीही `ccwork` असतो. `app.Main` मध्ये, `ccam` शिवाय इतर कोणतेही नाव `config.toml` एकदा लोड करते आणि `shim.Lookup` बोलावते, जे ज्या खात्याचा `shortcut` `filepath.Base(argv[0])` शी जुळतो ते शोधते. मग `launcher.LaunchWith` आधीच लोड झालेल्या config सह [`ccam <name>`](https://ccam.dev/mr/features/launch.md) सारखेच टप्पे घेते, आणि `argv[1:]` न बदलता `claude` ला देते.

shell alias किंवा wrapper script नाही तर symlink का: symlink प्रत्येक shell मध्ये आणि scripts मध्ये चालते, ती अतिरिक्त shell सुरू करण्याचा वेळ (सुमारे 1 ते 2 ms) जोडत नाही, आणि सुरू करताना तरीही एकच फाइल वाचली जाते. `scripts/perf-check.sh` `hyperfine` ने शॉर्टकट मोजते, `ccam <name>` च्याच 10 ms (p95) मर्यादेवर.

## सुरक्षितता आणि अपवादात्मक स्थिती

- **कोणत्याही खात्याची नसलेली लिंक.** `~/.local/bin` मधील ccam च्या लिंकचे नाव कोणतेही खाते वापरत नसेल, उदाहरणार्थ तुम्ही `config.toml` मधील `shortcut` हाताने बदलल्यानंतर, तर ccam डीफॉल्ट खात्यावर जात नाही. ते `` ccam: ccold is not the shortcut of any account (see `ccam list`, `ccam shortcut`) `` ने थांबते. `ccam shortcut` ने नाव पुन्हा सेट करा, किंवा लिंक हटवा.
- **आधीपासून असलेल्या फाइल्स.** ccam ने तयार न केलेली फाइल ते कधीच बदलत नाही. `ccam shims install` `<path> already exists and is not a ccam link, so it was left alone` ने थांबते.
- **हलवलेली ccam binary.** तेव्हा जुन्या लिंक्स आता अस्तित्वात नसलेल्या पाथकडे निर्देश करतात, आणि ccam त्यांना स्वतःच्या मानत नाही. त्या हटवा, मग `ccam shims install` चालवा.
- **नाव बदलणे आणि काढणे.** `ccam rename` शॉर्टकटचे नाव तेच ठेवते, आणि लिंक चालत राहते, कारण ती ccam कडे निर्देश करते आणि ccam `config.toml` मध्ये नाव शोधते. `ccam remove` खात्याची लिंक हटवते. `ccam shortcut <account> <new>` नवीन लिंक तयार करण्यापूर्वी जुनी हटवते.
- **PATH.** ccam लिंक तयार करते आणि `~/.local/bin` तुमच्या `PATH` वर नसतो, तेव्हा ते `Note: /home/me/.local/bin is not in PATH. Add it to ~/.bashrc or ~/.zshrc:` आणि त्यानंतर जोडायची `export PATH=...` ओळ छापते.
- **नंतर तपासणे.** `ccam doctor` `missing shortcuts in /home/me/.local/bin: ccwork` नोंदवते आणि फोल्डर `PATH` वर नसल्यास इशारा देते. `ccam doctor --fix` नसलेल्या लिंक्स तयार करते.

## संबंधित

- [Claude Code सुरू करणे](https://ccam.dev/mr/features/launch.md)
- [खाती व्यवस्थापित करणे](https://ccam.dev/mr/features/accounts.md)
- [कमांड संदर्भ](https://ccam.dev/mr/docs/commands.md#shortcuts)
- [ccam इन्स्टॉल करा](https://ccam.dev/mr/docs/install.md)