5 分钟上手 claude-sneakpeek:快速创建你的第一个隔离 Claude Code 变体

原创2026-10-14 20:54:511,630 阅读

5 分钟上手 claude-sneakpeek:快速创建你的第一个隔离 Claude Code 变体

claude-sneakpeek 是一款开源的 Claude Code 变体管理器:一条 npx 命令就能创建完全隔离的 Claude Code 变体——独立的配置、会话、MCP 服务器与凭据,还能解锁 swarm mode 等尚未公开发布的 feature-flag 能力,且完全不影响你现有的 Claude Code 安装。

claude-sneakpeek 隔离 Claude Code 变体管理器:TUI 交互向导首页菜单

🤔 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:为你的变体接上不同的模型

claude-sneakpeek 选择 Provider 界面:为隔离 Claude Code 变体选择 Z.ai、MiniMax、OpenRouter 等模型网关

进入 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 统一注册:

claude-sneakpeek 隔离变体的品牌主题:Z.ai、MiniMax、OpenRouter、CCRouter 启动画面

✅ 第三步:启动并验证

安装完成后,直接用变体命令启动:

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 的文档索引继续探索。

登录后查看全文
claude-sneakpeek