Claude Code शुरू करना

ccam work Claude Code को work अकाउंट से शुरू करता है, और नाम के बाद का सब कुछ जैसा है वैसा ही claude को जाता है। इसे वहाँ इस्तेमाल करें जहाँ आप claude टाइप करते: टर्मिनल में, किसी स्क्रिप्ट में, या pipe से आए input के साथ।

उपयोग

ccam work                        # Claude Code as the account work
ccam 2                           # the account with number 2 (see ccam list)
ccam work --resume               # claude --resume, as work
ccam work -p "fix the tests" --output-format json
cat log.txt | ccam work -p "find the cause"
ccam -p "summarise"              # no name: the default account
ccam use work                    # make work the default account
ccam run work --continue         # same as ccam work --continue
ccam                             # the picker on a terminal, the list otherwise
ccam --dry-run work -p hi        # print the command instead of running it

अकाउंट का नाम या ccam list से उसका नंबर दें। ccam नाम के बाद वाले आर्ग्युमेंट नहीं पढ़ता, इसलिए ccam work --help Claude Code की help दिखाता है। नाम के बाद -- लगाना वैकल्पिक है। Standard input, exit code और signals वैसे ही काम करते हैं जैसे claude के साथ।

जब पहला आर्ग्युमेंट - से शुरू होता है और ccam के अपने flags में से नहीं है, तो ccam सभी आर्ग्युमेंट के साथ डिफ़ॉल्ट अकाउंट शुरू करता है। डिफ़ॉल्ट वह अकाउंट है जिसे ccam use से सेट किया गया, या अगर आपने कोई सेट नहीं किया तो सबसे छोटे नंबर वाला अकाउंट।

Picker

बिना आर्ग्युमेंट के ccam, standard input और output के टर्मिनल होने पर picker खोलता है, वरना ccam list प्रिंट करता है। यह हर अकाउंट का नंबर, ईमेल, 5 घंटे का उपयोग, आख़िरी उपयोग और साझा आइटम दिखाता है; हर अकाउंट के जवाब देते ही उपयोग भरता जाता है।

Picker कुछ करने से पहले बंद होता है, इसलिए Claude Code शुरू होने से पहले टर्मिनल अपनी सामान्य स्थिति में आ जाता है। d या साझा करने में बदलाव के बाद यह फिर से खुलता है। साझा करने में बदलाव पहले योजना दिखाता है और पूछता है, जैसे ccam share करता है।

विकल्प

आर्ग्युमेंट के नियम:

• ccam अपने flags केवल अकाउंट के नाम से पहले पढ़ता है। नाम के बाद हर आर्ग्युमेंट Claude Code का है, --dry-run और --help भी।
• --dry-run, ccam --dry-run work, ccam run --dry-run work और ccam --dry-run (डिफ़ॉल्ट अकाउंट) के रूप में काम करता है। इसे माना जाता है, अस्वीकार नहीं किया जाता।
• ccam run <name|number> [claude args], ccam <name> का लंबा रूप है। बिना नाम के ccam run डिफ़ॉल्ट अकाउंट इस्तेमाल करता है।
• अकाउंट के नाम add, list, run या usage जैसे ccam कमांड के नाम नहीं हो सकते, इसलिए ccam <word> कभी अस्पष्ट नहीं होता।

Dry run एक पंक्ति प्रिंट करता है जिसे आप shell में paste कर सकते हैं:

$ ccam --dry-run work -p "fix the tests"
CLAUDE_CONFIG_DIR=/home/me/.local/share/ccam/profiles/work /home/me/.local/bin/claude --mcp-config=/home/me/.local/share/ccam/groups/default/mcp.json -p 'fix the tests'

यह कैसे काम करता है

हर बार शुरू करने में, कमांड लाइन से exec तक, वही चरण होते हैं:

हर बॉक्स अपना चरण चलते समय जलता है, और नीचे की पंक्तियाँ वह environment और आर्ग्युमेंट हैं जिनके साथ Claude Code शुरू होता है।

