Sarrafa asusai

Kowane asusun ccam foldar saitin Claude Code ce ta daban mai nata shiga. Waɗannan umarnai suna ƙirƙira, shiga, lissafa, sake suna da cire asusai, kuma suna yin rajistar foldojin da kake da su tuni.

Amfani

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"

Duk inda umarni ke karɓar <name|number>, za ka iya ba da sunan asusun ko lambar ramin (slot) sa, wato ginshiƙin # na ccam list.

ccam add a terminal ba tare da zaɓuɓɓuka ba yana buɗe mataimaki (wizard). Yana tambayar suna, sannan yana nuna jerin zaɓin abubuwan da aka raba (an yi wa komai alama sai tarihin tattaunawa), sannan yana tambaya Create a shortcut command for work? [y/N] kuma, idan ka ce y, Shortcut name [ccwork]:. Duk wani daga --share, --shortcut ko --no-login, ko bututu (pipe) maimakon terminal, yana tsallake mataimakin; to sai dole a ba da suna, kuma ba a ƙirƙirar gajeren umarni sai idan --shortcut ya ambaci ɗaya.

ccam list yana nuna ramin, suna, gajeren umarni, imel, abubuwan da aka raba da amfani na ƙarshe, tare da * a gaban asusun tsoho:

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

Da --json, kowane asusu abu ne mai slot, shortcut, name, email, default, dir, last_used (ba ya nan idan ba a taɓa fara asusun ba) da share. share yana danganta kowane abu (mcp, settings, memory, extensions, history) da sunan rukuninsa ko da "local".

Zaɓuɓɓuka

ccam login, ccam logout, ccam use da ccam rename ba su da zaɓuɓɓukan kansu. ccam completion yana karɓar bash ko zsh; duk wani abu dabam yana gazawa da only bash and zsh are supported.

Sunayen asusai haruffa 1 zuwa 32 ne na a-z, 0-9, - da _, suna farawa da harafi ko lamba. Suna ba zai iya zama lambobi kawai ba, domin ccam 2 yana nufin ramin 2. Haka kuma suna ba zai iya zama umarnin ccam ba (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), don haka ccam <name> ba ya taɓa yin shubuha. Jerin shi ne config.Reserved a internal/config.

Yadda yake aiki

ccam add work --shortcut ccwork yana gudanar da waɗannan matakai a addProfile (internal/cli/profiles.go):

1. config.ValidateName yana duba sunan, kuma shim.Check yana duba gajeren umarnin kafin a ƙirƙiri komai.
2. profile.Add yana ƙirƙirar ~/.local/share/ccam/profiles/work/ da mode 0700 kuma yana ba asusun mafi ƙanƙantar lambar rami da ke a kwance (Config.NextSlot), don haka ana sake amfani da lambar asusun da aka cire. Asusun farko yana zama tsoho.
3. applyShare yana haɗa sabuwar foldar mara komai da rukunonin rabawarta da share.Build sannan Apply, misali settings.json zuwa groups/default/settings.json. Idan wannan ya gaza, ana cire sabuwar foldar, domin foldar da ta rage za ta hana kowace sake gwadawa da folder already exists.
4. Ana ajiye asusun a ~/.config/ccam/config.toml ta fsutil.AtomicWrite: fayil na wucin gadi, fsync, sannan rename, don haka faɗuwar shiri ba ta taɓa barin rabin saiti ba.
5. runLogin yana fara claude auth login tare da CLAUDE_CONFIG_DIR da aka saita zuwa foldar asusun. Idan shigar ta gaza, asusun yana nan, kuma ccam yana buga kuskuren kuma yana gaya maka ka gudanar da ccam login work daga baya.
6. profile.ReadEmail yana fitar da oauthAccount.emailAddress daga profiles/work/.claude.json. Wannan fayil zai iya kai megabytes da dama, don haka TopLevelValue yana neman maɓalli ɗaya kawai maimakon ya karanta dukkan fayil ɗin.
7. shim.Install yana haɗa ~/.local/bin/ccwork da binary na ccam, wanda ke neman argv[0] a config.toml lokacin da ya fara.

Shiga na iya ɗaukar mintuna, kuma wani ccam na iya ajiye saitin a wannan lokacin. Don haka umarnin da ke jira suna ajiyewa ta env.update, wanda ke sake loda config.toml, yana amfani da canji ɗaya (a nan, imel ɗin) kuma yana ajiyewa. ccam remove yana sake lodawa bayan tambayarsa saboda dalili ɗaya.

ccam login yana gudanar da mataki na 5 da na 6 ga asusun da ke akwai. ccam logout yana gudanar da claude auth logout a cikin asusun kuma yana share imel ɗin da aka ajiye. ccam use yana sake rubuta default a config.toml kawai.

Shiga a kwamfutar nesa

Ta SSH, ɓangaren burauza na claude auth login zai iya lalacewa. Claude Code yana jiran shigar a sabar callback a http://localhost:<port>/callback a kan sabar, amma burauzar da ke kammala shigar tana aiki a kwamfutarka, inda wannan adireshin ba ya kai ko'ina kuma burauzar tana nuna kuskure kamar ERR_CONNECTION_REFUSED. Adireshin har yanzu yana ɗauke da lambar sau ɗaya, don haka ccam zai iya isar da ita:

