1. 项目定位与用途
CloudCLI 是一个桌面和移动端 Web UI，专为 Claude Code、Cursor CLI、Codex 和 Gemini-CLI 等 AI 编程助手设计。它允许用户本地或远程查看和管理活跃的项目与会话，提供统一的图形化界面来操作这些命令行工具，降低使用门槛并提升移动端可用性。核心功能包括交互式聊天、集成终端、文件浏览器、Git 操作、会话管理和插件扩展，既可通过 CloudCLI Cloud 服务免费用，也支持自托管部署。
项目档案应用项目
CloudCLI 开源 Web UI：远程管理 Claude Code/Cursor 会话，支持桌面移动端，npm 快速安装
CloudCLI 是免费开源 Web 界面，用于远程管理 Claude Code、Cursor CLI、Codex 和 Gemini 等 AI 编程助手的会话与项目。提供响应式设计、集成终端、文件浏览器和 Git 操作，支持 npm 安装或云端服务访问，适合开发者在多设备上无缝使用 AI 编程工具。
AI 总结
CloudCLI 是一个开源 Web UI，用于远程管理 Claude Code、Cursor CLI 等 AI 编程助手的会话与项目，提供响应式界面、集成终端和文件浏览器，支持桌面与移动端无缝访问。
中文项目介绍
CloudCLI（又名 Claude Code UI）是一个免费的开放源码 Web 界面，旨在让用户通过浏览器或移动设备远程管理 Claude Code、Cursor CLI、Codex 和 Gemini-CLI 等 AI 编程助手的会话与项目。它解决了传统命令行界面无法远程访问、多设备间会话同步困难以及统一管理多个项目 Git 状态的痛点。
适用场景包括：在任何设备上通过网页访问 AI 编程助手；集中查看和管理多个项目的代码变更与历史；利用插件系统扩展自定义功能集成；以及通过 TaskMaster AI 进行高级项目管理。
从技术实现看，CloudCLI 采用前后端分离架构：前端基于 React 和 Vite，运行于 5173 端口，提供响应式聊天界面、文件树、Git 操作等组件；后端基于 Express 和 TypeScript，运行于 3001 端口，通过适配器层集成各 CLI 工具，并使用 SQLite 数据库持久化会话数据，WebSocket 实现交互式终端。
详细信息与使用说明
2. 解决的问题
传统 AI 编程助手的命令行界面存在三大问题：无法远程访问，必须在本机终端使用；多设备间会话不同步，难以在手机、平板和电脑间无缝切换；管理多个项目的 Git 状态和会话历史分散且低效。CloudCLI 通过 Web 界面集中解决这些问题，支持从任何设备通过浏览器连接，自动发现本地会话，并提供统一的项目视图和操作面板，让开发者随时随地继续编码任务。
3. 适用场景
主要适用场景包括：1) 远程开发：通过浏览器或移动设备访问本机或服务器的 AI 编程会话；2) 跨设备协作：在桌面、平板、手机上无缝继续之前的对话和任务；3) 项目管理：集中查看多个项目的文件结构、Git 分支和提交历史；4) 插件扩展：通过插件系统添加自定义功能，如集成第三方服务或新工具标签页；5) 团队共享：结合 CloudCLI Cloud 服务，实现容器化开发环境的共享访问。
4. 安装方式
仓库中明确给出三种安装方式：1) npm 全局安装：运行 `npm install -g @cloudcli-ai/cloudcli`，然后执行 `cloudcli` 启动；2) npx 临时运行：使用 `npx @cloudcli-ai/cloudcli` 无需安装即可试用；3) Docker 沙箱（实验性）：运行 `npx @cloudcli-ai/cloudcli@latest sandbox ~/my-pro` 在隔离环境中启动 agents。此外，推荐使用 CloudCLI Cloud 服务（https://cloudcli.ai）免去本地配置。注意：npm 方式需要 Node.js v22+。
5. 使用方式
安装后，执行 `cloudcli` 命令启动服务，默认在 http://localhost:3001 提供 Web 界面。前端开发服务器运行在 5173 端口，通过 Vite 代理转发 API 和 WebSocket 请求到后端。界面会自动发现本地现有会话和项目，用户可通过下拉菜单选择 Claude Code、Cursor CLI、Codex 或 Gemini 等 CLI 工具，进入聊天界面发送指令，使用集成终端执行命令，通过文件浏览器编辑代码，并利用 Git 浏览器进行分支切换和提交操作。开发模式下可使用 `npm run dev` 同时启动前后端。
6. 补充说明或实现特点
CloudCLI 采用模块化全栈设计：前端为 React 单页应用，使用 CodeMirror 实现代码编辑，xterm.js 提供终端体验；后端为 Express 服务，通过适配器模式集成各 CLI 工具（位于 server/providers/），统一消息处理接口。数据持久化使用 SQLite，结合 bcrypt 加密密码和 JWT 令牌认证。插件系统支持动态加载，可扩展新标签页和后端路由。项目支持多语言 README 和 PWA 功能，可通过 `npm run build` 构建生产版本。注意：Docker 沙箱功能依赖 `sbx` CLI，且为实验性特性。
思维导图
CloudCLI
前端 UI
React + Vite
响应式设计
聊天界面
文件浏览器
Git 操作
后端服务
Express + TypeScript
REST API
WebSocket 终端
SQLite 数据库
CLI 适配器
Claude Code
Cursor CLI
Codex
Gemini-CLI
核心功能
会话管理
插件系统
TaskMaster AI
部署方式
npm 全局安装
npx 临时运行
Docker 沙箱
CloudCLI Cloud
常见问题
CloudCLI 支持哪些 AI 编程助手？
支持 Claude Code、Cursor CLI、Codex 和 Gemini-CLI，可通过 UI 下拉菜单切换，具体模型列表见 shared/modelConstants.js。
如何安装 CloudCLI？
推荐使用 npm 全局安装：`npm install -g @cloudcli-ai/cloudcli`，或临时运行 `npx @cloudcli-ai/cloudcli`；也可直接访问 CloudCLI Cloud 服务免安装。Docker 沙箱为实验性功能。
是否支持移动设备访问？
是的，CloudCLI 采用响应式设计，在桌面、平板和手机上均可正常使用，并针对触摸导航进行了优化，截图可见移动端聊天界面。
如何扩展 CloudCLI 的功能？
通过插件系统，可以开发自定义插件来添加新标签页、后端服务或第三方集成，参考插件 starter 仓库（github.com/cloudcli-ai/cloudcli-plugin-starter）开始构建。
数据存储在哪里？是否安全？
会话和认证数据默认存储在本地 SQLite 数据库中，密码使用 bcrypt 加密，API 访问需 JWT 令牌，确保数据安全。具体配置见 .env.example。