ccam انسٹال کریں

Linux یا macOS پر ٹرمینل میں یہ کمانڈ چلائیں:

curl -fsSL https://ccam.dev/install.sh | sh

اسکرپٹ آپ کے سسٹم کے لیے ریلیز ڈاؤن لوڈ کرتا ہے، اس کا SHA-256 چیک سم جانچتا ہے اور ccam کو ~/.local/bin میں رکھتا ہے، جہاں ccam وہ شارٹ کٹ کمانڈز بھی بناتا ہے جو آپ بعد میں چنیں، جیسے ccwork۔ اگر وہ فولڈر آپ کے PATH میں نہیں ہے تو اسکرپٹ وہ لائن دکھاتا ہے جو ~/.bashrc یا ~/.zshrc میں شامل کرنی ہے۔

ccam آپ کے لیے Claude Code شروع کرتا ہے، اس لیے پہلے Claude Code انسٹال کریں اور یقینی بنائیں کہ claude --version کام کرتا ہے۔

معاون سسٹمز

• x86-64 اور ARM64 پر Linux: Ubuntu، Debian، Fedora، Arch، Alpine اور دیگر ڈسٹری بیوشنز۔ بائنری اسٹیٹک ہے اور اسے کسی اور چیز کی ضرورت نہیں۔
• Apple silicon اور Intel پر macOS۔
• Windows براہِ راست سپورٹ نہیں ہے۔ WSL کے اندر ccam کسی بھی Linux سسٹم کی طرح کام کرتا ہے۔

انسٹال کرنے کے دوسرے طریقے

Debian اور Ubuntu پیکیج۔ ریلیزز کے صفحے سے ccam_<version>_linux_amd64.deb ڈاؤن لوڈ کریں اور اسے انسٹال کریں:

sudo apt install ./ccam_*_linux_amd64.deb

پیکیج /usr/bin/ccam انسٹال کرتا ہے۔

سورس سے۔ Go 1.26 یا اس سے نئے ورژن کے ساتھ:

go install github.com/jhyunwoo/ccam/cmd/ccam@latest

کوئی مخصوص ورژن۔ CCAM_VERSION سیٹ کریں:

curl -fsSL https://ccam.dev/install.sh | CCAM_VERSION=v0.1.0 sh

شیل کمپلیشن

ccam completion bash > ~/.local/share/bash-completion/completions/ccam
ccam completion zsh > "${fpath[1]}/_ccam"

کمپلیشن ccam کی تمام کمانڈز اور آپشنز کے لیے کام کرتی ہے، اکاؤنٹس کے ناموں سمیت۔

انسٹالیشن چیک کریں

ccam version
ccam doctor

ccam doctor چیک کرتا ہے کہ Claude Code مل رہا ہے اور ہر اکاؤنٹ فولڈر، لنک اور لاگ اِن درست حالت میں ہے۔ اس کے بعد فوری آغاز پر جائیں۔

اپ ڈیٹ کرنا

ccam update --check
ccam update

ccam update --check صرف یہ بتاتا ہے کہ کوئی نئی ریلیز موجود ہے یا نہیں۔ ccam update آپ کے سسٹم کے لیے ریلیز ڈاؤن لوڈ کرتا ہے، اس کا SHA-256 چیک سم ریلیز کی checksums.txt فائل سے ملاتا ہے اور پھر ccam فائل کو ایک ہی قدم میں بدل دیتا ہے۔ اگر چیک سم میل نہ کھائے تو کچھ بھی تبدیل نہیں ہوتا۔ ccwork جیسے شارٹ کٹس ccam کے لنکس ہیں، اس لیے وہ فوراً نیا ورژن چلاتے ہیں۔

$ ccam update --check
ccam 0.3.0 is available (you have 0.2.0). Run `ccam update`.
$ ccam update
→ downloading https://github.com/jhyunwoo/ccam/releases/download/v0.3.0/ccam_linux_amd64.tar.gz
✓ Updated ccam 0.2.0 → 0.3.0 (/home/me/.local/bin/ccam)
$ ccam update
ccam 0.3.0 is up to date.

ccam کبھی خود سے اپ ڈیٹس چیک نہیں کرتا؛ یہ نئی ریلیز صرف تب ڈھونڈتا ہے جب آپ یہ کمانڈ چلائیں۔ کوئی مخصوص ریلیز، پرانی ریلیز سمیت، انسٹال کرنے کے لیے --version دیں۔ ccam --dry-run update کچھ بھی تبدیل کیے بغیر دکھاتا ہے کہ کیا ڈاؤن لوڈ ہوگا اور کیا بدلا جائے گا۔

ccam update --version v0.2.0
ccam --dry-run update

انسٹال اسکرپٹ دوبارہ چلانے سے بھی ~/.local/bin والی کاپی اپ ڈیٹ ہو جاتی ہے۔ اگر آپ نے ccam کو go install سے بنایا تھا تو وہی کمانڈ دوبارہ چلائیں۔

Debian اور Ubuntu پیکیج۔ apt کے ذریعے انسٹال کی گئی /usr/bin/ccam کو ccam update نہیں بدلتا بلکہ اس کے بجائے یہ مراحل دکھاتا ہے۔ ریلیزز کے صفحے سے نئی ccam_<version>_linux_amd64.deb ڈاؤن لوڈ کریں اور اسے پرانی کے اوپر انسٹال کریں:

sudo apt install ./ccam_*_linux_amd64.deb

اَن انسٹال کرنا

پہلے، جب تک ccam انسٹال ہے، اکاؤنٹس کے شارٹ کٹس ہٹائیں۔ ccam list انہیں Shortcut کالم میں دکھاتا ہے؛ ہر ایک کو ccam shortcut <account> --remove سے ہٹائیں، یا وہ لنکس خود ~/.local/bin سے حذف کریں۔ پھر کمانڈ ہٹائیں، اور اگر اکاؤنٹس کی ضرورت نہ رہی ہو تو ڈیٹا فولڈرز بھی:

ccam list
ccam shortcut work --remove   # once for each account that has a shortcut
rm ~/.local/bin/ccam
rm -r ~/.config/ccam ~/.local/share/ccam ~/.local/state/ccam

~/.local/share/ccam حذف کرنے سے وہاں محفوظ لاگ اِن اور گفتگو کی ہسٹری بھی حذف ہو جاتی ہے۔ جو ~/.claude فولڈر آپ نے امپورٹ کیا تھا وہ اپنی جگہ پر رہتا ہے۔