# claude-code-desktop
**Repository Path**: Top_hr/claude-code-desktop
## Basic Information
- **Project Name**: claude-code-desktop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Claude Code Desktop
Claude Code CLI 的桌面可视化包装器
A Desktop GUI Wrapper for Claude Code CLI
功能特性 •
安装 •
快速开始 •
配置 •
开发
English •
中文
---
## English
### Introduction
**Claude Code Desktop** is a desktop GUI wrapper for Anthropic's [Claude Code CLI](https://docs.anthropic.com/claude-code).
It preserves all native capabilities of Claude Code CLI while providing a user-friendly graphical interface, making it easy for users unfamiliar with command-line tools to enjoy the power of AI programming assistants.
### Core Philosophy
- **Preserve Native Capabilities**: Pass through CLI commands, not re-implement
- **Lower the Barrier**: Click-to-use graphical interface
- **Enhanced Experience**: Context management, memory, system prompts, and more
### Features
- ✅ **Multi-session Management** - Multiple tabs with independent sessions
- ✅ **Session Recovery** - Auto-restore conversation context after restart
- ✅ **Multi-model Support** - Anthropic, Zhipu AI, DeepSeek, Kimi, MiniMax, Custom
- ✅ **Connection Testing** - One-click API connectivity test
- ✅ **System Prompts** - Built-in defaults + customizable + one-click reset
- ✅ **User Memory** - Record preferences, let AI understand you better
- ✅ **Working Directory** - Visual directory selection
- ✅ **Built-in Runtime** - Bundled Node.js, ready out of the box
- ✅ **Auto Permission Mode** - Execute operations without confirmation prompts
### Supported Model Providers
| Provider | Default Model | Status |
|----------|---------------|--------|
| Anthropic | claude-sonnet-4-* | Official |
| Zhipu AI | glm-4.6 | ✅ |
| DeepSeek | deepseek-chat | ✅ |
| Kimi | kimi-k2-turbo-preview | ✅ |
| MiniMax | MiniMax-M2 | ✅ |
| Custom | User configured | ✅ |
### Installation
Download the latest DMG file from [Releases](https://github.com/xxx/claude-code-desktop/releases).
```bash
# First time opening on macOS
xattr -cr "/Applications/Claude Code Desktop.app"
```
### Build from Source
```bash
git clone https://github.com/xxx/claude-code-desktop.git
cd claude-code-desktop
npm install
npm run tauri dev # Development
npm run tauri build # Production build
```
### Quick Start
1. **Launch the app** - Claude CLI will be auto-installed on first run
2. **Configure authentication** - Login with Anthropic account or enter API Key
3. **Select working directory** - Set the directory Claude can read/write
4. **Start chatting** - Enter your programming requests, let AI help you code
### Tech Stack
- **Frontend**: React 18 + TypeScript + Tailwind CSS + Zustand
- **Backend**: Rust + Tauri 2.0
- **Database**: SQLite (rusqlite)
- **Build Tools**: Vite 6.0 + Tauri CLI
### Requirements
- macOS 12+ (currently macOS only, ARM64)
- Node.js 18+ (for development)
- Rust 1.70+ (for development)
### License
MIT License
---
## 简介
**Claude Code Desktop** 是 Anthropic [Claude Code CLI](https://docs.anthropic.com/claude-code) 的桌面可视化包装器（Wrapper）。
它保留了 Claude Code CLI 的所有原生能力，同时提供更友好的图形界面，让不熟悉命令行的用户也能轻松使用 AI 编程助手。
### 核心理念
- **保留原生能力**：不重新实现 CLI 功能，而是透传和可视化
- **降低使用门槛**：图形化界面，点击即用
- **增强用户体验**：上下文管理、记忆、系统提示词等增强功能
## 功能特性
### 已实现
- ✅ **多会话管理** - 支持多标签页，会话独立运行
- ✅ **会话恢复** - 重启应用后自动恢复对话上下文
- ✅ **多模型支持** - 智谱 AI、DeepSeek、Kimi、MiniMax、自定义
- ✅ **连通性测试** - 一键测试 API 连接状态
- ✅ **系统提示词** - 内置默认 + 可自定义 + 一键重置
- ✅ **用户记忆** - 记录个人偏好，让 AI 更懂你
- ✅ **工作目录管理** - 可视化选择工作目录
- ✅ **内置运行环境** - 内置 Node.js，开箱即用
- ✅ **自动权限模式** - 无需逐一确认，自动执行操作
### 支持的模型厂商
| 厂商 | 默认模型 | 状态 |
|------|----------|------|
| Anthropic | claude-sonnet-4-* | 官方 |
| 智谱 AI | glm-4.6 | ✅ |
| DeepSeek | deepseek-chat | ✅ |
| Kimi | kimi-k2-turbo-preview | ✅ |
| MiniMax | MiniMax-M2 | ✅ |
| 自定义 | 用户配置 | ✅ |
## 安装
### 下载安装
从 [Releases](https://github.com/xxx/claude-code-desktop/releases) 下载最新版本的 DMG 文件。
```bash
# macOS 首次打开
xattr -cr "/Applications/Claude Code Desktop.app"
```
### 从源码构建
```bash
# 克隆仓库
git clone https://github.com/xxx/claude-code-desktop.git
cd claude-code-desktop
# 安装依赖
npm install
# 开发模式
npm run tauri dev
# 构建生产版本
npm run tauri build
```
> **说明**：仓库已包含内置 Node.js 运行时（macOS ARM64），开箱即用。
## 快速开始
1. **启动应用** - 首次启动会自动安装 Claude CLI
2. **配置认证** - 选择 Anthropic 账号登录或输入 API Key
3. **选择工作目录** - 设置 Claude 可以读写的项目目录
4. **开始对话** - 输入你的编程需求，让 AI 帮你写代码
## 配置
### 认证方式
- **Anthropic 账号登录** - 通过浏览器授权
- **API Key** - 直接输入 Anthropic API Key
- **第三方模型** - 配置其他厂商的 API Key
### 系统提示词
在设置 → 提示词中可以自定义系统提示词，设定 Claude 的行为方式。
### 用户记忆
在设置 → 提示词 → 记忆中记录你的偏好：
- 编程语言和框架
- 代码风格偏好
- 项目特定信息
## 技术栈
- **前端**：React 18 + TypeScript + Tailwind CSS + Zustand
- **后端**：Rust + Tauri 2.0
- **数据库**：SQLite (rusqlite)
- **构建工具**：Vite 6.0 + Tauri CLI
## 项目结构
```
claude-code-desktop/
├── src/ # 前端代码
│ ├── components/ # React 组件
│ ├── stores/ # Zustand 状态管理
│ ├── lib/ # 工具函数
│ └── types/ # TypeScript 类型
├── src-tauri/ # 后端代码
│ ├── src/
│ │ ├── commands/ # Tauri 命令
│ │ ├── services/ # 业务逻辑
│ │ └── models/ # 数据模型
│ └── resources/
│ ├── node/ # 内置 Node.js 运行时
│ ├── hooks/ # Claude CLI Hooks
│ └── scripts/ # 辅助脚本
└── docs/ # 文档
```
## 开发
### 环境要求
- Node.js 18+
- Rust 1.70+
- macOS 12+ (当前仅支持 macOS)
### 开发命令
```bash
# 启动开发服务器
npm run tauri dev
# 构建生产版本
npm run tauri build
# 类型检查
npm run type-check
```
## 常见问题
### 首次打开提示"无法验证开发者"
```bash
xattr -cr "/Applications/Claude Code Desktop.app"
```
### Pre-flight Check 超时
使用第三方模型时可能出现，应用会自动处理，无需手动干预。
## 许可证
MIT License
## 致谢
- [Anthropic Claude Code](https://docs.anthropic.com/claude-code) - 强大的 AI 编程助手
- [Tauri](https://v2.tauri.app) - 轻量级桌面应用框架