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.

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.

# First time opening on macOS
xattr -cr "/Applications/Claude Code Desktop.app"

Build from Source

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 的桌面可视化包装器（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 下载最新版本的 DMG 文件。

# macOS 首次打开
xattr -cr "/Applications/Claude Code Desktop.app"

从源码构建

# 克隆仓库
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)

开发命令

# 启动开发服务器
npm run tauri dev

# 构建生产版本
npm run tauri build

# 类型检查
npm run type-check

常见问题

首次打开提示"无法验证开发者"

xattr -cr "/Applications/Claude Code Desktop.app"

Pre-flight Check 超时

使用第三方模型时可能出现，应用会自动处理，无需手动干预。

许可证

MIT License

致谢

• Anthropic Claude Code - 强大的 AI 编程助手
• Tauri - 轻量级桌面应用框架