Claude-profiles

claude-profiles

Swap Claude Code configurations in one command

Quick Start • Commands • Auto-Switching • npm • Discussions

______________________________________________________________________

克劳德简介 允许您维护多个Claude Code配置并立即在它们之间切换。不同的插件、钩子、MCP服务器和不同工作流的设置——没有冲突。

npm install -g claude-profiles

一个命令。你的 ~/.claude 自动成为默认配置文件。不需要安装向导。

为什么？

快速开始

# Install (that's it — shell hook + slash commands auto-configured)
npm install -g claude-profiles

# Create a work profile
claude-profiles create work

# Switch to it
claude-profiles use work
# >>> RESTART CLAUDE CODE /`.切换直接在内部交换配置文件 `~/.claude` --没有环境变量，没有符号链接。

~/.claude/ # Create profile (clones ~/.claude) claude-profiles use # Switch profile claude-profiles list # List all profiles (* = active) claude-profiles current # Show active profile claude-profiles delete # Delete a profile claude-profiles toggle plugin on|off # Toggle plugin per profile claude-profiles init # Guided setup (optional) claude-profiles uninstall # Clean removal

### 克劳德代码内部

这些斜线命令直接在Claude Code会话中工作：

/profiles # List profiles + show available commands /profiles-list # List all profiles (* = active) /profiles-use # Switch profile /profiles-create - # Create a new profile /profiles-current # Show active profile /profiles-delete # Delete a profile /profiles-configure # Toggle plugins in the active profile

无需离开Claude代码——内置的钩子会立即执行命令并显示结果。

## 示例：工作vs个人

Create separate profiles

claude-profiles create work -d "Work — Vercel + Jira MCP servers" claude-profiles create personal -d "Personal — minimal plugins"

Configure each profile

claude-profiles use work

>>> RESTART CLAUDE CODE >> RESTART CLAUDE CODE .claude-profile

当你 `cd` 在该目录中，shell钩子会自动切换。Leave--恢复默认值。

喜欢 `.nvmrc` 适用于Node.js版本，但适用于Claude Code配置。

### 分辨率链

1. `CLAUDE_PROFILES_ACTIVE` env-var（最高优先级）
1. `.claude-profile` 文件（沿目录树向上移动）
1. 活动配置文件来自 `state.json`
1. 退路： `default` (`~/.claude`)

## 安装/卸载

Install — one command, everything configured

npm install -g claude-profiles

Uninstall — asks which profile to keep, cleans everything

claude-profiles uninstall npm uninstall -g claude-profiles

自动安装：

- 增加 `/profiles-*` Claude代码的斜线命令
- 安装外壳挂钩 `.zshrc`/`.bashrc`/`config.fish` （自动打开 `cd`)
- 注册一个快速执行钩子（因此 `/profiles-list` 在1秒内响应）
- 为添加自动批准权限 `claude-profiles` 命令

卸载会删除上述所有内容。 `~/.claude` 永远不会被修改。

What profiles isolate

每个配置文件都有自己的：

- `settings.json` --插件、钩子、权限、模型首选项
- `mcp.json` --MCP服务器配置
- `CLAUDE.md` --自定义说明
- `commands/` --斜线命令
- `settings.local.json` --本地覆盖

在所有配置文件中共享：

- 插件缓存（下载的文件）
- 项目/会话数据
- 身份验证凭据
- 自动内存（中的每个项目 `~/.claude/projects/`，不按配置文件）

Shell integration details

shell钩子在安装时使用conda风格的哨兵注释自动添加：

>>> claude-profiles >>>

!! Contents within this block are managed by claude-profiles !!

_claude_profiles_hook() { ... }

#

Design influences

• Python 版本管理器 --解析链（环境变量>文件>默认值）
• direnv --自动开启 cd
• 非易失性存储器 — .nvmrc 惯例
• 康达 --shell配置的哨兵注释
• Codex CLI --配置文件覆盖

相关

• --对原生Claude Code配置文件的功能请求
• Codex CLI配置文件 --OpenAI的方法

贡献

看 贡献.md.PR欢迎。

许可证

麻省理工学院