# ClaudeCodeLauncher

**Repository Path**: MeowMeowZi/ClaudeCodeLauncher

## Basic Information

- **Project Name**: ClaudeCodeLauncher
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code Launcher

> Windows 桌面 GUI 应用，专为 Claude Code 用户打造的项目启动器。一键启动、多窗口管理、状态感知通知。

<!-- 截图待补充 -->

## 简介

Claude Code Launcher 是一款基于 Tauri 2 + React 构建的 Windows 桌面应用。它将 xterm.js 终端直接内嵌在界面中，通过 ConPTY 运行 Claude Code，告别手动找文件夹、敲命令的繁琐操作。

集成 Claude Code Hooks 系统，在任务完成或需要输入时自动弹出 Windows Toast 通知，点击通知即可跳转到对应终端标签页。

**仅支持 Windows 11。**

## 功能特性

### 项目管理

- 项目列表展示：名称、路径、最近打开时间，按使用频率排序
- 星标置顶收藏，置顶项目优先显示
- 启动时自动检测路径有效性，无效项目灰显并提示重新定位
- 支持拖拽文件夹到窗口快速添加项目
- 侧边栏显示 Git 分支名称和修改状态

### 内嵌终端

- xterm.js + ConPTY 内嵌终端，无需外部窗口
- 多标签页并行运行，按项目分组管理
- WebGL 渲染，支持多款精选暗色主题切换
- 终端主题即时生效，持久保存，重启后自动恢复

### 智能通知

- 集成 Claude Code Hooks 系统，通过 HTTP 回调获取任务事件
- 任务完成 / 需要用户输入时发送 Windows Toast 通知
- 点击通知自动跳转到对应终端标签页
- 通知声音和弹窗可独立开关

### 启动项管理

- 每个项目可预设多个启动项（名称 + 命令）
- 内置默认 Claude Code 启动项（`claude`），不可删除
- 右键菜单快速选择启动项，或通过管理界面新增/编辑/删除

### 系统托盘

- 应用图标常驻系统托盘，关闭窗口改为最小化到后台
- 左键单击托盘图标打开/聚焦主窗口
- 托盘 Tooltip 显示当前运行中的终端实例数量
- 右键托盘菜单快速启动最近项目，或完全退出应用

## 截图

<!-- 截图待补充 -->

## 安装使用

### 前置条件

使用前需确保 [Claude Code CLI](https://docs.anthropic.com/zh-CN/docs/claude-code) 已安装，且 `claude` 命令在 PATH 中可用。

### 方式一：直接下载 exe（推荐）

前往 Gitee Releases 页面下载最新版本安装包：

[下载 Claude Code Launcher](https://gitee.com/MeowMeowZi/ClaudeCodeLauncher/releases)

下载 `.exe` 安装文件后直接运行安装即可。

### 方式二：从源码构建

**前置环境：**

- [Node.js](https://nodejs.org/) 18+
- [Rust](https://rustup.rs/)（含 MSVC 工具链）
- npm 或 pnpm

**构建步骤：**

```bash
git clone https://gitee.com/MeowMeowZi/ClaudeCodeLauncher.git
cd ClaudeCodeLauncher
npm install
npm run tauri build
```

构建产物位于 `src-tauri/target/release/bundle/` 目录。

## 技术栈

| 技术 | 版本 | 用途 |
|------|------|------|
| [Tauri](https://tauri.app/) | 2.10 | 桌面应用框架，提供原生 Windows 集成 |
| [React](https://react.dev/) | 19 | 前端 UI 框架 |
| TypeScript | — | 前端类型安全 |
| Rust | — | 后端逻辑，进程/PTY/通知管理 |
| [Zustand](https://zustand.pmnd.rs/) | 5 | 前端状态管理 |
| [xterm.js](https://xtermjs.org/) | — | 内嵌终端渲染，WebGL 加速 |
| ConPTY | — | Windows 原生伪终端，运行 Claude Code |
| [Tailwind CSS](https://tailwindcss.com/) | 4 | 样式框架 |

## 开发

```bash
# 启动开发环境（热更新）
npm run tauri dev

# 运行测试
npm test

# 生产构建
npm run tauri build
```

## 许可证

本项目基于 [MIT License](./LICENSE) 开源。