# ClaudeCodeCLI-Web

**Repository Path**: laory/claude-code-cli-web

## Basic Information

- **Project Name**: ClaudeCodeCLI-Web
- **Description**: 通过网页界面控制本地 Claude Code CLI 和文件系统。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-16
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Web Controller

通过网页界面控制本地 Claude Code CLI 和文件系统。

## 功能特性

- 💬 **聊天** - 与 Claude 对话，支持流式输出
- 📁 **文件浏览器** - 浏览、创建、删除、重命名文件
- 🖥️ **终端** - 执行系统命令
- ℹ️ **系统信息** - 查看系统状态和切换工作目录
- 📱 **移动端适配** - 支持手机浏览器访问
- 🎤 **语音输入** - 支持语音识别输入

## 系统要求

- Node.js 16+
- Claude Code CLI 已安装并配置

## 安装

```bash
# 克隆项目
git clone git@gitee.com:laory/claude-code-cli-web.git
cd web-controller

# 安装依赖
npm install
```

## 启动

```bash
# 启动服务器
npm start
```

访问 **http://localhost:3005**

## 环境变量（可选）

如果需要指定 API Key，可以设置环境变量：

**Windows (PowerShell):**
```powershell
$env:ANTHROPIC_API_KEY="your-api-key"
```

**macOS/Linux:**
```bash
export ANTHROPIC_API_KEY="your-api-key"
```

## 文件结构

```
web-controller/
├── server.js          # 后端服务器
├── public/
│   └── index.html     # 前端页面
├── package.json
├── .gitignore
└── README.md
```

## 安全说明

⚠️ **重要提示**

- 文件操作被限制在启动目录内
- 终端功能可执行任意系统命令
- **不要**在公网环境中暴露此服务
- 仅在受信任的本地网络中使用

## 浏览器兼容性

| 浏览器 | 支持情况 |
|--------|----------|
| Chrome | ✅ 完整支持 |
| Edge | ✅ 完整支持 |
| Safari | ✅ 完整支持 |
| Firefox | ✅ 完整支持 |

**语音输入功能**需要 Chrome、Edge 或 Safari 浏览器。

## 使用说明

### 聊天
- 在输入框中输入消息，按 `Ctrl + Enter` 或点击发送按钮发送
- 点击麦克风按钮可使用语音输入
- 点击"新建对话"可清空当前对话历史

### 文件管理
- 浏览目录：点击文件夹进入
- 返回上级：点击 `..` 或返回按钮
- 新建文件/文件夹：点击对应按钮
- 重命名/删除：鼠标悬停在文件上，点击右侧操作按钮

### 切换工作目录
1. 点击侧边栏"系统信息"
2. 点击"切换目录"按钮
3. 选择或输入目标目录路径

### 移动端使用
- 点击左上角菜单按钮打开侧边栏
- 其他功能与桌面端相同

## 技术栈

- **后端**: Node.js, Express.js
- **前端**: 原生 JavaScript, CSS
- **语音识别**: Web Speech API

## License

MIT