Kusimamia akaunti

Kila akaunti ya ccam ni folda tofauti ya usanidi wa Claude Code yenye taarifa zake za kuingia. Amri hizi huunda, huingiza, huorodhesha, hubadilisha majina na huondoa akaunti, na husajili folda ambazo tayari unazo.

Matumizi

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"

Popote amri inapopokea <name|number>, unaweza kutoa jina la akaunti au namba yake (slot), yaani safu ya # ya ccam list.

ccam add kwenye terminal bila chaguo hufungua mchawi. Huuliza jina, kisha huonyesha orodha ya kuteua ya vipengele vinavyoshirikiwa (kila kitu isipokuwa historia ya mazungumzo kimeteuliwa), kisha huuliza Create a shortcut command for work? [y/N] na, ukijibu y, Shortcut name [ccwork]:. Chaguo lolote kati ya --share, --shortcut au --no-login, au pipe badala ya terminal, huruka mchawi; hapo jina linahitajika na hakuna njia fupi inayoundwa isipokuwa --shortcut itaje moja.

ccam list huonyesha namba, jina, njia fupi, barua pepe, vipengele vinavyoshirikiwa na matumizi ya mwisho, na * mbele ya akaunti chaguo-msingi:

$ 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  -

Kwa --json, kila akaunti ni kitu chenye slot, shortcut, name, email, default, dir, last_used (huachwa ikiwa akaunti haijawahi kuanzishwa) na share. share huhusisha kila kipengele (mcp, settings, memory, extensions, history) na jina la kikundi chake au "local".

Chaguo

ccam login, ccam logout, ccam use na ccam rename hazina chaguo zao wenyewe. ccam completion hupokea bash au zsh; kitu kingine chochote hushindwa kwa only bash and zsh are supported.

Majina ya akaunti yana herufi 1 hadi 32 za a-z, 0-9, - na _, yakianza na herufi au tarakimu. Jina haliwezi kuwa tarakimu tu, kwa sababu ccam 2 inamaanisha namba 2. Jina pia haliwezi kuwa amri ya 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), ili ccam <name> isiwe na utata kamwe. Orodha hiyo ni config.Reserved katika internal/config.

Jinsi inavyofanya kazi

ccam add work --shortcut ccwork hutekeleza hatua hizi katika addProfile (internal/cli/profiles.go):

1. config.ValidateName hukagua jina, na shim.Check hukagua njia fupi kabla ya kitu chochote kuundwa.
2. profile.Add huunda ~/.local/share/ccam/profiles/work/ kwa mode 0700 na huipa akaunti namba ndogo kabisa iliyo wazi (Config.NextSlot), kwa hiyo namba ya akaunti iliyoondolewa hutumiwa tena. Akaunti ya kwanza huwa chaguo-msingi.
3. applyShare huunganisha folda mpya iliyo tupu na vikundi vyake vya kushiriki kwa share.Build na kisha Apply, kwa mfano settings.json kwenda groups/default/settings.json. Hili likishindwa, folda mpya huondolewa, kwa sababu folda iliyobaki ingezuia kila jaribio jipya kwa folder already exists.
4. Akaunti huhifadhiwa katika ~/.config/ccam/config.toml kupitia fsutil.AtomicWrite: faili ya muda, fsync, kisha rename, ili hitilafu ya ghafla isiache usanidi nusu.
5. runLogin huanzisha claude auth login huku CLAUDE_CONFIG_DIR ikiwa imewekwa kwenye folda ya akaunti. Kuingia kukishindwa, akaunti hubaki, na ccam huchapisha hitilafu na kukuambia uendeshe ccam login work baadaye.
6. profile.ReadEmail huchukua oauthAccount.emailAddress kutoka profiles/work/.claude.json. Faili hiyo inaweza kuwa megabaiti kadhaa, kwa hiyo TopLevelValue hutafuta ufunguo huo mmoja badala ya kuchanganua faili nzima.
7. shim.Install huunganisha ~/.local/bin/ccwork na binary ya ccam, ambayo hutafuta argv[0] katika config.toml inapoanza.

Kuingia kunaweza kuchukua dakika kadhaa, na ccam nyingine inaweza kuhifadhi usanidi wakati huo. Kwa hiyo amri zinazosubiri huhifadhi kupitia env.update, ambayo hupakia upya config.toml, hutumia badiliko hilo moja (hapa, barua pepe) na kuhifadhi. ccam remove hupakia upya baada ya swali lake kwa sababu hiyo hiyo.

ccam login hutekeleza hatua ya 5 na 6 kwa akaunti iliyopo. ccam logout huendesha claude auth logout ndani ya akaunti na hufuta barua pepe iliyohifadhiwa. ccam use huandika upya default tu katika config.toml.

Kuingia kwenye mashine ya mbali

Kupitia SSH, sehemu ya kivinjari ya claude auth login inaweza kushindwa. Claude Code husubiri kuingia kwenye seva ya callback katika http://localhost:<port>/callback kwenye seva, lakini kivinjari kinachokamilisha kuingia kinaendeshwa kwenye kompyuta yako, ambako anwani hiyo haielekei popote na kivinjari huonyesha hitilafu kama ERR_CONNECTION_REFUSED. Anwani hiyo bado ina msimbo wa mara moja, kwa hiyo ccam inaweza kuuwasilisha:

