கணக்குகளை நிர்வகித்தல்

ஒவ்வொரு ccam கணக்கும் தனக்கென உள்நுழைவு கொண்ட ஒரு தனி Claude Code config கோப்புறை. இந்தக் கட்டளைகள் கணக்குகளை உருவாக்குகின்றன, உள்நுழைகின்றன, பட்டியலிடுகின்றன, பெயர் மாற்றுகின்றன, நீக்குகின்றன, உங்களிடம் ஏற்கெனவே உள்ள கோப்புறைகளைப் பதிவு செய்கின்றன.

பயன்பாடு

ccam add                                   # wizard on a terminal: name, shared items, shortcut, login
ccam add work --shortcut ccwork            # no wizard: log in, then create the ccwork command
ccam add side --no-login --share history=team
ccam login side                            # run claude auth login inside the account
ccam logout side                           # remove the login token
ccam list                                  # table of accounts; ccam ls is the same
ccam list --json                           # machine-readable
ccam use 2                                 # make slot 2 the default account
ccam rename side personal
ccam remove personal                       # asks, then moves the folder to the trash
ccam import                                # find ~/.claude and ~/.claude-* and ask about each
ccam import ~/.claude-ops --name ops
ccam completion zsh > "${fpath[1]}/_ccam"

ஒரு கட்டளை <name|number>-ஐ ஏற்கும் இடங்களில், கணக்கின் பெயரையோ அதன் slot எண்ணையோ, அதாவது ccam list-இன் # நெடுவரிசையை, கொடுக்கலாம்.

options இல்லாமல் டெர்மினலில் இயக்கும் ccam add ஒரு wizard-ஐத் திறக்கும். அது பெயரைக் கேட்டு, பிறகு பகிரப்பட்ட உருப்படிகளின் தேர்வுப் பட்டியலைக் காட்டி (உரையாடல் வரலாற்றைத் தவிர அனைத்தும் தேர்வுசெய்யப்பட்டிருக்கும்), பிறகு Create a shortcut command for work? [y/N] என்றும், y கொடுத்தால் Shortcut name [ccwork]: என்றும் கேட்கும். --share, --shortcut, --no-login ஆகியவற்றில் ஏதேனும் ஒன்று, அல்லது டெர்மினலுக்குப் பதிலாக ஒரு pipe, wizard-ஐத் தவிர்க்கும்; அப்போது பெயர் கட்டாயம், --shortcut ஒன்றைப் பெயரிடாவிட்டால் குறுக்குவழி உருவாக்கப்படாது.

ccam list slot, பெயர், குறுக்குவழி, மின்னஞ்சல், பகிரப்பட்ட உருப்படிகள், கடைசிப் பயன்பாடு ஆகியவற்றைக் காட்டும், இயல்புநிலைக் கணக்குக்கு முன் * இருக்கும்:

$ ccam list
   #  Name      Shortcut  Email             Shared                        Last used
*  1  work      ccwork    user@example.com  mcp settings md ext           -
   2  personal  -         me@side.dev       settings md ext history@team  -

--json உடன், ஒவ்வொரு கணக்கும் slot, shortcut, name, email, default, dir, last_used (கணக்கு ஒருபோதும் தொடங்கப்படவில்லை என்றால் விடப்படும்), share ஆகியவற்றைக் கொண்ட ஒரு object. share ஒவ்வோர் உருப்படியையும் (mcp, settings, memory, extensions, history) அதன் குழுப் பெயருடன் அல்லது "local" உடன் இணைக்கும்.

Options

ccam login, ccam logout, ccam use, ccam rename ஆகியவற்றுக்குச் சொந்த options இல்லை. ccam completion bash அல்லது zsh-ஐ ஏற்கும்; வேறு எதுவும் only bash and zsh are supported என்று தோல்வியடையும்.

கணக்குப் பெயர்கள் a-z, 0-9, -, _ ஆகியவற்றால் ஆன 1 முதல் 32 எழுத்துகள், ஓர் எழுத்து அல்லது இலக்கத்தில் தொடங்க வேண்டும். ccam 2 என்றால் slot 2 என்பதால், பெயர் முழுவதும் இலக்கங்களாக இருக்க முடியாது. பெயர் ஒரு ccam கட்டளையாகவும் இருக்க முடியாது (add, list, ls, run, use, next, usage, u, share, mcp, login, logout, rename, remove, rm, import, migrate, doctor, shims, shortcut, completion, help, version, statusline, update), அதனால் ccam <name> ஒருபோதும் குழப்பமாக இருக்காது. இந்தப் பட்டியல் internal/config-இல் உள்ள config.Reserved.

