快速入门

用 ccam add 添加每个账号，然后用 ccam <name> 或你自己命名的快捷命令（例如 ccwork）启动 Claude Code。大多数人只需要这些。

1. 添加第一个账号

ccam add

向导会询问账号名称（例如 personal 或 work）、该账号要与其他账号共享哪些项，以及是否创建快捷命令（见第 4 步）。然后它会运行 claude auth login，打开浏览器让你登录。在远程机器上，浏览器可能停在一个无法加载的 http://localhost:…/callback 页面；把这个地址粘贴到终端中，ccam 就会完成登录。完成后你会看到：

✓ personal (me@example.com) added
  no shortcut (add one with `ccam shortcut personal ccpersonal`)

2. 迁移现有设置

如果你以前用过 Claude Code，你的设置、CLAUDE.md、扩展和 MCP 服务器都在 ~/.claude 中。把它们复制到共享设置中，每个账号就都能用上：

ccam migrate

ccam 会先显示要复制的内容并征求确认。它只读取 ~/.claude，从不复制登录信息；除非你加上 --history，否则不会复制对话历史。详情参见复制现有配置。

3. 添加第二个账号

ccam add work

在浏览器中用另一个账号登录。

4. 切换账号

ccam work 会以 work 账号启动 Claude Code。想要更短的命令，可以给账号起一个专属的快捷命令，例如 ccwork。选完共享项后，向导会询问：

 Create a shortcut command for work? [y/N]
 A command such as ccwork that opens Claude Code as this account.

按 y，然后输入名称，或者直接按回车键使用建议的名称：

 Shortcut name [ccwork]: █
 a-z, 0-9, '.', '-' and '_'; Enter alone uses ccwork

登录完成后，ccam 会显示确认信息：

✓ work (work@example.com) added
  shortcut: ccwork

如果你跳过了这个问题，随时都可以添加快捷命令：

$ ccam shortcut work ccwork
✓ shortcut for work: ccwork

现在，以下任一命令都会以 work 账号启动 Claude Code：

ccwork
ccam work
ccam 2

只运行 ccam 会打开一个选择器：用方向键和回车键选择，或者直接按账号的编号。

快捷命令或账号名之后的所有内容都会原样传给 Claude Code，因此你可以继续使用熟悉的选项：

ccwork --resume
ccam work -p "fix the failing test" --output-format json
cat error.log | ccwork -p "what caused this?"

5. 选择要共享的内容

默认情况下，MCP 服务器、settings.json、全局 CLAUDE.md，以及 agents、commands、skills 和 plugins 会在账号之间共享。对话历史不共享。如果你想跨账号继续对话，请为两个账号都开启它：

ccam share personal --history on
ccam share work --history on

ccam 在做任何更改之前，会先显示它将移动哪些内容。详情参见共享。

6. 当某个账号达到用量限制时

ccam usage
ccam next --continue

ccam usage 显示每个账号的 5 小时用量和每周用量。ccam next --continue 在下一个账号中打开同一段对话。参见用量限制。

已经在使用 ~/.claude？

注册它，而不必重新登录：

ccam import

该文件夹保留在原位置，直接运行 claude 也会像以前一样工作。