1. cmd/ccam/main.go, app.Main को बुलाता है। अगर ccam किसी दूसरे नाम से शुरू हुआ, तो वह एक शॉर्टकट है और सीधे launcher पर जाता है।
2. app.parse, cobra के शामिल होने से पहले os.Args देखता है। केवल अकेला ccam (picker), कोई ccam कमांड नाम (config.Reserved), -h/--help और -v/--version ही cli.Execute पर जाते हैं। बाकी सब कुछ शुरू करना है।
3. launcher.Launch, ~/.config/ccam/config.toml पढ़ता है, जो इकलौती फ़ाइल है जिसे यह parse करता है।
4. launcher.Prepare नाम या नंबर से अकाउंट खोजता है, शुरुआत का एक -- हटाता है, और ResolveClaude से claude executable खोजता है। PATH की खोज फ़ाइल के modification time के साथ ~/.local/state/ccam/claude-path में cache होती है, इसलिए ccam हर बार शुरू होने पर PATH नहीं खोजता। बदली हुई या गायब फ़ाइल नई खोज करवाती है। config.toml में दिया claude_bin पाथ जैसा है वैसा इस्तेमाल होता है। ccam ऐसे claude को अस्वीकार करता है जो ख़ुद ccam हो, inode से तुलना करके, क्योंकि उससे loop बन जाता।
5. checkLinks, अकाउंट फ़ोल्डर ~/.local/share/ccam/profiles/<name>/ की तुलना उसकी साझा सेटिंग्स से share.Check के ज़रिए करता है, जो केवल lstat और readlink बुलाता है, यानी हर आइटम के लिए एक या दो system call। गायब लिंक तुरंत बना दिया जाता है। जिस भी चीज़ से डेटा खो सकता है, वह शुरू करना रोक देती है।
6. applyMCP साझा MCP सर्वर जोड़ता है (नीचे देखें)।
7. session.Register session दर्ज करता है। ccam अपने PID के नाम वाला एक marker, जिसमें process के शुरू होने का समय होता है, $XDG_RUNTIME_DIR/ccam/profile-<name>/<pid> में लिखता है (या XDG_RUNTIME_DIR न होने पर ~/.local/state/ccam/locks/ में)। बातचीत का इतिहास साझा करने वाले अकाउंट के लिए, historyCheck पहले history-<group>-<hash> में कोई चल रहा session खोजता है, जहाँ hash मौजूदा फ़ोल्डर का है, और वहाँ भी रजिस्टर करता है। exec PID बनाए रखता है, इसलिए marker फिर ख़ुद Claude Code process का नाम बताता है। यह marker है, पकड़ा हुआ lock नहीं, क्योंकि Claude Code जो processes शुरू करता है वे lock विरासत में पाकर session ख़त्म होने के बाद भी उसे रखे रहते।
8. Plan.Exec टर्मिनल का शीर्षक claude · <name> सेट करता है (जब standard error टर्मिनल हो), शुरू करने का समय fsync के बिना ~/.local/state/ccam/last-used/<name> में लिखता है, और syscall.Exec बुलाता है।

Claude Code, अकाउंट फ़ोल्डर पर सेट CLAUDE_CONFIG_DIR और अकाउंट के नाम पर सेट CCAM_PROFILE के साथ चलता है। ccam इनके विरासत में मिले मान हटा देता है। macOS पर ccam import से रजिस्टर किए गए ~/.claude फ़ोल्डर के लिए, यह CLAUDE_SECURESTORAGE_CONFIG_DIR को ख़ाली मान पर भी सेट करता है, ताकि अकाउंट और सादा claude एक ही कीचेन लॉगिन इस्तेमाल करें।

exec क्यों

syscall.Exec, ccam process की जगह claude को रख देता है, इसलिए ccam memory में नहीं रहता, keystrokes, signals और exit code Claude Code के अपने होते हैं, और आर्ग्युमेंट एक array बने रहते हैं, कभी shell string नहीं बनते। Session के बाद का काम, जैसे claude mcp add से जोड़े गए सर्वर पहचानना, अगली बार शुरू होने पर होता है: ccam .claude.json के modification time की तुलना ~/.local/state/ccam/mcp/<name>/seen से करता है और फ़ाइल को केवल तभी parse करता है जब वह बदली हो।

कमांड लाइन का रास्ता कैसे तय होता है

तीन कमांड लाइनें, internal/app से होकर तीन रास्ते:

शॉर्टकट का मिलान argv[0] पर होता है, ccam <name> का पहले आर्ग्युमेंट पर, और दोनों syscall.Exec पर ख़त्म होते हैं। केवल ccam usage जैसी ccam कमांड ही cobra तक पहुँचती है।

