cc-profiles（Claude Code 多 Profile 切换与共享管理） Skill 技能

技能简介

cc-profiles 是一款零依赖、本地化的 Web UI 工具，专门用于在一台机器上同时管理多个 Claude Code 配置（profile），支持项目与记忆在 profile 间搬移、Skill/MCP 服务器共享、设置集中编辑、所有操作可撤销。开发者常常需要为工作 / 副业 / 客户 / 演示分别维护独立的 Claude Code 配置，cc-profiles 把这套繁琐操作变成一键点击。完全 Python 3.9+ 标准库实现，无第三方包依赖，开箱即用。

核心能力

1. 多 Profile 统一管理：在同一台机器上同时挂载 Default、Work、Client、Side Project 等多个 Claude Code profile，互不干扰。
2. 项目一键搬移：把项目从 profile A 拖到 profile B，自动同步 conversation、记忆、Skill、MCP 服务器配置。
3. Skill 与 MCP 共享：勾选 Skill 或 MCP 服务器在多个 profile 间共享，避免每次切换都要重新安装。
4. 设置集中编辑：可视化编辑 settings.json、MCP 服务器、permission rules 等，避免手动改 JSON 出错。
5. 全操作可撤销：任何迁移、共享、设置变更都生成可回滚的快照，记录操作前后的差异。
6. 零依赖：仅依赖 Python 标准库，无第三方依赖，体积小、可审计、易分发。

安装配置

1. 安装：pip install cc-profiles，完成后 cc-profiles CLI 可用。
2. 启动 Web UI：cc-profiles 默认启动本地服务并打开浏览器；也可加上 --host 0.0.0.0 --port 8765 暴露给同网段其他设备。
3. 首次使用：UI 会扫描 ~/.claude/ 目录发现已有 profile，自动导入。
4. 数据目录：所有元数据存放于 ~/.cc-profiles/，含 profiles.db、snapshots/、logs/。
5. 多 Profile 切换：UI 中点击目标 profile 即切换 Claude Code 当前激活配置，下次启动 Claude Code 自动应用。

使用步骤

1. 启动 cc-profiles，浏览器进入 http://127.0.0.1:8765。
2. 在左侧 Profile 列表里点击"+"新增 profile（如 Work、Client）。
3. 把现有项目从 Default 拖到 Work profile，UI 会显示被同步的资源（conversation、memory、Skill、MCP）。
4. 在共享 Skill 列表里勾选要在 Work profile 中可见的 Skill，保存后自动写入 ~/.claude.json。
5. 在 Settings 标签页编辑 permission rules、theme、env 等设置，所有修改生成可撤销的快照。
6. 需要恢复某个变更时，进入 Snapshots 标签页选择历史快照并回滚。
7. 关闭 UI 不影响已生效的配置，下次启动恢复上次会话状态。

适用场景

• 多客户自由职业者：为每个客户维护独立的 Claude Code profile（记忆 / Skill / MCP 完全隔离）。
• 双职工/在职副业：在 Work 与 Side Project profile 之间快速切换，避免工作记忆混入副业项目。
• 咨询顾问演示：演示前临时切换到 Demo profile（屏蔽敏感 Skill 与记忆）。
• 团队 Lead 标准化：为团队成员预置多个共享 Skill 模板，一键应用到目标 profile。
• 个人效率实验：尝试不同 Skill 组合，用快照功能随时回退到上一组好用的 Skill 配置。

适用人群

• 同时维护多个项目并行/AI 编程助手频繁切换的独立开发者。
• 为不同客户/雇主使用 Claude Code 的外包/咨询工程师。
• 在工作与个人项目共用同一台电脑、担心记忆交叉污染的工程师。
• 团队内部需要统一 Skill/MCP 配置的 Tech Lead。

工作原理

cc-profiles 是一个本地 Web 服务，前端使用 HTML5/CSS/原生 JavaScript（无框架），后端基于 Python 3.9+ 标准库（http.server/sqlite3/pathlib）。它把 Claude Code 配置目录 ~/.claude/ 与 ~/.claude.json 视作数据源：扫描得到现有 profile 列表、对每个 profile 的 settings.json、conversation 历史、记忆文件、Skill 与 MCP 列表建立 SQLite 索引；UI 中的拖拽操作触发文件级 cp/symlink 调整，并在执行前后生成差异快照到 ~/.cc-profiles/snapshots/，任何变更都能一键回滚；同时把勾选共享的 Skill / MCP 写入目标 profile 的 ~/.claude.json mcpServers 字段，做到"在 UI 里勾选 = Claude Code 立刻可用"。

官方链接

• PyPI：https://pypi.org/project/cc-profiles/
• 文档：https://cc-profiles.andreaia.com
• 仓库：https://github.com/andreaiannarone/cc-profiles
• Issues：https://github.com/andreaiannarone/cc-profiles/issues