Claude Code Launcher

克劳德代码启动器

基于终端的启动器 克劳德代码 其提供用于选择和启动MCP（模型上下文协议）服务器配置的交互式界面。

概述

Claude Code Launcher是一个基于Go的TUI（终端用户界面）应用程序，它简化了使用不同MCP服务器配置启动Claude Code的过程。而不是手动指定 --mcp-config 标志，此工具会自动发现您的MCP配置文件，并在交互式选择菜单中显示它们。

特性

• 🔍 自动发现：扫描 .claude/mcp/ JSON配置文件目录
• 🎯 交互选择：使用干净的TUI界面选择要启动的MCP服务器
• ⚡ 智能默认值：如果找不到MCP配置，则直接启动Claude Code
• 🎨 漂亮的界面：采用泡泡茶打造，打造流畅的终端体验

平台支持

此工具目前仅支持macOS。

启动器使用Unix系统调用(syscall.Exec)用Claude Code完全替换启动器进程，确保干净的进程管理和正确的终端处理。这种方法可以防止进程暂停（Ctrl+C）的问题，并提供最流畅的用户体验，但在Windows上不可用。

安装

先决条件

• macOS （必填）
• 上涨1.18或更高
• 已安装Claude Code CLI(claude 命令可用）

从源代码安装

# Clone the repository
git clone https://github.com/yourusername/claude-code-launcher.git
cd claude-code-launcher

# Install the binary to $GOPATH/bin
go install

# The command 'cc-launcher' should now be available globally

确保 $(go env GOPATH)/bin 在你的路径。您可以通过以下方式进行验证：

echo $PATH | grep -q "$(go env GOPATH)/bin" && echo "✓ GOPATH/bin is in PATH" || echo "✗ Add $(go env GOPATH)/bin to PATH"

如果它不在PATH中，请将其添加到shell配置文件中(~/.bashrc, ~/.zshrc等等）：

export PATH="$PATH:$(go env GOPATH)/bin"

用法

只需从任何目录运行启动器：

cc-launcher

工作流程

1. 启动器扫描中的MCP配置文件 .claude/mcp/*.json
2. 如果找到MCP文件，您将看到一个交互式菜单：

- 使用箭头键导航 - 按 Space 选择/取消选择配置 - 按 Enter 使用选定的配置启动Claude Code - 按 q 或 Ctrl+C 退出

1. 如果找不到MCP文件，Claude Code将直接启动

示例

$ cc-launcher

Select MCP configurations to launch:
  [ ] taskmaster.json
  [x] shadcn-ui.json
  [ ] context7.json
  [ ] No mcp servers

Press Space to select, Enter to launch, q to quit

MCP配置

将MCP服务器配置文件放在 .claude/mcp/ 相对于当前工作目录的目录。每个配置都应该是一个有效的JSON文件。

示例结构：

.claude/
└── mcp/
    ├── taskmaster.json
    ├── shadcn-ui.json
    └── context7.json

发展

从源头构建

# Build the binary
make build

# Run directly without building
make run

# Clean build artifacts
make clean

可用目标：

• make build -构建应用程序二进制文件(cc-launcher)
• make clean -删除构建工件
• make run -直接运行应用程序，无需构建

依赖项

• 珍珠奶茶 -TUI框架
• 泡泡 -TUI组件
• 唇彩 -终端造型

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。