# claude-code-desktop

**Repository Path**: prja/claude-code-desktop

## Basic Information

- **Project Name**: claude-code-desktop
- **Description**: Claude Code Desktop - local AI coding assistant (FastAPI + React + LangGraph)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 🚀 Claude Code Desktop 项目快速理解指南

根据对仓库核心文件的分析，以下是项目的关键信息整理：

### ✅ 结论

这是一个 **基于 Electron + FastAPI 的桌面端 AI 代码助手**，采用前后端分离架构，通过 Agent 模式调用大语言模型（LLM）实现智能代码交互。

---

### ✅ 依据

基于以下文件分析：
- `docker-compose.yml`：服务编排定义
- `.env.example`：环境变量模板
- `backend/requirements.txt`：后端依赖
- `frontend/package.json`：前端技术栈

---

### ✅ 项目架构解析

#### 🔧 技术栈总览

| 层级 | 技术选型 | 说明 |
|------|---------|------|
| **桌面容器** | Electron 33.x | 跨平台桌面应用 |
| **前端 UI** | React 18 + Vite + TypeScript | 现代化前端框架 |
| **状态管理** | Zustand 4.x | 轻量级状态管理 |
| **Markdown 渲染** | react-markdown | 聊天内容展示 |
| **后端框架** | FastAPI + Uvicorn | 高性能异步 API |
| **AI 框架** | LangChain + LangGraph | Agent 工作流编排 |
| **向量数据库** | ChromaDB | 本地向量检索 |
| **缓存/消息** | Redis 7 | 状态共享与任务队列 |
| **持久化** | SQLite (SQLAlchemy) | 本地数据存储 |

#### 🏗️ 服务架构

```
┌─────────────────────────────────────────────┐
│              Electron Desktop               │
│  ┌─────────────┐    ┌──────────────────┐    │
│  │   Frontend  │◄──►│   API Server     │    │
│  │ (React/Vite)│    │   (FastAPI :8000)│    │
│  └─────────────┘    └────────┬─────────┘    │
└──────────────────────────────┼──────────────┘
                               │
              ┌────────────────┼──────────────┐
              ▼                ▼              ▼
         ┌─────────┐    ┌──────────┐   ┌──────────────┐
         │  Redis  │    │ ChromaDB │   │ Agent Worker │
         │  :6379  │    │  :8001   │   │   (Python)   │
         └─────────┘    └──────────┘   └──────────────┘
```

#### 📁 模块职责

| 模块 | 路径 | 核心职责 |
|------|------|---------|
| **api_server** | `backend/api_server/` | 对外提供 REST API，处理前端请求 |
| **agent_worker** | `backend/agent_worker/` | LLM Agent 工作进程，执行代码分析任务 |
| **shared** | `backend/shared/` | 前后端/服务间共享的数据模型与工具 |
| **frontend/src** | `frontend/src/` | 前端页面与组件逻辑 |
| **frontend/electron** | `frontend/electron/` | Electron 主进程配置 |

#### 🔑 支持的 LLM 提供商

- **DeepSeek** (`deepseek-chat` 模型)
- **DashScope/阿里云** (`qwen-max-2025-01-25` 模型)
- **HappyHorse**（预留接口）

---

### ✅ 关键配置说明

**聊天模式** (`CHAT_MODE`):
- `agent` 模式：通过 Redis → Worker 异步执行（默认）
- `direct` 模式：进程内直接调用 LLM

**数据持久化**:
- 数据库：`/data/claude_desktop.db` (SQLite)
- Chrome 会话：`/data/chroma_persist/`

**开发模式启动**:
bash
```
# 前端
npm run electron:dev

# 后端 (Docker)
docker-compose up
```

---

### ✅ 建议

1. **快速上手**：将 `.env.example` 复制为 `.env`，填入至少一个 LLM 的 API Key，然后运行 `docker-compose up` 即可启动后端服务
2. **如需深入某个模块**：可以告诉我具体想了解哪个部分（如 Agent 工作流、前端组件、API 路由等），我会进一步分析源码
3. **README 缺失**：当前 README.md 为空，如需生成项目文档，我可以协助创建