साझा MCP सर्वर

डिफ़ॉल्ट flag strategy के साथ, ccam ग्रुप के MCP सर्वर Claude Code को एक आर्ग्युमेंट के रूप में देता है, आपके आर्ग्युमेंट से पहले:

mcp.FlagArgs केवल तभी आर्ग्युमेंट लौटाता है जब ग्रुप की mcp.json मौजूद हो, और Plan.InsertArgs उसे claude के ठीक बाद रखता है। तब आपका अपना --mcp-config या --strict-mcp-config उसके ऊपर फिर भी लागू होता है। यह एक आर्ग्युमेंट है, --mcp-config=<path>, क्योंकि Claude Code का --mcp-config कई मान लेता है: दो आर्ग्युमेंट के रूप में लिखने पर वह बाद में आने वाले prompt को भी config फ़ाइल समझ लेता।

config.toml में mcp_strategy = "sync" होने पर, ccam इसके बजाय सर्वर अकाउंट की .claude.json में लिखता है, और अगर अकाउंट पहले से चल रहा हो तो यह छोड़ देता है।

10 ms का बजट

Claude Code शुरू होने से पहले ccam अधिकतम 10 ms (p95) जोड़ता है। शुरू करने का रास्ता कभी cobra का कमांड ट्री नहीं बनाता, Bubble Tea शुरू नहीं करता और कोई नेटवर्क कनेक्शन नहीं खोलता, और अगर package के init() functions कुल मिलाकर 5 ms से ज़्यादा लें तो TestPackageInitIsCheap विफल होता है। scripts/perf-check.sh, hyperfine से ccam --dry-run work, ccam work और एक शॉर्टकट को मापता है और 10 ms से ऊपर विफल होता है, और internal/launcher में BenchmarkLaunchPath इन चरणों को loop में चलाता है। हर चरण का समय देखने के लिए CCAM_TRACE=1 सेट करें:

$ CCAM_TRACE=1 ccam --dry-run work >/dev/null
ccam trace: start                 2.830ms (total 2.830ms)
ccam trace: load config           0.397ms (total 3.227ms)
ccam trace: prepare               0.112ms (total 3.339ms)
ccam trace: check links           0.238ms (total 3.578ms)
ccam trace: prelaunch             0.083ms (total 3.661ms)

सुरक्षा और विशेष स्थितियाँ

• अज्ञात नाम या नंबर no account "<name>" के साथ रुकता है और ccam list की ओर इशारा करता है। अगर कोई अकाउंट ही न हो, तो ccam ccam add <name> से एक जोड़ने को कहता है।
• अगर कोई साझा पाथ सामान्य फ़ाइल बन गया हो या ग़लत जगह इशारा करता हो, तो ccam stopped because of share link problems: के साथ रुकता है, उनकी सूची दिखाता है, और ccam doctor --fix चलाने को कहता है। शुरू करने के रास्ते पर यह डेटा move नहीं करता।
• अगर इस अकाउंट के साथ बातचीत का इतिहास साझा करने वाला (उसी ग्रुप का) कोई दूसरा Claude Code उसी फ़ोल्डर में चल रहा हो, तो ccam चेतावनी देता है कि इतिहास मिल सकता है और Run anyway? [y/N] पूछता है। टर्मिनल के बिना यह चेतावनी दिखाकर आगे बढ़ता है।
• --dry-run, MCP sync, नए सर्वर की सूचना, इतिहास की जाँच, session marker, शीर्षक और आख़िरी उपयोग का समय छोड़ देता है, और exec नहीं करता। यह फिर भी साझा लिंक जाँचता है, और सामान्य शुरुआत की तरह गायब लिंक बनाता है।
• mcp_strategy = "sync" के साथ, विफल sync ccam: MCP sync failed (launching anyway): … प्रिंट करता है और Claude Code उन्हीं सर्वरों के साथ शुरू होता है जो उसके पास पहले से थे।

संबंधित

• शॉर्टकट कमांड
• अकाउंट प्रबंधित करना
• कमांड संदर्भ
• MCP सर्वर, सेटिंग्स और इतिहास साझा करें
• CLAUDE_CONFIG_DIR कैसे काम करता है