இது எப்படி வேலை செய்கிறது

ccam add work --shortcut ccwork addProfile-இல் (internal/cli/profiles.go) இந்தப் படிகளை இயக்குகிறது:

1. எதுவும் உருவாக்கப்படும் முன், config.ValidateName பெயரையும், shim.Check குறுக்குவழியையும் சரிபார்க்கின்றன.
2. profile.Add 0700 mode-உடன் ~/.local/share/ccam/profiles/work/-ஐ உருவாக்கி, கணக்குக்கு மிகக் குறைந்த காலி slot எண்ணைக் (Config.NextSlot) கொடுக்கிறது, அதனால் நீக்கப்பட்ட கணக்கின் எண் மீண்டும் பயன்படுத்தப்படும். முதல் கணக்கு இயல்புநிலை ஆகிறது.
3. applyShare புதிய, காலியான கோப்புறையை share.Build மற்றும் பிறகு Apply மூலம் அதன் பகிர்வுக் குழுக்களுடன் இணைக்கிறது, எடுத்துக்காட்டாக settings.json-ஐ groups/default/settings.json-உடன். இது தோல்வியடைந்தால், புதிய கோப்புறை நீக்கப்படும், ஏனெனில் மீதமிருக்கும் கோப்புறை ஒவ்வொரு மறுமுயற்சியையும் folder already exists என்று தடுக்கும்.
4. கணக்கு fsutil.AtomicWrite மூலம் ~/.config/ccam/config.toml-இல் சேமிக்கப்படுகிறது: ஒரு தற்காலிகக் கோப்பு, fsync, பிறகு rename, அதனால் crash ஒருபோதும் பாதி config-ஐ விட்டுச்செல்லாது.
5. runLogin கணக்குக் கோப்புறைக்கு அமைக்கப்பட்ட CLAUDE_CONFIG_DIR உடன் claude auth login-ஐத் தொடங்குகிறது. உள்நுழைவு தோல்வியடைந்தால், கணக்கு அப்படியே இருக்கும், ccam பிழையை அச்சிட்டு, பின்னர் ccam login work-ஐ இயக்கச் சொல்லும்.
6. profile.ReadEmail profiles/work/.claude.json-இலிருந்து oauthAccount.emailAddress-ஐ எடுக்கிறது. அந்தக் கோப்பு பல megabytes ஆக இருக்கலாம், அதனால் TopLevelValue முழுக் கோப்பையும் parse செய்வதற்குப் பதிலாக அந்த ஒரு key-ஐ மட்டும் தேடுகிறது.
7. shim.Install ~/.local/bin/ccwork-ஐ ccam binary-உடன் இணைக்கிறது; அது தொடங்கும்போது argv[0]-ஐ config.toml-இல் தேடுகிறது.

உள்நுழைவுக்குச் சில நிமிடங்கள் ஆகலாம், இடையில் மற்றொரு ccam config-ஐச் சேமிக்கக்கூடும். அதனால் காத்திருக்கும் கட்டளைகள் env.update மூலம் சேமிக்கின்றன; அது config.toml-ஐ மீண்டும் ஏற்றி, அந்த ஒரு மாற்றத்தை (இங்கே, மின்னஞ்சல்) பொருத்தி, சேமிக்கிறது. இதே காரணத்துக்காக ccam remove தன் கேள்விக்குப் பிறகு மீண்டும் ஏற்றுகிறது.

ccam login ஏற்கெனவே உள்ள கணக்குக்குப் படி 5 மற்றும் 6-ஐ இயக்குகிறது. ccam logout கணக்கில் claude auth logout-ஐ இயக்கி, சேமித்த மின்னஞ்சலை அழிக்கிறது. ccam use config.toml-இல் default-ஐ மட்டுமே மாற்றி எழுதுகிறது.

தொலைநிலைக் கணினியில் உள்நுழைதல்

