multi-ccp

v0.1.8

Published

3 days ago

Cross-platform Claude Code profile manager for API, login, and router workflows.

0High
0Medium
0Low

asoutherncat

claude-code claude profiles cli anthropic

multi-ccp

English | 简体中文

multi-ccp 是一个 Claude Code profile 和历史会话管理工具。它会安装 ccp 命令，帮助你运行多个 Claude Code 会话窗口，并让每个窗口拥有独立隔离的配置目录、模型 provider、登录状态和历史记录。

当你希望为工作、个人项目、不同 API provider、不同模型路由分别使用独立 Claude Code 会话时，可以使用 multi-ccp，无需手动切换环境变量或反复编辑配置文件。

multi-ccp

功能特性

使用独立 profile 运行多个 Claude Code 会话窗口。
每个 profile 的 Claude Code 配置、登录状态、环境变量和项目历史记录互相隔离。
创建兼容 Anthropic API 的 profile，自定义 ANTHROPIC_BASE_URL、token 和模型配置。
创建 Claude 登录 profile，使用 Claude Code 正常账号登录流程，不保存账号密码。
创建 Claude Code Router preset profile，支持多个模型 provider 和 route。
通过同一个 CLI 管理 Claude Code Router。
在不同 profile 之间，或在 main 与 profile 之间同步 Claude Code 历史会话。
快速查看、打开和编辑 profile 配置。

安装

npm install -g multi-ccp

验证安装：

ccp --version
ccp help

快速开始

想走最短路径？可以先问 AI 如何使用 multi-ccp。复制这句提示词：

How do I use multi-ccp to manage multiple Claude Code profiles?

如果你想查看完整命令说明，可以继续阅读下面的示例。

打开本地 Web UI，用可视化方式查看 profile 和创建配置：

ccp ui

Web UI 是 CLI 的本地辅助界面，可用于查看 profile、基于预设创建 profile、编辑 profile 配置，以及打开 CCR 管理入口。

multi-ccp

交互式创建一个 profile：

ccp add
ccp start <profile-name>

ccp add 会让你选择内置预设模板或自定义配置，例如 DeepSeek、AI CodeMirror、Mimo、CCR GPT、Manual CCR、Claude Login 或 Custom API。

如果你想直接使用某个内置预设，也可以指定 --preset：

ccp add --preset deepseek
ccp add --preset deepseek my-ds
ccp start my-ds

为另一个 provider、账号或项目上下文创建独立 profile：

ccp add
ccp start <profile-name>

列出和查看 profile：

ccp list
ccp status work
ccp path work

Profile 类型

API Profiles

API profile 用于兼容 Anthropic API 的 provider。它会将 API 环境变量写入该 profile 的 settings.json。

ccp add
ccp start <profile-name>

选择 API 预设时，命令会提示你输入 profile 名称和 token。选择 Custom API 时，命令会提示你输入：

ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN
模型名称（可选；留空则使用 Claude Code 默认模型）

自定义 provider 模型

为了简化 provider 配置，ccp add 会把你输入的模型名称默认写入所有 Claude Code 默认模型槽位。如果留空，multi-ccp 不会写入任何模型环境变量，由 Claude Code 使用默认模型。以填写了模型的 DeepSeek profile 为例，初始配置可能类似：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_MODEL": "deepseek-v4-pro"
  }
}

如果你的 provider 为快速任务、子代理或长上下文任务提供了不同模型，可以手动编辑 profile：

ccp edit deepseek

例如，把轻量模型分配给快速任务，把支持 1M 上下文的模型分配给主模型槽位：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1M]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1M]"
  }
}

具体模型名称和 endpoint 请参考 DeepSeek API 文档。

Login Profiles

ccp add
ccp start <profile-name>

当 Claude Code 要求你登录时，登录状态会保存在这个 profile 的配置目录下。另一个 profile 可以使用不同账号或不同登录状态：

ccp add-login personal
ccp start personal

ccp add-login <profile> 仍可作为直接创建登录 profile 的兼容入口。

Claude Code Router Profiles

CCR profile 绑定到 Claude Code Router preset。Claude Code Router 是一个独立的开源项目，可以将 Claude Code 请求路由到不同模型 provider。multi-ccp 会集成它的 config 和 preset system，让每个 profile 可以使用自己的 provider route。

ccp ccr status
ccp ccr model
ccp add
ccp start <profile-name>

CCR profile 会把 route 写入 .ccp.json，并让 Claude Code 指向类似这样的 preset endpoint：

http://127.0.0.1:3456/preset/gpt-route

历史会话同步

sync-session 会同步当前项目的 Claude Code 历史会话。你可以交互式选择要同步的会话，也可以一次同步全部会话。

从 main 同步到某个 profile：

ccp sync-session work
ccp sync-session work --all

在两个命名 profile 之间同步：

ccp sync-session work to personal
ccp sync-session work to personal --all

从 profile 同步回 main：

ccp sync-session work to main

同步命令会在 .ccp-sync 中记录 hash，复制 session assets，并在目标文件存在冲突时提示是否覆盖。

命令

ccp help
ccp list
ccp ui
ccp add [profile]
ccp add --preset <preset> [profile]
ccp add-login <profile>
ccp add-ccr <profile>
ccp remove <profile>
ccp status <profile|main>
ccp start <profile> [claude args...]
ccp path <profile|main>
ccp edit <profile>

Claude Code Router 相关命令：

ccp ccr status
ccp ccr install
ccp ccr start
ccp ccr stop
ccp ccr restart
ccp ccr ui
ccp ccr model

历史会话同步命令：

ccp sync-session <target-profile> [--all]
ccp sync-session <source-profile|main> to <target-profile|main> [--all]

配置目录

Profiles 默认存放在：

~/.claude-profiles/<profile>

Claude Code 默认配置目录仍然可以通过 main 访问：

main

例如：

ccp status main
ccp sync-session main to work
ccp sync-session work to main

安全说明

ccp remove <profile> 删除前会要求你输入 profile 名称确认。
ccp add、ccp add-login 和 ccp add-ccr 不会覆盖已经存在的 profile。
sync-session 使用 SHA-256 hash 检测冲突，并在覆盖目标文件前询问确认。
Login profile 不保存 Claude 账号密码。

开发

git clone <repository-url>
cd multi-ccp
npm install
npm run typecheck
npm test
npm run build

从源码运行 CLI：

npm run dev -- help

预览 npm 包内容：

npm pack --dry-run

License

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

multi-ccp

功能特性

安装

快速开始

Profile 类型

API Profiles

自定义 provider 模型

Login Profiles

Claude Code Router Profiles

历史会话同步

命令

配置目录

安全说明

开发

License