Claude Rig

claude-rig

Run multiple Claude Code configurations side by side.

问题

Claude Code将所有配置保存在一个单一的 ~/.claude/ 目录。它一直有效，直到你需要：

• 多个订阅 --您最多有2-5个帐户，每次切换时都必须注销并重新登录。无法同时运行两个订阅。
• API与订阅并列 --想要API访问一个项目，而您的Max订阅访问另一个项目？同样的交易——一个配置，一个身份验证。
• 每个项目使用不同的工具 --您的web项目需要Tailwind技能和数据库MCP服务器。您的CLI工具不需要这些。但是每个会话都加载相同的插件、MCP服务器和钩子。
• 无风险测试 --想尝试一个新的MCP服务器，而不会泄露到您的生产设置中吗？您必须禁用其他所有功能，进行测试，然后重新启用。没有隔离。

克劳德钻机是干什么的

每种配置都变得独立 钻机 --单独的设置、技能、插件、代理、命令、钩子、MCP服务器和说明。身份验证可以在不同的设备间共享，也可以单独保存。在不同的终端中并排运行它们。

# Terminal 1: your Max subscription, minimal setup
claude --rig=minimal

# Terminal 2: different Max account, full web dev stack
claude --rig=webdev

# Terminal 3: API access, experimental MCP server you're testing
claude --rig=experiment

为什么选择克劳德钻机

此空间中的大多数工具在帐户之间交换凭据文件。claude-rug隔离了整个配置，并允许您同时运行它们。

它不做什么

• 不会修改克劳德代码。 使用官方 CLAUDE_CONFIG_DIR 环境变量和 --add-dir 旗帜。没有补丁，没有叉子。
• 不管理Claude Code安装。 自己安装Claude Code——Claude设备管理其配置。
• 不会替换项目级配置。 你的项目 CLAUDE.md 和 .claude/ 仍然正常工作。Rigs处理用户级配置。
• 没有外部依赖关系。 Single Go二进制，仅限stdlib。

安装

家酿 （macOS/Linux）：

brew install edimuj/tap/claude-rig

外壳脚本 （macOS/Linux）：

curl -sSL https://raw.githubusercontent.com/edimuj/claude-rig/main/install.sh | sh

PowerShell （Windows）：

irm https://raw.githubusercontent.com/edimuj/claude-rig/main/install.ps1 | iex

去安装:

go install github.com/edimuj/claude-rig/cmd/claude-rig@latest

下载二进制文件： --macOS、Linux、Windows。

快速开始

# One-time setup
claude-rig init

# Create your first rig
claude-rig create minimal

# Or clone your existing ~/.claude/ config as a starting point
claude-rig clone default webdev --link-auth

# Launch explicitly
claude-rig launch webdev

# Or bind to a project and just run claude-rig
cd ~/projects/my-app
claude-rig rc webdev
claude-rig          # picks up the rig automatically

命令

运作原理

每个钻机都是一个完整的配置目录 ~/.claude-rig/rigs//:

~/.claude-rig/rigs/webdev/
    .claude.json            # real file (MCP servers, onboarding state)
    CLAUDE.md               # real file (rig-specific instructions)
    settings.json           # real file (rig-specific config)
    rig.json                # isolation config, synced plugins/MCP, overrides
    skills/                 # real directory
    plugins/                # real directory (synced from global by default)
    conversations/          # real dir (isolated by default)
    history.jsonl           # real file (isolated by default)
    telemetry/ -> ~/.claude/ # symlink (shared by default)
    ...

开 launch，claude-rig解析二进制（固定或磁盘上最新的），集 CLAUDE_CONFIG_DIR 在rig目录中，加载全局 ~/.claude/CLAUDE.md 通过 --add-dir，刷新符号链接，然后通过以下方式将其替换为Claude Code exec。具有不同钻机的两个实例可以同时运行而不会发生冲突。

蓝图——分享您的设置

您已花费数小时在Claude Code设置中拨号。正确的插件、MCP服务器、技能、设置、CLAUDE.md说明。然后有人问“你的设置是什么？”你什么都没有。没有导出，没有可共享的格式。你最终会手写一堵文字墙，列出所有内容。

蓝图解决了这个问题。一个命令将装备提取到便携式规范中。另一个命令从头开始重新创建。

# Extract your setup
claude-rig blueprint create my-setup --from go

# Anyone can recreate it -- from GitHub, a file, or a local directory
claude-rig blueprint apply edimuj/my-setup --link-auth

不像 export/import （创建完整的文件存档以供备份），蓝图是轻量级的规范。插件被列为安装引用，而不是二进制blob。整个过程是一个小的JSON文件，加上你编写的任何自定义技能或代理。将其推送到GitHub，你的追随者、队友或未来的自己可以在一个命令中启动你的确切设置。

你可以用蓝图做什么：

• 在社交媒体上分享你的设置——“这是我所有围棋项目使用的装备”
• 使用一个命令而不是维基页面来招募新的团队成员
• 在新机器上复制您的设置，而不记得您安装了什么
• 与博客文章或教程一起发布，以便读者可以按照您的确切配置进行操作
• 为不同类型的工作（网络、移动、数据、DevOps）保留一个蓝图库

看 docs/blueprints.md 以获取完整参考。

平台支持

• Linux --全力支持
• macOS --全力支持
• 视窗 --需要开发人员模式（用于符号链接）。看 docs/windows.md.

文档

另请查看

发展

make build                # build binary
make build-windows        # cross-compile for Windows (amd64)
make run ARGS="version"   # run without installing
make install              # install to ~/go/bin/

许可证

麻省理工学院