SSH வழியாக, claude auth login-இன் browser பகுதி உடைந்துவிடக்கூடும். Claude Code சர்வரில் http://localhost:<port>/callback-இல் உள்ள ஒரு callback சர்வரில் உள்நுழைவுக்காகக் காத்திருக்கிறது, ஆனால் உள்நுழைவை முடிக்கும் browser உங்கள் கணினியில் இயங்குகிறது, அங்கே அந்த முகவரி எங்கும் செல்லாது, browser ERR_CONNECTION_REFUSED போன்ற பிழையைக் காட்டும். முகவரியில் இன்னும் ஒருமுறைக் குறியீடு உள்ளது, அதனால் ccam அதைச் சேர்க்க முடியும்:

runLogin உங்கள் டெர்மினலை Claude Code-இடம் ஒப்படைப்பதில்லை. அது Claude Code-இன் standard input-ஐ ஒரு pipe-உடன் இணைக்கிறது, நீங்கள் தட்டச்சு செய்யும் ஒவ்வொரு வரியையும் relayLogin அதற்குள் நகலெடுக்கிறது, அதனால் Claude Code-இன் Paste code here கேள்வியில் ஒட்டப்படும் குறியீடு இன்னும் வந்துசேரும். ஒரு வரி callback முகவரியாக இருந்தால், host localhost, 127.0.0.1 அல்லது [::1] ஆக இருந்து, port கொடுக்கப்பட்டு, பாதை /callback ஆக இருந்து, code மற்றும் state இரண்டும் இருந்தால் மட்டுமே callbackURL அதை ஏற்கிறது; http://-ஐ விட்டுவிடலாம். பிறகு deliverCallback browser செய்திருப்பது போலவே, 10 வினாடி வரம்புடனும் redirects-ஐப் பின்தொடராமலும், சர்வரில் அந்த முகவரியைக் கோருகிறது. கோரிக்கை காத்திருக்கும் claude auth login-இன் callback சர்வரை அடைகிறது (வரைபடத்தில் கோடிட்ட வரி). Claude Code குறியீட்டைப் பெற்று உள்நுழைவைச் சேமிக்கிறது, Linux-இல் கணக்குக் கோப்புறையில் உள்ள .credentials.json-இல். ஒட்டப்பட்ட வரி ccam-ஐ ஒருபோதும் வேறொரு host-ஐத் தொடர்புகொள்ள வைக்க முடியாது.

உள்நுழைவு தொடங்கும் முன் ccam இதை அச்சிடும்:

On a remote machine? If the browser ends on a http://localhost:…/callback page that does not load, paste that address here.

வெற்றிபெற்றால் அது → Passed the sign-in to Claude Code on this machine. என்று அச்சிடும்.

பெயர் மாற்றம், நீக்கம், இறக்குமதி

ccam rename மற்றும் ccam remove கணக்கின் கோப்புறையிலும், கணக்கின் பெயரில் ccam வேறிடங்களில் வைத்திருப்பவற்றிலும் செயல்படுகின்றன. nameState அந்தப் பாதைகளைப் பட்டியலிடுகிறது: ~/.local/state/ccam/last-used/<name>, ~/.local/state/ccam/mcp/<name>, usage caches ~/.local/state/ccam/usage/<name>.json மற்றும் <name>.statusline.json. ccam remove work அவற்றை இந்த வரிசையில் கையாள்கிறது:

ccam remove முதலில் கணக்கு இயங்கிக்கொண்டிருந்தால் மறுத்து, பிறகு கேட்கும். கணக்கு நீட்டிப்புகளைப் பகிர்ந்தால், RewritePluginPaths குழுவின் installed_plugins.json மற்றும் known_marketplaces.json-ஐ மாற்றி எழுதுகிறது, ஏனெனில் Claude Code இந்தக் கணக்கின் கோப்புறை வழியாகச் செல்லக்கூடிய absolute plugin பாதைகளைச் சேமிக்கிறது. profile.Trash கோப்புறையை ~/.local/share/ccam/trash/<name>-<time>/-க்கு நகர்த்துகிறது, கணக்கு config.toml-இலிருந்து நீங்குகிறது, அதே பெயருடைய பிந்தைய கணக்கு அவற்றைப் பெறாமல் இருக்க nameState பாதைகள் நீக்கப்படுகின்றன, குறுக்குவழி இணைப்பும் நீக்கப்படுகிறது. மீட்டெடுக்க, கோப்புறையைக் குப்பையிலிருந்து திரும்ப நகர்த்துங்கள்.

