5 分钟上手 claude-sneakpeek:快速创建你的第一个隔离 Claude Code 变体
5 分钟上手 claude-sneakpeek:快速创建你的第一个隔离 Claude Code 变体
claude-sneakpeek 是一款开源的 Claude Code 变体管理器:一条 npx 命令就能创建完全隔离的 Claude Code 变体——独立的配置、会话、MCP 服务器与凭据,还能解锁 swarm mode 等尚未公开发布的 feature-flag 能力,且完全不影响你现有的 Claude Code 安装。
🤔 claude-sneakpeek 是什么?
一句话:给 Claude Code 装一套"平行宇宙"。它为每个变体(variant)安装一份独立的 Claude Code,互不干扰。
- 🔐 完全隔离:独立的 config、sessions、MCP servers、credentials,你正在用的 Claude Code 纹丝不动
- ⚡ 解锁隐藏能力:swarm mode(原生多智能体编排)、delegate mode(后台代理)、team coordination(团队协作)
- 🌐 多 Provider 支持:Z.ai、MiniMax、OpenRouter、本地模型(ccrouter),也有纯血 Claude 的 mirror 模式
变体名称就是命令名:创建为
claudesp的变体,之后直接敲claudesp即可启动。
🚀 第一步:一键安装隔离变体(约 30 秒)
最快的路径是 quick 命令,一条命令完成"选 Provider → 装包 → 生成启动器"全流程:
npx @realmikekelly/claude-sneakpeek quick --name claudesp
--name claudesp:指定变体名,它将同时成为你的 CLI 命令- 默认安装到
~/.claude-sneakpeek/claudesp/,启动器脚本放在~/.local/bin/claudesp
如果系统提示找不到 claudesp,把 ~/.local/bin 加入 PATH 即可(macOS/Linux):
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
📖 完整安装说明见 README.md。
🖥️ 第二步:进入交互式 TUI 向导
不带参数直接运行,会进入基于 Ink/React 的终端交互向导(TUI 源码位于 src/tui/screens/HomeScreen.tsx):
npx @realmikekelly/claude-sneakpeek
首页提供 Quick Setup(30 秒配好 Provider + API key)、Manage Variants(管理已有变体)、Update All(批量升级)、Diagnostics(健康检查)等入口,↑↓ 导航、↵ 确认、Esc 返回。
选择 Provider:为你的变体接上不同的模型
进入 Quick Setup 后,向导会列出可选的 API 网关,各 Provider 差异一目了然:
| Provider | 模型 | 认证方式 | 适用场景 |
|---|---|---|---|
mirror |
Claude(原生) | OAuth / API Key | 纯血 Claude 体验,推荐首选 |
zai |
GLM-4.7 | API Key | Z.ai Coding Plan 订阅 |
minimax |
MiniMax-M2.1 | API Key | MiniMax Cloud 订阅 |
openrouter |
自选 | Auth Token | 想换其他模型 |
ccrouter |
本地 LLM | 可选 | 本地模型路由 |
各 Provider 的详细对比与配置方法见 docs/providers.md;纯 Claude 的 mirror 模式详解见 docs/features/mirror-claude.md。
🎨 每个 Provider 都有自己的品牌主题
不同 Provider 的变体启动时会显示专属 ASCII 品牌主题(金色 Z.ai、珊瑚色 MiniMax、青色 OpenRouter、天蓝色 CCRouter),由 src/brands/index.ts 统一注册:
✅ 第三步:启动并验证
安装完成后,直接用变体命令启动:
claudesp
如果一切正常,你会看到品牌启动画面和全新的 Claude Code 会话。想做一次全面体检,可以运行 doctor 命令检查所有变体:
npx @realmikekelly/claude-sneakpeek doctor
📁 变体文件都在哪里?
每个变体都"住"在自己的目录里,管理起来非常清晰:
~/.claude-sneakpeek/claudesp/
├── npm/ # 该变体专属的 Claude Code(npm 包)
├── config/ # 隔离的 config、sessions、MCP servers
└── variant.json # 变体元数据
~/.local/bin/claudesp # 启动器(wrapper)脚本
变体内部的目录结构与构建流程细节,可参考架构文档 docs/architecture/overview.md;创建过程由 src/core/variant-builder/ 下的步骤化构建器(安装 npm 包 → 写配置 → 应用主题 → 生成 wrapper)自动完成,无需手工干预。
🔄 常用管理命令速查
| 命令 | 作用 |
|---|---|
npx @realmikekelly/claude-sneakpeek update claudesp |
将变体升级到最新版 Claude Code |
npx @realmikekelly/claude-sneakpeek remove claudesp |
删除变体(不影响其他变体) |
npx @realmikekelly/claude-sneakpeek tweak claudesp |
打开 tweakcc 自定义主题 |
npx @realmikekelly/claude-sneakpeek doctor |
健康检查所有变体 |
💡 想继续折腾外观和系统提示词?主题定制指南在 docs/TWEAKCC-GUIDE.md。
❓ 新手常见问题
会不会影响我现有的 Claude Code?
不会。每个变体拥有完全独立的 npm 安装与配置目录,wrapper 通过 CLAUDE_CONFIG_DIR 环境变量指向自己的配置,互不串扰。
怎么让不同项目用不同的模型?
再建一个变体即可,例如给本地模型建一个 ccrouter 变体、给 Claude 原生建一个 mirror 变体,各自独立启动。
想体验多智能体功能? swarm mode、delegate mode 等 feature-flag 能力是变体的核心卖点之一,创建变体后即可在会话中尝试。
🎉 至此,你已经在 5 分钟内拥有了第一个隔离的 Claude Code 变体:一行命令安装、TUI 向导配置、独立目录管理。更多功能(团队协作模式、Prompt Pack 等)可以从 docs/README.md 的文档索引继续探索。


