Cloud CLI

对于重度依赖 Claude Code、Cursor CLI 或 Codex 的开发者而言，纯命令行界面虽然强大，但在处理复杂项目结构、查看 Git 状态或进行多任务管理时，往往显得不够直观。更重要的是，一旦离开桌面环境，手机和平板几乎无法有效介入这些正在运行的会话。

Cloud CLI（又名 Claude Code UI）不仅仅是一个简单的 Web 包装器，而是一个功能完备的桌面端与移动端统一界面。无论您是在办公室的显示器前，还是在通勤路上的手机上，都能无缝查看活跃项目、管理会话、编辑文件甚至提交代码。

核心亮点：从命令行到可视化工作流

Cloud CLI 将原本黑底白字的终端交互，升级为了现代化的图形界面，同时保留了 CLI 的所有强大能力。

1. 全平台响应式设计

• 桌面端：提供宽敞的多栏布局，左侧文件树，中间代码编辑与聊天，右侧 Git 状态，最大化屏幕利用率。
• 移动端：针对触摸操作深度优化。底部标签栏方便单手操作，侧边栏可折叠，支持滑动手势导航。您可以将其添加为 PWA（渐进式 Web 应用）到主屏幕，获得原生 App 般的体验。
• 无缝切换：会话状态实时同步。您可以在电脑上开始一个复杂的重构任务，然后在手机上随时查看进度或回复 AI 的确认请求。

2. 交互式文件浏览器与编辑器

不再需要频繁切换窗口使用 VS Code 查看文件。Cloud CLI 内置了强大的文件管理器：

• 交互式文件树：支持展开/折叠，清晰展示项目结构。
• 实时编辑：内置基于 CodeMirror 的代码编辑器，支持多种语言语法高亮。您可以直接读取、修改并保存文件，所有更改实时同步到底层 CLI 会话中。
• 文件操作：支持创建、重命名、删除文件和目录，完全可视化的文件管理体验。

3. 原生 Git 工作流集成

这是 Cloud CLI 区别于普通 Web 界面的杀手级功能。它不仅仅是显示日志，而是允许您：

• 查看差异：直观地看到 AI 修改了哪些代码。
• 暂存与提交：直接在界面上 Stage 文件并编写 Commit 信息。
• 分支管理：轻松切换分支，管理开发线。
  这让整个“AI 生成代码 -> 审查 -> 提交”的闭环完全在界面内完成，无需回到终端输入 git add 或 git commit。

4. 高级会话管理

• 持久化存储：所有对话历史自动保存，支持按项目和 timestamp 分组。
• 多会话并发：同时管理多个活跃会话，轻松在不同任务间切换。
• 恢复与导出：随时恢复之前的对话上下文，或导出历史记录用于归档。

5. 可选的 TaskMaster AI 集成

对于大型项目，Cloud CLI 支持集成 TaskMaster AI。

• PRD 解析：上传产品需求文档，AI 自动将其拆解为结构化的开发任务。
• 可视化看板：提供看板风格的任務板，跟踪任务依赖关系和完成进度。
• 工作流自动化：实现从需求到代码生成的全自动流转。

安全至上：默认禁用，按需开启

安全性是 Cloud CLI 设计的重中之重。

• 默认零信任：所有 Claude Code 工具（如文件写入、Shell 执行）默认处于禁用状态。这防止了 AI 在未授权情况下执行潜在危险操作。
• 细粒度控制：用户可以通过侧边栏的设置图标，选择性启用所需的工具。您的偏好设置仅保存在本地，确保控制权始终在您手中。
• 推荐策略：首次使用时，仅启用基础读取工具，待熟悉工作流后，再根据需要逐步开放写入和执行权限。

快速开始指南

Cloud CLI 基于 Node.js 构建，部署极其简单，支持“一键运行”和“全局安装”两种模式。

前置要求

• Node.js v22 或更高版本
• 已安装并配置好 Claude Code CLI、Cursor CLI 或 Codex 中的至少一种

方式一：一键运行（推荐试用）

无需安装，直接使用 npx 运行最新版：

npx @siteboon/claude-code-ui

启动后，访问 http://localhost:3001 即可使用。停止服务器后再次运行该命令即可重启。

方式二：全局安装（日常使用）

如果您需要频繁使用，建议全局安装以获得更便捷的命令体验：

# 安装
npm install -g @siteboon/claude-code-ui

# 启动
claude-code-ui
# 或使用别名
cloudcli

常用命令速查：

生产环境部署：作为后台服务运行

对于需要长期运行的场景（如远程开发服务器），推荐使用 PM2 进行进程管理：

# 安装 PM2
npm install -g pm2

# 启动服务
pm2 start cloudcli --name "claude-code-ui" -- --port 8080

# 设置开机自启
pm2 startup
pm2 save

这样即使断开 SSH 连接或重启服务器，Cloud CLI 也会自动运行，让您随时随地通过浏览器访问。

架构与技术栈

Cloud CLI 采用现代前后端分离架构，确保高性能与可扩展性：

• 前端：基于 React 18 + Vite 构建，使用 CodeMirror 提供专业级代码编辑体验，全面适配移动端触摸事件。
• 后端：使用 Node.js + Express 提供 RESTful API 和静态文件服务。
• 通信：通过 WebSocket 实现聊天消息和项目状态的实时流式传输，确保低延迟交互。
• 集成层：通过子进程管理直接调用本地的 Claude Code/Cursor/Codex CLI，确保所有操作均在本地环境执行，数据不出域。