# 管理帳號 > 用 ccam add、ccam login、ccam list、ccam rename、ccam remove 和 ccam import 新增、登入、列出、重新命名、移除和匯入 Claude Code 帳號。 Source: https://ccam.dev/zh-hant/features/accounts/ · Updated 2026-10-19 每個 ccam 帳號都是一個獨立的 Claude Code 設定資料夾，有自己的登入資訊。這些指令用來建立、登入、列出、重新命名和移除帳號，也能登錄你已經有的資料夾。 ## 用法 ```sh 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" ``` 凡是接受 `` 的指令，都可以指定帳號名稱或它的槽位編號，也就是 `ccam list` 的 `#` 欄。 在終端機中不加任何選項執行 `ccam add`，會開啟設定精靈。它會先詢問名稱，接著顯示共用項目的核取清單（除了對話記錄以外都已勾選），然後詢問 `Create a shortcut command for work? [y/N]`，回答 `y` 後再詢問 `Shortcut name [ccwork]:`。只要加上 `--share`、`--shortcut` 或 `--no-login` 任一個選項，或是輸入來自管線而不是終端機，就會略過設定精靈；這時必須指定名稱，而且除非 `--shortcut` 指定了名稱，否則不會建立快捷指令。 `ccam list` 會顯示槽位、名稱、快捷指令、電子郵件、共用的項目和上次使用時間，預設帳號前面會標示 `*`： ```console $ 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`。`share` 會把每個項目（`mcp`、`settings`、`memory`、`extensions`、`history`）對應到它的群組名稱或 `"local"`。 ## 選項 | 選項 | 作用 | 預設值 | | --- | --- | --- | | `ccam add --no-login` | 建立帳號但不登入；之後再用 `ccam login ` 登入 | 關閉 | | `ccam add --share ` | 與某個群組共用一個項目，或用 `item=local` 讓它保持私有。可重複指定 | `mcp`、`settings`、`memory`、`extensions` 在 `default`；`history` 為 local | | `ccam add --shortcut ` | 同時在 `~/.local/bin` 中建立這個快捷指令 | 無 | | `ccam list --json` | 以 JSON 輸出帳號 | 關閉 | | `ccam remove -y`、`--yes` | 不詢問直接移除 | 關閉 | | `ccam import --name ` | 你指定的資料夾要使用的帳號名稱 | 從資料夾名稱推導 | | `ccam import -y`、`--yes` | 不詢問直接匯入找到的每個資料夾 | 關閉 | | `--dry-run` | `ccam list` 和 `ccam completion` 不會變更任何東西，所以接受它。`add`、`login`、`logout`、`use`、`rename`、`remove` 和 `import` 會拒絕它，並顯示 `` --dry-run is not supported by `ccam add`; nothing was changed ``（其中為該指令的名稱） | 關閉 | `ccam login`、`ccam logout`、`ccam use` 和 `ccam rename` 沒有自己的選項。`ccam completion` 接受 `bash` 或 `zsh`；其他值會失敗並顯示 `only bash and zsh are supported`。 帳號名稱為 1 到 32 個字元，可使用 `a-z`、`0-9`、`-` 和 `_`，並以字母或數字開頭。名稱不能全是數字，因為 `ccam 2` 代表槽位 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 ` 永遠不會有歧義。這份清單是 `internal/config` 中的 `config.Reserved`。 ## 運作方式 `ccam add work --shortcut ccwork` 會在 `addProfile`（`internal/cli/profiles.go`）中執行以下步驟： 1. 在建立任何東西之前，`config.ValidateName` 會檢查名稱，`shim.Check` 會檢查快捷指令。 2. `profile.Add` 以權限 `0700` 建立 `~/.local/share/ccam/profiles/work/`，並給帳號最小的可用槽位編號（`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`，所以當機時絕不會留下只寫了一半的設定。 5. `runLogin` 會在 `CLAUDE_CONFIG_DIR` 設為帳號資料夾的狀態下啟動 `claude auth login`。如果登入失敗，帳號仍會保留，ccam 會印出錯誤，並告訴你之後執行 `ccam login work`。 6. `profile.ReadEmail` 從 `profiles/work/.claude.json` 取出 `oauthAccount.emailAddress`。這個檔案可能有好幾 MB，所以 `TopLevelValue` 只掃描那一個鍵，而不解析整個檔案。 7. `shim.Install` 把 `~/.local/bin/ccwork` 連結到 ccam 執行檔；ccam 啟動時會在 `config.toml` 中查詢 `argv[0]`。 登入可能要花上幾分鐘，這段期間另一個 ccam 可能會儲存設定。因此需要等待的指令會透過 `env.update` 儲存：它會重新載入 `config.toml`，套用那一項變更（這裡是電子郵件），再儲存。基於同樣的理由，`ccam remove` 會在詢問之後重新載入。 `ccam login` 會對現有的帳號執行第 5 和第 6 步。`ccam logout` 會在帳號中執行 `claude auth logout`，並清除儲存的電子郵件。`ccam use` 只會改寫 `config.toml` 中的 `default`。 ### 在遠端機器上登入 透過 SSH 連線時，`claude auth login` 在瀏覽器端的步驟可能會失敗。Claude Code 在伺服器上的 `http://localhost:/callback` 開啟回呼伺服器等待登入，但完成登入的瀏覽器在你的電腦上執行，那個位址在你的電腦上連不到任何地方，瀏覽器會顯示 `ERR_CONNECTION_REFUSED` 之類的錯誤。這個位址仍然帶著一次性代碼，所以 ccam 可以替你轉交： `runLogin` 不會把你的終端機直接交給 Claude Code。它把 Claude Code 的標準輸入接到一個管線，由 `relayLogin` 把你輸入的每一行複製進去，所以在 Claude Code 的 `Paste code here` 提示貼上的代碼仍然會送達。當某一行是回呼位址時，`callbackURL` 只在以下條件都成立時才接受它：主機是 `localhost`、`127.0.0.1` 或 `[::1]`，有指定連接埠，路徑是 `/callback`，而且 `code` 和 `state` 都存在；`http://` 可以省略。接著 `deliverCallback` 會像瀏覽器原本會做的那樣，在伺服器上請求該位址，時間限制為 10 秒，而且不跟隨重新導向。這個請求會抵達正在等待的 `claude auth login` 的回呼伺服器（圖中的虛線）。Claude Code 收到代碼並儲存登入資訊，在 Linux 上是存到帳號資料夾中的 `.credentials.json`。貼上的內容絕不會讓 ccam 連線到其他主機。 ccam 在開始登入前會印出： ```text 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/`、`~/.local/state/ccam/mcp/`，以及用量快取 `~/.local/state/ccam/usage/.json` 和 `.statusline.json`。`ccam remove work` 依以下順序處理它們： 如果帳號正在執行，`ccam remove` 會先拒絕，否則會詢問你。如果帳號共用擴充功能，`RewritePluginPaths` 會改寫群組的 `installed_plugins.json` 和 `known_marketplaces.json`，因為 Claude Code 儲存的是外掛的絕對路徑，而這些路徑可能經過這個帳號的資料夾。`profile.Trash` 會把資料夾移到 `~/.local/share/ccam/trash/-