runLogin haikabidhi terminal yako kwa Claude Code. Huunganisha standard input ya Claude Code na pipe, na relayLogin hunakili ndani yake kila mstari unaouandika, kwa hiyo msimbo unaobandikwa kwenye swali la Paste code here la Claude Code bado hufika. Mstari unapokuwa anwani ya callback, callbackURL huikubali tu ikiwa host ni localhost, 127.0.0.1 au [::1], port imetolewa, njia ni /callback na code pamoja na state zote zipo; http:// inaweza kuachwa. Kisha deliverCallback huomba anwani hiyo kwenye seva kwa kikomo cha sekunde 10 na bila kufuata redirects, kama kivinjari kingefanya. Ombi hufika kwenye seva ya callback ya claude auth login inayosubiri (mstari wa vistari kwenye mchoro). Claude Code hupokea msimbo na huhifadhi taarifa za kuingia, kwenye Linux katika .credentials.json ndani ya folda ya akaunti. Mstari uliobandikwa hauwezi kamwe kuifanya ccam iwasiliane na host nyingine.

ccam huchapisha hiki kabla kuingia hakujaanza:

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

Ikifaulu huchapisha → Passed the sign-in to Claude Code on this machine.

Kubadilisha jina, kuondoa na kuingiza

ccam rename na ccam remove hufanya kazi kwenye folda ya akaunti na kwenye kile ambacho ccam huhifadhi mahali pengine kwa jina la akaunti. nameState huorodhesha njia hizo: ~/.local/state/ccam/last-used/<name>, ~/.local/state/ccam/mcp/<name> na cache za matumizi ~/.local/state/ccam/usage/<name>.json na <name>.statusline.json. ccam remove work huzishughulikia kwa mpangilio huu:

ccam remove kwanza hukataa ikiwa akaunti inaendeshwa, kisha huuliza. Ikiwa akaunti inashiriki viendelezi, RewritePluginPaths huandika upya installed_plugins.json na known_marketplaces.json za kikundi, kwa sababu Claude Code huhifadhi njia kamili za plugins ambazo zinaweza kupita kwenye folda ya akaunti hii. profile.Trash huhamisha folda kwenda ~/.local/share/ccam/trash/<name>-<time>/, akaunti huondoka kwenye config.toml, njia za nameState hufutwa ili akaunti ya baadaye yenye jina lile lile isizirithi, na kiungo cha njia fupi huondolewa. Ili kurejesha, hamisha folda kutoka kwenye trash.

ccam rename hubadilisha jina la folda, huandika upya njia za plugins katika plugins/ yake kutoka folda ya zamani kwenda mpya, huhamisha hali ya chaguo-msingi pamoja nayo, na huhamisha njia za nameState kwenda jina jipya. Amri ya njia fupi huhifadhi jina lake. Uandikaji upya wa plugins ukishindwa, folda hurudishiwa jina lake la zamani, kwa kuwa usanidi haujahifadhiwa.

ccam import husajili folda pale ilipo, kama dir katika config.toml. Kamwe haiihamishi wala kuinakili: refresh token iliyonakiliwa ingesababisha nakala hizo zitoane nje ya akaunti. Bila hoja ya folda, hutafuta folda za ~/.claude na ~/.claude-* ambazo hazijasajiliwa na huuliza kuhusu kila moja; majina hutokana na folda (~/.claude ni main, ~/.claude-work ni work, ~/.claude-2 ni acct2), na folda ambayo jina lake haliwezi kupatikana huorodheshwa pamoja na amri ya --name ya kutumia. Bila CLAUDE_CONFIG_DIR, Claude Code huhifadhi .claude.json katika folda yako ya nyumbani kando ya ~/.claude, kwa hiyo unapoingiza ~/.claude na haina .claude.json yake yenyewe, ccam huunda kiungo ~/.claude/.claude.json kwenda ~/.claude.json. Kisha claude ya kawaida na ccam main huona akaunti ile ile. Akaunti zilizoingizwa hazishiriki chochote hadi uendeshe ccam share, na hakuna njia fupi inayoundwa.

ccam completion bash|zsh huchapisha script ya kukamilisha amri ambayo pia hukamilisha majina ya akaunti.

Usalama na hali maalum

• ccam rename na ccam remove hukataa wakati akaunti inaendeshwa (refuseRunning), kwa work is running; quit its Claude Code session first, kwa sababu kipindi kinaendelea kuandika ndani ya folda.
• ccam remove kwenye akaunti iliyoingizwa huifuta tu kwenye usajili: ✓ main unregistered (folder ... left in place). ~/.claude yako haihamishwi kwenda kwenye trash.
• ccam add hukataa jina ambalo folda yake tayari ipo katika profiles/, na huelekeza kwa ccam import.
• ccam import hukataa folda ambayo tayari imesajiliwa, njia ambayo si folda, na jina lililokwisha kuchukuliwa.
• ccam logout na ccam login hazikagui kama akaunti inaendeshwa.
• Ikiwa relay haiwezi kufikia Claude Code, kwa mfano baada ya kuingia kumalizika, huchapisha ccam: could not pass the sign-in to Claude Code: pamoja na sababu. Hitilafu ya HTTP kwa kawaida inamaanisha msimbo umeisha muda; anza kuingia tena.

Zinazohusiana

• Kuanzisha Claude Code
• Amri za njia fupi
• Shiriki seva za MCP, mipangilio na historia
• Akaunti kadhaa za Claude Code