ccam rename கோப்புறையின் பெயரை மாற்றி, அதன் plugins/-இல் உள்ள plugin பாதைகளைப் பழைய கோப்புறையிலிருந்து புதியதுக்கு மாற்றி எழுதி, இயல்புநிலையையும் உடன் கொண்டு சென்று, nameState பாதைகளைப் புதிய பெயருக்கு நகர்த்துகிறது. குறுக்குவழிக் கட்டளை தன் பெயரை வைத்திருக்கும். plugin மாற்றி எழுதுதல் தோல்வியடைந்தால், config சேமிக்கப்படாததால், கோப்புறையின் பெயர் மீண்டும் பழையதாக மாற்றப்படும்.

ccam import ஒரு கோப்புறையை அது இருக்கும் இடத்திலேயே, config.toml-இல் dir ஆகப் பதிவு செய்கிறது. அது அதை ஒருபோதும் நகர்த்துவதோ நகலெடுப்பதோ இல்லை: நகலெடுக்கப்பட்ட refresh token நகல்களை ஒன்றையொன்று வெளியேற்ற வைக்கும். கோப்புறை argument இல்லாமல், அது பதிவுசெய்யப்படாத ~/.claude மற்றும் ~/.claude-* கோப்புறைகளைத் தேடி, ஒவ்வொன்றைப் பற்றியும் கேட்கும்; பெயர்கள் கோப்புறையிலிருந்து வருகின்றன (~/.claude என்பது main, ~/.claude-work என்பது work, ~/.claude-2 என்பது acct2), பெயரைப் பெற முடியாத கோப்புறை பயன்படுத்த வேண்டிய --name கட்டளையுடன் பட்டியலிடப்படும். CLAUDE_CONFIG_DIR இல்லாமல், Claude Code .claude.json-ஐ உங்கள் home கோப்புறையில் ~/.claude-க்கு அருகில் வைக்கிறது, அதனால் நீங்கள் ~/.claude-ஐ இறக்குமதி செய்து அதற்குச் சொந்த .claude.json இல்லையென்றால், ccam ~/.claude/.claude.json-இலிருந்து ~/.claude.json-க்கு இணைப்பை உருவாக்கும். அப்போது வெறும் claude-உம் ccam main-உம் ஒரே கணக்கைப் பார்க்கும். நீங்கள் ccam share-ஐ இயக்கும் வரை இறக்குமதி செய்யப்பட்ட கணக்குகள் எதையும் பகிராது, குறுக்குவழியும் உருவாக்கப்படாது.

ccam completion bash|zsh கணக்குப் பெயர்களையும் நிறைவுசெய்யும் ஒரு completion script-ஐ அச்சிடும்.

பாதுகாப்பும் விளிம்பு நிலைகளும்

• கணக்கு இயங்கும்போது ccam rename மற்றும் ccam remove மறுக்கும் (refuseRunning), work is running; quit its Claude Code session first என்று, ஏனெனில் அமர்வு கோப்புறையில் தொடர்ந்து எழுதுகிறது.
• இறக்குமதி செய்யப்பட்ட கணக்கில் ccam remove அதன் பதிவை மட்டுமே நீக்கும்: ✓ main unregistered (folder ... left in place). உங்கள் ~/.claude குப்பைக்கு நகர்த்தப்படாது.
• profiles/-இல் ஏற்கெனவே கோப்புறை உள்ள பெயரை ccam add மறுத்து, ccam import-ஐச் சுட்டிக்காட்டும்.
• ccam import ஏற்கெனவே பதிவுசெய்யப்பட்ட கோப்புறை, கோப்புறை அல்லாத பாதை, ஏற்கெனவே எடுக்கப்பட்ட பெயர் ஆகியவற்றை மறுக்கும்.
• ccam logout மற்றும் ccam login கணக்கு இயங்குகிறதா என்று சரிபார்ப்பதில்லை.
• relay Claude Code-ஐ அடைய முடியாவிட்டால், எடுத்துக்காட்டாக உள்நுழைவு முடிந்த பிறகு, அது காரணத்துடன் ccam: could not pass the sign-in to Claude Code: என்று அச்சிடும். HTTP பிழை பொதுவாகக் குறியீடு காலாவதியானது என்று பொருள்; உள்நுழைவை மீண்டும் தொடங்குங்கள்.

தொடர்புடையவை

• Claude Code-ஐத் தொடங்குதல்
• குறுக்குவழிக் கட்டளைகள்
• MCP சர்வர்கள், அமைப்புகள், வரலாற்றைப் பகிர்தல்
• பல Claude Code கணக்குகள்