runLogin ba ya miƙa terminal ɗinka ga Claude Code. Yana haɗa standard input na Claude Code da bututu (pipe), kuma relayLogin yana kwafar kowane layi da ka rubuta zuwa cikinsa, don haka lambar da aka liƙa a tambayar Paste code here ta Claude Code har yanzu tana isa. Idan layi adireshin callback ne, callbackURL yana karɓar sa ne kawai idan host ɗin localhost, 127.0.0.1 ko [::1] ne, an ba da port, hanyar /callback ce kuma duka code da state suna nan; ana iya barin http://. Sannan deliverCallback yana neman wannan adireshin a kan sabar da iyakar daƙiƙa 10 kuma ba tare da bin redirects ba, kamar yadda burauzar za ta yi. Buƙatar tana isa sabar callback na claude auth login da ke jira (layin da aka yanke a zanen). Claude Code yana karɓar lambar kuma yana ajiye shigar, a Linux a .credentials.json cikin foldar asusun. Layin da aka liƙa ba zai taɓa sa ccam ya tuntuɓi wani host ba.

ccam yana buga wannan kafin shigar ta fara:

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

Idan ya yi nasara yana buga → Passed the sign-in to Claude Code on this machine.

Yayin da shigar ke jiran shigarwa a terminal, ccam yana kashe echo da yanayin layi (line mode) na terminal kuma yana nuna * ga kowane harafi da ka rubuta, don haka lambar da aka liƙa ko adireshin callback ba ya bayyana a allo. readLine yana gyara layin da kansa: Enter yana aika layin, Backspace yana goge harafi ɗaya, kuma Ctrl+D a layi mara komai yana kawo ƙarshen shigarwa. Ana mayar da terminal yadda yake idan shigar ta ƙare, haka kuma a Ctrl+C, SIGTERM ko SIGHUP, waɗanda har yanzu suke ƙare ccam. Idan babu terminal a standard input da standard error, ana kwafar layuka yadda suke zuwa.

Sake suna, cirewa da shigowa

ccam rename da ccam remove suna aiki a kan foldar asusun da kuma abin da ccam ke ajiyewa da sunan asusun a wasu wurare. nameState yana lissafa waɗannan hanyoyi: ~/.local/state/ccam/last-used/<name>, ~/.local/state/ccam/mcp/<name> da cache na amfani ~/.local/state/ccam/usage/<name>.json da <name>.statusline.json. ccam remove work yana sarrafa su a wannan tsari:

ccam remove da farko yana ƙi idan asusun yana aiki, sannan yana tambaya. Idan asusun yana raba extensions, RewritePluginPaths yana sake rubuta installed_plugins.json da known_marketplaces.json na rukunin, domin Claude Code yana ajiye cikakkun hanyoyin plugin waɗanda za su iya ratsa foldar wannan asusun. profile.Trash yana matsar da foldar zuwa ~/.local/share/ccam/trash/<name>-<time>/, asusun yana fita daga config.toml, ana goge hanyoyin nameState don kada asusun da za a yi daga baya mai suna iri ɗaya ya gaje su, kuma ana cire mahaɗin gajeren umarnin. Don maidowa, mayar da foldar daga shara.

ccam rename yana sake sunan foldar, yana sake rubuta hanyoyin plugin a cikin plugins/ ɗinta daga tsohuwar foldar zuwa sabuwa, yana ɗauke da matsayin tsoho tare, kuma yana matsar da hanyoyin nameState zuwa sabon sunan. Gajeren umarnin yana riƙe sunansa. Idan sake rubuta plugin ɗin ya gaza, ana mayar da sunan foldar, tunda ba a ajiye saitin ba.

ccam import yana yin rajistar folda a inda take, a matsayin dir a config.toml. Ba ya taɓa matsar ko kwafar ta: refresh token da aka kwafa zai sa kwafin su fitar da juna. Ba tare da argument na folda ba yana neman foldojin ~/.claude da ~/.claude-* da ba a yi wa rajista ba kuma yana tambaya game da kowace; sunaye suna fitowa daga foldar (~/.claude shi ne main, ~/.claude-work shi ne work, ~/.claude-2 shi ne acct2), kuma ana lissafa foldar da ba za a iya samun suna daga gare ta ba tare da umarnin --name da za a yi amfani da shi. Ba tare da CLAUDE_CONFIG_DIR ba, Claude Code yana ajiye .claude.json a foldar gidanka kusa da ~/.claude, don haka idan ka shigo da ~/.claude kuma ba shi da .claude.json nasa, ccam yana ƙirƙirar mahaɗin ~/.claude/.claude.json zuwa ~/.claude.json. Sannan claude na yau da kullum da ccam main suna ganin asusu ɗaya. Asusan da aka shigo da su ba sa raba komai har sai ka gudanar da ccam share, kuma ba a ƙirƙirar gajeren umarni.

ccam completion bash|zsh yana buga rubutun kammalawa (completion) wanda kuma ke kammala sunayen asusai.

Tsaro da yanayi na musamman

• ccam rename da ccam remove suna ƙi yayin da asusun ke aiki (refuseRunning), da work is running; quit its Claude Code session first, domin zaman yana ci gaba da rubutu a cikin foldar.
• ccam remove a kan asusun da aka shigo da shi yana soke rajistarsa kawai: ✓ main unregistered (folder ... left in place). Ba a matsar da ~/.claude naka zuwa shara ba.
• ccam add yana ƙin sunan da foldarsa ta riga ta kasance a profiles/, kuma yana nuna ccam import.
• ccam import yana ƙin foldar da aka riga aka yi wa rajista, hanyar da ba folda ba ce, da sunan da aka riga aka ɗauka.
• ccam logout da ccam login ba sa duba ko asusun yana aiki.
• Idan relay ɗin ba zai iya kai wa Claude Code ba, misali bayan shigar ta ƙare, yana buga ccam: could not pass the sign-in to Claude Code: tare da dalilin. Kuskuren HTTP yawanci yana nufin lambar ta ƙare; sake fara shigar.

Masu alaƙa

• Fara Claude Code
• Gajerun umarni
• Raba sabobin MCP, saituna da tarihi
• Asusun Claude Code da dama